// an association element property: fileName value: myFile01 // an entry, with multiple properties property: system value: aix property: fileType value: spool property: systemName value: employee // a second entry property: system value: win property: fileType value: seqws property: systemName value: c:\myProduct\myFile.txt
The file name must be a valid name, an asterisk, or the beginning of a valid name followed by an asterisk. The asterisk is the wildcard equivalent of one or more characters and provides a way to identify a set of names. For example, an association element that includes the following value for a file name pertains to any file name that begins with the letters myFile:
myFile*
If multiple elements are valid for a file name used in your program, EGL uses the first element that applies. For example, a series of association elements might be characterized by the following values for a file name, in order:
myFile myFile* *
Consider the element associated with the last value, where the value of the file name is only an asterisk. Such an element could apply to any file; but in relation to a particular file, the last element applies only if the previous elements do not. For example, if your program references myFile01, the linkage specified in the second element supersedes the third element to define how the reference is handled.
any
For example, if you are generating for AIX, EGL uses the first entry that refers to aix or to any.
A file type determines what properties are necessary for a given entry in an association element. The next table describes the EGL file types.
File type | Description |
---|---|
gsam | A serial or print file that is associated with a GSAM database. |
ibmcobol | A serial, indexed, or relative file. ibmcobol is supported by the EGL debugger when running on Windows or for Java™ code generated for Windows to provide access to remote VSAM files located on z/OS®. ibmcobol is also supported by Java code generated for AIX to provide access to local files. ibmcobol is not supported by the EGL debugger when running on Linux®, nor for Java code generated for any runtime environment other than Windows or AIX. |
mmsgq | A serial file associated with a multi-segment message queue. |
mq | An WebSphere® MQ message queue; for details on how to work with such a queue, see your WebSphere MQ documentation. |
seq | A serial file accessed by a COBOL program that
runs on z/OS under the control
of JCL (not under CICS®) or
runs on iSeries®. This type
of file is accessed by COBOL READ/WRITE statements. On z/OS, access of the data set is faster than
if you specify seqrs as the file type. When seq is specified, however,
these restrictions are in effect:
|
seqrs | A serial file accessed by a COBOL program that
runs on z/OS under the control
of JCL (not under CICS). This
type of file is accessed by the EGL runtime. File access is slower
than if you specify seq as the file type, but you have greater flexibility:
|
seqws | A serial file accessed by an EGL-generated Java program. |
smsgq | A serial or print file associated with a single-segment message queue. |
spool | A spool file on AIX, CICS, or Linux. |
tempaux | A CICS auxiliary temporary storage queue. |
tempmain | A CICS main temporary storage queue. |
transient | A CICS transient data queue. |
vsam | On iSeries,
this is an emulated VSAM file accessed by an EGL-generated COBOL program. On z/OS batch, this is a VSAM data
set accessed by an EGL-generated COBOL program. This type of data
set is accessed by COBOL READ/WRITE statements, and access of the
data set is faster than if you specify vsamrs as the file type. When
vsam is specified, however, these restrictions are in effect:
On CICS, this is
a VSAM data set accessed by an EGL-generated COBOL program. This
type of data set is accessed by EXEC CICS commands.
On CICS you can do the following:
|
vsamrs | For z/OS batch,
a VSAM data set accessed by an EGL-generated COBOL program. This type
of file is accessed by the EGL runtime. File access is slower than
if you specify vsam as the file type, but you have greater flexibility:
|
Target runtime environment | IndexedRecord | RelativeRecord | SerialRecord |
---|---|---|---|
Java generation |
|
|
|
IMS/VS | n/a | n/a |
|
IMS™ BMP |
|
|
|
iSeries COBOL |
|
|
|
z/OS batch |
|
|
|
z/OS CICS |
|
|
|
Debug |
|
|
|