CHGICFDEVE

La commande CHGICFDEVE (Modifier un poste unité de fichier ICF) permet de modifier les attributs de l'unité programme dans le fichier ICF indiqué.

Paramètres

Fichier ICF (FILE)

Indique le fichier ICF contenant l'unité programme ICF à modifier.

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier ICF

nom

Indiquez le nom du fichier ICF.

Qualificatif 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 du poste unité programme du fichier ICF dont les attributs doivent être modifiés.

Ce paramètre est obligatoire.

nom

Indiquez le nom de l'unité programme du fichier ICF dont les attributs doivent être modifiés. Le poste unité programme doit exister dans le fichier ICF spécifié.

Lieu éloigné (RMTLOCNAME)

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

*SAME

Le nom de lieu éloigné n'est pas modifié.

nom-communications

Indiquez le nom du lieu éloigné avec lequel votre programme communique. Lors de son exécution, une seule unité programme associée à chaque lieu éloigné asynchrone, BSCEL ou SNUF, peut être acquise à tout moment.

*REQUESTER

Le nom pris en compte est le nom utilisé pour identifier l'unité de communication à partir de laquelle le programme est démarré. Le programme cible utilise toujours *REQUESTER comme nom de lieu éloigné dans le fichier ICF afin de se connecter à la session dont se sert le programme source pour envoyer la demande EVOKE. Vous ne pouvez préciser *REQUESTER que pour un seul poste d'unité programme.

*REQUESTER n'est admis que pour un travail de communication du système cible. Si cette valeur est indiquée pour un autre type de travail, un message d'arrêt programme est envoyé lors de l'accès à l'unité programme.

Type de communication (CMNTYPE)

Indique le type de communication sur lequel porte l'invite.

*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. Le paramètre DEV ne concerne que les communications de type APPC (Communications évoluées de programme à programme) et SNUF (SNA Upline Facility).

*SAME

Le nom d'unité n'est pas modifié.

*LOC

L'unité associée au lieu éloigné est 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.

Lieu local (LCLLOCNAME)

Indique le nom du lieu local.

*SAME

Le nom de lieu local n'est pas modifié.

*LOC

Le lieu local et le lieu éloigné portent le même nom.

*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 utilisé. Ce paramètre ne concerne que les communications APPC.

*SAME

Le nom de mode n'est pas modifié.

*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é de réseau. Ce paramètre ne concerne que les communications APPC.

*SAME

L'ID éloigné de réseau n'est pas modifié.

*LOC

N'importe quel ID éloigné de réseau peut être 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.

Sélection de format (FMTSLT)

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

*SAME

La valeur de sélection du format d'enregistrement n'est pas modifié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 spécifiés pour le fichier dans les DDS sont utilisés pour sélectionner les formats d'enregistrement. Si le fichier n'en contient pas, un message d'erreur est envoyé et l'acquisition de l'unité programme n'a pas lieu.

*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'identificateur VTAM du sous-système hôte CICS/VS ou IMS/VS, envoyé avec le message d'ouverture de session. Ce paramètre ne concerne que les communications SNUF.

*SAME

L'identificateur d'application n'est pas modifié.

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

Activité par lots (BATCH)

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

*SAME

La valeur reste inchangée.

*NO

Pas de travaux en traitement par lots.

*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 la session communique. Ce paramètre ne concerne que les communications SNUF.

*SAME

La valeur reste inchangée.

*DEVD

Le système hôte figurant 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 avec l'option "prêt à recevoir".

Fin de la session hôte (ENDSSNHOST)

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

*SAME

La valeur de ce paramètre ne change pas.

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

*SAME

La valeur reste inchangée.

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

*SAME

La valeur reste inchangée.

*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 le type de communication SNUF.

*SAME

La valeur reste inchangée.

*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 transmis au programme.

Protection des messages (MSGPTC)

Indique, pour CICS/VS et IMS/VS, si les messages sont protégés pendant cette session. Ce paramètre ne concerne que les communications SNUF.

*SAME

La valeur reste inchangée.

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

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é

*SAME

L'unité d'émulation n'est pas modifiée.

*NONE

3278

Le flot de données s'adresse à une unité d'affichage 3278 ou 3277.

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

*SAME

Le format des données de l'unité d'émulation n'est pas modifié.

