SirPro file-group maintenance: Difference between revisions
m (1 revision: SirPro from Stage) |
m (mention RKWeb equivalents) |
||
(8 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 [[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>. | |||
You | |||
< | |||
<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> | ||
<p class="caption">CCAGRP screen for permanent group definitions</p> | ==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: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 — 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: | |||
<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>PUBLIC, SEMIPUB or PRIVATE.</td></tr> | <td><var>PUBLIC</var>, <var>SEMIPUB</var>, or <var>PRIVATE</var>.</td></tr> | ||
<tr><th> | <tr><th>Priv</th> | ||
<td>Hexadecimal switches associating various privileges with the default opening of PUBLIC and SEMIPUB 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> | <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> | <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> | <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 SELECT.</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> | ||
<td>Class level required for READ.</td></tr> | <td>Class level required for <var>READ</var>.</td></tr> | ||
<tr><th nowrap>Priv Level U</th> | <tr><th nowrap>Priv Level U</th> | ||
<td>Class level required for UPDATE.</td></tr> | <td>Class level required for <var>UPDATE</var>.</td></tr> | ||
<tr><th>Priv Level A</th> | <tr><th>Priv Level A</th> | ||
<td>Class level required for | <td>Class level required for <var>ADD</var>.</td></tr> | ||
</table> | </table> | ||
===Function keys=== | |||
These function keys are available on the group definition display: | |||
<table class="thJustBold"> | <table class="thJustBold"> | ||
<tr><th> | <tr><th>F1</th> | ||
<td>Help.</td></tr> | <td>Help.</td></tr> | ||
<tr><th> | <tr><th>F3</th> | ||
<td>Quit (return to SirPro Main Menu).</td></tr> | <td>Quit (return to SirPro Main Menu).</td></tr> | ||
<tr><th> | <tr><th>F7</th> | ||
<td>Scroll up.</td></tr> | <td>Scroll up.</td></tr> | ||
<tr><th> | <tr><th>F8</th> | ||
<td>Scroll down.</td></tr> | <td>Scroll down.</td></tr> | ||
<tr><th> | <tr><th>F9</th> | ||
<td>Repeat last command-line command.</td></tr> | <td>Repeat last command-line command.</td></tr> | ||
<tr><th> | <tr><th>F10</th> | ||
<td>Scroll file lines to the left.</td></tr> | <td>Scroll file lines to the left.</td></tr> | ||
<tr><th> | <tr><th>F11</th> | ||
<td>Scroll the file lines to the right. | <td>Scroll the file lines to the right. | ||
If there are more than | If there are more than eight files in a group definition, an ellipsis (<tt>...</tt>) will appear to the right of the eighth file. This key shifts the view to the right to display the remaining files.</td></tr> | ||
</table> | </table> | ||
<b>C</b>opy, <b>U</b>pdate and <b>ADD</b> commands invoke | ==Updating a group definition== | ||
the following display, which allows an entire | <b>C</b>opy, <b>U</b>pdate, and <b>ADD</b> commands invoke | ||
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 204</var> default values. | <b>Access</b>, <b>Priv</b>ileges, and <b>Bldgft</b> are set to their <var class="product">Model 204</var> default values. | ||
Enter values for the remaining fields, and press | Enter values for the remaining fields, and press F12 to build the group. | ||
Function keys valid for this display are: | |||
<table class="thJustBold"> | <table class="thJustBold"> | ||
<tr><th> | <tr><th>F1</th> | ||
<td>Help.</td></tr> | <td>Help.</td></tr> | ||
<tr><th> | <tr><th>F3</th> | ||
<td>Quit (return to SirPro | <td>Quit (return to SirPro main menu).</td></tr> | ||
<tr><th> | <tr><th>F9</th> | ||
<td>Repeat last command-line command.</td></tr> | <td>Repeat last command-line command.</td></tr> | ||
<tr><th> | <tr><th>F12</th> | ||
<td>Commit the definition to CCAGRP. This key invokes error checking before the group definition commands are executed.</td></tr> | <td>Commit the definition to CCAGRP. This key invokes error checking before the group definition commands are executed.</td></tr> | ||
</table> | </table> |
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.
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:
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
| ||||||||
---|---|---|---|---|---|---|---|---|---|
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.
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
- SirPro
- SirPro procedure-list selection
- SirPro procedure-list operations
- SirPro command processor
- SirPro Print All Information facility
- SirPro field definition display
- SirPro CCASTAT password maintenance
- SirPro file-group maintenance
- SirPro change management tools and functions
- SirPro date processing