JCL-specific environment variables

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

CTM_SPACE [2]
Enables you to change the default MFBSI behavior for handling spaces in AutoEdit variable values to mimic the z/OS behavior.
Syntax
CTM_SPACE={[ON|YES]|[OFF|NO]}
Parameters
ON|YES
Handle spaces using the MFBSI behavior, meaning allow embedded spaces in CTM variables.
OFF|NO
Handle spaces using the z/OS behavior, meaning do not allow embedded spaces in CTM variables.
Default
CTM_SPACE=ON
Comments
Control-M (CTM) for z/OS does not support embedded spaces in variable values. The default CTM behavior of MFBSI supports spaces, and in the case of AutoEdit variable values, removes the spaces and assigns the rest of the value to the variable. To mimic the z/OS behavior for handling spaces in AutoEdit variables, set CTM_SPACE=OFF.
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.

Syntax

SET ES_ALLOC_EXPAND=value

Values

Y Expands an environment variable used to specify an allocation path.

N Do not expand the variable used in the path.

Default

The default value is Y.

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.

Syntax

SET ES_ALLOC_OVERRIDE=rules-file

Values

rules-file The file path and name of the dataset rules file.

ES_CAT_RETRY_COUNT
Determines the number of attempts made to open a catalog file that has produced an error when the initial attempt to open it was made.
Syntax
ES_CAT_RETRY_COUNT=n
Parameter
n
The number of attempts made to open a catalog file.
Properties
Default: ES_CAT_RETRY_COUNT=0
Comments
Use this variable in conjunction with the ES_CAT_RETRY_WAIT variable, which determines how long to wait in between each attempt.

Take care when setting these variables as they could impact the time taken to report an error and therefore will delay processing of a job whilst the checks take place. These variables can be useful if you experience file access problems (for example, network connection drop-outs) that only last a second or two, so that it gives the system a chance to recover, before aborting.

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.
Syntax
ES_CAT_RETRY_WAIT=n
Parameter
n
The number of seconds to wait between attempts made to open a catalog file.
Properties
Default: ES_CAT_RETRY_WAIT=0
Comments

Use this variable in conjunction with the ES_CAT_RETRY_COUNT variable, which determines how many attempts to make to open a catalog file that initially failed to open.

Take care when setting these variables as they could impact the time taken to report an error and therefore will delay processing of a job whilst the checks take place. These variables can be useful if you experience file access problems (for example, network connection drop-outs) that only last a second or two, so that it gives the system a chance to recover, before aborting.

ES_DSENQSHR
Enable and configure handling of the DSENQSHR keyword when it is specified on the JCL job card, and when it is not specified on the job card.
Syntax
ES_DSENQSHR={ALLOW|AUTO|DISALLOW}
Parameters
ALLOW
For JCL jobs that have the DSENQSHR keyword specified on the JCL job card, sets DSENQSHR to the value specified on the job card. For jobs that do not have the DSENQSHR keyword specified on the JCL job card, sets DSENQSHR=ALLOW for each of those jobs.
AUTO
Use the value specified on the JCL Job card, which sets ES_DSENQSHR to ALLOW when that value is either ALLOW or USEJC, and DISALLOW otherwise.
DISALLOW
For jobs that do not have the DSENQSHR keyword specified on the JCL job card, sets DSENQSHR=DISALLOW for each of those jobs.
Properties
Default: ES_CAT_RETRY_WAIT=ES_DSENQSHR=DISALLOW
Comments
When ES_DSENQSHR is not set, the value of DSENQSHR on the JCL job card is used. In this case, if DSENQSHR is set to USEJC on the job card, ES_DSENQSHR is set to DISALLOW.

When DSENQSHR is allowed on a job, exclusive dataset locks are downgraded to SHARED after performing the last step that requires an exclusive lock.

Exclusive locks resulting from a dynamic exclusive enque (for example an IDCAMS DELETE operation) are maintained as exclusive until the end of the job regardless of the DSENQSHR setting.

Use VSAM Shareoptions with VSAM datasets. You can enable these using the ES_SHAREOPT=Y environment variable.

ES_IEBGEN_TO_ICEGEN
Determines enablement of VSAM copy using the MFGENER utility.
Syntax
ES_IEBGEN_TO_ICEGEN={Y|N}
Parameters
Y
Enables VSAM copy using the MFGENER utility.
N
Disables VSAM copy using the MFGENER utility.
Properties
Default: ES_IEBGEN_TO_ICEGEN=N
ES_JES_BYTES
Maximum number of bytes to output in a job before taking the action specified by cancelling the job, cancelling the job and dumping memory contents, or issuing a warning message.
Syntax
ES_JES_BYTES=(number[,{WARNING|CANCEL|DUMP}])
Parameters
number
Maximum number of bytes in thousands. The range is from 0-99999999.
WARNING
Issue a warning when the specified maximum number of bytes is reached.
CANCEL
Cancel the job when the specified maximum number of bytes is reached.
DUMP
Cancel the job and dump the memory contents when the specified maximum number of bytes is reached.
Properties
Default: None
Example
ES_JES_BYTES=(100,DUMP)

