Options GENERATE

Vous pouvez utiliser le paramètre OPTION pour l'action GENERATE afin de contrôler certains traitements. Cette rubrique décrit les options disponibles à utiliser avec l'action GENERATE .

Présentation des options GENERATE

Le tableau 1 présente les options GENERATE disponibles. Chacune des options disponibles est décrite plus en détail dans GENERATE OPTION keywords.
Tableau 1. Présentation des options GENERATE
OPTION Abréviation Descriptif
USS – Exécutez uniquement l'étape de flux de travaux GENERATE qui déploie les éléments liés à z/OS® UNIX System Services. Cette option nécessite une exécution complète de l'action GENERATE avant utilisation.
NOUSS – N'exécutez pas l'étape z/OS UNIX dans l'action GENERATE .
SECEXITS SEC Effectuer le traitement de la configuration pour les sorties de sécurité uniquement. Cette option nécessite une exécution complète de l'action GENERATE avant utilisation.
NOSECEXITS NS Ne pas effectuer de traitement de configuration pour les sorties de sécurité.
VALIDATE VAL Effectuez la validation initiale des paramètres RTEDEF .
QUICKLOAD QL Chargez les membres de configuration en lecture seule dans les fichiers RK*. Les membres en lecture seule sont ceux qui ne sont pas affectés par la personnalisation lors de la configuration. Cette option nécessite une exécution complète de l'action GENERATE avant utilisation.
QUICKCONFIG QC Mettre à jour les membres configurables pour l'environnement d'exécution (par exemple, dans les bibliothèques RKANPARU, RKANSAMU et RKANCMDU ) sans rafraîchir les données des bibliothèques cibles SMP/E. Cette option nécessite une exécution complète de l'action GENERATE avant utilisation.
RELINK LIEN Assemblez et éditez des modules pour OMEGAMON for Networks (KN3) et l'interface utilisateur 3270 améliorée d'OMEGAMON (KOB). Cette option nécessite une exécution complète de l'action GENERATE avant utilisation.
NORELINK caractère de retour à la ligne N'assemblez pas et ne reliez pas les modules d'édition pour OMEGAMON for Networks ( KN3 ) et l'interface utilisateur OMEGAMON enhanced 3270 (KOB).
TRGCOPY TRG Faites une copie de vos bibliothèques cibles SMP/E, à partir desquelles vous pourrez créer ou mettre à jour vos environnements d'exécution.
Préparation PREP Préparez les fichiers de travail pour votre environnement d'exécution. Vous pouvez utiliser cette option pour générer les fichiers de travail avant d'autres étapes d'action GENERATE , en vue de la préparation de l'installation ou de la maintenance d'OMEGAMON.

Pour spécifier plusieurs options, séparez les valeurs par une virgule et sans espace. Par exemple :OPTION USS,SECEXITS

Compatibilité des options GENERATE

Certaines options ne sont pas compatibles avec d'autres options au cours du même travail. Le tableau 2 indique les options compatibles. Y dans la cellule du tableau indique que vous pouvez spécifier les deux options ensemble dans le même travail. N dans la cellule du tableau indique que vous ne pouvez pas spécifier les deux options ensemble dans le même travail.
Tableau 2. Compatibilité des options GENERATE
  USS NOUSS SECEXITS NOSECEXITS VALIDATE QUICKLOAD QUICKCONFIG RELINK NORELINK TRGCOPY PREPARE
USS — N Y N N Y Y Y N N N
NOUSS N — N Y N N N N Y Y N
SECEXITS Y N — N N Y Y Y N N N
NOSECEXITS N Y N — N N N N Y N N
VALIDATE N N N N — N N N N N N
QUICKLOAD Y N Y N N — Y Y N N N
QUICKCONFIG Y N Y N N Y — Y N N N
RELINK Y N Y N N Y Y — N N N
NORELINK N Y N Y N N N N — N N
TRGCOPY N Y N N N N N N N — N
PREPARE N N N N N N N N N N —

mots clés GENERATE OPTION

