HPlogo   Configuring and Managing Host-Based X.25 Links:
HP 3000 MPE/iX Computer Systems
> Chapter 8 Formatting Host-Based X.25 Log Files

To Use EVLOG

MPE documents

Complete PDF

 

Table of Contents

Glossary

Index

 

⇓ Page Bottom

⇑ Page Top

 

The EVLOG Formatter

Displaying the Data

You can run EVLOG using default options or you can run EVLOG interactively to select and modify specific options. Instructions for each run mode follow. The options are described in the remainder of this chapter.

To Run EVLOG Using Default Options

Follow these steps to format a host-based X.25 log file using the default options.
  1. Copy the file that you want to format to a different file name. (Hewlett-Packard recommends that you treat log files as read-only files. Copying to a new file name allows you to format the new file without modifying the original log file.)
  2. At the MPE/iX prompt, enter the command:

    :evlog logfilename

    where logfilename is the name of the file created in step 1.
These steps will cause the entire log file to be formatted with default options.

To Run EVLOG Interactively

Follow these steps to format a host-based X.25 log file, to select options:
  1. Copy the file that you want to format to a different file name. (Hewlett-Packard recommends that you treat log files as read-only files. Copying to a new file name allows you to format the new file without modifying the original log file.)
  2. At the MPE/iX prompt, enter either of the following commands:

    :evlog

    or

    :evlog logfilename,n

    where logfilename is the name of the file created in step 1 and n is any non-zero PARM. For example

    :evlog myfile,2

    The following display will appear:

         EVLOG C.00.00 001
         File type = 7 (Version = A1200D00)
 Options:

   0 — Set all options back to their default values (MYFILE 0 records)
   1 — File                                  (1..0)
   2 — Records                               (ALL)
   3 — Event types                           (ALL)
   4 — Subsystems                            (1..2147483647)
   5 — Event Codes                           (ALL)
   6 — Logical Channel Identifier (LCI)      (ALL)
   7 — Virtual Port Number (VPN)             (HOST time)
   8 — Time/offset format                    (70-01-01-00-00-00...
   9 — Time/offset (1970-2020)                20-01-01-00-00-00)

   ? — Redisplay current options

 Each number of option or <CR> to select current options:
  

To Select Formatting Options

To select the formatting option that you want to change when running EVLOG interactively, type the option number at the prompt. EVLOG will then prompt you to enter additional information. The information required depends on the option selected. Brackets displaying the current setting of the option are included in the prompt. Each of the options is described, each description includes an example of the option's use. User input is bold.

Note
NOTE: The formatter will use default values for any options not specified by the user. The default values are listed in parentheses beside each of the options.

Option 1: File

Use this option to open an event log file, if you did not specify a log file name on the command line. Whenever a file is opened, the File option will reflect file name and the number of records in the file. In the following example, the log file logfile1, contains 15 records.

 Enter number of option or <CR> to select current options: 1
 Event log name []? logfile1
 Options:

   0 —      Set all options back to their default values
   1 —      File                                (logfile1, 15 records)
   2 —      Records                             (1..0)
   . —      .     .     .     .     .     .     .     .     .     .
   . —      .     .     .     .     .     .     .     .     .     .
   . —      .     .     .     .     .     .     .     .     .     .
  

Option 2: Records

Use this option to select which record numbers to display. In the following example, the user chooses to display records 2 through 5 of the opened log file. Notice that the Records option displays the records that were selected.

 Enter number of option or <CR> to select current options: 2

 First record [1]? 2
 Last record [15]? 5

 Options:

   0 —      Set all options back to their default values
   1 —      File                                (logfile1, 15 records)
   2 —      Records                             (2..5)
   . —      .     .     .     .     .     .     .     .     .     .
   . —      .     .     .     .     .     .     .     .     .     .
   . —      .     .     .     .     .     .     .     .     .     .
  

Option 3: Event Types

