资格

定义 CICSPlex ® SM 上下文和作用域。

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

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

读取语法图跳过可视语法图QUALIFYCONTEXT( data-value)SCOPE(data-value)THREAD(cpsm-令牌) RESPONSE(数据参考 )REASON(数据参考 )

描述

此命令定义 API 处理线程发出的后续命令的 CICSPlex SM 上下文和作用域。

相关命令

CONNECT

选项

CONTEXT(数据值)
标识针对此线程发出的后续命令的上下文。 上下文必须是 CMAS 或 CICSplex 的 1-to 8 字符名称。

指定的上下文将对线程保持有效，直到您在后续命令中覆盖该线程或对其进行更改为止。

REASON(数据引用)
指定变量以接收此命令返回的全字原因值。
RESPONSE(数据引用)
指定一个变量以接收此命令返回的全字响应值。
SCOPE(数据值)
标识针对此线程发出的后续命令的作用域。
SCOPE 选项限定 CONTEXT 选项。 当上下文是 CICSplex 时，作用域可以是下列其中一项:
  • CICSplex 本身的 1-to 8 字符名称
  • CICSplex 中的 CICS® 系统或 CICS 系统组
  • 在 CICSPlex SM 资源描述 (RESDESC) 中定义的逻辑作用域

当上下文是 CMAS 时，此选项没有含义，将被忽略。

除非您为特定命令覆盖该线程或通过发出另一个 QUALIFY 命令来更改该线程，否则指定的作用域将对该线程保持有效。 如果未指定 SCOPE 选项，那么将不采用作用域值 (即，不会保留 CONNECT 命令为线程建立的缺省作用域)。

注: 当上下文是 CICSplex 时，某些 API 命令需要有效的作用域。 如果未在 QUALIFY 命令上指定作用域，那么在针对表示 CICS 资源的资源表发出以下任何命令时，必须指定 SCOPE 选项:
  • GET
  • PERFORM OBJECT
  • PERFORM SET
  • REFRESH
  • SET
主题 （cpsm-令牌）
标识要用于此操作的 API 线程。 标识线程的 cpsm-token 值由 CONNECT 命令返回。

条件

以下是可由 QUALIFY 命令返回的 RESPONSE 值的列表。 每个 RESPONSE 的描述都包含关联的 REASON 值的列表 (如果适用)。
1024 正常
该命令已成功完成处理。
1028 无效参数
检测到无效参数。 将返回无效的参数作为原因值:
  • 1280 线程
  • 1282 上下文
  • 1294 范围

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

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