SET TSQUEUE / TSQNAME
删除临时存储器 (TS) 队列。 您还可以使用备用命令 SET TSQNAME。 使用任一命令来删除名称长达 8 个字符的队列,并使用 SET TSQNAME 以删除名称长达 16 个字符的队列。
语法
警告系统命令功能强大,可提供有关系统状态的信息,并允许对系统进行更改。 系统命令只能由授权应用程序和用户使用。
通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态(在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS),激活命令安全检查。
条件: INVREQ , NOTAUTH , NOTFND , POREL , QIDERR 和 SYSIDERR
NOHANDLE, RESP, 和 RESP2 是可以添加到所有 EXEC CICS 命令中的常用选项,用于处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息,请参阅 EXEC CICS 命令格式和编程注意事项. 有关使用 CVDA 的更多信息,请参阅 CICS-值数据区 (CVDA)。
此命令是线程安全的。
描述
SET TSQUEUE 命令用于删除 TS 队列。 您可以使用 LASTUSEDINT 选项来确保自发出先前的 INQUIRE 以来,未引用要删除的队列。 您还可以使用 LASTUSEDINT 选项来删除在给定时间间隔内未引用的队列。 如果队列可恢复,那么必须附加单独的任务才能执行删除。
可以使用单个命令删除的最大 TS 队列数为 32766。 如果超过此限制,那么请求将失败,并且不会删除任何队列。
选项
- ACTION (cvda)
- 指定要对队列执行的操作。 CVDA 值如下所示:
- DELETE
- 删除队列。
- LASTUSEDINT (data-value)
- 如果指定了此选项,那么仅当上次使用的时间间隔大于或等于指定的值时,才会删除队列。 指定值 (以秒计)。
- POOLNAME (data-value)
- 指定 8 字符的池名称。
- SYSID (data-value)
- 指定 4 字符的共享系统标识 (sysid)。
- TSQNAME (data-value)
- 指定 TS 队列的 1 到 16 个字符的标识。
- TSQUEUE (data-value)
- 指定 TS 队列的 1 到 8 字符标识。
条件
- INVREQ
- RESP2 值:
- 1
- 未删除 TSQUEUE ,因为 LASTUSEDINT 大于时间间隔,或者因为 TSQUEUE 正在使用中。
- 2
- 指定的操作不是 DELETE
- 3
- 指定了 LASTUSEDINT ,但其值无效; 即负值。
- 4
- 队列类型无效。
- NOTAUTH
- RESP2 值:
- 100
- 未授权与发出任务关联的用户使用此命令。
- 101
- 未授权与发出任务关联的用户以此命令所需的方式访问此特定资源。
- NOTFND
- RESP2 值:
- 1
- 找不到 TSQUEUE。
- 容错
- RESP2 值:
- 0
- 指定了 POOLNAME ,但无法访问池。
- QIDERR
- RESP2 值:
- 1
- QUEUE 名称无效; (它是二进制零)。
- SYSIDERR
- RESP2 值:
- 0
- 指定了 SYSID ,但没有相应的池,或者池不可用。
- 3
- SYSID 未映射到共享池。
- 4
- 服务器错误。
- 5
- 耦合设施上发生 I/O 错误。
