ALESERV EXTRACT (Find a STOKEN) Macro

The ALESERV EXTRACT macro requests that the system finds the STOKEN associated with the specified ALET.

The caller can obtain the STOKEN for any space that is represented by a valid entry on the current access list (DU-AL or PASN-AL related to the current task/partition).

Format

Read syntax diagramSkip visual syntax diagramnameALESERV EXTRACT,STOKEN= stoken_addr,ALET= alet_addr,MF=L,RELATED= anyvalue(E, lstaddr)

Requirements for the caller

AMODE:
24 or 31
RMODE:
24 or ANY
ASC Mode:
Primary or AR (access register)

Parameters

STOKEN=stoken_addr
Specifies the address of the location where the system is to return the 8-byte STOKEN that corresponds to the specified ALET.
ALET=alet_addr
Specifies the address of the location where the 4-byte ALET is given.
MF=L...
L specifies the list form of the macro, which is used to construct a non-executable control program parameter list.

RELATED=anyvalue specifies any valid macro parameter expression, which can be freely chosen by the user.

No other parameters can be specified, if the list form of the macro is chosen.

MF=E...
E specifies the execute form of the macro, which uses the parameter list that is generated by the list form of the macro.

lstaddr specifies the address of the parameter list. This address must not be in a data space. If the caller of the macro is in 24-bit addressing mode, the address of the parameter list must not be above the 16 MB line.

If the MF operand is omitted, the standard form of the macro is used, which places the parameters into an inline parameter list.

Return Codes in Register 15

00
Successful completion.
14
The input ALET corresponds to an invalid access list entry.
28
The caller specified an invalid ALET.
3C
An ALET value of 1 was specified.
44
The ALE associated with the input ALET represents addressing capability to a deleted or terminated space.
58
The access list that is associated with the input ALET does not exist.