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 cassub and casout for more information. 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 for MFBSI as follows:

SJOBID

Specifies the MFBSIJCL output destination. Required when SJOBID is not specified 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

Optional, the timeout period in seconds between the job submission and the Enterprise Server job start.

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

Note: You can use the MFBSIALR module to send an alert to the scheduler when the startup timeout period is reached. See Sending Alerts to the Scheduler for more information.

RUNTIMEOUT=nnnn

Optional, the timeout period in seconds between the Enterprise Server job start and job end.

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

Note: You can use the MFBSIALR module to send an alert to the scheduler when the run timeout period is reached. See Sending Alerts to the Scheduler for more information.

JCLExit=moduleName

Optional, specifies a user exit module to call before job submission to Enterprise Server/JCL.

This user exit lets you modify the parts of the JCL such as parameters substitution, and returns 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

Optional, specifies a module to call just before terminating the MFBSIJCL process.

JESYSMSG

Optional, 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.

PARMS … [ENDPARMS]

Optional, used to define substitution pairs (parameterName=parameterValue).

See JCL Parameters Substitution Usage for more information.

AUTOEDIT

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

See JCL Parameters Substitution Usage for more information.

CFG=[path/][filename][.ext]

Optional, specifies a file to be use as an alternate mfbsi.cfg parameters file.

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

Optional, uses the CASSUB/CASOUT API call interfaces to submit the job, monitor the JCL region, and retrieve the JESYSMSG output.

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 security.