JCL-specific environment variables

This topic lists environment variables relate to configuring the JCL environment.

Variable	Description
CASRDO44_NEWSUB	Enables access to JCL files held on the local machine on which the browser is running. CASRDO44_NEWSUB=OFF
CASSPOOL_LOCK_RETRY_COUNT	If errors are experienced by the spool module, the number of times it retries to obtain a record lock can be adjusted using this environment variable. The default value is 20. CASSPOOL_LOCK_RETRY_COUNT=`num-retries`
ES_ALLOC_EXPAND	The default value is Y, which expands an environment variable when used to specify an allocation path. Set to N to override this behavior, which is to not expand the variable used in the path. ES_ALLOC_EXPAND=Y\|N
ES_ALLOC_OVERRIDE	The location of a file containing rules that determine where new data sets are created. This applies only to JES and batch files, and not CICS, IMS, or Web services files. ES_ALLOC_OVERRIDE=`rules-file`
ES_CAT_RETRY_COUNT	Determines the amount of attempts made to open a catalog file that has produced an error when the initial attempt to open it was made. ES_CAT_RETRY_COUNT=n Default is ES_CAT_RETRY_COUNT=0.
ES_CAT_RETRY_WAIT	Determines the amount of time (in seconds) to wait between attempts made to open a catalog file that has produced an error when the initial attempt to open it was made. ES_CAT_RETRY_WAIT=n Default is ES_CAT_RETRY_WAIT=0.
ES_JESYSMSG_OUTPUT	The status of the system messages spool files (JESYSMSG) is set to Output, rather than Out Hold. ES_JESYSMSG_OUTPUT=Y\|N
ES_JESYSMSG_RESTRICTED	When the status of the system message spool files are set to Output, by using ES_JESYSMSG_OUTPUT, you can hold back spool files based on their class, by using ES_JESYSMSG_RESTRICTED. ES_JESYSMSG_RESTRICTED=`class-name/number` To specify multiple class names or numbers, enter them as a string; for example, ABC123 for classes A, B, C, 1, 2, & 3.
ES_JES_BYTES	Maximum number of bytes to output in a job before taking the action specified (either cancelling the job, cancelling the job and dumping memory contents, or issuing a warning message). ES_JES_BYTES=`NUMBER` \| (NUMBER,WARNING \| CANCEL \| DUMP)
ES_JES_CARDS	Maximum number of cards to output in a job before taking the action specified (either cancelling the job, cancelling the job and dumping memory contents, or issuing a warning message). ES_JES_CARDS=`NUMBER` \| (NUMBER,WARNING \| CANCEL \| DUMP)
ES_JES_CONSOLE_MESSAGES	CASMG0001I messages are produced when a program running in a JCL job does 'display upon console'. These messages, along with others, are lodged in the splmsg.dat file and, when the job information is displayed in ESCWA/ESMAC these messages are also shown. There is a limit of 65535 messages per job. If that limit is exceeded the last messages sent will overwrite the last message already lodged in splmsg.dat. If your program outputs a lot of messages you can avoid having them stored in splmsg by setting ES_JES_CONSOLE_MESSAGES=N. Whatever this setting, the CASMG0001I messages will still be included in the JESYSMSG for the job. ES_JES_CONSOLE_MESSAGES=Y\|N There is also a Job statement extension so that this can be configured on a job by job basis. //*MFE:%CONSOLE_MSGS=Y\|N
ES_JES_DELAY_MEM_ENQ[9]	Delays the exclusive enque of a new (not previously existing) PDS member until the file is opened. PDS members are given an exclusive enque at step start. When used with existing PDS members, the program abends with code S213 when it attempts to access a file and cannot get the exclusive enque. ES_JES_DELAY_MEM_ENQ=Y\|N Default is `N`.
ES_JES_DISABLE_RESTART_FLUSH	Indicates whether a region's jobs are moved from the Active queue to the Complete queue when a region is restarted. ES_JES_DISABLE_RESTART_FLUSH=Y\|N
ES_JES_ENFORCE_EXPIRE_DATE[12] (UNIX only)	Enables or disables the checking of the expiry date. ES_JES_ENFORCE_EXPIRE_DATE={Y\|N} Default is `N`.
ES_JES_LEVEL	Sets the default JCL type. ES_JES_LEVEL=JES2\|JES3\|VSE
ES_JES_LINES	Maximum number of lines to output in a job before taking the action specified (either cancelling the job, cancelling the job and dumping memory contents, or issuing a warning message). ES_JES_LINES=`NUMBER` \| (NUMBER,WARNING \| CANCEL \| DUMP)
ES_JES_OUTLIM	ES_JES_OUTLINE=`NUMBER` \| (NUMBER,WARNING \| CANCEL \| DUMP) ES_JES_OUTLIM=5000 When the above is set, a warning will be issued when 5000 lines of output is exceeded. ES_JES_OUTLIM=(1000,CANCEL) When the above is set, it causes a step to abend with an S722 abend code if the output limit of any SYSOUT dataset exceeds 1000 lines. Individual OUTLIM values can be set on each SYSOUT dataset. For example, //SYSPRINT DD SYSOUT=*,OUTLIM=500. If the output of SYSPRINT exceeds 500 lines and ES_JES_OUTLIM=(1000,CANCEL) then the step will be cancelled with an S722 abend code.
ES_JES_PAGES	Maximum number of pages to output in a job before taking the action specified (either cancelling the job, cancelling the job and dumping memory contents, or issuing a warning message). ES_JES_PAGES=`NUMBER` \| (NUMBER,WARNING \| CANCEL \| DUMP)
ES_JES_PARM_INIT_LOW	When set to Y, the parameter string passed to a program executed by JCL is initialized to low-values. The default is N, which is to initialize it to spaces. ES_JES_PARM_INIT_LOW=Y\|N
ES_JES_RESTART	Enables JCL restart processing. ES_JES_RESTART=Y\|N
ES_JES_SORT_SPOOL_BY	Specifies which column is initially used to sort the spool records in casrdo41. ES_JES_SORT_SPOOL_BY=JOBNAME\|SUBDATE\|JOBUSER Note: If any other value is specified, then the spool records are sorted based on the JOBNUMBER (JOBID).
ES_JES_SPOOL_ORDER	The order in which the spool list is displayed when you first open ESMAC. ES_JES_SPOOL_ORDER=1\|`any` 1 Spool list displayed in descending order. any Any value other than 1 displays the spool list in ascending order. This is the default.
ES_OPEN_CAT_ON_DEMAND	Determines if additional catalogs (as specified using MFUSERCAT_NODE) are opened when the system starts, or only opened when required. ES_OPEN_CAT_ON_DEMAND=Y\|N Default is `N`.
ES_PL1_MFFH_JCL	Enables you to run Open PL/I programs that access JCL data definitions. The default value is N. ES_PL1_MFFH_JCL=Y\|N
ES_PROG_PATH	Set ES_PROG_PATH=Y to display the program's load path in the JESYSMSG and SYSLOG datasets. Note: This is only applicable for native enterprise server regions.
ES_OLD_DYN_PDS	Determines the resulting behavior of dynamic PDS members when specified in a JCL DD statement. Set to Y to enable previous default behavior of creating the physical files and cataloging PDS members when specified in a JCL DD statement. Set to N (the default), the physical files are only created and cataloged when using a JCL utility or user program. ES_OLD_DYN_PDS=Y\|N Default is `N`.
ES_SAM_ESDS	Under VSE, when this is set to Y, opening an OUTPUT of a reusable ESDS file resets the file when the DISP is not specified in the DLBL statement. ES_SAM_ESDS=Y\|N
ES_SSTM_CICS	Location of the JCL used to initialize the SSTM CICS environment. ES_SSTM_CICS=`file-location`
ES_SSTM_IMS	Location of the JCL used to initialize the SSTM IMS environment. ES_SSTM_IMS=`file-location`
ES_SSTM_JOB_FLUSH_ACTIVE	By default, this is set to N. When set to Y, causes a CICS SSTM job to be removed from the Active queue when the region shuts down.
ES_SYSOUT_HOLD	Sysout held classes. ES_SYSOUT_HOLD=???
ES_USR_DFLT_JES	Allows you to override the default user when no user is logged on for JES authentication. ES_USR_DFLT_JES=Y\|N???
JES_PRINT_SPOOL_MSG	Specifies the disposition of the spool data set printing message (JES000029I). JES_PRINT_SPOOL_MSG=CONSOLE\|LOG\|SILENT CONSOLE The console.log file (default). LOG A special log file named PRNT_SPL_MSG_YYYY_MM_DD.DAT where YYYY_MM_DD is the current date. This file resides in the same directory as the spool files, and a new file is created every day. SILENT No messages. Use this option with caution, as you will have no audit log of your spool data sets. Note: This environment variable is introduced for high print load users, where print messages to the console impact system performance.
GDG_RESTART_UCC11_ONLY	Determines when GDG restart information should be written. Y GDG restart information is written, but only when ES_JES_RESTART=Y and MF_UCC11 is set (Y, YA, or M). This is the default. N GDG restart information is written even if MF_UCC11=N or is not set. (ES_JES_RESTART=Y must still be set.) GDG_RESTART_UCC11_ONLY=Y\|N
MF_ALIAS	Specifies program aliases. Each set (pair) is 16 characters long - 8 characters for the program-name, and 8 characters for the alias. You can specify up to 10 pairs. This list is searched first and thus can potentially override the built-in list. If not found, the built-in alias table is searched. An entry shorter than 8 characters must have trailing spaces extending its length to 8 characters. MF_ALIAS=`program-name1` `alias1` [`program-name2` `alias2`] ...[`program-name10` `alias10`]
MFCATMNTUE	Specifies the name of the MFCATMNT user exit program if not compiled to the default name of MFCATMNTUE. MFCATMNTUE=`program-name` The default value is MFCATMNTUE.
MF_CHARSET	Specifies which character set an enterprise server is to use. MF_CHARSET=A\|E\|ASCII\|EBCDIC The default value is ASCII.
MF_DUPJOBS	Enables jobs with identical names to run. MF_DUPJOBS=Y\|N The default value is N.
MF_FALLTHRUCHECK	Specifies that MSS is to check that the main COBOL program ends by executing a GOBACK or STOP RUN. MF_FALLTHRUCHECK=Y\|N The default value is Y.
MF_JESPWR_EXIT	Used to pass JES2 and VSE PWR statements to the user exit MFJESPWR. If this environment variable is set, the JCL execution engine will call the exit program, MFJESPWR, whenever a JES2 or VSE PWR statement is encountered. It passes the contents of the JCL record plus Job and Job Step information. A sample MFJESPWR.cbl is included with the product. MF_JESPWR_EXIT= Y\|N The default value is N.
MF_JCL_AUDIT	Specifies that the audit log records audit information when a catalog entry is deleted. MF_JCL_AUDIT=DLET\|DLEJ\|DLET,DLEJ DLET Logs audit information each time an ESMAC/CAS utility deletes a catalog entry. DLEJ Logs audit information each time a step in a JCL job deletes a catalog entry. DLET,DLEJ Logs audit information each time either an ESMAC/CAS utility or a JCL job step deletes a catalog entry. The default is that this is not set.
MF_JES_ABEND_CAF_COMMIT[4]	Specify the outcome when a non-zero return code is received from the commit at the end of a DSNAL or IKJEFT** unit of work. MF_JES_ABEND_CAF_COMMIT=YES\|NO\|`rtn-code` YES an abend (S482) is generated. NO an abend is not generated. rtn-code a numeric value (up to 3 digits) to be used as the return code. The default is YES.
MF_MFA	Specifies what data set catalogs are to be searched. MF_MFA=ALL\|RJSE `ALL` - Search for data sets first in the local catalog, and if not found, on the mainframe (default). `RJSE` - Search for data sets in the local catalog only. No mainframe is performed.
MF_MVSJOB	Sets the number at which a job starts and finishes. MF_MVSJOB=`<lower value>`{-\|+}`<upper value>` Where: `<lower value>` Number at which a job starts. Contains 7 digits - for example, 0000001 - Sets the values but only on the first startup of the region. + Reset the values to these new ones each time the region is started. `<upper value>` Upper job number. Contains 7 digits - for example, 9999999 For example: set MF_MVSJOB=0000010+0000100 This resets the values to start with job number 10 and run through to job number 100. When the upper limit has been reached you receive a message: All job numbers in the range 0000010:0000100 are in use At this point you need to remove some jobs from the spool - you can use the spool housekeeping functions to do this. This environment variable can be used to enable a 7-digit Job number limit. If the <upper value> mentioned is greater than 99999, then 6+ digit job number support is enabled. The maximum value that can be set is 9999999. Tip: To revert to 5-digit job number support, set MF_MVSJOB=`<low number>`+`<high number>`, where `high number` is less than 0099999, and ensuring that the + sign is used to separate the low and high values. If a value set using this variable is not valid, the default values of <0001000>{-\|+}<0099999> are set.
MF_NODD	Specifies what action MSS is to take at run time if a job step uses a file that has not been allocated. MF_NODD=A\|R A Abend the program. This is the default. R Returns file status 3/5.
MF_PCRENAME_LAX	When an MVS data set is renamed, the associated physical file is normally renamed only if it is in the Default Allocation data set location. MF_PCRENAME_LAX=Y\|N\|D Y Enable physical files in other locations to be renamed if the cataloged name is changed. N Only physical files in the default allocation data set location are renamed. This is the default value. D Indicates that a new directory structure and filename will be constructed, and the existing file moved to that location.
MF_RCCF	Enables Remote Job Step Execution (RJSE). MF_RCCF=DELETEJOB\|KEEPJOB
MF_SMS	Enables support for SMS data classes. SMS is IBM's Storage Management Subsystem. MSS provides emulation for SMS data classes only. To enable DATACLAS support this variable needs to be set ON in addition to setting MFUSERCAT_NODE=SYSMFE1. MF_SMS=ON\|OFF The default value is OFF.
MF_SPOOL_HK_TESTDATE	Overrides the normal date for the spool housekeeping. MF_SPOOL_HK_TESTDATE=YYYYMMDD
MF_UCC11	Note: This environment variable works independently of the JCL RESTART parameter. Enables emulation of UCC11, a third party add-on to the mainframe that affects data set disposition processing. MF_UCC11=Y\|YA\|M\|MA\|MR\|N Y - When restarting a job with DISP=(NEW,CATLG), it will not result in job failure caused by the data set already being cataloged. YA - When running a job with DISP=(NEW,CATLG), it will not result in job failure caused by the data set already being cataloged. M, MA, MR - When restarting a job any data set that has an initial disposition of NEW is changed to MOD. Therefore, data will be appended to the data set if it already exists. N - MF_UCC11 is not set so a data set with an initial disposition of NEW may cause an error when restarting the job if the data set already exists. The setting of the MF_UCC11 value can be made on a job-by-job basis using either the JCL user exit, MFJUXIT, or the Advanced Restart Functionality.
MF_UCC11_DYNCLEAN	When UCC11 emulation is enabled, MF_UCC11=Y or YA, set this environment variable in order to control whether dynamically allocated datasets (such as using SVC99) are cleaned when a job is restarted. MF_UCC11_DYNCLEAN=Y\|N Y Default. When a job is restarted, any dynamically allocated datasets will be removed and replaced. N Prevents the cleaning of dynamically allocated datasets when restarting a job.
MF_USESCA7	Specifies that MSS accepts CA7 Scheduler control statements as comments rather than diagnosing them as errors. CA7 Scheduler control statements begin with # in column 1. MF_USESCA7=ON\|OFF The default value is OFF.
MFALLOC_DEF_VB_PCFILE [8]	When set to Y (the default), a new PS VB file that is created without an LRECL setting (or set to 0), is defined in the catalog as a VB file with default settings of minimum length = 0, and maximum length = 32760. Alternatively, set this variable to 'N' to ensure that the file is not created in these circumstances. MFALLOC_DEF_VB_PCFILE=Y\|N
MFALLOC_PCFILE	When set to Y, which is the default, it will cause a catalogued file to be created if DSORG=PS is provided in the DCB parameters. MFALLOC_PCFILE=Y\|N
MFJ_ALL_STEP_CHECK	The default behavior of this product is to not check COND CODES from steps prior to a restart step. This means that the steps after the restart step that have conditions that refer to any steps prior to the restart step might run. Micro Focus recommends that you review and test the behavior before restarting the jobs. Set this variable to Y to prevent steps after a restart step that have conditions that refer to any steps prior to the restart from running. MFJ_ALL_STEP_CHECK=N\|Y
MFJ_PTPCH_CODESET[4]	For use when an extended Japanese code set other than 9122 is being used. This will cause MFJPTPCH to check the same hexadecimal character value as with code set 9122 to decide if a character is printable or not. The only permissible value is EXTJ: MFJ_PTPCH_CODESET=EXTJ
MFJ_REPRO_EMPTY	Enables or disables the ability for the IDCAMS REPRO action to copy from a pristine VSAM file. MFJ_REPRO_EMPTY=Y\|N When set to Y, the resulting file will be empty. The default value is N, which will produce a JCLAM0150S error when attempted.
MFJSENGINE	Specifies which sort engine the utility MFJSORT is to emulate. MFJSENGINE=DFSORT\|SYNCSORT The default value is DFSORT.
MFJ_INPUTDS_ERROR	When set to N, will cause IEBDG, IEBGENER, IEBCOMPR, and DFSORT and ICETOOL emulation to treat missing input files as though they were present but empty. MFJ_INPUTDS_ERROR=Y\|N The default value is Y.
MFJ_STRICT_CASE	When set to Y, will cause MVSCATIO to honor the case of physical file names passed by the catalog API, and other utilities such as MFCATXML and MVSPCRN. When set to N, all physical file names will be folded into upper case. MFJ_STRICT_CASE=Y\|N The default is N.
MFJFAXIT	Specifies the user exit program that enables file action notifications. This user exit is called by the JCL engine whenever a JCL file is opened OUTPUT, I-O, or EXTEND, or when it is copied or renamed by the JCL engine. See User Exit for File Action Notifications for more information. A sample user exit program (MFJFAXIT.cbl) is provided with your product, and is located in the src\enterpriseserver\exits sub-directory of your product install directory. MFJFAXIT=`<path-and-file-name-of-exit>`
MFREXX_CHARSET	Specifies the character set used by the REXX engine when working with hexadecimal strings or performing string comparisons. MFREXX_CHARSET=A\|E A ASCII. This is the default value. E EBCDIC.
MFREXX_CONCAT	Specifies one or more characters to be used for the CONCAT operator in addition to REXX's default, which is "\|\|". MFREXX_CONCAT=char-spec One or more characters for each operator; each character you specify is used in addition to the default operator. Each additional character must be defined within single or double quotes, or in hexadecimal. Separate multiple characters with a space or a comma. Any error in the specification of the additional characters, including the specification of alphabetic or numeric characters, results in the environment variable being ignored.
MFREXX_LSEQ_RECSIZE_MAX	Specifies the record length for the REXX EXECIO command when reading or writing a line sequential file that has been cataloged with a record length of zero. MFREXX_LSEQ_RECSIZE_MAX=rec-length rec-length Record length to use. The minimum value you can specify is 255. Specifying an invalid value, or a value less than 255, results in the default value (255) being used.
MFREXX_NO_PROCESS_STDIN[10]	When set to "y" or "Y" this environment variable stops STDIN from being processed on an EXECIO command.
MFREXX_NOT	Specifies one or more characters to be used for the NOT operator in addition to REXX's default, which is "¬". MFREXX_NOT=char-spec char-spec One or more characters for each operator; each character you specify is used in addition to the default operator. Each additional character must be defined within single or double quotes, or in hexadecimal. Separate multiple characters with a space or a comma. Any error in the specification of the additional characters, including the specification of alphabetic or numeric characters, results in the environment variable being ignored.
MFREXX_OR	One or more characters to be used for the OR operator in addition to REXX's default, which is "\|". MFREXX_OR=char-spec char-spec One or more characters for each operator; each character you specify is used in addition to the default operator. Each additional character must be defined within single or double quotes, or in hexadecimal. Separate multiple characters with a space or a comma. Any error in the specification of the additional characters, including the specification of alphabetic or numeric characters, results in the environment variable being ignored.
MFSYSCAT	The location of the JES system catalog. MFSYSCAT=cat-file cat-file The fully-qualified location and name of the system catalog file to use. For a database-hosted system catalog, you need to include the full SQL URL, for example, sql://localhost/JCLTEST/catalog.dat?folder=/JCLDEMO See the data category in The dbfhdeploy Command Line Utility for full notation details if specifying a database-hosted system catalog.
MFUSERCAT_BASE_LOC	If an entry in MFUSERCAT_LOC only specifies the file name of a user catalog rather than the full path and file name, use this environment variable to specify where these catalogs are located. MFUSERCAT_BASE_LOC=C:\User\catalogs If multiple user catalog files are in the same location - for example, `C:\USERCATALOGS` or `$$MYFILESHARE` - use this environment variable to store that location. Then, you only need to specify the file name of the catalog in MFUSERCAT_LOC.
MFUSERCAT_LOC	The location of the node(s) set in MFUSERCAT_NODE, separated by semi-colons if more than one is specified. MFUSERCAT_LOC=`file-location(s)` This is not set by default.
MFUSERCAT_NODE	Sets additional SMS, SPOOL and User catalogs. To enable support for the SMS entities DATACLAS and MGMTCLAS, this variable needs to be set in addition to setting MF_SMS=ON. MFUSERCAT_NODE=`node` This is not set by default.
SSTM_WC_REFRESH	Determines how often the write count for the SSTM job is updated in SYSOUT or SYSPRINT. You can set a value between 1-65535 to indicate the number of writes at which the count is updated. A value of 0 (zero) indicates that the count is only updated when the file is closed. Any other value smaller that 1 will default to 0, and any value larger than 65535 will default to 65535. SSTM_WC_REFRESH=`write-count`
VSE_STARTUP_CFG	The location of the VSE JCL configuration file. VSE_STARTUP_CFG=config-file config-file The fully-qualified location and name of the configuration file to use.

ES_JES_OUTLIM=NUMBER | (NUMBER,WARNING | CANCEL | DUMP)