QUERY TRSAVE
Authorization
Privilege Class: A, C, E, G
Purpose
Use QUERY TRSAVE to display the destination of traces defined by TRSOURCE, or to display the status of traces controlled by SET CPTRACE.
Operands
- ALL
- displays the status of all active TRSAVE functions, or indicates that there are no active functions.
- CP
- displays the status of TRSAVE activity for CP system tracing. This option is allowed only for class A, C, and E users.
- FRAMES
- displays the number of frames allocated from the system dynamic paging area for active DEFERIO traces and for DEFERIO CP system tracing and displays the number of pageable pages in the system dynamic paging area that are still eligible for DEFERIO traces.
- ID traceid
- displays the status of TRSAVE activity for the specified trace ID.
Usage Notes
- For class G users, QUERY TRSAVE displays the destination of data derived from the trace or traces for that user's virtual machine.
- For class A, C, or E users, QUERY TRSAVE displays the status of any TRSAVE activity.
Responses
Response 1:
If tracing is done to DASD:
SOURCE FILENAME RECEIVER KEEP SIZE FRAMES FILLED
CPTRACE filename userid n mmmm [mmmmm nnnnn DEFERIO]
traceid filename userid n mmmm [mmmmm nnnnn DEFERIO]
- SOURCE
- identifies the source of the trace. CPTRACE identifies tracing activity resulting from the TRSAVE FOR CP ON command. The operand traceid identifies tracing activity resulting from a TRSOURCE ID traceid command.
- FILENAME
- identifies the file names specified, or defaulted to, on the TRSAVE command.
- RECEIVER
- identifies the users specified, or defaulted to, as the TO userid on the TRSAVE commands. Each userid listed in the column is the only user authorized to read this system trace file.
- KEEP
- identifies the maximum number of files that CP keeps each time this trace is active.
- SIZE
- identifies the maximum size, in 4 KB pages, for each of the files created when this trace is active.
- FRAMES
- identifies the number of real storage frames that are set aside for an in-storage-wrap of the DEFERIO trace. The frames are allocated from the system dynamic paging area when the traceid is enabled or, for trace table data, when TRSAVE CP ON is issued. Blanks are displayed if the trace is not a DEFERIO trace.
- FILLED
- identifies the number of those real storage frames that are filled with trace data. Blanks are displayed if the trace is not a DEFERIO trace. The nnnnn value will not exceed mmmmm-1, because one frame is set aside as the current frame being filled. When nnnnn reaches mmmmm-1, the displayed value of nnnnn remains at that level until the traceid is disabled.
- DEFERIO
- indicates that no trace data is recorded on DASD until the traceid is disabled or, for trace table data, until TRSAVE CP OFF is issued. Blanks are displayed if the trace is not a DEFERIO trace.
When ALL is specified, the above information is displayed for all existing traceids and for CPTRACE when it is active.
Response 2:
The following message is displayed when a class A, C, or E user issues QUERY TRSAVE ID
traceid for a trace ID that is not defined.
Traceid traceid is not defined.
Response 3:
The following message is displayed when a class G user issues QUERY TRSAVE ID
traceid for a trace ID that is not defined or when the user is not
authorized to view information for that particular traceid.
Traceid traceid is not tracing for your virtual machine.
Response 4:
The following message is displayed when the user issues QUERY TRSAVE ALL but no trace IDs have
been defined.
No traceids defined.
Response 5:
The following message is displayed when a class G user issues QUERY TRSAVE ALL but no trace IDs
have been defined for which the user is authorized to view information.
No traceids defined for your virtual machine.
Response 6:
If CP system trace data is being written to tape, the following message is displayed:
TRSAVE for CP on drive rdev1 [rdev2] MODE nnnn
{rewind} [DEFERIO FRAMES mmmmm FILLED nnnnn]
{run }
- rdev1 [rdev2]
- identifies the real device number or numbers of the tape drives being used for the TRSAVE function. If only one tape drive is being used, rdev2 is not shown.
- MODE nnnn
- identifies the tape's format density.
- REWIND
- RUN
- indicates that the tape is to be rewound (REWIND) or rewound and unloaded (RUN) when the tape fills.
- DEFERIO
- indicates that no trace data is recorded on tape until TRSAVE CP OFF is issued.
- FRAMES mmmmm
- identifies the number of real storage frames that are set aside for an in-storage-wrap of the DEFERIO trace. The frames have been allocated from the system dynamic paging area.
- FILLED nnnnn
- identifies the number of those real storage frames that have been filled with trace data. The nnnnn value will not exceed mmmmm-1, because one frame is set aside as the current frame being filled. When nnnnn reaches mmmmm-1, the displayed value remains at that level until TRSAVE CP OFF is issued.
Response 7:
The following message is displayed if TRSAVE FOR CP is not active:
TRSAVE inactive for CP
Response 8:
The following message indicates that TRSAVE FOR CP is neither active nor inactive, but is in a
transition state between the two:
TRSAVE pending active for CP
Response 9:
The following messages are displayed when a class A, C, or E user issues QUERY TRSAVE FRAMES.
nnnnnn frames are allocated for active DEFERIO traces.
mmmmmm pages are still eligible to be allocated for DEFERIO traces.
The
frames are allocated from the system dynamic paging area. Keep in mind that number of pageable pages
in the system dynamic paging area is affected by the locking and unlocking of frames for various
reasons. For more information see the TRSAVE command's usage notes regarding DEFERIO.Response 10:
The following message indicates that TRSAVE FOR CP is terminating:
TRSAVE terminating for CP
Messages
- HCP003E Invalid option - {option|command contains extra option(s) starting with option}
- HCP410E CP ENTERED; PAGING ERROR
- HCP475I Fatal I/O error trying to read directory from volid [for user userid]
- HCP1001E An operand is missing for option.
- HCP1013E An invalid operand was supplied for option - operand.
- HCP6525E Authorization request failed.