RTVNETA

La commande RTVNETA (Extraire attributs du réseau)permet, dans un programme CL ou REXX, d'extraire les attributs de réseau du système. Les valeurs sont renvoyées (copiées) dans les variables indiquées dans le programme.

Restrictions : Les attributs du réseau et la variable recevant les valeurs doivent être compatibles.

Paramètres

Variable pour SYSNAME (8) (SYSNAME)

Indique le nom de la variable CL devant recevoir le nom du système en cours. Il doit s'agir d'une variable alphanumérique comportant au moins 8 caractères.

Variable pour PNDSYSNAME (8) (PNDSYSNAME)

Indique le nom de la variable CL devant recevoir le nom du système en instance. Il doit s'agir d'une variable alphanumérique comportant au moins 8 caractères. En l'absence de nom de système en instance, la valeur retournée est composée de blancs.

Variable pour LCLNETID (8) (LCLNETID)

Indique le nom de la variable CL devant recevoir l'ID local du réseau. Il doit s'agir d'une variable alphanumérique comportant au moins 8 caractères.

Variable pour LCLCPNAME (8) (LCLCPNAME)

Indique le nom de la variable CL devant recevoir le nom du point de contrôle local. Il doit s'agir d'une variable alphanumérique comportant au moins 8 caractères.

Variable pour LCLLOCNAME (8) (LCLLOCNAME)

Indique le nom de la variable CL devant recevoir le nom du lieu local par défaut. Il doit s'agir d'une variable alphanumérique comportant au moins 8 caractères.

Variable pour DFTMODE (8) (DFTMODE)

Indique le nom de la variable CL devant recevoir le nom du mode par défaut. Il doit s'agir d'une variable alphanumérique comportant au moins 8 caractères.

Variable pour NODETYPE (8) (NODETYPE)

Indique le nom de la variable CL devant recevoir le type de noeud APPN. Il doit s'agir d'une variable alphanumérique comportant au moins 8 caractères.

Les valeurs susceptibles d'être renvoyées dans la variable CL sont les suivantes :

*ENDNODE

Le noeud ne fournit pas de services de réseau à d'autres noeuds, mais il peut faire partie d'un réseau APPN en utilisant un serveur de réseau adjacent ou bien fonctionner dans un environnement paritaire comme les noeuds de réseau élémentaires.

*NETNODE

Le noeud fournit des services de routage intermédiaire, de sélection de route et de répertoire de réseau distribué aux utilisateurs locaux et aux noeuds d'extrémité et noeuds de réseau élémentaires qu'il dessert.

*BEXNODE

Le noeud fonctionne comme un noeud d'extension de branche. Il tient lieu de noeud d'extrémité dans un réseau primaire APPN et joue le rôle de serveur de noeud réseau pour les noeuds d'extrémité au sein de son domaine local.

Variable pour DTACPR (10 0) (DTACPR)

Indique le nom de la variable CL recevant le niveau de compression des données en cours. Indiquez le nom d'une variable décimale comportant au moins de 10 chiffres sans position décimale.

Les valeurs pouvant être renvoyées dans la variable pour définir le niveau de compression des données sont les suivantes :

0

*NONE - La compression des données n'est pas admise dans la session.

-1

*REQUEST - La compression des données est demandée dans la session par le système local. La demande peut cependant être refusée ou remplacée par un niveau inférieur de compression des données par le système éloigné. La compression des données est admise dans la session si elle est demandée par le système éloigné.

-2

*ALLOW - La compression des données est admise dans la session par le système local si elle est demandée par un système éloigné. Le système local ne demande pas la compression.

-3

*REQUIRE - La compression des données est exigée dans la session. Si le système éloigné ne remplace pas les niveaux de compression par ceux qui ont été demandés par le système local, la session n'est pas ouverte. Les niveaux de compression des données demandés par le système local sont ceux qui ont été indiqués.

Variable pour DTACPRINM (10 0) (DTACPRINM)

