|
|
|
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.
|
