|
|
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.
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.
See Table 7-1 "General Options" for a
description of general options.
Table 7-1 General Options
Subsystem |
Option |
Meaning |
Description |
802.3, 802.5, SDLC, LAP-B, RJE/BSC, FDDI. 100VG-AnyLAN, 100Base-T, X25 |
? | Redisplay Options | Displays current options. Additional input OK. |
0 | Set Defaults | Set all options back to default values. |
NETXPORT, NetIPC, Network Services | 1 |
ASCII ON or OFF | ON = ASCII representation of 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. |
See Table 7-2 "Log Options" for a
description of logging options.
Table 7-2 Log Options
Subsystem |
Option |
Meaning |
Description |
802.3, 802.5, FDDI, 100VG-AnyLAN, 100Base-T |
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, RJE/BSC | 1 | Linknames |
Select logging options by Linknames. @ = ALL |
2 | Class Selection | 10 = Errors, 12 = Informational, 99 = ALL |
NetIPC, Network Services,NETXPORT | 5 |
Class Selection | Show LOG formatter memo with 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 Output |
Allows a summary report of log entries either in additions to or instead
of the normal formatting of log entries. Default = OFF. |
10 | Save or Use Filter File | Allows saving of the filter
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 | |
See Table 7-3 "X.25 Trace Formatter"
for information on the trace formatter options.
Table 7-3 X.25 Trace Formatter
Options |
Actual Settings |
| 0 | - | Set Default Values | |
| 3 | - | Display Mode | Terse or Lab |
| 4 | - | Layer | Level2_3 or Level 2 or Level 3 |
| 5 | - | Dump Packet | No or Yes |
Level 2: | |
| 6 | - | Full or Header |
Header Only or Full Packet with Data |
| 8 | - | Packet Type |
All, or Select Combination of 9 Level or Packet Types |
Level 3: | |
| 9 | - | Full or Header | Header or Full Packet with Data |
| 10 | - | Display Length | Amount of Data to Display |
| 11 | - | Q bit | Both, or Value of Q-bit 0, 1, or Both |
| 12 | - | VC Number | All, or Select Virtual Circuit Number |
| 13 | - | Packet Type |
All, o Select From 17 Level 3 Packet Types in any Combination |
Enter the number or <CR> to select the current option:
packet types in any combination. |
See Table 7-4 "Trace Options" for a
description of trace options.
Table 7-4 Trace Options
Subsystem |
Option |
Meaning |
Description |
802.3, 802.5, FDDI, 100VG-AnyLAN, 100Base-T | 1 |
Change Filters | Allows definition of what characters each packet
must match before it will be formatted. |
2 | Change Output Flags |
Allows reduction of output by selecting which parts of filtered packets to format |
NETXPORT, NetIPC, Network Services | 5 |
Type or Descriptor | Format events for a particular 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 Output |
Allows a summary report of log entries either in additions to or instead
of the normal formatting of log entries. Default = OFF. |
10 | Save or Use Filter File |
Allows saving of the filter 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 Address |
Allows specification of a destination IP address for header trace messages. |
13 | Source TCP Port |
Allows specification of a source TCP address for header trace messages. |
14 | Destination IPC Port NS Messages |
Allows specification of a destination TCP address for header trace
messages. ON = NS messages displayed. OFF = NetIPC intrinsic calls for
Network services displayed. |
Network Services Only | 8 | Format NS Messages Only |
Toggle ON and OFF. ON = Only Display NS Protocols, (VT, NFT, RFA, PTOP)
OFF = Also Display NetIPC Intrinsic Level Activity |
SDLC, LAP-B, RJE/BSC 802.3, 802.5, FDDI, 100VG-AnyLAN, 100Base-T |
1 | Output Limit | Allow input of maximum bytes 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, SDLC | 7 | Data Representation | Tells formatter
what type of bit encoding is used. (ASCII or EBCDIC) |
LAP-B Only | 8 | MODOLO Count | Tells formatter whether
frame data in trace file was a modolo-128 format rather than default modolo-8 format. |
802.3, 802.5 | 5 | Select Linknames | |
FDDI, 100VG-AnyLAN, 100Base-T | 6 | Exclude Linknames | |
7 | Select Character Representation |
Toggle between ASCII and EBCDIC representation. |
802.3, 802.5, FDDI | 9 | Filter ON Station Address |
Select MAC or station address for filtering Source and Destination. |
10 | Filter ON SAP | Select filtering for both SSAP and BSAP. |
11 | Generate HP-UX Trace Site |
Create trace output file or format, that 8.0 HP-UX formatter can use. |
100VG-AnyLAN, 100Base-T | 8 |
Filter ON Station Address | Select MAC or station address for
filtering Source and Destination. |
9 | Filter ON SAP | Select filtering for both SSAP and BSAP. |
See Table 7-5 "Filter Sets" for a
description of filter sets.
Table 7-5 Filter Sets
Subsystem |
Number |
Filter |
Description |
SDLC | 1 | Data frames sent/rcvd |
Enables printing of frames sent and frames received on the datacomm link. |
2 | Driver message sent/rcvd |
Enables printing of all port messages sent to the driver by SNA
Transport and other entities, or sent to them by the driver. |
3 | Driver state-changes |
Enables printing of changes in 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. |
X25 | 0 | Set Defaults | Set all options back to default. |
1 | VC Number | Select Virtual Circuit numbers |
2 | Packet Type | Select Packet types. |
3 | Q-Bit | Toggles between ON and OFF selection of Q-bit (Control bit) |
LAP-B | 2 | Driver messages sent/rcvd |
Enables printing of all port messages sent to the driver by NS
Transport and other entities, or sent to them by the driver. |
3 | Driver state-changes | Enables printing of changes in
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 sent/rcvd | Enables printing of frames 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. |
RJE | 1 | | Enables printing of
frames sent and frames received on the datacomm line. |
2 | | Enables printing of all port messages sent to the
driver by the RJERCS intrinsics and other entities, or sent to them by the driver. |
3 | | Enables printing of changes in internal state
within the RJE driver modules. |
4 | | Enables printing of details related to internal
processing of internal driver requests, mainly those related to utility
functions (not datacomm I/O). |
5 | | Enables printing of all calls to all RJERCS
intrinsics (such as ROPEN) and all buffer data written to or read from the
RJE driver. |
51 | | Enables printing of frames sent and frames received
on the datacomm link. |
52 | | Enables printing of all state changes not already
shown under set 51, and any other information traced by the downloaded
Bisync firmware. |
99 | | Produces a full trace. |
0 | | Disables all filter sets and produces a listing of error only. |
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 "NMS Error Messages" of
this manual.
|