Aller au contenu

ADDICFDEVE

Ajouter unité à fichier ICF

En bref

La commande ADDICFDEVE (Ajouter un poste unité à un fichier ICF) permet d'ajouter une unité programme au fichier ICF indiqué.

ADDICFDEVE se lit ADD (Ajouter) + ICFDEVE. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

ADDICFDEVE FILE(…) PGMDEV(…) RMTLOCNAME(…)

Paramètres

Astuce : dans une session 5250, tapez ADDICFDEVE 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 ADDICFDEVE (Ajouter un poste unité à un fichier ICF) permet d'ajouter une unité programme au fichier ICF indiqué.

Paramètres

Mot-clé Description Valeurs possibles Remarques
FILE Fichier Nom d'objet qualifié Obligatoire, positionnel 1
Qualificatif 1: Fichier Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
PGMDEV Unité-programme Valeur caractère Obligatoire, positionnel 2
RMTLOCNAME Lieu éloigné Nom de communication, *REQUESTER Obligatoire, positionnel 3
CMNTYPE Type de communication *ALL, *APPC, *ASYNC, *BSCEL, *FINANCE, *INTRA, *RETAIL, *SNUF Facultatif, positionnel 4
DEV Unité Nom, *LOC Facultatif
LCLLOCNAME Lieu local Nom de communication, *LOC, *NETATR Facultatif
MODE Mode Nom de communication, *NETATR Facultatif
RMTNETID ID éloigné réseau Nom de communication, *LOC, *NETATR, *NONE Facultatif
FMTSLT Sélection de format *PGM, *RECID, *RMTFMT Facultatif
APPID Identificateur d'application Nom, *DEVD, *USER Facultatif
BATCH Activité par lots *YES, *NO Facultatif
HOST Type d'hôte *DEVD, *CICS, *IMS, *IMSRTR Facultatif
ENDSSNHOST Fin de la session hôte *RSHUTD, *TERMSELF Facultatif
SPCHOSTAPP Application hôte spéciale *DEVD, *NONE, *FLASH Facultatif
INZSELF INIT-SELF formaté *NO, *YES Facultatif
HDRPROC Traitement d'en-tête *SYS, *USER Facultatif
MSGPTC Protection des messages *YES, *NO Facultatif
EMLDEV Unité d'émulation Valeurs uniques: *NONE
Autres valeurs: Liste d'éléments
Facultatif
Élément 1: Type d'unité 3278, 3284, 3286, 3287, 3288, 3289
Élément 2: Format des données *UNFORMAT, *FIELD, *EXTFIELD, *NOFIELD
CNVTYPE Type de conversation *SYS, *USER, *SRCPGM Facultatif
BLOCK Type de groupage Liste d'éléments Facultatif
Élément 1: Type de groupage *DEVD, *NONE, *ITB, *IRS, *NOSEP, *USER, *SEP
Élément 2: Séparateur d'enreg, si *SEP Valeur hexadécimale, X'1E'
RCDLEN Longueur d'enregistrement 1-32767, *DEVD Facultatif
BLKLEN Longueur de bloc 1-32767, *DEVD Facultatif
TRNSPY Transmission mode transparent *DEVD, *NO, *YES Facultatif
DTACPR Compression et décompression *DEVD, *NO, *YES Facultatif
TRUNC Suppression blancs de fin *DEVD, *NO, *YES Facultatif
OVRFLWDTA Données excédentaires *DISCARD, *RETAIN Facultatif
GRPSEP Type séparateur de groupe *DEVD, *EOT, *DEV3740, *OFCSYS Facultatif
RMTBSCEL BSCEL à distance *DEVD, *NO, *YES Facultatif
INLCNN Connexion initiale *CTLD, *DIAL, *ANS Facultatif

Fichier (FILE)

Indique le fichier ICF auquel l'unité programme ICF doit être ajoutée.

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier

nom
Indiquez le nom du fichier ICF.

Qualificateur 2 : Biblio

