RKTools: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (mention RKWeb equivalents)
m (typos)
 
(13 intermediate revisions by 3 users not shown)
Line 2: Line 2:
<var class="product">RKTools</var> &mdash; ''Rocket Tools for Model 204'' &mdash; is a family of products implemented as <var class="product">SOUL</var> [[Application Subsystem development|application subsystems]], designed to function together in a <var class="product">Model&nbsp;204</var> Online. Prior to version 7.5 of RKTools (October, 2015), the product was known as UL/SPF.
<var class="product">RKTools</var> &mdash; ''Rocket Tools for Model 204'' &mdash; is a family of products implemented as <var class="product">SOUL</var> [[Application Subsystem development|application subsystems]], designed to function together in a <var class="product">Model&nbsp;204</var> Online. Prior to version 7.5 of RKTools (October, 2015), the product was known as UL/SPF.


Each product in the family can be installed and run independently, or each can be installed and run as a component of the integrated <var class="product">RKTools</var> framework. All <var class="product">RKTools</var> products share a common look and feel, providing a highly productive full screen 3270 interface to a variety of common <var class="product">Model&nbsp;204</var> functions. In addition, many of the component subsystems also support web interfaces.
Each [[#components|product in the family]] can be installed and run independently, or each can be installed and run as a component of the integrated <var class="product">RKTools</var> framework. All <var class="product">RKTools</var> products share a common look and feel, providing a highly productive full screen 3270 interface to a variety of common <var class="product">Model&nbsp;204</var> functions. In addition, many of the component subsystems also support web interfaces.


==RKTools components==
==<b id="components"></b>RKTools components==
<var class="product">RKTools</var> comprises the following products:
<var class="product">RKTools</var> comprises the following products:
<dl>
<dl>
<dt>[[SirDBA]] <dd>A system that analyzes <var class="product">Model&nbsp;204</var> databases to determine their logical structure, populating an internal catalog. <var class="product">SirDBA</var> is distributed as a component of the Sir2000 Database Analysis Tools.
<dt>[[SirDBA]] <dd>A system that analyzes <var class="product">Model&nbsp;204</var> databases to determine their logical structure, populating an internal catalog. <var class="product">SirDBA</var> is distributed as a component of the Sir2000 Database Analysis Tools.


<dt>[[SirFile]] <dd>A comprehensive facility both for monitoring the physical storage utilization of <var class="product">Model&nbsp;204</var> database files and for warning users of the need for file reorganizations. <var class="product">SirFile</var> maintains historical information that allows it to predict when file sizing problems will occur, allowing a DBA to take preventative action before an application outage results.
<dt>[[SirFile]]  
<dd>A comprehensive facility both for monitoring the physical storage utilization of <var class="product">Model&nbsp;204</var> database files and for warning users of the need for file reorganizations. <var class="product">SirFile</var> maintains historical information that allows it to predict when file sizing problems will occur, allowing a DBA to take preventative action before an application outage results.


<dt>[[SirLib]] <dd>A powerful and flexible system that provides change management and
<dt>[[SirLib]]  
configuration control for <var class="product">Model&nbsp;204</var> <var class="product">SOUL</var> applications. <var class="product">SirLib</var> is
<dd>A powerful and flexible system that provides change management and
fully integrated within the <var class="product">SirPro</var> programming environment.
configuration control for <var class="product">Model&nbsp;204</var> <var class="product">SOUL</var> applications. <var class="product">SirLib</var> is fully integrated within the <var class="product">SirPro</var> programming environment.


<dt>[[SirMon]] <dd>A comprehensive facility for monitoring the performance and availability of <var class="product">Model&nbsp;204</var> online systems. <var class="product">SirMon</var> combines the real time monitoring of
<dt>[[SirMon]]  
<dd>A comprehensive facility for monitoring the performance and availability of <var class="product">Model&nbsp;204</var> online systems. <var class="product">SirMon</var> combines the real time monitoring of
<var class="product">Model&nbsp;204</var> performance with intelligent full screen displays that facilitate System Manager and Administrator duties.
<var class="product">Model&nbsp;204</var> performance with intelligent full screen displays that facilitate System Manager and Administrator duties.


<dt>[[SirPro]] <dd>A collection of powerful and easy to use tools for programmers, database administrators, and application managers. <var class="product">SirPro</var> provides programmers with powerful facilities for managing large libraries of <var class="product">User Language</var> procedures, and it provides system managers with intuitive ISPF-like front ends to many <var class="product">Model&nbsp;204</var> system management commands. As of <var class="product">RKTools</var> Version 7.5, SirPro also incorporates the user-extensible [[SoulEdit]] editor, which can also be invoked from the command line via the (optional) <var class="product">Model&nbsp;204</var> apsy <var class="product">SE</var>. Because the procedure list feature of <var class="product">SirPro</var> is so central, it too has an optional standalone apsy called <var class="product">PL</var>.
<dt>[[SirPro]]  
<dd>A collection of powerful and easy to use tools for programmers, database administrators, and application managers. <var class="product">SirPro</var> provides programmers with powerful facilities for managing large libraries of <var class="product">SOUL</var> procedures, and it provides system managers with intuitive ISPF-like front ends to many <var class="product">Model&nbsp;204</var> system management commands.  
<p>
As of <var class="product">RKTools</var> version 7.5, SirPro also incorporates the user-extensible [[SoulEdit]] editor, which can also be invoked from a command line call to the (optional) <var class="product">Model&nbsp;204</var> application subsystem <code>SE</code>. Because the procedure list feature of <var class="product">SirPro</var> is so central, it too has an optional standalone subsystem called <code>PL</code>. </p>


<dt>[[SirScan]] <dd>A high performance utility that allows users in a <var class="product">Model&nbsp;204</var> Online to browse the contents of its journal in real time. <var class="product">SirScan</var> permits ordinary users to view journal entries generated by their own online session, and it allows users in [[ADMIN SCLASS]]es to browse journal entries for any set of users. The data is displayed in a full-screen browser with powerful searching commands and filtering options.
<dt>[[SirScan]]  
<dd>A high performance utility that allows users in a <var class="product">Model&nbsp;204</var> Online to browse the contents of its journal in real time. <var class="product">SirScan</var> permits ordinary users to view journal entries generated by their own online session, and it allows users in [[ADMIN SCLASS]]es to browse journal entries for any set of users. The data is displayed in a full-screen browser with powerful searching commands and filtering options.
</dl>
</dl>


In addition:
In addition:
<ul>
<ul>
<li>The <code>FACT</code> subsystem, a utility for browsing <var class="product"><b>[[SirFact]]</b></var> dumps, is indirectly linked into the <var class="product">RKTools</var> menuing structure as [[SirFact FACT subsystem#Using SirPro|a SirPro option]]. </li>
<li>As of version 7.7, RKTools products are accessed by a web interface (<b>[[RKWeb]]</b>) as well as by the traditional 3270 interface. </li>


<li>As of version 7.7, RKTools provides access to [[Dictionary/204 overview|Dictionary/204]], notably including the [[System requirements for Application Subsystems#Overview of the Subsystem Management facility|Subsystem Management facility]] (SUBSYSMGMT) and the [[FILEMGMT overview|File Management facility]] (FILEMGMT). </li>
<li>The <code>FACT</code> subsystem, a utility for browsing <var class="product"><b>[[SirFact]]</b></var> dumps, is indirectly linked into the <var class="product">RKTools</var> menuing structure as [[SirFact FACT subsystem#Using SirPro|a SirPro option]]. <code>FACT</code> is also available from the RKWeb interface (<code>Build > Fact Dump Analysis</code>).</li>


<li>As of version 7.7, RKTools products are accessed by a web interface ([[RKWeb]]) as well as by the traditional 3270 interface. </li>
<li>As of version 7.7, RKTools provides access to <b>[[Dictionary/204 overview|Dictionary/204]]</b>, notably including the [[System requirements for Application Subsystems#Overview of the Subsystem Management facility|Subsystem Management facility]] (SUBSYSMGMT) and the [[FILEMGMT overview|File Management facility]] (FILEMGMT). These facilities are available from the RKTools TN3270 main menu and from the RKWeb interface (<code>Manage > Subsystem Management</code> and the <code>Manage > Dictionary</code> sub-menu options).</li>


<li>Many sample web and client-server applications developed for the [[Janus TCP/IP Base#The Janus family|Janus product family]] are distributed and installed along with the <var class="product">RKTools</var> products, although they are <i>not</i> linked into the <var class="product">RKTools</var> 3270 menuing structure.  
<li>As of version 7.7, RKTools provides access to the Model&nbsp;204 <b>[[SQL catalog#Using the SQL catalog|SQL Server]]</b> DDL-generation tools CCACATREPT and CCATSF. These facilities are available from the RKTools TN3270 main menu and from the RKWeb interface (<code>Manage > Dictionary > SQL Catalog Reports</code> and <code>Manage > Dictionary > Table Specifications</code>).</li>
 
<li>As of version 7.7, RKWeb provides access (<code>Build > Tune Reports</code>) to the the reporting portion of <b>[[SirTune]]</b>, the SOUL program <code>SIRTUNEREPORT</code>.  </li>
 
<li>Many sample web and client-server applications developed for the [[Janus TCP/IP Base#The Janus family|Janus product family]] are distributed and installed along with the <var class="product">RKTools</var> products, although they are <i>not</i> linked into the <var class="product">RKTools</var> TN3270 menuing structure.  
<p>
<p>
These applications include: </p>
These applications include: </p>
<ul>  
<ul>  
<li><code>JanCat</code>, an application that builds normalized views of <var class="product">Model&nbsp;204</var> data for use
<li><code>JanCat</code>, an application that builds normalized views of <var class="product">Model&nbsp;204</var> data for use
by <var class="product">[[Media:JsdsrNew.pdf|Janus Specialty Data Store]]</var> applications. </li>
by <b><var class="product">[[Media:JsdsrNew.pdf|Janus Specialty Data Store]]</var></b> applications. </li>


<li><code>JanSSL</code>, a [[Janus Network Security]] system for creating and managing SSL certificate requests. This application is available from the RKWeb interface (Manage > SSL Certificates) as of RKTools 7.7. </li>
<li><code>JanSSL</code>, a <b>[[Janus Network Security]]</b> system for creating and managing SSL certificate requests. This application is available from the RKWeb interface (<code>Manage > SSL Certificates</code>). </li>
</ul>
</ul></li>
</li>
</ul>
</ul>


Line 59: Line 68:


<li>Verifying that the environment has the appropriate parameter settings. </li>
<li>Verifying that the environment has the appropriate parameter settings. </li>
<li>Running a program that performs all installation functions for new users and all upgrade functions for reinstalling users. </li>
</ol>
</ol>


Line 74: Line 85:
STOP
STOP
</p>
</p>
 
<p id="mainmenu">
In addition to the individual <var class="product">SOUL</var> subsystems that implement the <var class="product">RKTools</var> products,
In addition to the individual <var class="product">SOUL</var> subsystems that implement the <var class="product">RKTools</var> products,
Rocket Software distributes an umbrella <var class="product">RKTools</var> subsystem, accessed by entering <code>RKTOOLS</code> from the Model&nbsp;204 command line. The <b>RKTOOLS</b> subsystem provides a menu that contains entries for all <var class="product">RKTOOLS</var> components installed at a site:
Rocket Software distributes an umbrella <var class="product">RKTools</var> subsystem, accessed by entering <code>RKTOOLS</code> from the Model&nbsp;204 command line. The <b>RKTOOLS</b> subsystem provides a menu that contains entries for all <var class="product">RKTOOLS</var> components installed at a site: </p>
   
   
<p class="caption" style="width:450px">RKTools main menu</p>
<p class="caption" style="width:450px">RKTools main menu (V7.7)</p>
<p class="figure">[[File:RKToolsMainMenu.png|450px]]</p>
<p class="figure">[[File:RKToolsMainMenu77.png|450px]]</p>


===Fast-pathing===
===Fast-pathing===
Line 94: Line 105:


The command format is:
The command format is:
<p class="syntax">PL [<span class="term">procedurePattern</span>] [FILE <span class="term">filename</span> | GROUP <span class="term">groupname</span>]
<p class="syntax">PL [<span class="term">procedurePattern</span>] [FILE <span class="term">filename</span> | GROUP <span class="term">groupname</span>][HAS <span class="term">searchValue</span> | CONTAINS <span class="term">searchValue</span>]
</p>
</p>
where <var class="term">procedurePattern</var> supports the wildcard usage described in [[SirPro procedure-list selection#procname|Procedure name]].  
where <var class="term">procedurePattern</var> supports the wildcard usage described in [[SirPro procedure-list selection#procname|Procedure name]].  
Line 120: Line 131:
Each RKTools release has the version number of the Model&nbsp;204 release whose features it can exploit.   
Each RKTools release has the version number of the Model&nbsp;204 release whose features it can exploit.   


For information about member product changes and new features contained in a release, see the RKTools release notes for your version of Model&nbsp;204 (for example, [[Release notes for RKTools V7.5]]).
For information about member product changes and new features contained in a release, see the [[M204wiki main page#rktools_notes|RKTools release notes]] appropriate for your version of Model&nbsp;204:
<ul>
<li>[[Release notes for RKTools V7.5]] for Model&nbsp;204 V7.5 </li>
 
<li>[[Release notes for RKTools V7.7]] for Model&nbsp;204 V7.6 and V7.7 </li>
</ul>


[[Category: RKTools]]
[[Category: RKTools]]

Latest revision as of 17:44, 2 January 2018

RKToolsRocket Tools for Model 204 — is a family of products implemented as SOUL application subsystems, designed to function together in a Model 204 Online. Prior to version 7.5 of RKTools (October, 2015), the product was known as UL/SPF.

Each product in the family can be installed and run independently, or each can be installed and run as a component of the integrated RKTools framework. All RKTools products share a common look and feel, providing a highly productive full screen 3270 interface to a variety of common Model 204 functions. In addition, many of the component subsystems also support web interfaces.

RKTools components

RKTools comprises the following products:

SirDBA
A system that analyzes Model 204 databases to determine their logical structure, populating an internal catalog. SirDBA is distributed as a component of the Sir2000 Database Analysis Tools.
SirFile
A comprehensive facility both for monitoring the physical storage utilization of Model 204 database files and for warning users of the need for file reorganizations. SirFile maintains historical information that allows it to predict when file sizing problems will occur, allowing a DBA to take preventative action before an application outage results.
SirLib
A powerful and flexible system that provides change management and configuration control for Model 204 SOUL applications. SirLib is fully integrated within the SirPro programming environment.
SirMon
A comprehensive facility for monitoring the performance and availability of Model 204 online systems. SirMon combines the real time monitoring of Model 204 performance with intelligent full screen displays that facilitate System Manager and Administrator duties.
SirPro
A collection of powerful and easy to use tools for programmers, database administrators, and application managers. SirPro provides programmers with powerful facilities for managing large libraries of SOUL procedures, and it provides system managers with intuitive ISPF-like front ends to many Model 204 system management commands.

As of RKTools version 7.5, SirPro also incorporates the user-extensible SoulEdit editor, which can also be invoked from a command line call to the (optional) Model 204 application subsystem SE. Because the procedure list feature of SirPro is so central, it too has an optional standalone subsystem called PL.

SirScan
A high performance utility that allows users in a Model 204 Online to browse the contents of its journal in real time. SirScan permits ordinary users to view journal entries generated by their own online session, and it allows users in ADMIN SCLASSes to browse journal entries for any set of users. The data is displayed in a full-screen browser with powerful searching commands and filtering options.

In addition:

  • As of version 7.7, RKTools products are accessed by a web interface (RKWeb) as well as by the traditional 3270 interface.
  • The FACT subsystem, a utility for browsing SirFact dumps, is indirectly linked into the RKTools menuing structure as a SirPro option. FACT is also available from the RKWeb interface (Build > Fact Dump Analysis).
  • As of version 7.7, RKTools provides access to Dictionary/204, notably including the Subsystem Management facility (SUBSYSMGMT) and the File Management facility (FILEMGMT). These facilities are available from the RKTools TN3270 main menu and from the RKWeb interface (Manage > Subsystem Management and the Manage > Dictionary sub-menu options).
  • As of version 7.7, RKTools provides access to the Model 204 SQL Server DDL-generation tools CCACATREPT and CCATSF. These facilities are available from the RKTools TN3270 main menu and from the RKWeb interface (Manage > Dictionary > SQL Catalog Reports and Manage > Dictionary > Table Specifications).
  • As of version 7.7, RKWeb provides access (Build > Tune Reports) to the the reporting portion of SirTune, the SOUL program SIRTUNEREPORT.
  • Many sample web and client-server applications developed for the Janus product family are distributed and installed along with the RKTools products, although they are not linked into the RKTools TN3270 menuing structure.

    These applications include:

    • JanCat, an application that builds normalized views of Model 204 data for use by Janus Specialty Data Store applications.
    • JanSSL, a Janus Network Security system for creating and managing SSL certificate requests. This application is available from the RKWeb interface (Manage > SSL Certificates).

RKTools packaging and installation requirements

All of the RKTools products are Model 204 application subsystems written in SOUL. RKTools is distributed as a set of Model 204 files in a backup format produced by the Model 204 DUMP command.

All SOUL-based products are distributed in a single Model 204 procedure file. The file is M204PROC as of RKTools 7.7; for earlier versions the file is SIRIUS.

RKTools makes extensive use of specialized SOUL OO classes and $functions. These classes and $functions enable the creation of powerful SOUL application systems that can support complex environments with minimal server size requirements.

Installing RKTools requires:

  1. Downloading the M204PROC or SIRIUS file, and restoring it to the Model 204 environment where the tools will run.
  2. Setting up some subsidiary Model 204 files.
  3. Verifying that the environment has the appropriate parameter settings.
  4. Running a program that performs all installation functions for new users and all upgrade functions for reinstalling users.

For details, see RKTools installation.

Upgrades to RKTools can almost always be handled by restoring a fresh copy of the M204PROC or SIRIUS file.

Integrating RKTools with other subsystems

RKTools and any of its constituent products can be easily integrated with other SOUL subsystems. Whenever an RKTools component product is exiting, it first checks to see if the global variable SIRIUS.COMM exists and has a non-null value. If so, the RKTools product performs a subsystem transfer using the value in SIRIUS.COMM as the name of the target subsystem.

For example, the following code fragment lets you transfer into subsystem SIRMON. When SIRMON exits, control is transferred to the application subsystem MENUSYS, provided that NEXT is the current subsystem's communication global variable:

%rc = $Setg('SIRIUS.COMM','MENUSYS') %rc = $Setg('NEXT','XFER') %rc = $Setg('XFER','SIRMON') STOP

RKTools main menu (V7.7)

Fast-pathing

The RKTOOLS subsystems support fast-path navigation. For example, a SirMon user can transfer into the SirPro main menu option 1 destination (the SirPro procedure-list selection screen) by using the component subsystem name or short-code along with a menu number:

sirpro 1

Or:

pro 1

And a user in SirScan can enter sirmon 3.1 on the command line and be transferred directly to the option 1 (Resource Usage) destination of the SirMon main menu option 3 (User Monitor) screen.

PL command

PL is both a special subsystem and a command that lets you directly enter the Procedure List screen in SirPro. The command is like a pro 1 fast-path command combined with procedure-search specifications.

The command format is:

PL [procedurePattern] [FILE filename | GROUP groupname][HAS searchValue | CONTAINS searchValue]

where procedurePattern supports the wildcard usage described in Procedure name.

If you do not specify a FILE or GROUP clause, one of the following is used:

  • The current open context. This context is obtained using VIEW APDFCNTX or $view('APDFCNTX') (see the APDFCNTX parameter).
  • The last-visited SirPro procedure list.

Note: To search for procedure names that contain the words "FILE" or "GROUP", use a PL command like the following:

PL File FILE filename

where:

  • File indicates procedures whose name contains the word "File".
  • FILE is required because the context is not automatically added if searching for the words "FILE" or "GROUP".

Release notes

Each RKTools release has the version number of the Model 204 release whose features it can exploit.

For information about member product changes and new features contained in a release, see the RKTools release notes appropriate for your version of Model 204: