ADDRTGE

La commande Ajouter un poste de routage (ADDRTGE) permet d'ajouter un poste de routage à la description de sous-système indiquée. Chaque poste de routage indique les paramètres nécessaires pour lancer une phase d'activation d'un travail. Par exemple, le poste de routage indique le nom du programme à lancer lors de la réception des données de routage correspondant à la valeur de comparaison de ce poste.

Restrictions :

1. Pour pouvoir utiliser cette commande, vous devez disposer des droits opérationnels sur les objets (*OBJOPR), des droits de gestion sur les objets (*OBJMGT) et de lecture (*READ) sur la description de sous-système indiquée, ainsi que du droit d'exécution (*EXECUTE) sur la bibliothèque contenant la description de sous-système.

Paramètres

Description de sous-système (SBSD)

Indique le nom et la bibliothèque de la description de sous-système à laquelle le poste de routage doit être ajouté.

Ce paramètre est obligatoire.

Qualificatif 1 : Description de sous-système

nom

Indiquez le nom de la description de sous-système à laquelle le poste de routage doit être ajouté.

Qualificatif 2 : Biblio

*LIBL

Une recherche s'effectue sur toutes les bibliothèques figurant dans la liste des bibliothèques d'unité d'exécution, afin de trouver une occurrence.

*CURLIB

L'objet est recherché dans la bibliothèque en cours de l'unité d'exécution. Si cette dernière n'est pas précisée, QGPL est prise par défaut.

nom

Indiquez le nom de la bibliothèque de la description de sous-système à laquelle le poste de routage doit être ajouté.

No séquence poste de routage (SEQNBR)

Indique le numéro de séquence du poste de routage à ajouter ou modifier. La recherche de correspondance entre les données de routage et les valeurs de comparaison du poste de routage se fait dans l'ordre croissant des numéros de séquence. La recherche prend fin en cas de correspondance ou lorsque le dernier poste de routage est atteint. S'il existe plusieurs concordances, seule la première est traitée.

Ce paramètre est obligatoire.

1-9999

Indiquez une valeur comprise entre 1 et 9999.

Donnée de comparaison (CMPVAL)

Permet d'associer une valeur à un poste de routage ; cette valeur est comparée aux données de routage afin de déterminer si le poste concerné doit être utilisé pour démarrer une phase d'activation du travail. Si la donnée de routage concorde avec la valeur de comparaison, le poste est utilisé. Vous pouvez préciser une position de début dans la chaîne de caractères indiquant le début de la comparaison au sein de la donnée de routage.

Ce paramètre est obligatoire.

Valeurs uniques

*ANY

Toutes les données de routage sont considérées comme concordantes. Vous ne pouvez indiquer *ANY que si le poste de routage possède le numéro de séquence le plus élevé de tous les postes figurant dans la description de sous-système.

Elément 1 : Valeur de comparaison

valeur-alphanumérique

Entrez une chaîne de 80 caractères au maximum ; cette valeur sera comparée aux données de routage. En cas de correspondance, le poste de routage concerné sera utilisé pour démarrer une phase d'activation.

Elément 2 : Position de début

1

La comparaison entre la valeur de comparaison et les données de routage débute au premier caractère de la chaîne de caractères des données de routage.

1-80

Indiquez une valeur (entre 1 et 80) désignant la position de début de comparaison au sein de la chaîne de caractères des données de routage. La valeur correspondant à la dernière position de caractère comparée doit être inférieure ou égale à la longueur des données de routage utilisées pour la comparaison.

Nom du programme à appeler (PGM)

Indique le nom et la bibliothèque du programme à appeler et à exécuter à l'initialisation de la phase d'activation. Aucun paramètre ne peut être passé au programme indiqué. Vous pouvez soit indiquer explicitement le nom du programme dans le poste de routage, soit l'extraire des données de routage. Dans le premier cas, la sélection du poste provoque l'appel du programme correspondant, quel que soit le nom de programme passé au moyen d'une fonction EVOKE. En cas d'appel du programme désigné dans la fonction EVOKE, *RTGDTA doit être indiqué. Si le programme n'existe pas lors de l'ajout ou de la modification du poste de routage, un qualifiant de bibliothèque doit être indiqué car le nom qualifié du programme est conservé dans la description de sous-système.

