CL Command Reference - TFRBCHJOB

CL Command List > TFRBCHJOB Reference

Description:

The Transfer Batch Job (TFRBCHJOB) command transfers a batch job to the specified job queue. The job queue does not have to be allocated to an active subsystem at the time of the batch job transfer. The batch job that is transferred is the one in which this command is issued. Routing data and request data can be specified for the batch job when it is transferred. The routing data specified is processed in the subsystem in which the job queue is active. The request data follows other request data for the job. The transferred batch job resumes running the request data following the transfer.

Restrictions:

1. To use this command, you must have:
. use (*USE) authority to the job queue and execute (*EXECUTE) authority to the library that contains that job queue.

2. The job being transferred must be a batch job that started from a job queue.

3. The TFRBCHJOB command is not allowed to run in a batch communications job (a batch job that was started as the result of a program start request) or a batch immediate job.

Notes:

1. Running this command causes loss of spooled inline files because they cannot be accessed in the new routing step.

2. If you are working in a System/36 environment, the TFRBCHJOB command does not transfer the System/36 environment to the new routing step.

3. If objects allocated to the previous routing step, are needed in the new routing step, they must be allocated again. If files opened in the previous routing step, are needed in the new routing step, they must be opened again.

4. If the TFRBCHJOB command is issued in a CL program, all subsequent commands in the CL program are bypassed.

5. A batch job transferred to a job queue by the TFRBCHJOB command exists through an initial program load (IPL) if the batch job was residing on the job queue at the time the system was powered down. A batch jobĄ¯s temporary objects are destroyed during the power down.

6. The QTEMP library of a batch job that has been transferred by the TFRBCHJOB command is always empty when the next routing step is started. Caution must be used with the library list in conjunction with a batch job that was transferred to a job queue by the TFRBCHJOB command. The TFRBCHJOB function saves the library list to recover the job on a job queue if an IPL occurs. When the routing step for the transferred batch job is started, the libraries in the saved library list must exist in the system or the jobĄ¯s routing step ends.


Examples:

TFRBCHJOB JOBQ(QGPL/APPLICQ) RTGDTA(APPLICS)

This command transfers the batch job in which the command is entered to the APPLICQ job queue that is in the QGPL library. The job is routed using the routing data APPLICS. The job must be a batch job.