Each line is assumed to hold 132 bytes; therefore the job is automatically cancelled at 100000/132 lines, and the memory contents are dumped.

ES_JES_CARDS
Maximum number of cards to output in a job before taking the action specified by cancelling the job, cancelling the job and dumping memory contents, or issuing a warning message.
Syntax
ES_JES_CARDS=(number[,{WARNING|CANCEL|DUMP}])
Parameters
number
Maximum number of cards. The range is from 0-99999999.
WARNING
Issue a warning when the specified maximum number of cards is reached.
CANCEL
Cancel the job when the specified maximum number of cards is reached.
DUMP
Cancel the job and dump the memory contents when the specified maximum number of cards is reached.
Properties
Default: None
Example
ES_JES_CARDS=(30,WARNING)

Each card is assumed to hold 25 lines; therefore at 750 lines (25×30) a warning message is issued the job continues.

ES_JES_CONSOLE_MESSAGES
Determines whether to lodge CASMG0001I messages in the splmsg.dat list for a job.
Syntax
ES_JES_CONSOLE_MESSAGES={Y|N}
Parameters
Y
Lodges CASMG0001I messages in the splmsg.dat list for a job.
N
Does not lodge CASMG0001I messages in the splmsg.dat list for a job.
Properties
Default: ES_JES_CONSOLE_MESSAGES=Y
Comments
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. 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.

There is a way to work around this, if your program outputs a lot of messages. You can set ES_JES_CONSOLE_MESSAGES=N in order to avoid storing the messages in splmsg.dat. Whatever this setting, the CASMG0001I messages will still be included in the JESYSMSG for the job.

There is also a Job statement extension so that this can be configured on a job by job basis - see the line below. See JOB Statement Extensions for more details.

//*MFE:%CONSOLE_MSGS=Y|N
ES_JES_DELAY_MEM_ENQ
Determines whether to delays the exclusive enque of a new (not previously existing) PDS member until the file is opened.
Syntax
ES_JES_DELAY_MEM_ENQ={Y|N}
Parameters
Y
Delay the exclusive enque of a new (not previously existing) PDS member until the file is opened.
N
Do not delay the exclusive enque of a new (not previously existing) PDS member until the file is opened.
Properties
Default: ES_JES_DELAY_MEM_ENQ=N
Comments
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_DISABLE_RESTART_FLUSH
Indicates whether jobs in a specific enterprise server region are moved from the Active queue to the Complete queue when the region is restarted.
Syntax
ES_JES_DISABLE_RESTART_FLUSH={Y|N}
Parameters
Y
Move jobs in the region from the Active queue to the Complete queue when the region is restarted.
N
Do not move jobs in the region from the Active queue to the Complete queue when the region is restarted.
Properties
Default: None
ES_JES_ENFORCE_EXPIRE_DATE

Determines whether or not to check the expiration date when deleting a catalogued dataset, and if expired, delete the dataset.

Note: Use the PURGE keyword to delete non-expired datasets.
Syntax
ES_JES_ENFORCE_EXPIRE_DATE={Y|N}
Parameters
Y
Check the expiry date and delete expired datasets.
N
Do not check the expiration date.
Properties
Default: ES_JES_ENFORCE_EXPIRE_DATE=Y
ES_JES_FREE_SSTM_SYSOUT
Determines whether to free the memory assigned to store details about each CICS spool file that you create using the CICS Spool Write API's, once the spool file has been created.

This helps avoid problems with receiving 'out of memory' errors, when creating multiple new files.

