使用结果集

CICSPlex ® SM 将您选择的资源表记录放置在结果集中。 结果集是可由 API 程序访问、查看和操作的资源表记录的逻辑组。

可以通过以下两种方法之一来创建结果集:
  • 通过直接 API 请求来获取资源数据。 GET 命令是收集资源数据和创建结果集的主要方法。
  • 通过处理一个结果集以创建另一个结果集的 API 请求。 COPY 是一个命令示例,该命令可以从现有记录中的记录创建新的结果集。 从中复制记录的结果集称为源结果集。 要复制到的目标结果集。
结果集中的资源表记录必须全部表示一种类型的受管对象。 即,包含 PROGRAM 资源表记录的结果集不能同时包含 LOCTRAN 资源表记录。 还必须从同一 CICSPlex SM 上下文收集资源表记录。 因此,包含来自一个 CICSplex 的记录的结果集不能用于保存来自任何其他 CICSplex 的记录。 一旦创建了结果集,其资源类型和上下文就会固定下来。 更改结果集的类型或上下文的唯一方法是将结果集的内容完全替换为新的资源表记录。

请记住,结果集中的资源表记录不是实际受管对象; 它是收集数据时受管对象的属性的报告。 这是一个重要的区别,因为在将资源表记录返回到程序时,实际受管对象可能已更改或可能不再存在。 返回的记录数可能随着受管对象的出现而变化,但结果集中的记录结构保持不变。

简单 API 程序一次只能处理一个结果集。 每个针对数据的新请求都可以创建一个结果集来替换先前的结果集。 更复杂的程序可能会同时维护多个结果集,并更直接地控制这些结果集的保留时间。