RKWeb: Difference between revisions
m (add link) |
|||
(74 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
<div class="toclimit-3"> | |||
==Overview== | ==Overview== | ||
The RKTools 7.7 release is comprised of the RKTools | The [[RKTools]] 7.7 release is comprised of the RKTools subsystems, Dictionary/204, and RKWeb. | ||
and RKWeb. | |||
<ul> | <ul> | ||
<li>The RKTools subsystem provides access to all RKTools (formerly UL/SPF tools) | <li>The RKTools subsystem provides access to all TN3270-based RKTools (formerly UL/SPF tools).</li> | ||
<li>Dictionary/204 is available from the TN3270 interface or from RKWeb.</li> | <li>Dictionary/204 is available from the TN3270 interface, the RKTools menu, or from RKWeb.</li> | ||
<li>RKWeb provides an easy-to-use web interface to | <li>RKWeb provides an easy-to-use web interface to almost all of the RKTools and Dictionary components.</li> | ||
</ul> | </ul> | ||
<p> | <p>RKWeb harnesses most of the Rocket M204 tools in a common framework, providing a highly productive web interface to common Model 204 functions. RKWeb is mobile-friendly, enabling you to perform most Model 204 operations from your smartphone or other mobile device.</p> All existing security and product ownership is honored in the RKWEB subsystem — for instance, an interface is provided for managing group definitions and passwords, but the option is only available to RKWEB subsystem ADMIN [[SCLASS]] users that have System Administrator login privileges. | ||
<p>RKWeb requires [[Janus Web Server]] and Model 204 version 7.6 or later. See [[ | <p>RKWeb requires [[Janus Web Server]] and Model 204 version 7.6 or later. See [[RKTools installation#RKWeb (Model 204 Tools on the Web)|RKWeb installation]] for more information. For sites that do not own Janus Web, a Limited Janus Web capability is included that allows a restricted number of web threads to use RKWeb.</p> | ||
<p>RKWeb provides a task-based UI for SOUL application development. Tasks are divided into three functional areas: <b>[[#Build|Build]]</b>, <b>[[#Manage|Manage]]</b>, and <b>[[#Monitor|Monitor]]</b>. The [[#com_proc|Command processor]] is available in each functional area.</p> | <p>RKWeb provides a task-based UI for SOUL application development. Tasks are divided into three functional areas: <b>[[#Build|Build]]</b>, <b>[[#Manage|Manage]]</b>, and <b>[[#Monitor|Monitor]]</b>. The [[#com_proc|Command processor]] is available in each functional area.</p> | ||
Line 18: | Line 18: | ||
<ul> | <ul> | ||
<li>Edit procedures ([[#Edit|Edit]])</li> | <li>Edit procedures ([[#Edit|Edit]])</li> | ||
<li>Configure change management for procedures | <li>Configure change management for procedures ([[#Configure|Configure]])</li> | ||
<li>Analyze dump files ([[#Fact Dump Analysis|Fact Dump Analysis]])</li> | <li>Analyze dump files ([[#Fact Dump Analysis|Fact Dump Analysis]])</li> | ||
<li>Tune procedure performance ([[#Tune Reports|Tune Reports]])</li> | <li>Tune procedure performance ([[#Tune Reports|Tune Reports]])</li> | ||
<li>Run Model 204 commands ([[#Command processor|Command processor]])</li> | |||
</ul> | </ul> | ||
===Edit=== | ===Edit=== | ||
The <code>Build > Edit</code> menu option enables you to edit procedures within Model 204 files. | The <code>Build > Edit</code> menu option enables you to edit procedures within Model 204 files. | ||
<p class="note"><b>Note:</b> You must enable pop-ups in your browser to edit a procedure (it is opened in a separate window).</p> | <p class="note"><b>Note:</b> You must enable pop-ups in your browser to edit a procedure (it is opened in a separate window).</p> | ||
====RKWeb editor==== | |||
<p>The editor provided with RKWeb is based on the open-source [https://ace.c9.io/ Ace] editor.</p> | |||
The RKWeb editor: | |||
<ul> | |||
<li>Works with all SOUL code and other code stored in M204 procedure files.</li> | |||
<li>Uses color coding in SOUL or JavaScript programs to highlight items such as function names, parameters, and labels.</li> | |||
<li>Respects Model 204 security, allowing users to see, browse, and/or edit only the procedures that they would have permission to see, browse, or edit in 3270.</li> | |||
<li>Is available to all Model 204 owners.</li> | |||
</ul> | |||
The RKWeb editor enables you to perform basic editing tasks such as search and replace, skip words, insert and delete lines, Undo, and so on. For a list of default keyboard shortcuts in the Ace editor, see [https://github.com/ajaxorg/ace/wiki/Default-Keyboard-Shortcuts Default keyboard shortcuts]. | |||
====To edit a procedure==== | ====To edit a procedure==== | ||
<p class="note"><b>Note:</b> Pop-ups must be enabled to use this feature.</p> | |||
<ol> | <ol> | ||
<li>Click the <code>Build</code> tab.</li> | <li>Click the <code>Build</code> tab.</li> | ||
<li>In the <code>Build</code> menu, click <code>Edit</code>.</li> | <li>In the <code>Build</code> menu, click <code>Edit</code>.</li> | ||
<li>The Edit tool fetches a list of procedures in the current file.</li> | <li>If needed, click the <b>Open Procedure List</b> button. | ||
<p>To view a different file, enter a name in the <b>File</b> field. If the file is password-protected, enter a password in the <b>Password</b> field.</p></li> | <li>The Edit tool fetches a list of procedures in the current file. The list appears in a new window (or tab). </li> | ||
<p>To view a different file, enter a name in the <b>File</b> field. If the file is password-protected, enter a password in the <b>Password</b> field. Then click the <b>List</b> button.</p></li> | |||
<li>To filter the list of procedures: | <li>To filter the list of procedures: | ||
<ul> | <ul> | ||
<li>Enter a string in the <b>Filter</b> field, such as shared or EDITOR. ( | <li>Enter a string in the <b>Filter</b> field, such as <code>shared</code> or <code>EDITOR</code>. (Case-sensitivity of the string is set in the [[#To customize the procedure list settings|Procedure List Settings dialog box]].)</li> | ||
<li>Enter a number of hours in the <b>Age(hours)</b> field to filter the list by the age of the procedures.</li> | <li>Enter a number of hours in the <b>Age(hours)</b> field to filter the list by the age of the procedures.</li> | ||
<li>Press Enter or click <b>List</b> to refresh the list of procedures.</li> | <li>Press Enter or click <b>List</b> to refresh the list of procedures.</li> | ||
To see the original unfiltered list, delete the criteria from the <b>Filter</b> and <b>Age(hours)</b> fields and press Enter or click <b>List</b>.</li> | To see the original unfiltered list, delete the criteria from the <b>Filter</b> and <b>Age(hours)</b> fields and press Enter or click <b>List</b>.</li> | ||
<li>Click a procedure name to open that procedure in a new tab and edit it in the | </ul></li> | ||
<li>Click a procedure name to open that procedure in a new window (or tab) and edit it in the [[#RKWeb editor|RKWeb editor]].</li> | |||
<li>After editing, click <b>Save</b> and close the window to return to the procedure list window.</li> | |||
<li>Close the procedure list window to return to the RKWeb main screen.</li> | |||
</ol> | </ol> | ||
Line 53: | Line 78: | ||
<ul> | <ul> | ||
<li>Background color of the Procedure List toolbar.</li> | <li>Background color of the Procedure List toolbar.</li> | ||
<li>Color of an open procedure.</li></ul> | <li>Color of an open procedure.</li> | ||
</ul> | |||
<p>Enter a color name, such as <code>red</code>, or its hexadecimal code, such as <code>#FF0000</code>, or its rgb value, <br />such as <code>rgb(255,0,0)</code>.</p> | <p>Enter a color name, such as <code>red</code>, or its hexadecimal code, such as <code>#FF0000</code>, or its rgb value, <br />such as <code>rgb(255,0,0)</code>.</p> | ||
</li> | </li> | ||
</ul> | </ul> | ||
</li> | </li> | ||
<li>Click <b>Save</b> to save your changes.</li> | |||
</ol> | </ol> | ||
===Configure=== | ===Configure=== | ||
The <code>Build > Configure</code> | The <code>Build > Configure</code> option is available to SirLib owners who are RKWEB subsystem ADMIN SCLASS users. It enables you to configure and administer change management for SOUL procedures residing in Model 204 procedure files. | ||
====To use SirLib change control==== | ====To use SirLib change control==== | ||
<ol> | <ol> | ||
<li>Click the <code>Configure</code> | <li>Click the <code>Build</code> tab.</li> | ||
<p>This opens the [[ | <li>In the <code>Build</code> menu, click <code>Configure</code>. | ||
<p>SirLib functionality is provided as a [[Janus_Web_Legacy_Support|Janus legacy application]], operating outside the RKWeb menu framework. When you click the <code>Configure</code> menu option, a new | <p>This opens the [[SirLib change control|SirLib Configuration and Change Control System]].</p> | ||
<p>SirLib functionality is provided as a [[Janus_Web_Legacy_Support|Janus legacy application]], operating outside the RKWeb menu framework. When you click the <code>Configure</code> menu option, a new window (or tab) opens, leaving your original RKWeb session in place in the original window (or tab).</p> | |||
<p class="note"><b>Note:</b> These Janus Legacy applications are not fully integrated with RKWeb, so you must use the security configured for those applications. For instance, FILEMGMT is implemented as Janus Legacy, and it might prompt you for a separate password.</p> | |||
</li> | |||
<li>Enter an action number to choose a menu option from the <code>Configuration and Change Control System</code> menu. | <li>Enter an action number to choose a menu option from the <code>Configuration and Change Control System</code> menu. | ||
<p>The <b>Target file</b> field, <b>Fixes File</b> field, and menu options are the same as on the [[ | <p>The <b>Target file</b> field, <b>Fixes File</b> field, and menu options are the same as on the [[SirLib change control#SirLib main menu|SirLib main menu]]. </p> | ||
<table> | <table> | ||
<tr class="head"> | <tr class="head"> | ||
<th>Menu number</th><th>Item</th><th>Enables you to...</th></tr> | <th>Menu number</th><th>Item</th><th>Enables you to...</th></tr> | ||
<tr><td>1</td><td>Project Definition List</td><td>[[SirLib_change_control#Project_definition|Add, delete, or change the project identifiers]] in the FixFile assigned to a managed file.</td></tr> | <tr><td>1</td><td>Project Definition List</td><td>[[SirLib_change_control#Project_definition|Add, delete, or change the project identifiers]] in the FixFile assigned to a managed file.</td></tr> | ||
<tr><td>2</td><td nowrap>Apply changes (Reconfigure a file)</td><td>[[ | |||
<tr><td>3</td><td nowrap>Administration (specify a file or use default)</td> <td>[[SirLib_change_control#Administering_system_and_file_profiles|Administer system and file profiles]].</td></tr> | <tr><td>2</td> | ||
<tr><td>4</td><td>Security (specify a file or use default)</td> <td>Set [[ | <td nowrap>Apply changes (Reconfigure a file)</td><td>[[SirLib change control#Configuring files (applying updates)|Apply file updates]].</td></tr> | ||
<tr><td>5</td><td>Cutover</td> <td>Clean up and stabilize projects. [[ | |||
<tr><td>6</td><td>Reports</td> <td>Run a [[ | <tr><td>3</td> | ||
<tr><td>7</td><td nowrap>View/Clear Procedure Locks</td><td>( | <td nowrap>Administration (specify a file or use default)</td> <td>[[SirLib_change_control#Administering_system_and_file_profiles|Administer system and file profiles]].</td></tr> | ||
</table | |||
<li>When you have performed all desired tasks, close the | <tr><td>4</td> | ||
<td>Security (specify a file or use default)</td> | |||
<td>Set [[SirLib security|SirLib security]] settings.</td></tr> | |||
<tr><td>5</td> | |||
<td>Cutover</td> | |||
<td>Clean up and stabilize projects. [[SirLib change control#cutover|Release cutover]] returns a managed file to a pre-managed state, but with all existing updates applied.</td></tr> | |||
<tr><td>6</td> | |||
<td>Reports</td> | |||
<td>Run a [[SirLib reports|SirLib report]] on Change History, Configuration, or Problem tracking.</td></tr> | |||
<tr><td>7</td> | |||
<td nowrap>View/Clear Procedure Locks</td> | |||
<td>(ADMIN users only) See procedures that are [[SirLib change control#View.2FClear procedure locks|currently checked out]].</td></tr> | |||
</table></li> | |||
<li>When you have performed all desired tasks, close the window to return to your RKWeb session.</li> | |||
</ol> | </ol> | ||
===Fact Dump Analysis=== | ===Fact Dump Analysis=== | ||
The <code>Fact Dump Analysis</code> menu item provides a UI to the [[ | The <code>Fact Dump Analysis</code> menu item provides a UI to the [[SirFact FACT subsystem|SirFact FACT subsystem]], enabling you to analyze a diagnostic dump by selecting a dump file and its procedure that contains the dump. You can then choose which data to display. | ||
<p class="note"><b>Note:</b> Your site must own <var class="product">SirFact</var> in order for you to use Fact Dump Analysis.</p> | <p class="note"><b>Note:</b> Your site must own <var class="product">SirFact</var> and you must be an RKWEB subsystem SCLASS user in order for you to use Fact Dump Analysis.</p> | ||
====To select and analyze a diagnostic dump==== | ====To select and analyze a diagnostic dump==== | ||
<ol> | <ol> | ||
<li>Click the <code>Build</code> tab.</li> | <li>Click the <code>Build</code> tab.</li> | ||
<li>In the <code>Build</code> menu, click <code>Fact Dump Analysis</code> | <li>In the <code>Build</code> menu, click <code>Fact Dump Analysis</code>.</li> | ||
<li>Click < | <li>Click <code>Select</code> from the submenu. | ||
<p>In the <b>File</b> field, enter a dump file name. The SirFact dump selection screen displays a list of procedures in the selected dump file.</p> | <p>In the <b>File</b> field, enter a dump file name. The SirFact dump selection screen displays a list of procedures in the selected dump file.</p> | ||
<p>To choose a different file, enter its name in the <b>File</b> field and click <b>Switch file</b>.</p></li> | <p>To choose a different file, enter its name in the <b>File</b> field and click <b>Switch file</b>.</p></li> | ||
<li>Click a procedure name to analyze its dump information with the [[ | <li>Click a procedure name to analyze its dump information with the [[SirFact FACT subsystem]]. | ||
<p>The screen displays basic information extracted from the dump: default context information for the error condition such as a date/time stamp, source procedure and file, user ID of the user for whom the error occurred, and so on.</p> | <p>The screen displays basic information extracted from the dump: default context information for the error condition such as a date/time stamp, source procedure and file, user ID of the user for whom the error occurred, and so on.</p> | ||
<p>Enter SirFact commands to extract additional information, which is appended to the information on the screen:</p> | <p>Enter SirFact commands to extract additional information, which is appended to the information on the screen:</p> | ||
<ul> | <ul> | ||
<li>To view the context where an error occurred, enter the <code> | <li>To view the context where an error occurred, enter the <code> | ||
[[ | [[SirFact FACT subsystem#C.5Bontext.5D command: Setting program context for data extraction|Context]]</code> SirFact command, with an information context, in the <b>Command</b> field and click <b>Send query</b>. | ||
<p>The valid information contexts are:</p> | <p>The valid information contexts are:</p> | ||
<table> | <table> | ||
Line 111: | Line 161: | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<td><var class="term">subroutine-name</var></td> | <td nowrap><var class="term">subroutine-name</var></td> | ||
<td>Switches to the context of the named complex subroutine. Simple subroutines are not valid contexts, as they share the same context as the main body of the program.</td> | <td>Switches to the context of the named complex subroutine. Simple subroutines are not valid contexts, as they share the same context as the main body of the program.</td> | ||
</tr> | </tr> | ||
Line 117: | Line 167: | ||
</li> | </li> | ||
<li>To display specific data from the dump, such as attributes, For Each Record loop fields, lists, and so on, enter the <var>Display</var> SirFact command and its | <li>To display specific data from the dump, such as attributes, For Each Record loop fields, lists, and so on, enter the <var>Display</var> SirFact command and its | ||
[[ | [[SirFact FACT subsystem#D.5Bisplay.5D command: Displaying data from the SirFact dump|parameters]] in the <b>Command</b> field and click <b>Send query</b>.</li> | ||
</ul></li> | </ul></li> | ||
</ol> | </ol> | ||
===Tune Reports=== | ===Tune Reports=== | ||
The <code>Tune Reports</code> menu item enables you to produce a listing of one or more [[SirTune reports]], which you can use to tune problem areas in an Online. | |||
<p class="note"><b>Note:</b> The <code>Tune Reports</code> menu item is a quick way to generate SirTune reports that you have already configured. It is assumed that you are familiar with configuring and running SirTune reports. For more information, see [[SirTune report generation#Report configuration|SirTune report configuration]]. <code>Tune Reports</code> is available to all owners of [[SirTune]] that are RKWEB subsystem ADMIN SCLASS users.</p> | |||
====To produce a report==== | |||
<ol> | |||
<li>Click the <code>Build</code> tab.</li> | |||
<li>In the <code>Build</code> menu, click <code>Tune Reports</code>.</li> | |||
<li>Select <b>Procedure</b> or <b>Dataset</b> to choose either a procedure or data set report. | |||
<ul> | |||
<li>For Procedure: | |||
<p>In the SirTune input section, enter the File, Procedure, Data Source, and Volume (if desired).</p></li> | |||
<li>For Dataset: | |||
<p>In the SirTune input section, enter the Configuration file name and Volume (if desired) and Data Source and Volume (if desired).</p></li> | |||
</ul> | |||
</li> | |||
<li>In the SirTune Output section, select <b>Page</b> to see the report on your screen, or select <b>Dataset</b> and enter the Dataset name and Volume (if desired).</li> | |||
<li>Click <b>Generate</b> to generate the report.</li> | |||
</ol> | |||
==Manage== | ==Manage== | ||
Line 129: | Line 199: | ||
<ul> | <ul> | ||
<li>Define applications that run under the Application Subsystem facility ([[#Subsystem Management|Subsystem Management]])</li> | <li>Define applications that run under the Application Subsystem facility ([[#Subsystem Management|Subsystem Management]])</li> | ||
<li>Manage your procedures, files, and subsystems ([[#Dictionary|Dictionary]])</li> | <li>Manage your procedures, files, and subsystems ([[#Dictionary|Dictionary]])</li> | ||
<li>Maintain Model 204 passwords ([[#Passwords|Passwords]])</li> | |||
<li>Manage Model 204 group definitions ([[#Group Definitions|Group Definitions]])</li> | <li>Maintain Model 204 passwords ([[#Passwords|Passwords]])</li> | ||
<li>Manage SSL certificates | |||
<li>Manage Model 204 group definitions ([[#Group Definitions|Group Definitions]])</li> | |||
<li>Manage SSL certificates ([[#SSL Certificates|SSL Certificates]])</li> | |||
<li>Run Model 204 commands ([[#Command processor|Command processor]])</li> | |||
</ul> | </ul> | ||
===Subsystem Management=== | ===Subsystem Management=== | ||
The [[ | The [[Subsystem Management facility#Overview of the Subsystem Management facility|Subsystem Management]] menus enable you to define user-written applications that run under the Application Subsystem facility (APSY). | ||
<p>A subsystem is an application consisting of a collection of procedures, files, and assigned characteristics that are defined as a subsystem to Model 204 through the Subsystem Management interface.</p> | <p> | ||
A subsystem is an application consisting of a collection of procedures, files, and assigned characteristics that are defined as a subsystem to Model 204 through the Subsystem Management interface. RKWEB's Subsysmgmt is available to RKWEB subsystem ADMIN [[SCLASS]] users who have System Administrator login privileges.</p> | |||
====Procedure==== | ====Procedure==== | ||
Enter specifications for subsystem procedures on the Procedure screen. | Enter specifications for subsystem procedures on the Procedure screen. | ||
=====To create specifications for a subsystem procedure===== | =====To create specifications for a subsystem procedure===== | ||
<ol> | <ol> | ||
<li> | <li>Click the <code>Manage</code> tab. </li> | ||
<li>Enter a name in the <b>Subsystem</b> field | <li>In the <code>Subsystem Management</code> menu, click the arrow to open the submenu, and select <code>Procedure</code>.</li> | ||
<li>Click the icon beside the <b>Subsystem</b> field and select <b>Create</b>.</li> | <li>Enter a name in the <b>Subsystem</b> field and press <b>Enter</b>. | ||
<li>If the subsystem does not exist, a message appears. Click the icon beside the <b>Subsystem</b> field and select <b>Create</b>.</li> | |||
<li>The item appears in the display, with its fields populated with default values. The item is now created and will be available in the Subsystem list.</li> | <li>The item appears in the display, with its fields populated with default values. The item is now created and will be available in the Subsystem list.</li> | ||
<li>Edit the [[SUBSYSMGMT#Procedure_prefixes|procedure prefixes]] as desired. </li> | <li>Edit the [[SUBSYSMGMT#Procedure_prefixes|procedure prefixes]] as desired. </li> | ||
<li>Edit the [[SUBSYSMGMT# | <li>Edit the [[SUBSYSMGMT#Procedure names|procedure names]] as desired.</li> | ||
<li>Edit the [[SUBSYSMGMT# | <li>Edit the [[SUBSYSMGMT#Global variables|global variables]] as desired.</li> | ||
<li>If you have made any edits, click the <b>Save <var class="term">number</var> Updates</b> button.</li> | <li>If you have made any edits, click the <b>Save <var class="term">number</var> Updates</b> button.</li> | ||
</ol> | </ol> | ||
=====To rename specifications for a subsystem procedure===== | =====To rename specifications for a subsystem procedure===== | ||
<ol> | <ol> | ||
<li> | <li>Click the <code>Manage</code> tab. </li> | ||
<li>In the <code>Subsystem Management</code> menu, click the arrow to open the submenu, and select <code>Procedure</code>.</li> | |||
<li>Select an item in the <b>Subsystem</b> drop-down list.</li> | <li>Select an item in the <b>Subsystem</b> drop-down list.</li> | ||
<li>Click the icon beside the <b>Subsystem</b> field and select <b> | <li>Click the icon beside the <b>Subsystem</b> field and select <b>Rename</b>.</li> | ||
<li>In the <b>Rename Subsystem</b> pop-up, enter the new subsystem name in the <b>To</b> field and click <b>Confirm Rename</b>.</li> | <li>In the <b>Rename Subsystem</b> pop-up, enter the new subsystem name in the <b>To</b> field and click <b>Confirm Rename</b>.</li> | ||
<li>The renamed item appears as the selected subsystem.</li> | <li>The renamed item appears as the selected subsystem.</li> | ||
</ol> | </ol> | ||
=====To copy specifications for a subsystem procedure===== | =====To copy specifications for a subsystem procedure===== | ||
<ol> | <ol> | ||
<li> | <li>Click the <code>Manage</code> tab. </li> | ||
<li>In the <code>Subsystem Management</code> menu, click the arrow to open the submenu, and select <code>Procedure</code>.</li> | |||
<li>Select an item in the <b>Subsystem</b> drop-down list.</li> | <li>Select an item in the <b>Subsystem</b> drop-down list.</li> | ||
<li>Click the icon beside the <b>Subsystem</b> field and select <b>Copy</b>.</li> | <li>Click the icon beside the <b>Subsystem</b> field and select <b>Copy</b>.</li> | ||
Line 168: | Line 253: | ||
=====To delete specifications for a subsystem procedure===== | =====To delete specifications for a subsystem procedure===== | ||
<ol> | <ol> | ||
<li> | <li>Click the <code>Manage</code> tab. </li> | ||
<li>In the <code>Subsystem Management</code> menu, click the arrow to open the submenu, and select <code>Procedure</code>.</li> | |||
<li>Select an item in the <b>Subsystem</b> drop-down list.</li> | <li>Select an item in the <b>Subsystem</b> drop-down list.</li> | ||
<li>Click the icon beside the <b>Subsystem</b> field and select <b> | <li>Click the icon beside the <b>Subsystem</b> field and select <b>Delete</b>.</li> | ||
<li>In the <b>Delete Subsystem</b> pop-up, click <b>Confirm Delete</b>.</li> | <li>In the <b>Delete Subsystem</b> pop-up, click <b>Confirm Delete</b>.</li> | ||
<li>The item disappears from the display and the subsystem list.</li> | <li>The item disappears from the display and the subsystem list.</li> | ||
Line 179: | Line 265: | ||
=====To specify subsystem operating options===== | =====To specify subsystem operating options===== | ||
<ol> | <ol> | ||
<li> | <li>Click the <code>Manage</code> tab. </li> | ||
<li>In the <code>Subsystem Management</code> menu, click the arrow to open the submenu, and select <code>Operational</code>.</li> | |||
<li>In the <b>Subsystem</b> field, select a subsystem name from the drop-down list.</li> | <li>In the <b>Subsystem</b> field, select a subsystem name from the drop-down list.</li> | ||
<li>Set the | <li>Set the operating options as needed. | ||
<p>The following table summarizes the operating options and what they | <p>The following table summarizes the operating options and what they specify when enabled. For more details, see [[System requirements for Application Subsystems#Parameter descriptions|operating options]].</p> | ||
<table> | <table> | ||
<tr class="head"> | <tr class="head"> | ||
<th>Operating option field</th> | <th>Operating option field</th> | ||
<th> | <th>Description</th> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<td>Status</td> | <td>Status</td> | ||
<td>Specifies the level of availability of the subsystem to users</td> | <td>Specifies the level of availability of the subsystem to users.</td> | ||
<tr> | <tr> | ||
<tr> | <tr> | ||
<td>Auto Start </td> | <td>Auto Start </td> | ||
<td> | <td>Automatically starts the subsystem when the first user enters the subsystem name.</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<td>Lock File/Group</td> | <td>Lock File/Group</td> | ||
<td> | <td>Subsystem files and groups are available only to users running in the subsystem after the subsystem is started.</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<td>Log user into M204</td> | <td>Log user into M204</td> | ||
<td> | <td>The user is logged out of Model 204 and then logged back in to Model 204 with the subsystem name as the user ID when entering the system.</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<td>Log user out of M204</td> | <td>Log user out of M204</td> | ||
<td> | <td>The user is automatically logged out of <var class="product">Model 204</var> upon exiting the subsystem.</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<td>Auto Commit</td> | <td>Auto Commit</td> | ||
<td> | <td>A SOUL COMMIT statement is executed by Model 204 at each procedure END in the subsystem during execution.</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<td>Maximum Iterations</td> | <td>Maximum Iterations</td> | ||
<td> | <td>The maximum number of consecutive times the same procedure can be invoked.</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<td>Account</td> | <td>Account</td> | ||
<td> | <td>An account value that overrides the login account. The original value is restored when the user exits the subsystem.</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<td>Privileges (in hex)</td> | <td>Privileges (in hex)</td> | ||
<td> | <td>A user's privileges while in the subsystem. Privileges specified before logging into the subsystem are overridden.</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<td>Start Login privileges (in hex)</td> | <td>Start Login privileges (in hex)</td> | ||
<td>Controls login privileges while starting a subsystem.</td> | <td>Controls login privileges while starting a subsystem. If specified, Start Login Privileges overrides both the user's previous privileges and other privilege fields in the subsystem definition.</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<td>Subsystem can access Remote Files</td> | <td>Subsystem can access Remote Files</td> | ||
<td>For use with [[PQO: | <td>For use with [[PQO: Scattered APSY subsystems#Member availability to APSY subsystems|Parallel Query Option/204]] (PQO) applications; allows application subsystem definitions and requests to refer to remote files.</td> | ||
</tr> | </tr> | ||
Line 256: | Line 343: | ||
====Files==== | ====Files==== | ||
The Files menu item enables you to define the files, including the procedure file, used by the subsystem. | The Files menu item enables you to define the files, including the procedure file, used by the subsystem. | ||
=====To create or update a file specification===== | =====To create or update a file specification===== | ||
<ol> | <ol> | ||
<li> | <li>Click the <code>Manage</code> tab. </li> | ||
<li>In the <code>Subsystem Management</code> menu, click the arrow to open the submenu, and select <code>Files</code>.</li> | |||
<li>Select a subsystem from the drop-down list beside the <b>Subsytem</b> field.</li> | <li>Select a subsystem from the drop-down list beside the <b>Subsytem</b> field.</li> | ||
<li>On the <b>Files</b> screen, enter the [[ | <li>On the <b>Files</b> screen, enter the [[Subsystem Management facility#File specifications|file specifications]] in each field.</li> | ||
<li>Click the <b>Save <var class="term">number</var> Updates</b> button.</li> | <li>Click the <b>Save <var class="term">number</var> Updates</b> button.</li> | ||
</ol> | </ol> | ||
====System Classes==== | ====System Classes==== | ||
You define command and file privileges for each class of subsystem users on the System Classes screen. Each class of user requires a separate screen. User class privileges defined to the subsystem override settings for OPENCTL and file privileges that reside in the password table. | You define command and file privileges for each class of subsystem users on the System Classes screen. Each class of user requires a separate screen. User class privileges defined to the subsystem override settings for OPENCTL and file privileges that reside in the password table. | ||
=====To create a system class===== | =====To create a system class===== | ||
<ol> | <ol> | ||
<li> | <li>Click the <code>Manage</code> tab. </li> | ||
<li>In the <code>Subsystem Management</code> menu, click the arrow to open the submenu, and select <code>System Classes</code>.</li> | |||
<li>On the <b>System Classes</b> screen, select a subsystem from the drop-down list beside the <b>Subsytem</b> field.</li> | <li>On the <b>System Classes</b> screen, select a subsystem from the drop-down list beside the <b>Subsytem</b> field.</li> | ||
<li>In a semi-public subsystem, the first class is automatically assigned the class name DEFAULT. To change the name, double-click the name DEFAULT and type in the new name, which can be up to eight characters long.</li> | <li>In a semi-public subsystem, the first class is automatically assigned the class name DEFAULT. To change the name, double-click the name DEFAULT and type in the new name, which can be up to eight characters long.</li> | ||
<li>In the <b>Command Privileges</b> section, check the box beside each subsystem command that you want the user class (SCLASS) to be able to issue. <b>Debug</b> specifies entering the subsystem in DEBUG mode.</li> | <li>In the <b>Command Privileges</b> section, check the box beside each subsystem command that you want the user class ([[SCLASS]]) to be able to issue. <b>Debug</b> specifies entering the subsystem in DEBUG mode.</li> | ||
<li>If you are a system manager, you can update the fields in the <b>Login Privileges</b> section. | <li>If you are a system manager, you can update the fields in the <b>Login Privileges</b> section. | ||
<ul> | <ul> | ||
Line 306: | Line 398: | ||
=====To add or delete another system class===== | =====To add or delete another system class===== | ||
<ol> | <ol> | ||
<li>Click the plus sign icon beside the | <li>Click the plus sign icon beside the titles of the existing system classes (such as DEFAULT).</li> | ||
<li>A new title, CLASS<var class="term">x</var>, appears. (As each new class is added, <var class="term">x</var> is incremented by 1.) Click the title field to enter a different name, up to eight characters long.</li> | <li>A new title, CLASS<var class="term">x</var>, appears. (As each new class is added, <var class="term">x</var> is incremented by 1.) Click the title field to enter a different name, up to eight characters long.</li> | ||
<li>Fill in the fields as described above.</li> | <li>Fill in the fields as described above.</li> | ||
<li>To delete the class, click the trash can icon beside its name.</li> | <li>To delete the class, click the trash can icon beside its name.</li> | ||
</ol> | |||
=====<b id="classUsers"></b>To view users===== | |||
<ol> | |||
<li>Click the <code>Manage</code> tab. </li> | |||
<li>In the <code>Subsystem Management</code> menu, click the arrow to open the submenu, and select <code>Users</code>.</li> | |||
<li>On the <b>Users</b> screen, select a subsystem from the drop-down list beside the <b>Subsytem</b> field.</li> | |||
<li>The list of users appears.</li> | |||
</ol> | </ol> | ||
===Dictionary=== | ===Dictionary=== | ||
Dictionary/204 functionality is provided as a [[Janus Web Legacy Support|Janus legacy application]]. | |||
The <code>Dictionary</code> links provide convenient access to the existing 3270 [[Dictionary/204 overview|Dictionary/204]] screens. | |||
The <code>Dictionary</code> links provide convenient access to the existing 3270 [[Dictionary/ | |||
RKWeb provides the following <code>Dictionary</code> submenu items: | RKWeb provides the following <code>Dictionary</code> submenu items: | ||
<ul> | <ul> | ||
<li><code>Administration</code> | <li><code>Administration</code> — Brings up the [[Dictionary/204_administration#Using_the_Dictionary.2F204_Administration_main_menu |Administration Facility main menu]].</li> | ||
<li><code>Documents</code> | |||
<li><code>Reports</code> | <li><code>Documents</code> — Brings up the [[Dictionary/204_Documentation_facility#Using_the_Documentation_main_menu| Documentation Facility main menu]].</li> | ||
<li><code>Xref</code> | |||
<li><code>File Management</code> | <li><code>Reports</code> — Brings up the [[Dictionary/204_reports#Selecting_a_report_option|Reports main menu]].</li> | ||
<li><code>Xref</code> — Brings up the [[Dictionary/204_Cross-Reference_facility#Cross-Reference_Selection_screen|Cross-reference selection screen]]. </li> | |||
<li><code>File Management</code> — Brings up the [[Logging on to FILEMGMT#FILEMGMT primary screen|File Management primary screen]].</li> | |||
<li><code>SQL Catalog Reports</code> — Brings up the [[SQL catalog reporting and querying#CCACATREPT Main Menu|SQL Catalog Reporting Facility main menu]].</li> | |||
<li><code>Table Specifications</code> — Brings up the [[SQL DDL from the Table Specification Facility#Creating or modifying a base table (Main Menu panel)|Table Specification Facility main menu]].</li> | |||
</ul> | </ul> | ||
When you click each link a new tab opens. The Dictionary components operate outside the RKWeb menu framework, leaving your original session in place in the original tab. When your Dictionary session is finished, you can simply close the tab to return to your RKWeb session. | When you click each link a new tab opens. The Dictionary components operate outside the RKWeb menu framework, leaving your original session in place in the original tab. When your Dictionary session is finished, you can simply close the tab to return to your RKWeb session. | ||
====Administration==== | ====Administration==== | ||
The Dictionary Administration Facility screen, available to administrators, contains a menu with the following options: | The Dictionary Administration Facility screen, available to administrators, contains a menu with the following options: | ||
Line 339: | Line 447: | ||
</ul></li> | </ul></li> | ||
<li><code>[[Dictionary/204_administration#Security_administration|Security Administration]]</code>. Enables you to specify the privileges of Dictionary/204 users.</li> | <li><code>[[Dictionary/204_administration#Security_administration|Security Administration]]</code>. Enables you to specify the privileges of Dictionary/204 users.</li> | ||
<li><code>[[Dictionary/ | <li><code>[[Dictionary/204 administration#Printing a dictionary inventory|Inventory Report]]</code>. Enables you to produce a report covering the entire contents of the dictionary. This facility reports on the attributes and references of all entries of each entity type. | ||
<p class="note"><b>Note:</b> The processing time required to produce the dictionary inventory can be quite long, depending upon the complexity and number of dictionary entries.</p></li> | <p class="note"><b>Note:</b> The processing time required to produce the dictionary inventory can be quite long, depending upon the complexity and number of dictionary entries.</p></li> | ||
</ol> | </ol> | ||
====Documents==== | ====Documents==== | ||
<p>The Documents facility provides an interface for defining and describing attributes and relationships that are not controlled by the system or by one of the other facilities listed on the Dictionary/204 main menu.</p> | <p> | ||
The Documents facility provides an interface for defining and describing attributes and relationships that are not controlled by the system or by one of the other facilities listed on the Dictionary/204 main menu.</p> | |||
The <code>[[Dictionary/204_Documentation_facility#Using_the_Documentation_main_menu |Dictionary Document Facility]]</code> screen contains a menu with the following options: | The <code>[[Dictionary/204_Documentation_facility#Using_the_Documentation_main_menu |Dictionary Document Facility]]</code> screen contains a menu with the following options: | ||
<ol> | <ol> | ||
<li><code>[[Dictionary/204_Documentation_facility#Adding_an_entry|Add an Entry]]</code>. You can add an entry for an entity type that is either a VIEW or an entity type created by your installation through the Dictionary Administration facility, for example, REPORTs, USERs, and so on. You cannot add entries managed by other Dictionary/204 facilities (such as FILE and PROCEDURE entries).</li> | <li><code>[[Dictionary/204_Documentation_facility#Adding_an_entry|Add an Entry]]</code>. You can add an entry for an entity type that is either a VIEW or an entity type created by your installation through the Dictionary Administration facility, for example, REPORTs, USERs, and so on. You cannot add entries managed by other Dictionary/204 facilities (such as FILE and PROCEDURE entries).</li> | ||
<li><code>[[Dictionary/204_Documentation_facility#Updating_an_entry|Update an Entry]]</code>. You can update an entry of any entity type. You can change only the attributes and relationships that are not managed by another Dictionary/204 facility. | <li><code>[[Dictionary/204_Documentation_facility#Updating_an_entry|Update an Entry]]</code>. You can update an entry of any entity type. You can change only the attributes and relationships that are not managed by another Dictionary/204 facility. | ||
<p>Updating also allows you to create [[Dictionary/204_Documentation_facility#Dummy_entries|dummy entries]].</p></li> | <p>Updating also allows you to create [[Dictionary/204_Documentation_facility#Dummy_entries|dummy entries]].</p></li> | ||
<li><code>[[Dictionary/204_Documentation_facility#Deleting_an_entry|Delete an Entry]]</code>. You can delete an entry for either a VIEW or an entity of a type defined at your installation through the Dictionary Administration facility. You cannot delete entries managed by another Dictionary/204 facility.</li> | <li><code>[[Dictionary/204_Documentation_facility#Deleting_an_entry|Delete an Entry]]</code>. You can delete an entry for either a VIEW or an entity of a type defined at your installation through the Dictionary Administration facility. You cannot delete entries managed by another Dictionary/204 facility.</li> | ||
<li><code>[[Dictionary/204_Documentation_facility#Copying_an_entry|Copy an Entry]]</code>. You can copy an entry for an entity type that is either a VIEW or an entity type created by your installation. You cannot copy entries that are managed by another Dictionary/204 facility.</li> | <li><code>[[Dictionary/204_Documentation_facility#Copying_an_entry|Copy an Entry]]</code>. You can copy an entry for an entity type that is either a VIEW or an entity type created by your installation. You cannot copy entries that are managed by another Dictionary/204 facility.</li> | ||
<li><code>[[Dictionary/204_Documentation_facility#Renaming_an_entry|Rename an Entry]]</code>. You can rename an entry for an entity type that is either a VIEW or an entity of a type created by your installation, such as REPORT, USER, and so on. You cannot rename entries manages by another Dictionary/204 facility. </li> | <li><code>[[Dictionary/204_Documentation_facility#Renaming_an_entry|Rename an Entry]]</code>. You can rename an entry for an entity type that is either a VIEW or an entity of a type created by your installation, such as REPORT, USER, and so on. You cannot rename entries manages by another Dictionary/204 facility. </li> | ||
</ol> | </ol> | ||
Line 358: | Line 472: | ||
<ul> | <ul> | ||
<li>All the attributes and relationships for a given entry</li> | <li>All the attributes and relationships for a given entry</li> | ||
<li>List of all of the entries for a given type of entity | <li>List of all of the entries for a given type of entity — all SCREENs, all FILEs, and so on</li> | ||
<li>Entries selected by name, entity type, relationship with another specified entry, or specific keywords</li> | <li>Entries selected by name, entity type, relationship with another specified entry, or specific keywords</li> | ||
</ul> | </ul> | ||
Line 364: | Line 478: | ||
<ol> | <ol> | ||
<li>Select <code>Manage > Dictionary > Reports</code> from the main menu.</li> | <li>Select <code>Manage > Dictionary > Reports</code> from the main menu.</li> | ||
<li>On the Dictionary Reports Main Menu that appears, select an option: | <li>On the Dictionary Reports Main Menu that appears, select an option: | ||
<ol> | <ol> | ||
<li><code>[[Dictionary/204_reports#Displaying_an_entry|Display an Entry]]</code> | <li><code>[[Dictionary/204_reports#Displaying_an_entry|Display an Entry]]</code> | ||
<p>Displays the attributes and/or relationships (or references) for an entry of a specified entity type.</p></li> | <p>Displays the attributes and/or relationships (or references) for an entry of a specified entity type.</p></li> | ||
<li><code>[[Dictionary/204_reports#Listing_entries_of_an_entity_type|List Entries of an Entity Type]]</code> | <li><code>[[Dictionary/204_reports#Listing_entries_of_an_entity_type|List Entries of an Entity Type]]</code> | ||
<p>Displays a list of entries of one or several entity types. For example, the names of all the files, all the procedures, and so on.</p></li> | <p>Displays a list of entries of one or several entity types. For example, the names of all the files, all the procedures, and so on.</p></li> | ||
<li><code>[[Dictionary/204_reports#Displaying_cross-reference_relationships|Display Cross-References for an Entry</code>]] | <li><code>[[Dictionary/204_reports#Displaying_cross-reference_relationships|Display Cross-References for an Entry</code>]] | ||
<p>Displays relationships between entries based on cross-references only. | <p>Displays relationships between entries based on cross-references only. | ||
You can search all entries or only entries of a particular entity type.</p> | You can search all entries or only entries of a particular entity type.</p> | ||
</li> | </li> | ||
<li><code>[[Dictionary/204_reports#Displaying_named_relationships|Display Named References for an Entry]]</code> | <li><code>[[Dictionary/204_reports#Displaying_named_relationships|Display Named References for an Entry]]</code> | ||
<p>Displays relationships between entries based on named references only. | <p>Displays relationships between entries based on named references only. | ||
You can search all entries or only entries of a particular entity type.</p> | You can search all entries or only entries of a particular entity type.</p> | ||
<p>Named references are unidirectional and take the form A ===> B; however, Dictionary/204 also allows you to search for entries that are related to B (including A).</p></li> | <p>Named references are unidirectional and take the form A ===> B; however, Dictionary/204 also allows you to search for entries that are related to B (including A).</p></li> | ||
<li><code>[[Dictionary/204_reports#Displaying_all_relationships|Display All References for an Entry]]</code> | <li><code>[[Dictionary/204_reports#Displaying_all_relationships|Display All References for an Entry]]</code> | ||
<p>Displays any relationship between entries including cross-, named, or path (indirect) references.</p></li> | <p>Displays any relationship between entries including cross-, named, or path (indirect) references.</p></li> | ||
<li><code>[[Dictionary/ | |||
<li><code>[[Dictionary/204 reports#Browsing dictionary entries by attributes|Browse Entries by Attributes]]</code> | |||
<p>Browses through entries selected by the value of their KEYWORD attribute, the UNQUALIFIED NAME attribute, or optionally browsing entries selected by the value of specific standard attributes.</p> | <p>Browses through entries selected by the value of their KEYWORD attribute, the UNQUALIFIED NAME attribute, or optionally browsing entries selected by the value of specific standard attributes.</p> | ||
<p>You can restrict browsing to a single entity type or browse all the dictionary entries, regardless of entity type.</p> | <p>You can restrict browsing to a single entity type or browse all the dictionary entries, regardless of entity type.</p> | ||
Line 391: | Line 511: | ||
====Xref==== | ====Xref==== | ||
The [[Dictionary/ | The [[Dictionary/204 Cross-Reference facility#Using the Cross-Reference facility|Dictionary cross-reference facility]] produces a cross-reference report for procedures in a selected file or group. The report shows the line numbers where language elements such as labels, functions, and variable names occur. | ||
<ol> | <ol> | ||
<li>From the main menu, select <code>Manage > Dictionary > Xref</code>.</li> | <li>From the main menu, select <code>Manage > Dictionary > Xref</code>.</li> | ||
Line 411: | Line 531: | ||
====File Management==== | ====File Management==== | ||
The Dictionary/204 File Management Subsystem facility, [[Dictionary/204_FILEMGMT_overview|FILEMGMT]], enables you to create Model 204 files quickly, reliably, and securely. You define a file and its contents on the series of screens that FILEMGMT provides. FILEMGMT uses your definitions to: | The Dictionary/204 File Management Subsystem facility, [[Dictionary/204_FILEMGMT_overview|FILEMGMT]], enables you to create Model 204 files quickly, reliably, and securely. You define a file and its contents on the series of screens that FILEMGMT provides. FILEMGMT uses your definitions to: | ||
<ul> | <ul> | ||
<li>Construct the Model 204 commands that create the physical file</li> | <li>Construct the Model 204 commands that create the physical file</li> | ||
<li>Store the appropriate entries in your installation's dictionary</li> | <li>Store the appropriate entries in your installation's dictionary</li> | ||
</ul> | </ul> | ||
Line 453: | Line 573: | ||
<td>Defines field groups for a new or existing file, changes existing field group names or contents, and performs other field group maintenance functions.</td> | <td>Defines field groups for a new or existing file, changes existing field group names or contents, and performs other field group maintenance functions.</td> | ||
</tr> | </tr> | ||
</table> | |||
====SQL Catalog Reports==== | |||
The CCACATREPT subsystem is a reporting mechanism for data in the CCACAT SQL catalog file. CCACATREPT is a menu-driven utility that produces both online and printed output. With CCACATREPT you can produce a report that provides information about all SQL objects defined in the SQL catalog. | |||
Catalog administrators can compare the CCACATREPT output to the Model 204 file data to determine the updates they need to make to the SQL catalog to obtain consistency with the file. They can modify the report's generated DDL and use it to repopulate the SQL catalog. SQL application programmers and SQL users can use the output to verify valid table, view, column names and column attributes. | |||
In the Selection field, specify the number of the type of report that you want to generate: | |||
<ol> | |||
<li>File of valid DDL syntax, which you can use to rebuild the catalog </li> | |||
<li>Fixed format report of a table or view </li> | |||
<li>Privilege report by table or view name </li> | |||
<li>Privilege report by user</li> | |||
</ol> | |||
Fill in the fields as needed for each report: | |||
<table> | |||
<tr class="head"> | |||
<th>Field</th><th>Used in report type...</th><th>Value</th></tr> | |||
<tr><td>Schema Name</td><td>1,2, or 3</td><td>Enter the name of a specific schema or enter an asterisk (*) for all schemas. | |||
<p>If your Selection field entry requires an entry for this field and you do not enter a value, by default CCACATREPT outputs all schemas.</p></td></tr> | |||
<tr><td>Authorization ID</td><td>1 or 2</td><td>Enter the name of a specific authorization ID or enter an asterisk (*) for all authorization IDs. | |||
<p>If your Selection field entry requires an entry for this field and you do not enter a value, by default CCACATREPT outputs all authorization IDs.</p></td></tr> | |||
<tr><td>Table View/Name</td><td>1, 2, or 3</td><td>Enter the name of a specific table or view to be reported or enter an asterisk (*) for all tables and views. | |||
<p>If your Selection field entry requires an entry for this field and you do not enter a value, by default CCACATREPT outputs all tables and views.</p></td></tr> | |||
<tr><td>DDL Statement Type(s)</td><td>1</td><td>The output from Selection 1 is standard SQL DDL generated from the Model 204 SQL catalog. In the DDL Statement Type(s) field, you identify the DDL statement types to be generated. | |||
<p>Select one or more of the following identifiers:</p> | |||
<table> | |||
<tr class="head"> | |||
<th>Identifier</th> | |||
<th>Statement generated</th> | |||
</tr> | |||
<tr> | |||
<td>T</td> | |||
<td>CREATE TABLE</td> | |||
</tr> | |||
<tr> | |||
<td>V</td> | |||
<td>CREATE VIEW</td> | |||
</tr> | |||
<tr> | |||
<td>G</td> | |||
<td>GRANT</td> | |||
</tr> | |||
<tr> | |||
<td>T, V, or G</td> | |||
<td>CREATE SCHEMA or SET SCHEMA<br> | |||
CREATE TABLE, CREATE VIEW, and GRANT</td> | |||
</tr> | |||
</table> | |||
<p>If your Selection field entry requires an entry for this field and you do not enter a value, by default CCACATREPT outputs all the DDL.</p></td></tr> | |||
<tr><td>Grantee</td><td>4</td><td>Enter the SQL identifier of a specific grantee to be reported or enter an asterisk (*) for all grantees. Privileges granted to PUBLIC are always reported. | |||
<p>If your Selection field entry requires an entry for this field and you do not enter a value, by default CCACATREPT outputs privileges for all grantees.</p></td></tr> | |||
<tr><td>"USE" Command Arg</td><td>All</td><td>Use this field to route output to a destination other than to the terminal. The character string you enter in this field becomes the Model 204 USE command argument that identifies the output destination device. | |||
<p>You can enter any USE command argument that is valid in your operating environment, for example, <code>PRINTER FOO</code> or <code>$PRINT *</code>.</p> | |||
<p>For more details, see [[SQL_catalog_reporting_and_querying#.22USE.22_Command_Arg|"USE" Command Arg]].</p></td></tr> | |||
</table> | |||
====Table Specifications==== | |||
The Model 204 SQL Table Specification facility (TSF) enables you to create a new SQL table by mapping a Model 204 file. TSF is not used to modify existing tables. | |||
TSF looks at an existing Model 204 file, reads its field names and their attributes, and allows you to specify how to map the file to an SQL table. The TSF provides an interactive, menu-driven facility that generates a subset of DDL statements based on your specifications. You can use the generated DDL as input to the CVI utility to define your SQL table to the SQL catalog. | |||
The following table summarizes the values to be entered on the main screen. For details, see [[SQL_DDL_from_the_Table_Specification_Facility#Creating_or_modifying_a_base_table_.28Main_Menu_panel.29|Creating or modifying a base table (Main Menu panel)]]. | |||
Unless otherwise noted, you must enter a value for each field. | |||
<table> | |||
<tr class="head"> | |||
<th>Field</th><th>Value</th></tr> | |||
<tr><td>Schema Authorization</td> | |||
<td>Authorization ID (default is the Model 204 login user ID)</td></tr> | |||
<tr><td>Table Name</td> | |||
<td>The name of the SQL table that you are defining. Multiple nested tables are allowed.</td></tr> | |||
<tr><td>Schema Name</td> | |||
<td>The SQL schema name as you want it to appear in the CREATE SCHEMA statement. (If left blank, Schema Name defaults to the authorization ID specified for Schema Authorization.)</td></tr> | |||
<tr><td nowrap>Model 204 File Name</td> | |||
<td>The name of the Model 204 file that you want defined as an SQL table.</td></tr> | |||
<tr><td>Password</td> | |||
<td>If applicable, enter the passowrd that gives the user the authority to read the file and all the field names that will be used as columns in the SQL table.</td></tr> | |||
<tr><td>Table Type</td> | |||
<td>The table type: B (Base), P (Parent), or N (Nested). </td></tr> | |||
<tr><td>Primary Key</td> | |||
<td>If the table type is P (Parent) or N (Nested), enter the value for the primary key.</td></tr> | |||
<tr><td>Parent Table</td> | |||
<td>If the table type is N (Nested), enter the name of the SQL table that each nested table references.</td></tr> | |||
</table> | </table> | ||
===Passwords=== | ===Passwords=== | ||
Clicking the <code> | Clicking the <code>Manage > Passwords</code> menu item enables you to use the [[SirPro CCASTAT password maintenance|SirPro password functionality]] to maintain passwords in [[Storing security information (CCASTAT)|CCASTAT]]. The Passwords interface is available to RKWEB subsystem ADMIN SCLASS users who have System Administrator privileges. | ||
When viewing passwords for users, files, or groups, click a column header (such as <b>Privileges</b>) to sort the entries by that header. | When viewing passwords for users, files, or groups, click a column header (such as <b>Privileges</b>) to sort the entries by that header. | ||
Click the information icon (the letter i in a red circle) at the right of the screen to see the current values of the parameters that affect the password settings. Click the link to the Model 204 wiki to get to detailed parameter information | Click the information icon (the letter <i>i</i> in a red circle) at the right of the screen to see the current values of the parameters that affect the password settings. Click the link to the Model 204 wiki to get to detailed parameter information. | ||
====Users==== | ====Users==== | ||
From the <code>Users</code> menu, you can add, change, or delete login user ID entries in the password table. | From the <code>Users</code> menu, you can add, change, or delete login user ID entries in the password table. | ||
=====To add a user ID===== | =====To add a user ID===== | ||
<ol> | <ol> | ||
<li>Click the plus sign icon beside the Model 204 User Passwords header.</li> | <li>Click the plus sign icon beside the Model 204 User Passwords header.</li> | ||
<li>In the <b>Add userid to CCASTAT</b> dialog box that appears, enter the user ID, which can be one to ten characters long. | <li>In the <b>Add userid to CCASTAT</b> dialog box that appears, enter the user ID, which can be one to ten characters long. | ||
<li>In the <b>Password</b> field, enter the password. The password cannot contain commas and must be one to eight characters long. | <li>In the <b>Password</b> field, enter the password. The password cannot contain commas and must be one to eight characters long. | ||
Line 474: | Line 692: | ||
<li>In the <b>Priority</b> field, choose a [[PRIORITY_command#Usage_notes|user priority]] from the drop-down list.</li> | <li>In the <b>Priority</b> field, choose a [[PRIORITY_command#Usage_notes|user priority]] from the drop-down list.</li> | ||
<li>In the <b>Terminals</b> field, leave the default of ALL if your installation does not use terminal security features. Otherwise, enter the number of a terminal from which a user can issue a LOGIN command for this user ID.</li> | <li>In the <b>Terminals</b> field, leave the default of ALL if your installation does not use terminal security features. Otherwise, enter the number of a terminal from which a user can issue a LOGIN command for this user ID.</li> | ||
<li>Click the <b>Save updates</b> button. The information is immediately committed to CCASTAT. | <li>Click the <b>Save updates</b> button. The information is immediately committed to CCASTAT. | ||
</li> | </li> | ||
<li>Press F5 to refresh the screen and verify that the new user ID is listed.</li> | <li>Press F5 to refresh the screen and verify that the new user ID is listed.</li> | ||
Line 481: | Line 699: | ||
=====To change a User ID===== | =====To change a User ID===== | ||
<ol> | <ol> | ||
<li>Click the icon to the left of the user | <li>Click the icon to the left of the user ID that you want to change.</li> | ||
<li>Select <b>Change</b> from the pop-up menu that appears.</li> | <li>Select <b>Change</b> from the pop-up menu that appears.</li> | ||
<li>In the <b>Change user password or logon settings</b> dialog box, change the user id, password, verify password, priority, privileges, and/or terminals.</li> | <li>In the <b>Change user password or logon settings</b> dialog box, change the user id, password, verify password, priority, privileges, and/or terminals.</li> | ||
<li>Click the <b>Save updates</b> button. The information is immediately committed to CCASTAT. | <li>Click the <b>Save updates</b> button. The information is immediately committed to CCASTAT. | ||
</li> | </li> | ||
</ol> | </ol> | ||
Line 492: | Line 710: | ||
<li>Click the icon to the left of the user ID that you want to delete.</li> | <li>Click the icon to the left of the user ID that you want to delete.</li> | ||
<li>Select <b>Delete</b> from the pop-up menu that appears.</li> | <li>Select <b>Delete</b> from the pop-up menu that appears.</li> | ||
<li>In the <b>Delete User</b> pop-up that appears, click <b>Confirm Delete</b>. The information is immediately deleted from CCASTAT. | <li>In the <b>Delete User</b> pop-up that appears, click <b>Confirm Delete</b>. The information is immediately deleted from CCASTAT. | ||
</li> | </li> | ||
<li>Press F5 to refresh the screen and verify that the user ID has been removed from the list.</li> | <li>Press F5 to refresh the screen and verify that the user ID has been removed from the list.</li> | ||
Line 500: | Line 718: | ||
=====To add a file password===== | =====To add a file password===== | ||
<ol> | <ol> | ||
<li>Click the plus sign icon beside the Model 204 File Passwords header.</li> | <li>Click the plus sign icon beside the Model 204 File Passwords header.</li> | ||
<li>In the <b>Add File entry to CCASTAT</b> dialog box that appears, enter the name, password, and privileges for the file. Hover over each field for pop-up help. For details on acceptable values, see [[LOGCTL_command:_Modifying_file_entries_in_the_password_table|LOGCTL for file entries]].</li> | <li>In the <b>Add File entry to CCASTAT</b> dialog box that appears, enter the name, password, and privileges for the file. Hover over each field for pop-up help. For details on acceptable values, see [[LOGCTL_command:_Modifying_file_entries_in_the_password_table|LOGCTL for file entries]].</li> | ||
<li>In the <b>File name</b> field, enter the File name, which can be 1-8 characters long and must start with a letter.</li> | <li>In the <b>File name</b> field, enter the File name, which can be 1-8 characters long and must start with a letter.</li> | ||
Line 508: | Line 726: | ||
<li>In the <b>Index</b> field, specify a single index character (a digit 0-9 or a letter A-Z). An index is required when a file has more than one password; it is used to differentiate entries for future changes or deletions.</li> | <li>In the <b>Index</b> field, specify a single index character (a digit 0-9 or a letter A-Z). An index is required when a file has more than one password; it is used to differentiate entries for future changes or deletions.</li> | ||
<li>In the <b>User class</b> field, enter the number of the [[Model_204_security_features#User_and_procedure_classes|user class]] that can access the file.</li> | <li>In the <b>User class</b> field, enter the number of the [[Model_204_security_features#User_and_procedure_classes|user class]] that can access the file.</li> | ||
<li>In the <b>Select Privs</b>, <b>Read Privs</b>, <b>Update Privs</b>, and <b>Add Privs</b> fields, enter the three-digit | <li>In the <b>Select Privs</b>, <b>Read Privs</b>, <b>Update Privs</b>, and <b>Add Privs</b> fields, enter the three-digit [[Establishing and maintaining security#Field-level security|field-level security]] for Select, Read, Update, and Add privileges. </li> | ||
<li>In the <b>Terminals</b> field, leave the default of ALL if your installation does not use terminal security features. Otherwise, enter the number of a terminal from which a user can issue a LOGIN command for this user ID.</li> | <li>In the <b>Terminals</b> field, leave the default of ALL if your installation does not use terminal security features. Otherwise, enter the number of a terminal from which a user can issue a LOGIN command for this user ID.</li> | ||
<li>Click the <b>Save updates</b> button. The information is immediately committed to CCASTAT. | <li>Click the <b>Save updates</b> button. The information is immediately committed to CCASTAT. | ||
</li> | </li> | ||
<li>Press F5 to refresh the screen and verify that the new file entry is listed.</li> | <li>Press F5 to refresh the screen and verify that the new file entry is listed.</li> | ||
Line 517: | Line 735: | ||
=====To change a file password or logon settings===== | =====To change a file password or logon settings===== | ||
<ol> | <ol> | ||
<li>Click the icon to the left of the file | <li>Click the icon to the left of the file ID that you want to change.</li> | ||
<li>Select <b>Change</b> from the pop-up menu that appears.</li> | <li>Select <b>Change</b> from the pop-up menu that appears.</li> | ||
<li>In the <b>Change file password or logon settings</b> dialog box, change the Password, general Privileges, User class, Select/Update/Read/Add privileges, and/or Terminals. For information on acceptable values, see [[ | <li>In the <b>Change file password or logon settings</b> dialog box, change the Password, general Privileges, User class, Select/Update/Read/Add privileges, and/or Terminals. For information on acceptable values, see [[LOGCTL command: Modifying file_entries in the password table|LOGCTL for file entries]]. | ||
<p class="note"><b>Tip:</b> To change general Privileges, click the search icon beside the field to bring up a checklist of privileges.</p> | <p class="note"><b>Tip:</b> To change general Privileges, click the search icon beside the field to bring up a checklist of privileges.</p> | ||
</li> | </li> | ||
<li>Click the <b>Save updates</b> button. The information is immediately committed to CCASTAT. | <li>Click the <b>Save updates</b> button. The information is immediately committed to CCASTAT. | ||
</li> | </li> | ||
</ol> | </ol> | ||
Line 530: | Line 748: | ||
<li>Click the icon to the left of the File that you want to delete.</li> | <li>Click the icon to the left of the File that you want to delete.</li> | ||
<li>Select <code>Delete</code> from the pop-up menu that appears.</li> | <li>Select <code>Delete</code> from the pop-up menu that appears.</li> | ||
<li>In the <b>Delete File</b> pop-up that appears, click <b>Confirm Delete</b>. The information is immediately deleted from CCASTAT. | <li>In the <b>Delete File</b> pop-up that appears, click <b>Confirm Delete</b>. The information is immediately deleted from CCASTAT. | ||
</li> | </li> | ||
<li>Press F5 to refresh the screen and verify that the file has been removed from the list.</li> | <li>Press F5 to refresh the screen and verify that the file has been removed from the list.</li> | ||
Line 540: | Line 758: | ||
<li>Click the plus sign icon beside the <b>Model 204 Group Passwords</b> header.</li> | <li>Click the plus sign icon beside the <b>Model 204 Group Passwords</b> header.</li> | ||
<li>In the <b>Add Group entry to CCASTAT</b> dialog box that appears, enter the Group name, Password, general Privileges, Index, User class, Select/Update/Read/Add privileges, and/or Terminals. | <li>In the <b>Add Group entry to CCASTAT</b> dialog box that appears, enter the Group name, Password, general Privileges, Index, User class, Select/Update/Read/Add privileges, and/or Terminals. | ||
For information on acceptable values, see [[ | For information on acceptable values, see [[LOGCTL command: Modifying group entries in the password table|LOGCTL for group entries]]. | ||
<p class="note"><b>Tip:</b> To set general Privileges, click the search icon beside the field to bring up a checklist of privileges.</p> | <p class="note"><b>Tip:</b> To set general Privileges, click the search icon beside the field to bring up a checklist of privileges.</p> | ||
</li> | </li> | ||
<li>Click the <b>Save updates</b> button. The information is immediately committed to CCASTAT. | <li>Click the <b>Save updates</b> button. The information is immediately committed to CCASTAT. | ||
</li> | </li> | ||
<li>Press F5 to refresh the screen and verify that the new group entry is listed.</li> | <li>Press F5 to refresh the screen and verify that the new group entry is listed.</li> | ||
Line 552: | Line 770: | ||
<li>Click the icon to the left of the group id that you want to change.</li> | <li>Click the icon to the left of the group id that you want to change.</li> | ||
<li>Select <b>Change</b> from the pop-up menu that appears.</li> | <li>Select <b>Change</b> from the pop-up menu that appears.</li> | ||
<li>In the <b>Change group password or logon settings</b> dialog box, change the Password, general Privileges, Index, User class, Select/Update/Read/Add privileges, and/or Terminals. For information on acceptable values, see [[ | <li>In the <b>Change group password or logon settings</b> dialog box, change the Password, general Privileges, Index, User class, Select/Update/Read/Add privileges, and/or Terminals. For information on acceptable values, see [[LOGCTL command: Modifying group entries in the password table|LOGCTL for group entries]]. | ||
<p class="note"><b>Tip:</b> To change general Privileges, click the search icon beside the field to bring up a checklist of privileges.</p></li> | <p class="note"><b>Tip:</b> To change general Privileges, click the search icon beside the field to bring up a checklist of privileges.</p></li> | ||
<li>Click the <b>Save updates</b> button. The information is immediately committed to CCASTAT. | <li>Click the <b>Save updates</b> button. The information is immediately committed to CCASTAT. | ||
</li> | </li> | ||
</ol> | </ol> | ||
Line 561: | Line 779: | ||
<li>Click the icon to the left of the group that you want to delete.</li> | <li>Click the icon to the left of the group that you want to delete.</li> | ||
<li>Select <b>Delete</b> from the pop-up menu that appears.</li> | <li>Select <b>Delete</b> from the pop-up menu that appears.</li> | ||
<li>In the <b>Delete Group</b> pop-up that appears, click <b>Confirm Delete</b>. The information is immediately deleted from CCASTAT. | <li>In the <b>Delete Group</b> pop-up that appears, click <b>Confirm Delete</b>. The information is immediately deleted from CCASTAT. | ||
</li> | </li> | ||
<li>Press F5 to refresh the screen and verify that the group entry has been removed from the list.</li> | <li>Press F5 to refresh the screen and verify that the group entry has been removed from the list.</li> | ||
Line 567: | Line 785: | ||
===Group Definitions=== | ===Group Definitions=== | ||
The <code>Group Definitions</code> menu option enables system managers to manage the [[ | The <code>Group Definitions</code> menu option enables system managers to manage the [[SirPro file-group maintenance|group definitions]] in [[Storing and using file group definitions (CCAGRP)|CCAGRP]]. Access to the Group Definition page is given to RKWEB subsystem ADMIN SCLASS users who have System Administrator login privileges. | ||
====To add a group==== | ====To add a group==== | ||
<ol> | <ol> | ||
<li>Click the plus sign icon beside the <b>Model 204 Groups</b> screen title. | <li>Click the plus sign icon beside the <b>Model 204 Groups</b> screen title. | ||
<p>The <b>Create a new group</b> screen appears.</p></li> | <p>The <b>Create a new group</b> screen appears.</p></li> | ||
<li>Fill in or select the field values to set the group parameters. Hover the mouse over each field for help. These parameters are also described in the [[ | |||
<li>Fill in or select the field values to set the group parameters. Hover the mouse over each field for help. These parameters are also described in the <var>[[CREATE command: Permanent group|CREATE]]</var> command.</li> | |||
<li>Click the <b>Save changes</b> button.</li> | <li>Click the <b>Save changes</b> button.</li> | ||
<li>Press the <code>F5</code> key to refresh the display and see your group in the list.</li> | <li>Press the <code>F5</code> key to refresh the display and see your group in the list.</li> | ||
</ol> | </ol> | ||
Line 595: | Line 817: | ||
<li>Click the icon beside the group name that you want to update, and click Update in the Copy/Rename/Update/Delete pop-up list.</li> | <li>Click the icon beside the group name that you want to update, and click Update in the Copy/Rename/Update/Delete pop-up list.</li> | ||
<p>The <b>Update group definition</b> dialog box appears.</p></li> | <p>The <b>Update group definition</b> dialog box appears.</p></li> | ||
<li>Fill in or select new field values to change the group parameters. Hover the mouse over each field for help. These parameters are also described in the [[ | <li>Fill in or select new field values to change the group parameters. Hover the mouse over each field for help. These parameters are also described in the [[CREATE command: Permanent group|CREATE]] command.</li> | ||
<li>Click the <b>Save <var class="term">number</var> Updates</b> button.</li> | <li>Click the <b>Save <var class="term">number</var> Updates</b> button.</li> | ||
</ol> | </ol> | ||
Line 608: | Line 830: | ||
===SSL Certificates=== | ===SSL Certificates=== | ||
<p class="note"><b>Note:</b> Before using the RKWeb SSL Certificates interface, click the <code>Manage > SSL Certificates > SSL Information</code> menu item and read the SSL <b>Certificate Management - How to use this application</b> screen.</p> | <p class="note"><b>Note:</b> Before using the RKWeb SSL Certificates interface, click the <code>Manage > SSL Certificates > SSL Information</code> menu item and read the SSL <b>Certificate Management - How to use this application</b> screen.</p> | ||
====Overview==== | ====Overview==== | ||
<p>Janus Network Security supports the SSL (Secure Socket Layer) and the TLS (Transport Layer Security) protocols, which provide secure communications for users of Janus products. In order to provide for secure communications and authentication, SSL employs several features, including public and private keys for encryption, and certificates and digital signatures for authentication.</p> | <p> | ||
<p>Server certificates used by SSL typically contain the country, state or province, locality (city, town, village, etc.), organization, and organizational unit of the holder of the private key. In addition, SSL server certificates contain the TCP/IP host name of the server that holds the private key.</p> | Janus Network Security supports the SSL (Secure Socket Layer) and the TLS (Transport Layer Security) protocols, which provide secure communications for users of Janus products. In order to provide for secure communications and authentication, SSL employs several features, including public and private keys for encryption, and certificates and digital signatures for authentication. </p> | ||
<p> | |||
The information in a server certificate can normally be viewed in a client application such as a browser, so an end user can be sure that he or she is communicating with the correct server. | Access to this feature in RKWeb requires a [[Janus Network Security]] license and is restricted to RKWEB subsystem ADMIN SCLASS members, who also have System Administrator login privileges. </p> | ||
<p> | |||
Server certificates used by SSL typically contain the country, state or province, locality (city, town, village, etc.), organization, and organizational unit of the holder of the private key. In addition, SSL server certificates contain the TCP/IP host name of the server that holds the private key.</p> | |||
<p> | |||
The information in a server certificate can normally be viewed in a client application such as a browser, so an end user can be sure that he or she is communicating with the correct server. </p> | |||
<p class="note"><b>Note:</b> An SSL client will automatically verify that the host name in a server certificate matches the name of the host to which it is connecting.</p> | <p class="note"><b>Note:</b> An SSL client will automatically verify that the host name in a server certificate matches the name of the host to which it is connecting.</p> | ||
<p>For more information on certificates, see [[ | <p> | ||
For more information on certificates, see [[Janus Network Security#keycert|About keys and certificates]].</p> | |||
RKWeb provides a convenient web interface for the tasks involved in generating an SSL certificate. (For an overview of the process, see [[ | <p> | ||
RKWeb provides a convenient web interface for the tasks involved in generating an SSL certificate. (For an overview of the process, see [[SSL certificate management|SSL certificate management]].) </p> | |||
The process of getting a valid certificate and private key combination usually involves these steps: | <p> | ||
The process of getting a valid certificate and private key combination usually involves these steps: </p> | |||
<table> | <table> | ||
<tr class="head"> | <tr class="head"> | ||
Line 625: | Line 853: | ||
<tr> | <tr> | ||
<td>1. Generate a private key and an associated certificate request.</td><td>Create Request</td><td>The certificate request is basically a certificate without a digital signature. The private key should be stored in a secure location and (preferably) encrypted.</td></tr> | <td>1. Generate a private key and an associated certificate request.</td><td>Create Request</td><td>The certificate request is basically a certificate without a digital signature. The private key should be stored in a secure location and (preferably) encrypted.</td></tr> | ||
<tr><td>2. Forward the certificate request file to the certifying authority (CA).</td><td>N/A</td><td>Scroll down the screen to the "How to use this page" section.</td></tr> | <tr><td>2. Forward the certificate request file to the certifying authority (CA).</td><td>N/A</td><td>Scroll down the screen to the "How to use this page" section.</td></tr> | ||
<tr><td>3. The certifying authority digitally signs the certificate.</td><td>N/A</td> <td>Presumably, the certifying authority verifies that the information in the certificate is correct and valid, but this is not strictly necessary.</td></tr> | <tr><td>3. The certifying authority digitally signs the certificate.</td><td>N/A</td> <td>Presumably, the certifying authority verifies that the information in the certificate is correct and valid, but this is not strictly necessary.</td></tr> | ||
<tr><td>4. The certifying authority sends the digitally signed certificate back to the holder of the private key.</td><td>N/A</td><td>N/A</td></tr> | <tr><td>4. The certifying authority sends the digitally signed certificate back to the holder of the private key.</td><td>N/A</td><td>N/A</td></tr> | ||
<tr><td>5. The holder of the private key receives the signed certificate. This usually involves associating the signed certificate with the private key in some way.</td><td>Receive Certificate</td><td>With Janus Network Security, the private key and the signed certificate must be placed into the same procedure.</td></tr> | <tr><td>5. The holder of the private key receives the signed certificate. This usually involves associating the signed certificate with the private key in some way.</td><td>Receive Certificate</td><td>With Janus Network Security, the private key and the signed certificate must be placed into the same procedure.</td></tr> | ||
Line 673: | Line 904: | ||
==Monitor== | ==Monitor== | ||
The <code>Monitor</code> menu enables you to monitor Model 204 performance, perform a journal scan, and run Model 204 commands. | The <code>Monitor</code> menu enables you to monitor Model 204 performance, perform a journal scan, and run Model 204 commands. | ||
===Performance=== | ===Performance=== | ||
The <code>Monitor > Performance</code> menu is the RKWeb interface to the [[SirMon]] monitoring application. SirMon combines the real time monitoring of Model 204 performance with intelligent full screen displays that facilitate System Manager duties. | The <code>Monitor > Performance</code> menu is the RKWeb interface to the [[SirMon]] monitoring application, and it is restricted to RKWEB subsystem ADMIN SCLASS users at sites that own SirMon. SirMon combines the real-time monitoring of Model 204 performance with intelligent full-screen displays that facilitate System Manager duties. You can scroll the displays, refresh them, and sort them by displayed statistics and parameters. | ||
<p>SirMon provides a collection of | <p>SirMon provides a collection of predefined monitoring options known to be useful for analyzing Model 204 performance and solving performance problems. SirMon features are designed to highlight significant resource consumers.</p> | ||
<p>SirMon is completely integrated with the Model 204 security scheme, so users have access to commands in SirMon only if they have access to them at Model 204 command level.</p> | <p>SirMon is completely integrated with the Model 204 security scheme, so users have access to commands in SirMon only if they have access to them at the Model 204 command level.</p> | ||
<p>SirMon divides the Model 204 Online into System, | <p>SirMon divides the Model 204 Online into System, Files, Users, Subsystems, MP Tasks, and Janus Ports statistics. In addition to those statistics collected by Model 204, SirMon provides an extensive collection of additional statistics and information that is invaluable for understanding the performance of a Model 204 Online.</p> | ||
<p>To see the meaning of any statistic in the display, mouse over it for pop-up help.</p> | <p>To see the meaning of any statistic in the display, mouse over it for pop-up help.</p> | ||
<p>Extensive customization facilities make it easy to design and implement screens or views that track information of interest to your particular site.</p> | <p>Extensive [[#Custom|customization]] facilities make it easy to design and implement screens or views that track information of interest to your particular site.</p> | ||
====System==== | ====System==== | ||
The <code>Monitor > Performance > System</code> menu option provides a submenu of system statistics screens: | The <code>Monitor > Performance > System</code> menu option provides a submenu of system statistics screens, including: | ||
<table class="thJustBold"> | <table class="thJustBold"> | ||
Line 736: | Line 968: | ||
<p>For a description of each statistic, hover the mouse over the column heading to see pop-up help.</p> | <p>For a description of each statistic, hover the mouse over the column heading to see pop-up help.</p> | ||
A <var class="product">SirMon</var> administrator can also locally define [[#Custom|custom screens]] that are accessed from the <code>Monitor > Performance > System</code> menu. | |||
====Files==== | ====Files==== | ||
The <code>Monitor > Performance > Files</code> menu presents a | The <code>Monitor > Performance > Files</code> menu presents a submenu of file statistics screens, including: | ||
<table class="thJustBold"> | <table class="thJustBold"> | ||
Line 760: | Line 992: | ||
<tr> | <tr> | ||
<th>File Table Usage</th> | <th>File Table Usage</th> | ||
<td>Shows file space utilization information for each open <var class="product">Model 204</var> file, broken down by table type.</td></tr> | <td>Shows file space utilization information for each open <var class="product">Model 204</var> file, broken down by table type.</td></tr> | ||
<tr> | <tr> | ||
<th>Ordered Index Usage</th> | <th nowrap>Ordered Index Usage</th> | ||
<td>Information about ordered index data density and usage.</td></tr> | <td>Information about ordered index data density and usage.</td></tr> | ||
</table> | </table> | ||
Line 769: | Line 1,001: | ||
<p>For a description of each statistic, hover the mouse over the column heading to see pop-up help.</p> | <p>For a description of each statistic, hover the mouse over the column heading to see pop-up help.</p> | ||
Locally defined screens may also be accessed from the File Monitor menu. These screens are defined by a <var class="product">SirMon</var> administrator as described in [[# | Locally defined screens may also be accessed from the File Monitor menu. These screens are defined by a <var class="product">SirMon</var> administrator as described in [[#Custom|Custom screens]]. | ||
====Users==== | ====Users==== | ||
The <code>Monitor > Performance > | The <code>Monitor > Performance > Users</code> menu presents a submenu of user statistics screens, including: | ||
<table class="thJustBold"> | <table class="thJustBold"> | ||
Line 792: | Line 1,024: | ||
<tr> | <tr> | ||
<th>Record Locking Table Usage</th> | <th nowrap>Record Locking Table Usage</th> | ||
<td>Statistics useful in determining utilization of the record locking table and highlighting poor enqueueing behaviour in applications.</td></tr> | <td>Statistics useful in determining utilization of the record locking table and highlighting poor enqueueing behaviour in applications.</td></tr> | ||
Line 810: | Line 1,042: | ||
Locally defined screens may also be accessed from the User Monitor menu. | Locally defined screens may also be accessed from the User Monitor menu. | ||
These screens are defined by a <var class="product">SirMon</var> administrator as described in [[# | These screens are defined by a <var class="product">SirMon</var> administrator as described in [[#Custom|Custom screens]]. | ||
====Subsystems==== | ====Subsystems==== | ||
The <code>Monitor > Performance > Subsystems</code> menu presents a | The <code>Monitor > Performance > Subsystems</code> menu presents a submenu of subsystem statistics screens, including: | ||
<table class="thJustBold"> | <table class="thJustBold"> | ||
Line 832: | Line 1,064: | ||
<p>For a description of each statistic, hover the mouse over the column heading to see pop-up help.</p> | <p>For a description of each statistic, hover the mouse over the column heading to see pop-up help.</p> | ||
Locally defined screens may also be accessed from the Subsystems menu. These screens are defined by a <var class="product">SirMon</var> administrator as described in [[# | Locally defined screens may also be accessed from the Subsystems menu. These screens are defined by a <var class="product">SirMon</var> administrator as described in [[#Custom|Custom screens]]. | ||
====MP Tasks==== | ====MP Tasks==== | ||
The <code>Monitor > Performance > MP Tasks</code> menu presents a | The <code>Monitor > Performance > MP Tasks</code> menu presents a submenu of task statistics screens, including: | ||
<table class="thJustBold"> | <table class="thJustBold"> | ||
Line 843: | Line 1,075: | ||
<tr> | <tr> | ||
<th>Task Performance</th> | <th nowrap>Task Performance</th> | ||
<td>Display of CPU usage, the PCPU statistic, and other statistics related to performance of <var class="product">Model 204</var> multitasking. | <td>Display of CPU usage, the PCPU statistic, and other statistics related to performance of <var class="product">Model 204</var> multitasking. | ||
</td></tr> | </td></tr> | ||
</table> | </table> | ||
Line 850: | Line 1,082: | ||
<p>For a description of each statistic, hover the mouse over the column heading to see pop-up help.</p> | <p>For a description of each statistic, hover the mouse over the column heading to see pop-up help.</p> | ||
Locally defined screens may also be accessed from the Task | Locally defined screens may also be accessed from the Task | ||
Monitor menu. These screens are defined by a <var class="product">SirMon</var> administrator, as described in [[# | Monitor menu. These screens are defined by a <var class="product">SirMon</var> administrator, as described in [[#Custom|Custom screens]]. | ||
====Janus Ports==== | ====Janus Ports==== | ||
The <code>Monitor > Performance > Janus Ports</code> menu presents a | The <code>Monitor > Performance > Janus Ports</code> menu presents a submenu of port statistics screens, including: | ||
<table class="thJustBold"> | <table class="thJustBold"> | ||
Line 861: | Line 1,093: | ||
<th>Description</th></tr> | <th>Description</th></tr> | ||
<tr> | <tr> | ||
<th>Janus SSLStat</th> | <th nowrap>Janus SSLStat</th> | ||
<td>A detailed display of the SSL activity for each combination of Janus port and network security protocol. "SSL activity" refers to <var class="product">[[Janus Network Security]]</var> encrypted communications on a Janus port whose definition includes an SSL parameter specification. Each port is listed under the <var>Portname</var> header. | <td>A detailed display of the SSL activity for each combination of Janus port and network security protocol. "SSL activity" refers to <var class="product">[[Janus Network Security]]</var> encrypted communications on a Janus port whose definition includes an SSL parameter specification. Each port is listed under the <var>Portname</var> header. | ||
<p>For details on the Janus SSL statistics, see [[JANUS_SSLSTAT_or_SSLSTATUS|Janus SSLStat]].</p> | <p>For details on the Janus SSL statistics, see [[JANUS_SSLSTAT_or_SSLSTATUS|Janus SSLStat]].</p> | ||
Line 882: | Line 1,114: | ||
=====To create a custom performance screen===== | =====To create a custom performance screen===== | ||
<ol> | <ol> | ||
<li>In the <b>Type</b> | <li>Click the <code>Monitor</code> tab.</li> | ||
<li>In the <code>Performance</code> menu, click the arrow to open the submenu, and select <code>Custom</code>.</li> | |||
<li>In the <b>Type</b> section, select the type of performance statistics that you want to use.</li> | |||
<li>In the <b>Load From</b> field, click the subsystem that you want to load from. | <li>In the <b>Load From</b> field, click the subsystem that you want to load from. | ||
<p>To start again, click Clear. | <p>To start again, click <b>Clear</b>.</p></li> | ||
In the<b>Non-Interval Statistics</b> section, click to select | <li>In the <b>Non-Interval Statistics</b> section, click one or more statistic buttons to select the statistics to be included. To see a description of each statistic, hover the mouse over the statistic button. | ||
<p>To remove a statistic from the list | <p>The selected statistics buttons will turn blue, and the buttons will be copied into the Sort order section. The statistics will be listed in the order that you select them, or you can click and drag them within the Sort order section to change their order.</p> | ||
<li>In the <b>Interval Statistics</b> section, click to select each statistic that you want to be included.</li> | <p>To remove a statistic from the list to be included, click its blue button. Or click its button in the Sort order section to show a Remove Stat menu item. Click Remove Stat. To cancel the removal, click away from Remove Stat. </p></li> | ||
<li>To save as an ad hoc listing, click Save as Adhoc. The listing will be saved to "Adhoc for <var class="term">username</var>."</li> | <li>In the <b>Interval Statistics</b> section, click to select each statistic that you want to be included. | ||
<li>To save under a report type, click Save.</li> | <p>Most statistics viewable as rates (interval statistics) can alternatively be displayed as totals. To view a statistic as a total, click its button in the Sort order section and select <b>Set as Total (#)</b>. The statistic name on the button appears with # appended to show it is a total. To undo, click the button again and select <b>Clear Total (#)</b>.</p></li> | ||
<li>To run the report, click <b>Run</b>. On the report screen that appears, hover the mouse over each statistic name to display pop-up help. Click <b>Refresh</b> to run the report again.</li> | |||
<li>To save as an ad hoc listing, click <b>Save as Adhoc</b>. The listing will be saved to "Adhoc for <var class="term">username</var>."</li> | |||
<li>To save under a report type, click <b>Save</b>.</li> | |||
</ol> | </ol> | ||
===Journal Scan=== | ===Journal Scan=== | ||
The <code>Journal Scan</code> menu link brings up the RKWeb journal scanner, a high-performance utility similar to the TN3270 interface of [[SirScan]]. The journal scanner allows users in a <var class="product">Model 204</var> Online to browse the contents of its [[Tracking system activity (CCAJRNL, CCAAUDIT, CCAJLOG)#Overview of the journal data sets|journal]] in real time. To use the journal scanner, you must have a license to use the SIRSCAN subsystem. | |||
ADMIN SCLASS users of the RKWEB subsystem can view the current Online journal entries or browse the content of archival journals (by DDname, if they are allocated to the Online as sequential files). The data is displayed on the web page with powerful searching commands, including filtering and display options. | |||
The <b>Model 204 | The <b>Model 204 journal scan</b> form supports the same input as shown for SirScan (see [[SirScan scan specification|journal scan specifications]]). | ||
< | ====To run a journal scan==== | ||
<ol> | |||
<li>Click the <code>Monitor</code> tab.</li> | |||
<li>In the <code>Monitor</code> menu, click <code>Journal Scan</code>.</li> | |||
<li>On the Model 204 journal scan form, enter the desired [[SirScan scan specification#Screen input fields|field values]]. | |||
<p>Click the red plus or minus sign icon to toggle between a minimized set of request options (start time and users only) and an expanded set of options.</p></li> | |||
<li>Click <b>Submit journal request</b> to see the journal entries.</li> | |||
</ol> | |||
===Command processor=== | ===<b id="com_proc"></b>Command processor=== | ||
With the command processor, you can run any [[Category:Commands|Model 204 command]] that your user role has permissions for. | With the command processor, you can run any [[:Category:Commands|Model 204 command]] that your user role has permissions for. | ||
====To run a Model 204 command==== | ====To run a Model 204 command==== | ||
<ol> | <ol> | ||
<li>Click the <code>Command processor</code> link to open the Model 204 command interface.</li> | <li>Click the <code>Command processor</code> link to open the Model 204 command interface.</li> | ||
<li>Enter any command as you would on a Model 204 command line, such as <code>VIEW ALL</code>, then click <b>Submit</b> to run it.</li> | <li>Enter any command as you would on a Model 204 command line, such as <code>VIEW ALL</code>, then click <b>Submit</b> to run it.</li> | ||
<li>To see the command history, click <b>Show stack</b>. You can edit the stack by deleting unwanted commands and clicking <b>Save stack</b>.</li> | <li>To see the command history, click <b>Show stack</b>. You can edit the stack by deleting unwanted commands and clicking <b>Save stack</b>.</li> | ||
</ol> | </ol> | ||
==RKWeb | ==RKWeb security== | ||
<p>RKWeb is implemented as a single application subsystem (APSY) and provides access to each of its Model 204 components as appropriate, based on your site's products and your user permissions.</p> | <p>RKWeb is implemented as a single application subsystem (APSY) and provides access to each of its Model 204 components as appropriate, based on your site's products and your user permissions.</p> | ||
<ul> | <ul> | ||
<li>Some RKWeb components are purchased as individual products and are not included in the Model 204 core. Those products are only available at sites that own them.</li> | <li>Some RKWeb components are purchased as individual products and are not included in the Model 204 core. Those products are only available at sites that own them.</li> | ||
<li>Some components, such as SirScan, check that your site owns the underlying product and verify user access by SCLASS. Other features, such as LOGCTL access, require the same UPRIV as at command level (typically System Manager or System Administrator).</li> | <li>Some components, such as SirScan, check that your site owns the underlying product and verify user access by SCLASS. Other features, such as LOGCTL access, require the same UPRIV as at command level (typically System Manager or System Administrator).</li> | ||
</ul> | </ul> | ||
Line 925: | Line 1,167: | ||
<p>Privileges for the Command processor are handled as they are on the command line: you can run any commands that you have permissions for.</p> | <p>Privileges for the Command processor are handled as they are on the command line: you can run any commands that you have permissions for.</p> | ||
<p>For details on configuring RKWeb | <p>For details on configuring a secure web port for RKWeb, see [[RKTools installation#Additional setup for RKWeb|RKWeb installation]].</p> | ||
==Where's my RKTools 3270 functionality?== | ==Where's my RKTools 3270 functionality?== | ||
Want to use the RKWeb interface but looking for the familiar RKTools functionality? | Want to use the RKWeb interface but looking for the familiar RKTools functionality? | ||
<p>The following table maps each RKWeb menu item to the existing RKTools 3270 interface.</p> | <p>The following table maps each RKWeb menu item to the existing RKTools 3270 interface. Be aware that not all the functionality present in each product's 3270 screens is reproduced in RKWeb.</p> | ||
<p>The <b>Available to...</b> column shows which product you must own in order to access a specific component. "Model 204 Core" functionality is available to all users with proper permissions.</p> | <p> | ||
The <b>Available to...</b> column shows which product you must own in order to access a specific component. "Model 204 Core" functionality is available to all users with proper permissions.</p> | |||
<table> | <table> | ||
<tr><th>RKTools 3270</th><th nowrap>RKWeb component > menu item</th><th>Available to...</th></tr> | <tr class="head"><th>RKTools 3270</th><th nowrap>RKWeb component > menu item</th><th>Available to...</th></tr> | ||
<tr><td> | |||
<tr><td>CREATE GROUP command, <br />SirPro</td><td>Manage > Group Definitions</td><td>Model 204 Core</td></tr> | <tr><td>Model 204 command line, SirPro command processing</td><td nowrap>Build, Manage, Monitor > Command processor</td><td>Model 204 Core</td></tr> | ||
<tr><td>Dictionary/204</td><td>Manage > Dictionary</td><td>Model 204 Core</td></tr> | |||
<tr><td> | <tr><td>CREATE GROUP command, <br />SirPro</td><td>Manage > Group Definitions</td><td>Model 204 Core</td></tr> | ||
<tr><td nowrap>LOGCTL/LOGADD commands, <br />SirPro</td><td>Manage > Passwords</td><td>Model 204 Core</td></tr> | |||
<tr><td>Dictionary/204</td><td>Manage > Dictionary</td><td>Model 204 Core</td></tr> | |||
<tr><td>JANSSL</td><td>Manage > SSL Certificates</td><td>Janus Network Security owners</td></tr> | |||
<tr><td nowrap>LOGCTL/LOGADD commands, <br />SirPro</td><td>Manage > Passwords</td><td>Model 204 Core</td></tr> | |||
<tr><td>SirFact</td><td nowrap>Build > Fact Dump Analysis</td><td>SirFact owners</td></tr> | <tr><td>SirFact</td><td nowrap>Build > Fact Dump Analysis</td><td>SirFact owners</td></tr> | ||
<tr><td>SirLib</td><td>Build > Configure</td><td>SirLib owners</td></tr> | <tr><td>SirLib</td><td>Build > Configure</td><td>SirLib owners</td></tr> | ||
<tr><td>SirMon</td><td>Monitor > Performance</td><td>SirMon owners</td></tr> | |||
<tr><td>SirMon</td><td>Monitor > Performance</td><td>SirMon owners</td></tr> | |||
<tr><td>SirScan</td><td>Monitor > Journal Scan</td><td>SirScan owners</td></tr> | <tr><td>SirScan</td><td>Monitor > Journal Scan</td><td>SirScan owners</td></tr> | ||
<tr><td>SirTune Reports</td><td>Build > Tune Reports</td><td>SirTune owners</td></tr> | <tr><td>SirTune Reports</td><td>Build > Tune Reports</td><td>SirTune owners</td></tr> | ||
<tr><td>SoulEdit</td><td>Build > Edit</td><td>SirPro owners</td></tr> | <tr><td>SoulEdit</td><td>Build > Edit</td><td>SirPro owners</td></tr> | ||
<tr><td> | |||
<tr><td>Subsystem Management</td><td>Manage > Subsystem Management</td><td>Model 204 Core</td></tr> | |||
</table> | </table> | ||
</div> <!-- end of toc limit div --> | |||
[[Category: RKTools]] |
Latest revision as of 19:30, 25 September 2017
Overview
The RKTools 7.7 release is comprised of the RKTools subsystems, Dictionary/204, and RKWeb.
- The RKTools subsystem provides access to all TN3270-based RKTools (formerly UL/SPF tools).
- Dictionary/204 is available from the TN3270 interface, the RKTools menu, or from RKWeb.
- RKWeb provides an easy-to-use web interface to almost all of the RKTools and Dictionary components.
RKWeb harnesses most of the Rocket M204 tools in a common framework, providing a highly productive web interface to common Model 204 functions. RKWeb is mobile-friendly, enabling you to perform most Model 204 operations from your smartphone or other mobile device.
All existing security and product ownership is honored in the RKWEB subsystem — for instance, an interface is provided for managing group definitions and passwords, but the option is only available to RKWEB subsystem ADMIN SCLASS users that have System Administrator login privileges.RKWeb requires Janus Web Server and Model 204 version 7.6 or later. See RKWeb installation for more information. For sites that do not own Janus Web, a Limited Janus Web capability is included that allows a restricted number of web threads to use RKWeb.
RKWeb provides a task-based UI for SOUL application development. Tasks are divided into three functional areas: Build, Manage, and Monitor. The Command processor is available in each functional area.
Build
The Build
menu provides these options for building your application:
- Edit procedures (Edit)
- Configure change management for procedures (Configure)
- Analyze dump files (Fact Dump Analysis)
- Tune procedure performance (Tune Reports)
- Run Model 204 commands (Command processor)
Edit
The Build > Edit
menu option enables you to edit procedures within Model 204 files.
Note: You must enable pop-ups in your browser to edit a procedure (it is opened in a separate window).
RKWeb editor
The editor provided with RKWeb is based on the open-source Ace editor.
The RKWeb editor:
- Works with all SOUL code and other code stored in M204 procedure files.
- Uses color coding in SOUL or JavaScript programs to highlight items such as function names, parameters, and labels.
- Respects Model 204 security, allowing users to see, browse, and/or edit only the procedures that they would have permission to see, browse, or edit in 3270.
- Is available to all Model 204 owners.
The RKWeb editor enables you to perform basic editing tasks such as search and replace, skip words, insert and delete lines, Undo, and so on. For a list of default keyboard shortcuts in the Ace editor, see Default keyboard shortcuts.
To edit a procedure
Note: Pop-ups must be enabled to use this feature.
- Click the
Build
tab. - In the
Build
menu, clickEdit
. - If needed, click the Open Procedure List button.
- The Edit tool fetches a list of procedures in the current file. The list appears in a new window (or tab).
- To filter the list of procedures:
- Enter a string in the Filter field, such as
shared
orEDITOR
. (Case-sensitivity of the string is set in the Procedure List Settings dialog box.) - Enter a number of hours in the Age(hours) field to filter the list by the age of the procedures.
- Press Enter or click List to refresh the list of procedures. To see the original unfiltered list, delete the criteria from the Filter and Age(hours) fields and press Enter or click List.
- Enter a string in the Filter field, such as
- Click a procedure name to open that procedure in a new window (or tab) and edit it in the RKWeb editor.
- After editing, click Save and close the window to return to the procedure list window.
- Close the procedure list window to return to the RKWeb main screen.
To view a different file, enter a name in the File field. If the file is password-protected, enter a password in the Password field. Then click the List button.
To customize the procedure list settings
- Click the Settings icon in the upper right corner of the screen.
In the Procedure List Settings dialog box, you can customize the following Procedure List settings:
- Hiding of BASE.* and SEQ.* type procedures
- Font size
- Case sensitivity of procedure name Filter field
- Double-clicking (vs. single-clicking) to open a procedure
- Procedure colors:
- Background color of the Procedure List toolbar.
- Color of an open procedure.
Enter a color name, such as
red
, or its hexadecimal code, such as#FF0000
, or its rgb value,
such asrgb(255,0,0)
.
- Click Save to save your changes.
Configure
The Build > Configure
option is available to SirLib owners who are RKWEB subsystem ADMIN SCLASS users. It enables you to configure and administer change management for SOUL procedures residing in Model 204 procedure files.
To use SirLib change control
- Click the
Build
tab. - In the
Build
menu, clickConfigure
.This opens the SirLib Configuration and Change Control System.
SirLib functionality is provided as a Janus legacy application, operating outside the RKWeb menu framework. When you click the
Configure
menu option, a new window (or tab) opens, leaving your original RKWeb session in place in the original window (or tab).Note: These Janus Legacy applications are not fully integrated with RKWeb, so you must use the security configured for those applications. For instance, FILEMGMT is implemented as Janus Legacy, and it might prompt you for a separate password.
- Enter an action number to choose a menu option from the
Configuration and Change Control System
menu.The Target file field, Fixes File field, and menu options are the same as on the SirLib main menu.
Menu number Item Enables you to... 1 Project Definition List Add, delete, or change the project identifiers in the FixFile assigned to a managed file. 2 Apply changes (Reconfigure a file) Apply file updates. 3 Administration (specify a file or use default) Administer system and file profiles. 4 Security (specify a file or use default) Set SirLib security settings. 5 Cutover Clean up and stabilize projects. Release cutover returns a managed file to a pre-managed state, but with all existing updates applied. 6 Reports Run a SirLib report on Change History, Configuration, or Problem tracking. 7 View/Clear Procedure Locks (ADMIN users only) See procedures that are currently checked out. - When you have performed all desired tasks, close the window to return to your RKWeb session.
Fact Dump Analysis
The Fact Dump Analysis
menu item provides a UI to the SirFact FACT subsystem, enabling you to analyze a diagnostic dump by selecting a dump file and its procedure that contains the dump. You can then choose which data to display.
Note: Your site must own SirFact and you must be an RKWEB subsystem SCLASS user in order for you to use Fact Dump Analysis.
To select and analyze a diagnostic dump
- Click the
Build
tab. - In the
Build
menu, clickFact Dump Analysis
. - Click
Select
from the submenu.In the File field, enter a dump file name. The SirFact dump selection screen displays a list of procedures in the selected dump file.
To choose a different file, enter its name in the File field and click Switch file.
- Click a procedure name to analyze its dump information with the SirFact FACT subsystem.
The screen displays basic information extracted from the dump: default context information for the error condition such as a date/time stamp, source procedure and file, user ID of the user for whom the error occurred, and so on.
Enter SirFact commands to extract additional information, which is appended to the information on the screen:
- To view the context where an error occurred, enter the
Context
SirFact command, with an information context, in the Command field and click Send query.The valid information contexts are:
* (asterisk) Switches FACT context to the mainline of the executing program. . (period) Switches to whichever context the program was in at the time of the SirFact error. subroutine-name Switches to the context of the named complex subroutine. Simple subroutines are not valid contexts, as they share the same context as the main body of the program. - To display specific data from the dump, such as attributes, For Each Record loop fields, lists, and so on, enter the Display SirFact command and its parameters in the Command field and click Send query.
- To view the context where an error occurred, enter the
Tune Reports
The Tune Reports
menu item enables you to produce a listing of one or more SirTune reports, which you can use to tune problem areas in an Online.
Note: The Tune Reports
menu item is a quick way to generate SirTune reports that you have already configured. It is assumed that you are familiar with configuring and running SirTune reports. For more information, see SirTune report configuration. Tune Reports
is available to all owners of SirTune that are RKWEB subsystem ADMIN SCLASS users.
To produce a report
- Click the
Build
tab. - In the
Build
menu, clickTune Reports
. - Select Procedure or Dataset to choose either a procedure or data set report.
- For Procedure:
In the SirTune input section, enter the File, Procedure, Data Source, and Volume (if desired).
- For Dataset:
In the SirTune input section, enter the Configuration file name and Volume (if desired) and Data Source and Volume (if desired).
- For Procedure:
- In the SirTune Output section, select Page to see the report on your screen, or select Dataset and enter the Dataset name and Volume (if desired).
- Click Generate to generate the report.
Manage
The Manage
menu contains options to manage your applications, files, and user logins:
- Define applications that run under the Application Subsystem facility (Subsystem Management)
- Manage your procedures, files, and subsystems (Dictionary)
- Maintain Model 204 passwords (Passwords)
- Manage Model 204 group definitions (Group Definitions)
- Manage SSL certificates (SSL Certificates)
- Run Model 204 commands (Command processor)
Subsystem Management
The Subsystem Management menus enable you to define user-written applications that run under the Application Subsystem facility (APSY).
A subsystem is an application consisting of a collection of procedures, files, and assigned characteristics that are defined as a subsystem to Model 204 through the Subsystem Management interface. RKWEB's Subsysmgmt is available to RKWEB subsystem ADMIN SCLASS users who have System Administrator login privileges.
Procedure
Enter specifications for subsystem procedures on the Procedure screen.
To create specifications for a subsystem procedure
- Click the
Manage
tab. - In the
Subsystem Management
menu, click the arrow to open the submenu, and selectProcedure
. - Enter a name in the Subsystem field and press Enter.
- If the subsystem does not exist, a message appears. Click the icon beside the Subsystem field and select Create.
- The item appears in the display, with its fields populated with default values. The item is now created and will be available in the Subsystem list.
- Edit the procedure prefixes as desired.
- Edit the procedure names as desired.
- Edit the global variables as desired.
- If you have made any edits, click the Save number Updates button.
To rename specifications for a subsystem procedure
- Click the
Manage
tab. - In the
Subsystem Management
menu, click the arrow to open the submenu, and selectProcedure
. - Select an item in the Subsystem drop-down list.
- Click the icon beside the Subsystem field and select Rename.
- In the Rename Subsystem pop-up, enter the new subsystem name in the To field and click Confirm Rename.
- The renamed item appears as the selected subsystem.
To copy specifications for a subsystem procedure
- Click the
Manage
tab. - In the
Subsystem Management
menu, click the arrow to open the submenu, and selectProcedure
. - Select an item in the Subsystem drop-down list.
- Click the icon beside the Subsystem field and select Copy.
- In the Copy Subsystem pop-up, enter the new subsystem name in the To field and click Confirm Copy.
- The new copy appears as the selected subsystem.
To delete specifications for a subsystem procedure
- Click the
Manage
tab. - In the
Subsystem Management
menu, click the arrow to open the submenu, and selectProcedure
. - Select an item in the Subsystem drop-down list.
- Click the icon beside the Subsystem field and select Delete.
- In the Delete Subsystem pop-up, click Confirm Delete.
- The item disappears from the display and the subsystem list.
Operational
Operating options affect certain aspects of the overall behavior of a subsystem. Define and maintain them using the Operational
menu options.
To specify subsystem operating options
- Click the
Manage
tab. - In the
Subsystem Management
menu, click the arrow to open the submenu, and selectOperational
. - In the Subsystem field, select a subsystem name from the drop-down list.
- Set the operating options as needed.
The following table summarizes the operating options and what they specify when enabled. For more details, see operating options.
Operating option field Description Status Specifies the level of availability of the subsystem to users. Auto Start Automatically starts the subsystem when the first user enters the subsystem name. Lock File/Group Subsystem files and groups are available only to users running in the subsystem after the subsystem is started. Log user into M204 The user is logged out of Model 204 and then logged back in to Model 204 with the subsystem name as the user ID when entering the system. Log user out of M204 The user is automatically logged out of Model 204 upon exiting the subsystem. Auto Commit A SOUL COMMIT statement is executed by Model 204 at each procedure END in the subsystem during execution. Maximum Iterations The maximum number of consecutive times the same procedure can be invoked. Account An account value that overrides the login account. The original value is restored when the user exits the subsystem. Privileges (in hex) A user's privileges while in the subsystem. Privileges specified before logging into the subsystem are overridden. Start Login privileges (in hex) Controls login privileges while starting a subsystem. If specified, Start Login Privileges overrides both the user's previous privileges and other privilege fields in the subsystem definition. Subsystem can access Remote Files For use with Parallel Query Option/204 (PQO) applications; allows application subsystem definitions and requests to refer to remote files. Message Display Options Check the boxes to display Disconnect, informational, and/or error messages for subsystem users. - Click the Save number Updates button.
Files
The Files menu item enables you to define the files, including the procedure file, used by the subsystem.
To create or update a file specification
- Click the
Manage
tab. - In the
Subsystem Management
menu, click the arrow to open the submenu, and selectFiles
. - Select a subsystem from the drop-down list beside the Subsytem field.
- On the Files screen, enter the file specifications in each field.
- Click the Save number Updates button.
System Classes
You define command and file privileges for each class of subsystem users on the System Classes screen. Each class of user requires a separate screen. User class privileges defined to the subsystem override settings for OPENCTL and file privileges that reside in the password table.
To create a system class
- Click the
Manage
tab. - In the
Subsystem Management
menu, click the arrow to open the submenu, and selectSystem Classes
. - On the System Classes screen, select a subsystem from the drop-down list beside the Subsytem field.
- In a semi-public subsystem, the first class is automatically assigned the class name DEFAULT. To change the name, double-click the name DEFAULT and type in the new name, which can be up to eight characters long.
- In the Command Privileges section, check the box beside each subsystem command that you want the user class (SCLASS) to be able to issue. Debug specifies entering the subsystem in DEBUG mode.
- If you are a system manager, you can update the fields in the Login Privileges section.
- Login is optional and specifies the user class login privileges for all, some, or none of the subsystem user classes.
Any individual user login privilege held at entry to the subsystem or specified on the Operational Parameters screen is overridden. The original value is restored when the user exits the subsystem.
Enter a hexadecimal value within the range of X'00' to X'FF', as described in PRIVDEF parameter settings.
NULL
indicates default privileges from the Operational Parameters screen. - Record Security ID is optional and overrides any individual user record security ID held on entry to the subsystem. You can enter a maximum of eight characters.
NULL
indicates the security activated on login.The original value of the record security ID is restored when the user exits the subsystem.
- Account is optional and specifies an account associated with specific user classes. The account can be specified for all, some, or none of the user classes. You can enter as many as ten characters.
Any individual value of Account held at entry to the subsystem or specified on the Operational screen is overridden. The original value is restored when the user exits the subsystem.
NULL indicates the user's login account or the value from the Operational screen.
- Login is optional and specifies the user class login privileges for all, some, or none of the subsystem user classes.
- In the File Privileges section, set privileges for the files or groups that can be accessed by the defined class of users.
This section displays the names of files or groups that you defined for this subsystem on the File Use screen. For each file, you can define the following privileges:
- Prcldef specifies Model 204 procedure security. Values must be between 0 (default) and 255, where 0 specifies no procedure security and 255 specifies the highest security.
- Privileges specifies file privileges. Values are hexadecimal 0 to X'BFFF' (default).
- Select Level, Read Level, Update Level, and Add Level specify values for field-level security parameters. Values must be between 0 (default) and 255, where 0 specifies that all users can access field values, and 255 restricts access of field values to users having certain privileges.
- When done defining the system class, click the Save number Updates button.
To add or delete another system class
- Click the plus sign icon beside the titles of the existing system classes (such as DEFAULT).
- A new title, CLASSx, appears. (As each new class is added, x is incremented by 1.) Click the title field to enter a different name, up to eight characters long.
- Fill in the fields as described above.
- To delete the class, click the trash can icon beside its name.
To view users
- Click the
Manage
tab. - In the
Subsystem Management
menu, click the arrow to open the submenu, and selectUsers
. - On the Users screen, select a subsystem from the drop-down list beside the Subsytem field.
- The list of users appears.
Dictionary
Dictionary/204 functionality is provided as a Janus legacy application.
The Dictionary
links provide convenient access to the existing 3270 Dictionary/204 screens.
RKWeb provides the following Dictionary
submenu items:
Administration
— Brings up the Administration Facility main menu.Documents
— Brings up the Documentation Facility main menu.Reports
— Brings up the Reports main menu.Xref
— Brings up the Cross-reference selection screen.File Management
— Brings up the File Management primary screen.SQL Catalog Reports
— Brings up the SQL Catalog Reporting Facility main menu.Table Specifications
— Brings up the Table Specification Facility main menu.
When you click each link a new tab opens. The Dictionary components operate outside the RKWeb menu framework, leaving your original session in place in the original tab. When your Dictionary session is finished, you can simply close the tab to return to your RKWeb session.
Administration
The Dictionary Administration Facility screen, available to administrators, contains a menu with the following options:
Entity Type Maintenance
. Enables you to define, update, or delete a Dictionary entity type.Path Maintenance
. Enables you to display, add, update, or delete a Dictionary path definition.Facility Administration
. Enables you to:- Add, delete, or rename procedure names on a list of user-written procedures that produce reports
- Determine command options and setting defaults for the File Management facility
Security Administration
. Enables you to specify the privileges of Dictionary/204 users.Inventory Report
. Enables you to produce a report covering the entire contents of the dictionary. This facility reports on the attributes and references of all entries of each entity type.Note: The processing time required to produce the dictionary inventory can be quite long, depending upon the complexity and number of dictionary entries.
Documents
The Documents facility provides an interface for defining and describing attributes and relationships that are not controlled by the system or by one of the other facilities listed on the Dictionary/204 main menu.
The Dictionary Document Facility
screen contains a menu with the following options:
Add an Entry
. You can add an entry for an entity type that is either a VIEW or an entity type created by your installation through the Dictionary Administration facility, for example, REPORTs, USERs, and so on. You cannot add entries managed by other Dictionary/204 facilities (such as FILE and PROCEDURE entries).Update an Entry
. You can update an entry of any entity type. You can change only the attributes and relationships that are not managed by another Dictionary/204 facility.Updating also allows you to create dummy entries.
Delete an Entry
. You can delete an entry for either a VIEW or an entity of a type defined at your installation through the Dictionary Administration facility. You cannot delete entries managed by another Dictionary/204 facility.Copy an Entry
. You can copy an entry for an entity type that is either a VIEW or an entity type created by your installation. You cannot copy entries that are managed by another Dictionary/204 facility.Rename an Entry
. You can rename an entry for an entity type that is either a VIEW or an entity of a type created by your installation, such as REPORT, USER, and so on. You cannot rename entries manages by another Dictionary/204 facility.
Reports
Dictionary/204 provides online interfaces for querying and reporting on the entries in the dictionary. The reports can include:
- All the attributes and relationships for a given entry
- List of all of the entries for a given type of entity — all SCREENs, all FILEs, and so on
- Entries selected by name, entity type, relationship with another specified entry, or specific keywords
To run Dictionary reports:
- Select
Manage > Dictionary > Reports
from the main menu. - On the Dictionary Reports Main Menu that appears, select an option:
Display an Entry
Displays the attributes and/or relationships (or references) for an entry of a specified entity type.
List Entries of an Entity Type
Displays a list of entries of one or several entity types. For example, the names of all the files, all the procedures, and so on.
Display Cross-References for an Entry
Displays relationships between entries based on cross-references only. You can search all entries or only entries of a particular entity type.
Display Named References for an Entry
Displays relationships between entries based on named references only. You can search all entries or only entries of a particular entity type.
Named references are unidirectional and take the form A ===> B; however, Dictionary/204 also allows you to search for entries that are related to B (including A).
Display All References for an Entry
Displays any relationship between entries including cross-, named, or path (indirect) references.
Browse Entries by Attributes
Browses through entries selected by the value of their KEYWORD attribute, the UNQUALIFIED NAME attribute, or optionally browsing entries selected by the value of specific standard attributes.
You can restrict browsing to a single entity type or browse all the dictionary entries, regardless of entity type.
Select User-Written Report
Select a report that has been customized by the Dictionary administrator.
Xref
The Dictionary cross-reference facility produces a cross-reference report for procedures in a selected file or group. The report shows the line numbers where language elements such as labels, functions, and variable names occur.
- From the main menu, select
Manage > Dictionary > Xref
. - On the Dictionary cross-reference screen, select the procedure file or group that you want to cross-reference.
- In the Report Options list, select the SOUL elements to be included in the report, or select All.
- On the "Expand INCLUDEs" line, enter Y or N. If you select Y, then the Cross-Reference facility scans every INCLUDE command or statement in your procedure, searches for the included procedures or subroutines, and cross-references all included code that is found.
- In the procedure selection criteria section, specify procedure names or patterns:
- Enter
N
to use procedure names. You can enter several procedure names on the same line by separating the names with semicolons or any number of spaces. For example, the following line is recognized as a valid request to process three procedures:BILLSYS.PROC1;BILLSYS.PROC2 BILLSYS.PROC3
- Enter
P
to use a pattern. This informs the Cross-Reference facility that you want to use pattern-matching rules.For example, enter
BILLSYS*
to generate a report for all procedures in the selected file that begin with the string BILLSYS.
- Enter
File Management
The Dictionary/204 File Management Subsystem facility, FILEMGMT, enables you to create Model 204 files quickly, reliably, and securely. You define a file and its contents on the series of screens that FILEMGMT provides. FILEMGMT uses your definitions to:
- Construct the Model 204 commands that create the physical file
- Store the appropriate entries in your installation's dictionary
By combining the two operations, FILEMGMT eliminates the need to enter this information twice. FILEMGMT validates the information for accuracy and consistency, and it creates and stores all necessary dictionary entries and references.
FILEMGMT does more than create new files. You can use the facility to:
- View existing file data
- Reset file parameters
- Add fields, records, and field groups to existing files
- Calculate and change the size of a file
- Copy files, fields, and records
To invoke FILEMGMT:
- Select
Manage > Dictionary > File Management
from the main menu.The FILEMGMT primary screen appears.
- In the Filename field, enter the name of the file that you are working with.
- In the prefix box beside a category (File, Field, Record, or Field Group), enter the number corresponding to the action you want to perform.
The categories are as follows:
File maintenance |
Creates a new Model 204 file, determines the size of a file, recreates or modifies the parameters of an existing file, deletes or copies a file, and performs other file maintenance functions. |
Field maintenance |
Defines fields for a new or existing file, changes existing field names or attributes, and performs other field maintenance functions. |
Record maintenance |
Defines records for a new or existing file, changes existing record names or characteristics, and performs other record maintenance functions. |
Field Group maintenance |
Defines field groups for a new or existing file, changes existing field group names or contents, and performs other field group maintenance functions. |
SQL Catalog Reports
The CCACATREPT subsystem is a reporting mechanism for data in the CCACAT SQL catalog file. CCACATREPT is a menu-driven utility that produces both online and printed output. With CCACATREPT you can produce a report that provides information about all SQL objects defined in the SQL catalog.
Catalog administrators can compare the CCACATREPT output to the Model 204 file data to determine the updates they need to make to the SQL catalog to obtain consistency with the file. They can modify the report's generated DDL and use it to repopulate the SQL catalog. SQL application programmers and SQL users can use the output to verify valid table, view, column names and column attributes.
In the Selection field, specify the number of the type of report that you want to generate:
- File of valid DDL syntax, which you can use to rebuild the catalog
- Fixed format report of a table or view
- Privilege report by table or view name
- Privilege report by user
Fill in the fields as needed for each report:
Field | Used in report type... | Value | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Schema Name | 1,2, or 3 | Enter the name of a specific schema or enter an asterisk (*) for all schemas.
If your Selection field entry requires an entry for this field and you do not enter a value, by default CCACATREPT outputs all schemas. | ||||||||||
Authorization ID | 1 or 2 | Enter the name of a specific authorization ID or enter an asterisk (*) for all authorization IDs.
If your Selection field entry requires an entry for this field and you do not enter a value, by default CCACATREPT outputs all authorization IDs. | ||||||||||
Table View/Name | 1, 2, or 3 | Enter the name of a specific table or view to be reported or enter an asterisk (*) for all tables and views.
If your Selection field entry requires an entry for this field and you do not enter a value, by default CCACATREPT outputs all tables and views. | ||||||||||
DDL Statement Type(s) | 1 | The output from Selection 1 is standard SQL DDL generated from the Model 204 SQL catalog. In the DDL Statement Type(s) field, you identify the DDL statement types to be generated.
Select one or more of the following identifiers:
If your Selection field entry requires an entry for this field and you do not enter a value, by default CCACATREPT outputs all the DDL. | ||||||||||
Grantee | 4 | Enter the SQL identifier of a specific grantee to be reported or enter an asterisk (*) for all grantees. Privileges granted to PUBLIC are always reported.
If your Selection field entry requires an entry for this field and you do not enter a value, by default CCACATREPT outputs privileges for all grantees. | ||||||||||
"USE" Command Arg | All | Use this field to route output to a destination other than to the terminal. The character string you enter in this field becomes the Model 204 USE command argument that identifies the output destination device.
You can enter any USE command argument that is valid in your operating environment, for example, For more details, see "USE" Command Arg. |
Table Specifications
The Model 204 SQL Table Specification facility (TSF) enables you to create a new SQL table by mapping a Model 204 file. TSF is not used to modify existing tables.
TSF looks at an existing Model 204 file, reads its field names and their attributes, and allows you to specify how to map the file to an SQL table. The TSF provides an interactive, menu-driven facility that generates a subset of DDL statements based on your specifications. You can use the generated DDL as input to the CVI utility to define your SQL table to the SQL catalog.
The following table summarizes the values to be entered on the main screen. For details, see Creating or modifying a base table (Main Menu panel).
Unless otherwise noted, you must enter a value for each field.
Field | Value |
---|---|
Schema Authorization | Authorization ID (default is the Model 204 login user ID) |
Table Name | The name of the SQL table that you are defining. Multiple nested tables are allowed. |
Schema Name | The SQL schema name as you want it to appear in the CREATE SCHEMA statement. (If left blank, Schema Name defaults to the authorization ID specified for Schema Authorization.) |
Model 204 File Name | The name of the Model 204 file that you want defined as an SQL table. |
Password | If applicable, enter the passowrd that gives the user the authority to read the file and all the field names that will be used as columns in the SQL table. |
Table Type | The table type: B (Base), P (Parent), or N (Nested). |
Primary Key | If the table type is P (Parent) or N (Nested), enter the value for the primary key. |
Parent Table | If the table type is N (Nested), enter the name of the SQL table that each nested table references. |
Passwords
Clicking the Manage > Passwords
menu item enables you to use the SirPro password functionality to maintain passwords in CCASTAT. The Passwords interface is available to RKWEB subsystem ADMIN SCLASS users who have System Administrator privileges.
When viewing passwords for users, files, or groups, click a column header (such as Privileges) to sort the entries by that header.
Click the information icon (the letter i in a red circle) at the right of the screen to see the current values of the parameters that affect the password settings. Click the link to the Model 204 wiki to get to detailed parameter information.
Users
From the Users
menu, you can add, change, or delete login user ID entries in the password table.
To add a user ID
- Click the plus sign icon beside the Model 204 User Passwords header.
- In the Add userid to CCASTAT dialog box that appears, enter the user ID, which can be one to ten characters long.
- In the Password field, enter the password. The password cannot contain commas and must be one to eight characters long. For more information on mixed-case passwords and Password Expiration, see LOGCTL for user ID entries.
- Re-enter the password in the Verify Password field.
- In the Privileges field, click the search icon beside the field and select from a checklist of privileges.
- In the Priority field, choose a user priority from the drop-down list.
- In the Terminals field, leave the default of ALL if your installation does not use terminal security features. Otherwise, enter the number of a terminal from which a user can issue a LOGIN command for this user ID.
- Click the Save updates button. The information is immediately committed to CCASTAT.
- Press F5 to refresh the screen and verify that the new user ID is listed.
To change a User ID
- Click the icon to the left of the user ID that you want to change.
- Select Change from the pop-up menu that appears.
- In the Change user password or logon settings dialog box, change the user id, password, verify password, priority, privileges, and/or terminals.
- Click the Save updates button. The information is immediately committed to CCASTAT.
To delete a user ID
- Click the icon to the left of the user ID that you want to delete.
- Select Delete from the pop-up menu that appears.
- In the Delete User pop-up that appears, click Confirm Delete. The information is immediately deleted from CCASTAT.
- Press F5 to refresh the screen and verify that the user ID has been removed from the list.
Files
From the Files
menu, you can add, change, or delete file entries in the password table.
To add a file password
- Click the plus sign icon beside the Model 204 File Passwords header.
- In the Add File entry to CCASTAT dialog box that appears, enter the name, password, and privileges for the file. Hover over each field for pop-up help. For details on acceptable values, see LOGCTL for file entries.
- In the File name field, enter the File name, which can be 1-8 characters long and must start with a letter.
- In the Password field, enter the password. The password cannot contain blanks, commas colons, or the LINEEND character. It must be 1 to 8 characters long.
- Re-enter the password in the Verify Password field.
- In the Privileges field, click the search icon beside the field and select from a checklist of privileges.
- In the Index field, specify a single index character (a digit 0-9 or a letter A-Z). An index is required when a file has more than one password; it is used to differentiate entries for future changes or deletions.
- In the User class field, enter the number of the user class that can access the file.
- In the Select Privs, Read Privs, Update Privs, and Add Privs fields, enter the three-digit field-level security for Select, Read, Update, and Add privileges.
- In the Terminals field, leave the default of ALL if your installation does not use terminal security features. Otherwise, enter the number of a terminal from which a user can issue a LOGIN command for this user ID.
- Click the Save updates button. The information is immediately committed to CCASTAT.
- Press F5 to refresh the screen and verify that the new file entry is listed.
To change a file password or logon settings
- Click the icon to the left of the file ID that you want to change.
- Select Change from the pop-up menu that appears.
- In the Change file password or logon settings dialog box, change the Password, general Privileges, User class, Select/Update/Read/Add privileges, and/or Terminals. For information on acceptable values, see LOGCTL for file entries.
Tip: To change general Privileges, click the search icon beside the field to bring up a checklist of privileges.
- Click the Save updates button. The information is immediately committed to CCASTAT.
To delete a file
- Click the icon to the left of the File that you want to delete.
- Select
Delete
from the pop-up menu that appears. - In the Delete File pop-up that appears, click Confirm Delete. The information is immediately deleted from CCASTAT.
- Press F5 to refresh the screen and verify that the file has been removed from the list.
Groups
From the Groups
menu, you can add, change, or delete group entries in the password table.
To add a group entry
- Click the plus sign icon beside the Model 204 Group Passwords header.
- In the Add Group entry to CCASTAT dialog box that appears, enter the Group name, Password, general Privileges, Index, User class, Select/Update/Read/Add privileges, and/or Terminals.
For information on acceptable values, see LOGCTL for group entries.
Tip: To set general Privileges, click the search icon beside the field to bring up a checklist of privileges.
- Click the Save updates button. The information is immediately committed to CCASTAT.
- Press F5 to refresh the screen and verify that the new group entry is listed.
To change a group password or logon settings
- Click the icon to the left of the group id that you want to change.
- Select Change from the pop-up menu that appears.
- In the Change group password or logon settings dialog box, change the Password, general Privileges, Index, User class, Select/Update/Read/Add privileges, and/or Terminals. For information on acceptable values, see LOGCTL for group entries.
Tip: To change general Privileges, click the search icon beside the field to bring up a checklist of privileges.
- Click the Save updates button. The information is immediately committed to CCASTAT.
To delete a group entry
- Click the icon to the left of the group that you want to delete.
- Select Delete from the pop-up menu that appears.
- In the Delete Group pop-up that appears, click Confirm Delete. The information is immediately deleted from CCASTAT.
- Press F5 to refresh the screen and verify that the group entry has been removed from the list.
Group Definitions
The Group Definitions
menu option enables system managers to manage the group definitions in CCAGRP. Access to the Group Definition page is given to RKWEB subsystem ADMIN SCLASS users who have System Administrator login privileges.
To add a group
- Click the plus sign icon beside the Model 204 Groups screen title.
The Create a new group screen appears.
- Fill in or select the field values to set the group parameters. Hover the mouse over each field for help. These parameters are also described in the CREATE command.
- Click the Save changes button.
- Press the
F5
key to refresh the display and see your group in the list.
To copy a group
- Click the icon beside the group name that you want to copy, and click Copy in the Copy/Rename/Update/Delete pop-up list.
- In the Rename Group pop-up, enter the new name in the To field and click Confirm Rename.
- Press F5 to refresh the screen and see the new copy with the name that you entered.
To rename a group
- Click the icon beside the group name that you want to rename, and click Rename in the Copy/Rename/Update/Delete pop-up list.
- In the Rename Group pop-up, enter the name of the new copy in the To field and click Confirm Rename.
- Press F5 to refresh the screen and confirm the name change.
To update a group
- Click the icon beside the group name that you want to update, and click Update in the Copy/Rename/Update/Delete pop-up list.
- Fill in or select new field values to change the group parameters. Hover the mouse over each field for help. These parameters are also described in the CREATE command.
- Click the Save number Updates button.
The Update group definition dialog box appears.
To delete a group
- Click the icon beside the group name that you want to delete, and click Delete in the Copy/Rename/Update/Delete pop-up list.
- In the Delete Group pop-up, click Confirm Delete.
- Press F5 to refresh the screen and confirm that the group has been removed from the list.
SSL Certificates
Note: Before using the RKWeb SSL Certificates interface, click the Manage > SSL Certificates > SSL Information
menu item and read the SSL Certificate Management - How to use this application screen.
Overview
Janus Network Security supports the SSL (Secure Socket Layer) and the TLS (Transport Layer Security) protocols, which provide secure communications for users of Janus products. In order to provide for secure communications and authentication, SSL employs several features, including public and private keys for encryption, and certificates and digital signatures for authentication.
Access to this feature in RKWeb requires a Janus Network Security license and is restricted to RKWEB subsystem ADMIN SCLASS members, who also have System Administrator login privileges.
Server certificates used by SSL typically contain the country, state or province, locality (city, town, village, etc.), organization, and organizational unit of the holder of the private key. In addition, SSL server certificates contain the TCP/IP host name of the server that holds the private key.
The information in a server certificate can normally be viewed in a client application such as a browser, so an end user can be sure that he or she is communicating with the correct server.
Note: An SSL client will automatically verify that the host name in a server certificate matches the name of the host to which it is connecting.
For more information on certificates, see About keys and certificates.
RKWeb provides a convenient web interface for the tasks involved in generating an SSL certificate. (For an overview of the process, see SSL certificate management.)
The process of getting a valid certificate and private key combination usually involves these steps:
Step | Menu item | Notes |
---|---|---|
1. Generate a private key and an associated certificate request. | Create Request | The certificate request is basically a certificate without a digital signature. The private key should be stored in a secure location and (preferably) encrypted. |
2. Forward the certificate request file to the certifying authority (CA). | N/A | Scroll down the screen to the "How to use this page" section. |
3. The certifying authority digitally signs the certificate. | N/A | Presumably, the certifying authority verifies that the information in the certificate is correct and valid, but this is not strictly necessary. |
4. The certifying authority sends the digitally signed certificate back to the holder of the private key. | N/A | N/A |
5. The holder of the private key receives the signed certificate. This usually involves associating the signed certificate with the private key in some way. | Receive Certificate | With Janus Network Security, the private key and the signed certificate must be placed into the same procedure. |
Create Request
To generate a certificate request
- Click the
Manage > SSL Certificates > Create Request
menu item. - On the Generate Certificate Requests and Self-Signed Certificates screen, scroll down to read the online help.
- Fill in the fields as directed in the help. Hover the mouse over each field for pop-up help.
- Click the Create certificate request button.
To generate a self-signed certificate
- Click the
Manage > SSL Certificates > Sign Certificate
menu item. - On the Sign a Certificate screen, scroll down to read the online help.
- Fill in the fields as directed in the help. Hover the mouse over each field for pop-up help.
- Click the Sign the Certificate button.
To receive a signed certificate
- Click the
Manage > SSL Certificates > Receive Certificate
menu item. - On the Receive a Signed Certificate screen, scroll down to read the online help.
- Fill in the fields as directed in the help. Hover the mouse over each field for pop-up help.
- Click the Receive Certificate button.
To manage SSL requests and certificates
- Click the
Manage > SSL Certificates > Manage Certificates
menu item. - Click the equals sign icon beside a request name and select an option:
- View the details of the certificate on a separate screen
- Add an intermediate certificate. For information about intermediate certificates, see the online help on the SSL information screen.
- Rename the selected certificate
- Delete the selected certificate
To learn about using the SSL application
Click the Manage > SSL Certificates > SSL Information
menu item to bring up the SSL Certificate Management - How to use this application screen.
It is recommended that you read this screen before doing any SSL tasks.
Monitor
The Monitor
menu enables you to monitor Model 204 performance, perform a journal scan, and run Model 204 commands.
Performance
The Monitor > Performance
menu is the RKWeb interface to the SirMon monitoring application, and it is restricted to RKWEB subsystem ADMIN SCLASS users at sites that own SirMon. SirMon combines the real-time monitoring of Model 204 performance with intelligent full-screen displays that facilitate System Manager duties. You can scroll the displays, refresh them, and sort them by displayed statistics and parameters.
SirMon provides a collection of predefined monitoring options known to be useful for analyzing Model 204 performance and solving performance problems. SirMon features are designed to highlight significant resource consumers.
SirMon is completely integrated with the Model 204 security scheme, so users have access to commands in SirMon only if they have access to them at the Model 204 command level.
SirMon divides the Model 204 Online into System, Files, Users, Subsystems, MP Tasks, and Janus Ports statistics. In addition to those statistics collected by Model 204, SirMon provides an extensive collection of additional statistics and information that is invaluable for understanding the performance of a Model 204 Online.
To see the meaning of any statistic in the display, mouse over it for pop-up help.
Extensive customization facilities make it easy to design and implement screens or views that track information of interest to your particular site.
System
The Monitor > Performance > System
menu option provides a submenu of system statistics screens, including:
Option | Description |
---|---|
Above-the-bar Buffers | Locally defined selection. |
Above/Below the bar disk I/O | Locally defined selection. |
Below-the-bar Buffers | Locally defined selection. |
Database I/O Performance | Overall view of physical and logical I/O for the various database files defined to the Online environment. |
MP Performance | Measures of performance specific to a multi-processor Model 204 environment. |
Request Profile | Overall view of database activity up to the current moment. Displays total Find statements and various measures of record access and update. |
System Performance | General view of system performance that includes CPU usage, I/O activity and other broad measures. |
User State Distribution | Reports the total number of users in the various categories of activity (running, waiting, swapping, etc.) at a given moment. |
User Wait Type Dist | Displays counts of users by wait type (waiting for disk I/O, or file resource, etc.). |
For a description of each statistic, hover the mouse over the column heading to see pop-up help.
A SirMon administrator can also locally define custom screens that are accessed from the Monitor > Performance > System
menu.
Files
The Monitor > Performance > Files
menu presents a submenu of file statistics screens, including:
Option | Description |
---|---|
Buffer Usage | Detailed breakdown of each file's disk buffer usage by table together with disk read and write rates. |
Critical File Resource | Shows each category of resource conflict as a rate and the total number if users waiting on various critical file resources. |
File Activity | Display of disk activity, file enqueue counts, total page buffer utilization, and critical file resource conflicts. |
File Table Usage | Shows file space utilization information for each open Model 204 file, broken down by table type. |
Ordered Index Usage | Information about ordered index data density and usage. |
For a description of each statistic, hover the mouse over the column heading to see pop-up help.
Locally defined screens may also be accessed from the File Monitor menu. These screens are defined by a SirMon administrator as described in Custom screens.
Users
The Monitor > Performance > Users
menu presents a submenu of user statistics screens, including:
Option | Description |
---|---|
Critical File Resources | Detailed statistics providing information about conflicts on critical file resources. |
Disk Buffer Usage | Various DKxxx statistics for each user. |
Misc. Resource Usage | Aggregate measures of activity, making it easy to spot significant resource consumers. |
Record Locking Table Usage | Statistics useful in determining utilization of the record locking table and highlighting poor enqueueing behaviour in applications. |
Resource Usage | Broad measurements of users' consumption of CPU and I/O activity. |
Resource Usage and Subsys | Various resource consumption statistics and the current subsystem for each user. |
User State Display | Displays users state, wait type and other measures to indicate their level of activity. |
For a description of each statistic, hover the mouse over the column heading to see pop-up help.
Locally defined screens may also be accessed from the User Monitor menu. These screens are defined by a SirMon administrator as described in Custom screens.
Subsystems
The Monitor > Performance > Subsystems
menu presents a submenu of subsystem statistics screens, including:
Option | Description |
---|---|
Active/Inactive Subsystems | Display of status, number of users, access (PRIVATE, PUBLIC, SEMIPUBLIC), non-precompiled prefix and precompiled prefix for all subsystems defined in the Online. |
Resident QTBL Usage | Detailed breakdown of key information about each subsystem's use of resident QTBL. |
For a description of each statistic, hover the mouse over the column heading to see pop-up help.
Locally defined screens may also be accessed from the Subsystems menu. These screens are defined by a SirMon administrator as described in Custom screens.
MP Tasks
The Monitor > Performance > MP Tasks
menu presents a submenu of task statistics screens, including:
Option | Description |
---|---|
Task Performance | Display of CPU usage, the PCPU statistic, and other statistics related to performance of Model 204 multitasking. |
For a description of each statistic, hover the mouse over the column heading to see pop-up help.
Locally defined screens may also be accessed from the Task Monitor menu. These screens are defined by a SirMon administrator, as described in Custom screens.
Janus Ports
The Monitor > Performance > Janus Ports
menu presents a submenu of port statistics screens, including:
Option | Description |
---|---|
Janus SSLStat | A detailed display of the SSL activity for each combination of Janus port and network security protocol. "SSL activity" refers to Janus Network Security encrypted communications on a Janus port whose definition includes an SSL parameter specification. Each port is listed under the Portname header.
For details on the Janus SSL statistics, see Janus SSLStat. |
Janus Status | A detailed display of the current status of specified ports. |
Janus TStat | A detailed display of thread usage activity on Janus ports. This information can prove useful in isolating problems with thread availability and in doing capacity planning. |
For pop-up help for each statistic, hover the mouse over the column header.
Custom
The Monitor > Performance > Custom
menu item enables you to build a custom performance screen.
To create a custom performance screen
- Click the
Monitor
tab. - In the
Performance
menu, click the arrow to open the submenu, and selectCustom
. - In the Type section, select the type of performance statistics that you want to use.
- In the Load From field, click the subsystem that you want to load from.
To start again, click Clear.
- In the Non-Interval Statistics section, click one or more statistic buttons to select the statistics to be included. To see a description of each statistic, hover the mouse over the statistic button.
The selected statistics buttons will turn blue, and the buttons will be copied into the Sort order section. The statistics will be listed in the order that you select them, or you can click and drag them within the Sort order section to change their order.
To remove a statistic from the list to be included, click its blue button. Or click its button in the Sort order section to show a Remove Stat menu item. Click Remove Stat. To cancel the removal, click away from Remove Stat.
- In the Interval Statistics section, click to select each statistic that you want to be included.
Most statistics viewable as rates (interval statistics) can alternatively be displayed as totals. To view a statistic as a total, click its button in the Sort order section and select Set as Total (#). The statistic name on the button appears with # appended to show it is a total. To undo, click the button again and select Clear Total (#).
- To run the report, click Run. On the report screen that appears, hover the mouse over each statistic name to display pop-up help. Click Refresh to run the report again.
- To save as an ad hoc listing, click Save as Adhoc. The listing will be saved to "Adhoc for username."
- To save under a report type, click Save.
Journal Scan
The Journal Scan
menu link brings up the RKWeb journal scanner, a high-performance utility similar to the TN3270 interface of SirScan. The journal scanner allows users in a Model 204 Online to browse the contents of its journal in real time. To use the journal scanner, you must have a license to use the SIRSCAN subsystem.
ADMIN SCLASS users of the RKWEB subsystem can view the current Online journal entries or browse the content of archival journals (by DDname, if they are allocated to the Online as sequential files). The data is displayed on the web page with powerful searching commands, including filtering and display options.
The Model 204 journal scan form supports the same input as shown for SirScan (see journal scan specifications).
To run a journal scan
- Click the
Monitor
tab. - In the
Monitor
menu, clickJournal Scan
. - On the Model 204 journal scan form, enter the desired field values.
Click the red plus or minus sign icon to toggle between a minimized set of request options (start time and users only) and an expanded set of options.
- Click Submit journal request to see the journal entries.
Command processor
With the command processor, you can run any Model 204 command that your user role has permissions for.
To run a Model 204 command
- Click the
Command processor
link to open the Model 204 command interface. - Enter any command as you would on a Model 204 command line, such as
VIEW ALL
, then click Submit to run it. - To see the command history, click Show stack. You can edit the stack by deleting unwanted commands and clicking Save stack.
RKWeb security
RKWeb is implemented as a single application subsystem (APSY) and provides access to each of its Model 204 components as appropriate, based on your site's products and your user permissions.
- Some RKWeb components are purchased as individual products and are not included in the Model 204 core. Those products are only available at sites that own them.
- Some components, such as SirScan, check that your site owns the underlying product and verify user access by SCLASS. Other features, such as LOGCTL access, require the same UPRIV as at command level (typically System Manager or System Administrator).
If your site or your user role does not have access to a component, the component link is visible in the RKWeb UI but is inactive.
Privileges for the Command processor are handled as they are on the command line: you can run any commands that you have permissions for.
For details on configuring a secure web port for RKWeb, see RKWeb installation.
Where's my RKTools 3270 functionality?
Want to use the RKWeb interface but looking for the familiar RKTools functionality?
The following table maps each RKWeb menu item to the existing RKTools 3270 interface. Be aware that not all the functionality present in each product's 3270 screens is reproduced in RKWeb.
The Available to... column shows which product you must own in order to access a specific component. "Model 204 Core" functionality is available to all users with proper permissions.
RKTools 3270 | RKWeb component > menu item | Available to... |
---|---|---|
Model 204 command line, SirPro command processing | Build, Manage, Monitor > Command processor | Model 204 Core |
CREATE GROUP command, SirPro | Manage > Group Definitions | Model 204 Core |
Dictionary/204 | Manage > Dictionary | Model 204 Core |
JANSSL | Manage > SSL Certificates | Janus Network Security owners |
LOGCTL/LOGADD commands, SirPro | Manage > Passwords | Model 204 Core |
SirFact | Build > Fact Dump Analysis | SirFact owners |
SirLib | Build > Configure | SirLib owners |
SirMon | Monitor > Performance | SirMon owners |
SirScan | Monitor > Journal Scan | SirScan owners |
SirTune Reports | Build > Tune Reports | SirTune owners |
SoulEdit | Build > Edit | SirPro owners |
Subsystem Management | Manage > Subsystem Management | Model 204 Core |