Installing the CICS Transaction Server agent on z/OS

When you install the CICS® Transaction Server (TS) agent, you download the files from Rational® Test Control Panel 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.

Procedure

Download and extract the CICS Transaction Server Exits package, IBMCICSTransactionServer.zip, that is provided with Rational Test Control Panel into a temporary folder. For information about the package, see Rational Integration Tester tool packages.
Use FTP to transfer the CICS XMIT files in the temporary folder to MVS™ on the z/OS system.
1. Using the command line on the system where you extracted the files, go to the temporary folder.
2. Enter the following command:
  ftp hostname
3. Enter your MVS TSO user ID and password.
4. 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