$D DEStid - Display a JES2 symbolic destination
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
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.
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 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
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
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.