z/OS JES2 Macros
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


$ALESERV – JES2 ALET services

z/OS JES2 Macros
SA32-0996-00

Use $ALESERV to add or delete access list entry tables (ALETs). This macro service also maintains a list of the ALETs for JES2-owned address spaces.

Format description

Read syntax diagramSkip visual syntax diagram
>>-+--------+--$ALESERV--ACTION=--+-ADD----+-------------------->
   '-symbol-'                     '-DELETE-'   

>--+-DSB=--addr---------------+--ERRET=--label--OKRET=--label--><
   +-HASXB=--addr-------------+                                 
   +-NAME=--name--------------+                                 
   '-NAMEFLD=--+-label------+-'                                 
               '-(--R--n--)-'                                   

ACTION=
The action to be taken:
ADD | DELETE
Specifies that JES2 is to add (ADD) or delete (DELETE) an ALET.
Note: You must also specify one and only one of the following: DSB=, HASXB=, NAME=, or NAMEFLD=.
DSB=
Specifies the address of the data space block (DSB) associated with the data space for which you want an ALET added or deleted.

If you specify DSB=, you cannot specify HASXB=, NAME=, or NAMEFLD=.

HASXB=
Specifies the address of the address space extension block (HASXB) for which a DELETE ALL is required. HASXB= implies NAME=ALL and can only be specified on a ACTION=DELETE call.

If you specify HASXB=, you cannot specify DSB=, NAME=, or NAMEFLD=.

NAME=
Specifies the name of the ALET requested. This name must match either the name specified on a $DSPSERV CREATE call or one of the predefined names in $ALINDEX. NAME=ALL requests that JES2 delete all ALETs. NAME=ALL can only be specified on a ACTION=DELETE call.

If you specify NAME=, you cannot specify DSB=, HASXB=, or NAMEFLD=.

NAMEFLD=
Specifies a label that contains the name of the ALET or a register that points to the name of the ALET to be processed. This name must match either the name specified on a $DSPSERV CREATE call or one of the predefined names in $ALINDEX. A field that contains the value ALL is equivalent to specifying NAME=ALL and only allowable on a ACTION=DELETE call.

If you specify NAMEFLD=, you cannot specify DSB=, HASXB=, or NAME=.

ERRET
The label to branch to in the event of a non-zero return code.
OKRET
The label to branch to if the return code is zero.

Programming notes

  • If JES2 has already added a requested ALET, a new ALET is not added.
  • If the ALINDEX does not exist, JES2 creates it on the first ADD call.
  • If this is a DELETE call and NAME=ALL (or implied), JES2 deletes the ALINDEX table.
  • If all ALETs in the ALINDEX table are deleted, the table is not also deleted.

Return codes

The following return codes (decimal) are returned in register 15.
Return Code
Meaning
0
Processing successful. If ADD call, ALET is returned in R1.
4
Processing failed. Zero returned in R1.
8
Processing failed. JES2 cannot identify the ALET identifier passed to it. Zero returned in R1.
12
A logic error occurred due to a mismatch of the action requested (ADD or DELETE) and the ALET identifier passed to JES2, such as $ALESERV ADD,NAME=ALL.

Environment

  • JES2 main task, subtask, functional subsystem (HASPFSSM), or user environment.
  • $WAIT cannot occur.
  • Callers can be in AR ASC mode.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014