AIFGLOBPUT

Places a user-defined value (for example, a pointer or a bit map) in the user cell of the Architected Interface Facility: Operating System internal data area.

Syntax

                 REC         I32      REC

AIFGLOBPUT (overall_status, user_id, user_cell);

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.

user_cell

record by value (required)

Passes a user-defined value to be placed in the user cell of the Architected Interface Facility: Operating System internal data area.

Record type: longint_type (Refer to appendix B.)

Operation Notes

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.

AIFGLOBPUT

Technical documentation

» Table of Contents

» Index

Syntax

Parameters

Operation Notes