11.1.8.4 オプション

kixpkggen.pyは、次のオプションをサポートしています。

-h --help
ヘルプ・メッセージを表示して終了します。
-a ASSET --asset=ASSET
CICSアセット(ZIPファイル)を指定します。
-u --ubb
UBBCONFIGのみを生成します。
conf
XML構成ファイルを指定します。

次の表に、XML構成ファイルの要素を示します。次のリスト12-10はテンプレートを示し、後続のリスト12-11はサンプルを示しています。

表11-2 XML構成ファイルの要素 - Resourcesセクション

要素 このファイル内のオカレンス 説明
domain-info 0または1 Resourcesセクション
domainid 0または1 UBBCONFIG DOMAINID
ipckey 0または1 IPCKEY
servers 0または1 ドメイン・レベルに定義されたサーバー(たとえばARTTCPL)
server n serverには次の属性があります。
  • name: サーバーの名前(必須)。
  • hostname: サーバーが実行されるホスト名。デフォルトでマスター・マシンです。
  • clopt: サーバーのCLOPT。
  • conv: サーバーが会話型サーバーであるかどうか。YまたはNに設定します。
  • rm-group: RMグループID (指定しない場合、デフォルトで非RMグループに設定されます)。
option 0またはn UBBCONFIGのリソース・セクションのパラメータ。次の属性があります。
  • name: パラメータ名
  • value: パラメータ値

表11-3 XML構成ファイルの要素 - Machinesセクション

要素 このファイル内のオカレンス 説明
mach-info 1 Machinesセクション
machine n N/A
hostname 1 uname -nが返すホスト名。
rm-group 1 rm-infoセクションのRMグループのID (「XML構成ファイルの要素 - RMセクション」表を参照)。
ismaster 0または1 このマシンがMASTERかどうかを示します。YESまたはNOに設定します
nlsport 0または1 NLSポート
nport 0または1 ネットワーク・リスニング・ポート
tuxdir 0または1 Tuxedoインストール・ディレクトリ
artdir 0または1 ART for CICSインストール・ディレクトリ
appdir 0または1 APPDIR
cbldir 0または1 COBOLディレクトリ
cbltype 0または1 COBOLタイプ。MFまたはCITに設定します。cbldirが設定されている場合は必須です。
dbdir 0または1 データベース・ディレクトリ
dbtype 0または1 データベース・タイプ。OracleまたはUDBに設定します。dbdirが設定されている場合は必須です。
path 0または1 バイナリ検索パスに追加されるパス
ldpath 0または1 ライブラリ検索パスに追加されるパス
uid 0または1 UID
gid 0または1 GID
env 0またはn エクスポートされる環境変数。次の属性があります。
  • name: 変数名
  • value: 変数値

表11-4 XML構成ファイルの要素 - CICSリージョン定義

要素 このファイル内のオカレンス 説明
region-info 1 CICSリージョン定義
region-map n  
region 1 リージョンのCICS SYSID
machines 0または1 指定しない場合、リージョンはすべてのマシンに定義されます。
machine n 次の属性があります。
  • nhostname: ホスト名。これは必須です。
  • rm-group: RMグループID。この設定は、前のmachinesセクションに設定された値をオーバーライドします(表「XML構成ファイルの要素 - Machinesセクション」を参照)。
servers 0または1 このリージョンに定義されるART for CICSサーバー。指定しない場合、ARTSTRNおよびARTATRNのみが定義されます。
server n 次の属性があります。
  • type: サーバーのタイプ。有効な値は、STRN、STR1、ATRN、ATR1、CTRN、CTR1、WTRN、WTR1、DPL、TSQ,CKTIおよびCSKLです。
  • name: サーバー名。指定しない場合、rm-group (machine要素)およびtype (server要素)によって決まります。
  • num: 構成されるサーバーの数。デフォルト値は1です。
  • min: MIN。デフォルト値は1です。
  • max: MAX。デフォルト値は1です。
  • clopt: サーバーのCLOPT

表11-5 XML構成ファイルの要素 - RMセクション

