REFRESH

描述

• 此命令刷新结果集中部分或全部资源表记录的数据。
• 对于 MAS 资源表，仅当上次构建结果集时 MAS 处于活动状态时， REFRESH 才会提供数据。

相关命令

• COPY
• GET
• LOCATE
• MARK
• PERFORM OBJECT
• SPECIFY FILTER

选项

ALL

刷新结果集中的所有资源表记录。 指定 ALL 时:

• 将忽略 COUNT 选项。
• 将从结果集中除去已删除的任何记录。 先前由删除的记录担任的任何职位都将填补，其余记录将重新编号。 因此，刷新后，给定记录在结果集中的相对位置可能不同。

向后

刷新先前的资源表记录，并通过结果集以向后方向继续刷新 COUNT 选项指定的记录数。

注: 如果记录指针位于结果集的底部，那么使用BACK何承天将刷新当前记录 (这是最后一条记录) ，然后继续先前记录。

计数(数据值)

指定要刷新的资源表记录数。 如果未指定 COUNT 选项，那么仅刷新一条记录。

如果未指定FOR何承天或BACK何承天选项，那么刷新过程将通过结果集向前移动。

CURRENT

仅刷新当前资源表记录。 指定 CURRENT 时，将忽略 COUNT 选项。

过滤 （cpsm-令牌）

标识要用于此操作的过滤器。 FILTER 选项指示仅应考虑刷新那些符合指定过滤条件的资源表记录。

刷新的记录数由 COUNT 选项确定。 如果未指定 COUNT 选项，那么仅刷新符合过滤条件的第一个记录。

用于标识过滤器的 cpsm-token 值由 SPECIFY FILTER 命令返回。

向前

刷新当前资源表记录，并通过结果集继续向前，刷新 COUNT 选项指定的记录数。

已标记

指示仅应考虑刷新在结果集中标记的那些资源表记录。

刷新的记录数由 COUNT 选项确定。 如果未指定 COUNT 选项，那么仅刷新标记的第一个记录。

您可以使用 MARK 和 UNMARK 命令来标记资源表记录。

NOTFILTER (cpsm-token)

标识要用于此操作的过滤器。 NOTFILTER 选项指示仅应考虑刷新那些不符合指定过滤条件的资源表记录。

刷新的记录数由 COUNT 选项确定。 如果未指定 COUNT 选项，那么将仅刷新第一个不满足过滤条件的记录。

用于标识过滤器的 cpsm-token 值由 SPECIFY FILTER 命令返回。

未标记

指示仅应考虑刷新未在结果集中标记的那些资源表记录。

刷新的记录数由 COUNT 选项确定。 如果未指定 COUNT 选项，那么将仅刷新未标记的第一个记录。

您可以使用 MARK 和 UNMARK 命令来标记资源表记录。

无等待

一旦接受了 REFRESH 命令，就将控制权返回给程序，这将允许异步处理该命令。

如果指定 NOWAIT 选项，那么必须使用后续 RECEIVE 命令来测试此请求的完成情况。 异步请求的结果将作为 ASYNCREQ 资源表记录返回。 有关异步处理的完整描述，请参阅 CICSPlex SM API 概述。

注: 如果指定 TOKEN 选项，那么缺省情况下将采用 NOWAIT 选项。

REASON(数据引用)

指定变量以接收此命令返回的全字原因值。

RESPONSE(数据引用)

指定一个变量以接收此命令返回的全字响应值。

RESULT (cpsm-token)

标识此操作要处理的 API 结果集。 结果集可以是由以下任何命令生成的结果集:

• COPY
• GET
• PERFORM OBJECT

主题 （cpsm-令牌）

标识要用于此操作的 API 线程。 标识线程的 cpsm-token 值由 CONNECT 命令返回。

TOKEN(数据值)

定义 1-to 4 字符令牌，您选择将异步 REFRESH 请求与后续 RECEIVE 命令的结果关联。 此令牌供程序使用; CICSPlex ® SM 不使用该值。 当此 REFRESH 请求完成时， RECEIVE 命令将返回该令牌。

条件