caspac

caspac ユーティリティを使用して PAC を管理できます。

構文：

caspac -a{action}=object -p{PACName} -s{sor} -n{psorName}

パラメーター：

-a

実行するアクション、およびそのアクションが実行されるオブジェクトを指定します。

action

PAC の管理をサポートするアクション：

InitPac

コールドスタート用に PAC を初期化します。PAC を強制的に初期化すると、PSOR からすべての情報が削除されます。このオプションを適用するのは、指定した PAC のすべてのリージョンが停止している場合だけにする必要があります。

Status

PAC の現在のステータスを表示します。

Dump

指定した PAC に対して作成された SOR のダンプファイルを作成します。

注: caspac の Dump アクションでは、別のファイル名でファイルが作成されます。エンドポイントの代わりにテキスト _coh_ が含まれ、拡張子は .rdmp のままになります。

Restore

指定したスケールアウトリポジトリ (SOR) にダンプファイルを復元します。

PacLog

指定した SOR を使用して PAC で生成されたメッセージのログファイルを作成します。

SetMode

作業モードを指定します。次のいずれかの値を指定できます。

Running: 指定した PSOR でバッチワークロードおよび EXEC CICS START を処理できるように作業モードフラグを設定します。
Quiesce: 指定した PSOR でバッチワークロードおよび EXEC CICS START を処理できないように作業モードフラグを設定します。

CheckCompat

指定した PSOR が現在インストールされているエンタープライズサーバーインスタンスとは別のバージョンで作成されている場合の互換性のチェックに使用します。互換性がない場合は次のようなメッセージが表示され、戻りコードは -1 になります。

Located an incompatible CSA record in the PSOR, a compatible upgrade is not possible.

RemOldPAC

PAC 名がプレフィックスとして付いていない Enterprise Developer 7.0 PU8 よりも前に作成された PAC ストア (PSOR) を削除できます。

RemShrQueues

SOR を定義するときに新しい ESCWA オプションを使用して PAC 間で TS および TD を共有できる Enterprise Developer 8.0 で導入されたストア (Shared_CasTSQ_RC、Shared_CasTSQ_NR、Shared_CasTDQ_RC、および Shared_CasTDQ_NR) をすべて削除します。

回復をサポートするアクション：

CasDEQs="file_path\file_name.csv": タスクの終了時やジョブまたはトランザクションの実行中に DEQ で発生した可能性があるすべてのエラーをリストするために使用します。
このアクションにより、dbfhadmin コマンドを使用して手動で DEQ を回復するために使用できる CSV ファイルが生成されます。
RecoverUUID: PAC を離れたエンタープライズサーバーリージョンの UUID を指定すると、そのエンタープライズサーバーリージョンに関連するすべてのエントリが PSOR から削除されます。

プログラムのディプロイをサポートするアクション：

Delete

ロードされているファイルを SOR から削除します。

リスト

SOR にロードされているユーザープログラムをリストします。

Load

caspac コマンドが発行された時点で、CICS と JES を除くオブジェクトをロードしてディプロイします。オブジェクトは、リージョンの作業領域の PAC_LOADLIB フォルダーにディプロイされます。

LoadCics

CPMT NE コマンドの実行時に、オブジェクトをディプロイ用に CICS にロードします。オブジェクトは、リージョンの作業領域の PAC_LOADLIB_CICS フォルダーにディプロイされます。

LoadJes

オブジェクトをロードし、リージョンの作業領域の PAC_LOADLIB_JES フォルダーに直接ディプロイします。

object

アクションで使用するオブジェクトを指定します。実行するアクションに応じて、次のいずれかの値を指定できます。

DLL
共有オブジェクト
PAC 名
ダンプファイル
PAC ログファイル

注: オブジェクト名では大文字と小文字が区別されます。

-ssor

SOR のタイプとその接続パラメーターを指定します。

注: 接続パラメーターは Redis と Oracle Coherence で異なります。詳細については、「PAC および SOR の環境変数」を参照してください。

Redis の SOR に接続する場合は次のようになります。

redis,127.0.0.1:6741

Coherence の SOR に接続する場合は次のようになります。