Use this option to restrict the records displayed to those of a specific event type. In the following example, the user chooses to display only DTC events. Following the selection, the Event types option displays a 3, to signify the selection of event type 3, DTC events. (Note that not all of the event types are meaningful for log files on host-based systems.)

 Enter number of option or <CR> to select current options: 3

 Event types:

   0 —      ALL
   1 —      PC
   2 —      PC/DTC
   3 —      DTC

 Event type [ALL]? 3

 Options:

   0 —      Set all options back to their default values
   1 —      File                                (logfile1, 15 records)
   2 —      Records                             (2..5)
   3 —      Event types                         (3)
   . —      .     .     .     .     .     .     .     .     .     .
   . —      .     .     .     .     .     .     .     .     .     .
   . —      .     .     .     .     .     .     .     .     .     .
  

Option 4: Subsystems

Use this option to restrict the records displayed to those of a particular subsystem. In the following example, the user selects the NMP subsystem. Following the selection, the Subsystem option displays a 4, to signify the selection of subsystem 4, NMP. (Note that not all of the subsystem types are meaningful for log files on host-based systems.)

 Enter number of option or <CR> to select current options: 4

 Subsystem numbers:

   0 —      All            4 —     NMP               8 —     OS
   1 —      Windows        5 —     NMLIB             9 —     RLS
   2 —      TICL           6 —     IOIF              10 —    UI
   3 —      RMP            7 —     PROBE             11 —    OV

 Subsystem[ALL]? 4

 Options:

   0 —      Set all options back to their default values
   1 —      File                                (logfile1, 15 records)
   2 —      Records                             (1..0)
   3 —      Event types                         (3)
   4 —      Subsystems                          (4)
   . —      .     .     .     .     .     .     .     .     .     .
   . —      .     .     .     .     .     .     .     .     .     .
   . —      .     .     .     .     .     .     .     .     .     .
  

Option 5: Event Codes

