AWS Blu Age 使用者的資料結構 - AWS 大型主機現代化
任務執行詳細資訊訊息結構交易啟動結果結構交易啟動記錄結果結構佇列上任務的可能狀態提交任務並排程任務輸入排程任務回應的清單重複任務回應的清單

AWS Mainframe Modernization Service （受管執行期環境體驗） 不再向新客戶開放。對於與 AWS Mainframe Modernization Service （受管執行期環境體驗） 類似的功能，探索 AWS Mainframe Modernization Service （自我管理體驗）。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱AWS 大型主機現代化可用性變更。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

AWS Blu Age 使用者的資料結構

您可以在下一節中了解 AWS Blu Age 引擎的各種資料結構。

任務執行詳細資訊訊息結構

每個任務執行詳細資訊都會有下列欄位：

scriptId

呼叫指令碼的識別符。

呼叫者

發起人的 I.P. 地址。

identifier

唯一的任務執行識別符。

startTime

任務執行開始的日期和時間。

endTime

任務執行結束的日期和時間。

status

任務執行的狀態。一個可能的數值：

  • DONE：任務執行正常結束。

  • TRIGGERED：任務執行已觸發，但尚未啟動。

  • RUNNING：任務執行正在執行。

  • KILLED：任務執行已終止。

  • FAILED：任務執行失敗。

executionResult

訊息，以加總任務執行的結果。如果任務執行尚未完成，此訊息可以是簡單的訊息，也可以是具有下列欄位的 JSON 結構：

  • exitCode：數字結束碼；負值表示失敗情況。

  • 程式：任務啟動的最新程式。

  • 狀態：一個可能的數值：

    • Error：當 exitCode = -1 時；這對應於任務執行期間發生的 （技術） 錯誤。

    • Failed：當 exitcode = -2 時；這對應於服務程式執行期間發生的失敗 （例如 ABEND 情況）。

    • Succeeded：當 exitCode >= 0 時；

  • stepName：任務中執行的最新步驟名稱。

executionMode

SYNCHRONOUS 或 ASYNCHRONOUS，取決於任務的啟動方式。

輸出範例：

{
    "scriptId": "INTCALC",
    "caller": "127.0.0.1",
    "identifier": "97d410be-efa7-4bd3-b7b9-d080e5769771",
    "startTime": "06-09-2023 11:42:41",
    "endTime": "06-09-2023 11:42:42",
    "status": "DONE",
    "executionResult": "{ \"exitCode\": -1, \"stepName\": \"STEP15\", \"program\": \"CBACT04C\", \"status\": \"Error\" }",
    "executionMode": "ASYNCHRONOUS"
  }

交易啟動結果結構

結構可能包含下列欄位：

outCome

代表交易執行結果的字串。可能值為：

  • Success：交易執行正常結束。

  • Failure：交易執行無法正常結束，遇到一些問題 （某些問題）。

逗號

代表 COMMAREA 最終值的字串，以位元組 64 編碼的位元組陣列表示。可能是空字串。

containerRecord

（選用） 字串，以位元組 64 編碼位元組陣列表示 CONTAINER 的記錄內容。

serverDescription

可能包含提供請求之伺服器的相關資訊 （用於除錯目的）。可能是空字串。

abendCode

（選用） 如果已中止啟動的交易所參考的程式，則抽象程式碼值會傳回為此欄位中的字串。

回應範例：

成功

{
    "outCome": "Success",
    "commarea": "",
    "serverDescription": ""
  }

失敗

{
    "outCome": "Failure",
    "commarea": "",
    "serverDescription": "",
    "abendCode": "AEIA"
  }

交易啟動記錄結果結構

結構可能包含下列欄位：

recordContent

代表 COMMAREA 記錄內容的字串，以位元組 64 編碼的位元組陣列表示。

containerRecord

字串，以位元組 64 編碼位元組陣列表示 CONTAINER 的記錄內容。

serverDescription

可能包含提供請求之伺服器的相關資訊 （用於除錯目的）。可能是空字串。

回應範例：

成功

{
    "recordContent": "",
    "serverDescription": ""
}

佇列上任務的可能狀態

在佇列上，任務可以具有下列狀態：

ACTIVE

任務目前正在佇列上執行。

EXECUTION_WAIT

任務正在等待執行緒可用。

已排程

任務排定在特定日期和時間執行。

HOLD

任務正在等待釋放，然後再執行。

COMPLETED (已完成)

任務已成功執行。

失敗

任務執行失敗。

UNKNOWN (不明)

狀態未知。

提交任務並排程任務輸入

提交任務和排程任務輸入是com.netfective.bluage.gapwalk.rt.jobqueue.SubmitJobMessage物件的 JSON 序列化。以下的範例輸入顯示這類 Bean 的所有欄位。

提交任務的範例輸入：

{
    "messageQueueName":null,
    "scheduleDate":null,
    "scheduleTime":null,
    "programName":"PTA0044",
    "programParams":
     {"wmind":"B"},
    "localDataAreaValue":"",
    "userName":"USER1",
    "jobName":"PTA0044",
    "jobNumber":9,
    "jobPriority":5,
    "executionDate":"20181231",
    "jobQueue":"queue1",
    "jobOnHold":false
}

