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

669 lines
26 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>Create Service Configuration (CRTSRVCFG)</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="CRTSRVCFG.Top_Of_Page"></a>
<h2>Create Service Configuration (CRTSRVCFG)</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="#CRTSRVCFG.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CRTSRVCFG.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CRTSRVCFG.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CRTSRVCFG"></a>
<p>The Create Service Configuration (CRTSRVCFG) command creates the service configuration needed for all service and support applications: Electronic Customer Support (ECS), Electronic Service Agent, and Information Center Update.
</p>
<p>Connectivity options are available from either local or remote systems or logical partitions. Primary or backup configurations can be created 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="#CRTSRVCFG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CRTSRVCFG.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="#CRTSRVCFG.ROLE"><b>ROLE</b></a></td>
<td valign="top">Role</td>
<td valign="top">*PRIMARY, *BACKUP</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CRTSRVCFG.CNNTYPE"><b>CNNTYPE</b></a></td>
<td valign="top">Connection type</td>
<td valign="top">*DIRECT, *OTHERISP, *LCLDIAL, *MULTIHOP, *RMTDIAL</td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#CRTSRVCFG.CNTRYID"><b>CNTRYID</b></a></td>
<td valign="top">Country or region ID</td>
<td valign="top"><i>Character value</i>, <b><u>*SELECT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTSRVCFG.STATE"><b>STATE</b></a></td>
<td valign="top">State or province code</td>
<td valign="top"><i>Character value</i>, <b><u>*SELECT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTSRVCFG.TELNBR1"><b>TELNBR1</b></a></td>
<td valign="top">Primary telephone number</td>
<td valign="top"><i>Character value</i>, <b><u>*SELECT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTSRVCFG.TELNBR2"><b>TELNBR2</b></a></td>
<td valign="top">Alternate telephone number</td>
<td valign="top"><i>Character value</i>, <b><u>*SELECT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTSRVCFG.RSRCNAME"><b>RSRCNAME</b></a></td>
<td valign="top">Resource name</td>
<td valign="top"><i>Name</i>, <b><u>*CALC</u></b>, *SELECT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTSRVCFG.MODEM"><b>MODEM</b></a></td>
<td valign="top">Modem information name</td>
<td valign="top"><i>Character value</i>, <b><u>*RSRCNAME</u></b>, *SELECT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTSRVCFG.RMTSYS"><b>RMTSYS</b></a></td>
<td valign="top">Remote system</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="6"><a href="#CRTSRVCFG.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>*NONE</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Port number</td>
<td valign="top">
1-65535, <b><u>*IBMSVR</u></b></td>
</tr>
<tr>
<td valign="top">Element 3: Relative priority</td>
<td valign="top">
<b><u>*TRYAFTER</u></b>, *TRYBEFORE</td>
</tr>
<tr>
<td valign="top">Element 4: Authentication user ID</td>
<td valign="top">
<i>Character value</i>, <b><u>*NONE</u></b></td>
</tr>
<tr>
<td valign="top">Element 5: Authentication password</td>
<td valign="top">
<i>Character value</i>, <b><u>*NONE</u></b></td>
</tr>
<tr>
<td valign="top"><a href="#CRTSRVCFG.ISPPRF"><b>ISPPRF</b></a></td>
<td valign="top">ISP profile name</td>
<td valign="top"><i>Character value</i>, <b><u>*SELECT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="5"><a href="#CRTSRVCFG.CNNPNT"><b>CNNPNT</b></a></td>
<td valign="top">Connectivity for others</td>
<td valign="top">Single values: <b><u>*NO</u></b><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>*YES</u></b></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>*ALL</u></b>, *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>*GEN</u></b>, *SELECT</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#CRTSRVCFG.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>*IBMSVR</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Authentication user ID</td>
<td valign="top">
<i>Character value</i>, <b><u>*NONE</u></b></td>
</tr>
<tr>
<td valign="top">Element 3: Authentication password</td>
<td valign="top">
<i>Character value</i>, <b><u>*NONE</u></b></td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CRTSRVCFG.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CRTSRVCFG.ROLE"></a>
<h3>Role (ROLE)</h3>
<p>Specifies whether this service configuration is to be the primary or backup service configuration. The system or logical partition will first attempt to connect to IBM using the primary service configuration. If the primary service configuration fails, the system or logical partition will attempt the connection using a backup service configuration.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b>*PRIMARY</b></dt>
<dd>The service configuration created will be the primary connection to IBM. A primary service configuration must be created before a backup service configuration can be created.
</dd>
<dt><b>*BACKUP</b></dt>
<dd>The service configuration created will be the backup connection to IBM. This value is not allowed if the primary service configuration has not been created.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTSRVCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTSRVCFG.CNNTYPE"></a>
<h3>Connection type (CNNTYPE)</h3>
<p>Specifies the connection type by which the system or logical partition will connect to IBM. You can connect to IBM using the current system or logical partition or through another system or logical partition.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b>*DIRECT</b></dt>
<dd>Connect to IBM through the current system or logical partition using a direct connection to the internet as the connection type. Use this option if the system or logical partition can access the internet using one or more active TCP/IP interfaces.
</dd>
<dt><b>*OTHERISP</b></dt>
<dd>Connect to IBM through the current system or logical partition using an internet service provider (ISP) as the connection type. Use this option if the system or logical partition can connect to an ISP using a point-to-point (PPP) connection profile.
</dd>
<dt><b>*LCLDIAL</b></dt>
<dd>Connect to IBM through the current system or logical partition with a dial connection using AT&amp;T Global Network Services (AGNS).
</dd>
<dt><b>*MULTIHOP</b></dt>
<dd>Connect to IBM through another system or logical partition using a multi-hop connection to the internet as the connection type. Use this option if the system or logical partition providing the connection is configured to use CNNTYPE(*DIRECT), CNNTYPE(*OTHERISP), or CNNTYPE(*MULTIHOP).
</dd>
<dt><b>*RMTDIAL</b></dt>
<dd>Connect to IBM through another system or logical partition using AT&amp;T Global Network Services (AGNS) as the connection type. Use this option if the system or logical partition providing the connection is configured to dial to IBM using AT&amp;T Global Network Services (AGNS).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTSRVCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTSRVCFG.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>*SELECT</u></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>Specify the 2-character country or region identifier to be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTSRVCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTSRVCFG.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>*SELECT</u></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>Specify the 2-character state or province code to be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTSRVCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTSRVCFG.TELNBR1"></a>
<h3>Primary telephone number (TELNBR1)</h3>
<p>Specifies the primary telephone number that will be dialed to connect to AT&amp;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>*SELECT</u></b></dt>
<dd>A panel is displayed that allows the selection of the primary telephone number. After a selection is made, an additional panel will be displayed to allow editing of the telephone 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>Specify 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="#CRTSRVCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTSRVCFG.TELNBR2"></a>
<h3>Alternate telephone number (TELNBR2)</h3>
<p>Specifies the alternate telephone number that will be dialed to connect to AT&amp;T Global Network Services (AGNS), if the connection attempt using the primary telephone 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>*SELECT</u></b></dt>
<dd>A panel is displayed that allows the selection of the alternate telephone number. After a selection is made, an additional panel will be displayed to allow editing of the telephone 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>Specify 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="#CRTSRVCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTSRVCFG.RSRCNAME"></a>
<h3>Resource name (RSRCNAME)</h3>
<p>Specifies the communications resource that will be 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>*CALC</u></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 service configuration. 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 used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify 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="#CRTSRVCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTSRVCFG.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>*RSRCNAME</u></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>Specify the name of the modem to use.
<p>
<b>Note: </b>The modem name must match one of the modems defined for the system or logical partition.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTSRVCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTSRVCFG.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 is 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><i>character-value</i></b></dt>
<dd>Specify 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="#CRTSRVCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTSRVCFG.PROXY"></a>
<h3>Proxy server (PROXY)</h3>
<p>Specifies the information for configuring an HTTP or Service and Support proxy connection configuration. Configuring a proxy connection is optional. The proxy connection is an alternate connection configuration to the primary or backup connection that has been 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 configuration will not be created.
</dd>
</dl>
<p><b>Element 1: IP address or host name</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The IP address or host name is not specified. A proxy connection configuration will not be created.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the IP address or host name of the proxy server through which this server will attempt to connect.
</dd>
</dl>
<p><b>Element 2: Port number</b>
</p>
<dl>
<dt><b><u>*IBMSVR</u></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>Specify 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>*TRYAFTER</u></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>*NONE</u></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>*NONE</u></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="#CRTSRVCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTSRVCFG.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>*SELECT</u></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>Specify the name of the ISP profile that will be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTSRVCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTSRVCFG.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><u>*NO</u></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>*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>*ALL</u></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>Specify 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>*GEN</u></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>Specify 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="#CRTSRVCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTSRVCFG.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>*IBMSVR</u></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>Specify 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>*NONE</u></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>*NONE</u></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="#CRTSRVCFG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTSRVCFG.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Creating a Primary Direct Service Configuration</b>
</p>
<p>
<pre>
CRTSRVCFG ROLE(*PRIMARY) CNNTYPE(*DIRECT)
CNTRYID(XX) STATE(XX)
</pre>
</p>
<p>This command creates a primary direct internet service configuration used for all service and support applications: Electronic Customer Support (ECS), Electronic Service Agent, and Information Center Update.
</p>
<p><b>Example 2: Creating a Backup Service Configuration Using an Existing ISP</b>
</p>
<p>
<pre>
CRTSRVCFG ROLE(*BACKUP) CNNTYPE(*OTHERISP) CNTRYID(XX)
STATE(XX) ISPPRF(MYISP) CNNPNT(*YES *ALL)
</pre>
</p>
<p>This command creates an backup internet service configuration using an internet service provider used for all service and support applications: Electronic Customer Support (ECS), Electronic Service Agent, and Information Center Update. The local system or logical partition is a connection point which will listen for connection requests on all interfaces.
</p>
<p><b>Example 3: Creating a Primary Local Dial Service Configuration</b>
</p>
<p>
<pre>
CRTSRVCFG ROLE(*PRIMARY) CNNTYPE(*LCLDIAL) CNTRYID(XX)
STATE(XX) TELNBR1(1111111) TELNBR2(2222222)
</pre>
</p>
<p>This command creates a primary local dial connnection to AT&amp;T Global Network Services (AGNS) used for all service and support applications: Electronic Customer Support (ECS), Electronic Service Agent, and Information Center Update.
</p>
<p><b>Example 4: Creating a Backup Multi-hop Service Configuration</b>
</p>
<p>
<pre>
CRTSRVCFG ROLE(*BACKUP) CNNTYPE(*MULTIHOP)
CNTRYID(YY) RMTSYS(ABCDEFG)
</pre>
</p>
<p>This command creates a backup internet service configuration using another remote system or logical partition used for all service and support applications: Electronic Customer Support (ECS), Electronic Service Agent, and Information Center Update. The configuration will connect using a multi-hop connection configuration through the remote system named ABCDEFG.
</p>
<p><b>Example 5: Creating a Remote Point-to-Point Service Configuration</b>
</p>
<p>
<pre>
CRTSRVCFG ROLE(*PRIMARY) CNNTYPE(*RMTDIAL) CNTRYID(XX)
STATE(XX) RMTSYS(ABCDEFG)
</pre>
</p>
<p>This command creates a primary remote dial connnection to AT&amp;T Global Network Services (AGNS) used for all service and support applications: Electronic Customer Support (ECS), Electronic Service Agent, and Information Center Update. This configuration will connect using a dial connection configuration on a remote system named ABCDEFG.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTSRVCFG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTSRVCFG.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 &amp;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 &amp;2/&amp;1 type *&amp;3 not found.
</dd>
<dt><b>TCP8211</b></dt>
<dd>Point-to-point profile &amp;1 not found.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTSRVCFG.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>