SirPro file-group maintenance: Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
 
m (mention RKWeb equivalents)
 
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<!--Page automatically generated by CMSTOWIK EXEC and will be
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>.
** automatically replaced ** -- any manual edits will be lost.
You've been warned.  ..  (Page built by JAL at the SIRIUS VM; file: FUNPGNEW SYSUT2) -->
<!-- Page name: SirPro file-group maintenance-->


Option 8 on the SirPro main menu provides a full-screen facility for managing group
definitions in CCAGRP.
<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 &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>PUBLIC, SEMIPUB or PRIVATE.</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 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>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 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 ADD.</td></tr>
<td>Class level required for <var>ADD</var>.</td></tr>
</table>
 
See [[Security]] for more information about security.
 
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 may be used to view them, but 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.
 
Prefixing 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>
</table>


<b>D</b>elete and <b>R</b>ename are executed directly from the CCAGRP screen.
===Function keys===
<b>C</b>opy and <b>U</b>pdate send the user to a group definition update screen.
These function keys are available on the group definition display:
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.
 
PF keys on the group definition display are:
<table class="thJustBold">
<table class="thJustBold">
<tr><th>PF1</th>
<tr><th>F1</th>
<td>Help.</td></tr>
<td>Help.</td></tr>


<tr><th>PF3</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>PF7</th>
<tr><th>F7</th>
<td>Scroll up.</td></tr>
<td>Scroll up.</td></tr>


<tr><th>PF8</th>
<tr><th>F8</th>
<td>Scroll down.</td></tr>
<td>Scroll down.</td></tr>


<tr><th>PF9</th>
<tr><th>F9</th>
<td>Repeat last command-line command.</td></tr>
<td>Repeat last command-line command.</td></tr>


<tr><th>PF10</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>PF11</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 8 files in a group definition, an ellipsis (<tt>...</tt>) will appear to the right of the eighth file. This PF key shifts the view to the right to display the remaining files.</td></tr>
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 GROUP definition to be built.
<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&nbsp;204</var> default values.
Enter values for the remaining fields, and press PF12 to build the group.
Enter values for the remaining fields, and press F12 to build the group.


PF keys valid for this display are:
Function keys valid for this display are:
<table class="thJustBold">
<table class="thJustBold">
<tr><th>PF1</th>
<tr><th>F1</th>
<td>Help.</td></tr>
<td>Help.</td></tr>


<tr><th>PF3</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>PF9</th>
<tr><th>F9</th>
<td>Repeat last command-line command.</td></tr>
<td>Repeat last command-line command.</td></tr>


<tr><th>PF12</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.

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