Hitachi

OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 プロトコル TP1/NET/OSAS-NIF編


mcftalccn(コネクション定義の開始)

〈このページの構成〉

形式

mcftalccn -c コネクションID
          -p onf
          -n x'自システムのPSAPアドレス'
          -q x'相手システムのPSAPアドレス'
          -g "sndbuf=メッセージ送信用バッファグループ番号
              rcvbuf=メッセージ受信用バッファグループ番号"
         〔-e "msgbuf=メッセージ編集用バッファグループ番号
              count=メッセージ編集用バッファ数"〕
          -m "mode=xnfas"
         〔-t int|rsp〕
         〔-i auto|manual〕
         〔-b "〔bretry=yes|no〕
               〔bretrycnt=コネクション確立障害時の確立再試行回数〕
               〔bretryint=コネクション確立障害時の確立再試行間隔〕"〕
         〔-v "〔tim1=正常処理監視タイマ値〕
               〔tim2=ユーザ処理監視タイマ値〕
               〔tim3=送達確認監視タイマ値〕
               〔tim4=連続送信監視タイマ値〕
               〔tim5=終了処理監視タイマ値〕"〕
          -o "ownsid=x'自システムID'
              otrsid=x'相手システムID'"
         〔-y "〔nummax=NIF通番最大値〕"〕
         〔-x "〔embed=yes|no〕
               〔agentnum=asn1|fixed〕"〕
          -z "slot=仮想スロット番号"

機能

コネクションに関する環境を定義します。

オプション

● -c コネクションID  〜〈識別子〉((1〜8文字))

OpenTP1システム内で,一意となるコネクションIDを指定します。

● -p onf

プロトコルの種別を指定します。

onf

NIF/OSIプロトコル

● -n x'自システムのPSAPアドレス'  〜〈1〜142文字の16進数字〉

自システムのPSAPアドレスを指定します。

自システムのPSAPアドレスの形式を次の図に示します。

[図データ]

ほかのコネクションが使用するPSAPアドレスと重複しないPSAPアドレスを指定してください。

● -q x'相手システムのPSAPアドレス'  〜〈1〜186文字の16進数字〉

相手システムのPSAPアドレスを指定します。

相手システムのPSAPアドレスの形式を次に示します。なお,NSAP値の形式については,マニュアル「通信管理 XNF/AS NSAPアドレス概説編」を参照してください。

[図データ]

-nオプションで指定する自システムのPSAPアドレスと,-qオプションで指定する相手システムのPSAPアドレスの組み合わせは,ほかのコネクションが使用する組み合わせと重複しないでください。

● -g

(オペランド)

sndbuf=メッセージ送信用バッファグループ番号  〜〈符号なし整数〉((1〜512))

メッセージ送信用バッファのグループ番号を指定します。

バッファグループ定義(mcftbuf -g)のgroupnoオペランドに指定されているバッファグループ番号を指定してください。

rcvbuf=メッセージ受信用バッファグループ番号  〜〈符号なし整数〉((1〜512))

メッセージ受信用バッファのグループ番号を指定します。

バッファグループ定義(mcftbuf -g)のgroupnoオペランドに指定されているバッファグループ番号を指定してください。

● -e

(オペランド)

msgbuf=メッセージ編集用バッファグループ番号  〜〈符号なし整数〉((1〜512))

入力,出力メッセージ編集UOC呼び出し時に,メッセージ編集用として使用するバッファグループ番号を指定します。

このオペランドを省略した場合は,メッセージ編集用バッファは確保されません。メッセージ編集用バッファグループ番号は,バッファグループ定義(mcftbuf -g)のgroupnoオペランドで指定するバッファグループ番号を指定してください。

count=メッセージ編集用バッファ数  〜〈符号なし整数〉((1〜131070))

入力,出力メッセージ編集UOC呼び出し時に,メッセージ編集用として使用するバッファの数を指定します。

msgbufオペランドで指定するメッセージ編集用バッファグループ番号に対応するバッファグループ定義(mcftbuf -g)のcountオペランドおよびextendオペランドで指定するバッファ数の中から,メッセージ編集用に使用するバッファ数を指定してください。

メッセージ編集用バッファグループ番号に対応するmcftbufのcountオペランドおよびextendオペランドには,すべての論理端末で入力メッセージ編集UOCおよび出力メッセージ編集UOCが,同時に動作した場合を考慮した面数を指定してください。

また,このオペランドの指定は,バッファグループ定義(mcftbuf -g)のcountオペランドおよびextendオペランドで指定されたバッファ数の合計値を超える指定はできません。

