CA-GSS Statements and Commands › GSS Extended Functions › IO Functions › Number, String, and Variable Functions › System Information Functions › LOCATE()

LOCATE()

This function returns the memory address of selected control blocks and structures.

Syntax

address = LOCATE(item,[opt])

Parameters

address

Address of the item that one of the keywords specifies. The returned value is in decimal form.

item

Control block or structure. Specify one of the following items:

ASCB Returns the ASCB of the ISERVE address space.

ASID Returns the ASID of the ISERVE address space.

CSCB Returns the CSCB of the ISERVE address space. If opt is also specified, the appropriate CSCB address is returned.

CVT Returns the CVT.

RCT Returns the RCT.

RMCT Returns the RMCT.

TIOT Returns the TIOT of the ISERVE address space.

opt

ASID identifying the address space whose CSCB is returned.

Return Codes

101

ARG 1 MISSING OR INVALID

Example

locate('cvt')      == '16610568'/* Current CVT address in decimal     */
d2x(locate('cvt')) == 'FD7508'  /* Current CVT address in hexadecimal */