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