文件定义 - FILEDEF

文件定义（FILEDEF）视图显示有关文件定义的物理和操作特征的信息。

提供的视图

要从主菜单访问，请单击:

管理视图 > CICS 资源定义 > 文件定义

表 1. 提供的 文件定义 (FILEDEF) 视图集中的视图
视图 注
文件定义

EYUSTARTFILEDEF.ADDTOGRP

 向资源组添加一个或多个文件定义。
文件定义

EYUSTARTFILEDEF.CREATE

 创建文件定义并将其添加到数据存储库。
文件定义

EYUSTARTFILEDEF.DETAILED

 有关所选文件定义的详细信息。
文件定义

EYUSTARTFILEDEF.INSTALL

 在活动系统中安装文件定义。
文件定义

EYUSTARTFILEDEF.REMOVE

 从数据存储库中除去文件定义。
文件定义

EYUSTARTFILEDEF.TABULAR

 有关当前上下文中所有文件定义的表格化信息。

操作

表 2。 FILEDEF 视图可用的操作
操作 描述
地址 TOGRP 向资源组添加一个或多个文件定义。
创建 创建文件定义并将其添加到数据存储库。
CSDCOPY 复制 CICS CSD 资源定义。
CSDInstall 在活动系统中安装 CICS CSD 资源定义。
INSTALL 在活动系统中安装文件定义。
移除 从数据存储库中除去文件定义。
UPDATE 更新数据存储库中的文件定义。

字段

表 3。 FILEDEF 视图中的字段
字段 属性名 描述
文件访问方法 访问 指出该文件的访问方法（仅限于 OS/2 的 CICS）。 值包括：
  • ESDS
  • KSDS
  • RRDS
  • 键盘
  • BDAM
  • VSAM
  • NOTAPPLIC
添加选项 ADD 指定是否将记录添加到文件。
CICS VSAM 文件备份类型 BACKUPTYPE 可以将 CICS VSAM 文件定义为在打开供更新时进行备份。 可能的值为：
  • DYNAMIC - 指定该值并指定 RECOVERY 属性为 ALL，可以使文件在打开以进行更新时进行备份。
  • STATIC - 此文件在打开以进行更新期间不可进行备份。
基本数据集名称 basename 当与文件关联的对象为路径时，是与 VSAM 路径关联的 44 个字符的基本集群名称。 如果该对象不是路径，那么该选项返回与 DSNAME 选项相同的值。 （仅限 CICS for OS/2）
浏览选项 BROWSE 指定是否能从文件连续检索记录。
VSAM 目录名称 CATNAME VSAM 目录的名称。
执行上次修改的代理程序 CHANGEAGENT 执行上次修改的更改代理程序标识。
  • DREPAPI - 资源上次是由 CICSPlex SM API 命令更改的。
执行上次修改的代理程序发行版 CHANGEAGREL 执行上次修改的代理程序的 CICS 发行版级别。
上次修改时间 CHANGETIME 上次更改定义的本地日期和时间。
执行上次修改的用户标识 CHANGEUSRID 执行上次修改的用户标识。
控制区间大小 CNTLINTRVAL 控制区间大小的最后一个值，以字节表示。 （仅限 CICS for OS/2）
创建时间 CREATETIME 创建定义的本地日期和时间。
CSD 组 CSDGROUP 针对该 CICS 资源定义的 CSD 组的名称。 BAS 定义会忽略该字段。
数据缓冲区数目 DATABUFFERS 用于数据的缓冲区数目。 使用 2（缺省值）到 32767 范围内的值。 您可以指定的最小值大于在 STRINGS 属性中定义的字符串数。 如果将该字段留空，那么 CICSPlex SM 在有缺省值的情况下，会对 CICS 环境使用缺省值。
版本 DEFVER BAS 资源定义的版本号，范围为 1 到 15。 CICS CSD 资源定义会忽略该字段。
删除选项 DELETE 指定是否可从文件删除记录。
描述代码页 DESCCODEPAGE 描述字段的代码页。 CICS CSD 资源定义会忽略该字段。
描述 描述 文件定义的描述。
文件的处置 DISPOSITION 此文件的处置:
  • OLD-相当于 JCL 中的 DISP=OLD 参数。
  • SHARE - 等同于 JCL 中的 DISP=SHR 参数。
