ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/endpasthr.htm

115 lines
4.2 KiB
HTML

<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>End Pass-Through (ENDPASTHR)</title>
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body bgcolor="white">
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<a name="ENDPASTHR.Top_Of_Page"></a>
<h2>End Pass-Through (ENDPASTHR)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>Interactive environments (*INTERACT *IPGM *IREXX *EXEC)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#ENDPASTHR.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ENDPASTHR.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ENDPASTHR.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ENDPASTHR"></a>
<p>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.
</p>
<p>
<b>Note: </b>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.
</p>
<p>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.
</p>
<p>If the ENDPASTHR command is entered and there is not a pass-through session, an error message is sent.
</p>
<p>More information about pass-through is in the Remote Work Station Support book, SC41-5402.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDPASTHR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ENDPASTHR.PARAMETERS.TABLE">Parameters</a></h3>
<table border="1" cellpadding="4" cellspacing="0">
<!-- col1="10" col2="15" col3="30" col4="10" -->
<tr>
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
</tr>
<tr>
<td valign="top"><a href="#ENDPASTHR.LOG"><b>LOG</b></a></td>
<td valign="top">Job log</td>
<td valign="top"><b><u>*NOLIST</u></b>, *LIST</td>
<td valign="top">Optional, Positional 1</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#ENDPASTHR.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="ENDPASTHR.LOG"></a>
<h3>Job log (LOG)</h3>
<p>Specifies whether the job log is saved at the target system.
</p>
<dl>
</dl>
<dl>
<dt><b><u>*NOLIST</u></b></dt>
<dd>The information in the job log is deleted when the job ends.
</dd>
</dl>
<dl>
<dt><b>*LIST</b></dt>
<dd>A job log is saved at the target system.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDPASTHR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ENDPASTHR.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
ENDPASTHR LOG(*LIST)
</pre>
</p>
<p>This command ends a pass-through session and prints a job log.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDPASTHR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ENDPASTHR.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF8914</b></dt>
<dd>ENDPASTHR command not allowed.
</dd>
<dt><b>CPF8915</b></dt>
<dd>ENDPASTHR not allowed. System request job active.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDPASTHR.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>