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. |
| |
-------------------------------------------------------------------------------