After installing WebSphere MQ File Transfer Edition for z/OS
After you have installed on z/OS®, you must set environment variables then run the configuration scripts provided by WebSphere® MQ File Transfer Edition to configure a new coordination queue manager and create new agents. Finally, you must start the agents that you have created. You can then use the agents to transfer files.
About this task
Procedure
- Set the environment variables described in Environment variables for WebSphere MQ File Transfer for z/OS.
- Set up the connection to the coordination queue manager by running the fteSetupCoordination command. You must run this command even if you have already set up a coordination queue manager on this system or another system.
- Optional: If it is the first time you have
set up this coordination queue manager you must run the MQSC script
generated by the fteSetupCoordination command on
the coordination queue manager by performing the following steps:
- If MQSC is available on your z/OS system,
run the following command, replacing coordination_queue_manager with
the name of your coordination queue manager:
runmqsc coordination_queue_manager < configuration_directory/coordination_queue_manager/coordination_queue_manager.mqsc
- If MQSC is not available on your z/OS system, use CSQUTIL to configure WebSphere MQ
File Transfer Edition.
In this example, the first step copies the script commands from a z/OS UNIX System Services file defined on the MQSCIN DD statement, to a data set. This step is required to stop commands being truncated by CSQUTIL if the commands are read directly from a z/OS UNIX System Services file. The second step runs the script commands in the data set against the queue manager defined in the PARM parameter. For more information about how to use CSQUTIL, see: WebSphere MQ utility program (CSQUTIL).
For your own environment, change the following lines in the example://TSO EXEC PGM=IKJEFT01,REGION=2000K,DYNAMNBR=20,TIME=(,10) //MQSCIN DD PATH='/u/fteuser/AGENT1_create.mqsc', // PATHOPTS=ORDONLY //MQSCOUT DD RECFM=FB,LRECL=80,DISP=(NEW,PASS), // SPACE=(TRK,(1,1)) //SYSTSPRT DD SYSOUT=* //SYSTSIN DD * OCOPY INDD(MQSCIN) OUTDD(MQSCOUT) TEXT //CSQUTIL EXEC PGM=CSQUTIL,PARM='FT7B' //SYSPRINT DD SYSOUT=* //STEPLIB DD DSN=MQM.SCSQANLE,DISP=SHR // DD DSN=MQM.SCSQAUTH,DISP=SHR //CSQUCMD DD DSN=*.TSO.MQSCOUT,DISP=(OLD,DELETE) //SYSIN DD * COMMAND
- Change MQSCIN DD PATH='/u/fteuser/AGENT1_create.mqsc' to the path to the MQSC file on the destination system.
- Change the PARM=' ' value in the following line CSQUTIL EXEC PGM=CSQUTIL,PARM='FT7B' to the name of the queue manager that you want to run the script against.
- Change STEPLIB DD DSN=MQM.SCSQANLE,DISP=SHR and DD DSN=MQM.SCSQAUTH,DISP=SHR to point to the SCSQAUTH and SCSQANLE data sets for your installation of WebSphere MQ. For information about the supported versions of WebSphere MQ, see the web page WebSphere MQ File Transfer Edition System Requirements.
- If MQSC is available on your z/OS system,
run the following command, replacing coordination_queue_manager with
the name of your coordination queue manager:
- Set up the connection to the command queue manager by running the fteSetupCommands command.
- Create an agent by running the fteCreateAgent command.
- Run the MQSC script generated by the fteCreateAgent command
on the agent queue manager by performing the following steps:
- If MQSC is available on your z/OS system,
run the following command, replacing agent_queue_manager with
the name of your agent queue manager and replacing agent_name with
the name of your agent:
runmqsc agent_queue_manager < configuration_directory/coordination_queue_manager/agents/agent_name_create.mqsc
- If MQSC is not available on your z/OS system, use CSQUTIL to configure WebSphere MQ
File Transfer Edition.
In this example, the first step copies the script commands from a z/OS UNIX System Services file defined on the MQSCIN DD statement, to a data set. This step is required to stop commands being truncated by CSQUTIL if the commands are read directly from a z/OS UNIX System Services file. The second step runs the script commands in the data set against the queue manager defined in the PARM parameter. For more information about how to use CSQUTIL, see: WebSphere MQ utility program (CSQUTIL).
For your own environment, change the following lines in the example://TSO EXEC PGM=IKJEFT01,REGION=2000K,DYNAMNBR=20,TIME=(,10) //MQSCIN DD PATH='/u/fteuser/AGENT1_create.mqsc', // PATHOPTS=ORDONLY //MQSCOUT DD RECFM=FB,LRECL=80,DISP=(NEW,PASS), // SPACE=(TRK,(1,1)) //SYSTSPRT DD SYSOUT=* //SYSTSIN DD * OCOPY INDD(MQSCIN) OUTDD(MQSCOUT) TEXT //CSQUTIL EXEC PGM=CSQUTIL,PARM='FT7B' //SYSPRINT DD SYSOUT=* //STEPLIB DD DSN=MQM.V700.SCSQANLE,DISP=SHR // DD DSN=MQM.V700.SCSQAUTH,DISP=SHR //CSQUCMD DD DSN=*.TSO.MQSCOUT,DISP=(OLD,DELETE) //SYSIN DD * COMMAND
- Change MQSCIN DD PATH='/u/fteuser/AGENT1_create.mqsc' to the path to the MQSC file on the destination system.
- Change the PARM=' ' value in the following line CSQUTIL EXEC PGM=CSQUTIL,PARM='FT7B' to the name of the queue manager that you want to run the script against.
- Change STEPLIB DD DSN=MQM.V700.SCSQANLE,DISP=SHR and DD DSN=MQM.V700.SCSQAUTH,DISP=SHR to point to the SCSQAUTH and SCSQANLE data sets for your installation of WebSphere MQ Version 7.0
- If MQSC is available on your z/OS system,
run the following command, replacing agent_queue_manager with
the name of your agent queue manager and replacing agent_name with
the name of your agent:
- Start the agent using the fteStartAgent command.

Feedback
