$D DESTDEF

Function

To display the meaning and context of explicit and symbolic destinations on the DESTID statement.

Syntax


>>-$D--DESTDEF--+-------------+--+----------+------------------->
                '-,--LOCALNUM-'  '-,--Ndest-'   

>--+-------------+--+----------+--+-----------+----------------->
   '-,--NODENAME-'  '-,--Rdest-'  '-,--RMdest-'   

>--+------------+--+-------------+--+----------+---------------><
   '-,--RMTdest-'  '-,--SHOWUSER-'  '-,--Udest-'

Parameters

LOCALNUM: Displays the maximum special local routing allowed on this system.
Ndest: Displays how JES2 interprets destinations of the form ‘Nnnnn'. JES2 either interprets ‘Nnnnn' and ‘NnnnnRmmmm' as a node (NODE) or as a userid (USER).
NODENAME: Displays the nodename.
Rdest: Displays how JES2 interprets destinations of the form ‘Rmmmm' and ‘NnnnnRmmmm'. JES2 either interprets ‘Rmmmm' as a remote work station (REMOTE) or as a userid (USER).
RMdest: Displays how JES2 interprets destinations of the form ‘RMmmmm'. JES2 either interprets ‘RMmmmm' as a remote work station (REMOTE) or as a userid (USER).
RMTdest: Displays how JES2 interprets destinations of the form ‘RMTmmmm'. JES2 either interprets ‘RMTmmmm' as a remote work station (REMOTE) or as a userid (USER).
SHOWUSER: Displays whether destinations for the local node that have user routings are displayed with a ‘LOCAL.' prefix (WITHLOCAL) or not (NOLOCAL).
Udest: Displays how JES2 interprets destinations of the form ‘Unnnn'. JES2 either interprets ‘Unnnn' as a special local route code (SPLOCAL) or as a userid (USER).

Authority Required

This command requires display 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 read security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Scope

The scope of this command varies by parameter.

The values supplied for the LOCALNUM and SHOWUSER parameters will display information about this member only. Depending on your installation's setup, however, you might want to use these parameters to get information about all members of 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).

The values supplied for all other parameters are MAS-wide and will display information about the entire MAS.

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   $d destdef

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

JES2 displays an installation where destids prefixed by ‘N', ‘U', and ‘R' can be userids. JES2 processes destids prefixed by either ‘RM' or ‘RMT' as remote work stations and displays the ‘LOCAL.' prefix for all route codes.