4.531 rtrv-log
Use this command to retrieve records from the active or standby Alarm and UIM logs generated by the Maintenance system. This command selects these records based on a span of time or a specific log file index.
Parameters
- dir (optional)
- Direction in which to obtain entries from within the log (forward or backward) for displaying. See the Dependencies and Notes sections for usage information.
- edate (optional)
- End date. Report only log entries that were created on or before the specified date (dir=fwd), or only log entries that were created on or after the specified date (dir=bkwd). See the Notes section for usage information.
- enum (optional)
- Ending Message Reference Number (MRN) for which to display entries. The ending Alarm or UIM number if specifying a range.
- Range:
- 1 - 1999
1-999 —Alarms (UAMs)
1000-1999 —UIMs
- Default:
- If enum is not specified and:
If snum is specified, the default enum value is the same as the specified snum value.
If snum is not specified and type is alarm or not specified, the default enum value is 999.
If snum is not specified and type is all or uim, the default enum value is 1999.
- etime (optional)
- End time. Report only log entries that were created on or before the specified time (dir=fwd), or only log entries that were created on or after the specified time (dir=bkwd). See the Notes section for usage information.
- mode (optional)
-
Log display mode; display all information or just summary information from each log entry.
Note:
If the entry is only one line, the same information (one line) is displayed in brief and full mode for that entry.
- next (optional)
- Number of additional records to display using the same direction (dir) and filtering criteria of outgrp, type, slog, and mode that were used for the previous successful
rtrv-logcommand at the same terminal.
- outgrp (optional)
- Output Group to sort or filter the Alarms (UAMs) and/or UIMs on.
- Range:
-
- all
- Retrieve information for all Output Groups
- appserv
- Application Server
- appss
- Application Subsystem
- card
- Card
- clk
- Clock
- db
- Database
- dbg
- Debug
- gtt
- GTT Maintenance
- gws
- GWS Maintenance
- link
- Link Maintenance
- meas
- Measurements Maintenance
- mon
- Monitoring (Sentinel or IMF) Maintenance
- mps
- MPS Maintenance
- pu
- Program Update
- sa
- System Administration
- seas
- SEAS (Sentinel or IMF)
- sys
- System Maintenance
- traf
- Traffic
- Default:
- If the next parameter is not specified, the default is all.
If the next parameter is specified, the output is the same as the immediately previous successful
rtrv-logcommand that was entered at the same terminal (and nortrv-logcommand was entered at another terminal).
- sdate (optional)
- Start date. Report only log entries that were created on or after the specified date (dir=fwd), or only log entries that were created on or before the specified date (dir=bkwd). See the Notes section for usage information.
- snum (optional)
- A single Alarm or UIM Message Reference Number (MRN), or the starting Alarm or UIM MRN if specifying a range. This parameter cannot be specified when the outgrp parameter is specified.
Example
rtrv-log:sdate=960715:stime=220000:num=50
rtrv-log:sdate=960715:stime=220000:num=50:snum=106
rtrv-log:sdate=960715:stime=220000:num=50:snum=106:enum=350
rtrv-log:next=100
Dependencies
No other rtrv-log command can already be in progress on the same OAM.
The initialization of the ELOG and UIM logs must be complete in the system before the rtrv-log command can be entered.
If the sdate and edate parameters are specified:
- In the forward direction, the sdate value must be less than or equal to the edate value.
- In the backward direction, the sdate value must be greater than or equal to the edate value.
The month component of the sdate and edate parameters must be in the range 1–12.
The day component of the sdate and edate parameters must be in the range 1–31 and must accurately reflect the number of days in the month and year indicated (see Notes section).
The seconds component of the stime and etime parameters must be in the range 00–59.
The minutes component of the stime and etime parameters must be in the range 00–59.
If the sdate parameter value is equal to the edate parameter value,
- In the forward direction, the stime value must be less than or equal to the etime value.
- In the backward direction, the stime value must be greater than or equal to the etime value.
The sdate parameter value plus the stime parameter value must be less than the current time and date combination.
If dir=bkwd is specified with a date and time range, sdate/stime must be greater than edate/etime.
When the enum parameter is specified, the snum parameter must be specified with a value less than or equal to the specified enum value.
The specified enum parameter value and the specified snum value must be within the same range: 1-999 for Alarms (UAMs) and 1000-1999 for UIMs.
The type parameter and the snum/enum parameters cannot be specified together in the command.
The rtrv-log:next= command must be entered on the same terminal where the previous successful rtrv-log command was entered in the system. No other parameters can be entered with the next parameter in the command.
The rtrv-log:next= command cannot be entered following a rtrv-log command that contained the type=all parameter. A rtrv-log command without the type=all parameter must be entered before the rtrv-log::next= command can be entered.
Because entries can be overwritten between the entry of a rtrv-log command without the next parameter and the entry of a rtrv-log:next= command, the rtrv-log:next: command might not execute successfully. Another rtrv-log command without the next parameter must be entered before the rtrv-log:next: command can be entered again,
The values specified for the edate with the stime parameter combination must be valid.
The values specified for the edate with stime and etime parameter combination must be valid.
When an enum parameter is specified, it requires an snum as its mated parameter.
No other parameters can be entered with the next parameter in the command.
The selected log must be accessible and free of errors.
The standby OAM is corrupt or cannot be found.
When the snum parameter is specified, it must be within the valid range: 1-999 for Alarms (UAMs) and 1000-1999 for UIMs.
When the enum parameter is specified, it must be within the valid range: 1-999 for Alarms (UAMs) and 1000-1999 for UIMs.
Notes
This command can be canceled using the F9 function key or the canc-cmd command. See canc-cmd for more information.
To accommodate the year 2000 and beyond, the two-digit year portion of dates is interpreted to be in the indicated century as follows:
- years 95–99 = 1995 through 1999
- years 00–94 = 2000 through 2094
This means that date 000101 (Jan. 1, 2000) is greater than 991231 (Dec. 31, 1999).
The day portion of any sdate/edate value entered must be in agreement with the month and year. The system issues error message E2252 if the day is found to be not valid (for example, 960631 is not a valid date). The system software and date/time hardware properly handle leap years and leap centuries. The year 2000 is a leap year.
When no date or time parameters are specified, the log display depends on the specified or default values of the num and dir parameters. The num parameter determines the maximum number of entries to display, and the dir parameter determines whether entries are displayed from the oldest end (dir=fwd or not specified) or the newest end (dir=bkwd).
When sdate is specified and edate is not specified in the forward direction, edate is defaulted to be the end of the log.
When edate is specified and sdate is not specified in the forward direction, sdate is defaulted to be the beginning of the log.
When sdate is specified and edate is not specified in the backward direction, edate is defaulted to be the beginning of the log.
When edate is specified and sdate is not specified in the backward direction, sdate is defaulted to be the end of the log.
When stime is specified and etime is not specified in the forward direction, etime is defaulted to 235959.
When etime is specified and stime is not specified in the forward direction, stime is defaulted to 000000.
When stime is specified and etime is not specified in the backward direction, rtime is defaulted to 000000.
When etime is specified and stime is not specified in the backward direction, stime is defaulted to 235959.
When stime or etime is specified but neither the sdate or edate parameters are specified, sdate and edate are each defaulted to the value today.
The num parameter is used to control the maximum number of entries to be displayed by one command.
The dir parameter is used to control whether preceding (older) or following (newer) records are displayed. In either output format, records are displayed in time order regardless of the retrieval control of the dir parameter.
Because logging does not stop while records are displaying, old records that were displayed can be overwritten before they are accessed again.
After the date or time is changed in the system, output records can show anomalies in the date-time stamp. An example of this occurs when the time is changed back—in this case records may show that an earlier time follows a later time in the log.
When no Output Group (outgrp) is specified, no sorting based on Output Groups and no additional Alarm/UIM breakdown into Output Group categories is done for the report. The log entries will be shown only in the forward or reverse chronological ordering of the logs.
When a unique Output Group is specified, the report is separated into Alarm and UIM categories, and the entries for the specified Output Group are shown in each category.
When outgrp=all is specified, the report is separated into Alarm and UIM categories, and the available entries in each category are listed by Output Group.
The next parameter is used to display a specified number of additional log records after the previous rtrv-log entry at the terminal. New records that are logged after the previous rtrv-log command was entered will not be displayed when the rtrv-log:next= command is entered. The next parameter is valid only under the following conditions:
- The
rtrv-log:next=command is entered at the same terminal from which the previousrtrv-logcommand was entered. The previousrtrv-logcommand must not include the type=all parameter. - No other terminal has issued a
rtrv-logcommand after thertrv-logcommand entered at the terminal form which thertrv-log:next=command is entered. - The next parameter is the only parameter specified in the
rtrv-logcommand. - There are still logs present that match the conditions (except time/date/num) specified in the previous
rtrv-logcommand.
When either a single snum or range of snum/enum is specified, only those Alarms or UIMs within the specified range are displayed.
When snum is specified and enum is not specified, the enum value defaults to the specified snum value.
When enum is specified, an snum value must be specified that is less than or equal to the specified enum value.
If an snum is specified within the range 1-999, its corresponding enum must be greater than or equal to the snum and also within the range of 1-999.
If an snum is specified within the range 1000-1999, its corresponding enum must be greater than or equal to the snum and also within the range of 1000-1999.
When enum is not specified and the specified snum Alarm or UIM does not exist (is not currently used in the system), a scroll area message indicates that the snum value is out of range.
If snum and enum are specified and one or both specified Alarms and/or UIMs do not exist (are not currently used in the system), the report lists all existing Alarms and/or UIMs that exist within the specified range.
The Alarm log only stores minimal information about each alarm. Only a few alarms support multiple-line formats that would be displayed when mode=full is used. The majority of alarms display the same information when either mode=full or mode=brief is used.
Output
In this example, the sequence numbers that are replaced by the dashes (- - - -) represent the UIMs that were discarded due to the UIM thresholding feature:
rtrv-log:type=uim:sdate=960715:stime=220000:num=50
rlghncxa03w 04-02-16 10:15:29 EST EAGLE 31.3.0
Card 1113; SYS REL= Rel 31.3.0; STP CLLI= ncralstp0001; Timezone= EST
**** Logged 99-07-16 01:03:09****
0001.1005 CARD 1105,B INFO GWS rcvd OPC that is not allowed
SIO=01 OPC=001-001-001 DPC=002-002-002
H0H1=000 AFTPC=003-003-003
TEST MODE
SR=scrb LSN=A1234567
Report Date: 99-07-16 Time: 01:00:01
**** Logged 99-07-16 01:03:34****
----.1004 CARD 1205,B INFO MTP rcvd unknown DPC
SIO=07 OPC=001-001-001 DPC=002-002-002
LSN=A1234567
Report Date: 99-07-16 Time: 01:01:00
**** Logged 99-07-16 01:03:55****
0014.1019 CARD 1103 INFO SCCP rcvd invalid UDTS msg
SIO=03 OPC=001-001-001 DPC=002-002-002
CDPA: SSN=005 TT=250
CGPA: SSN=000 TT=000
RETURN CAUSE=001
DATA=26 80 03 09 0e 06 09 00 fe 08 50 55
43 00
LSN=A1234567
Report Date: 99-07-16 Time: 01:00:05
;
This example shows the records in the log created after 15 July 2003 at 10 PM up to a maximum of 50 records:
rtrv-log:sdate=030715:stime=220000:num=50
ncralstp00001 10-03-16 10:15:29 EST EAGLE 42.0.0
Card 1113; SYS REL= 31.3.0; STP CLLI= ncralstp00001; Timezone= EST
****03-07-15 22:03:09****
3159.0013 ** CARD 1207 CCS7ITU Card is isolated from the system
****03-07-15 22:03:11****
3160.0046 TERMINAL 10 Terminal enabled
****03-07-16 00:23:55****
3161.0200 SLK 1103,B RCVRY-LKF: link available
****03-07-16 01:43:51****
3163.0317 LSET A123456789 RCVRY-LKSTO: linkset allowed
****03-07-16 02:35:16****
3164.0082 * FUSE PANEL 11xx Alarm in fuse panel
****03-07-16 03:00:23****
3165.0108 ** IMT BUS A Major IMT fault detected
****03-07-16 03:37:59****
3166.0292 *C GLS SYSTEM GLS is not available
****03-07-16 07:22:06****
3167.0313 *C DPC 021-005-000 DPC is prohibited
****03-07-16 09:33:17****
3168.0348 * SEAS SYSTEM SEAS is at minimum service
****03-07-16 09:34:01****
3169.0112 * IMT SYSTEM Major Failures detected on both
****03-07-16 09:35:07****
3170.0160 * CLOCK SYSTEM 1116-S clock failed
****03-07-16 09:36:34****
3171.0160 * CARD 1116 OAM 1116-S clock failed
****03-07-16 09:37:23****
3172.0065 * CLOCK Minor holdover clock trouble detected
****03-07-16 09:38:12****
3173.0308 *C SYSTEM Node isolated due to SLK failure
****03-07-16 09:39:56****
3174.0331 *C SCCP SYSTEM SCCP is not available
****03-07-16 09:40:15****
3175.0002 * GPL SYSTEM OAM Card is not running approved GP
****03-07-16 09:42:45****
3177.0060 * CDT 9 Minor customer trouble detected
****03-07-16 09:45:29****
3180.0321 * XLIST X-LIST occupancy threshold Exceeded
****03-07-16 09:48:48****
3181.0175 * SECURITY 1114 LOGBUFROVL-SECULOG – upload required
****03-07-16 10:23:47****
0259.0084 ** DSM 1101,B IP Connection Unavailable
Failed Channels: Prov Dnld TCP UDP
****03-07-16 10:25:41****
0069.0084 ** STC 1105,B IP Connection Unavailable
ERROR STATUS: DHCP Lease. Physical Link.
;
UAM Report terminated - end of log reached.
END OF ALARM LOG REPORT.
;
This example shows the records in the log created after 15 July 2003 at 10 PM for Alarm (UAM) 160:
rtrv-log:sdate=030715:stime=220000:num=50:snum=160
ncralstp00001 03-07-16 10:15:29 EST EAGLE 31.3.0
Card 1113; SYS REL= 31.3.0; STP CLLI= ncralstp00001; Timezone= EST
****03-07-16 09:35:07****
3170.0160 * CLOCK SYSTEM 1116-S clock failed
****03-07-16 09:36:34****
3171.0160 * CARD 1116 OAM 1116-S clock failed
;
UAM Report terminated - end of log reached.
END OF LOG REPORT.
;
This example shows the records in the log created after 15 July 2003 at 10 PM that include Alarms (UAMs) 106 - 350:
rtrv-log:sdate=030715:stime=220000:num=50:snum=106:enum=350
ncralstp00001 10-03-16 10:15:29 EST EAGLE 42.0.0
Card 1113; SYS REL= 31.3.0; STP CLLI= ncralstp00001; Timezone= EST
****03-07-16 00:23:55****
3161.0200 SLK 1103,B RCVRY-LKF: link available
****03-07-16 01:43:51****
3163.0317 LSET A123456789 RCVRY-LKSTO: linkset allowed
****03-07-16 03:00:23****
3165.0108 ** IMT BUS A Major IMT fault detected
****03-07-16 03:37:59****
3166.0292 *C GLS SYSTEM GLS is not available
****03-07-16 07:22:06****
3167.0313 *C DPC 021-005-000 DPC is prohibited
****03-07-16 09:33:17****
3168.0348 * SEAS SYSTEM SEAS is at minimum service
****03-07-16 09:34:01****
3169.0112 * IMT SYSTEM Major Failures detected on both
****03-07-16 09:35:07****
3170.0160 * CLOCK SYSTEM 1116-S clock failed
****03-07-16 09:36:34****
3171.0160 * CARD 1116 OAM 1116-S clock failed
****03-07-16 09:38:12****
3173.0308 *C SYSTEM Node isolated due to SLK failure
****03-07-16 09:39:56****
3174.0331 *C SCCP SYSTEM SCCP is not available
****03-07-16 09:45:29****
3180.0321 * XLIST X-LIST occupancy threshold Exceeded
****03-07-16 09:48:48****
3181.0175 * SECURITY 1114 LOGBUFROVL-SECULOG - upload required
;
UAM Report terminated - end of log reached.
END OF LOG REPORT.
;
This example shows the records in the log in the backward direction that were created between 12 June 2003 at 4:48:27 PM and 11 June 2003 at 10:00:45 PM for Alarms (UAMs):
rtrv-log:dir=bkwd:stime=044827:sdate=030612:etime=100045:edate=030611
tekelecstp 03-06-23 04:10:12 EST EAGLE 31.3.0
Card 1115; SYS REL= 31.3.0. STP CLLI= tekelecstp; Timezone= EST
Report Initiated - extended processing time required
****03-06-12 04:48:27****
5001.0009 CARD 1115 EOAM MASP became active
****03-06-11 13:38:55****
5003.0002 * GPL SYSTEM BPHMUX Card is not running approved GPL
****03-06-11 13:38:55****
5002.0002 * GPL SYSTEM BPDCM Card is not running approved GPL
****03-06-11 13:36:04****
5001.0009 CARD 1115 EOAM MASP became active
****03-06-11 12:15:29****
5001.0009 CARD 1115 EOAM MASP became active
****03-06-11 11:19:51****
5001.0009 CARD 1115 EOAM MASP became active
****03-06-11 10:00:46****
5019.0109 IMT SYSTEM All IMT System level alarms cleared
****03-06-11 10:00:45****
5018.0106 IMT BUS B IMT Bus alarm cleared
****03-06-11 10:00:45****
5017.0106 IMT BUS A IMT Bus alarm cleared
****03-06-11 10:00:45****
5016.0014 CARD 1107 SS7ANSI Card is present
ASSY SN: 10200301518
****03-06-11 10:00:45****
5015.0111 ** IMT SYSTEM Failure on both IMT A and IMT B
UAM Report terminated - 11 records displayed
END OF LOG REPORT.
;
This example shows all the records in the log in the backward direction (UAMs and UIMs):
rtrv-log:type=all
tekelecstp 06-01-06 09:16:20 EST EAGLE 35.0.0
Card 1113; SYS REL= 35.0.0; STP CLLI= tekelecstp; Timezone= ****
****06-01-06 09:06:49****
0002.0009 CARD 1113 EOAM MASP became active
****06-01-06 09:11:16****
0004.0143 * CARD 1113 EOAM System release GPL(s) not approved
****06-01-06 09:13:54****
0005.0048 * TERMINAL 4 Terminal failed
****06-01-06 09:13:59****
0006.0046 TERMINAL 2 Terminal enabled
UAM Report terminated - end of log reached
;
tekelecstp 06-01-06 09:16:22 **** EST EAGLE 35.0.0
Card 1113; SYS REL= 35.0.0; STP CLLI= tekelecstp; Timezone= ****
****Logged 06-01-06 09:10:43****
0003.1083 SYSTEM INFO REPT COND: system alive
Report Date:06-01-06 Time:09:10:43
****Logged 06-01-06 09:15:43****
0007.1083 SYSTEM INFO REPT COND: system alive
Report Date:06-01-06 Time:09:15:43
UIM Report terminated - end of log reached
END OF LOG REPORT.
;
This example shows the log records in the backward direction that include Alarms (UAMs) 937 and 938 for the RTD System:
rtrv-log:dir=bkwd:num=10
stdcfg1b 13-06-23 00:05:42 WET EAGLE 35.6.0
Card 1113; SYS REL= 35.6.0; STP CLLI= stdcfg1b; Timezone= WET
****13-06-23 00:03:42****
0936.0542 RTD SYSTEM MSU cksum error threshold cleared
****13-06-22 23:15:12****
0915.0541 *C RTD SYSTEM MSU cksum error threshold exceeded
****13-06-21 21:50:24****
0144.0542 RTD SYSTEM MSU cksum error threshold cleared
****13-06-21 21:48:47****
0142.0541 *C RTD SYSTEM MSU cksum error threshold exceeded
****13-06-21 21:32:03****
0138.0096 CARD 1101 SS7ML Card has been reloaded
****13-06-21 21:31:40****
0137.0002 * GPL SYSTEM SS7ML Card is not running approved GPL
****13-06-21 21:31:28****
0136.0109 IMT SYSTEM All IMT System level alarms cleared
Outstanding IMT BUS A failure for card 1111, 1113
****13-06-21 21:31:28****
0135.0106 IMT BUS B IMT Bus alarm cleared
UAM Report terminated - max. or num= count reached
END OF LOG REPORT.
;