DMPJOB

La commande Vider travail (DMPJOB) vide les structures de données de base, ou des appels spécifiques, du travail en cours ou du travail en cours de maintenance à la suite de la commande Démarrer travail de service (STRSRVJOB). Les informations sont vidées dans un fichier imprimante spoule (QPSRVDMP) en vue de leur impression. Si l'utilisateur a indiqué SPOOL(*NO) dans la commande CHGPRTF ou OVRPRTF, la sortie n'est pas mise en spoule mais imprimée directement ; et, si l'imprimante n'est pas disponible, cette commande remplace le travail d'impression et met la sortie en spoule. Lorsque l'utilisateur indique SPOOL(*NO) dans l'une des deux commandes ci-dessus, il doit indiquer QPSRVDMP comme fichier imprimante. Le vidage comprend des informations formatées sur les programmes indiqués, ainsi que des vidages des objets du système d'exploitation, des objets système et des unités d'exécution indiqués associés au travail. The Dump Job (DMPJOB) command dumps the basic data structures, or specific calls of the current job or of the job being serviced as a result of the Start Service Job (STRSRVJOB) command. The information is dumped to a spooled printer file (QPSRVDMP) to be printed. If the user had specified SPOOL(*NO) on either the CHGPRTF command or the OVRPRTF command, then the output is not spooled but printed directly; and, if the printer is not available, then this command overrides the print job and spools the output. When the user specifies SPOOL(*NO) on one of the two commands above, the user must specify QPSRVDMP as the printer file. The dump includes formatted information about the specified programs, and dumps of specified operating system objects, system objects, and threads associated with the job.

Restrictions:

• Cette commande est livrée avec le droit public d'exclusion (*EXCLUDE) et les profils utilisateur QPGMR, QSYSOPR, QSRV et QSRVBAS sont livrés avec des droits privés pour utiliser cette commande. This command is shipped with exclude (*EXCLUDE) public authority and the QPGMR, QSYSOPR, QSRV, and QSRVBAS user profiles are shipped with private authorities to use this command.

Paramètres

Programme à clicher (PGM)

Indique le programme à vider. Vous pouvez indiquer jusqu'à 10 programmes. Specifies which program to dump. Up to 10 programs can be specified.

Valeurs uniques

*ALL

Tous les programmes de la pile d'appels sont vidés. All programs on the call stack are dumped.

*NONE

Aucun programme n'est vidé. Seules les listes des programmes appelés et activés sont vidées. No programs are dumped. Only the lists of called and activated programs are dumped.

Élément 1: Programme

Qualificatif 1: Programme

nom

Indiquez le nom du programme appelé à vider. Specify the name of the called program to dump.

Qualificatif 2: Biblio

*ALL

Indique que toutes les bibliothèques seront utilisées pour localiser le programme à vider indiqué. Si *ALL est indiqué, un niveau d'appel (élément 3) ne peut pas être indiqué. Specifies that all libraries will be used to locate the specified program to dump. If *ALL is specified, a call level (element 3) cannot be specified.

nom

Indiquez le nom de la bibliothèque à utiliser pour localiser le programme à vider. Specify the name of the library to use to locate the program to dump.

Élément 2: Niveau d'appel

*LAST

Le dernier appel (le plus récent) portant le nom de programme indiqué est vidé. The last (most recent) call with the program name specified is dumped.

*FIRST

Le premier appel (le plus ancien) portant le nom de programme indiqué est vidé. The first (oldest) call with the program name specified is dumped.

*ALL

Tous les appels portant le nom de programme indiqué sont vidés. All calls with the program name specified are dumped.

integer-number

Indiquez le niveau d'appel pour un programme comportant plusieurs appels dans la pile. Si *ALL est indiqué pour le qualificatif de nom de bibliothèque, le niveau d'appel ne peut pas être indiqué. Specify the call level for a program with multiple calls in the stack. If *ALL is specified for the library name qualifier, the call level cannot be specified.

Zones de structures du travail (JOBARA)

Indique que les zones de structure du travail du processus sont vidées. Les zones de structure du travail sont les suivantes : Specifies that the job structure areas of the process are dumped. Job structure areas consist of the following:

• Bloc de contrôle des travaux Work Control Block
• Liste de recherche de bibliothèques Library Search List
• Bibliothèque temporaire du travail Job Temporary Library
• Zone de données locale du travail Job Local Data Area
• Bloc de contrôle de spoule Spool Control Block
• File d'attente de communications de gestion des données Data Management Communications Queue
• Objet de communication de service Service Communication Object
• Modèle de définition de processus Process Definition Template
• Liste de verrous du processus Process Lock List
• File d'attente de réponses de l'interface machine (MI) Machine Interface (MI) Response Queue

*ALL

Les zones de structure du travail sont vidées. The job structure areas are dumped.

*NONE

Les zones de structure du travail ne sont pas vidées. The job structure areas are not dumped.

Objets référencés par adresse (ADROBJ)

Indique que les objets adressés à partir de la mémoire programme d'un programme vidé sont également vidés. Si *NONE est indiqué pour le paramètre Programme à clicher (PGM), aucun objet adressé n'est vidé. Specifies that objects addressed from the program storage of a program being dumped are also dumped. If *NONE is specified on the Programme à clicher (PGM) parameter, no addressed objects are dumped.

*YES

Les objets adressés sont vidés. The addressed objects are dumped.

*NO

Les objets adressés ne sont pas vidés. The addressed objects are not dumped.

Unités d'exécution du travail (JOBTHD)Job threads (JOBTHD)

Indique si la liste et les informations des unités d'exécution du travail sont vidées. Specifies whether the list and information of the threads in the job is dumped.

