SoftSpy installation guide - Revision history

JDamon at 19:30, 1 May 2017

2017-05-01T19:30:19Z

← Older revision		Revision as of 19:30, 1 May 2017
Line 90:		Line 90:
	To install the SoftSpy 7.5 files:		To install the SoftSpy 7.5 files:
	<ol>		<ol>
	<li>If you have not previously installed SoftSpy, modify and submit ~~the modify~~ the [[SoftSpy SPYALOC job stream\|SPYALOC]] JCL job. This job allocates the <var class="product">Model 204</var> SoftSpy data sets SPYPROC, SPYDATA, and SPYTEMP. The following table shows space requirements for these data sets:		<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 204</var> SoftSpy data sets SPYPROC, SPYDATA, and SPYTEMP. The following table shows space requirements for these data sets:
	<table>		<table>
	<tr>		<tr>

ELowell: /* Introduction */

2017-04-13T23:32:28Z

Introduction

← Older revision		Revision as of 23:32, 13 April 2017
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 204</var>. When performing the installation, you should have a copy of the Rocket <var class="product">Model 204</var> [[~~#Prerequisite:_Installing_Model.C2.A0204~~\|~~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 204</var>. When performing the installation, you should have a copy of the Rocket <var class="product">Model 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>

ELowell at 23:15, 13 April 2017

2017-04-13T23:15:55Z

← Older revision		Revision as of 23:15, 13 April 2017
Line 592:		Line 592:
	<li>The following prompt appears:		<li>The following prompt appears:
	<p class="code">$$Enter an Administrator User ID. Press <ENTER> when finished.</p>		<p class="code">$$Enter an Administrator User ID. Press <ENTER> when finished.</p>
	Enter the <var class="product">Model 204</var> account of anyone who is to be given <var class="product">Model 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 204</var> account of anyone who is to be given <var class="product">Model 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 204</var>		Subsequent changes to the list of users with ADMIN privileges for the subsystem must be made using the <var class="product">Model 204</var>
Line 706:		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 817:		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 836:		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==

ELowell: /* Prerequisite: Installing Model 204 */

2017-04-13T22:50:39Z

Prerequisite: Installing Model 204

← Older revision		Revision as of 22:50, 13 April 2017
Line 71:		Line 71:
	<li>Install Dictionary/204</li></ul>		<li>Install Dictionary/204</li></ul>

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

ELowell at 22:50, 13 April 2017

2017-04-13T22:50:04Z

← Older revision		Revision as of 22:50, 13 April 2017
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 204</var>. When performing the installation, you should have a copy of the Rocket <var class="product">Model 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 204</var>. When performing the installation, you should have a copy of the Rocket <var class="product">Model 204</var> [[#Prerequisite:_Installing_Model.C2.A0204\|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 595:		Line 595:

	Subsequent changes to the list of users with ADMIN privileges for the subsystem must be made using the <var class="product">Model 204</var>		Subsequent changes to the list of users with ADMIN privileges for the subsystem must be made using the <var class="product">Model 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 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 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>

ELowell: /* Adjusting the NUSERS parameter */

2017-04-13T22:31:31Z

Adjusting the NUSERS parameter

← Older revision		Revision as of 22:31, 13 April 2017
Line 390:		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===

ELowell: /* Downloading and installing SoftSpy 7.5 files on z/VM */

2017-02-07T23:44:24Z

Downloading and installing SoftSpy 7.5 files on z/VM

← Older revision		Revision as of 23:44, 7 February 2017
Line 183:		Line 183:
	<p>To install the SoftSpy version 7.5 files:</p>		<p>To install the SoftSpy version 7.5 files:</p>
	<ol>		<ol>
	<li>SPYPROC, the SoftSpy procedure file, is distributed in a ~~dump format~~. 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>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/VM system.</li>		<li>Upload the file from your workstation to your z/VM system.</li>
	<li>RESTORE the file into ~~a Model 204 SOUL~~ file.</li>		<li>RESTORE the file into the SPYPROC file.</li>
	</ol>		</ol>

ELowell: /* Downloading and installing SoftSpy 7.5 files on z/VSE */

2017-02-07T23:41:58Z

Downloading and installing SoftSpy 7.5 files on z/VSE

← Older revision		Revision as of 23:41, 7 February 2017
Line 292:		Line 292:
	<ol>		<ol>
	<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 204</var> SoftSpy data sets SPYPROC, SPYDATA, and SPYTEMP.</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 204</var> SoftSpy data sets SPYPROC, SPYDATA, and SPYTEMP.</li>
	<li>SPYPROC, the SoftSpy procedure file, is distributed in a ~~dump format~~. 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>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>Upload the file from your workstation to your z/VSE system.</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>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.

ELowell: /* Downloading and installing SoftSpy 7.5 files on z/OS */

2017-02-07T23:40:00Z

Downloading and installing SoftSpy 7.5 files on z/OS

← Older revision		Revision as of 23:40, 7 February 2017
Line 110:		Line 110:
	</table>		</table>
	</li>		</li>
	<li>SPYPROC, the SoftSpy procedure file, is distributed in a ~~dump format~~. 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>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>Upload the file from your workstation to your z/OS system.</li>
	<li>RESTORE the file into ~~a Model 204 SOUL~~ file.</li>		<li>RESTORE the file into the SPYPROC file.</li>
	</ol>		</ol>

ELowell: /* Prerequisite: Installing Model 204 */

2017-02-07T21:46:55Z

Prerequisite: Installing Model 204

← Older revision		Revision as of 21:46, 7 February 2017
Line 165:		Line 165:
	</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>