
 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 <switch> 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 <switch> 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.

