Installing the CICS Transaction Server agent on z/OS

When you install the CICS® Transaction Server (TS) agent, you move files from your IBM® Rational® Integration Tester Platform Pack system to the z/OS® system and then configure the files for the exit.

Before you begin

The CICS Transaction Server (TS) agent is supported on CICS TS versions 3.2, 4.1, 4.2, 5.1, and 5.2.

Two sets of XMIT files are provided. The XMIT files that support CICS 3.2 are prefixed RIT.CICS32. The XMIT files that support CICS 4.1 and above are prefixed RIT.CICS. In the procedure, they are referred to generically as CICSxx. Choose the XMIT files that match your operation environment. To support all versions of CICS, repeat the instructions for both sets of XMIT files.

Before you install and set up the agent, ensure that you have installed IBM Rational Integration Tester Platform Pack. Rational Integration Tester Platform Pack is installed as part of the Rational Test Workbench and Rational Test Virtualization Server product offerings.

Procedure

Use FTP to transfer the CICS XMIT files in the CICSTransactionServer\native folder to MVS™ on the z/OS system.
1. Using the command line on the system where Rational Integration Tester Platform Pack is installed, go to Rational Integration Tester Platform Pack installation directory\CICSTransactionServer\native.
2. Using the command line on the system where you extracted the files, go to the temporary folder.
3. Enter the following command:
  ftp hostname
4. Enter your MVS TSO user ID and password.
5. Enter the following commands:
  bin
  
  quote site CYL PRI=2 SEC=2 recfm=fb lrecl=80 blksize=3200
  
  put RIT.CICSxx.PROC.XMIT 'userid.RIT.CICSxx.PROC.XMIT'
  
  put RIT.CICSxx.LOAD.XMIT 'userid.RIT.CICSxx.LOAD.XMIT'
  
  put RIT.CICSxx.LOADLIB.XMIT 'userid.RIT.CICSxx.LOADLIB.XMIT'
  where userid is your TSO user ID.
Unpack the data set.
1. Under ispf (option 6), open the TSO command window. Then, enter the following command:
  receive indsn(RIT.CICSxx.PROC.XMIT)
2. When you are prompted for the restore parameters, enter the following text:
  dsn(RIT.CICSxx.PROC)
3. Enter the following command:
  receive indsn(RIT.CICSxx.LOAD.XMIT)
4. When you are prompted for the restore parameters, enter the following text:
  dsn(RIT.CICSxx.LOAD)
5. Enter the following command:
  receive indsn(RIT.CICSxx.LOADLIB.XMIT)
6. When you are prompted for the restore parameters, enter the following text:
  dsn(RIT.CICSxx.LOADLIB)
Three data sets are created with names in the following format:
- userid.RIT.CICSxx.PROC
- userid.RIT.CICSxx.LOAD
- userid.RIT.CICSxx.LOADLIB
Configure the CICS TS agent by following the instructions that are supplied in the README file.

What to do next

To complete the CICS exit installation, define resources in CICS as described in Defining resources and starting the CICS Transaction Server agent.

Feedback