ALESERV SEARCH (Search Access List Entry) Macro

The ALESERV SEARCH macro searches through the DU-AL or PASN-AL related to the current task/partition for an ALET that corresponds to the specified STOKEN.

If the entry is on the list, the system returns the ALET. Otherwise, a return code is set in register 15.

Format

Read syntax diagramSkip visual syntax diagramnameALESERV SEARCH,STOKEN= stoken_addr,ALET= alet_addr,AL=WORKUNIT,AL=PASN,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 8-byte STOKEN for which the system is to return the corresponding ALET.
ALET=alet_addr
As input to the SEARCH request, ALET specifies the point in the access list where the system is to begin the search. The following values are valid as start addresses:
  • Minus one (-1) - Start at the beginning of the DU-AL or PASN-AL.
  • Valid ALET - Start the search with the next ALET in the access list. It is recommended to start searching from the beginning of the access list, that is with ALET=-1. Starting with a valid ALET gives consistent results only if the program can ensure that no ADD or DELETE requests are executed while processing the SEARCH request.

As output from the SEARCH request, ALET specifies the address of the location where the system is to return the 4-byte ALET, if present. Otherwise, ALET is unchanged and register 15 contains a return code indicating that an ALET for the specified STOKEN is not on the access list.

AL=WORKUNIT | PASN
WORKUNIT specifies that the access list to be searched is a 'dispatchable unit access list' (DU-AL), that is, an access list that is associated with a z/VSE task. PASN specifies that the access list to be searched is a 'primary address space access list' (PASN-AL), that is, an access list that is associated with a z/VSE partition.
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.
28
The caller specified an ALET that is not valid on the specified access list.
34
The caller specified an STOKEN that is not represented on the specified access list.
48
The caller specified AL=WORKUNIT, but the input ALET indexes into the PASN-AL or the caller specified AL=PASN and the input ALET indexes into the DU-AL.