Transfer Pass-Through (TFRPASTHR)

Where allowed to run: Interactive environments (*INTERACT *IPGM *IREXX *EXEC)
Threadsafe: No
Parameters
Examples
Error messages

The Transfer Pass-Through (TFRPASTHR) command allows you to transfer from a pass-through system to a source system. It performs the same function as a System Request (SYS REQ) option 10, 11, 13, or 14, and is valid only on a target pass-through system.

Top

Parameters

Keyword Description Choices Notes
TOJOB To job *SRC, *ALT, *HOME, *HOMEALT Optional, Positional 1
Top

To job (TOJOB)

Specifies the program that is given control when you are transferred to the home system or the previous system.

The possible values are:

*SRC
The job on the current system is suspended, and control is transferred back to the program specified on the System request program prompt (SRQ10PGM parameter) of the Start Pass-Through (STRPASTHR) command on the previous system. When the specified program ends, the target system gets control.
*ALT
The job on the target system is suspended, and control is transferred back to the alternate job on the previous system. When control is transferred, the Transfer Job (TFRJOB) command can be used to transfer from the alternate job to the original job, giving control to the target system. Otherwise, when the alternate job ends, the target system gets control.
*HOME
The job on the target system is suspended, and control is transferred back to the program specified on the System request program prompt (SRQ10PGM parameter) of the Start Pass-Through (STRPASTHR) command on the home system. When the specified program ends, the target system gets control.
*HOMEALT
The job on the target system is suspended, and control is transferred back to the alternate job on the home system. When control is transferred, the Transfer Job (TFRJOB) command can be used to transfer from the alternate job to the original job, giving control to the target system. Otherwise, when the alternate job ends, the target system gets control.
Top

Examples

TFRPASTHR   TOJOB(*HOME)

This command transfers control back to the source job on the home system.

Top

Error messages

None

Top