LOGFILE command: Difference between revisions
Jump to navigation
Jump to search
(→Syntax) |
|||
| (6 intermediate revisions by 4 users not shown) | |||
| Line 6: | Line 6: | ||
<dd>Lists file entries in the password table, including privileges, but not passwords | <dd>Lists file entries in the password table, including privileges, but not passwords | ||
</dl> | </dl> | ||
==Syntax== | ==Syntax== | ||
<p class="syntax">LOGFILE [< | <p class="syntax">LOGFILE [<span class="term">filename1</span>] [,] [<span class="term">filename2</span>] | ||
</p> | </p> | ||
Where: | |||
<p><var class="term">filename1</var> and <var class="term">filename2</var> are the names of files in the password table.</p> | <p> | ||
<var class="term">filename1</var> and <var class="term">filename2</var> are the names of files in the password table.</p> | |||
<table> | <table> | ||
<tr> <th>If specifying... </th> <th>Model 204 lists...</th> </tr> | <tr class="head"> <th>If specifying... </th> <th>Model 204 lists...</th> </tr> | ||
<tr> <td nowrap>Neither <i>filename1</i> nor <i>filename2</i></td> | |||
<tr> < | |||
<td>All file entries in the password table.</td> </tr> | <td>All file entries in the password table.</td> </tr> | ||
<tr> < | <tr> <td>Only <i>filename1</i></td> | ||
< | <td>Entries for that file.</td> </tr> | ||
</td> </tr> | |||
<tr> < | <tr> <td>Only <i>filename2</i> </td> | ||
< | <td>File entries starting at the beginning of the password table and extending through the file name entry. A comma is required if only <var class="term">filename2</var> is specified. Otherwise, either a comma or one or more blanks can be specified.</td> </tr> | ||
</td> </tr> | |||
<tr> < | <tr> <td>Both <i>filename1</i> and <i>filename2</i> </td> | ||
< | <td>File entries starting at the <var class="term">filename1</var> entry and extending through the <var class="term">filename2</var> entry.</td> </tr> | ||
</td> </tr> | |||
</table> | </table> | ||
| Line 38: | Line 36: | ||
LOGFILE , TCENSUS | LOGFILE , TCENSUS | ||
</p> | </p> | ||
==Usage notes== | ==Usage notes== | ||
<p>The LOGFILE command lists one or more file entries in the password table. The list is produced in alphabetical order.</p> | <p> | ||
<p>Each file entry displayed by LOGFILE has the following format:</p> | The <var>LOGFILE</var> command lists one or more file entries in the password table. The list is produced in alphabetical order.</p> | ||
<p> | |||
Each file entry displayed by <var>LOGFILE</var> has the following format:</p> | |||
<p class="code"><i>filename</i> <i>index</i> <i>password</i> X'<i>pppp</i>' <i>nnn</i>, <i>sss</i>, <i>rrr</i>, <i>uuu</i>, <i>aaa</i>, <i>terminals</i> | <p class="code"><i>filename</i> <i>index</i> <i>password</i> X'<i>pppp</i>' <i>nnn</i>, <i>sss</i>, <i>rrr</i>, <i>uuu</i>, <i>aaa</i>, <i>terminals</i> | ||
</p> | </p> | ||
Where: | |||
<table> | <table> | ||
<tr> | <tr> | ||
<th>filename</th> | <th>filename</th> | ||
<td> | <td>The name of the file. For Model 204 7.5 and later, and for <var class="product">[[SirSafe]]</var> customers before Model 204 7.5, <var class="term">filename</var> is preceded by a colon (<tt>:</tt>) or greater-than sign (<tt>></tt>), as was used on the <var>LOGCTL</var> command that created the entry. A greater-than sign indicates a <var class="product">SirSafe</var>-controlled visible password.</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<th>index</th> | <th>index</th> | ||
<td> | <td>The file index, if more than one file has the same name.</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<th>password</th> | <th>password</th> | ||
<td> | <td>The password for the entry. For non-SirSafe customers, <var class="term">password</var> is not present before Model 204 7.5; in Model 204 7.5 and later, it is always displayed as <code>********</code>. For SirSafe customers, <code>********</code> is displayed for the password if the password is <i>not</i> a SirSafe-controlled password, and the actual password is displayed if it is a SirSafe-controlled password.</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>nnn</th> | <th>nnn</th> | ||
<td> | <td>The procedure user class.</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<th>sss</th> | <th>sss</th> | ||
<td> | <td>The field-level security SELECT level.</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<th>rrr</th> | <th>rrr</th> | ||
<td> | <td>The field-level security READ level.</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<th>uuu</th> | <th>uuu</th> | ||
<td> | <td>The field-level security UPDATE level.</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<th>aaa</th> | <th>aaa</th> | ||
<td> | <td>The field-level security ADD level. (For information on field-level security, see [[Model 204 security features#Field-level security|Field-level security]].)</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<th>terminals</th> | <th>terminals</th> | ||
<td> | <td><var>ALL</var>, <var>NONE</var>, or a list of authorized terminals.</td> | ||
</tr> | </tr> | ||
</table> | </table> | ||
====Sending LOGFILE output to the USE data set==== | ====Sending LOGFILE output to the USE data set==== | ||
< | <ul> | ||
< | <li>If there is an open USE data set, the <var>LOGFILE</var> command output is directed to it. See the <var>[[RESET COMMAND command|RESET COMMAND]]</var> command for a discussion of how to direct the output.</li> | ||
<li>Refer to [[Storing security information (CCASTAT)#Password table data set|Password table data set]] and [[Establishing and maintaining security#File password table maintenance|File password table maintenance]] for a detailed description of the password table.</li> | |||
</ul> | |||
[[Category: System manager commands]] | [[Category: System manager commands]] | ||
[[Category:Commands]] | [[Category:Commands]] | ||
Latest revision as of 12:21, 21 April 2019
Summary
- Privileges
- System manager
- Function
- Lists file entries in the password table, including privileges, but not passwords
Syntax
LOGFILE [filename1] [,] [filename2]
Where:
filename1 and filename2 are the names of files in the password table.
| If specifying... | Model 204 lists... |
|---|---|
| Neither filename1 nor filename2 | All file entries in the password table. |
| Only filename1 | Entries for that file. |
| Only filename2 | File entries starting at the beginning of the password table and extending through the file name entry. A comma is required if only filename2 is specified. Otherwise, either a comma or one or more blanks can be specified. |
| Both filename1 and filename2 | File entries starting at the filename1 entry and extending through the filename2 entry. |
Example
LOGFILE LOGFILE CENSUS LOGFILE CENSUS, TCENSUS LOGFILE , TCENSUS
Usage notes
The LOGFILE command lists one or more file entries in the password table. The list is produced in alphabetical order.
Each file entry displayed by LOGFILE has the following format:
filename index password X'pppp' nnn, sss, rrr, uuu, aaa, terminals
Where:
| filename | The name of the file. For Model 204 7.5 and later, and for SirSafe customers before Model 204 7.5, filename is preceded by a colon (:) or greater-than sign (>), as was used on the LOGCTL command that created the entry. A greater-than sign indicates a SirSafe-controlled visible password. |
|---|---|
| index | The file index, if more than one file has the same name. |
| password | The password for the entry. For non-SirSafe customers, password is not present before Model 204 7.5; in Model 204 7.5 and later, it is always displayed as ********. For SirSafe customers, ******** is displayed for the password if the password is not a SirSafe-controlled password, and the actual password is displayed if it is a SirSafe-controlled password. |
| pppp | The two-byte representation of the file privileges. (See the PRIVDEF parameter.) |
| nnn | The procedure user class. |
| 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.) |
| terminals | ALL, NONE, or a list of authorized terminals. |
Sending LOGFILE output to the USE data set
- If there is an open USE data set, the LOGFILE command output is directed to it. See the RESET COMMAND command for a discussion of how to direct the output.
- Refer to Password table data set and File password table maintenance for a detailed description of the password table.