RTVJOBA

La commande RTVJOBA (Extraire attributs du travail) est utilisée dans un programme CL ou REXX pour extraire les valeurs d'un ou plusieurs attributs de travail et de copier le résultat dans la variable indiquée. Elle permet d'extraire les valeurs d'un ou de plusieurs attributs dans un travail et de les placer dans la variable CL indiquée.

L'invite CL pour cette commande répertorie la longueur minimale des variables extraites en regard des paramètres appropriés. Pour les variables de type alphanumérique, un numéro unique s'affiche. Pour les variables décimales, deux numéros s'affichent. Le premier correspond à la longueur minimale de la variable et le deuxième, au nombre minimal de décimales.

Restrictions :

1. Cette commande n'est admise que dans un programme CL ou une procédure REXX.
2. Cette commande est à unités d'exécution protégées sous certaines conditions. Pour plus d'informations, reportez-vous à la rubrique Portée des attributs et sécurité d'unité d'exécution.

Portée des attributs et sécurité d'unité d'exécution :

Cette commande est utilisée pour extraire les attributs d'un travail pour lequel la commande est utilisée. Cependant, si un attribut de travail n'existe pas car il n'est prise en charge que par l'unité d'exécution, l'attribut d'exécution est ensuite extrait dans l'unité d'exécution dans laquelle cette commande est utilisée.

La colonne Portée indique si l'attribut est apposé au travail ou à l'unité d'exécution.

La colonne Threadsafe indique si les attributs admettent des unités d'exécution protégées.

Oui : - Les attributs comportant cette valeur peuvent être extraits en toute sécurité depuis l'unité d'exécution initiale ou depuis une unité d'exécution secondaire.

Non : - Les attributs comportant cette valeur n'admettent pas les unités d'exécution non protégées et ne peuvent pas être extraits dans un travail à unités d'exécution multiples.

Portée des attributs et sécurité d'unité d'exécution :

Attribut                                             Portée   Unité protégée
----------------------------                         ------   ----------
Nom de groupe ASP (ASPGRP)                           Travail      Oui
Gestion des messages d'interruption (BRKMSG)         Travail      Oui
Contrôle ID caractère (CHRIDCTL)                     Travail      Oui
ID codé de jeu de caractères (CCSID)                 Travail      Oui
ID de pays ou de région (CNTRYID)                    Travail      Oui
Bibliothèque en coure (CURLIB)                       Travail      Oui
Profil utilisateur en cours (CURUSER)                Travail      Oui
Format de date (DATFMT)                              Travail      Oui
Séparateur de date (DATSEP)                          Travail      Oui
Jour de la semaine (DAYOFWEEK)                       Travail      Oui
Gestion des conversations DDM (DDMCNV)               Travail      Oui
Format décimal (DECFMT)                              Travail      Oui
ID de jeu de caractères codés par défaut (DFTCCSID)  Travail      Oui
Temps d'attente par défaut (DFTWAIT)                 Travail      Oui
Reprise de l'unité (DEVRCYACN)                       Travail      Oui
Etat d'arrêt du système (ENDSTS)                     Travail      Oui
Réponse aux messages d'interrogation (INQMSGRPY)     Travail      Oui
Code comptabilité (ACGCDE)                           Travail      Oui
Date de travail avec siècle (CYMDDATE)               Travail      Oui
Date de travail sans siècle (DATE)                   Travail      Oui
Travaux soumis : date et heure (DATETIME)            Travail      Oui
Sortie de l'historique du travail (LOGOUTPUT)        Travail      Oui
Act. satur. file d'attente  mess. travail (JOBMSGQFL)Travail      Oui
Taille max. file d'attente messages (JOBMSGQMX)      Travail      Oui
Nom de travail (JOB)                                 Travail      Oui
Numéro de travail (NBR)                              Travail      Oui
Sous-type de travail (SUBTYPE)                       Travail      Oui
Indicateurs externes (SWS)                           Travail      Oui
Type de travail (TYPE)                               Travail      Oui
Identificateur de langue (LANGID)                    Travail      Oui
Consignation locale (LOGLVL)                         Travail      Oui
Historique des commandes programme CL (LOGCLPGM)     Travail      Oui
Niveau de gravité de consignation (LOGSEV)           Travail      Oui
Texte de consignation (LOGTYPE)                      Travail      Oui
Bibliothèque de file d'attente en sortie (OUTQLIB)   Travail      Oui
Nom de file d'attente de sortie (OUTQ)               Travail      Oui
Format de touche d'impression (PRTKEYFMT)            Travail      Oui
Texte à imprimer (PRTTXT)                            Travail      Oui
Unité imprimante (PRTDEV)                            Travail      Oui
Code retour programme (RTNCDE)                       Travail      Oui
Purge (PURGE)                                        Travail      Oui
Groupe affinité des ressources (RSCAFNGRP)           Travail      Oui
Priorité d'exécution (RUNPTY)                        Travail      Oui
Séquence de tri (SRTSEQ)                             Travail      Oui
Bibliothèque de séquence de tri (SRTSEQLIB)          Travail      Oui
Action de fichier spoule (SPLFACN)                   Travail      Oui
Gestion des messages d'état (STSMSG)                 Travail      Oui
Biblio file d'attente messages déposant (SBMMSGQLIB) Travail      Oui
File d'attente des messages du déposant (SBMMSGQ)    Travail      Oui
Liste des bibliothèques système (SYSLIBL)            Travail      Oui
Affinité ressources unité d'exécution (THDRSCAFN)    Unité exéc   Oui
Séparateur d'heure (TIMSEP)                          Travail      Oui
Tranche de temps (TIMESLICE)                         Travail      Oui
Pool fin de tranche de temps (TSEPOOL)               Travail      Oui
Nom abrégé fuseau horaire (TIMZONABBR)               Travail      Oui
Description fuseau horaire (TIMZON)                  Travail      Oui
Nom complet fuseau horaire (TIMZONFULL)              Travail      Oui
Décalage fuseau horaire (TIMOFFSET)                  Travail      Oui
Liste des bibliothèques utilisateur (USRLIBL)        Unité exéc   Oui
Profil utilisateur (USER)                            Travail      Oui
Décalage de l'année (YEAROFS)                        Travail      Oui

