顺序

对结果集中的资源表记录进行排序。

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

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

读取语法图跳过可视语法图ORDERBY(data-area) LENGTH(data-value) RESULT(cpsm-令牌) THREAD(cpsm-令牌) RESPONSE(数据参考) REASON(数据参考)

描述

此命令将结果集中的资源表记录按用户指定的顺序排序。
  • 缺省情况下，记录按资源表的键属性排序。
  • 您为结果集指定的排序顺序将保持有效，直到您发出另一个 ORDER 命令为止。
  • 如果结果集包含已删除的记录，那么这些记录将包含在排序过程中。 它们按与其他记录相同的属性排序，它们在新排序的结果集中的位置可能难以确定。 要防止发生此情况，请在发出 ORDER之前发出 REFRESH 命令; REFRESH 将从结果集中除去任何已删除的记录。

相关命令

  • COPY
  • GET
  • GETDEF
  • GROUP
  • LOCATE
  • PERFORM OBJECT

选项

BY(数据区)
标识包含要用于此操作的顺序表达式的缓冲区。
顺序表达式是要用于对资源表记录进行排序的属性的列表。 例如：
  CICSSYS,TRANID.
其中，属性名称以逗号或空格分隔，并且整个表达式以句点结束。

在此示例中，资源表记录使用 CICS® 系统名称作为主排序键和事务标识作为辅助键进行排序。 缺省排序顺序为升序。 要按降序对属性值进行排序，请将 /D 添加到属性名称的末尾。

有关将订单表达式与 ORDER 命令配合使用的更多信息，请参阅 CICSPlex SM API 概述。

LENGTH(数据值)
指定 BY 缓冲区长度的全字值。
注: 您指定的缓冲区长度不应包含除顺序表达式以外的任何数据。
REASON(数据引用)
指定变量以接收此命令返回的全字原因值。
RESPONSE(数据引用)
指定一个变量以接收此命令返回的全字响应值。
RESULT (cpsm-token)
标识此操作要处理的 API 结果集。 结果集可以是由以下任何命令生成的结果集:
  • COPY
  • GET
  • GETDEF
  • GROUP
  • PERFORM OBJECT
主题 （cpsm-令牌）
标识要用于此操作的 API 线程。 标识线程的 cpsm-token 值由 CONNECT 命令返回。

条件

以下是可由 ORDER 命令返回的 RESPONSE 值的列表。 每个 RESPONSE 的描述都包含关联的 REASON 值的列表 (如果适用)。
1024 正常
该命令已成功完成处理。
1028 无效参数
检测到无效参数。 将返回无效的参数作为原因值:
  • 1280 线程
  • 1283 结果
  • 1285 长度
  • 1300 人

请检查命令描述以获取有效的参数语法。

1029 失败
由于下列其中一个原因，该命令失败:
1331 异常终止
命令处理异常结束。
1359 异常
命令处理迂到异常情况。
1030 发生了错误
由于下列其中一个原因，发生了环境错误:
1321 社会资源
CMAS 拥有的必需资源不可用。
1357 无存储器
应用程序存根程序无法在正在运行处理线程的地址空间中获取必需的存储器。
1358 无服务
应用程序存根程序无法装入 API 服务模块。
1032 繁忙
由于以下原因，发生了忙碌状态:
1283 结果
RESULT 选项上指定的结果集正由另一个命令处理。
1033 服务器 GONE
处理线程所连接的 CMAS 不再处于活动状态。
1034 不可用
由于下列其中一个原因，发生了不可用的情况:
1334 CPSMAPI
处理线程所连接的 CMAS 不可用于 API 处理。
1340 APITASK
API 控制子任务未处于活动状态。
1035 版本 INVL
由于下列其中一个原因，发生了版本冲突:
1335 不支持
不支持用于此命令的应用程序存根程序的版本。
1336 notvsnconn
用于此命令的应用程序存根程序的版本与用于 CONNECT 命令的版本不同。
1036 无效cmd
由于以下原因，该命令无效:
1285 长度
命令上所有选项的总长度超过最大限制。