PRINT MESSAGE
FUNCTION
This command displays messages defined in Dictionary-IV on the terminal.
SYNTAX
PRINT MESSAGE msg-code-string [USING "msg-dict-name"]
msg-code-string:
type, number [, display-mode [, clear [, (col,ln) [, *1-replacement [, *2-replacement ...]]]]]- type
- is one of the following values:
| I | Input |
| N Non-Input | |
| P | Prompt |
| S | Selector (normal and background reverse video) |
| Y Yes/No | |
| i | Input prints data from "INTO" data element or variable as default value. |
| n | Non-Input, no suffix, no carriage return needed |
| s | Selector (background reverse video and foreground reverse video) |
| x | Non-input, no suffix, carriage return needed |
- number
- the number of a message in the message list.
- display-mode
- is one of the following values:
| (blank) | Standard Print Mode |
|---|---|
| B | Background |
| C | Clear message area and exit |
| F | Foreground |
| R | Reverse Video Foreground |
| X | Return Message, do not print |
| r | Reverse Video Background |
- clear
- is one of the following values:
| A | Clear Line Before & After |
| B | Clear Line Before |
| C | Clear Line After |
| D | Clear Message Area After |
| E | Clear Screen Before & After |
| F | Clear Screen Before |
| G | Clear Screen After |
| X | Do Not Clear |
| (blank) Do Not Clear |
- col,ln
- the column and line position of display, where (0,0) specifies the top left of the screen.
- *1-replacement
- If the message number is null, this can specify a message. If the message number is not null, this contains a string value that is to be placed in a message which contains *1, *2, and so on.
- msg-dict-name
- the name of a Dictionary-IV defined message dictionary.
NOTES
- For more information on messages see the Dictionary-IV Developer Guide.
- If the USING “msg-dict-name” clause is not specified, the system uses the last opened message dictionary. The USING option overrides this default for the current command.
- All parameters specified with the PRINT MESSAGE command override the values defined for the message in the message dictionary.
- The PRINT MESSAGE command will display input, non-input, and yes/no messages, but will not accept any operator response. To display an input, non-input, or yes/no message and accept operator input, use the INPUT MESSAGE command.
- The replacement value in the msg-code-string can specify a replacement value that is to be placed in a message which contains *1-replacement, *2-replacement, and so on.
- In order to perform a replacement, the message must contain a *1. If the replacement value is ABCD, and the message is ‘File *1 is busy,’ then ‘File ABCD is busy’ is displayed. For each substitution there is another *n entry in the message, where n is a positive integer.
- To display a non-dictionary message using the msg-code-string options, specify a null message number, any display mode, clear, or position options and a *n-replacement that equals the message you plan to display.
- The elastic string variable ]MD$ controls whether the message is printed in the current window, in a new window, or physically on the screen. For more information see the on-line documentation for the Dictionary-IV API 8MSG and refer to the ninth entry in the 8MSG message array. Setting ]MD$=“*” applies the default.
EXAMPLES
PRINT MESSAGE "P,5" USING "4SSAMPLE"
PRINT MESSAGE "P,5,R,B,(0,22)" USING "4SSAMPLE"SEE ALSO
INPUT MESSAGE, OPEN MESSAGES
From the Script-IV Language Reference, version 8.9.1. Open this page in the PDF