8.1.2　新規作成

種類

実行エージェントの種類を選択します。

エージェント

実行エージェントのことです。

グループ

実行エージェントグループのことです。

必須

エージェント名

実行エージェントまたは実行エージェントグループとして登録したいエージェント名を入力します。

1〜255バイトの任意文字列（以下，使用禁止文字を除く）を指定可能です。

アンダーバー(_)2つの「__」で始まる名称は，サービス用に予約されているため，指定できません。

使用禁止文字

制御文字および " ' ` $ ” ’ ‘ : , < > スペース

その他，注意事項

• 大文字小文字は区別されません。

• 日本語などのマルチバイト文字も使用できます。ただし，言語環境によって文字バイト長が異なるため，ASCII文字を推奨します。エージェント名に環境依存文字を含む場合，実行エージェントの編集に失敗することがあります。この場合，別の文字を指定して再作成（削除して新規作成）により対処してください。

• 「@SYS」で始まる名称は使用できません。

必須

ジョブの受付配信制限の状態

実行エージェントまたは実行エージェントグループのジョブの受付配信制限の状態を選択します。

有効

ジョブを受け付け，実行ホストに配信されます。

無効

ジョブを受け付けません。ただし，すでに受け付けたジョブは実行ホストに配信されます。

保留

ジョブを受け付けます。ただし，実行ホストには配信されません。

閉塞

ジョブを受け付けません。また，実行ホストにも配信されません。

「有効」または「無効」を選択した場合，実行エージェントの状態（接続状態）は「未確認」に設定されます。「保留」または「閉塞」を選択した場合，実行エージェントの状態（接続状態）は「使用不可」に設定されます。

必須

実行ホスト名

ジョブの実行先ホスト名を入力します。

1〜255バイトの任意文字列（以下，使用禁止文字を除く）を指定可能です。

マネージャーホスト名は指定できません。

使用禁止文字

制御文字および " ' ` $ ” ’ ‘

その他，注意事項

半角空白文字を含む文字列を指定した場合，除去して処理されます。このため，半角空白文字は使用しないでください。

エージェントのみ指定（必須）

ジョブ実行多重度

ジョブ実行多重度を設定する時間帯と，その時間帯のジョブ実行多重度を以下の形式で入力します。

なお，タイムゾーンはJSTになります。

ジョブ実行多重度により，この実行エージェントで同時に実行できるジョブ数を制限できます。同時実行数が制限されるジョブは，UNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，カスタムジョブ，および引き継ぎ情報設定ジョブです。同時に実行しようとしたジョブ数が，ジョブ実行多重度に達した場合，それを超えた分のジョブは，実行中のジョブが終了するまでキューイング（実行待ち）の状態になります。

形式

hh:mm-hh:mm=ジョブ実行多重度,hh:mm-hh:mm=ジョブ実行多重度,...

hhに指定できる値は，0〜9または00〜23（単位：時）です。

mmに指定できる値は，0, 00, または30（単位：分）です。

ジョブ実行多重度に指定できる値は，0〜4294967295です。

時間帯とジョブ実行多重度の組み合わせは，最大48まで指定できます。

その他，補足事項

• 時間帯を重複して指定した場合は，あとで指定した値が反映されます。

• ジョブ実行多重度を指定しなかった時間帯には，ジョブ実行多重度0が仮定されます。

• 実行した時刻を含む時間帯を指定した場合，ジョブ実行多重度はすぐに変更されます。

エージェントのみ指定（必須）

属するエージェントと優先順位

実行エージェントグループに関連づける実行エージェント名とそのグループ内での優先順位を以下の形式で入力します。

形式

実行エージェント名[:優先順位],実行エージェント名[:優先順位],...

実行エージェント名にはすでに登録済みの実行エージェントを指定します。

優先順位に指定できる値は，1〜16です。優先順位が一番低いのが1，一番高いのが16です。優先順位が高いほど，ジョブが優先的に実行されます。省略した場合，16が仮定されます。

関連づけできる実行エージェントの数は1,024までです。

なお，V01-12以降において，デフォルト実行エージェント（エージェント名が@SYSTEMの実行エージェント）は指定できません。

グループのみ指定（必須）

説明

実行エージェントまたは実行エージェントグループに対するコメントを入力します。

1〜80バイトの任意文字列（以下，使用禁止文字を除く）を指定可能です。

使用禁止文字

制御文字および " ' ` $ ” ’ ‘

その他，注意事項

説明文の末尾に連続して設定した半角空白文字は無効になる場合があります。このため，末尾に半角空白文字を使用しないでください。

任意

一括登録（V02-30以降）

複数の実行エージェントを一括で登録するコマンド文を生成できます。

［コマンド文生成］ボタンをクリックして起動するダイアログで必要な情報を入力（コマンド実行先ホストのOSをLinuxかWindowsから選択）し，［生成とJSONファイルのダウンロード］ボタンをクリックすると，一括登録用コマンド文の生成と，リクエストボディとなるJSONファイルのテンプレートをダウンロードできます。

生成されたコマンド文をコピーしてリクエストボディ（JSONファイル）^※1を編集し，クライアント端末からJSONファイルを指定してコマンドを実行することで一括登録の操作ができます。コマンド文を実行すると，サービスポータルに対してREST APIでの通信が発生するため，通信ができるように事前にポートの許可設定などを実施してください。

なお，生成されたコマンド文の有効期限は60分になるため，あらかじめテンプレートからリクエストボディとなるJSONファイルを作成しておき，コマンド文に入力データとして指定することもご検討ください。

システム負荷の軽減のため，複数の一括操作コマンドを同時に実行しないでください。

リクエストボディの例を以下に示します。

{"agents":[{"type":"A","name":"sampleAgent","status":"Ef","host":"samplehost","con_exe_def":"00:00-00:00=10","link_agent":"","description":"サンプルです。","targethost_id":"ajs-mgr99.99.jp1-cld.local"}]}

レスポンスで返却する主なステータスコードを※4に示します。

−

{

−

"agents" : [ {

−

"type" :種類,

実行エージェントの種類（文字列）を指定します。^※2

"name" : エージェント名,

実行エージェント名または実行エージェントグループ名（文字列）を指定します。

"status" : ジョブの受付配信制限の状態,

ジョブの受付配信制限の状態（文字列）を指定します。^※3

"host" : 実行ホスト名,

実行ホスト名（文字列）を指定します。

"con_exe_def" : ジョブ実行多重度,

ジョブ実行多重度（文字列）を指定します。

"link_agent" : 属するエージェントと優先順位,

属する実行エージェント名と優先順位（文字列）を指定します。

"description" : 説明,

説明（文字列）を指定します。

"targethost_id" : 操作対象マネージャーホスト名

操作対象のマネージャーホスト名（文字列）を指定します。このマネージャーホストに紐づく実行エージェントに対して操作が行われます。

}, ... ]

要求エージェント分だけ繰り返して指定してください。

}

−

A

エージェント

G

グループ

Ef

有効

In

無効

Hd

保留

Bl

閉塞

202

成功しました。タスクIDを返却します。

400

リクエスト内容が不正です（KBDC10028-E，KBDC10101-E，KBDC10301-E，KBDC10318-E）。

401

認証情報が無効です（KBDC20102-E，KBDC10104-E）。

403

権限がありません（KBDC10028-E，KBDC10020-E）。

409

操作中です（KBDC10501-W，KBDC10502-W）。

412

エージェント名が重複しています（KBDC10732-E，KBDC13004-E）。

503

メンテナンス中です（KBDC13016-E，KBDC13017-E）。