Change Service Configuration (CHGSRVCFG)

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.

Restrictions:

Input/output system configuration (*IOSYSCFG) special authority is required to run this command.

Parameters

Keyword	Description	Choices	Notes
ROLE	Role	PRIMARY, BACKUP	Required, Key, Positional 1
CNNTYPE	Connection type	SAME, DIRECT, OTHERISP, LCLDIAL, MULTIHOP, RMTDIAL	Optional
CNTRYID	Country or region ID	Character value, SAME, SELECT	Optional
STATE	State or province code	Character value, SAME, SELECT	Optional
TELNBR1	Primary telephone number	Character value, SAME, SELECT	Optional
TELNBR2	Alternate telephone number	Character value, SAME, SELECT	Optional
RSRCNAME	Resource name	Name, SAME, CALC, *SELECT	Optional
MODEM	Modem information name	Character value, SAME, RSRCNAME, *SELECT	Optional
RMTSYS	Remote system	Character value, *SAME	Optional
PROXY	Proxy server	Single values: NO Other values: Element list*	Optional
	Element 1: IP address or host name	Character value, *SAME
	Element 2: Port number	1-65535, SAME, IBMSVR
	Element 3: Relative priority	SAME, TRYAFTER, *TRYBEFORE
	Element 4: Authentication user ID	Character value, SAME, NONE
	Element 5: Authentication password	Character value, SAME, NONE
ISPPRF	ISP profile name	Character value, SAME, SELECT	Optional
CNNPNT	Connectivity for others	Single values: NO Other values: Element list*	Optional
	Element 1: Connection point	SAME, YES
	Element 2: Interfaces	Values (up to 12 repetitions): Element list
	Element 1: Interface	Character value, SAME, ALL, *SELECT
	Element 2: L2TP profile name	Character value, SAME, GEN, *SELECT
CNNPNTPRX	Connection point proxy	Element list	Optional
	Element 1: Port number	1-65535, SAME, IBMSVR
	Element 2: Authentication user ID	Character value, SAME, NONE
	Element 3: Authentication password	Character value, SAME, NONE

Top

Role (ROLE)

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.

*PRIMARY: The primary service configuration will be changed.
*BACKUP: The backup service configuration will be changed.

Connection type (CNNTYPE)

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.

Note: 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.

*SAME: The connection type does not change.
*DIRECT: The current system or logical partition uses a direct connection to the internet as the connection type.
*OTHERISP: The current system or logical partition uses an internet service provider (ISP) as the connection type.
*LCLDIAL: The current system or logical partition uses a dial connection using AT&T Global Network Services (AGNS) as the connection type.
*MULTIHOP: The current system or logical partition uses a multi-hop connection to the internet as the connection type.
*RMTDIAL: 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.

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.

*SAME: The country or region identifier does not change.
*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: Specifies the 2-character country or region identifier that will 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.

*SAME: The state or province code does not change.
*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: Specifies the 2-character state or province code that will be used.

Primary telephone number (TELNBR1)

Specifies the primary telephone number 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.

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

Alternate telephone number (TELNBR2)

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.

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

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

Resource name (RSRCNAME)

Specifies the communications resource used by this service.

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

*SAME

The resource name does not change.

*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 confuguration. 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 be used.

name

Specifies 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.

*SAME: The modem name does not change.
*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: Specifies the modem name. Note that the modem name must match one of the modems defined for the system or logical partition.

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 Version 4 address will be 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.

*SAME: The remote system does not change.
character-value: Specifies 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 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.

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 will not be used.

Element 1: IP address or host name

*SAME: The value does not change.
character-value: Specifies the IP address or host name of the proxy server through which this server will attempt to connect.
*NONE: The IP address or host name is not specified. A proxy connection configuration will not be created.

Element 2: Port number

*SAME: The value does not change.
*IBMSVR: The Service and Support proxy server will accept connections using the default port.
1-65535: Specifies the port number on which the Service and Support proxy server will accept connections.

Element 3: Relative priority

*SAME: The value does not change.
*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

*SAME: The value does not change.
*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

*SAME: The value does not change.
*NONE: A password is not required.
character-value: If the proxy server requires authentication, specify the password that will be used.

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.

*SAME: The ISP profile name does not change.
*SELECT: A panel is displayed that allows the selection of the ISP profile that will be used.
character-value: Specifies the name of the ISP profile 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

*SAME: The value is not changed.
*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

*SAME: The value does not change.
*ALL: All available interfaces will listen for a connection.
*SELECT: Only selected interfaces will listen for a connection.
character-value: Specifies the interface that will listen for a connection.

Element 2: L2TP profile name

*SAME: The value does not change.
*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: Specifies 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

*SAME: The value does not change.
*IBMSVR: The Service and Support proxy server will accept connections using the default port.
1-65535: Specifies the port number on which the Service and Support proxy server will accept connections.

Element 2: Authentication user ID

*SAME: The value does not change.
*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

*SAME: The value does not change.
*NONE: A password is not required.
character-value: If the proxy server requires authentication, specify the password that will be used.

Examples

Example 1: Change a Local Dial Primary Service Configuration

CHGSRVCFG   ROLE(*PRIMARY)  CNNTYPE(*SAME)  TELNBR1(3333333)

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.

Example 2: Change a Direct Internet Backup Service Configuration

CHGSRVCFG   ROLE(*BACKUP)  CNNTYPE(*SAME)  PROXY('10.1.1.1')

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.

Error messages

*ESCAPE Messages

CPFB040: If RSRCNAME(*SELECT) is specified, MODEM(*RSRCNAME) cannot be 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.