Paramètres

Variable pour JOB (10) (JOB)

Indique le nom de la variable CL destinée à recevoir le nom du travail. Il doit s'agir d'une variable alphanumérique comportant au moins 10 caractères.

Variable pour USER (10) (USER)

Indique nom de la variable CL qui doit recevoir le nom du profil utilisateur associé au travail lors de son lancement. Le nom d'utilisateur correspond à la deuxième partie du nom de travail qualifié. Il doit s'agir d'une variable alphanumérique comportant au moins 10 caractères.

Variable pour NBR (6) (NBR)

Indique le nom de la variable CL devant recevoir le numéro à 6 caractères que le système a affecté au travail. Le numéro de travail correspond à la première partie du nom de travail qualifié (numéro-travail/nom-utilisateur/nom-travail).

Var CL pour CURUSER (10) (CURUSER)

Indique le nom de la variable CL destinée à recevoir le nom du profil utilisateur actif. Il doit s'agir d'une variable alphanumérique comportant au moins 10 caractères.

Variable pour TYPE (1) (TYPE)

Indique le nom de la variable CL qui reçoit la valeur de 1 caractère correspondant à l'environnement du travail. La valeur est égale à 1 pour un travail par lots et elle égale à 1 pour un travail interactif. Il doit s'agir d'une variable alphanumérique comportant au moins 1 caractère.

Variable CL pour SUBTYPE (1) (SUBTYPE)

Indique le nom de la variable CL qui reçoit la valeur sous-type correspondant à l'environnement du travail. Il doit s'agir d'une variable alphanumérique comportant au moins 1 caractère. Les valeurs susceptibles d'être renvoyées sont les suivantes :

Valeur

Environnement

*

Le travail ne comprend pas de sous-type

D

Le travail est un travail par lots immédiat

E

Le travail est un travail d'appel de communications

F

Le travail est un travail IBM 36

J

Le travail est un travail anticipé

P

Le travail est un pilote d'impression

T

Le travail est un travail MRT

U

Le travail est un travail utilisateur spoule secondaire

Variable pour SYSLIBL (165) (SYSLIBL)

