Create Service Configuration (CRTSRVCFG)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Create Service Configuration (CRTSRVCFG) command creates the service configuration needed for all service and support applications: Electronic Customer Support (ECS) and Electronic Service Agent.
Connectivity options are available from either local or remote systems or logical partitions. Primary or backup configurations can be created for the service configuration.
Restrictions:
- Input/output system configuration (*IOSYSCFG) special authority is required to run this command.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| ROLE | Role | *PRIMARY, *BACKUP | Required, Positional 1 |
| CNNTYPE | Connection type | *DIRECT, *OTHERISP, *MULTIHOP | Required, Positional 2 |
| CNTRYID | Country or region ID | Character value, *SELECT | Optional |
| STATE | State or province code | Character value, *SELECT | Optional |
| ISPPRF | ISP profile name | Character value, *SELECT | Optional |
| RMTSYS | Remote system | Character value | Optional |
| PROXY | Proxy server | Single values: *NO Other values: Element list |
Optional |
| Element 1: IP address or host name | Character value, *NONE | ||
| Element 2: Port number | 1-65535, *IBMSVR | ||
| Element 3: Relative priority | *TRYAFTER, *TRYBEFORE | ||
| Element 4: Authentication user ID | Character value, *NONE | ||
| Element 5: Authentication password | Character value, *NONE | ||
| CNNPNT | Connectivity for others | Single values: *NO Other values: Element list |
Optional |
| Element 1: Connection point | *YES | ||
| Element 2: Interfaces | Values (up to 12 repetitions): Element list | ||
| Element 1: Interface | Character value, *ALL, *SELECT | ||
| Element 2: L2TP profile name | Character value, *GEN, *SELECT | ||
| CNNPNTPRX | Connection point proxy | Element list | Optional |
| Element 1: Port number | 1-65535, *IBMSVR | ||
| Element 2: Authentication user ID | Character value, *NONE | ||
| Element 3: Authentication password | Character value, *NONE |
| Top |
Role (ROLE)
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.
This is a required parameter.
- *PRIMARY
- 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.
- *BACKUP
- 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.
| Top |
Connection type (CNNTYPE)
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.
This is a required parameter.
- *DIRECT
- 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.
- *OTHERISP
- 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.
- *MULTIHOP
- 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).
Note: Support for *LCLDIAL and *RMTDIAL was removed in IBM i 7.2 because IBM has dropped support for AT&T Global Network Services (AGNS). Equivalent dial functionality may be configured by specifying the *OTHERISP value and providing a configured internet service provider (ISP) connection profile or a Layer 2 Tunneling Protocol (L2TP) remote dial connection profile.
| Top |
Country or region ID (CNTRYID)
Specifies the country or region identifier used for the service configuration.
Note: This parameter is only valid when *PRIMARY is specified for the Role (ROLE) parameter.
- *SELECT
- A panel is displayed that allows the selection of a country or region identifier.
Note: This value is only valid if this command is run in an interactive job.
- character-value
- Specify the 2-character country or region identifier to be used.
| Top |
State or province code (STATE)
Specifies the state or province code used for the service configuration.
Note: This parameter is only valid when *PRIMARY is specified for the Role (ROLE) parameter.
- *SELECT
- 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.
Note: This value is only valid if this command is run in an interactive job.
- character-value
- Specify the 2-character state or province code to be used.
| Top |
ISP profile name (ISPPRF)
Specifies the internet service provider (ISP) connection profile that will be used.
Note: This parameter is only valid when *OTHERISP is specified for the Connection type (CNNTYPE) parameter.
- *SELECT
- A panel is displayed that allows the selection of the ISP connection profile that will be used.
- character-value
- Specify the name of the ISP connection profile that will be used.
| Top |
Remote system (RMTSYS)
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 address is accepted.
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.
- character-value
- Specify the IP address or host name of the remote system or logical partition that will provide the service configuration connection to IBM.
| Top |
Proxy server (PROXY)
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.
The information provides the server with the information needed to connect to the destination proxy server.
Single values
- *NO
- The IP address or host name is not specified. A proxy connection configuration will not be created.
Element 1: IP address or host name
- *NONE
- The IP address or host name is not specified. A proxy connection configuration will not be created.
- character-value
- Specify the IP address or host name of the proxy server through which this server will attempt to connect.
Element 2: Port number
- *IBMSVR
- The Service and Support proxy server will accept connections using the default port.
- 1-65535
- Specify the port number on which the Service and Support proxy server will accept connections.
Element 3: Relative priority
- *TRYAFTER
- The proxy connection configuration will be attempted after the previously defined configuration.
- *TRYBEFORE
- The proxy connection configuration will be attempted before the previously defined configuration.
Element 4: Authentication user ID
- *NONE
- A user ID is not required.
- character-value
- If the proxy server requires authentication, specify the user ID that will be used.
Element 5: Authentication password
- *NONE
- A password is not required.
- character-value
- If the proxy server requires authentication, specify the password that will be used.
| Top |
Connectivity for others (CNNPNT)
Specifies whether other systems or logical partitions are allowed to use the service configuration connection to IBM through this system or logical partition.
Note: This parameter is only valid when *PRIMARY is specified for the Role (ROLE) parameter.
Single values
- *NO
- Other systems or logical partitions are not allowed to use the service configuration connection to IBM configured on this system or logical partition.
Element 1: Connection point
- *YES
- Other systems or logical partitions are allowed to use the service configuration connection to IBM configured on this system or logical partition.
Element 2: Interfaces
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.
Element 1: Interface
- *ALL
- All available interfaces will listen for a connection.
- *SELECT
- Only selected interfaces will listen for a connection.
- character-value
- Specify the interface that will listen for a connection.
Element 2: L2TP profile name
- *GEN
- Automatically generate and name an L2TP profile to use as the terminator profile.
- *SELECT
- Select an existing L2TP profile to use as the terminator profile.
- character-value
- Specify the name of an L2TP terminator profile which will be used to provide connectivity for other systems or logical partitions.
| Top |
Connection point proxy (CNNPNTPRX)
Specifies the Service and Support proxy server to provide connectivity for other systems or logical partitions.
Element 1: Port number
- *IBMSVR
- The Service and Support proxy server will accept connections using the default port.
- 1-65535
- Specify the port number on which the Service and Support proxy server will accept connections.
Element 2: Authentication user ID
- *NONE
- A user ID is not required.
- character-value
- If the proxy server requires authentication, specify the user ID that will be used.
Element 3: Authentication password
- *NONE
- A password is not required.
- character-value
- If the proxy server requires authentication, specify the password that will be used.
| Top |
Examples
Example 1: Creating a Primary Direct Service Configuration
CRTSRVCFG ROLE(*PRIMARY) CNNTYPE(*DIRECT) CNTRYID(US)
STATE(MN) CNNPNT(*YES ((*ALL)))
This command creates a primary direct internet service configuration used for all service and support applications: Electronic Customer Support (ECS) and Electronic Service Agent. The local system or logical partition is a connection point which listens for connection requests on all interfaces.
Example 2: Creating a Backup Service Configuration Using an Existing ISP
CRTSRVCFG ROLE(*BACKUP) CNNTYPE(*OTHERISP) CNTRYID(US)
STATE(MN) ISPPRF(MYISP)
This command creates a backup internet service configuration using an internet service provider used for all service and support applications: Electronic Customer Support (ECS) and Electronic Service Agent.
Example 3: Creating a Backup Multi-hop Service Configuration
CRTSRVCFG ROLE(*BACKUP) CNNTYPE(*MULTIHOP)
CNTRYID(US) RMTSYS(ABCDEFG)
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) and Electronic Service Agent. The configuration connects using a multi-hop connection configuration through the remote system named ABCDEFG.
Example 4: Creating a Remote Point-to-Point Service Configuration
CRTSRVCFG ROLE(*PRIMARY) CNNTYPE(*OTHERISP) CNTRYID(US)
STATE(MN) ISPPRF(ABCDEFG)
This command creates a primary internet service configuration using the Layer 2 Tunneling Protocol (L2TP) remote dial connection profile ABCDEFG. The connection is used for all service and support applications: Electronic Customer Support (ECS) and Electronic Service Agent.
| Top |
Error messages
*ESCAPE Messages
- CPDB042
- Parameter RMTSYS required when CNNTYPE(*MULTIHOP) specified.
- TCP8050
- *IOSYSCFG authority required to use &1.
- TCP8290
- No TCP/IP point-to-point modem information
- CPF8813
- No entries exist.
- CPF9899
- Error occurred during processing of command.
- TCP8205
- Required object &2/&1 type *&3 not found.
- TCP8211
- Point-to-point profile &1 not found.
| Top |