INQUIRE DSNAME
检索有关外部数据集的信息。
语法
通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态（在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS），激活命令安全检查。
条件: DSNNOTFOUND ， END ， ILLOGIC ， IOERR ， NOTAUTH ，
NOHANDLE, RESP, 和 RESP2 是可以添加到所有 EXEC CICS 命令中的常用选项，用于处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项. 有关使用 CVDA 的更多信息，请参阅 CICS-值数据区 (CVDA)。
描述
INQUIRE DSNAME 命令返回与 FILE 资源定义相关联的对象的相关信息，该对象可以是 BDAM 数据集， VSAM 数据集或通过备用索引到达数据集的 VSAM 路径。
数据集通过 FILE 定义中的 DSNAME 属性以动态方式或通过关联 JCL DD 语句上的 DSN 选项以静态方式与文件相关联。 在发出命令的 CICS® 区域打开引用数据集的第一个文件之前，无法确定数据集的许多属性。 如果在打开文件之前属性无效，那么将返回 NOTAPPLIC 状态。
浏览
您还可以使用 INQUIRE DSNAME 命令上的浏览选项 (START ， NEXT 和 END) 来浏览与系统中安装的文件相关联的所有对象。 请参阅 浏览资源定义 ，以获取有关浏览的常规信息，包括语法，异常条件和示例。
选项
- ACCESSMETHOD (cvda)
- 返回用于标识与此数据集配合使用的访问方法的 CVDA 值。 CVDA 值包括：
- BDAM
- 访问方法为 BDAM。
- NOTAPPLIC
- 发出命令的 CICS 区域尚未打开数据集。
- VSAM
- 访问方法为 VSAM。
- AVAILABILITY (cvda) (仅限 VSAM)
- 返回一个 CVDA 值，指示在此 CICS 区域中当前是否将数据集标记为可用或不可用，或者是否将对数据集的完全访问权限制为 REPLICATOR 程序。 可用性指示符是 CICS 区域在每个数据集的数据集名称块 (DSNB) 中维护的本地标志。 CVDA 值包括：
- AVAILABLE
- 根据 CICS 数据集名称块，该数据集可供使用。 CICS 可以对此数据集发出 RLS 和非 RLS 打开请求。注: 虽然根据 CICS保存的信息提供了数据集，但如果 ICF 目录另有指示，那么打开的请求仍可能失败。 例如，如果数据集恢复处于暂挂状态或正在进行中，那么可能会发生此情况。
- NOTAPPLIC
- 该数据集不是 VSAM 数据集，或者发出此命令的 CICS 区域尚未打开该数据集。
- RREPL
- 对数据集的完全访问权仅限于定义为 REPLICATION (REPLICATOR) 的程序。 其他程序仅具有读访问权。
- UNAVAILABLE
- 针对 CICS 标记为不可用的数据集返回。 CICS 区域无法以 RLS 或非 RLS 方式打开数据集。
- BACKUPTYPE (cvda) (仅限 VSAM)
- 返回一个 CVDA 值，该值标识用于此数据集的备份类型。 CVDA 值包括：
- DYNAMIC
- 数据集有资格进行 "打开时备份" (BWO) 处理; 即，具有所需功能的数据集管理器可以在数据集打开以进行输出时对其进行备份。 也可以在数据集关闭的情况下对其进行备份。 允许数据集执行 BWO，并以非 RLS 方式访问该数据集。
如果数据集以 RLS 方式打开，那么需要查看 VSAM 目录，以了解是否允许数据集执行 BWO。 对于以 RLS 方式打开的数据集，返回的 BACKUPTYPE 值为 NOTAPPLIC。
- NOTAPPLIC
- 发出命令的 CICS 区域尚未打开数据集，或者数据集为 BDAM 或 VSAM PATH。 另外，如果以 RLS 方式打开数据集，那么返回 NOTAPPLIC。 应当引用 VSAM 目录以获得 BWO 状态。
- 静态
- 数据集以非 RLS 方式访问，并且不适用于 BWO 处理。 必须先关闭针对此数据集打开以输出的所有 CICS 文件，然后数据集管理器 (例如 DFSMShsm 或 DFSMSdss) 才能生成备份副本。 分层存储管理器 (DFSMShsm) 和数据集服务 (DFSMSdss) 是Data Facility Storage Management SubsystemDFSMS) 的组件。
如果数据集以 RLS 方式打开，那么需要查看 VSAM 目录，以了解是否允许数据集执行 BWO。
- 未确定
- 如果 RECOVSTATUS 为UN确定的，那么针对基本文件返回。
- BASEDSNAME (data-area) (仅限 VSAM)
- 当查询对象是路径时，返回与 VSAM 路径关联的基本集群的 44 个字符的名称。 当对象是 VSAM 数据集时，此选项将返回与 DSNAME 选项相同的值。
如果访问方法为 BDAM ，或者如果发出该命令的 CICS 区域尚未打开数据集，那么将返回空白。
- DSNAME (data-value)
- 指定要查询的对象的 44 个字符的标识。 它必须与安装在 CICS中的 FILE 定义 (在该定义的 DSNAME 选项或 DDNAME 选项中指定的 JCL DD 语句中指定) 相关联。
- FILECOUNT (数据区)
- 返回一个全字二进制字段，指示引用此数据集的已安装文件定义数。
- FWDRECOVLOG (data-area) (仅限 VSAM)
- FWDRECOVLSN (数据区) (仅限 VSAM)
- 返回用于记录更新的日志流的名称 (最多 26 个字符) (如果这是使用正向恢复属性或复制日志记录定义的数据集)。 如果数据集不可转发可恢复并且未使用复制日志记录，那么 CICS 将返回空白。返回的日志流名称为:
- 直接在 ICF 目录中为正向恢复或复制日志记录指定的日志流名称
- 对于在 ICF 目录中没有正向恢复属性的非 RLS 访问方式数据集，它是由 CICS 通过从 FWDRECOVLOG 值生成的日志名称标识的日志流名称。
- LOGREPSTATUS (cvda)
- 返回一个 CVDA 值，该值标识是否使用 LOGREPLICATE 定义了数据集。 有效值如下：
- 逻辑复制
- 将记录对数据集的所有更新以进行复制。
- 技术副本
- 不会记录数据集的更新以进行复制。
- NOTAPPLIC
- 发出命令的 CICS 区域尚未打开数据集，或者数据集为 BDAM。
- LOSTLOCKS (cvda) (仅限 RLS)
- 返回一个 CVDA 值，指示此数据集是否有任何丢失的锁定。 CVDA 值包括：
- NOTAPPLIC
- 这不是 RLS 数据集，或者发出该命令的 CICS 区域尚未打开该数据集。
- 无锁
- 数据集没有丢失的锁定。
- 回收锁
- 数据集已丢失锁定，因此不可用，但在此 CICS 区域上不需要恢复。
- 回收卡
- 数据集已丢失锁定，因此不可用，并且 CICS 区域正在执行丢失锁定恢复。
请参阅 EXEC CICS SET DSNAME 命令上的 RESETLOCKS 和 FORCE | COMMIT | BACKOUT 选项，以获取有关清除可能挂起丢失锁定恢复的工作单元的信息。
- OBJECT (cvda) (仅限 VSAM)
- 返回 CVDA 值，指示查询对象是包含记录 (VSAM KSDS ， ESDS 或 RRDS 或直接使用的备用索引) 的实际数据集还是将备用索引链接到其基本集群的 VSAM 路径定义。 CVDA 值包括：
- BASE
- 这是包含记录的数据集。
- NOTAPPLIC
- 发出该命令的 CICS 区域尚未打开数据集，或者该数据集是 BDAM 数据集。
- 路径
- 这是一条路。
- QUIESC专题 (cvda) (仅限 VSAM)
- 返回一个 CVDA 值，指示数据集的 RLS 停顿状态。 该信息从数据集的 ICF 目录条目中获取。注: 无论发出命令的 CICS 区域是否已打开数据集，都将返回此选项。CVDA 值包括：
- NOTAPPLIC
- 此数据集为:
- 已迁移
- 使用 BDAM 访问
- 使用不支持 RLS 的 VSAM 级别访问 (即， DFSMS/MVS 低于 1.3)
如果 CICS 在没有 RLS 支持的情况下运行 (指定或隐含 RLS=NO 系统初始化参数) ，那么也会返回 NOTAPPLIC。
- QUIESCED
- 此数据集已停顿。 CICS 无法针对数据集以 RLS 方式打开文件，并且没有 CICS 区域具有当前针对此数据集打开的文件。 然而，可用非 RLS 方式打开数据集。
- QUIESCING
- 此数据集正在停顿。 它仅适用于启动停顿的 CICS 区域; 对于其他 CICS 区域，将返回 UNQUIESCED。
- 取消停顿
- 未停顿或未停顿的数据集的正常值。 它指示可以针对数据集以 RLS 或非 RLS 方式打开文件，这是由第一个打开方式建立的方式。 以一种方式打开文件后，只能以相同方式打开其他文件。
- RECOVSTATUS (cvda)
- 返回用于标识数据集恢复特征的 CVDA 值。 CVDA 值包括：
- 前向可变
- 将记录对数据集的所有更新以进行回退和正向恢复。
- NOTAPPLIC
- 这是 BDAM 数据集或 VSAM 路径，或者发出命令的 CICS 区域尚未打开该数据集。
- 不可撤销
- 不会记录对数据集的更新。
此响应也可能作为使用 XFCNREC 全局用户出口的结果而返回。 在 XFCNREC 上启用的程序可能指示即使与同一数据集关联的不同文件的回退恢复需求不匹配，也应继续打开文件。 在这些情况下，数据集将标记为 NOTRECOVABLE ，以指示其数据完整性无法再保证。 直到 CEMT SET DSNAME REMOVE 或 EXEC CICS SET DSNAME REMOVE 命令或初始启动或冷启动清除该条件为止。
当数据集处于此状态时，将根据文件定义中的规范对特定请求执行回退日志记录。 因此，对于通过一个文件而不是通过另一个文件的请求，可能会发生回退日志记录。
- 可恢复
- 将记录对数据集的所有更新以进行回退。
- 未确定
- 由于未打开与此数据集关联的文件，或者由于仅打开的文件定义为耦合设施数据表或用户维护的数据表 (其中恢复属性独立于关联的数据集) ，因此恢复状态未知。
- RETLOCKS (cvda)
- 返回 CVDA 值，指示由于此 CICS 区域的延迟恢复工作，是否存在针对指定数据集的任何保留记录锁定。 CVDA 值包括：
- NOTAPPLIC
- 发出命令的 CICS 区域未打开此数据集。
- 未保留
- 此 CICS 区域:
- 没有基本数据集的延迟恢复工作，因此没有保留的锁定，或者
- 当前正在进行恢复工作。
- 保留
- 此 CICS 区域已延迟恢复工作，导致数据集的保留锁定。 这样做的一个效果是，如果上次以 RLS 方式打开数据集，那么锁定是 RLS 锁定，因此无法以非 RLS 方式打开数据集。
另一个影响是无法更改指定此数据集的任何 FILE 定义以指定其他数据集。
如果数据集是 BDAM 数据集或以非 RLS 方式访问的 VSAM 数据集，那么锁定是 CICS 记录锁定，否则是 RLS 记录锁定。 具有保留锁定的 UOW 通常被搁置，但它可能正在重试。
- 有效性 (cvda)
- 返回 CVDA 值，该值通过打开与数据集相关联的文件来确定是否已针对 VSAM 目录验证数据集名称。 CVDA 值包括：
- INVALID
- 尚未验证数据集名称 (尚未进行验证或验证失败)。
- 有效
- 已验证数据集名称。
条件
- DSNNOTFOUND
- RESP2 值：
- 1
- 找不到数据集。
- END
- RESP2 值：
- 2
- 没有更多此类型的资源定义。
- ILLOGIC
- RESP2 值：
- 1
- 当此资源类型的浏览已在进行时，发出了 START 命令，或者当此资源类型的浏览未在进行时，发出了 NEXT 或 END 命令。
- IOERR
- RESP2 值：
- 40
- 指定了QUIESC一下，但 DFSMS/MVS 在读取 ICF 目录时发生了错误。
- 48
- 无法完成指定的操作，因为已迁移数据集。 重新调用数据集，然后重新发出命令。
- 49
- 读取 ICF 目录以建立基本数据集名称时， DFSMS/MVS 发生错误。
注: 如果在浏览中发生 IOERR ，那么它不会终止浏览操作，并且 CICS 会尝试返回尽可能多的参数值。 - NOTAUTH
- RESP2 值：
- 100
- 未授权与发出任务关联的用户使用此命令。