Warning: Setting the variable also removes the tracking information about the file which means that the file's status (SPOOLED) no longer appears in the JESYSMSG for the SSTM job.
Syntax
ES_JES_FREE_SSTM_SYSOUT={Y|N}
Parameters
Y
Free the memory assigned to store details about each CICS spool file.
N
Do not free the memory assigned to store details about each CICS spool file.
ES_JES_HIGHER_SECURITY_LEVEL
Determines which programs are loaded based on checks made against the list of SYS1.LNKLIB entries.
Syntax
ES_JES_HIGHER_SECURITY_LEVEL={0|[1|NONE][2|BASIC][3|WARN][4|ENHANCED]}
Parameters
0
The behavior is unchanged with regard to JES enhanced security.
1|NONE
A value of 1 or NONE is the equivalent of not setting the value and maintains the behaviour of earlier versions of Enterprise Server. With a setting of 1 or no setting at all, warning messages about the number of SYS1.LNKLIB entries might be issued if none have been defined (JES000067W) and messages about programs not being loaded from certain locations (JES000069W) are also given. In addition, messages JCLCM0260W and JCLCM0308W might also be issued.
2|BASIC
A level of BASIC or 2 causes programs to be loaded from the list of SYS1.LNKLIB entries, STEPLIB, and JOBLIB locations. Programs in other locations are not loaded. The loading of programs from dynamic PDSs is also entirely disabled.
3|WARN
A level of WARN or 3 causes checks to be made against the PROGRAM and the PHYSFILE security classes. The PHYSFILE check is to make sure the PHYSFILE resource class is implemented. If these checks fail, a warning message (JCLCM0262W, JCLCM0263W or JCLCM0266W) is issued.
4|ENHANCED
A level of ENHANCED or 4 will cause the same PROGRAM and PHYSFILE checks to be made but if they fail then the job will abend with an S913 security error and a suitable message will be issued to indicate the failure.
Properties
Default: ES_JES_HIGHER_SECURITY_LEVEL=1
ES_JES_LINES
Maximum number of lines to output in a job before taking the action specified by cancelling the job, cancelling the job and dumping memory contents, or issuing a warning message.
Syntax
ES_JES_LINES=(number[,{WARNING|CANCEL|DUMP}])
Parameters
number
Maximum number of lines in thousands. The range is from 0-99999999.
WARNING
Issue a warning when the specified maximum number of lines is reached.
CANCEL
Cancel the job when the specified maximum number of lines is reached.
DUMP
Cancel the job and dump the memory contents when the specified maximum number of lines is reached.
Properties
Default: None
Example
ES_JES_LINES=(100,CANCEL)
Each card is assumed to hold 25 lines; therefore at 750 lines (25×30) a warning message is issued the job continues. Limit the number of lines output to 100000. When this limit is reached cancel the job. This results in an S722 Output limit exceeded system abend code being produced.
ES_JES_OUTLIM
Maximum number of lines to output to a particular dataset before calling the user exit, processing any global limits, and then cancelling the job.
Syntax
ES_JES_OUTLIM=(number[,{WARNING|CANCEL|DUMP}])
Parameters
number
Maximum number of lines of output before taking action. The range is from 1-16777215.
WARNING
Issue a warning when the specified maximum number of lines of output is reached.
CANCEL
Cancel the job when the specified maximum number of lines of output is reached.
DUMP
Cancel the job and dump the memory contents when the specified maximum number of lines of output is reached.
Properties
Default: None
Example
ES_JES_OUTLIM=5000
A warning is issued when 5000 lines of output is exceeded.
ES_JES_OUTLIM=(1000,CANCEL)
Comments
Individual OUTLIM values can be set on each SYSOUT dataset. For example,//SYSPRINT DD SYSOUT=*,OUTLIM=500.
ES_JES_PAGES
Maximum number of pages to output in a job before taking the action specified by cancelling the job, cancelling the job and dumping memory contents, or issuing a warning message.
Syntax
ES_JES_PAGES=(number[,{WARNING|CANCEL|DUMP}])
Parameters
number
Maximum number of pages. The range is from 0-99999999.
WARNING
Issue a warning when the specified maximum number of pages is reached.
CANCEL
Cancel the job when the specified maximum number of pages is reached.
DUMP
Cancel the job and dump the memory contents when the specified maximum number of pages is reached.
Properties
Default: None
Example
ES_JES_PAGES=10
Each page is assumed to hold 60 lines; therefore when 600 lines (60×10) have been processed, a warning is issued and the job continues.
ES_JES_PARM_INIT_LOW
Determines whether the parameter string passed to a program executed by JCL is initialized to low-values or to spaces.
Syntax
ES_JES_PARM_INIT_LOW={Y|N}
Parameters
Y
Initialize the parameter string to low-values.
N
Initialize the parameter string to spaces.
Properties
Default: ES_JES_PARM_INIT_LOW=N
ES_JES_RESTART
Determines whether JCL restart processing is enabled.
Syntax
ES_JES_RESTART={Y|N}
Parameters
Y
Enables JCL restart processing.
N
Disables JCL restart processing.
Properties
Default: ES_JES_RESTART=N
ES_JES_SORT_SPOOL_BY
Specifies which column is initially used to sort the spool records in casrdo41.
Syntax
ES_JES_SORT_SPOOL_BY={JOBNAME|SUBDATE|JOBUSER}
Parameters
JOBNAME
Sort by job name.
SUBDATE
Sort by sub date.
JOBUSER
Sort by job user.
Properties
Default: None
ES_JES_SPOOL_ORDER
The order in which the spool list is displayed when you first open ESMAC.
Syntax
ES_JES_SPOOL_ORDER=value
Values
  • 1 - Displays the list in descending order by JOBID. Any other value displays it in ascending order.

