MFBSIJCL Command Line Parameters

MFBSIJCL uses two sets of command line parameters. The parameter sets are optionally delimited by END [space-END-space].

One parameter set corresponds exactly to the parameters used by the CASSUB and CASOUT commands. See online help for details on these commands. With MFBSI, the parameters -j and -x let you use OS environment variables in the path specification. See the description of the mfbsi.cfg parameter JCL-Submit for details.

The other parameter set is specific to MFBSI as shown.

Parameter Description
SJOBID Specifies the MFBSIJCL output destination. Required when SJOBID is not defined in mfbsi.cfg or when not using a configuration file.
  • SJOBID=[JobId]. The internal Job ID assigned by the scheduler. This creates a log file containing the CASSUB or CASOUT outputs and includes the JCL execution return code. The log file is named by the Job Id used (jobID.log).
  • SJOBID=JCL. The output log file name is set to the submitted JCL member name.
  • SJOBID=JOBNO. The output log file name is set to the job number assigned by the Enterprise Server/MSS JCL.
  • SJOBID=STDOUT. No log file is created. The MFBSIJCL output is directly written to the console (STDOUT).

Specifying the JESYSMSG parameter includes the Enterprise Server SysMsg log in the log file or STDOUT output.

REGION=ESregionName When using a custom MFBSI_DIR setting (where the last part of the MFBSI_DIR path does not specify the region name), specifies the Enterprise Server region name to be used.
STARTUPTIMEOUT=nnnn The timeout period in seconds between the job submission and the Enterprise Server job start. Optional.

A value of 0 specifies an infinite wait. The default value is 300 (seconds).

You can use the MFBSIALR module to send an alert to the scheduler when the startup timeout period is reached.

RUNTIMEOUT=nnnn The timeout period in seconds between the Enterprise Server job start and job end. Optional.

A value of 0 specifies an infinite wait. The default value is 900 (seconds).

You can use the MFBSIALR module to send an alert to the scheduler when the run timeout period is reached.

JCLExit=moduleName Specifies a user exit module to call before job submission to Enterprise Server/JCL. Optional.

This user exit lets you modify the parts of the JCL such as parameters substitution, and return the full name of a new JCL file to be submitted. If needed, use JCLExitID to pass an identification string to the user exit.

TerminateExit=moduleName Specifies a module to call just before terminating the MFBSIJCL process. Optional.
JESYSMSG Extracts the Sysmsg log produced by Enterprise Server for the job and includes it in the specified output destination, which is either a log file or STDOUT. Optional.
PARMS … [ENDPARMS] Used to define substitution pairs (parameterName=parameterValue). Optional.

See the topic on parameters substitution for details.

AUTOEDIT If PARMS … END-PARMS is not specified, this invokes the symbolic parameter substitution module to translate systems parameters. Optional.

See the topic on parameters substitution for details.

CFG=[path/][filename][.ext] Specifies a file to use as an alternate mfbsi.cfg parameters file. Optional.

The folder specified by $MFBSI_DIR is used if no path is specified. The extension .cfg is used if no extension is specified.

CASAPI=ON|OFF|YES|NO Uses the CASSUB/CASOUT API call interfaces to submit the job, monitor the JCL region, and retrieve the JESYSMSG output. Optional.

By default, MFBSIJCL uses CASSUB/CASOUT external commands to submit the job, monitor the JCL region and retrieve the JESYSMSG output. Set this parameter to ON or YES for improved performance and tighter security.

Note: Do not use special configuration settings for the COBOL file handler (EXTFH) in the environment where MFBSIJCL is running. For example, do not use STRIPSPACE=OFF. If needed, you can specify special EXTFH parameters at the region level. Contact Micro Focus Support regarding EXTFH parameters.