Chapter 5. Other Common Service Layer (CSL) functionalities 113
Executing panel that appears until the command has been completed or until the wait
interval has expired. Once the command process has finished, or has timed-out, you will
be returned to the TSO SPOC command entry panel.
The default wait time, if no time is entered, is five minutes. All wait intervals are in the form
of MMM:SS (M=minutes; S=seconds). If you only enter a number and no colon, the SPOC
will interpret the number as seconds. For example, if you enter "120" as your wait interval
value, the TSO SPOC will interpret this as 120 seconds, or two minutes.
Waiting preference
Optionally specify whether you want to wait for the command to complete and return a
response or not. If you prefer not to wait for command completion, you can review the
command status and output by selecting
Display —>3. Command status from the action
bar.
Command shortcuts
Shortcuts are abbreviated ways of entering commands. A command which is entered
frequently can be abbreviated to just a few characters.
You can enable or disable whether the TSO SPOC is to process shortcuts. TSO SPOC will
not use shortcuts if this selection is not specified.
Shortcut processing
You can control whether to replace shortcut parameters or to merge the shortcut
parameters. If the short cut is defined as follows:
Cmd & resource: QRY TRAN
Additional parameters: CLASS(1) SHOW(CLASS,QCNT)
In the command line, you type the following:
QRY TRAN SHOW(PSB)
With the merge option, the submitted command will be:
QRY TRAN CLASS(1) SHOW(PSB,CLASS,QCNT)
With the override option, the submitted command will be:
QRY TRAN CLASS(1) SHOW(PSB)
Initial view
Optionally indicate whether you would like for the TSO SPOC command and response
panel that allows you to enter commands and receive the output, or the SPOC status list
that displays the execution status of all commands you submitted to appear upon startup.
The command and response panel is the default if unspecified on the preference panel.
These values are saved in the ISPF profile dataset and are used the next time you use
DFSSPOC.
5.8 Setting up a user written interface to Operations Manager
In addition to the TSO ISPF SPOC application, a REXX SPOC API has been provided. The
REXX interface allows REXX programs to submit commands to OM and to retrieve the
responses.
5.8.1 REXX SPOC functions
The REXX programming language is frequently used to implement automation software.
Programs written in REXX can run under TSO, Netview, or some other environment. The
114 IMS in the Parallel Sysplex, Volume III: IMSplex Implementation and Operations
REXX programs use SCI to communicate with OM, and they may or may not be run on the
same OS/390 as OM. Command responses are saved to a REXX stem variable.
5.8.2 REXX SPOC file allocation
In order to use the REXX interface, the executables must be available to the TSO session.
This is done either by adding the SDFSRESL library to the TSO JCL in the STEPLIB DD
statement or by using the TSOLIB command to add the SDFSRESL library to the TSO search
order.
Table 5-2 shows the DD names and the associated files that need to be allocated via ALTLIB
functions.
Table 5-2 SPOC REXX interface file allocation associations
5.8.3 The REXX SPOC environment
The REXX SPOC components are:
CSLULXSB program
IMSSPOC subcommands
CSLULGTS REXX function
5.8.4 CSLULXSB TSO command program
The REXX host command environment is setup by the CSLULXSB program. The purpose of
this program is to:
Establish the IMSSPOC host command environment.
Establish the CSLULGTS function.
Provides REXX variables for return code and reason code processing within the REXX
program.
Since this is an OS/390 program, the "Address LINK CSLULXSB" instruction is used to set up
the environment. Example 5-9 shows the call to CSLULXSB to establish the REXX SPOC
environment.
Example 5-9 CSLULXSB program call
Address LINK 'CSLULXSB'
5.8.5 IMSSPOC environment
Once CSLULXSB has been successfully processed, the IMSSPOC environment is available
to the REXX program. Host commands are typically quoted strings and are passed directly to
the host command processor.
Commands IMS, ROUTE, WAIT, CART, and END are supported and perform specific local
IMSSPOC functions. Any other passed string is assumed to be a command and is passed to
SCI. Example 5-10 shows the use of the IMSSPOC environment.
Usage Data set
TSOLIB command IMS.SDFSRESL
FILE (SYSPROC) user.written.execs

Get IMS in the Parallel Sysplex Volume III IMSplex Implementation and Operations now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.