MQ サービスの作成 (CRTMQMSVC)
実行可能な場所: | スレッド・セーフ: |
---|---|
すべての環境 (*ALL) | はい |
MQ サービスの作成 (CRTMQMSVC) コマンドは、デフォルトとは異なる属性を指定して、新しい MQ サービス定義を作成します。
パラメーター
キーワード | 説明 | 選択 | 注 |
---|---|---|---|
サーバー名 | サービス名 | 文字値 | 必須、キー、定位置 1 |
MQMNAME | メッセージ・キュー・マネージャー名 | 文字値、*DFT | オプション、キー、定位置 2 |
REPLACE | 置換 | *NO、*YES | オプショナル, 定位置 3 |
text | テキスト '記述' | 文字値、*BLANK、*SYSDFTSVC | オプショナル, 定位置 4 |
STRCMD (ストリング) | プログラムを開始 | 単一値: *SYSDFTSVC、*NONE その他の値: 修飾オブジェクト名 | オプショナル, 定位置 5 |
修飾子 1: 開始プログラム | 名前 | ||
修飾子 2: ライブラリー | 名前 | ||
ストラグ | 開始プログラム実引数 | 文字値、*BLANK、*SYSDFTSVC | オプショナル, 定位置 6 |
終了 (ENDCMD) | 終了プログラム | 単一値: *SYSDFTSVC、*NONE その他の値: 修飾オブジェクト名 | オプショナル, 定位置 7 |
修飾子 1: 終了プログラム | 名前 | ||
修飾子 2: ライブラリー | 名前 | ||
ENDARG (終了) | 終了プログラム実引数 | 文字値、*BLANK、*SYSDFTSVC | オプショナル, 定位置 8 |
STDOUT | 標準出力 | 文字値、*BLANK、*SYSDFTSVC | オプショナル, 定位置 9 |
STDERR | 標準エラー | 文字値、*BLANK、*SYSDFTSVC | オプショナル, 定位置 10 |
TYPE | サービス・タイプ | *SYSDFTSVC、*CMD、*SVR | オプショナル, 定位置 11 |
コントロール | サービス制御 | *SYSDFTSVC、*MANUAL、*QMGR、*STARTONLY | オプション、定位置 12 |
サービス名 (SVCNAME)
新規 MQ サービス定義の名前です。
指定できる値は以下のとおりです。
- サービス名
- サービス定義の名前を指定します。 ストリングの最大長は 48 バイトです。
メッセージ・キュー・マネージャー名 (MQMNAME)
キュー・マネージャーの名前を指定します。
指定できる値は以下のとおりです。
- *DFT
- デフォルト・キュー・マネージャーを使用します。
- キュー・マネージャー名
- メッセージ・キュー・マネージャーの名前です。
置換 (REPLACE)
同じ名前のサービス定義が既に存在している場合、その定義を置き換えるかどうかを指定します。
指定できる値は以下のとおりです。
- *NO
- この定義は、同じ名前の既存のサービス定義を置き換えません。 指定されたサービス定義が既に存在している場合、コマンドは失敗します。
- *YES
- 既存のサービス定義を置き換えます。 同じ名前の定義がない場合は、新規の定義が作成されます。
テキスト '記述' (TEXT)
サービス定義を簡単に説明するテキストを指定します。
注 : フィールド長は 64 バイトであり、システムが 2 バイト文字セット (DBCS) を使用している場合、最大文字数が少なくなります。
指定できる値は以下のとおりです。
- *SYSDFTSVC
- この属性の値は、システム・デフォルト・サービスから取り出されます。
- *BLANK
- テキストはブランク・ストリングに設定されます。
- description
- 新規記述情報を指定します。
開始プログラム (STRCMD)
実行するプログラムの名前。
指定できる値は以下のとおりです。
- *SYSDFTSVC
- この属性の値は、システム・デフォルト・サービスから取り出されます。
- start-command
- 実行可能な開始コマンドの名前。
開始プログラム実引数 (STRARG)
開始時にプログラムに渡される引数。
指定できる値は以下のとおりです。
- *SYSDFTSVC
- この属性の値は、システム・デフォルト・サービスから取り出されます。
- *BLANK
- 開始コマンドに引数は渡されません。
- start-command-arguments
- 開始コマンドに渡される引数。
終了プログラム (ENDCMD)
サービスの停止が要求されると実行する実行可能プログラムの名前。
指定できる値は以下のとおりです。
- *SYSDFTSVC
- この属性の値は、システム・デフォルト・サービスから取り出されます。
- *BLANK
- 終了コマンドは実行されません。
- end-command
- 実行可能な終了コマンドの名前。
終了プログラム実引数 (ENDARG)
サービスが停止を要求されるときに、終了プログラムに渡される引数。
指定できる値は以下のとおりです。
- *SYSDFTSVC
- この属性の値は、システム・デフォルト・サービスから取り出されます。
- *BLANK
- 引数は終了コマンドに渡されません。
- end-command-arguments
- 終了コマンドに渡される引数。
標準出力 (STDOUT)
サービス・プログラムの標準出力が転送されるファイルへのパス。
指定できる値は以下のとおりです。
- *SYSDFTSVC
- この属性の値は、システム・デフォルト・サービスから取り出されます。
- *BLANK
- 標準出力は廃棄されます。
- stdout-path
- 標準出力パス。
標準エラー (STDERR)
サービス・プログラムの標準エラーが転送されるファイルのパス。
指定できる値は以下のとおりです。
- *SYSDFTSVC
- この属性の値は、システム・デフォルト・サービスから取り出されます。
- *BLANK
- 標準エラーは廃棄されます。
- stderr-path
- 標準エラー・パス。
サービス・タイプ (TYPE)
サービスを実行するモード。
指定できる値は以下のとおりです。
- *SYSDFTSVC
- この属性の値は、システム・デフォルト・サービスから取り出されます。
- *CMD
- 開始時にコマンドは実行されますが、状況は収集されることも表示されることもありません。
- *SVR
- 開始された実行可能プログラムの状況がモニターおよび表示されます。
サービス制御 (CONTROL)
キュー・マネージャー開始時にサービスを自動的に開始するかどうか。
指定できる値は以下のとおりです。
- *SYSDFTSVC
- この属性の値は、システム・デフォルト・サービスから取り出されます。
- *MANUAL
- サービスは自動的に開始されることも停止されることもありません。
- *QMGR
- キュー・マネージャーが開始するとサービスが開始し、キュー・マネージャーが停止するとサービスが停止します。
- *STARTONLY
- キュー・マネージャーの開始時にサービスは開始されますが、キュー・マネージャーが停止する際にサービスの停止は要求されません。