CSD GETNEXTRSRCE
在资源浏览中获取下一个资源的详细信息。
语法
警告系统命令功能强大，可提供有关系统状态的信息，并允许对系统进行更改。 系统命令只能由授权应用程序和用户使用。
通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态（在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS），激活命令安全检查。
条件: CSDERR ， END ， ILLOGIC ， ENGERR 和 NOTAUTH
NOHANDLE、RESP 和 RESP2是常用选项，可添加到所有 EXEC CICS 命令中以处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项.
描述
CSD GETNEXTRSRCE 命令返回由 CSD STARTBRRSRCE 命令启动的浏览中下一个资源的详细信息。
选项
- ATTRIBUTES (数据区域)
- 指定返回包含相关资源的属性列表的字符串的数据区。
- ATTRLEN (数据区)
- 包含下列其中一个值的全字二进制字段:
- 与 ATTRIBUTES 选项一起使用时:
- 在输入时， ATTRLEN 包含应用程序可接受的属性字符串的最大长度。 如果长度可以由编译器从 ATTRIBUTES 变量生成，那么不需要指定 ATTRLEN 。
- 在输出时， ATTRLEN 包含返回的属性字符串的长度。 如果属性字符串的长度超过输入 ATTRLEN 值，那么将产生 LENGERR 条件。
- 与 SET 选项一起使用时， ATTRLEN 是设置为属性字符串长度的仅输出字段。
- 与 ATTRIBUTES 选项一起使用时:
- 组 (数据区)
- 指定要浏览的组的 8 字符名称。
- RESID (数据区)
- 返回返回其属性的资源定义的 8 字符名称。 只有四个字符的资源名称 (如 TRANSACTION) 将用四个空格填充。
- RESTYPE (cvda)
- 返回指示资源定义类型的 CVDA 值。 请参阅所有命令所使用的 CICS-value 数据区 ，以获取 CVDA 值与其数字等效值之间的映射。
- SET (ptr-ref)
- 指定设置为返回的属性字符串地址的指针引用。 指针引用一直有效，直到发出下一个 CSD GETNEXTRSRCE 资源命令或任务结束为止。
条件
- CSDERR
- RESP2 值:
- 1
- 无法读取CSD。
- 4
- CSD 正由另一个 CICS® 系统使用，并且未配置为共享。
- 5
- 没有足够的 VSAM 字符串 (CSDSTRNO 系统初始化参数值) 可用于运行 EXEC CICS CSD 命令。
- END
- RESP2 值:
- 1
- CSD 或指定的列表不再包含任何组。
- ILLOGIC
- RESP2 值:
- 1
- 未在进行资源浏览。
- LENGERR
- RESP2 值:
- 1
- 在传递到 CICS 的 ATTRLEN 选项上指定的 ATTRIBUTES 数据区的长度为负数。
- 2
- 在传递到 CICS 的 ATTRLEN 选项上指定的 ATTRIBUTES 数据区的长度小于要返回的数据量。
- NOTAUTH
- RESP2 值:
- 100
- 未授权与发出任务关联的用户使用此命令。