Commande CL IBM i (AS/400)

PRTLCKRPT

Imprimer rapport de verrous

Print Lock Report

En bref

PRTLCKRPT se lit PRT (Imprimer) + LCKRPT. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

PRTLCKRPT MBR(…)

Paramètres

MBR Membre du fichier de base de données Data base file member obligatoire
LIB Bibliothèque du fichier de base de données Data base file library
TITLE Titre du rapport Report title
RPTTYPE Type de rapport Report type
FIRST Première exécution pour les données en cours First run for current data
PERIOD Période du rapport Time period for report
MINWAIT Temps d'attente minimal Minimum wait time
JOB Nom du travail Job name
JOBD Description de travail Job description

Astuce : dans une session 5250, tapez PRTLCKRPT 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 QPFR)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande Imprimer le rapport de verrouillage (PRTLCKRPT) produit un rapport qui présente les conflits de verrouillage et de saisie survenant pendant le fonctionnement du système. Le rapport est produit à partir des données de trace de gestion des ressources collectées par la commande Démarrer la trace de performances (STRPFRTRC) et formatées par la commande Imprimer le rapport de transactions (PRTTNSRPT). Ces informations permettent de déterminer si des travaux sont retardés pendant leur traitement en raison de demandes de verrouillage non satisfaites ou de saisies internes de la machine (ces situations sont également appelées attentes). The Print Lock Report (PRTLCKRPT) command produces a report that shows lock and seize conflicts that occur during system operation. The report is produced from the resource management trace data collected by the Start Performance Trace (STRPFRTRC) command and formatted by the Print Transaction Report (PRTTNSRPT) command. This information can be used to determine if jobs are delayed during processing because of unsatisfied lock requests or internal machine seizes (these conditions are also known as waits).

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
MBR	Membre du fichier de base de donnéesData base file member	Nom	Obligatoire, positionnel 1
LIB	Bibliothèque du fichier de base de donnéesData base file library	Nom, QPFRDATA	Facultatif, positionnel 2
TITLE	Titre du rapportReport title	Valeur caractère, MBRTXT, BLANK	Facultatif, positionnel 3
RPTTYPE	Type de rapportReport type	SUM, TOD, RQS, HLD, OBJ, ALL	Facultatif
FIRST	Première exécution pour les données en coursFirst run for current data	YES, NO	Facultatif
PERIOD	Période du rapportTime period for report	Liste d'éléments	Facultatif
	Élément 1:	Liste d'éléments
	Élément 1: Starting time	Heure, *FIRST
	Élément 2:	Liste d'éléments
	Élément 1: Ending time	Heure, *LAST
MINWAIT	Temps d'attente minimalMinimum wait time	0-30000, 500	Facultatif
JOB	Nom du travailJob name	Nom, PRTLCKRPT, *MBR	Facultatif
JOBD	Description de travailJob description	Valeurs uniques: NONE Autres valeurs: Nom d'objet qualifié*	Facultatif
	Qualificatif 1 : Description de travailQualificatif 1: Job description	Nom, QPFRJOBD
	Qualificatif 2: BibliothèqueQualificatif 2: Library	Nom, LIBL, CURLIB

Membre du fichier de base de données (MBR)Data base file member (MBR)

Indique le membre du fichier QAPMDMPT dans lequel les données de trace de gestion des ressources sont collectées par la commande Démarrer la trace de performances (STRPFRTRC). Specifies the member in file QAPMDMPT in which the resource management trace data is collected by the Start Performance Trace (STRPFRTRC) command.

Ce paramètre est obligatoire. This is a required parameter.

Bibliothèque du fichier de base de données (LIB)Data base file library (LIB)

Indique la bibliothèque dans laquelle les données sont sauvegardées. Specifies the library where the data is saved.

QPFRDATA: La bibliothèque de données de performances fournie par IBM, QPFRDATA, est utilisée. The IBM-supplied performance data library, QPFRDATA, is used.
nom: Indiquez le nom de la bibliothèque dans laquelle les données sont collectées. Specify the name of the library where the data is collected.

Titre du rapport (TITLE)Report title (TITLE)

Indique le titre du rapport créé. Specifies the title for the report that is created.

*MBRTXT: Le texte du membre de base de données, qui contient les données de performances, constitue le titre du rapport. The text of the database member, which contains the performance data, is the report title.
*BLANK: Aucun titre n'est indiqué. No title is specified.
valeur-caractère: Indiquez un titre de 50 caractères maximum, entre apostrophes. Specify a title of up to 50 characters, enclosed in apostrophes.