数据集名称 DSNAME 该文件使用的数据集名称（操作系统已知的名称）。 DSNAME 可以为 1 到 44 个字符，符合 MVS 数据集名称的规则。
VSAM 数据集名共享 DSNSHARING 指定是否将 VSAM 数据集名称共享用于 VSAM 文件。 可能的值包括：
  • ALLREQS - 打开文件时在 ACB 中设置数据集名称共享功能，因此将其用于所有文件请求。
  • MODIFYREQS - 仅当对文件设置了 DELETE、ADD 或 UPDATE 操作时，才会在打开文件时在 ACB 中设置数据集名称共享功能。
使用外部文件管理器 扩展文件管理器 指定是否使用外部文件管理器。 （仅限 CICS for OS/2）
访问方法 文件访问 针对该文件的访问方法（仅限 CICS for OS/2）。 值包括：
  • O
  • R
  • U
文件启用状态 已启用文件 指出事务是否可以访问文件（仅限 CICS for OS/2）。 值包括：
  • Y-已启用-该文件可供事务使用，如果已关闭，那么将在第一个请求时打开该文件。
  • U-未启用-该文件不可供事务使用，但当前正在使用该文件的事务除外。 如果存在任何此类用户，那么还会显示“BEING CLOSED”。 该状态与 DISABLED 相同，只不过它是在请求 SET FILE CLOSE 时隐式出现。 文件已通过 SET FILE OPEN 命令隐式启用。
  • N-已禁用-该文件不可供事务使用，但当前正在使用该文件的事务除外。
文件打开的状态 fileOpen 文件的打开状态（仅限 CICS for OS/2）。 值包括：
  • Y-文件已打开。
  • N-文件已关闭。
数据集类型 文件类型 数据集类型（仅限 CICS for OS/2）。 值包括：
  • A
  • E- 标准 ESDS
  • K-KSDS
  • R-RRDS
文件段定义名称 FSEGDEFNAME 1 到 8 个字符的文件键段定义的名称（仅限 CICS for OS/2）
文件段定义版本 Fsegdefver （可选） 范围为 1 到 15 的整数。 为 CICSPlex SM 指定 0 或留空，以分配范围为 1 到 15 范围的第一个可用版本标识。 （仅限 CICS for OS/2）
用于正向恢复的日志数 FWDRECOVLOG 与用于正向恢复的 MVS 系统记录器日志流对应的日志。 对于耦合设施数据表，将忽略该属性；如果在 ICF 目录中为与该表关联的源数据集定义了任何恢复属性，那么也会忽略这些属性。 CFDT 不可正向恢复。
  • NO - 不需要对此文件进行正向恢复日志记录。
  • 日志 - 此数字标识供 CICS 用作正向恢复日志的日志。 CICS 日志名称采用 DFHJnn 格式，其中 nn 的范围为 1 到 99。 将正向恢复后的映像写入与日志名称 DFHJnn 对应的 MVS 日志流。
索引缓冲区数目 INDEXBUFFERS 用于索引的缓冲区数目。 使用 1 到 32767 范围内的值。 您可以指定的最小值就是在 STRINGS 属性中定义的字符串数。 如果将该字段留空，那么 CICSPlex SM 在有缺省值的情况下，会对 CICS 环境使用缺省值。
在日志上记录的添加操作 JNLADD 您要在 JOURNAL 属性指定的日志上记录的添加操作。 可能的值为：
  • AFTER - 完成 VSAM I/O 操作之后，在日志中记录文件控制写操作。
  • ALL - 在完成 VSAM I/O 操作之前以及之后，都在日志中记录文件控制写操作。
  • BEFORE - 在完成 VSAM I/O 操作之前，在日志中记录文件控制写操作。
  • NONE - 不在日志中记录添加操作。
在日志上记录的读操作 JNLREAD 您要在 JOURNAL 属性指定的日志上记录的读操作。 可能的值为：
  • ALL - 在日志中记录所有读操作。
  • NONE - 不在日志中记录读操作。
  • READONLY - 在日志中只记录 READ ONLY 操作（而不记录 READ UPDATE 操作）。
  • UPDATEONLY - 在日志中只记录 READ UPDATE 操作（而不记录 READ ONLY 操作）。