*LIBL
La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.
*CURLIB
Le fichier ICF est recherché dans la bibliothèque en cours. Si cette dernière n'est pas précisée, QGPL est prise par défaut.
nom
Indiquez la bibliothèque contenant le fichier ICF.

Unité-programme (PGMDEV)

Indique le nom de l'unité programme ICF à ajouter. Pour un fichier ICF, le nombre total d'unités programme pouvant être ajoutées (défini dans la commande ADDICFDEVE ou dans la commande OVRICFDEVE) est déterminé par le paramètre Nombre maximal d'unités pgm (MAXPGMDEV) de la commande CRTICFF (Créer un fichier ICF) ou de la commande CHGICFF (Modifier un fichier ICF).

Le nom indiqué pour ce paramètre est l'unité de fichier ICF avec laquelle le programme de l'utilisateur communique. Ce nom est utilisé pour des opérations d'entrée-sortie spécifiques à l'unité, afin d'identifier l'unité programme et ses attributs. Bien que l'utilisateur puisse indiquer le même nom de lieu éloigné sur plusieurs unités de fichier, chaque nom d'unité programme doit être unique parmi les unités du fichier ICF. L'utilisateur peut ainsi ouvrir plusieurs sessions sur le même lieu éloigné ou affecter des valeurs d'attribut différentes pour chaque session sur le même lieu éloigné.

Remarque :Reportez-vous au manuel APPC Programming, SC41-5443 pour plus d'informations sur l'utilisation des paramètres RMTLOCNAME, DEV, LCLLOCNAME et RMTNETID permettant de sélectionner une description d'unité APPC.

Ce paramètre est obligatoire.

valeur-alphanumérique
Indiquez le nom de l'unité programme ICF à ajouter. Ce nom est utilisé pour des opérations d'entrée-sortie spécifiques à l'unité, afin d'identifier l'unité programme et les attributs. Ce nom d'unité-programme doit être unique parmi les postes du fichier ICF.

Lieu éloigné (RMTLOCNAME)

Indique le nom du lieu éloigné avec lequel le programme communique.

Ce paramètre est obligatoire.

*REQUESTER
Le nom qui permet de désigner l'unité de communication via laquelle le programme est démarré est utilisé. La session qui est attribuée lorsque l'unité programme est acquise correspond à la même session dans laquelle la demande de démarrage de programme est reçue. Si le programme n'est pas démarré à la suite d'une demande correspondante, l'opération d'affectation de l'unité programme échoue. Le programme cible utilise *REQUESTER comme nom de lieu éloigné dans le fichier ICF pour se connecter à la session utilisée par le programme source pour envoyer la demande de démarrage de programme.

La valeur *REQUESTER peut être indiquée sur un seul poste d'unité programme et ne s'applique qu'à un travail de communication cible. Si *REQUESTER est indiqué dans un autre type de travail, un message est émis.

nom-communications
Indiquez le nom d'un lieu éloigné. Il n'est pas nécessaire que ce lieu éloigné existe lors de l'exécution de cette commande, mais il doit être disponible (configuré sur le système comme description d'unité ou dans la fonction APPN) pour ce lieu éloigné lorsque l'unité programme est acquise par le programme. Un même nom de lieu éloigné peut être indiqué pour plusieurs noms d'unités programme différents. Cependant, une seule unité programme associée à un lieu éloigné asynchrone (ASYNC), binaire synchrone (BSCEL) ou de type SNUF peut être ajoutée dans le fichier à un moment donné. Cette valeur ne peut pas être indiquée avec CNVTYPE(*SRCPGM).

Type de communication (CMNTYPE)

Indique les types de communication sur lesquels porte l'invite. Ce paramètre n'est utilisé que pour la fonction d'invite. La valeur indiquée pour ce paramètre détermine le sous-ensemble des autres paramètres affichés (à entrer) pour l'utilisateur.

