Path to the directory containing multiple COBOL files.

Select Customize COBOL FD conversion options to customize how the COBOL FD is translated. If you do not select this checkbox, default translation settings are applied.

For more information, see Customization Options for COBOL File Descriptions.

Choose one of two options:

• Single File defines a single data file. This option is not applicable for remote connections.
• Collection of files defines a collection of data files to be described by one synonym.

Indicates the data retrieval type.

• One-time retrieval retrieves data once to create synonym for sequential file.
• File Listener provides continued retrieval.

Indicates how often the listener checks for the presence of a file in number of seconds. The default is 10 seconds.

Indicates the timeout interval for the listener in number of seconds. The default is 10 seconds.

Indicates the number of records processed within one request. This option is available for single file processing.

Indicates the number of files processed within one request. This option is available for processing collection of files. The default is 99,999,999.

Indicates the mechanism used by files agents to pick up files from their directories.

• IMMEDIATE processes the file as soon as it is detected.
• TRIGGER processes the file as soon as a trigger file is detected. This option requires an additional setting for the trigger file extension.

Indicates the extension of the trigger file. The trigger file extension is added to the full name of the file being listened for.

Indicates how the file is handled after it has been processed by a file agent.

• DELETE deletes the file.
• ARCHIVE copies the file with the timestamp to a specified directory defined in File Listener Archiving Directory option.
• KEEP keeps the files.

Defines the location where the data files will be archived when DISCARD strategy of ARCHIVE is used. This can be an application directory, a mapped application name, or a directory location on your file system.

When using a directory on a file system for local files, the name of the physical directory can be used.

When using a directory on a file system for remote data files, a directory relative to the initial directory can be used. For example, if your remote initial directory is /home/user1/apps, using sales will set the data files directory location to /home/user1/apps/sales.

Defines the location of data files for polling. This can be an application directory, a mapped application name, or a directory location on your file system.

When using a directory on a file system for local files, the name of the physical directory can be used.

When using a directory on a file system for remote data files, a directory relative to the initial directory can be used. For example, if your remote initial directory is /home/user1/apps, using sales sets the data files directory location to /home/user1/apps/sales.

Type a full name or a partial name with a wildcard symbol %. A full name returns just that entry. A name with a wildcard symbol may return many entries.

Type an extension with or without the wildcard symbol %.

Select the Validate checkbox if you wish to convert all special characters to underscores and perform a name check to prevent the use of reserved names. (This is accomplished by adding numbers to the names.) This parameter ensures that names adhere to specifications. See Validation for Special Characters and Reserved Words for more information.

When the Validate option is unchecked, only the following characters are converted to underscores: '-'; ' '; ' \'; '/'; ','; '$'. No checking is performed for names.

Select the Make unique checkbox if you wish to set the scope for field and group names to the entire synonym. This ensures that no duplicate names are used, even in different segments of the synonym. When this option is unchecked, the scope is the segment.

Indicates the name of the synonym.

Select an application directory. The default value is baseapp.

If you have tables with identical table names, assign a prefix or a suffix to distinguish them. For example, if you have identically named human resources and payroll tables, assign the prefix HR to distinguish the synonyms for the human resources tables. Note that the resulting synonym name cannot exceed 64 characters.

If all tables and views have unique names, leave the prefix and suffix fields blank.

To specify that this synonym should overwrite any earlier synonym with the same fully qualified name, select the Overwrite existing synonyms checkbox.

This option provides data portability between servers by enabling processing of data loaded in different encoding systems.

Click the Extended data format attributes checkbox to display the Codepage option.

In the input box provided, enter the code page of the stored data. Your entry is added to the Master File of the generated synonym.

Choose one of the following options from the dropdown menu:

• Fully qualified PDS name to indicate a partitioned data set on MVS.

  In the input boxes provided, type a PDS name preceded by // and a Member name containing the location of the COBOL FD source. If you wish, you can filter the member name using a wildcard character (%).

• Absolute HFS directory pathname to indicate a hierarchical file structure on USS.

  In the input boxes provided, type a Directory name to specify the HFS location that contains the COBOL FD and a File name and File extension. If you wish, you can filter the file and extension using a wildcard character (%).

Select the Validate checkbox if you wish to convert all special characters to underscores and perform a name check to prevent the use of reserved names. (This is accomplished by adding numbers to the names.) This parameter ensures that names adhere to specifications. See Validation for Special Characters and Reserved Words for more information.

When the Validate option is unchecked, only the following characters are converted to underscores: '-'; ' '; ' \'; '/'; ','; '$'. No checking is performed for names.

Select the Make unique checkbox if you wish to set the scope for field and group names to the entire synonym. This ensures that no duplicate names are used, even in different segments of the synonym. When this option is unchecked, the scope is the segment.

Select Customize COBOL FD conversion options to customize how the COBOL FD is translated. If you do not select the checkbox, default translation settings are applied.

For more information, see Customization Options for COBOL File Descriptions.

Select an application directory. The default value is baseapp.

If you have tables with identical table names, assign a prefix or a suffix to distinguish them. For example, if you have identically named human resources and payroll tables, assign the prefix HR to distinguish the synonyms for the human resources tables. Note that the resulting synonym name cannot exceed 64 characters.

If all tables and views have unique names, leave the prefix and suffix fields blank.

This option provides data portability between servers by enabling processing of data loaded in different encoding systems.

Click the Extended data format attributes checkbox to display the Codepage option.

In the input box provided, enter the code page of the stored data. Your entry is added to the Master File of the generated synonym.

To specify that this synonym should overwrite any earlier synonym with the same fully qualified name, select the Overwrite existing synonyms checkbox.

