|
|
|
Returns the contents of the user cell in the Architected Interface Facility:
Operating System internal data area.
Syntax
REC I32 REC
AIFGLOBGET ( 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 reference (required)
Returns the contents of the user cell in the internal data area.
Record type: longint_type (Refer to appendix B.)
Operation Notes
This user cell is shareable among all processes using the same user ID.
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.
|
