Liren Large Software Subsidy 14/14.iso/s/s005/16.ddi/RAS/OS2_HELP_SYSLOGH.HLP

OS/2 Help File | 1993-04-22 | 15.0 KB | 465 lines

ΓòÉΓòÉΓòÉ <hidden> Help for SYSLOG ΓòÉΓòÉΓòÉ

Use the OS/2 System Log File Formatter (SYSLOG) to view or print the formatted
contents of the system error log file. You can also use SYSLOG to suspend or
resume error logging or redirect error logging data from one file to another.

Related information: Using SYSLOG

For a detailed explanation of each field, select from the list below:

o Next Rec
o Prev Rec


ΓòÉΓòÉΓòÉ <hidden> Help for Prev Rec ΓòÉΓòÉΓòÉ

Select the Prev Rec pushbutton to format the record that precedes the one that
is being viewed.


ΓòÉΓòÉΓòÉ <hidden> Help for Next Rec ΓòÉΓòÉΓòÉ

Select the Next Rec pushbutton to format the record that follows the one that
is being viewed.


ΓòÉΓòÉΓòÉ <hidden> Using SYSLOG ΓòÉΓòÉΓòÉ

The following are some important facts to know about the SYSLOG Utility.

o You must include "RUN = LOGDAEM.EXE" and "DEVICE = LOG.SYS" statements in the
  CONFIG.SYS file to use SYSLOG.  These two commands along with specifying
  parameters allow the System Logging Service to retrieve log data and keep the
  data in specific error logging files.  Refer to the Command Reference for
  more information about these commands.
o The "RUN = LOGDAEM.EXE" command controls the start of the Logging Daemon
  process.  You need to specify, in the CONFIG.SYS file, the path and file name
  where the error logging data is to be placed. This file in the CONFIG.SYS
  file is called the local error log file and requires the /E parameter.  For
  example, to specify C:\OS2\SYSTEM as the path for the error log file
  LOG0001.DAT, type the following in the CONFIG.SYS file:

    RUN=C:\OS2\SYSTEM\LOGDAEM.EXE /E:C:\OS2\SYSTEM\LOG0001.DAT

o The "DEVICE = LOG.SYS" command activates the System Logging Service device
  driver.  For example:

    DEVICE=C:\OS2\LOG.SYS

o The formatted contents of the file are displayed a record at a time in the
  main window of the utility. This area is divided into two logical parts:

   - System area - The area of the window that contains information supplied by
     the system and the OS/2 Error Logging Facility.  This includes: record ID,
     date, time, status, originator's name, and process name.
   - Record defined area - The area that is used to format variable data as
     specified by the formatting template.  If you specified no templates for a
     given record and the record is not one of the record IDs recognized by the
     utility, the variable data is displayed in hexadecimal on the left side of
     the window and in ASCII on the right.

o If the current system log file has no records, an information panel is
  displayed informing you of the log file status.  Otherwise, the last record
  in the current error log file is displayed.

If the log file has records in it, you can select the Next Rec or Prev Rec
pushbutton to move through the log file.


ΓòÉΓòÉΓòÉ 1. Help for File ΓòÉΓòÉΓòÉ

Use the choices on the File menu to:

o Open and view the contents of a system error log file
o Print the contents of a system error log file
o Change the current error log file to a different file
o Give SYSLOG access to recent changes in the active error log file
o Exit the SYSLOG Utility program.


ΓòÉΓòÉΓòÉ 2. Help for View ΓòÉΓòÉΓòÉ

Use View to select the Display file header information and Display error
logging summary choices on the menu.


ΓòÉΓòÉΓòÉ 3. Help for Options ΓòÉΓòÉΓòÉ

Use Options to select the Suspend error logging and Display options choices on
the menu.


ΓòÉΓòÉΓòÉ 4. Help for Open ΓòÉΓòÉΓòÉ

Use Open to indicate which error log file you want to view.


