SPLEVEL (Set and Test Macro Level) Macro

The macro sets or tests the global symbol that indicates the level of a macro.

Certain macros that are supplied in the z/VSE macro library are identified as being downward-incompatible with VSE/ESA versions. To use these macros, you must generate downward compatible expansions by issuing the SPLEVEL macro. SPLEVEL sets (or tests) a global symbol that is interrogated by these macros during assembly to determine the type of expansion to be generated.

The following macros check the setting of the global symbol:
  • FCEPGOUT
  • PAGEIN
  • PFIX
  • PFREE
  • RELPAG
  • WTO
  • WTOR

Format

Read syntax diagramSkip visual syntax diagramname SPLEVEL SET= nSETTEST

Parameters

SET=n
Sets a global symbol equal to n, where n must be 1, 2, 3, or 4. If you code any of the above macros, one of the following macro expansions is generated:
  • VSE/ESA 1.1 and 1.2 macro expansion if n=1
  • VSE/ESA 1.3 macro expansion if n=2 or 3
  • VSE/ESA 2.1 and later macro expansion if n=4
SET
Causes the SPLEVEL routine to use the default value n=4.
TEST
Determines the macro level that is in effect. The result of the test request is returned to your program in the global set symbol &SYSSPLV. If TEST is specified and if SPLEVEL SET has not been issued during this assembly, the SPLEVEL routine puts the default value (4) into the global set symbol. If SPLEVEL is issued, the previous value of n or the default value is already in the global set symbol. (For information about global set symbols refer to the High Level Assembler for VSE manuals.)