The following command extracts entries from the VPE trace file with options to limit the information extracted. The command can also extract DIAL trace entries written to the VPE trace file (either with the VPE trace entries or alone). See the section on FUNC DIL that follows. The DIAL trace is described in the next section.
In a VSE environment, @I$TRACE PRINT command can only be issued in batch (even if the trace was run online).
This command has the following format:
[USER uuu ]
[TIME hhmm[/hhmm] ]
[DATE mmdd ]
@I$TRACE PRINT [FUNC aaa[/aaa]... ]
[BLOCK nnnnn[/nnnnn] ]
[NAME output-name ]
[FILE file-name ]
[STATISTICS ]
@I$TRACE PRINT command alone extracts all entries on the VPE trace file.
Limits the selection of entries in the trace file to those generated by the specified user. The value of uuu is the three‑character short user ID of the user. If other users wrote to the trace file, this option lets you extract only your own entries. For example, the following selects entries for user GBS only.
@I$TRACE PRINT USER GBS
Limits the selection of entries made in the trace file to those generated during the specified time range. The value of hhmm is the beginning of the time range. The range ends with another hhmm, if specified, or when the end of the trace file is reached. Time is in 24‑hour format.
For example, the following selects all records entered in the trace file from 12:01 p.m. until the end of the trace file is reached:
@I$TRACE PRINT TIME 1201
The following, however, selects all records entered in the trace file between 1:15 am and 1:24 p.m.
@I$TRACE PRINT TIME 0115/1324
Limits the selection to entries made in the trace file on a specific day. The value of mmdd is a numeric value that specifies the date. If your CICS region or partition is not recycled daily (so that the trace file is not re‑initialized daily), this option ensures that you select the entries for the specified day only. For example, the following selects all entries made in the trace file on April 27.
@I$TRACE PRINT DATE 0427
Limits the selection to entries in the trace file resulting from service aaa. You can specify up to six of the following services. If you specify no function, all are selected.
For example, the following selects only VPE services.
@I$TRACE PRINT FUNC VPE
The following selects SCF, PSS, and PMS services.
@I$TRACE PRINT FUNC SCF/PSS/PMS
The following selects all functions.
@I$TRACE PRINT
You can also limit selection to all entries except those resulting from
specified services. Use a not sign (¬) prefix.
For example, the following selects all entries except those from VPE.
@I$TRACE PRINT FUNC ¬VPE
The following selects all entries made in the trace file except those from SCF or PSS.
@I$TRACE PRINT FUNC ¬SCF/¬PSS
Limits the selection of entries in the trace file to those in the specified range of data blocks. The value of nnnnn specifies the starting block from which entries are selected. The range ends with another nnnnn or when the end of the trace file is reached. Leading zeros are required. Data blocks on the trace file are numbered sequentially. You can find the block numbers on the Trace Listing. For example, the following selects all entries on the Trace file from block 100 to the end of the trace file.
@I$TRACE PRINT BLOCK 00100
The following selects all entries from block 5 to block 96.
@I$TRACE PRINT BLOCK 00005/00096
Changes the name of the output member in the online output library. The default name is OUTTRACE. The output‑name can be any alphanumeric name up to eight characters.
For example, the following defines MYOUTPUT as the name of the output member.
@I$TRACE PRINT NAME MYOUTPUT
Changes the name of the VPE trace file (used as input to @I$TRACE PRINT). The file‑name is any valid DD or DLBL name up to eight characters in z/OS and up to seven characters in VSE. @I$TRACE PRINT first closes the default input trace file and then opens the file with the name specified in this parameter. The default trace file name is ADRTRC.
In VSE, you must update the IDSYSFT to include an entry for the new file name with the same format as the ADRT entry.
For example, the following changes the input VPE trace file name to MYDTF.
@I$TRACE PRINT FILE MYDTF
Prints only the statistics accumulated for the sections of the trace file analyzed.
This option suppresses the printing of detailed trace entries. Instead, it summarizes the services requested and resources used during the activity that was traced. If you also use the FUNC option, only statistics that apply to the specified functions are generated. Otherwise, statistics are generated for all entries in the trace file. Other options besides FUNC are ignored. For example, the following generates statistics for the entire VPE trace file.
@I$TRACE PRINT STATISTICS
The following generates statistics for VLS entries only.
@I$TRACE PRINT FUNC VLS STATISTICS
Note: You can use any combination of these options in any order. For example, the following extracts all DIAL trace entries for user XYZ written on the 15th of January.
@I$TRACE PRINT USER XYZ DATE 0115 FUNC DIL
As stated above, however, if you specify STATISTICS, all other options except FUNC are ignored.
|
Copyright © 2015 CA Technologies.
All rights reserved.
|
|