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

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

# 大型机 AWS 变换中 Gapwalk 应用程序的端点
<a name="ba-endpoints-gapwalk"></a>

在本主题中，了解 Gapwalk Web 应用程序的端点。这些端点使用根路径 `/gapwalk-application`。

**Topics**
+ [Batch 作业（现代 JCLs 化和类似的）相关端点](#ba-endpoints-gapwalk-batch)
+ [指标端点](#ba-endpoints-gapwalk-metrics)
+ [其他端点](#ba-endpoints-gapwalk-other)
+ [作业队列相关端点](#ba-endpoints-gapwalk-jobq)

## Batch 作业（现代 JCLs 化和类似的）相关端点
<a name="ba-endpoints-gapwalk-batch"></a>

批处理作业既可以同步运行，也可以异步运行（请参阅以下详细信息）。批处理作业是使用 groovy 脚本执行的，这些脚本是遗留脚本（JCL）现代化的结果。

**Topics**
+ [列出已部署的脚本](#ba-list-deployed-scripts)
+ [同步启动脚本](#ba-launch-script-synchronously)
+ [异步启动脚本](#ba-launch-script-asynchronously)
+ [列出触发的脚本](#ba-launch-script-triggered)
+ [检索作业执行详细信息](#ba-retrieve-job-execution-details)
+ [列出可以终止的异步启动脚本](#ba-list-async-scripts)
+ [列出可以终止的同步启动脚本](#ba-list-sync-scripts)
+ [终止给定的作业执行](#ba-kill-job-execution)
+ [列出用于实现可重启性的现有检查点](#ba-list-existing-checkpoints)
+ [重新启动作业（同步）](#ba-restart-job-sync)
+ [重新启动作业（异步）](#ba-restart-job-async)
+ [为异步作业执行设置线程限值](#ba-set-thread-limit)

### 列出已部署的脚本
<a name="ba-list-deployed-scripts"></a>
+ 支持的方法：GET

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`/scripts`
+ 参数：无
+ 此端点以字符串形式返回服务器上已部署的 groovy 脚本列表。此端点主要从 Web 浏览器中使用，因为返回的字符串是一个 HTML 页面，其中包含活动链接（每个可启动脚本一个链接，请参阅以下示例）。

示例响应:

```
<p><a href=./script/COMBTRAN>COMBTRAN</a></p><p><a href=./script/CREASTMT>CREASTMT</a></p><p><a href=./script/INTCALC>INTCALC</a></p><p><a href=./script/POSTTRAN>POSTTRAN</a></p><p><a href=./script/REPROC>REPROC</a></p><p><a href=./script/TRANBKP>TRANBKP</a></p><p><a href=./script/TRANREPT>TRANREPT</a></p><p><a href=./script/functions>functions</a></p>
```

**注意**  
这些链接是用于**同步**启动每个列出的脚本的 URL。
+ 支持的方法：GET/POST

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`/triggerscripts`
+ 参数：无
+ 此端点以字符串形式返回服务器上已部署的 groovy 脚本列表。此端点主要从 Web 浏览器中使用，因为返回的字符串是一个 HTML 页面，其中包含活动链接（每个可启动脚本一个链接，请参阅以下示例）。

  与之前的端点响应相反，这些链接是用于**异步**启动每个列出的脚本的 URL。  
![\[列出脚本示例（浏览器视图）\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/trigger_scripts.png)

### 同步启动脚本
<a name="ba-launch-script-synchronously"></a>

此端点有两个变体，分别针对 GET 和 POST 方法使用专用路径（请参阅下文）。
+ 支持的方法：GET

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`/script/{scriptId:.+}`
+ 支持的方法：POST

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`/post/script/{scriptId:.+}`
+ 参数：
  + 要启动**输入验证**的脚本的标识符：脚本 ID 不能为空，不能超过 255 个字符，并且必须与以下模式匹配：`^[a-zA-Z0-9._-]+$`
  + 可选：使用请求参数（显示为 `Map<String,String>`）传递给脚本的参数。给定的参数将自动添加到调用的 groovy 脚本的[绑定](https://docs.groovy-lang.org/latest/html/api/groovy/lang/Binding.html)中。**输入验证**：参数映射不能超过 50 个条目。
+ 该调用使用可选参数执行脚本（由 ScriptId 标识），并等待完成后再返回带以下任一参数的：*ResponseEntityString*
  + HTTP 200：“完成。” 或成功执行时的 JSON 成功消息
  + HTTP 200：包含执行失败详细信息的 JSON 错误消息。其他信息可在服务器日志中找到。
**注意**  
运行时现在支持为失败的任务执行返回 HTTP 500 状态码。要配置此响应代码[，请参阅主应用程序的可用属性](https://docs.aws.amazon.com/m2/latest/userguide/ba-runtime-key-value.html#ba-runtime-key-value-main)。
  + **输入验证**：无效的脚本 ID 或参数将返回包含验证错误详细信息的 HTTP 400 错误请求。

    ```
    {
        "exitCode": -1,
        "stepName": "STEP15",
        "program": "CBACT04C",
        "status": "Error"
    }
    ```

    通过查看服务器日志，可以发现此处出现了部署问题（预期的程序未正确部署，因此无法被找到，导致作业执行失败）：  
![\[脚本执行错误示例\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/script_exec_error_logs.png)

**注意**  
同步调用应用于短时间运行的作业。长时间运行的作业应采用异步启动（请参阅以下专用端点）。

### 异步启动脚本
<a name="ba-launch-script-asynchronously"></a>
+ 支持的方法：GET/POST

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`/triggerscript/{scriptId:.+}`
+ 参数：
  + 要启动**输入验证**的脚本的标识符：脚本 ID 不能为空，不能超过 255 个字符，并且必须与以下模式匹配：`^[a-zA-Z0-9._-]+$`
  + 可选：使用请求参数（显示为 `Map<String,String>`）传递给脚本的参数。给定的参数将自动添加到调用的 groovy 脚本的[绑定](https://docs.groovy-lang.org/latest/html/api/groovy/lang/Binding.html)中。**输入验证**：参数映射不能超过 50 个条目。
+ 与上面的同步模式相反，此端点不会等待作业执行完成后再发送响应。如果可以找到可用的线程，作业执行会立即启动，并立即向调用方发送响应。响应中包含作业执行 ID（表示作业执行的唯一标识符），该 ID 可用于查询作业执行状态或强制终止出现故障的作业执行。响应的格式为：

  ```
  Triggered script <script identifier> [unique job execution id] @ <date and time>
  ```
+ 由于作业异步执行依赖于固定、有限数量的线程，因此如果找不到可用的线程，则可能无法启动作业执行。在这种情况下，返回的消息将如下所示：

  ```
  Script [<script identifier>] NOT triggered - Thread limit reached (<actual thread limit>) - Please retry later or increase thread limit.
  ```

  请参阅下文的 `settriggerthreadlimit` 端点，了解如何提高线程限制。

示例响应:

```
Triggered script INTCALC [d43cbf46-4255-4ce2-aac2-79137573a8b4] @ 06-12-2023 16:26:15
```

借助唯一作业执行标识符，您可以根据需要快速检索服务器日志中的相关日志条目。其他几个端点也会使用该标识符，详细信息如下文所述。

### 列出触发的脚本
<a name="ba-launch-script-triggered"></a>
+ 支持的方法：GET/POST

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`/triggeredscripts/{status:.+}`、`/triggeredscripts/{status:.+}/{namefilter}`
+ 参数：
  + Status（必需）：要检索的已触发脚本的状态。**输入验证**：状态不能为空且不能超过 50 个字符。可能的值为：
    + `all`：显示所有作业执行详细信息，无论作业是否仍在运行。
    + `running`：仅显示当前正在运行的作业的作业详细信息。
    + `done`：仅显示已结束执行的作业的作业详细信息。
    + `killed`：仅显示已使用专用端点强制终止执行的作业的作业详细信息（请参阅下文）。
    + `triggered`：仅显示已触发但尚未启动的作业的作业详细信息。
    + `failed`：仅显示已标记为执行失败的作业的作业详细信息。
    + \$1namefilter（可选）\$1：仅检索给定脚本标识符的执行。**输入验证**：不能超过 255 个字符
+ 以 JSON 形式返回作业执行详细信息的集合。有关更多信息，请参阅 [作业执行详细信息消息结构](ba-endpoints-apx.md#job-execution-details)。

示例响应:

```
[
    {
      "scriptId": "INTCALC",
      "caller": "127.0.0.1",
      "identifier": "d43cbf46-4255-4ce2-aac2-79137573a8b4",
      "startTime": "06-12-2023 16:26:15",
      "endTime": "06-12-2023 16:26:15",
      "status": "DONE",
      "executionResult": "{ \"exitCode\": -1, \"stepName\": \"STEP15\", \"program\": \"CBACT04C\", \"status\": \"Error\" }",
      "executionMode": "ASYNCHRONOUS"
    }
  ]
```

### 检索作业执行详细信息
<a name="ba-retrieve-job-execution-details"></a>
+ 支持的方法：GET

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`/getjobexecutioninfo/{jobexecutionid:.+}`
+ 参数：
  + jobexecutionid（必需）：用于检索相应作业执行详细信息的唯一作业执行标识符。**输入验证**：Job 执行 ID 不能为空且不能超过 255 个字符
+ 返回表示单个作业执行详细信息的 JSON 字符串（请参阅[作业执行详细信息消息结构](ba-endpoints-apx.md#job-execution-details)），如果根据给定标识符找不到相应的作业执行详细信息，则响应为空。

### 列出可以终止的异步启动脚本
<a name="ba-list-async-scripts"></a>
+ 支持的方法：GET

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`/killablescripts`
+ 返回一组异步启动作业的作业执行标识符，这些作业当前仍在运行并且可以被强制终止（请参阅下文的 `/kill` 端点）。

### 列出可以终止的同步启动脚本
<a name="ba-list-sync-scripts"></a>
+ 支持的方法：GET

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`/killablesyncscripts`
+ 返回一组同步启动作业的作业执行标识符，这些作业当前仍在运行并且可以被强制终止（请参阅下文的 `/kill` 端点）。

### 终止给定的作业执行
<a name="ba-kill-job-execution"></a>
+ 支持的方法：POST

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN
+ 路径：`/kill/{identifier:.+}`
+ 参数：作业执行标识符（必需）：要强制终止的作业执行的唯一作业执行标识符。**输入验证**：标识符不能为空且不能超过 255 个字符
+ 返回一条详细描述作业执行终止尝试结果的文本消息；该消息将包含脚本标识符、作业执行唯一标识符以及执行终止发生的日期和时间。如果找不到具有给定标识符且正在运行的作业执行，则将返回一条错误消息。

**警告**  
 运行时会尽最大努力合理地终止目标作业执行。因此，来自 /kill 端点的响应可能需要一点时间才能到达调用方，因为大型机的 Tr AWS ansform 运行时会尽量减少终止任务对业务的影响。
强制终止作业执行应引起注意，因为它可能会产生直接的业务后果，包括可能的数据丢失或损坏。强制终止应该用于给定作业执行出现意外情况且已明确确定数据补救措施的情况。
终止作业后，应进行进一步的调查（事后分析），以找出问题所在，并采取适当的补救措施。
在任何情况下，终止正在运行的作业的尝试都会记录在服务器日志中，并提供警告级别的消息。

### 列出用于实现可重启性的现有检查点
<a name="ba-list-existing-checkpoints"></a>

作业可重启性依赖于脚本能否在 `CheckpointRegistry` 中注册检查点来跟踪作业执行进度。如果作业执行未能正常结束，并且已经注册了重新启动检查点，则只需从最后一个已知的已注册检查点重新启动作业执行即可（无需执行检查点之前的先行步骤）。
+ 支持的方法：POST

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN
+ 路径：`/restarts/{scriptId}/{jobId}`
+ 参数：
  + scriptId（可选，字符串）：正在重新启动的脚本。
  + jobId（可选，字符串）：作业执行的唯一标识符。
+ 返回现有重启检查点的 JSON 格式的列表，这些重启检查点可用于重新启动未正确执行和结束的作业，或通过绕过先前已执行的步骤触发延迟的重启。如果任何脚本都未注册任何检查点，则页面内容会显示“未注册检查点。”

### 重新启动作业（同步）
<a name="ba-restart-job-sync"></a>
+ 支持的方法：POST

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN
+ 路径：`/restart/{hashcode}/{scriptId}/{skipflag}`
+ 参数：
  + hashcode（必需，整数）：使用提供的哈希码作为检查点值（请参阅上文的 `/restarts` 端点，以了解如何检索有效的检查点值），重新启动最近的作业执行。
  + scriptId（可选，字符串）：正在重新启动的脚本。
  + skipflag（可选，布尔值）：跳过所选（检查点）步骤的执行并从直接后续步骤（如果有）发起重新启动。
+ 返回：请参阅上文的 `/script` 返回内容描述。

### 重新启动作业（异步）
<a name="ba-restart-job-async"></a>
+ 支持的方法：GET

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`/triggerrestart/{hashcode}/{scriptId}/{skipflag}`
+ 参数：
  + hashcode（必需，整数）：使用提供的哈希码作为检查点值（请参阅上文的 `/restarts` 端点，以了解如何检索有效的检查点值），重新启动最近的作业执行。
  + scriptId（可选，字符串）：正在重新启动的脚本。
  + skipflag（可选，布尔值）：跳过所选（检查点）步骤的执行并从直接后续步骤（如果有）发起重新启动。
+ 返回：请参阅上文的 `/triggerscript` 返回内容描述。

### 为异步作业执行设置线程限值
<a name="ba-set-thread-limit"></a>

作业异步执行依赖于 JVM 中的专用线程池。该池对可用线程的数量有固定的限值。用户能够根据主机容量（数量 CPUs、可用内存等）调整限制。默认情况下，线程限值设置为 5 个线程。
+ 支持的方法：POST

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN
+ 路径：`/settriggerthreadlimit/{threadlimit:.+}`
+ 参数（整数）：要应用的新线程限值。**输入验证**：必须介于 1 到 1000 之间（含）。
+ 返回一条消息 (`String`)，其中包括新的线程限制值和前一个线程限值；如果提供的线程限值无效（不是严格的正整数），则返回错误消息。

示例响应:

```
Set thread limit for Script Tower Control to 10 (previous value was 5)
```

#### 计算当前正在运行的已触发任务执行个数
<a name="ba-count-current-jobs"></a>
+ 支持的方法：GET

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`/countrunningtriggeredscripts`
+ 返回一条消息，指示正在运行的异步启动作业数和线程限值（即可以同时运行的最大已触发作业数）。

示例响应:

```
0 triggered script(s) running (limit =10)
```

**注意**  
此端点可用于在启动作业之前检查是否未达到线程限值（达到该值时，将阻止作业启动）。

#### 清除作业执行信息
<a name="ba-purge-job-info"></a>

只要服务器启动，作业执行信息就会保留在服务器内存中。此端点可便于清除内存中较旧的信息，因为这些信息已经不适用。
+ 支持的方法：POST

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN
+ 路径：`/purgejobinformation/{age:.+}`
+ 参数：一个严格的正整数值，表示要清除信息的留存时间（以小时为单位）。**输入验证**：必须介于 0 到 365 之间（含）。
+ 返回一条包含以下信息的消息：
  + 清除文件的名称，该文件存储已清除的作业执行信息以供存档。
  + 已清除的作业执行信息的数量。
  + 内存中剩余的作业执行信息数量。

## 指标端点
<a name="ba-endpoints-gapwalk-metrics"></a>

**输入验证**：所有指标端点都会验证请求参数，如果值无效，则返回 HTTP 400 错误请求。

### JVM
<a name="ba-metrics-jvm"></a>

此端点返回与 JVM 相关的可用指标。
+ 支持的方法：GET

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`/metrics/jvm`
+ 参数：无
+ 返回一条包含以下信息的消息：
  + threadActiveCount：活动线程数。
  + jvmMemoryUsed：Java 虚拟机正在使用的内存。
  + jvmMemoryMax：Java 虚拟机允许的最大内存。
  + jvmMemoryFree：Java 虚拟机当前未使用的可用内存。

### 会话
<a name="ba-metrics-session"></a>

此端点返回与当前打开的 HTTP 会话相关的指标。
+ 支持的方法：GET

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`/metrics/session`
+ 参数：无
+ 返回一条包含以下信息的消息：
  + sessionCount：服务器当前维护的活跃用户会话数。

### 批处理
<a name="ba-metrics-batch"></a>
+ 支持的方法：GET

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`/metrics/batch`
+ 参数：
  + startTimestamp（可选，数字）：用于数据筛选的起始时间戳。**输入验证**：必须是有效的数值。
  + endTimestamp（可选，数字）：用于数据筛选的结束时间戳。**输入验证**：必须是有效的数值。
  + page（可选，数字）：用于分页的页码。**输入验证**：必须为正整数。
  + pageSize（可选，数字）：分页中每页的项目数。**输入验证**：必须是严格的正整数，最大值为 500。
  + **输入验证**：参数映射不能超过 20 个条目
+ 返回一条包含以下信息的消息：
  + content：批量执行指标的列表。
  + pageNumber：分页中的当前页码。
  + pageSize：每页显示的项目数。
  + totalPages：可用的总页数。
  + numberOfElements：当前页面上的项目数。
  + last：最后一页的布尔标志。
  + first：第一页的布尔标志。

### 事务
<a name="ba-metrics-transaction"></a>
+ 支持的方法：GET

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`/metrics/transaction`
+ 参数：
  + startTimestamp（可选，数字）：用于数据筛选的起始时间戳。**输入验证**：必须是有效的数值。
  + endTimestamp（可选，数字）：用于数据筛选的结束时间戳。**输入验证**：必须是有效的数值。
  + page（可选，数字）：用于分页的页码。**输入验证**：必须为正整数。
  + pageSize（可选，数字）：分页中每页的项目数。**输入验证**：必须是严格的正整数，最大值为 500。
  + **输入验证**：参数映射不能超过 20 个条目
+ 返回一条包含以下信息的消息：
  + content：批量执行指标的列表。
  + pageNumber：分页中的当前页码。
  + pageSize：每页显示的项目数。
  + totalPages：可用的总页数。
  + numberOfElements：当前页面上的项目数。
  + last：最后一页的布尔标志。
  + first：第一页的布尔标志。

## 其他端点
<a name="ba-endpoints-gapwalk-other"></a>

使用以下端点列出已注册的程序或服务、了解运行状况和管理 JICS 事务。

**Topics**
+ [列出已注册程序](#ba-list-registered-programs)
+ [列出已注册服务](#ba-list-registered-services)
+ [运行状况](#ba-health-status)
+ [列出可用的 JICS 事务](#ba-list-jics-transactions)
+ [启动 JICS 事务](#ba-launch-jics-transaction)
+ [启动 JICS 事务（备用）](#ba-launch-jics-transaction-alt)
+ [列出活动会话](#ba-active-session-list)

### 列出已注册程序
<a name="ba-list-registered-programs"></a>
+ 支持的方法：GET

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`/programs`
+ 以 html 页面的形式返回已注册程序的列表。每个程序都由其主程序标识符指定。返回的列表中包含经过现代化改造的遗留程序和实用程序（IDCAMS、IEBGENER等...）。请注意，可用的实用程序将取决于您的 tomcat 服务器上部署的实用程序 Web 应用程序。例如， z/OS 公用事业支持计划可能不适用于现代化的 iSeries 资产，因为它们无关紧要。

### 列出已注册服务
<a name="ba-list-registered-services"></a>
+ 支持的方法：GET

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`/services`
+ 以 html 页面的形式返回已注册运行时服务的列表。给定的服务由 Tr AWS ansform for 大型机运行时作为实用程序提供，例如，可以在 groovy 脚本中使用。Blusam 加载服务（从遗留数据集创建 Blusam 数据集）属于此类服务。

示例响应:

```
<p>BluesamESDSFileLoader</p><p>BluesamKSDSFileLoader</p><p>BluesamRRDSFileLoader</p>
```

### 运行状况
<a name="ba-health-status"></a>
+ 支持的方法：GET

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`/`
+ 返回一条简单消息，表明 gapwalk-application 已启动并正在运行 (`Jics application is running.`)

### 列出可用的 JICS 事务
<a name="ba-list-jics-transactions"></a>
+ 支持的方法：GET

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`/transactions`
+ 返回一个 html 页面，其中列出了所有可用的 JICS 事务。这仅适用于具有 JICS 元素（对遗留 CICS 元素进行现代化）的环境。

示例响应:

```
<p>INQ1</p><p>MENU</p><p>MNT2</p><p>ORD1</p><p>PRNT</p>
```

### 启动 JICS 事务
<a name="ba-launch-jics-transaction"></a>
+ 支持的方法：POST

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`/jicstransrunner/{jtrans:.+}`
+ 参数：
  + JICS 事务标识符（字符串，必需）：要启动的 JICS 事务的标识符（最多 8 个字符）
  + 必需：以 Map<String,Object> 形式传递给事务的其他输入数据。该映射的内容用于提供由 JICS 事务使用的 [COMMAREA](https://www.ibm.com/docs/en/cics-ts/5.4?topic=programs-commarea)。如果运行事务不需要任何数据，则该映射可以为空。
  + 可选：Http 标头条目，用于自定义给定事务的运行环境。支持以下标头键：
    + `jics-channel`：将在本事务启动时启动的程序要使用的 JICS CHANNEL 的名称。
    + `jics-container`：用于启动此 JICS 事务的 JICS 容器的名称。
    + `jics-startcode`：在 JICS 事务启动时使用的 STARTCODE（字符串，最多 2 个字符）。有关可能的值，请参阅 [STARTCODE](https://www.ibm.com/docs/en/cics-ts/5.5?topic=summary-assign)（向下浏览页面）。
    + `jicxa-xid`：由调用方发起的“全局事务”（[XA](https://en.wikipedia.org/wiki/X/Open_XA)）的 XID（X/Open 事务标识符 XID 结构），当前的 JICS 事务启动将参与该全局事务。**输入验证**：XID 不能为空且不能超过 255 个字符。
+ 返回表示 JICS 事务启动结果的 `com.netfective.bluage.gapwalk.rt.shared.web.TransactionResultBean` JSON 序列化。
+ **输入验证**：无效的 XID 值（空白或超过 255 个字符）将返回包含验证错误详细信息的 HTTP 400 错误请求。

有关该结构的更多详细信息，请参阅[事务启动结果结构](ba-endpoints-apx.md#transaction-outcome)。

### 启动 JICS 事务（备用）
<a name="ba-launch-jics-transaction-alt"></a>
+ 支持的方法:POST

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`/jicstransaction/{jtrans:.+}`
+ 参数：  
**JICS 事务标识符（字符串，必需）**  
要启动的 JICS 事务的标识符（长度为最多 8 个字符）  
**必需：以 Map<String,Object> 形式传递给事务的其他输入数据**  
该映射的内容用于提供由 JICS 事务使用的 [COMMAREA](https://www.ibm.com/docs/en/cics-ts/5.4?topic=programs-commarea)。如果运行事务不需要任何数据，则该映射可以为空。  
**可选：Http 标头条目，用于自定义给定事务的运行环境。**  
支持以下标头键：  
  + `jics-channel`：将在本事务启动时启动的程序要使用的 JICS CHANNEL 的名称。
  + `jics-container`：用于启动此 JICS 事务的 JICS 容器的名称。
  + `jics-startcode`：在 JICS 事务启动时使用的 STARTCODE（字符串，最多 2 个字符）。有关可能的值，请参阅 [STARTCODE](https://www.ibm.com/docs/en/cics-ts/5.5?topic=summary-assign)（向下浏览页面）。
  + `jicxa-xid`：由调用方发起的“全局事务”([XA](https://en.wikipedia.org/wiki/X/Open_XA)) 的 XID（X/Open 事务标识符 XID 结构），当前的 JICS 事务启动将参与该全局事务。**输入验证**：XID 不能为空且不能超过 255 个字符。
+ 返回表示 JICS 事务启动结果的 `com.netfective.bluage.gapwalk.rt.shared.web.RecordHolderBean` JSON 序列化。有关该结构的详细信息，请参阅[事务启动记录结果结构](ba-endpoints-apx.md#transaction-record-outcome)。
+ **输入验证**：无效的 XID 值（空白或超过 255 个字符）将返回包含验证错误详细信息的 HTTP 400 错误请求。

### 列出活动会话
<a name="ba-active-session-list"></a>
+ 支持的方法：GET

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN
+ 路径：`/activesessionlist`
+ 参数：无
+ **输入验证**：参数映射不能超过 20 个条目
+ 返回 JSON 序列化形式的 `com.netfective.bluage.gapwalk.application.web.sessiontracker.SessionTrackerObject` 列表，表示活动用户会话的列表。如果禁用了会话跟踪，将会返回空列表。

## 作业队列相关端点
<a name="ba-endpoints-gapwalk-jobq"></a>

 作业队列是 AS400 作业提交机制支持大型机的 AWS 转换。Job 队列 AS400 用于在特定线程池上运行作业。作业队列由名称和最大线程数定义，最大线程数对应于该队列上可以同时运行的最大程序数。如果队列中提交的作业大于最大线程数，则作业将等待线程可用。

有关队列中作业状态的详尽列表，请参阅[队列中作业的可能状态](ba-endpoints-apx.md#jobs-status)。

作业队列上的操作通过以下专用端点处理。可以使用以下根 URL 从 Gapwalk 应用程序 URL 调用这些操作：`http://server:port/gapwalk-application/jobqueue`。

**Topics**
+ [列出可用的队列](#ba-list-available-queues)
+ [启动或重新启动作业队列](#ba-start-restart-queue)
+ [提交要启动的作业](#ba-submit-job-launch)
+ [列出所有已提交的作业](#ba-list-scheduled-jobs)
+ [释放所有“暂停”作业](#ba-release-held-jobs)
+ [释放给定作业名称下所有处于“暂停”状态的作业](#ba-release-held-jobs-name)
+ [释放具有给定作业编号的作业](#ba-release-job-number)
+ [按重复计划提交作业](#ba-submit-job-on-repeating-schedule)
+ [列出所有已提交的重复作业](#ba-list-all-submitted-repeating-jobs)
+ [取消重复作业的计划](#ba-cancel-scheduling-of-repeating-job)

### 列出可用的队列
<a name="ba-list-available-queues"></a>
+ 支持的方法：GET

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`list-queues`
+ 以 JSON 键值列表的形式返回可用队列列表及其状态。

示例响应:

```
{"Default":"STAND_BY","queue1":"STARTED","queue2":"STARTED"}
```

作业队列的可能状态为：

**STAND\$1BY**  
作业队列正在等待启动。

**STARTED**  
作业队列已启动并正在运行。

**UNKNOWN**  
无法确定作业队列状态。

### 启动或重新启动作业队列
<a name="ba-start-restart-queue"></a>
+ 支持的方法：POST

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN
+ 路径：`/restart/{name}`
+ 参数：要启动/重新启动的队列的名称（必需，字符串）。**输入验证**：队列名称不得为空且不能超过 255 个字符。
+ 端点不返回任何内容，而是依赖 http 状态来指示 start/restart 操作的结果：  
**HTTP 200**  
 start/restart 操作进展顺利：给定的任务队列现已启动。  
**HTTP 404**  
作业队列不存在。  
**HTTP 503**  
 start/restart 尝试期间出现异常（应检查服务器日志以找出问题所在）。

### 提交要启动的作业
<a name="ba-submit-job-launch"></a>
+ 支持的方法：POST

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`/submit`
+ 参数：（必需，请求体）`com.netfective.bluage.gapwalk.rt.jobqueue.SubmitJobMessage` 对象的 JSON 序列化。有关更多信息，请参阅 [提交作业和计划作业输入](ba-endpoints-apx.md#submit-job)。
+ 返回包含原始 `SubmitJobMessage` 的 JSON 和指示作业是否已提交的日志。

### 列出所有已提交的作业
<a name="ba-list-scheduled-jobs"></a>
+ 支持的方法：GET

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`/list-jobs?status={status}&size={size}&page={page}&sort={sort}`
+ 参数：
  + page：要检索的页码（默认值 = 1）
  + size：页面的大小（默认值 = 50，最大值 = 300）
  + sort：作业的顺序。（默认值 =“executionId”）。“executionId”是目前支持的唯一值
  + status：（可选）如果提供，它将根据状态执行筛选。
+ 以 JSON 字符串的形式返回所有计划作业的列表。有关响应示例，请参阅[计划作业响应列表](ba-endpoints-apx.md#list-scheduled-jobs)。

### 释放所有“暂停”作业
<a name="ba-release-held-jobs"></a>
+ 支持的方法：POST

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`/release-all`
+ 返回一条消息，指示释放尝试操作的结果。这里有两种可能的情况：
  + HTTP 200 和消息“所有作业均已成功释放！” （如果所有作业均已成功释放）。
  + HTTP 503 和消息“作业未释放。出现未知错误。有关更多详细信息，请参阅日志”（如果释放尝试出现问题）。

### 释放给定作业名称下所有处于“暂停”状态的作业
<a name="ba-release-held-jobs-name"></a>

对于给定的作业名称，可以提交多个具有不同作业编号的作业（作业运行的唯一性由一组 <job name, job number> 来保证）。此端点将尝试释放具有给定作业名称的所有处于“暂停”状态的作业提交。
+ 支持的方法：POST

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`/release/{name}`
+ 参数：要查找的作业名称，为字符串。必需。
+ 返回一条消息，指示释放尝试操作的结果。这里有两种可能的情况：
  + HTTP 200 和消息 “组 <name> (<number of released jobs>) 中的作业已成功释放！” （如果作业已成功释放）。
  + HTTP 503 和消息“组 <name> 中的作业未释放。出现未知错误。有关更多详细信息，请参阅日志”（如果释放尝试出现问题）。

### 释放具有给定作业编号的作业
<a name="ba-release-job-number"></a>

此端点将尝试释放具有给定 <job name, job number> 且处于“暂停”状态的唯一作业提交。
+ 支持的方法：POST

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`/release/{name}/{number}`
+ 参数：  
**name**  
参数：要查找的作业名称，为字符串。必需。  
**数字**  
要查找的作业编号，以整数表示。必需。  
**返回**  
 一条消息，指示释放尝试操作的结果。这里有两种可能的情况：  
  + HTTP 200 和消息“作业 <name/number> 已成功释放！” （如果该作业已成功释放）。
  + HTTP 503 和消息“作业 <name/number>> 未释放。出现未知错误。有关更多详细信息，请参阅日志”（如果释放尝试出现问题）。

### 按重复计划提交作业
<a name="ba-submit-job-on-repeating-schedule"></a>

安排将按重复计划执行的作业。
+ 支持的方法：POST

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN、ROLE\$1USER
+ 路径：`/schedule`
+ 参数：请求正文必须包含 `com.netfective.bluage.gapwalk.rt.jobqueue.SubmitJobMessage` 对象的 JSON 序列化。

### 列出所有已提交的重复作业
<a name="ba-list-all-submitted-repeating-jobs"></a>
+ 支持的方法：GET

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN
+ 路径：`/schedule/list?status={status}&size={size}&page={page}&sort={sort}`
+ 参数：

  1. page：要检索的页码（默认值 = 1）

  1. size：页面的大小（默认值 = 50，最大值 = 300）

  1. sort：作业的顺序。（默认值 =“id”）。“id”是目前支持的唯一值。

  1. status：（可选）如果提供，它将根据状态执行筛选。可能的值是第 1 部分中提到的值。

  1. status：（可选）如果提供，它将根据状态执行筛选。可能的值是第 1 部分中提到的值。

  1. 以 JSON 字符串的形式返回所有计划作业的列表。

### 取消重复作业的计划
<a name="ba-cancel-scheduling-of-repeating-job"></a>

删除按重复计划创建的作业。作业计划状态设置为“INACTIVE”。
+ 支持的方法：POST

  需要身份验证和以下角色之一：ROLE\$1ADMIN、ROLE\$1SUPER\$1ADMIN
+ 路径：`/schedule/remove/{schedule_id}`
+ 参数：`schedule_id`，要删除的计划作业的标识符。