USS | NOUSS
Vous pouvez éventuellement contrôler le moment de l'exécution de l'étape du flux de travail GENERATE qui déploie les parties liées à z/OS UNIX. Par défaut, l'action GENERATE effectue automatiquement toute configuration requise z/OS UNIX configuration nécessaire. Toutefois, il peut arriver que vous souhaitiez ignorer cette étape (pour des raisons telles que des problèmes d'autorisation) et effectuer cette étape ultérieurement. Vous pouvez utiliser le paramètre OPTION pour spécifier la valeur USS ou NOUSS afin de contrôler ce traitement, comme suit:
USS
Lorsque OPTION USS est spécifié, l'action GENERATE n'exécute que l'étape qui déploie les parties liées à z/OS UNIX; aucun autre traitement n'est effectué (à moins qu'une autre valeur OPTION ne soit également spécifiée, telle que SECEXITS). Vous ne pouvez pas utiliser cette option lors de l'exécution initiale de l'action GENERATE pour un nouvel environnement d'exécution ; elle ne peut être utilisée que lors des exécutions suivantes.
Important :
  • Vous devez effectuer une exécution complète de l'action GENERATE avant de pouvoir utiliser OPTION USS.
  • Si vous avez modifié des paramètres dans vos membres RTEDEF qui ont un impact sur la configuration, n'utilisez pas, car il ne capturera pas vos modifications de paramètres z/OS UNIX n'utilisez pas OPTION USS, car il ne prendra pas en compte les changements de paramètres. Au lieu de cela, exécutez l'action GENERATE avec OPTION NOUSS (ou sans l'option) pour reconfigurer les membres liés à z/OS UNIX. Ensuite, vous pouvez utiliser OPTION USS pour déplacer les membres mis à jour vers z/OS UNIX.
NOUSS
Lorsque OPTION NOUSS est spécifié, l'action GENERATE n'exécute pas l'étape qui déploie les parties liées à z/OS UNIX. Vous pouvez utiliser cette option lors de l'exécution initiale de l'action GENERATE pour un nouvel environnement d'exécution, ainsi que lors des exécutions suivantes.
SECEXITS | NOSECEXITS

Vous pouvez optionnellement contrôler le moment où le traitement de la configuration doit être effectué pour les sorties de sécurité. Par défaut, l'action GENERATE exécute automatiquement les tâches de configuration requises pour les exits de sécurité, ce qui inclut la reconstruction et la réimplantation des exits de sécurité dans la bibliothèque de chargement RKANMODU . En exécutant ces tâches séparément des autres étapes, vous pouvez économiser de précieux cycles de CPU et isoler le moment où une autorisation supplémentaire est nécessaire, ce qui peut être le cas lors de la mise à jour de la bibliothèque de chargement.

Vous pouvez utiliser le paramètre OPTION pour spécifier la valeur SECEXITS ou NOSECEXITS afin de contrôler ce traitement, comme suit :
SECEXITS
Lorsque OPTION SECEXITS est spécifié, l'action GENERATE effectue la configuration des exits de sécurité uniquement ; aucun autre traitement n'est effectué (sauf si une autre valeur OPTION est également spécifiée, telle que USS). Vous ne pouvez pas utiliser cette option lors de l'exécution initiale de l'action GENERATE pour un nouvel environnement d'exécution ; elle ne peut être utilisée que lors des exécutions suivantes.
Important: Vous devez effectuer une exécution complète de l'action GENERATE avant de pouvoir utiliser l'option SECEXITS .
NOSECEXITS
Lorsque OPTION NOSECEXITS est spécifié, l'action GENERATE n'effectue pas de traitement de configuration pour les sorties de sécurité. Vous pouvez utiliser cette option lors de la première exécution de l'action GENERATE pour un nouvel environnement d'exécution, ainsi que lors des exécutions suivantes.
Conseil : cette option ne met pas à jour la bibliothèque de chargement RKANMODU , un ensemble de données dont la mise à jour peut nécessiter une autorisation plus restrictive. Si vous utilisez cette option en même temps que l'option NORELINKl'action GENERATE ne met pas à jour la bibliothèque RKANMODU , et vous pouvez effectuer les autres étapes de configuration de GENERATE qui ne nécessitent pas d'accès supplémentaire.

Pour plus d'informations sur la création de votre bibliothèque d'exits de sécurité, voir Configuration des exits de sécurité dans votre environnement d'exécution.

