Configuring a file manager

In TXSeries®, queues created and accessed as a part of the region residing in the file manager. The topic explains the procedure on how to create a region or modify an existing region to use SFS, DB2® or Oracle as the file manager.

Ensure that you have installed TXSeries and the associated database if SFS is not used as a file manager. You also need to have a basic understanding of TXSeries on aspects such as the file manager and region.

The file manager controls the administration of files that holds your data, and queues that pass data and information on the state of the TXSeries system. A file manager in TXSeries can be an SFS, an IBM® DB2 database, or an Oracle database. You can configure the region to access the database as a file manager, either locally or remotely.

Files need to be created in the file manager for applications defined in TXSeries region. This is to use the FILE APIs of CICS, such as EXEC CICS WRITE FILE and EXEC CICS READ FILE from applications. These user created files must be created on the file manager configured on the region. You can do this using either of the following methods:
  • Interactive method - This method is used for one time creation of files in file manager.
  • Schema file definitions - This method is best for repeated use of files with the same characteristics.

See topic Adding files to the file manager for more information.

Configure the DB2 or Oracle for use with TXSeries before your application programs can use data in DB2 or Oracle. When working with an existing TXSeries region, you might need to move file and queue management between DB2, SFS, and Oracle.

Note: When Oracle or DB2 is used to manage TXSeries queue and user files (as a file manager), it handles all files as recoverable, regardless of the value that is set in the File Definition (FD.stanza) for the RecoverStatus attribute.