Print Lock Report (PRTLCKRPT)

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).

Parameters

Keyword	Description	Choices	Notes
MBR	Data base file member	Name	Required, Positional 1
LIB	Data base file library	Name, QPFRDATA	Optional, Positional 2
TITLE	Report title	Character value, MBRTXT, BLANK	Optional, Positional 3
RPTTYPE	Report type	SUM, TOD, RQS, HLD, OBJ, ALL	Optional
FIRST	First run for current data	YES, NO	Optional
PERIOD	Time period for report	Element list	Optional
	Element 1:	Element list
	Element 1: Starting time	Time, *FIRST
	Element 2:	Element list
	Element 1: Ending time	Time, *LAST
MINWAIT	Minimum wait time	0-30000, 500	Optional
JOB	Job name	Name, PRTLCKRPT, *MBR	Optional
JOBD	Job description	Single values: NONE Other values: Qualified object name*	Optional
	Qualifier 1: Job description	Name, QPFRJOBD
	Qualifier 2: Library	Name, LIBL, CURLIB

Top

Report title (TITLE)

Specifies the title for the report that is created.

*MBRTXT: The text of the database member, which contains the performance data, is the report title.
*BLANK: No title is specified.
'report-title': Specify a title of up to 50 characters, enclosed in apostrophes.

Report type (RPTTYPE)

Specifies the type of reports that are produced.

*SUM: The report includes only a summary of the seize/lock data.
*TOD: The report includes detail sorted by time of day, followed by a summary.
*HLD: The report includes detail sorted by name of the holding job and time of day, followed by a summary.
*RQS: The report includes detail sorted by name of the requesting job and time of day, followed by a summary.
*OBJ: The report includes detail sorted by name of the object and time of day, followed by a summary.
*ALL: Four reports are produced. The reports include *TOD, *HLD, *RQS, and *OBJ, followed by a summary.

First run for current data (FIRST)

Specifies whether the Print Lock Report (PRTLCKRPT) command was run since the last set of resource management trace data was collected.

*YES: 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: The Print Lock Report (PRTLCKRPT) command is run for this set of data. The preprocessing pass is not done.

Time period for report (PERIOD)

Specifies the period of time on which to report.

Starting Time

Records created before this time are not included in either the detail or summary listing.

*FIRST

The report includes records starting from the first record.

start-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.

The time can be specified with or without a time separator:

Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds.
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.

Ending Time

Records created after this time are not included in either the detail or summary listing.

*LAST: The report includes records through the last record.
end-time: Specify the time of the last record to include in the report. Use the same time format as used for the starting time.

Minimum wait time (MINWAIT)

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: 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.
number-of-milliseconds: Specify the minimum wait time, ranging from 0 through 30,000 milliseconds (from no minimum up to 30 seconds).

Job name (JOB)

Specifies the job name to be used if submitting the job for batch processing.

Any value for this parameter is ignored if *NONE is specified for the Job description prompt (JOBD parameter).

Note: If *NONE is specified for the Job description prompt (JOBD parameter), job processing is performed interactively.

The possible job name values are:

PRTLCKRPT: The command name is used for the job name.
*MBR: The name selected for the performance data member in the Member prompt (MBR parameter) is used.
job-name: Specify the name to be used for any and all batch jobs.

Batch job description (JOBD)

Specifies the job description used to submit the job for batch processing.

The possible job description values are:

QPFRJOBD: The IBM-supplied job description, QPFRJOBD, is used.
job-description-name: Specify the name of an alternate job description.
*NONE: 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.

The possible library values are:

*LIBL: All libraries in the job's library list are searched until the first match is found.
*CURLIB: 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.
library-name: Specify the library in which the job description is located.

Examples

Example 1: Producing a Summary Report

PRTLCKRPT   MBR(RESTRC)

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.

Example 2: Including a Detail Listing Sorted By Time

PRTLCKRPT   MBR(RESTRC)  RPTTYPE(*TOD)

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.