SMART/400
Developer’s Guide
This document is subject to the restrictions in the Foreword. © 2005 CSC Corporation Limited. All rights reserved.
i
Foreword
STATEMENT OF CONFIDENTIALITY
CSC has prepared this document in good faith. Many factors outside CSC’s current
knowledge or control affect the recipient's needs and project plans and errors in the
document will be corrected once discovered by CSC. The responsibility lies with the
recipient to evaluate the document for applicability.
The information in this document is proprietary, confidential and an unpublished work and
is provided upon recipient’s covenant to keep such information confidential. Personal
Data supplied in this document may not be used for any purpose other than for which it
was supplied. Personal Data may not be transferred to other parties without the prior
consent of CSC. In no event may this information be supplied to third parties without
CSC’s consent.
The following notice shall be reproduced on any copies permitted to be made:
© CSC Corporation Limited 2005 All rights reserved
Any request for further information concerning this document should be addressed to:
The Insurance Services Helpdesk
Midrange Competency Centre
Royal Pavilion
Wellesley Road, Aldershot
Hampshire, GU11 1PZ
United Kingdom
Direct Line: +44 (0)1252 536333
Fax: +44 (0)1252 534022
Email: lifehelp@csc.com
CSC Corporation Limited is registered in England under number 1812179, registered
office Royal Pavilion, Wellesley Road, Aldershot, Hampshire, GU11 1PZ
SMART/400 Developer’s Guide
This document is subject to the restrictions in the Foreword. © 2005 CSC Corporation Limited. All rights reserved.
ii
1 INTRODUCTION................................................................................................................................... 1
2 DESIGNING A MODIFICATION............................................................................................................ 3
2.1 Introducing New Fields................................................................................................................. 3
2.1.1 The Field Dictionary Subsystem............................................................................................... 4
2.1.2 Checking For Existing Fields....................................................................................................5
2.1.3 Maintaining Fields on the Dictionary......................................................................................... 6
2.1.4 Windows .................................................................................................................................. 7
2.2 Documenting Fields via the Help System ................................................................................... 11
2.2.1 Help Maintenance Subsystem................................................................................................ 13
2.2.2 Field Dictionary Search .......................................................................................................... 14
2.2.3 Field Help Selection ............................................................................................................... 15
2.2.4 Screen Field Help Selection................................................................................................... 16
2.2.5 Maintaining Help Details ........................................................................................................17
2.3 Error Codes................................................................................................................................ 18
2.3.1 Error Code Maintenance Subsystem...................................................................................... 18
2.3.2 Error Code Creation............................................................................................................... 19
2.3.3 Error Code Enquiry Search .................................................................................................... 20
2.3.4 Error Code Maintenance Search............................................................................................ 21
2.3.5 Amend Error Codes ...............................................................................................................22
2.3.6 Delete Error Codes ................................................................................................................ 23
2.3.7 Translate Error Codes............................................................................................................ 24
2.4 Using a Table or Data Set to Hold Data ..................................................................................... 25
2.5 Changing Fields on a Data Set...................................................................................................25
2.5.1 Data Sets Subsystem.............................................................................................................25
2.5.2 Checking for Existing Data Sets............................................................................................. 26
2.5.3 Data Sets Maintenance.......................................................................................................... 27
2.5.4 Approach to Deleting Data Set Fields .................................................................................... 28
2.5.5 Compiling the Physical File .................................................................................................... 28
2.5.6 Retaining the Data while Amending the Data Set................................................................... 29
2.5.7 Summary of the Data Set Maintenance Process.................................................................... 29
2.6 Changing the Fields on a Table..................................................................................................30
2.6.1 The Compile (CB) Extra Data Screen Command ................................................................... 31
2.6.2 Validation on the eXtra Data Screen ...................................................................................... 31
2.7 Deleting a Table Item ................................................................................................................. 32
2.7.1 Modifying the Valid Flag......................................................................................................... 32
2.7.2 Physically Deleting a Table or Item ........................................................................................ 35
2.8 What Options are Available for Accessing Data? ....................................................................... 36
2.8.1 Sequential.............................................................................................................................. 36
2.8.2 By Key ................................................................................................................................... 36
2.8.3 Direct ..................................................................................................................................... 36
2.8.4 Performance Considerations.................................................................................................. 36
SMART/400 Developer’s Guide
This document is subject to the restrictions in the Foreword. © 2005 CSC Corporation Limited. All rights reserved.
iii
2.9 What Does an Online Function Consist Of? ............................................................................... 37
2.10 Client/Server Enablement........................................................................................................... 37
2.10.1 Business Objects........................................................................................................... 37
2.10.2 Client/Server Data Area................................................................................................. 38
2.11 Screen Types ............................................................................................................................. 38
2.12 Screen Handling......................................................................................................................... 38
2.12.1 Screen I/O Modules....................................................................................................... 39
2.12.2 Screen Control Programs .............................................................................................. 39
2.12.3 Screen Validation Programs .......................................................................................... 39
2.13 Documenting Screen Layouts .................................................................................................... 39
2.14 When Should Business Transactions Be Batched?.................................................................... 40
2.14.1 Batching Financial Online Transactions......................................................................... 40
3 BUILDING AN ONLINE MOCK-UP..................................................................................................... 43
3.1 Building the Mock-up.................................................................................................................. 43
3.1.1 Designing the Screens ...........................................................................................................44
3.1.2 Compiling the Screens ...........................................................................................................44
3.1.3 Registering the Subsystem on T1685 .................................................................................... 45
3.1.4 Assigning Transaction Codes................................................................................................. 47
3.1.5 Setting up the Menu Options on Tables ................................................................................. 47
3.1.6 Secondary Program Switching ............................................................................................... 52
3.1.7 Connecting the Screens......................................................................................................... 55
3.1.8 Sanctioning the User.............................................................................................................. 56
3.2 Where Menu Descriptions are Held............................................................................................ 57
3.3 Documenting the Processing Required ...................................................................................... 58
3.4 Deferring Processing to AT ........................................................................................................ 59
3.4.1 AT Request Job Priority .........................................................................................................59
3.4.2 AT Job Queue Maintenance................................................................................................... 60
3.5 What Does a Batch Function Consist Of? .................................................................................. 61
3.6 What Options are Available for Reporting?................................................................................. 62
3.7 Designing Report Layouts .......................................................................................................... 62
3.7.1 Editing the Printer File - DDS ................................................................................................. 63
3.7.2 The Compile Report Command.............................................................................................. 64
3.7.3 The Display File Field Description Command - DSPFFD ....................................................... 64
3.7.4 The Report Program ..............................................................................................................65
3.8 Using SCRIBE to Produce a Hard Copy of Documentation........................................................ 67
3.8.1 Document Library Structure ................................................................................................... 67
3.8.2 Setting up the Documentation................................................................................................ 68
3.8.3 Document Format Standards ................................................................................................. 68
3.8.4 Naming Conventions..............................................................................................................69
3.8.5 Sample Scribe Parameter File ............................................................................................... 70
3.8.6 Producing the Final Document ............................................................................................... 72
SMART/400 Developer’s Guide
This document is subject to the restrictions in the Foreword. © 2005 CSC Corporation Limited. All rights reserved.
iv
3.8.7 Promoting Documentation to Release.................................................................................... 72
4 BUILDING AN ONLINE MODIFICATION............................................................................................ 73
4.1 Logical Files ............................................................................................................................... 73
4.1.1 Existing View or New View?................................................................................................... 73
4.2 Creating/Amending A Logical File .............................................................................................. 74
4.2.1 Logical View Subsystem ........................................................................................................ 74
4.2.2 Logical View Database Files .................................................................................................. 82
4.2.3 Compiling the Logical File ......................................................................................................82
4.3 Accessing Information from the Database.................................................................................. 83
4.3.1 The I/O Module ...................................................................................................................... 83
4.4 Passing Information Between Screens....................................................................................... 85
4.4.1 READS, KEEPS and RETRV................................................................................................. 85
4.5 Building The Screen ................................................................................................................... 86
4.5.1 DSNSCR................................................................................................................................ 86
4.5.2 Designing the Screen Image.................................................................................................. 87
4.5.3 Window Screens .................................................................................................................... 88
4.5.4 Editing the DDS ..................................................................................................................... 89
4.5.5 Defining Valid Function Keys ................................................................................................. 90
4.5.6 Flagging Fields for Error Highlighting ..................................................................................... 90
4.5.7 Sorting the Fields ................................................................................................................... 90
4.6 Compiling the Screen ................................................................................................................. 91
4.6.1 Compiling Window Screens ................................................................................................... 92
4.7 What Does the Screen I/O Module Do? ..................................................................................... 93
4.8 What Does the Screen Control Program Do?............................................................................. 93
4.8.1 Error Processing .................................................................................................................... 93
4.8.2 Key Handling.......................................................................................................................... 94
4.8.3 Processing Associated with Fields ......................................................................................... 94
4.8.4 Positioning the Cursor............................................................................................................ 95
4.8.5 Miscellaneous Display Attributes............................................................................................ 96
4.9 Subfiles ...................................................................................................................................... 97
4.9.1 Subfile Control Record Format............................................................................................... 97
4.9.2 Subfile Record Format ...........................................................................................................97
4.10 Single Page Vs Self-Extending Subfiles ..................................................................................... 97
4.11 Coding a Subfile Page................................................................................................................ 98
4.12 Subfile Handling ......................................................................................................................... 99
4.12.1 Creating Subfile Screens Using DSNSCR..................................................................... 99
4.12.2 The Subfile Compile Parameter................................................................................... 100
4.12.3 Subfile Programming Notes......................................................................................... 100
4.12.4 Design Considerations................................................................................................. 102
4.13 Coding an Online Program....................................................................................................... 103
4.13.1 Introduction.................................................................................................................. 103
评论1