LOGCTL command: Modifying file entries in the password table: Difference between revisions
Jump to navigation
Jump to search
m (add note) |
|||
| (7 intermediate revisions by 4 users not shown) | |||
| Line 6: | Line 6: | ||
<dd>Adds, deletes, or changes file entries in the password table | <dd>Adds, deletes, or changes file entries in the password table | ||
</dl> | </dl> | ||
==Syntax== | ==Syntax== | ||
<p class="syntax">LOGCTL {A | D | C} :< | <p class="syntax">LOGCTL {A | D | C} :<span class="term">filename</span> [<span class="term">index</span>] | ||
</p> | </p> | ||
Where: | |||
<table> | <table> | ||
<tr> | <tr> | ||
<th>filename</th> | <th>filename</th> | ||
<td> | <td>The name of the file entry to be added, deleted, or changed (1 to 8 characters). The file name must be preceded by a colon (<tt>:</tt>).</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<th>index</th> | <th>index</th> | ||
<td> | <td>A single character indicating which file entry is being modified, and is either a digit (0-9) or a letter (A-Z); index must be specified if the file has more than one password.</td> | ||
</tr> | </tr> | ||
</table> | </table> | ||
==Example== | ==Example== | ||
<p class="code">LOGCTL C :TESTFILE | <p class="code">LOGCTL C :TESTFILE | ||
</p> | </p> | ||
==Usage notes== | ==Usage notes== | ||
<p>The LOGCTL command adds, deletes, or changes file entries in the password table. If add (A) or change (C) is specified, <var class="product">Model 204</var> prompts for information as shown below.</p> | <p> | ||
The <var>LOGCTL</var> command adds, deletes, or changes file entries in the password table. If add (<var>A</var>) or change (<var>C</var>) is specified, <var class="product">Model 204</var> prompts for information as shown below.</p> | |||
<p>The system manager can change any of the following specifications in a file entry: </p> | <p>The system manager can change any of the following specifications in a file entry: </p> | ||
<ul> | <ul> | ||
<li | <li>Password</li> | ||
</li> | |||
<li | <li>Privileges</li> | ||
</li> | |||
<li | <li>User class</li> | ||
</li> | |||
<li | <li>Field-level security levels</li> | ||
</li> | |||
<li | <li>Terminal list</li> | ||
</ul> | |||
</li> | <p> | ||
Upon entry of the <var>LOGCTL</var> command, the system responds with a prompt in the following form: </p> | |||
<p>Upon entry of the LOGCTL command, the system responds with a prompt in the following form: </p> | <p class="code">*** M204.0374: ENTER FILE/GROUP PASSWORD,PRIVILEGES,CLASS,SELECT,READ,UPDATE,ADD | ||
<p class="code">*** M204.0374: | |||
</p> | </p> | ||
<p>The user response would be in this form:</p> | |||
< | <p class="code"><i>password</i>,X'<I>pppp</I>',<i>ccc</i>,<i>sss</i>,<i>rrr</i>,<i>uuu</i>,<i>aaa</i></p> | ||
Where: | |||
<table> | <table> | ||
<tr> | <tr> | ||
<th>password</th> | <th>password</th> | ||
<td> | <td>As of Model 204 version 7.7, a password can contain up to 127 characters, including blanks and special characters. | ||
<p class="note"><b>Note:</b> Commas in passwords are allowed only when using the <var>[[LOGINCP or LOGONCP command|LOGONCP]]</var> command or the <var>[[$Sir_Login]]</var> function, but not when using the <var>LOGCTL</var> command. In the case of <var>LOGCTL</var>, comma is the delimiter between arguments.</p></td> | |||
</tr> | </tr> | ||
<tr> | <tr> | ||
<th>pppp</th> | <th>pppp</th> | ||
<td> | <td>The two-byte representation of the file privileges. (See the <var>[[PRIVDEF parameter|PRIVDEF]]</var> parameter.)</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<th>ccc</th> | <th>ccc</th> | ||
<td> | <td>The procedure user class. (See [[Model 204 security features#Procedure security|Procedure security]].)</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<th>sss</th> | <th>sss</th> | ||
<td> | <td>The field-level security <var>SELECT</var> level.</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<th>rrr</th> | <th>rrr</th> | ||
<td> | <td>The field-level security <var>READ</var> level.</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<th>uuu</th> | <th>uuu</th> | ||
<td> | <td>The field-level security <var>UPDATE</var> level.</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<th>aaa</th> | <th>aaa</th> | ||
<td> | <td>The field-level security <var>ADD</var> level. (For information on field-level security, see [[Establishing and maintaining security#Field-level security|Field-level security]].) </td> | ||
</tr> | </tr> | ||
</table> | </table> | ||
<p>When a file entry is being added, the password is required and all other specifications are optional. <var class="product">Model 204</var> supplies default values of zero.</p> | <p> | ||
<p>When a file entry is being changed, all specifications are optional. If the system manager does not supply a specification in the command, the existing specification in the password table is preserved, as described for login user IDs. </p> | When a file entry is being added, the password is required and all other specifications are optional. <var class="product">Model 204</var> supplies default values of zero.</p> | ||
<p> | |||
When a file entry is being changed, all specifications are optional. If the system manager does not supply a specification in the command, the existing specification in the password table is preserved, as described for login user IDs. </p> | |||
[[Category: System manager commands]] | [[Category: System manager commands]] | ||
[[Category:Commands]] | [[Category:Commands]] | ||
Latest revision as of 20:22, 13 September 2017
Summary
- Privileges
- System manager
- Function
- Adds, deletes, or changes file entries in the password table
Syntax
LOGCTL {A | D | C} :filename [index]
Where:
| filename | The name of the file entry to be added, deleted, or changed (1 to 8 characters). The file name must be preceded by a colon (:). |
|---|---|
| index | A single character indicating which file entry is being modified, and is either a digit (0-9) or a letter (A-Z); index must be specified if the file has more than one password. |
Example
LOGCTL C :TESTFILE
Usage notes
The LOGCTL command adds, deletes, or changes file entries in the password table. If add (A) or change (C) is specified, Model 204 prompts for information as shown below.
The system manager can change any of the following specifications in a file entry:
- Password
- Privileges
- User class
- Field-level security levels
- Terminal list
Upon entry of the LOGCTL command, the system responds with a prompt in the following form:
*** M204.0374: ENTER FILE/GROUP PASSWORD,PRIVILEGES,CLASS,SELECT,READ,UPDATE,ADD
The user response would be in this form:
password,X'pppp',ccc,sss,rrr,uuu,aaa
Where:
| password | As of Model 204 version 7.7, a password can contain up to 127 characters, including blanks and special characters.
Note: Commas in passwords are allowed only when using the LOGONCP command or the $Sir_Login function, but not when using the LOGCTL command. In the case of LOGCTL, comma is the delimiter between arguments. |
|---|---|
| pppp | The two-byte representation of the file privileges. (See the PRIVDEF parameter.) |
| ccc | The procedure user class. (See Procedure security.) |
| sss | The field-level security SELECT level. |
| rrr | The field-level security READ level. |
| uuu | The field-level security UPDATE level. |
| aaa | The field-level security ADD level. (For information on field-level security, see Field-level security.) |
When a file entry is being added, the password is required and all other specifications are optional. Model 204 supplies default values of zero.
When a file entry is being changed, all specifications are optional. If the system manager does not supply a specification in the command, the existing specification in the password table is preserved, as described for login user IDs.