HP 3000 Manuals

Formatting Options [ Using the Node Management Services (NMS) Utilities ] MPE/iX 5.0 Documentation


Using the Node Management Services (NMS) Utilities

Formatting Options 

NMDUMP allows you to modify formatting options for specified subsystem
IDs.  There are three ways to change the formatting menu options.

   *   Most options toggle between two possible values, like YES or NO
       and ON or OFF.

   *   Some require you to enter an option number which then displays an
       additional menu and prompt.

   *   Several options prompt you to enter the numbers of certain items.

The following tables show the options for logging and tracing.  Some
logging and tracing options also have filters you can specify.  Table 7-4
shows these filters.

You may type // at any of the main NMDUMP prompts to exit the program.
If NMDUMP is displaying a subsystem menu, you must press [RETURN] to exit
the menu and return to the main NMDUMP prompt before typing // to exit
the program.

You may also type "Help" at any of the main NMDUMP prompts for help text.

Link Subsystem Formatting 

The link manager subsystem does not call any menus.  NMDUMP formats
logging messages only.  The first line labels the error as a link manager
error, and shows whether it is fatal or non-fatal.  The next line
contains the time and date of the event.  This line is followed by the
log message, the requestor ID, the link name, and the logical device
(LDEV) of the link.

The requestor ID is for internal use only.  Any underlying errors are
reported below the LDEV field.  Many messages correspond to NMERR
messages that are documented in Appendix A of this manual.

          Table 7-1.  General Options 

-------------------------------------------------------------------------------
|                                                                             |
|     Subsystem      Option      Meaning                Description           |
|                                                                             |
-------------------------------------------------------------------------------
|                                                                             |
| 802.3, 802.5,      ?      Redisplay Options  Displays current options.      |
| SDLC, LAP-B,                                 Additional input OK.           |
| RJE/BSC                                                                     |
|                                                                             |
| FDDI                                                                        |
|                                                                             |
|                    0      Set Defaults       Set all options back to        |
|                                              default values.                |
|                                                                             |
-------------------------------------------------------------------------------
|                                                                             |
| NETXPORT, NetIPC,  1      ASCII ON or OFF    ON = ASCII representation of   |
| Network Services                             data (OCTAL). OFF =            |
|                                              Hexadecimal representation.    |
|                                              Default = ON.                  |
|                                                                             |

|                    2      Output Format      Automatically changes output   |
|                                              format to HEX if currently in  |
|                                              OCTAL or OCTAL if currently in |
|                                              HEX.                           |
|                                                                             |
|                    3      Maximum Number     Allows a limit to the amount   |
|                                              of data printed in the         |
|                                              information and data sections  |
|                                              by reducing the number of      |
|                                              bytes per record to output.    |
|                                                                             |
|                    4      Verbosity          LOW = Summary, gives the       |
|                                              formatted header and raw       |
|                                              messages only.  HIGH = Detail. |
|                                              Automatically changes LOW to   |
|                                              HIGH or HIGH to LOW.           |
|                                                                             |
-------------------------------------------------------------------------------

          Table 7-2.  Log Options 

-------------------------------------------------------------------------------
|                                                                             |
|     Subsystem      Option      Meaning                Description           |
|                                                                             |
-------------------------------------------------------------------------------
|                                                                             |
| 802.3, 802.5, FDDI 1      Linknames          Select logging options by      |
|                                              Linknames.  @ = ALL            |
|                                                                             |
|                    2      Excluded Linknames Select Linkname to be excluded |
|                                              from logging.                  |
|                                                                             |
|                    3      Log Classes        Error message options (ERRORS, |
|                                              WARNINGS, INFO, ALL)           |
|                                                                             |
|                    4      Set Output Level   Toggle between Terse and       |
|                                              Verbose.  Verbose = Detail     |
|                                              report, Terse = Summary.       |
|                                                                             |
-------------------------------------------------------------------------------
|                                                                             |
| SDLC, LAP-B,       1      Linknames          Select logging options by      |
| RJE/BSC                                      Linknames.  @ = ALL            |
|                                                                             |
|                    2      Class Selection    10 = Errors, 12 =              |
|                                              Informational, 99 = ALL        |
|                                                                             |
-------------------------------------------------------------------------------
|                                                                             |
| NetIPC, Network    5      Class Selection    Show LOG formatter memo with   |
| Services, NETXPORT                           LOG classes configured within  |
|                                              NMMGR.                         |
|                                                                             |
|                    6      Entity or Module   Select specific entities       |
|                                              (NETXPORT) or modules (NS) to  |
|                                              format for logging.            |
|                                                                             |
|                    7      Event or PIN       Select event (NETXPORT) or PIN |
|                                              (NetIPC, NS) where error       |
|                                              occurred.                      |
|                                                                             |