Indique le nom de la variable CL recevant le niveau en cours de compression des données du noeud intermédiaire. Indiquez le nom d'une variable décimale comportant au moins de 10 chiffres sans position décimale.

Les valeurs pouvant être renvoyées dans la variable pour définir le niveau de compression des données du noeud intermédiaire sont les suivantes :

0

*NONE - Les systèmes éloignés ne reçoivent pas de demande de compression des données lorsque le système est un noeud intermédiaire SNA.

-1

*REQUEST - Les systèmes éloignés reçoivent une demande de compression des données lorsque le système est un noeud intermédiaire SNA.

Variable pour MAXINTSSN (5 0) (MAXINTSSN)

Indique le nom de la variable CL devant recevoir le nombre maximal de sessions intermédiaires. Indiquez le nom d'une variable décimale d'une longueur minimale de 5 chiffres sans décimale.

Variable pour RAR (5 0) (RAR)

Indique le nom de la variable CL devant recevoir la résistance de route. Indiquez le nom d'une variable décimale d'une longueur minimale de 5 chiffres sans décimale.

Variable pour NETSERVER (85) (NETSERVER)

Indique le nom de la variable CL devant recevoir la liste des serveurs de noeud réseau. Ce nom de variable doit comporter au moins 85 caractères. Si le nom du serveur ou l'ID réseau comporte un nombre de caractères inférieur au nombre de caractères admis pour cette variable, la valeur sera complétée par des blancs sur la droite. Cinq noms de serveurs de noeud réseau figurent dans la liste. Chaque serveur est défini de la façon suivante : ID réseau (9 caractères) suivi du nom du serveur (8 caractères). Aucun séparateur n'est indiqué. L'ID réseau peut contenir la valeur *LCLNETID indiquant que l'ID réseau en cours est utilisé. Si moins de cinq serveurs de noeud de réseau sont précisés, la zone correspondant aux noms des serveurs non mentionnés est à blanc. Dès qu'un premier nom à blanc est rencontré dans la liste, il est très probable que les noms restants seront également à blanc.

Variable pour ALRSTS (10) (ALRSTS)

Indique le nom de la variable CL devant recevoir l'état d'alerte. Ce nom de variable doit comporter au moins 10 caractères. (Si la valeur de l'état d'alerte comporte un nombre de caractères inférieur au nombre défini pour la variable, cette valeur est complétée par des blancs à droite.)

Les valeurs susceptibles d'être renvoyées dans la variable CL sont les suivantes :

*ON

Le système génère des alertes pour l'ensemble des conditions d'alerte à l'exception des conditions sans contrôle opérateur.

*OFF

Le système ne génère pas d'alertes.

*UNATTEND

