Table Of Contents
show rtr distributions-statistics
show rtr enhanced-history collection-statistics
show rtr enhanced-history distribution-statistics
show rtr group schedule
show rtr history
show rtr operational-state
show rtr reaction-trigger
show rtr responder
show rtr totals-statistics
show running-config
show running-config map-class
show saa apm cache
show saa apm information
show saa apm operation
show saa apm results
show slot
show slot0:
show slot1:
show snmp
show snmp engineID
show snmp group
show snmp mib
show snmp mib ifmib ifindex
show snmp mib notification-log
show snmp pending
show snmp sessions
show snmp user
show sntp
show stacks
show startup-config
show subsys
show tcp
show tcp brief
show tdm data
show tech-support
show time-range
show version
show whoami
show xsm status
show xsm xrd-list
showmon
snmp ifmib ifalias long
snmp mib notification-log default
snmp mib notification-log default disable
snmp mib notification-log globalageout
snmp mib notification-log globalsize
snmp mib persist
snmp trap link-status
snmp-server chassis-id
snmp-server community
snmp-server contact
snmp-server enable informs
show rtr distributions-statistics
To display statistic distribution information (captured response times) for all Service Assurance Agent (SAA) operations or the specified operation, use the show rtr distributions-statistics command in EXEC mode.
show rtr distributions-statistics [operation] [tabular | full]
Syntax Description
operation
|
(Optional) Number of the SAA operation to display.
|
tabular
|
(Optional) Displays information in a column format reducing the number of screens required to display the information. This is the default.
|
full
|
(Optional) Displays all information using identifiers next to each displayed value.
|
Defaults
Tabular format for all operations is displayed.
Command Modes
EXEC
Command History
Release
|
Modification
|
11.2
|
This command was introduced.
|
12.3(01)
|
This command integrated in Release 12.3
|
12.3(14)T
|
This command was replaced by the show ip sla monitor statistics command.
|
Usage Guidelines
The distributions statistics consist of the following:
•
The sum of completion times (used to calculate the mean)
•
The sum of the completions times squared (used to calculate standard deviation)
•
The maximum and minimum completion time
•
The number of completed attempts
You can also use the show rtr collection-statistics and show rtr totals-statistics commands to display additional statistical information.
For enhanced-history distribution statistics, see the show rtr enhanced-history distribution-statistics command.
Examples
The following is sample output from the show rtr distributions-statistics command in tabular format when the output is split over multiple lines
Router# show rtr distributions-statistics
StartT = Start Time of Entry (hundredths of seconds)
Dst = Time Distribution Index
Comps = Operations Completed
OvrTh = Operations Completed Over Thresholds
SumCmp = Sum of Completion Times (milliseconds)
SumCmp2L = Sum of Completion Times Squared Low 32 Bits (milliseconds)
SumCmp2H = Sum of Completion Times Squared High 32 Bits (milliseconds)
TMax = Completion Time Maximum (milliseconds)
TMin = Completion Time Minimum (milliseconds)
Entry StartT Pth Hop Dst Comps OvrTh SumCmp
SumCmp2L SumCmp2H TMax TMin
The following example shows the output as it appears on a single line:
Entry StartT Pth Hop Dst Comps OvrTh SumCmp SumCmp2L SumCmp2H TMax TMin
10 3581 1 1 1 0 0 0 0 0 0 0
Related Commands
Command
|
Description
|
show rtr collection-statistics
|
Displays statistical errors for all SAA operations or the specified operation.
|
show rtr configuration
|
Displays configuration values including all defaults for all SAA operations or the specified operation.
|
show rtr totals-statistics
|
Displays the total statistical values (accumulation of error counts and completions) for all SAA operations or the specified operation.
|
show rtr enhanced-history collection-statistics
To display enhanced history statistics for all collected history buckets for the specified Service Assurance Agent (SAA) operation, use the show rtr enhanced-history collection-statistics command in user EXEC or privileged EXEC mode.
show rtr enhanced-history collection-statistics [operation-number] [interval seconds]
Syntax Description
operation-number
|
(Optional) Displays enhanced history distribution statistics for only the specified operation.
|
interval seconds
|
(Optional) Displays enhanced history distribution statistics for only the specified aggregation interval.
• This keyword will not function for SLM operations.
|
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
12.2(15)T
|
This command was introduced in Early Deployment Release 12.2T.
|
12.3(01)
|
This command was integrated in Release 12.3.
|
Usage Guidelines
This command displays data for each bucket of enhanced history data shown individually (one after the other).
The number of buckets and the collection interval is set using the enhanced-history interval seconds buckets number-of-buckets SAA RTR configuration mode command.
For SLM operations, the enhanced history collection interval is set at 900 seconds and the number of buckets is set at 100. Because the enhanced history aggregation interval is fixed at 900 seconds, the optional interval keyword available for this command will not work for SLM operations.
Examples
The output of this command will vary depending on the operation type. The following examples show output for various SAA operations.
Output for SLM Controller Operation
Router# show rtr configuration 1 | include Type
Type of operation to perform: slm controller
Router# show running-config | begin rtr
enhanced-history interval 900 buckets 100
rtr schedule 1 start-time now life forever
Router# show rtr enhanced-history collection-statistics 1
Aggregation Interval: 900
Aggregation start time 00:15:00.003 UTC Thur May 1 2003
Number of failed operations due to a Disconnect: 0
Number of failed operations due to a Timeout: 0
Number of failed operations due to a Busy: 0
Number of failed operations due to a No Connection: 0
Number of failed operations due to an Internal Error: 0
Number of failed operations due to a Sequence Error: 0
Number of failed operations due to a Verify Error: 0
Ds1StatRxLineStatus: 16385
Ds1StatRxBPVs: 0, Ds1StatRxCrcFrameErrors: 0
Ds1StatRxErrSecs: 0, Ds1StatRxSevereErrSecs: 0
Ds1StatRxUnavailSecs: 0, Ds1StatRxBurstyErrSecs: 0
Table 103 describes the significant fields shown in the display.
Table 103 show rtr enhanced-history Field Descriptions for SLM Controller Operations
Field
|
Description
|
Aggregation Interval:
|
The number of seconds the operation runs for each enhanced history bucket. For example, a value of 900 indicates that statistics were gathered for 15 minutes before the next bucket was created.
|
Bucket Index:
|
The number identifying the collection bucket. The number of buckets is set using the enhanced-history SAA RTR configuration command.
|
Ds1StatRx
|
DS1 and E1 Received Statistics—The Ds1StatRx prefix is used for DS1 and E1 interfaces. DS1 and E1 interfaces are physical interfaces that run at a medium speed (for example, 1544 Kbps for DS1 interfaces). "Rx" indicates "received."
|
Ds1StatRxLineStatus:
|
Line Status—This variable indicates the Line Status of the interface. The dsx1LineStatus is a bit map represented as a sum, therefore, it can represent multiple conditions, like Excess Zeros and B8ZS detect, simultaneously. For example, the outOfFrame condition is implied by an outOfSignal condition.
Possible values include:
• 2 — yellowAlarm
• 8 — blueAlarm
• 32 — outOfFrame
• 64 — outOfSignal
• 8192 — excessZeros
• 16384 — b8zsDetect
|
Ds1StatRxBPVs:
|
Bi-Polar Violations—The total number of Bipolar Violations (BPVs) received on the interface.
|
Ds1StatRxCrcFrameErrors:
|
CRC or Frame Errors—he total number of Cyclic Redundancy Check (CRC) Errors (with ESF framing) or Frame Errors (with D4 framing) received on the interface.
|
Ds1StatRxErrSecs:
|
Errored Seconds—The total number of Errored Seconds that have occurred on the interface. This includes both Line Errored and Path Errored Seconds.
|
Ds1StatRxSevereErrSecs:
|
Severely Errored Seconds—The total number of Severely Errored Seconds that have occurred on the interface. This includes both Line Severely Errored Seconds and Path Severely Errored Seconds.
|
Ds1StatRxUnavailSecs:
|
Unavailable Seconds—The total number of Unavailable Seconds that have occurred on the interface.
|
Ds1StatRxBurstyErrSecs:
|
Type B Errored Seconds—The total number of Type B (Bursty) Errored Seconds that have occurred on the interface.
|
Ds1StatRxREBEs:
|
E1 Remote-End Block Errors—The total number of Remote-End Block Error (REBE) Events received on an E1 interface. (This data does not appear for DS1 interfaces.)
|
Output for SLM Frame Relay Operation
Router# show rtr configuration 2 | include Type
Type of operation to perform: Slm Frame-relay Interface
Router# show rtr ennhanced-history collection-statistics 2
Aggregation Interval: 900
Aggregation start time 00:15:00.003 UTC Mon Mar 1 1993
Number of failed operations due to a Disconnect: 0
Number of failed operations due to a Timeout: 0
Number of failed operations due to a Busy: 0
Number of failed operations due to a No Connection: 0
Number of failed operations due to an Internal Error: 0
Number of failed operations due to a Sequence Error: 0
Number of failed operations due to a Verify Error: 0
Tx Total Frames: 24 Rx Total Frames: 24
Tx Total Octets: 312 Rx Total Octets: 344
Tx FCSAlignErrors: 0 Rx FCSAlignErrors: 0
Tx Aborted Frames: 0 Rx Aborted Frames: 0
Tx Long Frames: 0 Rx Long Frames: 0
Tx Short Frames: 0 Rx Short Frames: 0
Tx MaxThroughput: 88 Rx MaxThroughput: 152
Tx MaxUtilization: 0 Rx MaxUtilization: 0
Tx MaxFramesSec: 1 Rx MaxFramesSec: 1
UnavailSecs: 0 Drop Events: 0
Tx OverFlowOctets: 0 Rx OverFlowOctets: 0
Tx Burst Percent1(sec): 238 Rx Burst Percent1(sec): 238
Tx Burst Percent2(sec): 0 Rx Burst Percent2(sec): 0
Tx Burst Percent3(sec): 0 Rx Burst Percent3(sec): 0
Tx Burst Percent4(sec): 0 Rx Burst Percent4(sec): 0
Tx Burst Percent5(sec): 0 Rx Burst Percent5(sec): 0
Table 104 describes the significant fields shown in the display. In the output "Tx" indicates "transmitted," "Rx" indicates "received."
Table 104 show rtr enhanced-history collection-statistics Field Descriptions for SLM Frame Relay Operations
Field
|
Description
|
LinkState
|
The Link State of the Frame Relay access channel being monitored. The link state is determined by the presence of LMI messages on the user and network side of the line.
The link state can take the following values:
• up(1)—Both sides of the access channel are up.
• networkDown(2)—The network side of the circuit has not responded to at least frDlcmiErrorThreshold Status Enquiry messages.
• userDown(3)—The user side of the access channel has not sent a Status Enquiry LMI message in FrConfigPollingTimeoutInterval (T391) seconds.
• down(4)—Both sides of the access channel have been down over some portion of the sampling interval.
• spoofNetworkUp(5)—The agent has been spoofing for the user over some portion of the sampling interval while the network side of the access channel has been up over the entire sampling interval.
• spoofNetworkDown(6)— The agent has been spoofing for the user over some portion of the sampling interval while the network side of the access channel has been down over the entire sampling interval.
|
Tx Total Frames:
|
The total number of frames (including errored frames) transmitted by the interface. Aborted frames are not included in this count.
(MIB variable: FrStatTxFrames)
|
Rx Total Frames:
|
The total number of non-errored frames received by the interface. Aborted frames are not included.
(MIB variable: FrStatRxFrames)
|
Tx Total Octets:
|
The total number of octets transmitted in frames from the interface (excluding framing bits but including FCS octets). Octets in errored and aborted frames are included in this count.
(MIB variable: FrStatTxOctets)
|
Rx Total Octets:
|
The total number of octets received by the interface in non-errored frames (excluding framing bits but including FCS octets). Octets in errored and aborted frames are included in this count.
(MIB variable: FrStatRxOctets)
|
Tx FCSAlignErrors:
|
The total number of frames transmitted by the interface that had a length (excluding framing bits, but including FCS octets) of at least (5) octets, but had either a bad Frame Check Sequence (FCS) with an integral number of octets (FCS Error) or a bad FCS with a non-integral number of octets (Alignment Error). Agents that cannot count this transmit-side object will return a value of zero.
(MIB variable: FrStatTxFcsAlignErrors)
|
Rx FCSAlignErrors:
|
The total number of frames received by the interface that had a length (excluding framing bits, but including FCS octets) of at least (5) octets, but had either a bad Frame Check Sequence (FCS) with an integral number of octets (FCS Error) or a bad FCS with a non-integral number of octets (Alignment Error).
(MIB variable: FrStatRxFcsAlignErrors)
|
Tx Burst Percent1(sec):
|
The number of one second intervals where the transmitted throughput (t) is greater than or equal to zero and less than or equal to BurstLimit 1 (0 <= t <= BurstLimit1). BurstLimit1 is defined as a percentage of the CircuitBurstNominalRate in the RTTMON MIB.
Note: The burst parameters used in this definition are defined in the CircuitConfigTable of the RTTMON MIB.
|
show rtr enhanced-history distribution-statistics
To display enhanced history distribution statistics for Service Assurance Agent (SAA) operations in tabular format, use the show rtr enhanced-history distribution-statistics command in user EXEC or privileged EXEC mode.
show rtr enhanced-history distribution-statistics [operation-number [interval seconds]]
Syntax Description
operation-number
|
(Optional) Displays enhanced history distribution statistics for only the specified operation.
|
interval seconds
|
(Optional) Displays enhanced history distribution statistics for only the specified aggregation interval for only the specified operation.
• The valid range is from 1 to 3,600 seconds (1 hour). The default is 900 seconds.
• This keyword will not function for SLM operations.
|
Command Modes
User Exec
Privileged Exec
Command History
Release
|
Modification
|
12.3(01)
|
This command was introduced.
|
Usage Guidelines
Enhanced history statistics (recorded in milliseconds instead of centiseconds) are enabled using the enhanced-history command when configuring the SAA operation.
The distribution statistics consist of the following:
•
The sum of completion times (used to calculate the mean)
•
The sum of the completion times squared (used to calculate standard deviation)
•
The maximum and minimum completion times
•
The number of completed attempts
You can also use the following commands to display additional statistics or history information, or to view the status of the operation:
•
show rtr enhanced-history collection-statistics
•
show rtr enhanced-history totals-statistics
Tip
If the character `n' appears in your output, or not all fields are displayed, you should increase the screen width for your CLI display (for example, using the width line configuration command or the terminal width Exec mode command).
Examples
The following is sample output from the show rtr enhanced-history distribution-statistics command for an SLM Frame Relay Circuit (Slm Frame-relay Pvc) operation. Please note the following:
•
The fields are defined at the beginning of the output for the command.
•
RTT means round-trip-time.
•
The time elapsed between BucketIndex 1 (started at 257,850,000) and BucketIndex 2 (started at 258,750,002) in this example is 900,002 milliseconds, or 900 seconds.
•
Table 129 provides further details about the significant fields shown in this output.
Router# show rtr configuration 3 | include Type
Type of operation to perform: Slm Frame-relay Pvc
Router# show rtr enhanced-history distribution-statistics 3
Point by point Enhanced History
Int = Aggregation Interval (seconds)
StartT = Aggregation Start Time
Comps = Operations completed
OvrTh = Operations completed over thresholds
SumCmp = Sum of RTT (milliseconds)
SumCmp2L = Sum of RTT squared low 32 bits (milliseconds)
SumCmp2H = Sum of RTT squared high 32 bits (milliseconds)
TMax = RTT maximum (milliseconds)
TMin = RTT minimum (milliseconds)
Entry Int BucI StartT Pth Hop Comps OvrTh SumCmp SumCmp2L SumCmp2H TMax TMin
3 900 1 257850000 1 1 3 0 43 617 0 15 14
3 900 2 258750002 1 1 3 0 45 677 0 16 14
3 900 3 259650000 1 1 3 0 44 646 0 15 14
3 900 4 260550002 1 1 3 0 42 594 0 15 12
3 900 5 261450003 1 1 3 0 42 590 0 15 13
3 900 6 262350001 1 1 3 0 46 706 0 16 15
3 900 7 263250003 1 1 3 0 46 708 0 16 14
Table 105 show rtr enhanced-history distribution-statistics Field Descriptions
Field
|
Description
|
|
The operation ID number you specified for the SAA operation.
|
|
Aggregation Interval - This is the configured statistical distribution buckets interval, in seconds.
For example, a value of 900 for Int means that statistics are gathered for 900 seconds per bucket.
|
|
Bucket Index Number—A number uniquely identifying the statistical distribution (aggregation) bucket.
• The number of history buckets to be kept is configured using the buckets-of-history-kept command.
• A bucket will gather statistics for the specified interval of time (aggregation interval), after which a new statistics bucket is created.
• If a number-of-buckets-kept value is configured, the interval for the last bucket is infinity (until the end of the operation).
• Buckets are not applicable to HTTP and Jitter monitoring operations.
• This field is equivalant to the rttMonStatsCaptureDistIndex object in the Cisco Rttmon MIB.
|
|
|
Aggregation Start Time — Start time for the aggregation interval (per Bucket Index).
• Shows the start time as the number of milliseconds since the router started; in other words, the time stamp is the number of milliseconds since the last system boot-up.
|
|
Path Index Number — The Path index number is an idenitifier for a set of different paths to the target destination that have been discovered. For example, if the first probe iteration finds the path h1, h2, h3, h4, then this path is labeled as "1". If, on a later iteration, a new path is discovered, say h1, h2, h5, h6, h4, then this new path will be identified as "2", and so on.
• Data collection per path is available only for IP/ICMP Path Echo operations ("pathEcho probes"). For all other operations, a value of "1" will always appear.
• Data collection per path is configured using the paths-of-statistics-kept number command when configuring the operation.
|
|
Hop Index Number — Statistics data per hop. A hop is data transmission between two points in a path (for example, from device h2 to device h3).
• Data collection per hop is available only for IP/ICMP Path Echo operations ("pathEcho probes"). For all other operations, a value of "1" will always appear.
• Data collection per hop is configured using the hops-of-statistics-kept number command when configuring the operation.
• This field is equivalant to the rrttMonStatsCaptureHopIndex object in the Cisco Rttmon MIB.
|
Comps (Completed
Round-Trip-Time Probes)
|
Completions —The number of RTT probes that have completed without an error and without timing out, per bucket index.
• This object has the special behavior as defined by the ROLLOVER NOTE in the DESCRIPTION of the Cisco Rttmon MIB object.
|
SumCmp (Sum of Completed
Round-Trip-Times)
|
Sum of Completed Probe Times (1) — The total of all round-trip-time values for all succesfull probes in the row, in milliseconds.
|
SumCmp2L (Sum of Squares
of Completed
Round-Trip-Times,
Squared, Low-Order Value)
|
Sum of the Squares of Completed Probe Times (2), Low-Order — The sum of the square roots of round-trip-times for probes that were successfully measured, in milliseconds; displays the low-order 32 bits of the value only.
• 32 low-order bits and 32 high-order bits are ordered in unsigned 64-bit integers (Int64) as follows:
-------------------------------------------------
| High-order 32 bits | Low-order 32 bits |
-------------------------------------------------
• The "SumCmp2" values are split into "high-order" and "low-order" numbers because of limitations of SNMP. The maximum value allowed for an SNMP object is 4,294,967,295 (the `Gauge32' limit). If the sum of the square roots for your operation exceeds this value, then the "high-order" value will be utilized. (For example, the number 4,294,967,296 would have all low-order bits as '0', and the rightmost high-order bit would be `1').
• The Low-order value (SumCmp2L) appears first in the output because in most cases, the value will be less than 4,294,967,295, which means that the value of SumCmp2H will appear as zero. For example:
|
SumCmp2H (Sum of Squares
of Completed
Round-Trip-Times,
Squared, High-order
Value)
|
Sum of the Squares of Completed Probe Times (2), High-Order— The high-order 32 bits of the accumulated squares of completion times (in milliseconds) of probe operations which completed successfully.
|
|
Round-Trip-Time, Maximum— The highest recorded round-trip-time, in milliseconds, per aggregation interval.
|
|
Round-Trip-Time, Minimum—The lowest recorded round-trip-time, in milliseconds, per aggregation interval.
|
Related Commands
Command
|
Description
|
rtr
|
Allows configuration of SAA operations by entering rtr configuration mode for the specified operation number.
|
show rtr enhanced-history collection-statistics
|
Displays data for all collected history buckets for the specified SAA operation, with data for each bucket shown individually.
|
show rtr group schedule
To display the group schedule details of the Service Assurance Agent (SAA) operations, use the show rtr group schedule command in user EXEC or privileged EXEC mode.
show rtr group schedule [group-operation-number]
Syntax Description
group-operation-number
|
(Optional) Number of the SAA group operation to display.
|
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
12.3(8)T
|
This command was introduced as part of the Service Assurance Agent (SAA) Multi-Operation Scheduler (Multiple Operation Scheduling) feature.
|
12.2(25)S
|
This command was integrated in Release 12.2S.
|
Note
This command not available in Release 12.3(x) (the 12.3 "mainline" release).
Examples
The following is sample output from the show rtr group schedule command that shows information about group (multiple) scheduling. The last line in the example indicates that the SAA operations are multiple scheduled (TRUE):
Router# show rtr group schedule
Multi-Scheduling Configuration:
Probes to be scheduled: 2,3,4,9-30,89
Group operation frequency: 30
The following is sample output from the show rtr group schedule command that shows information about group (multiple) scheduling, with the frequency value the same as the schedule-period value, the life value as 3600 seconds, and the ageout value as never:
Router# show rtr group schedule
Probes to be scheduled: 3,4,6-10
Total number of probes: 7
Group operation frequency: Equals schedule period
Status of entry (SNMP RowStatus): Active
Next Scheduled Start Time: Start Time already passed
Entry Ageout (seconds): never
Table 106 describes the significant fields shown in the displays.
Table 106 show rtr group schedule Field Descriptions
Field
|
Description
|
Group Entry Number
|
The operation group number specified for SAA multiple operations scheduling.
|
Probes to be scheduled
|
The operations numbers specified in the operation group 1.
|
Scheduled period
|
The time in seconds you mentioned while scheduling the operation.
|
Group operation frequency
|
The frequency at which each operation is started.
|
Multi-scheduled
|
The value TRUE shows that group scheduling is active.
|
Related Commands
Command
|
Description
|
show rtr configuration
|
Displays the scheduling details.
|
show running configuration
|
Displays the configuration details which includes the SAA multiple operations scheduling information.
|
show rtr history
To display history collected for all Service Assurance Agent (SAA) operations or for a specified operation, use the show rtr history command in EXEC mode.
show rtr history [operation-number] [tabular | full]
Syntax Description
operation-number
|
(Optional) Displays history for only the specified operation.
|
tabular
|
(Optional) Displays information in a column format reducing the number of screens required to display the information. This is the default.
|
full
|
(Optional) Displays all information using identifiers next to each displayed value.
|
Defaults
Tabular format history for all operations is displayed.
Command Modes
EXEC
Command History
Release
|
Modification
|
11.2
|
This command was introduced.
|
Usage Guidelines
Table 131 lists the Response Return values used in the output of the show rtr history command. If the default (tabular) format is used, the Response Return description is displayed as a code in the Sense column. If the full format is used, the Response Return is displayed as indicated in the Description column.
Table 107 Response Return (Sense Column) Codes
Code
|
Description
|
1
|
Okay.
|
2
|
Disconnected.
|
3
|
Over threshold.
|
4
|
Timeout.
|
5
|
Busy.
|
6
|
Not connected.
|
7
|
Dropped.
|
8
|
Sequence error.
|
9
|
Verify error.
|
10
|
Application specific.
|
Examples
The following is sample output from the show rtr history command in tabular format:
SampleT = Sample Start Time
CompT = Completion Time (milliseconds)
Sense = Response Return Code
Line 2 has the Target Address
Entry LifeI BucketI SampleI SampleT CompT Sense
Related Commands
Command
|
Description
|
show rtr configuration
|
Displays configuration values including all defaults for all SAA operations or the specified operation.
|
show rtr operational-state
Note
Effective with Cisco IOS Release 12.3(14)T, the show rtr operational-state command is replaced by the show ip sla monitor statistics command. See the show ip sla monitor statistics command for more information.
To display the operational state of all Cisco IOS IP Service Level Agreements (IP SLAs) operations or a specified operation, use the show rtr operational-state command in EXEC mode.
show rtr operational-state [operation-number]
Syntax Description
operation-number
|
(Optional) ID number of the IP SLAs operation to display.
|
Defaults
Displays output for all running IP SLAs operations.
Command Modes
EXEC
Command History
Release
|
Modification
|
11.2
|
This command was introduced.
|
12.0(5)T
|
Output for the Jitter operation type was added.
|
12.1
|
The tabular and full keywords were removed.
|
12.2(8)T
|
Output for "NumOfJitterSamples" was added (CSCdv30022).
|
12.2(8)S
|
Output for "NumOfJitterSamples" was added (CSCdv30022).
|
12.3(4)T
|
Output (MOS and ICPIF scores) for the Jitter (codec) operation type was added.
|
12.3(7)T
|
Decimal granularity for MOS scores was added.
|
12.3(14)T
|
This command was replaced by the show ip sla monitor statistics command.
|
Usage Guidelines
Use the show rtr operational-state command to display the current state of IP SLAs operations, including how much life the operation has left, whether the operation is active, and the completion time. The output will also include the monitoring data returned for the last (most recently completed) operation.
Examples
The following example shows basic sample output from the show rtr operational-state command:
Router# show rtr operational-state
Current Operational State
Modification Time: *22:15:43.000 UTC Sun Feb 11 2001
Last Time this Entry was Reset: Never
Number of Octets in use by this Entry: 1332
Number of Operations Attempted: 2
Current Seconds Left in Life: 3511
Operational State of Entry: active
Latest Completion Time (milliseconds): 544
Latest Operation Start Time: *22:16:43.000 UTC Sun Feb 11 2001
Latest Sense Description: 200 OK
HTTP Transaction RTT: 504
The following example shows sample output from the show rtr operational-state command when the specified operation is a Jitter (codec) operation:
Router# show rtr operational-state 1
Modification time: 13:18:38.012 PST Mon Jun 24 2002
Number of Octets Used by this Entry: 10392
Number of operations attempted: 2
Number of operations skipped: 0
Current seconds left in Life: Forever
Operational state of entry: Active
Last time this entry was reset: Never
Connection loss occurred: FALSE
Over thresholds occurred: FALSE
Latest RTT (milliseconds): 2
Latest operation start time: *13:18:42.896 PST Mon Jun 24 2002
Latest operation return code: OK
ICPIF Value: 0 MOS score: 0
NumOfRTT: 61 RTTAvg: 2 RTTMin: 2 RTTMax: 3
PacketLossSD: 0 PacketLossDS: 0
PacketOutOfSequence: 0 PacketMIA: 0 PacketLateArrival: 0
InternalError: 0 Busies: 0 PacketSkipped: 39 <<<<<<==========
MinOfPositivesSD: 1 MaxOfPositivesSD: 1
NumOfPositivesSD: 1 SumOfPositivesSD: 1 Sum2PositivesSD: 1
MinOfNegativesSD: 1 MaxOfNegativesSD: 1
NumOfNegativesSD: 1 SumOfNegativesSD: 1 Sum2NegativesSD: 1
MinOfPositivesDS: 0 MaxOfPositivesDS: 0
NumOfPositivesDS: 0 SumOfPositivesDS: 0 Sum2PositivesDS: 0
MinOfNegativesDS: 0 MaxOfNegativesDS: 0
NumOfNegativesDS: 0 SumOfNegativesDS: 0 Sum2NegativesDS: 0
Interarrival jitterout: 0 Interarrival jitterin: 0
OWMinSD: 0 OWMaxSD: 0 OWSumSD: 0 OWSum2SD: 0
OWMinDS: 0 OWMaxDS: 0 OWSumDS: 0 OWSum2DS: 0
The values shown indicate the values for the last IP SLAs operation. RTT stands for Round-Trip-Time. SD stands for Source-to-Destination. DS stands for Destination-to-Source. OW stands for One Way. The * symbol in front of the time stamps indicates the time is synchronized using NTP or SNTP. Table 108 describes the significant fields shown in this output.
Table 108 show rtr operational-state Field Descriptions
Field
|
Description
|
Voice Scores:
|
Indicates that Voice over IP statistics appear on the following lines. Voice score data is computed when the operation type is configured as type jitter (codec).
|
ICPIF:
|
The Calculated Planning Impairment Factor (ICPIF) value for the latest iteration of the operation. The ICPIF value is computed by IP SLAs using the formula Icpif = Io + Iq + Idte + Idd + Ie - A, where
• the values for Io, Iq, and Idte are set to zero,
• the value Idd is computed based on the measured one way delay,
• the value Ie is computed based on the measured packet loss,
• and the value of A is specified by the user.
ICPIF values are expressed in a typical range of 5 (very low impairment) to 55 (very high impairment). ICPIF values numerically less than 20 are generally considered "adequate."
Note This value is intended only for relative comparisons, and may not match ICPIF values generated using alternate methods.
|
MOS:
|
The estimated Mean Opinion Score (Conversational Quality, Estimated) for the latest iteration of the operation. The MOS-CQE is computed by IP SLAs as a function of the ICPIF.
MOS values are expressed as a number from 1 (1.00) to 5 (5.00), with 5 being the highest level of quality, and 1 being the lowest level of quality. A MOS value of 0 (zero) indicates that MOS data could not be generated for the operation.
|
RTT Values:
|
Indicates that Round-Trip-Time statistics appear on the following lines.
|
NumOfRTT
|
The number of successful round trips.
|
RTTSum
|
The sum of those round trip values (in milliseconds).
|
RTTSum2
|
The sum of squares of those round trip values (in milliseconds).
|
Packet Loss Values:
|
Indicates that Packet Loss statistics appear on the following lines.
|
PacketLossSD
|
The number of packets lost from source to destination.
|
PacketLossDS
|
The number of packets lost from destination to source.
|
PacketOutOfSequence
|
The number of packets returned out of order.
|
PacketMIA
|
The number of packets lost where the direction (SD or DS) cannot be determined (MIA: "missing in action").
|
PacketLateArrival
|
The number of packets that arrived after the timeout.
|
PacketSkipped
|
The number of packets that are not sent during the IP SLAs jitter operation.
|
InternalError
|
The number of times an operation could not be started due to other internal failures.
|
Busies
|
The number of times this operation could not be started because the previously scheduled run was not finished.
|
Jitter Values:
|
Indicates that jitter operation statistics appear on the following lines.
Jitter is inter-packet delay variance.
|
NumOfJitterSamples:
|
The number of jitter samples collected. This is the number of samples that are used to calculate the following jitter statitstics.
|
MinOfPositivesSD MaxOfPositivesSD
|
The minimum and maximum positive jitter values from source to destination, in milliseconds.
|
NumOfPositivesSD
|
The number of jitter values from source to destination that are positive (i.e., network latency increases for two consecutive test packets).
|
SumOfPositivesSD
|
The sum of those positive values (in milliseconds).
|
Sum2PositivesSD
|
The sum of squares of those positive values.
|
MinOfNegativesSD MaxOfNegativesSD
|
The minimum and maximum negative jitter values from source to destination. The absolute value is given.
|
NumOfNegativesSD
|
The number of jitter values from source to destination that are negative (i.e., network latency decreases for two consecutive test packets).
|
SumOfNegativesSD
|
The sum of those values.
|
Sum2NegativesSD
|
The sum of the squares of those values.
|
Interarrival jitterout:
|
The source to destination(SD) jitter value calculation, as defined in RFC 1889.
|
Interarrival jitterin:
|
The destination to souce (DS) jitter value calculation, as defined in RFC 1889.
|
One Way Values
|
Indicates that One Way measurement statistics appear on the following lines.
One Way (OW) Values are the amount of time it took the packet to travel from the source router to the target router (SD) or from the target router to the source router (DS).
|
NumOfOW
|
Number of successful one way time measurements.
|
OWMinSD
|
Minimum time from the source to the destination.
|
OWMaxSD
|
Maximum time from the source to the destination.
|
OWSumSD
|
Sum of the OWMinSD and OWMaxSD values.
|
OWSum2SD
|
Sum of the squares of the OWMinSD and OWMaxSD values.
|
Related Commands
Command
|
Description
|
show rtr configuration
|
Displays configuration values including all defaults for all IP SLAs operations or the specified operation.
|
show rtr reaction-trigger
To display the reaction trigger information for all Service Assurance Agent (SAA) operations or the specified operation, use the show rtr reaction-trigger command in EXEC mode.
show rtr reaction-trigger [operation-number] [tabular | full]
Syntax Description
operation-number
|
(Optional) Number of the SAA operation to display.
|
tabular
|
(Optional) Display information in a column format reducing the number of screens required to display the information.
|
full
|
(Optional) Display all information using identifiers next to each displayed value. This is the default.
|
Defaults
Full format for all operations
Command Modes
EXEC
Command History
Release
|
Modification
|
11.2
|
This command was introduced.
|
12.3
|
This command was integrated in Release 12.3.
|
Usage Guidelines
Use the show rtr reaction-trigger command to display the configuration status and operational state of target operations that will be triggered as defined with the rtr reaction-configuration global command.
Examples
The following is sample output from the show rtr reaction-trigger command in full format:
Router# show rtr reaction-trigger 1
Status of Entry (SNMP RowStatus): active
Operational State: pending
Related Commands
Command
|
Description
|
show rtr configuration
|
Displays configuration values including all defaults for all SAA operations or the specified operation.
|
show rtr responder
To display Service Assurance Agent (SAA) Response Time Report (RTR) Responder information, use the show rtr responder command in EXEC mode.
show rtr responder
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.0(3)T
|
This command was introduced.
|
12.3
|
This command was integrated in Release 12.3.
|
Usage Guidelines
Use the show rtr responder command to display information about recent sources of SAA control messages, such as who has sent recent control messages and who has sent invalid control messages.
Examples
The following is sample output from the show rtr responder command:
Router# show rtr responder
RTR Responder is: Enabled
Number of control message received: 19 Number of errors: 1
4.0.0.1 [19:11:49.035 UTC Sat Dec 2 1995]
4.0.0.1 [19:10:49.023 UTC Sat Dec 2 1995]
4.0.0.1 [19:09:48.707 UTC Sat Dec 2 1995]
4.0.0.1 [19:08:48.687 UTC Sat Dec 2 1995]
4.0.0.1 [19:07:48.671 UTC Sat Dec 2 1995]
4.0.0.1 [19:10:49.023 UTC Sat Dec 2 1995] RTT_AUTH_FAIL
Related Commands
Command
|
Description
|
show rtr configuration
|
Displays configuration values for SAA operations.
|
show rtr totals-statistics
To display the total statistical values (accumulation of error counts and completions) for all Service Assurance Agent (SAA) operations or the specified operation, use the show rtr totals-statistics command in EXEC mode.
show rtr totals-statistics [number] [tabular | full]
Syntax Description
number
|
(Optional) Number of the SAA operation to display.
|
tabular
|
(Optional) Display information in a column format reducing the number of screens required to display the information.
|
full
|
(Optional) Display all information using identifiers next to each displayed value. This is the default.
|
Defaults
Full format for all operations
Command Modes
EXEC
Command History
Release
|
Modification
|
11.2
|
This command was introduced.
|
Usage Guidelines
The total statistics consist of the following items:
•
The operation number
•
The start time of the current hour of statistics
•
The age of the current hour of statistics
•
The number of attempted operations
You can also use the show rtr distributions-statistics and show rtr collection-statistics commands to display additional statistical information.
Examples
The following is sample output from the show rtr totals-statistics command in full format:
Router# show rtr totals-statistics
Start Time Index: *17:15:41.000 UTC Thu May 16 1996
Age of Statistics Entry (hundredths of seconds): 48252
Number of Initiations: 10
Related Commands
Command
|
Description
|
show rtr collection-statistics
|
Displays statistical errors for all SAA operations or the specified operation.
|
show rtr configuration
|
Displays configuration values including all defaults for all SAA operations or the specified operation.
|
show rtr distributions-statistics
|
Displays statistic distribution information (captured response times) for all SAA operations or the specified operation.
|
show running-config
To display the contents of the currently running configuration file or the configuration for a specific class map, interface, map class, policy map, or virtual circuit (VC) class, use the show running-config command in privileged EXEC mode.
show running-config [options]
Syntax Description
options
|
(Optional) One of the following options can be entered with the command:
• brief—Displays the configuration without certification data.
• class-map name—Displays class map information. The linenum keyword can be used with the class-map name option.
• full—Displays the full configuration.
• interface type number—Displays interface-specific configuration information. If you use the interface keyword, you must specify the interface type and the interface number (for example, interface ethernet 0). Common interfaces include async, ethernet, fastEthernet, group-async, loopback, null, serial, and virtual-template. Use the show run interface ? command to determine the interfaces available on your system.
• linenum—Displays line numbers in the output. The brief or full keyword can be used with the linenum keyword.
• map-class—Displays map class information. This option is described separately; see the show running-config map-class command page.
• policy-map name—Displays policy map information. The linenum keyword can be used with the policy-map name option.
• vc-class name—Displays VC class information (display available only on limited routers such as the Cisco 7500 series). The linenum keyword can be used with the vc-class name option.
• view full—Enables the display of a full running configuration. This is for view-based users who typically can view only configuration commands that they are entitled to access for that particular view.
• |—Allows addition of output modifiers and is available with all the keywords for this command.
|
Defaults
The show running-config command without any arguments or keywords displays the entire contents of the running configuration file.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
12.0
|
This command was replaced by the more system:running-config command.
|
12.0(1)T
|
The output modifier (|) was added.
|
12.2(4)T
|
The linenum keyword was added.
|
12.3(8)T
|
The view full option was added.
|
Usage Guidelines
The show running-config command is technically a command alias of the more system:running-config command. Although more commands are recommended (due to their uniform structure across platforms and their expandable syntax), the show running-config command remains enabled to accommodate its widespread use, and to allow typing shortcuts such as show run.
The show running-config interface command is useful when there are multiple interfaces and you want to look at the configuration of a specific interface.
The linenum keyword causes line numbers to be displayed in the output. This option is useful for identifying a particular portion of a very large configuration.
Examples
The following example shows the configuration for serial interface 1:
Router# show running-config interface serial 1
Building configuration...
The following example shows the configuration for Ethernet interface 0/0. Line numbers are displayed in the output.
Router# show running-config interface ethernet 0/0 linenum
Building configuration...
Current configuration : 104 bytes
2 : interface Ethernet0/0
3 : ip address 10.4.2.63 255.255.255.0
The following example shows how to set line numbers in the command output, and then use the output modifier to start the display at line 10:
Router# show running-config linenum | begin 10
14 : enable password #####
17 : firmware location bootflash:mica-modem-pw.2.7.1.0.bin
20 : resource-pool disable
24 : ip domain name cisco.com
25 : ip name-server 172.16.11.48
26 : ip name-server 172.16.2.133
29 : isdn switch-type primary-5ess
Related Commandsdoc-rtr53-02#show running-conf linenum | begin 10
Related Commands 10 : boot-start-marker
Related Commands 11 : boot-end-marker
Related Commands 12 : !
Related Commands 13 : no logging buffered
Related Commands 14 : enable password #1writer
Related Commands 15 : !
Related Commands 16 : spe 1/0 1/7
Related Commands 17 : firmware location bootflash:mica-modem-pw.2.7.1.0.bin
Related Commands 18 : !
Related Commands 19 : !
Related Commands 20 : resource-pool disable
Related Commands 21 : !
Related Commands 22 : no aaa new-model
Related Commands 23 : ip subnet-zero
Related Commands 24 : ip domain name cisco.com
Related Commands 25 : ip name-server 172.16.11.48
Related Commands 26 : ip name-server 172.16.2.133
Related Commands 27 : !
Related Commands 28 : !
Related Commands 29 : isdn switch-type primary-5ess
Related Commands 30 : !
Related Commands 31 : !
Related Commands
Command
|
Description
|
boot config
|
Specifies the device and filename of the configuration file from which the router configures itself during initialization (startup).
|
configure terminal
|
Enters global configuration mode.
|
copy running-config startup-config
|
Copies the running configuration to the startup configuration. (Command alias for the copy system:running-config nvram:startup-config command.)
|
show startup-config
|
Displays the contents of NVRAM (if present and valid) or displays the configuration file pointed to by the CONFIG_FILE environment variable. (Command alias for the more:nvram startup-config command.)
|
show running-config map-class
To display only map-class configuration information from the running configuration file, use the show running-config map-class command in privileged EXEC mode.
show running-config map-class [atm [map-class-name] | dialer [map-class-name] | frame-relay
[map-class-name]] [linenum]
Syntax Description
atm
|
(Optional) Displays only ATM map-class configuration lines.
|
dialer
|
(Optional) Displays only dialer map-class configuration lines.
|
frame-relay
|
(Optional) Displays only Frame Relay map-class configuration lines.
|
map-class-name
|
(Optional) Displays only configuration lines for the specified map-class.
|
linenum
|
(Optional) Displays line numbers in the output.
|
Defaults
Displays all map-class configuration in the running configuration file.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.1
|
The map-class extension to the show running-config command was introduced to show only lines pertaining to dialer or Frame Relay map classes.
|
12.1(2)T
|
The atm, dialer, and frame-relay keywords and map-class-name argument were introduced.
|
12.2(4)T
|
The linenum keyword was added.
|
Usage Guidelines
Use the show running-config map-class command to display the following information from the running configuration file:
•
All map classes configured on the router.
•
Map classes configured specifically for ATM, Frame Relay, or dialer.
•
A specific ATM, Frame Relay, or dialer map class.
Use the linenum keyword to display line numbers in the output. This option is useful for identifying a particular portion of a very large configuration.
Examples
All Map Classes Configured on the Router Example
The following example displays all map classes configured on the router:
Router# show running-config map-class
Building configuration...
map-class frame-relay cir60
frame-relay adaptive-shaping becn
map-class frame-relay cir70
no frame-relay adaptive-shaping
frame-relay priority-group 2
All Frame Relay Map Classes Example
The following example displays all Frame Relay map classes on the router:
Router# show running-config map-class frame-relay
Building configuration...
map-class frame-relay cir60
frame-relay adaptive-shaping becn
map-class frame-relay cir70
no frame-relay adaptive-shaping
frame-relay priority-group 2
A Specific Map Class and Display of Line Numbers Example
The following example displays a specific map class called class1. Line numbers are displayed in the output.
Router# show running-config map-class frame-relay class1 linenum
Building configuration...
2 : map-class frame-relay boy
3 : no frame-relay adaptive-shaping
Related Commands
Command
|
Description
|
map-class atm
|
Specifies the ATM map class for an SVC.
|
map-class dialer
|
Defines a class of shared configuration parameters associated with the dialer map command for outgoing calls from an ISDN interface and for PPP callback.
|
map-class frame-relay
|
Specifies a map class to define QoS values for a Frame Relay VC.
|
more system:running-config
|
Displays contents of the currently running configuration file (equivalent to the show running-config command.)
|
show saa apm cache
To display the amount of memory available in the Service Assurance Agent (SAA) Application Performance Monitor (APM) cache and information about the files stored in the cache, use the show saa apm cache command in EXEC mode.
show saa apm cache
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.2(2)T
|
This command was introduced.
|
12.3(01)
|
This command was integrated in Release 12.3.
|
Usage Guidelines
SAA APM script and scheduler files are kept in an area of system memory called the SAA APM cache.
Examples
The following is sample output from the show saa apm cache command:
Router# show saa apm cache
Cache Size (bytes): 100000
TimeCreated TimeAccessed Size Ref Loc Type SBit FileName
03/21 13:31:25 03/21 13:31:48 1170 0 1 SCR 0 user/scripts/ldap-rem.scr
03/21 13:31:23 03/21 13:31:48 38 0 1 DAT 0 user/data/ldap-rem.dat
03/21 13:31:22 03/21 13:31:27 69 1 0 DAT 0 user/data/ldap.dat
03/21 13:31:20 03/21 13:31:27 1513 1 0 SCR 0 user/scripts/ldap.scr
03/21 13:31:19 03/21 13:31:27 2500 1 0 SCH 0 user/scheduler/master.sch
03/21 13:31:17 03/21 13:31:27 256 1 0 CFG 0 apm.cfg.1
03/21 13:31:17 03/21 13:31:17 568 1 0 CFG 0 user/config/ldap.cf
03/20 14:29:13 03/20 14:29:36 735 0 1 SCR 0 user/scripts/udp-rem.scr
Table 109 describes the significant fields shown in the display.
Table 109 show saa apm cache Field Descriptions
Field
|
Description
|
Type
|
Type of file in the cache. Possible types are:
• CFG— APM configuration file
• DAT — APM data file
• SCR—APM script file
• SCH—APM scheduler file
|
Size
|
Size of the file, in bytes.
|
Ref
|
Ref-count. Indicates how many APM operations are accessing (referencing) the file.
|
Loc
|
"Local" value. Indicates whether the file is local or remote. Possible values are:
0—File is remote.
1—File is local.
|
SBit
|
"Sticky bit" value. Possible values are:
0—sticky bit not set; this file will be deleted from the APM cache during the next cache trimming operation, or when a clear saa apm cache command is executed.
1—sticky bit is set; this file can only be deleted by using the force keyword with the clear saa apm cache command.
|
Related Commands
Command
|
Description
|
clear saa apm cache
|
Deletes files from the SAA Application Performance Monitor cache.
|
saa apm cache-size
|
Sets the size of the SAA Application Performance Monitor (APM) cache.
|
show saa apm operation
|
Displays details about SAA Application Performance Monitor (APM).
|
show saa apm information
To display details about Service Assurance Agent (SAA) Application Performance Monitor (APM) running on the system, use the show saa apm information command in EXEC mode.
show saa apm information
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.2(2)T
|
This command was introduced.
|
Examples
The following is sample output from the show saa apm information command:
Router# show saa apm information
Service Assurance Agent: Application Performance Monitor
Max Number of oper supported: 50
Number of configurable oper: 50
Number of oper configured: 0
Number of files in cache: 0
Cache Size (bytes): 100000
APM low memory water-mark: 6708828
Related Commands
Command
|
Description
|
saa apm lowWaterMark
|
Specifies the lowest amount of free memory that must be available on the system to allow additional SAA APM operations to be configured.
|
show saa apm operation
To display details about Service Assurance Agent (SAA) Application Performance Monitor (APM) operation, use the show saa apm operation command in EXEC mode.
show saa apm operation [operation-number]
Syntax Description
operation-number
|
(Optional) Number that uniquely identifies an APM operation.
|
Defaults
Information for all APM operations is displayed.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.2(2)T
|
This command was introduced.
|
Examples
The following is sample output from the show saa apm operation command:
Router# show saa apm operation
ControlFile URL: ftp://user:password@saa-nms/apm/config/smtp-1000.cfg
Latest Operation Time: *08:13:40.000 UTC Mon Oct 08 2001
Latest Operation Status: 0
show saa apm results
To display the accumulated data for Service Assurance Agent (SAA) Application Performance Monitor (APM) operations, use the show saa apm results command in EXEC mode.
show saa apm results [operation-number]
Syntax Description
operation-number
|
(Optional) A number that uniquely identifies an APM operation. If an operation-number is not specified, all operation results in the buffer are displayed.
|
Defaults
All APM operation results are displayed.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.2(2)T
|
This command was introduced.
|
Usage Guidelines
SAA APM script and scheduler files are kept in an area of system memory called the SAA APM cache.
Examples
The following is sample output from the show saa apm results command:
Router# show saa apm results
Cache Size (bytes): 100000
Cache used (bytes): 14188
File Name TimeCreated TimeAccessed ref Type sticky
apm/data/ldap-13.dat 13:37:20 13:37:25 1 DAT 0
apm.cf.9 13:37:18 13:37:25 1 CFG 0
apm/config/ldap-13.cf 13:37:18 00:00:00 1 CFG 0
apm/data/ldap-12.dat 13:37:15 13:37:20 1 DAT 0
apm.cf.8 13:37:14 13:37:20 1 CFG 0
apm/config/ldap-12.cf 13:37:14 00:00:00 1 CFG 0
apm/data/ldap-11.dat 13:37:11 13:37:16 1 DAT 0
apm.cf.7 13:37:11 13:37:16 1 CFG 0
apm/config/ldap-11.cf 13:37:11 00:00:00 1 CFG 0
apm/scripts/ldap.scr 13:37:07 13:37:29 3 SCR 0
apm/data/iptv-2.dat 13:36:49 13:36:54 1 DAT 0
apm/config/iptv-2.cf 13:36:48 00:00:00 1 CFG 0
apm/scripts/iptv.scr 13:36:47 13:37:08 1 SCR 0
apm/scheduler/master.sch 13:36:45 13:37:34 4 SCH 0
Table 110 describes the significant fields shown in the display.
Table 110 show saa apm cache Field Descriptions
Field
|
Description
|
Type
|
Type of file in cache. Possible types are:
• CFG— APM configuration file
• DAT — APM data file
• SCR—APM script file
• SCH—APM scheduler file
|
sticky
|
"Sticky bit" value. Possible values are:
0—sticky bit not set; this file will be deleted from the APM cache during the next cache trimming operation, or when a clear saa apm cache command is executed.
1—sticky bit is set; this file can only be deleted by using the force keyword with the clear saa apm cache command.
|
Related Commands
Command
|
Description
|
clear saa apm cache
|
Deletes files from the SAA Application Performance Monitor cache.
|
saa apm cache-size
|
Sets the size of the SAA Application Performance Monitor cache.
|
show saa apm operation
|
Displays details about SAA Application Performance Monitor operations.
|
show slot
To display information about the PCMCIA flash memory cards file system, use the show slot command in user EXEC or privileged EXEC mode.
show slot [all | chips | detailed | err | summary]
Syntax Description
all
|
(Optional) Displays all possible flash system information for all PCMCIA flash cards in the system.
|
chips
|
(Optional) Displays flash chip information.
|
detailed
|
(Optional) Displays the flash detailed directory.
|
err
|
(Optional) Displays the flash chip erase and write retries.
|
summary
|
(Optional) Displays the flash partition summary.
|
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
12.0
|
This command was introduced.
|
Usage Guidelines
Use the show slot command to display details about the files in a particular linear PCMCIA flash memory card of less than 20 MB and some 32 MB linear PCMCIA cards.
Note
Use the show disk command for ATA PCMCIA cards. Other forms of this commands are show disk0: and show disk1:.
For more information regarding file systems and flash cards, access the PCMCIA Filesystem Compatibility Matrix and Filesystem Information document at the following URL:
http://www.cisco.com/en/US/partner/products/hw/routers/ps341/products_tech_note09186a00800a7515.shtml
To see which flash cards are used in your router, use the show version command and look at the bottom portion of the output.
The following display indicates an ATA PCMCIA flash disk.
46976K bytes of ATA PCMCIA card at slot 0 (Sector size 512 bytes).
The following display indicates a linear PCMCIA flash card with 20480K bytes of flash memory in card at slot 1 with a sector size of 128K.
20480K bytes of Flash PCMCIA card at slot 1 (Sector size 128K).
Note
In some cases the show slot command will not display the file systems, use show slot0: or show slot1:.
Examples
The following example displays information about slot 0. The output is self-explanatory.
PCMCIA Slot0 flash directory:
1 11081464 c3660-bin-mz.123-9.3.PI5b
[11081528 bytes used, 9627844 available, 20709372 total]
20480K bytes of processor board PCMCIA Slot0 flash (Read/Write)
The following example shows all possible flash system information for all PCMCIA flash cards in the system.
Partition Size Used Free Bank-Size State Copy Mode
1 20223K 10821K 9402K 4096K Read/Write Direct
PCMCIA Slot0 flash directory:
1 11081464 c3660-bin-mz.123-9.3.PI5b
[11081528 bytes used, 9627844 available, 20709372 total]
20480K bytes of processor board PCMCIA Slot0 flash (Read/Write)
1 1 89A0 2048KB INTEL 28F016SA
2 1 89A0 2048KB INTEL 28F016SA
1 2 89A0 2048KB INTEL 28F016SA
2 2 89A0 2048KB INTEL 28F016SA
1 3 89A0 2048KB INTEL 28F016SA
2 3 89A0 2048KB INTEL 28F016SA
1 4 89A0 2048KB INTEL 28F016SA
2 4 89A0 2048KB INTEL 28F016SA
1 5 89A0 2048KB INTEL 28F016SA
2 5 89A0 2048KB INTEL 28F016SA
The following example shows flash chip information
20480K bytes of processor board PCMCIA Slot0 flash (Read/Write)
1 1 89A0 2048KB INTEL 28F016SA
2 1 89A0 2048KB INTEL 28F016SA
1 2 89A0 2048KB INTEL 28F016SA
2 2 89A0 2048KB INTEL 28F016SA
1 3 89A0 2048KB INTEL 28F016SA
2 3 89A0 2048KB INTEL 28F016SA
1 4 89A0 2048KB INTEL 28F016SA
2 4 89A0 2048KB INTEL 28F016SA
1 5 89A0 2048KB INTEL 28F016SA
2 5 89A0 2048KB INTEL 28F016SA
The following example show the flash detailed directory.
Router# show slot detailed
PCMCIA Slot0 flash directory:
1 11081464 c3660-bin-mz.123-9.3.PI5b
[11081528 bytes used, 9627844 available, 20709372 total]
20480K bytes of processor board PCMCIA Slot0 flash (Read/Write)
The following example shows the flash chip erase and write retries.
PCMCIA Slot0 flash directory:
1 11081464 c3660-bin-mz.123-9.3.PI5b
[11081528 bytes used, 9627844 available, 20709372 total]
20480K bytes of processor board PCMCIA Slot0 flash (Read/Write)
Chip Bank Code Size Name erase write
1 1 89A0 2048KB INTEL 28F016SA 0 0
2 1 89A0 2048KB INTEL 28F016SA 0 0
1 2 89A0 2048KB INTEL 28F016SA 0 0
2 2 89A0 2048KB INTEL 28F016SA 0 0
1 3 89A0 2048KB INTEL 28F016SA 0 0
2 3 89A0 2048KB INTEL 28F016SA 0 0
1 4 89A0 2048KB INTEL 28F016SA 0 0
2 4 89A0 2048KB INTEL 28F016SA 0 0
1 5 89A0 2048KB INTEL 28F016SA 0 0
2 5 89A0 2048KB INTEL 28F016SA 0 0
The following example shows the flash partition summary.
Router# show slot summary
Partition Size Used Free Bank-Size State Copy Mode
1 20223K 10821K 9402K 4096K Read/Write Direct
20480K bytes of processor board PCMCIA Slot0 flash (Read/Write)
Related Commands
Command
|
Description
|
dir slot0:
|
Directory listing of files on a PCMCIA Flash card located in slot0.
|
dir slot1:
|
Directory listing of files on a PCMCIA Flash card located in slot1.
|
show slot0:
|
Displays information about the PCMCIA flash memory card's file system located in slot 0.
|
show slot1:
|
Displays information about the PCMCIA flash memory card's file system located in slot 1.
|
show slot0:
To display information about the PCMCIA flash memory card's file system located in slot 0, use the show slot0: command in user EXEC or privileged EXEC mode.
show slot0: [all | chips | detailed | err | summary]
Syntax Description
all
|
(Optional) Displays all possible flash system information for all PCMCIA flash cards in the system.
|
chips
|
(Optional) Displays flash chip information.
|
detailed
|
(Optional) Displays the flash detailed directory.
|
err
|
(Optional) Displays the flash chip erase and write retries.
|
summary
|
(Optional) Displays the flash partition summary.
|
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
12.0
|
This command was introduced.
|
Usage Guidelines
Use the show slot0: command to display details about the files in a particular linear PCMCIA flash memory card of less than 20 MB and some 32 MB linear PCMCIA cards.
Note
Use the show disk command for ATA PCMCIA cards. Other forms of this commands are show disk0: and show disk1:.
For more information regarding file systems and flash cards, access the PCMCIA Filesystem Compatibility Matrix and Filesystem Information document at the following URL:
http://www.cisco.com/en/US/partner/products/hw/routers/ps341/products_tech_note09186a00800a7515.shtml
To see which flash cards are used in your router, use the show version command and look at the bottom portion of the output.
The following display indicates an ATA PCMCIA flash disk.
46976K bytes of ATA PCMCIA card at slot 0 (Sector size 512 bytes).
The following display indicates a linear PCMCIA flash card with 20480K bytes of flash memory in card at slot 1 with a sector size of 128K.
20480K bytes of Flash PCMCIA card at slot 1 (Sector size 128K).
Note
In some cases the show slot command will not display the file systems, use show slot0: or show slot1:.
Examples
The following example displays information about slot 0. The output is self-explanatory.
PCMCIA Slot0 flash directory:
1 11081464 c3660-bin-mz.123-9.3.PI5b
[11081528 bytes used, 9627844 available, 20709372 total]
20480K bytes of processor board PCMCIA Slot0 flash (Read/Write)
Partition Size Used Free Bank-Size State Copy Mode
1 20223K 10821K 9402K 4096K Read/Write Direct
PCMCIA Slot0 flash directory:
1 11081464 c3660-bin-mz.123-9.3.PI5b
[11081528 bytes used, 9627844 available, 20709372 total]
20480K bytes of processor board PCMCIA Slot0 flash (Read/Write)
1 1 89A0 2048KB INTEL 28F016SA
2 1 89A0 2048KB INTEL 28F016SA
1 2 89A0 2048KB INTEL 28F016SA
2 2 89A0 2048KB INTEL 28F016SA
1 3 89A0 2048KB INTEL 28F016SA
2 3 89A0 2048KB INTEL 28F016SA
1 4 89A0 2048KB INTEL 28F016SA
2 4 89A0 2048KB INTEL 28F016SA
1 5 89A0 2048KB INTEL 28F016SA
2 5 89A0 2048KB INTEL 28F016SA
The following example shows flash chip information.
Router# show slot0: chips
20480K bytes of processor board PCMCIA Slot0 flash (Read/Write)
1 1 89A0 2048KB INTEL 28F016SA
2 1 89A0 2048KB INTEL 28F016SA
1 2 89A0 2048KB INTEL 28F016SA
2 2 89A0 2048KB INTEL 28F016SA
1 3 89A0 2048KB INTEL 28F016SA
2 3 89A0 2048KB INTEL 28F016SA
1 4 89A0 2048KB INTEL 28F016SA
2 4 89A0 2048KB INTEL 28F016SA
1 5 89A0 2048KB INTEL 28F016SA
2 5 89A0 2048KB INTEL 28F016SA
The following example show the flash detailed directory.
Router# show slot0: detailed
PCMCIA Slot0 flash directory:
1 11081464 c3660-bin-mz.123-9.3.PI5b
[11081528 bytes used, 9627844 available, 20709372 total]
20480K bytes of processor board PCMCIA Slot0 flash (Read/Write)
The following example shows the flash chip erase and write retries.
PCMCIA Slot0 flash directory:
1 11081464 c3660-bin-mz.123-9.3.PI5b
[11081528 bytes used, 9627844 available, 20709372 total]
20480K bytes of processor board PCMCIA Slot0 flash (Read/Write)
Chip Bank Code Size Name erase write
1 1 89A0 2048KB INTEL 28F016SA 0 0
2 1 89A0 2048KB INTEL 28F016SA 0 0
1 2 89A0 2048KB INTEL 28F016SA 0 0
2 2 89A0 2048KB INTEL 28F016SA 0 0
1 3 89A0 2048KB INTEL 28F016SA 0 0
2 3 89A0 2048KB INTEL 28F016SA 0 0
1 4 89A0 2048KB INTEL 28F016SA 0 0
2 4 89A0 2048KB INTEL 28F016SA 0 0
1 5 89A0 2048KB INTEL 28F016SA 0 0
2 5 89A0 2048KB INTEL 28F016SA 0 0
The following example shows the flash partition summary.
Router# show slot0: summary
Partition Size Used Free Bank-Size State Copy Mode
1 20223K 10821K 9402K 4096K Read/Write Direct
20480K bytes of processor board PCMCIA Slot0 flash (Read/Write)
Related Commands
Command
|
Description
|
dir slot0:
|
Directory listing of files on a PCMCIA Flash card located in slot0.
|
dir slot1:
|
Directory listing of files on a PCMCIA Flash card located in slot1.
|
show slot1:
|
Displays information about the PCMCIA flash memory card's file system located in slot 1.
|
show slot
|
Displays information about the PCMCIA flash memory cards.
|
show slot1:
To display information about the PCMCIA flash memory card's file system located in slot 1, use the show slot1: command in user EXEC or privileged EXEC mode.
show slot1: [all | chips | detailed | err | summary]
Syntax Description
all
|
(Optional) Displays all possible flash system information for all PCMCIA flash cards in the system.
|
chips
|
(Optional) Displays flash chip information.
|
detailed
|
(Optional) Displays the flash detailed directory.
|
err
|
(Optional) Displays the flash chip erase and write retries.
|
summary
|
(Optional) Displays the flash partition summary.
|
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
12.0
|
This command was introduced.
|
Usage Guidelines
Use the show slot1: command to display details about the files in a particular linear PCMCIA flash memory card of less than 20 MB and some 32 MB linear PCMCIA cards located in slot 1.
Note
Use the show disk command for ATA PCMCIA cards. Other forms of this commands are show disk0: and show disk1:.
For more information regarding file systems and flash cards, access the PCMCIA Filesystem Compatibility Matrix and Filesystem Information document at the following URL:
http://www.cisco.com/en/US/partner/products/hw/routers/ps341/products_tech_note09186a00800a7515.shtml
To see which flash cards are used in your router, use the show version command and look at the bottom portion of the output.
The following display indicates an ATA PCMCIA flash disk.
46976K bytes of ATA PCMCIA card at slot 0 (Sector size 512 bytes).
The following display indicates a linear PCMCIA flash card with 20480K bytes of flash memory in card at slot 1 with a sector size of 128K.
20480K bytes of Flash PCMCIA card at slot 1 (Sector size 128K).
Note
In some cases the show slot command will not display the file systems. Use show slot0: or show slot1:.
Examples
The following example displays information about slot 0 using the slot0: command form. The output
is self-explanatory.
PCMCIA Slot1 flash directory:
1 10907068 c3660-bin-mz.123-7.9.PI4
[10907132 bytes used, 5739008 available, 16646140 total]
16384K bytes of processor board PCMCIA Slot1 flash (Read/Write)
Partition Size Used Free Bank-Size State Copy Mode
1 20223K 10821K 9402K 4096K Read/Write Direct
PCMCIA Slot0 flash directory:
1 11081464 c3660-bin-mz.123-9.3.PI5b
[11081528 bytes used, 9627844 available, 20709372 total]
20480K bytes of processor board PCMCIA Slot0 flash (Read/Write)
1 1 89A0 2048KB INTEL 28F016SA
2 1 89A0 2048KB INTEL 28F016SA
1 2 89A0 2048KB INTEL 28F016SA
2 2 89A0 2048KB INTEL 28F016SA
1 3 89A0 2048KB INTEL 28F016SA
2 3 89A0 2048KB INTEL 28F016SA
1 4 89A0 2048KB INTEL 28F016SA
2 4 89A0 2048KB INTEL 28F016SA
1 5 89A0 2048KB INTEL 28F016SA
2 5 89A0 2048KB INTEL 28F016SA
The following example shows flash chip information.
Router# show slot1: chips
20480K bytes of processor board PCMCIA Slot0 flash (Read/Write)
1 1 89A0 2048KB INTEL 28F016SA
2 1 89A0 2048KB INTEL 28F016SA
1 2 89A0 2048KB INTEL 28F016SA
2 2 89A0 2048KB INTEL 28F016SA
1 3 89A0 2048KB INTEL 28F016SA
2 3 89A0 2048KB INTEL 28F016SA
1 4 89A0 2048KB INTEL 28F016SA
2 4 89A0 2048KB INTEL 28F016SA
1 5 89A0 2048KB INTEL 28F016SA
2 5 89A0 2048KB INTEL 28F016SA
The following example show the flash detailed directory.
Router# show slot1: detailed
PCMCIA Slot0 flash directory:
1 11081464 c3660-bin-mz.123-9.3.PI5b
[11081528 bytes used, 9627844 available, 20709372 total]
20480K bytes of processor board PCMCIA Slot0 flash (Read/Write)
The following example shows the flash chip erase and write retries.
PCMCIA Slot0 flash directory:
1 11081464 c3660-bin-mz.123-9.3.PI5b
[11081528 bytes used, 9627844 available, 20709372 total]
20480K bytes of processor board PCMCIA Slot0 flash (Read/Write)
Chip Bank Code Size Name erase write
1 1 89A0 2048KB INTEL 28F016SA 0 0
2 1 89A0 2048KB INTEL 28F016SA 0 0
1 2 89A0 2048KB INTEL 28F016SA 0 0
2 2 89A0 2048KB INTEL 28F016SA 0 0
1 3 89A0 2048KB INTEL 28F016SA 0 0
2 3 89A0 2048KB INTEL 28F016SA 0 0
1 4 89A0 2048KB INTEL 28F016SA 0 0
2 4 89A0 2048KB INTEL 28F016SA 0 0
1 5 89A0 2048KB INTEL 28F016SA 0 0
2 5 89A0 2048KB INTEL 28F016SA 0 0
The following example shows the flash partition summary.
Router# show slot1: summary
Partition Size Used Free Bank-Size State Copy Mode
1 20223K 10821K 9402K 4096K Read/Write Direct
20480K bytes of processor board PCMCIA Slot0 flash (Read/Write)
Related Commands
Command
|
Description
|
dir slot0:
|
Directory listing of files on a PCMCIA Flash card located in slot0.
|
dir slot1:
|
Directory listing of files on a PCMCIA Flash card located in slot1.
|
show slot0:
|
Displays information about the PCMCIA flash memory card's file system located in slot 0.
|
show slot
|
Displays information about the PCMCIA flash memory cards.
|
show snmp
To check the status of Simple Network Management Protocol (SNMP) communications, use the show snmp command in EXEC mode.
show snmp
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
This command provides counter information for SNMP operations. It also displays the chassis ID string defined with the snmp-server chassis-id global configuration command.
Examples
The following is sample output from the show snmp command:
0 Bad SNMP version errors
0 Illegal operation for community name supplied
24 Number of requested variables
0 Number of altered variables
0 Too big errors (Maximum packet size 1500)
Logging to 172.16.58.33.162, 0/10, 13 sent, 0 dropped.
SNMP Manager-role output packets
SNMP Manager-role input packets
Informs in flight 0/25 (current/max)
Logging to 172.16.217.141.162
4 sent, 0 in-flight, 1 retries, 0 failed, 0 dropped
Logging to 172.16.58.33.162
0 sent, 0 in-flight, 0 retries, 0 failed, 0 dropped
Table 111 describes the significant fields shown in the display.
Table 111 show snmp Field Descriptions
Field
|
Description
|
Chassis
|
Chassis ID string.
|
SNMP packets input
|
Total number of SNMP packets input.
|
Bad SNMP version errors
|
Number of packets with an invalid SNMP version.
|
Unknown community name
|
Number of SNMP packets with an unknown community name.
|
Illegal operation for community name supplied
|
Number of packets requesting an operation not allowed for that community.
|
Encoding errors
|
Number of SNMP packets that were improperly encoded.
|
Number of requested variables
|
Number of variables requested by SNMP managers.
|
Number of altered variables
|
Number of variables altered by SNMP managers.
|
Get-request PDUs
|
Number of get requests received.
|
Get-next PDUs
|
Number of get-next requests received.
|
Set-request PDUs
|
Number of set requests received.
|
SNMP packets output
|
Total number of SNMP packets sent by the router.
|
Too big errors
|
Number of SNMP packets which were larger than the maximum packet size.
|
Maximum packet size
|
Maximum size of SNMP packets.
|
No such name errors
|
Number of SNMP requests that specified a MIB object that does not exist.
|
Bad values errors
|
Number of SNMP set requests that specified an invalid value for a MIB object.
|
General errors
|
Number of SNMP set requests that failed due to some other error. (It was not a noSuchName error, badValue error, or any of the other specific errors.)
|
Response PDUs
|
Number of responses sent in reply to requests.
|
Trap PDUs
|
Number of SNMP traps sent.
|
SNMP logging
|
Indicates whether logging is enabled or disabled.
|
sent
|
Number of traps sent.
|
dropped
|
Number of traps dropped. Traps are dropped when the trap queue for a destination exceeds the maximum length of the queue, as set by the snmp-server queue-length global configuration command.
|
SNMP Manager-role output packets
|
Information related to packets sent by the router as an SNMP manager.
|
Get-request PDUs
|
Number of get requests sent.
|
Get-next PDUs
|
Number of get-next requests sent.
|
Get-bulk PDUs
|
Number of get-bulk requests sent.
|
Set-request PDUs
|
Number of set requests sent.
|
Inform-request PDUs
|
Number of inform requests sent.
|
Timeouts
|
Number of request timeouts.
|
Drops
|
Number of requests dropped. Reasons for drops include no memory, a bad destination address, or an unreasonable destination address.
|
SNMP Manager-role input packets
|
Information related to packets received by the router as an SNMP manager.
|
Inform response PDUs
|
Number of inform request responses received.
|
Trap PDUs
|
Number of SNMP traps received.
|
Response PDUs
|
Number of responses received.
|
Responses with errors
|
Number of responses containing errors.
|
SNMP informs
|
Indicates whether SNMP informs are enabled.
|
Informs in flight
|
Current and maximum possible number of informs waiting to be acknowledged.
|
Logging to
|
Destination of the following informs.
|
sent
|
Number of informs sent to this host.
|
in-flight
|
Number of informs currently waiting to be acknowledged.
|
retries
|
Number of inform retries sent.
|
failed
|
Number of informs that were never acknowledged.
|
dropped
|
Number of unacknowledged informs that were discarded to make room for new informs.
|
Related Commands
Command
|
Description
|
show snmp pending
|
Displays the current set of pending SNMP requests.
|
show snmp sessions
|
Displays the current SNMP sessions.
|
snmp-server chassis-id
|
Provides a message line identifying the SNMP server serial number.
|
snmp-server manager
|
Starts the SNMP manager process.
|
snmp-server manager session-timeout
|
Sets the amount of time before a nonactive session is destroyed.
|
snmp-server queue-length
|
Establishes the message queue length for each trap host.
|
show snmp engineID
To display the identification of the local Simple Network Management Protocol (SNMP) engine and all remote engines that have been configured on the router, use the show snmp engineID command in EXEC mode.
show snmp engineID
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.0(3)T
|
This command was introduced.
|
Usage Guidelines
An SNMP engine is a copy of SNMP that can reside on a local or remote device.
Examples
The following example specifies 00000009020000000C025808 as the local engineID and 123456789ABCDEF000000000 as the remote engine ID, 172.16.37.61 as the IP address of the remote engine (copy of SNMP) and 162 as the port from which the remote device is connected to the local device:
Router# show snmp engineID
Local SNMP engineID: 00000009020000000C025808
Remote Engine ID IP-addr Port
123456789ABCDEF000000000 172.16.37.61 162
Table 112 describes the fields shown in the display.
Table 112 show snmp engineID Field Descriptions
Field
|
Definition
|
Local SNMP engine ID
|
A string that identifies the copy of SNMP on the local device.
|
Remote Engine ID
|
A string that identifies the copy of SNMP on the remote device.
|
IP-addr
|
The IP address of the remote device.
|
Port
|
The port number on the local device to which the remote device is connected.
|
Related Commands
Command
|
Description
|
snmp-server engineID local
|
Configures a name for either the local or remote SNMP engine on the router.
|
show snmp group
To display the names of groups on the router and the security model, the status of the different views, and the storage type of each group, use the show snmp group command in EXEC mode.
show snmp group
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.0(3)T
|
This command was introduced.
|
Examples
The following example specifies the group name as public, the security model as v1, the read view name as v1default, the notify view name as *tv.FFFFFFFF, and the storage type as volatile:
groupname: public security model:v1
writeview: no writeview specified
Table 113 describes the fields shown in the example.
Table 113 show snmp group Field Descriptions
Field
|
Definition
|
groupname
|
The name of the SNMP group, or collection of users that have a common access policy.
|
security model
|
The security model used by the group, either v1, v2c, or v3.
|
readview
|
A string identifying the read view of the group.
|
writeview
|
A string identifying the write view of the group.
|
notifyview
|
A string identifying the notify view of the group.
|
storage-type
|
Indicates whether the settings have been set in volatile or temporary memory on the device, or in nonvolatile or persistent memory where settings will remain after the device has been turned off and on again.
|
Related Commands
Command
|
Description
|
snmp-server group
|
Configures a new SNMP group or a table that maps SNMP users to SNMP views.
|
show snmp mib
To display a list of the MIB module instance identifiers (OIDs) registered on your system, use the show snmp mib command in EXEC mode.
show snmp mib
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.2, 12.2(2)T
|
This command was introduced.
|
Usage Guidelines
SNMP management information is viewed as a collection of managed objects, residing in a virtual information store, termed the Management Information Base (MIB). Collections of related objects are defined in MIB modules. These modules are written using a subset of OSIs Abstract Syntax Notation One (ASN.1), termed the Structure of Management Information (SMI).
This command is intended for network administrators who are familiar with the SMI and ASN.1 syntax.
While this command can be used to display a list of MIB object identifiers (OIDs) registered on the system, the use of a network management system (NMS) application is the recommended alternative for gathering this information.
The show snmp mib command will display the instance identifiers for all the MIB objects on the system. The instance identifier is the final part of the OID. An object can have one or more instance identifiers. Before displaying the instance identifier, the system attempts to find the best match with the list of table names. The MIB module table names are registered when the system initializes.
The definitions for the OIDs displayed by this command can be found in the relevant RFCs and MIB modules. For example, RFC 1907 defines the system.x, sysOREntry.x, snmp.x, and snmpTrap.x OIDs, and this information is supplemented by the extensions defined in the CISCO-SYSTEM-MIB.
Tips
This command produces a high volume of output if SNMP is enabled on your system. To exit from a --More-- prompt, press Ctrl-Z.
Examples
The following is sample output from the show snmp mib command:
Related Commands
Command
|
Description
|
show snmp mib ifmib ifindex
|
Displays SNMP Interface Index identification numbers (ifIndex values) for all the system interfaces or the specified system interface
|
show snmp mib ifmib ifindex
To display SNMP Interface Index identification numbers (ifIndex values) for all the system interfaces or the specified system interface, use the show snmp mib ifmib ifindex command in EXEC mode.
show snmp mib ifmib ifindex [interface-type] [slot/][port-adapter/][port]
Syntax Description
interface-type
|
The type of interface. Use the show snmp mib ifmib ifindex ? command to determine the options available on your system. Typical interface-types include async, dialer, ethernet, fastEthernet, serial and so on.
|
slot/
|
The slot number for the interface card, followed by a forward-slash. The availability of this argument depends on your system hardware configuration.
|
port-adapter/
|
The port-adapter number, followed by a forward-slash. The availability of this argument depends on your system hardware configuration.
|
port
|
The interface number.
|
Defaults
The ifIndex values for all interfaces are displayed.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.2(2)T
|
This command was introduced.
|
Usage Guidelines
The show snmp mib ifmib ifindex command allows you to display SNMP Interface Index identification numbers (ifIndex values) assigned to interfaces and subinterfaces using the CLI. This command provides a way to view these values without the need for a Network Management Station.
If a specific interface is not specified using the optional interface-type, slot, port-adapter, and port arguments, the ifDescr and ifIndex pairs of all interfaces and subinterfaces present on the system are shown.
Examples
The following example shows output for a specific interface:
Router# show snmp mib ifmib ifIndex Ethernet2/0
The following examples shows output for all interfaces:
Router# show snmp mib ifmib ifindex
ATM1/0-aal5 layer: Ifindex = 12
ATM1/0-atm layer: Ifindex = 10
ATM1/0.0-aal5 layer: Ifindex = 13
ATM1/0.0-atm subif: Ifindex = 11
ATM1/0.9-aal5 layer: Ifindex = 32
ATM1/0.9-atm subif: Ifindex = 31
ATM1/0.99-aal5 layer: Ifindex = 36
ATM1/0.99-atm subif: Ifindex = 35
Related Commands
Command
|
Description
|
show snmp mib
|
Displays a list of the MIB module instance identifiers (OIDs) registered on the system.
|
snmp ifindex persist
|
Enables ifIndex values in the Interfaces MIB (IF-MIB) that persist across reboots only on a specific interface.
|
snmp ifmib ifalias long
|
Configures the system to handle IfAlias descriptions of up to 256 characters in length.
|
snmp-server ifindex persist
|
Enables ifIndex values in the Interfaces MIB (IF-MIB) that persist across reboots for all interfaces (globally).
|
show snmp mib notification-log
To display information about the state of local SNMP notification logging, use the show snmp mib notification-log command in EXEC mode.
show snmp mib notification-log [all | default]
Syntax Description
all
|
(Optional) Displays all notification log entries stored in the local Notification Log MIB database.
|
default
|
(Optional) Displays summary information for the default (unnamed) SNMP Notification Log.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
12.0(22)S
|
This command was introduced.
|
12.2(13)T
|
This command was integrated into Release 12.2(13)T.
|
Usage Guidelines
The SNMP Notification Log works in conjunction with the NOTIFICATION-LOG-MIB.my MIB module (available at ftp://ftp.cisco.com/pub/mibs/v2/). This MIB module is based on RFC 3014. The local logs can be polled by external network management applications to verify that they have not missed important SNMP notifications (traps and informs).
The show snmp mib notification-log all command displays all logged notification entries currently in the local MIB database. Entries are displayed from the oldest to the newest. The time of entry creation is determined using the system-up-time (sysUpTime) value; this means that the age of the entry is set using the amount of time that has passed since the router was last restarted. Other information for the entries includes the notificationID, and the filters (varbinds) associated with the log, if any.
Examples
The following is sample output from the show snmp mib notification-log command:
Router# show snmp mib notification-log
GlobalAgeout 15, GlobalEntryLimit 500
Total Notifications logged in all logs 0
Log Name"", Log entry Limit 500, Notifications logged 0
Note that in this example, the Log Name of "" indicates the default "null-named" Notification Log.
Related Commands
Command
|
Description
|
snmp mib notification-log default
|
Creates and activates an SNMP Notification Log.
|
snmp mib notification-log globalageout
|
Sets the maximum age for a notification.
|
snmp mib notification-log globalsize
|
Sets the maximum number of notifications allowed in all logs.
|
show snmp pending
To display the current set of pending Simple Network Management Protocol (SNMP) requests, use the show snmp pending command in EXEC mode.
show snmp pending
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
11.3 T
|
This command was introduced.
|
Usage Guidelines
After the SNMP manager sends a request, the request is "pending" until the manager receives a response or the request timeout expires.
Examples
The following is sample output from the show snmp pending command:
Router# show snmp pending
req id: 47, dest: 172.16.58.33.161, V2C community: public, Expires in 5 secs
req id: 49, dest: 172.16.58.33.161, V2C community: public, Expires in 6 secs
req id: 51, dest: 172.16.58.33.161, V2C community: public, Expires in 6 secs
req id: 53, dest: 172.16.58.33.161, V2C community: public, Expires in 8 secs
Table 114 describes the significant fields shown in the display.
Table 114 show snmp pending Field Descriptions
Field
|
Description
|
req id
|
ID number of the pending request.
|
dest
|
IP address of the intended receiver of the request.
|
V2C community
|
SNMP version 2C community string sent with the request.
|
Expires in
|
Remaining time before request timeout expires.
|
Related Commands
Command
|
Description
|
show snmp
|
Checks the status of SNMP communications.
|
show snmp sessions
|
Displays the current SNMP sessions.
|
snmp-server manager
|
Starts the SNMP manager process.
|
snmp-server manager session-timeout
|
Sets the amount of time before a nonactive session is destroyed.
|
show snmp sessions
To display the current Simple Network Management Protocol (SNMP) sessions, use the show snmp sessions command in EXEC mode.
show snmp sessions [brief]
Syntax Description
brief
|
(Optional) Displays a list of sessions only. Does not display session statistics.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
11.3 T
|
This command was introduced.
|
Usage Guidelines
Sessions are created when the SNMP manager in the router sends SNMP requests, such as inform requests, to a host or receives SNMP notifications from a host. One session is created for each destination host. If there is no further communication between the router and host within the session timeout period, the corresponding session will be deleted.
Examples
The following is sample output from the show snmp sessions command:
Router# show snmp sessions
Destination: 172.16.58.33.162, V2C community: public
Round-trip-times: 0/0/0 (min/max/last)
0 Gets, 0 GetNexts, 0 GetBulks, 0 Sets, 4 Informs
0 Traps, 0 Informs, 0 Responses (0 errors)
Destination: 172.16.217.141.162, V2C community: public, Expires in 575 secs
Round-trip-times: 1/1/1 (min/max/last)
0 Gets, 0 GetNexts, 0 GetBulks, 0 Sets, 4 Informs
0 Traps, 0 Informs, 4 Responses (0 errors)
Table 115 describes the significant fields shown in the output.
The following is sample output from the show snmp sessions brief command:
Router# show snmp sessions brief
Destination: 172.16.58.33.161, V2C community: public, Expires in 55 secs
Table 115 describes the significant fields shown in the display.
Table 115 show snmp sessions Field Descriptions
Field
|
Description
|
Destination
|
IP address of the remote agent.
|
V2C community
|
SNMP version 2C community string used to communicate with the remote agent.
|
Expires in
|
Remaining time before the session timeout expires.
|
Round-trip-times
|
Minimum, maximum, and the last round-trip time to the agent.
|
packets output
|
Packets sent by the router.
|
Gets
|
Number of get requests sent.
|
GetNexts
|
Number of get-next requests sent.
|
GetBulks
|
Number of get-bulk requests sent.
|
Sets
|
Number of set requests sent.
|
Informs
|
Number of inform requests sent.
|
Timeouts
|
Number of request timeouts.
|
Drops
|
Number of packets that could not be sent.
|
packets input
|
Packets received by the router.
|
Traps
|
Number of traps received.
|
Informs
|
Number of inform responses received.
|
Responses
|
Number of request responses received.
|
errors
|
Number of responses that contained an SNMP error code.
|
Related Commands
Command
|
Description
|
show snmp
|
Checks the status of SNMP communications.
|
show snmp pending
|
Displays the current set of pending SNMP requests.
|
snmp-server manager
|
Starts the SNMP manager process.
|
snmp-server manager session-timeout
|
Sets the amount of time before a nonactive session is destroyed.
|
show snmp user
To display information on each Simple Network Management Protocol (SNMP) username in the group username table, use the show snmp user command in EXEC mode.
show snmp user
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.0(3)T
|
This command was introduced.
|
Usage Guidelines
An SNMP user is a remote user for which an SNMP management operation is performed. For example, inform operations can be sent to a user on a remote SNMP engine. The user is designated using the snmp-server user command.
Examples
The following example specifies the username as authuser, the engine ID string as 00000009020000000C025808, and the storage-type as nonvolatile:
Engine ID: 00000009020000000C025808
storage-type: nonvolatile
Table 116 describes the fields shown in the display.
Table 116 show snmp user Field Descriptions
Field
|
Definition
|
User name
|
A string identifying the name of the SNMP user.
|
Engine ID
|
A string identifying the name of the copy of SNMP on the device.
|
storage-type
|
Indicates whether the settings have been set in volatile or temporary memory on the device, or in nonvolatile or persistent memory where settings will remain after the device has been turned off and on again.
|
Related Commands
Command
|
Description
|
snmp-server user
|
Configures a new user to an SNMP group.
|
show sntp
To show information about the Simple Network Time Protocol (SNTP), use the show sntp command in EXEC mode on a Cisco 1003, Cisco 1004, Cisco 1005, Cisco 1600, Cisco 1720, or Cisco 1750 router.
show sntp
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
11.2
|
This command was introduced.
|
Examples
The following is sample output from the show sntp command:
SNTP server Stratum Version Last Receive
172.16.118.9 5 3 00:01:02
172.21.28.34 4 3 00:00:36 Synced Bcast
Broadcast client mode is enabled.
Table 117 describes the significant fields shown in the display.
Table 117 show sntp Field Descriptions
Field
|
Description
|
SNTP server
|
Address of the configured or broadcast NTP server.
|
Stratum
|
NTP stratum of the server. The stratum indicates how far away from an authoritative time source the server is.
|
Version
|
NTP version of the server.
|
Last Receive
|
Time since the last NTP packet was received from the server.
|
Synced
|
Indicates the server chosen for synchronization.
|
Bcast
|
Indicates a broadcast server.
|
Related Commands
Command
|
Description
|
sntp broadcast client
|
Configures a Cisco 1003, Cisco 1004, Cisco 1005, Cisco 1600, Cisco 1720, or Cisco 1750 router to use SNTP to accept NTP traffic from any broadcast server.
|
sntp server
|
Configures a Cisco 1003, Cisco 1004, Cisco 1005, Cisco 1600, Cisco 1720, or Cisco 1750 router to use SNTP to request and accept NTP traffic from a time server.
|
show stacks
To monitor the stack usage of processes and interrupt routines, use the show stacks command in EXEC mode.
show stacks
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
The display from this command includes the reason for the last system reboot. If the system was reloaded because of a system failure, a saved system stack trace is displayed. This information is of use only to your technical support representative in analyzing crashes in the field. It is included here in case you need to read the displayed statistics to an engineer over the phone.
Examples
The following is sample output from the show stacks command following a system failure:
Level Called Free/Size Name
3 738 900/1000 Multiport Communications Interfaces
5 178 970/1000 Console UART
System was restarted by bus error at PC 0xAD1F4, address 0xD0D0D1A
GS Software (GS3), Version 9.1(0.16), BETA TEST SOFTWARE
Compiled Tue 11-Aug-92 13:27 by jthomas
Stack trace from system failure:
FP: 0x29C158, RA: 0xACFD4
FP: 0x29C184, RA: 0xAD20C
FP: 0x29C1B0, RA: 0xACFD4
FP: 0x29C1DC, RA: 0xAD304
FP: 0x29C1F8, RA: 0xAF774
FP: 0x29C214, RA: 0xAF83E
FP: 0x29C228, RA: 0x3E0CA
FP: 0x29C244, RA: 0x3BD3C
Related Commands
Command
|
Description
|
show processes
|
Displays information about the active processes.
|
show startup-config
The more nvram:startup-config command has been replaced by the show startup-config command. See the description of the more command in the "Cisco IOS File System Commands" chapter for more information.
show subsys
To display the subsystem information, use the show subsys command in privileged EXEC mode.
show subsys [class class | name name]
Syntax Description
class class
|
(Optional) Displays the subsystems of the specified class. Valid classes are driver, kernel, library, management, protocol, and registry.
|
name name
|
(Optional) Displays the specified subsystem. Use the asterisk character (*) as a wildcard at the end of the name to list all subsystems, starting with the specified characters.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.1
|
This command was introduced.
|
Usage Guidelines
Use the show subsys command to confirm that all required features are in the running image.
Examples
The following is sample output from the show subsys command:
static_map Kernel 1.000.001
compress Kernel 1.000.001
alignment Kernel 1.000.002
ip_addrpool_sys Library 1.000.001
flash_services Library 1.000.001
ip_localpool_sys Library 1.000.001
nvram_common Driver 1.000.001
oc12suni Driver 1.000.001
Table 118 describes the fields shown in the display.
Table 118 show subsys Field Descriptions
Field
|
Description
|
static_map
|
Name of the subsystem.
|
Class
|
Class of the subsystem. Possible classes include Kernel, Library, Driver, Protocol, Management, Registry, and SystemInit.
|
Version
|
Version of the subsystem.
|
show tcp
To display the status of TCP connections, use the show tcp command in EXEC mode.
show tcp [line-number]
Syntax Description
line-number
|
(Optional) Absolute line number of the line for which you want to display Telnet connection status.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Examples
The following is sample output from the show tcp command:
tty0, connection 1 to host cider
Connection state is ESTAB, I/O status: 1, unread input bytes: 0
Local host: 172.31.232.17, Local port: 11184
Foreign host: 172.31.1.137, Foreign port: 23
Enqueued packets for retransmit: 0, input: 0, saved: 0
Event Timers (current time is 67341276):
Timer: Retrans TimeWait AckHold SendWnd KeepAlive GiveUp PmtuAger
iss: 67317172 snduna: 67317228 sndnxt: 67317228 sndwnd: 4096
irs: 1064896000 rcvnxt: 1064897597 rcvwnd: 2144 delrcvwnd: 0
SRTT: 317 ms, RTTO: 900 ms, RTV: 133 ms, KRTT: 0 ms
minRTT: 4 ms, maxRTT: 300 ms, ACK hold: 300 ms
Flags: higher precedence, idle user, retransmission timeout
Datagrams (max data segment is 536 bytes):
Rcvd: 41 (out of order: 0), with data: 34, total data bytes: 1596
Sent: 57 (retransmit: 1), with data: 35, total data bytes: 55
Table 119 describes the first five lines of output shown in the display.
Table 119 show tcp Field Descriptions—First Section of Output
Field
|
Description
|
tty0
|
Identifying number of the line.
|
connection 1
|
Number identifying the TCP connection.
|
to host xxx
|
Name of the remote host to which the connection has been made.
|
Connection state is ESTAB
|
A connection progresses through a series of states during its lifetime. These states follow in the order in which a connection progresses through them.
• LISTEN—Waiting for a connection request from any remote TCP and port.
• SYNSENT—Waiting for a matching connection request after having sent a connection request.
• SYNRCVD—Waiting for a confirming connection request acknowledgment after having both received and sent a connection request.
• ESTAB—Indicates an open connection; data received can be delivered to the user. This is the normal state for the data transfer phase of the connection.
• FINWAIT1—Waiting for a connection termination request from the remote TCP or an acknowledgment of the connection termination request previously sent.
• FINWAIT2—Waiting for a connection termination request from the remote TCP host.
• CLOSEWAIT—Waiting for a connection termination request from the local user.
• CLOSING—Waiting for a connection termination request acknowledgment from the remote TCP host.
• LASTACK—Waiting for an acknowledgment of the connection termination request previously sent to the remote TCP host.
• TIMEWAIT—Waiting for enough time to pass to be sure the remote TCP host has received the acknowledgment of its connection termination request.
• CLOSED—Indicates no connection state at all.
For more information, see RFC 793, Transmission Control Protocol Functional Specification.
|
I/O status:
|
Number describing the current internal status of the connection.
|
unread input bytes:
|
Number of bytes that the lower-level TCP processes have read, but the higher-level TCP processes have not yet processed.
|
Local host:
|
IP address of the network server.
|
Local port:
|
Local port number, as derived from the following equation: line-number + (512 * random-number). (The line number uses the lower nine bits; the other bits are random.)
|
Foreign host:
|
IP address of the remote host to which the TCP connection has been made.
|
Foreign port:
|
Destination port for the remote host.
|
Enqueued packets for retransmit:
|
Number of packets waiting on the retransmit queue. These are packets on this TCP connection that have been sent but have not yet been acknowledged by the remote TCP host.
|
input:
|
Number of packets that are waiting on the input queue to be read by the user.
|
saved:
|
Number of received out-of-order packets that are waiting for all packets comprising the message to be received before they enter the input queue. For example, if packets 1, 2, 4, 5, and 6 have been received, packets 1 and 2 would enter the input queue, and packets 4, 5, and 6 would enter the saved queue.
|
The following line of output shows the current time according to the system clock of the local host:
Event Timers (current time is 67341276):
The time shown is the number of milliseconds since the system started.
The following lines of output display the number of times that various local TCP timeout values were reached during this connection. In this example, the local host re-sent data 30 times because it received no response from the remote host, and it sent an acknowledgment many more times because there was no data on which to piggyback.
Timer: Retrans TimeWait AckHold SendWnd KeepAlive GiveUp PmtuAger
Table 120 describes the fields in the preceding lines of output.
Table 120 show tcp Field Descriptions—Second Section of Output
Field
|
Description
|
Timer:
|
The names of the timers in the display.
|
Starts:
|
The number of times the timer has been started during this connection.
|
Wakeups:
|
Number of keepalives sent without receiving any response. (This field is reset to zero when a response is received.)
|
Next:
|
The system clock setting that will trigger the next time this timer will go off.
|
Retrans
|
The Retransmission timer is used to time TCP packets that have not been acknowledged and are waiting for retransmission.
|
TimeWait
|
The TimeWait timer is used to ensure that the remote system receives a request to disconnect a session.
|
AckHold
|
The Acknowledgment timer is used to delay the sending of acknowledgments to the remote TCP in an attempt to reduce network use.
|
SendWnd
|
The Send Window is used to ensure that there is no closed window due to a lost TCP acknowledgment.
|
KeepAlive
|
The KeepAlive timer is used to control the transmission of test messages to the remote TCP to ensure that the link has not been broken without the local TCP's knowledge.
|
GiveUp
|
The GiveUp timer determines the amount of time a local host will wait for an acknowledgement (or other appropriate reply) of a transmitted message after the the maximum number of retransmissions has been reached. If the timer expires, the local host gives up retransmission attempts and declares the connection dead.
|
PmtuAger
|
The PMTU age timer is a time interval for how often TCP reestimates the path MTU with a larger maximum segment size (MSS). When the age timer is used, TCP path MTU becomes a dynamic process. If the MSS is smaller than what the peer connection can manage, a larger MSS is tried every time the age timer expires. The discovery process stops when the send MSS is as large as the peer negotiated or the timer has been manually disabled by setting it to infinite.
|
The following lines of output display the sequence numbers that TCP uses to ensure sequenced, reliable transport of data. The local host and remote host each use these sequence numbers for flow control and to acknowledge receipt of datagrams.
iss: 67317172 snduna: 67317228 sndnxt: 67317228 sndwnd: 4096
irs: 1064896000 rcvnxt: 1064897597 rcvwnd: 2144 delrcvwnd: 0
Table 121 describes the fields shown in the display.
Table 121 show tcp Field Descriptions—Sequence Number
Field
|
Description
|
iss:
|
Initial send sequence number.
|
snduna:
|
Last send sequence number that the local host sent but has not received an acknowledgment for.
|
sndnxt:
|
Sequence number the local host will send next.
|
sndwnd:
|
TCP window size of the remote host.
|
irs:
|
Initial receive sequence number.
|
rcvnxt:
|
Last receive sequence number that the local host has acknowledged.
|
rcvwnd:
|
TCP window size of the local host.
|
delrcvwnd:
|
Delayed receive window—data the local host has read from the connection, but has not yet subtracted from the receive window the host has advertised to the remote host. The value in this field gradually increases until it is larger than a full-sized packet, at which point it is applied to the rcvwnd field.
|
The following lines of output display values that the local host uses to keep track of transmission times so that TCP can adjust to the network it is using.
SRTT: 317 ms, RTTO: 900 ms, RTV: 133 ms, KRTT: 0 ms
minRTT: 4 ms, maxRTT: 300 ms, ACK hold: 300 ms
Flags: higher precedence, idle user, retransmission timeout
Table 122 describes the significant fields shown in the output.
Table 122 show tcp Field Descriptions—Line Beginning with "SRTT"
Field
|
Description
|
SRTT:
|
A calculated smoothed round-trip timeout.
|
RTTO:
|
Round-trip timeout.
|
RTV:
|
Variance of the round-trip time.
|
KRTT:
|
New round-trip timeout (using the Karn algorithm). This field separately tracks the round-trip time of packets that have been re-sent.
|
minRTT:
|
Smallest recorded round-trip timeout (hard-wire value used for calculation).
|
maxRTT:
|
Largest recorded round-trip timeout.
|
ACK hold:
|
Time the local host will delay an acknowledgment in order to piggyback data on it.
|
Flags:
|
Properties of the connection.
|
For more information on these fields, refer to Round Trip Time Estimation, P. Karn & C. Partridge, ACM SIGCOMM-87, August 1987.
Datagrams (max data segment is 536 bytes):
Rcvd: 41 (out of order: 0), with data: 34, total data bytes: 1596
Sent: 57 (retransmit: 1), with data: 35, total data bytes: 55
Table 123 describes the significant fields shown in the last lines of the show tcp command output.
Table 123 show tcp Field Descriptions—Last Section of Output
Field
|
Description
|
Rcvd:
|
Number of datagrams the local host has received during this connection (and the number of these datagrams that were out of order).
|
with data:
|
Number of these datagrams that contained data.
|
total data bytes:
|
Total number of bytes of data in these datagrams.
|
Sent:
|
Number of datagrams the local host sent during this connection (and the number of these datagrams that needed to be re-sent).
|
with data:
|
Number of these datagrams that contained data.
|
total data bytes:
|
Total number of bytes of data in these datagrams.
|
Related Commands
Command
|
Description
|
show tcp brief
|
Displays a concise description of TCP connection endpoints.
|
show tcp brief
To display a concise description of TCP connection endpoints, use the show tcp brief command in EXEC mode.
show tcp brief [all]
Syntax Description
all
|
(Optional) Displays status for all endpoints. Without this keyword, endpoints in the LISTEN state are not shown.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
11.2
|
This command was introduced.
|
Examples
The following is sample output from the show tcp brief command while a user has connected into the system via Telnet:
TCB Local Address Foreign Address (state)
609789AC Router.cisco.com.23 cider.cisco.com.3733 ESTAB
Table 124 describes the significant fields shown in the display.
Table 124 show tcp brief Field Descriptions
Field
|
Description
|
TCB
|
An internal identifier for the endpoint.
|
Local Address
|
The local IP address and port.
|
Foreign Address
|
The foreign IP address and port (at the opposite end of the connection).
|
(state)
|
The state of the connection. States are described in the syntax description of the show tcp command.
|
Related Commands
Command
|
Description
|
show tcp
|
Displays the status of TCP connections.
|
show tdm data
To display a snapshot of the time-division multiplexing (TDM) bus data memory in Cisco Access Servers, use the show tdm data command in EXEC mode.
show tdm data [motherboard | slot slot-number]
Syntax Description
motherboard
|
(Optional) Displays data for the motherboard (system plane).
|
slot slot-number
|
(Optional) Displays data for the specified interface (slot number).
|
Command Modes
EXEC
Command History
Release
|
Modification
|
11.2
|
This command was introduced for Cisco AS5200 access servers.
|
Usage Guidelines
The data memory for all TDM bus connections in the access server is displayed if you do not specify a motherboard or slot number.
Examples
In the following example, a snapshot of TDM memory is shown where the normal ISDN idle pattern (0x7E) is present on all channels of the TDM device resident on the motherboard:
AS5200# show tdm data motherboard
MT8980 motherboard unit 0, Control Register = 0x1F, ODE Register = 0x06
Ch0: 0x7E, Ch1: 0x7E, Ch2: 0x7E, Ch3: 0x7E
Ch4: 0x7E, Ch5: 0x7E, Ch6: 0x7E, Ch7: 0x7E
Ch8: 0x7E, Ch9: 0x7E, Ch10: 0x7E, Ch11: 0x7E
Ch12: 0x7E, Ch13: 0x7E, Ch14: 0x7E, Ch15: 0x7E
Ch16: 0x7E, Ch17: 0x7E, Ch18: 0x7E, Ch19: 0x7E
Ch20: 0x7E, Ch21: 0x7E, Ch22: 0x7E, Ch23: 0x7E
Ch24: 0x7E, Ch25: 0x7E, Ch26: 0x7E, Ch27: 0x7E
Ch28: 0x7E, Ch29: 0x7E, Ch30: 0x7E, Ch31: 0x7E
Ch0: 0x7E, Ch1: 0x7E, Ch2: 0x7E, Ch3: 0x7E
Ch4: 0x7E, Ch5: 0x7E, Ch6: 0x7E, Ch7: 0x7E
Ch8: 0x7E, Ch9: 0x7E, Ch10: 0x7E, Ch11: 0x7E
Ch12: 0x7E, Ch13: 0x7E, Ch14: 0x7E, Ch15: 0x7E
Ch16: 0x7E, Ch17: 0x7E, Ch18: 0x7E, Ch19: 0x7E
Ch20: 0x7E, Ch21: 0x7E, Ch22: 0x7E, Ch23: 0x7E
Ch24: 0x7E, Ch25: 0x7E, Ch26: 0x7E, Ch27: 0x7E
Ch28: 0x7E, Ch29: 0x7E, Ch30: 0x7E, Ch31: 0x7E
Related Commands
Command
|
Description
|
show tdm connections
|
Displays data about the TDM bus connection memory in a Cisco AS5200 access server.
|
show tech-support
To display general information about the router when reporting a problem, use the show tech-support privileged EXEC command.
show tech-support [page] [password] [cef | ipmulticast | isis | mpls | ospf [process-ID | detail] |
rsvp]
Syntax Description
page
|
(Optional) Causes the output to display a page of information at a time. Use the return key to display the next line of output or use the space bar to display the next page of information. If not used, the output scrolls (that is, does not stop for page breaks).
|
password
|
(Optional) Leaves passwords and other security information in the output. If not used, passwords and other security-sensitive information in the output are replaced with the label "<removed>" (this is the default).
|
cef
|
(Optional) Displays show command output specific to Cisco Express Forwarding (CEF).
|
ipc
|
(Optional) Displays show command output specific to Inter-Process Communications (IPC).
|
ipmulticast
|
(Optional) Displays show command output related to the IP Multicast configuration, including Protocol Independent Multicast (PIM) information, Internet Group Management Protocol (IGMP) information, and Distance Vector Multicast Routing Protocol (DVMRP) information.
|
isis
|
(Optional) Displays show command output specific to Connectionless Network Service (CLNS) and Intermediate System-to-Intermediate System Protocol (ISIS).
|
mpls
|
(Optional) Displays show command output specific to Multilayer Switching Protocol (MPLS) forwarding and applications.
|
ospf [ process-ID | detail]
|
(Optional) Displays show command output specific to Open Shortest Path First Protocol (OSPF) networking.
|
rsvp
|
(Optional) Displays show command output specific to Resource Reservation Protocol (RSVP) networking.
|
Defaults
The output scrolls without page breaks.
Passwords and other security information are removed from the output.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.2
|
This command was introduced.
|
11.3(7), 11.3(7)T, 11.2(16)
|
The output for this command was expanded to show additional information for boot, bootflash, context, and traffic for all enabled protocols.
|
12.0
|
The following keyword extensions were added:
• cef
• ipmulticast
• isis
• mpls
• ospf
|
Usage Guidelines
The show tech-support command is useful for collecting a large amount of information about your routing device for troubleshooting purposes. The output of this command can be provided to technical support representatives when reporting a problem.
The show tech-support command displays the output of a number of show commands at once. The output from this command will vary depending on your platform and configuration. For example, Access Servers will display voice-related show output. Additionally, the show protocol traffic commands will be displayed for only the protocols enabled on your device. The output of the show tech-support command can include the output of the following commands:
•
show apollo traffic
•
show appletalk traffic
•
show bootflash
•
show bootvar
•
show buffers
•
show cdp neighbors
•
show cef
•
show clns traffic
•
show context
•
show controllers
•
show decnet traffic
•
show interfaces
•
show ip cef
•
show ip interface
•
show ip traffic
•
show isis
•
show mpls
•
show novell traffic
•
show processes cpu
•
show processes memory
•
show running-config
•
show stacks
•
show version
•
show vines traffic
•
show xns traffic
•
show file systems
•
dir nvram:
•
show disk0: all
•
show process cpu
•
show pci controller
Use of the optional cef, ipmulticast, ipc, isis, mpls , ospf, or rsvp keywords provides a way to display a number of show commands specific to a particular protocol or process in addition to the show commands listed previously.
For example, if your TAC support representative suspects that you may have a problem in your Cisco Express Forwarding (CEF) configuration, you may be asked to provide the output of the show tech-support cef command. The show tech-support [page] [password] cef command will display the output from the following commands in addition to the output for the standard show tech-support command:
•
show ip cef summary
•
show adjacency summary
•
show ip cef events summary
•
show ip cef inconsistency records detail
•
show cef interface
•
show cef events
•
show cef timers
•
show interfaces stats
•
show cef drop
•
show cef not-cef-switched
Examples
For a sample display of the output from the show tech-support command, refer to the documentation for the show commands listed in the "Usage Guidelines" section.
Related Commands
Command
|
Description
|
show apollo traffic
|
Displays information about the number and type of Apollo Domain packets transmitted and received by the Cisco IOS software.
|
show appletalk traffic
|
Displays statistics about AppleTalk traffic, including MacIP traffic.
|
show bootflash
|
Displays the contents of boot Flash memory.
|
show bootvar
|
Displays the contents of the BOOT environment variable, the name of the configuration file pointed to by the CONFIG_FILE environment variable, the contents of the BOOTLDR environment variable, and the configuration register setting.
|
show buffers
|
Displays statistics for the buffer pools on the network server.
|
show clns traffic
|
Displays a list of the CLNS packets this router has seen.
|
show context
|
Displays context data.
|
show controllers
|
Displays information that is specific to the hardware.
|
show controllers tech-support
|
Displays general information about a VIP card when reporting a problem.
|
show decnet traffic
|
Displays the DECnet traffic statistics (including datagrams sent, received, and forwarded).
|
show interfaces
|
Displays ALC information.
|
show ip traffic
|
Displays statistics about IP traffic.
|
show novell traffic
|
Displays information about the number and type of IPX packets transmitted and received.
|
show processes cpu
|
Displays information about the active processes.
|
show processes memory
|
Shows the amount of memory used.
|
show running-config
|
Displays the current configuration of your routing device.
|
show stacks
|
Displays the stack usage of processes and interrupt routines.
|
show version
|
Displays the configuration of the system hardware, the software version, the names and sources of configuration files, and the boot images.
|
show vines traffic
|
Displays the statistics maintained about VINES protocol traffic.
|
show xns traffic
|
Displays information about the number and type of XNS packets transmitted and received by the Cisco IOS software.
|
show time-range
To display information about configured time ranges, use the show time-range command in user EXEC or privileged EXEC mode.
show time-range
Syntax Description
This command has no arguments or keywords.
Command Default
This command has no default behavior.
Command Modes
User EXEC and Privileged EXEC
Command History
Release
|
Modification
|
12.2
|
This command was introduced.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.33(SRA).
|
Usage Guidelines
Use this command to display configured time ranges.
Examples
The following is sample output for the show time-range command. The word (active) indicates that the time range is in effect at that moment; otherwise, the output will indicate (inactive).
time-range entry: test (active)
absolute start 00:00 01 January 2006 end 23:59 31 December 2006
periodic weekdays 8:00 to 20:00
Related Commands
Command
|
Description
|
time-range
|
Specifies a time range by name and allows you configure a range during which an access list, for example, is active.
|
show version
To display information about the currently loaded software version along with hardware and device information, use the show version command in EXEC mode.
show version
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
9.0
|
This command was introduced.
|
12.3(4)T
|
The output format of this command was updated.
|
12.2(25)S
|
The output format of this command was updated.
|
Usage Guidelines
This command displays information about the Cisco IOS software version currently running on a routing device, the ROM Monitor and Bootflash software versions, and information about the hardware configuration, including the amount of system memory. Because this command displays both software and hardware information, the output of this command is the same as the output of the show hardware command. (The show hardware command is a command alias for the show version command.)
Specifically, the show version command provides the following information:
•
Software information
–
Main Cisco IOS image version
–
Main Cisco IOS image capabilities (feature set)
–
Location and name of bootfile in ROM
–
Bootflash image version (depending on platform)
•
Device-specific information
–
Device name
–
System uptime
–
System reload reason
–
Config-register setting
–
Config-register settings for after the next reload (depending on platform)
•
Hardware information
–
Platform type
–
Processor type
–
Processor hardware revision
–
Amount of main (processor) memory installed
–
Amount I/O memory installed
–
Amount of Flash memory installed on different types (depending on platform)
–
Processor board ID
The output of this command uses the following format:
Cisco IOS Software, <platform> Software (<image-id>), Version <software-version>,
<software-type>
TAC Support: http://www.cisco.com/tac
Copyright (c) <date-range> by Cisco Systems, Inc.
Compiled <day> <date> <time> by <compiler-id>
ROM: System Bootstrap, Version <software-version>, <software-type>
BOOTLDR: <platform> Software (image-id), Version <software-version>, <software-type>
<router-name> uptime is <w> weeks, <d> days, <h> hours, <m> minutes
System returned to ROM by reload at <time> <day> <date>
System image file is "<filesystem-location>/<software-image-name>"
Last reload reason: <reload-reason>
Cisco <platform-processor-type> processor (revision <processor-revision-id>) with
<free-DRAM-memory>K/<packet-memory>K bytes of memory.
Processor board ID <ID-number>
<CPU-type> CPU at <clock-speed>Mhz, Implementation <number>, Rev <Revision-number>,
<kilobytes-Processor-Cache-Memory>KB <cache-Level> Cache
See the Examples section for descriptions of the fields in this output.
Examples
The following is sample output from the show version command issued on a Cisco 3660 running Cisco IOS Release 12.3(4)T:
Cisco IOS Software, 3600 Software (C3660-I-M), Version 12.3(4)T
TAC Support: http://www.cisco.com/tac
Copyright (c) 1986-2003 by Cisco Systems, Inc.
Compiled Thu 18-Sep-03 15:37 by ccai
ROM: System Bootstrap, Version 12.0(6r)T, RELEASE SOFTWARE (fc1)
C3660-1 uptime is 1 week, 3 days, 6 hours, 41 minutes
System returned to ROM by power-on
System image file is "slot0:tftpboot/c3660-i-mz.123-4.T"
Cisco 3660 (R527x) processor (revision 1.0) with 57344K/8192K bytes of memory.
Processor board ID JAB055180FF
R527x CPU at 225Mhz, Implementation 40, Rev 10.0, 2048KB L2 Cache
3660 Chassis type: ENTERPRISE
2 FastEthernet interfaces
DRAM configuration is 64 bits wide with parity disabled.
16384K bytes of processor board System flash (Read/Write)
Flash card inserted. Reading filesystem...done.
20480K bytes of processor board PCMCIA Slot0 flash (Read/Write)
Configuration register is 0x2102
The following is sample output from the show version command issued on a Cisco 7200 router running Cisco IOS Release 12.4(4)T. This output shows the total bandwidth capacity and the bandwith capacity that is configured on the Cisco 7200. Displaying bandwidth capacity is available in Cisco IOS Release 12.2 and later releases.
Cisco IOS Software, 7200 Software (C7200-JS-M), Version 12.4(4)T, RELEASE SOFTW)
Technical Support: http://www.cisco.com/techsupport
Copyright (c) 1986-2005 by Cisco Systems, Inc.
Compiled Thu 27-Oct-05 05:58 by ccai
ROM: System Bootstrap, Version 12.1(20000710:044039) [nlaw-121E_npeb 117], DEVEE
BOOTLDR: 7200 Software (C7200-KBOOT-M), Version 12.3(16), RELEASE SOFTWARE (fc4)
router uptime is 5 days, 18 hours, 2 minutes
System returned to ROM by reload at 02:45:12 UTC Tue Feb 14 2006
System image file is "disk0:c7200-js-mz.124-4.T"
Last reload reason: Reload Command
Cisco 7206VXR (NPE400) processor (revision A) with 491520K/32768K bytes of memo.
Processor board ID 26793934
R7000 CPU at 350MHz, Implementation 39, Rev 3.2, 256KB L2 Cache
6 slot VXR midplane, Version 2.6
PCI bus mb0_mb1 (Slots 0, 1, 3 and 5) has a capacity of 600 bandwidth points.
Current configuration on bus mb0_mb1 has a total of 440 bandwidth points.
This configuration is within the PCI bus capacity and is supported.
PCI bus mb2 (Slots 2, 4, 6) has a capacity of 600 bandwidth points.
Current configuration on bus mb2 has a total of 390 bandwidth points
This configuration is within the PCI bus capacity and is supported.
Please refer to the following document "Cisco 7200 Series Port Adaptor
Hardware Configuration Guidelines" on Cisco.com <http://www.cisco.com>
for c7200 bandwidth points oversubscription and usage guidelines.
2 FastEthernet interfaces
62976K bytes of ATA PCMCIA card at slot 0 (Sector size 512 bytes).
125952K bytes of ATA PCMCIA card at slot 1 (Sector size 512 bytes).
8192K bytes of Flash internal SIMM (Sector size 256K).
Configuration register is 0x2002
For information about PCI buses and bandwidth calculation, go to /en/US/docs/routers/7200/configuration/7200_port_adapter_config_guidelines/3875In.html#wp1057192.
Table 125 describes the significant fields shown in the display.
Table 125 show version Field Descriptions
Field
|
Description
|
Cisco IOS Software, <platform> Software (<image-id>), Version <software-version>, <release-type>
Example:
Cisco IOS Software, 7200
Software (C7200-G4JS-M),
Version 12.3(4)T
|
platform—Cisco hardware device name.
image-id—The coded software image identifier, in the format platform-features-format (for example, "c7200-g4js-mz".
software-version—The Cisco IOS software release number, in the format x.y(z)A, where x.y is the main release identifier, z is the maintenance release number, and A, where applicable, is the special release train identifier. For example, 12.3(4)T indicates the fourth maintenance release of the 12.3T special technology release train.
Note In the full software image filename, 12.3(4)T appears as 123-4.T. In the IOS Upgrade Planner, 12.3(4)T appears as 12.3.4T (ED).
release-type—The description of the release type. Possible values include MAINTENANCE [for example, 12.3(3)] or INTERIM [for example, 12.3(3.2)].
Tips  Refer to "The ABC's of Cisco IOS Networking" (available on Cisco.com) for more information on Cisco IOS software release numbering and software versions.
Cisco IOS is a registered trademark (R) of Cisco Systems, Inc.
|
TAC Support:
http://www.cisco.com/tac
Copyright (c) <date-range> by Cisco Systems, Inc.
|
The Cisco Technical Assistance Center (TAC) contains more than 30,000 pages of searchable technical content, including links to products, technologies, solutions, technical tips, and tools. Registered Cisco.com users can log in from this page to access even more content.
Cisco IOS software, including the source code, user-help, and documentation, is copyrighted by Cisco Systems, Inc. It is Cisco's policy to enforce its copyrights against any third party who infringes on its copyright.
|
ROM: System Bootstrap,
Version 12.0(6r)T, RELEASE
SOFTWARE (fc1)
|
The system "bootstrap" software, stored in ROM memory.
|
BOOTFLASH:
|
The system "bootflash" software, stored in Flash memory (if applicable).
|
Example:
C3660-1 uptime is 1 week, 3
days, 6 hours, 41 minutes
|
The amount of time the system has been up and running.
|
System returned to ROM by
<reload-reason> at <time>
<day> <date>
Example:
System returned to ROM by
reload at 20:56:53 UTC Tue
Nov 4 2003
|
Shows the last recorded reason for a system reload, and time of last reload.
|
Last reload reason:
<reload-reason>
Example:
Last reload reason: Reload
command
|
Shows the last recorded reason for a system reload.
|
Last reset from
<reset-reason>
Example:
|
Shows the last recorded reason for a system reset. Possible reset-reason values include:
• power-on—System was reset with the initial power on or a power cycling of the device.
• s/w peripheral—System was reset due to a software peripheral.
• s/w nmi—System was reset by a nonmaskable interrupt (NMI) originating in the system software. For example, on some systems, you can configure the device to reset automatically if two or more fans fail.
• push-button—System was reset by manual activation of a RESET push-button (also called a hardware NMI).
• watchdog—System was reset due to a watchdog process.
• unexpected value—May indicate a bus error, such as for an attempt to access a nonexistent address (for example, "System restarted by bus error at PC 0xC4CA, address 0x210C0C0").
(This field was formerly labeled as the "System restarted by" field.")
|
System image file is
"<file-location/file-name>"
Example:
System image file is
"slot0:tftpboot/c3660-i-mz.1
23-3.9.T2"
|
Displays the file location (local or remote filesystem) and the system image name.
|
Cisco <platform>
(<processor-type>) processor
(revision
<processor-revision-id>)
with
<free-DRAM-memory>K/<packet-
memory>K bytes of memory.
Example: Separate DRAM and Packet Memory
Cisco RSP4 (R5000) processor
with 65536K/2072K bytes of
memory
Example: Combined DRAM and Packet Memory
Cisco 3660 (R527x) processor
(revision 1.0) with
57344K/8192K bytes of
memory.
|
This line can be used to determine how much Dynamic RAM (DRAM) is installed on your system, in order to determine if you meet the "Min. Memory" requirement for a software image. DRAM (including SDRAM) is used for system processing memory and for packet memory.
Two values, separated by a slash, are given for DRAM: The first value tells you how DRAM is available for system processing, and the second value tells you how much DRAM is being used for Packet memory.
The first value, Main Processor memory, is either:
• The amount of DRAM available for the processor, or
• The total amount of DRAM installed on the system.
The second value, Packet memory, is either:
• The total physical input/output (I/O) memory (or "Fast memory") installed on the router (Cisco 4000, 4500, 4700, and 7500 series), or
• The amount of "shared memory" used for packet buffering. In the shared memory scheme (Cisco 2500, 2600, 3600, and 7200 Series), a percentage of DRAM is used for packet buffering by the router's network interfaces.
Note The terms "I/O memory" or "iomem"; "shared memory"; "Fast memory" and "PCI memory" all refer to "Packet Memory". Packet memory is either separate physical RAM or shared DRAM.
Separate DRAM and Packet Memory
The 4000, 4500, 4700, and 7500 series routers have separate DRAM and Packet memory, so you only need to look at the first number to determine total DRAM. In the example to the left for the Cisco RSP4, the first value shows that the router has 65536K (65,536 kilobytes, or 64 megabytes) of DRAM. The second value, 8192K, is the Packet memory.
Combined DRAM and Packet Memory
The 2500, 2600, 3600, and 7200 series routers require a minimum amount of I/O memory to support certain interface processors.
The 1600, 2500, 2600, 3600, and 7200 series routers use a fraction of DRAM as Packet memory, so you need to add both numbers to find out the real amount of DRAM. In the example to the left for the Cisco 3660, the router has 57,344 kilobytes (KB) of free DRAM and 8,192 KB dedicated to Packet memory. Adding the two numbers together gives you 57,344K + 8,192K = 65,536K, or 64 megabytes (MB) of DRAM.
|
|
|
For more details on memory requirements, see the document "How to Choose a Cisco IOSĀ® Software Release" on Cisco.com.
|
Configuration register is
<value>
Example:
Configuration register is
0x2142 (will be 0x2102 at
next reload)
|
Shows the current configured hex value of the software configuration register. If the value has been changed with the config-register command, the register value that will be used at the next reload is displayed in parenthesis.
The boot field (final digit) of the software configuration register dictates what the system will do after a reset.
For example, when the boot field of the software configuration register is set to 00 (for example, 0x0), and you press the NMI button on a Performance Route Processor (PRP), the user-interface remains at the ROM monitor prompt (rommon>) and waits for a user command to boot the system manually. But if the boot field is set to 01 (for example, 0x1), the system automatically boots the first Cisco IOS image found in the onboard Flash memory SIMM on the PRP.
The factory-default setting for the configuration register is 0x2102. This value indicates that the router will attempt to load a Cisco IOS software image from Flash memory and load the startup configuration file.
|
Related Commands
Command
|
Description
|
show inventory
|
Displays the Cisco Unique Device Identifier information, including the Product ID, the Version ID, and the Serial Number, for the hardware device and hardware components.
|
show whoami
To display information about the terminal line of the current user, including host name, line number, line speed, and location, use the show whoami command in EXEC mode.
show whoami [text]
Syntax Description
text
|
(Optional) Additional data to print to the screen.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
If text is included as an argument in the command, that text is displayed as part of the additional data about the line.
To prevent the information from being lost if the menu display clears the screen, this command always displays a --More-- prompt before returning. Press the space bar to return to the prompt.
Examples
The following example is sample output from the show whoami command:
Comm Server "Router", Line 0 at 0bps. Location "Second floor, West"
show xsm status
To display information and subscription status of the XML Subscription Manager (XSM) server and clients (such as VPN Device Manager [VDM]), and to display a list of XML data from the XSM server, use the show xsm status command in privileged EXEC mode.
show xsm status
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.1(6)E
|
This command was introduced.
|
12.2(9)YE
|
This command was integrated into Cisco IOS Release 12.2(9)YE.
|
12.2(9)YO1
|
This command was integrated into Cisco IOS Release 12.2(9)YO1.
|
12.2(13)T
|
This command was integrated into Cisco IOS Release 12.2(13)T.
|
Usage Guidelines
Use this command to display the following information: which subsystems and histories are enabled or disabled (XSM, Embedded Device Manager [EDM], VDM), XSM client version, number of XSM sessions, duration of XSM session, session IDs, client version and IP address, configuration and monitor privilege levels, and list of subscribed XML Request Descriptors (XRDs).
Examples
The following example shows one XSM session (Session ID = 2) active on the Cisco device for the XSM client at IP address 172.17.129.134, and how long this session has been connected to the XSM server (Session 2: Connected since 22:47:07 UTC Mon Jan 8 2001). The output shows that the XSM, VDM, and EDM subsystems, and EDM and VDM history collecting are enabled. XSM configuration privilege level is set at 15, with XSM monitor privilege level set at 1.
This output also shows the active XRDs (and their version) for Session 2:
XSM subsystem is Enabled.
VDM subsystem is Enabled.
EDM subsystem is Enabled.
XSM privilege configuration level 15.
XSM privilege monitor level 1.
Number of XSM Sessions : 1.
XSM Client v0.0(0.0)- @ 172.17.129.134
Connected since 22:47:07 UTC Mon Jan 8 2001
6 ) ipsec-topn-tunnels-by-traffic v1.0
7 ) ipsec-topn-tunnels-by-duration v1.0
Table 126 describes the significant fields shown in the display. (See Table 127 in the documentation of the show xsm xrd-list command for a full description of subscribed XRDs).
Table 126 show xsm status Field Descriptions
Field
|
Description
|
XSM privilege configuration level
|
XSM configuration privilege level.
|
XSM privilege monitor level
|
XSM monitor privilege level.
|
Number of XSM Sessions
|
Total number of concurrent XSM sessions.
|
Session ID
|
Specific XSM session number.
|
XSM Client
|
Version and IP address of the XSM client.
|
Connected since
|
Start time for each session connection to the XSM server.
|
List of subscribed xrds
|
Details XRDs available from the XSM server (see show xsm xrd-list command for complete list of XRDs).
|
Related Commands
Command
|
Description
|
clear xsm
|
Clears XSM client sessions.
|
show xsm xrd-list
|
Displays all XRDs for clients subscribed to the XSM server.
|
xsm
|
Enables XSM client access to the router.
|
xsm privilege configuration level
|
Enables configuration privilege level to subscribe to XRDs.
|
xsm privilege monitor level
|
Enables monitor privilege level to subscribe to XRDs.
|
show xsm xrd-list
To display all XML Request Descriptors (XRDs) for XML Subscription Manager (XSM) clients (such as the VPN Device Manager [VDM]) made available by subscription to the XSM server and to identify the required privilege levels, use the show xsm xrd-list command in privileged EXEC mode.
show xsm xrd-list
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.1(6)E
|
This command was introduced.
|
12.2(9)YE
|
This command was integrated into Cisco IOS Release 12.2(9)YE.
|
12.2(9)YO1
|
This command was integrated into Cisco IOS Release 12.2(9)YO1.
|
12.2(13)T
|
This command was integrated into Cisco IOS Release 12.2(13)T.
|
Usage Guidelines
Use this command to display the XRD version and minimum privilege level and type (configuration or monitor) required to view each XRD.
Examples
The following example shows some active XRDs on the XSM server. The end of each line displays the following:
•
XRD version number.
•
XRD privilege type (configuration or monitor), indicating the privilege level required.
This example displays all available XRDs because both relevant commands (xsm edm and xsm vdm) have been configured. However, if one command is not configured, only an abbreviated XRD list will appear.
Router# show xsm xrd-list
List of all available xrds:
0 ) vlan-db v1.0 privilege=configuration
1 ) entity v1.0 privilege=configuration
2 ) ip v1.0 privilege=configuration
3 ) ios-users v1.0 privilege=configuration
4 ) device-about v1.0 privilege=monitor
5 ) ios-image v1.0 privilege=configuration
6 ) if-stats v1.0 privilege=monitor
7 ) if-list v1.0 privilege=configuration
8 ) device-health v1.0 privilege=monitor
9 ) time v1.0 privilege=monitor
10) access-lists v1.0 privilege=configuration
11) ike-topn-tunnels-by-traffic v1.0 privilege=monitor
12) ike-topn-tunnels-by-errors v1.0 privilege=monitor
13) ike-topn-tunnels-by-duration v1.0 privilege=monitor
14) ike-stats v1.0 privilege=monitor
15) ike v1.0 privilege=configuration
16) certificate-authorities v1.0 privilege=configuration
17) ipsec-topn-tunnels-by-traffic v1.0 privilege=monitor
18) ipsec-topn-tunnels-by-errors v1.0 privilege=monitor
19) ipsec-topn-tunnels-by-duration v1.0 privilege=monitor
20) ipsec-stats v1.0 privilege=monitor
21) crypto-maps v1.0 privilege=configuration
22) ipsec v1.0 privilege=configuration
23) vdm-history v1.0 privilege=configuration
24) gre-tunnels v1.0 privilege=monitor
Table 127 describes (in alphabetical order) typical XRDs shown in the display.
Table 127 show xsm xrd-list Field Descriptions
Field
|
Descriptions
|
access-lists
|
IOS access control list (ACL) configuration.
|
certificate-authorities
|
IOS certificate authority (CA) configuration.
|
crypto-maps
|
IOS Crypto Map configuration.
|
device-about
|
General network device information.
|
device-health
|
General network device health statistics.
|
edm-history
|
Selected, historical statistics related to general embedded device management. (This field is not shown in the example above.)
|
entity
|
Summary of all physical and logical entities within a device.
|
gre-tunnels
|
All current GRE tunnels and respective statistics.
|
if-list
|
List of all interfaces and their respective IOS configurations.
|
if-stats
|
Statistics for all interfaces and their respective IOS configurations.
|
ike
|
IOS Internet Key Exchange (IKE) configuration.
|
ike-stats
|
Statistics related to IKE.
|
ike-topn-tunnels-by-duration
|
Top 10 IKE tunnels by duration (time).
|
ike-topn-tunnels-by-errors
|
Top 10 IKE tunnels by errors.
|
ike-topn-tunnels-by-traffic
|
Top 10 IKE tunnels by traffic volume.
|
ios-image
|
Information about the current running IOS image.
|
ios-users
|
Local IOS user configuration.
|
ip
|
IOS IP configuration statistics.
|
ipsec
|
IOS IPSec configuration.
|
ipsec-stats
|
Interface name and IPSec input and output statistics including: number of packets, dropped packets, octets and errors.
|
ipsec-topn-tunnels-by-duration
|
Top 10 IPSec tunnels by duration.
|
ipsec-topn-tunnels-by-errors
|
Top 10 IPSec tunnels by errors.
|
ipsec-topn-tunnels-by-traffic
|
Top 10 IPSec tunnels by traffic.
|
time
|
Device's clock reading in UTC.
|
vdm-history
|
Selected, historical VPN-related statistics.
|
vlan-db
|
VLAN database configuration (switches only).
|
xsm-session
|
Status of the current XSM session and related subscriptions. (This field is not shown in the example above.)
|
Related Commands
Command
|
Description
|
clear xsm
|
Clears XSM client sessions.
|
show xsm status
|
Displays information and status about clients subscribed to the XSM server.
|
xsm
|
Enables XSM client access to the router.
|
xsm privilege configuration level
|
Enables configuration privilege level to subscribe to XRDs.
|
xsm privilege monitor level
|
Enables monitor privilege level to subscribe to XRDs.
|
showmon
To show both the ReadOnly and the Upgrade ROMmon image versions when you are in ROMmon mode, as well as which ROMmon image is running on the Cisco 7200 VXR or Cisco 7301 router, use the showmon command in ROMmon mode.
showmon
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
ROMmon
Command History
Release
|
Modification
|
12.0(28)S
|
This command was introduced on the Cisco 7200 VXR router. It was introduced in ROMmon version 12.3(4r)T1 for the Cisco 7200 VXR router.
|
12.3(8)T
|
This command was integrated into Cisco IOS Release 12.3(8)T and supported on the Cisco 7200 VXR router and Cisco 7301 router. It was introduced in ROMmon version 12.3(4r)T2 for the Cisco 7301 router.
|
12.3(9)
|
This command was integrated into Cisco IOS Release 12.3(9) and supported on the Cisco 7200 VXR router and Cisco 7301 router.
|
Usage Guidelines
Use the showmon command when you are in ROMmon mode. Use the show rom-monitor command when you are in Cisco IOS.
Examples
The following example, applicable to both the Cisco 7200 VXR and Cisco 7301 routers, uses the showmon command in ROMmon to display both ROMmon images and to verify that the Upgrade ROMmon image is running:
ReadOnly ROMMON version is:
System Bootstrap, Version 12.2(20031011:151758) [biff]
Copyright (c) 2004 by Cisco Systems, Inc.
Upgrade ROMMON version is:
System Bootstrap, Version 12.2(20031011:151758) [biff]
Copyright (c) 2004 by Cisco Systems, Inc.
Upgrade ROMMON currently running
Upgrade ROMMON is selected for next boot
Related Commands
Command
|
Description
|
rommon-pref
|
Selects a ReadOnly or Upgrade ROMmon image to be booted on the next reload of a Cisco 7200 VXR or Cisco 7301 when you are in ROMmon.
|
snmp ifmib ifalias long
To configure the system to handle IfAlias descriptions of up to 256 characters, use the snmp ifmib ifalias long command in global configuration mode. To limit the IfAlias description to 64 characters, use the no form of this command.
snmp ifmib ifalias long
no snmp ifmib ifalias long
Syntax Description
This command has no arguments or keywords.
Defaults
The ifAlias description is limited to 64 characters.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(2)T
|
This command was introduced.
|
Usage Guidelines
The ifAlias object (ifXEntry 18) of the Interfaces MIB (IF-MIB) is called the Interface Alias. The Interface Alias (ifAlias) is a user-specified description of an interface used for Simple Network Management Protocol (SNMP) network management. The ifAlias is an object in the Interfaces Group MIB (IF-MIB) which can be set by a network manager to "name" an interface.
The ifAlias value for an interface or subinterface can be set using the description command in interface configuration mode or subinterface configuration mode, or by using a Set operation from an NMS. Prior to the introduction of this command, ifAlias descriptions for subinterfaces were limited to 64 characters. (The OLD-CISCO-INTERFACES-MIB allows up to 255 characters for the locIfDescr MIB variable, but this MIB does not support subinterfaces.) IfAlias descriptions appear in the output of the show interfaces EXEC mode command, and in the output of the more system: running-config or show running-config EXEC mode commands.
Examples
In the following example, the system is configured to retain and return ifAlias values of up to 256 characters in length:
Router(config)# snmp ifmib ifalias long
Related Commands
Command
|
Description
|
description
|
Allows you to specify a description for the specified interface in human-readable form.
|
show snmp mib
|
Displays a list of the MIB module instance identifiers (OIDs) registered on your system.
|
show snmp mib ifmib ifindex
|
Displays SNMP Interface Index identification numbers (ifIndex values) for all the system interfaces or the specified system interface
|
snmp mib notification-log default
To create an unnamed Simple Network Management Protocol (SNMP) notification log, use the snmp mib notification-log default command in global configuration mode. To delete the log, use the no form of this command.
snmp mib notification-log default [size number]
no snmp mib notification-log default [size number]
Syntax Description
size number
|
(Optional) Maximum number of entries the log can contain. The default is 500 entries.
|
Defaults
500 entries
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.0(22)S
|
This command was introduced.
|
12.2(13)T
|
This command was integrated into Cisco IOS Release 12.2(13)T.
|
Usage Guidelines
This command creates a default unnamed SNMP notification log. The default log has a zero length string as its name (appears in the output of the show snmp mib notification-log command as Log Name"").
Creation and removal of the default log can only be performed using the Command Line Interface (CLI). Creation of named logs using the CLI or SNMP tools (SET operations) is not currently supported. No filters (varbinds) can be associated with the default log.
SNMP notification logging is enabled by default, but logging does not start until a specific log is created and defined using this command, or a named log is created using an SNMP Set operation from a network management station (NMS).
The no form of this command deletes the default notification log and removes the notifications that were a part of this log from the Notification Log MIB database (recursively deletes the log and all of its entries).
Examples