| NETXPORT Only      8      Port ID or PIN     Select a Port ID or PIN in     |
|                                              hexadecimal format.  Default = |
|                                              OFF.                           |
|                                                                             |
|                    9      Display Summary    Allows a summary report of log |
|                           Output             entries either in additions to |
|                                              or instead of the normal       |
|                                              formatting of log entries.     |
|                                              Default = OFF.                 |
|                                                                             |
|                    10     Save or Use Filter Allows saving of the filter    |
|                           File               option definitions to a file   |
|                                              for later use or using         |
|                                              previously saved filter file.  |
|                                              1= Use filter file, 2= Save    |
|                                              filter file.                   |
|                                                                             |
| Link                      No options                                        |
|                                                                             |
-------------------------------------------------------------------------------

          Table 7-3.  Trace Options 

-------------------------------------------------------------------------------
|                                                                             |
|     Subsystem      Option      Meaning                Description           |
|                                                                             |
-------------------------------------------------------------------------------
|                                                                             |
| 802.3, 802.5, FDDI 1      Change Filters     Allows definition of what      |
|                                              characters each packet must    |
|                                              match before it will be        |
|                                              formatted.                     |
|                                                                             |
|                    2      Change Output      Allows reduction of output by  |
|                           Flags              selecting which parts of       |
|                                              filtered packets to format.    |
|                                                                             |
-------------------------------------------------------------------------------
|                                                                             |
| NETXPORT, NetIPC,  5      Type or Descriptor Format events for a particular |
| Network Services                             type (NETXPORT) or descriptor  |
|                                              number (NetIPC, NS).           |
|                                                                             |
|                    6      Entity or Service  Format events for a particular |
|                                              entity (NETXPORT) or service   |
|                                              (NS).                          |
|                                                                             |
|                    7      Event or PIN       Format events for a particular |
|                                              event (NETXPORT) or PIN        |
|                                              (NetIPC, NS). Call for network |
|                                              services displayed.            |
|                                                                             |
|                    8      Port ID or PIN     Select a Port ID or PIN in     |
|                                              hexadecimal format.  Default = |
|                                              OFF.                           |
|                                                                             |
|                    9      Display Summary    Allows a summary report of log |
|                           Output             entries either in additions to |
|                                              or instead of the normal       |
|                                              formatting of log entries.     |
|                                              Default = OFF.                 |
|                                                                             |

|                    10     Save or Use Filter Allows saving of the filter    |
|                           File               option definitions to a file   |
|                                              for later use or using         |
|                                              previously saved filter file.  |
|                                              1= Use filter file, 2= Save    |
|                                              filter file.                   |
|                                                                             |
|                    11     Source IP Address  Allows specification of a      |
|                                              source IP address for header   |
|                                              trace messages.  Default =     |
|                                              OFF.                           |
|                                                                             |
|                    12     Destination IP     Allows specification of a      |
|                           Address            destination IP address for     |
|                                              header trace messages.         |
|                                                                             |
|                    13     Source TCP Port    Allows specification of a      |
|                                              source TCP address for header  |
|                                              trace messages.                |
|                                                                             |
| NS Only            14     Destination IPC    Allows specification of a      |
|                           Port NS Messages   destination TCP address for    |
|                                              header trace messages.  ON =   |
|                                              NS messages displayed.  OFF =  |
|                                              NetIPC intrinsic calls for     |
|                                              Network services displayed.    |
|                                                                             |
-------------------------------------------------------------------------------

          Table 7-3.  Trace Options (continued) 

-------------------------------------------------------------------------------
|                                                                             |
|     Subsystem      Option      Meaning                Description           |
|                                                                             |
-------------------------------------------------------------------------------
|                                                                             |
| SDLC, LAP-B,       1      Output Limit       Allow input of maximum bytes   |
| RJE/BSC                                      in line-data frames to reduce  |
|                                              the amount of formatted data.  |
|                                              Affects only line-data-frames. |
|                                                                             |
|                    2      Filter Sets        Allows selection of filters    |
|                                              for output data.  All filter   |
|                                              sets are displayed when        |
|                                              selected.                      |
|                                                                             |
|                    3      Show Raw Data      Allows printing of unformatted |
|                                              trace data along with the same |
|                                              data in decoded form.  Default |
|                                              = YES.                         |
|                                                                             |
|                    4      Show Decoded Data  Used with option 3, will       |
|                                              disable printing of decoded    |
|                                              data.  (Prints only raw data.) |
|                                              Default = YES.                 |
|                                                                             |
| LAP-B only         7      Data               Tells formatter what type of   |
|                           Representation     bit encoding is used.  (ASCII  |
|                                              or EBCDIC)                     |
|                                                                             |

