Remove Routing Entry (RMVRTGE)

Where allowed to run: All environments (*ALL)
Threadsafe: No 		Parameters
Examples
Error messages

The Remove Routing Entry (RMVRTGE) command removes a routing entry from the specified subsystem description. The subsystem can be active at the time the command is run.

Restrictions:

  1. To use this command, you must have:
    • object operational (*OBJOPR), object management (*OBJMGT), and read (*READ) authority to the specified subsystem description and execute (*EXECUTE) authority to the library containing the subsystem description.
Top

Parameters

Keyword Description Choices Notes
SBSD Subsystem description Qualified object name Required, Positional 1
Qualifier 1: Subsystem description Name
Qualifier 2: Library Name, *LIBL, *CURLIB
SEQNBR Routing entry sequence number 1-9999 Required, Positional 2
Top

Subsystem description (SBSD)

Specifies the name and library of the subsystem description that contains the routing entry being removed.

This is a required parameter.

Qualifier 1: Subsystem description

name
Specify the name of the subsystem description from which the routing entry is being removed.

Qualifier 2: Library

*LIBL
All libraries in the thread's library list are searched until a match is found.
*CURLIB
The current library for the thread is used to locate the object. If no library is specified as the current library for the thread, the QGPL library is used.
name
Specify the name of the subsystem description's library from which the routing entry is being removed.
Top

Routing entry sequence number (SEQNBR)

Specifies the sequence number of the routing entry being removed. The sequence numbers on the routing entries indicate the order that the routing entries will be processed when comparing values. When a job enters the system, the compare value for the job is compared to the compare value for the routing entries in a subsystem. When the first match is found, the routing information for that entry is used for the new job; therefore, the sequence numbers indicate the compare order.

This is a required parameter.

1-9999
Specify a sequence number between 1 and 9999.
Top

Examples 

RMVRTGE   SBSD(OR/PERT)  SEQNBR(9912)

This command removes the routing entry 9912 from subsystem description PERT in library OR.

Top

Error messages

*ESCAPE Messages

CPF1619
Subsystem description &1 in library &2 damaged.
CPF1691
Active subsystem description may or may not have changed.
CPF1697
Subsystem description &1 not changed.
Top