Aller au contenu

OVRICFDEVE

Substituer unité fichier ICF

En bref

La commande OVRICFDEVE (Substituer un poste unité de fichier ICF) permet d'ajouter temporairement le nom de l'unité programme et du lieu éloigné au fichier ICF ou de remplacer le nom d'une unité programme par le nom du lieu éloigné et ses attributs.

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

Syntaxe minimale

OVRICFDEVE PGMDEV(…)

Paramètres

Astuce : dans une session 5250, tapez OVRICFDEVE 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 OVRICFDEVE (Substituer un poste unité de fichier ICF) permet d'ajouter temporairement le nom de l'unité programme et du lieu éloigné au fichier ICF ou de remplacer le nom d'une unité programme par le nom du lieu éloigné et ses attributs.

Remarque :L'utilisation de cette commande ne provoque pas la substitution immédiate d'un fichier. Les informations contenues dans la commande sont stockées jusqu'à l'utilisation du fichier, qui est alors remplacé.

Pour plus d'informations sur le traitement des substitutions, reportez-vous aux manuels Catégorie des fichiers et systèmes de fichiers de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/, Application Display Programming book, SC41-5715 et Catégorie Impression de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Paramètres

Mot-clé Description Valeurs possibles Remarques
PGMDEV Unité-programme Valeur caractère Obligatoire, positionnel 1
RMTLOCNAME Lieu éloigné Nom de communication, *REQUESTER Facultatif, positionnel 2
CMNTYPE Type de communication *ALL, *APPC, *ASYNC, *BSCEL, *FINANCE, *INTRA, *RETAIL, *SNUF Facultatif, positionnel 3
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 *NO, *YES 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, *NOFIELD, *EXTFIELD
CNVTYPE Type de conversation *SYS, *USER, *SRCPGM Facultatif
BLOCK Type de groupage Valeurs uniques: *DEVD, *NONE, *ITB, *IRS, *NOSEP, *USER
Autres valeurs: Liste d'éléments
Facultatif
Élément 1: Type de groupage *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 des données *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
SECURE Protection autre substitution *NO, *YES Facultatif
OVRSCOPE Portée de substitution *ACTGRPDFN, *CALLLVL, *JOB Facultatif

Unité-programme (PGMDEV)

Indique le nom de l'unité-programme utilisée pour un fichier ICF dont les attributs sont substitués. Le nombre total d'unités pouvant être ajoutées à un fichier ICF est défini par le paramètre MAXPGMDEV de la commande CRTICFF (Créer un fichier ICF) ou CHGICFF (Modifier un fichier ICF).

Ce paramètre est obligatoire.

valeur-alphanumérique
Indiquez le nom du poste de l'unité-programme ICF avec lequel le programme communique. Ce nom est utilisé pour des opérations d'entrée-sortie spécifiques à l'unité pour identifier l'unité-programme et les attributs de session. Le nom de l'unité-programme doit être unique, bien que le nom du lieu éloigné puisse être indiqué plusieurs fois. Cela permet d'avoir plusieurs sessions sur le même lieu éloigné ou des valeurs d'attributs différentes pour chaque session sur le même lieu éloigné. Ce nom d'unité-programme doit être unique parmi les postes du fichier ICF. Si une commande de substitution est entrée une seconde fois pour la même unité-programme, les deux commandes définissent la même unité-programme (selon les règles de traitement des substitutions).

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.

Lieu éloigné (RMTLOCNAME)

Indique le nom du lieu éloigné avec lequel communique votre programme. Ce nom doit être spécifié à l'aide de la commande ADDICFDEVE (Ajouter un poste unité à un fichier ICF) ou d'une commande de substitution d'unité programme. Si aucun lieu éloigné n'est indiqué, un message d'arrêt programme est envoyé lors de l'acquisition de l'unité programme.

