公共数据结构格式
以下是列表 API 的数据结构格式和字段描述。
通用头格式 0100
格式 0100 用于作为程序 (*PGM) 调用的列表 API。
| 偏移 | 类型 | 字段 | |
|---|---|---|---|
| Dec | 十六进制 | ||
| 0 | 0 | CHAR(64) | 用户区域 (user area) |
| 64 | 40 | BINARY(4) | 通用头的大小 |
| 68 | 44 | CHAR(4) | 结构的发行版和级别 |
| 72 | 48 | CHAR(8) | 格式名 |
| 80 | 50 | CHAR(10) | 使用的 API |
| 90 | 5A | CHAR(13) | 创建日期和时间 |
| 103 | 67 | CHAR (1) | 信息状态 |
| 104 | 68 | BINARY(4) | 已使用的用户空间大小 |
| 108 | 6C | BINARY(4) | 与输入参数部分的偏移量 |
| 112 | 70 | BINARY(4) | 输入参数部分的大小 |
| 116 | 74 | BINARY(4) | 标题部分的偏移量 |
| 120 | 78 | BINARY(4) | 标题部分的大小 |
| 124 | 7C | BINARY(4) | 列表数据部分的偏移量 |
| 128 | 80 | BINARY(4) | 列表数据部分的大小 |
| 132 | 84 | BINARY(4) | 列表条目数 |
| 136 | 88 | BINARY(4) | 每个条目的大小 |
| 140 | 8C | BINARY(4) | 列表项中数据的 CCSID |
| 144 | 90 | CHAR(2) | 国家或地区标识 |
| 146 | 92 | CHAR(3) | 语言标识 |
| 149 | 95 | CHAR (1) | 已划分子集的列表指示符 |
| 150 | 96 | CHAR (42) | 保留 |
通用头格式 0300
格式 0300 用于作为从 ILE 服务程序 (*SRVPGM) 导出的过程调用的列表 API。
| 偏移 | 类型 | 字段 | |
|---|---|---|---|
| Dec | 十六进制 | ||
| 0 | 0 | 0100 格式的所有内容 | |
| 192 | C0 | CHAR(256) | API 入口点名称 |
| 448 | 1C0 | CHAR(128) | 保留 |
字段描述
数据结构格式中的字段按字母顺序描述。
API 入口点名称。 生成列表的 ILE 可绑定 API 入口点的名称。
已使用 API。 对于格式 0100 ，这是生成列表的基于程序的 API 的名称。 对于格式 0300 ，这是保留字段。 请参阅所使用 API 的 API 入口点名称字段。
列表项中数据的 CCSID。 列表条目中数据的编码字符集标识。 如果值为 0 ，那么数据不与特定 CCSID 关联，并且应视为十六进制数据。
国家或地区标识。 写入用户空间的数据的国家或地区标识。
创建日期和时间。 创建列表的日期和时间。 该表显示了可能的值。
| 值 | 描述 |
|---|---|
| 1 | 世纪，其中 0 指示年份 19 xx ， 1 指示年份 20 xx。 |
| 2-7 | 日期，格式为 YYMMDD (年，月，日)。 |
| 8-13 | 一天中的时间，格式为 HHMMSS (小时，分钟，秒)。 |
格式名。 列表数据部分的格式的名称。
信息状态。 信息是否完整准确。 该表显示了可能的值。
| 值 | 描述 |
|---|---|
| C | 完整且准确。 |
| I | 未完成。 您收到的信息不准确或不完整。 |
| P | 部分但准确。 您接收到的信息是准确的，但 API 要返回的信息比用户空间所能容纳的信息更多。 有关部分列表的更多信息，请参阅 列表部分 。 |
语言标识。 写入用户空间的数据的语言标识。
列表条目数。 列表数据部分中的固定长度条目数。
(全部) 部分的偏移量。 从用户空间开始到部分开始的字节偏移量。
保留。 忽略的字段。
每个条目的大小。 每个列表数据段条目的大小 (以字节为单位)。 所有条目都是相同的大小。 对于返回可变长度记录的格式，此值为零。
通用头的大小。 通用头的大小 (以字节为单位)。 这不包括用户区域的大小。 请参阅 常规数据结构 以获取显示用户区域的图。
标题部分的大小。 头部分的大小 (以字节为单位)。
输入参数部分的大小。 输入参数部分的大小 (以字节为单位)。
列表数据部分的大小。 列表数据部分的大小 (以字节为单位)。 对于返回可变长度记录的格式，此值为零。
已使用的用户空间大小。 用户区域，通用头，输入参数部分，头部分和列表数据部分的组合大小 (以字节计)。 这将确定用户空间中的更改内容。
结构的发行版和级别。 此列表的通用头格式的发行版和级别。 此字段的值为 0100 (对于通用头格式 0100) 和 0300 (对于通用头格式 0300)。 列示将此值放入用户空间的 API。
子列表指示符。 指示是否可以以该格式存储从列表 API 中选择的数据的标志。 该表显示了可能的值。
| 值 | 描述 |
|---|---|
| 0 | 列表未被子化; 所有信息都可以以该格式存储。 |
| 1 | 列表已被细分。 例如，集成文件系统名称可能比格式中的可用区域长。 |
用户区域。 用户空间内的一个区域，供调用者用于在使用该用户空间的应用程序之间通信与系统程序员相关的信息。