A number of additional interactive commands exist. They can be executed at DIA> prompt or DCL prompt.
1 – ADD
Allows the users to add information to DECevent. Valid ADD commands are: ADD USER ADD EXTERNAL
1.1 – USER
Adds a user name to one or all of the notification mailing lists. User names can be added to any of the mailing lists except the SICL mailing list which is reserved for Digital use only. ADD USER user-name [mail-list]
1.1.1 – user-name
Is the user name to be added to the specified mailing list.
1.1.2 – mail-list
Valid notification mailing lists for the ADD USER command are: - CUSTOMER - FSE - MONITOR - SICL
1.2 – EXTERNAL
Adds an entry to one external notification lists. ADD EXTERNAL entry_name list_name
1.2.1 – entry_name
On OpenVMS systems, is a logical name that points to a command procedure. On Digital Unix systems, is the name of a script file.
1.2.2 – list_name
Can be one of CUSTOMER or RESERVED.
2 – REMOVE
Allows the user to remove either compiled rulesets or data from the fault manager. The following are valid REMOVE commands: REMOVE REPAIRED REMOVE SYSTEM_INFO REMOVE USER
2.1 – REPAIRED
Removes repair information entered by a service engineer for a specific device. This allows the repair database to be trimmed, enhancing the usability of the information. Repair entries deleted from the database are no longer available to the fault manager and cannot be recovered. REMOVE REPAIRED dev-name dev-name: A valid device name.
2.2 – SYSTEM_INFO
Removes information about a system under the fault manager's domain. REMOVE SYSTEM_INFO node-name node-name: A valid node name.
2.3 – USER
Removes a user name from one or more of the notification mailing lists. A valid user name must be specified. If no mailing list is specified then the specified user name will be removed from all of the mailing lists except the SICL mailing list. REMOVE USER user-name [mail-list]
2.3.1 – user-name
Is the user name listed within the SHOW MAILING_LIST report.
2.3.2 – mail-list
Valid notification mailing lists for the REMOVE USER command are: - CUSTOMER - FSE - MONITOR - SICL
3 – FLUSH
Clears out saved event information for a particular device. FLUSH dev-name dev-name: Is a valid device name.
4 – SHOW
Displays information about settings and selection parameters or recorded data entries from the various product databases. Valid show command are: SHOW EXTERNAL SHOW KNL SHOW MAILING_LIST SHOW SELECT SHOW THEORY SHOW PARAMETERS SHOW SICL SHOW THRESHOLD SHOW REPAIRED SHOW SETTINGS SHOW SUMMARY SHOW TYPES
4.1 – EXTERNAL
Displays the contents of the external notification lists. If a list_name isn't provided, the contents of all external lists is shown. SHOW EXTERNAL list_name
4.1.1 – list_name
Can be one of CUSTOMER or RESERVED.
4.2 – KNL
Displays version information about each knowledge file. The report can be used to determine if knowledge files are out of date or to determine the level of device support in a given knowledge file. Versioning information was added to knowledge files to allow knowledge files to be distributed separatly. The report format is: Knowledge File Version Information File name Version Build Date Platform
4.3 – MAILING_LIST
Displays accounts that receive mail when different types of notification messages are sent. If no mail-list is specified then all of the mailing lists are shown. SHOW MAILING_LIST [mail-list]
4.3.1 – mail-list
Valid mailing lists for the SHOW MAILING_LIST command are: - CUSTOMER - FSE - MONITOR - SICL
4.4 – PARAMETERS
Displays all settings related to notification. Valid show parameters are as follows: - The telephone number for Digital Services (SET PHONE) - The serial number of each registered system (SET SYSTEM_INFO) - The type of each registered system (SET SYSTEM_INFO) - The name of each registered system (SET SYSTEM_INFO) - The current SICL state (SET SICL)
4.5 – REPAIRED
Shows the history of repair actions for the specified device. Information is displayed using the following format: Device Time Of Repair Comment dev-nm dd-mmm-yyyy:hh:mm Engineer's comment SHOW REPAIRED [dev-name] dev-name: Specifies the name of a valid device.
4.6 – SETTINGS
Displays the current status of an individual settings parameter. If the setting parameter is omitted, then all setting parameters are displayed. SHOW SETTINGS [setting] setting: The name of parameter to be displayed.
4.7 – SELECT
Used to show the selections defined by the user. Each selection is shown as a selection name and selection path pair, for example, DISK HEADER.DISK.DEVTYPE. If the select-name is omitted, then all selection information is displayed. SHOW SELECT [select-name] select-name: Parameter is the name of the selection to be displayed.
4.8 – SICL
Displays the current state of SICL (System Initiated Call Logging).
4.9 – SUMMARY
Displays a list of all devices that have crossed their assigned notification threshold. SHOW SUMMARY The output has the following format: Device Class State Count Time dev-nm class curr-state err-cnt time-occured
4.10 – THEORY
Displays a list of all devices that have indicated faults. SHOW THEORY The output of this command has the following format: Device Theory Time Reported dev-nm the-nm date-time
4.11 – THRESHOLD
Displays current threshold values for a specific device or device type. Threshold values determine when analysis and notification occur. If no qualifiers are present, SHOW THRESHOLD will list thresholds for all devices and device types. Output from this command has the following format: ---Hard--- ---Soft--- ---Info--- ---Media--- Device Cnt DSE Cus Cnt DSE Cus Cnt DSE Cus Cnt DSE Cus device cnt DSE Cus Cnt DSE Cus Cnt DSE Cus Cnt DSE Cus SHOW THRESHOLD [/NAME=dev-name][/TYPE=dev-type]
4.11.1 /NAME
/NAME=dev-name Provides a device name for the command, where dev-name is a valid device name. Either the /TYPE or /NAME qualifier must be present.
4.11.2 /TYPE
/TYPE=dev-type The /TYPE qualifier provides a device type for the command, where dev-type is a valid device type. Issue SHOW TYPES to list the valid device types. Either the /TYPE or /NAME qualifier must be present.
4.12 – TYPES
Displays devices that the fault manager currently recognizes under the specified subsystem. If no subsystem is specified, then all devices are listed under each of the subsystems. SHOW TYPES [subsystem]
4.12.1 – subsystem
The following are valid subsystems for the SHOW TYPES command: - CPU - IOS
5 – SET
Allows users to customize system settings. All SET commands must be executed from the interactive command shell. The following are valid set commands: SET DEFAULT REPORT SET LOCALE SET EVENT SET PHONE_NUMBER SET SICL SET SYSTEM_INFO SET THRESHOLD
5.1 – DEFAULT REPORT
Sets the default report used during translation. The report is specified by giving a path name of a report generation ruleset. SET DEFAULT REPORT rule_name rule_name: Name of ruleset. For example, TRANSLATION.DEFAULT_REPORT
5.2 – EVENT
Allows users to select an event log file from which event reports are formatted. This allows a user, in the interactive command shell, to use an event log other than the default system event log without specifying the file name on all of the subsequent commands. SET EVENT file_name file_name: Name of an event log to be used for formatting report.
5.3 – LOCALE
Allows users to override the locale file previously set for the current system. This is done for internationalization reasons so that natural language conventions can be added in the future. SET LOCALE location location: String defining the location of the user in terms of the locale preferences available, for example, AMERICAN_ENGLISH.
5.4 – PHONE_NUMBER
The SET PHONE_NUMBER command sets the phone number of the Customer Support Center for a particular customer site, allowing the customer notification mail message to provide the customer with the correct number to call for service. Change the phone number in interactive mode. Once changed, execute the SAVE SYSTEM SETTINGS command to save the phone number. The current phone number setting can be seen by executing the SHOW PARAMETERS command. SET PHONE_NUMBER phone-number phone-number: Is the valid CSC phone number.
5.5 – SICL
The SET SICL command turns the System Initiated Call Logging feature on or off. SET SICL state state: Can be either ON or OFF.
5.6 – SYSTEM_INFO
Provides information to the fault manager about a system under its domain. SET SYSTEM_INFO /SERIAL_NUMBER=num /NODE=node-name "system type"
5.6.1 /SERIAL_NUMBER
/SERIAL_NUMBER= num Provides the serial number used for all service contracts. This qualifier is required.
5.6.2 /NODE
/NODE=node-name The valid VMS node-name of the system. This qualifier is required.
5.6.3 – system type
A required parameter that is a quoted string that describes the system, for example, "DEC 4000"
5.7 – THRESHOLD
Alters threshold triggering for monitored devices. Thresholds can be entered either by device name or by device type. SET THRESHOLD - [/NAME=dev-name][/TYPE=dev-type]/CLASS=severity[/DSE][/CUSTOMER] count
5.7.1 /NAME
/NAME=dev-name Provides a device name for the command, where dev-name is a valid device name. Either the /TYPE or /NAME qualifier must be present.
5.7.2 /TYPE
/TYPE=dev-type Provides a device type for the command, where dev-type is a valid device type. Issue SHOW TYPES to list the valid device types. Either the /TYPE or /NAME qualifier must be present.
5.7.3 /CLASS
/CLASS=severity The /CLASS qualifier is required. It specifies the level of severity by one of the following keywords: - HARD (A device could not recover data) - SOFT (A device that may have recovered data) - INFO (Indicates informational events on a device) - MEDIA (Indicates events related to storage media)
5.7.4 /DSE
Performed analysis when a device crosses this threshold. When thresholds are crossed, the external notification procedures are invoked. Thresholds are set for different severity levels of events. Either the /DSE or /CUSTOMER qualifier must be present.
5.7.5 /CUSTOMER
Notifies the customer when a device crosses this threshold. When thresholds are crossed, the external notification procedures are invoked. Thresholds are set for different severity levels of events. Either the /DSE or /CUSTOMER qualifier must be present.
5.7.6 – count
The threshold value to be set for the specified device or device type.
6 – SAVE SETTINGS
Allows users to store their current customization settings in a default file. DECevent will use these defaults in subsequent commands. SAVE SETTINGS
7 – RESTORE
Restores customized settings or the system defined settings. RESTORE SETTINGS RESTORE SYSTEM
7.1 – SETTINGS
Allows users to cancel customizations they may have set since the last customization file was saved. This command does not make sense when the fault manager is passed a command from the operating system command line. For this reason it is only supported in the interactive command shell. RESTORE SETTINGS
7.2 – SYSTEM SETTING
Allows users to cancel customizations previously set and saved in the customer system settings file. The command restores the default system settings. RESTORE SYSTEM SETTINGS
8 – DIRECTORY
Returns a list of all the event or canonical rulesets known to DECevent. DIRECTORY EVENTS DIRECTORY CANONICAL
8.1 – EVENTS
Lists all of the event rulesets that are stored in the event to canonical (ETC) knowledge library. DIRECTORY EVENTS
8.2 – CANONICAL
Lists all of the canonical rulesets that are stored in the canonical to report (CTR) knowledge library. DIRECTORY CANONICALS
9 – IGNORE
Prevents the fault manager from monitoring a device or device type. Either the /NAME or /TYPE qualifier must be present. IGNORE [/NAME=dev-name][/TYPE=dev-type]
9.1 /NAME
/NAME=dev-name Provides a device name for the command, where dev-name is a valid device name. Either the /TYPE or /NAME qualifier must be present.
9.2 /TYPE
/TYPE=dev-type Provides a device type for the command, where dev-type is a valid device type. Issue SHOW TYPE to list the valid device types. Either the /TYPE or /NAME qualifier must be present.
10 – RECOGNIZE
Reverses the effect of the IGNORE command, forcing the fault manager to start monitoring a device or device type previously ignored. Either the /NAME or /TYPE qualifier must be present. RECOGNIZE [/NAME= dev-name][/TYPE=dev-type]
10.1 /NAME
/NAME=dev-name Provides a device name for the command, where dev-name is a valid device name. Either the /TYPE or /NAME qualifier must be present.
10.2 /TYPE
/TYPE=dev-type Provides a device type for the command, where dev-type is a valid device type. Issue SHOW TYPE to list the valid device types. Either the /TYPE or /NAME qualifier must be present.
11 – REPAIR
Resets the analysis information for a repaired device, allowing the fault manager to start fresh analysis of the device. Failure to enter this command after repairing a device causes the fault manager to suppress notification of new problems or to incorrectly call out a nonexistent fault. REPAIR /NAME=dev-name /DATE=time "repair-action"
11.1 /NAME
/NAME=dev-name Indicates the name of the device that is repaired or replaced. This qualifier is required.
11.2 /DATE
/DATE=time Indicates the date and time a repair action was performed. Time can be specified as an absolute time or it can be specified by the keywords TODAY or YESTERDAY. This qualifier is required. time: (DD-MMM-YYYY:HH:MM:SS.CC) or (DD-MMM-YYYY HH:MM:SS.CC)
11.3 – repair action
A quoted string that describes the repair action, for example, "Replaced drive with new one. Fred Smith"
12 – TEST
Tests notification functions on a system. The following are valid test commands: TEST EXTERNAL TEST MAIL TEST SICL
12.1 – EXTERNAL
Tests a user-written external notification message. User-written external notification messages are sent when analysis is performed or when a device crosses a customer-defined threshold. TEST EXTERNAL destination destination: Can be either CUSTOMER or RESERVED.
12.2 – MAIL
Tests whether all users specified on mailing lists can receive mail. A test message is sent to all members of a specified mail list. If mail cannot be sent, the mail transport reports errors for sending mail to a particular user. TEST MAIL mail-list
12.2.1 – mail-list
The following mail lists are tested with this command: - CUSTOMER - FSE - MONITOR
12.3 – SICL
Ensures the proper installation of the System Initiated Call Logging feature.