Default
By default the list is displayed in ascending order by JOBID.
ES_JESYSMSG_OUTPUT
The status of the system messages spool files (JESYSMSG) is set to Output, rather than Out Hold.
Syntax
ES_JESYSMSG_OUTPUT={Y|N}
Parameters
Y
All job messages will have the status as Output, but will only actually print (either physically or logically) if the MSGCLASS of the job matches one of the sysout classes defined to an active printer.
N
Messages are set to Out Hold
Properties
Default: ES_JESYSMSG_OUTPUT=N
ES_JESYSMSG_RESTRICTED
Holds back spool files based on their class when the status of the system message spool files are set to Output.
Syntax
ES_JESYSMSG_RESTRICTED={class-name|class-number}[class-name|class-number][...]]
Parameters
class-name
The name of a class.
number
A number representing the class.
Properties
Default: ES_JESYSMSG_RESTRICTED=N
Example
The following:
ES_JESYSMSG_RESTRICTED=ABC123
Specifies classes A, B, C, 1, 2, and 3.
Comments
All job messages have an Output status, but print either physically or logically only when the MSGCLASS of the job matches one of the sysout classes defined to an active printer.
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.
Syntax
ES_OPEN_CAT_ON_DEMAND={Y|N}
Parameters
Y
When the enterprise server region starts, no attempt is made to open the catalogs specified in MFUSERCAT_NODE. Only the system catalog is opened initially, and the other nodes are opened when required.
N
When the enterprise server region starts, all nodes are opened.
Properties
Default: ES_OPEN_CAT_ON_DEMAND=N
Comments
When ES_OPEN_CAT_ON_DEMAND=N is set and there is a problem opening any of the nodes specified in MFUSERCAT_NODE, the JES system will not start.
ES_PL1_MFFH_JCL
Enables you to run Open PL/I programs that access JCL data definitions.
Syntax
ES_PL1_MFFH_JCL=Y|N
Values

Y You can run Open PL/I programs that access JCL data definitions.

N Open PL/I programs cannot access JCL data definitions.

Default

The default value is N.

ES_OLD_DYN_PDS
Determines the resulting behavior of dynamic PDS members when specified in a JCL DD statement.

Values

Y Enables previous default behavior of cataloging and creating the physical files for dynamic PDS when referenced in a JCL DD statement.

N Physical files for dynamic PDS members are only created and cataloged when created using the JCL utility or by a user program.

Default

The default value is N.

ES_PROG_PATH
Determines whether to display the program's load path in the JESYSMSG and SYSLOG datasets.
Note: Applies to native enterprise server regions only.
Syntax
ES_PROG_PATH={Y|N}
Parameters
Y
Display the program's load path in the JESYSMSG and SYSLOG datasets.
N
Do not display the program's load path in the JESYSMSG and SYSLOG datasets.
Properties
Default: None
ES_SAM_ESDS
Under VSE and when opening the OUTPUT of a reusable ESDS file, determines whether the file is reset when the DISP is not specified in the DLBL statement.
Syntax
ES_SAM_ESDS={Y|N}
Parameters
Y
File is reset.
N
File is not reset.
Properties
Default: None
ES_SSTM_CICS
Location of the JCL used to initialize the SSTM CICS environment.
Syntax
ES_SSTM_CICS=file-location
Parameters
file-location
The full path to the location of the JCL used to initialize the SSTM CICS environment.
Properties
Default: None
ES_SSTM_IMS
Location of the JCL used to initialize the SSTM IMS environment.
Syntax
ES_SSTM_IMS=file-location
Parameters
file-location
The full path to the location of the JCL used to initialize the SSTM IMS environment.
Properties
Default: None
ES_SSTM_JOB_FLUSH_ACTIVE
Determines whether a CICS SSTM job is removed from the Active queue when the region shuts down.
Syntax
ES_SSTM_JOB_FLUSH_ACTIVE =file-location
Parameters
Y
Remove the CICS SSTM job from the Active queue.
N
Do not remove the CICS SSTM job from the Active queue.
Properties
Default: ES_SSTM_JOB_FLUSH_ACTIVE=N
ES_SYSOUT_HOLD
Determines whether the status of the SYSOUT files are set to Out Hold.
Syntax
ES_SYSOUT_HOLD={Y|N}
Parameters
Y
The status of the SYSOUT files are set to Out Hold.
N
The status of the SYSOUT files are not set to Out Hold.
Properties
Default: None
ES_USR_DFLT_JES
Allows you to override the default user when no user is logged on for JES authentication.

Syntax

SET ES_USR_DFLT_JES=user

Values

  • user The deafult user name.

Default

JESUSER

