Association elements

As described in Resource associations, the resource associations part is composed of association elements. Each element is specific to a file name (property fileName) and contains a set of entries, each with these properties:

The values of the system and fileType properties determine what additional properties are available to you from the following list:

commit

Indicates (for an EGL-generated Java program on iSeries) whether to enable commitment control.

Select one of these values:

NO (the default): Use of sysLib.commit or sysLib.rollback has no effect.
YES: You can use sysLib.commit and sysLib.rollback to define the end of a logical unit of work.

conversionTable

Specifies the name of the conversion table used by a generated Java program during access of an MQSeries message queue.

For additional information, see Data conversion.

fileType

Specifies the file organization on the target system. You can select an explicit type like seqws. Alternatively, you can select the value default, which is itself the default value of the property fileType. Use of the default means that a file type is selected automatically:

For a particular combination of target system and EGL record type; or
For print output, when the file name is printer.

Record and file type cross-reference shows the explicit fileType values, as well as the value used if you select default.

fileName

Refers to a logical file name, as specified in one or more records. You are creating an association element that relates this name to a physical resource on one or more target systems. (For print output, specify the value printer.)

You can use an asterisk (*) as a global substitution character in a logical file name; however, that character is valid only as the last character. For details, see Resource associations and file types.

formFeedOnClose

Indicates whether a form feed is issued when the output of a print form ends. (A print form is produced when your code issues a print statement.)

This property is available only if the fileName value is printer in one of the following cases:

The system value is aix, iSeriesj, or linux, and the fileType value is seqws or spool; or
The system value is win, and the fileType value is seqws.

Select one of these values:

YES: A form feed occurs (the default)
NO: A form feed does not occur

replace

Specifies whether adding a record to the file replaces the file rather than appending to the file. This entry is used only in these cases:

You are generating Java code; and
The record is of file type seqws.

Select one of these values:

NO: Append to the file (the default)
YES: Replace the file

system

Specifies the target platform. Select one of the following values:

aix: AIX
iseriesj: iSeries
linux: Linux
win: Windows 2000/NT/XP
any: Any target platform; for details, see Resource associations and file types

systemName

Specifies the system resource name of the file or data set associated with the file name. Enclose the value in single or double quote marks if a space or any of the following characters is in the value:

  % = , ( ) /

text

Specifies whether to cause a generated Java program to do the following when accessing a file by way of a serial record:

Append end-of-line characters during the add operation. On non-UNIX platforms, those characters are a carriage return and linefeed; on UNIX platforms, the only character is a linefeed.
Remove end-of-line characters during the get or get next operation.

Select one of these values:

NO: The default is not to append or remove the end-of-line characters
YES: Make the changes, as is useful if the generated program is exchanging data with products that expect records to end with the end-of-line characters

Related concepts
Resource associations and file types