Use this option to specify a range of event codes to be displayed. To specify the codes, you may enter either the event code numbers or the mnemonics listed in the prompt display. (The Options display will list the event code numbers whether you select by number or by mnemonic.) In the following example, the user chooses X.25 events by entering the mnemonic X25. Notice that the event code numbers are shown in the resulting display.

 Enter number of option or <CR> to select current options: 5

 Event code mnemonics (use for First event code if desired:

   COM           (Common events)                 =            1 —  511
   AOS           (AOS events)                    =          512 — 1023
   MGR           (MANAGER)                       =         1024 — 1279
   LAN                                           =         1280 — 1525
   AFCP                                          =         1536 — 1791
   ADCP                                          =         1792 — 2303
   TNR                                           =         2304 — 2559
   LNK           (LINKMGR)                       =         2560 — 2815
   TCP                                           =         2816 — 3071
   IP                                            =         3072 — 3327
   EXT           (MGR_Extension events)          =         3328 — 3583
   L3            (X.25 level 3 events)           =         3584 — 4095
   L2            (X.25 level 2 events)           =         4096 — 4607
   PAD           (X.25 PAD events)               =         4608 — 5119
   MON           (Monitor events)                =         5120 — 5631
   X25           (L2 + L3 events)                =         3584 — 4607
   X25PAD        (X.25 + PAD events)             =         3584 — 5119

 Event code range: First event code [1]? X25

 Options:

   0 —      Set all options back to their default values
   1 —      File                                (logfile1, 15 records)
   2 —      Records                             (2..5)
   3 —      Event types                         (3)
   4 —      Subsystems                          (4)
   5 —      Event codes                         (3584..4607)
   . —      .     .     .     .     .     .     .     .     .     .
   . —      .     .     .     .     .     .     .     .     .     .
   . —      .     .     .     .     .     .     .     .     .     .
   

Option 6: Logical Channel Identifier (LCI)

Use this option to restrict the records displayed to those for a specific Logical Channel Identifier. In the following example, the user presses [RETURN] to accept the default of displaying all records.

 Enter number of option or <CR> to select current options: 6

 Logical Channel Identifier (LCI) (1-256 0 = ALL) [ALL]?

 Options:

   0 —      Set all options back to their default values
   1 —      File                                (logfile1, 15 records)
   2 —      Records                             (2..5)
   3 —      Event types                         (3)
   4 —      Subsystems                          (4)
   5 —      Event codes                         (3584..4607)
   6 —      Logical Channel Identifier (LCI)    (ALL)
   . —      .     .     .     .     .     .     .     .     .     .
   . —      .     .     .     .     .     .     .     .     .     .
   . —      .     .     .     .     .     .     .     .     .     .
  

Option 7: Virtual Port Number (VPN)

Use this option to restrict the records displayed to those for a particular virtual port number (VPN). (Some PAD events contain the VPN but not the corresponding LCI; some X.25 events contain the LCI but not the VPN. However, some X.25 events contain both, so usually you can logically tie the two together.) In the following example, the user presses [RETURN] to accept the default of displaying all records.

 Enter number of option or <CR> to select current options: 7

 Logical Channel Identifier (LCI) (1—255 0 = ALL) [ALL]?

 Options:
   0 —      Set all options back to their default values
   1 —      File                                (logfile1, 15 records)
   2 —      Records                             (2..5)
   3 —      Event types                         (3)
   4 —      Subsystems                          (4)
   5 —      Event codes                         (3584..4607)
   6 —      Logical Channel Identifier (LCI)    (ALL)
   7 —      Virtual Port Number (VPN)           (ALL)
   . —      .     .     .     .     .     .     .     .     .     .
   . —      .     .     .     .     .     .     .     .     .     .
   . —      .     .     .     .     .     .     .     .     .     .
  

Option 8: Time/Offset Format

There are four types of timestamps in event log records. They are:
HOST time

The time the event was logged on the host (HP 3000). Found in event type 3 (DTC).

PC time

The time the event was logged on the OV DTC MGR PC. (This type is not meaningful for log files created on systems using host-based network management.)

DTC CPU time

The time the event was sent from the DTC. Found in event type 3 (DTC).

DTC SNP time

The time the event occurred on the SNP. Found in event type 3 (DTC)
Use this option to choose whether one of these timestamp types will be displayed under the column labeled "Time/offset" or whether the offset will be from the beginning of the file. In the example that follows, the user chooses to display the time that events were logged on the host.

 Enter number of option or <CR> to select current options: 8

 Time formats:

   1 —      HOST
   2 —      PC
   3 —      DTC CPU
   4 —      DTC SNP
   5 —      Record offset

 Time format [1]? 1

 Options:

   0 —      Set all options back to their default values
   1 —      File                                (logfile1, 15 records)
   2 —      Records                             (2..5)
   3 —      Event types                         (3)
   4 —      Subsystems                          (4)
   5 —      Event codes                         (3584..4607)
   6 —      Logical Channel Identifier (LCI)    (ALL)
   7 —      Virtual Port Number (VPN)           (ALL)
   8 —      Time/offset format                  (Host time)
   . —      .     .     .     .     .     .     .     .     .     .
   . —      .     .     .     .     .     .     .     .     .     .
  

Option 9: Time/Offset

Use this option to specify a range of time to be displayed. This option is available only for the HOST time. In the following example, the user selects a time range from October 4 through October 5 of 1991 by responding to the series of prompts. Note that, as usual, the current settings are displayed in brackets in the prompts.

 Enter number of option or <CR> to select current options: 9

 HOST time range:

  FROM                year           [1970]? 1991
                      month          [1]? 10
                      day            [1]? 4
                      hour           [0]? 11
                      min            [0}?
                      sec            [0]?

  TO:                 year           [2020]? 1991
                      month          [1]? 10
                      day            [1]? 5
                      hour           [0]?
                      min            [0]?
                      sec            [0]?

 Options:

   0 —      Set all options back to their default values
   1 —      File                                (logfile1, 15 records)
   2 —      Records                             (2..5)
   3 —      Event types                         (3)
   4 —      Subsystems                          (4)
   5 —      Event codes                         (3584..4607)
   6 —      Logical Channel Identifier (LCI)    (ALL)
   7 —      Virtual Port Number (VPN)           (ALL)
   8 —      Time/offset format                  (Host time)
   9 —      Time/offset (1970 — 2020))          (70-01-01-00-00-00...
                                                 20-01-01-00-00-00)
   ? —      Redisplay current options

 Enter number of option or <CR> to select current options:
  



The EVLOG Formatter

Displaying the Data