597 lines
28 KiB
HTML
597 lines
28 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 Remote Support (STRRMTSPT)</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="STRRMTSPT.Top_Of_Page"></a>
|
||
|
|
<h2>Start Remote Support (STRRMTSPT)</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="#STRRMTSPT.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#STRRMTSPT.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#STRRMTSPT.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="STRRMTSPT"></a>
|
||
|
|
<p>The Start Remote Support (STRRMTSPT) command creates and varies on all configuration objects needed for remote support. Remote support allows the IBM service organization to access your system. Remote support options that are available include:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>remote work station
|
||
|
|
</li>
|
||
|
|
<li>virtual device
|
||
|
|
</li>
|
||
|
|
<li>virtual device over a systems network architecture (SNA) connection
|
||
|
|
</li>
|
||
|
|
<li>virtual device over a point-to-point protocol (PPP) connection using internet protocol (IP)
|
||
|
|
</li>
|
||
|
|
<li>virtual device over a virtual private network (VPN) connection using internet protocol (IP)
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>Each remote support option has different command parameters that are required for connectivity. If any existing remote support configuration objects are found, they are deleted and then re-created. After the configuration objects have been created, they are varied on. You must provide a user identifier and password before the support person can sign-on your system.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>When using DEVCLS(*RMT), the remote work station used by a support organization must be one of those listed in the DSPTYPE and DSPMODEL parameters. If your support organization has a configuration that does not match, you must work with the support person to create the correct configuration objects on your system.
|
||
|
|
</li>
|
||
|
|
<li>When using DEVCLS(*VRT) or DEVCLS(*IPS), the QUSER user profile must not be disabled.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRMTSPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="STRRMTSPT.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="#STRRMTSPT.DEVCLS"><b>DEVCLS</b></a></td>
|
||
|
|
<td valign="top">Device class</td>
|
||
|
|
<td valign="top">*RMT, *VRT, *IPS, *PPP, *VPN</td>
|
||
|
|
<td valign="top">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRMTSPT.DSPTYPE"><b>DSPTYPE</b></a></td>
|
||
|
|
<td valign="top">Display type</td>
|
||
|
|
<td valign="top">3179, 3180, 3196, 3197, 5251, 5291, 5292</td>
|
||
|
|
<td valign="top">Optional, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRMTSPT.DSPMODEL"><b>DSPMODEL</b></a></td>
|
||
|
|
<td valign="top">Display model</td>
|
||
|
|
<td valign="top">1, 2, 11, A1, A2, B1, B2, C1, C2, D1, D2, W1, W2, 0001, 0002, 0011</td>
|
||
|
|
<td valign="top">Optional, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRMTSPT.STNADR"><b>STNADR</b></a></td>
|
||
|
|
<td valign="top">Station address</td>
|
||
|
|
<td valign="top">01-FE, <b><u>FE</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 4</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRMTSPT.USRPRF"><b>USRPRF</b></a></td>
|
||
|
|
<td valign="top">User profile</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>QPGMR</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 5</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRMTSPT.RSRCNAME"><b>RSRCNAME</b></a></td>
|
||
|
|
<td valign="top">Resource name</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*DFT</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 6</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRMTSPT.RMTLOCNAME"><b>RMTLOCNAME</b></a></td>
|
||
|
|
<td valign="top">Remote location</td>
|
||
|
|
<td valign="top"><i>Communications name</i>, <b><u>QREMOTE</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 7</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRMTSPT.LCLLOCNAME"><b>LCLLOCNAME</b></a></td>
|
||
|
|
<td valign="top">Local location</td>
|
||
|
|
<td valign="top"><i>Communications name</i>, <b><u>QLOCAL</u></b>, *NETATR</td>
|
||
|
|
<td valign="top">Optional, Positional 8</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRMTSPT.RMTNETID"><b>RMTNETID</b></a></td>
|
||
|
|
<td valign="top">Remote network identifier</td>
|
||
|
|
<td valign="top"><i>Communications name</i>, *NETATR, <b><u>*NONE</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRMTSPT.MAXLENRU"><b>MAXLENRU</b></a></td>
|
||
|
|
<td valign="top">Maximum length of request unit</td>
|
||
|
|
<td valign="top">241-32767, <b><u>32767</u></b>, *SAME, *CALC</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRMTSPT.DTACPR"><b>DTACPR</b></a></td>
|
||
|
|
<td valign="top">Data compression</td>
|
||
|
|
<td valign="top">*SAME, *NETATR, *NONE, *ALLOW, <b><u>*REQUEST</u></b>, *REQUIRE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRMTSPT.INDTACPR"><b>INDTACPR</b></a></td>
|
||
|
|
<td valign="top">Inbound data compression</td>
|
||
|
|
<td valign="top">*SAME, *RLE, *LZ9, *LZ10, <b><u>*LZ12</u></b>, *NONE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRMTSPT.OUTDTACPR"><b>OUTDTACPR</b></a></td>
|
||
|
|
<td valign="top">Outbound data compression</td>
|
||
|
|
<td valign="top">*SAME, *RLE, *LZ9, *LZ10, <b><u>*LZ12</u></b>, *NONE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRMTSPT.MODEM"><b>MODEM</b></a></td>
|
||
|
|
<td valign="top">Modem</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*RSRCNAME</u></b>, *RMTPPP, *SELECT</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRMTSPT.MDMRMTSYS"><b>MDMRMTSYS</b></a></td>
|
||
|
|
<td valign="top">Modem remote system</td>
|
||
|
|
<td valign="top"><i>Character value</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRMTSPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="STRRMTSPT.DEVCLS"></a>
|
||
|
|
<h3>Device class (DEVCLS)</h3>
|
||
|
|
<p>Specifies the device class for this display station. Different configuration objects are created, depending on the value specified.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*RMT</u></b></dt>
|
||
|
|
<dd>This device class is for a device connected to a remote work station. The configuration objects created for this option include a line description, a controller description, a display device description, and a printer device description.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*VRT</b></dt>
|
||
|
|
<dd>This device class is for a virtual device. The configuration objects created for this option include a line description, a controller description, a device description, a virtual control description, and a virtual display device description.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*IPS</b></dt>
|
||
|
|
<dd>This device class is for a virtual device and also supports internet protocol (IP) over SNA sessions on this connection. The configuration objects created for this option include a line description, a controller description, a device description, a virtual control description, and a virtual display device description.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PPP</b></dt>
|
||
|
|
<dd>This device class supports IP over a point-to-point protocol (PPP) connection. The configuration objects created for this option include a line description, a controller description, a device description, and a PPP profile. DEVCLS(*PPP) requires that the QRETSVRSEC system value be set to '1' to retain server security data. This allows for additional authentication to be performed when the service organization attempts to connect.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*VPN</b></dt>
|
||
|
|
<dd>This device class supports IP over a virtual private network (VPN) connection. The Universal Connection wizard must be run before running the STRRMTSPT command in order to set up a VPN configuration on the system. Once the STRRMTSPT command is entered, eleven alphanumeric characters are displayed on your screen. These characters need to be told to the Customer Support Representative for a complete connection to be established. No configuration objects are created for this option.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRMTSPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRMTSPT.DSPTYPE"></a>
|
||
|
|
<h3>Display type (DSPTYPE)</h3>
|
||
|
|
<p>Specifies the workstation display device type which will be used for remote support. A value must be specified for this parameter when DEVCLS has a value of *RMT, *VRT, or *IPS.
|
||
|
|
</p>
|
||
|
|
<p>Valid display station type values are:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>3179
|
||
|
|
</li>
|
||
|
|
<li>3180
|
||
|
|
</li>
|
||
|
|
<li>3196
|
||
|
|
</li>
|
||
|
|
<li>3197
|
||
|
|
</li>
|
||
|
|
<li>5251
|
||
|
|
</li>
|
||
|
|
<li>5291
|
||
|
|
</li>
|
||
|
|
<li>5292
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRMTSPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRMTSPT.DSPMODEL"></a>
|
||
|
|
<h3>Display model (DSPMODEL)</h3>
|
||
|
|
<p>Specifies the model number of the device for this description. A value must be specified for this parameter when DEVCLS has a value of *RMT, *VRT, or *IPS.
|
||
|
|
</p>
|
||
|
|
<p>The possible values for the device model for each device type are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>TYPE</b></dt>
|
||
|
|
<dd><b> MODEL
|
||
|
|
</b></dd>
|
||
|
|
<dt><b>3179</b></dt>
|
||
|
|
<dd>2
|
||
|
|
</dd>
|
||
|
|
<dt><b>3180</b></dt>
|
||
|
|
<dd>2
|
||
|
|
</dd>
|
||
|
|
<dt><b>3196</b></dt>
|
||
|
|
<dd>A1, A2, B1, or B2
|
||
|
|
</dd>
|
||
|
|
<dt><b>3197</b></dt>
|
||
|
|
<dd>C1, C2, D1, D2, W1, or W2
|
||
|
|
</dd>
|
||
|
|
<dt><b>5251</b></dt>
|
||
|
|
<dd>11
|
||
|
|
</dd>
|
||
|
|
<dt><b>5291</b></dt>
|
||
|
|
<dd>1, or 2
|
||
|
|
</dd>
|
||
|
|
<dt><b>5292</b></dt>
|
||
|
|
<dd>1, or 2
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRMTSPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRMTSPT.STNADR"></a>
|
||
|
|
<h3>Address (STNADR)</h3>
|
||
|
|
<p>Depending on the value specified for the DEVCLS parameter, this parameter specifies the address that will be used for either the station address or the local IP address qualifier. If the DEVCLS is not *PPP or *VPN, then this parameter specifies the station address. The station address is the hexadecimal address by which the local system is known to the remote system. The hexadecimal address is the polling address assigned to this system.
|
||
|
|
</p>
|
||
|
|
<p>If the DEVCLS is *IPS, *PPP, or *VPN, this parameter is used as the local IP address qualifier. This specifies the value of the last byte of the local internet address that will be used.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>FE</u></b></dt>
|
||
|
|
<dd>The hexadecimal value FE is the local system address.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>address</i></b></dt>
|
||
|
|
<dd>Specify a hexadecimal value from 01 to FE.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRMTSPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRMTSPT.USRPRF"></a>
|
||
|
|
<h3>User profile (USRPRF)</h3>
|
||
|
|
<p>Specifies the name of the user profile that the IBM service personnel will use to sign on to your system. This profile is made the owner of the objects created by the system when remote support is started. The user profile must already exist on your system.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>QPGMR</u></b></dt>
|
||
|
|
<dd>The default system-supplied user profile, QPGMR, is used to sign on to your system.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>user-profile-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the existing user profile that will be used to sign on to the remote system.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRMTSPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRMTSPT.RSRCNAME"></a>
|
||
|
|
<h3>Resource name (RSRCNAME)</h3>
|
||
|
|
<p>Specifies the name of the resource used to access iSeries electronic customer support. This parameter is not used for DEVCLS(*VPN).
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*DFT</u></b></dt>
|
||
|
|
<dd>
|
||
|
|
<ul>
|
||
|
|
<li>For DEVCLS(*PPP):
|
||
|
|
<ul>
|
||
|
|
<li>Look for resources being used by the 2771 or 2793 integrated modem. If only one 2771 or 2793 is defined, that resource is used for this PPP line. Note that more than one 2771 or 2793 could be defined, but a 2771 or 2793 resource can only be calculated if only one is defined.
|
||
|
|
</li>
|
||
|
|
<li>If a 2771 or 2793 modem resource cannot be used, determine if any resources are defined for use by electronic customer support (ECS). If an ECS resource is available, that resource is used for this PPP line.
|
||
|
|
</li>
|
||
|
|
<li>If neither a single 2771 or 2793 integrated modem or ECS resource is available, the resource cannot be calculated and it will have to be explicitly specified.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>For all other DEVCLS values (except *VPN): The resource name associated with the shipped default port for accessing electronic customer support is used. This is the first port on the I/O (input/output) adapter in card position B of the first multifunction IOP (input/output processor) on the bus. If this port does not exist on the system, resource name CMN01 is used.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>resource-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the resource used to access electronic customer support.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRMTSPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRMTSPT.RMTLOCNAME"></a>
|
||
|
|
<h3>Remote location (RMTLOCNAME)</h3>
|
||
|
|
<p>Specifies the remote location name of the system with which this object communicates. This parameter is used when DEVCLS is *VRT or *IPS.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>QREMOTE</u></b></dt>
|
||
|
|
<dd>The default system-supplied remote support location name.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>remote-location-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the remote support location.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRMTSPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRMTSPT.LCLLOCNAME"></a>
|
||
|
|
<h3>Local location (LCLLOCNAME)</h3>
|
||
|
|
<p>Specifies the unique location name that identifies the local system to remote devices. The name cannot be the same as that specified for the <b>Remote location</b> prompt (RMTLOCNAME parameter). The combination of the names specified for the <b>Local location</b> prompt (LCLLOCNAME parameter) and the <b>Remote location</b> prompt (RMTLOCNAME parameter) must be unique for each device attached to the same controller. This parameter is used when the DEVCLS parameter has a value of *VRT or *IPS.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>QLOCAL</u></b></dt>
|
||
|
|
<dd>The default system-supplied local location name is used.
|
||
|
|
</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>local-location-name</i></b></dt>
|
||
|
|
<dd>Specify the location name to be used to identify the local system to remote devices.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRMTSPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRMTSPT.RMTNETID"></a>
|
||
|
|
<h3>Remote network identifier (RMTNETID)</h3>
|
||
|
|
<p>Specifies the name of the remote network in which the remote system resides. This parameter is used when the DEVCLS parameter has a value of *VRT or *IPS.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No remote network name is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>remote-network-name</i></b></dt>
|
||
|
|
<dd>Specify the remote network name.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRMTSPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRMTSPT.MAXLENRU"></a>
|
||
|
|
<h3>Maximum length of request unit (MAXLENRU)</h3>
|
||
|
|
<p>Specifies the maximum request unit (RU) length allowed. This parameter is used when the DEVCLS parameter has a value of *VRT or *IPS.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>32767</u></b></dt>
|
||
|
|
<dd>The maximum request unit length is 32767 bytes.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CALC</b></dt>
|
||
|
|
<dd>The system calculates the maximum value to use.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>maximum-request-unit-length</i></b></dt>
|
||
|
|
<dd>Specify a value, ranging from 241 through 32767 bytes, for the maximum length of incoming request units.
|
||
|
|
<p>Some common values, based on line type, are:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>SDLC lines: 256, 512, 1024, 2048
|
||
|
|
</li>
|
||
|
|
<li>Token-Ring Network lines: 256, 512, 1024, 1985
|
||
|
|
</li>
|
||
|
|
<li>X.25 (QLLC) lines: 247, 503, 1015
|
||
|
|
</li>
|
||
|
|
<li>X.25 (ELLC) lines: 241, 497, 1009
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>More information on setting the maximum RU length is in the Communications Configuration book, SC41-5401 book.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRMTSPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRMTSPT.DTACPR"></a>
|
||
|
|
<h3>Data compression (DTACPR)</h3>
|
||
|
|
<p>Specifies whether data compression is used.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*REQUEST</u></b></dt>
|
||
|
|
<dd>Data compression is requested on the session by the local system. However, the request can be refused or changed to lower compression levels by the remote system. Data compression is allowed on the session if requested by the remote system. The requested compression levels for inbound and outbound data are the levels specified on the <b>Inbound data compression</b> and <b>Outbound data compression</b> prompts (INDTACPR and OUTDTACPR parameters).
|
||
|
|
<p>If data compression is requested by the remote system, the data compression levels used by the session are the lower of the requested levels and the levels specified on the <b>Inbound data compression</b> and <b>Outbound data compression</b> prompts (INDTACPR and OUTDTACPR parameters).
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>Compression is not allowed on the session.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALLOW</b></dt>
|
||
|
|
<dd>Data compression is allowed on the session by the local system if requested by a remote system. The local system does not request compression.
|
||
|
|
<p>If data compression is requested by the remote system, the data compression levels used by the session are the lower of the requested levels and the levels specified on the <b>Inbound data compression</b> and <b>Outbound data compression</b> prompts (INDTACPR and OUTDTACPR parameters).
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*REQUIRE</b></dt>
|
||
|
|
<dd>Data compression is required on the session. If the remote system does not accept the local system's exact required levels of compression, the session is not established.
|
||
|
|
<p>The data compression levels that the local system require are the levels specified on the <b>Inbound data compression</b> and <b>Outbound data compression</b> prompts (INDTACPR and OUTDTACPR parameters).
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRMTSPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRMTSPT.INDTACPR"></a>
|
||
|
|
<h3>Inbound data compression (INDTACPR)</h3>
|
||
|
|
<p>Specifies the desired level of compression for inbound data. No data compression occurs if *NONE is specified on the <b>Data compression</b> prompt (DTACPR parameter). Adaptive dictionary-based compression is a dynamic compression algorithm, similar to Lempel-Ziv, that compresses previously seen strings to 9-, 10-, and 12-bit codes. This algorithm is referred to as LZ in the following parameters.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LZ12</u></b></dt>
|
||
|
|
<dd>The LZ algorithm with the 12-bit code for repeated substrings in the data stream is used. These codes refer to entries in a common dictionary, created as the data flows between the sender and receiver. The LZ algorithms require storage and extra processing time. LZ12 requires the most storage and processing time of the LZ algorithms; however, it compresses the data stream the most.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RLE</b></dt>
|
||
|
|
<dd>The Run Length Encoding (RLE) algorithm is used. RLE substitutes a 1- or 2-byte sequence in the data stream for each repeated occurrence of the same character. This algorithm requires no storage and less processing time than the other options.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LZ9</b></dt>
|
||
|
|
<dd>The LZ algorithm with the 9-bit code for repeated substrings in the data stream is used. These codes refer to entries in a common dictionary, created as the data flows between the sender and receiver. The LZ algorithms require storage and extra processing time. The LZ9 requires the least storage and processing time of the LZ algorithms; however, it compresses the data stream the least.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LZ10</b></dt>
|
||
|
|
<dd>The LZ algorithm with the 10-bit code for repeated substrings in the data stream is used. These codes refer to entries in a common dictionary, created as the data flows between the sender and receiver. The LZ algorithms require storage and extra processing time. The LZ10 table algorithm requires more storage and processing time than the LZ9, but less than the LZ12. The LZ10 compresses the data stream more than the LZ9, but less than the LZ12.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRMTSPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRMTSPT.OUTDTACPR"></a>
|
||
|
|
<h3>Outbound data compression (OUTDTACPR)</h3>
|
||
|
|
<p>Specifies the desired level of compression for outbound data. No data compression occurs if *NONE is specified on the <b>Data compression</b> prompt (DTACPR parameter).
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LZ12</u></b></dt>
|
||
|
|
<dd>The LZ algorithm with the 12-bit code for repeated substrings in the data stream is used. These codes refer to entries in a common dictionary, created as the data flows between the sender and receiver. The LZ algorithms require storage and extra processing time. LZ12 requires the most storage and processing time of the LZ algorithms; however, it compresses the data stream the most.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RLE</b></dt>
|
||
|
|
<dd>The Run Length Encoding (RLE) algorithm is used. RLE substitutes a 1- or 2-byte sequence in the data stream for each repeated occurrence of the same character. This algorithm requires no storage and less processing time than the other options.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LZ9</b></dt>
|
||
|
|
<dd>The LZ algorithm with the 9-bit code for repeated substrings in the data stream is used. These codes refer to entries in a common dictionary, created as the data flows between the sender and receiver. The LZ algorithms require storage and extra processing time. The LZ9 requires the least storage and processing time of the LZ algorithms; however, it compresses the data stream the least.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LZ10</b></dt>
|
||
|
|
<dd>The LZ algorithm with the 10-bit code for repeated substrings in the data stream is used. These codes refer to entries in a common dictionary, created as the data flows between the sender and receiver. The LZ algorithms require storage and extra processing time. The LZ10 table algorithm requires more storage and processing time than the LZ9, but less than the LZ12. The LZ10 compresses the data stream more than the LZ9, but less than the LZ12.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRMTSPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRMTSPT.MODEM"></a>
|
||
|
|
<h3>Modem (MODEM)</h3>
|
||
|
|
<p>Specifies the modem description to use for the point-to-point protocol (PPP) profile.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*RSRCNAME</u></b></dt>
|
||
|
|
<dd>The modem description will be determined based on the value defined for the RSRCNAME parameter.
|
||
|
|
<ul>
|
||
|
|
<li>If the resource is defined to use the 2771 integrated modem, the '2771 Internal Modem' description is used.
|
||
|
|
</li>
|
||
|
|
<li>If the resource is defined to use the 2772 integrated modem, the '2772 Internal Modem' description is used.
|
||
|
|
</li>
|
||
|
|
<li>If the resource is defined to use the 2793 integrated modem, the '2793 Internal Modem' description is used.
|
||
|
|
</li>
|
||
|
|
<li>If the resource is defined to use the 2805 integrated modem, the '2805 Internal Modem' description is used.
|
||
|
|
</li>
|
||
|
|
<li>If the ECS resource was chosen, the 'IBM 7852-400' modem description is used.
|
||
|
|
</li>
|
||
|
|
<li>Otherwise if the resource does not have a pre-defined modem description, MODEM(*RSRCNAME) cannot be used and the modem description will have to be explicitly defined.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RMTPPP</b></dt>
|
||
|
|
<dd>Indicates that a modem on a different partition or system is to be used. The internet address or host name where the modem is located must be specified for the <b>Modem remote system (MDMRMTSYS)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SELECT</b></dt>
|
||
|
|
<dd>A list of modem descriptions is shown from which you can select the modem to use. This option is only valid when running the STRRMTSPT CL command in interactive mode, otherwise an error will occur. If you are running interactively, it is recommended that you use the *SELECT value to help ensure that you properly select the modem to use.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>'modem-identification'</i></b></dt>
|
||
|
|
<dd>Specify the name of the modem to use. Note that modem names are case sensitive and must match exactly to the modems defined for the system.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>'generic*-modem-identification'</i></b></dt>
|
||
|
|
<dd>Specify the generic name of the modem you wish to use. A generic modem name is a character string of one or more characters followed by an asterisk (*); for example, 'abc*'. If a generic name is specified, then the FIRST modem name that matches with the generic name will be used. It is recommended that you include as many characters in the modem name string as possible to avoid any ambiguity. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete modem name. The actual modem name chosen will be posted in a message in the joblog.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRMTSPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRMTSPT.MDMRMTSYS"></a>
|
||
|
|
<h3>Modem remote system (MDMRMTSYS)</h3>
|
||
|
|
<p>Specifies the internet protocol (IPv4) address or the host name for the system or partition where the modem to be used for remote support is located.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is required if *RMTPPP is specified for the <b>Modem (MODEM)</b> parameter. If the MODEM parameter has any value other than *RMTPPP, this parameter cannot be specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the IP address or host name of the remote system or partition where the modem is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRMTSPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="STRRMTSPT.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Start Remote Support using PPP</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
STRRMTSPT DEVCLS(*PPP) STNADR(FA)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command creates and starts a PPP answer profile and associated configuration objects. The local internet address assigned is 169.254.2.250.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Start Remote Support for Virtual Device</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
STRRMTSPT DEVCLS(*VRT) DSPTYPE(5251)
|
||
|
|
DSPMODEL(11) STNADR(FE)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command creates and varies on the 5251 Model 11 Display Station located at station address FE.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 3: Start Remote Support using VPN</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
STRRMTSPT DEVCLS(*VPN)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command starts remote support over a virtual private network (VPN) connection. Before running this command, the Universal Connection wizard needs to be run, specifying a VPN or multihop type of connection (local or remote) for Electronic Customer Support (ECS).
|
||
|
|
</p>
|
||
|
|
<p><b>Example 4: Start Remote Support using a Remote Modem and PPP</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
STRRMTSPT DEVCLS(*PPP) STNADR(FE) MODEM(*RMTPPP)
|
||
|
|
MDMRMTSYS('10.1.1.2')
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command creates and starts an L2TP remote answer profile and associated configuration objects. Before running this command, the Universal Connection wizard needs to be run on the system or partition with internet address 10.1.1.2 where the modem to be used is located. When running the Universal Connection wizard, you need to specify that the modem should provide connectivity to others and that the connection type is AT&T. An alternative would be to create an L2TP terminator profile using the Remote Access Service New Profile GUI on the system or partition where the modem is located, specifying that outgoing calls are supported.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRMTSPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="STRRMTSPT.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF1394</b></dt>
|
||
|
|
<dd>CPF1394 User profile &1 cannot sign on.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9801</b></dt>
|
||
|
|
<dd>Object &2 in library &3 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9899</b></dt>
|
||
|
|
<dd>Error occurred during processing of command.
|
||
|
|
</dd>
|
||
|
|
<dt><b>TCP83A7</b></dt>
|
||
|
|
<dd>QRETSVRSEC=0. Unable to save remote service password for &2.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRMTSPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|