Note: Micro Focus recommends that you use the Advanced Region Properties page in the Enterprise Server Common Web Administration (ESCWA) interface to configure this environment variable. See Advanced Region Properties for more information.
JES_PRINT_SPOOL_MSG
Specifies the disposition of the spool data set printing message (JES000029I).
Note: This environment variable is intended for high print load users, where print messages to the console impact system performance.
Syntax
JES_PRINT_SPOOL_MSG={CONSOLE|LOG|SILENT}
Parameters
CONSOLE
The console.log file.
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.
Properties
Default: JES_PRINT_SPOOL_MSG=CONSOLE
GDG_RESTART_UCC11_ONLY
Determines when GDG restart information should be written.
Syntax
SET GDG_RESTART_UCC11_ONLY={Y|N}
Parameters
Y
GDG restart information is written, but only when ES_JES_RESTART=Y and MF_UCC11 is set (Y, YA, or M).
N
GDG restart information is written even if MF_UCC11=N or is not set. (ES_JES_RESTART=Y must still be set.)
Properties
Default: SET GDG_RESTART_UCC11_ONLY=Y
JCLTEMP_DIR [6]
Enables you to specify a separate location for the JCLTEMP directory.
Syntax
JCLTEMP_DIR=path
Parameter
path
The full or relative path to the location of your JCLTEMP directory.
Default
Not set. Uses the directory specified by MFBSI_DIR.
MF_ALIAS
Specifies program aliases.
Note: You can alias any program other than IEFBR14, which is always processed as IEFBR14.
Syntax
MF_ALIAS=program-name1 alias1 [program-name2 alias2]...[program-name10 alias10]
Parameters
program-name1...10
An eight-character program name.
Important: A program name shorter than eight characters must have trailing spaces extending its length to eight characters.
alias1...10
An eight-character alias.
Important: An alias shorter than eight characters must have trailing spaces extending its length to eight characters.
Comments
Each program-name/alias pair is 16 characters long — eight characters for the program-name, and eight characters for the alias. You can specify up to 10 pairs.

program-name/alias pairs are searched first in the order in which they appear and thus can potentially override the built-in list. If not found, the built-in alias table is searched.

Example
MF_ALIAS=IKJEFT1BIDAEFT01MYPROG  THEIRPRG
adds:
Program-name Alias
IKJEFT1B IDAEFT01
MYPROG THEIRPRG
MF_CHARSET
Specifies which character set an enterprise server is to use.
Syntax
MF_CHARSET={[A|ASCII]|[E|EBCDIC]}
Parameters
A|ASCII
Use the ASCII character set.
E|EBCDIC
Use the EBCDIC character set.
Properties
Default: MF_CHARSET= ASCII
MF_DUPJOBS
Specifies whether jobs with duplicate names are allowed to run in parallel.
Syntax
MF_DUPJOBS={Y|N}
Parameters
Y
Jobs with duplicate names are allowed to run in parallel.
N
Jobs with duplicate names are not allowed to run in parallel.
Properties
Default: MF_DUPJOBS=N
MF_FALLTHRUCHECK
Specifies whether MSS is to check that the main COBOL program ends by executing a GOBACK or STOP RUN.
Syntax
MF_FALLTHRUCHECK={Y|N}
Parameters
Y
Check that the main COBOL program ends by executing a GOBACK or STOP RUN.
Y
Do not check that the main COBOL program ends by executing a GOBACK or STOP RUN.
Properties
Default: MF_FALLTHRUCHECK=Y
Comments
If MF_FALLTHRUCHECK is set to Y and the check fails, MSS issues this message:
JCLCM0213S Main pgm xxxxxxxx did not issue GOBACK or STOP RUN. 
MF_IKJEFT_KEEP_MAX
Determines whether IKJEFT01 uses the last return code from a command or the highest return code of all commands executed as the step COND CODE.
Syntax
MF_IKJEFT_KEEP_MAX={Y|N}
Parameters
Y
IKJEFT01 uses the highest return code of all commands executed as the step COND CODE.
N
IKJEFT01 uses the last return code from a command as the step COND CODE.
Properties
Default: MF_IKJEFT_KEEP_MAX=N
MF_JCL_AUDIT
Syntax
MF_JCL_AUDIT={DLET|DLEJ|DLET,DLEJ}
Parameters
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.
Properties
Default: None
Comments
The information recorded in the log is:
  • The user who deleted the catalog entry
  • The group to which the user belongs
  • Whether the catalog entry was deleted by an ESMAC user or a JCL job step
  • The name of the deleted catalog entry
  • Whether the standard delete operation or the JCL delete operation was performed
Example
The following is an example of the audit event passed to SYSLOG:
mf.jcl 35500 5:5 [timeQuality tzKnown="1" isSynced="0"][origin ip="127.0.0.1" enterpriseID="********.5043" 
software="Micro Focus Auditing" swVersion="API ver 1.2.2 syslog ver 1.0.0"][meta 
sequenceId="88"][MFAuditPropertyList@5043 SYSTEM="AUDIT   "] userid=SYSAD    groupid=SYSADM 
  jobnum=0000000 jobname=ESMAC    dsname=MFI01.ANF.TEST1                         
     member=         api=MVSCATIO apifunc=DLET 
MF_JES_ABEND_CAF_COMMIT
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.
Syntax
MF_JES_ABEND_CAF_COMMIT=value
Value

value can be one of:

  • 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.
