LOCATE()

Use the LOCATE() function to return the memory address of selected control blocks and structures.

The LOCATE() function has this format:

address = LOCATE(item,[opt])

The LOCATE() function takes these arguments:

address

Address of the item specified by one of the keywords. The returned value is in decimal form.

item

Control block or structure. Specify one of the following:

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 to be returned.

The LOCATE() function produces these 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 */