This column displays the name that is assigned to each synonym. To assign a different name, replace the displayed value.

Select files for which you wish to create synonyms:

• To select all files in the list, click the Select All button.
• To select specific files, select the corresponding checkboxes.

After choosing files, choose the corresponding data file name from the dropdown list.

Select this checkbox for Multiple Synonyms.

Is the path to multiple data files.

Defines the location of the data file.

From the dropdown menu select:

• Server side.
• Local machine.

Defines an absolute path to the data file on the server or a directory relative to the initial one. It includes the name of the data file.

Enter the path and file name or click the ellipsis (...) to select the file.

Click the ellipsis (...) to select the data file to be uploaded.

Select:

• Single File to define a single data file. This option is not applicable for remote connections.
• Collection of files to define a collection of data files to be described by one synonym.

Indicates the data retrieval type:

• One-time retrieval retrieves data once, to create a synonym for a sequential file.
• File Listener provides continual retrieval.

Defines a character or series of characters that indicate the separation between file records or data rows (for example, groups of delimited fields).

This attribute is reflected in the Access File as RDELIMITER.

Defines whether the string in the delimiter field is a printable string or a non-printable decimal character. Please note that a non-printable decimal character appears (translated) in the Access File as a hexadecimal value. If the delimiter is entered as hexadecimal, set this attribute to No.

Defines a character or series of characters that indicate the separation between file fields.

To use multiple characters, enter them together. For example, enter two slashes (//).

To use a tab character as a delimiter, enter the reserved word TAB.

Alternatively, you can enter hexadecimal values directly. For example, Linefeed and Carriage Return would be 0x0A and 0x0D, respectively.

If several characters form a separator, enter then as one string. For example, Linefeed and Carriage Return would be 0x0A0D.

Defines whether the string in the delimiter field is a printable string or a non-printable decimal character. Please note that the non-printable decimal character appears (translated) in the Access File as a hexadecimal value.

If the delimiter is entered as a hexadecimal value, set this attribute to No.

If this attribute is set to Yes, then the values in the Delimiter attribute should be entered as decimals. For example, for non-printable separators such as Linefeed, use the decimal value of 10. If several non-printable characters form a separator, use a space between the decimal values. For example, to use Linefeed and Carriage Return together, enter 10 or 13.

Select this checkbox to request that the names in the header line be used as column names in the synonym.

Specifies the number of rows above the header row that should be ignored when creating the synonym and reading the data.

If character columns are enclosed in quotation marks or another symbol, enter an enclosure symbol for the character column format used in the Delimited Files for which the synonyms are being generated. For example, for a file in which character columns are enclosed in double quotation marks, specify " in the Enclosure field.

Enter a value to indicate how many records from the DFIX data file to scan to determine the length of the columns.

If this parameter is omitted, all records from the file are processed to make this determination.

Indicates whether the original data layout, including empty records and linefeeds, will be preserved.

• No. The original characters are replaced by a printable string. This is the default.
• Yes. The original characters, including non-printable characters and linefeeds, will be preserved.

This attribute is reflected in the Access File as PRESERVEFRMT.

Indicates how often the listener checks for the presence of a file in number of seconds. The default is 10 seconds.

Indicates the timeout interval for the listener in number of seconds. The default is 10 seconds.

Indicates the number of files processed within one request. The default is 99,999,999.

Indicates the mechanism used by files agents to pick up files from their directories.

• IMMEDIATE processes the file as soon as it is detected.
• TRIGGER processes the file as soon as a trigger file is detected. This option requires an additional setting for the trigger file extension.

Indicates the extension of the trigger file. The trigger file extension is added to the full name of the file being listened for.

Indicates how the file is handled after it has been processed by a file agent.

• DELETE deletes the file.
• ARCHIVE copies the file with the timestamp to a specified directory defined in File Listener Archiving Directory option.
• KEEP keeps the files.

Archiving directory on the server where the data file will be archived. You can use an absolute path or a directory relative to the initial one.

Defines the location type of the data files. It can be a physical directory for local files or a directory relative to the initial directory for remote data files. For example, if your remote initial directory is /home/user1/apps, using sales in collection definition sets the data files location to /home/user1/apps/sales.

Type a full name or a partial name with a wildcard symbol %. A full name returns just that entry. A name with a wildcard symbol may return many entries.

Type an extension with or without the wildcard symbol %.

Select an application directory. The default value is baseapp.

If you have tables with identical table names, assign a prefix or a suffix to distinguish them. For example, if you have identically named human resources and payroll tables, assign the prefix HR to distinguish the synonyms for the human resources tables. Note that the resulting synonym name cannot exceed 64 characters.

If all tables and views have unique names, leave the prefix and suffix fields blank.

To specify that this synonym should overwrite any earlier synonym with the same fully qualified name, select the Overwrite existing synonyms checkbox.

This column displays the name that is assigned to each synonym. To assign a different name, replace the displayed value.

Select the checkboxes to left of Default Synonym Name to choose the files for which you want to create synonyms. The data files are highlighted when you choose the corresponding checkboxes.

Click Select All Files to select all the data files in the directory path.

This option provides data portability between servers by enabling processing of data loaded in different encoding systems.

Select the Extended data format attributes checkbox to display the Codepage option.

In the input box provided, enter the code page of the stored data. Your entry is added to the Master File of the generated synonym.

A tab character. This is the default.

A character string, for example ~.

A hex code. For example, 0x44 (a comma), or 0x0D0A (a return and a linefeed). The hex code uses ASCII for Windows or UNIX systems and EBCDIC for IBM Mainframes.