Aller au contenu

CHGCSI

Modifier infos annexes comm

Change Comm Side Information

En bref

La commande Modification d'informations annexes de communication (CHGCSI) permet de modifier un objet d'informations annexes dans une bibliothèque donnée. The Change Communications Side Information (CHGCSI) command is used to change a side information object in a specific library.

CHGCSI se lit CHG (Modifier) + CSI. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CHGCSI CSI(…)

Paramètres

  • CSI Informations annexes Side information obligatoire
  • RMTLOCNAME Emplacement distant Remote location
  • TNSPGM Programme de transaction Transaction program
  • TEXT Texte 'descriptif'
  • DEV Unité
  • LCLLOCNAME Emplacement local Local location
  • MODE Mode
  • RMTNETID ID éloigné réseau

Astuce : dans une session 5250, tapez CHGCSI puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande Modification d'informations annexes de communication (CHGCSI) permet de modifier un objet d'informations annexes dans une bibliothèque donnée. The Change Communications Side Information (CHGCSI) command is used to change a side information object in a specific library.

Consultez APPC Programming, SC41-5443, pour savoir comment le système utilise les paramètres RMTLOCNAME, DEV, LCLLOCNAME et RMTNETID pour sélectionner une description d'unité APPC. Refer to the APPC Programming, SC41-5443, for information on how the system uses the RMTLOCNAME, DEV, LCLLOCNAME, and RMTNETID parameters to select an APPC device description.

Paramètres

Mot-clé Description Valeurs possibles Remarques
CSI Informations annexesSide information Nom d'objet qualifié Obligatoire, clé, positionnel 1
Qualificatif 1 : Informations annexesQualificatif 1: Side information Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
RMTLOCNAME Emplacement distantRemote location Nom de communication, *SAME Facultatif
TNSPGM Programme de transactionTransaction program Valeur caractère, *SAME Facultatif
TEXT Texte 'descriptif' Valeur caractère, *SAME, *BLANK Facultatif
DEV Unité Nom de communication, *SAME, *LOC Facultatif
LCLLOCNAME Emplacement localLocal location Nom de communication, *SAME, *LOC, *NETATR Facultatif
MODE Mode Nom de communication, *SAME, *NETATR Facultatif
RMTNETID ID éloigné réseau Nom de communication, *SAME, *LOC, *NETATR, *NONE Facultatif

Informations annexes (CSI)Side information (CSI)

Indique le nom de l'objet d'informations annexes à modifier. Un nom d'objet doit être indiqué. Specifies the name of the side information object to be changed. An object name must be specified.

Ce paramètre est obligatoire. This is a required parameter.

Les valeurs de bibliothèque possibles sont les suivantes : The possible library values are:

*LIBL
Toutes les bibliothèques de la liste de bibliothèques de l'unité d'exécution en cours sont recherchées jusqu'à ce que la première occurrence soit trouvée. All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB
La bibliothèque en cours est utilisée pour localiser l'objet d'informations annexes. Si aucune bibliothèque n'est indiquée comme bibliothèque en cours, QGPL est utilisée. The current library is used to locate the side information object. If no library is specified as the current library, the QGPL is used.
nom-bibliothèque
Indiquez le nom de la bibliothèque où se trouve l'objet d'informations annexes. Specify the name of the library where the side information object is located.
side-information-name
Indiquez le nom de l'objet qui contiendra l'objet d'informations annexes souhaité. L'objet d'informations annexes est accessible par le paramètre de nom de destination symbolique (sym_dest_name) de l'appel Initialize_Conversation (CMINIT). 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.

Emplacement distant (RMTLOCNAME)Remote location (RMTLOCNAME)

Indique le nom de l'emplacement distant avec lequel votre programme communique. Le partner_LU_name de CPI (Common Programming Interface) Communications, qui se compose de l'identificateur de réseau distant et de l'emplacement distant, détermine l'unité logique distante du programme distant. 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.

Les valeurs possibles sont : The possible values are:

*SAME
Le nom de l'emplacement distant ne change pas. The remote location name does not change.
remote-location-name
Indiquez le nom de l'emplacement distant associé au nom de destination symbolique. Specify the name of the remote location that is associated with the symbolic destination name.

Programme de transaction (TNSPGM)Transaction program (TNSPGM)

Indique le nom du programme de transaction à démarrer sur le système distant. Specifies the name of the transaction program on the remote system to be started.

