Enter a directory name to display all members in the directory path.

If you wish to limit retrieval, you can enter a file name and/or file extension:

• In the File name box, enter 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.
• In the File extension box, enter an extension with or without the wildcard symbol %.

Type the name of the synonym.

Type the name of the IMS Transactions program or APPC transaction.

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.

Optionally, 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.

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 will be assigned to each synonym. To assign a different name, replace the displayed value.

Is the name of the COBOL FD file that contains information about input parameters.

There can be no more than one set of input COBOL Copybooks per synonym. You can choose the same Copybook or different Copybooks for input and output parameters.

Is the name of the COBOL FD file that contains information about output parameters.

There can be no more than one set of output Copybooks per synonym. You can choose the same Copybook or different Copybooks for input and output parameters.

Choose one of the following options from the drop-down list:

• 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 (%).

  or

• 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 (%).

• Applications to indicate a pre-configured HFS directory.

Type the name of the synonym.

Type the name of the IMS Transactions program or APPC transaction.

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.

Optionally, 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.

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 will be assigned to each synonym. To assign a different name, replace the displayed value.

Is the name of the COBOL FD file that contains information about input parameters.

There can be no more than one set of input COBOL Copybooks per synonym. You can choose the same Copybook or different Copybooks for input and output parameters.

Is the name of the COBOL FD file that contains information about output parameters.

There can be no more than one set of output Copybooks per synonym. You can choose the same Copybook or different Copybooks for input and output parameters.