SYSSTATE (Metal C only)

Pragma equivalent

None.

Purpose

Provides additional SYSSTATE macro parameters to the SYSSTATE macro that is generated by the compiler.

Syntax

Defaults

SYSSTATE(NOASCENV, OSREL(NONE))

Parameters

ASCENV | NOASCENV

Instructs the compiler to automatically generate additional SYSSTATE macros with the ASCENV parameter to reflect the ASC mode of the function.

The default is NOASCENV, with which no ASCENV parameter appears on the SYSSTATE macro.

OSREL (NONE | ZOSVnRm)

Provides z/OS® release value for the OSREL parameter on the SYSSTATE macro.

The z/OS release value must be in the form of ZOSVnRm as described in z/OS MVS™ Programming: Assembler Services Reference. Valid values for the OSREL parameter include ZOSV1R6 or later z/OS releases.

The default is NONE, with which no OSREL parameter appears on the SYSSTATE macro.

Usage

When the GENASM option is in effect, you can specify the SYSSTATE compiler option to enhance the SYSSTATE macro that is generated by the compiler. With the SYSSTATE option, you can include the OSREL parameter in the SYSSTATE macro, or have the ASCENV parameter automatically set, or both.

The effect of the SYSSTATE macro depends on whether you use other system macros and whether those system macros rely on system variables that are set by the SYSSTATE macro. For example, if a system macro checks for the OSREL setting, you might need to include the OSREL parameter; if a system macro used in an AR mode function checks for the ASCENV setting, you might need to add the ASCENV parameter. With the SYSSTATE compiler option, you can control how these parameters can be added to the SYSSTATE macro.

IPA effects

If you specify different SYSSTATE suboptions for compilation units during the IPA compile step, different SYSSTATE values will be isolated in different partitions during the IPA link step.

If the SYSSTATE option is specified during the IPA link step, it overrides all other SYSSTATE settings during the IPA compile step.

Predefined macros