Indique le nom de la variable CL qui doit recevoir la partie système de la liste des bibliothèques de l'unité d'exécution. Chaque nom de bibliothèque renvoyé est justifié à gauche dans une zone de 11 caractères complétée à droite par des blancs. La variable doit être de type alphanumérique comportant 165 caractères au minimum.

Variable pour CURLIB (10) (CURLIB)

Indique le nom de la variable CL qui doit recevoir le nom de la bibliothèque en cours pour l'unité d'exécution. La variable doit être de type alphanumérique et comporter au moins dix caractères.

Remarque :Si aucune bibliothèque en cours n'est définie pour l'unité d'exécution, la valeur *NONE est renvoyée dans cette variable.

Variable pour USRLIBL (2750) (USRLIBL)

Indique le nom de la variable CL qui doit recevoir la partie utilisateur de la liste des bibliothèques de l'unité d'exécution. Chaque nom de bibliothèque renvoyé est justifié à gauche dans une zone de 11 caractères complétée à droite par des blancs. Si la variable CL est trop faible pour la liste de bibliothèques, une exception est signalée et aucun nom de bibliothèque n'est renvoyé. Il doit s'agir d'une variable alphanumérique d'une longueur minimale de 275 caractères. Une variable alphanumérique d'une longueur minimale de 2750 caractères est requise lorsque la partie utilisateur de la liste de bibliothèques contient 250 noms de bibliothèques.

Variable CL pour ASPGRP (10) (ASPGRP)

Indique le nom de la variable CL qui doit recevoir le nom de groupe de pools de mémoire secondaire. Il doit s'agir d'une variable alphanumérique comportant au moins 10 caractères. La valeur *NONE est renvoyée s'il n'existe aucun groupe de pools de mémoire secondaire pour l'unité d'exécution.

Variable pour LOGLVL (1) (LOGLVL)

Indique le nom de la variable CL qui doit recevoir la valeur à 1 caractère (0 à 4) représentant le niveau de consignation des messages. Ce dernier est utilisé pour déterminer le type de message consignés dans l'historique du travail. Il doit s'agir d'une variable alphanumérique comportant au moins 1 caractère.

Variable pour LOGSEV (2 0) (LOGSEV)

Indique le nom de la variable CL qui reçoit la valeur à 2 chiffres (00 à 99) représentant le niveau de gravité minimal que doit avoir un message pour être consigné dans l'historique du travail. La variable doit être de type décimal et comporter deux chiffres, sans position décimale.

Variable pour LOGTYPE (10) (LOGTYPE)

Indique le nom de la variable CL qui doit recevoir la valeur spéciale de niveau du texte pour tout message consigné dans l'historique du travail. Il doit s'agir d'une variable alphanumérique comportant au moins 10 caractères.

Variable pour LOGCLPGM (10) (LOGCLPGM)

Indique le nom de la variable CL qui doit recevoir la valeur spéciale indiquant si des commandes exécutées dans un programme CL sont consignées dans l'historique du travail. Il doit s'agir d'une variable alphanumérique comportant au moins 10 caractères.

Variable pour LOGOUTPUT (10) (LOGOUTPUT)

Indique le nom de la variable CL qui reçoit la valeur spéciale indiquant la façon dont l'historique du travail doit être généré à la fin de l'exécution du travail. Il doit s'agir d'une variable alphanumérique comportant au moins 10 caractères. La valeur spéciale *JOBEND, *JOBLOGSVR ou *PND est renvoyée.

Variable pour JOBMSGQMX (2 0) (JOBMSGQMX)

Indique le nom d'une variable CL recevant la taille maximale de la file d'attente de messages du travail. Ce doit être une variable décimale à 2 chiffres, sans décimale.

Variable pour JOBMSGQFL (10) (JOBMSGQFL)

Indique l'action à entreprendre lorsque la file d'attente de messages du travail est saturée. La variable doit comporter au moins 10 caractères. La valeur spéciale *NOWRAP, *WRAP ou *PRTWRAP est retournée.

Variable pour INQMSGRPY (10) (INQMSGRPY)

Indique le nom de la variable CL qui doit recevoir la valeur spéciale indiquant le mode de gestion des messages d'interrogation utilisé par le travail. Il doit s'agir d'une variable alphanumérique comportant au moins 10 caractères.

Variable pour STSMSG (7) (STSMSG)

