RKTools installation - Revision history

Mlarocca: /* Janus Web rules for RKWeb */

2017-10-09T17:03:25Z

Janus Web rules for RKWeb

← Older revision		Revision as of 17:03, 9 October 2017
Line 565:		Line 565:

	<b></b>*... Rules supporting the applications implemented as Janus Legacy apps.		<b></b>*... Rules supporting the applications implemented as Janus Legacy apps.
			JANUS WEB <i>portname</i> DISALLOW /ACE*
			JANUS WEB <i>portname</i> DISALLOW /RKW*
	JANUS WEB <i>portname</i> DISALLOW /SIRLIB*		JANUS WEB <i>portname</i> DISALLOW /SIRLIB*
	JANUS WEB <i>portname</i> DISALLOW /DICTADMIN*		JANUS WEB <i>portname</i> DISALLOW /DICTADMIN*
Line 574:		Line 576:
	JANUS WEB <i>portname</i> DISALLOW /CCATSF*		JANUS WEB <i>portname</i> DISALLOW /CCATSF*

			JANUS WEB <i>portname</i> ALLOW /ACE* USER *
			JANUS WEB <i>portname</i> ALLOW /RKW* USER *
	JANUS WEB <i>portname</i> ALLOW /SIRLIB* USER *		JANUS WEB <i>portname</i> ALLOW /SIRLIB* USER *
	JANUS WEB <i>portname</i> ALLOW /DICTADMIN* USER *		JANUS WEB <i>portname</i> ALLOW /DICTADMIN* USER *
Line 580:		Line 584:
	JANUS WEB <i>portname</i> ALLOW /XREF* USER *		JANUS WEB <i>portname</i> ALLOW /XREF* USER *
	JANUS WEB <i>portname</i> ALLOW /FILEMGMT* USER *		JANUS WEB <i>portname</i> ALLOW /FILEMGMT* USER *
	JANUS WEB <i>portname</i> ALLOW /CCACATREPT* USER *		JANUS WEB <i>portname</i> ALLOW /CCACATREPT* USER *
	JANUS WEB <i>portname</i> ALLOW /CCATSF* USER *		JANUS WEB <i>portname</i> ALLOW /CCATSF* USER *

	JANUS WEB <i>portname</i> ON /SIRLIB* CMD 'SIRLIB *'		JANUS WEB <i>portname</i> ON /SIRLIB* CMD 'SIRLIB *'

JAL: /* Download the installation file */ change link

2017-08-11T00:37:30Z

Download the installation file: change link