coherence,mfes-cache-config.xml,coherence.cluster=MyPAC_cluster,mfescache.wka.MyPAC_cluster=127.0.0.1:7574

-n{psorName}

PAC SOR の名前。これは、Redis AUTH 認証要求または Redis SENTINEL にのみ必要です。詳細については、「Providing Credentials for Redis using Secrets」を参照してください。

Redis AUTH を使用する場合、参照として使用される各 PSOR について、-n オプションを使用してコンテナー機能でシークレットを作成する必要があります。

-p{PACName}

使用する PAC 名。これが指定されていない場合、PAC 名は ES_PAC 環境変数から取得されます。PSOR には PAC 名とバージョン番号がプレフィックスとして付けられるため、同じ PSOR から複数の PAC を実行できます。これは、互換性のないアップグレードプロセスの実行に役立ちます。

説明：

Enterprise Developer 8.0 以降では、PSOR ストアに PAC 名とバージョン番号がプレフィックスとして付けられるため、同じ PSOR から複数の PAC を実行できます。これにより、互換性のないアップグレードプロセスが簡単になります。

caspac ユーティリティでは、-pPACName を使用して、コマンドラインパラメーターの一部として PAC 名を追加できます。指定されていない場合は、ES_PAC 環境変数が使用されます。

例

