Derivation: RECord PADding

RECPAD specifies whether a formatted input record is padded with blanks.

Non-CICS default

RECPAD=((OFF),OVR)

CICS® default

RECPAD is ignored under CICS.

Syntax

                    .-OFF--.        .-OVR----.      
>>-RECPAD--=--(--(--+-ON---+--)--,--+-NONOVR-+--)--------------><
                    +-NONE-+                        
                    +-ALL--+                        
                    '-VAR--'                        

OFF|NONE

Specifies that no blank padding be applied when an input list and format specification requires more data from an input record than the record contains. If more data are required, the error described by condition FOR1002 is detected.

ON|ALL

Specifies that a formatted input record within an internal file, or a varying or undefined length record (RECFM=U or V) external file, be padded with blanks when an input list and format specification require more data from the record than the record contains. Blanks added for padding are interpreted as though the input record actually contains blanks in those fields.

VAR

Applies blank padding to any of the following types of files:

• An external, non-VSAM file with a record format (the RECFM value) that allows the lengths of records to differ within the file. Such record formats are variable (V), variable blocked (VB), undefined (U), variable spanned (VS), and variable blocked spanned (VBS); this excludes fixed (F), fixed blocked (FB), and fixed blocked standard (FBS).
• An external, VSAM entry-sequenced data set (ESDS) or key-sequenced data set (KSDS).
• An internal file.

OVR

Specifies that the option can be overridden.

NONOVR

Specifies that the option cannot be overridden.

Usage notes

• NORECPAD has the same effect as RECPAD(OFF) and RECPAD(NONE). RECPAD has the same effect as RECPAD(ON) and RECPAD(ALL).
• The PAD specifier of the OPEN statement can be used to indicate padding for individual files.