nom-communications
Indiquez le nom du lieu éloigné avec lequel communique votre programme. Ce lieu doit être défini sur le système ou sur le réseau APPN, au moment où le programme acquiert l'unité programme. Un lieu éloigné peut être ajouté aussi souvent que nécessaire avec des noms d'unité programme différents. Cependant, une seule unité programme associée à chaque lieu éloigné asynchrone, BSCEL ou SNUF peut être acquise à la fois par le fichier. Pour chaque lieu éloigné APPC, plusieurs unités programme peuvent être acquises simultanément par le fichier. Pour chaque lieu éloigné SNUF, plusieurs unités peuvent être spécifiées. Le système détermine l'unité à utiliser si aucune n'est indiquée au paramètre DEV (Unité).
*REQUESTER
Le nom désignant l'unité de communication servant à démarrer le programme est utilisé. La session allouée lors de l'acquisition de l'unité programme est celle qui a reçu la demande de démarrage du programme. Si le programme ne démarre pas à la suite de cette demande, l'unité programme ne peut être acquise. Le programme cible utilise toujours *REQUESTER, comme nom de lieu éloigné du fichier ICF, afin de se connecter à la session que le programme source utilise pour émettre la demande de démarrage de programme.

*REQUESTER n'est correct que pour un travail de communication cible. Si cette valeur est indiquée pour tout autre type de travail, un message d'arrêt programme est envoyé lors de l'acquisition de l'unité programme. Si *REQUESTER est utilisé dans une opération d'acquisition, les paramètres suivants ne sont pas pris en compte :

  • DEV
  • LCLLOCNAME
  • MODE
  • RMTNETID

Type de communication (CMNTYPE)

Indique le type de communication de l'unité ICF. Ce paramètre n'est utilisé que pour les invites ; il est ignoré lorsque la commande est exécutée. La valeur spécifiée pour ce paramètre détermine le sous-ensemble des autres paramètres affichés (dans une invite) pour l'utilisateur.

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

Unité (DEV)

Indique l'unité de communication utilisée dans le lieu éloigné. Bien que ce paramètre s'applique à tous les types de communication, il n'est obligatoire que pour APPC, INTRA et SNUF. Si cette unité n'est pas admise pour le lieu éloigné, un message d'arrêt programme est envoyé lors de l'acquisition de l'unité programme. Si la commande ADDICFDEVE (Ajouter un poste unité à un fichier ICF) n'est pas exécutée pour l'unité programme spécifiée, ce paramètre prend la valeur *LOC si aucune autre valeur n'est indiquée.

*LOC
L'unité associée au lieu éloigné est utilisée. Si plusieurs unités peuvent être associées au lieu éloigné, c'est le système qui détermine l'unité utilisée.
nom
Indiquez le nom de l'unité avec lequel communique votre programme. Bien que ce nom s'applique à tous les types de transmission, il n'est obligatoire que pour APPC et SNUF. Si ce nom n'est pas admis pour le lieu éloigné, un message d'arrêt programme est envoyé lors de l'acquisition de l'unité programme.

Lieu local (LCLLOCNAME)

Indique le nom de votre lieu. Ce paramètre ne concerne que le type de communication APPC. Si la commande ADDICFDEVE (Ajouter un poste unité à un fichier ICF) n'est pas exécutée pour l'unité programme spécifiée, ce paramètre prend la valeur *LOC s'il n'est pas substitué.

*LOC
Le nom de lieu local associé au nom de lieu éloigné est utilisé.
*NETATR
La valeur LCLLOCNAME indiquée dans les attributs de réseau du système est utilisée.
nom-communications
Entrez le nom de votre lieu. Le nom du lieu local ne doit être spécifié que pour APPC. Si ce nom n'est pas correct, un message d'arrêt de programme est envoyé lors de l'acquisition de l'unité programme.

Mode (MODE)

Indique le nom de mode utilisé. Ce paramètre ne concerne que le type de communication APPC. Si la commande ADDICFDEVE (Ajouter un poste unité à un fichier ICF) n'est pas exécutée pour l'unité programme spécifiée, ce paramètre prend la valeur *NETATR s'il n'est pas substitué.

*NETATR
Le mode défini dans les attributs du réseau est utilisé.
*BLANK.
Nom de mode constitué de 8 blancs.
nom-communications
Entrez le nom du mode pour l'unité de communication APPC. Si le mode n'est pas admis pour une combinaison de lieu éloigné, de lieu local et d'ID éloigné du réseau, 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é de réseau utilisé avec le lieu éloigné. Ce paramètre ne concerne que le type de communication APPC. Si la commande ADDICFDEVE (Ajouter un poste unité à un fichier ICF) n'est pas exécutée pour l'unité programme spécifiée, ce paramètre prend la valeur *LOC s'il n'est pas substitué.