*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 indiquent l'emplacement et les caractéristiques des zones. *FIELD n'est admis 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 BBATCH et si 3278 est mentionné pour le type d'unité de ce paramètre.

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 (Communications évoluées de programme à programme).

*SAME

La valeur reste inchangée.

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

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 ou de dégroupage
• Groupage ou dégroupage utilisateur
• Groupage système avec caractères de séparation des enregistrements
• Groupage système des enregistrements de longueur fixe

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

Elément 1 : Type de groupage

*SAME

La valeur reste inchangée.

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

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

*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 est un 1E hexadécimal.

*SAME

La valeur reste inchangée.

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.

Remarque :Pour plus de détails sur les caractères de contrôle BSC qui ne peuvent pas servir de caractères de séparation d'enregistrement, reportez-vous à la table de la description de la commande ADDICFDEVE.

Longueur d'enregistrement (RCDLEN)

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

*SAME

La valeur reste inchangée.

*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 la longueur maximale (en octets) d'un bloc de données envoyé. Ce paramètre ne concerne que les communications BSCEL et SNUF.

*SAME

La longueur de bloc n'est pas modifiée.

*DEVD

La longueur de bloc spécifiée dans la description d'unité est utilisée.

1 à 32767

Indique la longueur maximale des blocs d'enregistrements utilisée et envoyée par ce fichier unité. Cette longueur doit être au moins égale à la taille du plus grand enregistrement envoyé. 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.

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 cette fonction pour émettre des zones de données binaires ou condensées. Ce paramètre ne concerne que les communications BSCEL.

*SAME

La valeur reste inchangée.

*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é. *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), le type de communication 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 la compression de données est effectuée.

*SAME

La valeur reste inchangée.

*DEVD

L'option de compression des données figurant dans la description d'unité est utilisée.

*NO

Les données ne sont pas comprimées ou décomprimé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 de sortie. Ce paramètre ne concerne que les communications BSCEL.

*SAME

La valeur reste inchangée.

*DEVD

Les blancs de fin de zone spécifiés dans la description d'unité sont utilisés.

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

Remarque :TRUNC(*YES) ne peut pas être indiqué si BLOCK(*NOSEP) ou BLOCK(*ITB) est spécifié. Si TRUNC(*YES) est indiqué en même temps que DTACPR(*YES) ou BLOCK(*USER), la troncature est ignorée.

Données excédentaires (OVRFLWDTA)

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

*SAME

La valeur reste inchangée.

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

*SAME

La valeur reste inchangée.

*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 avec le système éloigné. Ce paramètre ne concerne que les communications BSCEL.

*SAME

La valeur reste inchangée.

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

*SAME

La valeur reste inchangée.

*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

Le système local émet l'appel.

Exemples

Exemple 1 : Modification de la sélection des formats d'enregistrement

CHGICFDEVE   FILE(ICFTEST)  PGMDEV(BSCEL2)
             RMTLOCNAME(BSCNYC)  FMTSLT(*RECID)

Cette commande permet de modifier l'unité programme BSCEL2 dans le fichier ICF ICFTEST. L'unité programme est modifiée de sorte que les attributs FMTSLT(*RECID) lui soient appliqués. Le nom du lieu éloigné est modifié en BSCNYC.

Exemple 2 : Modification du type de conversation

CHGICFDEVE   FILE(QGPL/ICF1)  PGMDEV(APPC1)
             RMTLOCNAME(*REQUESTER)
             FMTSLT(*RMTFMT)  CNVTYPE(*SYS)

Cette commande permet de modifier l'unité programme APPC1 dans le fichier ICF ICF1 pour lui affecter le nom de lieu éloigné *REQUESTER. Cette unité programme est modifiée de sorte que les attributs FMTSLT(*RMTFMT) et CNVTYPE(*SYS) lui soient appliqués.

Exemple 3 : Modification de l'unité de communication

CHGICFDEVE   FILE(ICFLIB/ICFAPPL1)  PGMDEV(APPC)
             RMTLOCNAME(APPCMPLS)  DEV(MPLSLINE2)

Cette commande permet de modifier l'unité programme APPC dans le fichier ICFAPPL1. Le nom du lieu éloigné est modifié en APPCMPLS et l'unité en MPLSLINE2.

Messages d'erreur

*ESCAPE Messages

CPF7367

Unité non modifiée dans fichier &1 de &2.