*ALL
Tous les paramètres apparaissent dans l'invite.
*APPC
Seuls les paramètres APPC apparaissent dans l'invite.
*ASYNC
Seuls les paramètres ASYNC apparaissent dans l'invite.
*BSCEL
Seuls les paramètres BSCEL apparaissent dans l'invite.
*FINANCE
Seuls les paramètres FINANCE apparaissent dans l'invite.
*INTRA
Seuls les paramètres INTRA apparaissent dans l'invite.
*RETAIL
Seuls les paramètres RETAIL apparaissent dans l'invite.
*SNUF
Seuls les paramètres SNUF apparaissent dans l'invite.

Unité (DEV)

Indique l'unité de communication utilisée sur le lieu éloigné. Ce paramètre ne doit être utilisé que pour les types de communication APPC, FINANCE, RETAIL, SNUF et INTRA.

*LOC
L'unité associée au lieu éloigné est utilisée. Si plusieurs unités sont associées au lieu éloigné, c'est le système qui détermine l'unité utilisée.
nom
Précisez le nom d'une unité de communication associée au lieu éloigné. Si ce nom n'est pas valable pour le lieu éloigné, un message d'arrêt programme est envoyé lors de l'acquisition de l'unité programme. Pour plus d'informations sur les noms d'unité, reportez-vous au manuel APPC Programming, SC41-5443.

Lieu local (LCLLOCNAME)

Indique le nom du lieu local.

*LOC
Le nom du lieu local associé au lieu éloigné est utilisé.
*NETATR
La valeur LCLLOCNAME indiquée dans les attributs de réseau du système est utilisée.
nom-communications
Indiquez le nom du lieu local associé à l'unité programme. Ce nom n'est utile que si vous voulez mentionner un nom de lieu local spécifique différent pour le lieu éloigné. Si le nom indiqué n'est pas correct, un message d'arrêt programme est envoyé lors de l'acquisition de l'unité programme.

Mode (MODE)

Indique le nom du mode à utiliser. Ce paramètre ne concerne que les communications APPC.

*NETATR
Le mode défini dans les attributs du réseau est utilisé.
BLANK
Un nom de mode composé de 8 blancs est utilisé.
nom-communications
Indiquez un nom de mode pour l'unité de communication APPC. Si ce mode n'est valable pour aucune combinaison d'unité de lieu éloigné, de lieu local et d'identificateur de réseau éloigné, un message d'arrêt programme est envoyé lors de l'acquisition de l'unité programme.

ID éloigné réseau (RMTNETID)

Indique l'ID éloigné du réseau à utiliser avec le lieu éloigné. Ce paramètre ne concerne que le type de communication APPC.

*LOC
Tout ID éloigné de réseau peut être utilisé pour le lieu éloigné. Si plusieurs ID éloignés de réseau sont associés au lieu éloigné, le système détermine l'ID éloigné de réseau qui est utilisé.
*NETATR
L'ID éloigné du réseau figurant dans les attributs du réseau est utilisé.
*NONE
Aucun ID éloigné de réseau n'est utilisé.
nom-communications
Indiquez un ID éloigné de réseau à associer à l'unité programme.

Sélection de format (FMTSLT)

Indique le type de sélection des formats d'enregistrements utilisé pour les opérations d'entrée.

*PGM
Le programme détermine la sélection des formats d'enregistrement. Si une opération d'entrée (READ) est spécifiée avec un nom de format d'enregistrement, ce dernier sera toujours sélectionné. Si aucun format d'enregistrement n'est indiqué pour l'opération d'entrée, le format par défaut (le premier format d'enregistrement du fichier) est toujours sélectionné.
*RECID
Les mots clés RECID, indiqués pour le fichier dans les DDS, servent à sélectionner les formats d'enregistrement. Si ces mots clés ne figurent pas dans les DDS, un message d'erreur est envoyé et l'unité programme n'est pas acquise.
*RMTFMT
Les noms de formats éloignés provenant du système émetteur servent à sélectionner les formats d'enregistrement. Si l'unité n'est pas une unité APPC et que *RMTFMT est précisé, une erreur d'exécution se produira lors de l'acquisition de l'unité programme.

Identificateur d'application (APPID)