*LOC
N'importe quel ID éloigné de réseau peut être utilisé. Si plusieurs ID éloignés de réseau sont associés au lieu éloigné, c'est le système qui détermine l'ID éloigné de réseau.
*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 pour l'unité de communication APPC.

Sélection de format (FMTSLT)

Indique le format d'enregistrement utilisé pour les opérations d'entrée. Si la commande ADDICFDEVE (Ajouter un poste unité à un fichier ICF) n'est pas exécutée pour l'unité programme spécifiée, ce paramètre prend la valeur *PGM s'il n'est pas substitué.

*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é.
Cela signifie également que si des mots clés d'identification d'enregistrement spécifiés dans les DDS, ou des formats éloignés sont reçus, ils ne seront pas pris en considération lors de la sélection du format de l'enregistrement.
*RECID
Les mots clés d'identification d'enregistrement spécifiés dans les DDS sont utilisés pour la sélection des enregistrements. A défaut de mot clé dans le fichier, un message d'erreur est envoyé, l'opération en cours est annulée, et l'unité n'est pas acquise.
*RMTFMT
Les noms de formats éloignés reçus du système émetteur servent à la sélection des enregistrements. Si l'unité n'est pas une unité APPC et que *RMTFMT est spécifié, une erreur d'exécution se produit lors de l'acquisition de l'unité programme.

Identificateur d'application (APPID)

Indique (en caractères alphanumériques) l'ID VTAM des sous-systèmes hôte CICS/VS ou IMS/VS envoyée avec le message d'ouverture. Ce paramètre ne concerne que les unités SNUF. Si la commande ADDICFDEVE n'est pas exécutée pour l'unité programme spécifiée, ce paramètre prend la valeur *DEVD s'il n'est pas substitué.

*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 l'identificateur d'application envoyé avec le message d'ouverture.

Activité par lots (BATCH)

Indique, pour CICS/VS et IMS/VS, si cette session est utilisée pour des travaux par lots. Ce paramètre ne concerne que les unités SNUF, point de vente et INTRA. Si la commande ADDICFDEVE n'est pas exécutée pour l'unité programme indiquée, ce paramètre prend la valeur *NO si aucune autre valeur n'est indiquée.

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

Type d'hôte (HOST)

Indique le sous-système hôte ou éloigné avec lequel la session communique. Ce paramètre ne concerne que les unités SNUF. Si la commande ADDICFDEVE n'est pas exécutée pour l'unité programme indiquée, ce paramètre prend la valeur *DEVD s'il n'est pas substitué.

*DEVD
Le système hôte spécifié dans la description d'unité est utilisé.
*CICS
La session communique avec CICS/VS.
*IMS
La session communique avec IMS/VS.
*IMSRTR
La session communique avec IMS/VS au moyen de l'option "prêt à recevoir".

Fin de la session hôte (ENDSSNHOST)

Indique comment la fonction SNUF (SNA upline facility) mettra fin à la session avec le système hôte.

*RSHUTD
SNUF envoie une demande d'arrêt 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 pour 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 de type SNUF. Si la commande ADDICFDEVE n'est pas exécutée pour l'unité programme indiquée, ce paramètre prend la valeur *SYS s'il n'est pas substitué.

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

Protection des messages (MSGPTC)

Indique, pour CICS/VS et IMS/VS, si la protection des messages est utilisée dans cette session. Ce paramètre ne concerne que le type de communication SNUF. Si la commande ADDICFDEVE n'est pas exécutée pour l'unité programme indiquée, ce paramètre prend la valeur *YES.

