Defining Cobol or PL/1 files

You can define ACL tables from Cobol copybook files or PL/1 files. Both types of files store field formatting information in an external file, separate from the data file. ACL uses the formatting information to create an ACL table layout and reads data directly from the data file.

To define an ACL table from a Cobol or PL/1 external definition file:

  1. Select File > New > Table.

    The first page displayed in the Data Definition Wizard depends on your configuration. If integration with ACL Server is enabled the Select Platform for Data Source page is displayed, otherwise the Select Local Data Source page is displayed.

  2. If the Select Platform for Data Source page is displayed, select Local and click Next.
  3. In the Select Local Data Source page, select External Definition and click Next.
  4. In the Select External Definition Source page, select Cobol or PL/1, as appropriate, and click Next.
  5. In the Select External Definition(s) page, complete the following steps:
    1. Do one of the following:
      • Select an existing definition file or data set from the External Definition drop-down list.

      • Click Browse, locate the definition file or data set in the Select File to Convert dialog box, and click Open.

    2. Complete one of the following steps to select either a single definition or multiple definitions:
      • Add an individual definition to the Selected Definitions list by selecting the definition in the Available Definitions list and clicking the right-arrow button, or by double-clicking the definition in the Available Definitions list.

      • Add multiple definitions by selecting the Do you want to concatenate multiple selected file definitions? checkbox, and then select each definition to add and click the right-arrow button, or click Add all to add all of the definitions listed in the Available Definitions list.

    3. Click Next.
  6. In the Select Conversion Properties page, select either or both of the following properties, as necessary, and click Next.
    • Remove leading file indicator from field names – If a prefix is specified before each field name, it will be removed from the field name added to the ACL table layout. For example, Test-Field1 would have the prefix Test- removed.

      If this checkbox is not selected, any prefix values identified will be included in the field name with the hyphen converted to an underscore (i.e. Test-Field1 will be added as Test_Field1).

    • IBM Variable Length – If the data file being processed is an IBM variable length file, the record length is not specified in the ACL table layout.

  7. In the Final page, verify the settings for the new ACL table and click Finish.
  8. Enter a name for the ACL table you are adding to your project and click OK.
  9. If the associated data file is not found, you will be prompted for the file location. Complete the following steps to locate the file:
    1. If the Select file location dialog box is displayed select Client to select a file that is accessible from your computer, or select Server and select the server profile to use to access a server file, and click OK.
    2. In the Select file dialog box, locate and select the data file and click Open.

(C) 2015 ACL Services Ltd. All Rights Reserved.