Clôture d'un journal RKLVLOG et ouverture d'un nouveau journal

Lorsque vous recréez un problème pour le soumettre au service de support logiciel IBM®, vous pouvez utiliser une commande z/OS MODIFY pour fermer le fichier de spool RKLVLOG en cours et en ouvrir un autre. Cette commande est lancée à partir d'une console z/OS. La commande TLVLOG permet de gérer l'enregistrement des informations dans le journal RKLVLOG. La syntaxe et l'utilisation de cette commande sont les suivantes :


>>---MODIFY------stcname------,------TLVLOG------SWITCH--------->

>--+---------------+--+----------------+--+------------+-------->
   '-,CLASS=classe-'  '-,COPIES=copies-'  '-,DEST=dest-'   

>--+----------+--+------------------+--+-------------------+--+----------------------+--+----------+--+-------------------+--+-----------------------+-><
   '-,FCB=fcb-'  '-,FORM=formulaire-'  |       .-NON-----. |  '-,MAXLINES=lignes_max-'  '-,UCS=ucs-'  '-,USER=utilisateur-'  '-,WTRNAME=nom_écriture-'   
                                       '-HOLD=-+-+-----+-+-'                                                                                             
                                                 '-OUI-'

où :

Mot clé	Description
Switch	Mot clé qui alloue un nouveau fichier RKLVLOG de manière dynamique en utilisant les valeurs en cours, commence l'enregistrement sur le nouveau fichier et ferme le fichier RKLVLOG en cours, ce qui libère ce dernier pour traitement dans JES.
`classe`	Classe JES SYSOUT identifiée par le biais d'un seul caractère. `CLASS=A` correspond à la valeur de démarrage de TMS: Engine.
`copies`	Nombre de copies. La fourchette valide est comprise entre 1 et 254. `COPIES=1` correspond à la valeur de démarrage. Remarque : JES2 autorise 255 copies tandis que JES3 en autorise uniquement 254.
`dest`	Destination JES SYSOUT comprenant entre 1 et 8 caractères. `DEST=()` correspond à la valeur de démarrage.
`fcb`	Correspond au nom FCB à utiliser qui comprend entre 1 et 4 caractères. `FCB=()` correspond à la valeur de démarrage.
`formulaire`	Correspond au nom de formulaire à utiliser qui comprend entre 1 et 4 caractères. `FORM=()` correspond à la valeur de démarrage.
`hold`	Indique si le fichier SYSOUT doit être placé à l'état d'opérateur JES hold. Indiquez YES (l'état d'opérateur hold est demandé) ou NO. `HOLD=NO` correspond à la valeur de démarrage. Remarque : Si `HOLD=YES` est spécifié, vous devez lancer la commande de libération JES appropriée pour que le fichier SYSOUT soit traité par JES.
`nombre_max_lignes`	Nombre maximal de lignes pouvant être écrites dans RKLVLOG, en milliers (par exemple, `MAXLINES=2` indique un maximum de 2000 lignes). La fourchette valide est comprise entre 0 et 16000 (16 millions de lignes). Lorsque ce nombre est atteint, une commande TLVLOG SWITCH est lancée automatiquement, ce qui entraîne la fermeture du journal RKLVLOG en cours et l'allocation d'un nouveau journal. Si la valeur spécifiée est 0, aucune limite maximale n'est fixée ; vous devez entrer manuellement la commande TLVLOG SWITCH pour changer de fichier journal. `MAXLINES=0` correspond à la valeur de démarrage. Remarque : Contrairement aux autres valeurs, MAXLINES prend effet immédiatement. Si la nouvelle valeur MAXLINES est inférieure au nombre de lignes déjà écrites dans le journal RKLVLOG, le changement de journal est immédiat.
`ucs`	Nom UCS à utiliser qui comprend entre 1 et 4 caractères. `UCS=()` correspond à la valeur de démarrage.
`utilisateur`	ID utilisateur composé de 1 à 8 caractères vers lequel SYSOUT doit être spoolé. Ignoré si le paramètre DEST ne comporte pas de valeur. `USER=()` correspond à la valeur de démarrage.
`nom_écriture`	Correspond au nom d'écriture externe à utiliser qui comprend entre 1 et 8 caractères. `WTRNAME=()` correspond à la valeur de démarrage.

