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:
- 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 |