Indique le nom de la variable CL qui doit recevoir la valeur spéciale précisant le mode de gestion des messages d'état utilisé pour le travail. La variable doit être une variable de type alphanumérique et comporter 7 caractères au minimum.

Variable pour BRKMSG (7) (BRKMSG)

Indique le nom de la variable CL qui doit recevoir la valeur spéciale représentant le mode de gestion des messages d'interruption utilisé pour le travail. La variable doit être de type alphanumérique et comporter au moins 7 caractères.

Variable pour DEVRCYACN (13) (DEVRCYACN)

Indique le nom de la variable CL qui doit recevoir la valeur spéciale indiquant le type de rétablissement à effectuer pour le travail lorsqu'une erreur d'E/S a été détectée sur l'unité *REQUESTER utilisée pour les travaux interactifs. La variable doit être de type alphanumérique et comporter au moins 13 caractères.

Variable pour RTNCDE (5 0) (RTNCDE)

Indique le nom de la variable CL qui reçoit le code retour à cinq chiffres d'un RPG, COBOL, DFU ou d'un utilitaire de tri. Ce code est défini par ces programmes avant leur retour aux programmes appelants. Les codes retour suivants indiquent l'état du dernier programme (des types précités) dont le traitement s'est terminé au cours du travail :

0

Retour normal (RPG, COBOL, DFU ou utilitaire de tri)

1

Indicateur LR (dernier enregistrement) activé (RPG)

2

Erreur - aucun indicateur d'arrêt défini (RPG, COBOL, DFU ou utilitaire de tri)

3

L'un des indicateurs d'arrêt de RPG (H1 à H9) est activé.

La variable CL doit être une valeur décimale à cinq chiffres sans position décimale.

Variable pour ENDSTS (1) (ENDSTS)

Indique le nom de la variable CL qui doit recevoir l'état d'annulation. Cette valeur (1 caractère) indique si une annulation contrôlée est en cours d'exécution pour le travail. Le chiffre 1 indique que le système, le sous-système sur lequel est exécuté le travail ou le travail lui-même est en cours d'annulation. Le chiffre 0 indique qu'aucune annulation n'est en cours. La variable CL doit être de type alphanumérique et comporter au moins 1 caractère.

Variable pour PRTDEV (10) (PRTDEV)

Indique le nom de la variable CL qui doit recevoir le nom de l'unité imprimante. Il doit s'agir d'une variable alphanumérique comportant au moins 10 caractères.

Variable pour OUTQ (10) (OUTQ)

Indique le nom de la variable CL qui doit recevoir le nom de la file d'attente en sortie utilisée par le travail pour une sortie en spoule. Il doit s'agir d'une variable alphanumérique comportant au moins 10 caractères.

Variable pour OUTQLIB (10) (OUTQLIB)

Indique le nom de la variable CL qui doit recevoir le nom de la bibliothèque contenant la file d'attente en sortie utilisée par le travail pour une sortie en spoule. Il doit s'agir d'une variable alphanumérique comportant au moins 10 caractères.

Variable CL pour SPLFACN(10) (SPLFACN)

Indique le nom de la variable CL qui doit recevoir la valeur spéciale indiquant si les fichiers spoule sont conservés avec le travail ou détachés lors de l'arrêt du travail. Il doit s'agir d'une variable alphanumérique comportant au moins 10 caractères. La valeur spéciale *KEEP ou *DETACH est renvoyée.

Variable pour PRTTXT (30) (PRTTXT)

Indique le nom de la variable CL qui doit recevoir le texte à imprimer pour le travail. Cette variable doit être de type alphanumérique et comporter au moins 30 caractères.

Variable pour PRTKEYFMT (10) (PRTKEYFMT)

Indique le nom de la variable CL qui doit recevoir le format de la touche IMPR pour le travail. La variable doit comporter au moins 10 caractères. La valeur spéciale *NONE, *PRTBDR, *PRTHDR ou *PRTALL est renvoyée.

Variable pour SRTSEQ (10) (SRTSEQ)

Indique le nom de la variable CL recevant le nom de la table de séquence de tri utilisée pour le travail. La valeur spéciale *LANGIDUNQ, *LANGIDSHR ou *HEX peut être renvoyée dans la variable. Il doit s'agir d'une variable alphanumérique comportant au moins 10 caractères.