ΓòÉΓòÉΓòÉ 5. Help for Print ΓòÉΓòÉΓòÉ

Use Print to display a list of all available system printers on which you can
print the error log file.


ΓòÉΓòÉΓòÉ 6. Help for Change Error Log File ΓòÉΓòÉΓòÉ

Use Change error log file to choose a new target error log path and file name.
You can select this choice to display a window where you can change the error
log file specified in the CONFIG.SYS file (local error log file) to a new path
and file name that you specify using this window.  This file is called the
remote error log file.


ΓòÉΓòÉΓòÉ <hidden> Help for Refresh ΓòÉΓòÉΓòÉ

Use Refresh to format any error log records that have been received since the
utility was started or since the last refresh (update).


ΓòÉΓòÉΓòÉ <hidden> Help for Exit ΓòÉΓòÉΓòÉ

Use Exit to close the SYSLOG program.


ΓòÉΓòÉΓòÉ 7. Help for Display File Header Information ΓòÉΓòÉΓòÉ

Use Display file header information to display control information that is
maintained in the error log file header block.  Select this choice to display a
window containing this error log file information.


ΓòÉΓòÉΓòÉ 8. Help for Display Error Logging Summary ΓòÉΓòÉΓòÉ

Use Display error logging summary to display important dynamic control
information that is maintained by the Logging Daemon process about the current
state of error logging.  Select this choice to display a window containing this
error logging information.


ΓòÉΓòÉΓòÉ 9. Help for Display File Header Information ΓòÉΓòÉΓòÉ

Information on this window includes the following:

o The Error Log File Revision for OS/2 2.1 is 1.  This is the first revision of
  the Error Log File Formatter.
o The Error Log File Size field specifies the current size of the system error
  log file.
o The Maximum Error Log File Size field specifies the size,in KB, at which the
  error log file will wrap.  Additional records will be written at the
  beginning of the log file overwriting the existing records.
o The Times File Wrapped field displays the number of times the error log file
  reached its size limit and had to overwrite existing records.
o The Last Date File Wrapped field displays the last calendar date the error
  log file exceeded its size limit.
o The Last Time File Wrapped field displays the last time of day the error log
  file reached its size limit and had to overwrite existing records.


ΓòÉΓòÉΓòÉ <hidden> Wrap: ΓòÉΓòÉΓòÉ

A file will wrap when the error log file can hold no more records and begins
overwriting the first record.  This means the error log file has reached its
maximum size and you need to specify another file as the error log file where
subsequent records can be logged.  Use the Change Error Log File window to
specify additional error log files.  You can specify the size of the error log
file in the CONFIG.SYS file.


ΓòÉΓòÉΓòÉ 10. Help for Display Error Logging Summary ΓòÉΓòÉΓòÉ

Information on this window includes the following:

o The Current Logging Status field displays the current logging status of the
  Error Logging facility.  There are three possible states for error logging:

   - Active
   - Suspended
   - Uninitialized

o The Local Error Log File field displays the file name of the local error log
  file.
o The Remote Error Log File field displays the file name of the remote error
  log file.
o The Date of Logging Start field displays the calendar date (after the most
  recent system startup) system error logging began.
o The Time of Logging Start field shows the time of day (after the most recent
  system startup) system error logging began.
o The Entries Logged to Local Log field displays the number of entries logged
  into the local error log file since the date and time shown in the date and
  time fields.
o The Entries Logged to Remote Log field displays the number of entries logged
  into the remote error log file since the date and time shown in the date and
  time fields.

Log entries are logged into the local error log file until you redirect them to
a remote error log file.  If errors occur during the time you are redirecting
them to the remote log file, the entries are written to the local error log
file.


ΓòÉΓòÉΓòÉ <hidden> Local Error Log File: ΓòÉΓòÉΓòÉ

The local error log file is the file specified in the CONFIG.SYS file where
error log entries are to be logged.