Les valeurs possibles sont : The possible values are:

*SAME
Le nom du programme de transaction ne change pas. The transaction program name does not change.
transaction-program-name
Indiquez jusqu'à 64 caractères pour le nom du programme de transaction. Specify up to 64 characters for the transaction program name.

Remarque :Si le nom de programme de transaction indiqué contient des caractères qui ne font pas partie du jeu de caractères 00640, la représentation hexadécimale du nom du programme de transaction est affichée. Par exemple, un nom de programme de transaction dont la représentation hexadécimale est 21F0F0F1 est affiché sous la forme X'21F0F0F1'. Remarque :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'.

Pour plus d'informations sur les jeux de caractères, consultez CPI Communications Reference, SC26-4399. More information on character sets is in the CPI Communications Reference, SC26-4399.

Texte 'descriptif' (TEXT)

Indique le texte qui décrit brièvement l'objet. Specifies the text that briefly describes the object.

Les valeurs possibles sont : The possible values are:

*SAME
Le texte ne change pas. The text does not change.
*BLANK
Aucun texte n'est indiqué. No text is specified.
'description'
Indiquez 50 caractères de texte au maximum, placés entre apostrophes. Specify no more than 50 characters of text, enclosed in apostrophes.

Unité (DEV)

Indique le nom de la description d'unité utilisée pour le système distant. Specifies the name of the device description used for the remote system.

Les valeurs possibles sont : The possible values are:

*SAME
Le nom de l'unité ne change pas. The device name does not change.
*LOC
L'unité est déterminée par le système. The device is determined by the system.
device-name
Indiquez le nom de l'unité associée à l'emplacement distant. Specify the name of the device that is associated with the remote location.

Emplacement local (LCLLOCNAME)Local location (LCLLOCNAME)

Indique le nom de l'emplacement local. Specifies the local location name.

Les valeurs possibles sont : The possible values are:

*SAME
Le nom de l'emplacement local ne change pas. The local location name does not change.
*LOC
Le nom de l'emplacement est déterminé par le système. The location name is determined by the system.
*NETATR
La valeur LCLLOCNAME indiquée dans les attributs réseau du système est utilisée. The LCLLOCNAME value specified in the system network attributes is used.
local-location-name
Indiquez le nom de votre emplacement. Indiquez l'emplacement local si vous souhaitez indiquer un nom d'emplacement spécifique pour l'emplacement distant. 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)

Indique le mode utilisé pour contrôler la session. Ce nom est le même que le mode_name de CPI (Common Programming Interface) Communications. Specifies the mode used to control the session. This name is the same as the Common Programming Interface (CPI)- Communications mode_name.

Les valeurs possibles sont : The possible values are:

*SAME
Le nom du mode ne change pas. The mode name does not change.
*NETATR
Le mode des attributs réseau est utilisé. The mode in the network attributes is used.
BLANK
Huit caractères blancs sont utilisés. Eight blank characters are used.
mode-name
Specify a mode name for the remote location.

Remarque :SNASVCMG et CPSVCMG ne sont pas autorisés. Remarque :SNASVCMG and CPSVCMG are not allowed.

ID éloigné réseau (RMTNETID)

Indique l'identificateur de réseau distant utilisé avec l'emplacement distant. Le partner_LU_name de CPI (Common Programming Interface) Communications, qui se compose de l'identificateur de réseau distant et de l'emplacement distant, détermine l'unité logique distante du programme distant. 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.

Les valeurs possibles sont : The possible values are:

*SAME
L'ID de réseau distant ne change pas. The remote network ID does not change.
*LOC
L'ID de réseau distant de l'emplacement distant est utilisé. The remote network ID for the remote location is used.
*NETATR
L'identificateur de réseau distant indiqué dans les attributs réseau est utilisé. The remote network identifier specified in the network attributes is used.
*NONE
Le réseau distant n'a pas de nom. The remote network has no name.
remote-network-id
Indiquez un ID de réseau distant. Specify a remote network ID.

Exemples 

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

Cette commande modifie l'ID de réseau distant en *NETATR dans l'objet d'informations annexes de communication SIDEOBJ de la bibliothèque QGPL. This command changes the remote network ID to *NETATR in the communications side information object SIDEOBJ in library QGPL.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF3B8B
L'objet d'informations annexes de communication &1 n'a pas été modifié dans la bibliothèque &2. Communications side information object &1 not changed in library &2.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.