Indique (en caractères alphanumériques) l'identificateur VTAM du sous-système hôte CICS/VS ou IMS/VS, à envoyer avec le message d'ouverture de session. Ce paramètre ne concerne que les communications SNUF.

*DEVD
L'identificateur d'application spécifié dans la description d'unité est utilisé.
*USER
Le programme d'application peut envoyer un message d'ouverture à l'hôte. Cette valeur n'est admise que si l'interface de programme 3270 est utilisée.
nom
Indiquez un identificateur d'application pour VTAM de CICS/VS ou d'IMS/VS.

Activité par lots (BATCH)

Indique, pour CICS/VS et IMS/VS, si cette session est utilisée pour des travaux en traitement par lots. Ce paramètre concerne les communications SNUF, INTRA et RETAIL.

*NO
Pas de travaux en traitement par lots dans cette session.
*YES
Cette session est utilisée pour des travaux en traitement par lots, et SNUF ne doit pas assembler les enregistrements physiques en enregistrements logiques. Si *YES est spécifié, *NO doit être indiqué pour le paramètre Protection des messages (MSGPTC).

Type d'hôte (HOST)

Indique le sous-système hôte ou éloigné avec lequel le système local ou le sous-système communique durant la session. Ce paramètre ne concerne que les communications SNUF.

*DEVD
Le système hôte figurant dans la description d'unité est utilisé.
*CICS
CICS/VS est utilisé durant la session de communication.
*IMS
IMS/VS est utilisé durant la session de communication.
*IMSRTR
IMS/VS utilise l'option "prêt à recevoir" durant la session.

Fin de la session hôte (ENDSSNHOST)

Indique comment SNUF mettra fin à la session avec le système hôte.

*RSHUTD
SNUF envoie une commande de demande de mise hors fonction au système hôte.
*TERMSELF
SNUF envoie une commande de fin de session au système hôte. Cette valeur peut notamment être utilisée lorsque la valeur *RSHUTD ne réussit pas à mettre fin à une session avec un système hôte non IBM.

Application hôte spéciale (SPCHOSTAPP)

Indique si SNUF personnalise le support des applications hôte spéciales en dehors de la couche d'application de CICS ou d'IMS.

*DEVD
L'application hôte spéciale indiquée dans la description d'unité est utilisée.
*NONE
SNUF ne personnalise pas le support des applications hôte spéciales.
*FLASH
SNUF personnalise le support de l'application Federal Reserve Flash.

INIT-SELF formaté (INZSELF)

Indique si un INIT-SELF formaté est créé à la place de l'ouverture de session non formatée normalement envoyée par SNUF à l'hôte.

*NO
L'ouverture de session par défaut non formatée proposée par SNUF est utilisée.
*YES
L'INIT-SELF formaté proposé par SNUF est utilisé.

Traitement d'en-tête (HDRPROC)

Indique, pour CICS/VS et IMS/VS, si les en-têtes de gestion de fonction (FMH) reçus sont transmis au programme d'application. Ce paramètre ne concerne que les communications SNUF.

*SYS
SNUF supprime les en-têtes de gestion de fonction (FMH) avant de transmettre les données au programme.
*USER
SNUF ne supprime pas les en-têtes de gestion de fonction (FMH) avant de transmettre les données au programme.

Protection des messages (MSGPTC)

Indique, pour CICS/VS et IMS/VS, si la protection des messages est utilisée pour cette session. Ce paramètre ne concerne que les communications SNUF.

*YES
Les messages sont protégés. SNUF les sauvegarde jusqu'à ce que vous y répondiez et tente une nouvelle synchronisation si d'autres erreurs se produisent. *YES n'est admis que lorsque *NO est indiqué pour le paramètre Activité par lots (BATCH).
*NO
Les messages ne sont pas protégés.

Unité d'émulation (EMLDEV)