VALIDATE
Vous pouvez vérifier que tous les paramètres spécifiés dans le jeu de données RTEDEF ont des valeurs correctes et que vous ne manquez rien. Cette option vous aide à préparer l'exécution de l'action GENERATE complète. OPTION VALIDATE recréera les bibliothèques temporaires et de travail et exécutera les étapes de validation pour s'assurer que votre configuration est correcte. Vous ne pouvez pas utiliser l'option VALIDATE avec une autre valeur OPTION . Après avoir exécuté l'action GENERATE avec OPTION VALIDATE, vous pouvez trouver le rapport de validation à l'aide de l'instruction $VALRPT DD .
Attention: Si vous avez précédemment utilisé PARMGEN pour la configuration, sachez que l'utilisation de l'action GENERATE avec OPTION VALIDATE recréera le fichier WCONFIG , ce qui invalidera la configuration PARMGEN. Cela signifie que si vous migrez un environnement d'exécution de PARMGEN vers le gestionnaire de configuration à l'aide de l'action MIGRATE , puis que vous exécutez l'action GENERATE avec OPTION VALIDATE, vous ne pouvez plus utiliser la configuration PARMGEN.
CHARGEMENT rapide

A l'aide de OPTION QUICKLOAD, vous pouvez charger les membres de configuration en lecture seule dans les fichiers RK* . Les membres en lecture seule sont ceux qui ne sont pas affectés par la personnalisation lors de la configuration.

OPTION QUICKLOAD est compatible avec les options USS et SECEXITS , mais pas avec les options VALIDATE et NOUSS . Cette option nécessite une exécution complète de l'action GENERATE avant utilisation.

QUICKCONFIG

Grâce à cette option, vous pouvez rapidement reconfigurer vos produits sans avoir à recharger les membres d'exécution en lecture seule ou à rafraîchir les données des bibliothèques cibles SMP/E. L'utilisation de cette option peut améliorer les performances, avec l'impact le plus important lors de l'utilisation d'un environnement d'exécution complet (le paramètreRTE_TYPE est défini sur FULL).

Lorsque OPTION QUICKCONFIG est spécifié, l'action GENERATE met à jour les membres configurables pour l'environnement d'exécution (par exemple, dans les bibliothèques RKANPARU, RKANSAMU et RKANCMDU ) sans actualiser les données des bibliothèques cibles SMP/E. Les membres en lecture seule, qui sont des membres qui ne sont pas affectés par la personnalisation lors de la configuration, ne sont pas chargés dans les fichiers RK* .

Plus spécifiquement, l'exécution de l'action GENERATE avec OPTION QUICKCONFIG effectue les actions suivantes:
  • Valide les paramètres
  • Alloue les fichiers manquants
  • Met à jour des membres configurables pour l'environnement d'exécution (par exemple, dans les bibliothèques RKANPARU, RKANSAMUet RKANCMDU )
  • Met à jour les tâches démarrées, la liste VTAM et le noeud VTAM
  • Mises à jour z/OS UNIX -mais ne les déploie pas dans les répertoires ou les fichiers z/OS UNIX répertoires ou fichiers. Pour déployer des membres préparés dans des fichiers ou des répertoires z/OS UNIX vous devez combiner l'option QUICKCONFIG avec l'option USS .
L'exécution de l'action GENERATE avec OPTION QUICKCONFIG n'effectue pas les actions suivantes:
  • Rafraîchir les données des bibliothèques cibles SMP/E
  • Mise à jour des modules en lecture seule des bibliothèques cibles SMP/E
  • Mettre à jour z/OS UNIX des fichiers ou des répertoires
  • Effectuer des opérations d'assemblage ou de liaison liées à des exits de sécurité ou à d'autres modules de chargement

Vous ne pouvez pas utiliser l'option QUICKCONFIG avec l'option VALIDATE ou l'option NOUSS . L'option QUICKCONFIG nécessite une exécution complète de l'action GENERATE avant utilisation.

RELINK | NORELINK

Vous pouvez éventuellement contrôler le moment où les éléments sont assemblés et liés à la bibliothèque de chargement RKANMODU lorsqu'une nouvelle liaison des modules IBM Z OMEGAMON AI for Networks ( KN3 ) ou de l'interface utilisateur OMEGAMON enhanced 3270 (KOB) est nécessaire, par exemple lors de l'application d'une maintenance. Par défaut, l'action GENERATE exécute automatiquement ces étapes. En effectuant ces tâches séparément, vous pouvez isoler le moment où une autorisation supplémentaire est nécessaire, ce qui peut être le cas lors de la mise à jour de la bibliothèque de chargement.

