Each entry in the GT.M Message and Recovery Procedures Reference Manual is presented in the following format.
|
1. NOTPRINCIO |
|
2. NOTPRINCIO, Output currently directed to device xxxx |
|
3. Run Time Warning: This message displays the current device when the process enters Direct Mode and the current device xxxx is not the principal device. |
|
4. Action: To redirect all I/O to the terminal, note the current device or save it in a temporary variable and USE $P. If you decide to resume program execution, restore the current device with a USE command. |
where
1. Indicates the mnemonic preceding the error message and is the component by which the entry is alphabetized.
2. Indicates the mnemonic and the actual message that accompanies it.
3. Indicates the GT.M component that generates the message, its severity, and a short description of its implication(s).
4. Suggests action(s) to take when the message appears.
This manual can be used with GT.M on any of its supported platforms. However, because in some instances the suggested actions are more useful when platform-specific information is provided, the following conventions are used, as necessary. In text, platform-specific statements are separated by a space and an italic slash ( / ). UNIX-specific text follows the slash and appears in italic typeface, as illustrated in the following example. The VMS-specific text precedes the slash and appears in standard Roman (non-italic) typeface. UNIX-specific text follows the slash, see the following example.
MUPIP Error: The global directory currently named by the logical name GTM$GBLDIR / environment variable gtmgbldir is not valid.
If an entire statement is either UNIX- or VMS- specific, it is preceded by the phrase "In UNIX," or "In VMS," and appears in Roman typeface. The following example illustrates this convention.
Action: In VMS, relink your image to include the missing routine. In UNIX, relink your external call descriptor image to include the missing routine.
Although the terms "host shell command" and "file-specification" have some platform-specification connotations, they are used in their most generic sense throughout this manual. The former describes commands that originate from the host operating system, rather than from GT.M. When this phrase is used, the commands being referenced are typically those that display file protections: in VMS, DIR/SEC and in UNIX, ls -lR. The term "file-specification" may refer to a simple file name or a full directory path to that file.