指定过滤器
定义属性或值过滤器并为其分配标识令牌。
警告系统命令功能强大，可提供有关系统状态的信息，并允许对系统进行更改。 系统命令只能由授权应用程序和用户使用。
通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态（在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS），激活命令安全检查。
描述
此命令定义属性或值过滤器，并向其分配标识令牌。
- 过滤器与定义它们的特定处理线程相关联; 它们不能由其他处理线程共享。
- 您可以定义多个过滤器以供处理线程使用; CICSPlex ® SM 向每个过滤器分配唯一的标识令牌。
- 当终止处理线程时，将废弃由其定义的任何过滤器。
相关命令
- COPY
- DELETE
- DISCARD
- FETCH
- GET
- GROUP
- LISTEN
- LOCATE
- MARK
- PERFORM OBJECT
- PERFORM SET
- REFRESH
- SET
- UNMARK
选项
- CRITERIA(数据区)
- 标识包含要用于此操作的过滤表达式的缓冲区。 CRITERIA 选项仅过滤满足指定条件的资源表记录。
有关如何构成过滤表达式的详细信息，请参阅 CICSPlex SM API 概述。
注: 不能在过滤器表达式中指定 EYU_CICSNAME 或 EYU_CICSREL 属性。 - 过滤 （data-ref）
- 指定一个变量以接收 CICSPlex SM 分配给此过滤器的令牌。
必须在使用此过滤器的所有后续命令上指定此标识标记。
- LENGTH(数据值)
- 一个全字值，用于指定 CRITERIA 缓冲区的长度。注: 您指定的缓冲区长度不应包含除过滤表达式以外的任何数据。
- OBJECT(数据值)
- 标识要为其创建过滤器的资源表。 此值必须是有效资源表的 8 字符名称。
- REASON(数据引用)
- 指定变量以接收此命令返回的全字原因值。
- RESPONSE(数据引用)
- 指定一个变量以接收此命令返回的全字响应值。
- 主题 （cpsm-令牌）
- 标识要用于此操作的 API 线程。 标识线程的 cpsm-token 值由 CONNECT 命令返回。
条件
以下是可由 SPECIFY
FILTER 命令返回的 RESPONSE 值的列表。 每个 RESPONSE 的描述都包含关联的 REASON 值的列表 (如果适用)。
- 1024 正常
- 该命令已成功完成处理。
- 1026 未找到
- 由于以下原因发生了 "找不到" 情况:
- 1310 属性
- 找不到指定资源表的 CRITERIA 缓冲区中指定的属性。
- 1028 无效参数
- 检测到无效参数。 将返回无效的参数作为原因值:
- 1280 线程
- 1281 对象
- 1285 长度
- 1286 过滤器
- 1299 条件
请检查命令描述以获取有效的参数语法。
- 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 命令的版本不同。
- 1036 无效cmd
- 由于下列其中一个原因，该命令无效:
- 1285 长度
- 命令上所有选项的总长度超过最大限制。
- 1286 过滤器
- 在操作上传递的过滤表达式过大或复杂。
- 1041 无效数据
- 检测到无效数据。 包含无效数据的参数将作为原因值返回:
- 1299 条件
- CRITERIA 缓冲区中列出的属性值对于指定的属性无效。