|                    8      MODOLO Count       Tells formatter whether frame  |
|                                              data in trace file was a       |
|                                              modolo-128 format rather than  |
|                                              default modolo-8 format.       |
|                                                                             |
-------------------------------------------------------------------------------

          Table 7-4.  Filter Sets 

-------------------------------------------------------------------------------
|                                                                             |
|  Subsystem      Number          Filter                Description           |
|                                                                             |
-------------------------------------------------------------------------------
|                                                                             |
| SDLC         1            Data frames        Enables printing of frames     |
|                           sent/rcvd          sent and frames received on    |
|                                              the datacomm link.             |
|                                                                             |
|              2            Driver message     Enables printing of all port   |
|                           sent/rcvd          messages sent to the driver by |
|                                              SNA Transport and other        |
|                                              entities, or sent to them by   |
|                                              the driver.                    |
|                                                                             |
|              3            Driver             Enables printing of changes in |
|                           state-changes      internal state within the SDLC |
|                                              driver modules.                |
|                                                                             |
|              4            Driver intervals   Enables printing of details    |
|                                              related to internal processing |
|                                              of internal driver requests,   |
|                                              mainly those related to        |
|                                              utility functions (not         |
|                                              datacomm I/O).                 |
|                                                                             |
|              55           Card footprint     Enables printing of large      |
|                                              blocks of footprint            |
|                                              information from the           |
|                                              downloaded SDLC firmware.      |
|                                                                             |
|              99           ALL                Produces a full trace.         |
|                                                                             |
|              0            Errors Only        Disables all filter sets and   |
|                                              produces a listing of error    |
|                                              only.                          |
|                                                                             |
-------------------------------------------------------------------------------
|                                                                             |
| LAP-B        2            Driver messages    Enables printing of all port   |
|                           sent/rcvd          messages sent to the driver by |
|                                              NS Transport and other         |
|                                              entities, or sent to them by   |
|                                              the driver.                    |
|                                                                             |
|              3            Driver             Enables printing of changes in |
|                           state-changes      internals state within the     |
|                                              LAP-B driver modules.          |
|                                                                             |

|              4            Driver internals   Enables printing of details    |
|                                              related to internal processing |
|                                              of internal driver requests,   |
|                                              mainly those related to        |
|                                              utility functions (not         |
|                                              datacomm I/O).                 |
|                                                                             |
|              51           Card frames        Enables printing of frames     |
|                           sent/rcvd          sent and frames received on    |
|                                              the datacomm link.             |
|                                                                             |
|              53           Card state-changes Enables printing of the        |
|                                              individual state changes       |
|                                              traced by the downloaded LAP-B |
|                                              firmware.                      |
|                                                                             |
|              99           ALL                Produces a full trace.         |
|                                                                             |
|              0            Errors             Disables all filter sets and   |
|                                              produces a listing of error    |
|                                              only.                          |
|                                                                             |
-------------------------------------------------------------------------------

          Table 7-4.  Filter Sets (continued) 

-------------------------------------------------------------------------------
|                                                                             |
|  Subsystem      Number          Filter                Description           |
|                                                                             |
-------------------------------------------------------------------------------
|                                                                             |
| RJE          1            Data frames        Enables printing of frames     |
|                           sent/rcvd          sent and frames received on    |
|                                              the datacomm line.             |
|                                                                             |
|              2            Driver messages    Enables printing of all port   |
|                           sent/rcvd          messages sent to the driver by |
|                                              the RJERCS intrinsics and      |
|                                              other entities, or sent to     |
|                                              them by the driver.            |
|                                                                             |
|              3            Driver             Enables printing of changes in |
|                           state-changes      internal state within the RJE  |
|                                              driver modules.                |
|                                                                             |
|              4            Driver internals   Enables printing of details    |
|                                              related to internal processing |
|                                              of internal driver requests,   |
|                                              mainly those related to        |
|                                              utility functions (not         |
|                                              datacomm I/O).                 |
|                                                                             |
|              5            RJERCS Intrinsic   Enables printing of all calls  |
|                           calls              to all RJERCS intrinsics (such |
|                                              as ROPEN) and all buffer data  |
|                                              written to or read from the    |
|                                              RJE driver.                    |
|                                                                             |
|              51           Card frames        Enables printing of frames     |
|                           sent/rcvd          sent and frames received on    |
|                                              the datacomm link.             |
|                                                                             |

|              52           Card internals     Enables printing of all state  |
|                                              changes not already shown      |
|                                              under set 51, and any other    |
|                                              information traced by the      |
|                                              downloaded Bisync firmware.    |
|                                                                             |
|              99           ALL                Produces a full trace.         |
|                                                                             |
|              0            Errors             Disables all filter sets and   |
|                                              produces a listing of error    |
|                                              only.                          |
|                                                                             |
-------------------------------------------------------------------------------



MPE/iX 5.0 Documentation