End Pass-Through (ENDPASTHR)

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

The End Pass-Through (ENDPASTHR) command ends a pass-through session. The ENDPASTHR command signs you off the target system, and ends the advanced program-to-program communications (APPC) session. This releases the virtual display device from the subsystem and returns it to the vary-on pending condition. The job at each intermediate node for the pass-through session also ends. Control returns to the source system for the next command following the Start Pass-Through (STRPASTHR) command.

Note: The ENDPASTHR command uses the SIGNOFF command as part of its processing. If the system has a SIGNOFF command that appears in the library list before QSYS/SIGNOFF, the SIGNOFF command is used by ENDPASTHR. The SIGNOFF command should not use the ENDPASTHR command. It sends the system into a loop when you end your pass-through session.

The ENDPASTHR command does not end the passthrough session when there is a secondary interactive job at the target system. One of the jobs must be ended (by using SIGNOFF or ENDJOB) before the ENDPASTHR command can be entered.

If the ENDPASTHR command is entered and there is not a pass-through session, an error message is sent.

More information about pass-through is in the Remote Work Station Support book, SC41-5402.

Top

Parameters

Keyword Description Choices Notes
LOG Job log *NOLIST, *LIST Optional, Positional 1
Top

Job log (LOG)

Specifies whether the job log is saved at the target system.

*NOLIST
The information in the job log is deleted when the job ends.
*LIST
A job log is saved at the target system.
Top

Examples

ENDPASTHR   LOG(*LIST)

This command ends a pass-through session and prints a job log.

Top

Error messages

*ESCAPE Messages

CPF8914
ENDPASTHR command not allowed.
CPF8915
ENDPASTHR not allowed. System request job active.
Top