[Contents] [Prev. Chapter] [Next Chapter]

Chapter 8 - The -int Flag

8.1 Description

The -int flag allows you to enter the DECevent interactive command shell. When you are in the DECevent interactive command shell, the dia> prompt is displayed on the screen.

Chapter 4 provides a basic overview of the interactive command shell.

Note

All commands valid from the CLI also are valid from the interactive command shell without first entering the dia command verb. Some commands, such as the set commands, are valid only from within the interactive command shell and may not be entered from the CLI. If -int is specified on the command line, subsequent commands are ignored.

8.1.1 Entering the Interactive Command Shell

To enter the interactive command shell from a Digital UNIX system, at the system prompt, enter the following command:

The DECevent interactive command shell prompt, dia>, appears. The format for entering a command at the dia> prompt is the following:

Where:

Correct interactive command syntax is explained further in this chapter.

8.1.2 Exiting Interactive Mode

To exit from the interactive command shell, at the dia> prompt type exit, followed by a carriage return.

8.1.3 Qualifiers and Parameters

Although there are no specific qualifiers or parameters for the -int flag, all commands valid from the CLI are valid from within the interactive command shell.

8.1.4 Interactive Command Examples

The following examples show how to enter the interactive command shell, how to issue a command from within the interactive command shell, and how to exit the interactive command shell.

Example: Entering the Interactive Command Shell

To enter the interactive command shell, enter the following command at the system prompt:

The DECevent interactive command shell prompt, dia>, then appears.

Example: Issuing a Command from the Interactive Command Shell

The following command shows how to issue a set locale command from the DECevent interactive (dia>) prompt:

Note

All settings must be entered in uppercase letters.

The set loc command is described in detail in Section 8.2.2.

Example: Saving Settings from within the Interactive Command Shell

The results of all set commands must be saved before exiting the interactive command shell or the default settings once again become valid upon exiting the interactive command shell. To save settings, enter the following command at the dia> prompt:

Example: Exiting the Interactive Command Shell

To exit the interactive command shell, enter the following command at the interactive (dia>) prompt:

8.2 Set, sav, and res Command Descriptions

The set, sav, and res commands work only from within the interactive command shell. The set commands allow you to customize or change system settings. The sav command allows you to save these changed settings. The res command allows you to restore previously set customer settings.

Table 8-1 lists each set command as well as the sav and res commands. Underlined parameters imply required input. 

         Table_8-1:_The_set,_res,_and_sav_Commands______________________

         Command_____Action_____________________________________________

         set evt     Allows you to select an event log file from which
         file        event reports are formatted.

         set loc     Allows you to change the locale file for interna-
         locale      tionalization reasons.

         res         Allows you to cancel customizations previously set
                     in the customer local settings file.

         sav         Allows you to store the current customization
         ____________settings_in_a_default_file.________________________

8.2.1 The set evt Command

The set evt command allows you to select an event log file from which event reports are formatted. This allows you, in the interactive command shell, to use an event log other than the default system event log without specifying the file name on all subsequent commands. Before exiting the interactive command shell, you must save this setting or system default settings become valid once again.

Syntax

The following syntax is used for the set evt command:

The file Parameter

The file parameter is the name and path of the event log file used for formatting the report. You must enter a file parameter with this command.

Example

The following is an example of a set evt command:

Note

Set commands should be saved with the sav command. Refer to Section 8.2.4 for information of saving set command functions.

8.2.2 The set loc Command

The set loc command allows you to override the locale file previously set for the current system. This is done for internationalization reasons so natural language conventions can be added in the future.

Note

Only the AMERICAN_ENGLISH locale file will be supported for DECevent. However, documentation will be provided describing how to create new locale files.

Syntax

The following syntax is used for the set loc command:

locale Parameter

The locale parameter is a string defining the local language preferences available. An example is AMERICAN_ENGLISH. You must provide a locale parameter with this command.

Example

The following is an example of a set loc command:

Note

All settings must be entered in uppercase letters.

8.2.3 The res Command

The res command allows you to restore previous settings in the local customization file. It cancels customizations set since the last time the customization file was saved.

Syntax

The following syntax is used for the res command:

Example

The following is an example of a res command.

8.2.4 The sav Command

The sav command allows you to store current customized settings in a default file. DECevent then uses these settings in subsequent sessions.

Syntax

The following syntax is used for the sav command:

Example

The following is an example of the sav command:

[Contents] [Prev. Chapter] [Next Chapter]