CHGDEVAPPC

Modifier une unité APPC

En bref

La commande CHGDEVAPPC permet de modifier une description d'unité APPC.

CHGDEVAPPC se lit CHG (Modifier) + DEVAPPC. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CHGDEVAPPC DEVD(…)

Paramètres

DEVD Description d'unité obligatoire
ONLINE En ligne à l'IPL
MODE Mode
MSGQ File attente messages
LOCADR Adresse locale du lieu
SNGSSN Session unique
LCLCTLSSN Session contrôlée en local
PREESTSSN Session pré-établie
LOCPWD Mot de passe du lieu
SECURELOC Lieu protégé
TEXT Texte 'descriptif'

Astuce : dans une session 5250, tapez CHGDEVAPPC 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 CHGDEVAPPC permet de modifier une description d'unité APPC.

Restriction : Pour utiliser cette commande, vous devez disposer du droit spécial *IOSYSCFG (configuration de système d'entrée-sortie).

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
DEVD	Description d'unité	Nom	Obligatoire, clé, positionnel 1
ONLINE	En ligne à l'IPL	SAME, YES, *NO	Facultatif
MODE	Mode	Valeurs uniques: SAME Autres valeurs (jusqu'à 14 répétitions): Nom de communication, NETATR	Facultatif
MSGQ	File attente messages	Valeurs uniques: SAME, CTLD, SYSOPR Autres valeurs: Nom d'objet qualifié*	Facultatif
	Qualificatif 1: File attente messages	Nom, QSYSOPR
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
LOCADR	Adresse locale du lieu	Valeur caractère, *SAME	Facultatif
SNGSSN	Session unique	Valeurs uniques: SAME, NO Autres valeurs: Liste d'éléments	Facultatif
	Élément 1: Session unique possible	*YES
	Élément 2: Nombre de conversations	1-512
LCLCTLSSN	Session contrôlée en local	SAME, YES, *NO	Facultatif
PREESTSSN	Session pré-établie	SAME, YES, *NO	Facultatif
LOCPWD	Mot de passe du lieu	Valeur caractère, SAME, NONE	Facultatif
SECURELOC	Lieu protégé	SAME, YES, NO, VFYENCPWD	Facultatif
TEXT	Texte 'descriptif'	Valeur caractère, SAME, BLANK	Facultatif

Description d'unité (DEVD)

Indique le nom de la description d'unité.

Ce paramètre est obligatoire.

En ligne à l'IPL (ONLINE)

Indique si cet objet est mis en fonction automatiquement lors de la procédure de chargement initial (IPL).

*SAME: La valeur ne change pas.

*YES

L'unité est mise en fonction automatiquement lors de l'IPL.

*NO

L'unité n'est pas mise en fonction automatiquement lors de l'IPL.

Mode (MODE)

Indique les noms des modes qui définissent les sessions sur l'unité.

Ce paramètre admet des valeurs multiples.

*SAME: La valeur ne change pas.

*NETATR: L'ID éloigné du réseau figurant dans les attributs du réseau est utilisé.

nom-mode

Indiquez le nom des descriptions de modes utilisées par l'unité. CPSVCMG et SNASVCMG ne peuvent être spécifiés, ces noms étant réservés au système.

Vous pouvez spécifier jusqu'à 14 modes.

File attente messages (MSGQ)

Indique le nom de la file d'attente de messages vers laquelle sont envoyés les messages d'exploitation de cette unité.

*SAME: La valeur ne change pas.

*CTLD: Les messages sont envoyés dans la file d'attente de messages définie sur le contrôleur connecté. Cette file d'attente est définie au moment de la mise en fonction de l'unité.

*SYSOPR: Les messages sont envoyés dans la file d'attente de messages de l'opérateur système (QSYS/QSYSOPR).

nom-file-attente-messages

Indiquez le nom de la file d'attente de messages dans laquelle sont envoyés les messages d'exploitation.

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques du travail jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

La recherche porte sur la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est prise par défaut.

nom-bibliothèque

Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Adresse locale du lieu (LOCADR)

Indique l'adresse locale du lieu associé à cette unité.

Les valeurs possibles sont comprises entre 00 et FF.

*SAME: La valeur ne change pas.

Session unique (SNGSSN)

Indique si des sessions uniques ou multiples sont utilisées avec les lieux éloignés. Si des sessions uniques sont utilisées, le nombre de conversations doit être indiqué.

Valeurs uniques

*SAME: La valeur ne change pas.

*NO

Des sessions multiples sont utilisées.

Elément 1 : Session unique possible

*YES

Des sessions uniques sont utilisées.

Elément 2 : Nombre de conversations

conversations

Indiquez un nombre de conversations compris entre 1 et 512.

Session contrôlée en local (LCLCTLSSN)

Indique si la session est contrôlée en local.

*SAME: La valeur ne change pas.

*NO

La session unique est contrôlée à distance.

*YES

La session unique est contrôlée en local.

Session pré-établie (PREESTSSN)

Indique si la session est établie au moment de la connexion avec le système éloigné.

*SAME: La valeur ne change pas.

*NO

La session n'est pas établie automatiquement au moment de la connexion.

*YES

La session est établie automatiquement au moment de la connexion.

Mot de passe du lieu (LOCPWD)

Indique le mot de passe nécessaire à la validation de la connexion.

*SAME: La valeur ne change pas.

*NONE

Il n'existe pas de mot de passe.

mot-de-passe-du-lieu

Indiquez le mot de passe sous forme d'une chaîne de caractères hexadécimaux.

Lieu protégé (SECURELOC)

Indique la manière de gérer les informations de sécurité lors de la réception de demandes de démarrage de programmes en provenance d'un système éloigné. La valeur choisie est envoyée à ces derniers lors de l'établissement de sessions. Elle détermine la façon de traiter les demandes d'allocation ou d'appel. Cette valeur s'applique uniquement aux conversations établies avec le niveau de sécurité SECURITY(SAME).

*SAME: La valeur ne change pas.

*NO

Le système éloigné n'est pas un lieu protégé. et ses validations de sécurité ne sont pas acceptées. Les conversations ayant le niveau de sécurité SECURITY(SAME) sont traitées avec le niveau SECURITY(NONE). Aucune information de sécurité n'est envoyée avec les demandes d'allocation ou d'appel.

*YES

Le système éloigné est un lieu protégé et ses validations de sécurité sont acceptées par le système local. Ce dernier lui permet de vérifier les mots de passe utilisateur lors de conversations ayant le niveau de sécurité SECURITY(SAME). Sur le système éloigné, les ID utilisateur sont extraits à partir du gestionnaire de sécurité, puis envoyés avec un indicateur déjà vérifié dans les demandes d'allocation ou d'appel.

*VFYENCPWD

Le système éloigné n'est pas un lieu protégé. Il n'est pas autorisé à envoyer l'indicateur déjà vérifié lors de conversations ayant le niveau de sécurité SECURITY(SAME). Sur le système éloigné, les ID et mots de passe utilisateur sont extraits du gestionnaire de sécurité. Les mots de passe sont ensuite chiffrés, puis envoyés avec les ID dans les demandes d'allocation ou d'appel pour vérification par le système local. N'utilisez cette valeur que si le système éloigné est doté de la V3R2M0, ou suivante du système d'exploitation. S'il ne prend pas en charge la protection des mots de passe, aucun établissement de session n'est autorisé ; s'il prend en charge la protection des mots de passe mais pas la vérification des mots de passe chiffrés (VFYENCPWD), le niveau de sécurité SECURITY(NONE) est attribué aux conversations.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*SAME: Le texte, s'il existe, ne change pas.
*BLANK: Aucun texte n'est spécifié.

valeur-alphanumérique: Tapez un texte d'au plus 50 caractères, entre apostrophes.

Exemples

CHGDEVAPPC   DEVD(APPC1)  SNGSSN(*NO)

Cette commande permet de modifier la description de l'unité de communication APPC1, de sorte qu'elle ne soit plus limitée à des sessions uniques.

Messages d'erreur

Messages *ESCAPE

CPF2618: Description d'unité &1 non modifiée.