msgbufオペランドを省略した場合は,このオペランドの指定は無効です。

msgbufオペランドを指定した場合,このオペランドを省略できません。省略した場合,定義オブジェクト生成時にKFCA11519-Eメッセージを出力してエラーとなります。

● -m

(オペランド)

mode=xnfas

使用する通信管理を次の値で指定します。

このオペランドは必ず指定してください。

xnfas

XNF/AS

● -t int|rsp  〜《int》

コネクション確立時の発呼と着呼の識別を指定します。

int

自システムが発呼側

rsp

自システムが着呼側

● -i auto|manual  〜《manual》

オンライン開始時にコネクションを自動的に確立するかどうかを指定します。

auto

オンライン開始時にコネクションを自動的に確立します。

manual

MCF起動後,コネクションを確立します。コネクションの確立は,運用コマンド(mcftactcn)の入力,またはAPI(dc_mcf_tactcn関数もしくはCBLDCMCF('TACTCN△△'))の発行で行います。

● -b

(オペランド)

bretry=yes|no  〜《yes》

コネクション確立時に障害が発生した場合,コネクション確立再試行をするかどうかを指定します。

yes

コネクション確立再試行をします。

no

コネクション確立再試行をしません。

bretrycnt=コネクション確立障害時の確立再試行回数  〜〈符号なし整数〉((0〜65535))《0》(単位:回)

コネクションの確立再試行をする場合の確立再試行回数を指定します。このオペランドを省略した場合,または0を指定した場合,確立再試行を無限回繰り返します。

bretryオペランドでnoを指定した場合,bretrycntオペランドの指定は無効になります。

bretryint=コネクション確立障害時の確立再試行間隔  〜〈符号なし整数〉((0〜2550))《60》(単位:秒)

コネクションの確立再試行をする場合の確立再試行間隔を指定します。0を指定した場合,直ちにコネクションの確立再試行をします。

bretryオペランドでnoを指定した場合,bretryintオペランドの指定は無効になります。

注意事項

再試行間隔の精度は秒単位です。また,タイマ定義(mcfttim -t)のbtimオペランドで指定する時間の間隔で再試行するかどうかをチェックします。このため,このオペランドで指定した再試行間隔と実際に再試行する時間には秒単位の誤差が生じます。

● -v

(オペランド)

tim1=正常処理監視タイマ値  〜〈符号なし整数〉((0,10〜8191))《60》(単位:秒)

正常処理監視タイマ値を指定します。

0を指定した場合,正常処理監視をしません。

注意事項

監視時間の精度は秒単位です。また,タイマ定義(mcfttim -t)のbtimオペランドで指定する時間の間隔でタイムアウトが発生したかどうかを監視しています。このため,このオペランドで指定した監視時間と実際にタイムアウトを検出する時間には秒単位の誤差が生じます。そのため,タイミングによっては,指定した監視時間よりも短い時間でタイムアウトすることがあります。

tim2=ユーザ処理監視タイマ値  〜〈符号なし整数〉((0,10〜8191))《60》(単位:秒)

ユーザ処理監視タイマ値を指定します。

0を指定した場合,ユーザ処理監視をしません。

注意事項

監視時間の精度は秒単位です。また,タイマ定義(mcfttim -t)のbtimオペランドで指定する時間の間隔でタイムアウトが発生したかどうかを監視しています。このため,このオペランドで指定した監視時間と実際にタイムアウトを検出する時間には秒単位の誤差が生じます。そのため,タイミングによっては,指定した監視時間よりも短い時間でタイムアウトすることがあります。

tim3=送達確認監視タイマ値  〜〈符号なし整数〉((0,10〜8191))《60》(単位:秒)

送達確認監視タイマ値を指定します。

0を指定した場合,送達確認監視をしません。

注意事項

監視時間の精度は秒単位です。また,タイマ定義(mcfttim -t)のbtimオペランドで指定する時間の間隔でタイムアウトが発生したかどうかを監視しています。このため,このオペランドで指定した監視時間と実際にタイムアウトを検出する時間には秒単位の誤差が生じます。そのため,タイミングによっては,指定した監視時間よりも短い時間でタイムアウトすることがあります。

tim4=連続送信監視タイマ値  〜〈符号なし整数〉((0,10〜8191))《60》(単位:秒)

連続送信監視タイマ値を指定します。

0を指定した場合,連続送信監視をしません。

注意事項

