TPARSE

将资源表记录从一个变量解析为一组变量。

读取语法图跳过可视语法图 TPARSE OBJECT ( data-value ) PREFIX ( data-value ) STATUS ( data-ref ) VAR ( data-area ) ASIS THREAD ( cpsm-令牌 )

描述

此命令将资源表记录从变量解析为一组表示表的各个属性的变量。 可以将 TPARSE 与任何类型的 CICSPlex ® SM 资源表配合使用。

资源表变量可以是任何有效的 REXX 变量，包括词干变量。 输出变量通过向属性名称添加前缀来构成，如下所示:
  prefix_attribute

其中 prefix 是您提供的文本字符串， attribute 是资源表中属性的名称。 在前缀和属性名称之间插入下划线 (_)。

注: 有关资源表及其属性的完整描述，请参阅 CICSPlex SM 资源表。

选项

ASIS
指定不将资源表属性值转换为其外部格式; 将按原样返回这些值。 属性值如下所示:
  • 字符值具有尾部空格。
  • 二进制值具有前导零，并且不会转换为显示格式。
  • EYUDA 和 CVDA 值不会转换为字符格式。
必须使用 ASIS 选项来解析要重建的 CPSM 定义或 CICS 定义资源表 (使用 TBUILD ASIS 命令)。
注: 如果将 ASIS 选项与 EYUDA 或 CVDA 值配合使用，那么可以使用 TRANSLATE 命令将编码数字值转换为字符值。
OBJECT(数据值)
标识要解析的资源表。 此值必须是有效资源表的 1-to 8 字符名称。
注: 不能使用 TPARSE 命令来处理由指定 VIEW 命令创建的资源表视图。 如果创建与提供的资源表同名的视图，然后在 PARSE 命令上指定该名称，那么该命令将失败。
PREFIX(数据值)
指定要用于命名 TPARSE 返回的属性变量的前缀。
注: 前缀的最大允许长度由 REXX 和运行程序的环境确定。
STATUS(数据引用)
指定一个变量以接收为此命令返回的 REXX 状态值。 状态将以字符形式作为下列其中一项返回:
确定
TPARSE 命令已成功完成处理。
语法错误
由于语法错误，无法处理 TPARSE 命令。 描述错误的 EYUARnnnn 消息将写入系统上为 IRXSAY WRITEERR 输出定义的目标。
FAILURE
TPARSE 命令失败，因为它尝试处理的某些数据无效。 跟踪数据将写入名为 EYU_TRACE 的 REXX 词干变量。 描述故障的 EYUARnnnn 消息也可以写入系统上为 IRXSAY WRITEERR 输出定义的目标。
注: 有关 EYUTRACE 词干变量的更多信息，请参阅 开发 CICSPlex SM 应用程序。
THREAD(cpsm-token)
标识要用于此操作的 API 线程。 用于标识线程的 cpsm-token 值由 CONNECT 命令返回。
VAR(数据区)
指定包含要解析的资源表记录的变量。