SirPro file-group maintenance: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (misc cleanup)
m (mention RKWeb equivalents)
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
Option 8 on the SirPro [[SirPro#SirPro main menu|main menu]] provides a full-screen facility for managing the group definitions in CCAGRP.
Option 8 on the SirPro [[SirPro#SirPro main menu|main menu]] provides a full-screen facility for managing the group definitions in [[Storing and using file group definitions (CCAGRP)|CCAGRP]]. You can also access these definitions from the [[RKWeb]] interface by selecting <code>Manage > Group Definitions</code>.
 
<p class="note"><b>Note:</b> This option is only available to system managers.
<p class="note"><b>Note:</b> This option is only available to system managers.
</p>
</p>  


==Maintaining CCAGRP definitions==
==Maintaining CCAGRP definitions==
For each group defined in CCAGRP, <var class="product">SirPro</var> displays two lines of information. The first line contains the group name and parameters, and the second line contains the files defined to the group.


<p class="caption" style="width:500px">CCAGRP screen for permanent group definitions</p>
<p class="caption" style="width:450px">CCAGRP screen for permanent group definitions</p>
<p class="figure">[[File:SProCCAGRP.png|450px]]</p>
 
<p>
The [[RKWeb#Group Definitions|RKWeb version of this screen]] has a different layout and operation but it offers the same functionality. </p>
 
<blockquote class="note">
<p><b>Note:</b> The TN3270 <var class="product">SirPro</var> CCAGRP interface imposes a limit of 24 files per group. If you have groups defined with more than 24 files, Option 8 on the SirPro main menu lets you view them &mdash; but it should not be used to update them, as the 25th and later files will be deleted from the definition. <var class="product">SirPro</var> prevents Update, Copy, or Rename commands (see <b>Sel</b> field, below) against groups with more than 24 members. </p>
<p>
The RKWeb CCAGRP interface has a limit of 254 files per group. </p>
</blockquote>
 
===Screen fields===
The CCAGRP screen's fields are:
<table class="thJustBold">
<tr><th>Sel</th>
<td>A single-character command field. Valid commands are:


For each group defined in CCAGRP, <var class="product">SirPro</var> displays two lines of
information. The first line contains the group name and parameters,
and the second line contains the files defined to the group.
The parameters shown for each group are:
<table class="thJustBold">
<table class="thJustBold">
<tr><th>D</th>
<td>Deletes the group definition.</td></tr>
<tr><th>R</th>
<td>Rename the group.</td></tr>
<tr><th>C</th>
<td>Copy the group definition to a group definition of a new name.</td></tr>
<tr><th>U</th>
<td>Update: Change the parameter settings for the files defined to the group definition.</td></tr>
</table>
<p>
<var>D</var>elete and <var>R</var>ename are executed directly from the CCAGRP screen. <var>C</var>opy and <var>U</var>pdate send the user to a group definition update screen. In addition, the command-line command
<code>ADD <i>groupname</i></code> sends the user to the same screen.
The update screen is shown below in [[#Updating a group definition|Updating a group definition]].</p></td></tr>
<tr><th>Group</th>
<td>The name of a group member of CCAGRP.</td></tr>
<tr><th>Access</th>
<tr><th>Access</th>
<td><var>PUBLIC</var>, <var>SEMIPUB</var>, or <var>PRIVATE</var>.</td></tr>
<td><var>PUBLIC</var>, <var>SEMIPUB</var>, or <var>PRIVATE</var>.</td></tr>


<tr><th>Privileges</th>
<tr><th>Priv</th>
<td>Hexadecimal switches associating various privileges with the default opening of <var>PUBLIC</var> and <var>SEMIPUB</var> groups.</td></tr>
<td>Hexadecimal switches associating various privileges with the default opening of <var>PUBLIC</var> and <var>SEMIPUB</var> groups.</td></tr>


<tr><th>BLDGFT</th>
<tr><th>Bldgft</th>
<td>Entering <code>Y</code> builds global find table, and <code>N</code> does not build this table, when the group is opened. <code>Y</code> is the default.</td></tr>
<td>Entering <code>Y</code> builds global find table, and <code>N</code> does not build this table, when the group is opened. <code>Y</code> is the default.</td></tr>


<tr><th>PROCFILE</th>
<tr><th>Procfile</th>
<td>File name of the group member that will contain procedures. If all members may contain procedures, an asterisk (<tt>*</tt>) is used.</td></tr>
<td>File name of the group member that will contain procedures. If all members may contain procedures, an asterisk (<tt>*</tt>) is used.</td></tr>


<tr><th>UPDTFILE</th>
<tr><th>Updtfile</th>
<td>File that should be the target of record adds when no specific member name context is given.</td></tr>
<td>File that should be the target of record adds when no specific member name context is given.</td></tr>


<tr><th>Priv Level N</th>
<tr><th>Priv Level N</th>
<td>Procedure class level.</td></tr>
<td>Procedure class level. See [[Model 204 security features#Procedure security|Procedure security]] for more information.</td></tr>


<tr><th>Priv Level S</th>
<tr><th>Priv Level S</th>
<td>Class level required for <var>SELECT</var>.</td></tr>
<td>Class level required for <var>SELECT</var>. See [[Model 204 security features#Field-level security|Field-level security]] for more information.</td></tr>


<tr><th>Priv Level R</th>
<tr><th>Priv Level R</th>
Line 43: Line 77:
</table>
</table>


See [[Security]] for more information about security.
===Function keys===
 
<p class="note"><b>Note:</b> The <var class="product">SirPro</var> CCAGRP interface imposes a limit of 24 files per group. If you have groups defined with more than 24 files, Option 8 on the SirPro main menu lets you view them &mdash; but it should not be used to update them, as the 25th
and later files will be deleted from the definition.
<var class="product">SirPro</var> prevents Update, Copy, or Rename commands against groups with more than 24 members. <p>
 
Preceding each group name is a single-character command field.
Valid commands in these fields are:
 
<table class="thJustBold">
<tr><th>D</th>
<td>Deletes the group definition.</td></tr>
 
<tr><th>R</th>
<td>Rename the group.</td></tr>
 
<tr><th>C</th>
<td>Copy the group definition to a group definition of a new name.</td></tr>
 
<tr><th>U</th>
<td>Update: Change the parameter settings for the files defined to the group definition.</td></tr>
</table>
 
<b>D</b>elete and <b>R</b>ename are executed directly from the CCAGRP screen.
<b>C</b>opy and <b>U</b>pdate send the user to a group definition update screen.
In addition, the command-line command
<code>ADD <i>groupname</i></code> sends the user to the same screen.
The update screen is described below.
 
These function keys are available on the group definition display:
These function keys are available on the group definition display:
<table class="thJustBold">
<table class="thJustBold">
Line 101: Line 107:
the following display, which allows an entire group definition to be built.
the following display, which allows an entire group definition to be built.


<p class="caption">CCAGRP screen for updating a group definition</p>
<p class="caption" style="width:450px">CCAGRP screen for updating a group definition</p>
<p class="figure">[[File:SProCCAGRPupdt.png|450px]]</p>


<b>Access</b>, <b>Priv</b>ileges, and <b>Bldgft</b> are set to their <var class="product">Model&nbsp;204</var> default values.
<b>Access</b>, <b>Priv</b>ileges, and <b>Bldgft</b> are set to their <var class="product">Model&nbsp;204</var> default values.

Latest revision as of 19:07, 21 June 2017

Option 8 on the SirPro main menu provides a full-screen facility for managing the group definitions in CCAGRP. You can also access these definitions from the RKWeb interface by selecting Manage > Group Definitions.

Note: This option is only available to system managers.

Maintaining CCAGRP definitions

For each group defined in CCAGRP, SirPro displays two lines of information. The first line contains the group name and parameters, and the second line contains the files defined to the group.

CCAGRP screen for permanent group definitions

The RKWeb version of this screen has a different layout and operation but it offers the same functionality.

Note: The TN3270 SirPro CCAGRP interface imposes a limit of 24 files per group. If you have groups defined with more than 24 files, Option 8 on the SirPro main menu lets you view them — but it should not be used to update them, as the 25th and later files will be deleted from the definition. SirPro prevents Update, Copy, or Rename commands (see Sel field, below) against groups with more than 24 members.

The RKWeb CCAGRP interface has a limit of 254 files per group.

Screen fields

The CCAGRP screen's fields are:

Sel A single-character command field. Valid commands are:
D Deletes the group definition.
R Rename the group.
C Copy the group definition to a group definition of a new name.
U Update: Change the parameter settings for the files defined to the group definition.

Delete and Rename are executed directly from the CCAGRP screen. Copy and Update send the user to a group definition update screen. In addition, the command-line command ADD groupname sends the user to the same screen. The update screen is shown below in Updating a group definition.

Group The name of a group member of CCAGRP.
Access PUBLIC, SEMIPUB, or PRIVATE.
Priv Hexadecimal switches associating various privileges with the default opening of PUBLIC and SEMIPUB groups.
Bldgft Entering Y builds global find table, and N does not build this table, when the group is opened. Y is the default.
Procfile File name of the group member that will contain procedures. If all members may contain procedures, an asterisk (*) is used.
Updtfile File that should be the target of record adds when no specific member name context is given.
Priv Level N Procedure class level. See Procedure security for more information.
Priv Level S Class level required for SELECT. See Field-level security for more information.
Priv Level R Class level required for READ.
Priv Level U Class level required for UPDATE.
Priv Level A Class level required for ADD.

Function keys

These function keys are available on the group definition display:

F1 Help.
F3 Quit (return to SirPro Main Menu).
F7 Scroll up.
F8 Scroll down.
F9 Repeat last command-line command.
F10 Scroll file lines to the left.
F11 Scroll the file lines to the right. If there are more than eight files in a group definition, an ellipsis (...) will appear to the right of the eighth file. This key shifts the view to the right to display the remaining files.

Updating a group definition

Copy, Update, and ADD commands invoke the following display, which allows an entire group definition to be built.

CCAGRP screen for updating a group definition

Access, Privileges, and Bldgft are set to their Model 204 default values. Enter values for the remaining fields, and press F12 to build the group.

Function keys valid for this display are:

F1 Help.
F3 Quit (return to SirPro main menu).
F9 Repeat last command-line command.
F12 Commit the definition to CCAGRP. This key invokes error checking before the group definition commands are executed.

See also

Retrieved from "https://m204wiki.rocketsoftware.com/index.php?title=SirPro_file-group_maintenance&oldid=103499"