Type de rapport (RPTTYPE)Report type (RPTTYPE)

Indique le type de rapports produits. Specifies the type of reports that are produced.

*SUM: Le rapport ne comprend qu'un récapitulatif des données de saisie/verrouillage. The report includes only a summary of the seize/lock data.
*TOD: Le rapport comprend le détail trié par heure de la journée, suivi d'un récapitulatif. The report includes detail sorted by time of day, followed by a summary.
*HLD: Le rapport comprend le détail trié par nom du travail détenteur et par heure de la journée, suivi d'un récapitulatif. The report includes detail sorted by name of the holding job and time of day, followed by a summary.
*RQS: Le rapport comprend le détail trié par nom du travail demandeur et par heure de la journée, suivi d'un récapitulatif. The report includes detail sorted by name of the requesting job and time of day, followed by a summary.
*OBJ: Le rapport comprend le détail trié par nom d'objet et par heure de la journée, suivi d'un récapitulatif. The report includes detail sorted by name of the object and time of day, followed by a summary.
*ALL: Quatre rapports sont produits. Les rapports comprennent *TOD, *HLD, *RQS et *OBJ, suivis d'un récapitulatif. Four reports are produced. The reports include *TOD, *HLD, *RQS, and *OBJ, followed by a summary.

Première exécution pour les données en cours (FIRST)First run for current data (FIRST)

Indique si la commande Imprimer le rapport de verrouillage (PRTLCKRPT) a été exécutée depuis la collecte du dernier jeu de données de trace de gestion des ressources. Specifies whether the Print Lock Report (PRTLCKRPT) command was run since the last set of resource management trace data was collected.

*YES: C'est la première fois que la commande Imprimer le rapport de verrouillage (PRTLCKRPT) est exécutée pour ces données. Les données sont reformatées et écrites dans le membre QAPTLCKD du fichier QAPTLCKD. Le rapport est créé à partir de ces données prétraitées. This is the first time the Print Lock Report (PRTLCKRPT) command was run for the data. The data is reformatted and written to member QAPTLCKD of file QAPTLCKD. The report is created from this preprocessed data.
*NO: La commande Imprimer le rapport de verrouillage (PRTLCKRPT) est exécutée pour ce jeu de données. La passe de prétraitement n'est pas effectuée. The Print Lock Report (PRTLCKRPT) command is run for this set of data. The preprocessing pass is not done.

Période du rapport (PERIOD)Time period for report (PERIOD)

Indique la période sur laquelle porte le rapport. Specifies the period of time on which to report.

Élément 1: Starting time

*FIRST

Le rapport inclut les enregistrements à partir du premier enregistrement. The report includes records starting from the first record.

time

Specify the time of the first data record to include in the report. The time is specified as 4 or 6 digits (hhmm or hhmmss), where hh is the hour, mm is the minute, and ss is the second.

L'heure peut être indiquée avec ou sans séparateur d'heure : The time can be specified with or without a time separator:

Sans séparateur d'heure, indiquez une chaîne de 4 ou 6 chiffres (hhmm ou hhmmss), où hh = heures, mm = minutes et ss = secondes. Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds.
Avec un séparateur d'heure, indiquez une chaîne de 5 ou 8 caractères où le séparateur d'heure défini pour votre travail sépare les heures, les minutes et les secondes. Si vous entrez cette commande depuis la ligne de commande, la chaîne doit être placée entre apostrophes. Si un séparateur d'heure autre que celui défini pour votre travail est utilisé, cette commande échoue. With a time separator, specify a string of 5 or 8 digits where the time separator specified for your job is used to separate the hours, minutes, and seconds. If you enter this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.

Élément 2: Ending time

Élément 1: Ending time

Les enregistrements créés après cette heure ne sont inclus ni dans la liste détaillée ni dans la liste récapitulative. Records created after this time are not included in either the detail or summary listing.

*LAST: Le rapport inclut les enregistrements jusqu'au dernier enregistrement. The report includes records through the last record.
time: Indiquez l'heure du dernier enregistrement à inclure dans le rapport. Utilisez le même format d'heure que pour l'heure de début. Specify the time of the last record to include in the report. Use the same time format as used for the starting time.

Temps d'attente minimal (MINWAIT)Minimum wait time (MINWAIT)

Indique le temps d'attente minimal d'un enregistrement de saisie/verrouillage inclus dans le rapport. Les enregistrements dont les temps d'attente sont plus courts ne sont inclus ni dans la liste détaillée ni dans la liste récapitulative. Specifies the minimum wait time for a seize/lock record that is included in the report. Records with shorter wait times are not included in either the detail or summary listing.

