SET TSQUEUE / TSQNAME

删除临时存储器 (TS) 队列。 您还可以使用备用命令 SET TSQNAME。 使用任一命令来删除名称长达 8 个字符的队列,并使用 SET TSQNAME 以删除名称长达 16 个字符的队列。

语法

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

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

SET TSQUEUE

读取语法图跳过可视语法图SET TSQUEUE(data-value)TSQNAME(data-value)SYSID(data-value)POOLNAME(data-value)ACTION(CVDA)LASTUSEDINT(data-value)

条件: 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 错误。