IMAGE specifiers have the following meanings in an ENTER statement:
|
Specifier
|
Meaning
|
|
#
|
Causes the statement to terminate when the last item is terminated. No statement terminator is needed, EOI and LF are item terminators, and early termination is not allowed.
|
|
%
|
Is the same as # except EOI causes early statement termination when it terminates an item.
|
|
K
|
Allows free-field entry. For numerics, entered characters are sent to the number builder, leading non-numeric characters and blanks are ignored, trailing non-numeric characters and characters sent with EOI true are delimiters. For strings, entered characters are sent to the string. A CR may be sent to the string if it is not followed by a LF. The string is terminated by CR/LF, LF, character received with EOI true, or the string dimensioned length being filled.
|
|
-K
|
Is like K except LF and CR/LF are not terminators.
|
|
H
|
Is the same as K except a comma is the radix indicator and a period is a non-numeric character.
|
|
-H
|
Means the same as -K for strings, and H for numbers.
|
|
B
|
Demands one Byte, like the NUM function.
|
|
W
|
Demands a 16-bit Word (2’s complement integer). If the interface is 16-bit, the word is entered in one operation (even if the BYTE attribute was used in the I/O path). If the interface is 8-bit, the byte ordering depends on the LSB/MSB of the I/O path. If the source is a string, native byte ordering is always used (LSB FIRST on a PC, MSB FIRST on a Sun or HP Workstation). If the WORD attribute was specified in the I/O path, a pad byte will be entered before the word when necessary to achieve word alignment.
|
|
Y
|
Is the same as W, except that word alignment is not done, and the BYTE attribute is not ignored.
|
|
+
|
Indicates an END (EOI) is needed with the last character of the last item to terminate the ENTER statement. LFs are no longer statement terminators, but are still item terminators.
|
|
-
|
Indicates a LF is needed to terminate the ENTER statement. EOI is ignored; other END indicators cause an error.
|
|
S
|
Same meaning as D.
|
|
M
|
Same meaning as D.
|
|
D
|
Demands one character for each D, or repeat count. Non-numerics are consumed while fulfilling the count but also delimit the number. Blanks embedded in the number are ignored.
|
|
Z
|
Same meaning as D.
|
|
*
|
Same meaning as D.
|
|
.(period)
|
Same meaning as D.
|
|
R
|
Has the same meaning as D, plus the number builder is instructed to use a comma as the radix indicator and a period as a non-numeric character.
|
|
E
|
Is treated the same as 4D.
|
|
ESZ
|
Same as 3D.
|
|
ESZZ
|
Same as 4D.
|
|
ESZZZ
|
Same as 5D.
|
|
A
|
Demands one alphanumeric string character.
|
|
X
|
Enters a character and discards it.
|
|
/
|
Skips all characters to the next LF and EOI is ignored.
|
|
L
|
Ignored in ENTER.
|
|
@
|
Ignored in ENTER.
|
|
"string literal"
|
One character is skipped for each character in the string literal. Remember to double the quote marks when the IMAGE is inside a string literal
|
|