用于输入的同步自动日志记录 JNLSYNCREAD 指定要同步还是异步写自动日志记录，该记录是针对 READ 操作而写入 JOURNAL 指定的日志的。
用于输出的同步自动日志记录 JNLSYNCWRITE 指定要同步还是异步写自动日志记录，该记录是针对 WRITE 操作而写入 JOURNAL 指定的日志的。
在日志上记录的重写/删除操作 JNLUPDATE 指定是否要将 REWRITE 和 DELETE 操作记录在 JOURNAL 属性指定的日志上。
日志号 JOURNAL 指定是否要自动对该文件进行日志记录。 记录的数据采用 VSAM 记录格式，并且用于用户控制的日志记录。 记录的数据可通过 JNLADD、JNLREAD、JNLSYNCREAD、JNLSYNCWRITE 和 JNLUPDATE 属性进行识别。 可能的值为：
  • NO - 此文件中没有出现自动的日志记录。
  • 数字 - 此数字标识 CICS 用于进行自动日志记录的日志。 CICS 日志名称采用 DFHJnn 格式，其中 nn 的范围为 1 到 99。
键长度 KEYLENGTH 远程文件以及用 LOAD（NO）指定的耦合设施数据表中记录的逻辑键长度（字节）。 如果未在此定义 KEYLENGTH，那么必须在引用该文件的应用程序中的文件控制命令上指定该 KEYLENGTH 选项。 如果 KEYLENGTH 未在此定义且没有在应用程序中指定，而且键的长度大于 4 个字符，那么缺省值为 4。
密钥数 键号 用于查找记录的索引编号，以半字二进制数值表示。 （仅限 CICS for OS/2）
装入类型 LOADTYPE 耦合设施数据表的装入类型。 值包括：
  • Load - 此耦合设施数据表是从源数据集预装入的，或者即将从该数据集预装入。
  • Noload - 此耦合设施数据表不是从源数据集预装入的。
自动记录日志 LOG 指定您是否要自动对该文件进行日志记录。
LSR 池编号 LSRPOOLID 本地共享资源池的标识。 LSR 池编号的缺省值为 1；如果已为 NSRGROUP 属性指定了一个值，那么 LSR 池编号的缺省值为 NONE。 选项包括：
  • NONE - 指定与此文件相关联的数据集使用 VSAM 非共享资源（NSR）。
  • 数字 - 该值的范围是 1 到 255，用于标识与此文件关联的 VSAM 数据集所使用的 VSAM 共享资源池的编号。 将数据集定义为使用 VSAM 本地共享资源（LSR）。 建议您在与该 LSR 池编号对应的 LSRPOOL 资源定义中明确定义缓冲区、字符串和其他资源。
数据表中记录的最大数目 MAXNUMRECS 对于 CICS 和 USER 表，这是数据表中的最大项数，范围为 1 到 99999999。 如果指定了 NOLIMIT，那么项数无限制。 NOLIMIT 是缺省值。
最大记录长度 MAXRECORDLEN 文件中记录的最大长度 (以字节计)。

输入值: 1-32767
最小记录长度 MINRECORDLEN 文件中记录的最小长度 (以字节计)。

输入值: 1-4090

（仅限 CICS for OS/2）
名称 名称 文件定义的名称。
非共享的资源（NSR）组名 NSRGROUP 当数据集使用 VSAM 非共享资源（NSR）时，对于引用这些数据集的文件，是 1 到 8 个字符的符号名称，以反映引用相同 VSAM 基本数据集的文件定义。
文件打开的时间 OPENTIME 指定何时打开文件。 可能的值为
  • FIRSTREF - 文件保持关闭状态，除非通过以下方式对其发出文件打开请求：主终端命令、应用程序中的 EXEC CICS SET FILE OPEN 命令或隐式打开。
  • STARTUP - 在 CICS 初始化之后，此文件由自动启动的 CICS 事务（CSFU）立即打开，除非此文件的状态为 UNENABLED，在这种情况下，此文件保持处于关闭状态。
用户访问密码 PASSWORD 1 到 8 个字符的密码，用于验证用户对文件的访问权。 从 CICS Transaction Server 5.3 起，该属性将过时。
耦合设施数据表（CFDT）池名称 POOLNAME 耦合设施数据表所在的耦合设施数据表池的名称。
读取选项 READ 指定该文件上的记录是否可读。
读完整性的缺省级别 READINTEG 使用 RLSACCESS (YES) 定义的文件所需的读完整性级别:
  • CONSISTENT-读取记录时具有一致的读完整性。 CONSISTENT 仅在您同样指定 RLSACCESS(YES) 时有效 - 如果您为非 RLS 文件指定 CONSISTENT，那么会因为出错而拒绝该资源定义。
  • REPEATABLE - 在采用可重复读完整性的情况下读取记录。
  • UNCOMMITTED - 在不采用读完整性的情况下读取记录。 UNCOMMITTED 的完整性级别与那些不支持 READINTEG 属性的 CICS 发行版提供的级别相同。
