RMVRTGE (Remove Routing Entry)

RMVRTGE Command syntax diagram

 

Purpose

The Remove Routing Entry (RMVRTGE) command is used during system set-up, when work is divided on the system, to remove a specified subsystem description routing entry that controls programs or run attributes for a job. The subsystem can be active at the time.

Restriction: The user, typically a system operator or system administrator, must have both object operational and object management authorities to change the subsystem description.

 

Required Parameters

SBSD

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

The name of the subsystem description can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

subsystem-description-name: Specify the name of the subsystem description.

SEQNBR

Specifies the sequence number of the routing entry being removed. The sequence numbers on the routing entries indicate the order in which 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.

Example for RMVRTGE

RMVRTGE  SBSD(OR/PERT)  SEQNBR(9912)

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

Error messages for RMVRTGE

*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.