Practical Usage of ISPF Dialog Manager

Practical Usage of ISPF Dialog Manager is a concise and comprehensive source of information for the development of applications using IBM's Dialog Management package. Dialog Manager is a vehicle for implementing dialogue applications (such as PDF - Program Development Facility) and is very well suited to the implementation of individual dialogue systems and those systems which are required to run from the TSO/ISPF environment. It is also ideally suited for prototyping.
This book is intended for both beginners and experts. With its carefully chosen blend of theory and practice, and extensive use of examples and case studies, this book will provide an invaluable guide to all those needing to learn about or using the ISPF Dialog Manager.

1. Introduction.- 1.1 Historical development.- 1.2 General application area.- 1.3 Comparison with other dialogue systems.- 1.4 The future of ISPF.- 2. General Concepts.- 2.1 Definition of data processing.- 2.2 Definition of dialogue.- 2.3 Dialogue components.- 2.4 Introduction to DTL.- 3. Invocation.- 3.1 Introduction.- 3.2 Invocation services.- 3.2.1 ISPSTART — Initiate ISPF environment and invoke function.- 3.2.2 SELECT — Invoke function.- 3.3 Miscellaneous environmental services.- 3.3.1 CONTROL — Set processing modes.- 3.3.2 LIBDEF — Define application libraries.- 3.3.3 LIST — Write data lines to ISPF list dataset.- 3.3.4 LOG — Write a message to the ISPF log dataset.- 3.3.5 QLIBDEF — Query LIBDEF information.- 3.4 ISPF service invocation.- 3.4.1 Error message variables.- 3.5 Batch invocation.- 3.5.1 Panel input in batch.- 3.5.2 Sample batch JCL.- 4. Command Procedures.- 4.1 Introduction.- 4.2 CLIST features.- 4.2.1 CLIST syntax summary.- 4.3 REXX features.- 4.3.1 REXX syntax summary.- 4.4 TSO commands.- 4.4.1 ALLOC — Allocate dataset or file.- 4.4.2 CALL — Execute program.- 4.4.3 EXEC — Execute command procedure.- 4.4.4 FREE — Release dataset or file.- 4.4.5 SUBMIT — Submit job control statements for batch execution.- 4.5 Command invocation.- 4.5.1 CLIST command invocation.- 4.5.2 REXX command invocation.- 5. Panels.- 5.1 Introduction.- 5.2 Panel definition.- 5.2.1 ADDPOP — Pop-up panel display.- 5.2.2 DISPLAY — Data input panel.- 5.2.3 REMPOP — Revoke pop-up panel display.- 5.2.4 SELECT — Selection panel.- 5.2.5 TBDISPL — Table display panel.- 5.2.6 Help panel.- 5.3 Preprocessed panels.- 6. Variable Services.- 6.1 Introduction.- 6.2 Syntax.- 6.3 Variable pools.- 6.3.1 Function pool.- 6.3.2 Shared pool.- 6.3.3 Profile pool.- 6.3.4 Read-only profile pool.- 6.3.5 Command procedure pool.- 6.4 Access to variables and pools.- 6.5 Variable services.- 6.5.1 VERASE — Remove variables from shared or profile pool.- 6.5.2 VGET — Get variable from a pool or profile.- 6.5.3 VPUT — Put variable into a pool or profile.- 6.6 System variables.- 6.6.1 General variables.- 6.6.2 Time and date variables.- 6.6.3 Terminal functions and PF key variables.- 6.6.4 Scrolling variables.- 6.6.5 TBDISPL service variables.- 6.6.6 Dialogue error variables.- 6.6.7 Control variables in selection panels.- 6.6.8 Control variables used in help panels.- 6.6.9 List service variables.- 6.6.10 List and log dataset variables.- 6.6.11 System variables as panel control variables.- 7. Message Services.- 7.1 Introduction.- 7.2 Form of message.- 7.2.1 Variable substitution.- 7.3 Message processing.- 7.4 Message services.- 7.4.1 GETMSG — Get a message.- 7.4.2 LOG — Write a message to the log data set.- 7.4.3 SETMSG — Set a message.- 7.5 Symbolic parameters.- 7.6 Invocation of messages.- 8. Panel Processing.- 8.1 Introduction.- 8.2 Hardware characteristics.- 8.3 Form of panel.- 8.3.1 Panel section.- 8.3.2 Attribute section.- 8.3.3 Action Bar Choice (> ABC) section.- 8.3.4 Action Bar Initialisation (> ABCINIT > section.- 8.3.5 Action Bar Processing (> ABCPROC) section.- 8.3.6 Body (> BODY) section.- 8.3.7 Model (> BODY) section.- 8.3.8 Area (> AREA) section.- 8.3.9 Initialisation section.- 8.3.10 Reinitialisation section.- 8.3.11 Processing section.- 8.3.12 Point-And-Shoot (> PNS) section.- 8.3.13 Field-Level (> HELP) section.- 8.3.14 End (> END) section.- 8.4 Panel statements.- 8.4.1 Assignment statement (=).- 8.4.2 EXIT statement.- 8.4.3 GOTO statement.- 8.4.4 IF (ELSE) statement.- 8.4.5 PANEXIT (panel exit) statement.- 8.4.6 REFRESH statement.- 8.4.7 TOG (toggle) statement.- 8.4.8 VEDIT (variable edit) statement.- 8.4.9 VER (verification) statement.- 8.4.10 VGET statement.- 8.4.11 VPUT statement.- 8.5 Panel functions.- 8.5.1 LVLINE function.- 8.5.2 PFK function.- 8.5.3 TRANS function.- 8.5.4 TRUNC function.- 8.6 Panel control variables.- 8.6.1 .ALARM — Set alarm.- 8.6.2 .ATTR — Set field attribute.- 8.6.3 .ATTRCHAR — Set attribute character.- 8.6.4 .AUTOSEL — Set auto selection status.- 8.6.5 .CSRPOS — Set cursor position within field.- 8.6.6 .CSRROW — Set cursor at table row.- 8.6.7 .CURSOR — Set cursor at field.- 8.6.8 .HELP — Specify help panel.- 8.6.9 .MSG — Specify message identifier.- 8.6.10 .PFK — Obtain PF key.- 8.6.11 .RESP — Obtain response.- 8.6.12 .TRAIL — TRUNC remainder.- 8.6.13 .ZVARS — Placeholder.- 8.7 Dynamic area.- 8.7.1 Format of a dynamic area.- 8.7.2 Dynamic area definition.- 8.7.3 Shadow variable.- 8.8 Use of dynamic areas.- 8.8.1 Scrolling.- 8.9 Graphic areas.- 8.9.1 Format of a graphic area.- 8.9.2 Graphic area definition.- 8.10 Use of graphic areas.- 8.11 Scrollable area.- 8.11.1 Format of a scrollable area.- 8.11.2 Definition of a scrollable area.- 8.12 Use of scrollable areas.- 8.13 Panel area information.- 8.14 Keylists.- 8.15 Processing sequence in panels.- 8.16 Special panel processing.- 8.16.1 Panel error processing.- 8.16.2 Extended alphabetic validation.- 8.16.3 Fields containing mixed data.- 8.16.4 Date validation.- 8.16.5 Validation of number of data fields.- 8.16.6 Arithmetic processing.- 8.16.7 Extended processing.- 8.16.8 Cursor positioning.- 8.16.9 Comprehensive validation.- 8.16.10 Dynamic area scrolling.- 8.16.11 Conditional setting of message variables.- 8.16.12 Mixed Panel Processing Elements.- 9. Table Services.- 9.1 General form of table.- 9.2 Table input/output.- 9.3 Use of tables.- 9.4 Table operations.- 9.4.1 TBADD — Add a row to a table.- 9.4.2 TBBOTTOM — Set row pointer at end of table.- 9.4.3 TBCLOSE — Close and save table.- 9.4.4 TBCREATE — Create a new table.- 9.4.5 TBDELETE — Delete a row from a table.- 9.4.6 TBDISPL — Display table contents.- 9.4.7 TBEND — Close table without saving.- 9.4.8 TBERASE — Delete table.- 9.4.9 TBEXIST — Determine whether table row exists.- 9.4.10 TBGET — Retrieve table row.- 9.4.11 TBMOD — Unconditional update of table row.- 9.4.12 TBOPEN — Open a table for processing.- 9.4.13 TBPUT — Conditional update of table row.- 9.4.14 TBQUERY — Obtain table information.- 9.4.15 TBSARG — Set search argument.- 9.4.16 TBSAVE — Save table.- 9.4.17 TBSCAN — Perform table search.- 9.4.18 TBSKIP — Move row pointer.- 9.4.19 TBSORT — Sort table.- 9.4.20 TBSTATS — Retrieve table statistics.- 9.4.21 TBTOP — Set row pointer at top of table.- 9.4.22 TBVCLEAR — Clear table variables.- 10. Table Applications.- 10.1 Introduction.- 10.2 Example.- 10.3 Table creation.- 10.4 Input of data into the table.- 10.5 Display of table records.- 10.6 Update of selected table records.- 10.7 Explicit row positioning.- 10.8 Searching on data fields.- 10.9 Termination.- 10.10 Complete CLIST.- 10.11 Equivalent processing for non-keyed table.- 11. File Tailoring Services.- 11.1 General form of skeleton.- 11.2 File tailoring operations.- 11.2.1 FTCLOSE — Terminate file tailoring.- 11.2.2 FTERASE — Delete member from output library.- 11.2.3 FTINCL — Include skeleton for processing.- 11.2.4 FTOPEN — Open file tailoring processing.- 11.3 Control statements.- 11.3.1 )BLANK — Insert blank line.- 11.3.2 )CM — Comment.- 11.3.3 )DEFAULT — Default delimiters.- 11.3.4 )DOT — Do-table.- 11.3.5 )ENDDOT — End do-table.- 11.3.6 )ENDSEL — End selection.- 11.3.7 )IM — Imbed skeleton.- 11.3.8 )SEL — Select.- 11.3.9 )SET — Assignment.- 11.3.10 )TB — Set tab stops.- 11.4 Control delimiters.- 11.5 Data record.- 11.6 Symbolic parameters.- 12. File Tailoring Applications.- 12.1 Introduction.- 12.2 Example.- 12.3 Worked example.- 13. Command Table.- 13.1 Introduction.- 13.2 Command hierarchy.- 13.3 Command table format.- 13.3.1 ZCTVERB — Verb (command).- 13.3.2 ZCTTRUNC — Truncation length.- 13.3.3 ZCTACT — Action.- 13.3.4 ZCTDESC — Description.- 13.3.5 Example.- 13.4 ISPCMDS — Default command table.- 13.5 Program function keys.- 13.5.1 Keylists.- 14. Program Environment.- 14.1 Introduction.- 14.2 ISPF Program interfaces.- 14.2.1 ISPEXEC call interface.- 14.2.2 ISPLINK call interface.- 14.2.3 Calls which return values indirectly.- 14.3 Program invocation.- 14.4 Program calls.- 14.5 Linkage to services.- 14.5.1 Invoked PL/I program.- 14.5.2 Invoked COBOL program.- 14.5.3 Invoked Assembler program.- 14.5.4 Invoked C/370 program.- 14.6 Linkage to services.- 14.6.1 PL/I program invocation.- 14.6.2 COBOL program invocation.- 14.6.3 Assembler program invocation.- 14.6.4 C/370 program invocation.- 14.7 Program ISPF parameters.- 14.7.1 Name.- 14.7.2 Service name.- 14.7.3 Keyword.- 14.7.4 Name list string.- 14.7.5 Name list structure.- 14.7.6 Numeric value.- 14.7.7 Dataset list.- 14.8 Linkage Editor parameters.- 14.9 Program variable services.- 14.9.1 VCOPY — Copy ISPF variables to program variables.- 14.9.2 VDEFINE — Make ISPF variables available as program variables.- 14.9.3 VDELETE — Remove availability of ISPF variables.- 14.9.4 VMASK — Specify mask processing.- 14.9.5 VREPLACE — Replace function pool variables with program variables.- 14.9.6 VRESET — Remove variables from defined function pool.- 14.10 Panel exit.- 14.11 Program examples.- 14.11.1 Sample PL/I program.- 14.11.2 Sample COBOL program.- 14.11.3 Sample Assembler program.- 14.11.4 Sample C/370 program.- 14.12 Sample panel exit.- 14.12.1 Generalised panel exit.- 15. Help Mode.- 15.1 Introduction.- 15.2 Help panel.- 15.3 Standard help panel.- 15.4 Table of contents.- 15.5 Index.- 15.6 Help panel hierarchy.- 15.7 Field-help.- 15.8 Reference phrase.- 15.9 Definition of help panels.- 15.9.1 Dynamically formatted help panels.- 15.10 Example.- 16. Miscellaneous Display Services.- 16.1 Introduction.- 16.2 BRIF — Browse interface.- 16.2.1 Read routine.- 16.2.2 Command routine.- 16.2.3 Example.- 16.3 BROWSE — Browse a dataset or library member.- 16.4 EDIF — Edit interface.- 16.4.1 Read routine.- 16.4.2 Write routine.- 16.4.3 Command routine.- 16.4.4 Example.- 16.5 EDIREC — Initialise edit recovery.- 16.6 EDIT — Edit a dataset or library member.- 16.7 VIEW — View a dataset or library member.- 17. Library Management.- 17.1 Introduction.- 17.1.1 Service identifier.- 17.1.2 Error handling.- 17.2 Library Management services.- 17.2.1 LMCLOSE — Close dataset.- 17.2.2 LMCOMP — Compress a library.- 17.2.3 LMCOPY — Copy library members.- 17.2.4 LMDDISP — Dataset display.- 17.2.5 LMDFREE — Free a dataset-list.- 17.2.6 LMD INIT — Initialise a dataset list.- 17.2.7 LMD LIST — List a dataset.- 17.2.8 LMERASE — Erase (delete) a dataset.- 17.2.9 LMFREE — Free a dataset association.- 17.2.10 LMGET — Read a logical record.- 17.2.11 LMINIT — Initialise a dataid for a dataset.- 17.2.12 LMMADD — Add member.- 17.2.13 LMMDEL — Delete a member.- 17.2.14 LMMDISP — Member list service.- 17.2.15 LMMFIND — Find member.- 17.2.16 LMMLIST — List library members.- 17.2.17 LMMOVE — Move library members.- 17.2.18 LMMREN — Rename member.- 17.2.19 LMMREP — Replace member.- 17.2.20 LMMSTATS — Set member statistics.- 17.2.21 LMOPEN — Open a dataset.- 17.2.22 LMPRINT — Print a dataset or member.- 17.2.23 LMPUT — Write a logical record.- 17.2.24 LMQUERY — Retrieve dataset information.- 17.2.25 LMRENAME — Rename a dataset.- 17.3 Program invocation example.- 17.3.1 Invocation forms.- 17.3.2 Data type for program invocation.- 17.3.3 Sample program.- 17.4 Worked example.- 18. DTL Example.- 18.1 Introduction.- 18.2 GML definition.- 18.3 Generated display panels.- 18.4 Generated help panels.- 18.5 Generated messages.- 18.6 Generated key list.- 18.7 Generated command table.- 18.8 GETDATE coded procedure.- 18.9 Coded procedures.- 19. Graphical User Interface.- 19.1 Introduction.- 19.2 Mainframe-workstation mapping.- 19.2.1 Action bars.- 19.2.2 Pop-up windows.- 19.2.3 Pop-up messages.- 19.2.4 Point-and-shoot fields.- 19.2.5 Pushbuttons.- 19.2.6 Multi-selection fields (checkboxes).- 19.3 GUI invocation.- 19.4 GUI restrictions.- 19.5 Example.- 20. Test Facilities.- 20.1 Introduction.- 20.2 Test facility invocation.- 20.3 Facilities.- 20.3.1 Option 1 — Invoke function.- 20.3.2 Option 2 — Display panel.- 20.3.3 Option 3 — Display/modify variable information.- 20.3.4 Option 4 — Display/modify table information.- 20.3.5 Option 5 — Browse ISPF log.- 20.3.6 Option 6 — Invoke ISPF service.- 20.3.7 Option 7 — Specify trace options.- 20.3.8 Option 8 — Specify breakpoints.- 20.4 Invocation of ISPF from TSO TEST.- Appendix A. Syntax.- Appendix B. Glossary.