CRTCSI

La commande Créer informations complémentaires de communications (CRTCSI) crée un objet d'informations complémentaires dans une bibliothèque donnée. Le nom de l'objet d'informations complémentaires doit être unique dans la bibliothèque dans laquelle il doit être créé. Pour plus d'informations sur la façon dont le système utilise les paramètres RMTLOCNAME, DEV, LCLLOCNAME et RMTNETID pour sélectionner une description d'unité APPC, consultez APPC Programming, SC41-5443. The Create Communications Side Information (CRTCSI) command creates a side information object in a specific library. The side information object name must be unique in the library in which the side information object is to be created. More information on how the system uses the RMTLOCNAME, DEV, LCLLOCNAME, and RMTNETID parameters to select an APPC device description is in the APPC Programming, SC41-5443.

Paramètres

Informations annexes (CSI)Side information (CSI)

Indique le nom de l'objet d'informations complémentaires à créer. Un nom d'objet doit être indiqué. Specifies the name of the side information object to be created. An object name must be specified.

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

side-information-name

Indiquez le nom de l'objet qui contiendra l'objet d'informations complémentaires souhaité. Specify the name of the object that will contain the desired side information object.

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

*CURLIB

L'objet d'informations complémentaires est créé dans la bibliothèque en cours. Si aucune bibliothèque en cours n'est définie pour le travail, QGPL est utilisée. The side information object is created in the current library. If no library is specified as the current library for the job, QGPL is used.

nom-bibliothèque

Indiquez le nom de la bibliothèque dans laquelle l'objet d'informations complémentaires est créé. Specify the name of the library where the side information object is created.

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.

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

Programme de transaction (TNSPGM)Transaction program (TNSPGM)

Indique le nom (64 caractères au maximum) du programme de transaction à démarrer sur le système distant. Specifies the name (up to 64 characters) of the transaction program on the remote system to be started.

\nRemarque : Pour indiquer des noms de programmes de transaction de service SNA, entrez la représentation hexadécimale du nom du programme de transaction de service. Par exemple, pour indiquer un nom de programme de transaction de service dont la représentation hexadécimale est 21F0F0F1, vous entrez X'21F0F0F1'. Remarque :To specify SNA service transaction program names, enter the hexadecimal representation of the service transaction program name. For example, to specify a service transaction program name whose hexadecimal representation is 21F0F0F1, you would enter X'21F0F0F1'.

Pour plus d'informations sur les noms de programmes de transaction de service SNA, consultez SNA Transaction Programmer's Reference Manual for LU Type 6.2. More information on SNA service transaction program names is in the SNA Transaction Programmer's Reference Manual for LU Type 6.2.

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

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:

*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:

*LOC

device-name

L'unité est déterminée par le système. The device is determined by the system.

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:

*LOC

Le nom d'emplacement local est déterminé par le système. The local 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:

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

\nRemarque : Les valeurs SNASVCMG et CPSVCMG ne sont pas autorisées. Remarque :The values 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:

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

Droits (AUT)

Indique les droits que vous accordez aux utilisateurs qui n'ont pas de droits spécifiques sur l'objet, qui ne figurent pas dans une liste d'autorisation et dont le profil de groupe ou les profils de groupe supplémentaires n'ont pas de droits spécifiques sur l'objet. Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.

Les valeurs possibles sont : The possible values are:

*LIBCRTAUT

Les droits publics sur l'objet sont extraits du paramètre CRTAUT de la bibliothèque indiquée. Cette valeur est déterminée à la création. Si la valeur CRTAUT de la bibliothèque est modifiée après la création de l'objet, la nouvelle valeur n'affecte pas les objets existants. Public authority for the object is taken from the CRTAUT parameter of the specified library. This value is determined at create time. If the CRTAUT value for the library changes after the object is created, the new value does not affect existing objects.

*CHANGE

L'utilisateur peut effectuer toutes les opérations sur l'objet, à l'exception de celles réservées au propriétaire ou contrôlées par les droits d'existence de l'objet (*OBJEXIST) et de gestion de l'objet (*OBJMGT). L'utilisateur peut modifier l'objet et exécuter des fonctions de base sur celui-ci. Le droit *CHANGE fournit le droit d'exploitation de l'objet (*OBJOPR) et tous les droits sur les données. Si l'objet est une liste d'autorisation, l'utilisateur ne peut pas ajouter, modifier ni retirer d'utilisateurs. The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.

*ALL

L'utilisateur peut effectuer toutes les opérations, à l'exception de celles réservées au propriétaire ou contrôlées par le droit de gestion de la liste d'autorisation (*AUTLMGT). L'utilisateur peut contrôler l'existence de l'objet, définir sa sécurité, le modifier et exécuter des fonctions de base sur celui-ci. L'utilisateur peut également changer la propriété de l'objet. The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.

*USE

L'utilisateur peut effectuer des opérations de base sur l'objet, telles que l'exécution d'un programme ou la lecture d'un fichier. L'utilisateur ne peut pas modifier l'objet. Le droit d'utilisation (*USE) fournit les droits d'exploitation de l'objet (*OBJOPR), de lecture (*READ) et d'exécution (*EXECUTE). The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.

*EXCLUDE

L'utilisateur ne peut pas accéder à l'objet. The user cannot access the object.

authorization-list

Indiquez le nom de la liste d'autorisation dont les droits sont utilisés pour les informations complémentaires. Specify the name of the authorization list whose authority is used for the side information.

Exemples

CRTCSI   CSI(QGPL/SIDEOBJ)  RMTLOCNAME(APPC2)
         TNSPGM(TESTNOP)  AUT(*CHANGE)

Cette commande crée un objet d'informations complémentaires de communications nommé SIDEOBJ dans la bibliothèque QGPL. Le nom d'emplacement distant est défini à APPC2 et le nom du programme de transaction à TESTNOP. Le droit sur l'objet est *CHANGE. This command creates a communications side information object named SIDEOBJ in library QGPL. The remote location name is set to APPC2, the transaction program name to TESTNOP. The authority to the object is *CHANGE.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF3B82

L'objet d'informations complémentaires de communications &1 existe déjà dans la bibliothèque &2. Communications side information object &1 already exists in library &2.

CPF3B83

L'objet d'informations complémentaires de communications &1 n'a pas été créé dans la bibliothèque &2. Communications side information object &1 not created in library &2.