ENDPASTHR (End Pass-Through)

ENDPASTHR Command syntax diagram

 

Purpose

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.

 

Optional Parameters

LOG

Specifies whether the JOBLOG is saved at the remote system.

*NOLIST: The information in the job log is deleted when the job ends.

*LIST: The JOBLOG is saved at the remote system.

Example for ENDPASTHR

ENDPASTHR  LOG(*LIST)

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

Error messages for ENDPASTHR

*ESCAPE Messages

CPF8914

ENDPASTHR command not allowed.

CPF8915

ENDPASTHR not allowed. System request job active.