ΓòÉΓòÉΓòÉ <hidden> Remote Error Log File: ΓòÉΓòÉΓòÉ

The remote error log file is the file you have specified to be the file where
error log entries are to be logged.  You use the Change Error Log File window
to change the error logging file from the local file in the CONFIG.SYS to the
remote file you specify.


ΓòÉΓòÉΓòÉ 11. Help for Suspend Error Logging ΓòÉΓòÉΓòÉ

Use Suspend error logging to switch the status of the Error Logging Facility
between an active and suspended state.  When the facility is in a suspended
state, a check mark appears.


ΓòÉΓòÉΓòÉ 12. Help for Display Options ΓòÉΓòÉΓòÉ

Use Display options to indicate what records from the error log file you want
to format.  You can select records using the following search criteria:

o Qualifier

o Starting record I.D.

o Ending record I.D.

o Starting date

o Ending date

o Starting time

o Ending time.


ΓòÉΓòÉΓòÉ <hidden> Help for Open ΓòÉΓòÉΓòÉ

 1. Select the down arrow to the right of the Drive list to display all the
    drives on your system.
 2. Select a drive from the Drive list.
 3. Select a directory from the Directory list.
 4. Select a file name from the File list or type in a file name and select the
    Open pushbutton to display the file you want to view.

For a detailed explanation of each field, select from the list below:

o Open filename
o Type of file
o Drive
o File
o Directory
o Open pushbutton
o Cancel pushbutton


ΓòÉΓòÉΓòÉ <hidden> Help for Open Filename ΓòÉΓòÉΓòÉ

Type the name of the file you want to open in the Open filename field and
select the Open pushbutton.


ΓòÉΓòÉΓòÉ <hidden> Help for Type of File ΓòÉΓòÉΓòÉ

Select the down arrow to the right of the Type of file field to display the
available file types.  Log files can be of any type.


ΓòÉΓòÉΓòÉ <hidden> Help for Drive ΓòÉΓòÉΓòÉ

The Drive list displays the drives on your system.  Select the drive that
contains the log files you want to view.


ΓòÉΓòÉΓòÉ <hidden> Help for File ΓòÉΓòÉΓòÉ

The File list displays all the files in the directory you selected from the
Directory list.  Select the file you want to open.


ΓòÉΓòÉΓòÉ <hidden> Help for Directory ΓòÉΓòÉΓòÉ

The Directory list displays the directories on the selected drive.  Select a
directory to display the list of files from that directory in the File list
box.


ΓòÉΓòÉΓòÉ <hidden> Help for Open ΓòÉΓòÉΓòÉ

Select the Open pushbutton to view the file you selected.  The file must be an
error log file.


ΓòÉΓòÉΓòÉ <hidden> Help for Cancel ΓòÉΓòÉΓòÉ

Select the Cancel pushbutton if you decide not to change the current settings.


ΓòÉΓòÉΓòÉ <hidden> Help for Print ΓòÉΓòÉΓòÉ

 1. Select a printer from the printer list.
 2. Select the Print pushbutton.

For a detailed explanation of each field, select from the list below:

o Printer
o Print pushbutton


ΓòÉΓòÉΓòÉ <hidden> Help for Printer ΓòÉΓòÉΓòÉ

This list shows the printers you can use.


ΓòÉΓòÉΓòÉ <hidden> Help for Print ΓòÉΓòÉΓòÉ

Select the Print pushbutton to print the error log file.


ΓòÉΓòÉΓòÉ <hidden> Help for Change Error Log File ΓòÉΓòÉΓòÉ

 1. Select the down arrow to the right of the Drive list to display all the
    drives on your system.
 2. Select a drive from the Drive list.
 3. Select a directory from the Directory list.
 4. Select a file name from the File list or type in a file name and select the
    OK pushbutton to have the error log file changed to the file you have
    specified.

For a detailed explanation of each field, select from the list below:

o File name
o Type of file
o Drive
o File
o Directory
o OK pushbutton
o Cancel pushbutton


ΓòÉΓòÉΓòÉ <hidden> Help for File Name ΓòÉΓòÉΓòÉ

Type the name of the file you want to be the error log file in the File name
field and select the OK pushbutton.


ΓòÉΓòÉΓòÉ <hidden> Help for Type of File ΓòÉΓòÉΓòÉ

Select the down arrow to the right of the Type of file field to display the
available file types.  Log files can be of any type.


ΓòÉΓòÉΓòÉ <hidden> Help for Drive ΓòÉΓòÉΓòÉ

The Drive list displays the drives on your system.  Select the drive that
contains the file you want to be the error log file.


ΓòÉΓòÉΓòÉ <hidden> Help for File ΓòÉΓòÉΓòÉ

The File list displays all the files in the directory you selected from the
Directory list.  Select the file you want to be the error log file.


ΓòÉΓòÉΓòÉ <hidden> Help for Directory ΓòÉΓòÉΓòÉ

The Directory list displays the directories on the selected drive.  Select a
directory to display the list of files from that directory in the File list
box.


ΓòÉΓòÉΓòÉ <hidden> Help for OK ΓòÉΓòÉΓòÉ

Select the OK pushbutton to change the error log file to the the file you have
specified.


ΓòÉΓòÉΓòÉ <hidden> Help for Display Options ΓòÉΓòÉΓòÉ

 1. Select the criteria on which records will be selected from the log file.
    You can select one or more records based on their date, time, record I.D.,
    or qualifier tag.
 2. Select the Display pushbutton.

For a detailed explanation of each field, select from the list below:

o Qualifier
o Starting record I.D.
o Ending record I.D.
o Starting date
o Ending date
o Starting time
o Ending time
o Display pushbutton
o Cancel pushbutton


ΓòÉΓòÉΓòÉ <hidden> Help for Qualifier ΓòÉΓòÉΓòÉ

Enter a qualifier to include only those records whose tag matches the
qualifier.  A qualifier is a four-byte ASCII string.


ΓòÉΓòÉΓòÉ <hidden> Help for Starting Record I.D. ΓòÉΓòÉΓòÉ

Enter the starting record I.D. of the error log entries you want to be
displayed.


ΓòÉΓòÉΓòÉ <hidden> Help for Ending Record I.D. ΓòÉΓòÉΓòÉ

Enter the ending record I.D. of the error log entries you want to be displayed.


ΓòÉΓòÉΓòÉ <hidden> Help for Starting Date ΓòÉΓòÉΓòÉ

Enter the starting date to include only those records that were logged on or
after that date.  Enter the starting date in the format specified for your
country.


ΓòÉΓòÉΓòÉ <hidden> Help for Ending Date ΓòÉΓòÉΓòÉ

Enter the ending date to include only those records logged on or before that
date.  Enter the ending date in the format specified for your country.


ΓòÉΓòÉΓòÉ <hidden> Help for Starting Time ΓòÉΓòÉΓòÉ

Enter the starting time to include only those records logged on or after that
time.  Enter the starting time in a 24 hour format.  Use the separators
specified for your country.


ΓòÉΓòÉΓòÉ <hidden> Help for Ending Time ΓòÉΓòÉΓòÉ

Enter the ending time to include only those records logged on or before that
time.  Enter the ending time in a 24 hour format.  Use the separators specified
for your country.


ΓòÉΓòÉΓòÉ <hidden> Help for Display ΓòÉΓòÉΓòÉ

Select the Display pushbutton to display the error log file that you want to
view.


ΓòÉΓòÉΓòÉ <hidden> Key Assignments for SYSLOG ΓòÉΓòÉΓòÉ

When two key names are joined by a plus sign (+), use these two keys together.
Hold down the first key and press the second key.

F7
     Display the next record from the log file
F8
     Display the previous record from the log file

Related information:

Key Assignments