Chapter 8

The -int Flag

This chapter discusses 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 Tru64 UNIX system, at the system prompt, enter the following command:

% dia -int

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

dia> aaa xxxx yyyy

Where:

aaa is the command valid from the DECevent interactive command shell.
xxxx is the specific subject the command applies to.
yyyy is the parameter associated with the command.

Correct interactive command syntax is explained further in this chapter.

8.1.2 Exiting Interactive Mode

To exit from the interactive command shell, type exit at the dia> prompt 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:

% dia -int

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 dia> , the DECevent interactive prompt:

dia> set loc AMERICAN_ENGLISH

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:

dia> sav

Example: Exiting the Interactive Command Shell

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

dia> exit

8.2 Set, sav, and res Command Descriptions

The set , sav , and res commands work only from within the interactive command shell.

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 file

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

set loc locale

Allows you to change the locale file for internationalization 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:

set evt errorlog.old

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:

dia> set evt /usr/users/binlog/binlog_oscar

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:

set loc <locale>

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:

dia> set loc AMERICAN_ENGLISH

dia> sav

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:

res

Example

The following is an example of a res command.

dia> res

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:

sav

Example

The following is an example of the sav command:

dia> sav