CA 2E Toolkit Commands, YD to YW › YSTRSPLRTR (Start spooled file router)

YSTRSPLRTR (Start spooled file router)

The Start spooled file router (YSTRSPLRTR) command is used to start a spooled file router job to monitor a specified data queue which has previously been attached to one or more output queues. When spooled files on those output queues reach Ready (RDY) status, the spooled file router processes the spooled file (see below for details).

If this command is called interactively, it submits the spooled file router job to batch, using a job description called YSPLRTRJD. If this command is called in batch, the spooled file router job runs under the submitting job profile.

Note: The YSPLRTRJD job description is shipped with this command. You should ensure that it is changed to use a library list that contains all necessary libraries to execute all commands that you specify in the YSPLRTRP file.

The processing that takes place for each spooled file is controlled by the contents of the YSPLRTRP file. Spooled files are compared with records in YSPLRTRP and all matching records on YSPLRTRP (that is, all records on YSPLRTRP where the OUTQ, OUTQLIB, USER, JOB, FILE and USRDTA fields match the spooled file definition and attributes) are processed (see below for processing details) in PRIORITY order.

Note: If any of the OUTQ, OUTQLIB, USER, JOB, FILE or USRDTA fields on YSPLRTRP has the value '*ALL', then that field is assumed to match the equivalent value for the spooled file being processed. Thus a record with all the above fields set to '*ALL' will be considered to match every spooled file.

Note: If a matching record has PRCTYP = 'E' (Exclusive), then after that record has been processed, no further processing is performed on the spooled file. If a matching record has PRCTYP = 'D' (Deleted), then that record is not processed.