排程任務的範例輸入：

{
     "scheduleCron": "*/2 * * * * ?",
     "programName":"LOGPGM",
     "programParams": {
         "cl_sbmjob_param_json": "[\"./output/schedule-job-log.txt\", \"Every 2 seconds!\"]"
     },
     "localDataAreaValue":"",
     "userName":"PVO",
     "jobName":"LOGGERJOB",
     "jobPriority":5,
     "jobQueue":"queue1",
     "scheduleMisfirePolicy": 4,
     "startTime": "2003/05/04 07:00:00.000 GMT-06:00",
     "endTime": "2003/05/04 07:00:07.000 GMT-06:00"
 }
jobNumber

如果任務編號為 0，任務編號將使用任務編號序列中的下一個編號自動產生。該值應設為 0 （測試用途除外）。

jobPriority

AS400 中的預設任務優先順序為 5。有效範圍為 0-9，0 是最高優先順序。

jobOnHold

如果任務在保留狀態下提交，則不會立即執行，只會在有人「發行」它時執行。您可以使用 REST API (/release 或 /release-all) 來釋放任務。

scheduleDate 和 scheduleTime

如果這些值不是 null，任務將在指定的日期和時間執行。

日期

可以提供格式 MMddyy 或 ddMMyyyy （輸入的大小將決定使用的格式）

時間

可以提供格式 HHmm 或 HHmmss （輸入的大小將決定使用的格式）

programParams

將做為映射傳遞至程式。

scheduleMisfirePolicy

定義觸發錯誤時所使用的策略。以下為可能值：

  1. 釋放第一個不發射並捨棄另一個不發射。

  2. 提交第一次不發射的暫停任務，並捨棄其他不發射。

  3. 捨棄錯誤。

  4. 釋出所有不發射。任務佇列將執行所有任務。

排程任務回應的清單

這是 list-jobs 任務佇列端點的結構。用於提交該任務的提交任務訊息是回應的一部分。這可用於追蹤或測試/重新提交目的。任務完成時，也會填入開始日期和結束日期。

[
  {
    "jobName": "PTA0044",
    "userName": "USER1",
    "jobNumber": 9,
    "jobPriority": 5,
    "status": "HOLD",
    "jobDelay": 0,
    "startDate": null,
    "endDate": null,
    "jobQueue": "queue1",
    "message": {
      "messageQueueName": null,
      "scheduleDate": null,
      "scheduleTime": null,
      "programName": "PTA0044",
      "programParams": {"wmind": "B"},
      "localDataAreaValue": "",
      "userName": "USER1",
      "jobName": "PTA0044",
      "jobNumber": 9,
      "jobPriority": 5,
      "executionDate": "20181231",
      "jobQueue": "queue1",
      "jobOnHold": true,
      "scheduleCron": null,
      "save": false,
      "scheduleMisfirePolicy": 4,
      "omitdates": null
    },
    "executionId": 1,
    "jobScheduledId": 0,
    "jobScheduledAt": null
  },
  {
    "jobName": "PTA0044",
    "userName": "USER1",
    "jobNumber": 9,
    "jobPriority": 5,
    "status": "COMPLETED",
    "jobDelay": 0,
    "startDate": "2022-10-13T22:48:34.025+00:00",
    "endDate": "2022-10-13T22:52:54.475+00:00",
    "jobQueue": "queue1",
    "message": {
      "messageQueueName": null,
      "scheduleDate": null,
      "scheduleTime": null,
      "programName": "PTA0044",
      "programParams": {"wmind": "B"},
      "localDataAreaValue": "",
      "userName": "USER1",
      "jobName": "PTA0044",
      "jobNumber": 9,
      "jobPriority": 5,
      "executionDate": "20181231",
      "jobQueue": "queue1",
      "jobOnHold": true,
      "scheduleCron": "*/20 * * * * ?",
      "save": false,
      "scheduleMisfirePolicy": 4,
      "omitdates": null
    },
    "executionId": 2,
    "jobScheduledId": 0,
    "jobScheduledAt": null
  }
]

重複任務回應的清單

這是 /schedule/list 任務佇列端點的結構。

[
  {
    "id": 1,
    "status": "ACTIVE",
    "jobNumber": 1,
    "userName": "PVO",
    "msg": {
      "messageQueueName": null,
      "scheduleDate": null,
      "scheduleTime": null,
      "startTime": "2024/03/07 21:12:00.000 UTC",
      "endTime": "2024/03/07 21:13:59.000 UTC",
      "programName": "LOGPGM",
      "programParams": {"cl_sbmjob_param_json": "[\"./output/schedule-job-log.txt\", \"Every 20 seconds!\"]"},
      "localDataAreaValue": "",
      "userName": "PVO",
      "jobName": "LOGGERJOB",
      "jobNumber": 1,
      "jobScheduleId": 1,
      "jobPriority": 5,
      "executionDate": null,
      "jobQueue": "queue1",
      "jobOnHold": false,
      "scheduleCron": "*/20 * * * * ?",
      "save": false,
      "scheduleMisfirePolicy": 4,
      "omitdates": null
    },
    "lastUpdatedAt": "2024-03-07T21:11:13.282+00:00",
    "lastUpdatedBy": ""
  }
]