MFBSIJCL Command Line Parameters

MFBSIJCL uses two sets of command-line parameters. The parameter sets are optionally delimited by " END " [space-END-space]. Parameters may be alphanumeric, including special characters (for example, Ñ, Ç, ü, etc.).

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 /u and /p parameters enable you to specify credentials to run MFBSI with:

/uUserID
Authorization user ID.
/pPassword
Authorization password.

The other parameter set is specific for MFBSI as follows:

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.

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 is set to ON, which improves performance and security. Optional, set it to OFF or NO to use CASSUB/CASOUT external commands to submit the job, monitor the JCL region and retrieve the JESYSMSG output.

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.

CTM_SPACE={ON|OFF|YES|NO}
Enables you to change the default MFBSI behavior for handling spaces in AutoEdit variable values to mimic the z/OS behavior. The default of CTM_SPACE=ON (or =YES) handles spaces using the MFBSI behavior, meaning embedded spaces in CTM variables are allowed. When CTM_SPACE=OFF (or =NO) spaces are handled using the z/OS behavior, meaning embedded spaces in CTM variables are not allowed.
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.

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.
JESYSMSG-ON-SUCCESS={ON|OFF|YES|NO}
Sets MFBSI to return JESYMSG on success by default. You can change the default setting of JESYSMSG-ON-SUCCESS=YES to JESYSMSG-ON-SUCCESS=NO (or JESYSMSG-ON-SUCCESS=OFF) to set MFBSI to return JESYMSG in an error case (CC > 4) and to not return JESYMSG when successful.
MFBSISUB-ONLY
Allow asyncronhous MFBSI submission.
PARMS … [ENDPARMS]
Optional, used to define substitution pairs (parameterName=parameterValue).

See JCL Parameters Substitution Usage for more information.

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

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.
TerminateExit=moduleName
Optional, specifies a module to call just before terminating the MFBSIJCL process.