使用 "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