要素 このファイル内のオカレンス 説明
rm-info 1 RMセクション
rm n ID属性を指定する必要があります。これは、RMを一意に識別する文字列です。
rm-name 1 RM名
tms-name 0または1 TMSNAME。省略した場合、デフォルトでOracle_XAではTMS_ORAUDB_XAではTMS_UDB(その他はエラー)です。
openinfo 1 OPENINFO
rm-group 1 ID属性を指定する必要があります。これは、RMグループを一意に識別する文字列です。
rm n このグループのRMのID
svr-name 0または1  
str-name 0または1 ART for CICS同期トランザクション・サーバーの名前
atr-name 0または1 ART for CICS非同期トランザクション・サーバーの名前
ctr-name 0または1 ART for CICS会話型トランザクション・サーバーの名前
dpl-name 0または1 ART for CICS DPLサーバーの名前
wtr-name 0または1 ART for CICS非3270同期トランザクション・サーバーの名前
tsq-name 0または1 ART for CICS一時記憶域キュー・サーバーの名前
XML構成ファイル・テンプレートのリスト
<?xml version="1.0" encoding="UTF-8"?>
<config>
  <domain-info>
      <domainid></domainid>
      <ipckey></ipckey>
      <servers>
          <server name='' clopt='' conv='' hostname='' rm-group=''/>
      </servers>
      <option name='' value=''/>
</domain-info>

<mach-info>
    <machine>
        <hostname></hostname>  
        <ismaster></ismaster>
        <tuxdir></tuxdir>
        <artdir></artdir>
        <appdir></appdir>
        <rm-group></rm-group>
        <cbldir></cbldir>    
        <cbltype></cbltype>
        <dbdir></dbdir>
        <dbtype></dbtype>
        <uid></uid>
        <gid></gid>
        <nlsport></nlsport>
        <nport></nport>
        <path></path>
        <ldpath></ldpath>
        <env name='' value='' />
   </machine>
</mach-info>

<region-info>
    <region-map>
        <region></region>  
        <machines>
            <machine hostname='' rm-group=''/>
        </machines>
    <servers>
        <server type='' name='' num='' min='' max='' clopt=''/>
    </servers>
 </region-map>
</region-info>

<rm-info>
    <rm id=''>
        <rm-name></rm-name>
        <tms-name></tms-name>
        <openinfo></openinfo>
    </rm>
    <rm-group id=''>
        <rm></rm>
          <svr-name>    
            <str-name></str-name>
            <atr-name></atr-name>
            <dpl-name></dpl-name>
            <ctr-name></ctr-name>
            <wtr-name></wtr-name>
            <tsq-name></tsq-name>
          </svr-name>
      </rm-group>
  </rm-info>
</config>
XML構成ファイル・サンプルのリスト
<?xml version="1.0" encoding="UTF-8"?>

<config>
    <domain-info>
         <domainid>KIXD</domainid>
         <ipckey>123456</ipckey>
    </domain-info>

   <mach-info>
        <machine>
            <hostname>demobox</hostname>
            <rm-group>1</rm-group>
            <tuxdir>/home/demo/tuxedo22.1.0.0.0</tuxdir>
            <artdir>/home/demo/art22.1.0.0.0</artdir>
            <appdir>/home/demo/workspace/cicsdemo</appdir>
            <cbldir>/opt/cobol-it-3.7.10</cbldir>
            <cbltype>CIT</cbltype>
            <dbdir>/home/oracle/app/oracle/product/11.2.0/db_1</dbdir>
            <dbtype>ORA</dbtype>
        </machine>
  </mach-info>

<region-info>
    <region-map>
        <region>KIXR</region>
    </region-map>
</region-info>

<rm-info>  
    <rm id='1'>
        <rm-name>Oracle_XA</rm-name>

<openinfo>Oracle_XA:Oracle_XA+Acc=P/test/test+SqlNet=orcl</openinfo>
        </rm>

        <rm-group id='1'>
                <rm>1</rm>
            </rm-group>
         </rm-info>
</config>