SoftSpy version 7.4 installation files

Back to SoftSpy installation guide

Introduction

This page provides installation instructions for the following products:

• SoftSpy for Model 204, Version 7 Release 4.0
• MUSE for Model 204, Version 7 Release 4.0

Version 7 Release 4.0 of these products supports Model 204 Version 7 Release 4.0.

SoftSpy provides debugging features to help you develop, test, and maintain User Language applications. Add-on features include interactive debugging, performance tuning, quality assurance testing, and error audit options.

MUSE is a multi-use facility based on the Model 204 USE command.

Installation of SoftSpy should be done by the organization responsible for the installation and maintenance of Model 204. When performing the installation, you should have a copy of the Rocket Model 204 installation guide for your operating system. You should review all relevant sections of these pages before proceeding with the installation.

When you have completed the installation instructions detailed in this document, SoftSpy and MUSE will be installed. To install SoftSpy and MUSE in additional ONLINE or BATCH204 jobs, refer to Additional Installations.

Overview of Installation

SoftSpy consists of Model 204 nucleus extensions and Model 204 User Language procedures. The SoftSpy installation process installs the User Language procedures, and it modifies your Model 204 systems to make SoftSpy available for use.

This installation guide is organized into operating system-specific sections that provide instructions for getting the SoftSpy version 7.4 files. The SoftSpy installation guide provides the rest of the installation instructions, which are release-independent.

Installation on IBM z/OS

This section describes the SoftSpy installation steps that are specific to the IBM z/OS operating system.

Prerequisite: Installing Model 204

Before installing this version of SoftSpy, you must have completed these Model 204 installation steps:

• Install Model 204 nucleus
• Install Dictionary/204

For details, refer to the Model 204 z/OS installation instructions in the Rocket Model 204 Installation Guide for IBM z/OS, version 7.4

Note: When you link-edit the Model 204 nucleus, ensure that the SSPY and MUSE text decks/CSECTs are linked in.

Backing up data

If you are upgrading from a previous version of SoftSpy, it is strongly recommended that you make a backup copy of your existing SPYPROC and SPYDATA files before proceeding. The upgrade process modifies these files, so a backup copy is required if you need to revert to the previous version.

FTPing and installing the SoftSpy files

The steps for FTPing and installing the SoftSpy files are as follows.

1. Determine high-level qualifiers for data sets. The high-level qualifiers that you specify in the jobs provided must match the high-level qualifiers that you specified when installing Model 204.
2. Download zip files from the FTP server.
1. Navigate to the Rocket ftp web site.
2. Enter the userid and password provided by Rocket.
3. If you are using Internet Explorer:
   1. Follow the on-screen instructions to open the FTP site in File Explorer.
   2. Re-enter the user id and password provided by Rocket, as needed.
4. Open the M204 folder.
5. Open the 7.4 folder.
6. Open the SSPY folder.
7. Open the zOS folder and download the .zip file to your PC, in binary format.
3. Using WinZip or a similar program, unzip the file that you downloaded to your PC in the previous step. The unzip process will result in two files requiring approximately 2.3MB of storage.
4. Upload the .txt files from the FTP server to the mainframe:
• xmit-alloc.txt
• xmit-receive.txt
• m204rlnk.txt
• spyaloc.txt
These files must be transferred in ASCII format.
5. Modify and submit the xmit-alloc.txt JCL file. The ALLOC job allocates the target data sets for uploading the xmit-formatted files.

   Note: You can use the more robust 7.5 version of SPYPROC with SoftSpy 7.4 if you wish. If you will be using the 7.5 SPYPROC, you do not allocate a data set for it here. When modifying the 7.4 xmit-alloc.txt JCL file, comment out or remove the SPYPROC lines.

6. Using FTP, change the remote location to ‘sysindx. XMIT’, created by the ALLOC job, and upload in binary format the xmit-formatted files into the allocated data sets.
7. Modify and submit the xmit-receive.txt JCL file. The RECEIVE job receives the two data sets packaged in xmit format and converts them to OS standard format. Output data set names must conform to the data set naming conventions you used when installing Model 204.

   Note: If you will be using the 7.5 version of SPYPROC, modify the 7.4 xmit-receive.txt JCL file to comment out or remove the SPYPROC lines.

