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
(オペランド)
● -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メッセージを出力してエラーとなります。
● -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
(オペランド)
注意事項
-gオプションおよび-eオプションで指定するバッファグループ番号は,バッファグループ定義(mcftbuf)で指定したバッファグループ番号に対応させてください。mcftbuf定義コマンドでコネクションごとに割り当てる資源の量を次の表に示します。バッファグループ定義の詳細については,マニュアル「OpenTP1 システム定義」を参照してください。
- 注※1
-
lengthオペランドに指定できる最大値-256未満の値を指定してください。また,複数コネクションでバッファグループを共用する場合,コネクション間での最大の値を指定します。
- 注※2
-
複数コネクションでバッファグループを共用する場合,コネクションごとの和を指定します。
- 注※3
-
過着呼による障害検出を使用する場合,着呼型のコネクションごとに加算してください。
TP1/NET/OSAS-NIFは,オンライン開始時に送受信バッファが不足していないかチェックします。バッファが不足している場合,KFCA13525-Wメッセージが出力されます。
なお,オンライン開始時のチェックでは,送受信するメッセージが単一セグメント(最大セグメント分割数が0)と仮定します。このため,複数セグメントのメッセージを送受信するのに,表6-3に示した値より小さい値をバッファグループ定義に指定すると,オンライン開始時にKFCA13525-Wメッセージが出力されないで,オンライン中にバッファ不足が発生することがあるので,注意してください。