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
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.