Indique que cette unité programme sert à recevoir et à envoyer des flots de données 3270. Le paramètre d'unité d'émulation inclut le type et le format de données de l'unité d'émulation. Le format des données de l'unité d'émulation est le format du flot de données 3270 à transmettre ou recevoir. Un en-tête commun de 20 ou 32 octets, contenant des informations sur les commandes et les flots de données de type 3270, figure au début de la mémoire tampon d'E-S qui envoie ou reçoit le flot de données de type 3270. Ce paramètre ne concerne que les communications SNUF. Il peut être défini sous la forme d'une liste de deux valeurs (éléments) ou en tant que valeur unique (*NONE).

Le format des données de l'unité d'émulation indique le format du flot de données 3270 à transmettre ou recevoir. Un en-tête commun de 20 ou 23 octets qui comporte des informations de flot de données et de commande de type 3270 figure au début de la mémoire tampon d'entrée-sortie qui envoie ou reçoit le flot de données de type 3270.

Valeurs uniques

*NONE
Cette unité programme n'est pas utilisée pour envoyer et recevoir des flots de données 3270.

Elément 1 : Type d'unité

3278
Le flot de données s'adresse à un écran 3278, 3277 ou 3279.
3284
Le flot de données s'adresse à une imprimante 3284.
3286
Le flot de données s'adresse à une imprimante 3286.
3287
Le flot de données s'adresse à une imprimante 3287.
3288
Le flot de données s'adresse à une imprimante 3288.
3289
Le flot de données s'adresse à une imprimante 3289.

Elément 2 : Format des données

*UNFORMAT
Indique qu'un flot de données 3270 non formaté est envoyé ou reçu. Le programme d'application de l'utilisateur doit convertir le flot de données en image d'impression ou d'écran.
*FIELD
Un flot de données 3270 formaté est envoyé ou reçu. Ce flot de données comporte une image d'écran ou d'impression contenant des définitions de zones. Ces définitions de zones indiquent l'emplacement et les caractéristiques des zones. *FIELD n'est correct que si *NO est indiqué pour le paramètre Activité par lots (BATCH).
*NOFIELD
Un flot de données 3270 formaté est envoyé ou reçu. Ce flot de données comprend une image d'écran ou d'impression, sans définitions de zones. *NOFIELD n'est admis que si *NO est indiqué pour le paramètre BATCH.
*EXTFIELD
Un flot de données 3270 formaté est envoyé ou reçu. Ce flot de données comprend une image d'écran ou d'impression suivie par des définitions de zone. Ces définitions indiquent l'emplacement et les caractéristiques des zones. *EXTFIELD n'est admis que si *NO est indiqué pour le paramètre BATCH et que 3278 est mentionné comme type d'unité d'émulation.

Type de conversation (CNVTYPE)

Indique le type de conversation pour lequel le programme d'application est conçu. Ce paramètre ne concerne que les communications APPC. Pour plus de détails sur le type de communication APPC, reportez-vous au manuel APPC Programming, SC41-5443.

*SYS
Le système fournit la longueur et l'identificateur du flot général de données qui précèdent chaque section de données utilisateur dans le protocole d'unité APPC. L'application fournit la partie données de ce flot pour les opérations de sortie et ne reçoit que cette partie également pour les opérations d'entrée. Il s'agit du support de conversation mappée pour l'architecture LU 6.2.
*USER
Le programme d'application fournit la longueur et l'identificateur du flot général de données qui précède chaque section de données utilisateur dans le protocole d'unité APPC. Il s'agit du support de conversation privilégiée pour l'architecture LU 6.2.
*SRCPGM
Le programme cible accepte le type de conversation indiqué par le programme source. Si cette valeur est indiquée, RMTLOCNAME(*REQUESTER) doit également être indiqué.

Type de groupage (BLOCK)

Indique si le système ou l'utilisateur gère le groupage des enregistrements lors de leur émission. Ce paramètre ne concerne que le type de communication BSCEL. Avec ce paramètre, vous pouvez indiquer une des conditions de formatage d'enregistrement suivantes :

  • Pas de groupage/dégroupage : le format d'enregistrement défini dans les DDS est utilisé pour l'enregistrement et le bloc.
  • Groupage ou dégroupage utilisateur : Indique les contrôles BSC nécessaires à la description du format d'enregistrement du système.
  • Groupage système avec caractères de séparation des enregistrements : Indiquez le caractère de séparation d'enregistrement utilisé par le système pour déterminer des limites d'enregistrement dans le bloc.
  • Groupage système des enregistrements de longueur fixe : Le système utilise, selon le cas, des enregistrements, de longueur fixe, des groupages ou des dégroupages.

