Hitachi

JP1 Version 11 JP1/Script Description and Reference (For Windows Systems)


3.4.1 Script Trace Viewer window and menus

Trace Viewer displays the execution status and trace of a script created in Manager. The execution status and trace information are output to a trace file.

This section describes the layout and menus of the Script Trace Viewer window which appears when you start Trace Viewer. The window displayed when you open a trace file is also described.

Organization of this subsection

(1) Script Trace Viewer window

Figure 3-4 shows the Script Trace Viewer window and the names of its components.

Figure 3‒4: Script Trace Viewer window

[Figure]

(a) Toolbar

The toolbar contains buttons representing the most frequently used commands on the pull-down menus. By simply clicking a button, you can execute the corresponding command. You can hide the toolbar by toggling Toolbar in the View menu.

The following command buttons are displayed on the toolbar of the Script Trace Viewer window:

Save

Saves a trace file under a new name.

View

Displays the contents of a trace file.

Delete

Deletes a trace file.

Print

Prints a trace file.

Exit

Quits Trace Viewer.

Clear

Clears a trace file (to zero file size).

Select All

Selects all the items.

Analysis Trace

Shows or hides a list of analysis traces.

Execution Trace

Shows or hides a list of execution traces.

User Trace

Shows or hides a list of user traces.

Server Trace

Shows or hides a list of server traces.

Refresh

Updates the contents of a displayed trace file.

Select Computer

Specifies the computer on which the trace files to be displayed reside.

Help

Displays the JP1/Script online help.

(b) Status bar

The status bar displays messages about the processing being carried out by Trace Viewer and status messages at completion of processing.

(c) Client area

The client area displays trace file information (file type, file name, file size, date modified, and folder in which the file is located). In the leftmost field, icons show the execution status of each trace file. Their meaning differs depending on whether the particular script can be activated concurrently from multiple processes. Tables 3-11 and 3-12 show the meanings of the icons in each case.

Table 3‒11: Script Trace Viewer icons when multi-activation is permitted

Icon#

Execution status

Meaning

[Figure]

(white & lime)

Executing

One or more scripts is currently executing.

[Figure]

(white & blue)

Terminated normally (partially completed)

One or more scripts has terminated normally.

[Figure]

(white & red)

System error (partially completed)

A command execution error occurred in one or more scripts. Script execution has been canceled.

[Figure]

(white & yellow)

User error (partially completed)

An Alert command or ExitWindows command was executed in one or more scripts, or one or more scripts was forcibly terminated. (A system error may have occurred after Alert command execution.)

[Figure]

(aqua & blue)

Terminated normally (all completed)

All scripts have terminated normally.

[Figure]

(aqua & black)

Unexecuted (all completed)

None of the scripts has executed. This status is displayed when a command could not be executed because an error was found at syntax analysis, for example.

[Figure]

(aqua & red)

System error (all completed)

All scripts have terminated, but a command execution error occurred in one or more scripts and script execution was canceled.

[Figure]

(aqua & yellow)

User error (all completed)

All scripts have terminated, but an Alert command or ExitWindows command was executed in one or more scripts, or one or more scripts was forcibly terminated. (A system error may have occurred after Alert command execution.)

#: The colors in parentheses in the Icon field are the colors of the circles in the icon.

Table 3‒12: Script Trace Viewer icons when multi-activation is prohibited

Icon#

Execution status

Meaning

[Figure]

Not applicable

Execution status is not managed for this type of file (analysis trace or user trace).

[Figure]

(black)

Unexecuted

The script has not executed.

[Figure]

(lime)

Executing

The script is executing.

[Figure]

(blue)

Terminated normally

The script has terminated normally.

[Figure]

(red)

Terminated abnormally (system error)

A command execution error occurred and script execution has been canceled.

[Figure]

(yellow)

Terminated abnormally (user error)

An Alert command or ExitWindows command was executed or the script was forcibly terminated. (A system error may have occurred after Alert command execution.)

#: The color in parentheses in the Icon field is the color of the circle in the icon.

(2) Menus in the Script Trace Viewer window

The menus in the Script Trace Viewer window are described next. Table 3-13 lists the Trace Viewer commands (functions) provided in the menus.

Table 3‒13: Trace Viewer menus and commands

Menu

Command (function)

Description

File

Save As

Saves a selected trace file under a new name.

View Trace File

Displays the contents of a selected trace file.

Delete Trace File

Deletes a selected trace file.

Print

Prints a selected trace file.

Exit

Quits Trace Viewer.

Edit

Clear Trace File

Clears a trace file (to zero file size).

Select All

Selects all items.

View

Toolbar

Shows or hides the toolbar.

Status Bar

Shows or hides the status bar.

Minimize When Inactive

Minimizes the Trace Viewer window to an icon when the window is not in use.

Analysis Trace

Shows or hides a list of analysis traces.

Execution Trace

Shows or hides a list of execution traces.

User Trace

Shows or hides a list of user traces.

Server Trace

Shows or hides a list of server traces.

Refresh

Updates the information in a trace file.

Options

Select Computer

Specifies the computer on which the trace files to be displayed reside.

Help

Contents

Displays the contents of the JP1/Script online help.

Search by Keyword

Lists the keywords of the JP1/Script online help.

About JP1/Script

Displays version information for JP1/Script.