$T DESTDEF

Function

To control how JES2 displays a destination routed to the local node.

Because SHOWUSER can affect SDSF's security, see SDSF Guide and Reference before specifying this parameter.

Syntax


>>-$T--DESTDEF--+-------------------------------+--------------><
                '-,--SHOWUSER--=--+-No--------+-'   
                                  +-NOLOCAL---+     
                                  +-WITH------+     
                                  '-WITHLOCAL-'

Parameters

SHOWUSER={No|NOLOCAL|WITH|WITHLOCAL}

Specifies whether destinations for the local node that have user routines are (WITH or WITHLOCAL) or are not (No or NOLOCAL) to be displayed with a ‘LOCAL.' prefix.

No|NOLOCAL: Specifies that JES2 is to display destinations for the local node that contain user routings without the ‘LOCAL.' prefix. For example, SYSOUT routed to a TSO/E userid of FRED at the local node will display as ‘FRED'.
WITH|WITHLOCAL: Specifies that JES2 is to display destinations for the local node that contain user routings with a prefix of ‘LOCAL.' For example, SYSOUT routed to a TSO/E userid of FRED at the local node will display as ‘LOCAL.FRED'.
When the DESTDEF initialization statement parameters specify USER, you should specify SHOWUSER=WITHLOCAL to avoid possible confusion between displays of explicit routings and displays of user routings.

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 $HASP812 message displays the current status of DESTDEF parameters in the installation.

Example

 1   $t destdef,showuser=withlocal

  $HASP812 DESTDEF  LOCALNUM=9999,NDEST=NODE,RDEST=REMOTE,RMDEST=
  $HASP812          REMOTE,RMTDEST=REMOTE,UDEST=SPLOCAL,SHOWUSER=
  $HASP812          WITHLOCAL

JES2 displays userids at the local node with a prefix of 'LOCAL.'