APL2

A dialog service can be invoked by using the function form of ISPEXEC:
[n]   lastrc◄ISPEXEC   character-vector
lastrc
Specifies the name of an APL2® variable in which the return code from the service is to be stored.
character-vector
The character-vector is a single-character vector that contains all parameters to be passed to the dialog service. The format is the same as dialog service statements for command languages. The first parameter in the vector must be the name of the service to be invoked.

Standard register conventions are used. Registers 2 to 14 are preserved across the call.

A workspace containing the ISPEXEC function is provided with ISPF. All dialog writers must use this ISPEXEC function, as it contains the interface to ISPF and handles the implementation of commands (through the APL2 EXECUTE function); otherwise, results are unpredictable. For example:

THIS APL program shows four lines in a block, then line 15. Line 1 is (finger)OPEN THE TABEL. Line 2 is LASTCC(backarrow)ISPEXEC 'TBOPEN TABLE NOWRITE' Line 3 is (forward arrow)(LASTCC = 0)/NORMALCONT. Line 4 is (finger)PROCESS ERRORS HERE. Line 15 is NORMALCONT:..........

For information about using APL2 with ISPF, refer to the z/OS V2R2 ISPF Dialog Developer's Guide and Reference.