Starting and setting up the TSO SPOC

After you start the TSO SPOC through the IMS™ Application menu, you must add the IMS distribution libraries to the TSO user's environment.

To start the TSO SPOC, use the IMS Application menu.

Use one of the following methods to set up the TSO SPOC program:

  • Edit the logon procedure to include the IMS distribution libraries or to issue ALLOCATE commands to make the data sets available to the TSO user.

    The TSOLIB command of TSO can be used to make the load module data set available to the TSO user. TSOLIB is a command that establishes a STEPLIB-like data set without having to modify the logon procedure.

    The data set allocated to ISPTABL is unique to the user. Because of the way ISPF uses tables, the same data set allocated to ISPTABL must also be allocated in the ISPTLIB concatenation and ahead of the IMS.SDFSTLIB data set. The data sets are shown in the following table.

    Table 1. Data sets for SPOC setup
    Usage Data set
    TSOLIB command or STEPLIB IMS.SDFSRESL
    FILE(ISPPLIB) IMS.SDFSPLIB
    FILE(ISPMLIB) IMS.SDFSMLIB
    FILE(ISPTLIB) user.ISPTLIB IMS.SDFSTLIB
    FILE(ISPTABL) user.ISPTLIB
    FILE(SYSPROC) IMS.SDFSEXEC

    After the data sets are added to your TSO environment, you can call the TSO SPOC from other applications through a command interface.

    An example of calling TSO SPOC from a rexx program is:

    /* rexx */Address ISPEXEC "SELECT CMD(DFSSPOC CMD(qry tran) PLEX(plex1))"

    Additionally, you can call the TSO SPOC by entering:
    • TSO DFSSPOC in any ISPF command line.
    • DFSSPOC in the ISPF option 6 command line followed by any of the optional parameters that appear in the DFSSPOC syntax diagram.
  • Use the TSO ALTLIB command and ISPF's LIBDEF service. The DFSSPSRT exec provides an example of starting the DFSSPOC program using ALTLIB and LIBDEF.
    You can invoke DFSSPSRT from ISPF option 6 by entering:
    EXEC 'imslib.SDFSEXEC(DFSSPSRT)' 'HLQ(imslib)'