Keywords › Keyword Descriptions › LAYOUTFILEN

LAYOUTFILEN

The LAYOUTFILEN keyword points to the copybook used to resolve field names on the NEW file during COMPARE processing. CA File Master Plus accepts COBOL or PL/I copybooks. These copybooks must already be defined before referencing them with this keyword. The copybooks can be a member in a PDS, or a member in either a CA Panvalet or a CA Librarian library. The default value for this keyword is the ddname LAYOUTN. Only one LAYOUTFILEN keyword is allowed per command. If LAYOUTFILEN is not present, and no LAYOUTN DD statement is coded in the JCL, the old file layout is used.

Syntax

LAYOUTFILEN({LAYOUTN|dsname(member)|ddname})

Parameters

LAYOUTFILEN supports the following parameters:

dsname(member)

Identifies the data set name and required member that contain the record formatting criteria. This is dynamically allocated. No JCL is needed to reference this dsname.

ddname

Functions like the dsname except the ddname refers to the job step's JCL ddname that contains the data set name and member.

Example

The copybook that is used for the OLD file during the execution of the COMPARE command is in CUSTOMER.COPYLIB(CPYBOOK). The copybook that is used for the NEW file during the execution of the COMPARE command is in CUSTOMER.NEW.COPYLIB(CPYBOOK). OLD_KEY_FIELD and OLD_FIELD_NAME are resolved by looking in the LAYOUTFILE copybook, and NEW_KEY_FIELD and NEW_FIELD_NAME are resolved by looking in the LAYOUTFILEN copybook. The compare report uses both copybooks to map the data.

COMPARE,
  LAYOUTFILE(CUSTOMER.COPYLIB(CPYBOOK)),
  LAYOUTFILEN(CUSTOMER.NEW.COPYLIB(CPYBOOK)),
  FORMAT(SINGLE),
  SYNCKEY(OLD_KEY_FIELD,NEW_KEY_FIELD),
  POSITION(OLD_FIELD_NAME,NEW_FIELD_NAME)