使用 "CEDA DEFINE FILE命令定义共享数据表

使用 CEDA DEFINE FILE 命令将文件定义为 CICS®维护的数据表或用户维护的数据表。

FILE 资源中提供了 FILE 定义的完整详细信息。 本主题中仅描述了与数据表相关的属性。

表 ({NO|CICS| USER | CF})
指定 TABLE(CICS) 以将文件定义为 CICS维护的数据表。

指定 TABLE(USER) 以将文件定义为用户维护的数据表。

如果未指定 TABLE 参数,或者未指定 TABLE(NO)TABLE(CF),那么该文件未定义为 CICS 共享数据表。

MAXNUMRECS (NOLIMIT|number)
指定可以包含在数据表中的最大记录数,范围为 1 到 99999999。 缺省情况是对最大记录数没有限制。
FILE (名称)
指定文件的名称。

对于 CICS维护的数据表,此名称用于同时引用数据表和源数据集, CICS将其视为单个实体。

对于用户维护的数据表,此名称仅用于引用数据表。

DSNAME (名称)
指定要用作源数据集的 VSAM KSDS 的名称。 这必须是基本数据集,而不是路径或备用索引数据集。 如果存在与源数据集关联的路径或备用索引,那么通过该文件对 CICS维护的数据表进行的任何更新都会反映在源数据集及其备用索引中。 对于用户维护的数据表,更新不会反映在源数据集或其备用索引中。 装入完成后,用户维护的数据表完全独立于其源数据集。
LSRPOOLID (编号 |1)
该属性已过时,但仍受支持,用于提供与 CICS 较早发行版的兼容性。
LSRPOOLNUM (数字 |1| NONE)
指定要由数据表使用的 VSAM 本地共享资源 (LSR) 池的编号。 必须指定范围在 1 到 255 之间的 LSRPOOL 编号。 缺省值为 1 ,除非为 NSRGROUP 属性指定了值,在这种情况下, LSRPOOLNUM 的缺省值为 NONE。
OPENTIME ({FIRSTREF| STARTUP})
指定自动启动的事务 CSFU 在首次引用时或在启动后立即打开文件的时间。 缺省情况下,假定为 OPENTIME(FIRSTREF)

请记住,打开文件时会装入数据表,因此如果您正在使用用户出口 XDTRD ,请确保在打开文件之前激活用户出口 (请参阅 激活数据表的用户出口)。

记录格式 ({V| F})
指定文件中记录的格式,"RECORDFORMAT(V)表示长度可变的记录,"RECORDFORMAT(F)表示长度固定的记录。

缺省情况下,假定为 RECORDFORMAT(V) 。 用户维护的数据表必须具有可变长度记录。

ADD (NO| YES) , BROWSE (NO| YES) , DELETE (NO| YES) , READ (YES| NO) 和 UPDATE (NO| YES)
指定可以为数据表请求的文件操作。
RECOVERY ({NONE| BACKOUTONLY | ALL})
指定数据表所需的恢复支持类型。 缺省值为 RECOVERY(NONE)

对于用户维护的数据表, CICS仅支持动态事务回退,因此 RECOVERY(BACKOUTONLY)RECOVERY(ALL) 具有相同的含义。

对于 CICS维护的数据表, RECOVERY 参数适用于源数据集; 它必须与同一数据集的任何其他文件定义一致。

用户维护的数据表的恢复属性独立于其源数据集可能具有的任何恢复属性。

定义用户维护的数据表时,通过指定 RECOVERY(NONE) (如果它将不可恢复) 或 RECOVERY(BACKOUTONLY|ALL) (如果它将在事务失败后可恢复) 来在文件定义上指定其恢复属性。

用户维护的数据表的源数据集可以是不可恢复的,只能用于回退 (在事务和系统故障之后) 或转发可恢复的,而不管您为用户维护的数据表指定了什么。

源数据集可以通过以下两种方法之一获取其恢复属性:
  • 在 ICF 目录中定义数据集的恢复属性(RLS 和非 RLS 模式文件均可实现)。
  • 使用另一个文件名,将数据集作为普通CICS文件访问,并在文件定义中指定恢复属性(这只适用于非 RLS 模式文件)。

CICS数据表定义示例

