AIFGLOBREL

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.

AIFGLOBREL

Technical documentation

» Table of Contents

» Index

Syntax

Parameters

Operation Notes