*YES
Les messages sont protégés. SNUF les sauvegarde tant qu'une réponse n'est pas envoyée et essaye de resynchroniser si des erreurs se produisent. La valeur *YES n'est admise que lorsque la valeur *NO est également spécifiée au paramètre BATCH (Activité par lots).
*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).

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 est destiné à un écran 3278, 3277 ou 3279.
3284
Le flot de données est destiné à une imprimante 3284.
3286
Le flot de données est destiné à une imprimante 3286.
3287
Le flot de données est destiné à une imprimante 3287.
3288
Le flot de données est destiné à une imprimante 3288.
3289
Le flot de données est destiné à 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
Indique qu'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, 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 BATCH(*NO) est indiqué.
*NOFIELD
Indique qu'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 figure au paramètre BATCH.
*EXTFIELD
Indique qu'un flot de données 3270 formaté est envoyé ou reçu. Ce flot de données comprend une image d'écran suivie de définitions de zones. Ces définitions de zones indiquent l'emplacement et les caractéristiques de ces dernières. *EXTFIELD n'est admis que si BATCH(*NO) est indiqué et si 3278 est précisé comme type d'unité émulée.

Type de conversation (CNVTYPE)

Indique le type de conversation pour lequel est conçu le programme d'application. Ce paramètre ne concerne que le type de communications APPC (Communications évoluées de programme à programme). Si la commande ADDICFDEVE n'est pas exécutée pour l'unité-programme indiquée et que ce paramètre n'est pas remplacé, la valeur *SYS est utilisée pour le type de conversation (CNVTYPE). Pour plus d'informations sur le type de communications APPC, consultez le manuel APPC Programming, SC41-5443.

*SYS
Le support de conversation mappée APPC de l'architecture LU 6.2 est utilisé.
*USER
Le support de conversation privilégié APPC de l'architecture LU 6.2 est utilisé.
*SRCPGM
Le programme cible accepte le type de conversation indiqué par le programme source.

Type de groupage (BLOCK)

Indique si le système ou l'utilisateur vérifie que les enregistrements sont groupés lors de leur émission. Ce paramètre ne concerne que le type de transmission BSCEL. Si la commande ADDICFDEVE n'est pas exécutée pour l'unité programme indiquée, ce paramètre prend la valeur *DEVD s'il n'est pas substitué.

A l'aide de ce paramètre, vous pouvez spécifier l'une des conditions de formatage suivantes :

  • Pas de groupage/dégroupage : le format d'enregistrement défini dans les DDS est utilisé pour l'enregistrement et le bloc.
  • Groupage/dégroupage utilisateur : indiquez les contrôles BSCEL servant à décrire le format d'enregistrement du système.
  • Groupage système avec des caractères de séparation d'enregistrements : Indiquez le caractère de séparation d'enregistrements utilisé par le système pour définir les limites d'un bloc.
  • Groupage système des enregistrements à longueur fixe : le système utilise des enregistrements à longueur fixe, et les groupe ou les dégroupe.

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

Valeurs uniques

*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 ou dégroupés en fonction de la position du caractère de contrôle ITB (bloc de texte intermédiaire). Pour les fichiers d'entrée, les enregistrements sont délimités par le caractère ITB suivant. Un caractère de fin de texte ou de fin de transmission peut être utilisé comme caractère ITB pour délimiter un bloc. Pour les fichiers de sortie, le caractère ITB est ajouté après l'enregistrement. Si c'est le dernier caractère du bloc, il est remplacé par un caractère 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 d'entrée, un enregistrement est délimité par le caractère IRS suivant. Pour les fichiers de sortie, un caractère IRS est ajouté après chaque enregistrement.
*NOSEP
Aucun caractère de séparation des enregistrements n'est indiqué 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.
*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.

Elément 1 : Type de groupage

*SEP
Les enregistrements sont groupés ou dégroupés en fonction de la position du caractère de séparation défini par l'utilisateur. Pour les fichiers d'entrée, les enregistrements sont délimités par le caractère de séparation suivant. Pour les fichiers de sortie, un caractère de séparation est ajouté après chaque enregistrement.

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

X'1E'
Le caractère de séparation X'1E' est utilisé.
valeur-hexadécimale
Indiquez un caractère de séparation unique, d'une longueur de 1 octet. Il peut être désigné sous la forme de 2 caractères hexadécimaux, tel que BLOCK(*SEP X'FD'), ou d'un seul caractère, BLOCK(*SEP à).

Longueur d'enregistrement (RCDLEN)

