Control block events
This event occurs when a control block is accessed or updated. A rule for this event can accept or reject the request or allow the security product to determine if the request is allowed.
Return values
When an ATH event ends, the rule sets a return value. The server evaluates the return value and invokes z/OS® security routines.
| Return value | Description |
|---|---|
| ACCEPT | Access to the requested resource is allowed, and additional processing by the z/OS security subsystem is not performed. |
| REJECT | Access to the requested resource is denied, and additional processing by the z/OS security subsystem is not performed. The rule can include the ATH.OPAUERMG variable, which for most authorization requests, returns an error message to the requestor. |
| Other value | If another value or no value is returned, the z/OS security subsystem performs validation checking. The security product makes the final determine to allow or deny access to the requested resource. |
Variables
CONTROLBLOCK variables are used for events that pertain to accessing or updating a product control block.
| Variable name | Contents | Data type |
|---|---|---|
| ATH.AUBKCBAD | The address of the control block. | Character, read-only |
| ATH.AUBKCBAS | The address space (ASID) of the control block. | Numeric, read-only |
| ATH.AUBKCBLN | The length of the control block. | Numeric, read-only |
| ATH.AUBKCBNA | The name of the control block. | Character, read-only |