GTRACE QUERY

The QUERY function of the GTRACE macro determines how much data GTF will accept, and returns the value in the variable or register specified with the MAXLNG parameter. This function is useful when your program must run on different levels of MVS™ that accept different amounts of trace data in GTRACE DATA.

Environment

The requirements for the caller are:

Environmental factor	Requirement
Minimum authorization:	Problem state, any PSW key
Dispatchable unit mode:	Task or SRB
Cross memory mode:	Any PASN, any HASN, any SASN
AMODE:	24- or 31- or 64-bit
ASC mode:	Primary
Interrupt status:	Enabled or disabled for I/O or external interrupts
Locks:	No requirement
Control parameters:	Must be in the primary address space

Programming requirements

None.

Restrictions

None.

Input register information

Before issuing the GTRACE QUERY macro, the caller does not have to place any information into any register unless using it in register notation for a particular parameter, or using it as a base register.

Output register information

When control returns to the caller, the general purpose registers (GPRs) contain:

Register: Contents
0-14: Unchanged
15: Zero

Performance implications

None.

Syntax

The QUERY function of the GTRACE macro is coded as follows:

Syntax	Description

`name`	`name`: Symbol. Begin `name` in column 1.

␢	One or more blanks must precede GTRACE.

GTRACE

␢	One or more blanks must follow GTRACE.

QUERY

,MAXLNG=`addr`	`addr`: RX-type address or register (2) - (12).

Parameters

The parameters are explained as follows:

QUERY: Specifies the query function of the GTRACE macro.
,MAXLNG=addr: Specifies the address in which the maximum amount of GTF data is returned.

ABEND codes

None.

Return codes

The return code from GTRACE QUERY is always zero.