gtpg2m2wGeneral Macros

INQRC-Convert Resource Application Interface

This general macro can be used to obtain the following:

Format




TYPE
This indicates whether an RID (or SCBID) or a name is to be used as the search argument to locate the data.

R
This indicates that an RID or SCBID is to be used as a search argument. The RID or SCBID is right-justified in a 4-byte field padded to the left with binary zeros. If the search argument is an SCBID, the corresponding SCB must be chained off an RVT entry.

N
This indicates that a name is to be used as the search argument.

AREA=label1|(Rx)
This is a label or register (R0-R7, R14, or R15) containing the address of a work area that contains the input data and that is used to return the output if LEVEL is not coded. When it is used as a return area, 30 bytes must be reserved. If omitted, R14 is the default.

LEVEL=Dx
This specifies the ECB level, D0 through DF, that is used to return the requested data. On return to the caller, the level contains a core block with the data requested. The core block contains a 16-byte standard header followed by the returned data.

ERROR=label2
This is a label to branch to if the RID or SCBID or name provided is not valid or cannot be found. This parameter is required when LEVEL is coded.

FUNCTION
This is restricted to system use only.

ADD
Creates a resource definition for the new LU resource specified in the AREA input data.

ALLOCATE
Creates a resource definition for the new non-LU resource specified in the AREA input data.

AVAIL
Places the RVT entry for the LU resource specified in the AREA input data on the RVT available list.

CHG
Changes the name of the non-LU resource specified in the AREA input data to the new name specified in the AREA input data.

DELETE
Deletes the resource definition for the non-LU resource specified in the AREA input data.

FORCE
Removes all of the RVT entries from the RVT termination list and places them on the RVT available list.
Note:
Do not specify the TYPE parameter if you specify the FORCE option.

TERM
Places the RVT entry for the LU resource specified in the AREA input data on the RVT termination list.

Entry Requirements

Return Conditions

Programming Considerations

Examples

If the input is set up as follows:

and you code: INQRC TYPE=N,AREA=EBW000,LEVEL=D5,ERROR=ROUTINE the output would be: