$T SSI(nnn)

Function

To start or stop tracing for the specified subsystem interface (SSI) function.

To determine which SSI functions have been defined and to display information about an SSI function (such as the address, description, the assembly module containing the SSI function routine, and whether tracing is active), use the $D SSI command.

Syntax


>>-$T--SSI--+-nnn--+-------------+-------------------+---------->
            |      '- ---+-nnn-+-'                   |   
            |            '-*---'                     |   
            |    .-,----------------------------.    |   
            |    V                              |    |   
            '-(------+-nnn-+--+-------------+---+--)-'   
                     '-*---'  '- ---+-nnn-+-'            
                                    '-*---'              

>--+---------------------------------+-------------------------->
   '-| Selection limiting keywords |-'   

>--+---------------------------+-------------------------------><
   '-| Modification keywords |-'   

Modification keywords

|--+----------------------+-------------------------------------|
   '-,--TRace--=--+-No--+-'   
                  '-Yes-'     

Selection limiting keywords

|--+----------------------------------+-------------------------|
   '-,----/----TRace--+-=--+--+-No--+-'   
                      '-^=-'  '-Yes-'

Parameters

SSI({nnn|*}): The SSI function number (1-256). Specify the number to start or stop tracing for a specific function or specify an asterisk (*) to start or stop tracing for all SSI functions.
TRace={No|Yes}: Specifies whether (Y) or not (N) tracing is to be activated for the indicated SSI function.

Note: In order to activate tracing for any of the SSI functions using the $T SSI(nnn),TR=Y command, you must first issue the $S TRACE(11) and/or the $S TRACE(12) commands, which enable processor, device, or SSI function $SAVE/$RETURN tracing.

No trace data will be generated for function code 54, though 54 can be specified.

Authority Required

This command requires system authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS™ system command group is assigned.

This command requires control security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Scope

Single member. This command will be in effect for this member only.

Depending on your installation's setup, however, you might want this command to be applied to all members of the MAS (to ensure a consistent environment across the MAS). If so, you can use the MVS ROUTE *ALL command to issue this command to all active members (if the JES2 command character is the same on all members). See z/OS MVS System Commands, SA38-0666 for more information on using the ROUTE *ALL command.

Messages

The $HASP648 message displays the current value of the TRACE= parameter on the SSI(nnn) initialization statement.

Example

 1   $t ssi(1),tr=y

  $HASP648 SSI(1) TRACE=YES

JES2 activates tracing for SSI function number 1.