IFAMQRY — Query SMF in-memory resources

Description

Your application can call the IFAMQRY service to determine which SMF in-memory resources are available. Only those in-memory resources that are available to this caller, as determined by SAF, access are returned.

Environment

The requirements for the caller are:

Programming requirements

The caller must include the IFAZSYSP macro to get a mapping of the query parameter block. The caller should include the IFARCINM macro to get equate symbols for the return and reason codes.

Authorization

None.

Restrictions

None.

Syntax

Write the call as shown in the following syntax diagram. You must code all parameters on the CALL statement in the order shown.

Call IFAMQRY (
               QryParmBlock,
               rc,
               rsn);

For assembler programming, the stub routine for this callable service resides in SYS1.CSSLIB.

Parameters

The parameters are explained as follows:

QryParmBlock

A query parameter block.

Direction: Input/output

Type: Query parameter block

The query parameter block has the following format and is mapped by the IFAZSYSP macro in SYS1.MACLIB:

Decimal offset	Length	Type	Field	Description
0	4	EBCDIC	ID	ID with value of QRPB
4	2	binary	Length	Total length of the query parameter block
6	1	binary	Unused	Unused; must be zero
7	1	binary	Version	Parameter block version number (X'01')
8	2	binary	Flags	The following flags are supported: Value Meaning 1 Request return of extended types. When on, the output area will be mapped by QrPbX_InMemResource_Ext 2 - 15 Unused, must be zero
8	4	binary	Unused	Unused; must be zero
10	2	binary	Unused	Unused; must be zero
12	4	binary	Returned Imrs	Number of returned in-memory resources
16	4	binary	Buffer size	Size of the output buffer that is to contain the information for the returned in-memory resources
20	4	binary	Unused	Unused; must be zero
24	8	binary	Buffer address	Address of the output buffer that is to contain the information for the returned in-memory resources

Each in-memory resource returned in the output buffer (pointed to by the address in the buffer address field) has the following format:

Decimal offset	Length	Type	Field	Description
0	2	binary	Name length	Length of the name
2	26	EBCDIC	Name	Name of the in-memory resource, padded with blanks
28	32	binary	Types	Bit mask (0 - 255 bit array) of SMF record types that are available from this in-memory resource
60	8	binary	Reserved	Reserved

rc

The return code from the service.

Direction: Output

Type: 4-word integer

rsn

The reason code from the service.

Direction: Output

Type: 4-word integer

ABEND codes

IFAMQRY might abnormally end with system completion code X'353'. See z/OS MVS System Codes for an explanation and programmer response.

Related services

Return and reason codes

When the service returns control to the caller, the rc parameter contains a hexadecimal return code and the rsn parameter contains a hexadecimal reason code, as listed in Table 1. The return code and reason code symbols are mapped by the IFARCINM macro.