Indique, en octets, la longueur maximale des enregistrement à l'émission ou à la réception des données. Ce paramètre ne concerne que les types de communication SNUF et BSCEL. Si la commande ADDICFDEVE n'est pas exécutée pour l'unité programme indiquée, ce paramètre prend la valeur *DEVD s'il n'est pas substitué.

*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 des enregistrements pour ce fichier unité. Cette valeur doit correspondre au moins à la taille du plus grand enregistrement envoyé. Si un enregistrement est plus long que la valeur indiquée, une erreur d'exécution se produit à l'émission ou à la réception de l'enregistrement. Pour le type de communication SNUF, les valeurs doivent êtres comprises entre 1 et 32767. Pour les communications BSCEL, la longueur maximale des enregistrements est de 8192 octets.

Longueur de bloc (BLKLEN)

Indique, en octets, la longueur maximale des blocs à l'émission. Ce paramètre ne concerne que les types de communication BSCEL et SNUF. Si la commande ADDICFDEVE (Ajouter un poste unité à un fichier ICF) n'est pas exécutée pour l'unité programme indiquée, ou si ce paramètre n'est pas remplacé, il prend la valeur par défaut *DEVD.

*DEVD
La longueur de bloc figurant dans la description d'unité est utilisée.
1 à 32767
Entrez la longueur de bloc maximale utilisée pour ce fichier unité. Cette valeur doit correspondre au moins à la taille du plus grand enregistrement envoyé. Pour le type de communication SNUF, les valeurs doivent être comprises entre 1 et 32767. Pour les communications BSCEL, la longueur maximale des blocs est de 8192 octets.

Transmission mode transparent (TRNSPY)

Indique si le texte est envoyé en mode transparent. Ce mode permet d'envoyer les 256 caractères du code EBCDIC. Utilisez ce mode pour envoyer des zones de données condensées ou binaires. Ce paramètre ne concerne que le type de communication BSCEL. Si la commande ADDICFDEVE n'est pas exécutée pour l'unité programme spécifiée, ce paramètre prend la valeur *DEVD s'il n'est pas substitué.

*DEVD
L'option de transparence de texte figurant dans la description d'unité est utilisée.
*NO
La transparence n'est pas utilisée.
*YES
La transparence permet d'envoyer les 256 caractères du code EBCDIC. La valeur *YES n'est admise que lorsque les valeurs *NONE, *NOSEP ou *USER sont spécifiées au paramètre BLOCK (Type de groupage).

Compression des données (DTACPR)

Indique si les blancs dans les données BSCEL sont comprimés en sortie et décomprimés en entrée. La valeur *YES ne peut pas être utilisée ici si elle est également indiquée au paramètre TRNSPY (Transmission mode transparent). Ce paramètre ne concerne que le type de communication BSCEL. Si la commande ADDICFDEVE n'est pas exécutée pour l'unité programme indiquée, ce paramètre prend la valeur *DEVD s'il n'est pas substitué.

*DEVD
L'option de compression des données spécifiée dans la description d'unité est utilisée.
*NO
Pas de compression ou de décompression des données.
*YES
Les données sont comprimées en sortie et décomprimées en entrée.

Suppression blancs de fin (TRUNC)

Indique si les blancs de fin sont supprimés des enregistrements en sortie. La valeur *YES ne peut pas être spécifiée si la valeur *NOSEP est indiquée au paramètre BLOCK (Type de groupage). Si la valeur *YES est indiquée ici ainsi qu'au paramètre DTACPR (Compression des données), la troncature n'est pas prise en compte. Ce paramètre ne concerne que le type de communication BSCEL. Si la commande ADDICFDEVE n'est pas exécutée pour l'unité programme indiquée, ce paramètre prend la valeur *DEVD s'il n'est pas substitué.

*DEVD
Les blancs de fin de zone spécifiés dans la description d'unité sont utilisés.
*NO
Les blancs de fin de zone ne sont pas supprimés des enregistrements en sortie.
*YES
Les blancs de fin de zone sont supprimés des enregistrements en sortie.

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 de groupes de données (fichiers ou documents). Ce paramètre ne concerne que le type de communication BSCEL. Si la commande ADDICFDEVE n'est pas exécutée pour l'unité programme indiquée, ce paramètre prend la valeur *DEVD s'il n'est pas substitué.

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

BSCEL à distance (RMTBSCEL)

