SoftSpy installation guide: Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
 
(92 intermediate revisions by 3 users not shown)
Line 15: Line 15:
command.</p>
command.</p>


<p>Installation of SoftSpy should be done by the organization responsible for the installation and maintenance of <var class="product">Model&#160;204</var>.  When performing the installation, you should have a copy of the Rocket <var class="product">Model&#160;204</var> Installation Guide for your operating system. You should review all relevant sections of these pages before proceeding with the installation.</p>
<p>Installation of SoftSpy should be done by the organization responsible for the installation and maintenance of <var class="product">Model&#160;204</var>.  When performing the installation, you should have a copy of the Rocket <var class="product">Model&#160;204</var> [[Model_204_installation|installation guide]] for your operating system. You should review all relevant sections of these pages before proceeding with the installation.</p>


<p>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|Additional Installations.]]</p>
<p>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|Additional Installations.]]</p>
Line 38: Line 38:
<ul>
<ul>
<ul><li>[[#Updating_CCAIN|Updating CCAIN]]</li>
<ul><li>[[#Updating_CCAIN|Updating CCAIN]]</li>
<li>[[#Online_Installation_Steps Online|Installation Steps]]</li>
<li>[[#Online installation steps|Online installation steps]]</li>
<li>[[#Verify_the_Installation|Verify the Installation]] </li></ul>
<li>[[#Verifying the installation|Verifying the installation]] </li></ul>
</ul>
</ul>
<div></div>
<div></div>


===Downloading and installing SoftSpy version 7.4 files===
===SoftSpy and Model 204 version 7.4===
It is recommended that you install SoftSpy version 7.5, because it is more robust than 7.4. SoftSpy 7.5 is compatible with Model 204 versions 7.4 and 7.5.  
It is recommended that you install the SoftSpy version 7.5 SPYPROC file, because it is more robust than the 7.4 version.  


However, you can install SoftSpy version 7.4 if you are using Model 204 version 7.4. For details on how to download the SoftSpy version 7.4 files, see [[SoftSpy version 7.4 installation files]].
The SoftSpy SOUL code (SPYPROC file) for 7.5 is compatible with Model 204 versions 7.4 and 7.5.
 
<ul>
<li>If you are currently running SoftSpy version 7.4 with Model 204 version 7.4, you can upgrade to SoftSpy 7.5 by downloading the SPYPROC file. (See the section "Downloading and installing SoftSpy 7.5 files" for your operating system later on this page.)</li>
<li>If you are installing SoftSpy for the first time with Model 204 version 7.4, you must install the SoftSpy object as described in [[SoftSpy version 7.4 installation files]] before downloading the 7.5 SPYPROC file.</li>
</ul>


==Installation on IBM z/OS==
==Installation on IBM z/OS==
Line 66: Line 71:
<li>Install Dictionary/204</li></ul>
<li>Install Dictionary/204</li></ul>


For details about Model 204 version 7.4, see the <var class="book">[http://m204wiki.rocketsoftware.com/images/d/de/M204_V7R4_zOS_Install.pdf Rocket Model 204 Installation Guide for IBM z/OS, version 7.4]</var>.
For details about Model 204 version 7.5 and later, see [[Model 204 installation on IBM z/OS]].
 
For details about Model 204 version 7.4, see the <var class="book">[http://m204wiki.rocketsoftware.com/images/d/de/M204_V7R4_zOS_Install.pdf Rocket Model 204 Installation Guide for IBM z/OS, version 7.4]</var>.  
 
<p class="Note"><b>Notes:</b>
<ul><li>When you link-edit the Model 204 nucleus, ensure that the SSPY and MUSE text decks/CSECTs are linked in.</li>
<li>If you are running Model 204 version 7.4 and you have never installed SoftSpy before, you must [[SoftSpy version 7.4 installation files|install SoftSpy version 7.4]] before upgrading to SoftSpy version 7.5.</li>
</ul></p>
 
===Backing up data===


For details about Model 204 version 7.5, see [[Upgrading to Model 204 version 7.5 on IBM z/OS]].
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.


<p class="Note"><b>Note:</b> When you link-edit the Model 204 nucleus, ensure that the SSPY and MUSE text decks/CSECTs are linked in.</p>
===Downloading and installing SoftSpy 7.5 files on z/OS===


===Downloading and installing SoftSpy files===
<p class="note"><b>Note:</b> You must have either a [[Rocket M204 user ID]] or a Sirius user ID to download the installation files.</p>


<p>The steps for downloading and installing the SoftSpy 7.5 files are as follows. </p>
To install the SoftSpy 7.5 files:
<ol>
<ol>
<li>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 <var class="product">Model&#160;204</var>.</li>
<li>If you have not previously installed SoftSpy, modify and submit the [[SoftSpy SPYALOC job stream|SPYALOC]] JCL job. This job allocates the <var class="product">Model&#160;204</var> SoftSpy data sets SPYPROC, SPYDATA, and SPYTEMP. The following table shows space requirements for these data sets:
<li>Download SPYPROC, in binary form, from the [https://m204.rocketsoftware.com/maint/ullist?nickname=ROCKET SOUL files download page] to a workstation file.</li>
<li>Upload the file from your workstation to your z/VSE system.</li>
<li>RESTORE the file into a Model 204 SOUL file.</li>
 
      <li>Upload the .txt files to the mainframe:</li>
<ul>
  <li>xmit-alloc.txt</li>
  <li>xmit-receive.txt</li>
  <li>m204rlnk.txt</li>
  <li>spyaloc.txt</li>
</ul>These files must be transferred in ASCII format.
<li>Modify and submit the xmit-alloc.txt JCL file. The ALLOC job allocates the target data sets for uploading the xmit-formatted files.</li>
        <li>Using FTP, change the remote location to ‘sysindx. XMIT’, created in the previous step, and upload in binary format the xmit-formatted files into the allocated data sets.</li>
        <li>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 <var class="product">Model&#160;204</var>.</li>
<li>Modify and submit m204rlnk.txt. This job relinks ONLINE and BATCH204 with the SoftSpy object modules.</li>
        <li>If you have not previously installed SoftSpy, modify and submit spyaloc.txt. This job allocates the <var class="product">Model&#160;204</var> SoftSpy data sets SPYPROC, SPYDATA, and SPYTEMP. The following table shows space requirements for SPYPROC, SPYDATA, and SPYTEMP:</li>
   <table>
   <table>
   <tr>
   <tr>
Line 100: Line 98:
   <tr>
   <tr>
     <td>SPYPROC</td>
     <td>SPYPROC</td>
     <td>400</td>
     <td>1000</td>
   </tr>
   </tr>
   <tr>
   <tr>
     <td>SPYDATA</td>
     <td>SPYDATA</td>
     <td >150</td>
     <td >160</td>
   </tr>
   </tr>
   <tr>
   <tr>
Line 111: Line 109:
   </tr>
   </tr>
   </table>
   </table>
</li>
<li>If you have existing SPYPROC and SPYDATA files from a previous version, back them up.</li>
<li>SPYPROC, the SoftSpy procedure file, is distributed as a standard Model 204 Dump file (a sequential file). Download SPYPROC, in binary form, from the [https://m204.rocketsoftware.com/maint/ullist?nickname=ROCKET SOUL files download page] to a workstation file.</li>
<li>Upload the file from your workstation to your z/OS system.</li>
<li>RESTORE the file into the SPYPROC file.</li>
</ol>
</ol>


===Backing up data===
===z/OS installation next steps===
The steps in this section apply to both SoftSpy 7.4 and SoftSpy 7.5 installation on z/OS systems.
<p>Once you have uploaded the files into the allocated data sets and converted them to z/OS standard format, continue the installation as follows.</p>
<p>Once you have uploaded the files into the allocated data sets and converted them to z/OS standard format, continue the installation as follows.</p>
<ol>
<ol>
<li>Back up SPYDATA.
<p>If you are upgrading from a previous version of SoftSpy, it is strongly recommended that you make a backup copy of the SPYDATA file before proceeding. The upgrade process modifies the SPYDATA file, so a backup copy is required if you need to revert to the previous version.</p></li>


<li>Modify the ONLINE startup JCL.
<li>Modify the ONLINE startup JCL.
        <ul>
<ul>
<li>If you are installing SoftSpy for the first time, add DD statements for the SPYDUMP, SPYPROC, SPYDATA, and SPYTEMP data sets to your ONLINE startup JCL.  
<li>If you are installing SoftSpy for the first time, add DD statements for the SPYDUMP, SPYPROC, SPYDATA, and SPYTEMP data sets to your ONLINE startup JCL.  
<p>Following are samples of these statements:</p>
<p>Following are samples of these statements:</p>
<p span class="code">//SPYDUMP DD DSN=SYSM.M204.V<i>rrr</i>.SPYPROC.DUMP,DISP=SHR
<p span class="code">//SPYDUMP DD DSN=SYSM.M204.V<i>rrr</i>.SPYPROC.DUMP,DISP=SHR
Line 133: Line 135:
<p span class="code">//ITSAUTH DD DSN=SYSM.M204.ITSAUTH.M204,DISP=SHR</p>
<p span class="code">//ITSAUTH DD DSN=SYSM.M204.ITSAUTH.M204,DISP=SHR</p>


      <li>If you are upgrading from a previous version of SoftSpy, you only need to add DD statements for SPYDUMP and SPYPROC.  The DD statements for SPYDATA, SPYTEMP, and ITSAUTH should already be present.</li>
<li>If you are upgrading from a previous version of SoftSpy, you only need to add DD statements for SPYDUMP and SPYPROC.  The DD statements for SPYDATA, SPYTEMP, and ITSAUTH should already be present.</li>
      </ul>
</ul>


<p class="note"><b>Notes:</b> The SPYDUMP DD is only necessary to perform the installation and can be removed afterward. <br />For 7.5, the ITSAUTH DD can be removed.</p></li>
<p class="note"><b>Notes:</b> The SPYDUMP DD is only necessary to perform the installation and can be removed afterward. <br />For 7.5, the ITSAUTH DD can be removed.</p></li>


<li>Make sure that the SYSOPT (system options) X'04' bit is off. This setting indicates that <var class="product">Model&#160;204</var> data definition commands can only be executed from within the File Management Facility of Dictionary/204. (This facility is not used to
<li>Make sure that the SYSOPT (system options) X'04' bit is off. This setting indicates that <var class="product">Model&#160;204</var> data definition commands can only be executed from within the File Management Facility of Dictionary/204. (This facility is not used to
create and format the SPYDATA and SPYTEMP files and their fields as documented in [[#Online_Installation_Steps|Online Installation Steps]].) Normal SoftSpy
create and format the SPYDATA and SPYTEMP files and their fields as documented in [[#Online_Installation_Steps|Online installation steps]].) Normal SoftSpy
operation is not affected by the SYSOPT X'04' bit setting.</li>
operation is not affected by the SYSOPT X'04' bit setting.</li>


Line 164: Line 166:
</ul>
</ul>


For details about Model 204 version 7.5, see the Model 204 z/VM installation instructions in [[Upgrading to Model 204 version 7.5 on IBM z/VM CMS]].
For details about Model 204 version 7.5, [[Contacting Rocket Software Technical Support|contact Technical Support]].


For details about Model 204 version 7.4, see the <var class="book">[http://docs.rocketsoftware.com/nxt/gateway.dll/RKBnew556%2Fmodel%20204%2Fprevious%20versions%2Fv7.4%2Fm204_installzvm_v74.pdf Rocket Model 204 Installation Guide for IBM z/VM, version 7.4]</var>
For details about Model 204 version 7.4, see the <var class="book">[http://docs.rocketsoftware.com/nxt/gateway.dll/RKBnew556%2Fmodel%20204%2Fprevious%20versions%2Fv7.4%2Fm204_installzvm_v74.pdf Rocket Model 204 Installation Guide for IBM z/VM, version 7.4]</var>


<p class="Note"><b>Note:</b> When you link-edit the Model 204 nucleus, ensure that the SSPY and MUSE text decks/CSECTs are linked in.</p>
<p class="Note"><b>Notes:</b>
<ul><li>When you link-edit the Model 204 nucleus, ensure that the SSPY and MUSE text decks/CSECTs are linked in.</li>
<li>If you are running Model 204 version 7.4 and you have never installed SoftSpy before, you must [[SoftSpy version 7.4 installation files|install SoftSpy version 7.4]] before upgrading to SoftSpy version 7.5.</li>
</ul></p>


===Downloading the SoftSpy version 7.5 installation files===
===Backing up data===
<p class="note"><b>Note:</b> For information on version 7.4 files, see [[#Downloading and installing SoftSpy version 7.4 files|Downloading and installing SoftSpy version 7.4 files]].</p>
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.
===Downloading and installing SoftSpy 7.5 files on z/VM===


To download the 7.5 files:
<p class="note"><b>Note:</b> You must have either a [[Rocket M204 user ID]] or a Sirius user ID to download the installation files.</p>
 
<p>To install the SoftSpy version 7.5 files:</p>
<ol>
<ol>
<li>Download SPYPROC, in binary form, from the [https://m204.rocketsoftware.com/maint/ullist?nickname=ROCKET SOUL files download page] to a workstation file.</li>
<li>If you have existing SPYPROC and SPYDATA files from a previous version, back them up.</li>
<li>Upload the file from your workstation to your z/VSE system.</li>
<li>SPYPROC, the SoftSpy procedure file, is distributed as a standard Model 204 Dump file (a sequential file). Download SPYPROC, in binary form, from the [https://m204.rocketsoftware.com/maint/ullist?nickname=ROCKET SOUL files download page] to a workstation file.</li>
<li>RESTORE the file into a Model 204 SOUL file.</li>
<li>Upload the file from your workstation to your z/VM system.</li>
<li>RESTORE the file into the SPYPROC file.</li>
</ol>
</ol>


===Backing up data and installing SoftSpy===
===z/VM installation next steps===
The steps in this section apply to both SoftSpy 7.4 and SoftSpy 7.5 installation on z/VM systems.
   <ol>
   <ol>
     <li>Run M204GEN to generate modules and saved segments, as you did when installing the <var class="product">Model&#160;204</var> nucleus. For information, syntax, and rules for M204GEN, see the “M204GEN Command” section in the <var class="book">[http://docs.rocketsoftware.com/nxt/gateway.dll/RKBnew556%2Fmodel%20204%2Fprevious%20versions%2Fv7.4%2Fm204_installzvm_v74.pdf Rocket Model 204 Installation Guide for IBM z/VM, version 7.4]</var>.</li>
     <li>Run M204GEN to generate modules and saved segments, as you did when installing the <var class="product">Model&#160;204</var> nucleus. For information, syntax, and rules for M204GEN, see the “M204GEN Command” section in the <var class="book">[http://docs.rocketsoftware.com/nxt/gateway.dll/RKBnew556%2Fmodel%20204%2Fprevious%20versions%2Fv7.4%2Fm204_installzvm_v74.pdf Rocket Model 204 Installation Guide for IBM z/VM, version 7.4]</var>.</li>
     <li>Reapply all early warnings. For information, see the “Applying early warnings” section in the <var class="book">Rocket Model 204 Installation Guide for IBM z/VM, version 7.4</var>.</li>
     <li>Reapply all early warnings. For information, see the “Applying early warnings” section in the <var class="book">Rocket Model 204 Installation Guide for IBM z/VM, version 7.4</var>.</li>
    <li>Back up SPYDATA.
          <p>If you are upgrading from a previous version of SoftSpy, make a backup copy of the SPYDATA file before proceeding.  The upgrade process modifies the SPYDATA file, so a backup copy is required if you need to revert to the previous version.</p></li>
     <li>If the SPYPROC, SPYTEMP, and SPYDATA database files will reside on an OS format disk, allocate them at this time.  If you are upgrading from a previous version of SoftSpy, you only need to allocate the SPYPROC database file.
     <li>If the SPYPROC, SPYTEMP, and SPYDATA database files will reside on an OS format disk, allocate them at this time.  If you are upgrading from a previous version of SoftSpy, you only need to allocate the SPYPROC database file.
         <ol style="list-style-type:lower-alpha">
         <ol style="list-style-type:lower-alpha">
  <li>[[#SSPYFDEF EXEC|SSPYFDEF]] is an executable that defines SoftSpy database files. SSPYFDEF resides on the MAINT204 193 disk. Edit SSPYFDEF to conform to your disk naming and file placement conventions. The following table shows space requirements:</li>
  <li>SSPYFDEF is an exec that defines SoftSpy database files. SSPYFDEF resides on the MAINT204 193 disk. Edit SSPYFDEF to conform to your disk naming and file placement conventions. The following table shows space requirements:</li>
   <table>
   <table>
  <tr>
  <tr>
Line 197: Line 205:
  <tr>
  <tr>
   <td>SPYPROC</td>
   <td>SPYPROC</td>
   <td>400</td>
   <td>1000</td>
   <td>5000</td>
   <td>12500</td>
  </tr>
  </tr>
  <tr>
  <tr>
   <td>SPYDATA</td>
   <td>SPYDATA</td>
   <td>150</td>
   <td>160</td>
   <td>2000</td>
   <td>2133</td>
  </tr>
  </tr>
  <tr>
  <tr>
Line 246: Line 254:
</li>
</li>
<li>Make sure that the SYSOPT (system options) X'04' bit is off.</li>
<li>Make sure that the SYSOPT (system options) X'04' bit is off.</li>
<p>This setting indicates that <var class="product">Model&#160;204</var> data definition commands can only be executed from within the File Management Facility of Dictionary/204. (This facility is not used to create and format the SPYDATA and SPYTEMP files and their fields as documented in [[#Online Installation Steps|Online Installation Steps]].) Normal SoftSpy operation is not affected by the SYSOPT X'04' bit setting.</p>
<p>This setting indicates that <var class="product">Model&#160;204</var> data definition commands can only be executed from within the File Management Facility of Dictionary/204. (This facility is not used to create and format the SPYDATA and SPYTEMP files and their fields as documented in [[#Online installation steps|Online installation steps]].) Normal SoftSpy operation is not affected by the SYSOPT X'04' bit setting.</p>
<li>Continue the installation as described in [[#Updating_CCAIN|Updating CCAIN.]]</li>
<li>Continue the installation as described in [[#Updating_CCAIN|Updating CCAIN.]]</li>
</ol>
</ol>
Line 266: Line 274:
<li>Install Dictionary/204</li></ul>
<li>Install Dictionary/204</li></ul>


For details, refer to [[Upgrading to Model 204 version 7.5 on IBM z/VSE]].
For details about Model 204 version 7.5, see [[Model 204 installation on IBM z/VSE]].
 
For details about Model 204 version 7.4, refer to the <var class="book">[http://docs.rocketsoftware.com/nxt/gateway.dll/RKBnew556%2Fmodel%20204%2Fprevious%20versions%2Fv7.4%2Fm204_installzvse_v74.pdf Rocket Model 204 Installation Guide for IBM z/VSE, version 7.4]</var>
<p class="Note"><b>Notes:</b>
<ul><li>When you link-edit the Model 204 nucleus, ensure that the SSPY and MUSE text decks/CSECTs are linked in.</li>
<li>If you are running Model 204 version 7.4 and you have never installed SoftSpy before, you must [[SoftSpy version 7.4 installation files|install SoftSpy version 7.4]] before upgrading to SoftSpy version 7.5.</li>
</ul></p>
 
===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.


<p class="Note"><b>Note:</b> When you link-edit the Model 204 nucleus, ensure that the SSPY and MUSE text decks/CSECTs are linked in.</p>
===Downloading and installing SoftSpy 7.5 files on z/VSE===


===Installing SoftSpy===
<p>This section describes how to download and modify the SoftSpy version 7.5 installation files.</p>


<p>This section describes how to locate and download the files that you need in order to install SoftSpy.</p>
<p class="note"><b>Note:</b> You must have either a [[Rocket M204 user ID]] or a Sirius user ID to download the installation files.</p>


====Downloading the procedure file====
Download, upload, and restore the SoftSpy procedure file, SPYPROC, which is distributed in a dump format.
<ol>
<ol>
<li>Download SPYPROC, in binary form, from the [https://m204.rocketsoftware.com/maint/ullist?nickname=ROCKET SOUL files download page] to a workstation file.</li>
<li>If you have not previously installed SoftSpy, modify and submit the [[SoftSpy SPYALOC job stream|SPYALOC]] JCL job. This job allocates the <var class="product">Model&#160;204</var> SoftSpy data sets SPYPROC, SPYDATA, and SPYTEMP.</li>
<li>Upload the file from your workstation to your z/OS system.</li>
<li>If you have existing SPYPROC and SPYDATA files from a previous version, back them up.</li>
<li>RESTORE the file into a Model 204 SOUL file.<p>For detailed instructions, see [http://m204wiki.rocketsoftware.com/index.php?title=Web_help_download_SOUL_files#How_can_the_dump_file_be_uploaded_to_the_mainframe.3F Downloading and restoring SOUL files].</p></li>
<li>SPYPROC, the SoftSpy procedure file, is distributed as a standard Model 204 Dump file (a sequential file). Download SPYPROC, in binary form, from the [https://m204.rocketsoftware.com/maint/ullist?nickname=ROCKET SOUL files download page] to a workstation file.</li>
<li>Upload the file from your workstation to your z/VSE system.</li>
<li>RESTORE the file into the SPYPROC file.<p>For detailed instructions, see [http://m204wiki.rocketsoftware.com/index.php?title=Web_help_download_SOUL_files#How_can_the_dump_file_be_uploaded_to_the_mainframe.3F Downloading and restoring SOUL files].</p></li>
<li>Use the information in SPYPROC to determine size requirements for the dump file.
<li>Use the information in SPYPROC to determine size requirements for the dump file.
<br>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.
<br>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.
<br><b>Note:</b> If you make changes to the names in FTPSSPY, you must use those names for all subsequent installation jobs; otherwise those jobs will fail.</li>
<br><b>Note:</b> If you make changes to the names in FTPSSPY, you must use those names for all subsequent installation jobs; otherwise those jobs will fail.</li>
<li>Modify and submit LINKONLN and LINKB204 to relink your BATCH204 and ONLINE phases.</li>
<li>Modify and submit [[Model 204 LINKONLN job stream for IBM z/VSE|LINKONLN]] and [[Model 204 installation on IBM z/VSE#Linking the BATCH204 phase|LINKB204]] to relink your BATCH204 and ONLINE phases.</li>
<li>Complete the installation process as described in the remainder of this section.</li>
<li>Complete the installation process as described in the following section.</li>
</ol>
</ol>


===Backing up data and installing SoftSpy===
===z/VSE installation next steps===
The steps in this section apply to both SoftSpy 7.4 and SoftSpy 7.5 installation on z/VSE systems.
<ol>
<ol>
<li>
<li>Allocate the SoftSpy databases and ITSAUTH data set. <b>Note:</b> ITSAUTH applies to version 7.4 only.
Allocate the SoftSpy databases and ITSAUTH data set. <b>Note:</b> ITSAUTH applies to version 7.4 only.
   <ul>
   <ul>
<li>If upgrading from a prior version of SoftSpy, execute the
<li>If upgrading from a prior version of SoftSpy, execute the
SPYRINST job from the JCL library. This job will allocate the new SPYPROC
[[#SPYRINST JCL|SPYRINST]] job from the JCL library. This job will allocate the new SPYPROC
file. It is recommended that you back up SPYDATA before performing an
file.</li>
upgrade install. This will facilitate restoring the previous release of
SoftSpy.</li>
<li>
<li>
If performing a SoftSpy installation for the first time,
If performing a SoftSpy installation for the first time,
execute the SPYINST job from the JCL library. This job will allocate SPYPROC,
execute the [[#SPYINST JCL|SPYINST]] job from the JCL library. This job will allocate SPYPROC,
SPYDATA, SPYTEMP, and ITSAUTH files.</li>
SPYDATA, SPYTEMP, and ITSAUTH files.</li>
</ul>
</ul>
<table>
<table>
<tr><th>Database Name</th><th>Number of 6184 byte pages</th><th>Number of blocks on FBA devices</th></tr>
<tr><th>Database Name</th><th>Number of 6184 byte pages</th><th>Number of blocks on FBA devices</th></tr>
<tr><td>SPYPROC</td><td>400</td><td>5000</td></tr>
<tr><td>SPYPROC</td><td>1000</td><td>12500</td></tr>
<tr><td>SPYDATA</td><td>150</td><td>2000</td></tr>
<tr><td>SPYDATA</td><td>160</td><td>2133</td></tr>
<tr><td>SPYTEMP</td><td>112</td><td>1500</td></tr>
<tr><td>SPYTEMP</td><td>112</td><td>1500</td></tr>
</table>
</table>
</li>
</li>
<li>
Back up SPYDATA.
<br>If you are upgrading from a previous version of SoftSpy, make a backup
copy of the SPYDATA file before proceeding. The upgrade process modifies the
SPYDATA file, so a backup copy is required if you need to revert to the previous
version.</li>
<li>Modify ONLINE Startup JCL.
<li>Modify ONLINE Startup JCL.
<ul>
<ul>
Line 342: Line 350:
<li>Make sure that the SYSOPT (system options) X'04' bit is off.
<li>Make sure that the SYSOPT (system options) X'04' bit is off.
<br>
<br>
The SYSOPT X'04' bit setting indicates that Model 204 data definition commands can only be executed from within the File Management Facility of Dictionary/204. (This facility is not used to create and format the SPYDATA and SPYTEMP files and their fields as documented in [[#Online_Installation_Steps|Online Installation Steps]].) Normal SoftSpy operation is not affected by the SYSOPT X'04' bit setting.</li>
The SYSOPT X'04' bit setting indicates that Model 204 data definition commands can only be executed from within the File Management Facility of Dictionary/204. (This facility is not used to create and format the SPYDATA and SPYTEMP files and their fields as documented in [[#Online installation steps|Online installation steps]].) Normal SoftSpy operation is not affected by the SYSOPT X'04' bit setting.</li>
<li>Continue the installation as described in "Updating CCAIN".</li>
</ol>
</ol>


Line 381: Line 390:
===Adjusting the NUSERS parameter===
===Adjusting the NUSERS parameter===


<p>The NUSERS parameter needs to be increased by the number of IODEV=55 threads you have added to run SoftSpy servers. An increase in the NUSERS parameter might require a change to the size of the server data set. See the <var class="book">Rocket Model 204 System Manager's Guide</var> for a complete discussion of server data sets.</p>
<p>The NUSERS parameter needs to be increased by the number of IODEV=55 threads you have added to run SoftSpy servers. An increase in the NUSERS parameter might require a change to the size of the server data set. See [[Creating server data sets (CCASERVR)]] for a complete discussion of server data sets.</p>


===Ensuring that a large enough server is available===
===Ensuring that a large enough server is available===
Line 413: Line 422:
<p  >In either case, the size of RTBL is rounded up to the next
<p  >In either case, the size of RTBL is rounded up to the next
higher multiple of eight.</p>
higher multiple of eight.</p>
<p  >In addition, two of the DBCS environments require an even
larger server size:
<ul>
<li>
DBCSENV=3 requires a 286,000-byte server</li>
<li>
DBCSENV=4 requires a 294,000-byte server</li></ul></p>


===Adjusting the LENQTBL parameter===
===Adjusting the LENQTBL parameter===
Line 497: Line 498:
font-family:"Courier New"'> = 1480 + 2 * ( 1480 + 1088 ) = 6616</span></p>
font-family:"Courier New"'> = 1480 + 2 * ( 1480 + 1088 ) = 6616</span></p>


==Online Installation Steps==
==Online installation steps==


This section describes SoftSpy installation steps that are
This section describes SoftSpy installation steps that are
Line 591: Line 592:
<li>The following prompt appears:
<li>The following prompt appears:
<p  class="code">$$Enter an Administrator User ID. Press &lt;ENTER&gt; when finished.</p>
<p  class="code">$$Enter an Administrator User ID. Press &lt;ENTER&gt; when finished.</p>
Enter the <var class="product">Model&#160;204</var> account of anyone who is to be given <var class="product">Model&#160;204</var> ADMIN SCLASS privileges for the SoftSpy subsystem. Users added will supplement those added by previous installations of SoftSpy. The users in this SCLASS will be able to use the SoftSpy EDIT CONFIG command. Refer to the <var class="book">Rocket SoftSpy Reference Manual</var> for a discussion of EDIT CONFIG.
Enter the <var class="product">Model&#160;204</var> account of anyone who is to be given <var class="product">Model&#160;204</var> ADMIN SCLASS privileges for the SoftSpy subsystem. Users added will supplement those added by previous installations of SoftSpy. The users in this SCLASS will be able to use the SoftSpy EDIT CONFIG command. For more information, see [[SoftSpy_commands_and_macros#EDIT_CONFIG|EDIT CONFIG]].


Subsequent changes to the list of users with ADMIN privileges for the subsystem must be made using the <var class="product">Model&#160;204</var>
Subsequent changes to the list of users with ADMIN privileges for the subsystem must be made using the <var class="product">Model&#160;204</var>
Subsystem Management Facility. Refer to the <var class="book">Rocket Model 204 System Manager's Guide</var> for more information.
Subsystem Management Facility. See [[System_requirements_for_Application_Subsystems#Subsystem_Administration_screen|Subsystem Administration screen]] for more information.
The user id will be checked for compliance with <var class="product">Model&#160;204</var> conventions but will not be validated for existence in the CCASTAT file. The User ID prompt will appear repeatedly until you respond by pressing the Enter key without entering a User ID. The Model 204 account of the user who is running this procedure is included in the list automatically.</li>
The user id will be checked for compliance with <var class="product">Model&#160;204</var> conventions but will not be validated for existence in the CCASTAT file. The User ID prompt will appear repeatedly until you respond by pressing the Enter key without entering a User ID. The Model 204 account of the user who is running this procedure is included in the list automatically.</li>
Line 663: Line 664:
</li>
</li>
<li>Update this screen with any new configuration information, expiration date, and authorization key provided with your installation materials. If your authorization key is for an expiration date that has passed, you must contact Technical Support to obtain a new authorization key. </li>
<li>Update this screen with any new configuration information, expiration date, and authorization key provided with your installation materials. If your authorization key is for an expiration date that has passed, you must contact Technical Support to obtain a new authorization key. </li>
<li>Once you have made any required changes, press the SAVE PF key (PF6) to save the configuration. Saving the configuration information will write it out to the ITSAUTH file. It will also activate SoftSpy servers running in IODEV=55 threads.</li>
<li>Once you have made any required changes, press the SAVE PF key (PF6) to save the configuration. Saving the configuration information will write it out to the SPYDATA file. It will also activate SoftSpy servers running in IODEV=55 threads.</li>
<li>Press the QUIT PF key (PF3) to exit the SoftSpy configuration editor. All authorized products should now be ready for use.</li>
<li>Press the QUIT PF key (PF3) to exit the SoftSpy configuration editor. All authorized products should now be ready for use.</li>
</ol>
</ol>


==Verify the Installation==
==Verifying the installation==


<p >This section describes the process of verifying that SoftSpy
<p>This section describes the process of verifying that SoftSpy
and MUSE are correctly installed and available for general use. </p>
and MUSE are correctly installed and available for general use. </p>


Line 705: Line 706:
[[File:SoftSpy_Interactive_Evaluation_screen.jpg|450 px]]
[[File:SoftSpy_Interactive_Evaluation_screen.jpg|450 px]]
<li>Type the command:
<li>Type the command:
<p class="code">WATCH %I, %J</p>
<p class="code">WATCH %I, %J</p>
so that you can monitor the values of the percent variables as they change during evaluation. Use PF4 to single step through the procedure or PF5 to run the procedure to its end. You can also refer to the <var class="book">Rocket SoftSpy Reference Manual</var> to try some of the other features of SoftSpy.</li>
so that you can monitor the values of the percent variables as they change during evaluation. Use PF4 to single step through the procedure or PF5 to run the procedure to its end. You can also refer to the [[Introduction to SoftSpy]] for information about other SoftSpy features to try.</li>
<li>At the completion of this test, turn off SoftSpy by issuing the command:
<li>At the completion of this test, turn off SoftSpy by issuing the command:
<p class="code">SPY OFF</p>
<p class="code">SPY OFF</p>
Line 816: Line 817:
<h3>Customize SoftSpy Environments</h3>
<h3>Customize SoftSpy Environments</h3>


<p>The <i>Rocket SoftSpy Reference Manual</i> provides
<p>The [[SoftSpy environments]] topic provides instructions for [[SoftSpy environments#Tailoring environments|customizing SoftSpy environments]] to meet local needs. You can change the following environments:</p>
instructions for customizing SoftSpy environments to meet local needs. You can
change the following environments:</p>
<ul>
<ul>
<li>
<li>Base environment</li>
Base environment </li>
<li>Interactive Debug environment</li>
<li>Interactive Debug environment</li>
<li>Interactive Performance Tuning environment</li>
<li>Interactive Performance Tuning environment</li>
Line 835: Line 833:
display columns.</p>
display columns.</p>


<p>The <var class="book">Rocket SoftSpy Reference Manual</var> also
<p>The [[SoftSpy environments#Tailoring environments|Tailoring environments]] section also describes how to make SoftSpy skip over the interactive execution of selected
describes how to make SoftSpy skip over the interactive execution of selected
subsystems that are used as tools (such as SSTEST). You can customize SoftSpy to
subsystems that are used as tools (such as SSTEST). You can customize SoftSpy to
skip over any number of selected subsystems.</p>
skip over any number of selected subsystems.</p>


<p>Additionally, the <var class="book">Rocket SoftSpy Reference Manual</var>
<p>Additionally, the [[SoftSpy macro listing]] provides a complete listing of the SoftSpy macros, which you can customize as needed.</p>
provides a complete listing of the SoftSpy macros, which you can customize as
needed.</p>


==System Manager Considerations==
==System Manager Considerations==
Line 914: Line 909:
For these additional job streams, add a DD/FILEDEF/DLBL for the previously
For these additional job streams, add a DD/FILEDEF/DLBL for the previously
created ITSAUTH data set to the job stream.</p>
created ITSAUTH data set to the job stream.</p>
==CMS EXECs==
SSPYFDEF is an executable that defines SoftSpy database files. Edit SSPYFDEF to conform to your disk naming and file placement conventions. SSPYFDEF resides on the MAINT204 193 disk. See [[#Backing up data and installing SoftSpy|Backing up data and installing SoftSpy]] for space requirements.
===SSPYFDEF EXEC===
<p class="code"><nowiki>&CONTROL CMS
&ERROR &EXIT &RETCODE
*
*
* DEFINE THE SOFTSPY DATABASE FILES ACCORDING TO AN OPERAND
* PASSED ALONG WITH COMMAND
* UPDATE mode AND n CYL BEFORE RUNNING
*
    &IF /&1 EQ / &GOTO NOARG
    &IF &1 EQ ALOCSSPY &GOTO ALOCSSPY
    &IF &1 EQ CCASYS &GOTO CSYS
    &IF &1 EQ COMMON &GOTO COMMON
    &IF &1 EQ SPYPDMP &GOTO SPYPDMP
    &IF &1 EQ ITSAUTH &GOTO ITSAUTH
    &IF &1 EQ SPYDATA &GOTO SPYDATA
    &IF &1 EQ SPYPROC &GOTO SPYPROC
    &IF &1 EQ SPYTEMP &GOTO SPYTEMP
&EXIT
-NOARG
&BEGTYPE
THE SSPYFDEF COMMAND ARGUMENT WAS NOT RECOGNIZED
&END
&EXIT
-SPYPROC
    FILEDEF SPYPROC mode DSN M204 SPYPROC
&EXIT
-SPYDATA
    FILEDEF SPYDATA mode DSN M204 SPYDATA
&EXIT
-SPYTEMP
    FILEDEF SPYTEMP mode DSN M204 SPYTEMP
&EXIT
-ITSAUTH
    FILEDEF ITSAUTH mode DSN M204 ITSAUTH (BLOCK 2560 LRECL 256 RECFM FB
&EXIT
-ALOCSSPY
    M204UTIL ALLOC M204 SPYPROC mode (PRIMARY n CYL)
    M204UTIL ALLOC M204 SPYDATA mode (PRIMARY n CYL)
    M204UTIL ALLOC M204 SPYTEMP mode (PRIMARY n CYL)
    M204UTIL ALLOC M204 ITSAUTH mode (PRIMARY n CYL)
&EXIT
-CSYS
    FILEDEF CCASYS mode DSN M204 CCASYS
&EXIT
-COMMON
    FILEDEF CCAPRINT DISK SPYINST CCAPRINT A
    FILEDEF CCAAUDIT DISK SPYINST CCAAUDIT A
    FILEDEF CCASNAP DUMMY
    FILEDEF CCATEMP mode DSN M204 CCATEMP
    FILEDEF CCASTAT mode DSN M204 CCASTAT
&EXIT</nowiki></p>


==VSE JCL==
==VSE JCL==
Line 1,153: Line 1,082:


[[Category:SoftSpy]]
[[Category:SoftSpy]]
[[Category:Installation]]

Latest revision as of 19:30, 1 May 2017

Introduction

This page provides installation instructions for the following products:

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

Version 7 Release 5.0 of these products supports Model 204 Version 7 Release 5.0 and 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 sections that provide instructions for each operating system, followed by sections that provide instructions common to all operating systems.

The operating-system-specific topics (z/OS, z/VM, or z/VSE) describe:

  • Prerequisite Model 204 installation steps
  • Allocation of SoftSpy files
  • Required DD/DLBL/FILEDEF statements for SoftSpy files

Common installation sections are:

SoftSpy and Model 204 version 7.4

It is recommended that you install the SoftSpy version 7.5 SPYPROC file, because it is more robust than the 7.4 version.

The SoftSpy SOUL code (SPYPROC file) for 7.5 is compatible with Model 204 versions 7.4 and 7.5.

  • If you are currently running SoftSpy version 7.4 with Model 204 version 7.4, you can upgrade to SoftSpy 7.5 by downloading the SPYPROC file. (See the section "Downloading and installing SoftSpy 7.5 files" for your operating system later on this page.)
  • If you are installing SoftSpy for the first time with Model 204 version 7.4, you must install the SoftSpy object as described in SoftSpy version 7.4 installation files before downloading the 7.5 SPYPROC file.

Installation on IBM z/OS

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

Complete the z/OS-specific part of the installation process before performing the installation steps in the following sections, which apply to all operating system environments:

  • Update CCAIN
  • Online Installation Steps
  • Verify the Installation

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 about Model 204 version 7.5 and later, see Model 204 installation on IBM z/OS.

For details about Model 204 version 7.4, see the Rocket Model 204 Installation Guide for IBM z/OS, version 7.4.

Notes:

  • When you link-edit the Model 204 nucleus, ensure that the SSPY and MUSE text decks/CSECTs are linked in.
  • If you are running Model 204 version 7.4 and you have never installed SoftSpy before, you must install SoftSpy version 7.4 before upgrading to SoftSpy version 7.5.

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.

Downloading and installing SoftSpy 7.5 files on z/OS

Note: You must have either a Rocket M204 user ID or a Sirius user ID to download the installation files.

To install the SoftSpy 7.5 files:

  1. If you have not previously installed SoftSpy, modify and submit the SPYALOC JCL job. This job allocates the Model 204 SoftSpy data sets SPYPROC, SPYDATA, and SPYTEMP. The following table shows space requirements for these data sets:
    Database Name Number of 6184-byte pages
    SPYPROC 1000
    SPYDATA 160
    SPYTEMP 112
  2. If you have existing SPYPROC and SPYDATA files from a previous version, back them up.
  3. SPYPROC, the SoftSpy procedure file, is distributed as a standard Model 204 Dump file (a sequential file). Download SPYPROC, in binary form, from the SOUL files download page to a workstation file.
  4. Upload the file from your workstation to your z/OS system.
  5. RESTORE the file into the SPYPROC file.

z/OS installation next steps

The steps in this section apply to both SoftSpy 7.4 and SoftSpy 7.5 installation on z/OS systems.

Once you have uploaded the files into the allocated data sets and converted them to z/OS standard format, continue the installation as follows.

  1. Modify the ONLINE startup JCL.
    • If you are installing SoftSpy for the first time, add DD statements for the SPYDUMP, SPYPROC, SPYDATA, and SPYTEMP data sets to your ONLINE startup JCL.

      Following are samples of these statements:

      //SPYDUMP DD DSN=SYSM.M204.Vrrr.SPYPROC.DUMP,DISP=SHR //SPYPROC DD DSN=SYSM.M204.Vrrr.SPYPROC.M204,DISP=SHR //SPYDATA DD DSN=SYSM.M204.SPYDATA.M204,DISP=SHR //SPYTEMP DD DSN=SYSM.M204.SPYTEMP.M204,DISP=SHR

      where rrr is the current release level, such as 750 or 740.
    • For SoftSpy version 7.4, you will also need to add a DD statement for the ITSAUTH data set:

      //ITSAUTH DD DSN=SYSM.M204.ITSAUTH.M204,DISP=SHR

    • If you are upgrading from a previous version of SoftSpy, you only need to add DD statements for SPYDUMP and SPYPROC. The DD statements for SPYDATA, SPYTEMP, and ITSAUTH should already be present.

    Notes: The SPYDUMP DD is only necessary to perform the installation and can be removed afterward.
    For 7.5, the ITSAUTH DD can be removed.

  2. Make sure that the SYSOPT (system options) X'04' bit is off. This setting indicates that Model 204 data definition commands can only be executed from within the File Management Facility of Dictionary/204. (This facility is not used to create and format the SPYDATA and SPYTEMP files and their fields as documented in Online installation steps.) Normal SoftSpy operation is not affected by the SYSOPT X'04' bit setting.
  3. Continue the installation as described in Updating CCAIN.

Installation on IBM z/VM

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

Complete this part of the installation process before performing the installation steps in these sections, which apply to all operating system environments:

  • Updating CCAIN
  • Online Installation Steps
  • Verify the Installation

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 about Model 204 version 7.5, contact Technical Support.

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

Notes:

  • When you link-edit the Model 204 nucleus, ensure that the SSPY and MUSE text decks/CSECTs are linked in.
  • If you are running Model 204 version 7.4 and you have never installed SoftSpy before, you must install SoftSpy version 7.4 before upgrading to SoftSpy version 7.5.

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.

Downloading and installing SoftSpy 7.5 files on z/VM

Note: You must have either a Rocket M204 user ID or a Sirius user ID to download the installation files.

To install the SoftSpy version 7.5 files:

  1. If you have existing SPYPROC and SPYDATA files from a previous version, back them up.
  2. SPYPROC, the SoftSpy procedure file, is distributed as a standard Model 204 Dump file (a sequential file). Download SPYPROC, in binary form, from the SOUL files download page to a workstation file.
  3. Upload the file from your workstation to your z/VM system.
  4. RESTORE the file into the SPYPROC file.

z/VM installation next steps

The steps in this section apply to both SoftSpy 7.4 and SoftSpy 7.5 installation on z/VM systems.

  1. Run M204GEN to generate modules and saved segments, as you did when installing the Model 204 nucleus. For information, syntax, and rules for M204GEN, see the “M204GEN Command” section in the Rocket Model 204 Installation Guide for IBM z/VM, version 7.4.
  2. Reapply all early warnings. For information, see the “Applying early warnings” section in the Rocket Model 204 Installation Guide for IBM z/VM, version 7.4.
  3. If the SPYPROC, SPYTEMP, and SPYDATA database files will reside on an OS format disk, allocate them at this time. If you are upgrading from a previous version of SoftSpy, you only need to allocate the SPYPROC database file.
    1. SSPYFDEF is an exec that defines SoftSpy database files. SSPYFDEF resides on the MAINT204 193 disk. Edit SSPYFDEF to conform to your disk naming and file placement conventions. The following table shows space requirements:
    2. Database Name Number of 6184 byte pages Number of blocks on FBA devices
      SPYPROC 1000 12500
      SPYDATA 160 2133
      SPYTEMP 112 1500
    3. To allocate SoftSpy files on OS format disks, type:

      EXEC SSPYFDEF ALOCSSPY

  4. 7.4 only: If the ITSAUTH data set will reside on an OS format minidisk, allocate it at this time.

    ITSAUTH is a sequential file that contains authorization data and must be allocated to any job that uses SoftSpy with a DD name of ITSAUTH. ITSAUTH is 1 track in size and consists of fixed length 256 byte records. If the ITSAUTH stream will be on a CMS mini-disk, it does not have to be preallocated. On an OS format minidisk, allocate 8 blocks on FBA devices.

  5. Modify the ONLINE Startup EXEC. Note: ITSAUTH applies to version 7.4 only.
    • If you are installing SoftSpy for the first time, add FILEDEFs for the SPYDUMP, SPYPROC, SPYDATA, SPYTEMP, and ITSAUTH data sets to your ONLINE startup JCL. Samples of these FILEDEFs are:

      FILEDEF SPYPROC DISK SPYPROC DBVrrr filemode FILEDEF SPYDUMP DISK SPYPROC DUMP * FILEDEF SPYDATA DISK SPYDATA DATABASE filemode FILEDEF SPYTEMP DISK SPYTEMP DATABASE filemode FILEDEF ITSAUTH DISK ITSAUTH DATA filemode

      where rrr is the current release level, such as 750 or 740.

      If the SoftSpy files are on OS format disks, use FILEDEFs of the following format:

      FILEDEF SPYPROC filemode DSN SPYPROC DBVrrr M204 FILEDEF SPYDUMP DISK SPYPROC DUMP * FILEDEF SPYDATA filemode DSN SPYDATA M204 FILEDEF SPYTEMP filemode DSN SPYTEMP M204 FILEDEF ITSAUTH filemode DSN ITSAUTH DATA

      where rrr is the current release level, such as 750 or 740.

    • The installation process placed SPYDUMP on the MAINT204 200 disk. Use this dump of SPYPROC for the restore during the installation process.
    • If you are upgrading from a previous version of SoftSpy, you only need to add FILEDEFs for SPYDUMP and SPYPROC. The FILEDEFs for SPYDATA, SPYTEMP, and ITSAUTH should already be present.

    Note: The SPYDUMP FILEDEF is only necessary to perform the installation and can be removed afterward.

  6. Make sure that the SYSOPT (system options) X'04' bit is off.
  7. This setting indicates that Model 204 data definition commands can only be executed from within the File Management Facility of Dictionary/204. (This facility is not used to create and format the SPYDATA and SPYTEMP files and their fields as documented in Online installation steps.) Normal SoftSpy operation is not affected by the SYSOPT X'04' bit setting.

  8. Continue the installation as described in Updating CCAIN.

Installation on IBM z/VSE

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

Complete this part of the installation process before performing the installation steps in the following sections, which apply to all operating system environments:

  • Updating CCAIN
  • Online Installation Steps
  • Verify the Installation

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 about Model 204 version 7.5, see Model 204 installation on IBM z/VSE.

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

Notes:

  • When you link-edit the Model 204 nucleus, ensure that the SSPY and MUSE text decks/CSECTs are linked in.
  • If you are running Model 204 version 7.4 and you have never installed SoftSpy before, you must install SoftSpy version 7.4 before upgrading to SoftSpy version 7.5.

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.

Downloading and installing SoftSpy 7.5 files on z/VSE

This section describes how to download and modify the SoftSpy version 7.5 installation files.

Note: You must have either a Rocket M204 user ID or a Sirius user ID to download the installation files.

  1. If you have not previously installed SoftSpy, modify and submit the SPYALOC JCL job. This job allocates the Model 204 SoftSpy data sets SPYPROC, SPYDATA, and SPYTEMP.
  2. If you have existing SPYPROC and SPYDATA files from a previous version, back them up.
  3. SPYPROC, the SoftSpy procedure file, is distributed as a standard Model 204 Dump file (a sequential file). Download SPYPROC, in binary form, from the SOUL files download page to a workstation file.
  4. Upload the file from your workstation to your z/VSE system.
  5. RESTORE the file into the SPYPROC file.

    For detailed instructions, see Downloading and restoring SOUL files.

  6. Use the information in SPYPROC 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.
  7. Modify and submit LINKONLN and LINKB204 to relink your BATCH204 and ONLINE phases.
  8. Complete the installation process as described in the following section.

z/VSE installation next steps

The steps in this section apply to both SoftSpy 7.4 and SoftSpy 7.5 installation on z/VSE systems.

  1. Allocate the SoftSpy databases and ITSAUTH data set. Note: ITSAUTH applies to version 7.4 only.
    • If upgrading from a prior version of SoftSpy, execute the SPYRINST job from the JCL library. This job will allocate the new SPYPROC file.
    • If performing a SoftSpy installation for the first time, execute the SPYINST job from the JCL library. This job will allocate SPYPROC, SPYDATA, SPYTEMP, and ITSAUTH files.
    Database NameNumber of 6184 byte pagesNumber of blocks on FBA devices
    SPYPROC100012500
    SPYDATA1602133
    SPYTEMP1121500
  2. Modify ONLINE Startup JCL.
    • If you are installing SoftSpy for the first time, add DLBL, EXTENT and ASSGN statements for the SPYDUMP, SPYPROC, SPYDATA, SPYTEMP, and ITSAUTH data sets to your ONLINE startup JCL. Following are samples of these statements:

      // DLBL SPYPROC,'M204.SPYPROC',,DA // EXTENT SYS021,volser // ASSGN SYS021,DISK,VOL=volser,SHR // DLBL SPYDATA,'M204.SPYDATA',,DA // EXTENT SYS021,volser // ASSGN SYS021,DISK,VOL=volser,SHR // DLBL SPYTEMP,'M204.SPYTEMP',,DA // EXTENT SYS021,volser // ASSGN SYS021,DISK,VOL=volser,SHR // DLBL SPYDUMP,'M204.SPYPROC.DUMP',,DA // EXTENT SYS021,volser // ASSGN SYS021,DISK,VOL=volser,SHR // DLBL ITSAUTH,'M204.ITSAUTH',,SD // EXTENT SYS021,volser // ASSGN SYS021,DISK,VOL=volser,SHR

    • If you are upgrading from a previous version of SoftSpy, then you only need to add DLBL, EXTENT and ASSGN statements for SPYDUMP and SPYPROC. The DLBL, EXTENT and ASSGN statements for SPYDATA, SPYTEMP, and ITSAUTH should already be present.
    • Note: The SPYDUMP DD is only necessary to perform the installation and can be removed afterward.

  3. Make sure that the SYSOPT (system options) X'04' bit is off.
    The SYSOPT X'04' bit setting indicates that Model 204 data definition commands can only be executed from within the File Management Facility of Dictionary/204. (This facility is not used to create and format the SPYDATA and SPYTEMP files and their fields as documented in Online installation steps.) Normal SoftSpy operation is not affected by the SYSOPT X'04' bit setting.
  4. Continue the installation as described in "Updating CCAIN".

Updating CCAIN

This section describes the changes required to the CCAIN input stream to install and use SoftSpy. Depending on your situation, the following changes might be needed, as described in this section:

  • Adding IODEV=55 threads
  • Adjusting the NUSERS parameter
  • Ensuring that a large enough server is available
  • Adjusting the LENQTBL parameter
  • Adjusting the SPCORE parameter for SoftSpy operation
  • Adjusting the SPCORE parameter for MUSE operation

Adding IODEV=55 threads

Every concurrent end user SoftSpy session requires a separate SoftSpy server thread. Each IODEV=55 statement that you add to the CCAIN input stream will create a distinct SoftSpy server thread. The following example illustrates the lines to be added to the CCAIN stream to create three SoftSpy servers.

IODEV=55,AUTOSYS=C'',LIBUFF=255,LOBUFF=255,NORQS=5 IODEV=55,AUTOSYS=C'',LIBUFF=255,LOBUFF=255,NORQS=5 IODEV=55,AUTOSYS=C'',LIBUFF=255,LOBUFF=255,NORQS=5

The settings shown for the AUTOSYS and NORQS parameter are required for SoftSpy to work properly. The settings shown for LIBUFF and LOBUFF are necessary to minimize SoftSpy server table usage.

In order to use SoftSpy from a particular full screen thread, the size of the output page buffer (LOUTPB) must match the size of the output page buffer of an available SoftSpy server thread. If you use different values for LOUTPB for different full screen threads, then you should create SoftSpy servers for each distinct value of LOUTPB.

Adjusting the NUSERS parameter

The NUSERS parameter needs to be increased by the number of IODEV=55 threads you have added to run SoftSpy servers. An increase in the NUSERS parameter might require a change to the size of the server data set. See Creating server data sets (CCASERVR) for a complete discussion of server data sets.

Ensuring that a large enough server is available

SoftSpy servers normally use a Model 204 SERVSIZE of 280,000. However, there are cases where a larger server is required. This is because certain server tables whose sizes cannot be reset by SoftSpy contribute to overall server size requirements. If the sum of the size of RTBL, LOUTPB, and LFTBL exceeds 8,000 then a larger server will be required. The server size requirement is increased beyond 280,000 by the amount that the specified sum exceeds 8,000. Make sure that at least one in-core server is large enough to support this requirement.

Information about setting LOUTPB is contained in Adding IODEV=55 threads. SoftSpy automatically sets LFTBL to NGROUP*4 for each of the IODEV=55 threads. The size of RTBL depends on the values of the NGROUP, NFILES, and NRMTFILE parameters. The size of RTBL is usually the most important influence on increased server size requirements.

If the parallel query option of Model 204 is being used then the size of RTBL is:

( NGROUP + 12 ) * ( NFILES + NRMTFILE + 3 ) + NRMTFILE + 1

Otherwise, the size of RTBL is:

( NGROUP + 12 ) * ( NFILES + 3 )

In either case, the size of RTBL is rounded up to the next higher multiple of eight.

Adjusting the LENQTBL parameter

When SoftSpy servers are run, the LENQTBL parameter might need to be increased. The size of the enqueue table is based on the product of NUSERS and LENQTBL. When NUSERS is small, the value of LENQTBL might need to be set to at least 500.

Adjusting the SPCORE parameter for SoftSpy operation

The SPCORE parameter specifies the amount of storage to be set aside above and below the 16Mb line for operating system and run-time dynamic storage requests. The value of this parameter might need to be increased to accommodate the run-time requirements of SoftSpy. The storage required can be calculated with the formulas:

where n is the number of threads running a SoftSpy Server, and LOUTPBi is the size of the output page buffer for the given server thread.

The additional SPCORE requirement is a. The value derived for b represents the amount of storage that is allocated above the 16M line and does not impact SPCORE.

To maintain the number of disk buffers, an increase in MVS region size, CMS virtual machine size, or VSE partition size might be necessary. If increasing the region size is not viable, you can reduce either the number of disk buffers or the number of in-memory servers.

Adjusting the SPCORE parameter for MUSE operation

When MUSE is in use, additional storage is required. Although SPCORE is not affected, region (or virtual machine) size could be impacted.

The amount of storage needed for MUSE is computed by summing the storage requirements of each simultaneous user of MUSE. For each user, the amount of storage needed by MUSE is:

muse_storage = header_storage + max_muse_streams * ( header_storage + 1088 )

where

header_storage = 110 + ( MAXHDR + MAXTRL ) * ( HTLEN + 5 )

and max_muse_streams is the maximum number of MUSE output streams (created by MUSE OPEN(C) or USE) that will be open at any given time. For example, if

max_muse_streams = 2

MAXHDR = MAXTRL = 5

HTLEN = 132

then

header_storage = 110 + ( 5 + 5 ) * ( 132 + 5 ) = 1480

muse_storage = 1480 + 2 * ( 1480 + 1088 ) = 6616

Online installation steps

This section describes SoftSpy installation steps that are performed online from within Model 204.

Requirement: These steps must be performed using a Model 204 ONLINE that includes the SPYDUMP, SPYPROC, SPYDATA, SPYTEMP, and ITSAUTH data sets described in the installation section for each operating system.

Prerequisite: The CCAIN input stream for the ONLINE must have been updated as described in Updating CCAIN.

Perform the following steps, as described in this section:

  1. Log on to Model 204.
  2. Stop the SoftSpy subsystem.
  3. Create and restore the SPYPROC file.
  4. Run the INSTALL.SOFTSPY procedure.
  5. Set passwords for the SPYPROC and SPYDATA files
  6. Set the authorized product configuration.

Logging on to Model 204

Log on to Model 204 using an account with system manager privileges.

LOGON accountname password

Temporarily removing IODEV=55 threads

If SoftSpy has been previously installed, comment out the IODEV=55 threads and reduce NUSERS by the number of threads that were commented out.

Add these threads back in and change NUSERS accordingly before attempting to run SOFTSPY.

Stopping the SoftSpy subsystem

If SoftSpy has been previously installed, all use of SoftSpy must be terminated before you proceed. To terminate SoftSpy, issue the Model 204 command:

STOP SUBSYSTEM SOFTSPY

Creating and restoring the SPYPROC file

Create and restore the SPYPROC file using the commands below:

CREATE FILE SPYPROC END OPEN FILE SPYPROC IN SPYPROC INITIALIZE RESTORE 128 FROM SPYDUMP

Running the INSTALL.SOFTSPY procedure

The creation of the SoftSpy subsystem and the formatting of SPYTEMP and SPYDATA is performed by the INSTALL.SOFTSPY procedure.

  1. To begin the process, enter the following commands:

    OPEN SPYPROC INCLUDE INSTALL.SOFTSPY

    This procedure will prompt you for the information it needs to create the subsystem and to initialize or upgrade the SPYDATA file.
  2. The following prompt appears:

    $$Is SOFTSPY currently installed on this ONLINE (Y/N)?

    • If SoftSpy has previously been installed, and you want to perform an upgrade style installation of the new version, respond Y. This will cause access control lists and macros from the previous version contained in the SPYDATA file to be preserved.
    • Otherwise, respond N.
  3. If you are performing an upgrade style installation, the following prompt appears:

    $$Enter READ password for SPYDATA:

    Enter a read password (one with at least X'8041' privdef privileges) for the SPYDATA file. If the SPYDATA file cannot be opened with read access using the specified password, the installation process will terminate with an error message.
  4. The following prompt appears:

    $$Enter READ/WRITE password for CCASYS:

    Enter a read/write password (one with at least X'00C1' privdef privileges) for the CCASYS file. This allows the procedure to perform all required subsystem management for the SoftSpy subsystem. If the CCASYS file cannot be opened with read/write access, the installation process will terminate with an error message.
  5. If a subsystem with the name SOFTSPY is defined that is not the SoftSpy subsystem, the following prompt appears:

    $$A subsystem named SOFTSPY already exists. Replace (Y/N)?

    • If you want to replace the existing SoftSpy subsystem with the new SoftSpy subsystem, respond Y.
    • If not, respond N. A response of N will terminate the installation process.
  6. The following prompt appears:

    $$Enter an Administrator User ID. Press <ENTER> when finished.

    Enter the Model 204 account of anyone who is to be given Model 204 ADMIN SCLASS privileges for the SoftSpy subsystem. Users added will supplement those added by previous installations of SoftSpy. The users in this SCLASS will be able to use the SoftSpy EDIT CONFIG command. For more information, see EDIT CONFIG.

    Subsequent changes to the list of users with ADMIN privileges for the subsystem must be made using the Model 204 Subsystem Management Facility. See Subsystem Administration screen for more information.

    The user id will be checked for compliance with Model 204 conventions but will not be validated for existence in the CCASTAT file. The User ID prompt will appear repeatedly until you respond by pressing the Enter key without entering a User ID. The Model 204 account of the user who is running this procedure is included in the list automatically.
  7. If you are performing an upgrade style installation, you might receive the prompt:

    Macro macro_identifier already exists. 1. Replace with NEW version. 2. Discard NEW version. 3. Rename NEW version. 4. Rename OLD version. $$Please choose an option:

    This prompt is issued when a SoftSpy macro being installed has the same name as an existing macro and the new macro is different from the existing macro.

    • Enter 1 if you want the new version to replace the existing version.
    • Enter 2 if you want to discard the new version.
    • Enter 3 to save the new version under a different name.
    • Enter 4 to rename the existing macro and save the new version with the name displayed.

    An invalid response will cause the prompt to be redisplayed.

    The following prompt appears:

    $$Please enter new name or press <ENTER> to accept: "macro_identifier_BAK"

    If you select option 3 or 4, you will be prompted for a new name for the new or old version of the macro, respectively. You can respond with any valid SoftSpy macro name or press ENTER to accept the suggested name macro_identifier_BAK. If macro_identifier_BAK exists, the suggested name will have additional _BAK strings appended to it until a unique name can be presented.

Set Passwords for the SPYPROC and SPYDATA Files

The SPYPROC, SPYDATA, and SPYTEMP files are set to private at the end of the successful execution of the INSTALL.SOFTSPY procedure. A read password for the SPYDATA file will be required to install future upgrades to SoftSpy, and a procedure execution password for the SPYPROC file will be required if you need to reinitialize the SPYTEMP file. It is recommended that you assign passwords for these files. The Model 204 LOGCTL command is used to add passwords to CCASTAT, as shown in the following example:

LOGCTL A :SPYDATA READ,X'8441' <ENTER> LOGCTL A :SPYPROC EXECUTE,X'8021' <ENTER>

In the above example, the password READ is assigned as the read password for the SPYDATA file, and the password EXECUTE is assigned as the procedure execution password for the SPYPROC file. The <ENTER> notation indicates that the command expects further input, and the enter key is pressed to take the default. See LOGCTL command: Modifying file entries in the password table for a complete discussion of the LOGCTL syntax and parameters.

Set the Authorized Product Configuration

  1. Enter the following command to invoke the SoftSpy configuration editor:

    SPY EDIT CONFIG

    The editor displays a screen similar to the following figure.

    EDIT CONFIG Definition Screen

  2. Press the FORWARD PF key (PF8) to display the authorization entry screen.

    This screen is used to authorize your use of SoftSpy.

    EDIT CONFIG Authorization Entry Screen

  3. Update this screen with any new configuration information, expiration date, and authorization key provided with your installation materials. If your authorization key is for an expiration date that has passed, you must contact Technical Support to obtain a new authorization key.
  4. Once you have made any required changes, press the SAVE PF key (PF6) to save the configuration. Saving the configuration information will write it out to the SPYDATA file. It will also activate SoftSpy servers running in IODEV=55 threads.
  5. Press the QUIT PF key (PF3) to exit the SoftSpy configuration editor. All authorized products should now be ready for use.

Verifying the installation

This section describes the process of verifying that SoftSpy and MUSE are correctly installed and available for general use.

Verify SoftSpy operation

  1. To test that SoftSpy server(s) are enabled issue the command:

    SPY ON

    When SoftSpy has been successfully turned on, the following message will be displayed prior to the Model 204 command prompt. (There will be a short delay prior to the message while the SoftSpy User Language code precompiles.)

    SPY ON SPY.021: For the exclusive use of SoftSpy Trial > 

  2. Create an ad hoc procedure like the one shown below or include any existing procedure that you have available.

    BEGIN FOR %I FROM 1 TO 5 %J = %I * %I PRINT %I AND 'SQUARED IS' AND %J END FOR END

  3. The SoftSpy interactive evaluation screen will now be displayed on your terminal:

    SoftSpy Interactive Evaluation Screen

  4. Type the command:

    WATCH %I, %J

    so that you can monitor the values of the percent variables as they change during evaluation. Use PF4 to single step through the procedure or PF5 to run the procedure to its end. You can also refer to the Introduction to SoftSpy for information about other SoftSpy features to try.
  5. At the completion of this test, turn off SoftSpy by issuing the command:

    SPY OFF

    You can issue the SPY OFF command from either the Model 204 command prompt or from the command area just above the PF key labels on the SoftSpy screen.

If you experience any difficulties, contact Technical Support.

Verify MUSE operation

You can run two simple tests to verify that MUSE is available for use:

  1. To verify command-level MUSE, enter the following command at the Model 204 command prompt:

    MUSE CLOSE *

    If no errors are issued, then command-level MUSE is active, and ready for use.
  2. To verify statement-level MUSE, enter and run the following request:

    BEGIN MUSE CLOSE * END

    If this simple request compiles and evaluates without errors, then statement-level MUSE is active and ready for use.

If you experience any difficulties, contact Technical Support.

Customizing SoftSpy

This section describes the process of customizing SoftSpy for site-specific needs.

Customize the SoftSpy configuration

SoftSpy uses configuration information to determine the access authority of end users during SoftSpy sessions. The configuration can be modified only by those Model 204 users whose user identifiers have been included in the SoftSpy ADMIN SCLASS through subsystem management. The initial installation process will prompt you for a list of those user identifiers and perform the required subsystem management tasks. If you want to modify the list of users who are authorized to perform configuration changes, you must use Model 204 Subsystem Management.

The SoftSpy configuration lets you limit end user access to certain SoftSpy features. This is done by associating an Access Control List (ACL) with a SoftSpy privilege through the EDIT CONFIG command. An ACL is a list of Model 204 users who are to be granted privileges. The following table shows which privileges can be limited and the name of the ACL associated with each at the completion of an initial installation.

Privilege Name Associated ACL Meaning
M204 Ad Hoc ADMIN User can issue M204 command from SoftSpy command line or user macro.
M204 Macro null User can issue M204 command from system macros.
Read ACL ADMIN User can read access control lists.
Read MACRO null User can read system macros.
SoftSpy Server ADMIN User can issue the SPY SERVER command.
Spy ON null User can issue the SPY ON command.
Update ACL ADMIN User can update access control lists.
Update MACRO ADMIN User can update system macros.

Model 204 users who are in the ADMIN SCLASS can use the SoftSpy EDIT CONFIG command to change the name of the ACL associated with any of the commands listed above. When an end user attempts to use the command, the newly associated ACL will be checked. A null ACL name indicates that all end users may use the command.

ACLs are constructed and maintained using the EDIT ACL command. Initially, the only users who can perform this function are those that were entered during the installation process. The ADMIN ACL is constructed during an initial installation with the same user identifiers that are put into the SoftSpy Subsystem ADMIN SCLASS.

Customize SoftSpy Environments

The SoftSpy environments topic provides instructions for customizing SoftSpy environments to meet local needs. You can change the following environments:

  • Base environment
  • Interactive Debug environment
  • Interactive Performance Tuning environment
  • Interactive Quality Assurance Testing environment

Each of these environments can be customized at two levels:

  • For all users of SoftSpy, or,
  • For individual users (by Model 204 User ID).

You can customize items such as PFKEY settings and data display columns.

The Tailoring environments section also describes how to make SoftSpy skip over the interactive execution of selected subsystems that are used as tools (such as SSTEST). You can customize SoftSpy to skip over any number of selected subsystems.

Additionally, the SoftSpy macro listing provides a complete listing of the SoftSpy macros, which you can customize as needed.

System Manager Considerations

SoftSpy uses background tasks called SoftSpy servers that normally run in IODEV=55 threads to assist in program monitoring. When a User Language program is being executed under the control of SoftSpy, the program is run in the user's normal server, and one of the server threads is used by SoftSpy to control and monitor the execution of the program. There must be one server thread for each simultaneous user of SoftSpy.

SoftSpy and the MONITOR Command

SoftSpy uses two wait type codes displayed by using the MONITOR command. The codes appear in the WT column that contains the wait type for a user.

The wait code values are:

38 Execution is suspended and the SoftSpy server is awaiting a request from a user.
39 A user is suspended while a SoftSpy server is performing operations for the user.

Both of these wait type codes are swappable but not bumpable.

SoftSpy files

SoftSpy uses four different files. The usage of each file is summarized below.

File Description
SPYPROC This file contains procedures and help information used by SoftSpy. It is never updated, and it can be shared between several different online systems. If this file is corrupted it can be restored from the installation materials.
SPYDATA This file contains various types of data that must be retained. This includes configuration information, Access Control Lists (ACLs) and copies of all SoftSpy macros. A base version of this file is created by the installation process, but the information in this file is modified when configuration, ACL, or macro changes are made. Periodic backups of this file should be made for recovery purposes. A separate instance of this file is required for each online system.
SPYTEMP This file serves as a scratch pad for information during the execution of SoftSpy. Currently defined window descriptions, copies of macros being edited, and PF key settings are examples of the information saved in SPYTEMP. The CREATE.SPYTEMP procedure in SPYPROC can be used to recreate this file if necessary. A separate instance of this file is required for each online system.
ITSAUTH This file contains authorization data. It is a simple sequential file containing 256 byte fixed length records. It is refreshed when the SoftSpy configuration is saved using the SPY EDIT CONFIG command. If SoftSpy will be used in multiple online and batch systems, ITSAUTH should be shared among them.

Additional Installations

This section discusses the procedures to follow when you have already installed the current version of SoftSpy and MUSE successfully, and you wish to install them again in different ONLINE or BATCH204 jobs. These procedures are designed to speed up the process for a system manager who is very familiar with SoftSpy and MUSE installation and wants to save time. However, it is never a problem to perform the entire installation process again.

Install SoftSpy in additional ONLINE jobs

If you are installing SoftSpy in additional ONLINEs under the same operating system and Model 204 release after an initial installation, you can use an abbreviated procedure.

The SPYPROC file is never updated and can be shared by multiple ONLINEs running SoftSpy. Therefore, you can omit the Creating and restoring the SPYPROC file step on subsequent ONLINEs.

The DDs/DLBLs/ FILEDEFs for SPYPROC and ITSAUTH for each ONLINE can point to the same data set.

Each ONLINE must have its own SPYTEMP and SPYDATA files.

The INSTALL.SOFTSPY procedure must be run in each ONLINE to add the subsystem definition to CCASYS and to create and initialize SPYTEMP and SPYDATA.

Install MUSE in additional ONLINE and BATCH204 jobs

You might want to use MUSE in Model 204 ONLINE or BATCH204 jobs in addition to the job where SoftSpy was initially installed. For these additional job streams, add a DD/FILEDEF/DLBL for the previously created ITSAUTH data set to the job stream.

VSE JCL

The following JCL files are used for SoftSpy installation on z/VSE systems:

SPYINST allocates SoftSpy system files
SPYRINST allocates SPYPROC and SPYDUMP files

In the JCL files below, the variable xxx has been substituted for the release number; for example:

// LIBDEF PROC,SEARCH=M204LIB.Vxxx

Replace xxx with 750 or 740, as applicable; for example:

// LIBDEF PROC,SEARCH=M204LIB.V740

SPYINST JCL

// JOB SPYINST * ******************************************************************** * Rocket Model 204 * * ******************************************************************** /* SPYINST allocates SoftSpy system files. /* Note that in the allocate step the DLBL and EXTENTs are /* stated explicitly for each SoftSpy system file, while in /* the create step the SoftSpy proc is used. The allocate /* step cannot have the direct access (DA) code present on /* the DLBL statements, and the create step (and the online /* job) must have the (DA) code present. /* * /* Make sure that the explicit DLBL and EXTENT statements in /* the allocate step match the proc in all aspects except /* the DA codes. /* /* *************************************************************** /* *************************************************************** /* /* Add assign statements as needed: /* * /* // ASSGN SYS000,X'CUU' /* /* The JCL as it is provided assumes you have made /* standard assignments for the logical units (SYS000) /* you reference in your EXTENT statements. /* * /* *************************************************************** /* To adapt this stream to your particular installation the /* following changes should be made: /* /* (1) Modify the job statement to conform to your standards. /* /* (2) Change the DLBL and EXTENT to reflect your dataset /* names and locations as in other MODEL 204 jobs. /* assign SYS008 to a printer for the audit trail, or /* add DLBL and EXTENT statements for ccaaudit. /* /* *************************************************************** /* /* *************************************************************** /* step alloc: MODEL204 allocate of all SoftSpy system files * /* ************************************************************** * /* // EXEC PROC=M204JCL DLBL for JCL sublibrary // LIBDEF PROC,SEARCH=M204LIB.xxx // EXEC PROC=M204Vxxx DLBL for Vxxx M204 library // EXEC PROC=M204SYS DLBLS FOR CCASTAT, CCATEMP // LIBDEF PHASE,SEARCH=M204LIB.Vxxx // DLBL SPYPROC,'M204.SPYPROC',99/366,SD // EXTENT SYS000,volser,,,0000,000 (AT LEAST 400 PAGES) // DLBL SPYDATA,'M204.SPYDATA',99/366,SD // EXTENT SYS000,volser,,,0000,000 (AT LEAST 150 PAGES) // DLBL SPYTEMP,'M204.SPYTEMP',99/366,SD // EXTENT SYS000,volser,,,0000,000 (AT LEAST 100 PAGES) // DLBL ITSAUTH,'M204.ITSAUTH',99/366,SD // EXTENT SYS000,volser,,,0000,000 (AT LEAST 7 PAGES) // ASSGN SYS000,DISK,VOL=volser,SHR // ASSGN SYS008,PRINTER // EXEC ALLOCATE,SIZE=AUTO ALLOCATE FILE(SPYPROC,SPYDATA,SPYTEMP,ITSAUTH) /* // EXEC PROC=M204JCL DLBL for JCL sublibrary // LIBDEF PROC,SEARCH=M204LIB.Vxxx // EXEC LIBR ACCESS S=M204LIB.Vxxx CATALOG SFTSPY.PROC REPLACE=YES // DLBL SPYDUMP,'M204.SPYPROC.DUMP',,SD // EXTENT SYS000,volser // DLBL SPYPROC,'M204.SPYPROC',,DA // EXTENT SYS000,volser // DLBL SPYDATA,'M204.SPYDATA',,DA // EXTENT SYS000,volser // DLBL SPYTEMP,'M204.SPYTEMP',,DA // EXTENT SYS000,volser // DLBL ITSAUTH,'M204.ITSAUTH',,DA // EXTENT SYS000,volser /+ /* /&

SPYRINST JCL

// JOB SPYRINST * ******************************************************************** * Rocket Model 204 * * ******************************************************************** /* SPYRINST allocates SPYPROC and SPYDUMP files. /* * /* Note that in the allocate step the DLBL and EXTENTs are /* stated explicitly for each SoftSpy system file, while in /* the create step the SoftSpy proc is used. The allocate /* step cannot have the direct access (DA) code present on /* the DLBL statements, and the create step (and the online /* job) must have the (DA) code present. /* /* Make sure that the explicit DLBL and EXTENT statements in /* the allocate step match the proc in all aspects except /* the DA codes. /* /* *************************************************************** /* *************************************************************** /* * /* Add assign statements as needed: /* /* // ASSGN SYS000,X'CUU' /* /* The jcl as it is provided assumes you have made /* standard assignments for the logical units (SYS000) /* you reference in your EXTENT statements. /* /* *************************************************************** /* To adapt this stream to your particular installation the /* following changes should be made: /* /* (1) Modify the job statement to conform to your standards. /* /* (2) Change the DLBL and EXTENT to reflect your dataset /* names and locations as in other MODEL 204 jobs. /* Assign SYS008 to a printer for the audit trail, or /* add DLBL and EXTENT statements for ccaaudit. /* /* *************************************************************** /* /* *************************************************************** /* step alloc: MODEL204 allocate of all SoftSpy system files /* *************************************************************** /* // EXEC PROC=M204JCL DLBL for JCL sublibrary // LIBDEF PROC,SEARCH=M204LIB.Vxxx // EXEC PROC=M204Vxxx DLBL for Vxxx M204 library // EXEC PROC=M204SYS DLBLS FOR CCASTAT, CCATEMP // LIBDEF PHASE,SEARCH=M204LIB.Vxxx // DLBL SPYPROC,'M204.SPYPROC',exp date,SD // EXTENT SYS000,volser,,,0000,000 (AT LEAST 400 PAGES) // ASSGN SYS008,PRINTER // EXEC ALLOCATE,SIZE=AUTO ALLOCATE FILE(SPYPROC) /* // EXEC PROC=M204JCL DLBL for JCL sublibrary // LIBDEF PROC,SEARCH=M204LIB.Vxxx // EXEC LIBR ACCESS S=M204LIB.Vxxx CATALOG SFTSPY.PROC REPLACE=YES // DLBL SPYDUMP,'M204.SPYPROC.DUMP',,SD // EXTENT SYS000,volser // DLBL SPYPROC,'M204.SPYPROC',,DA // EXTENT SYS000,volser // DLBL SPYDATA,'M204.SPYDATA',,DA // EXTENT SYS000,volser // DLBL SPYTEMP,'M204.SPYTEMP',,DA // EXTENT SYS000,volser // DLBL ITSAUTH,'M204.ITSAUTH',,DA // EXTENT SYS000,volser /+ /* /&