Page History
9.195 SET_SESSION_VALUE
| Note | ||
|---|---|---|
| ||
この組み込み関数を使用すると、Visual LANSAのセッション値を実行アプリケーションによって動的に変更することができます。
セッション値への変更は、そのセッション(X_RUNコマンド)が実行を完了すると無効になることに注意してください。
詳細は、「標準X_RUNパラメータ」を参照してください。
引数
番号 | タイプ | 必須/任意 | 記述 | 最小長 | 最大長 | 最小小数桁数 | 最大小数桁数 |
|---|---|---|---|---|---|---|---|
1 | A | 必須 | 設定またはリセットされるセッション値の名前 現在、この組み込み関数によって次のセッション値を設定またはリセットすることができます。設定またはリセットされるセッション値の名前。現在、この組み込み関数によって次のセッション値を設定またはリセットすることができます。 USER：現在のユーザー - IBM iでは変更できません。USERを設定すると、USEX (サーバーへの接続時のデフォルト・ユーザーID)も設定されます。「セッション値USER=、GUSR=、およびUSEXに関する技術上の注記」を参照してください。 GUSR：現在のグループ・ユーザー - IBM iでは変更できません。 USER_AUDIT：ユーザー編集スタンプで使用されるユーザー。IBM iで明示的に設定されている必要があります。 Visual LANSAで変更しても、スーパーサーバー・アプリケーション内でIBM iは更新されません。 PRTR：現在のプリンター PPTH：プリンター・ファイル用の現在の完全修飾ディレクトリ JOBPTY：ジョブ待ち行列の優先順位 DBMS_OPTIMIZE：大量のDBMSアクティビティの最適化 CONNECT_PARTITION： CONNECT_SERVER組み込み関数によって使用されるデフォルトの区画 DPTH：エミュレートされたIBM i データ待ち行列が作成/アクセスされるディレクトリ EXPS：オブジェクト・セキュリティ・レコードのインポート時に実行されるアクション HELP：使用するヘルプ・システム HLPF：使用するヘルプ・ファイル HMJB：現在のアプリケーションがホスト・モニターのジョブであるかどうかを識別します。YまたはN。LANSA開発チーム専用に予約されています。 LANG：現在実行中の言語を変更します。このセッション値には、LANSAの内部作業に関する詳しい知識が必要なため、LANSA開発チームによって作成されたアプリケーションだけに使用が制限されます。 ITRO などすべてのトレース・パラメータ。これは、問題が発生したときだけトレースを有効にする場合に役立ちます。これによって、トレース・ファイルのサイズを最小限に抑えることができます。 PSRA =：一次サーバー経路権限。PSRA=Yを設定することによって、権限チェックがサーバーにルーティングされることを示します。 このコマンドを使用して、実行中に値を設定します。値の設定は、接続を定義して確立する前に行ってください(X_RUN パラメータ詳細の「PSRA (プライマリ・サーバー・ルート証明機関)」に記載されている注意点を参照してください)。 PSRR：一次サーバー経路リポジトリ。PSRR=Y(デフォルト)を設定することによって、リポジトリのデータがローカルで取得できない場合、そのデータを取得するために要求がサーバーに送信されることを示します。 このコマンドを使用して、実行中に値を設定します。値の設定は、接続を定義して確立する前に行ってください(X_RUN パラメータ詳細の(「PSRA (プライマリ・サーバー・ルート証明機関)」に記載されている注意点を参照してください)。 UDEF：スペースを含むユーザー定義の値(最大256バイト)。値にスペースが含まれている場合、または埋め込み引用符を使用する場合は、引用符で囲んでください。この場合、使用可能な長さは254バイトになります。注：埋め込み引用符はすべて一重引用符でなければなりません。二重引用符を使用すると、送信されたジョブが失敗します。 WPEN、 WPPN、WPPS、WPPD、WPFD、WPDF、WPDS、WPFO、WPASなどのWindowsの拡張印刷パラメータをこのパラメータで指定することができます。引数2で指定する値は、コマンド行でWindowsの拡張印刷パラメータを使用する際に適用されるものと同じ規則に従わなければなりません(「Windows拡張印刷パラメータ」を参照してください)。 WPPN、WPPS、WPPD、WPFD、WPDF、WPDS、WPFO、WPASなどのWindowsの拡張印刷パラメータをこのパラメータで指定することができます。引数2で指定する値は、コマンド行でWindowsの拡張印刷パラメータを使用する際に適用されるものと同じ規則に従わなければなりません。（「Windows拡張印刷パラメータ」を参照してください） XCMD：パスワードなどの特定パラメータ値を隠します。このパラメータは、設定後に送信されたジョブに対してのみアクティブになります。 CIPH： LANSAからOPenSSLを呼び出す際に使用する対称鍵暗号 | 1 | 50 | ||
2 | A | 必須 | セッション値が設定またはリセットされる値。詳細については、以下の「技術上の注記」を参照してください。 | 1 | 256 |
...
- このセッション値は、このジョブ(現在実行中のジョブ)から投入されたジョブの待ち行列の優先順位を制御するために使用します。x_run環境が起動している場合、このデフォルトは5に設定されます。この値は、IBM iのバッチ・ジョブ待ち行列とサブシステムのエミュレーションでのみ使用してください。また、これ以外のコンテキストで使用しても意味がありません。
- JOBPTY =に指定する値は、0 -> 9の範囲の整数値である必要があります。最も低いJOBPTY値で投入されたジョブが、エミュレートされたジョブ待ち行列から最初に実行されます。 JOBPTY値が等しいジョブは、到着順に実行されます。
- この機能を使用する前に、『Visual LANSA アプリケーションの配布ガイド』の「IBM i ジョブ待ち行列エミュレーション」をお読みください。
セッション値CONNECT_PARTITION=に関する技術上の注記
...
セッション値DBMS_OPTIMIZE=に関する技術上の注記
移植性に関する考慮事項 | IBM i上で実行されるRDMLXコードでこの組み込み関数を使用する場合は、COMMITを実行して、コミット制御を開始する必要があります。 |
...