DSPJOB

La commande DSPJOB (Afficher l'état d'un travail) permet d'afficher, pour un travail donné, les informations suivantes :

• 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 peuvent être affichées lorsque le travail figure dans une file d'attente de travaux, dans une file d'attente en sortie ou lorsqu'il est actif. 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.

Les fonctions de table QSYS2.STACK_INFO et QSYS2.OPEN_FILES renvoient des informations similaires.

Restrictions :

1. L'émetteur de la commande doit utiliser un profil utilisateur identique à celui de l'utilisateur du travail visualisé, 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

Travail (JOB)

Indique le nom du travail dont les informations doivent être affiché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 affiché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 de la sortie spoule

DSPJOB   JOB(SMITH/PAYROLL)  OUTPUT(*PRINT)

Cette commande permet de diriger les informations concernant le travail PAYROLL soumis par l'utilisateur nommé SMITH vers la file d'attente du spoule de sortie à imprimer.

Exemple 2 : affichage de la sortie spoule de travaux

DSPJOB   OPTION(*SPLF)

Cette commande permet d'afficher la sortie spoule du travail en cours.

Exemple 3 : affichage de toutes les informations concernant le travail

DSPJOB   OPTION(*ALL)

Cette commande permet d'afficher 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.