z/OS ISPF Planning and Customizing
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


ISPEXEC processing

z/OS ISPF Planning and Customizing
GC19-3623-00

ISPEXEC is an external entry point in module ISPLINK. This is how ISPF supports the Call ISPEXEC interface in module dialogs. As a result of executing a CLIST that is not under ISPF, if the CLIST contains ISPEXEC dialog service statements, CLIST might try to invoke the ISPEXEC module as a command processor. The results of this change are as follows:

  • If the ISPLINK module (or its alias entry points ISPLNK, ISPEXEC, ISPEX, or ISPQRY) is not invoked under ISPF, TSO issues an error message with a return code of 20.
  • The ISPEXEC entry point can interfere with your installation's setup if someone creates a CLIST called ISPEXEC, or if a CLIST specifically checks for a return code of 12 (TSO issues return code 12 if you try to invoke ISPEXEC when not under ISPF). To eliminate this problem, you make this change:
    • Move the ISPLINK load module (and alias entry points ISPLNK, ISPEXEC, ISPEX and ISPQRY) to a library that is not defined in the search sequence for attaching commands under ISPF.
  • The ISPLINK load module is usually link-edited with dialog functions coded in a programming language. Therefore, you should copy ISPLINK to an “automatic call” link-edit library. Modify existing CLISTs to recognize the ISPEXEC return code of 20 for invocation outside of an ISPF environment (testing for a return code not equal to 0 is recommended). If you choose, you can turn off (NOP) the error message issued from the ISPLINK (and ISPEXEC) module by applying this SUPERZAP:
    NAME      ISPLINK    ISPLINK
    VER       00FC       0A5D       TPUT SVC
    REP       00FC       0700       NOP INSTRUCTION

    Remember that the location of the 0A5D instruction can change from 00FC as a result of maintenance.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014