Vous pouvez utiliser le paramètre OPTION pour spécifier la valeur RELINK ou NORELINK afin de contrôler ce traitement, comme suit :
RELINK
Utilisez OPTION RELINK pour assembler et lier des éléments dans la bibliothèque de chargement RKANMODU lorsqu'une nouvelle liaison des modules IBM Z OMEGAMON AI for Networks ( KN3 ) ou OMEGAMON Enhanced 3270 User Interface (KOB) est nécessaire, par exemple lors de l'application de la maintenance. Vous ne pouvez pas utiliser cette option lors de la première exécution de l'action GENERATE pour un nouvel environnement d'exécution; elle ne peut être utilisée que lors des exécutions suivantes.
Important: Vous devez effectuer une exécution complète de l'action GENERATE avant de pouvoir utiliser l'option RELINK .
Note : Si vous connaissez PARMGEN, l'option RELINK a la même fonction que le job PARMGEN KCIJPLNK (Exécuter les étapes post SMP/E RKANMODU ASM/LINK ).
Conseil : vous pouvez personnaliser le programme de reliure utilisé en spécifiant le nom du programme dans le paramètre GBL_UTIL_BINDER.
Lors de l'utilisation de l'action GENERATE avec OPTION RELINK, les détails varient en fonction de l'environnement dans lequel l'action s'exécute, comme suit:
Sur un système local (le système de configuration dans un scénario de déploiement à distance)

Vous pouvez exécuter l'action GENERATE avec OPTION RELINK sur un système local pour assembler et lier des éléments.

Dans un environnement distant avec un niveau z/OS différent

Vous pouvez exécuter l'action GENERATE avec OPTION RELINK sur un système cible dont le niveau z/OS est différent de celui du système de configuration. Il n'est pas nécessaire d'exécuter toutes les étapes du scénario de déploiement à distance (actionGENERATE , action PACKAGE , transfert de fichiers, action DEPLOY ).

L'utilisation de l'option RELINK nécessite la présence de la bibliothèque SMP/E TKANMODS sur le système cible. La bibliothèque TKANMODS ne fait pas partie de l'environnement d'exécution complet et n'est pas créée par l'action BLDREMDS . En d'autres termes, vous devez disposer d'un environnement SMP/E pour garantir la cohérence. Par conséquent, vous devez exécuter Configuration Manager à partir des mêmes bibliothèques SMP/E.

Vous pouvez réexécuter l'action GENERATE avec OPTION RELINK si nécessaire.

Lorsque vous utilisez l'option RELINK pour relier des modules dans un environnement distant à un niveau z/OS différent, les paramètres des bibliothèques définies par les paramètres GBL_DSN_SYS1_MACLIB et GBL_DSN_CEE_SCEELKED peuvent être différents de ceux de votre système local. S'il existe des différences significatives dans le contenu de ces bibliothèques, qui contrôlent la façon dont les modules sont assemblés et liés, vous devez exécuter l'action GENERATE avec OPTION RELINK sur le système cible.

Dans un environnement distant avec le même niveau z/OS

Vous pouvez exécuter l'action GENERATE avec OPTION RELINK sur un système cible qui est au même niveau z/OS que le système de configuration. Dans cet environnement, il n'y a pas d'environnement SMP/E sur le système cible, et seul l'ensemble minimal de bibliothèques est transféré pour effectuer l'action DEPLOY .

Vous pouvez exécuter la série d'étapes suivante:
  1. Action GENERATE avec OPTION RELINK
  2. PACKAGE action
  3. Transfert de fichiers
  4. DEPLOY action
