[z/OS]

z/OS JCL variables

You can use substitution values, JCL variables, and configuration properties in the BFGCUSTM script.

The following table lists the substitution values for the BFGCUSTM JCL script in an MFT command PDSE library data set. You must replace these substitution values with suitable values before you submit the BFGCUSTM job.

Table 1. Substitution values for the BFGCUSTM JCL script
Substitution variable Value
++library++ The data set name of the containing MFT command PDSE library.
++bfg_java_home++ The location of your Java installation.
++mq_path++ The path to the IBM® MQ for z/OS® UNIX System Services Components directory. For example, /mqm/V9R2M0. This is used to give the full path to the MFT installation, for example, /mqm/V9R2M0/mqft.
The following table describes the environment variables for the BFGSTDIN DD statement for the BFGCUSTM JCL script, in an MFT command PDSE library data set (in the [Variables] section). You must replace all variables that are specified with substitution values (that is, values enclosed in two plus signs, ++) with suitable values before you submit the BFGCUSTM job.
Table 2. Environment variables
Environment variable Value
LIBRARY The data set name of the containing MFT command PDSE library.
TMPDIR z/OS UNIX System Services directory for temporary files.
BFG_PROD The full path to the mqft directory under the IBM MQ for z/OS UNIX System Services Components directory; For example: /mqm/V9R2M0/mqft.
BFG_DATA The location of the data directory for Managed File Transfer for z/OS, which is the path to DATA_DIR.
BFG_JAVA_HOME The location of your Java installation.
BFG_JVM_PROPERTIES Optional. Sets a value for the BFG_JVM_PROPERTIES environment variable. These properties are passed to the Java virtual machine.
BFG_GROUP_NAME The mqm file group is typically associated with MFT configuration data files and commands. Consequently, all users who are members in the mqm group can access and make changes to the MFT configuration. For more information, see File system permissions for MFT in IBM MQ.
For a z/OS system, a file group is a z/OS UNIX System Services (z/OS UNIX) filesystem entity, and the mqm file group is not necessarily defined. You can associate a z/OS UNIX filesystem group for MFT configuration data files by using the BFG_GROUP_NAME environment variable. For example, at the z/OS UNIX shell prompt use: 
export BFG_GROUP_NAME=FTEGB
which defines a group FTEGB to be associated with any subsequently created configuration files for the current z/OS UNIX session.

You can set BFG_GROUP_NAME to a blank value, or remove it.

Note: When running BFGCUSTM for the first time, if the MFT configuration is to be used by multiple user IDs, it is important that BFG_GROUP_NAME is set to a group accessible to all required user ID's. If BFGCUSTM is run again, then BFG_GROUP_NAME must not be changed (otherwise, the z/OS UNIX group file permissions for all files and directories in the directory referenced by BFG_DATA must also be changed to reflect the new BFG_GROUP_NAME setting).
BFG_WTO z/OS logging is enabled when BFG_WTO is set to YES, ON, or TRUE. This controls whether messages that are written to the agent event log are also written to the z/OS operator log facility, which allows easier access for automation products when you run an agent from JCL. The routing code is Programmer Information (11) and the descriptor code is Informational (12).
SERVICE_TYPE Specifies whether the MFT command library is for an agent or logger. The valid values are AGENT or LOGGER.
NAME The name of the agent or logger for the SERVICE_TYPE value.
QMGR The name of the local queue manager that is associated with the agent or logger for the SERVICE_TYPE value.
OUTPUT_CLASS The ouput class for SYSOUT data sets. Defaults to * which requests the same output class as the MSGCLASS parameter from the job statement.
MQ_PATH The path to the IBM MQ for z/OS UNIX Components directory.
MQ_HLQ The high-level qualifier for IBM MQ data sets.
MQ_LANG The language that is required.
DB2_HLQ Optional. High-level qualifier for Db2® data sets.
JOBCARD1 Header line 1 for a JCL command job.
JOBCARD2 Header line 2 for a JCL command job.
JOBCARD3 Header line 3 for a JCL command job.
ADMIN_JOB1 Header line 1 for an admin job.
ADMIN_JOB2 Header line 2 for an admin job.
ADMIN_JOB3 Header line 3 for an admin job.
FTE_CONFIG Existing MFT configuration for migration. Set to a blank value if migration is not required.
CREDENTIAL_PATH Path to credentials file for migration, for example /u/user1/agent3. Required for migration commands BFGAGMG and BFGLGMG JCL scripts only. Set to a blank value if migration is not required. Note also that
DB_PROPS_PATH Specifies the database logger properties file for migration. This option is required only if the properties file does not use the following default name and path: config_directory/coordination_qmgr/databaselogger.properties. Set to a blank value if migration is not required.
The following table describes the mandatory MFT configuration properties for the BFGSTDIN DD statement for the BFGCUSTM JCL script in an MFT command PDSE library data set. You must replace properties specified with substitution values (that is, values enclosed in two plus signs, ++) with a suitable non-blank value before you submit the BFGCUSTM job. These properties define overrides for the MFT configuration properties. You can add agent and logger properties to customize agents or loggers for your environment. For a list of all properties, see Configuration properties files.
Table 3. Mandatory configuration properties for the BFGSTDIN DD statement
Property Value
coordinationQMgr The name of the coordination queue manager for the configuration that the agent or logger is associated with.
coordinationQMgrHost Optional. Host name of the system that the coordination queue manager is running on. If you leave the value for this property blank, a bindings mode connection is assumed.
coordinationQMgrPort Optional. Port number that the coordination queue manager is listening on. This parameter is used only if you also specify a non-blank value for the coordinationQMgrHost property.
coordinationQMgrChannel Optional. Channel to use to connect to the coordination queue manager. This parameter is used only if you also specify a non-blank value for the coordinationQMgrHost property.
connectionQMgr The name of the command queue manager for the configuration that the agent or logger is associated with.
connectionQMgrHost Optional. Host name of the system that the command queue manager is running on. If you leave the value for this property blank, a bindings mode connection is assumed.
connectionQMgrPort Optional. Port number that the command queue manager is listening on. This parameter is used only if you also specify a non-blank value for the connectionQMgrHost property.
connectionQMgrChannel Optional. Channel to use to connect to the command queue manager. This parameter is used only if you also specify a non-blank value for the connectionQMgrHost property.