SQZ Subparameter - mfx - 3.1

p,l

Specifies the beginning byte position p and byte length l of the input record’s relevant field.

%pp

Specifies a fixed-length parsed field. See PARSE Parameter (Optional) for further description.

SHIFT=LEFT

Specifies left-squeezing of the input field. By default, all blank characters are eliminated and all nonblank characters are shifted left; if necessary, blank characters are introduced on the right side to compensate for the length of the output field. (The default output field length is equal to the input field length.)

SHIFT=RIGHT

Specifies right-squeezing of the input field. By default, all blank characters are eliminated and all nonblank characters are shifted right; if necessary, blank characters are introduced on the left side to compensate for the length of the output field. (The default output field length is equal to the input field length.)

Specifies that a variable-length field should be produced. The field will be left-justified and all blank characters will be deleted. The output record must be a variable-length record.

The maximum length of the field is determined from the input field length and the lengths of any LEAD, MID and TRAIL strings.

Any INREC/OUTREC fields following a VL field cannot specify a starting column number or any of the alignment options (H, F or D for halfword, fullword or doubleword alignment). Also, VL cannot be used with the OVERLAY parameter or the LENGTH subparamter.

VL is permitted with fixed-length data and OUTFIL FTOV. It is also permitted with OUTFIL IFTHEN and FTOV, but not with a WHEN=INIT parameter or with a HIT=NEXT parameter when FTOV is used.

Optionally alters the length of the output field to accommodate a change in the total number of characters from the input field. The default output field length is equal to the input field length l. Use LENGTH=n to either extend a field that needs to be larger due to the addition of a leading or trailing string, or to shorten a field from the default length to reduce the number of padding blank characters. LENGTH cannot be specified with the VL subparameter.

PREBLANK=list

Optionally specifies user-defined nonblank characters to be replaced with blank characters before squeezing. The characters to be replaced are specified together in a character string constant (C'string') or hexa­decimal string constant (X'hh...hh') from 1 to 10 bytes. PREBLANK searches throughout the entire input field and substitutes a blank char­acter for each individual nonblank character that matches any individ­ual PREBLANK string character. For example, PREBLANK=C'<>' replaces each occurrence of '<' and '>' with a blank character through­out the entire input field before squeeze operation.

LEAD=string

Optionally specifies a character constant (C'string') or hexadecimal constant (X'hh...hh') from 1 to 50 bytes that is placed in the output field immediately left of the first nonblank character in the field. Note that LENGTH=n also may need to be specified to accommodate the additional leading characters. For example, LEAD=C'(' inserts '(' as a leading character in the field.

MID=string

Optionally specifies insertion of a string per one or group of adjoining blank characters that is eliminated between the first and last nonblank characters in the field. The string can be a character constant (C'string') or hexadecimal constant (X'hh...hh') from 1 to 10 bytes. Note that LENGTH=n also may need to be specified to accommodate the additional characters. For example, MID=C'*' substitutes a '*' for every group of one or more adjoining blank characters that have been eliminated between the first and last nonblank characters in the field.

TRAIL=string

Optionally specifies a character constant (C'string') or hexadecimal constant (X'hh...hh') from 1 to 50 bytes that is placed in the output field immediately right of the last nonblank character in the field. Note that LENGTH=n also may need to be specified to accommodate the additional trailing characters. For example, TRAIL=C')' inserts ')' as a trailing character in the field.

PAIR=APOST

Optionally specifies that all blank and PREBLANK characters between pairs of apostrophes remain unchanged. Any apostrophe throughout the field also remains unchanged. For an unpaired apostrophe, if SHIFT=LEFT or VL is specified, the characters are unchanged from the apostrophe rightward to the end of the field; if SHIFT=RIGHT is specified, the characters are unchanged from the apostrophe leftward to the beginning of the field.

PAIR=QUOTE

Optionally specifies that all blank and PREBLANK characters between pairs of quotes remain unchanged. Any quote throughout the field also remains unchanged. For an unpaired quote, if SHIFT=LEFT or VL is specified, the characters are unchanged from the quote rightward to the end of the field; if SHIFT=RIGHT is specified, the characters are unchanged from the quote leftward to the beginning of the field.