Specifying runtime options under CICS
Under CICS®, you cannot pass
runtime options as parameters when the application is invoked. However,
you can specify runtime options for your application using one of
the following methods:
- As system-level default options in a CEEPRMxx parmlib member. For more information, see z/OS Language Environment Customization.
- As CICS region-level default options established in CEEROPT. For more information about CEEROPT, see z/OS Language Environment Customization.
- In C++ programs, as static ILC to C modules that have a #pragma runopts statement
- As application defaults established in CEEUOPT (see Creating application-specific runtime option defaults with CEEXOPT for details).
- In the user exit. For more information, (see CEEBXITA assembler user exit interface.
- In C applications, as options specified using #pragma runopts (see the description in Methods available for specifying runtime options for information about #pragma runopts).
- In PL/I applications, as options specified using the PLIXOPT string (see the description in Methods available for specifying runtime options for information about the PLIXOPT string).
Some runtime options have different defaults and exhibit slightly different behavior while executing under CICS. The options are listed in Table 1.
| Option | Description |
|---|---|
| ABPERC | ABPERC is ignored. |
| ABTERMENC | ABTERMENC(ABEND) is the IBM-supplied default under CICS. |
| AIXBLD | AIXBLD is ignored. |
| ALL31 | ALL31(ON) is the IBM-supplied default under CICS. |
| ANYHEAP | ANYHEAP(4K,4080,ANY,FREE) is the IBM-supplied default under CICS. Both the initial size and the increment size are rounded to the nearest multiple of 8 bytes. In addition, if ANYHEAP(0) is specified, the initial HEAP is obtained on the first use and will be based on the increment size. The maximum initial and increment size for ANYHEAP is 1 gigabyte (1024M). |
| ARGPARSE | ARGPARSE is ignored. |
| AUTOTASK | AUTOTASK is ignored. |
| BELOWHEAP | BELOWHEAP(4K,4080,FREE) is the IBM-supplied default under CICS. Both the initial size and the increment size are rounded to the nearest multiple of 8 bytes. In addition, if BELOWHEAP(0) is specified, then the initial HEAP is obtained on the first use and will be based on the increment size. |
| CBLOPTS | CBLOPTS is ignored. |
| CBLPSHPOP | ON is the IBM-supplied default under CICS. |
| CBLQDA | CBLQDA is ignored. |
| CHECK | ON is the IBM-supplied default under CICS. |
| COUNTRY | The value specified is user-defined. |
| DEBUG | DEBUG is ignored. |
| DEPTHCONDLMT | For C, COBOL, FORTRAN, and applications with multiple languages, the recommended value is 10. For PL/I, the recommended value is 0. |
| ENV | ENV is ignored. |
| ENVAR | ENVAR sets the initial value for environment variables. With ENVAR, you can pass switches or tagged information into the application using standard z/OS UNIX functions getenv(), setenv(), and clearenv(). |
| ERRCOUNT | ERRCOUNT(0) is the IBM-supplied default under CICS. |
| ERRUNIT | ERRUNIT is ignored. |
| EXECOPS | EXECOPS is ignored. |
| FILEHIST | FILEHIST is ignored. |
| FILETAG | FILETAG is ignored. |
| FLOW | NOFLOW is the IBM-supplied default under CICS. |
| HEAP | HEAP(4K,4080,ANY,KEEP,4K,4080) is the IBM-supplied default under CICS. Both the initial size and the increment size are rounded to the next multiple of 8 bytes. In addition, if HEAP(0) is specified, then the initial HEAP is obtained on the first use and will be based on the increment size. The maximum initial and increment size for HEAP is 1 gigabyte (1024M). |
| HEAPCHK | HEAPCHK(OFF,1,0,0,0,1024,0,1024,0) is the IBM-supplied default under CICS. |
| HEAPPOOLS | HEAPPOOLS(OFF,8,10,32,10,128,10,256,10,1024,10,2048,10,0,10,0,10,0,10,0,10,0,10,0,10) is the IBM-supplied default under CICS. |
| HEAPZONES | HEAPZONES(0,ABEND,0,ABEND) is the IBM-supplied default under CICS |
| INQPCOPN | INQPCOPN is ignored. |
| INTERRUPT | INTERRUPT is ignored. |
| LIBSTACK | LIBSTACK(32,4080,FREE) is the IBM-supplied default under CICS. Both the initial size and the increment size are rounded to the nearest multiple of 8 bytes. The minimum initial size is 32 bytes; the minimum increment size is 4080 bytes. When ALL31 is ON, LIBSTACK is not allocated below the 16M line. |
| MSGFILE | MSGFILE is ignored. All messages and output (dumps and reports, for example) are sent to a transient data queue called CESE (for more information, see Runtime output under CICS ). |
| MSGQ | 15 is the IBM-supplied default under CICS. |
| NATLANG | ENU is the IBM-supplied default under CICS. |
| NONIPTSTACK | NONIPTSTACK is ignored. |
| OCSTATUS | OCSTATUS is ignored. |
| PAGEFRAMESIZE | PAGEFRAMESIZE is ignored. Note the statement of direction associated with this runtime option. |
| PC | PC is ignored. |
| PLIST | PLIST is ignored. |
| PLITASKCOUNT | PLITASKCOUNT is ignored. |
| POSIX | POSIX is ignored. |
| PROFILE | PROFILE(OFF) is the IBM-supplied default under CICS. |
| PRTUNIT | PRTUNIT is ignored. |
| PUNUNIT | PUNUNIT is ignored. |
| RDRUNIT | RDRUNIT is ignored. |
| RECPAD | RECPAD is ignored. |
| REDIR | REDIR is ignored. |
| RTEREUS | RTEREUS is ignored. |
| SIMVRD | SIMVRD is ignored. |
| STACK | STACK(4K,4080,ANY,KEEP,,) is the IBM-supplied default under CICS. |
| STORAGE | STORAGE(NONE,NONE,NONE,0K) is the IBM-supplied default under CICS. Your application could require a different setting. For example, to initialize memory to zeros, use STORAGE(00,00,00). |
| TERMTHDACT | All TERMTHDACT output (including that from dumps) is written to a transient data queue named CESE. |
| TEST | NOTEST(ALL,*,PROMPT,INSPPREF) is the IBM-supplied default under CICS. |
| THREADHEAP | THREADHEAP is ignored. |
| THREADSTACK | THREADSTACK is ignored. |
| TRACE | TRACE(OFF,4K,DUMP,LE=0) is the IBM-supplied default under CICS. |
| TRAP | TRAP(ON,SPIE) is the IBM-supplied default under CICS. |
| UPSI | UPSI(00000000) is the IBM-supplied default under CICS. |
| USERHDLR | The specified value is user-defined. |
| VCTRSAVE | VCTRSAVE(OFF) is the IBM-supplied default under CICS. |
| XPLINK | XPLINK is ignored. |
| XUFLOW | XUFLOW(AUTO) is the IBM-supplied default under CICS. |