8. Modify and submit m204rlnk.txt. This job relinks ONLINE and BATCH204 with the SoftSpy object modules.
9. If you have not previously installed SoftSpy, modify and submit spyaloc.txt. This job allocates the Model 204 SoftSpy data sets SPYPROC, SPYDATA, SPYTEMP, and ITSAUTH. The following table shows space requirements for SPYPROC, SPYDATA, SPYTEMP, and ITSAUTH:

Database Name	Number of 6184-byte pages
SPYPROC	400
SPYDATA	150
SPYTEMP	112
ITSAUTH	8

Once you have uploaded the FTP files into the allocated data sets and converted them to z/OS standard format, continue the installation as described in the SoftSpy installation guide z/OS installation next steps section.

Installation on IBM z/VM

This section describes the SoftSpy installation steps that are specific to the z/VM operating system.

Prerequisite: Installing Model 204

Before installing this version of SoftSpy, you must have completed these Model 204 installation steps:

• Install the Model 204 nucleus.
• Install Dictionary/204.

For details, refer to the Rocket Model 204 Installation Guide for IBM z/VM, version 7.4

Note: When you link-edit the Model 204 nucleus, ensure that the SSPY and MUSE text decks/CSECTs are linked in.

Backing up data

If you are upgrading from a previous version of SoftSpy, it is strongly recommended that you make a backup copy of your existing SPYPROC and SPYDATA files before proceeding. The upgrade process modifies these files, so a backup copy is required if you need to revert to the previous version.

Contents of the SoftSpy VMARC archive

The following table lists the contents of the SoftSpy VMARC.

Contents of the SoftSpy archive files

Archive File	Unpacks to this minidisk	Contents
DISKFDF	193	SoftSpy installation executable
DISKSPY	194	SoftSpy object (TEXT) modules and load list
DISKDMP	200	SPYPROC file distributed in Model 204 DUMP format (identified by the file type M204DUMP)

Downloading the VMARC module

SoftSpy is provided in a VMARC archive format, which requires the VMARC module to unpack the files.

If you do not already have the VMARC module on your system, you can download it from IBM:

1. Navigate to the IBM downloads web page for VMARC.
2. Scroll up the page and read the license agreement.
3. Follow the downloading instructions on the web page.

Downloading the installation archive

SoftSpy is available in a VMARC archive on the FTP server. Perform installation tasks for SoftSpy on the CMS ID normally used for the installation and maintenance of Model 204, typically MAINT204.

1. Go to the Rocket ftp web site.
2. Enter the username and password supplied to you by Rocket.
3. If you are using Internet Explorer:
   1. Follow the on-screen instructions to open the FTP site in File Explorer.
   2. Re-enter the user id and password provided by Rocket, as needed.
4. Open the M204 folder.
5. Open the folder for your release, such as v7r4 or v7r5.
6. Open the SSPY folder.
7. Open the zVM folder and download the vmarc file to your PC in binary format.
8. Transfer the vmarc file on your PC to the MAINT204’s A disk and name the file CMrrrSP VMARC, where rrr is the release level. Be sure to transfer the file in binary format.
9. If disks 193, 194 or 200 are read only, change them to read/write by reaccessing them:

ACC 193 C ACC 194 D ACC 200 F

Unpacking the installation program

The INSSPY EXEC will access the appropriate minidisks and unpack the individual VMARC archives. Unpack the INSSPY EXEC by entering the following:

