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


$ARMODE – JES2 multi-address space access

z/OS JES2 Macros
SA32-0996-00

Use the $ARMODE macro instruction to perform functions related to multi-address space management, such as switching access register control mode, and how the access registers are to be loaded.

Format description

Read syntax diagramSkip visual syntax diagram
>>-+--------+--$ARMODE--+-----+--+-----------------+------------>
   '-symbol-'           +-ON--+  '-,INIT--=--addrx-'   
                        '-OFF-'                        

>--,AR--=--(--R--n--+------------+--)--------------------------->
                    '-…--,--R--n-'      

>--+--------------------------------------------+--------------->
   '-,ALET--=--+-(--R--n--+------------+--)---+-'   
               |          '-…--,--R--n-'      |     
               '-(--value--+-------------+--)-'     
                           '---,--value-'          

>--+--------------------+--+-------------------------+---------><
   '-,RELATED--=--label-'  |               .-NOSET-. |   
                           '-,SYSSTATE--=--+-SET---+-'   

ON|OFF
Specifies whether the call to $ARMODE is to set the access register control mode ON or OFF. If you do not set this value, the current AR-mode remains in effect.
Note: If this parameter is specified it must be coded first.
INIT=
Specifies that all access registers are loaded with the 16 consecutive full-words beginning at the storage location pointed to by this address.
AR=
Specifies the access registers that are loaded with the values specified by ALET=. These registers are set in the order specified. You can specify up to 16 access registers.
ALET=
Specifies a list of values (ALETs) that are set in the access registers specified by AR=. You can specify either one or more registers or one or more fullword values. If any or all of these ALET values are not specified, the corresponding registers are set to 0. Each ALET points to an entry on an access list. For more information, see Data space usage.
RELATED=
Specifies a valid alphanumeric label that this macro is related to.
Note: If the label referred to by this keyword does not exist, an assembler error will occur.
SYSSTATE=
Specifies whether (SET) or not (NOSET) a SYSSTATE macro is issued. The SYSSTATE macro is used to indicate that a caller is in AR mode and provides the generation of code and addresses that are appropriate for callers in that mode.
Note:
  1. The contents of general registers 0 and 1 are destroyed across a call to $ARMODE.
  2. If ALET= is specified, AR= must be specified.

Environment

  • All JES2 environments.
  • MVS™ WAITs or JES2 $WAITs cannot occur.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014