621 lines
23 KiB
HTML
621 lines
23 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>Start Pass-Through (STRPASTHR)</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="STRPASTHR.Top_Of_Page"></a>
|
||
|
|
<h2>Start Pass-Through (STRPASTHR)</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="#STRPASTHR.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#STRPASTHR.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#STRPASTHR.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="STRPASTHR"></a>
|
||
|
|
<p>The Start Pass-Through (STRPASTHR) command allows you to pass through to a target system where you can sign on as if you were attached locally. For information on configuring or operating the pass-through function, refer to the Remote Work Station Support book.
|
||
|
|
</p>
|
||
|
|
<p><b>Restriction:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>This command cannot be entered at a work station with a display that has 12 lines by 80 characters.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPASTHR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="STRPASTHR.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="#STRPASTHR.RMTLOCNAME"><b>RMTLOCNAME</b></a></td>
|
||
|
|
<td valign="top">Remote location</td>
|
||
|
|
<td valign="top"><i>Communications name</i>, *CNNDEV</td>
|
||
|
|
<td valign="top">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRPASTHR.CNNDEV"><b>CNNDEV</b></a></td>
|
||
|
|
<td valign="top">APPC device</td>
|
||
|
|
<td valign="top">Single values: <b><u>*LOC</u></b><br>Other values (up to 16 repetitions): <i>Name</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRPASTHR.VRTCTL"><b>VRTCTL</b></a></td>
|
||
|
|
<td valign="top">Virtual controller</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRPASTHR.VRTDEV"><b>VRTDEV</b></a></td>
|
||
|
|
<td valign="top">Virtual display device</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 32 repetitions): <i>Name</i></td>
|
||
|
|
<td valign="top">Optional, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRPASTHR.MODE"><b>MODE</b></a></td>
|
||
|
|
<td valign="top">Mode</td>
|
||
|
|
<td valign="top"><i>Communications name</i>, <b><u>*NETATR</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRPASTHR.LCLLOCNAME"><b>LCLLOCNAME</b></a></td>
|
||
|
|
<td valign="top">Local location</td>
|
||
|
|
<td valign="top"><i>Communications name</i>, <b><u>*LOC</u></b>, *NETATR</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRPASTHR.RMTNETID"><b>RMTNETID</b></a></td>
|
||
|
|
<td valign="top">Remote network identifier</td>
|
||
|
|
<td valign="top"><i>Communications name</i>, <b><u>*LOC</u></b>, *NETATR, *NONE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#STRPASTHR.SRQ10PGM"><b>SRQ10PGM</b></a></td>
|
||
|
|
<td valign="top">System request program</td>
|
||
|
|
<td valign="top">Single values: <b><u>*SRQMNU</u></b><br>Other values: <i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: System request program</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top"><a href="#STRPASTHR.RMTUSER"><b>RMTUSER</b></a></td>
|
||
|
|
<td valign="top">User profile</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b>, *CURRENT</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRPASTHR.RMTPWD"><b>RMTPWD</b></a></td>
|
||
|
|
<td valign="top">User password</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRPASTHR.RMTINLPGM"><b>RMTINLPGM</b></a></td>
|
||
|
|
<td valign="top">Initial program to call</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*RMTUSRPRF</u></b>, *NONE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRPASTHR.RMTINLMNU"><b>RMTINLMNU</b></a></td>
|
||
|
|
<td valign="top">Initial menu</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*RMTUSRPRF</u></b>, *SIGNOFF</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRPASTHR.RMTCURLIB"><b>RMTCURLIB</b></a></td>
|
||
|
|
<td valign="top">Current library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*RMTUSRPRF</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRPASTHR.PASTHRSCN"><b>PASTHRSCN</b></a></td>
|
||
|
|
<td valign="top">Display option</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*YES</u></b>, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPASTHR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="STRPASTHR.RMTLOCNAME"></a>
|
||
|
|
<h3>Remote location (RMTLOCNAME)</h3>
|
||
|
|
<p>Specifies one of the following:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>If (*LOC) is specified for the <b>APPC device</b> prompt (CNNDEV parameter), the RMTLOCNAME parameter specifies the name of the remote location that is the target of the pass-through session.
|
||
|
|
</li>
|
||
|
|
<li>If any devices are specified on the CNNDEV parameter, the RMTLOCNAME parameter specifies the first system to do intermediate pass-through routing.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>remote-location-name</i></b></dt>
|
||
|
|
<dd>Specify the remote location name that is the target of the pass-through session or the first system that does intermediate pass-through routing. APPN determines the route to this location.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CNNDEV</b></dt>
|
||
|
|
<dd>Use the APPC devices specified with the <b>APPC device</b> prompt (CNNDEV parameter).
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPASTHR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPASTHR.CNNDEV"></a>
|
||
|
|
<h3>APPC device (CNNDEV)</h3>
|
||
|
|
<p>Specifies the names of the device descriptions that connect the first system to do pass-through routing with the target system. If *CNNDEV is specified on the Remote location prompt (RMTLOCNAME parameter), the first device specified on this parameter is on the source system. If the name of a remote location is specified on the Remote location prompt (RMTLOCNAME parameter), the first device specified on this parameter is on the system in that remote location. If another system connects the source system to the target system and pass-through must establish the intermediate sessions, then you must specify a list of APPC device descriptions. The APPC device names must be listed in the order that the systems are passed through to get to the target system.
|
||
|
|
</p>
|
||
|
|
<p>You can enter multiple values for this parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LOC</u></b></dt>
|
||
|
|
<dd>The <b>Remote location</b> prompt (RMTLOCNAME parameter) specifies the name of the remote location that is the target of the pass-through session.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>device-name(s)</i></b></dt>
|
||
|
|
<dd>Specify the names of the device descriptions that complete the route from the source system to the target system. Up to 16 names can be specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPASTHR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPASTHR.VRTCTL"></a>
|
||
|
|
<h3>Virtual controller (VRTCTL)</h3>
|
||
|
|
<p>Specifies the name of the virtual controller on the remote system that is used to do pass-through jobs. If you specify a virtual controller, one of the virtual display devices attached to it is selected for the pass-through job. A device on the target system is selected based on a comparison of device type and model.
|
||
|
|
</p>
|
||
|
|
<p>This entry is mutually exclusive with an entry on the <b>Virtual display device</b> prompt (VRTDEV parameter); *NONE must be specified when one or more devices are specified on the <b>Virtual display device</b> prompt (VRTDEV parameter).
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No controller is specified. If *NONE is also specified on the <b>Virtual display device</b> prompt (VRTDEV parameter), you are requesting automatic configuration.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>virtual-controller-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the virtual controller description on the target system.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPASTHR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPASTHR.VRTDEV"></a>
|
||
|
|
<h3>Virtual display device (VRTDEV)</h3>
|
||
|
|
<p>Specifies one or more devices on the target system that are connected to a virtual controller used for the pass-through session. A device on the target system from the list is selected based on a comparison of device type and model.
|
||
|
|
</p>
|
||
|
|
<p>This entry is mutually exclusive with an entry on the <b>Virtual controller</b> prompt (VRTCTL parameter); *NONE must be specified when a controller name is specified on the <b>Virtual controller</b> prompt (VRTCTL parameter).
|
||
|
|
</p>
|
||
|
|
<p>You can enter multiple values for this parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No device names are specified. If *NONE is also specified on the <b>Virtual controller</b> prompt (VRTCTL parameter), you are requesting automatic configuration.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>virtual-display-device-name</i></b></dt>
|
||
|
|
<dd>Specify the names of the virtual display device descriptions on the target system. Up to 32 names can be specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPASTHR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPASTHR.MODE"></a>
|
||
|
|
<h3>Mode (MODE)</h3>
|
||
|
|
<p>Specifies the mode name used.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NETATR</b></dt>
|
||
|
|
<dd>The mode in the network attributes is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>mode-name</i></b></dt>
|
||
|
|
<dd>Specify a mode name.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPASTHR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPASTHR.LCLLOCNAME"></a>
|
||
|
|
<h3>Local location (LCLLOCNAME)</h3>
|
||
|
|
<p>Specifies the local location name.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LOC</u></b></dt>
|
||
|
|
<dd>The local location name is chosen by the system.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NETATR</b></dt>
|
||
|
|
<dd>The LCLLOCNAME value specified in the system network attributes is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>APPN-location-name</i></b></dt>
|
||
|
|
<dd>Specify the local location name that is associated with the source system. If the local location name is not valid, an escape message is sent.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPASTHR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPASTHR.RMTNETID"></a>
|
||
|
|
<h3>Remote network identifier (RMTNETID)</h3>
|
||
|
|
<p>Specifies the network ID of the network where the remote location resides.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LOC</u></b></dt>
|
||
|
|
<dd>Any remote network ID for the remote location may be used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NETATR</b></dt>
|
||
|
|
<dd>The LCLNETID value specified in the system network attributes is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>The remote location does not support network identifiers.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>APPN-network-identifier</i></b></dt>
|
||
|
|
<dd>Specify a remote network ID.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPASTHR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPASTHR.SRQ10PGM"></a>
|
||
|
|
<h3>System request program (SRQ10PGM)</h3>
|
||
|
|
<p>Specifies that the system request menu is displayed, or specifies the name of the program that starts on the source system when system request option 10 is selected.
|
||
|
|
</p>
|
||
|
|
<p>The user program can display a menu that allows you to select the system you want to access, and then transfer to a group job that sends the Start Pass-Through (STRPASTHR) command to the desired system. For more information, see the Remote Work Station Support book.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SRQMNU</u></b></dt>
|
||
|
|
<dd>The system request menu on the source system is displayed.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>program-name</i></b></dt>
|
||
|
|
<dd>Specify the program and library names of the program started when system request option 10 is selected.
|
||
|
|
<p>The possible library values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
|
<dd>The library list is used to locate the program.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>The current library for the job is used to locate the program. If no current library entry exists in the library list, QGPL is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>library-name</i></b></dt>
|
||
|
|
<dd>Specify the library where the program is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPASTHR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPASTHR.RMTUSER"></a>
|
||
|
|
<h3>User profile (RMTUSER)</h3>
|
||
|
|
<p>Specifies the user profile for automatic sign-on to the target system. If a profile is specified for this parameter and password security is active on the target system, (*NONE) is not valid for the User password prompt (RMTPWD parameter).
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No user profile name is sent, and no automatic sign-on occurs.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURRENT</b></dt>
|
||
|
|
<dd>The user profile of the job using this command is sent. If the target system allows it, and the user profile exists on the target system, and the password specified in the RMTPWD parameter is valid for the profile, the user is automatically signed on. Otherwise, the user is presented with a sign-on display on the target system or a failure message on the source system, depending on the configuration of the target system.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>profile-name</i></b></dt>
|
||
|
|
<dd>Specify a user profile name to use that exists on the target system. If the target system allows it, and if the user profile exists on the target system, the user is automatically signed on. Otherwise, the user is presented with a sign-on display on the target system or a failure message on the source system, depending on the configuration of the target system. If a profile is specified and password security is active on the target system, a password must be specified, even if the profile specified is the same as the current profile.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPASTHR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPASTHR.RMTPWD"></a>
|
||
|
|
<h3>User password (RMTPWD)</h3>
|
||
|
|
<p>Specifies the password being sent to the target system.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>The system does not send a password. If a profile is specified on the <b>User profile</b> prompt (RMTUSER parameter), and password security is active on the target system, this value is not allowed.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>password</i></b></dt>
|
||
|
|
<dd>Specify a password being sent to the target system to verify the sign-on of the user specified in the RMTUSER parameter. This password is encrypted before being sent across the communication line.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPASTHR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPASTHR.RMTINLPGM"></a>
|
||
|
|
<h3>Initial program to call (RMTINLPGM)</h3>
|
||
|
|
<p>Specifies the program that is called immediately after you sign on.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*RMTUSRPRF</u></b></dt>
|
||
|
|
<dd>The initial program specified in the remote user profile is called immediately after automatic sign-on.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>No program is run before the initial menu is shown, even if an initial program is specified in the remote user profile.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>program</i></b></dt>
|
||
|
|
<dd>Specify the name of a program that is called immediately after automatic sign-on.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPASTHR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPASTHR.RMTINLMNU"></a>
|
||
|
|
<h3>Initial menu (RMTINLMNU)</h3>
|
||
|
|
<p>Specifies the first menu shown when you are automatically signed on to the target system after the initial program is run.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*RMTUSRPRF</u></b></dt>
|
||
|
|
<dd>The initial menu specified in the remote user profile is shown immediately after the initial program is run.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SIGNOFF</b></dt>
|
||
|
|
<dd>A menu is not shown after the initial program is run, even if an initial menu is specified in the remote user profile. After the initial program ends, the user is signed off, and the pass-through session ends.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>menu</i></b></dt>
|
||
|
|
<dd>Specify the menu that is shown immediately after the initial program is run.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPASTHR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPASTHR.RMTCURLIB"></a>
|
||
|
|
<h3>Current library (RMTCURLIB)</h3>
|
||
|
|
<p>Specifies the name of the library that becomes the current library in the library list of the job after automatic sign-on.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*RMTUSRPRF</u></b></dt>
|
||
|
|
<dd>The current library specified in the remote user profile becomes the current library in the library list after automatic sign-on.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>library</i></b></dt>
|
||
|
|
<dd>Specify the library that becomes the current library in the library list after automatic sign-on.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPASTHR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPASTHR.PASTHRSCN"></a>
|
||
|
|
<h3>Display option (PASTHRSCN)</h3>
|
||
|
|
<p>Specifies whether the pass-through display and associated status messages appear before the pass-through session is established.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*YES</u></b></dt>
|
||
|
|
<dd>The pass-through display and information messages are shown before the pass-through session is established.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>The pass-through display and information messages are not shown before the pass-through session is established.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPASTHR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="STRPASTHR.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Pass-Through to Toronto</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
STRPASTHR RMTLOCNAME(*CNNDEV) CNNDEV(DET CHI TOR) VRTCTL(VWSC)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command specifies starting a pass-through to the Toronto system by going through Detroit and Chicago. More information is in the <b>Remote Work Station Support</b> book located in the Information Center.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Pass-Through to Detroit</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
STRPASTHR RMTLOCNAME(DETROIT) VRTCTL(VWSC)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command specifies a pass-through to the Detroit system. APPN establishes the route to Detroit.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 3: Pass-Through to Toronto</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
STRPASTHR RMTLOCNAME(DETROIT) CNNDEV(CHI TOR) VRTCTL(VWSC)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command specifies another way to pass-through to the Toronto system by going through Chicago and Detroit. APPN establishes the route to Detroit.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 4: Pass-Through to Detroit</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
STRPASTHR RMTLOCNAME(DETROIT) RMTUSER(*CURRENT)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command specifies a pass-through to the DETROIT system and an automatic sign-on using the user profile with the same name as the one currently used on the source system. It also specifies that the DETROIT system automatically configures a virtual device for the pass-through session, since a virtual controller or virtual device was not specified.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPASTHR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="STRPASTHR.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF2702</b></dt>
|
||
|
|
<dd>Device description &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2703</b></dt>
|
||
|
|
<dd>Controller description &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF5383</b></dt>
|
||
|
|
<dd>Mode &7 specified for device &4 not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF5536</b></dt>
|
||
|
|
<dd>System cannot automatically select an APPC device description for the remote location.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF5546</b></dt>
|
||
|
|
<dd>Class-of-service for device &4 not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8901</b></dt>
|
||
|
|
<dd>Virtual device &1 not varied on.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8902</b></dt>
|
||
|
|
<dd>Virtual device &1 not available.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8903</b></dt>
|
||
|
|
<dd>Device &1 not valid for pass-through.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8904</b></dt>
|
||
|
|
<dd>Pass-through request not accepted.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8905</b></dt>
|
||
|
|
<dd>Pass-through not allowed on this system.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8906</b></dt>
|
||
|
|
<dd>Error during session initialization. Reason code &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8907</b></dt>
|
||
|
|
<dd>Communications failure for device &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8908</b></dt>
|
||
|
|
<dd>Controller &1 not varied on.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8909</b></dt>
|
||
|
|
<dd>Old software release. Pass-through ended.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8910</b></dt>
|
||
|
|
<dd>Controller &1 not valid for pass-through.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8911</b></dt>
|
||
|
|
<dd>Communications failure. Session was not started.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8912</b></dt>
|
||
|
|
<dd>Pass-through session ended. Reason code &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8913</b></dt>
|
||
|
|
<dd>Pass-through ended abnormally.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8916</b></dt>
|
||
|
|
<dd>Cannot select virtual device &1 at system &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8917</b></dt>
|
||
|
|
<dd>Not authorized to &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8918</b></dt>
|
||
|
|
<dd>Job canceled at system &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8919</b></dt>
|
||
|
|
<dd>Device &1 not accessed by system &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8920</b></dt>
|
||
|
|
<dd>Pass-through failed. &1 must be varied off and on.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8921</b></dt>
|
||
|
|
<dd>APPC failure. Failure code is &3.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8922</b></dt>
|
||
|
|
<dd>Negative response from device &1 at system &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8923</b></dt>
|
||
|
|
<dd>Data stream received at system &1 not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8924</b></dt>
|
||
|
|
<dd>No available virtual controller.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8925</b></dt>
|
||
|
|
<dd>Device &1 not created.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8928</b></dt>
|
||
|
|
<dd>Device &1 could not be changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8929</b></dt>
|
||
|
|
<dd>Device &1 could not be varied on.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8931</b></dt>
|
||
|
|
<dd>Location &1 not an APPC location.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8932</b></dt>
|
||
|
|
<dd>Device &1 must be non-networking APPC device.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8933</b></dt>
|
||
|
|
<dd>Route to specified location not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8935</b></dt>
|
||
|
|
<dd>Pass-through not allowed to system &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8936</b></dt>
|
||
|
|
<dd>Pass-through failed for security reasons.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8937</b></dt>
|
||
|
|
<dd>Automatic sign on not allowed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8938</b></dt>
|
||
|
|
<dd>Error in QRMTSIGN program. Pass-through failed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8939</b></dt>
|
||
|
|
<dd>Trying to send too much data.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8940</b></dt>
|
||
|
|
<dd>Cannot automatically select virtual device.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8941</b></dt>
|
||
|
|
<dd>Incorrect internal use of pass-through.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8943</b></dt>
|
||
|
|
<dd>Pass-through not allowed from server TELNET session.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b><u>*STATUS Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPI8901</b></dt>
|
||
|
|
<dd>No matching device on remote system. Function limited.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPI8902</b></dt>
|
||
|
|
<dd>Pass-through started at system &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPI8903</b></dt>
|
||
|
|
<dd>Virtual device &1 selected at system &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPI8906</b></dt>
|
||
|
|
<dd>Automatic sign-on not allowed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPASTHR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|