Si vous indiquez une valeur autre que *NONE ou *USER, les enregistrements seront groupés en sortie, selon les exigences du système, et dégroupés en entrée.

Elément 1 : Type de groupage

*DEVD
L'option de groupage figurant dans la description d'unité est utilisée.
*NONE
Aucun groupage ou dégroupage n'est effectué par le système.
*ITB
Les enregistrements sont groupés et dégroupés en fonction de la position d'un caractère de contrôle de bloc de texte intermédiaire (ITB). Pour les fichiers en entrée, un enregistrement est délimité par la position du caractère de bloc de texte intermédiaire suivant. Un caractère de bloc de fin de texte ou de fin de transmission sert de caractère de bloc de texte intermédiaire pour délimiter un bloc. Pour les fichiers en sortie, un caractère ITB est ajouté après l'enregistrement. S'il s'agit du dernier caractère du bloc, l'ITB est remplacé par un caractère de bloc de fin de texte ou de fin de transmission.
*IRS
Les enregistrements sont groupés et dégroupés en fonction de la position d'un caractère de séparation inter-enregistrements (IRS). Pour les fichiers en entrée, un enregistrement est délimité par le caractère IRS suivant. Pour les fichiers en sortie, un caractère IRS est ajouté après chaque enregistrement.
*NOSEP
Aucun caractère de séparation des enregistrements n'est contenu dans le bloc émis ou reçu. Le système groupe et dégroupe les enregistrements en fonction d'une longueur fixe, précisée dans les spécifications de format des DDS (Spécifications de description de données).
*USER
Le programme fournit tous les caractères de contrôle nécessaires à la transmission des enregistrements, y compris les caractères de séparation des enregistrements, de tramage BSCEL, de transparence, etc. Pour plus de détails sur les caractéristiques d'unité et de support BSCEL, reportez-vous au manuel BSC Equivalence Link Programming, SC41-5445.
*SEP
Les enregistrements sont groupés ou dégroupés en fonction de la position d'un caractère de séparation des enregistrements spécifié par l'utilisateur. Pour les fichiers en entrée, un enregistrement est délimité par le caractère séparateur suivant. Pour les enregistrements en sortie, un caractère séparateur est ajouté après chaque enregistrement.

Elément 2 : Séparateur d'enreg, si *SEP

X'1E'
Le caractère de séparation d'enregistrements, X'1E', est utilisé.
valeur-hexadécimale
Indiquez un séparateur d'enregistrements unique, de 1 octet. Ce caractère peut être indiqué sous la forme de 2 caractères hexadécimaux, comme par exemple BLOCK(*SEP FD) où X'FD' représente le caractère de séparation.

Les caractères suivants ne sont pas admis comme caractères de séparation car ils sont utilisés pour le contrôle BSC :

Figure : Caractères non disponibles pour les séparateurs d'enregistrements

