CHGCSI (Change Communications Side Information)

CHGCSI Command syntax diagram

 

Purpose

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

Refer to APPC, APPN, and HPR topic in the Information Center for information on how the system uses the RMTLOCNAME, DEV, LCLLOCNAME, and RMTNETID parameters to select an APPC device description.

 

Required Parameters

CSI

Specifies the name of the object that contains 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.

The name of the side information object can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

side-information-name: Specify the name of the object that contains the side information. This is the CPI-Communications symbolic destination name (sym_dest_name).

 

Optional Parameters

RMTLOCNAME

Specifies the remote location name of the system with which this object 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.

*SAME: The value does not change.

remote-location-name: Specify the remote location that is associated with the symbolic destination name.

TNSPGM

Specifies the name (up to 64 characters) of the transaction program on the remote system to be started. This is the CPI-Communications TP_name.

*SAME: The value does not change.

transaction-program-name: Specify the transaction program name. The user can enter SNA service transaction program names by specifying hexadecimal input. For example, '03F0F0F4' is a valid input format for an SNA service transaction program.

DEV

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

*SAME: The value does not change.

*LOC: The device associated with the remote location is used. If several devices are associated with the remote location, the system determines which device is used.

device-name: Specify the name of a communications device associated with the remote location. If the device name is not valid for the remote location, a message is sent when the program device entry is acquired. More information on device names is in APPC, APPN, and HPR topic in the Information Center.

LCLLOCNAME

Specifies the local location name.

*SAME: The value does not change.

*LOC: The device associated with the remote location is used. If several devices are associated with the remote location, the system determines which device is used.

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

local-location-name: Specify the name of the local location. Specify the local location if the remote location will also be indicated by a specific local location name.

MODE

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

*SAME: The value does not change.

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

mode-name: Specify a mode_name for the remote location.

Note:

The values SNASVCMG and CPSVCMG cannot be specified.

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, locates the logical unit at which the remote program is located.

*SAME: The value does not change.

*LOC: The remote network ID for the remote location is used.

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

*NONE: The remote network has no name.

remote-network-ID: Specify a remote network ID.

TEXT

Specifies the text that briefly describes the object. More information is in Commonly used parameters.

*SAME: The value does not change.

*BLANK: Text is not specified.

'description': Specify no more than 50 characters of text, enclosed in apostrophes.

Example for CHGCSI

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.

Error messages for CHGCSI

*ESCAPE Messages

CPF3B8B

Communications side information object &1 not changed in library &2.