Aller au contenu

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

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 :

  1. 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/.

  2. 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.
  3. Si OPTION(*FILOVR) ou OPTION (*ALL) est indiqué, elle n'aboutira pas dans un travail à unités d'exécution multiples.
  4. 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 *, *PRINT 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.
*PRINT
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.