DSAUSER | NODSAUSER (C only)

Pragma equivalent

None.

Purpose

When the METAL option is in effect, requests a user field to be reserved on the stack.

Syntax


   .-NODSAUSER-.                    
>>-+-DSAUSER---+--+-------------+------------------------------><
                  '-(--value--)-'

Defaults

NODSAUSER

Parameter

value: An integer in the range of 0 to 50.

Usage

When DSAUSER is specified with the METAL option, and no suboption is specified with DSAUSER, a field of the size of a pointer is reserved on the stack. The user field is a 4-byte field for AMODE 31 and an 8-byte field for AMODE 64. The user field is only allocated if the function has the user supplied prolog/epilog code.

If a value Start of change parameter End of change is specified with DSAUSER, a user field with the size of value 32-bit words is allocated. Specifying DSAUSER with the value parameter requires ARCH(6). A value of 0 has the same effect as NODSAUSER.

The reserved user field can be addressed by using the global set symbol &CCN_DSAUSER. For more information about &CCN_DSAUSER, see Compiler-generated global SET symbols in z/OS Metal C Programming Guide and Reference.

IPA effects

If the DSAUSER option is specified during any of the IPA compile steps, it is applied to all partitions created by the IPA link step. The largest value is used for all partitions in the IPA link step.