|
|
|
|
|
The following options are available with the display messages command.
start
The start option allows you to specify a starting time for display of messages. The system displays only messages that were logged at or after the time you specify. The time can be specified by date, time, or both date and time. Using today is equivalent to specifying the current date. Examples of specifying the date are:
"May 1, 2000"
"05/01/00"
"05-01-00"
Examples of specifying the time are:
hh:mm:ss
hour=hh
min=mm
sec=ss
where hh is 0 to 23, and mm and ss can be 0 to 59.
Do not mix the hh:mm:ss format with the item==xx format. If portions of the time are not specified, the time default is 0 hours, 0 minutes, and 0 seconds.
Also, giving only the time of day indicates the current date. For example, if today is January 15, 1993, the command display messages start "12/31 09:00" displays all of the messages that were logged starting at 9 am on December 31, 1993. In order to display messages from a previous year, you must specify the year. The entire start date and time must be enclosed in quotes (for example, display messages start "April 21, 1993 13:00:00" ).
If only the date is specified, the time defaults to the beginning of the day. For example, display messages start today displays all of the messages logged today (the day in which the command is executed).
stop
The stop option allows you to display messages logged up to a specific time. The date and time syntax is the same as for the start option. Therefore, display messages stop today displays all messages that were logged before today.
The start and stop options can be used together to display messages logged over a specific period of time. For example, display messages start "May 1" stop "May 2" displays all messages logged on May 1 of this year.
If you want the start and stop options to be the same day (for example, May 1), you must specify the hours and minutes for which you want to display messages. Otherwise, the time defaults to 00:00 for both the start and stop options and no messages are displayed.
card
The card option allows you to specify messages logged about a specific card or cards. For example, display messages card 2 displays all messages logged that are associated with card 2. You can display combinations of cards. For example, display messages card 2,3 displays messages for cards 2 and 3, and display messages card 0-2 displays messages for cards 0, 1, and 2.
You can also use the card option to display messages logged regarding a specific type of card. For example, display messages card NM displays all messages logged pertinent to NMS cards.
channel
The channel option works like the card option. For example, display messages channel IP displays all messages logged pertinent to VoIP channels, whereas display messages channel 5 displays all messages logged regarding channel 5.
Note:
The channel option requires an argument. Typing display messages channel 100 attempts to display all messages pertaining to channel 100. If you want to display the last 100 messages pertaining to any channel, type display messages channel all 100.
Note that specifying both the card option and the channel option displays all of the specified card-related messages but, of the channels that are specified, only those that reside on the specified cards are displayed. For example, display messages card NM channel all 100 displays the last 100 messages logged for NMS cards and NMS channels, whereas display messages card NM channel IP never displays any messages because it is impossible for a VoIP channel to reside on an NMS card.
id
The id option allows you to display specific message ids that have been logged. For example, display messages id ADMIN001 displays all occurrences of that message. For example, display messages id ADMIN001,ADMIN002 displays all occurrences of both messages.
source
The source option allows you to display messages logged by a particular system process. Some of the standard system processes are:
For example, display messages source NMSIP displays all messages logged regarding NMS cards and channels, where the message was logged from the NMSIP process.
The default source is all which displays messages for every process.
pattern
The pattern option allows you to specify a regular expression as accepted by logCat that may appear in any part of a message. The pattern must be enclosed in quotes and surrounded by slashes (/). For example, display messages pattern `/XYZ/' provides all messages that use the pattern XYZ anywhere in the message.
Note:
The pattern option is case-sensitive.
number
The number option specifies the number of messages you want to display, or you can use the all value to display all messages. The command accepts a three-digit number, so you can display up to 999 messages.
Although the number option only allows up to 3 digits, you may have more than 999 messages logged. Therefore, you can only view up to 999 messages in the message log report with the display messages command. The logCat command with the -t option can be used to display all logged messages.
Note:
The default number is 50. If all or a number greater than 50 is entered, a warning message will be displayed, telling you that system performance will be degraded.