记录格式 RECORDFORMAT 文件中记录的格式：
  • Fixed - 记录的长度固定。
  • Variable - 记录的长度可变。
记录大小 RECORDSIZE 远程文件中记录的最大长度（字节）。 指定的大小范围可以为 1 到 32767。
恢复类型 RECOVERY 文件所需的恢复类型:
  • ALL-将前映像记录在系统日志中，并将后映像记录在 FWDRECOVLOG 属性中指定的日志中。
  • BACKOUTONLY - 将前映像记录在系统日志中。
  • NONE - 不对此文件进行恢复日志记录。
远程文件名 REMOTENAME （可选） 如果文件位于远程系统上，那么指定该文件在所在系统或区域中使用的名称。 该名称的最大长度为 8 个字符。
远程系统名称 REMOTESYSTEM （可选） 如果文件位于远程系统上，那么指定将目标（本地）系统链接到文件所在的相关（远程）系统的连接的名称。 如果未提供该属性，那么会直接由相关系统的 CICS 系统标识得来。 将目标系统链接到相关系统的连接的名称必须与相关系统的 CICS 系统标识相同。
相对键位置 RKP 记录中相对于记录开始位置的关键字段的起始位置。 由于变长记录，该操作数必须在每个逻辑记录的起始位置为 4 个字节的 LLbb 字段留出空间。 必须始终对每个逻辑记录中具有关键字的数据集，或在浏览时，对它进行编码。
记录级共享（RLS）文件访问方法 RLSACCESS 指定 CICS 是否以 RLS 方式打开文件:
  • NO-不会以 RLS 方式打开文件。
  • YES - 以 RLS 方式打开此文件。
资源安全性值 RSL 该属性已过时，但仍受支持，用于提供与 CICS 较早发行版的兼容性。
VSAM 共享访问 SHR4ACCESS （仅限 CICS/VSE）VSAM 共享访问。
初始状态 STATUS CICS 初始化之后的文件初始状态：START=COLD 或 START=INITIAL。 选项包括：
  • DISABLED - 命令级应用程序对此文件的发出任何请求都将致使 DISABLED 条件被传递到该程序。
  • ENABLED - 允许对此文件进行正常处理。
  • UNENABLED - 这会禁止应用程序隐式地打开此文件。 按此方式访问文件都会遇到 NOTOPEN 情况。 相比较而言，打开文件的明确请求（例如，CEMT 或 EXEC CICS SET FILE OPEN 命令）会在尝试打开文件之前，将状态更改为 ENABLED。
针对文件的最大并行请求数 STRINGS 可对文件进行处理的并行请求数，范围为 1 到 255。 如果将该字段留空，那么 CICSPlex SM 在有缺省值的情况下，会对 CICS 环境使用缺省值。
数据表类型 TABLE 指示此文件是否表示数据表。值包括：
  • NO - 此文件并非表示数据表。
  • CICS - 此文件表示 CICS 维护的数据表。
  • USER - 此文件表示用户维护的数据表。
  • CF - 此文件表示耦合设施数据表。
表名 TABLENAME 为文件资源定义中的耦合设施数据表指定的 8 个字符的表名，或者，如果文件资源定义中省略了表名，那么这是文件名。 如果该文件未引用耦合设施数据表，那么该字段为空。
更新选项 UPDATE 指定该文件上的记录是否可更新。
更新模型 UPDATEMODEL 要用于耦合设施数据表的更新模型的类型:
  • LOCKING-指定使用锁定模型更新 CFDT。
  • CONTENTION - 指定使用争用模型来更新 CFDT。
用户数据区 1 USERDATA1 最长 8 个字符的可选字符串，使您可以提供与 BAS 资源定义相关的特定于站点的其他数据。 CICS CSD 资源定义会忽略该字段。
用户数据区 2 USERDATA2 最长 8 个字符的可选字符串，使您可以提供与 BAS 资源定义相关的特定于站点的其他数据。 CICS CSD 资源定义会忽略该字段。
用户数据区 3 USERDATA3 最长 8 个字符的可选字符串，使您可以提供与 BAS 资源定义相关的特定于站点的其他数据。 CICS CSD 资源定义会忽略该字段。