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 /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 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.
- 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}[2]
- 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[9]
- Sets MFBSI to return JESYMSG on success by default. You can change the default setting of JESYSMSG-ON-SUCCESS from 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.
- 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.