EBCDIC   ASCII    Contrôle BSC
------   -----    -----------------------------------
X'01'    X'01'    SOH (début d'en-tête)
X'02'    X'02'    STX (début de texte)
X'03'    X'03'    ETX (fin de texte)
X'10'    X'10'    DLE (échappement en transmission de données)
X'1D'    X'1D'    IGS (séparateur de groupe d'échange)
X'1F'    X'1F'    ITB (bloc de texte intermédiaire)
X'26'    X'17'    ETB (bloc de fin de transmission)
X'2D'    X'05'    ENQ (interrogation)
X'32'    X'16'    SYN (synchronisation)
X'37'    X'04'    EOT (fin de transmission)
X'3D'    X'15'    NAK (accusé de réception négatif)

Longueur d'enregistrement (RCDLEN)

Indique, en octets, la longueur maximale des enregistrements à l'émission ou à la réception des données. Ce paramètre ne concerne que les communications SNUF et BSCEL.

*DEVD
La longueur d'enregistrement figurant dans la description d'unité est utilisée. Si la taille d'un enregistrement dépasse la longueur indiquée, une erreur d'exécution se produit à l'émission ou à la réception de l'enregistrement.
1 à 32767
Indiquez la longueur maximale d'enregistrement pour ce fichier unité. Si la taille d'un enregistrement dépasse la longueur indiquée, une erreur d'exécution se produit à l'émission ou à la réception de l'enregistrement. Pour les communications SNUF, les valeurs admises sont comprises entre 1 et 32 767 octets. Pour les communications BSCEL, la longueur maximale est de 8 192 octets.

Longueur de bloc (BLKLEN)

Indique, en octets, la longueur maximale des blocs à l'émission. Ce paramètre ne concerne que les communications BSCEL et SNUF.

*DEVD
La longueur de bloc spécifiée dans la description d'unité est utilisée.
1 à 32767
C'est la longueur maximale (en octets) des blocs d'enregistrements envoyés par l'intermédiaire de ce fichier unité. Cette longueur doit être au moins égale à la taille du plus grand enregistrement envoyé. Les valeurs permises sont comprises entre 1 et 32767 pour le type de communication SNUF. Pour les communications BSCEL, la longueur maximale est de 8 192 octets.

Transmission mode transparent (TRNSPY)

Indique si les données sont envoyées en mode texte fantôme. Ce mode de transmission accepte les 256 caractères du code EBCDIC. Utilisez-le pour émettre des zones de données binaires ou condensées. Ce paramètre ne concerne que les communications BSCEL.

*DEVD
L'option de transparence de texte figurant dans la description d'unité est utilisée.
*NO
Le mode transparent n'est pas utilisé.
*YES
Le mode transparent est utilisé, permettant ainsi la transmission des 256 codes de caractères EBCDIC. *YES n'est possible que lorsque *NONE, *NOSEP, ou *USER est spécifié pour le paramètre Type de groupage (BLOCK).

Remarque :La transparence des données reçues est déterminée par le flot de données ; par conséquent, ce paramètre ne s'applique pas aux données reçues. Si TRNSPY(*YES) est indiqué avec BLOCK(*USER), BSCEL ignore l'indicateur de transparence lors des opérations d'écriture. Des contrôles corrects doivent être fournis avec les données pour obtenir une transmission transparente des données. Par exemple, les caractères de contrôle DLE (échappement en transmission de données) et STX (début de texte) doivent être indiqués en premier lieu ; le système fournit ensuite les autres caractères de contrôle requis pour la transmission transparente des données.

Compression et décompression (DTACPR)

Indique si les blancs inclus dans les données BSCEL sont comprimés en sortie et décomprimés en entrée. Ce paramètre ne concerne que les communications BSCEL.

*DEVD
L'option de compression des données figurant dans la description d'unité est utilisée.
*NO
Pas de compression ni de décompression des données.
*YES
Les données sont comprimées en sortie et décomprimées en entrée. La valeur *YES ne peut être utilisée ici si *YES est également spécifié pour le paramètre Transmission mode transparent (TRNSPY).

Suppression blancs de fin (TRUNC)

Indique si les blancs de fin sont supprimés des enregistrements de sortie. Ce paramètre ne concerne que les communications BSCEL.

*DEVD
L'option de blancs de fin de zone figurant dans la description d'unité est utilisée.
*NO
Les blancs de fin ne sont pas supprimés des enregistrements en sortie.
*YES
Les blancs de fin sont supprimés des enregistrements en sortie. La valeur *YES ne peut pas être indiquée si *NOSEP est spécifié pour le paramètre Type de groupage (BLOCK). Si *YES est indiqué ici, ainsi qu'au paramètre Compression et décompression (DTACPR), les blancs de fin ne sont pas supprimés.

Données excédentaires (OVRFLWDTA)

Indique si les données excédentaires sont supprimées ou conservées.

*DISCARD
Les données excédentaires ne sont pas conservées.
*RETAIN
Les données excédentaires sont conservées.

Type séparateur de groupe (GRPSEP)

Indique un séparateur pour les groupes de données (par exemple : fichiers et documents). Ce paramètre ne concerne que les communications BSCEL.

*DEVD
Le séparateur spécifié dans la description d'unité est utilisé comme séparateur de groupe de données.
*DEV3740
Les caractères STXETX (enregistrement nul) sont utilisés comme séparateur de groupe de données.
*EOT
Le caractère de contrôle EOT (fin de transmission) de BSCEL est utilisé comme séparateur de groupe de données.
*OFCSYS
Le caractère de contrôle ETX (fin de texte) de BSCEL est utilisé comme séparateur de groupe de données.

BSCEL à distance (RMTBSCEL)

Indique le type de session BSCEL établi avec le système éloigné. Ce paramètre ne concerne que les communications BSCEL.

*DEVD
L'option RMTBSCEL figurant dans la description d'unité est utilisée.
*NO
Le système éloigné ne reconnaît pas les commandes ou les messages BSCEL. Dans la plupart des cas, *NO est utilisé pour les communications avec des systèmes éloignés tels qu'un terminal de saisie 3741, un système 6 bureautique, un système de collecte de données 5230 ou un IBM 38.
*YES
Le système éloigné reconnaît les commandes BSCEL de début et de fin de transaction, ainsi que les messages en ligne. Dans la plupart des cas, *YES indique que le système éloigné est un autre IBM i, ou un système IBM 38, IBM 36 ou IBM 34 prenant en charge les communications BSCEL.

Connexion initiale (INLCNN)

Indique la méthode de connexion à la ligne pour la session en cours d'accès. Ce paramètre ne s'applique qu'aux communications BSCEL.

*CTLD
L'option de connexion initiale figurant dans la description de contrôleur est utilisée.
*ANS
Le système éloigné émet l'appel et le système local répond.
*DIAL
C'est le système local qui appelle et le système éloigné qui répond.

Exemples

Exemple 1 : Utilisation des mots clés RECID pour la sélection des enregistrements

ADDICFDEVE   FILE(ICFFILE1)  PGMDEV(BSCEL2)
             RMTLOCNAME(BSCNYC)  FMTSLT(*RECID)

Cette commande permet d'ajouter l'unité programme BSCEL2 dont le lieu éloigné correspondant est BSCNYC pour le fichier ICF ICFFILE1. L'unité programme est ajoutée avec les attributs de FMTSLT(*RECID).

Exemple 2 : Utilisation des noms de formats éloignés pour la sélection des enregistrements

ADDICFDEVE   FILE(QGPL/ICFTEST)  PGMDEV(APPC1)
             RMTLOCNAME(*REQUESTER)
             FMTSLT(*RMTFMT)  CNVTYPE(*SYS)

Cette commande permet d'ajouter l'unité programme APPC1 dont le lieu éloigné est *REQUESTER pour le fichier ICF ICFTEST dans la bibliothèque QGPL. Cette unité programme comporte les attributs FMTSLT(*RMTFMT) et CNVTYPE(*SYS).

Exemple 3 : Ajout d'une unité programme

ADDICFDEVE   FILE(ICFLIB/TESTFILE)  PGMDEV(JOE)
             RMTLOCNAME(LU0MPLS)

Cette commande permet d'ajouter l'unité programme JOE dont le lieu éloigné est LU0MPLS pour le fichier ICF TESTFILE dans la bibliothèque ICFLIB.

Exemple 4 : Ajout d'une unité programme

ADDICFDEVE   FILE(TESTFILE)  PGMDEV(APPC)
             RMTLOCNAME(APPCMPLS)  DEV(MPLSLINE2)

Cette commande permet d'ajouter au fichier ICF TESTFILE l'unité programme APPC dont le nom de lieu éloigné est APPCMPLS, en utilisant l'unité MPLSLINE2.

Messages d'erreur

*ESCAPE Messages

CPF7365
Unité non ajoutée au fichier &1 de &2.

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