500: La valeur par défaut de 500 millisecondes (une demi-seconde) est utilisée. Les enregistrements dont les temps d'attente sont plus courts présentent peu d'intérêt pour déterminer l'origine des problèmes de performances. The default value of 500 milliseconds (half a second) is used. Records with shorter wait times are of little interest when determining the source of performance problems.
0-30000: Indiquez le temps d'attente minimal, en millisecondes. Le temps d'attente maximal est de 30 secondes. Specify the minimum wait time, in milliseconds. The maximum wait time is 30 seconds.

Nom du travail (JOB)Job name (JOB)

Indique le nom du travail à utiliser si le travail est soumis pour un traitement par lots. Specifies the job name to be used if submitting the job for batch processing.

Toute valeur de ce paramètre est ignorée si *NONE est indiqué pour le paramètre Description de travail (JOBD). Any value for this parameter is ignored if *NONE is specified for the Job description (JOBD) parameter.

Remarque :Si JOBD(*NONE) est indiqué, le traitement du travail est effectué en mode interactif. Remarque :If JOBD(*NONE) is specified, job processing is performed interactively.

PRTLCKRPT: Le nom de la commande est utilisé comme nom du travail. The command name is used for the job name.
*MBR: Le nom sélectionné pour le membre de données de performance dans le paramètre Membre (MBR) est utilisé. The name selected for the performance data member in the Member (MBR) parameter is used.
nom: Indiquez le nom à utiliser pour tous les travaux par lots. Specify the name to be used for any and all batch jobs.

Description de travail (JOBD)Job description (JOBD)

Indique la description de travail utilisée pour soumettre le travail à un traitement par lots. Specifies the job description used to submit the job for batch processing.

Valeurs uniques

*NONE: Aucun travail par lots n'est soumis ; le traitement se poursuit en mode interactif pendant que l'utilisateur attend. La station de travail de l'utilisateur n'est pas disponible pour un autre usage pendant ce temps, ce qui peut être notable pour les travaux longs. A batch job is not submitted; processing continues interactively while the user waits. The user's workstation is not available for other use during this time, which could be significant for long jobs.

Qualificatif 1 : Description de travail Qualificatif 1: Job description

QPFRJOBD: La description de travail fournie par IBM, QPFRJOBD, est utilisée. The IBM-supplied job description, QPFRJOBD, is used.
nom: Indiquez le nom de la description de travail à utiliser. Specify the name of the job description to be used.

Qualificatif 2 : Bibliothèque Qualificatif 2: Library

*LIBL: Toutes les bibliothèques de la liste de bibliothèques du travail sont parcourues jusqu'à la première correspondance. All libraries in the job's library list are searched until the first match is found.
*CURLIB: La bibliothèque en cours du travail est utilisée pour localiser la description de travail. Si aucune entrée de bibliothèque en cours n'existe dans la liste de bibliothèques, QGPL est utilisée. The current library for the job is used to locate the job description. If no current library entry exists in the library list, QGPL is used.
nom: Indiquez la bibliothèque dans laquelle se trouve la description de travail. Specify the library in which the job description is located.

Exemples

Exemple 1 : Production d'un rapport récapitulatif Example 1: Producing a Summary Report

PRTLCKRPT   MBR(RESTRC)

Cette commande produit un rapport récapitulatif à partir des données de performances sauvegardées dans le membre RESTRC de QPFRDATA/QAPMDMPT lors d'une exécution précédente des commandes Démarrer la trace de performances (STRPFRTRC) et Imprimer le rapport de transactions (PRTTNSRPT). This command produces a summary report from the performance data saved in member RESTRC of QPFRDATA/QAPMDMPT from a prior run of the Start Performance Trace (STRPFRTRC) and Print Transaction Report (PRTTNSRPT) commands.

Exemple 2 : Inclusion d'une liste détaillée triée par heure Example 2: Including a Detail Listing Sorted By Time

PRTLCKRPT   MBR(RESTRC)  RPTTYPE(*TOD)

Cette commande produit le même rapport que l'exemple précédent, à ceci près qu'il inclut une liste détaillée triée selon l'heure à laquelle les conflits de verrouillage/saisie se sont produits. This command produces the same report as the previous example, except that it includes a detail listing sorted by the time in which the lock/seize conflicts occurred.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

PFR5511: Impossible d'accéder aux données de trace de gestion des ressources. Cannot access resource management trace data.
PFR5512: Impossible d'accéder aux données traitées de conflits de saisie ou de verrouillage. Cannot access processed seize or lock conflict data.