castran

CICS トランザクションに関する情報を検索または更新します。主な用途はトランザクションを有効または無効にすることですが、このコマンドを使用して TWA サイズやタイムアウト値などの他の値を変更したり、トランザクションのステータスを表示したりすることもできます。また、PPT で定義されている CICS プログラムに対する PHASEIN または NeWCOPY を実行することもできます。

NEWCOPY オプションを使用すると、指定したプログラムが現在使用中でない場合にのみ、そのプログラムの新しいコピーがロードされます。それ以外の場合は失敗します。PHASEIN オプションを使用すると、そのプログラムが現在実行中であっても新しいコピーがロードされます。その場合、以前にロードされたコピーは、使用されなくなるまで存続します。再ロード後に発生する要求では、新しいコピーが必ず使用されます。

注: castran は、それを呼び出す単純な COBOL プログラムを記述することにより、JCL 内から起動することもできます。

構文:
castran [/res-name] [/mprototype:host:WebServiceport] [/fserver-name]
    [/ttrans-id]
    [/e{e|d}]
    [/s{y|n|a}]
    [/g{y|n}]
    [/j{d|a}]
    [/d{y|n}]
    [/loutput-log]
    [/wTWA-size]
    [/qinput-timeout]
    [/xrunaway-timeout]
    [/ydeadlock-timeout]
    [/pprogram-name]
    [/nprogram-name]
    [/uuserid]
    [/apassword]
    [/cgroup]

コマンド・ファイルから複数のコマンドを発行する場合の構文:
castran [/res-name] [/mprototype:host:WebServiceport] [/fserver-name] /iinput-script-file
パラメータ:
/res-name 接続先のエンタープライズ・サーバーの名前。デフォルトでは ESDEMO に設定されます。

注:このユーティリティーを JCL または WEB サービスから呼び出す場合 (つまり、このユーティリティーを SEP 内で実行している場合) は、/r オプションを使用してサーバーに接続することはできません。その場合は、/m または /f オプションを使用してサーバーに接続する必要があります。

または
/mprototype:host:WebServiceport 接続先となるエンタープライズ・サーバーの Web サービスおよび J2EE リスナーのロケーション。例えば、/mtcp:localhost:9003。
または
/fserver-name 接続先のエンタープライズ・サーバーの名前。ルックアップを実行してエンタープライズ・サーバーの Web サービスを特定するという点で、これは /r オプションと異なります。
[-iinput-script-file] 実行するコマンドのリストが保存される入力スクリプト・ファイル。スクリプトファイルでは、コメント行の列 1 は # でなければなりません。
[-ttrans-id] 4 バイトのトランザクション ID。
[-e{e|d}] 指定したトランザクションの Enable ステータスを設定します。
設定 説明
e または値なし イネーブル
d ディスエーブル
[-s{y|n|a}] 指定したトランザクションの完全なトランザクション・ステータスを出力します。
設定 説明
y または値なし 表示
n 非表示
a /t オプションで指定したトランザクション ID に関係なく、PCT 内のすべてのトランザクションの詳細を表示します。
[-g{y|n}] 指定したトランザクションの Upper Case Translation ステータスを設定します。
設定 説明
y または値なし 大文字変換
n 大文字変換なし
[-j{d|a}] 指定したトランザクションの Screen ステータスを設定します。
設定 説明
d または値なし デフォルト
a 代替
[-d{y|n}] 指定したトランザクションの Transaction Dump ステータスを設定します。
設定 説明
y トランザクション・ダンプ
n または値なし トランザクション・ダンプなし
[-loutput-log] コマンドからの出力が書き込まれるファイル。デフォルトの書き込み先は、標準出力です。
[-wTWA-size] 指定したトランザクションの TWA Size {0..32767} を設定します。
[-qinput-timeout] 指定したトランザクションの Input Timeout を設定します。
設定 説明
s または値なし システムのデフォルト
0..4080 秒単位のタイムアウト値
[-xrunaway-timeout] 指定したトランザクションの Runaway Timeout を設定します。
設定 説明
s または値なし システムのデフォルト
0..2700 秒単位のタイムアウト値
[-ydeadlock-timeout] 指定したトランザクションの Deadlock Timeout を設定します。
設定 説明
s または値なし システムのデフォルト
0..4080 秒単位のタイムアウト値
[-pprogram-name] 指定したプログラムに対する PHASEIN を発行します。これは /t オプションで指定したトランザクション ID とは無関係であることに注意してください。
[-nprogram-name] 指定したプログラムに対する NEWCOPY を発行します。これは /t オプションで指定したトランザクション ID とは無関係であることに注意してください。
[-uuserid] 認証ユーザー ID
[-apassword] 認証パスワード
[-cgroup] 認証グループ (オプション)

注:/r、/m、/f オプションは、接続先となるエンタープライズ・サーバーを識別するための代替方法です。

戻りコード:
0 成功
4 無効フラグ/重複フラグ
12 トランザクション ID が PCT で見つからない / プログラムが PPT で見つからない / 不正なユーザー ID またはパスワード
15 リージョンが実行されていない / 無効なコマンド
依存性:

castran コマンドを発行する前に、エンタープライズ・サーバーを起動しておく必要があります。

コメント:

同じパラメータ・タイプを複数指定した場合は、最初に指定したものだけが使用されます。それ以外はすべて無視されます。

TWA サイズやタイムアウト・オプションが最大値を超えている場合は、最大値に設定されます。

スラッシュ (/) の代わりにダッシュ (-) を使用してコマンド・オプションを示すことができます。

スクリプト・ファイルの各行には、トランザクション ID またはプログラム名が含まれている必要がありますが (コメントを除く)、 リージョン名を含めることはできません。つまり、スクリプト・ファイル内のコマンドは、すべて 1 つのリージョンに関係しており、そのリージョンは、castran の最初の呼び出しで指定されます。パスまたはファイル名にスペースが含まれている場合は、そのパスまたはファイル名を引用符で囲む必要があります。その例を次に示します。

castran /rESDEMO /i"c:\input scripts\my script.txt"

セキュリティーが有効化されているエンタープライズ・サーバーで castran を使用するには、すべてのリソース定義が最新のものであることを確認する必要があります。これを行うには、次のコマンドを発行します。

caspcupg /r<server name> /dp=<dfhdrdat path>
例:

ACCT という CICS トランザクションを無効にして、そのステータスを ESDEMO というリージョンで表示する場合:

castran /rESDEMO /tACCT /ed /sy

TWA サイズを変更し、安全なリージョンで ACCT の大文字変換をオフにする場合:

castran /rESDEMO /uSYSAD /aSYSAD /w255 /gn /tACCT

入力スクリプトを使用して複数の操作を実行する場合:

castran /rESDEMO /imultiple_cmds.txt

multiple_cmds.txt に次の行が含まれる場合:

# multiple castran commands
/tACCT /ed
/tAC01 /ee /ja
/nACCT00