FCT - File Control Table

This tables specifies the datasets to be used in the application.

To define an entry in this table the directive define dataset is used.

define dataset

Defines a file entry (dataset) in the XCICS/TS File Control Table (FCT).

define dataset

name=<value>,
cluster=<value>,
catalog=<value>,
[sysid=<value>],
[mode=(updt|rr..)],
[logging=(on|off)],
[alternate],
[immediate],
[record_size=<value>],
[key_length<value>],
[key_offset=<value>],
[converter_function=<function>, converter_lib=<library>];

name

Name used in the application program when referring to such a file.

cluster

Name of the associated cluster entry in the XVSAM catalog.

alternate

This flag specifies if the dataset is a secondary index - Y - or a primary cluster - N -.

catalog

This is the name of the XVSAM catalog containing the specified cluster.

sysid

This parameter identifies the remote system that holds the file. It can be up to 4 characters long and it must correspond to one of the SYSIDs parameter defined in the Connection Control Table.

mode

The Open mode of the dataset or SYSID must be specified. The following modes are allowed:

•

Update

•	Exclusive update

•

Load mode

•	Exclusive protected retrieval

•	Protected retrieval

•	Protected retrieval reverse

•	Exclusive retrieval

•	Exclusive retrieval reverse

•	Extended load

logging

If set to "on", the file is put under XVSAM transactional control, and all updates are tracked in the XVSAM recovery system. This means that transactional data integrity is preserved on this file and after image processing is also possible.

If set to "off", the file is directly updated without any transactional control. No after image is available. When logging is set to "off" the file is also set in "immediate" mode by default.

immediate

if specified, the file does not partecipate to the LUW (logical-unit-of-work), and it is therefore updated directly when the update command is issued, without waiting for the LUW completion.

record_length

This parameter specifies the record length of the file and must be provided only for remote files that must be dynamically converted.

key_length

This parameter specifies the key length of the file and must be provided only for remote files that must be dynamically converted.

key_offset

This parameter specifies the key offset of the file and must be provided only for remote files that must be dynamically converted.

converter_function

If specified, the specified routine is dynamically invoked by XCICS when the file is accessed on or by a mainframe system running IBM CICS/TS, to translate the commarea to and from EBCDIC. The routine must conform the XCICS dynamic conversion specs as documented in the XCICS Customization Guide.

converter_lib

specifies the name of the shared library containing the converter routine.