Cette implémentation permet d'économiser des cycles d'UC à l'étape GENERATE .
Pour un environnement d'exécution complet
Dans un environnement d'exécution complet, vous devez exécuter l'action GENERATE avec OPTION QUICKLOAD,RELINK pour obtenir les résultats de reconnexion corrects. (Cette exigence est due à une dépendance sur le fichier RKANSAM ).
NORELINK
Lorsque OPTION NORELINK est spécifié, l'action GENERATE n'assemble pas et ne relie pas les modules IBM Z OMEGAMON AI for Networks ( KN3 ) ou OMEGAMON enhanced 3270 user interface (KOB), même si une nouvelle liaison est nécessaire. Vous pouvez utiliser cette option lors de la première exécution de l'action GENERATE pour un nouvel environnement d'exécution, ainsi que lors des exécutions suivantes.
Conseil : cette option ne met pas à jour la bibliothèque de chargement RKANMODU , un ensemble de données dont la mise à jour peut nécessiter une autorisation plus restrictive. Si vous utilisez cette option en même temps que l'option NOSECEXITSl'action GENERATE ne met pas à jour la bibliothèque RKANMODU , et vous pouvez effectuer les autres étapes de configuration de GENERATE qui ne nécessitent pas d'accès supplémentaire.
TRGCOPY
Utilisez OPTION TRGCOPY pour faire une copie de vos bibliothèques cibles SMP/E, à partir desquelles vous pouvez créer ou mettre à jour vos environnements d'exécution. Vous pouvez abréger ce mot clé en TRG. Pour plus d'informations, voir Utilisation de copies de bibliothèques cibles SMP/E.
PREPARATION

UtiliserOPTION PREPARE pour préparer des bibliothèques de travail intermédiaires pour votre environnement d'exécution. Vous pouvez utiliser cette option pour générer les fichiers de travail avant d'autres étapes de flux de travaux d'action GENERATE , en préparation de l'installation ou de la maintenance d'OMEGAMON. Cette option peut s'avérer utile si vous devez effectuer d'autres tâches connexes qui nécessitent les fichiers de travail à l'avance ou en parallèle, telles que la préparation des membres pour les liaisons Db2 ou la copie des membres de tâche démarrée dans les bibliothèques PROCLIB.

Avec cette option, vous pouvez exécuter l'action GENERATE avec OPTION PREPARE initialement pour créer les fichiers de travail, puis, lorsque vous êtes prêt, exécuter à nouveau l'option GENERATE (sans l'option PREPARE ) pour terminer les étapes de flux de travaux supplémentaires. Vous ne pouvez pas utiliser l'option PREPARE avec une autre valeur OPTION .
Important: Si vous utilisez l'option PREPARE pour créer les fichiers de travail, vous devez être au même niveau de maintenance Configuration Manager lorsque vous exécutez les travaux d'action GENERATE suivants sans l'option PREPARE .
Plus spécifiquement, l'exécution de l'action GENERATE avec OPTION PREPARE effectue les actions suivantes:
  • Valide les valeurs de paramètre
  • Effectue des étapes d'analyse syntaxique
  • Alloue et actualise les bibliothèques de transfert temporaire (IK*) et de travail (WK*). Ces bibliothèques seront copiées ultérieurement dans les bibliothèques d'exécution (RK*).
  • Alloue et actualise les bibliothèques PROCLIB, VTAMLSTet VTAMLIB . Ces bibliothèques contiennent des tâches démarrées, des listes VTAM et des noeuds VTAM.
    Important: Les fichiers spécifiés dans les paramètres GBL_DSN_SYS1_PROCLIB, GBL_DSN_SYS1_VTAMLIBet GBL_DSN_SYS1_VTAMLST seront impactés.
  • Met à jour la bibliothèque utilisateur globale spécifiée dans le paramètre GBL_USER_JCL, qui contient des paramètres globaux.
    Important: toute modification apportée aux membres RTEDEF suivants aura un impact sur votre environnement d'exécution existant: VAR$GLOB, VAR$lparet SYS@lpar
  • Crée un point de contrôle. A la fin du travail, l'action GENERATE avec OPTION PREPARE crée le membre $PREPARE dans la bibliothèque WKANPARU et le remplit avec la date et l'heure de création du point de contrôle, comme suit:
    ******************* Top of Data ******************
* Checkpoint created by userID on yyyy-mm-dd hh:mm:ss
****************** Bottom of Data ****************
    Si le point de contrôle est détecté, les travaux d'action GENERATE suivants (sans l'option PREPARE ) ignorent les étapes de flux de travaux effectuées par l'option PREPARE et reprennent le traitement avec les étapes de flux de travaux restantes. L'action GENERATE supprime ensuite le membre $PREPARE à la fin du travail.
    Remarque: Le point de contrôle n'est pas supprimé si l'une des options suivantes est utilisée: USS, SECEXITS, RELINK, QUICKLOAD