Default
Yes.
MF_JESPWR_EXIT
MF_JESPWR_EXIT is used to pass JES2 and VSE PWR statements to a 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.
Syntax
MF_JESPWR_EXIT=Y
MF_LEX_API [7]
Specifies whether the JES configuration uses single or multiple LEX files, and enables JES configuration to specify subdirectories for LEX files as necessary.
Syntax
MF_LEX_API={1|2|D}|1D|2D
Parameters
1
Use multiple LEX files.
2
Use a single LEX file. Disk-based access only.
D
Use directories to store LEX files.
Default
MF_LEX_API=1
Comments
Do mix these settings in a Region/PAC. They must be consistent for all.
MF_MFA
Specifies what data set catalogs are to be searched.
Syntax
MF_MFA={ALL|RJSE}
Parameters
ALL
Search for data sets first in the local catalog, and if not found, on the mainframe.
RJSE
Search for data sets in the local catalog only. No mainframe search is performed.
Properties
Default: MF_MFA= ALL
MF_MVSJOB
Sets the number at which a job starts and finishes.
Syntax
MF_MVSJOB=lower value{-|+}upper value
						
Parameters
lower value
Number at which a job starts. Contains seven digits - for example, 0000001.
+
Reset the values to these new ones each time the region is started.
-
Sets the values but only on the first startup of the region.
upper value
Upper job number. Contains seven digits - for example, 9999999.
Properties
Default: None*
* If a value set using this variable is not valid, the default values of <0001000>{-|+}<0099999> are set.
Comments

This environment variable can be used to enable a seven-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 five-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.

Example
set MF_MVSJOB=0000010+0000100

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.

MF_MVSP0034_LIMIT
Specifies the number of records in each exported catalog XML document.
Syntax
MF_MVSP0034_LIMIT=limit
Parameter
limit
A one- to six-digit number between 1 and 999999.
Properties
Default: None*
* If unset, then all records are written to the catalog export XML file.
MF_NODD
Specifies what action MSS is to take at run time if a job step uses a file that has not been allocated.
Syntax
MF_NODD={A|R}
Parameters
A
Abend the program
R
Return the file status 3/5.
Properties
Default: MF_NODD=A
MF_PCRENAME_LAX
Determines whether physical files in other locations can be renamed if the cataloged name is changed.
Syntax
MF_PCRENAME_LAX={Y|N|D}
Parameters
Y
Enables physical files in other locations to be renamed if the cataloged name is changed.
N
When an MVS dataset is renamed, the associated physical file is normally renamed only if it is stored in a subdirectory of the of the catalog file location.
D
Creates a new directory structure and filename, and moves the existing file to the new location.
Properties
Default: MF_PCRENAME_LAX=N
MF_RCCF
Determines whether to enable or disable Job Step Execution (RJSE).
Syntax
MF_RCCF={DELETEJOB|KEEPJOB}
Parameters
DELETEJOB
Disables RJSE.
KEEPJOB
Enables RJSE.
Properties
Default: MF_RCCF=DELETEJOB
MF_SMS
Enables support for IBM Storage Management Subsystem (SMS) data classes.
Syntax
MF_SMS={ON|OFF}
Parameters
ON
Turns on support for SMS data classes.
OFF
Turns off support for SMS data classes.
Properties
Default: MF_SMS=OFF
Comments
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_SPOOL_HK_TESTDATE
Overrides the normal date for the spool housekeeping.

Syntax

MF_SPOOL_HK_TESTDATE=YYYYMMDD

Values

YYYYMMDD The date which is to override the normal date.

Default

If this variable is not set, the normal date for the spool housekeeping is used.

MF_UCC11
Configures emulation of UCC11, which is the JCL job restart functionality.
Syntax
MF_UCC11={Y|YA|M|MA|MR|N}
Parameters
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 inital 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 might cause an error when restarting the job if the data set already exists.
Properties
Default: MF_UCC11=N
MF_UCC11_DYNCLEAN
When MF_UCC11 is enabled, controls whether dynamically allocated datasets (such as using SVC99) are cleaned when a job is restarted.
Syntax
MF_UCC11_DYNCLEAN={Y|N}
Parameters
Y
When a job is restarted, any dynamically allocated datasets are removed and replaced.
N
Prevents the cleaning of dynamically allocated datasets when restarting a job.
Properties
Default: MF_UCC11_DYNCLEAN=Y
Dependencies
Valid only when MF_UCC11=Y or YA.
MF_USESCA7
Determines whether MSS accepts CA7 Scheduler control statements as comments rather than diagnosing them as errors.
Syntax
MF_USESCA7={ON|OFF}
Parameters
ON
Accepts CA7 Scheduler control statements as comments.
OFF
Diagnoses CA7 Scheduler control statements as errors.
Properties
Default: MF_USESCA7=ON
MFALLOC_DEF_VB_PCFILE
Determines whether a new PSVB file is defined in the catalog.
Syntax
MFALLOC_DEF_VB_PCFILE={Y|N}
Parameters
Y
A new PS VB file is defined in the catalog as a VB file with default settings of minimum length = 0, and maximum length = 32760.
N
Do not create a new PS VB file.
Properties
Default: MFALLOC_DEF_VB_PCFILE=Y
Dependencies
Valid only when LRECL is not set or is set to 0 (zero).
MFALLOC_PCFILE
Determines whether a catalogued file is created when DSORG=PS is provided in the DCB parameters.
Syntax
MFALLOC_PCFILE={Y|N}
Parameters
Y
A catalogued file is created when DSORG=PS is provided in the DCB parameters.
N
A catalogued file is not created.
Properties
Default: MFALLOC_PCFILE=Y
Dependencies
Valid only when DSORG=PS is provided in the DCB parameters.
MFCATMNTUE

