CICS FCT -fct_name(group_name)

Access Active, Display Active, Install Add Base Name Copy Dataset Name Delete Description Dump File Extension File Path Fileshare Server Format Group List Grp | Key Length Key Position LRECL Max LRECL Min Name Override File Name Remote File Remote SYSID Resource Keys, 1 - 24 Resource Keys, all Set Status Type Use Catalog

CICS FCT - fct_name (group_name)

  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.

  If you displayed this page by clicking New on a previous page, some values on this page are already set to default values.

  Top

Group List

  Click this to display the CICS Group group_name page.

  Top

Add

  Click this to save changes you have made to the page, refresh the page and add the new FCT to the group you specify in Grp. The button changes to Apply.

  Top

Name

  Specify a name for this FCT.

  Top

Grp

  Choose a group to which this FCT will belong. The list of groups from which you can choose include only those which can be edited by you.

  Top

Description

  Specify a description of the file (can be up to 60 characters).

  Top

Type

  Choose 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)

  You must uncheck Use Catalog before you can specify a file type. This is because if you use the catalog this information is stored there, not in the FCT entry.

  Top

Format

  Choose 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.

  Top

LRECL Min

  Specify 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 Max LRECL.

  For fixed length records, set this value equal to Max LRECL.

  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.

  Top

LRECL Max

  Specify 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 Min LRECL.

  For fixed length records, set this value equal to Min LRECL.

  Top

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.

  Top

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 Min LRECL.

  For files of type Undefined, specify the length of the record key, which must not be greater than Max LRECL.

  Top

Use Catalog

  Check this if you want to use the catalog to store information about the file. If you check this, certain parameters on this page become irrelevant; the description for each parameter indicates whether Use Catalog affects that parameter.

  Top

Base Name

  Specify 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.

  Top

Dataset Name

  Specify the data set name for this file as used on the mainframe. You must check Use Catalog before you can specify a data set name. This is because the catalog uses this information.

  Top

Status

  Choose 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.

  Top

Access

  Check one or more boxes to set the read/write permissions for the file. You can check:

  - Read - enables applications to read records from the file.
  - Add - enables applications to add records to the file.
  - Browse - enables applications to browse the file.
  - Delete - enables applications to delete records from the file.
  - Update - enables applications to update records in the file.
  - Exclusive - CICS Exclusive Control. Enables application to gain exclusive control of a record within a file.

  Top

Set

  Check one or more boxes to set various file parameters. You can select the following options:

  - 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.
  - 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.
  - 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.
  - 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.

  Top

Remote SYSID

  Specify the system ID of the remote system on which the file resides. 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.

  Top

Remote File

  Specify 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.

  Top

Override File Name

  Specify 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.

  Top

File Extension

  Specify 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.

  Top

File Path

  Specify the path of the physical file if you want to override the default. Do not include the filename or file extension. Can be up to 255 characters. 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.

  Top

Fileshare Server

  Specify the ID of the Fileshare server on which the file resides. Can be up to 16 characters. 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.

  Top

Resource Keys, all

  Choose a setting to apply to all the resource keys:

  - On - enables all the resource keys.
  - Off - disables all the resource keys.

  Top

Resource Keys, 1 - 24

  Check any of the boxes 1 through 24 to activate that resource key.

  Top

Active, Display

  Check this to display the currently installed definition of this resource.

  Top

Active, Install

  Check this to install (make active) this resource.

  Top

Delete

  Check this to delete this FCT. This button is displayed only after you click Add.

  Top

Copy

  Check this to create a new FCT, using the values set on this page as the basis for the new FCT. This button is displayed only after you click Add.

  Top

Dump

  Check this to create and view dump information for this FCT. This button is displayed only after you click Add.

  Top