ERROR lOG LISTING PROCESSOR
ELLA COMMANDS
ELLA accepts three types of commands: boundary commands, task commands, and the device assignment command (SET, described previously). Boundary commands establish or change the limits that are to be applied to all subsequent task commans; i. e., boundary commands allow the user to specify the types of errors in which he is interested. Task commands initiate the execution of a particular type of list-ing. The device assignment command is used to change the I isting and message output device during execution of ELLA.
TASK COMMANDS
Task commands are used to request the ELLA displays and to terminate ELLA. ELLA task commands are:
CLIS produces a chronological listing of qualified error log entries.
64 Error Log Listing Processor
diagnostic messages. (Using the operator's con-sole for lengthy output is not recommended.)
SLIS produces a sorted listing of qualified error Jog entries.
SUM produces a categorized summary of qualified error log entries.
DISP produces a summary of qualified error log en-tries in graphic form.
END terminates ELLA.
Note that error log entries are displayed only if they qualify.
To qualify for inclusion in a display, an error log entry must pass ~ boundary tests in force at the time the display is generated. If no boundary commands have been entered, all error log entries qualify. Those error log entries which fai I to pass one or more of the boundary tests are ignored.
(Boundary commands are described following the task commands. )
ells
The CLIS command requests a chronological list-ing of the error entries in the order in which they appear in the error fi Ie.The format of the CLIS command is
C[US]
An example ofa CLIS listing is given in Example 3. Table 32 I ists the error log entry headings printed by ELLA and notes the manner in which all values are printed.
Example 3. Use of the CLlS Command
In this example, the user chose to initiate ELLA on-line. The user did not desire a lengthy listing at his terminal.
Therefore he reas~igned the listing function to the line printer using the SET command.
!ELLA@
;SET , LIST, LP
€V
~CLIS@
::'END@
lPRINT@
After the CLIS command was issued, ELLA produced the chronological listing and then prompted for another command.
The user desired no further listings, so he terminated ELLA with the END command. He then issued the system PRINT command which caused the listing to be output to the printer. The output that was sent to the line printer is shown below:
*CLIS
C H RON 0 LOG I CAL L I S TIN G
FROM 00/00/00 00:00:00:000
TO 12/31/99 23:59:59:999
*** SYSTEH IDENTIFICATION ***
CORE
TIME (K) SITE 1.0.
11:36:00:000 00128 PRT101
*** CONFIGURATION ***
I/O ADRS
Tum
~·IDL PRIr·1 ALTN11:36:00:000 7012 0001 0001 7140 0003 0003 7160 0004 0004 7445 0002 0002 7212 01FO 01FO 11:36:00:000 7322 0080 0080 7322 0081 0031 7271 OOEO ODED 7271 00E1 00E1 7271 00E2 00E2 11:36:00:000 7271 00E3 00E3 7611 0010 0010
SYSTE~1
CP-V COO
OCT INDEX
01 02 03 04 05 06 07 08 09 OA DB OC
-OPTIons--CPU SYHB RT RB
S67 Y N N
*** TIME STAMP *** DATE=07/10/74 TIr·ffi=12:f)0:00:f)04
*** SIO FAILURE ***
I/O ---SIO- ---TDV- SUBC TDV CUR
TDm ~1DL ADRS STAT CC STAT CC STAT co~·m DA
12:36:30:782 7323 0083 2000 6 1000 6 00 0011B7
12:37:29:518 7323 0083 2000 6 1000 6 00 001137
12:40:10:398 7323 0083 2000 6 1000 6 00 0011B7
TIHE RES
02
REM BYTES 0001 0001 O(),)1
~WI
0') 00 00
Error Log Listing Processor 65
*** TIHE STAHP ***
*** TIrill STAHP ***
DATE=07j10j74 DATE=07j10j74
TIME=13:00:00:00S TIr1E=14:0'1:00:f)()3
***Syt,mIONT INCONSISTENCY***
TIr·m
14:03:13:648
OCT INDEX 09
*** TIr-m STAHP ***
*** TIHE STM>tP ***
R,;.":L.
SECT.
0110
SYMB.
OCT
02
DATE=07j10j74 DATE=07j10j74
TIHE=1S:00:()():004 TIHJ:=16:00:00:006
Note that the CLIS command is listed in the line printer listing and that the existing time boundaries are printed after the title. If other boundaries were in force, they too would have appeared. Certain values, such as core size and recovery count, are printed in decimal for convenience. Other fields, such as the OPTIONS field, contain flags.
The true condition is represented by the letter Y, the false condition by the letter N. In this example, the system has symbiont capability but does not have remote processing and real-time facilities.
Table 32. Error log Entry Headings
Heading Description
ACCOUNT The account (eeeeeeee) in which the faulty fi Ie resides.
eeeeeeee
---AIO- A hexadecimal number (xxxx) representing the Ala device and
STAT CC operational status bytes (STAT) and a hexadecimal value (x)
xxxx x representing the condition code (CC) returned as the resu It of the Ala instruction.
CL A hexadecimal value (xx) representing the cluster protion of the
xx unit address.
CONTRLR A flag (f) indicating whether or not the controller is partitioned in
f addition to the device. Y means the controller is partitioned; N
means it is not partitioned.
CORE Core size in decimal thousands (dddd).
(K) dddd
COUNT The number of entries (in decimal) that duplicate the previous entry.
dddd
CPU CPU type (ddd).
ddd
----CUR COMM DW-- Two hexadecimal numbers (xxxxxxxx) representing the command
1 2 doubleword currently being processed for a device.
xxxxxxxx xxxxxxxx
DATE The month (mm), day (dd), and year (yy) that the error log entry
mm/dd/yy occurred.
DCT A hexadecimal value (xx) indicating the order in which the device is
INDEX configured into the system at SYSGEN. The index value for the first
xx device is 1.
66 Error Log Listing Processor
Table 32. Error Log Entry Headings (cont.)
Heading Description
ENTRIES A decimal value (dddd) representing the number of error log records
LOST lost when logging became temporarily impossible for any reason.
dddd
ENTRY A decimal value (dddd) representing the number of entries in the
COUNT enqueue table belonging to the specified user at the time the error
dddd log entry was made.
ERROR A hexadecimal value (xxxx) giving the error type code for the fai lure.
CODE See Appendix S, "Monitor Error Messages" in the Cp-V/SP Reference
xxxx Manual, 90 1764, for error code definitions.
ERRLOG--- A hexadecimal value (xxxxxxxx) representing the caller's address to CALL ADRS which the error logging routine will return when logging is completed.
xxxxxxxx This is used in isolating software faults.
FILE NAME The name of the file in which a fault has been detected.
---RIO- A hexadecimal value (xxxx) representing the status (STAT) and a
STAT CC hexadecimal value (x) representing the condition codes (CC)
re-xxxx x turned in response to an HIO instruction.
--INDEX-- The hexadecimal offset (xxxxxxxx) into a 64-word block in ERRFILE
BAD ENTRY that locates the first word of the incorrect entry.
xxxxxxxx
I/O A hexadecimal value (xxxx) representing the physical I/o address.
ADRS xxxx
I/O A decimal value (dddddddddd) representing the number of SIO
COUNT instruction executed for a device. This value is reset at system
dddddddddd boot time.
I/O ADRS A hexadecimal value (xxxx) representing the primary I/O address
PRIM ALTN (PRIM) by which a device can be referenced, and another
hexa-xxxx xxxx decimal value (xxxx) representing the alternate address (ALTN) for dual access devices.
--I/O-- A hexadecimal value (xxxx) representing the status (STAT) and a
STAT CC hexadecimal value (x) representing the condition codes (CC)
re-xxxx x turned in response to an I/O instruction.
LOCATIONS One to fourteen hexadecimal values indicating the addresses of the xxxxxxxx first fourteen (or less) memory locations exhibiting parity errors.
xxxxxxxx
--MEMORY STATUS-- Two hexadecimal values (xxxxxxxx) representing the status returned
1 2 in response to an LMS instruction.
xxxxxxxx xxxxxxxx
---MEMORY STATUS WORDS---- Three hexadecimal values (xxxxxxxx) representing status returned in
1 2 3 response to an LMS instruction.
xxxxxxxx xxxxxxxx xxxxxxxx
MDL A decimal number (dddd) that uniquely identifies peripheral devices
dddd by the Xerox model number (defined at SYSGEN).
Error Log listing Processor 67
Table 32. Error Log Entry Headings (cont.)
Heading Description
MFI A hexadecimal value (xx) representing the current state of the
xx memory fault indicators returned by the hardware in response to an
RD instruction. All memory fault indicators wi II be reset. (Sigma 6 and 7 only.)
MODE A decimal value (d) encoding the mode in which the file was opened
d where: 1 - IN; 2 - OUT; 4 - INOUT; 8 - OUTIN.
--OPTIONS-- Indicates whether or not the following facilities are available in the SYMB RT RB system: symbiont routines (SYMB), real-time processing (RT), and
f f f remote processing (RB). The flag (f) is equal to Y (present) or N (absent ).
ORG A single decimal digit that indicates the file organization where:
d 1 - consecutive; 2 - keyed; 3 - random.
PAR A hexadecimal value (xxxx) representing the number of memory
ERRS locations exhibiting parity errors after a memory scan.
xxxx
--POLL- A hexadecimal value (xxxx) representing the processor fault status
STAT CC (STAT) and a hexadecimal value (x) representing the condition
xxxx x codes
(ee)
returned by the hardware in response to a POLP orPOLR instruction.
POLR A hexadecimal value (xxxx) representing the processor fault status
RESULTS as returned by the hardware in response to a POLR instruction.
xxxx
---PSDW--- Two hexadecimal numbers (xxxxxxxx) representing the contents of
1 2 the program status doubleword.
xxxxxxxx xxxxxxxx
REAL A hexadecimal value (xxxxxxxx) representing the actual memory
ADRS address. In an unmapped system, this is the same as the IA field
xxxxxxxx of the PSD.
RECOV Not currently available. Output wi II appear as zero (00).
COUNT xx
REL. A hexadecimal value (xxxx) representing the relative sector at
SECT. which the inconsistancy was detected.
xxxx
RELATIVE- A hexadecimal value (xxxx) representing the relative sector number
SECT.ADRS at which the inconsistancy was detected. A relative sector is 256
xxxx words long with each sector on a given device being numbered from
zero through device end.
ep-v
maintains file pointers by relative sector number to expedite addressing different devices.REM A hexadecimal value (xxxx) representing the remaining byte count
BYTES as returned in response to a TDV instruction.
xxx x
68 Error Log Listing Processor
Table 32. Error Log Entry Headings (cont.)
Heading Descri ption
-RETRY- A two digit decimal number (dd) representing the maximum number of
REQ REM retries (REQ) after which a device error is returned to requester (value
dd dd obtained from requester's DCB), and another two-digit value (dd)
representing retry request minus the number of entries attempted (REM).
The range is between retry request and O. A 0 value indicates the operation was terminated due to retry count rundown.
SCREECH Not currently available. Output wi II appear as zero (OO).
CODE xx
SEEK ADRS A hexadecimal value (xxxxxxxx) representing the physical disk
xxxxxxxx address last used to access this device.
---SENSE INFORMATION--- A hexadecimal value (xxxxxxxx) representing the diagnostic infor-xxxxxxxx infor-xxxxxxxx infor-xxxxxxxxinfor-xxxxxxxx mation returned from the device as a result of sending a "sense" order
to the device. The value has a 4-word maximum, depending on the device.
-~-SIO- A hexadecimal value (xxxx) representing the status (STAT) returned STAT CC in response to an SIO instruction, and another hexadecimal value
xxxx x (x) representing the condition codes (CC) returned.
SITE I.D. An EBCDIC value (eeeeeeee) identifying the site (specified at
eeeeeeee SYSGEN).
START A hexadecimal value (xx) indicating the degree of initialization
TYPE (always equals three for system device boot).
xx
SUB Not currently available. Output wi II appear as zero (00).
CODE xx
SUBC A hexadecimal value (xx) representing the status (STAT) of the
va
STAT subchannel received as a result of a TDV instruction.
xx
SUBTYPE A hexadecimal value (xx) indicating the type of copy error that
xx occurred. Type 01 indicates read error; i. e., the ghost ERR:FIL
re-ceived an error indication when reading the original error fi Ie.
Type 02 indicates read error end, meaning that subsequent error log entries were correctly read from the original error file. Type 03 indi-cates a length error; i.e., the original error file record length was incorrect • Type 05 indicates incorrect time; i. e., the time of the following entry is either out of range or goes backward. Type 06 indicates illegal entry type; i.e., the type code of the following entry was found to bei lIegal by the ghost ERR:FIL.
SYMB. A hexadecimal value (xx) representing the order in which the
sym-DCT biont device is configured into the system; i.e., the DCT index of
xx the symbiont device.
SYSTEM Displays the operating system name (CP-V) and three EBCDIC char,;,.
CP-V eee acters (eee) representing the system version specified at SYSGE N.
TDV CUR A hexadecimal value (xxxxxx) representing the current command
COMM DA doubleword address returned in response to a TDV instruction.
xxxxxx
Error Log Listing Processor 69
Table 32. Error Log Entry Headings (cont. )
He"ading Description
---TDV- A hexadecimal value (xxxx) representing the status (STAT), and a
STAT CC hexadecimal value (x) representing the condition codes (CC) returned
xxxx xx in response to a TDV instruction.
TIME The time the error occurred, in hours (hh), minutes (mm), seconds (ss),
hh:rmn:ss:nnn and mill i seconds (nnn).
TIME LAST The time in hours, minutes, seconds, and milliseconds at which the
DUPLICATE last dupl icate of the preceding entry occurred.
hh :nnn:ss :nnn
TIME LAST The time of occurrance when the last entry was lost in hours,
min-LOST ENTRY utes, seconds and milliseconds.
hh :nnn:ss :nnn
TIME A decimal value (dd) in milliseconds representing the resolution of
RES the time field of all error log entries; e.g., if the time resolution is dd 2, then the time value for all error log entries is accurate to two
mi II iseconds.
---TIO- A hexadecimal value (xxxx) representing the status (STAT) and a
STAT CC hexadecimal value (x) representing the condition codes (CC) returned
xxxx x in response to a TIO instruction.
--TRAPPED-- A hexadecimal value (xxxxxxxx) representing the contents of the
INSTRUCT CC location pointed to by the trapped instruction's address (INSTRUCT) xxxxxxxx x in the PSD, and another hexadecimal value (x) representing the trap
condition codes (CC).
---TRAPPED--- A hexadecimal value (xxxxxxxx) representing the contents of the INSTRUCT CC EFF.ADRS location pointed to by the trapped instruction IS address (INSTRUCT) xxxxxxxx x xxxxxxxx in the PSD; a hexadecimal value (x) representing the trap condition codes (CC); and another hexadecimal value (xxxxxxxx) representing the final address (EFF.ADRS) computed for the trapped instruction.
UN A hexadecimal value (xx) representing the unit portion of the Xerox
xx 560 unit address.
UNIT A two-to-four EBCDIC character mnemonic name identifying one of
NAME the following: CPU; MI (Memory Interface); PI (Processor Interface);
eeee MIOP (Multiplexed Input Output Processor); RMP (Rotating Memory
Processor); CT (Communication Terminator); SU (System Unit).
USER A hexadecimal value (xxxx) which is a unique number assigned by
I.D. the system to the particular job or session.
xxxx
USER A hexadecimal value (xx) representing the index into internal system
NO. tables used to access user-specific information.
xx
VOLUME Not currently available. Output wi II be blank.
SERIAL eeeeee
message An operator message of up to 56 alphabetical characters.
70 Error log listing Processor
SLiS A sorted listing is requested with the SLIS command. The command has the form
SLIS
As in the chronological listing, the sorted listing includes all qualified error log entries. In this listing, however, entries are ordered by their type, and if they are peripheral class errors, by their model number and I/O address also.
Error records are first categorized by ELLA as system, pe-ripheralor secondary records, (see Table 33). System records and their associated secondaries are listed first. Except for the system ID record and configuration record (which are printed in front of all other records), system records are listed in ascending type code order as given in Table 33.
Secondary records are printed following their associated primary records.
Peripheral class records are sorted in three phases. They are first separated by model number and printed in ascending model number order. All peripheral records with the same model number are then separated and listed in ascending
device address order. Finally, all the records containing both the same device address and the same model number are printed in ascending type code order. Any secondary rec-ords associated with peripheral class entries are printed following the associated peripheral records.
Any secondary record that appears in the error fi Ie that can-not be linked with a primary record through the above rules association will be printed after all peripheral records and their associated secondaries under the heading
»>U NASSOCIATED SECONDARIES«<
Each time a record is listed that has a different device address than that of the preceding record listed, a model
Number/Address heading is produced under the heading
»>MODEL NO. :xxxx I/O ADDRESSi xxxx
where MODEL NO. is the 4-digit Xerox model number designation of the device and I/O ADDRESS is the 4-digit
(hexadecimal) I/O address of the device.
An example of a sorted listing is given in Example 4.
Table 33. Error Log Entry Types Type
Name Code Description
System Class
COpy ERROR 10 Recorded as a result of several possible error conditions in
the error logging mechanism. If the record subtype is 03, 05, or 06, .the record is followed by the 64-word buffer in which the error occurred.
PARITY ERROR 17 Recorded when program execution is interrupted to
loca-tion XI561 (MFI) on Sigma 6 or 7 or is trapped to location X' 4C' (parity trap) on Sigma 9 or Xerox 560.
SYSTEM STARTUP 18 Recorded when the system is booted and at each recovery.
WATCHDOG TIMER 19 Recorded when program execution traps to location XI461 due to a watchdog timer run-out condition.
FILE INCONSISTENCY 1A Recorded when the operating system cannot access a file
ENTRY in the file management system. The code displayed is
described in the CP-V /BP Reference Manual, 90 17 64.
SOFTWARE DETECTED 1B Recorded when the operating system cannot access a
SYMBIONT INCONSISTE NCY symbiont file in the symbiont file management system.
INSTRUCTION EXCEPTION 1D Recorded when program execution traps to location XI4Q1
on Sigma 9 or Xerox 560 due to an instruction exception condition.
LOST ENTRY INDICATOR 1E Recorded when error log buffering constraints, timing considerations, and error detection rates force error log-ging to be temporarily suspended or otherwise impossible.
Error Log Listing Processor 71
Table 33. Error Log Entry Types (cont.) Type
Name Code Descri ption
System Class (cont.)
POWER ON 20 Recorded when the hardware power monitor forces
program execution to trap to location X' 511 as a result of detecting a restoration of power condition. This normally occurs as a result of a power outage of 500 milliseconds or more in duration.
CONFIGURATION 21 Recorded when ERRFILE is entered.
SYSTEM IDENTIFICATION 22 Recorded when ERRFILE is entered.
TIME STAMP 23 The date and time recorded when ERRFILE is entered in
the system and every hour on the hour.
BAD GRANULE RELEASE 24 Recorded when either a bad disk address has been de-tected or when the granule to be released is already free (dual allocation).
REMOTE PROCESSING 26 Recorded when an error is detected in the transmission of
ERROR RECORD data to or from a remote processing workstation.
OPERATOR MESSAGE 27 A message entered by the operator through use of the ERSEND key-in.
PROCESSOR FAULT INTERRUPT 30 Recorded when there is a processor fault interrupt (location X'561) on the Xerox 560.
MEMORY FAULT INTERRUPT 31 Recorded when there is a memory fault interrupt (loca-tion X'571) on Sigma 9 or Xerox 560.
PROCESSOR CONFIGURATION 41 Recorded when the system is booted.
ENQUEUE TABLE OVERFLOW 50 Recorded to log specific information after the operating system has detected an enqueue table overflow condition.
UNKNOWN TYPE = xx xx An unknown type code xx has been encountered in an
error log entry.
Peripheral Class
SIO FAILURE 11 Recorded when the condition codes returned by the SIO
instruction are such that either CCl or CC2 are true.
DEVICE TIMEOUT 12 Recorded when the time-out value specified by DCTl1
has been exceeded.
UNEXP. INTERRUPT 13 Recorded when no match can be found between the I/O
address return in the status register by the AIO instruction and any DCTl I/O address of a device known to be busy.
AIO CC= 11 xx will not be logged.
DEVICE ERROR 15 Recorded when an I/O request is not successful upon one
of the specified number of retries. (It mayor may not have eventually been successful.) Only the status of the last erroneous retry for a given request is logged; not all of the retries.
72 Error Log Listing Processor
Table 33. Error Log Entry Types (cont.) Type
Name Code Description
Peripheral Class (cont. )
PARTITIONED RESOURCE 51 Recorded when a resource has been partitioned from the system.
RETURNED RESOURCE 52 Recorded when a previously partitioned resource has been returned to the system.
Secondary Data Class
DEVICE ERROR 16 Recorded when nonzero sense data is avai lable following
SECONDARY a device error.
DUPLICATE ENTRIES 1F Recorded when the error logging mechanism detects
identical consecutive errors. This prevents the error log from becoming saturated with redundant information.
SECONDARY POLL 32 Recorded for each nonzero poll status received by the
RECORD processor polling routines.
..
MEMORY PARITY 42 Recorded for each memory un i t that has recorded an error as
SECONDARY determined by the memory polling routines (i.e., bits
22-31 of status word zero are nonzero) for Xerox 560.
MEMORY PARITY 43 Recorded for each memory un it that has recorded an error as
SECONDARY determined by the memory poll ing routines (i.
e.,
bits22-. 31 of status word zero are nonzero) for Sigma 922-.
22-. 31 of status word zero are nonzero) for Sigma 922-.