Change Comm Side Information (CHGCSI)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
Error messages
*ESCAPE Messages
- CPF3B8B
- Communications side information object &1 not changed in library &2.
| Top |