translate

转换资源表属性值。

警告系统命令功能强大，可提供有关系统状态的信息，并允许对系统进行更改。 系统命令只能由授权应用程序和用户使用。

通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态（在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS），激活命令安全检查。

命令

读取语法图跳过可视语法图TRANSLATEOBJECT(data-value) ATTRIBUTE(data-value )FROMCV(data-value)TOCHAR(数据参考)FROMCHAR(data-value)TOCV(数据参考)THREAD(cpsm-令牌) RESPONSE(数据参考) REASON(数据参考)

描述

此命令在资源表属性值的内部编码格式与外部显示格式之间转换以编码格式 (例如 EYUDA 和 CVDA 值) 维护的资源表属性值。
  • 如果程序是用 REXX 编写的，那么可以使用 TPARSE 命令来访问资源表记录并转换其属性值。 但是，如果将 ASIS 选项与 TPARSE配合使用，那么属性值不会转换为其外部格式; 在这种情况下，您需要在使用 TPARSE 后使用 TRANSLATE 来接收格式化的显示值。 有关 TPARSE 命令的说明，请参阅 REXX 功能和命令。
  • 在 CICS® 环境中， DFHVALUE 函数可以针对以下资源表属性返回不兼容的 CVDA 值:
    资源表 属性值
    CONNECT RECOVSTATUS (NRS)
    IPCONN RECOVSTATUS (NRS)
    LIBRARY 条件状态 (严重)
    LOCTRAN RESSEC (RESSECEXT)
    PROGDEF API (CICSAPI)
    PROGRAM APIST (CICSAPI)
    PROGRAM LPASTAT (NOTSVA)
    PROGRAM LPASTAT (SVA)

    由于这些 CVDA 值与 CICS中使用的值冲突，因此 CICSPlex SM 必须修改这些值以保留其唯一性。 CICSPlex SM 将 8000 或 9000 添加到 DFHVALUE 针对其中每个 CICS CVDA 属性返回的值。

    如果要转换其中任何属性，那么必须将 8000 或 9000 添加到从 DFHVALUE 接收到的值，然后再将该属性提供给 CICSPlex SM。

选项

ATTRIBUTE(数据值)
标识要转换的资源表属性。 此值必须是资源表的有效属性的 1 到 12 个字符的名称。
FROMCHAR(数据值)
指定指定属性的 1 到 12 个字符的值。
FROMCV(数据值)
指定指定属性的 4 字节内部编码值。
OBJECT(数据值)
标识要转换的属性所属的资源表。 此值必须是有效资源表的 8 字符名称。
REASON(数据引用)
指定变量以接收此命令返回的全字原因值。
RESPONSE(数据引用)
指定一个变量以接收此命令返回的全字响应值。
主题 （cpsm-令牌）
标识要用于此操作的 API 线程。 标识线程的 cpsm-token 值由 CONNECT 命令返回。
TOCHAR(数据引用)
对变量进行命名，以接收将内部编码值转换为指定属性的 1-to 12-character 值的结果。
TOCV(数据引用)
指定一个变量以接收将字符值转换为指定属性的 4 字节内部编码值的结果。

条件

以下是可由 TRANSLATE 命令返回的 RESPONSE 值的列表。 每个 RESPONSE 的描述都包含关联的 REASON 值的列表 (如果适用)。
1024 正常
该命令已成功完成处理。
1028 无效参数
检测到无效参数。 将返回无效的参数作为原因值:
  • 1280 线程
  • 1281 对象
  • 1310 属性
  • 1311 FROMCV
  • 1312 托查尔
  • 1313 FROMCHAR
  • 1314 TOCV

请检查命令描述以获取有效的参数语法。

1029 失败
由于下列其中一个原因，该命令失败:
1331 异常终止
命令处理异常结束。
1359 异常
命令处理迂到异常情况。
1030 发生了错误
由于下列其中一个原因，发生了环境错误:
1321 社会资源
CMAS 拥有的必需资源不可用。
1357 无存储器
应用程序存根程序无法在正在运行处理线程的地址空间中获取必需的存储器。
1358 无服务
应用程序存根程序无法装入 API 服务模块。
1033 服务器 GONE
处理线程所连接的 CMAS 不再处于活动状态。
1034 不可用
由于下列其中一个原因，发生了不可用的情况:
1334 CPSMAPI
处理线程所连接的 CMAS 不可用于 API 处理。
1340 APITASK
API 控制子任务未处于活动状态。
1035 版本 INVL
由于下列其中一个原因，发生了版本冲突:
1335 不支持
不支持用于此命令的应用程序存根程序的版本。
1336 notvsnconn
用于此命令的应用程序存根程序的版本与用于 CONNECT 命令的版本不同。
1038 表错误
由于以下原因，资源表记录无效:
1354 无效
CICSPlex SM不支持指定版本的资源表。