Environment variables for WebSphere MQ File Transfer Edition for z/OS

After customization and configuration, you must set a number of environment variables before running the configuration and administration scripts provided by WebSphere® MQ File Transfer Edition. You must set these variables for each user and in each environment that the scripts will be invoked from.

To avoid conflicts with other products, you can choose to create a .wmqfterc script in your home directory. The .wmqfterc script is then invoked by each of the WebSphere MQ File Transfer Edition scripts and you can use this script to provide custom environment settings for WebSphere MQ File Transfer Edition.
Note: You must include the _BPXK_AUTOCVT environment variable in your .profile, and not in your .wmqfterc script, to interpret the WebSphere MQ File Transfer Edition scripts.

There is also one optional environment variable, FTE_WTO, that you can set to send messages to the operator log when running agents from JCL.

Table 1. Required z/OS environment variables
Environment variable Value
_BPXK_AUTOCVT ON
FTE_JAVA_HOME The location of your Java™ installation. For more information about the levels of Java supported, see WebSphere MQ File Transfer Edition system requirements.
FTE_CONFIG The location of the WebSphere MQ File Transfer Edition for z/OS® configuration. This is the path to a directory that subdirectories and files are created in by the configuration scripts as the scripts are invoked. The directory structure will then be used by administration scripts and agents. All users making configuration changes and running agents require write access to this directory structure.
STEPLIB Must include the following WebSphere MQ data sets:
  • SCSQAUTH
  • SCSQANLE
  • SCSQLOAD
If you want to run the database logger component on a z/OS system, STEPLIB must also include the following DB2® data sets in the order shown:
  • SDSNEXIT
  • SDSNLOD2
  • SDSNLOAD
LIBPATH Must include the location of your WebSphere MQ Java libraries in z/OS UNIX System Services space (for WebSphere MQ Version 7, the default is /mqm/V7R0M0/java/lib).
The following is an example .profile that correctly configures the environment variables for WebSphere MQ File Transfer Edition:
LIBPATH=/mqm/V7R0M0/java/lib:$LIBPATH
STEPLIB=MQM.V700.SCSQAUTH:MQM.V700.SCSQANLE:MQM.V700.SCSQLOAD
PATH=/u/fteuser/bin:/u/fteuser/J5.0/bin:/bin:/usr/bin:/u/fteuser/extras/bin:/bin:$PATH
FTE_JAVA_HOME=/u/fteuser/J5.0
FTE_CONFIG=/u/fteuser/test/ftedata
_BPXK_AUTOCVT=ON
export PATH LIBPATH STEPLIB FTE_JAVA_HOME FTE_CONFIG _BPXK_AUTOCVT

Optionally, you can also set the following environment variable:

Table 2. Optional z/OS environment variable
Environment variable Value
FTE_WTO One of the following values:
  • YES
  • ON
  • TRUE

Enables z/OS logging. By default, this environment variable is disabled.

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


Reference Reference

Feedback

Timestamp icon Last updated: Tuesday, 30 January 2018
http://www.ibm.com/support/knowledgecenter/SSEP7X_7.0.4/com.ibm.wmqfte.doc/zos_envvar.htm