CRTDEVAPPC

La commande CRTDEVAPPC permet de créer 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

Description d'unité (DEVD)

Indique le nom de la description d'unité.

Ce paramètre est obligatoire.

Lieu éloigné (RMTLOCNAME)

Nom de lieu éloigné du système avec lequel communique cet objet.

En ligne à l'IPL (ONLINE)

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

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

Lieu local (LCLLOCNAME)

Indique le nom du lieu unique qui permet aux unités éloignées d'identifier le système local. Le nom doit être différent de celui spécifié pour le paramètre Lieu éloigné (RMTLOCNAME). Si les valeurs indiquées aux paramètres ID éloigné du réseau et ID local du réseau sont identiques, la combinaison des noms spécifiés pour les paramètres LCLLOCNAME et RMTLOCNAME doit être unique pour chacune des descriptions d'unités connectées au même contrôleur.

*NETATR

La valeur LCLLOCNAME indiquée dans les attributs de réseau du système est utilisée.

Utilisez la commande (DSPNETA) pour déterminer le nom du lieu local par défaut.

nom-lieu-local

Indiquez le nom du lieu local.

ID éloigné réseau (RMTNETID)

Indique le nom éloigné du réseau.

*NETATR

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

*NONE

Le nom éloigné du réseau est X'40'.

ID-éloigné-réseau

Indiquez l'ID éloigné du réseau.

Connexion au contrôleur (CTL)

Indique le nom de la description de contrôleur à laquelle cette unité est connectée.

Remarque :Pour utiliser cette unité pour communiquer avec un lieu éloigné qui est résidant sur le même système que le lieu local, indiquez une description de contrôleur créée avec le paramètre LINKTYPE (*LOCAL).

Mode (MODE)

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

Ce paramètre admet des valeurs multiples.

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

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

APPN possible (APPN)

Indique si l'unité est gérée par APPN.

*YES

L'unité est gérée par APPN.

*NO

L'unité n'est pas gérée par APPN.

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

*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

10

Le nombre de conversations par défaut est de 10.

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.

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

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

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

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

*BLANK

Aucun texte n'est spécifié.

valeur-alphanumérique

Indiquez, entre apostrophes, un texte de 50 caractères au maximum.

Adresse locale du lieu (LOCADR)

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

Les valeurs possibles sont comprises entre 00 et FF.

Droits (AUT)

Indique les droits que vous accordez aux utilisateurs qui n'ont pas de droits spécifiques sur l'objet, qui ne figurent pas sur une liste d'autorisation ou dont le profil de groupe ou les profils du groupe supplémentaire ne disposent pas de droits spécifiques sur l'objet.

*CHANGE

L'utilisateur peut effectuer toutes les opérations sur l'objet, à l'exception de celles réservées au propriétaire ou contrôlées par les droits d'existence de l'objet (*OBJEXIST) et de gestion de l'objet (*OBJMGT). L'utilisateur peut réaliser des fonctions de base sur l'objet et le modifier. Le droit *CHANGE fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que les droits sur toutes les données. Si l'objet est une liste d'autorisation, vous pouvez ajouter, modifier ou supprimer des utilisateurs dans cette liste.

*ALL

L'utilisateur peut effectuer toutes les opérations, à l'exception de celles réservées au propriétaire ou soumises au droit de gestion de la liste d'autorisation (*AUTLMGT). L'utilisateur a un droit d'existence sur l'objet Il peut également effectuer des fonctions de base sur ce dernier, le modifier, définir son niveau de protection et en transférer la propriété.

*USE

L'utilisateur peut effectuer des opérations de base sur l'objet, telles que l'exécution d'un programme ou la lecture d'un fichier. Il ne peut pas le modifier. Le droit d'utilisation (*USE) fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que le droit d'exécution (*EXECUTE).

*EXCLUDE

L'utilisateur n'a pas accès à l'objet.

*LIBCRTAUT

Le système détermine les droits sur l'objet à l'aide de la valeur précisée à l'invite Droits pour objets créés (paramètre CRTAUT) dans la commande CRTLIB pour la bibliothèque contenant l'objet à créer. Si la valeur précisée au paramètre CRTAUT est modifiée, la nouvelle valeur n'affecte pas les objets existants.

nom

Indiquez le nom d'une liste d'autorisation permettant de déterminer les droits sur l'objet. Les droits sur l'objet précisés dans la liste sont accordés aux utilisateurs qui figurent sur cette liste. La liste d'autorisation doit exister à la création de l'objet.

Exemples

CRTDEVAPPC   DEVD(APPC1)  LOCADR(00)  RMTLOCNAME(CHICAGO)
             CTL(CTLAPPC01)  SNGSSN(*YES)

Cette commande permet de créer une description pour une unité de communication APPC appelée APPC1. Cette unité est associée à l'adresse de lieu de X'00', située à Chicago et connectée au contrôleur CTLAPPC01. Une seule session à la fois peut être ouverte sur cette unité.

Messages d'erreur

Messages *ESCAPE

CPF261A

Description d'unité &1 non créée à la suite d'erreurs.

CPF2654

Description d'unité &1 créée mais peut-être inutilisable.

CPF34D7

File d'attente en sortie &1 de &2 non modifiée en raison d'erreurs.