Specifies the name of the MFCATMNT user exit program if not compiled to the default name of MFCATMNTUE.

Syntax

SET MFCATMNTUE=program-name

Values

program-name represents the name of the MFCATMNT user exit program if not compiled to the default name of MFCATMNTUE.

Default

MFCATMNTUE=MFCATMNTUE

MFJ_ALL_STEP_CHECK
Use this variable to prevent any steps after a restart step that have conditions that refer to any steps prior to the restart from running.
Syntax
MFJ_ALL_STEP_CHECK={Y|N}
Parameters
Y
Do not run any steps after a restart step that have conditions that refer to any steps prior to the restart.
Y
Run the steps listed after a restart step that have conditions that refer to steps prior to the restart.
Properties
Default: MFJ_ALL_STEP_CHECK=N
Comments
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. This is a change of behavior from releases 4.0 Patch Update 1 and earlier when these steps would have not 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.

The setting of MFJ_ALL_STEP_CHECK is bypassed if the Abend and Cond Code Recover option of the Advanced Restart Functionality is used.

MFJ_INPUTDS_ERROR
Determines whether IEBDG, IEBGENER, IEBCOMPR, and DFSORT, and ICETOOL emulation treat missing input files as though they were present but empty.
Syntax
MFJ_INPUTDS_ERROR={Y|N}
Parameters
Y
Treats missing input files as missing.
N
Causes IEBDG, IEBGENER, IEBCOMPR, and DFSORT, and ICETOOL emulation to treat missing input files as though they were present but empty.
Properties
Default: MFJ_INPUTDS_ERROR=Y
MFJ_LEX_LOCATION
Specifies an alternative location for the storage of JCL lexigraphical files, which are created when a job is parsed, and are stored in the same directory as the job log by default.
Syntax
MFJ_LEX_LOCATION=path
Parameter
path
The full path to the alternative directory location in which to store JCL lexigraphical files. The alternative directory location must be accessible by all enterprise server regions that both submit and run jobs.
Properties
Default: None
MFJ_PTPCH_CODESET
Causes MFJPTPCH to check the same hexadecimal character value as with Japanese code set 9122 to decide whether a character is printable or not.
Syntax
MFJ_PTPCH_CODESET=EXTJ
Parameter
EXTJ
MFJPTPCH checks the same hexadecimal character value as with Japanese code set 9122 to decide whether a character is printable or not.
Properties
Default: None
Dependencies
For use only when an extended Japanese code set other than 9122 is being used.
MFJ_REPRO_EMPTY
Determines whether the IDCAMS REPRO action can copy from a pristine VSAM file.
Syntax
MFJ_REPRO_EMPTY={Y|N}
Parameters
Y
Enables the IDCAMS REPRO action to copy from a pristine VSAM file. The resulting file is empty.
N
Prevents the IDCAMS REPRO action from copying from a pristine VSAM file, and produces a JCLAM0150S error when attempted.
Properties
Default: MFJ_REPRO_EMPTY=Y
MFJ_STRICT_CASE
Determines the case to be maintained for physical file names passed to MVSCATIO by the catalog API (and other utilities such as MFCATXML and MVSPCRN).
Syntax
SET MFJ_STRICT_CASE=Y|N
Parameters
Y
MVSCATIO honors the case of physical file names passed by the catalog API, and other utilities such as MFCATXML and MVSPCRN.
N
All physical file names are folded into upper case.
Properties
Default: MFJ_STRICT_CASE=N
MFJFAXIT
Specifies the user exit program that enables file action notifications.
Syntax
MFJFAXIT=path-and-file-name
					
