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

102 lines
4.3 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>Transfer Pass-Through (TFRPASTHR)</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="TFRPASTHR.Top_Of_Page"></a>
<h2>Transfer Pass-Through (TFRPASTHR)</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="#TFRPASTHR.PARAMETERS.TABLE">Parameters</a><br>
<a href="#TFRPASTHR.COMMAND.EXAMPLES">Examples</a><br>
<a href="#TFRPASTHR.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="TFRPASTHR"></a>
<p>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.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#TFRPASTHR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="TFRPASTHR.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="#TFRPASTHR.TOJOB"><b>TOJOB</b></a></td>
<td valign="top">To job</td>
<td valign="top"><b><u>*SRC</u></b>, *ALT, *HOME, *HOMEALT</td>
<td valign="top">Optional, Positional 1</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#TFRPASTHR.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="TFRPASTHR.TOJOB"></a>
<h3>To job (TOJOB)</h3>
<p>Specifies the program that is given control when you are transferred to the home system or the previous system.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SRC</u></b></dt>
<dd>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.
</dd>
<dt><b>*ALT</b></dt>
<dd>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.
</dd>
<dt><b>*HOME</b></dt>
<dd>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.
</dd>
<dt><b>*HOMEALT</b></dt>
<dd>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.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#TFRPASTHR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="TFRPASTHR.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
TFRPASTHR TOJOB(*HOME)
</pre>
</p>
<p>This command transfers control back to the source job on the home system.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#TFRPASTHR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="TFRPASTHR.ERROR.MESSAGES">Error messages</a> </h3>
<p>None
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#TFRPASTHR.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>