3.3.4 RPG予約コマンド
SERVICE_で始まるコマンドやキーワードは予約されています。
例えば、以下のコマンドは予約されています。
|
SERVICE_LOAD |
SERVICE(サービス名) TRACE(オプション) TRACE_NAME(名前) |
|
SERVICE_SET |
TRACE(*CLEAR) |
|
SERVICE_GET |
PROPERTY(プロパティ) |
|
SERVICE_UNLOAD |
|
SERVICE_LOADコマンドは、JSMサービス・スレッドに対して、指定したサービス・プログラムをロードしてインスタンス化するように指示します。一度にロードするサービス・クラスは1つだけです。SERVICE_LOADコマンドは、Javaサービス・プログラマが現在のサービスで使用される省略値をロードするコードを作成する場所として適しています。
SERVICE_SETコマンドはトレース・ファイルをクリアできるようにします。
SERVICE_GETコマンドでは、関連するサービス・プロパティ・ファイルからキーワード/値のプロパティにアクセスできます。ユーザー定義のキーワード名と現在および将来のLANSA名との競合を少なくするには、キーワードの前にグローバルな一意の名前を付けます。サービス・プロパティのキーワードは大文字/小文字を区別しません。
サービス・プロパティのキーワードの値は、#JSMMSGフィールドに返されます。
キーワードが存在しない場合、NOT_EXISTという状態が返されます。
例
com.acme.property.messagetype=html
#
message.001=Service successfully loaded
message.002=Service successfully unloaded
message.003=Command is not supported :
SERVICE_UNLOADコマンドは、JSMサービス・スレッドに対して、現在ロードされているサービス・プログラムを無効にして、別のサービスをロードするように指示します。このコマンドはオプションのため、JSM接続を終了する場合、呼び出す必要はありません(SERVICE_UNLOADコマンドは、Javaサービス・プログラマが現在割り当てられているリソースを解放するコードを入れる場所として適しています)。