Parameter
path-and-file-name
The full path and filename for the user exit program that enables file action notifications.
Properties
Default: None
Comments
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.
Example
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.
MFJSENGINE
Specifies which sort engine the utility MFJSORT is to emulate.
Syntax
MFJSENGINE={DFSORT|SYNCSORT}
Parameters
DFSORT
MFJFSORT emulates the DSORT utility.
SYNCSORT
MFJFSORT emulates the SYNCSORT utility.
Properties
Default: MFJSENGINE=DFSORT
MFREXX_CHARSET
Specifies the character set used by the REXX engine when working with hexadecimal strings or performing string comparisons.
Syntax
MFREXX_CHARSET={A|E}
Parameters
A
Use the ASCII character set.
E
Use the EBCDIC character set.
Properties
Default: E
MFREXX_CONCAT
Specifies one or more characters to be used for the CONCAT operator in addition to REXX's default, which is "||".
Syntax
MFREXX_CONCAT=char-spec
Parameter
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.
Properties
Default: "||"
Comments
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.
Syntax
MFREXX_LSEQ_RECSIZE_MAX=rec-length
Parameter
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 being used.
Properties
Default: 255
MFREXX_NO_PROCESS_STDIN
Determines whether to stop STDIN from being processed on an EXECIO command.
Syntax
MFREXX_NO_PROCESS_STDIN={Y|N}
Parameters
Y
Stops STDIN from being processed on an EXECIO command.
N
STDIN is processed on an EXECIO command.
Properties
Default: MFREXX_NO_PROCESS_STDIN=N
MFREXX_NOT
Specifies one or more characters to be used for the NOT operator in addition to REXX's default, which is "¬".
Syntax
MFREXX_NOT=char-spec
Parameter
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.
Properties
Default: "¬"
Comments
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
Specifies one or more characters to be used for the OR operator in addition to REXX's default, which is "|".
Syntax
MFREXX_OR=char-spec
Parameter
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.
Properties
Default: "|"
Comments
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 and file name of the JES system catalog.
Syntax
SET MFSYSCAT={path\CATALOG.DAT | URL}
Parameters
path
The full path to the location of the CATALOG.DAT file.
URL
For a database-hosted system catalog, the full SQL URL that points to the CATALOG.DAT file.
Properties
Default: None
Comments
See the data category in The dbfhdeploy Command Line Utility for full notation details if specifying a database-hosted system catalog.
Examples
SET MFSYSCAT=C:\MY\CATALOG\FOLDER\CATALOG.DAT
SET MFSYSCAT=sql://localhost/JCLTEST/catalog.dat?folder=/JCLDEMO
MFUSERCAT_BASE_LOC
If an entry in MFUSERCAT_LOC only specifies the file name of the user catalog rather than the full path and file name, use this environment variable to specify where these catalogs are located.
Syntax
MFUSERCAT_BASE_LOC=path-and-file-name
Parameter
path
The full path to the file specified by the MFUSERCAT_LOC environment variable.
Properties
Default: None
Dependency
Valid only when the value of MFUSERCAT_LOC is a file name only.
Comments
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
Specifies the location and name of each additional catalog, matching the values provided in the MFUSERCAT_NODE value.
Syntax
MFUSERCAT_LOC=[path]file-name[;[path]file-name]][...]
Parameter
path
The full path to a file catalog file.
file-name
The name of the catalog file.
Properties
Default: None
Comments
Parameters are limited to a total of 4096 characters.

If multiple catalog files are in the same location, you can use the environment variable MFUSERCAT_LOC to store that location. If you do this, you only need to specify the file name of each catalog file in MFUSERCAT_LOC.

MFUSERCAT_NODE
Specifies additional SMS, SPOOL, and User catalogs.
Syntax
MFUSERCAT_NODE=node-name[,node-name][...]
Parameter
node-name
A user catalog or special node name.
Properties
Default: None
Comments
Use this variable to specify additional SMS, SPOOL and User catalogs. Up to 64 additional catalogs may be specified with semi-colon separated values (see Multiple Catalog Support for more details). The physical file used for each catalog is stored in the environment variable MFUSERCAT_LOC.

Each node can include wildcards. You can use * (for any number of characters) or ? (for a single character) in a node specification. You can also use the UNIX-style square bracket notation (part of the regular expression feature), where you specify a list of permissible characters at a particular point within the node specification; see Examples of Using Multiple Catalogs for more information.

To enable support for the SMS entities DATACLAS and MGMTCLAS, this variable needs to be set in addition to setting MF_SMS=ON.

Each node-name entry in MFUSERCAT_NODE must have a corresponding entry in MFUSERCAT_LOC.

Use the ES_OPEN_CAT_ON_DEMAND variable to determine if these catalogs are opened when the region starts, or only opened when they are required.

SPOOL_TIMEOUT
Enables greater control over record-lock retries by setting timeout and interval durations.
Syntax
SPOOL_TIMEOUT=timeout:interval
Parameters
timeout
The amount of time in milliseconds to continue to retry the lock before ceasing the attempt.
interval
The amount of time in milliseconds before initiating a new lock retry attempt.
Properties
Default: SPOOL_TIMEOUT=500:100
Comments
Set this environment variable to resolve reported record-locked messages, which, depending on hardware performance, can occur especially during shutdown of an enterprise server instance with an SSTM job.
SSTM_WC_REFRESH
Determines how often the write count for the SSTM job is updated in SYSOUT or SYSPRINT.
Syntax
SSTM_WC_REFRESH={0|value}
Parameter
0
The count is only updated when the file is closed.
value
A value between 1-65535 to indicate the number of writes at which the count is updated
Properties
Default: None
Comments
Any provided value outside of 0-65535 defaults to 65535.
VSE_STARTUP_CFG
The location of the VSE JCL configuration file.
Syntax
VSE_STARTUP_CFG=config-file
Parameter
config-file
The fully-qualified location and name of the configuration file to use.
Properties
Default: None