$DEL DEStid

Function

To delete a symbolic name for a JES2 route code.

Syntax


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

>--+------------------+----------------------------------------><
   '-,--DEST--=--dest-'

Parameters

xxxxxxxx: Specifies the 1 to 8 alphanumeric or special ($, #, or @) character symbolic destination name affected by this statement.

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.

Processing Considerations

When you dynamically delete a JES2 symbolic destination (destid), JES2 honors the deletion across a restart only if you perform a hot start. To permanently delete the symbolic destination, remove the DEStid initialization statement before restarting JES2.

Scope

Single member. The values supplied for 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 $HASP822 message indicates that the specified DESTID has been deleted.

Example

 1   $del destid(wrk1)

  $HASP822 DESTID(WRK1)      DEST=U34-ELEMENT DELETED

JES2 deletes the destination identifier WRK1.