Create Service Configuration (CRTSRVCFG)

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.

Parameters

Keyword	Description	Choices	Notes
ROLE	Role	PRIMARY, BACKUP	Required, Positional 1
CNNTYPE	Connection type	DIRECT, OTHERISP, LCLDIAL, MULTIHOP, *RMTDIAL	Required, Positional 2
CNTRYID	Country or region ID	Character value, *SELECT	Optional
STATE	State or province code	Character value, *SELECT	Optional
TELNBR1	Primary telephone number	Character value, *SELECT	Optional
TELNBR2	Alternate telephone number	Character value, *SELECT	Optional
RSRCNAME	Resource name	Name, CALC, SELECT	Optional
MODEM	Modem information name	Character value, RSRCNAME, SELECT	Optional
DIALTONE	Wait for dial tone	WAIT, NOWAIT	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

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.

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.
*LCLDIAL: Connect to IBM through the current system or logical partition with a dial connection using AT&T Global Network Services (AGNS).
*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).
*RMTDIAL: Connect to IBM through another system or logical partition using AT&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&T Global Network Services (AGNS).

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.

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.

Primary telephone number (TELNBR1)

Specifies the primary telephone number that will be dialed to connect to AT&T Global Network Services (AGNS).

Note: This parameter is only valid when *LCLDIAL is specified for the Connection type (CNNTYPE) parameter.

*SELECT: 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.
character-value: Specify the primary telephone number that will be dialed. Up to 48 characters can be specified.

Alternate telephone number (TELNBR2)

Specifies the alternate telephone number that will be dialed to connect to AT&T Global Network Services (AGNS), if the connection attempt using the primary telephone number is unsuccessful.

Note: This parameter is only valid when *LCLDIAL is specified for the Connection type (CNNTYPE) parameter.

*SELECT: 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.
character-value: Specify the alternate telephone number that will be dialed. Up to 48 characters can be specified.

Resource name (RSRCNAME)

Specifies the communications resource that will be used by this service.

Note: This parameter is only valid when *LCLDIAL is specified for the Connection type (CNNTYPE) parameter.

*CALC

The resource name will be determined as follows:

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.

If an integrated modem cannot be used, the resource cannot be calculated and it will have to be specified explicitly.

*SELECT

A panel is displayed that allows the selection of the resource name that will be used.

name

Specify the name of the communications resource that will be used.

Note: Use the Work with Hardware Resources (WRKHDWRSC) command with *CMN specified for the TYPE parameter to help determine the resource name.

Modem information name (MODEM)

Specifies the name of the modem description to use for this point-to-point service configuration.

Note: This parameter is only valid when *LCLDIAL is specified for the Connection type (CNNTYPE) parameter.

*RSRCNAME: The modem name will be determined based on the value specified for the Resource name (RSRCNAME) 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.
*SELECT: A panel is displayed that allows the selection of the modem description that will be used.
character-value: Specify the name of the modem to use.
Note: The modem name must match one of the modems defined for the system or logical partition.

Wait for dial tone (DIALTONE)

Specifies whether or not the modem waits for a dial tone before dialing out.

Note: This parameter is only valid when *LCLDIAL is specified for the Connection type (CNNTYPE) parameter.

*WAIT: The modem waits for a dial tone before dialing out.
*NOWAIT: The modem dials out without waiting for a dial tone.

ISP profile name (ISPPRF)

Specifies the internet service provider (ISP) 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 profile that will be used.
character-value: Specify the name of the ISP profile that will be used.

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(*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).

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.

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.

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.

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.

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. The local system or logical partition is a connection point which listens for connection requests on all interfaces.

Example 3: Creating a Primary Local Dial Service Configuration

CRTSRVCFG   ROLE(*PRIMARY)  CNNTYPE(*LCLDIAL)  CNTRYID(US)
            STATE(MN)  TELNBR1(1111111)  TELNBR2(2222222)

This command creates a primary local dial connnection to AT&T Global Network Services (AGNS) used for all service and support applications: Electronic Customer Support (ECS) and Electronic Service Agent.

Example 4: 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 5: Creating a Remote Point-to-Point Service Configuration

CRTSRVCFG   ROLE(*PRIMARY)  CNNTYPE(*RMTDIAL)  CNTRYID(US)
            STATE(MN)  RMTSYS(ABCDEFG)

This command creates a primary remote dial connnection to AT&T Global Network Services (AGNS) used for all service and support applications: Electronic Customer Support (ECS) and Electronic Service Agent. This configuration connects using a dial connection configuration on a remote system named ABCDEFG.

Example 6: Creating a Primary Local Dial Service Configuration with a Modem that Waits for a Dial Tone Before Dialing

CRTSRVCFG   ROLE(*PRIMARY)  CNNTYPE(*LCLDIAL)  CNTRYID(US)
            STATE(MN)  DIALTONE(*WAIT)
            TELNBR1(1111111)  TELNBR2(2222222)

This command creates a local dial connection configured to have a modem wait for a dial tone before dialing out.

Error messages

*ESCAPE Messages

CPFB040: If RSRCNAME(*SELECT) is specified, MODEM(*RSRCNAME) cannot be specified.
CPDB042: Parameter RMTSYS required when CNNTYPE(*RMTDIAL) or 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.