次の例では、ポート 6741 の 127.0.0.1 にある Redis サーバーで表される SOR に acct.dll をロードします。この acct.dll は、New Copy コマンドを使用して、PAC 内のすべてのアクティブなエンタープライズサーバーインスタンスにディプロイできます。
```
caspac -pMyPAC -aLoadCics="c:\new files\acct.dll" -sredis,127.0.0.1:6741 -npsorName
```
次の例では、ポート 6741 の 127.0.0.1 にある Redis サーバーで表される SOR に c:\new files にあるすべてのファイルをロードします。これは JES であるため、New Copy コマンドは必要ありません。
```
caspac -pMyPAC -aLoadJes="c:\new files\*.*" -sredis,127.0.0.1:6741 -npsorName
```
次の例では、ポート 6741 の 127.0.0.1 にある Redis サーバーで表される SOR に c:\new files にある CICS と JES のファイルを除くすべてのファイルをロードします。
```
caspac -pMyPAC -aLoad="c:\new files\*.*" -sredis,127.0.0.1:6741 -npsorName
```
次の例では、ポート 6741 の 127.0.0.1 にある Redis サーバーで表される SOR から acct.dll を削除します。
```
caspac -pMyPAC -aDelete=acct.dll -sredis,127.0.0.1:6741 -npsorName
```
次の例では、SOR にアップロードされているユーザープログラムをリストします。
```
caspac -pMyPAC -aList=* -sredis,127.0.0.1:6741 -npsorName
```
次の例では、コールドスタートの準備ができている MyPAC という PAC を初期化します。この PAC には、ポート 6741 の 127.0.0.1 にある Redis サーバーを使用する PSOR があります。
```
caspac -aInitPac=MyPAC -sredis,127.0.0.1:6741 -npsorName
```
次の例では、127.0.0.1 にある MyPAC_cluster というクラスターで Oracle Coherence を使用しています。
```
caspac -aInitPac=MyPAC -scoherence,,coherence.cluster=MyPAC_cluster,mfescache.wka.MyPAC_cluster=127.0.0.1
```
次の例では、MyPAC という PAC のステータスを返します。この PAC には、ポート 6741 の 127.0.0.1 にある Redis サーバーを使用する PSOR があります。
```
caspac -aStatus=MyPAC -sredis,127.0.0.1:6741 -npsorName
```
次の例では、127.0.0.1 にある MyPAC_cluster というクラスターで Oracle Coherence を使用している PAC のステータスを返します。
```
caspac -aStatus=MyPAC -scoherence,,coherence.cluster=MyPAC_cluster,mfescache.wka.MyPAC_cluster=127.0.0.1
```
次の例では、MyPAC という PAC のダンプを作成します。この PAC には、ポート 6741 の 127.0.0.1 にある Redis サーバーを使用する PSOR があります。
```
caspac -aDump=MyPAC -sredis,127.0.0.1:6741 -npsorName
```
次の例では、127.0.0.1 にある MyPAC_cluster というクラスターで Oracle Coherence を使用している PAC のダンプを作成します。
```
caspac -aDump=MyPAC -scoherence,,coherence.cluster=MyPAC_cluster,mfescache.wka.MyPAC_cluster=127.0.0.1
```
次の例では、CasPAC_127.0.0.1_06741.rdmp ダンプファイルから PAC を復元します。この PAC には、ポート 6741 の 127.0.0.1 にある Redis サーバーを使用する PSOR があります。
```
caspac -aRestore=CasPAC_127.0.0.1_06741.rdmp -sredis,127.0.0.1:6741 -npsorName
```
次の例では、* ワイルドカードを使用して一致するダンプファイルから PAC を復元します。この PAC には、ポート 6741 の 127.0.0.1 にある Redis サーバーを使用する PSOR があります。
```
caspac -aRestore=*.rdmp -sredis,127.0.0.1:6741 -npsorName
```
次の例では、* ワイルドカードを使用して一致するダンプファイルから PAC を復元します。この PAC には、127.0.0.1 にある MyPAC_cluster というクラスターで Oracle Coherence を使用している PSOR があります。
```
caspac -aRestore=*.rdmp -scoherence,,coherence.cluster=MyPAC_cluster,mfescache.wka.MYPAC_cluster=127.0.0.1
```
次の例では、指定したフォルダーおよびファイルに PAC ログファイルを書き込みます。この PAC には、ポート 6741 の 127.0.0.1 にある Redis サーバーを使用する PSOR があります。
```
caspac -aPacLog="c:\temp\PacLog.log" -sredis,127.0.0.1:6741 -npsorName
```
次の例では、指定したフォルダーおよびファイルに PAC ログファイルを書き込みます。この PSOR では、127.0.0.1 にある MyPAC_cluster というクラスターで Oracle Coherence を使用しています。
```
caspac -aPacLog=/tmp/paclog.log -scoherence,,coherence.cluster=MyPAC_cluster,mfescache.wka.MyPAC_cluster=127.0.0.1
```
次の例では、指定した PAC とポート 6741 の 127.0.0.1 にある Redis サーバーを使用する PSOR との互換性をチェックします。
```
caspac -aCheckCompat=MyPAC -sredis,127.0.0.1:6741
```
次の例では、PAC を実行モードまたは通常の動作モードに設定します。この PAC には、ポート 6741 の 127.0.0.1 にある Redis サーバーを使用する PSOR があります。
```
caspac -aSetMode=Running -sredis,127.0.0.1:6741 -npsorName
```
次の例では、PAC を休止モードにします。この PAC には、ポート 6741 の 127.0.0.1 にある Redis サーバーを使用する PSOR があります。
```
caspac -aSetMode=Quiesce -sredis,127.0.0.1:6741 -npsorName
```
次の例では、ポート 6741 の 127.0.0.1 にある Redis サーバーの DEQ エラーのリストを含む .csv ファイルをエクスポートします。
```
caspac -pMyPAC -aCasDEQs="c:\temp\DEQ_report.csv" -sredis,127.0.0.1:6741 -npsorName
```
次の例では、ポート 6741 の 127.0.0.1 にある Redis サーバーの指定した UUID に対応するエントリを PSOR から削除します。
```
caspac -pMyPAC -aRecoverUUID=1059443BD0330489609618E90F76B91B -sredis,127.0.0.1:6741 -npsorName
```
次の例では、ポート 6741 の 127.0.0.1 にある Redis サーバーからプレフィックスが付いていないストアに対応する MyPAC のすべての PSOR エントリを削除します。
```
caspac -aRemOldPAC=MyPAC -sredis,127.0.0.1:6741 –npsorName
```
次の例では、ポート 6741 の 127.0.0.1 にある Redis サーバーからすべての Shared_CasTSQ_RC、Shared_CasTSQ_NR、Shared_CasTDQ_RC、および Shared_CasTDQ_NR ストアを削除します。
```
caspac -aRemShrQueues -sredis,127.0.0.1:6741 -npsorName
```