Keywords › Keyword Descriptions › LAYOUTFILEN

LAYOUTFILEN

The LAYOUTFILEN keyword points to the COBOL or PL/I copybook used to resolve field names on the NEW file during COMPARE processing. Copybooks must already be defined before referencing them with this keyword. The default value for this keyword is the ddname LAYOUTN. You can use this keyword once 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 contains the copybook. This data set 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)