z/OS MVS Programming: Authorized Assembler Services Reference SET-WTO
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Associate an enclave with an address space (ENCASSOC)

z/OS MVS Programming: Authorized Assembler Services Reference SET-WTO
SA23-1375-00

Use the ENCASSOC SYSEVENT to associate an enclave and a server address space for SRBs that were scheduled to run in this enclave. This association allows SRM to manage the server address space’s storage related resources towards the enclave’s performance goal.
Note:
  1. It is not required to use SYSEVENT ENCASSOC when you run SRBs in enclaves. It is an improvement for storage management but it is not recommended when the address space into which the SRB is scheduled runs other significant work because the association may change the goal management for the target address space.
  2. The ENCASSOC SYSEVENT is necessary only for SRBs that were scheduled to run in this enclave. A task that joins an enclave automatically associates the home address space with the enclave.
You must specify X'8000' in the ASID parameter and access registers (AR) 0 and 1 must contain the enclave token. The enclave token must have been obtained from the IWMECREA macro.
The ENCASSOC SYSEVENT supports the following functions, which have to be specified with the TYPE parameter as well as in the parameter list IRAEVPL. Valid values are ‘1’ and ‘2’. Note that the value can be specified either as a decimal number or as a symbol.
TYPE=1
Allows the SRB to associate this enclave with the address space for the purpose of managing the storage related resources towards the enclave’s performance goal.
TYPE=2
Allows the SRB to disassociate this enclave with the address space.
For more information about SRBs and how to use them, see z/OS MVS Programming: Authorized Assembler Services Guide.
The recommended coding sequence of the ENCASSOC SYSEVENT is as follows:
  1. Subsystem:
    • The subsystem creates the enclave by using the IWMECREA service.
    • The subsystem schedules an SRB to run in the enclave.
  2. SRB:
    • The SRB associates the address space with the enclave by using the ENCASSOC SYSEVENT function Associate.
    • SRB process logic.
    • The SRB disassociates the address space with the enclave by using the ENCASSOC SYSEVENT function Disassociate.
Parent topic: SYSEVENT — System event

Input register information

Register 1 must point to a parameter list. The parameter list must be non-pageable and addressable via the caller's primary address space. To map the parameter list, use the IRAEVPL mapping macro described in z/OS MVS Data Areas in z/OS Internet Library at http://www.ibm.com/systems/z/os/zos/bkserv/.

Return and reason codes

When processing is complete for the ENCASSOC SYSEVENT, the last byte of register 15 contains one of the following hexadecimal return codes:

Table 1. Return Codes for ENCASSOC
Return Code Meaning
00 Successful completion.
04 Invalid function code specified.
10 Invalid enclave token specified.

Go to the previous page Go to the next page

Notices | Terms of use | Support | Contact z/OS | zFavorites



Copyright IBM Corporation 1990, 2014