$D DEStid

Function

To display the JES2 route code associated with the specified symbolic destination name.

This command has parameters you can use as a filtering technique to limit the type of information to search, or the amount of information to display. See Using filtering to control and display information for additional information.

One or more parameters on this command accepts wild cards. Parameter descriptions will note that.

Syntax


>>-$D--DEStid--+------------------------------+----------------->
               +-'--xxxxxxxx--'---------------+   
               |    .-,------------------.    |   
               |    V                    |    |   
               '-(----+-xxxxxxxx-------+-+--)-'   
                      '-'--xxxxxxxx--'-'          

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

>--+-------------------------------+---------------------------><
   '-| Display limiting keywords |-'   

Display limiting keywords

|--+---------+--+------------+--+-----------+-------------------|
   '-,--DEST-'  '-,--PRIMARY-'  '-,--STATUS-'   

Selection limiting keywords

|--+------------------------------------+----------------------->
   '-,--+---+--PRIMARY--+-=--+--+-No--+-'   
        '-/-'           '-^=-'  '-Yes-'     

>--+-----------------------------------------------+------------|
   '-,--+---+--STATUS--+-=--+--+-DESTID----------+-'   
        '-/-'          '-^=-'  +-NODENAME--------+     
                               '-NODENAME+DESTID-'

Parameters

xxxxxxxx

Specifies the 1 to 8 alphanumeric or special ($, #, or @) character symbolic destination name you want to display. You may specify a particular symbolic destination name or use wild cards (for example, POK* or *). See Using wildcards for additional information.

DEST

Displays the route code JES2 uses to route data.

PRIMARY[=No|Yes]

Displays whether this is a primary destid.

STATUS[=DESTID|NODENAME|NODENAME+DESTID]

Displays whether this is a node (or NJE node name) or a destid. The status displayed will be one of the following values:

STATUS=NODENAME+DESTID
STATUS=NODENAME
STATUS=DESTID

Authority Required

This command requires display authority. The description of the $T RDRnn command explains how to ensure that 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

Single member. The response to this command will be a display of information about this member only. You might want to use this command to get information about all members in the MAS. To do 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 $HASP822 message displays the current values of all the parameters on the DEStid initialization statement.

Examples

 1   $D DESTID(*)

  $HASP822 DESTID(POK)       DEST=N1,STATUS=NODENAME+DESTID,
  $HASP822                   PRIMARY=NO
        $HASP822 DESTID(REMOTE20)  DEST=R20,STATUS=DESTID,PRIMARY=NO
        $HASP822 DESTID(REMOTE21)  DEST=R21,STATUS=DESTID,PRIMARY=NO
        $HASP822 DESTID(REMOTE22)  DEST=R22,STATUS=DESTID,PRIMARY=NO
        $HASP822 DESTID(REMOTE23)  DEST=R23,STATUS=DESTID,PRIMARY=NO
        $HASP822 DESTID(REMOTE24)  DEST=R24,STATUS=DESTID,PRIMARY=NO
        $HASP822 DESTID(REMOTE25)  DEST=R25,STATUS=DESTID,PRIMARY=NO
        $HASP822 DESTID(REMOTE26)  DEST=R26,STATUS=DESTID,PRIMARY=NO
        $HASP822 DESTID(REMOTE27)  DEST=R27,STATUS=DESTID,PRIMARY=NO
        $HASP822 DESTID(REMOTE34)  DEST=R34,STATUS=DESTID,PRIMARY=NO
        $HASP822 DESTID(REMOTE5)   DEST=R5,STATUS=DESTID,PRIMARY=NO
        $HASP822 DESTID(SANJOSE)
  $HASP822 DESTID(SANJOSE)   DEST=N3,STATUS=NODENAME+DESTID,
  $HASP822                   PRIMARY=NO
           $HASP822 DESTID(WSC)
  $HASP822 DESTID(WSC)       DEST=N2,STATUS=NODENAME+DESTID,
  $HASP822                   PRIMARY=NO

JES2 displays all destids.

 2   $D DESTID(*), STATUS=NODENAME+DESTID

           $HASP822 DESTID(NODE4)
  $HASP822 DESTID(NODE4)     DEST=N4,STATUS=NODENAME+DESTID,
  $HASP822                   PRIMARY=NO
           $HASP822 DESTID(POK)
  $HASP822 DESTID(POK)       DEST=N1,STATUS=NODENAME+DESTID,
  $HASP822                   PRIMARY=NO
           $HASP822 DESTID(SANJOSE)
  $HASP822 DESTID(SANJOSE)   DEST=N3,STATUS=NODENAME+DESTID,
  $HASP822                   PRIMARY=NO
           $HASP822 DESTID(WSC)
  $HASP822 DESTID(WSC)       DEST=N2,STATUS=NODENAME+DESTID,
  $HASP822                   PRIMARY=NO

JES2 displays all destids that have a status of nodename and destid.

 3a   $D DESTID(FAXROOM)

  $HASP822 DESTID(FAXROOM)   DEST=U3,STATUS=DESTID,PRIMARY=YES

 3b   $D DESTID(PRINTER3)
  $HASP822 DESTID(PRINTER3)  DEST=U3,STATUS=DESTID,PRIMARY=NO

 3c   $TOJ7,ALL,D=U3

  JOB00007  $HASP686 OUTPUT(DIA)
  $HASP686 OUTPUT(DIA)       OUTGRP=1.1.1,BURST=NO,FCB=****,
  $HASP686                   FLASH=****,FORMS=DXP,HOLD=(NONE),
  $HASP686                   HOLDRC=,OUTDISP=LEAVE,PAGES=,
  $HASP686                   PRIORITY=12,PRMODE=LINE,QUEUE=1,
  $HASP686                   RECORDS=(37 OF 37),ROUTECDE=FAXROOM,
  $HASP686                   SECLABEL=,TSOAVAIL=NO,UCS=****,
  $HASP686                   USERID=PIKE,WRITER=

The series of examples above shows that multiple names (aliases) may exist for a destination. The PRIMARY parameter indicates what the alias is to be resolved to when the DEST of a job or SYSOUT is U3.

For example, if SYSOUT is routed to U3, as in the last example of the series, any displays of this output display FAXROOM.