Allocating a PDS to a System File

To allocate the PDS that contains your execs to a system file, you need to do the following:
  • Decide if you want to use the separate file for execs (SYSEXEC) or combine CLISTs and execs in the same file (SYSPROC). For information that will help you decide, see Things to Consider When Allocating to a System File (SYSPROC or SYSEXEC).
  • Use one of the following two checklists for a step-by-step guide to writing an exec that allocates a PDS to a system file.
    After your PDS is allocated to the system file, you can then run an exec by simply typing the name of the data set member that contains the exec. You can type the member name in any of the following locations:
    • At the READY prompt
      READY
       timegame
    • From the COMMAND option of ISPF/PDF
      -----------------------------  TSO COMMAND PROCESSOR  -------------------------
      ENTER TSO COMMAND OR CLIST BELOW:
      
      ===> timegame
      
      
      
      
      
      ENTER SESSION MANAGER MODE ===> NO    (YES or NO)
    • On the COMMAND line of any ISPF/PDF panel as long as the member name is preceded by "tso".
      ------------------------------  EDIT - ENTRY PANEL  ---------------------------
      COMMAND ===> tso timegame
      
      ISPF LIBRARY:
         PROJECT ===> PREFIX
         GROUP   ===> REXX     ===>            ===>            ===>
         TYPE    ===> EXEC
         MEMBER  ===> TIMEGAME     (Blank for member selection list)
      
      OTHER PARTITIONED OR SEQUENTIAL DATA SET:
         DATA SET NAME     ===>
         VOLUME SERIAL     ===>    (If not cataloged)
      
         DATA SET PASSWORD ===>    (If password protected)
      
         PROFILE NAME      ===>    (Blank defaults to data set type)
      
         INITIAL MACRO     ===>    LOCK       ===> YES    (YES, NO or NEVER)
      
         FORMAT NAME       ===>    MIXED MODE ===> NO     (YES or NO)
To reduce the search time for an exec that is executed implicitly and to differentiate it from a TSO/E command, precede the member name with a %:
READY
 %timegame

When a member name is preceded by %, TSO/E searches a limited number of system files for the name, thus reducing the search time. Without the %, TSO/E searches several files before it searches SYSEXEC and SYSPROC to ensure that the name you entered is not a TSO/E command.