ALESERV ADD (Add Access List Entry) Macro

The ALESERV ADD macro adds an entry to an access list and returns the ALET that references this entry.

If you want to know whether a data space already has an entry on an access list, use the ALESERV SEARCH macro.

Format

Read syntax diagramSkip visual syntax diagramnameALESERV ADD,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 identifier of the data space that the program wants to access and for which the entry is to be added. You might have received the STOKEN as output from the DSPSERV CREATE macro or from another user.
ALET=alet_addr
Specifies the address of the location where the system returns the 4-byte ALET for the access list entry that the system added.
AL=WORKUNIT | PASN
WORKUNIT specifies that the access list to which the entry is to be added 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 is a 'primary address space access list' (PASN-AL), that is, an access list that is associated with a partition.

Use AL=WORKUNIT if you want to limit the sharing of the data space to programs running under the owning task.

Use AL=PASN if you want other programs running in the partition to have access to the data space, or if you are adding an entry for a data space that has been created with DSPSERV SCOPE=COMMON.

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 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.
0C
The current access list cannot be expanded. There are no free ALEs and the maximum size has been reached.
10
ALESERV could not obtain storage for an expanded access list.
18
The caller tried to add to the PASN-AL without being in PSW key-0 state.
38
The input STOKEN is invalid.
4C
The space that is represented by the input STOKEN is invalid for cross-memory access.
5C
The caller is not authorized to add a data space to an access list.
6C
The caller tried to add an entry for a SCOPE=COMMON data space to a DU-AL.