|
|
|
Releases the object in the Architected Interface Facility: Operating System
internal data area associated with the specified user ID (previously created
by AIFGLOBACQ).
Syntax
REC I32
AIFGLOBREL ( overall_status, user_id );
Parameters
- overall_status
- record by reference (required)
Returns the overall status of the call. A zero indicates a successful
call. A negative value indicates an error in the overall call. A
positive value indicates a warning. Refer to appendix A for meanings of
status values.
Record type: status_type (Refer to appendix B.)
- user_id
- 32-bit signed integer by value (required)
Passes the user ID assigned to a vendor at the time of purchase of the
Architected Interface Facility: Operating System product.
Operation Notes
If your process does not release the shared object, the object is not deleted
until the system either aborts or is shut down.
AIFGLOBACQ, AIFGLOBREL, AIFGLOBGET, and
AIFGLOBPUT all access the user cell. The user cell is a 64-bit data
area which is located in the AIF internal area. All processes with the same
user_id will share the same user_cell. The management of the user cell is the
application designer's responsibility.
When AIFGLOBACQ is called, it returns the address of the newly
allocated object in the user_cell. If any value is in the user_cell prior to
calling AIFGLOBACQ it is the user's responsibility to save the value.
Likewise, if the user_cell is modified using AIFGLOBPUT, the
application designer must save the value returned by AIFGLOBACQ. The
value returned in the user_cell when the object was first allocated using
AIFGLOBACQ must be placed back in the user_cell with
AIFGLOBPUT if the user_cell has been modified between calls to
AIFGLOBACQ and AIFGLOBREL.
|
