The RSX error logging system consists of four tasks: ELI, ERRLOG, RPT, and CFL. Since these tasks require MCR syntax, use the DCL MCR command to execute them from DCL. All command descriptions in these help files refer to MCR syntax. The Error Log Interface task (ELI) controls the operation of the error logging task (ERRLOG). ELI turns error logging on and off, changes error limits, and names error log files and backup files. ERRLOG also provides a warning whenever one of the error limits is reached. The Report Generator task (RPT) produces error log reports based on infor- mation in control file modules. The Control File Language compiler (CFL) compiles the Error Log control file modules used by RPT. Type HELP ERRLOG ELI for more information about ELI commands. Type HELP ERRLOG WARNINGS for more information about error limits. Type HELP ERRLOG CFL for information about the CFL commands. Type HELP ERRLOG RPT for more information about the RPT commands. 2 CFL The CFL compiler compiles Error Log control file modules. CFL is used mainly to patch control file modules. Since CFL does not produce object code, CFL binary output cannot be patched with ZAP or PAT. Patches must be made by applying SLP corrections to the source file and recompiling the module. The command line syntax for CFL is: [binary_file][,list_file]=[symbol_file,]input_file The file type defaults are: Binary ICF List LST Symbol Input CNF 2 ELI The Error Log Interface task (ELI) controls the Error Logging task (ERRLOG). ELI provides switches to perform the following functions: Turns on logging: ELI>[log_file]/LOG[/LIM][/NV] Turns off logging: ELI>/-LOG Turns on limiting: ELI>/LIM Turns off limiting: ELI>/-LIM Names a Backup file: ELI>[backup_file]/BA Appends a log file: ELI>[filespec]/AP[/DE] Switches to new file: ELI>[log_file]/SW[/DE][/NV] Sets error limits: ELI>DDn:[,DDn:,...]/HL:nn./SL:nn. Resets QIO and error counts ELI>DDn:[,DDn:,...]/RE Shows information: ELI>DDn:[,DDn:,...]/SH Type HELP ERRLOG ELI for information on a particular switch. 3 /APPEND The ELI /AP switch appends a previous log file to the current log file. Logging must be active for the /AP switch to work. Syntax: filespec/AP[/DE] Default: /-DE Does not delete the appended log file. 3 /BACKUP The ELI /BA switch declares a backup file to be used if the primary error log file becomes unuseable. Syntax: [backup_file]/BA Defaults: LB:[1,6]BACKUP.ERR Creates a new version of the file 3 /HL #/SL 3 /LIMIT The ELI /LIM switch turns error limiting on or off. Syntax: /LIM /-LIM Defaults: None 3 /LOG The ELI /LOG switch turns error logging on or off. Syntax: [log_file]/LOG[/LIM][/NV] Defaults: log_file LB:[1,6]LOG.ERR [/LIM] Enables limiting /-NV Append log file to current log file Syntax: /-LOG Default: /-LIM Disables limiting also. 3 /RESET The ELI /RE switch resets the error and QIO counts on devices. Up to 14 devices may be specified. Syntax: DDnn:[,DDnn:,...]/RE Default: None 3 /SHOW The ELI /SH switch displays error and QIO counts for up to 14 specified devices on the system. If no devices are specified, all error logging devices are shown. The /SH switch also displays information about the current operating status of the error logging system. Syntax: [DDnn:,...]/SH Default: DDnn: If no devices are specified, information about all error logging devices is displayed. 3 /SL The ELI /HL and /SL switches set the Hard and Soft error limits. If limiting is turned on and either of these limits is reached logging for that device stops. Either switch may be used individually or in combination. Up to 14 devices may be specified in one command line. Syntax: DDnn:[,DDnn:,...]/HL:nn. Sets only hard limit DDnn:[,DDnn:,...]/SL:nn. Sets only soft limit DDnn:[,DDnn:,...]/HL:nn./SL:nn. Sets both limits Defaults (set by system generation): Device type Hard limit Soft limit Disks 5. 8. Tapes 5. 8. 3 /SWITCH The ELI /SW switch transfers logging from the current error log file to another file. Syntax: logfile/SW[/DE][/NV] Defaults: log_file No default /-DE Preserves previous log file /-NV Appends current log file to specified log file 2 RPT The general command line syntax for RPT is: [report_file[/switches]]=[input_file[/switches]] Switches are options that can be used on either side of the command line. Defaults: report_file input_file Device: LB0: LB0: UIC: current UIC [1,6] file_name: ERRREPORT LOG file_type: .LST .ERR version: new version ;0 The equals sign (=) is not optional. Therefore, to get a default report, including switches, use the following command line: RPT>= Type HELP ERRLOG RPT SWITCHES for information on RPT switches. 3 /DATE /DA:argument[:argument][:argument] The RPT /DA switch allows you to select packets based on the time of their occurrence. Syntax: /DA:RANGE:start_date:end_date select packets in this date range /DA:TODAY select packets occuring TODAY /DA:YESTERDAY select packets occuring YESTERDAY /DA:PREVIOUS:n select packets occuring on the PREVIOUS n days Start_date and end_date are both date strings. A date string has the form: String Type Meaning DD-MMM-YY Start Starting at DD-MMM-YY 00:00:00 DD-MMM-YY End Ending at DD-MMM-YY 23:59:59 (DD-MMM-YY HH:MM[:SS]) Start Starting at the specified time (DD-MMM-YY HH:MM[:SS]) End Ending at the specified time * Start Any date up through the end_date * End Any date since the start_date Default: The default is /DA:RANGE:*:* to select packets from all dates. 3 DEFAULTS RPT switches use the following defaults: /DATE:RANGE:*:* /DEVICE:ALL /FORMAT:BRIEF /PACKET_NUMBER:*:* /SUMMARY:NONE /TYPE:ALL /WIDE:WIDE The rest of the RPT switches have no defaults. RPT does not use them unless they are specified in the command line. 3 /DEVICE /DE:argument The RPT /DE switch allows you to select packets for peripheral errors, based on the device or controller name. Syntax: /DE:ALL select errors from all peripherals /DE:d_s select errors from a single peripheral /DE:(d_s,...) select errors from the peripherals specified The device specifier d_s can be: Syntax: DD Devices with the mnemonic DD DDnn: Device DDnn: Default: /DE:ALL 3 /FORMAT /FO:report_format The RPT /FO switch allows you to specify the desired format for the packet-by-packet report. Syntax: /FO:BRIEF Displays packets in BRIEF format /FO:FULL Displays packets in FULL format /FO:REGISTERS Displays only device registers in FULL format on PERIPHERAL errors. Does not display software information. Packets for other errors are displayed in FULL format. /FO:NONE Does not display a packet by packet report. Multiple arguments for the /FO switch are not allowed. Default: /FO:BRIEF 3 SWITCHES The Error Log Report Generator (RPT) switches are: Switch Meaning /DAte DAte qualifier /DEvice DEvice qualifier /FOrmat FOrmat type /KInd packet KInd /PAcket PAcket number /REport predefined REport type /SErial SErial number of drive and/or pack qualifier /SUmmary SUmmary type /TYpe packet TYpe /VOlume VOlume label qualifier /WIdth WIdth of output Type HELP ERRLOG RPT for more information on a particular switch. Type HELP ERRLOG RPT DEFAULTS for information on the default switches. 3 /PACKET /PA:packet_number[:packet_number] or /PA:(selection1,selection2,...) The RPT /PA switch allows you to select a packet or range of packets by specifying the packet identification number. BBB.RR is the format for packet_number, where BBB is the block number and RR is the record number. Syntax: /PA:packet_number Selects this packet /PA:start_number:end_number Selects this range of packets /PA:(packet_specifier,...) Selects multiple packet_specifiers String Type Meaning xxx.yy Start Starting with packet number xxx.yy zzz.aa End Ending with packet number zzz.aa * Start Any packet number through the end_number. * End Any packet number since the start-number. Default: /PA:*:* Selects all packets 3 /REPORT /RE:string_name or /RE:(string_name1,string_name2,...) The RPT /RE switch accesses predefined switch strings. Syntax: /RE:argument Replaces /RE:argument with a predefined switch string In this command, 'argument' is interpreted as either the name of a DIGITAL predefined switch string or as a userdefined switch string, located in LB:[1,6]ERRDEFINE.CFS. DIGITAL supplies 4 predefined switch strings to use with the /RE switch. Their 'arguments' are SYSTEM, WEEK, MONTH, and DAY. The strings, using defaults for unspecified switches, are: SYSTEM /FO:BR/KI:NO/TY:A/DA:RA:*:*/PA:*:*/WI:WI WEEK /FO:BR/KI:NO/TY:A/DA:PREVIOUS:7/WI:WI MONTH /FO:BR/KI:NO/TY:A/DA:PREVIOUS:31/WI:WI DAY /FO:FULL/KI:NO/TY:A/DA:TODAY/WI:WI Default: None 3 /SERIAL /SE:argument:argument The RPT /SE switch selects packets based on their drive and/or pack serial number. Syntax: /SE:DRIVE:serial_number Selects errors from peripherals that have the specified drive serial number /SE:PACK:serial_number Selects errors from peripherals that have the specified pack serial number /SE:(DRIVE:s_n,PACK:s_n)Selects errors from peripherals that have the specified pack and drive serial number The serial_number is a string of hex digits. Default: None 3 /SUMMARY /SU:summary_type or /SU:(summary_type1,summary_type2,...) The RPT /SU switch allows you to select the type of summary or summaries. Syntax: /SU:HISTORY Generates an historical summary /SU:ERROR Generates an error summary /SU:GEOMETRY Generates a geometrical summary /SU:ALL Generates all three summaries /SU:NONE Does not generate any summary /SU:(xxx,...) Generates more than one summary. xxx is HISTORY, ERROR, or GEOMETRY. Note that you may not use the multiple summary syntax to specify more than one keyword if one of the keywords is ALL or NONE. That is, /SU:(ALL) is legal but /SU:(ALL,ERROR) is not. Default: /SU:NONE. 3 /TYPE /TY:argument or /TY:(argument1,argument2,...) The RPT /TY switch selects packets by specifying a type or types of packets. Syntax: /TY:PERIPHERAL Selects PERIPHERAL errors /TY:PROCESSOR Selects PROCESSOR errors /TY:MEMORY Selects MEMORY errors /TY:CONTROL Selects Error Log CONTROL packets /TY:SYSTEM_INFO Selects SYSTEM INFOrmation packets /TY:ERRORS Selects PERIPHERAL, PROCESSOR, MEMORY, and SYSTEM_INFO packets /TY:ALL Selects ALL packets /TY:(xxx,...) Selects multiple packet types xxx can be any one of the above arguments. Note that you can specify ALL and ERRORS in this syntax, but each must be the only argument. That is, /TY:(ALL) is legal but /TY:(MEMORY,ALL) is not. Default: /TY:ALL. 3 /VOLUME /VO:argument The RPT /VO switch allows you to select packets based on device volume label. Syntax: /VO:volume_label Selects packets that have the specified volume label. Default: None 3 /WIDTH /WI:argument The RPT /WI switch controls the width of the output listing. RPT summary reports cannot be printed in narrow width format. Syntax: /WI:NARROW Generates an 80 column listing /WI:WIDE Generates a 132 column listing Default: /WI:WIDE 2 WARNINGS The ERRLOG task issues a warning message when error limiting is turned on and the device reaches one of the error limits. The message is: ** WARNING: Device DDnn: reached {Hard|Soft} limit (nn.) ** ERRLOG then stops logging errors on that device. Logging can be resumed on the device by: (1) raising the limit that was met (see HELP ERRLOG ELI /{HL|SL}) (2) resetting the device error counts (see HELP ERRLOG ELI /RESET). On nonmultiuser systems the warning is only displayed on the console terminal On multiuser systems, the warning is displayed on any terminal that has allocated the device. If that fails, it is sent to the terminal that invoked the task that attached the device. If the device is neither allocated nor attached, the warning is sent to the console. See HELP ERRLOG ELI /SHOW for information on how to display the error counts for each device.