

AWS 大型机现代化服务（托管运行时环境体验）不再向新客户开放。有关类似于 AWS 大型机现代化服务（托管运行时环境体验）的功能，请浏览 AWS 大型机现代化服务（自我管理体验）。现有客户可以继续正常使用该服务。有关更多信息，请参阅[AWS 大型机现代化可用性变更](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# LISTCAT JSON 格式
<a name="ba-shared-bac-listcat-json-format"></a>

LISTCAT JSON 格式由以下属性定义：
+ 可选的“catalogId”：遗留目录的标识符为一个字符串，默认目录的标识符为“default”。
+ “identifier”：数据集名称，为字符串。
+ “isIndexed”：指示 KSDS 的布尔标志：是 KSDS 时，为 true，否则为 false。
+ “isLinear”：指示 ESDS 的布尔标志：是 ESDS 时，为 true，否则为 false。
+ “isRelative”：指示 RRDS 的布尔标志，是 RRDS 时，为 true，否则为 false。
+ **注意**：“isIndexed”、“isLinear”和“isRelative”是互斥的。
+ “isFixedLength记录”：布尔标志：如果设置了固定长度的记录，则设置为 true，否则设置为 false。
+ “avgRecordSize“: 以字节为单位的平均记录大小，以正整数表示。
+ “maxRecordSize“: 以字节为单位的最大记录大小，以整数表示。 avgRecordSize 对于固定长度的记录大小，应等于。
+ 仅针对 KSDS：必需的主键定义（作为嵌套对象）
  + 标有“primaryKey”
  + “offset”：主键在记录中基于 0 的字节偏移量。
  + “length”：主键的长度（以字节为单位）。
  + “unique”：对于主键，必须设置为 true。
+ 对于 KSDS/ESDS，备用键集合（作为嵌套对象的集合）：
  + 标有“alternateKeys”
  + 对于每个备用键：
    + “offset”：备用键在记录中基于 0 的字节偏移量。
    + “length”：备用键的长度（以字节为单位）。
    + “unique”：如果备用键不接受重复条目，则必须设置为 true，否则设置为 false。
+ 如果没有备用键，请提供一个空集合：

  ```
  alternateKeys: []
  ```

下面是一个示例 KSDS LISTCAT JSON 文件。

```
{
  "catalogId": "default",
  "identifier": "AWS_M2_CARDDEMO_CARDXREF_VSAM_KSDS",
  "isIndexed": true,
  "isLinear": false,
  "isRelative": false,
  "isFixedLengthRecord": true,
  "avgRecordSize": 50,
  "maxRecordSize": 50,
  "primaryKey": {
    "offset": 0,
    "length": 16,
    "unique": true
  },
  "alternateKeys": [
    {
      "offset": 25,
      "length": 11,
      "unique": false
    }
  ]
}
```