Specifying runtime options

To allow your application to recognize runtime options, either the EXECOPS compiler option, or the #pragma runopts(execops) directive must be in effect. The default compiler option is EXECOPS.

You can specify runtime options as follows:

At execution time in one of the following ways:
- On the GPARM option of the IBM-supplied cataloged procedures
- On the option list of the TSO CALL command
- On the PARM parameter of the EXEC PGM=your-program-name JCL statement
- On the exported _CEE_RUNOPTS environment variable under the z/OS® shell
At compile time, on a #pragma runopts directive in your main program

If EXECOPS is in effect, use a slash '/' to separate runtime options from arguments that you pass to the application. For example:

GPARM='STORAGE(FE,FE,FE)/PARM1,PARM2,PARM3'

If EXECOPS is in effect, the Language Environment® runtime environment interprets the character string that precedes the slash as runtime options. It passes the character string that follows the slash to your application as arguments. If no slash separates the arguments, the Language Environment runtime environment interprets the entire string as an argument.

If EXECOPS is not in effect, the Language Environment runtime environment passes the entire string to your application.

If you specify two or more contradictory options (for example in a #pragma runopts statement), the last option that is encountered is accepted. Runtime options that you specify at execution time have higher precedence than those specified at compile time.

For more information on the precedence and specification of runtime options for applications that are compiled with the Language Environment runtime environment, refer to z/OS Language Environment Programming Reference.