Data Fields (p,l) or (%pp) Subparameters - mfx - 3.1

This specifies the position, length, and format of an input field. (See the description of f_i below for details.)

Identifies a fixed-length parsed field and format. (See the description of f_i below for details.)

This represents a positive numerical constant of up to 31 decimal digits. The + sign must be specified.

This represents a negative numerical constant of up to 31 decimal digits. The - sign must be specified.

An expression defines a numeric value. The simplest forms of an expression consist of a numeric data input field defined either by p,l,f_i or a constant defined by +n or -n. Expressions can also be created by connecting these simple expressions with operators, as shown in the last line of the above syntax illustration. Parentheses may be used to change the default precedence order of the operators. Algebraic equations can thus be represented with an expression.

A maximum value of 31 digits is permitted at all times in evaluating an expression. If this is exceeded, a critical error will be issued. Similarly, an attempted division by zero will also result in a critical error. The results of division will be rounded down to an integer.

Once an expression has been defined, its value can either be converted to a numeric output data format or to a printable numeric format using editing masks. See How to Convert Numeric Data. The default is to use the M0 editing mask to create printable output. The number of digits in an expression is defined to be 31 unless the expression is a simple p,l,f_i field.

+10
10,2,Y2Z
+10,ADD,10,2,Y2Z
1,4,ZD
10,2,PD
+30
1,4,ZD,ADD,10,2,PD
+30,MUL,(1,4,ZD,ADD,10,2,PD)
+30,MUL,(1,4,ZD,ADD,10,2,PD),MIN,(5,5,ZD,DIV,+100)
(+30,MUL,(1,4,ZD,ADD,10,2,PD)),MIN,(5,5,ZD,DIV,+100)

Use this parameter together with p,l to define the input format of a numeric field that is part or all of an expression. The expression will then be converted to either another numeric data format or to a printable format. In such cases, indicate the format of the data field that is to be converted by replacing f_i with BI, FI, FL, PD, ZD, CSF/FS, PD0, SFF, UFF, one of the SMF formats (DT1, DT2, DT3, TM1, TM2, TM3, and TM4), time-of-day (TOD) formats (DC1, DC2, DC3, TC1, TC2, TC3, TC4), extended time-of-day (ETOD) formats (DE1, DE2, DE3, TE1, TE2, TE3, TE4), or one of the year data formats (Y2B, Y2C, Y2D, Y2P, Y2S, Y2Z, Y2T, Y2U, Y2V, Y2W, Y2X, Y2Y, Y4T, Y4U, Y4V, Y4W, Y4X, Y4Y).

Also use this parameter when a 2-digit packed decimal year value is to be expanded to a 4-digit packed decimal value. In such cases replace f_i with Y2ID or Y2IP. The Y2ID and Y2IP formats cannot be used to form complex arithmetic expressions and do not allow the specification of mask (Mm), EDIT, SIGNS, or LENGTH.

An l value indicating the length of the field must be specified in accordance with the following allowable values:

for BI ... 1-8 inclusive

for CSF or FS ... 1-16 inclusive (15-digit limit)

for CSF or FS ... 17-32 inclusive (31-digit limit)

for FI ... 1-8 inclusive

for FL ... 4 or 8

for PD ... 1-16 inclusive

for PD0 ... 2-8 inclusive

for SFF ... 1-44 inclusive (31-digit limit)

for UFF ... 1-44 inclusive (31-digit limit)

for Y2B ... 1

for Y2C ... 2

for Y2D ... 1

for Y2ID ... 1

for Y2IP ... 2

for Y2P ... 2

for Y2S ... 2

for Y2Z ... 2

for ZD ... 1-31 inclusive

for Y2T ... 3-6 inclusive

for Y2U ... 2-3 inclusive

for Y2V ... 3-4 inclusive

for Y2W ... 3-6 inclusive

for Y2X ... 2-3 inclusive

for Y2Y ... 3-4 inclusive

for Y4T ... 7 or 8

for Y4U ... 4

for Y4V ... 5

for Y4W ... 7 or 8

for Y4X ... 4

for Y4Y ... 5

Use this subparameter to define the output numeric data format of an expression.

When f_o is specified, mask Mm, EDIT, and SIGNS cannot be specified. Indicate the desired format of the output field by replacing f_o with BI, CSF/FS, FD, FI, PD, PDC, PDF, ZD, ZDC or ZDF. The PDC format represents a PD field and uses a C for the sign of a positive value and D for the sign of a negative value. The ZDC format represents a ZD field and uses a C for the sign of a positive value and D for the sign of a negative value. PDF produces the same numerical value as PD, but uses an F for a positive sign and D for the sign of a negative value. ZDF produces the same numerical value as ZD, but uses an F for a positive sign and D for the sign of a negative value. See How to Convert Numeric Data for the default lengths of these fields. See LENGTH=n Subparameter for how this default may be changed.

