Specifying TEST run-time option with #pragma runopts in C and C++

The TEST run-time option can be specified either when you start your program, or directly in your source by using this #pragma: 
#pragma runopts (test(suboption,suboption...))
This #pragma must appear before the first statement in your source file. For example, if you specified the following in the source: 
#pragma runopts (notest(all,*,prompt))
then entered TEST on the command line, the result would be 
TEST(ALL,*,PROMPT).
TEST overrides the NOTEST option specified in the #pragma and, because TEST does not contain any suboptions of its own, the suboptions ALL, *, and PROMPT remain in effect.

If you link together two or more compile units with differing #pragmas, the options specified with the first compile are honored. With multiple enclaves, the options specified with the first enclave (or compile unit) started in each new process are honored.

If you specify options on the command line and in a #pragma, any options entered on the command line override those specified in the #pragma unless you specify NOEXECOPS. Specifying NOEXECOPS, either in a #pragma or with the EXECOPS compiler option, prevents any command line options from taking effect.

Refer to the following topics for more information related to the material discussed in this topic.

  • Related tasks
  • z/OS® XL C/C++ User's Guide