691 lines
25 KiB
HTML
691 lines
25 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>Change Service Configuration (CHGSRVCFG)</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="CHGSRVCFG.Top_Of_Page"></a>
|
||
|
<h2>Change Service Configuration (CHGSRVCFG)</h2>
|
||
|
<table width="100%">
|
||
|
<tr>
|
||
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
||
|
<b>Threadsafe: </b>No
|
||
|
</td>
|
||
|
<td valign="top" align="right">
|
||
|
<a href="#CHGSRVCFG.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
<a href="#CHGSRVCFG.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
<a href="#CHGSRVCFG.ERROR.MESSAGES">Error messages</a></td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<div> <a name="CHGSRVCFG"></a>
|
||
|
<p>The Change Service Configuration (CHGSRVCFG) command changes the service configuration needed for all service and support applications: Electronic Customer Support (ECS), Electronic Service Agent, and Information Center Update. Primary or backup configurations can be changed for the service configuration.
|
||
|
</p>
|
||
|
<p><b>Restrictions:</b>
|
||
|
</p>
|
||
|
<ul>
|
||
|
<li>Input/output system configuration (*IOSYSCFG) special authority is required to run this command.
|
||
|
</li>
|
||
|
</ul>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CHGSRVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<hr size="2" width="100%">
|
||
|
|
||
|
<div>
|
||
|
<h3><a name="CHGSRVCFG.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="#CHGSRVCFG.ROLE"><b>ROLE</b></a></td>
|
||
|
<td valign="top">Role</td>
|
||
|
<td valign="top">*PRIMARY, *BACKUP</td>
|
||
|
<td valign="top">Required, Key, Positional 1</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CHGSRVCFG.CNNTYPE"><b>CNNTYPE</b></a></td>
|
||
|
<td valign="top">Connection type</td>
|
||
|
<td valign="top"><b><u>*SAME</u></b>, *DIRECT, *OTHERISP, *LCLDIAL, *MULTIHOP, *RMTDIAL</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CHGSRVCFG.CNTRYID"><b>CNTRYID</b></a></td>
|
||
|
<td valign="top">Country or region ID</td>
|
||
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *SELECT</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CHGSRVCFG.STATE"><b>STATE</b></a></td>
|
||
|
<td valign="top">State or province code</td>
|
||
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *SELECT</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CHGSRVCFG.TELNBR1"><b>TELNBR1</b></a></td>
|
||
|
<td valign="top">Primary telephone number</td>
|
||
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *SELECT</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CHGSRVCFG.TELNBR2"><b>TELNBR2</b></a></td>
|
||
|
<td valign="top">Alternate telephone number</td>
|
||
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *SELECT</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CHGSRVCFG.RSRCNAME"><b>RSRCNAME</b></a></td>
|
||
|
<td valign="top">Resource name</td>
|
||
|
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b>, *CALC, *SELECT</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CHGSRVCFG.MODEM"><b>MODEM</b></a></td>
|
||
|
<td valign="top">Modem information name</td>
|
||
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *RSRCNAME, *SELECT</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CHGSRVCFG.RMTSYS"><b>RMTSYS</b></a></td>
|
||
|
<td valign="top">Remote system</td>
|
||
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b></td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top" rowspan="6"><a href="#CHGSRVCFG.PROXY"><b>PROXY</b></a></td>
|
||
|
<td valign="top">Proxy server</td>
|
||
|
<td valign="top">Single values: *NO<br>Other values: <i>Element list</i></td>
|
||
|
<td valign="top" rowspan="6">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top">Element 1: IP address or host name</td>
|
||
|
<td valign="top">
|
||
|
<i>Character value</i>, <b><u>*SAME</u></b></td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top">Element 2: Port number</td>
|
||
|
<td valign="top">
|
||
|
1-65535, <b><u>*SAME</u></b>, *IBMSVR</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top">Element 3: Relative priority</td>
|
||
|
<td valign="top">
|
||
|
<b><u>*SAME</u></b>, *TRYAFTER, *TRYBEFORE</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top">Element 4: Authentication user ID</td>
|
||
|
<td valign="top">
|
||
|
<i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top">Element 5: Authentication password</td>
|
||
|
<td valign="top">
|
||
|
<i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CHGSRVCFG.ISPPRF"><b>ISPPRF</b></a></td>
|
||
|
<td valign="top">ISP profile name</td>
|
||
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *SELECT</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top" rowspan="5"><a href="#CHGSRVCFG.CNNPNT"><b>CNNPNT</b></a></td>
|
||
|
<td valign="top">Connectivity for others</td>
|
||
|
<td valign="top">Single values: *NO<br>Other values: <i>Element list</i></td>
|
||
|
<td valign="top" rowspan="5">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top">Element 1: Connection point</td>
|
||
|
<td valign="top">
|
||
|
<b><u>*SAME</u></b>, *YES</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top">Element 2: Interfaces</td>
|
||
|
<td valign="top">
|
||
|
Values (up to 12 repetitions): <i>Element list</i></td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top" style="padding-left:10pt">Element 1: Interface</td>
|
||
|
<td valign="top">
|
||
|
<i>Character value</i>, <b><u>*SAME</u></b>, *ALL, *SELECT</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top" style="padding-left:10pt">Element 2: L2TP profile name</td>
|
||
|
<td valign="top">
|
||
|
<i>Character value</i>, <b><u>*SAME</u></b>, *GEN, *SELECT</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top" rowspan="4"><a href="#CHGSRVCFG.CNNPNTPRX"><b>CNNPNTPRX</b></a></td>
|
||
|
<td valign="top">Connection point proxy</td>
|
||
|
<td valign="top"><i>Element list</i></td>
|
||
|
<td valign="top" rowspan="4">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top">Element 1: Port number</td>
|
||
|
<td valign="top">
|
||
|
1-65535, <b><u>*SAME</u></b>, *IBMSVR</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top">Element 2: Authentication user ID</td>
|
||
|
<td valign="top">
|
||
|
<i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top">Element 3: Authentication password</td>
|
||
|
<td valign="top">
|
||
|
<i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CHGSRVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
</div>
|
||
|
<div> <a name="CHGSRVCFG.ROLE"></a>
|
||
|
<h3>Role (ROLE)</h3>
|
||
|
<p>Specifies whether the service configuration to be changed is the primary or backup service configuration. The system or logical partition will attempt to connect to IBM using the primary configuration. If the primary service configuration fails, the system or logical partition will try to establish the connection using a backup service configuration.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*PRIMARY</u></b></dt>
|
||
|
<dd>The primary service configuration will be changed.
|
||
|
</dd>
|
||
|
<dt><b>*BACKUP</b></dt>
|
||
|
<dd>The backup service configuration will be changed.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CHGSRVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CHGSRVCFG.CNNTYPE"></a>
|
||
|
<h3>Connection type (CNNTYPE)</h3>
|
||
|
<p>Specifies the current connection type by which the system or logical partition connects to IBM. The applicable parameters for the currently configured connection type will be the only ones that can be changed. The connection type for an existing service configuration for the system or logical partition cannot be changed.
|
||
|
</p>
|
||
|
<p>
|
||
|
<b>Note: </b>To change the connection type, the existing service configuration must be deleted by using the Delete Service Configuration (DLTSRVCFG) command, and a new service configuration must be created using the Create Service Configuration (CRTSRVCFG) command, specifying the desired connection type.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
<dd>The connection type does not change.
|
||
|
</dd>
|
||
|
<dt><b>*DIRECT</b></dt>
|
||
|
<dd>The current system or logical partition uses a direct connection to the internet as the connection type.
|
||
|
</dd>
|
||
|
<dt><b>*OTHERISP</b></dt>
|
||
|
<dd>The current system or logical partition uses an internet service provider (ISP) as the connection type.
|
||
|
</dd>
|
||
|
<dt><b>*LCLDIAL</b></dt>
|
||
|
<dd>The current system or logical partition uses a dial connection using AT&T Global Network Services (AGNS) as the connection type.
|
||
|
</dd>
|
||
|
<dt><b>*MULTIHOP</b></dt>
|
||
|
<dd>The current system or logical partition uses a multi-hop connection to the internet as the connection type.
|
||
|
</dd>
|
||
|
<dt><b>*RMTDIAL</b></dt>
|
||
|
<dd>The current system or logical partition uses an AT&T Global Network Services (AGNS) connection configuration from another system or logical partition as the connection type.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CHGSRVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CHGSRVCFG.CNTRYID"></a>
|
||
|
<h3>Country or region ID (CNTRYID)</h3>
|
||
|
<p>Specifies the country or region identifier used for the service configuration.
|
||
|
</p>
|
||
|
<p>
|
||
|
<b>Note: </b>This parameter is only valid when *PRIMARY is specified for the <b>Role (ROLE)</b> parameter.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
<dd>The country or region identifier does not change.
|
||
|
</dd>
|
||
|
<dt><b>*SELECT</b></dt>
|
||
|
<dd>A panel is displayed that allows the selection of a country or region identifier.
|
||
|
<p>
|
||
|
<b>Note: </b>This value is only valid if this command is run in an interactive job.
|
||
|
</p>
|
||
|
</dd>
|
||
|
<dt><b><i>character-value</i></b></dt>
|
||
|
<dd>Specifies the 2-character country or region identifier that will be used.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CHGSRVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CHGSRVCFG.STATE"></a>
|
||
|
<h3>State or province code (STATE)</h3>
|
||
|
<p>Specifies the state or province code used for the service configuration.
|
||
|
</p>
|
||
|
<p>
|
||
|
<b>Note: </b>This parameter is only valid when *PRIMARY is specified for the <b>Role (ROLE)</b> parameter.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
<dd>The state or province code does not change.
|
||
|
</dd>
|
||
|
<dt><b>*SELECT</b></dt>
|
||
|
<dd>A panel is displayed that allows the selection of a state or province code. No selection panel is displayed if the specified country or region does not have states or provinces.
|
||
|
<p>
|
||
|
<b>Note: </b>This value is only valid if this command is run in an interactive job.
|
||
|
</p>
|
||
|
</dd>
|
||
|
<dt><b><i>character-value</i></b></dt>
|
||
|
<dd>Specifies the 2-character state or province code that will be used.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CHGSRVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CHGSRVCFG.TELNBR1"></a>
|
||
|
<h3>Primary telephone number (TELNBR1)</h3>
|
||
|
<p>Specifies the primary telephone number dialed to connect to AT&T Global Network Services (AGNS).
|
||
|
</p>
|
||
|
<p>
|
||
|
<b>Note: </b>This parameter is only valid when *LCLDIAL is specified for the <b>Connection type (CNNTYPE)</b> parameter.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
<dd>The telephone number does not change.
|
||
|
</dd>
|
||
|
<dt><b>*SELECT</b></dt>
|
||
|
<dd>A panel is displayed that allows the selection of the primary telephone number used. After a selection is made, an additional panel will be displayed to allow changes of the connection number, adding any numbers or characters needed to obtain an outside line, pause while dialing, etc.
|
||
|
</dd>
|
||
|
<dt><b><i>character-value</i></b></dt>
|
||
|
<dd>Specifies the primary telephone number that will be dialed. Up to 48 characters can be specified.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CHGSRVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CHGSRVCFG.TELNBR2"></a>
|
||
|
<h3>Alternate telephone number (TELNBR2)</h3>
|
||
|
<p>Specifies the backup telephone number dialed to connect to AT&T Global Network Services (AGNS), if the connection attempt using the primary number is unsuccessful.
|
||
|
</p>
|
||
|
<p>
|
||
|
<b>Note: </b>This parameter is only valid when *LCLDIAL is specified for the <b>Connection type (CNNTYPE)</b> parameter.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
<dd>The telephone number does not change.
|
||
|
</dd>
|
||
|
<dt><b>*SELECT</b></dt>
|
||
|
<dd>A panel is displayed that allows the selection of the alternate telephone number that will be used. After a selection is made, an additional panel will be displayed to allow changes of the connection number, adding any numbers or characters needed to obtain an outside line, pause while dialing, etc.
|
||
|
</dd>
|
||
|
<dt><b><i>character-value</i></b></dt>
|
||
|
<dd>Specifies the alternate telephone number that will be dialed. Up to 48 characters can be specified.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CHGSRVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CHGSRVCFG.RSRCNAME"></a>
|
||
|
<h3>Resource name (RSRCNAME)</h3>
|
||
|
<p>Specifies the communications resource used by this service.
|
||
|
</p>
|
||
|
<p>
|
||
|
<b>Note: </b>This parameter is only valid when *LCLDIAL is specified for the <b>Connection type (CNNTYPE)</b> parameter.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
<dd>The resource name does not change.
|
||
|
</dd>
|
||
|
<dt><b>*CALC</b></dt>
|
||
|
<dd>The resource name will be determined as follows:
|
||
|
<p>The internal communication resources that can use an integrated modem are determined. If only one integrated modem is defined, that resource will be used for the confuguration. The value *CALC is not valid if more than one integrated modem is defined.
|
||
|
</p>
|
||
|
<p>If an integrated modem cannot be used, the resource cannot be calculated and it will have to be specified explicitly.
|
||
|
</p>
|
||
|
</dd>
|
||
|
<dt><b>*SELECT</b></dt>
|
||
|
<dd>A panel is displayed that allows the selection of the resource name that will be be used.
|
||
|
</dd>
|
||
|
<dt><b><i>name</i></b></dt>
|
||
|
<dd>Specifies the name of the communications resource that will be used.
|
||
|
<p>
|
||
|
<b>Note: </b>Use the Work with Hardware Resources (WRKHDWRSC) command with *CMN specified for the TYPE parameter to help determine the resource name.
|
||
|
</p>
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CHGSRVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CHGSRVCFG.MODEM"></a>
|
||
|
<h3>Modem information name (MODEM)</h3>
|
||
|
<p>Specifies the name of the modem description to use for this point-to-point service configuration.
|
||
|
</p>
|
||
|
<p>
|
||
|
<b>Note: </b>This parameter is only valid when *LCLDIAL is specified for the <b>Connection type (CNNTYPE)</b> parameter.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
<dd>The modem name does not change.
|
||
|
</dd>
|
||
|
<dt><b>*RSRCNAME</b></dt>
|
||
|
<dd>The modem name will be determined based on the value specified for the <b>Resource name (RSRCNAME)</b> parameter. If the resource is defined to use an integrated modem, the appropriate internal modem description will be used. If the resource does not have a predefined modem description, MODEM(*RSRCNAME) cannot be used and the modem description must be specified explicitly.
|
||
|
</dd>
|
||
|
<dt><b>*SELECT</b></dt>
|
||
|
<dd>A panel is displayed that allows the selection of the modem description that will be used.
|
||
|
</dd>
|
||
|
<dt><b><i>character-value</i></b></dt>
|
||
|
<dd>Specifies the modem name. Note that the modem name must match one of the modems defined for the system or logical partition.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CHGSRVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CHGSRVCFG.RMTSYS"></a>
|
||
|
<h3>Remote system (RMTSYS)</h3>
|
||
|
<p>Specifies either the IP address or host name (up to 255 characters) of the remote system or logical partition that will be used as the remote system that provides service configuration connectivity to IBM. A valid IP Version 4 address will be accepted.
|
||
|
</p>
|
||
|
<p>If the local system or logical partition has a service configuration created with CNNTYPE(*RMTDIAL) and has defined a remote system (RMTSYS) parameter, the remote system or logical partition must have a service configuration created with CNNTYPE(*LCLDIAL) and CNNPNT(*YES).
|
||
|
</p>
|
||
|
<p>If the local system or logical partition has a service configuration created with CNNTYPE(*MULTIHOP) and has defined a remote system (RMTSYS) parameter, the remote system or logical partition must have a service configuration created with a connection type (CNNTYPE) of *DIRECT, *OTHERISP, or *MULTIHOP, and a connection point (CNNPNT) value of *YES.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
<dd>The remote system does not change.
|
||
|
</dd>
|
||
|
<dt><b><i>character-value</i></b></dt>
|
||
|
<dd>Specifies the IP address or host name of the remote system or logical partition that will provide the service configuration connection to IBM.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CHGSRVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CHGSRVCFG.PROXY"></a>
|
||
|
<h3>Proxy server (PROXY)</h3>
|
||
|
<p>Specifies information for configuring an HTTP or Service and Support proxy connection. Configuring a proxy connection is optional. The proxy connection is an alternate connection to the primary or backup connection that was previously configured. A proxy connection can be used with any connection type.
|
||
|
</p>
|
||
|
<p>The information provides the server with the information needed to connect to the destination proxy server.
|
||
|
</p>
|
||
|
<p><b>Single values</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b>*NO</b></dt>
|
||
|
<dd>The IP address or host name is not specified. A proxy connection will not be used.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<p><b>Element 1: IP address or host name</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
<dd>The value does not change.
|
||
|
</dd>
|
||
|
<dt><b><i>character-value</i></b></dt>
|
||
|
<dd>Specifies the IP address or host name of the proxy server through which this server will attempt to connect.
|
||
|
</dd>
|
||
|
<dt><b>*NONE</b></dt>
|
||
|
<dd>The IP address or host name is not specified. A proxy connection configuration will not be created.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<p><b>Element 2: Port number</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
<dd>The value does not change.
|
||
|
</dd>
|
||
|
<dt><b>*IBMSVR</b></dt>
|
||
|
<dd>The Service and Support proxy server will accept connections using the default port.
|
||
|
</dd>
|
||
|
<dt><b><i>1-65535</i></b></dt>
|
||
|
<dd>Specifies the port number on which the Service and Support proxy server will accept connections.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<p><b>Element 3: Relative priority</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
<dd>The value does not change.
|
||
|
</dd>
|
||
|
<dt><b>*TRYAFTER</b></dt>
|
||
|
<dd>The proxy connection configuration will be attempted after the previously defined configuration.
|
||
|
</dd>
|
||
|
<dt><b>*TRYBEFORE</b></dt>
|
||
|
<dd>The proxy connection configuration will be attempted before the previously defined configuration.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<p><b>Element 4: Authentication user ID</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
<dd>The value does not change.
|
||
|
</dd>
|
||
|
<dt><b>*NONE</b></dt>
|
||
|
<dd>A user ID is not required.
|
||
|
</dd>
|
||
|
<dt><b><i>character-value</i></b></dt>
|
||
|
<dd>If the proxy server requires authentication, specify the user ID that will be used.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<p><b>Element 5: Authentication password</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
<dd>The value does not change.
|
||
|
</dd>
|
||
|
<dt><b>*NONE</b></dt>
|
||
|
<dd>A password is not required.
|
||
|
</dd>
|
||
|
<dt><b><i>character-value</i></b></dt>
|
||
|
<dd>If the proxy server requires authentication, specify the password that will be used.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CHGSRVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CHGSRVCFG.ISPPRF"></a>
|
||
|
<h3>ISP profile name (ISPPRF)</h3>
|
||
|
<p>Specifies the internet service provider (ISP) profile that will be used.
|
||
|
</p>
|
||
|
<p>
|
||
|
<b>Note: </b>This parameter is only valid when *OTHERISP is specified for the <b>Connection type (CNNTYPE)</b> parameter.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
<dd>The ISP profile name does not change.
|
||
|
</dd>
|
||
|
<dt><b>*SELECT</b></dt>
|
||
|
<dd>A panel is displayed that allows the selection of the ISP profile that will be used.
|
||
|
</dd>
|
||
|
<dt><b><i>character-value</i></b></dt>
|
||
|
<dd>Specifies the name of the ISP profile that will be used.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CHGSRVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CHGSRVCFG.CNNPNT"></a>
|
||
|
<h3>Connectivity for others (CNNPNT)</h3>
|
||
|
<p>Specifies whether other systems or logical partitions are allowed to use the service configuration connection to IBM through this system or logical partition.
|
||
|
</p>
|
||
|
<p>
|
||
|
<b>Note: </b>This parameter is only valid when *PRIMARY is specified for the <b>Role (ROLE)</b> parameter.
|
||
|
</p>
|
||
|
<p><b>Single values</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b>*NO</b></dt>
|
||
|
<dd>Other systems or logical partitions are not allowed to use the service configuration connection to IBM configured on this system or logical partition.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<p><b>Element 1: Connection point</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
<dd>The value is not changed.
|
||
|
</dd>
|
||
|
<dt><b>*YES</b></dt>
|
||
|
<dd>Other systems or logical partitions are allowed to use the service configuration connection to IBM configured on this system or logical partition.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<p><b>Element 2: Interfaces</b>
|
||
|
</p>
|
||
|
<p>Specifies which interfaces will listen for connections. Both the L2TP terminator profile and the Service and Support proxy, if configured, listen on the same interfaces. Up to 12 values can be specified.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b></b></dt>
|
||
|
<dd>
|
||
|
<p><b>Element 1: Interface</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
<dd>The value does not change.
|
||
|
</dd>
|
||
|
<dt><b>*ALL</b></dt>
|
||
|
<dd>All available interfaces will listen for a connection.
|
||
|
</dd>
|
||
|
<dt><b>*SELECT</b></dt>
|
||
|
<dd>Only selected interfaces will listen for a connection.
|
||
|
</dd>
|
||
|
<dt><b><i>character-value</i></b></dt>
|
||
|
<dd>Specifies the interface that will listen for a connection.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</dd>
|
||
|
<dt><b></b></dt>
|
||
|
<dd>
|
||
|
<p><b>Element 2: L2TP profile name</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
<dd>The value does not change.
|
||
|
</dd>
|
||
|
<dt><b>*GEN</b></dt>
|
||
|
<dd>Automatically generate and name an L2TP profile to use as the terminator profile.
|
||
|
</dd>
|
||
|
<dt><b>*SELECT</b></dt>
|
||
|
<dd>Select an existing L2TP profile to use as the terminator profile.
|
||
|
</dd>
|
||
|
<dt><b><i>character-value</i></b></dt>
|
||
|
<dd>Specifies the name of an L2TP terminator profile which will be used to provide connectivity for other systems or logical partitions.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CHGSRVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CHGSRVCFG.CNNPNTPRX"></a>
|
||
|
<h3>Connection point proxy (CNNPNTPRX)</h3>
|
||
|
<p>Specifies the Service and Support proxy server to provide connectivity for other systems or logical partitions.
|
||
|
</p>
|
||
|
<p><b>Element 1: Port number</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
<dd>The value does not change.
|
||
|
</dd>
|
||
|
<dt><b>*IBMSVR</b></dt>
|
||
|
<dd>The Service and Support proxy server will accept connections using the default port.
|
||
|
</dd>
|
||
|
<dt><b><i>1-65535</i></b></dt>
|
||
|
<dd>Specifies the port number on which the Service and Support proxy server will accept connections.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<p><b>Element 2: Authentication user ID</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
<dd>The value does not change.
|
||
|
</dd>
|
||
|
<dt><b>*NONE</b></dt>
|
||
|
<dd>A user ID is not required.
|
||
|
</dd>
|
||
|
<dt><b><i>character-value</i></b></dt>
|
||
|
<dd>If the proxy server requires authentication, specify the user ID that will be used.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<p><b>Element 3: Authentication password</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
<dd>The value does not change.
|
||
|
</dd>
|
||
|
<dt><b>*NONE</b></dt>
|
||
|
<dd>A password is not required.
|
||
|
</dd>
|
||
|
<dt><b><i>character-value</i></b></dt>
|
||
|
<dd>If the proxy server requires authentication, specify the password that will be used.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CHGSRVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<hr size="2" width="100%">
|
||
|
<div><h3><a name="CHGSRVCFG.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
<p><b>Example 1: Change a Local Dial Primary Service Configuration</b>
|
||
|
</p>
|
||
|
<p>
|
||
|
<pre>
|
||
|
CHGSRVCFG ROLE(*PRIMARY) CNNTYPE(*SAME) TELNBR1(3333333)
|
||
|
</pre>
|
||
|
</p>
|
||
|
<p>This command changes the primary telephone number of the primary service configuration. This example assumes the existing primary service configuration has a connection type of *LCLDIAL.
|
||
|
</p>
|
||
|
<p><b>Example 2: Change a Direct Internet Backup Service Configuration</b>
|
||
|
</p>
|
||
|
<p>
|
||
|
<pre>
|
||
|
CHGSRVCFG ROLE(*BACKUP) CNNTYPE(*SAME) PROXY('10.1.1.1')
|
||
|
</pre>
|
||
|
</p>
|
||
|
<p>This command changes the Service and Support proxy for a direct internet backup service configuration. This example assumes the existing backup service configuration has a connection type of *DIRECT.
|
||
|
</p>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CHGSRVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<hr size="2" width="100%">
|
||
|
<div><h3><a name="CHGSRVCFG.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b>CPFB040</b></dt>
|
||
|
<dd>If RSRCNAME(*SELECT) is specified, MODEM(*RSRCNAME) cannot be specified.
|
||
|
</dd>
|
||
|
<dt><b>TCP8050</b></dt>
|
||
|
<dd>*IOSYSCFG authority required to use &1.
|
||
|
</dd>
|
||
|
<dt><b>TCP8290</b></dt>
|
||
|
<dd>No TCP/IP point-to-point modem information
|
||
|
</dd>
|
||
|
<dt><b>CPF8813</b></dt>
|
||
|
<dd>No entries exist.
|
||
|
</dd>
|
||
|
<dt><b>CPF9899</b></dt>
|
||
|
<dd>Error occurred during processing of command.
|
||
|
</dd>
|
||
|
<dt><b>TCP8205</b></dt>
|
||
|
<dd>Required object &2/&1 type *&3 not found.
|
||
|
</dd>
|
||
|
<dt><b>TCP8211</b></dt>
|
||
|
<dd>Point-to-point profile &1 not found.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CHGSRVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
</body>
|
||
|
</html>
|