TO=f_o is equivalent to f_o and in general, there is no reason to use the TO= form. However, if you are using a data dictionary symbol in your control statement, you should use the TO=f_o form to avoid ambiguities with certain types of data conversions. See the section INREC, OUTREC, OUTFIL TO Subparameter .

Use the Mm subparameter to indicate that one of the 27 MFX-provided editing masks, M0-M26, is to be used. Replace 'm' with the mask number. For details, see Mm Subparameter (Editing Masks).

Use the EDIT subparameter to specify that a user-provided editing mask should be used to format the output fields. For details, see EDIT Subparameter.

Use the SIGNS subparameter to specify the signs that will appear before or after the edited number. For details, see SIGNS Subparameter.

Use the LENGTH subparameter to alter the length of the output field. This is normally determined by the number of numeric digits d and either the data format or the edit pattern and format of the edited field. For details, see LENGTH=n Subparameter.

Use this subparameter to tell MFX how the field should be aligned with respect to the start of the output record. Replace a with H, F, or D to specify halfword (H), fullword (F), or doubleword (D) alignment. The alignment itself actually takes place after the column designation. It will automatically pad any provided field with the number of bytes of binary zeros required to achieve the specified alignment. This subparameter cannot be used in conjunction with data conversion.

Use the CHANGE subparameter to change an input field to a replacement constant or input record field in the reformatted output record if the input field equals a search constant. For a complete description, see CHANGE Subparameter.

Use the JFY subparameter to specify that an input field be processed for left-justification or right-justification for the output record. For left-justification, leading blank characters are eliminated; the remaining characters are shifted left; if necessary, blank characters are introduced to the right. For right-justification, trailing blank characters are eliminated; the remaining characters are shifted right; if necessary, blank characters are introduced to the left. Options include introducing new leading and trailing nonblank characters; eliminating previous leading and trailing nonblank characters; and changing the length of the field in the output record. For a complete description and options, see JFY Subparameter.

Use the SQZ subparameter to specify that an input field be processed for “left-squeezing” or “right-squeezing” for the output record. SQZ includes the justification functions of the JFY subparameter but adds elimination of all blank characters in the input field and additional options for selecting and replacing blank and nonblank characters, which include introducing leading and trailing nonblank characters; replacing userspecified nonblank characters with blank characters prior to squeeze operation; replacing blank characters with user-specified nonblank characters; retaining blank characters between paired apostrophes and paired quotes; and changing the length of the field in the output record. For a complete description and options, see SQZ Subparameter.

Use the HEX subparameter to convert a record field to its hexadecimal representation. Specify this subparameter immediately after the position p and the length l of the field to be converted. Specify p,l,HEX for both fixed-length records and the fixed-length portion of variable-length records. Specify p,HEX for the variable-length portion of variable-length records. Starting in position p of the input record, for a length of l, each byte will be converted to its hexadecimal representation. Note that in the reformatted record, the converted field will be twice the length of the original field.

For examples of OUTREC control statements that use the TRAN subparameter, see figures Sample OUTREC Control Statement and Sample OUTREC Control Statement.

yyyy/x

yyyy/x

yyyy/xx

x/yyyy

x/yyyy

xx/yyyy

X'yyyyxC'

X'yyyyxC'

X'0yyyyxxC'

X'xyyyyC'

X'0xxyyyyC'

X'xxxyyyyC'

X'0xxxxyyyyC'

X'xyyyyC'

X'0xxyyyyC'

X'yyyy'

X'yyyy'

yyyy/ddd

yyyy/mm/dd

ddd/yyyy

mm/dd/yyyy

yyyy/ddd

yyyy/mm/dd

ddd/yyyy

mm/dd/yyyy

C'yyddd'

C'yymmdd'

X'yyddds' (P'yyddd')

X'0yymmdds' (P'yymmdd')

C'dddyy'

C'mmddyy'

X'dddyys' (P'dddyy')

X'0mmddyys' (P'mmddyy')

C'yyyyddd'

C'yyyymmdd'

X'yyyyddds' (P'yyyyddd')

X'0yyyymmdds' (P'yyyymmdd')

C'dddyyyy'

C'mmddyyyy'

X'dddyyyys' (P'dddyyyy')

For TOJUL=f_oyxx(c)

Date Form

For TOGREG=f_oyxx(c)

Date Form

C'yycmmdd'

C'mmddcyy'

C'yyyymmdd'

C'yyyycmmdd'

C'mmddcyyyy'

DIGIT1