Le système génère des alertes pour l'ensemble des conditions d'alerte, y compris les messages pour lesquels *UNATTEND est indiqué pour le paramètre ALROPT (Options d'alerte) de la commande ADDMSGD (Ajouter description de message) ou CHGMSGD (Modifier description message).

Variable pour ALRPRIFP (10) (ALRPRIFP)

Indique le nom de la variable CL (d'une longueur minimale de 10 caractères) qui doit recevoir le point focal d'alerte primaire. (Si la valeur de ce dernier comprend un nombre de caractères inférieur à celui défini pour la variable, elle est complétée par des blancs à droite.)

Les valeurs susceptibles d'être renvoyées dans la variable sont les suivantes :

*NO

Le système n'est pas un point focal d'alerte primaire.

*YES

Le système est un point focal d'alerte primaire.

Variable pour ALRDFTFP (10) (ALRDFTFP)

Indique le nom de la variable CL destinée à recevoir la valeur du point focal d'alerte par défaut. Indiquez une variable CL comportant au moins 10 caractères. (Si la valeur de ce dernier comprend un nombre inférieur à celui défini pour la variable, elle est complétée par des blancs à droite.)

Les valeurs susceptibles d'être renvoyées dans la variable sont les suivantes :

*NO

Le système n'est pas un point focal d'alerte par défaut.

*YES

Le système est un point focal d'alerte par défaut.

Variable pour ALRLOGSTS (7) (ALRLOGSTS)

Indique le nom de la variable CL qui reçoit l'état de consignation des alertes. La variable doit être une variable de type alphanumérique et comporter 7 caractères au minimum.

Les valeurs susceptibles d'être renvoyées dans la variable CL sont les suivantes :

*NONE

Aucune alerte n'est consignée.

*LOCAL

Seules les alertes générées localement sont consignées.

*RCV

Seules les alertes en provenance d'autres noeuds sont consignées.

*ALL

Seules les alertes créées localement et les alertes en provenance d'autres noeuds sont consignées.

Variable pour ALRBCKFP (16) (ALRBCKFP)

Indique le nom de la variable CL destinée à recevoir le nom du système qui fournit les services de point focal d'alerte lorsque le point focal principal est indisponible. Ce nom de variable doit comporter au moins 16 caractères. Si le nom du système de secours est moins long, il est complété par des blancs de fin.

Variable pour ALRRQSFP (16) (ALRRQSFP)

Indique le nom de la variable CL destinée à recevoir le nom du système auquel sont demandés les services de point focal d'alerte. Ce nom de variable doit comporter au moins 16 caractères. Si le nom du système est moins long, il est complété par des blancs de fin.

Variable pour ALRCTLD (10) (ALRCTLD)

Indique le nom de la variable CL qui reçoit le nom du contrôleur permettant l'envoi de messages d'alerte à un autre système lorsque le traitement des alertes est actif. Indiquez une variable CL comportant au moins 10 caractères. (Si le nom du contrôleur d'alerte comprend un nombre de caractères inférieur à celui défini pour la variable, il est complété par des blancs à droite.)

Les valeurs susceptibles d'être renvoyées dans la variable sont les suivantes :

*NONE

Aucun contrôleur d'alerte n'est défini.

nom

Indique le nom du contrôleur utilisé dans une session de contrôleur d'alerte. Ce dernier n'est pas pris en compte si le système dispose d'un point focal d'alerte primaire ou par défaut (par exemple, si le noeud se trouve dans la sphère de contrôle d'un autre système).

Variable pour ALRHLDCNT (5 0) (ALRHLDCNT)

Nom de la variable CL devant recevoir le nombre maximum d'alertes créées avant leur envoi sur la session du contrôleur d'alerte (attribut de réseau ALRCTLD). Les alertes sont retenues (placées en file d'attente) jusqu'à ce que le nombre d'alertes indiqué soit atteint. Ce paramètre permet de gérer les alertes qui sont envoyées par l'intermédiaire d'une ressource limitée en réduisant leur fréquence de transmission.

Remarque :L'attribut de réseau ALRHLDCNT ne s'applique que si l'attribut de réseau ALRCTLD est utilisé. La valeur de ALRHLDCNT n'est pas prise en compte lorsque les sessions de service de gestion, les fonctions APPN et de sphère de contrôle sont utilisées.

Le nombre maximum d'alertes pouvant être créées avant leur envoi est de 32767. Précisez le nom d'une variable décimale d'une longueur totale de 5 chiffres sans décimale.

Les valeurs susceptibles d'être renvoyées dans la variable sont les suivantes :

-2

Cette valeur représente *NOMAX. Les alertes sont retenues indéfiniment. Le nombre d'alertes retenues est la valeur maximale. Les alertes pourront être envoyées ultérieurement via l'indication d'une valeur inférieure pour l'attribut ALRHLDCNT.

0-32767

Précise le nombre maximal d'alertes pouvant être créées avant leur envoi. Les alertes restent à l'état retenu jusqu'à ce que ce nombre soit atteint. Si vous indiquez la valeur 0, les alertes seront envoyées au fur et à mesure de leur création.

Variable pour ALRFTR (10) (ALRFTR)

Indique le nom de la variable CL destinée à recevoir le nom du filtre d'alerte actif. Ce nom de variable doit comporter au moins 10 caractères. Si le nom du filtre d'alerte est moins long, il est complété par des blancs de fin.

Variable pour ALRFTRLIB (10) (ALRFTRLIB)

Indique le nom de la variable CL destinée à recevoir le nom de la bibliothèque contenant la définition du filtre d'alerte. Ce nom de variable doit comporter au moins 10 caractères. Si le nom de la bibliothèque est moins long, il est complété par des blancs de fin.

Variable pour MSGQ (10) (MSGQ)

Indique le nom de la variable CL devant recevoir le nom de la file d'attente de messages par défaut du réseau dans le système. Ce nom de variable doit comporter au moins 10 caractères. (Si le nom de la file d'attente de messages comporte un nombre de caractères inférieur au nombre défini pour la variable, la valeur est complétée par des blancs sur la droite).

Variable pour MSGQLIB (10) (MSGQLIB)

Indique le nom de la variable CL devant recevoir le nom de la bibliothèque contenant la file d'attente de messages par défaut du réseau SNADS pour ce système. Ce nom de variable doit comporter au moins 10 caractères. (Si le nom de la bibliothèque comporte un nombre de caractères inférieur au nombre défini pour la variable, sa valeur est complétée par des blancs sur la droite.)

Variable pour OUTQ (10) (OUTQ)

Indique le nom de la variable CL devant recevoir le nom de la file d'attente en sortie par défaut du réseau SNADS pour ce système. Ce nom de variable doit comporter au moins 10 caractères. (Si le nom de la file d'attente en sortie comporte un nombre de caractères inférieur au nombre défini pour la variable, sa valeur est complétée par des blancs sur la droite).

Variable pour OUTQLIB (10) (OUTQLIB)

Indique le nom de la variable CL qui reçoit le nom de bibliothèque qui contient la file d'attente en sortie du réseau par défaut. Ce nom de variable doit comporter au moins 10 caractères. (Si le nom de la bibliothèque comporte un nombre de caractères inférieur au nombre défini pour la variable, sa valeur est complétée par des blancs sur la droite.)

Variable pour JOBACN (10) (JOBACN)

Indique le nom de la variable CL (d'une longueur minimale de 10 caractères) qui doit recevoir l'action en cours pour les flots de travaux reçus via le réseau. (Si la valeur de l'action comprend un nombre de caractères inférieur à celui défini pour la variable, elle est complétée par des blancs à droite.)

Les valeurs susceptibles d'être renvoyées dans la variable CL sont les suivantes :

*REJECT

Le flot de données en entrée n'est pas admis par le système. Cette action permet à l'utilisateur d'empêcher l'entrée dans le système d'un flot de travaux reçu par l'intermédiaire du réseau.

*FILE

Le flot de données en entrée est classé dans la file d'attente des fichiers réseau reçus destinés à l'utilisateur. Ce dernier peut alors afficher, arrêter ou recevoir le flot de données en entrée ainsi que le soumettre à une file d'attente de travaux.

*SEARCH

La recherche s'effectue dans la table des postes travaux du réseau afin de définir le type d'action à réaliser pour le flot de données en entrée.

Variable pour MAXHOP (5 0) (MAXHOP)

Indique le nom de la variable CL devant recevoir le nombre maximal de réceptions et de réacheminements vers sa destination finale d'un poste de file d'attente de distribution dans le réseau SNADS. Indiquez le nom d'une variable décimale d'une longueur totale de 5 chiffres sans décimale.

Variable pour DDMACC (10) (DDMACC)

Indique le nom de la variable CL (d'une longueur minimale de 10 caractères) devant recevoir l'action du système en réponse aux demandes DDM ou DRDA provenant d'autres systèmes. (Si la valeur d'accès à DDM comprend un nombre de caractères inférieur à celui défini pour la variable, elle est complétée par des blancs à droite.)

Les valeurs susceptibles d'être renvoyées dans la variable CL sont les suivantes :

*REJECT

Ce système n'admet pas les demandes DDM et DRDA provenant de systèmes éloignés. Il peut toutefois utiliser DDM ou DRDA pour accéder aux fichiers ou aux tables SQL des systèmes éloignés. Les systèmes source (client) pour lesquels *REJECT est indiqué ne peuvent accéder ni aux fichiers, ni aux tables SQL d'un autre système.

*OBJAUT

Toutes les demandes d'accès aux fichiers ou aux tables SQL éloignées sont admises si le profil utilisateur associé au travail DDM ou DRDA est autorisé pour les fichiers. Les droits sur l'objet, tels que le droit de lecture, d'écriture ou de mise à jour doivent également exister pour ces fichiers.

nom

Indique le nom du programme de validation personnalisé pouvant compléter la sécurité au niveau objet. Ce programme d'exit utilisateur peut réduire l'accès aux fichiers *PUBLIC et privés. Le support DDM cible appelle le programme utilisateur pour chaque référence à un fichier. Ce programme signale alors à DDM si la demande doit se poursuivre ou s'arrêter. Dans le cas d'une architecture de base de données relationnelle répartie (DRDA), le programme de validation est appelé uniquement pour les demandes de connexion et non pour un accès individuel aux fichiers.

Variable pour DDMACCLIB (10) (DDMACCLIB)

Indique le nom de la variable CL devant recevoir le nom de la bibliothèque contenant le programme de validation des demandes DDM. Ce nom de variable doit comporter au moins 10 caractères. (Si le nom de la bibliothèque comporte un nombre de caractères inférieur au nombre défini pour la variable, sa valeur est complétée par des blancs sur la droite.) Si *REJECT ou *OBJAUT est indiqué au paramètre DDMACC (Variable pour DDMACC (10)), la valeur de ce paramètre sera composée de blancs.

Variable pour PCSACC (10) (PCSACC)

Indique le nom de la variable CL qui reçoit l'action du système en réponse aux demandes IBM i Access for Windows . Indiquez une variable CL comportant au moins 10 caractères. (Si la valeur d'accès à IBM i Access for Windows comprend un nombre de caractères inférieur à celui défini pour la variable, elle est complétée par des blancs à droite.)

Les valeurs susceptibles d'être renvoyées dans la variable CL sont les suivantes :

*REJECT

Le système n'accepte aucune demande IBM i Access for Windows .

*OBJAUT

Toutes les demandes IBM i Access for Windows sont admises et contrôlées par les autorisations sur les objets du système.

*REGFAC

La fonction d'inscription permet de déterminer les programmes d'exit des différents serveurs. A défaut, *OBJAUT est utilisé.

nom

Nom du programme d'exit du système hôte pour IBM i Access for Windows fourni par le client et pouvant compléter la sécurité du système au niveau objet.

Variable pour PCSACCLIB (10) (PCSACCLIB)

Indique le nom de la variable CL qui reçoit le nom de la bibliothèque contenant le programme d'accès IBM i Access for Windows . Le nom de la variable alphanumérique indiquée doit comporter au moins 10 caractères. (Si le nom de la bibliothèque comporte un nombre de caractères inférieur au nombre défini pour la variable, sa valeur est complétée par des blancs sur la droite.) Si *REJECT, *REGFAC ou *OBJAUT est renvoyé pour le paramètre PCSACC (Variable pour PCSACC (10)), la valeur de ce paramètre sera composé de blancs.

Variable CL pour NWSDOMAIN (8) (NWSDOMAIN)

Indique le nom de la variable CL devant recevoir le domaine LAN Server auquel appartiennent tous les serveurs PC intégrés, ou processeurs d'E-S de serveur de fichiers (FSIOP), du système. Il doit s'agir d'une variable alphanumérique comportant au moins 8 caractères.

Variable pour ALWVRTAPPN (10) (ALWVRTAPPN)

Indique le nom de la variable CL recevant la définition en cours du support APPN virtuel. Cette variable doit comporter un minimum de 10 caractères.

Variable pour ALWHPRTWR (10) (ALWHPRTWR)

Indique le nom de la variable CL recevant la définition en cours du support de transport de tour HPR. Cette variable doit comporter un minimum de 10 caractères.

Variable pour VRTAUTODEV (5 0) (VRTAUTODEV)

Indique le nom de la variable CL recevant la définition en cours du nombre maximal d'unités APPC créées automatiquement sur un contrôleur virtuel. Indiquez le nom d'une variable décimale d'une longueur totale de 5 chiffres sans décimale.

Variable pour HPRPTHTMR (40) (HPRPTHTMR)

Indique le nom de la variable CL recevant la définition en cours du nombre maximal de minutes nécessaires au changement de chemin HPR. Cette zone nécessite une variable alphanumérique de 40 caractères, dans laquelle chaque tranche de 10 caractères représente l'une des quatre valeurs de délai, respectivement pour les priorités de type réseau, élevée, moyenne et faible.

Variable pour ALWADDCLU (10) (ALWADDCLU)

Indique le nom de la variable CL utilisée et précise si le système autorise un autre système à l'ajouter en tant que noeud dans une grappe. Cette variable doit comporter un minimum de 10 caractères.

Les valeurs pouvant être renvoyées dans la variable pour permettre l'ajout à la grappe sont les suivantes :

*NONE

Aucun autre système ne peut ajouter ce système en tant que noeud dans une grappe.

*ANY

N'importe quel autre système peut ajouter ce système en tant que noeud dans une grappe.

*RQSAUT

N'importe quel autre système peut ajouter ce système en tant que noeud dans une grappe après authentification de la demande d'ajout à la grappe.

Variable pour MDMCNTRYID (2) (MDMCNTRYID)

Indique le nom de la variable CL utilisée pour recevoir l'attribut réseau correspondant à l'ID pays ou région associé au modem. Cette variable doit comporter au minimum 2 caractères.

Le paramètre MDMCNTRYID définit les caractéristiques nationales ou régionales par défaut des modems internes aux adaptateurs d'E-S système. Cette valeur doit être configurée correctement afin de garantir un bon fonctionnement et, dans certains pays ou régions, afin de satisfaire aux réglementations en vigueur. La ligne ne pourra pas être mise en tension par l'adaptateur si l'ID pays ou région du modem n'est pas défini.

Variable pour DFTNETTYPE (10) (DFTNETTYPE)

Ce paramètre est obsolète.

Variable pour DFTCNNLST (10) (DFTCNNLST)

Ce paramètre est obsolète.

Variable pour ALWANYNET (10) (ALWANYNET)

Ce paramètre est obsolète.

Exemples

Exemple 1 : extraction du nom du système en cours

DCL   VAR(&SNAME)  TYPE(*CHAR)  LEN(8)
RTVNETA   SYSNAME(&SNAME)

Cette commande permet d'extraire le nom du système en cours.

Exemple 2 : extraction du support APPN virtuel, du nombre maximal d'unités APPC et des changements de chemin HPR

DCL   VAR(&ALWVRTAPPN)  TYPE(*CHAR)  LEN(10)
DCL   VAR(&VRTAUTODEV)  TYPE(*DEC)  LEN(5 0)
DCL   VAR(&HPRPTHTMR)  TYPE(*CHAR)  LEN(40)
RTVNETA   ALWVRTAPPN(&ALWVRTAPPN)  VRTAUTODEV(&VRTAUTODEV)
          HPRPTHTMR(&HPRPTHTMR)

Cette commande permet d'extraire le jeu de paramètres de l'attribut de réseau en cours pour admettre le support virtuel APPN, les unités APPC créées automatiquement sur un contrôleur virtuel et les changements de chemin HPR.

Messages d'erreur

Messages *ESCAPE

CPF1844

Impossible d'accéder à l'attribut du réseau &1.