VMARC UNPK CMrrrSP VMARC A INSSPY EXEC A (REPLACE

for example:

VMARC UNPK CM750SP VMARC A INSSPY EXEC A (REPLACE

Unpacking the installation files

Execute the installation program with the following command:

EXEC INSSPY

You will see the installation files being loaded onto the appropriate minidisks.

Unpacking individual archives (optional)

If you need to unpack files to individual minidisks, use the following command:

VMARC UNPK CMrrrSP VMARC A DISKxxx A (REPLACE

For example:

VMARC UNPK CM750SP VMARC A DISKSPY A (REPLACE

This creates a file on the A disk called:

DISKSPY VMARC A

To list the files in the DISKSPY archive:

VMARC LIST DISKSPY VMARC A

To load the files to the 194 disk (F disk):

VMARC UNPK DISK194 VMARC A * * F (REPLACE

Continue the installation as described in the SoftSpy installation guide z/VM installation next steps section.

Installation on IBM z/VSE

This section describes the SoftSpy installation steps that are specific to the z/VSE operating system.

Prerequisite: Installing Model 204

Before installing this version of SoftSpy, you must have completed these Model 204 installation steps:

• Install Model 204 nucleus
• Install Dictionary/204

For details, refer to the Rocket Model 204 Installation Guide for IBM z/VSE, version 7.4

Note: When you link-edit the Model 204 nucleus, ensure that the SSPY and MUSE text decks/CSECTs are linked in.

Installing SoftSpy

This section describes how to locate and download the files that you need in order to install SoftSpy.

Downloading .zip files from the FTP server

1. Navigate to the Model 204 directory on the FTP server:

ftp://ftp.rocketsoftware.com/

2. Enter the userid and password provided by Technical Support.
3. If you are using Internet Explorer:
   1. Follow the on-screen instructions to open the FTP site in File Explorer.
   2. Re-enter the user id and password provided by Rocket, as needed.
4. Open the M204 folder.
5. Open the folder for your release, such as v7r4 or v7r5.
6. Open the SSPY folder.
7. Open the zVSE folder. (The .zip files are listed in the following table.)
8. Follow the instructions below to install SoftSpy.

zVSE .zip files

The .zip files available in the SSPY/zVSE folder are listed below. The letters rrr represent the version, such as 750 or 740.

Contents of zVSE folder

File	Description
m204.vrrr.spyproc.zip	SPYPROC dump file
m204.vrrr.sspy.zip	SoftSpy object and installation JCL
readme.pdf	Installation instructions

Note: The installation instructions on this page are written with the assumption that you will use the standard FTP method described. If you use an alternative FTP method for downloading the files, or if you change the provided FTP batch job during the download process, adjust the subsequent installation instructions accordingly.

1. FTP the m204.vrrr.sspy.zip file to your PC. This file must be transferred in binary format.
2. Unzip the m204.vrrr.sspy.zip file on your PC using WinZip or a similar program. This results in two .jcl files: catjsspy.jcl and catvsspy.jcl.
   The catvsspy.jcl file will catalog the LKONLN, LKB204, MUSE, and SSPY object in the Model 204 Vrrr sublibrary.
   The catjsspy.jcl file will catalog the FTPSSPY, SPYINST, and SPYRINST jobs in the Model 204 Jrrr sublibrary.
3. FTP the two .jcl files to the POWER RDR queue, CLASS=0, in binary format. This will place the files on HOLD in the RDR queue.
4. From the VSE console, release each job from the RDR queue; for example:
   r rdr,catvsspy
   At the pause, enter the DLBL statements for your Model 204 library.

5. Note: You can use the more robust 7.5 version of SPYPROC with SoftSpy 7.4 if you wish. If you will be using the 7.5 SPYPROC, skip this step.

   Transfer the SPYPROC.DUMP file from the ftp server to the z/VSE operating system. Use the information in this section to determine size requirements for the dump file.
   Rocket Software provides an optional sample batch job, FTPSSPY, to assist in this transfer. FTPSSPY, cataloged in the JCL library in step 4, defines the file names and data set names used in subsequent installation jobs. If you choose to use FTPSSPY, modify this job as noted in its comments and submit it.

   Note: If you make changes to the names in FTPSSPY, you must use those names for all subsequent installation jobs; otherwise those jobs will fail.

6. Modify and submit LINKONLN and LINKB204 to relink your BATCH204 and ONLINE phases.
7. Complete the installation process as described in the SoftSpy installation guide z/VSE installation next steps section.