Indique si la session BSCEL s'effectue avec un système BSCEL. Ce paramètre ne concerne que le type de communication BSCEL. Si la commande ADDICFDEVE n'est pas exécutée pour l'unité programme indiquée, ce paramètre prend la valeur *DEVD s'il n'est pas substitué.

*DEVD
L'option spécifiée dans la description d'unité est utilisée.
*NO
L'attribut *NO indique que le système éloigné ne peut pas reconnaître les commandes ou messages BSCEL. Dans la plupart des cas, *NO est utilisé lors de communications avec des systèmes éloignés tels qu'un terminal d'entrée de données 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 de début de transaction BSCEL, les commandes de fin de transaction et les messages en ligne. Dans la plupart des cas, *YES indique que le système éloigné est un autre ordinateur iSeries ou un système IBM 38, IBM 36 ou IBM 34 utilisant le support BSCEL.

Connexion initiale (INLCNN)

Indique, pour la session en cours d'acquisition, la manière dont s'effectue la connexion. Ce paramètre ne concerne que le type de communication BSCEL. Si la commande ADDICFDEVE (Ajouter un poste unité à un fichier ICF) n'est pas exécutée pour l'unité programme indiquée, ou si ce paramètre n'est pas remplacé, il prend la valeur par défaut *CTLD.

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

Protection autre substitution (SECURE)

Indique si cette unité programme est protégée contre les effets des commandes de substitution utilisées dans des programmes précédents.

*NO
Cette unité programme n'est pas protégée. Ses valeurs peuvent être remplacées.
*YES
Cette unité programme est protégée des substitutions précédentes.

Portée de substitution (OVRSCOPE)

Indique le champ d'application (la portée) de la substitution.

*ACTGRPDFN
Le champ d'application de la substitution est déterminé par le groupe d'activation du programme qui appelle cette commande. Lorsqu'il s'agit du groupe d'activation par défaut, le champ d'application est égal au niveau d'appel du programme appelant. Dans le cas contraire, le champ d'application correspond au groupe d'activation du programme appelant.
*CALLLVL
Le champ d'application de la substitution est déterminé par le niveau d'appel en cours. Toutes les opérations d'ouverture effectuées à un niveau d'appel identique ou supérieur au niveau en cours sont concernées par cette substitution.
*JOB
Le champ d'application de la substitution correspond au travail dans lequel cette dernière est exécutée.

Exemples

Exemple 1 : remplacement du poste unité par les attributs de sélection du format d'enregistrement

OVRICFDEVE   PGMDEV(BSCEL2)  RMTLOCNAME(BSCNYC)
             FMTSLT(*RECID)

Cette commande permet de remplacer l'unité programme BSCEL2 par un lieu éloigné correspondant nommé BSCNYC pour tout fichier ICF associé au travail. L'unité programme est remplacée par les attributs de FMTSLT(*RECID).

Exemple 2 : remplacement du poste unité par les attributs de sélection du format d'enregistrement et de type de conversation

OVRICFDEVE   PGMDEV(APPC1)  RMTLOCNAME(*REQUESTER)
             FMTSLT(*RMTFMT)  CNVTYPE(*SYS)

Cette commande permet de remplacer le poste unité programme APPC1 par le nom de lieu éloigné *REQUESTER. Le poste unité programme est remplacé par les attributs FMTSLT(*RMTFMT) et CNVTYPE(*SYS).

Exemple 3: substitution d'un poste pour des fichiers ICF associés

OVRICFDEVE   PGMDEV(JOE)  RMTLOCNAME(LU0MPLS)

Cette commande permet de remplacer le poste unité programme JOE par un lieu éloigné nommé LU0MPLS pour tout fichier ICF associé au travail.

Exemple 4: indication de l'unité de communication

OVRICFDEVE   PGMDEV(APPC)  RMTLOCNAME(APPCMPLS)  DEV(MPLSLINE2)

Cette commande permet de remplacer le poste unité programme APPC par un lieu éloigné nommé APPCMPLS utilisant l'unité MPLSLINE2.

Messages d'erreur

Messages *ESCAPE

CPF180C
Fonction &1 non admise.
CPF1892
Fonction &1 non admise.

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