CL Command Reference - ADDRTGE
CL Command List > ADDRTGE Reference
Description:
The Add Routing Entry (ADDRTGE) command adds a routing entry to the specified subsystem description. Each routing entry specifies the parameters used to start a routing step for a job. For example, the routing entry specifies the name of the program to run when the routing data that matches the compare value in this routing entry is received.
Notes:
1. The job associated with an active subsystem can only find objects that exist in the system auxiliary storage pool (ASP) or in a basic user ASP. Therefore, objects that are referenced by this command should exist in the system ASP or in a basic user ASP.
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 that subsystem description.
Examples:
Example 1: Adding to the Routing Portion of a Subsystem Description
ADDRTGE SBSD(ORDLIB/PERT) SEQNBR(46) CMPVAL(WRKSTN2)
PGM(ORDLIB/GRAPHIT) CLS(MYLIB/AZERO) MAXACT(*NOMAX)
POOLID(2)
This command adds routing entry 46 to the subsystem description PERT in the ORDLIB library. To use routing entry 46, the routing data must start with the character string WRKSTN2 starting in position 1. Any number of routing steps can be active through this entry at any one time. The program GRAPHIT in the library ORDLIB is to run in storage pool 2 by using class AZERO in library MYLIB.
Example 2: Adding to the Subsystem Description
ADDRTGE SBSD(QGPL/ABLE) SEQNBR(5) CMPVAL(XYZ) PGM(QGPL/REORD) CLS(LIBX/MYCLASS) MAXACT(*NOMAX)
This command adds routing entry 5 to the subsystem description ABLE in the QGPL library. The program REORD in library QGPL is started and uses the class MYCLASS in LIBX when a compare value of XYZ (starting in position 1) is matched in the routing data. The program runs in storage pool 1, and there is no maximum on the number of active routing steps allowed.