CHGRTGE

La commande Modifier un poste de routage CHGRTGE (Modifier un poste de routage) permet de modifier un poste de routage dans la description de sous-système indiquée. Le poste de routage indique les paramètres nécessaires pour lancer une phase d'activation d'un travail. Le sous-système associé peut être actif lors des modifications.

Restrictions :

1. Pour utiliser cette commande, vous devez disposer des droits opérationnels sur les objets (*OBJOPR), de gestion des objets (*OBJMGT) et de lecture (*READ) sur la description de sous-système indiquée, et 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 dans laquelle figure le poste de routage à modifier.

Ce paramètre est obligatoire.

Qualificatif 1 : Description de sous-système

nom

Indiquez le nom de la description de sous-système associé au poste de routage à modifier.

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 associée au poste de routage à modifier.

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

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

Valeurs uniques

*SAME

La valeur de comparaison et la position de début ne changent pas.

*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

*SAME

La position de démarrage reste inchangée.

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.

Valeurs uniques

*SAME

Le programme appelé ne change pas.

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

Remarque :Si le programme n'existe pas lors de la modification du poste, un qualifiant de bibliothèque doit être indiqué car le nom qualifié du programme est conservé dans la description de sous-système.

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

*SAME

La classe pour ce poste ne change pas.

*SBSD

Les phases d'activation lancées par l'intermédiaire de ce poste utilisent la description de sous-système dont le nom 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 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 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.

*SAME

Le nombre maximal de phases d'activation pouvant être actives simultanément ne change pas.

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

*SAME

L'identificateur du pool ne change pas.

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

*SAME

L'affinité des ressources de l'unité d'exécution reste inchangée.

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

*SAME

Le groupe d'affinité des ressources reste inchangé.

*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 : modification de la classe et de l'identificateur de pool

CHGRTGE   SBSD(LIB5/ORDER)  SEQNBR(1478)  CLS(LIB6/SOFAST)  POOLID(3)

Cette commande modifie le poste de routage 1478 dans la description de sous-système ORDER se trouvant dans la bibliothèque LIB5. Le même programme est utilisé, mais il s'exécute désormais dans le pool de mémoire 3 à l'aide de la classe SOFAST dans la bibliothèque LIB6.

Exemple 2 : modification du nom du programme appelé

CHGRTGE   SBSD(T7/PGMR)  SEQNBR(157)  PGM(T7/INTDEV)

Cette commande modifie le poste de routage 157 dans la description de sous-système PGMR se trouvant dans la bibliothèque T7. Le programme INTDEV de la bibliothèque T7 est désormais appelé lorsque ce poste de routage est sélectionné. Les autres paramètres du poste de routage ne sont pas modifiés.

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.