资格
定义 CICSPlex ® SM 上下文和作用域。
相关命令
CONNECT
描述
此命令定义 API 处理线程发出的后续命令的 CICSPlex SM 上下文和作用域。
选项
- CONTEXT(数据值)
- 标识针对此线程发出的后续命令的上下文。 上下文必须是 CMAS 或 CICSplex 的 1-to 8 字符名称。
指定的上下文将对线程保持有效，直到您在后续命令中覆盖该线程或对其进行更改为止。
- REASON(数据引用)
- 指定变量以接收此命令返回的全字原因值。
- RESPONSE(数据引用)
- 指定一个变量以接收此命令返回的全字响应值。
- SCOPE(数据值)
- 标识针对此线程发出的后续命令的作用域。SCOPE 选项限定 CONTEXT 选项。 当上下文是 CICSplex 时，作用域可以是:
- CICSplex 本身的 1-to 8 字符名称
- CICSplex 中的 CICS ® 系统或 CICS 系统组
- CICSPlex SM 资源描述 (RESDESC) 中定义的逻辑作用域。
指定的作用域对线程保持有效，除非您为特定命令覆盖该作用域或通过发出另一个限定命令来更改该作用域。 如果未指定 SCOPE 选项，那么不会采用 SCOPE 值 (即，不会保留 CONNECT 命令为线程建立的缺省作用域)。
注: 当上下文是 CICSplex 时，某些 API 命令需要有效的作用域。 如果未在限定命令上指定作用域，那么在对表示 CICS 资源的资源表发出以下任何命令时，必须指定 SCOPE 选项:- GET
- 执行对象
- PERFORM 集
- REFRESH
- SET。
- THREAD(cpsm-token)
- 标识要用于此操作的 API 线程。 用于标识线程的 cpsm-token 值由 CONNECT 命令返回。
条件
以下是可由限定命令返回的 RESPONSE 值的列表。 每个 RESPONSE 的描述都包含关联的 REASON 值的列表 (如果适用)。
- 确定
- 该命令已成功完成处理。
- 发生了错误
- 由于下列其中一个原因，发生了环境错误:
- 无服务
- 应用程序存根程序无法装入 API 服务模块。
- 无存储器
- 应用程序存根程序无法在正在运行处理线程的地址空间中获取必需的存储器。
- SOCRESOURCE
- CMAS 拥有的必需资源不可用。
- FAILED
- 由于下列其中一个原因，该命令失败:
- 异常终止
- 命令处理异常结束。
- EXCEPTION
- 命令处理迂到异常情况。
- INVALIDPARM
- 检测到无效参数。 将返回无效的参数作为原因值:
- 上下文
- SCOPE
- 太棒了
- NOTAVAILABLE
- 由于下列其中一个原因，发生了不可用的情况:
- APITASK
- API 控制子任务未处于活动状态。
- CPSMAPI
- 处理线程所连接的 CMAS 不可用于 API 处理。
- 项目 XMGR
- 处理线程当前所连接的 CMAS 不参与管理指定的 CICSplex ，并且没有其他 CMAS 可用于管理 CICSplex。
- 服务器 GONE
- 处理线程所连接的 CMAS 不再处于活动状态。
- 版本 INVL
- 由于下列其中一个原因，发生了版本冲突:
- NotSupported
- 不支持用于此命令的应用程序存根程序的版本。
- NOTVSNCONN
- 用于此命令的应用程序存根程序的版本与用于 CONNECT 命令的版本不同。