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

Complete the following steps to configure WebSphere MQ File Transfer Edition for z/OS:

Procedure

  1. Set the environment variables described in Environment variables for WebSphere MQ File Transfer for z/OS.
  2. 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.
  3. 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).

      //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
      For your own environment, change the following lines in the example:
      • 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.
  4. Set up the connection to the command queue manager by running the fteSetupCommands command.
  5. Create an agent by running the fteCreateAgent command.
  6. 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).

      //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
      For your own environment, change the following lines in the example:
      • 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
  7. Start the agent using the fteStartAgent command.

Task Task

Feedback

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