Variable pour SRTSEQLIB (10) (SRTSEQLIB)

Indique le nom de la variable CL recevant le nom de la bibliothèque contenant la table de séquence de tri à utiliser pour le travail. Il doit s'agir d'une variable alphanumérique comportant au moins 10 caractères. Si STRSEQ a pour valeur *LANGIDUNQ, *LANGIDSHR ou *HEX, des blancs sont renvoyés dans la variable.

Variable pour LANGID (3) (LANGID)

Indique le nom de la variable CL qui reçoit la valeur indiquant l'identificateur de langue à utiliser pour le travail. Il doit s'agir d'une variable alphanumérique d'une longueur minimale de 3 caractères.

Variable pour CNTRYID (2) (CNTRYID)

Indique le nom de la variable CL qui reçoit la valeur indiquant l'identificateur de pays ou région à utiliser pour le travail. Il doit s'agir d'une variable alphanumérique d'une longueur minimale de 2 caractères.

Variable pour CCSID (5 0) (CCSID)

Indique le nom de la variable CL qui doit recevoir l'ID de jeu de caractères codés utilisé. La variable doit être de type décimal et comporter 5 chiffres, sans position décimale.

Variable pour DFTCCSID (5 0) (DFTCCSID)

Indique le nom de la variable CL qui doit recevoir l'ID de jeu de caractères codés utilisé par défaut pour le travail. Ce doit être une variable décimale à 5 chiffres, sans décimale.

Var CL pour CHRIDCTL (10) (CHRIDCTL)

Indique le nom d'une variable CL qui reçoit la valeur utilisée comme contrôle d'identificateur de caractères pour le travail. Il doit s'agir d'une variable alphanumérique comportant au moins 10 caractères.

Variable pour DECFMT (1) (DECFMT)

Indique le nom d'une variable CL recevant le caractère utilisé pour exprimer le format décimal du travail. Il doit s'agir d'une variable alphanumérique comportant au moins 1 caractère.

Variable pour DATFMT (4) (DATFMT)

Indique le nom de la variable CL qui doit recevoir la valeur spéciale utilisée comme format de date pour le travail. La variable doit être de type alphanumérique et comporter au moins quatre caractères.

Variable pour DATSEP (1) (DATSEP)

Indique le nom de la variable CL qui doit recevoir le caractère utilisé comme séparateur de date pour le travail. Cette variable doit être de type alphanumérique et comporter au moins un caractère.

Variable pour TIMSEP (1) (TIMSEP)

Indique le nom de la variable CL qui doit recevoir le caractère utilisé comme séparateur d'heure pour le travail. Cette variable doit être de type alphanumérique et comporter au moins un caractère.

Variable pour DATE (6) (DATE)

Indique le nom de la variable CL qui reçoit la date attribuée par le système au travail au démarrage de ce dernier. La variable doit être de type alphanumérique et comporter au moins 6 caractères. (Le format de date défini pour le travail est utilisé).

Variable pour CYMDDATE (7) (CYMDDATE)

Indique le nom de la variable CL qui reçoit la date attribuée par le système au travail au démarrage de ce dernier. La variable doit être une variable de type alphanumérique et comporter 7 caractères au minimum. La date du travail est renvoyée au format SAAMMJJ, S représentant le siècle, AA l'année, MM le mois et JJ le jour.

Variable CL pour DATETIME (20) (DATETIME)

Indique le nom de la variable CL qui reçoit la date et l'heure locale du travail. Il doit s'agir d'une variable alphanumérique comportant au moins 20 caractères. La date et l'heure locale du travail sont au format AAAAMMJJHHNNSSXXXXXX où AAAA représente l'année, MM le mois, JJ le jour, HH les heures, NN les minutes, SS les secondes et XXXXXX les microsecondes.

Var CL pour DAYOFWEEK (4) (DAYOFWEEK)

Indique le nom de la variable CL qui reçoit le jour local de la semaine pour le travail. La variable doit être une variable de type alphanumérique et comporter 4 caractères au minimum. La valeur spéciale *SUN, *MON, *TUE, *WED, *THU, *FRI ou *SAT est renvoyée.

Variable CL pour TIMZON (10) (TIMZON)