Ce paramètre est obligatoire.

Valeurs uniques

*RTGDTA

Le nom du programme est extrait de la donnée de routage transmise et comparée avec le poste. Un nom qualifié s'obtient de la façon suivante : les positions 37 à 46 de la donnée de routage fournissent le nom de programme proprement dit, tandis que les positions 47 à 56 constituent le nom de bibliothèque. La valeur *RTGDTA ne peut être associée à des postes de routage que dans le cas de fonctions EVOKE portant sur des travaux pour lesquels le nom de programme est correctement positionné au sein de la donnée de routage.

Qualificatif 1 : Nom du programme à appeler

nom

Indiquez le nom du programme à lancer via ce poste de routage.

Qualificatif 2 : Biblio

*LIBL

Une recherche s'effectue sur toutes les bibliothèques figurant dans la liste des bibliothèques d'unité d'exécution, afin de trouver une occurrence.

*CURLIB

L'objet est recherché dans la bibliothèque en cours de l'unité d'exécution. Si cette dernière n'est pas précisée, QGPL est prise par défaut.

nom

Indiquez la bibliothèque dans laquelle figure le programme désigné.

Classe (CLS)

Indique le nom et la bibliothèque de la classe à utiliser pour les phases d'activation démarrées via ce poste de routage. La classe définit les attributs de l'environnement d'exécution des phases d'activation. Si la classe n'existe pas encore lors de l'ajout du poste de routage, il convient d'indiquer un qualifiant de bibliothèque car le nom qualifié de la classe est conservé dans la description du sous-système.

Valeurs uniques

*SBSD

Les phases d'activation lancées par l'intermédiaire de ce poste utilisent la description de sous-système dont le nom qualifié est identique à celui indiqué en regard de l'invite Description de sous-système (paramètre SBSD).

Qualificatif 1 : Classe

nom

Indiquez le nom de la classe à utiliser pour les phases d'activation lancées via ce poste.

Qualificatif 2 : Biblio

*LIBL

Une recherche s'effectue sur toutes les bibliothèques figurant dans la liste des bibliothèques d'unité d'exécution, afin de trouver une occurrence.

*CURLIB

L'objet est recherché dans la bibliothèque en cours de l'unité d'exécution. Si cette dernière n'est pas précisée, QGPL est prise par défaut.

nom

Indiquez le nom de bibliothèque de la classe à utiliser pour les phases d'activation lancées via ce poste.

Nombre maxi phases actives (MAXACT)

Indique le nombre maximal de phases d'activation (travaux) pouvant être actives simultanément via le poste de routage. Dans un travail donné, une seule phase d'activation peut être active à la fois. Lorsqu'un sous-système est actif et que le nombre maximal de phases d'activation est atteint, toute nouvelle tentative de démarrage via le même poste échoue. Le travail est interrompu et le sous-système envoie un message à l'historique du travail.

*NOMAX

Aucun maximum n'est fixé pour le nombre de phases d'activation actives simultanément et traitées par l'intermédiaire de ce poste de routage. Cette valeur est habituellement utilisée lorsqu'il n'y a pas lieu de contrôler le nombre de phases d'activation.

0-32000

Indiquez le nombre maximal de phases d'activation pouvant être actives simultanément via le poste de routage. Dès que le démarrage d'une nouvelle phase d'activation implique le dépassement de ce nombre, le travail est automatiquement interrompu.

Identificateur pool mémoire (POOLID)

Indique l'identificateur du pool de mémoire dans lequel le programme doit être exécuté. L'identificateur du pool indiqué ici se réfère à l'un des pools mémoire figurant dans la description de sous-système.

1

Le pool de mémoire 1 de ce sous-système est celui dans lequel le programme s'exécute.

