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.
(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.
-
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.
Icon# |
Execution status |
Meaning |
---|---|---|
(white & lime) |
Executing |
One or more scripts is currently executing. |
(white & blue) |
Terminated normally (partially completed) |
One or more scripts has terminated normally. |
(white & red) |
System error (partially completed) |
A command execution error occurred in one or more scripts. Script execution has been canceled. |
(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.) |
(aqua & blue) |
Terminated normally (all completed) |
All scripts have terminated normally. |
(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. |
(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. |
(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.) |
Icon# |
Execution status |
Meaning |
---|---|---|
Not applicable |
Execution status is not managed for this type of file (analysis trace or user trace). |
|
(black) |
Unexecuted |
The script has not executed. |
(lime) |
Executing |
The script is executing. |
(blue) |
Terminated normally |
The script has terminated normally. |
(red) |
Terminated abnormally (system error) |
A command execution error occurred and script execution has been canceled. |
(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.) |
(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.
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. |
|
|
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. |