Notes d'utilisation :

La commande TLVLOG exécute jusqu'à trois fonctions, selon les mots clés spécifiés. Si l'on part du principe que vous avez sélectionné ces trois fonctions, elles s'exécutent dans l'ordre suivant :
1. Mise à jour des valeurs d'allocation dynamique. A l'exception de MAXLINES, ces valeurs sont utilisées lors de l'exécution de l'allocation dynamique suivante. Les valeurs sont mises à jour à chaque fois qu'elles sont codées dans la commande.
2. Affichage de la liste des valeurs d'allocation dynamique. Cette opération s'exécute systématiquement.
3. Changement de journaux RKLVLOG. Cette opération s'effectue uniquement si SWITCH est spécifié dans la commande.
  Remarque : Vous pouvez mettre à jour les valeurs et demander un changement de journal à l'aide de la même commande ; les valeurs sont mises à jour d'abord et le changement de journal s'effectue ensuite.
Les journaux RKLVLOG peuvent être fermés automatiquement une fois qu'un certain nombre d'enregistrements ont été écrits dedans, comme en ce qui concerne le traitement SYSLOG MVS. Pour plus d'informations, voir le mot clé MAXLINES.
Pour configurer un changement automatique de journal RKLVLOG à chaque fois que l'espace adresse TMS: Engine est lancé, ajoutez la commande suivante à RKANCMD startup CLIST :
TLVLOG MAXLINES=nnn

Cette commande ferme automatiquement le journal RKLVLOG et le libère afin qu'il soit traité dans JES à chaque fois que nnn mille lignes ont été enregistrées. Si nécessaire, vous pouvez ajouter à cette commande d'autres valeurs liées à l'installation (par exemple CLASS).
Un grand nombre de messages de diagnostic sont enregistrés dans le journal RKLVLOG. Si le journal RKLVLOG est configuré pour être remplacé automatiquement ou de manière explicite, vous devez veiller à ce que les fichiers SYSOUT soient conservés au moins pendant la durée de vie de l'exécution de TMS: Engine au cas où ces derniers seraient utiles pour résoudre un problème.
Vous pouvez lancer une commande TLVLOG SWITCH lorsqu'un problème survient. Cela entraîne le transfert des données du journal RKLVLOG liées à le problème dans un fichier de spool distinct pouvant être inclus dans la documentation des problèmes standard de TMS: Engine. Veillez à inclure tous les fichiers RKLVLOG ayant été changés précédemment.
Le journal RKLVLOG étant géré par des sous-programmes de gestion des données IBM standard, les enregistrements sont placés en mémoire tampon avant d'être écrits. Si vous visualisez le journal RKLVLOG actif avec un produit tel que SDSF, les messages les plus récents ne s'affichent pas. Lancez la commande FLUSH TLVLOG pour former l'écriture du tampon de gestion des données en cours. N'utilisez pas la commande TLVLOG SWITCH pour remplacer le journal RKLVLOG en cours à cette fin car cela fragmente inutilement les messages qui y sont enregistrés.
A moins qu'une valeur différente de zéro ne soit attribuée au paramètre MAXLINES, le journal RKLVLOG n'est jamais remplacé automatiquement.
Si une erreur survient au cours de l'écriture dans RKLVLOG, TMS: Engine émet un message et désactive l'enregistrement dans ce journal. Les messages continuent cependant à s'enregistrer dans le journal VIEWLOG et dans toutes les interfaces opérateur actives. Selon l'erreur, vous pouvez redémarrer le journal RKLVLOG en lançant une demande de changement.

Voici quelques exemples d'utilisation de cette commande :

Pour afficher la liste de la destination et des valeurs RKLVLOG en cours : tlvlog
Pour établir la classe X et la destination SYSPROG en tant qu'attributs SYSOUT par défaut et le nombre maximal de lignes à la valeur 20 000 : tlvlog class=x dest=sysprog maxlines=20
Pour changer le journal RKLVLOG et en utiliser un nouveau : tlvlog switch