Les informations d'unité d'exécution sont les suivantes : Thread information consists of the following:

• For the thread running the DMPJOB command:
  • Bloc de contrôle d'unité d'exécution (TCB). Thread Control Block (TCB).
• For all the threads
  • ID d'unité d'exécution Thread ID
  • Gestionnaire d'unité d'exécution Thread handler
  • État d'exécution de l'unité d'exécution (valeur hexadécimale) Thread execution status (hexadecimal value)
  • État d'attente de l'unité d'exécution (valeur hexadécimale) Thread wait status (hexadecimal value)
  • Pile de l'unité d'exécution Thread stack

*YES

La liste et les informations des unités d'exécution sont vidées. The thread list and information is dumped.

*NO

La liste et les informations des unités d'exécution ne sont pas vidées. The thread list and information is not dumped.

*THDSTK

Seule la pile d'appels de l'unité d'exécution est vidée. Only the thread call stack is dumped.

ID d'unité d'exécution à inclure (SLTTHD)Thread ID to include (SLTTHD)

Indique une liste de vingt unités d'exécution au maximum du travail dont les informations doivent être incluses. Si *NO est indiqué pour le paramètre Unités d'exécution du travail (JOBTHD), aucune unité d'exécution n'est vidée. Specifies a list of up to twenty threads in the job whose information is to be included. If *NO is specified on the Job threads (JOBTHD) parameter, no threads are dumped.

Valeurs uniques

*ALL

Toutes les unités d'exécution sont vidées. All threads are dumped.

*SELECT

Une liste d'identificateurs d'unités d'exécution est affichée, dans laquelle l'utilisateur peut en sélectionner vingt au maximum à inclure. A list of thread identifiers is shown from which the user can select up to twenty to be included.

Autres valeurs

thread-identifier

Indiquez les identificateurs de vingt unités d'exécution au maximum dont les informations doivent être incluses. Specify the identifiers of up to twenty threads whose information is to be included.

Exemples

Exemple 1 : Vidage de programmes Example 1: Dumping Programs

DMPJOB   PGM((QGPL/UPDATE *FIRST) (PAYROLL/MASTER *ALL))
         JOBARA(*ALL)  ADROBJ(*NO)

Cette commande vide la première occurrence de QGPL/UPDATE dans la pile d'appels et toutes les occurrences de PAYROLL/MASTER. Les zones de structure du travail sont vidées. This command dumps the first occurrence of QGPL/UPDATE in the call stack and all occurrences of PAYROLL/MASTER. The job structure areas are dumped.

Exemple 2 : Vidage de la structure complète du travail Example 2: Dumping Entire Job Structure

DMPJOB

Cette commande vide la structure complète du travail. This command dumps the entire job structure.

Exemple 3 : Vidage des listes de programmes appelés et activés Example 3: Dumping Lists of Called and Activated Programs

DMPJOB   PGM(*NONE)  JOBARA(*NONE)

Cette commande vide les listes des programmes appelés et activés. This command dumps the lists of programs called and activated.

Exemple 4 : Vidage de la liste et des informations des unités d'exécution du travail Example 4: Dumping Job Thread List and Information

DMPJOB   PGM(*NONE)  JOBARA(*NONE)  JOBTHD(*YES)

Cette commande vide la liste des unités d'exécution du travail et leurs informations. This command dumps the list of the job's threads and their information.

Exemple 5 : Vidage des informations d'une seule unité d'exécution du travail Example 5: Dumping Only One Job Thread's Information

DMPJOB   PGM(*NONE)  JOBARA(*NONE)  JOBTHD(*YES)
         SLTTHD(00000001)

Cette commande vide l'identificateur d'unité d'exécution 00000001 et ses informations. This command dumps thread identifier 00000001 and its information.

Exemple 6 : Vidage de la seule pile d'appels des unités d'exécution Example 6: Dumping Only the Thread Call Stack

DMPJOB   PGM(*NONE)  JOBTHD(*THDSTK)

Cette commande vide uniquement la pile d'appels des unités d'exécution du travail. This command dumps only the job's threads call stack.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF3546

Les paramètres de programme indiqués sont introuvables. Program parameters specified were not found.

CPF3560

Le travail en cours de maintenance n'est pas en cours d'exécution. Job being serviced not running.

CPF3563

La valeur de débordement du fichier &1 dans &2 est trop grande. Overflow value for file &1 in &2 too large.

CPF3585

Le nom de bibliothèque *ALL et le niveau d'appel ne peuvent pas être utilisés ensemble. Library name *ALL and call level cannot be used together.

CPF3909

La commande de service ne sera pas traitée. Service command will not be processed.

CPF3918

La demande de service a été annulée. Service request canceled.

CPF3925

Impossible d'ouvrir le fichier &1. Cannot open file &1.

CPF3935

Le travail en cours de maintenance s'est terminé pendant le vidage. Job being serviced ended during dump.

CPF3950

Le message d'erreur &2 a été reçu pour le fichier &1. La demande a pris fin. Error message &2 received for file &1. Request ended.

CPF3951

Le fichier &1 ne peut pas être remplacé temporairement par le nom de fichier &2. File &1 cannot be overridden by file name &2.

CPF3967

Le vidage n'a pas démarré car le travail en maintenance n'est pas en cours d'exécution. Dump not started because serviced job not running.

CPF3968

Le vidage n'a pas démarré car le travail en maintenance a fini de s'exécuter. Dump not started because serviced job completed running.

CPF3969

Erreur lors de la fermeture du fichier &1. La sortie peut être incomplète. Error during close of file &1. Output may not be complete.