1-10

Indiquez l'identificateur du pool de mémoire défini pour ce sous-système et dans lequel le programme doit être exécuté.

Affinité ress unité exécution (THDRSCAFN)

Indique l'affinité des unités d'exécution par rapport aux ressources système.

Valeurs uniques

*SYSVAL

Lors du lancement de la phase d'activation, c'est la valeur d'affinité des ressources de l'unité d'exécution, issue de la valeur système QTHDRSCAFN, qui est utilisée.

Elément 1 : Groupe

*NOGROUP

Les travaux utilisant ce poste de routage auront une affinité par rapport à un groupe de processeurs et à la mémoire. Les unités d'exécution secondaires en cours de fonctionnement derrière le travail n'auront pas obligatoirement d'affinité avec le même groupe de processeurs et la même mémoire.

*GROUP

Les travaux utilisant ce poste de routage auront une affinité par rapport à un groupe de processeurs et à la mémoire. Les unités d'exécution secondaires en cours de fonctionnement derrière le travail auront une affinité avec le même groupe de processeurs et la même mémoire que l'unité d'exécution initiale.

Elément 2 : Niveau

*NORMAL

Une unité d'exécution utilisera n'importe quel processeur ou mémoire à partir du moment où les ressources avec lesquelles il a une affinité ne sont pas immédiatement disponibles.

*HIGH

Une unité d'exécution utilise uniquement les ressources avec lesquelles elle a une affinité, et, si besoin, attend leur disponibilité.

Groupe affinité de ressources (RSCAFNGRP)

Indique si des travaux utilisant ce poste de routage sont regroupés pour leur permettre d'avoir une affinité avec les mêmes ressources système (processeurs et mémoire). La valeur *YES est prioritaire sur la valeur système QTHDRSCAFN *NOGROUP.

*NO

Les travaux utilisant cette phase de routage ne sont pas regroupés.

*YES

Les travaux utilisant ce poste de routage sont regroupés de sorte qu'ils aient une affinité avec les mêmes ressources système. Les travaux qui partagent des données dans la mémoire s'exécutent mieux s'ils ont une affinité avec les mêmes ressources.

Exemples

Exemple 1 : ajout d'un poste de routage à une description de sous-système

ADDRTGE   SBSD(ORDLIB/PERT)  SEQNBR(46)  CMPVAL(WRKSTN2)
          PGM(ORDLIB/GRAPHIT)  CLS(MYLIB/AZERO)  MAXACT(*NOMAX)
          POOLID(2)

Cette commande ajoute un poste de routage 46 à la description de sous-système PERT dans la bibliothèque ORDLIB. Pour utiliser le poste de routage 46, les données de routage doivent commencer par la chaîne de caractères WRKSTN2 en position 1. Un certain nombre de phases d'activation peuvent être actives par ce poste à tout moment. Le programme GRAPHIT de la bibliothèque ORDLIB doit s'exécuter dans le pool de mémoire 2 à l'aide de la classe AZERO de la bibliothèque MYLIB.

Exemple 2 : ajout à la description de sous-système

ADDRTGE   SBSD(QGPL/ABLE)  SEQNBR(5)  CMPVAL(XYZ)
          PGM(QGPL/REORD)  CLS(LIBX/MYCLASS)  MAXACT(*NOMAX)

Cette commande ajoute un poste de routage 5 à la description de sous-système ABLE de la bibliothèque QGPL. Le programme REORD de la bibliothèque QGPL est démarré et utilise la classe MYCLASS dans LIBX lorsqu'une valeur de comparaison de XYZ (démarrant en position 1) concorde avec les données de routage. Le programme s'exécute dans le pool de mémoire 1. Le nombre maximal de phases d'activation actives admises n'est pas limité.

Messages d'erreur

Messages *ESCAPE

CPF1619

Description de sous-système &1 de &2 endommagée.

CPF1691

La description de sous-système actif n'a peut-être pas été modifiée.

CPF1697

Description de sous-système &1 non modifiée.