Association elements

As described in the topic "Resource associations part," the resource associations part is composed of association elements. Each element is specific to a file name (identified by the fileName property) and contains a set of entries, each with the following properties:
The values of the system and fileType properties determine what additional properties are available to you from the following list: You can find more information on cross-referencing record and file types in the topic File types.

conversionTable

Specifies the name of the conversion table used by a generated Java™ program during access of an WebSphere® MQ message queue.

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. See Resource associations part for more details on using the asterisk as a wild card.

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 fileType property. Use of the default means that a file type is selected automatically:
  • For a particular combination of target system and EGL record type.
  • For print output, when the file name is printer.

To find information on fileType values, along with defaults, refer to the table in the section "Valid file types of target runtime environment" of the topic Resource associations part.

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, linix, 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 fileType of the file is seqws.
Select one of these values:
NO (the default)
Append to the file.
YES
Replace the file. The first add statement for the serial file in the program, or the first add statement for the serial file after a close statement, adds the data to the beginning of the serial file, replacing all the previous contents.

system

Specifies the target platform. Select one of the following values:
aix
AIX®
imsbmp
IMS™ BMP
imsvs
IMS/VS
hpux
HP-UX
iseriesj
iSeries®Java
linux
Linux® (Intel® hardware)
solaris
Solaris
uss
z/OS®UNIX® System Services
win
Windows® 2000/NT/XP
zlinux
Linux (zSeries® hardware)
zosbatch
z/OS batch
zoscics
CICS® for z/OS
any
Any target platform

systemName

The systemName property specifies the system resource name of the file or data set associated with the EGL file name. Enclose the name in single or double quote marks if it contains a space or any of the following characters:
  % = , ( ) /

The value of the systemName property depends on the values of the system and fileType properties, as described in the following sections. To see this information in table form, see Record and file type cross-reference.

You can dynamically change the value of systemName at runtime by setting one of the following system variables:
  • For serial, indexed, relative, or WebSphere MQ records, set the recordName.resourceAssociation variable. EGL uses the systemName property to initialize the value of the recordName.resourceAssociation. When there is I/O for a record and the recordName.resourceAssociation has been changed, EGL automatically closes the previously opened file before opening the file in recordName.resourceAssociation.
  • For print output, set the converseVar.printerAssociation variable. EGL uses the systemName property to initialize the value of converseVar.printerAssociation. For certain runtime environments and file types, multiple print files can be open simultaneously.

systemName for debugging

The debugger runs only in the Windows and Linux environments. Therefore you must set the system property to either win or linux, depending the platform where you are running the debugger, and set the fileType and systemName properties accordingly.

systemName in Java environments

The following sections describe the possible values for systemName in various Java environments.

systemName for AIX

When the system property is set to aix, the following values are available for the fileType property:
seqws
The value of the systemName property is the name of a file that is associated with an EGL serial record.
spool
The value of the systemName property is set to the name of a printer or the path to a spool file associated with an EGL print file. The default value for systemName is the default printer for the system.

systemName for iSeries Java

When the system property is set to iseriesj, the following values are available for the fileType property:
mq
The value of the systemName property is the name of a WebSphere MQ message queue associated with an EGL MQRecord. The default value is the EGL queue name. The value of systemName is in the form of either queueName or queueManagerName:queueName. If the systemName is queueName, EGL connects to the default queue manager.
seqws
The value of the systemName property is the name of a file that is associated with an EGL serial record.
spool
The value of the systemName property is set to the name of a printer or the path to a spool file associated with an EGL print file. The default value for systemName is the default printer for the system.

systemName for Windows

When the system property is set to win, the following values are available for the fileType property:
seqws
The value of the systemName property is the name of a file that is associated with an EGL serial record.

systemName for other Java platforms

The following values of the system property all have the same possible values for the fileType property:
  • hpux
  • linux
  • solaris
  • uss
  • zlinux

For any of these system values, the following values are available for the fileType property:

mq
The value of the systemName property is the name of an WebSphere MQ message queue associated with an EGL MQRecord. The default value is the EGL queue name. The value of systemName is in the form of either queueName or queueManagerName:queueName. If the systemName is queueName, EGL connects to the default queue manager.
seqws
The value of the systemName property is the name of a file that is associated with an EGL serial record.
spool
The value of the systemName property is set to the name of a printer or the path to a spool file associated with an EGL print file. The default value for systemName is the default printer for the system.

text

When accessing a file by means of a serial record, the text property specifies whether a generated Java program should do the following :
  • Append end-of-line characters during the add operation. On non-UNIX platforms, those characters are a carriage return and line feed; on UNIX platforms, the only character is a line feed.
  • Remove end-of-line characters during the get next operation.
Select one of these values:
NO (the default)
Do not append or remove the end-of-line characters.
YES
Make the changes. This is useful if the generated program exchanges data with products that expect records to end with the end-of-line characters.

Feedback