AIFGLOBGET

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.

AIFGLOBGET

Technical documentation

» Table of Contents

» Index

Syntax

Parameters

Operation Notes