LOGFILE command: Difference between revisions

From m204wiki
Jump to navigation Jump to search
 
(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 [<i>filename1</i>] [<i>filename2</i>]
<p class="syntax">LOGFILE [<span class="term">filename1</span>] [,] [<span class="term">filename2</span>]
</p>
</p>
   
   
<b>Where:</b>
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&nbsp;204 lists...</th> </tr>
<tr class="head"> <th>If specifying... </th> <th>Model&nbsp;204 lists...</th> </tr>
 
<tr> <td nowrap>Neither <i>filename1</i> nor <i>filename2</i></td>  
<tr> <th><var>Neither</var> filename1 <var>nor</var> filename2</th>  
<td>All file entries in the password table.</td> </tr>
<td>All file entries in the password table.</td> </tr>
   
   
<tr> <th><var>Only</var> filename1</th> <td>
<tr> <td>Only <i>filename1</i></td>  
<p>Entries for that file.</p>
<td>Entries for that file.</td> </tr>
</td> </tr>
   
   
<tr> <th><var>Only</var> filename2 </th> <td>
<tr> <td>Only <i>filename2</i> </td>  
<p>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.</p>
<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> <th><var>Both</var> filename1 <var>and</var> filename2 </th> <td>
<tr> <td>Both <i>filename1</i> and <i>filename2</i> </td>  
<p>File entries starting at the <var class="term">filename1</var> entry and extending through the <var class="term">filename2</var> entry.</p>
<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>
   
   
<b>Where:</b>
Where:
<table>  
<table>  
<tr>
<tr>
<th>filename</th>
<th>filename</th>
<td> is the name of the file. For Model 204 7.5 and later and for SirSafe customers before Model 204 7.5, the filename will be preceded by a colon as was used on the LOGCTL command that created the entry.</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> is the file index if more than one file has the same name.</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> is the password for the entry. For non-SirSafe customers, password would not be be present before Model 204 7.5 and would always be displayed as ******** in Model 204 7.5 and later. For SirSafe customers, ******** would be displayed for the password if the password is not a SirSafe controlled password and the actual password will be displayed if it is a SirSafe controlled password.</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> is the two-byte representation of the file privileges. (See [[PRIVDEF parameter|PRIVDEF: Default user privileges]].)</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> is the procedure user class.</td>
<td>The procedure user class.</td>
</tr>
</tr>
   
   
<tr>
<tr>
<th>sss</th>
<th>sss</th>
<td> is the field-level security SELECT level.</td>
<td>The field-level security SELECT level.</td>
</tr>
</tr>
   
   
<tr>
<tr>
<th>rrr</th>
<th>rrr</th>
<td> is the field-level security READ level.</td>
<td>The field-level security READ level.</td>
</tr>
</tr>
   
   
<tr>
<tr>
<th>uuu</th>
<th>uuu</th>
<td> is the field-level security UPDATE level.</td>
<td>The field-level security UPDATE level.</td>
</tr>
</tr>
   
   
<tr>
<tr>
<th>aaa</th>
<th>aaa</th>
<td> is the field-level security ADD level. (For information on field-level security, see the <var class="product">Model&nbsp;204</var> File Manager's Guide.)</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> is ALL, NONE, or a list of authorized terminals.</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====
<p>If there is an open USE data set, the LOGFILE command output is directed to it. See [[RESET COMMAND command|RESET COMMAND: Control USE data set support]] for a discussion of how to direct the output.</p>
<ul>
<p>Refer to the <var class="product">Model&nbsp;204</var> System Manager's Guide for a detailed description of the password table.</p>
<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