FCT

Use this page to create a new FCT.

If you displayed this page by clicking COPY on a previous page, the values on the previous page are used as the basis for the new FCT.

To display the currently installed definition of this resource, click ACTIVE.

To install and make this resource active, click INSTALL.

To delete this FCT, click DELETE.

To create a new FCT, using the values set on this page as the basis for the new FCT, click COPY.

To create and view dump information for this FCT, click DUMP.

Name
The name for this resource.
Group
The group to which this FCT will belong. The list of groups from which you can choose includes only those which can be edited by you.
Description
A description of the resource, which can be up to 60 characters long.
Status
Specifies whether the file is accessible to transactions at system startup:
Enable
The file is accessible to transactions at system startup.
Disable
The file is not accessible to transactions at system startup. A disabled file returns the reference "DISABLED". This can cause problems for some applications; if this is true for your application, set Unenable instead.
Unenable
The file is not accessible to transactions at system startup. An unenabled file returns a reference "NOTOPEN", which can be handled by those applications that cannot handle a "DISABLED" reference.
The value set by this control is ignored if the file resides on a remote system.
Read Access
If checked, enables applications to read records from the file.
Add Access
If checked, enables applications to add records to the file.
Browse Access
If checked, enables applications to browse the file.
Delete Access
If checked, enables applications to delete records from the file.
Update Access
If checked, enables applications to update records in the file.
Exclusive Access
If checked, the CICS Exclusive Control enables the application to gain exclusive control of a record within a file.
Start Open
Check this to indicate that the file is to be opened at system startup. If you want the file to be opened at system startup and accessible to transactions, you must also select Enabled in the Status select box.
Start Empty
Check this to indicate that the current contents of the file are to be deleted at system startup.
Allow Duplicate Keys
Check this if the file can have duplicate keys. The file must be an alternate index (Type set to Alt index) and you must have unchecked Use Catalog, because if you use the catalog this information is stored there, not in the FCT entry.
Backward Recovery
Check this to indicate that the file is a protected resource, changes to which can be backed out. The file must be accessed through a Fileshare server.
Forward Recovery
Check this to indicate that journals are to be used to record changes to the file to enable forward recovery. The file must be accessed through a Fileshare server.
EBCDIC Collating Sequence
Check this to indicate that the EBCDIC collating sequence is to be used for this file. You must uncheck Use Catalog before you can check this, because if you use the catalog this information is stored there, not in the FCT entry.
Use Catalog
Check this if you want to use the catalog to store information about the file. If you check this, certain options on this page become irrelevant; the description for each parameter indicates whether Use Catalog affects that parameter.
Dataset Name
The dataset name for this file as used on the mainframe.
Note: You must check Use Catalog to display the Dataset Name field.
Remote SysID
The system ID of the remote system on which the file resides, specify the 4-character, remote system identifier (as defined in the TCT). If the program resides in the local region, leave this field blank. The name specified must be the same as that given in Name in the SysC or Sys62 definition. You must uncheck Use Catalog before you can specify a system ID for the remote system, this is because the catalog is used only for storing information about files held locally.
Remote File
The name of the file on the remote system. You must uncheck Use Catalog before you can specify a name for a remote file, this is because the catalog is used only for storing information about files held locally.
FCT Type
The file type:
KSDS
Key sequence data set.
ESDS
Entry sequence data set.
RRDS
Relative record data set.
Alt Index
Alternate index.
Undefined
Remote file (Specify the System ID on the Remote page).
Base Name
The base filename for an alternate index. CICS references alternate indexes by a user-assigned name. This connects the alternate index definition to the base file.
File Path
The path of the physical file if you want to override the default. Do not include the filename or file extension. This can be up to 255 characters long. You must uncheck Use Catalog before you can specify a path, this is because if you use the catalog this information is stored there, not in the FCT entry.
File Name Override
The filename of the physical file if you want to override the default. Do not include the file extension. Can be up to 255 characters. If you do not specify this entry, the physical file name defaults to the name of the FCT entry. You cannot use this default if you specify a Fileshare server; you must specify a physical file name. You must uncheck Use Catalog before you can specify a filename, this is because if you use the catalog this information is stored there, not in the FCT entry.
Path Extension
The file extension of the physical file if you want to override the default. Can be up to 3 characters. You must uncheck Use Catalog before you can specify an extension, this is because if you use the catalog this information is not required.
Format
The format for the file. You must uncheck Use Catalog before you can choose a file format, this is because if you use the catalog this information is stored there, not in the FCT entry.
LRECL Min
The minimum logical record length of the file, in bytes, in the range 1 through 32767. This must not be greater than the value of LRECL Max. For fixed length records, set this value equal to LRECL Max. You must uncheck Use Catalog before you can specify a minimum logical record length, this is because if you use the catalog this information is stored there, not in the FCT entry.
LRECL Max
The maximum logical record length of the file, in bytes in the range 1 through 32767. This must not be less than the value of LRECL Min. For fixed length records, set this value equal to LRECL Min.
Key Position
For files of type KSDS or ALT, specify the byte number at which the record key begins in the range 1 through 32767. Bytes are numbered from 1.
Key Length
For files of type KSDS or ALT, specify the length of the record key in bytes (within the range 1 through 32767). The value Key Position + Key Length -1 must not be greater than LRECL Min.
Fileshare Server
The ID of the Fileshare server on which the file resides. This can be up to 16 characters long. You must uncheck Use Catalog before you can specify a Fileshare server, this is because if you use the catalog this information is stored there, not in the FCT entry.