WRKJOB
Gérer un travail
En bref
La commande WRKJOB (Gérer un travail) permet de gérer ou de modifier les informations suivantes relatives à un travail utilisateur :
WRKJOB se lit WRK
(Gérer) + JOB.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
WRKJOB
Paramètres
-
JOBTravail -
OUTPUTSortie -
OPTIONOption -
SLTTHDID d'unité d'exécution à inclure Thread ID to include -
DUPJOBOPTOption pour travaux dupliqués
Astuce : dans une session 5250, tapez WRKJOB puis F4 pour
l'invite de saisie, et F1 sur un paramètre pour son aide.
Aide IBM i de la commande
Texte du F1, IBM i 7.5 en français
(bibliothèque QSYS)
Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Sous conditions
La commande WRKJOB (Gérer un travail) permet de gérer ou de modifier les informations suivantes relatives à un travail utilisateur :
- Les attributs de l'état du travail
- Les attributs de définition du travail
- Les attributs d'exécution du travail
- Les informations de fichier spoule
- Les informations sur l'historique du travail
- Les informations sur la liste d'appel des programmes
- Les informations sur le verrouillage du travail
- Les informations sur la liste des bibliothèques
- Les informations sur les fichiers ouverts
- Les informations sur les substitutions de fichiers
- L'état du contrôle de validation
- L'état des communications
- Les informations sur les groupes d'activation
- Les informations sur les exclusions mutuelles
- Les informations sur les unités d'exécution
- Les informations sur les attributs de médiathèque
- Variables d'environnement
Les informations suivantes peuvent uniquement être affichées lorsque le travail est actif : attributs d'exécution du travail ; informations sur la liste d'appel des programmes, sur les verrouillages du travail, sur la liste des bibliothèques, sur l'historique du travail, sur les fichiers ouverts et sur les substitutions de fichiers ; état du contrôle de validation ; état des communications ; informations sur le groupe d'activation, sur les exclusions mutuelles et sur les unités d'exécution.
Les informations suivantes peuvent être affichées que le travail soit actif dans le système, ou qu'il se trouve dans la file d'attente de travaux ou en sortie : attributs de l'état du travail, attributs de définition du travail et informations sur les fichiers spoule. Toutefois, le travail n'est pas considéré comme étant dans le système tant que la totalité de ses données en entrée n'est pas lue. Un poste est alors placé dans la file d'attente de travaux.
Restrictions :
- L'émetteur de la commande doit utiliser un profil utilisateur identique à celui de l'utilisateur du travail en cours, ou un profil utilisateur disposant du droit spécial d'exploitation des travaux (*JOBCTL).
L'identité de l'utilisateur du travail correspond au nom du profil utilisateur permettant d'identifier un travail par rapport aux autres travaux. Pour plus d'informations sur l'identité de l'utilisateur du travail, reportez-vous au manuel Ensemble de rubriques Gestion des travaux de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.
- Les informations sur les groupes d'activation pour un travail ne peuvent pas être affichées si le travail est suspendu lors de l'exécution de cette commande.
- Si OPTION(*FILOVR) ou OPTION (*ALL) est indiqué, elle n'aboutira pas dans un travail à unités d'exécution multiples.
- Vous devez disposer du droit spécial *SERVICE pour afficher les variables d'environnement d'un travail qui s'exécute sous un profil utilisateur différent.
Paramètres
| Mot-clé | Description | Valeurs possibles | Remarques |
|---|---|---|---|
| JOB | Travail | Valeurs uniques: * Autres valeurs: Nom de travail qualifié |
Facultatif, positionnel 1 |
| Qualificatif 1: Travail | Nom | ||
| Qualificatif 2: Utilisat | Nom | ||
| Qualificatif 3: Numéro | 000000-999999 | ||
| OUTPUT | Sortie | Facultatif, positionnel 2 | |
| OPTION | Option | *SELECT, *STSA, *DFNA, *RUNA, *SPLF, *JOBLOG, *PGMSTK, *JOBLCK, *LIBL, *OPNF, *FILOVR, *CMTCTL, *CMNSTS, *ACTGRP, *MUTEX, *THREAD, *MLBA, *ENVVAR, *ALL | Facultatif |
| SLTTHD | ID d'unité d'exécution à inclureThread ID to include | Valeurs uniques: *ALL, *SELECT Autres valeurs (jusqu'à 20 répétitions): Valeur caractère, *INITIAL, *CURRENT |
Facultatif |
| DUPJOBOPT | Option pour travaux dupliqués | *SELECT, *MSG | Facultatif |
Travail (JOB)
Indique le nom du travail utilisateur dont les informations doivent être gérées.
Valeurs uniques
- *
- Le travail dont les informations s'affichent est le travail à partir duquel la commande d'affichage est lancée.
Qualificatif 1 : Travail
- nom
- Indiquez le nom du travail à afficher. Si aucun qualifiant n'est précisé, la recherche s'arrêtera sur le premier travail correspondant au nom indiqué. Si plusieurs noms identiques sont rencontrés, une liste de messages contenant chacun des noms qualifiés sera affichée.
Qualificatif 2 : Utilisat
- nom
- Indiquez le nom permettant d'identifier le profil utilisateur contrôlant le travail.
Qualificatif 3 : Numéro
- 000000-999999
- Indiquez le numéro de travail attribué par le système.
Sortie (OUTPUT)
Indique si la sortie générée par la commande doit être affichée sur le poste de travail demandeur, ou imprimée avec la sortie spoule du travail.
- *
- La sortie est affichée pour les travaux interactifs ou imprimée avec la sortie spoule de travaux dans le cas des travaux non interactifs.
- Le résultat est placé dans un fichier spoule de la file d'attente en sortie du travail.
Option (OPTION)
Indique les informations gérées.
- *SELECT
- Le menu est affiché et toutes les options et touches de fonction sont disponibles.
- *STSA
- Les caractéristiques d'identification et l'état du travail sont affichés.
- *DFNA
- Les attributs de définition de la description associée au travail sont affichés.
- *RUNA
- Les attributs d'exécution du travail sont affichés.
- *SPLF
- Les fichiers spoule appartenant au travail sont affichés. Les fichiers de sortie spoule se trouvant dans les files d'attente en sortie de l'espace de nom de la bibliothèque de l'unité d'exécution lançant cette commande sont les seuls à être affichés.
- *JOBLOG
- Les commandes traitées par le travail et les messages résultant de l'exécution de ces commandes sont affichés.
- *PGMSTK
- Toutes les informations de tous les programmes de la liste d'appel des programmes sont affichées.
- *JOBLCK
- Les verrouillages de tous les objets externes tenus par le travail, y compris les verrouillages tenus et ceux en attente, sont affichés.
- *LIBL
- La liste des bibliothèques de l'unité d'exécution est affichée si le travail spécifié pour le paramètre JOB (Travail) est le travail à partir duquel la commande est lancée. La liste des bibliothèques de l'unité d'exécution d'origine est affichée pour les autres travaux.
- *OPNF
- Les fichiers ouverts pour le travail, ainsi que l'état des fichiers système et utilisateur sont affichés.
- *FILOVR
- Les substitutions de fichier à n'importe quel niveau d'appel interactif pour le travail sont affichées.
- *CMTCTL
- L'état du contrôle de validation du travail est affiché.
- *CMNSTS
- L'état des communications pour le travail est affiché.
- *ACTGRP
- Les groupes d'activation associés au travail sont affichés.
- *MUTEX
- Les informations d'exclusion mutuelle associées à l'unité d'exécution initiale du travail sont affichées.
- *THREAD
- Les informations relatives aux unités d'exécution du travail sont affichées.
- *MLBA
- Les informations relatives aux attributs de médiathèque du travail sont affichées.
- *ENVVAR
- Les variables d'environnement du travail sont affichées.
- *ALL
- Toutes les options sont affichées.
ID d'unité d'exécution à inclure (SLTTHD)Thread ID to include (SLTTHD)
Affiche une liste des identificateurs d'unité d'exécution pour lesquels les informations doivent être incluses.
Valeurs uniques
- *ALL
- Toutes les unités d'exécution du travail spécifié sont incluses.
- *SELECT
- Une liste des identificateurs d'unité d'exécution et l'utilisateur peut y sélectionner jusqu'à vingt unités à inclure. Cette valeur n'est valide que si la commande est exécutée dans un travail interactif.
Autres valeurs (jusqu'à 20 répétitions)
- *INITIAL
- L'unité d'exécution initiale du travail spécifié est incluse.
- *CURRENT
- L'unité d'exécution qui exécute la commande est incluse. Cette valeur n'est valide que si le travail spécifié correspond à celui qui exécute la commande.
- identificateur-unité-exécution
- Indiquez jusqu'à vingt identificateurs d'unités d'exécution pour lesquels les informations doivent être incluses. Il s'agit de l'ID unité d'exécution tel qu'affiché par la commande WRKJOB (Gérer un travail).
Option pour travaux dupliqués (DUPJOBOPT)
Indique l'action effectuée lorsque des travaux en double sont détectés par cette commande.
- *SELECT
- L'écran de sélection s'affiche lorsque des travaux en double sont détectés lors d'une session interactive. Sinon, un message est émis.
- *MSG
- Un message est émis lorsque des travaux dupliqués sont détectés.
Exemples
Exemple 1 : impression des informations concernant le travail
WRKJOB JOB(SMITH/PAYROLL) OUTPUT(*PRINT)
Cette commande permet d'imprimer les informations concernant le travail PAYROLL soumis par l'utilisateur SMITH à la file d'attente de la sortie spoule du travail.
Exemple 2 : gestion de la sortie spoule du travail en cours
WRKJOB OPTION(*SPLF)
Cette commande permet à l'utilisateur de gérer la sortie spoule du travail en cours.
Exemple 3 : gestion de toutes les informations concernant le travail en cours
WRKJOB OPTION(*ALL)
Cette commande permet à l'utilisateur de gérer toutes les informations concernant le travail en cours.
Messages d'erreur
Messages *ESCAPE
- CPF0941
- Le travail &3/&2/&1 ne se trouve plus dans le système.
- CPF1069
- Fin des noms dupliqués.
- CPF1070
- Travail &3/&2/&1 non trouvé.
- CPF1071
- Vous n'êtes pas autorisé à utiliser le travail &3/&2/&1.
- CPF2443
- Historique du travail non affiché ni listé car travail terminé.
- CPF3330
- Ressource nécessaire non disponible.
- CPF3336
- Le travail &5/&4/&3 n'est plus dans le système.
- CPF9845
- Erreur lors de l'ouverture du fichier &1.
- CPF9846
- Erreur lors du traitement du fichier &1 de &2.
- CPF9847
- Erreur lors de la fermeture du fichier &1 de bibliothèque &2.
- CPF9850
- Substitution non admise pour fichier imprimante &1.
- CPF9851
- Valeur de ligne fin de page trop faible pour fichier &1 dans &2.
- CPF9871
- Erreur lors du traitement.
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.