Indique le nom de la variable CL qui reçoit le nom de la description du fuseau horaire en cours utilisé pour calculer l'heure locale du travail. Il doit s'agir d'une variable alphanumérique comportant au moins 10 caractères.

Var CL pour TIMZONABBR (10) (TIMZONABBR)

Indique le nom de la variable CL qui reçoit le nom (abrégé ou court) du fuseau horaire utilisé pour calculer l'heure locale du travail. Cette valeur contient le nom abrégé de l'heure standard ou de l'heure avancée selon que l'heure avancée est en cours. Il doit s'agir d'une variable alphanumérique comportant au moins 10 caractères.

Var CL pour TIMZONFULL (50) (TIMZONFULL)

Indique le nom de la variable CL qui reçoit le nom (complet ou long) du fuseau horaire utilisé pour calculer l'heure locale du travail. Cette valeur contient le nom complet de l'heure standard ou de l'heure avancée selon que l'heure avancée est en cours. Il doit s'agir d'une variable alphanumérique comportant au moins 50 caractères.

Variable pour TIMOFFSET (3 0) (TIMOFFSET)

Indique le nom de la variable CL qui reçoit le décalage en cours (en minutes) utilisé pour calculer l'heure locale du travail. Cette valeur a été value ajustée à l'heure avancée si nécessaire. Ce doit être une variable décimale à 3 chiffres, sans décimale.

Var CL pour YEAROFS (3 0) (YEAROFS)

Indique le nom de la variable CL qui reçoit le décalage de l'année pour le travail. Cette valeur donne la différence (en nombre d'années) entre l'année grégorienne en cours et l'année calendaire en cours utilisée par le travail. La plage est comprise entre -140 et 140. Ce doit être une variable décimale à 3 chiffres, sans décimale.

Variable pour ACGCDE (15) (ACGCDE)

Indique le nom de la variable CL qui doit recevoir le code comptabilité du travail. La variable doit être de type alphanumérique et comporter au moins 15 caractères.

Variable pour SWS (8) (SWS)

Indique le nom de la variable CL qui reçoit la valeur des huit indicateurs externes utilisés par le travail. Ces indicateurs sont extraits sous la forme d'une valeur de 8 caractères, où chaque caractère est égal à 0 ou à 1. La variable CL doit être de type alphanumérique et comporter au moins 8 caractères.

Variable pour RUNPTY (2 0) (RUNPTY)

Indique le nom de la variable CL qui doit recevoir la valeur (01 à 99) représentant la priorité de traitement du travail dans lequel cette commande est utilisée. Cette valeur correspond à la priorité d'exécution la plus élevée admise pour chaque unité d'exécution du travail. Au sein du travail, les unités d'exécution individuelles peuvent disposer d'une priorité d'exécution plus faible. La variable doit être de type décimal et comporter deux chiffres, sans position décimale.

Variable pour TIMESLICE (7 0) (TIMESLICE)

Indique le nom de la variable CL qui doit recevoir la valeur (0000008 à 9999999) représentant le nombre maximal de millisecondes imparti à l'exécution d'une unité d'exécution du travail lorsque du temps UC lui est accordé. La variable doit être de type décimal et comporter 7 chiffres, sans position décimale.

Variable pour PURGE (10) (PURGE)

Indique le nom de la variable CL qui doit recevoir la valeur spéciale précisant si le travail peut être transféré de la mémoire principale à la mémoire secondaire en fin de tranche de temps ou au début d'une longue attente. Pour plus d'informations sur la procédure de purge d'un travail, reportez-vous à la description de ce paramètre dans la commande CHGJOB (Modifier un travail). Il doit s'agir d'une variable alphanumérique comportant au moins 10 caractères.

Variable pour DFTWAIT (7 0) (DFTWAIT)

Indique le nom de la variable CL qui doit recevoir la valeur par défaut (0000001 à 9999999, ou -1 si *NOMAX a été défini pour cette valeur) représentant le nombre maximal de secondes imparti par le système pour l'acquisition d'une ressource par une instruction machine. La variable doit être de type décimal et comporter 7 chiffres, sans position décimale.

Variable pour SBMMSGQ (10) (SBMMSGQ)

