QUERY TRSAVE

Read syntax diagramSkip visual syntax diagram Query TRSAVE FORALLFORCPIDtraceidFRAMES

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

  1. For class G users, QUERY TRSAVE displays the destination of data derived from the trace or traces for that user's virtual machine.
  2. 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.