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
-
FILEFichier obligatoire -
PGMDEVUnité-programme obligatoire -
RMTLOCNAMELieu éloigné obligatoire -
CMNTYPEType de communication -
DEVUnité -
LCLLOCNAMELieu local -
MODEMode -
RMTNETIDID éloigné réseau -
FMTSLTSélection de format -
APPIDIdentificateur d'application -
BATCHActivité par lots -
HOSTType d'hôte -
ENDSSNHOSTFin de la session hôte -
SPCHOSTAPPApplication hôte spéciale -
INZSELFINIT-SELF formaté -
HDRPROCTraitement d'en-tête -
MSGPTCProtection des messages -
EMLDEVUnité d'émulation -
CNVTYPEType de conversation -
BLOCKType de groupage -
RCDLENLongueur d'enregistrement -
BLKLENLongueur de bloc -
TRNSPYTransmission mode transparent -
DTACPRCompression et décompression -
TRUNCSuppression blancs de fin -
OVRFLWDTADonnées excédentaires -
GRPSEPType séparateur de groupe -
RMTBSCELBSCEL à distance -
INLCNNConnexion initiale
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.
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.