Indique le nom de la variable CL qui doit recevoir le nom de la file d'attente de messages. Il doit s'agir d'une variable alphanumérique comportant au moins 10 caractères.

Variable pour SBMMSGQLIB (10) (SBMMSGQLIB)

Indique le nom de la variable CL qui doit recevoir le nom de la bibliothèque contenant la file d'attente de messages décrite précédemment. Il doit s'agir d'une variable alphanumérique comportant au moins 10 caractères.

Variable pour DDMCNV (5) (DDMCNV)

Indique le nom de la variable CL qui doit recevoir la valeur spéciale représentant l'action effectuée pour les conversations DDM (Gestion de fichiers éloignés) du travail. La variable doit être de type alphanumérique et comporter au moins 5 caractères.

Variable pour TSEPOOL (10) (TSEPOOL)

Indique le nom de la variable CL qui doit recevoir la valeur spéciale précisant si les travaux interactifs sont placés dans un autre pool de mémoire principale lorsque la fin de la tranche de temps est atteinte. Il doit s'agir d'une variable alphanumérique comportant au moins 10 caractères.

Variable CL THDRSCAFN (20) (THDRSCAFN)

Indique le nom de la variable CL qui reçoit la valeur spéciale permettant de déterminer si des unités secondaires présentent ou non des affinités avec le même groupe de ressources système que l'unité d'exécution initiale. La valeur spéciale *NOGROUP ou *GROUP est renvoyée dans les 10 premiers caractères. Les 10 caractères suivants contiennent la valeur spéciale indiquant le niveau d'affinité. La valeur spéciale *NORMAL ou *HIGH est renvoyée. Il doit s'agir d'une variable alphanumérique comportant au moins 20 caractères.

Variable CL RSCAFNGRP (10) (RSCAFNGRP)

Indique le nom de la variable CL qui reçoit la valeur spéciale permettant de déterminer si le travail présente des affinités avec le même groupe de processeurs et de mémoires que les autres travaux utilisant le même poste de routage ou poste de travail à démarrage anticipé. Il doit s'agir d'une variable alphanumérique comportant au moins 10 caractères. La valeur spéciale *NO ou *YES est renvoyée.

Exemples

RTVJOBA   NBR(&JOBNBR)  DATE(&JOBDATE)  DFTCCSID(&DFTCSID)

Cette commande permet d'extraire le numéro, la date et l'ID codé de jeu de caractères par défaut du travail dans lequel est exécutée cette commande. Le numéro de travail à 6 chiffres est copié dans la variable CL &JOBNBR. La date du travail est copiée dans la variable CL &JOBDATE ; les valeurs des deux variables &JOBNBR et &JOBDATE doivent comporter 6 caractères. La valeur à 5 chiffres DFTCCSID est copiée dans la variable CL &DFTCCSID ; cette valeur doit comporter 5 caractères. Le format de la date est déterminé par le contenu de la valeur système QDATFMT, qui contrôle le format de date du système.

/* Déclarer les variables */
DCL   &LIBL *CHAR 2750
DCL   &CHGLIBL *CHAR 2760
/*  sauvegarder la liste des bibliothèques   */
RTVJOBA   USRLIBL(&LIBL)
 :
/*  Modifier provisoirement la liste des bibliothèques  */
CHGLIBL   LIBL(MYLIB QGPL)
 :
/*  Construire une chaîne de commande  */
CHGVAR   &CHGLIBL  ('CHGLIBL (' *CAT &LIBL *TCAT ')')
/*  restaurer la liste des bibliothèques  */
CALL QCMDEXC (&CHGLIBL 2760)

La commande ci-dessus permet d'extraire la bibliothèque utilisateur pour qu'elle puisse être restaurée plus tard de son état provisoire, où seuls MYLIB et QGPL se trouvaient dans la bibliothèque utilisateur de la liste des bibliothèques, à son état original.

Si aucune bibliothèque ne se trouve dans la bibliothèque utilisateur de la liste des bibliothèques, des blancs sont renvoyés dans la variable. Si une bibliothèque de la liste des bibliothèques a été supprimée, la valeur '*DELETED' est placée dans la position de la variable pour ce nom.

Messages d'erreur

Messages *ESCAPE

CPF098A

Taille du paramètre USRLIBL insuffisante.

CPF9899

Erreur lors du traitement de la commande.