監視時間の精度は秒単位です。また,タイマ定義(mcfttim -t)のbtimオペランドで指定する時間の間隔でタイムアウトが発生したかどうかを監視しています。このため,このオペランドで指定した監視時間と実際にタイムアウトを検出する時間には秒単位の誤差が生じます。そのため,タイミングによっては,指定した監視時間よりも短い時間でタイムアウトすることがあります。

tim5=終了処理監視タイマ値  〜〈符号なし整数〉((0,10〜65535))《300》(単位:秒)

終了処理監視タイマ値を指定します。

0を指定した場合,終了処理監視をしません。

注意事項

監視時間の精度は秒単位です。また,タイマ定義(mcfttim -t)のbtimオペランドで指定する時間の間隔でタイムアウトが発生したかどうかを監視しています。このため,このオペランドで指定した監視時間と実際にタイムアウトを検出する時間には秒単位の誤差が生じます。そのため,タイミングによっては,指定した監視時間よりも短い時間でタイムアウトすることがあります。

● -o

(オペランド)

ownsid=x'自システムID'  〜〈16進数字〉((0001〜ffff))

自システムのシステムIDをネットワーク内で一意に指定します。

otrsid=x'相手システムID'  〜〈16進数字〉((0001〜ffff))

相手システムのシステムIDをネットワーク内で一意に指定します。

● -y

(オペランド)

nummax=NIF通番最大値  〜〈符号なし整数〉((1〜4294967295))《32767》

通番管理機能で使用するNIF通番の最大値を指定します。

● -x

(オペランド)

embed=yes|no  〜《yes》

コネクションの確立方式を指定します。

ただし,-tオプションでrspを指定した場合,このオペランドの指定は無効になります。

yes

重畳型(OSI構造の層の中のACSEとNIF/OSIを同時に確立します。重畳型で接続できる端末の台数は,1〜33台です)

no

非重畳型(OSI構造の層の中のACSEを確立してからNIF/OSIを確立します。非重畳型で接続できる端末の台数は,1〜2048台です)

agentnum=asn1|fixed  〜《asn1》

NIFヘッダに設定するエージェント番号のオクテット数を指定します。

このオペランドの指定を省略した場合,asn1に設定されます。

asn1

ASN.1のエンコード規則に従い,最小のオクテット数に設定します。

fixed

2オクテット固定で設定します。

● -z

(オペランド)

slot=仮想スロット番号  〜〈符号なし整数〉((0〜65535))

仮想スロット番号を指定します。

XNF/ASの通信構成定義で指定する仮想スロット番号を指定してください。

このオペランドは必ず指定してください。

注意事項

-gオプションおよび-eオプションで指定するバッファグループ番号は,バッファグループ定義(mcftbuf)で指定したバッファグループ番号に対応させてください。mcftbuf定義コマンドでコネクションごとに割り当てる資源の量を次の表に示します。バッファグループ定義の詳細については,マニュアル「OpenTP1 システム定義」を参照してください。

表6‒3 mcftbuf定義コマンドでコネクションごとに割り当てる資源の量

mcftalccn

コマンド

バッファグループ定義 mcftbufコマンド -gオプション

length ※1

count + extend ※2

-g

sndbuf

論理端末数×10

または

コネクション間で最大のメッセージ長どちらかの最大値

論理端末数×(最大セグメント分割数+1)

rcvbuf

論理端末数×10

または

コネクション間で最大のメッセージ長どちらかの最大値

論理端末数×(最大セグメント分割数+1)+2※3

-e

msgbuf

ユーザ任意値(入力メッセージ編集UOC出力メッセージ編集UOCで編集したメッセージを格納できるサイズ)

編集用バッファ数

注※1

lengthオペランドに指定できる最大値-256未満の値を指定してください。また,複数コネクションでバッファグループを共用する場合,コネクション間での最大の値を指定します。

注※2

複数コネクションでバッファグループを共用する場合,コネクションごとの和を指定します。

注※3

過着呼による障害検出を使用する場合,着呼型のコネクションごとに加算してください。

TP1/NET/OSAS-NIFは,オンライン開始時に送受信バッファが不足していないかチェックします。バッファが不足している場合,KFCA13525-Wメッセージが出力されます。

なお,オンライン開始時のチェックでは,送受信するメッセージが単一セグメント(最大セグメント分割数が0)と仮定します。このため,複数セグメントのメッセージを送受信するのに,表6-3に示した値より小さい値をバッファグループ定義に指定すると,オンライン開始時にKFCA13525-Wメッセージが出力されないで,オンライン中にバッファ不足が発生することがあるので,注意してください。