← Older revision		Revision as of 00:37, 11 August 2017
Line 15:		Line 15:
	To download from the Rocket website:		To download from the Rocket website:
	<ol>		<ol>
	<li>On the [~~https~~://m204.rocketsoftware.com/ ~~Rocket M204 Customer Care~~] ~~page~~, go to the "Downloads and Uploads" section and select the "Download SOUL files" link to access the "SOUL files for Rocket Software" page.		<li>On the "Rocket M204 Customer Care" page ([http://m204.rocketsoftware.com/ http://m204.rocketsoftware.com]), go to the "Downloads and Uploads" section and select the "Download SOUL files" link to access the "SOUL files for Rocket Software" page.

	<li>Log in, and download the version of RKTools that is compatible with your version of Model 204. The procedure file contained in the "RKTools V7.7" link works for Model 204 versions 7.6 and above. For Model 204 version 7.5, use the download labeled "RKTools V7.5."		<li>Log in, and download the version of RKTools that is compatible with your version of Model 204. The procedure file contained in the "RKTools V7.7" link works for Model 204 versions 7.6 and above. For Model 204 version 7.5, use the download labeled "RKTools V7.5."

JAL: revise overview note and Dictionary install comment

2017-08-03T18:37:36Z

revise overview note and Dictionary install comment

← Older revision		Revision as of 18:37, 3 August 2017
Line 4:		Line 4:
	As of RKTools V7.7, all Rocket-provided, SOUL-based tools are consolidated in the <code>M204PROC</code> procedure file. <code>M204PROC</code> includes all components from RKTools 7.5 in addition to Dictionary/204 and the [[SQL catalog#Generating DDL with SQL utilities\|SQL Server utilities]]. This means that all Model 204 SOUL tools provided by Rocket are in a single file.		As of RKTools V7.7, all Rocket-provided, SOUL-based tools are consolidated in the <code>M204PROC</code> procedure file. <code>M204PROC</code> includes all components from RKTools 7.5 in addition to Dictionary/204 and the [[SQL catalog#Generating DDL with SQL utilities\|SQL Server utilities]]. This means that all Model 204 SOUL tools provided by Rocket are in a single file.

	<p class="note"><b>~~Tip~~:</b> ~~The~~ RKTools 7.7 installation process modifies the application subsystem definitions to point to the <code>M204PROC</code> file. ~~If you might want to~~ switch back to RKTools 7.5, keep a backup of your current <code>SIRIUS</code> file and your current <code>CCASYS</code> file (though you can also change the subsystem definitions manually using [[SUBSYSMGMT]]).</p>		<p class="note"><b>Note:</b> Since the RKTools 7.7 installation process modifies the application subsystem definitions to point to the <code>M204PROC</code> file, sites that are upgrading must perform a full installation and not merely an <code>M204PROC</code> file overlay. To allow for a switch back to RKTools 7.5, keep a backup of your current <code>SIRIUS</code> file and your current <code>CCASYS</code> file (though you can also change the subsystem definitions manually using [[SUBSYSMGMT]]).</p>

	Installing <var class="product">RKTools</var> requires downloading the <code>M204PROC</code> file from the <var class="product">Model 204</var> maintenance website, restoring it to your environment, setting up some subsidiary <var class="product">Model 204</var> files, and verifying that the Online environment has the appropriate parameter settings. Then you run a single procedure that installs or upgrades the RKTools subsystems.		Installing <var class="product">RKTools</var> requires downloading the <code>M204PROC</code> file from the <var class="product">Model 204</var> maintenance website, restoring it to your environment, setting up some subsidiary <var class="product">Model 204</var> files, and verifying that the Online environment has the appropriate parameter settings. Then you run a single procedure that installs or upgrades the RKTools subsystems.
Line 414:		Line 414:

	<li><p><b>Dictionary/204</b></p>		<li><p><b>Dictionary/204</b></p>
	Though the [[Dictionary/204 overview\|Dictionary/204]] components are delivered in <code>M204PROC</code> and accessible from RKWeb as of version 7.7, they are not installed and set up by <code>RKTOOLS_INSTALL</code>. For example, on z/OS, an initial Dictionary/204 installation uses the DDINST JCL from the Model 204 RKOBJLIB; for an upgrade, the DDRINST job.		Though the [[Dictionary/204 overview\|Dictionary/204]] components are delivered in <code>M204PROC</code> and accessible from RKWeb as of version 7.7, they are not installed and set up by <code>RKTOOLS_INSTALL</code>. For example, on z/OS, an initial Dictionary/204 installation uses the <code>DDINST</code> JCL from the Model 204 RKOBJLIB; for an upgrade, the <code>DDRINST</code> job.
	<p>		<p>
	Though ~~they~~ are largely the ~~same~~, review the [[Dictionary/204 installation guide]] ~~to see what steps, if~~ any~~, related to the Dictionary/204 tools (SUBSYSMGMT, [[FILEMGMT overview\|FILEMGMT]], and so on)~~ you might need to ~~run in addition to the RKTools installation~~. </p></li>		Though the Dictionary/204 installation steps are largely included in the the RKTools installation process, you may want to review the [[Dictionary/204 installation guide]] for any additional actions you might need to take. </p></li>

	<li><p><b>SQL Server</b></p>		<li><p><b>SQL Server</b></p>

JAL: mention DDINST and DDRINST

2017-08-02T22:33:18Z

mention DDINST and DDRINST

← Older revision		Revision as of 22:33, 2 August 2017
Line 414:		Line 414:

	<li><p><b>Dictionary/204</b></p>		<li><p><b>Dictionary/204</b></p>
	Though the [[Dictionary/204 overview\|Dictionary/204]] components are delivered in <code>M204PROC</code> and accessible from RKWeb, they ~~have their own~~ installation ~~process~~. ~~Review~~ the [[Dictionary/204 installation guide]] to see what steps, if any, related to the Dictionary/204 tools (SUBSYSMGMT, [[FILEMGMT overview\|FILEMGMT]], and so on) you might need to run in addition to the RKTools installation. </li>		Though the [[Dictionary/204 overview\|Dictionary/204]] components are delivered in <code>M204PROC</code> and accessible from RKWeb as of version 7.7, they are not installed and set up by <code>RKTOOLS_INSTALL</code>. For example, on z/OS, an initial Dictionary/204 installation uses the DDINST JCL from the Model 204 RKOBJLIB; for an upgrade, the DDRINST job.
			<p>
			Though they are largely the same, review the [[Dictionary/204 installation guide]] to see what steps, if any, related to the Dictionary/204 tools (SUBSYSMGMT, [[FILEMGMT overview\|FILEMGMT]], and so on) you might need to run in addition to the RKTools installation. </p></li>

	<li><p><b>SQL Server</b></p>		<li><p><b>SQL Server</b></p>

JAL: add a couple SQL Server-related remarks

2017-08-02T21:47:49Z

add a couple SQL Server-related remarks

← Older revision		Revision as of 21:47, 2 August 2017
Line 127:		Line 127:
	<tr><th>CCACAT</th>		<tr><th>CCACAT</th>
	<td>700 pages</td>		<td>700 pages</td>
	<td>~~Only for~~ RKWeb access to SQL Server. </td></tr>		<td>For RKWeb access to SQL Server. </td></tr>

	<tr><th>DATALINK</th>		<tr><th>DATALINK</th>
Line 139:		Line 139:
	<tr><th>TSFDATA</th>		<tr><th>TSFDATA</th>
	<td>200 pages</td>		<td>200 pages</td>
	<td>~~Only for~~ RKWeb access to SQL Server. </td></tr>		<td>For RKWeb access to SQL Server. </td></tr>

	<tr><th>TSFTEMP</th>		<tr><th>TSFTEMP</th>
	<td>300 pages</td>		<td>300 pages</td>
	<td>~~Only for~~ RKWeb access to SQL Server. </td></tr>		<td>For RKWeb access to SQL Server. </td></tr>
	</table>		</table>
	</li>		</li>
Line 425:		Line 425:
	<p class="code">INCLUDE SQLRINST </p>		<p class="code">INCLUDE SQLRINST </p>
	<p>		<p>
	If you are installing and using SQL Server independently apart from RKTools and RKWeb, see [[Model 204 SQL Server installation]]. </p></li>		If you are installing and using SQL Server independently apart from RKTools and RKWeb, or you have additional questions about SQL Server installation, see [[Model 204 SQL Server installation]]. </p></li>
	</ol>		</ol>
	</li>		</li>
Line 431:		Line 431:
	<li>Use SUBSYSMGMT to add users to the appropriate [[SCLASS]] classes for any private or semi-public RKTools subsystems.		<li>Use SUBSYSMGMT to add users to the appropriate [[SCLASS]] classes for any private or semi-public RKTools subsystems.
	<p>		<p>
	For authority to do this, you need System Administrator log in privileges, and you need SUBSYSMGMT privileges authorized via the [[Dictionary/204 administration#Security administration\|DICTADMIN facility]] of Dictionary/204. The ID of the user that runs the INSTALL_RKTOOLS procedure is automatically added to the ADMIN or to the highest-level administration SCLASS in each of the RKTools subsystems.</p>		For authority to do this, you need System Administrator log in privileges, and you need SUBSYSMGMT privileges authorized via the [[Dictionary/204 administration#Security administration\|DICTADMIN facility]] of Dictionary/204. The ID of the user that runs the INSTALL_RKTOOLS procedure is automatically added to the ADMIN or to the highest-level administration SCLASS in each of the RKTools subsystems (though not necessarily to the Dictionary and SQL Server subsystems).</p>
	<p>		<p>
	Each component application of <var class="product">RKTools</var> has its own APSY subsystem definition and privileges associated with SCLASS specifications.		Each component application of <var class="product">RKTools</var> has its own APSY subsystem definition and privileges associated with SCLASS specifications.
Line 438:		Line 438:
	[[Contacting Rocket Software Technical Support\|Contact Rocket Software]] if you are unsure of the effect of a proposed change. </p>		[[Contacting Rocket Software Technical Support\|Contact Rocket Software]] if you are unsure of the effect of a proposed change. </p>
	<p>		<p>
	RKTools components are installed as ''auto-start''. Use SUBSYSMGMT to disable this feature if you prefer that the subsystems not start automatically at each user request. </p>		RKTools components are typically installed as ''auto-start''. Use SUBSYSMGMT to disable this feature if you prefer that the subsystems not start automatically at each user request. </p>
	<p>		<p>
	The RKWeb interface, described further below in [[#Additional setup for RKWeb\|Additional setup for RKWeb]], is controlled by the RKWEB subsystem, and you need to update the subsystem definition with the names of eligible users. Some of the RKWeb options require system administrator login privileges just as those options do when accessed with the RKTools TN3270 interface. To use these options in RKWeb requires system administrator login privileges and ADMIN SCLASS membership <i>in the RKWEB subsystem</i>, as well as a [[RKWeb#RKWeb security\|suitable product license]]. </p></li>		The RKWeb interface, described further below in [[#Additional setup for RKWeb\|Additional setup for RKWeb]], is controlled by the RKWEB subsystem, and you need to update the subsystem definition with the names of eligible users. Some of the RKWeb options require system administrator login privileges just as those options do when accessed with the RKTools TN3270 interface. To use these options in RKWeb requires system administrator login privileges and ADMIN SCLASS membership <i>in the RKWEB subsystem</i>, as well as a [[RKWeb#RKWeb security\|suitable product license]]. </p></li>

JAL: add Dictionary file list

2017-07-26T20:34:40Z

add Dictionary file list

@@ Line 38: / Line 38: @@
 <li>Model&nbsp;204 System Manager privileges</li>
 <li>Access to the [[SUBSYSMGMT]] facility and the JCL or EXEC that runs the Online <var class="product">Model&nbsp;204</var> region.</li>
-</ul>
+</ul></li>
 </ul>
@@ Line 91: / Line 90: @@
 <td>Only if installing [[Janus Network Security|Janus SSL]] or RKWeb.</td></tr>
 </table>
-The following table shows the [[SQL Server overview|SQL Server]] supporting files:</li>
+<tr><th>DATALINK</th>
 <table class="thJustBold" id="sqlfiles">
 <caption>SQL Server file allocations</caption>
@@ Line 100: / Line 128: @@
 <td>700 pages</td>
 <td>Only for RKWeb access to SQL Server. </td></tr>
 <tr><th>TSFDATA</th>

JAL: minor formatting

2017-07-25T23:47:45Z

minor formatting

← Older revision		Revision as of 23:47, 25 July 2017
Line 95:		Line 95:
	<table class="thJustBold" id="sqlfiles">		<table class="thJustBold" id="sqlfiles">
	<caption>SQL Server file allocations</caption>		<caption>SQL Server file allocations</caption>
			<tr><th>File</th><th>Size</th><th>Allocation is required...</th></tr>

	<tr><th>CCACAT</th>		<tr><th>CCACAT</th>
	<td>700 pages</td>		<td>700 pages</td>

JAL: /* Install RKTools */ minor formatting

2017-07-25T22:22:23Z

Install RKTools: minor formatting

← Older revision		Revision as of 22:22, 25 July 2017
Line 95:		Line 95:
	<table class="thJustBold" id="sqlfiles">		<table class="thJustBold" id="sqlfiles">
	<caption>SQL Server file allocations</caption>		<caption>SQL Server file allocations</caption>
			<tr><th>CCACAT</th>
			<td>700 pages</td>
			<td>Only for RKWeb access to SQL Server. </td></tr>

	<tr><th>TSFDATA</th>		<tr><th>TSFDATA</th>
	<td>200 pages</td>		<td>200 pages</td>
	<td>Only for RKWeb access to SQL Server. </td></tr>		<td>Only for RKWeb access to SQL Server. </td></tr>

	~~<tr><th>CCACAT</th>~~
	~~<td>700 pages</td>~~
	~~<td>Only for RKWeb access to SQL Server. </td></tr>~~

	<tr><th>TSFTEMP</th>		<tr><th>TSFTEMP</th>

JAL: update SQL Server install section

2017-07-25T22:17:04Z

update SQL Server install section

@@ Line 50: / Line 50: @@
 <ol>
-<li>Allocate the RKTools files. The following table shows the RKTools files and their sizes:</li>
+<li>Allocate files.
 <table class="thJustBold">
 <caption>RKTools file allocations</caption>
@@ Line 90: / Line 91: @@
 <td>Only if installing [[Janus Network Security|Janus SSL]] or RKWeb.</td></tr>
 </table>
 <li><var>RESTORE</var> <code>M204PROC</code> from the DUMP file [[#Download the installation file|downloaded from the Rocket website]].
@@ Line 361: / Line 379: @@
 <li><p><b>SQL Server</b></p>
-The [[SQL Server overview|Model 204 SQL Server]] components continue to be delivered in <code>M204PROC</code> but they are also accessible from RKWeb. Using RKWeb for the SQL Server tools (CCACATREPT, CCATSF) requires the availability of additional supporting files and the inclusion of a separate installation procedure, as described in [[Model 204 SQL Server installation]]. </li>
+The [[SQL Server overview|Model 204 SQL Server]] components are delivered in <code>M204PROC</code>, and the SQL Server tools (CCACATREPT, CCATSF) are accessible from RKWeb. Support for this use of RKWeb requires the availability of the [[#sqlfiles|SQL Server supporting files]].
 </ol>
 </li>

JAL: mention RKTOOLS_VERSION procedure

2017-07-21T19:38:59Z

mention RKTOOLS_VERSION procedure

← Older revision		Revision as of 19:38, 21 July 2017
Line 99:		Line 99:
	IN M204PROC RESTORE 192 FROM <var class="term">dumpfile</var>		IN M204PROC RESTORE 192 FROM <var class="term">dumpfile</var>
	</p>		</p>
	</blockquote >		</blockquote>
			<p>
			To verify the <code>M204PROC</code> version, you can open <code>M204PROC</code> with [[SirPro]] and view the RKTOOLS_VERSION procedure. </p>

	<li id="updateJCL">Update the Online JCL or EXEC:		<li id="updateJCL">Update the Online JCL or EXEC: