Analyze Command Performance (ANZCMDPFR)

The Analyze Command Performance (ANZCMDPFR) command measures the performance of a single CL command or a set of CL commands. For a single command, performance information is collected from when the command starts until the command ends. For a set of commands, performance information is collected from the start of the first command in the set until the last command in the set ends.

Parameters

Keyword Description Choices Notes
CMD Command Command string Optional
CMDFILE Command file Qualified object name Optional
Qualifier 1: Command file Name
Qualifier 2: Library Name, *LIBL, *CURLIB
CMDMBR Command member Name, *FIRST Optional
OUTPUT Output *MSG, *OUTFILE Optional
OUTFILE File to receive output Qualified object name Optional
Qualifier 1: File to receive output Name
Qualifier 2: Library Name, *LIBL, *CURLIB
OUTMBR Output member options Element list Optional
Element 1: Member to receive output Name, *FIRST
Element 2: Replace or add records *REPLACE, *ADD

Command (CMD)

Specifies a CL command whose performance is to be analyzed.

Note: A value must be specified for either this parameter or the Command file (CMDFILE) parameter. You cannot specify a value for both the CMD and CMDFILE parameters.

command-string
Specify a syntactically-correct CL command string.

Command file (CMDFILE)

Specifies the database source file that contains the source member that contains the CL commands whose performance is to be analyzed.

Note: A value must be specified for either this parameter or the Command (CMD) parameter. You cannot specify a value for both the CMD and CMDFILE parameters.

Qualifier 1: Command file

name
Specify the name of the file to be used.

Qualifier 2: Library

*LIBL
All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB
The current library for the thread is used to locate the file. If no current library entry exists in the library list, the QGPL library is used.
name
Specify the name of the library where the file is located.

Command member (CMDMBR)

Specifies the database source file member that contains the CL commands whose performance is to be analyzed.

*FIRST
The first member of the database source file specified for the Command file (CMDFILE) parameter contains the CL commands to be run.
name
Specify the name of the file member.

Output (OUTPUT)

Specifies where the output from the command is sent.

*MSG
The output is displayed in a message (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).
*OUTFILE
The output is directed to the database file specified for the File to receive output (OUTFILE) parameter.

File to receive output (OUTFILE)

Specifies the database file to which the output of the command is directed. If the file does not exist, this command creates a database file in the specified library.

Note: If a new file is created, the text describing that file is "Output file for ANZCMDPFR" and the public authority is the same as the create authority specified for the library in which the file is created. Use the Display Library Description (DSPLIBD) command to show the library's create authority. The database format (QAPYANZR) of the output file is the same as that used in the IBM-supplied database file QAPYANZC.

Qualifier 1: File to receive output

name
Specify the name of the file to which the output of the command is directed.

Qualifier 2: Library

*LIBL
All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB
The current library for the job is searched to find the file. If no library is specified as the current library for the job, the QGPL library is used.
name
Specify the name of the library to be searched to find the file.

Output member options (OUTMBR)

Specifies the name of the database file member that receives the output of the command.

Element 1: Member to receive output

*FIRST
The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified for the File to receive output (OUTFILE) parameter. If the member already exists, you have the option to add new records to the end of the existing member or clear the member and then add the new records.
name
Specify the name of the file member that receives the output. If it does not exist, the system creates it.

Element 2: Replace or add records

*REPLACE
The system clears the existing member and adds the new records.
*ADD
The system adds the new records to the end of the existing records.

Examples

Example 1: Analyzing Performance of a Single Command

ANZCMDPFR   CMD(CRTLIB LIB(TST))

This command analyzes the performance of the CRTLIB LIB(TST) command. The results are sent as messages.

Example 2: Analyzing a Command and Writing Results to a File

ANZCMDPFR   CMD(DSPLIB LIB(QGPL))  OUTPUT(*OUTFILE)
            OUTFILE(MYLIB/MYFILE)

This command analyzes the performance of the DSPLIB LIB(QGPL) command. The results are written to the first member of database file MYFILE in library MYLIB.

Example 3: Analyzing Performance of a Set of CL Commands

ANZCMDPFR   CMDFILE(MYLIB/MYCMDFILE)
            CMDMBR(CMDS)

This command analyzes the performance of the set of CL commands located in the source member named CMDS in file MYCMDFILE in library MYLIB. The results are sent as messages.

Error messages

*ESCAPE Messages

CPF4104
User not authorized to operation on file &2 in &3, member, device, or program device &4.
CPF4128
Not able to allocate objects needed for file &2 in library &3 member or program device &4.
CPF9810
Library &1 not found.
CPF9812
File &1 in library &2 not found.