Change Comm Side Information (CHGCSI)

The Change Communications Side Information (CHGCSI) command is used to change a side information object in a specific library.

Refer to the APPC Programming book, SC41-5443, for information on how the system uses the RMTLOCNAME, DEV, LCLLOCNAME, and RMTNETID parameters to select an APPC device description.

Parameters

Keyword	Description	Choices	Notes
CSI	Side information	Qualified object name	Required, Key, Positional 1
	Qualifier 1: Side information	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
RMTLOCNAME	Remote location	Communications name, *SAME	Optional
TNSPGM	Transaction program	Character value, *SAME	Optional
TEXT	Text 'description'	Character value, SAME, BLANK	Optional
DEV	Device	Communications name, SAME, LOC	Optional
LCLLOCNAME	Local location	Communications name, SAME, LOC, *NETATR	Optional
MODE	Mode	Communications name, SAME, NETATR	Optional
RMTNETID	Remote network identifier	Communications name, SAME, LOC, NETATR, NONE	Optional

Top

Side information (CSI)

Specifies the name of the side information object to be changed. An object name must be specified.

This is a required parameter.

The possible library values are:

*LIBL: All libraries in the library list for the current thread are searched until the first match is found.

*CURLIB: The current library is used to locate the side information object. If no library is specified as the current library, the QGPL is used.
library-name: Specify the name of the library where the side information object is located.
side-information-name: Specify the name of the object that will contain the desired side information object. The side information object is accessed by the symbolic destination name (sym_dest_name) parameter on the Initialize_Conversation (CMINIT) call.

Remote location (RMTLOCNAME)

Specifies the remote location name with which your program communicates. The Common Programming Interface (CPI)- Communications partner_LU_name, which consists of the remote network identifier and the remote location, determines the remote logical unit of the remote program.

The possible values are:

*SAME: The remote location name does not change.
remote-location-name: Specify the name of the remote location that is associated with the symbolic destination name.

Transaction program (TNSPGM)

Specifies the name of the transaction program on the remote system to be started.

The possible values are:

*SAME: The transaction program name does not change.
transaction-program-name: Specify up to 64 characters for the transaction program name.

Note: If the specified transaction program name contains characters that are not in the character set 00640, the hexadecimal representation of the transaction program name are displayed. For example, a transaction program name whose hexadecimal representation is 21F0F0F1 is displayed as X'21F0F0F1'.

More information on character sets is in the CPI Communications Reference, SC26-4399.

Text 'description' (TEXT)

Specifies the text that briefly describes the object.

The possible values are:

*SAME: The text does not change.
*BLANK: No text is specified.
'description': Specify no more than 50 characters of text, enclosed in apostrophes.

Device (DEV)

Specifies the name of the device description used for the remote system.

The possible values are:

*SAME: The device name does not change.
*LOC: The device is determined by the system.
device-name: Specify the name of the device that is associated with the remote location.

Local location (LCLLOCNAME)

Specifies the local location name.

The possible values are:

*SAME: The local location name does not change.
*LOC: The location name is determined by the system.

*NETATR: The LCLLOCNAME value specified in the system network attributes is used.

local-location-name: Specify the name of your location. Specify the local location if you want to indicate a specific location name for the remote location.

Mode (MODE)

Specifies the mode used to control the session. This name is the same as the Common Programming Interface (CPI)- Communications mode_name.

The possible values are:

*SAME: The mode name does not change.

*NETATR: The mode in the network attributes is used.

BLANK: Eight blank characters are used.
mode-name: Specify a mode name for the remote location.
Note: SNASVCMG and CPSVCMG are not allowed.

Remote network identifier (RMTNETID)

Specifies the remote network identifier used with the remote location. The Common Programming Interface (CPI)- Communications partner_LU_name, which consists of the remote network identifier and the remote location, determines the remote logical unit of the remote program.

The possible values are:

*SAME: The remote network ID does not change.
*LOC: The remote network ID for the remote location is used.

*NETATR: The remote network identifier specified in the network attributes is used.

*NONE: The remote network has no name.
remote-network-id: Specify a remote network ID.

Examples

CHGCSI   CSI(QGPL/SIDEOBJ)  RMTNETID(*NETATR)

This command changes the remote network ID to *NETATR in the communications side information object SIDEOBJ in library QGPL.