各コマンドの共通引数の形式
ジョブ制御機能のコマンドで共通の引数の形式,およびインフォパッケージまたはプロセスチェーン制御機能のコマンドで共通の引数の形式について説明します。
- 〈このページの構成〉
SAPあて先情報
SAPあて先情報は,SAPシステムとの接続を確立するための引数です。SAPあて先情報の詳細形式を次に示します。
- SAPあて先情報
-
-h ホスト名 [-s NN]|-d あて先
SAPあて先情報のオプションは,SAPシステムへの接続方法に応じて次のように使い分けます。
-
ホスト名を指定してSAPシステムに接続する場合
指定したホスト上で稼働している,指定したシステム番号のアプリケーションサーバに接続します。
ホスト名を指定してSAPシステムに接続する場合は,「-h ホスト名 [-s NN]」を使用します。
-dオプションは同時に指定できません。
- -h ホスト名
-
「ホスト名」に,SAPシステムのホスト名を指定します。ホスト名には,次の形式の名称を使用できます。
・hostsアドレス(例:r3host1)
・IPアドレス(例:123.123.123.123)
・SAPルーターアドレス
SAPルーターアドレスの形式については,SAPのマニュアルおよびオンラインヘルプを参照してください。
- -s NN
-
「NN」に,SAPシステムを識別するためのシステム番号を指定します。指定できる文字列の長さは,1〜2バイトです。文字列に使用できるのは,数字だけです。この項目を省略した場合,システム番号に0が設定されます。
-
sapnwrfc.iniファイルを使用してSAPシステムに接続する場合
sapnwrfc.iniファイルの定義内容に従って,特定のアプリケーションサーバ,またはメッセージサーバの負荷分散機能によって決定された,任意のアプリケーションサーバに接続します。
sapnwrfc.iniファイルを使用してSAPシステムに接続する場合は,「-d あて先」を使用します。
-hオプションは同時に指定できません。
- -d あて先
-
「あて先」に,sapnwrfc.iniファイルのDESTに指定した値を指定します。
sapnwrfc.iniファイルは次のように検索されます。なお,あて先は,使用するsapnwrfc.iniファイルのDESTにあらかじめ指定しておいてください。
環境変数RFC_INIにsapnwrfc.iniが指定されている場合
環境変数RFC_INIファイルに指定したsapnwrfc.iniファイルだけが検索されます。JP1/AJS3 for EAPの作業ディレクトリにあるsapnwrfc.iniファイルは検索されません。
環境変数RFC_INIにsapnwrfc.iniが指定されていない場合
JP1/AJS3 for EAPの作業ディレクトリにあるsapnwrfc.iniファイルが検索されます。
-
SAPあて先情報をコマンドラインの一部として指定しない場合
SAPあて先情報をコマンドラインの一部として指定しない場合は,すべてのオプションを省略して,r3defconファイルに指定したあて先情報(addressセクションの情報)を使用します。この場合,r3defconファイルの作成が必要です。あらかじめ,コマンドを実行するユーザーのホームディレクトリ下にr3defconファイルを作成しておいてください。
sapnwrfc.iniファイル,r3defconファイルの作成については,「2. インストールとセットアップ」を参照してください。
SAPログオン情報
SAPログオン情報は,SAPシステムにログオンするときのユーザー情報を指定するための引数です。SAPログオン情報の詳細形式を次に示します。
- SAPログオン情報
-
{-c SAPクライアント -u SAPユーザー名
{-p パスワード | -p2 拡張パスワード} [-l 言語] | -dl}
- -c SAPクライアント
-
ログオン先のSAPシステムで有効なSAPクライアントのクライアント番号を指定します。クライアント番号に指定できる文字列の長さは,1〜3バイトです。文字列に使用できるのは,数字だけです。なお,SAPクライアント番号をSAPシステムに送るときには,1〜2バイトで指定したクライアント番号は3バイトに変換されます。
例えば,クライアント番号が「001」の場合,「1」,「01」,または「001」の3パターンの指定ができます。ただし,SAPシステムには,3バイト形式のクライアント番号「001」が送られます。
-dlオプションと同時に指定することはできません。
- -u SAPユーザー名
-
ログオン先のSAPシステムで有効なSAPユーザー名を指定します。
指定できるSAP ユーザーについては「2.3.9 ジョブ制御用のSAPユーザーを用意する」を参照してください。
SAPユーザー名に指定できる文字列の長さは,1〜12バイトです。
SAPシステムに対する制御は,このSAPユーザーの権限で実行されます。
-dlオプションと同時に指定することはできません。
- -p パスワード
-
-uオプションに指定したSAPユーザーに対応するパスワードを指定します。
このオプションは,SAPシステムで従来型のパスワードルールが適用されている場合に指定します。
パスワードに指定できる文字については「2.3.9 ジョブ制御用のSAPユーザーを用意する」を参照してください。
パスワードに指定できる文字列の長さは,1〜8バイトです。
-dlオプションと同時に指定することはできません。
- -p2 拡張パスワード
-
-uオプションに指定したSAPユーザーに対応する拡張パスワードを指定します。
このオプションは,SAPシステム側で拡張パスワードルールが適用されている場合に指定します。
拡張パスワードに指定できる文字については「2.3.9 ジョブ制御用のSAPユーザーを用意する」を参照してください。
拡張パスワードに指定できる文字列の長さは,1〜40バイトです。
-dlオプションと同時に指定することはできません。
- -l 言語
-
使用する言語種別を1バイトの英字で指定します。日本語または英語が使用できます。使用する言語には,次に示すSAPシステムで使用できる言語を指定してください。
-
日本語の場合:J
-
英語の場合:E
なお,次の場合,ログオン先のアプリケーションサーバで定義されている言語種別のデフォルトが使用されます。
-
-lオプションを省略した場合
-
ログオン先のアプリケーションサーバで定義されていない言語種別を指定した場合
このオプションに指定した言語種別は,SAPジョブログの言語と,KAJM0802-E,KAJM0813-Eなどのメッセージの挿入句として出力される,SAPシステムが返すエラーの詳細情報の言語に影響します。
-dlオプションと同時に指定することはできません。
-
- -dl
-
sapnwrfc.iniファイルを使用してSAPログオン情報を定義する場合に指定します。
このオプションは,SAPあて先情報に-dオプションを指定した場合に有効となります。SAPあて先情報に-dオプションを指定しないで,-dlオプションを指定した場合は,異常終了します。また,-c,-u,-p,-p2および-lオプションと同時に指定することはできません。
なお,SAPログオン情報をコマンドラインの一部として指定しない場合は,r3defconファイルに指定したログオン情報(logonセクションの情報)を使用します。あらかじめ,コマンドを実行するユーザーのホームディレクトリ下にr3defconファイルを作成しておいてください。
r3defconファイルの作成については,「2. インストールとセットアップ」を参照してください。
リダイレクション情報
コマンド実行時の標準出力先,および標準エラー出力先を指定するための引数です。リダイレクション情報の形式を次に示します。
- -so 標準出力ファイル名
-
コマンド実行時の標準出力先を指定します。
標準出力ファイル名に指定できる文字列の長さは,WindowsとLinuxとで異なります。
-
Windowsの場合
標準出力ファイル名に指定できる文字列の長さは,1〜259バイトです。
-
Linuxの場合
標準出力ファイル名に指定できる文字列の長さは,1〜255バイトです。
標準出力ファイル名を絶対パスで指定しない場合,JP1/AJS3 for EAPの作業ディレクトリにファイルが作成されます(JP1/AJS3 for EAPの作業ディレクトリが設定されていない場合,カレントディレクトリにファイルが作成されます)。
標準出力ファイル名には/dev/nullなどのデバイスファイルを指定しないでください。標準出力ファイルが不要な場合は,出力されたファイルを削除してください。
コマンド実行時の標準出力メッセージは,このファイルに追加書きで書き込みます。
-
- -se 標準エラー出力ファイル名
-
コマンド実行時の標準エラー出力先を指定します。
標準エラー出力ファイル名に指定できる文字列の長さは,WindowsとLinuxとで異なります。
-
Windowsの場合
標準エラー出力ファイル名に指定できる文字列の長さは,1〜259バイトです。
-
Linuxの場合
標準エラー出力ファイル名に指定できる文字列の長さは,1〜255バイトです。
標準エラー出力ファイル名を絶対パスで指定しない場合,JP1/AJS3 for EAPの作業ディレクトリにファイルが作成されます(JP1/AJS3 for EAPの作業ディレクトリが設定されていない場合,カレントディレクトリにファイルが作成されます)。
標準エラー出力ファイル名には/dev/nullなどのデバイスファイルを指定しないでください。標準エラー出力ファイルが不要な場合は,出力されたファイルを削除してください。
コマンド実行時の標準エラー出力メッセージは,このファイルに追加書きで書き込みます。
-
(2)インフォパッケージまたはプロセスチェーン制御機能のコマンドで共通の引数の形式
インフォパッケージまたはプロセスチェーン制御機能のコマンドで共通の「SAP BWあて先情報」および「SAP BWログオン情報」の詳細形式について説明します。
SAP BWあて先情報
SAP BWあて先情報は,SAP BWシステムとの接続を確立するための引数です。SAP BWあて先情報の詳細形式を次に示します。
- SAP BWあて先情報
-
-h ホスト名 [-s NN]|-d あて先
SAP BWあて先情報のオプションは,SAP BWシステムへの接続方法に応じて次のように使い分けます。
-
ホスト名を指定してSAP BWシステムに接続する場合
指定したホスト上で稼働している,指定したシステム番号のアプリケーションサーバに接続します。
ホスト名を指定してSAP BWシステムに接続する場合は,「-h ホスト名 [-s NN]」を使用します。
-dオプションは同時に指定できません。
- -h ホスト名
-
「ホスト名」に,SAP BWシステムのホスト名を指定します。ホスト名には,次の形式の名称を使用できます。
・hostsアドレス(例:bwhost1)
・IPアドレス(例:123.123.123.123)
・SAPルーターアドレス
SAPルーターアドレスの形式については,SAP BWのマニュアルおよびオンラインヘルプを参照してください。
- -s NN
-
「NN」に,SAP BWシステムを識別するためのシステム番号を指定します。指定できる文字列の長さは,1〜2バイトです。文字列に使用できるのは,数字だけです。この項目を省略した場合,システム番号に0が設定されます。
-
sapnwrfc.iniファイルを使用してSAP BWシステムに接続する場合
sapnwrfc.iniファイルの定義内容に従って,特定のアプリケーションサーバ,またはメッセージサーバの負荷分散機能によって決定された,任意のアプリケーションサーバに接続します。
sapnwrfc.iniファイルを使用してSAP BWシステムに接続する場合は,「-d あて先」を使用します。
-hオプションは同時に指定できません。
- -d あて先
-
「あて先」に, sapnwrfc.iniファイルのDESTに指定した値を指定します。
sapnwrfc.iniファイルは次のように検索されます。なお,あて先は,使用するsapnwrfc.iniファイルのDESTにあらかじめ指定しておいてください。
環境変数RFC_INIにsapnwrfc.iniが指定されている場合
環境変数RFC_INIファイルに指定したsapnwrfc.iniファイルだけが検索されます。JP1/AJS3 for EAPの作業ディレクトリにあるsapnwrfc.iniファイルは検索されません。
環境変数RFC_INIにsapnwrfc.iniが指定されていない場合
JP1/AJS3 for EAPの作業ディレクトリにあるsapnwrfc.iniファイルが検索されます。
-
SAP BWあて先情報をコマンドラインの一部として指定しない場合
SAP BWあて先情報をコマンドラインの一部として指定しない場合は,すべてのオプションを省略して,r3defconファイルに指定したあて先情報(addressセクションの情報)を使用します。この場合,r3defconファイルの作成が必要です。あらかじめ,コマンドを実行するユーザーのホームディレクトリ下にr3defconファイルを作成しておいてください。
sapnwrfc.iniファイル,r3defconファイルの作成については,「2. インストールとセットアップ」を参照してください。
SAP BWログオン情報
SAP BWログオン情報は,SAP BWシステムにログオンするときのユーザー情報を指定するための引数です。SAP BWログオン情報の詳細形式を次に示します。
- SAP BWログオン情報
-
{-c SAP BWクライアント -u SAP BWユーザー名 {-p パスワード | -p2 拡張パスワード} [-l 言語] | -dl}
- -c SAP BWクライアント
-
ログオン先のSAP BWシステムで有効なSAP BWクライアントのクライアント番号を指定します。クライアント番号に指定できる文字列の長さは,1〜3バイトです。文字列に使用できるのは,数字だけです。なお,SAP BWクライアント番号をSAP BWシステムに送るときには,1〜2バイトで指定したクライアント番号は3バイトに変換されます。
例えば,クライアント番号が「001」の場合,「1」,「01」,または「001」の3パターンの指定ができます。ただし,SAP BWシステムには,3バイト形式のクライアント番号「001」が送られます。
-dlオプションと同時に指定することはできません。
- -u SAP BWユーザー名
-
ログオン先のSAP BWシステムで有効なSAP BWユーザー名を指定します。
指定できるSAP BWユーザーについては「2.4.9 インフォパッケージまたはプロセスチェーン制御用のSAPユーザーを用意する」を参照してください。
SAP BWユーザー名に指定できる文字列の長さは,1〜12バイトです。
SAP BWシステムに対する制御は,このSAP BWユーザーの権限で実行されます。
-dlオプションと同時に指定することはできません。
- -p パスワード
-
-uオプションに指定したSAP BWユーザーに対応するパスワードを指定します。
パスワードに指定できる文字については「2.4.9 インフォパッケージまたはプロセスチェーン制御用のSAPユーザーを用意する」を参照してください。
パスワードに指定できる文字列の長さは,1〜8バイトです。
このオプションは,SAPシステム側で従来型のパスワードルールが適用されている場合に指定します。
-dlオプションと同時に指定することはできません。
- -p2 拡張パスワード
-
-uオプションに指定したSAP BWユーザーに対応する拡張パスワードを指定します。
拡張パスワードに指定できる文字については「2.4.9 インフォパッケージまたはプロセスチェーン制御用のSAPユーザーを用意する」を参照してください。
このオプションは,SAPシステム側で拡張パスワードルールが適用されている場合に指定します。
拡張パスワードに指定できる文字列の長さは,1〜40バイトです。
-dlオプションと同時に指定することはできません。
- -l 言語
-
使用する言語種別を1バイトの英字で指定します。日本語または英語が使用できます。使用する言語には,次に示すSAP BWシステムで使用できる言語を指定してください。
-
日本語の場合:J
-
英語の場合:E
なお,次の場合,ログオン先のSAP BWシステムで定義されている言語種別のデフォルトが使用されます。
-
-lオプションを省略した場合
-
ログオン先のSAP BWシステムで定義されていない言語種別を指定した場合
このオプションに指定した言語種別は,KAJM2802-E,KAJM0813-Eなどのメッセージの挿入句として出力される,SAPシステムが返すエラーの詳細情報の言語に影響します。
-dlオプションと同時に指定することはできません。
-
- -dl
-
sapnwrfc.iniファイルを使用してSAP BWログオン情報を定義する場合に指定します。
このオプションは,SAP BWあて先情報に-dオプションを指定した場合に有効となります。SAP BWあて先情報に-dオプションを指定しないで,-dlオプションを指定した場合は,異常終了します。また,-c,-u,-p,-p2および-lオプションと同時に指定することはできません。
なお,SAP BWログオン情報をコマンドラインの一部として指定しない場合は,r3defconファイルに指定したログオン情報(logonセクションの情報)を使用します。あらかじめ,コマンドを実行するユーザーのホームディレクトリ下にr3defconファイルを作成しておいてください。
r3defconファイルの作成については,「2. インストールとセットアップ」を参照してください。