|
|
| 注: | CICS Runtimeの場合、APPDIRを、CICSランタイム・サーバーのバイナリがあるディレクトリに設定する必要があります。 |
ART_IMS_CONFIGは、IMS構成ファイルの配置先の絶対パスを指定するオプションの環境変数です。これは、IMS DBにアクセスするときにOracle Tuxedo Application Runtime for IMSで必要となります。詳細は、Oracle Tuxedo Application Runtime for IMSユーザーズ・ガイドのOracle Tuxedo Application Runtime for IMS Usersの構成に関する項を参照してください。
ART_IMS_DBは、GSAMファイルの配置先のコンテナ・パスを指定するオプションの環境変数です。これは、IMS DBにアクセスするときにOracle Tuxedo Application Runtime for IMSで必要となります。詳細は、Oracle Tuxedo Application Runtime for IMSユーザーズ・ガイドのOracle Tuxedo Application Runtime for IMS Usersの構成に関する項を参照してください。
これは、ローカル・トランザクションの最適化用のオプションの環境変数です。ARTKIX_XA_DISABLE=yesの場合、XAトランザクションのかわりにデータベースのローカル・トランザクションを使用します。ARTSTRN/1、ARTATRN/1、ARTCTRN/1、ARTWTRN/1、ARTDPLなどのすべてのARTアプリケーション・サーバーはデフォルトでARTKIX_XA_DISABLEをサポートしていますが、独自のARTアプリケーション・サーバーを再構築する場合は、buildartcicsコマンドで-nオプションを指定して、ARTKIX_XA_DISABLEをサポートする必要があります。このローカル・トランザクション最適化は、ローカル・トランザクション・シナリオでのみ使用します。デフォルト値はNOです。
これは、ART CICS RuntimeとともにCOBOL-ITを使用する場合に必須の環境変数です。XA環境でCOBOL-IT/BDBによるVSAMファイル・サポートが有効化されていることを示します。1に設定する必要があります。
DD_VSAMFILEは、CICSプログラムにいくつかのVSAM演算子が含まれる場合、ARTワークベンチにより生成されるVSAM構成ファイルdesc.vsamの位置を示す必須環境変数です。
ARTKIX_XA_DISABLE=yesの場合、DBCONNECTを設定する必要があります。これは、Oracleを使用する際に、USER/PASSWD@SIDなどのデータベース接続文字列を指定します。
ISC_ENABLEはオプションの環境変数です。ISC_ENABLE=YESを設定すると、次のISC関連機能が有効になります。
ASSIGN ABDUMP/ABPROGRAM/ASRAINTRPT/ASRAKEY/ASRAPSW/ASRAREGS/ASRASPC/ASRASTG/INITPARM/INITPARMLEN/KATAKANA/NETNAME/SOSI/USERNAMECANCEL INQUIRE/SET FILEINQUIRE PROGRAM RESCOUNTINQUIRE SYSTEM JOBNAMEINQUIRE TERMINAL ALTSUFFIX/USERIDINQUIRE TRANSACTION PROGRAMINQUIRE TERMINAL/NETNAME ACQSTATUS CREATESESS ISSUE DISCONNECTISSUE PASSおよびEXTRACT LOGONMSGSEND LASTSET/INQUIRE TERMINALSET TERMINAL ACQSTATUS CREATE ACQUIRED RELEASEDSTART TRANSIDと<ANY> TERMIDSTART TRANSID機能:GMTRAN (Good Morningトランザクション)| 注: |
KIXCONFIGは、リソース構成ファイルがあるディレクトリを示す必須の環境変数です。
KIXDIRは、CICS Runtime製品がインストールされるディレクトリを示す必須の環境変数です。
通常、Tuxedo環境変数APPDIRは、${KIXDIR}/binに設定してください。
KIX_CBL_TRAP_ERRORは、COBOL LE(言語環境)エラー・プロシージャを有効または無効にする場合に使用します。デフォルト値はYで、エラー・プロシージャが有効であることを意味します。KIX_CBL_TRAP_ERROR=Nと指定した場合、エラー・プロシージャは無効になります。詳細は、 「CICS Runtimeでのエラー処理」を参照してください。
この環境変数はオプションです。ASKTIME APIで返される年の値を指定します。KIX_CURRENT_YEARの値は、0より大きい整数です。
この環境変数はオプションです。ASKTIME APIで返される月の値を指定します。KIX_CURRENT_MONTHの値は1から12までの数値で、1月から始まる月を表します。
この環境変数はオプションです。ASKTIME APIで返される日の値を指定します。KIX_CURRENT_DAYの値は1から31までの数値で、日付を表します。
この環境変数はオプションです。ASKTIME APIで返される時間の値を指定します。KIX_CURRENT_HOURの値は0から23までの数値で、24時間を表します。
この環境変数はオプションです。ASKTIME APIで返される分の値を指定します。KIX_CURRENT_MINUTEの値は0から59までの数値で、60分を表します。
この環境変数はオプションです。ASKTIME APIで返される秒の値を指定します。KIX_CURRENT_SECONDの値は0から59までの数値で、60秒を表します。
Common Work Area (CWA)が定義される場合(「KIX_CWA_SIZE」を参照)、共有メモリー・セグメントにより各マシン上に実装されます。KIX_CWA_IPCKEY変数は、共有メモリー・セグメントのIPCKEY(識別子)を示します。値は、1 - 99 999 999の範囲で定義できます。
| 注: | KIX_CWA_SIZEが正の値に設定されている場合、この変数は必須です。 |
ソース・プラットフォーム上で、Common Work Area (CWA)は、単一のCICSリージョン内で実行されるすべてのプログラムによって共有されます。このCICSゾーンのサイズは0 - 32765バイトで、0はCWAが定義されないことを示します。
ターゲット・プラットフォームのでは、KIX_CWA_SIZE変数もCWAのサイズを示します(0 - 32765バイト)。この環境変数が設定されない場合、値はデフォルトで0になります。値が0場合(明示的の場合も暗黙の場合も)は、CWAが定義されないことを示します。
KIX_DUMP_FILEは、COBOL-ITメモリー・ダンプが含まれるファイルを示すオプションの環境変数です。現在、KIX_DUMP_FILEはCOBOL-ITにのみ有効です。また。COBOL-ITのバージョンが3.7.7よりも新しい必要があります。COBOL-ITのバージョンが3.7.8よりも古いと、メモリーDUMPに無限ループ状態が発生する可能性があります。
KIX_DUMP_FILEが有効なローカル・ファイルに設定されている場合、CICSプログラムが中断すると、プログラムの最終的なメモリー情報が指定されたダンプ・ファイルに出力されます。そうではない場合、ダンプ・ファイルは生成されません。
KIX_IMSDB_TRACE_LEVELは、IMS DBアクセス・ログのトレース・レベルを指定するオプションの環境変数です。この値は、Oracle Tuxedo Application Runtime for IMSのレベルと同じです。
KIX_JOURNAL_DIRは、WRITE JOURNALNAMEの必須環境変数です。ジャーナル・レコードに対応するファイルが配置されるディレクトリを示します。
このオプションの変数には、Typeterm構成ファイル内で、マップセットの「FILENAME」フィールドに絶対パスが指定されない場合のために、マップセットの物理ファイルが検索されるパス(ディレクトリのリスト)を定義します。
KIX_PROFILINGは、CICSランタイム統計関数を有効または無効にする場合に使用します。KIX_PROFILING=YESと指定した場合、統計関数は有効になります。デフォルト値はNOです。詳細は、「CICSランタイム統計」を参照してください。
この必須の変数は、ARTATRNが遅延非同期トランザクションに対して使用する、ASYNC_QSPACEという名前のTuxedo qspaceを作成するために使用されます。
IPCキーには、ほかのIPCリソースの要件と競合しない値を指定します。この値は32,768より大きく262,143未満にします。
KIX_RESSECは、リソースベースの認可を有効または無効にするオプションの環境変数です。
GETMAIN SHAREDに必須です。これは、GETMAIN SHAREDに使用される共有メモリー・セグメントのIPCKEYを示します。
IPCKEYは共有メモリーごとに一意である必要があります。KIX_SHR_IPCKEYに指定されているIPCKEY値がすでに使用されている場合は、正常に機能しません。このIPCKEYを持つ共有メモリーがGETMAIN SHAREDに使用されていない場合は、サーバーが起動に失敗します。GETMAIN SHAREDに使用されている場合は、サーバーは共有メモリーへのアタッチを試み、メモリーの割当てにこれを使用しようとします。
GETMAIN SHAREDに必須です。これは、GETMAIN SHAREDに使用されている共有メモリーのサイズをメガバイト単位で示します。有効な範囲は0-32768*1024です。値0は、GETMAIN SHAREDのサポートがないことを示します。オーバーヘッドが内部実装メカニズムにより導入されたため、ユーザーが使用できる実際のメモリー・サイズはKIX_SHR_SIZEで示される値よりも小さくなります。
GETMAIN SHAREDにオプションです。共有メモリーのアタッチ・アドレスは、デフォルトで0x300000000000です。この値が指定されている場合は、ページ境界に合ったアドレスである必要があります。範囲0x300000000000 - 0x500000000000のアドレスが有効です。
これはオプションの環境変数です。Micro Focus COBOLを使用する場合は、KIX_SO_SUBSYS_WRAPPER=YESを設定します。すると、ARTはラッパー・プログラムを使用して実際のユーザー・プログラムをコールします。これにより、ユーザー・プログラムが.so書式である場合に、working-storage変数の初期化に対処できます。デフォルト値はNOです。
SPOOL関数に使用されるオプションの環境変数です。KIX_SPOOL_JOB_SUBMITが設定されていない場合のみ、KIX_SPOOL_JOB_AUTO_SUBMITがYESまたはyesに設定されていると、スプール・ファイルが自動的に送信されます。
例: KIX_SPOOL_JOB_AUTO_SUBMIT=yes
SPOOL関数に使用される必須の環境変数です。スプール・ファイルの送信用コマンド行を示します。コマンド行には、最初にスプール・ファイル名を参照する必須の%s記号を、2番目にはCLASSを参照する任意の%s記号を含める必要があります。
例: KIX_SPOOL_JOB_SUBMIT=/my_path/my_shell_script -f %s -c %s
| 注: | このスクリプトは、バッチ実行環境で実行する必要があります。「nohup」および「&」コマンドを使用すると、ログアウト後もバックグラウンドでスクリプトを実行し続けることが可能です。 |
SPOOL関数に使用される必須の環境変数です。CICS Runtimeが<spool_token>.<sever_pid>.<time_in_microseconds>.<occurrence_number>というスプール・ファイルを書き込む場所のディレクトリを示します。
KIX_TD_DIRは、エクストラ・パーティションTDQueuesに対応するファイルがあるディレクトリを示す必須の環境変数です。
KIX_TD_QSPACE_DEVICEは、TD QUEUE(INTRA)に必須な環境変数です。tdq_srvサーバーに必要なTuxedo QSPACEを示します。
KIX_TD_QSPACE_IPCKEYは、TD QUEUE(INTRA)に必須な環境変数です。tdqサーバーに必要なTuxedo QSPACEを示します。
KIX_TD_QSPACE_NAMEは、TD QUEUE(INTRA)に必須な環境変数です。tdqサーバーに必要なTuxedo QSPACE名を示します。
KIX_TECH_DIRは、テクニカル・ファイルがART CICSによって、たとえばREQIDオプションを介して名前付きのDELAYやCANCELを管理するために内部的に使用されたり、ENQ/DEQが書き込まれたりするディレクトリを示す必須の環境変数です。1つのCICSリージョン上で送信された名前付きのDELAYを別の地域で簡単に取り消しできないというソース制限を再現する場合を除き、各サーバーに対して同一である必要があります。
KIX_TS_DIRは、回復不可能なTSに対応するファイルがあるディレクトリを示す必須の環境変数です。各tsqサーバーのenvfileで異なる設定をすることで、サーバーごとに差違化できます(Tuxedoのドキュメントを参照)。
このオプションの変数を使用すると、管理者がシステム・アクティビティのトレースを取得できます。
設定できる範囲は0 - 9で、0はトレースなし、9は最大トレースを意味します。変数が定義されない場合、デフォルト値は0です。最も関係性が強いトレース・レベルは次のとおりです。
サポート・チーム用に他のレベルが予約されています。レベルが上がるほど、低いレベルで伝達されたトレースをすべてカバーします。
KIX_USER_TRACEがSIDに設定されている場合、KIX_TRACE_PATH変数を設定する必要があります。トレース・ファイルが保存されるディレクトリを定義します(ファイル名は.trcで終わります)。
ARTTSQのオプションの変数です。KIX_TSQ_FILE_OPT=YESに設定すると、リカバリ不能なTSQのファイルの開閉の最適化が有効になります。デフォルトはNOです。
このオプションの変数は、トレースのタイプ(1接続当たり1つのトレース・ファイル、または同じファイルですべてのトレース)を定義します。
KIX_USER_TRACE=SIDは、1接続当たりに1つのトレース・ファイルを表します。もう1つの値はSTDで、この場合、トレースはサーバーの各stdoutに出力され、変数が設定されていない場合は、STDとみなされます。
複数の同名のARTサーバーに対して、トランザクション / コマンド監査ツールを使用する場合は、SIDを使用してください。
KIX_XA_REOPEN_THRESHOLDはオプションの環境変数です。RM再オープンをトリガーするしきい値を定義します。しきい値は、連続するXA操作の失敗数です。XA操作は、Tuxedoパースペクティブからのtpbegin/tpcommit/tpabortです。しきい値が満たされると、ART for CICSアプリケーション・サーバー(ARTSTRN/1、ARTATRN/1、ARTCTRN/1、ARTWTRN/1およびARTDPL)はトランザクション・サービスを一時停止し、RMを再オープンして失敗を回復しようとします。KIX_XA_REOPEN_THRESHOLDは10進の正の値である必要があります。設定されていない場合、XAエラーの検出とRMの再オープン関数は有効ではありません。
KIX_XA_REOPEN_INTERVALはオプションの環境変数です。2つのXA再オープン試行間の間隔を秒数で定義します。XA_REOPEN_THRESHOLDを設定する場合、KIX_XA_REOPEN_INTERVALを指定します。値は10進の正の整数である必要があります。デフォルトの間隔は30秒です。
LD_LIBRARY_PATHは、ライブラリの場所を指定するオプションの環境変数です。
  
|