本例显示了CICS数据表的定义。 仅显示相关参数。

    File         ==> APPLE
    Group        ==> FRUIT
    DEscription  ==>
   VSAM PARAMETERS
    DSNAme       ==> CIC01.CICOWN.APPLES
    Password       :                    PASSWORD NOT SPECIFIED
    RLSACCESS    ==> NO                 YES|NO
    LSRPOOLId    ==> 1                  1-8 | None
    LSRPOOLNum   ==> 002                1-255 | None
    READINTEG    ==> UNCOMMITTED        UNCOMMITTED|CONSISTENT|REPEATABLE
    DSNSharing   ==> Allreqs            Allreqs | Modifyreqs
    STRings      ==> 005                1 - 255
    Nsrgroup     ==>
   REMOTE ATTRIBUTES
    REMOTESystem ==>
    REMOTEName   ==>
   REMOTE AND CFDATATABLE PARAMETERS
    RECORDSize   ==> 00080              1-32767
    Keylength    ==> 006                1-255 (1-16 For CF Datatable)
   INITIAL STATUS
    STAtus       ==> Enabled            Enabled | Disabled | Unenabled
    Opentime     ==> Startup            Firstref | Startup
    DIsposition  ==> Share              Share | Old
   BUFFERS
    DAtabuffers  ==> 00002              2 - 32767
    Indexbuffers ==> 00001              1 - 32767
   DATATABLE PARAMETERS
    TABLE        ==> CICS               No | Cics | User | CF
    Maxnumrecs   ==> 1000000            Nolimit  | 1-99999999
   CFDATATABLE PARAMETERS
    Cfdtpool     ==>
    TABLEName    ==>
    UPDATEModel  ==> Locking            Contention | Locking
    LOad         ==> No                 No | Yes
   DATA FORMAT
    RECORDFormat ==> F                  V | F
   OPERATIONS
    Add          ==> Yes                No | Yes
    BRowse       ==> No                 No | Yes
    DELete       ==> Yes                No | Yes
    REAd         ==> Yes                Yes | No
    Update       ==> Yes                No | Yes
   AUTO JOURNALING
    JOurnal      ==> No                 No | 1 - 99
    JNLRead      ==> None               None | Updateonly | Readonly | All
    JNLSYNCRead  ==> No                 No | Yes
    JNLUpdate    ==> No                 No | Yes
    JNLAdd       ==> None               None | Before | AFter |ALl
    JNLSYNCWrite ==> Yes                Yes | No
   RECOVERY PARAMETERS
    RECOVery     ==> All                None | Backoutonly | All
    Fwdrecovlog  ==> 10                 No | 1-99
    BAckuptype   ==> STAtic             STAtic | DYNamic
   SECURITY
    RESsecnum      : 00                 0-24 | Public

用户维护数据表定义示例

本例显示了用户维护数据表的定义。 仅显示相关参数。

    File         ==> COURGETT
    Group        ==> VEGS
    DEscription  ==>
   VSAM PARAMETERS
    DSNAme       ==> CIC02.CICOWN.COURGETT
    Password       :                    PASSWORD NOT SPECIFIED
    RLSACCESS    ==> NO                 YES|NO
    LSRPOOLId    ==> 1                  1-8 | None
    LSRPOOLNum   ==> 002                1-255 | None
    READINTEG    ==> UNCOMMITTED        UNCOMMITTED|CONSISTENT|REPEATABLE
    DSNSharing   ==> Allreqs            Allreqs | Modifyreqs
    STRings      ==> 005                1 - 255
    Nsrgroup     ==>
   REMOTE ATTRIBUTES
    REMOTESystem ==>
    REMOTEName   ==>
   REMOTE AND CFDATATABLE PARAMETERS
    RECORDSize   ==> 00080              1-32767
    Keylength    ==> 006                1-255 (1-16 For CF Datatable)
   INITIAL STATUS
    STAtus       ==> Enabled            Enabled | Disabled | Unenabled
    Opentime     ==> Firstref           Firstref | Startup
    DIsposition  ==> Share              Share | Old
   BUFFERS
    DAtabuffers  ==> 00002              2 - 32767
    Indexbuffers ==> 00001              1 - 32767
   DATATABLE PARAMETERS
    TABLE        ==> User               No | CIcs | User | CF
    Maxnumrecs   ==> 2000000            Nolimit | 1-99999999
   CFDATATABLE PARAMETERS
    Cfdtpool     ==>
    TABLEName    ==>
    UPDATEModel  ==> Locking            Contention | Locking
    LOad         ==> No                 No | Yes
   DATA FORMAT
    RECORDFormat ==> V                  V | F
   OPERATIONS
    Add          ==> Yes                No | Yes
    BRowse       ==> Yes                No | Yes
    DELete       ==> No                 No | Yes
    REAd         ==> Yes                Yes | No
    Update       ==> Yes                No | Yes
   AUTO JOURNALING
    JOurnal      ==> No                 No | 1 - 99
    JNLRead      ==> None               None | Updateonly | Readonly | All
    JNLSYNCRead  ==> No                 No | Yes
    JNLUpdate    ==> No                 No | Yes
    JNLAdd       ==> None               None | Before | AFter |ALl
    JNLSYNCWrite ==> Yes                Yes | No
   RECOVERY PARAMETERS
    RECOVery     ==> Backoutonly        None | Backoutonly | All
    Fwdrecovlog  ==> No                 No | 1-99
    BAckuptype   ==> STAtic             STAtic | DYNamic
   SECURITY
    RESsecnum      : 00                 0-24 | Public