dc_mcf_timer_set

ANSI C，C++の形式

#include <dcmcf.h>
int dc_mcf_timer_set(DCLONG flags,DCLONG timer,DCLONG timer_id,
                     char *lename,
                     char *apname,char *data,DCLONG data_leng,
                     DCLONG resv01,DCLONG resv02)

K&R版 C の形式

#include <dcmcf.h>
int dc_mcf_timer_set(flags, timer, timer_id, lename,
                      apname, data, 
                      data_leng, resv01, resv02)
DCLONG    flags;
DCLONG    timer;
DCLONG    timer_id;
char      *lename;
char      *apname;
char      *data;
DCLONG    data_leng;
DCLONG    resv01;
DCLONG    resv02;

●flags

DCNOFLAGSを設定します。

●timer

dc_mcf_timer_set関数を呼び出してから，何秒後にMHPを起動させるかを設定します。設定できる秒数は，1から360000まで（1秒から100時間まで）です。

注意事項

時間監視の精度は秒単位です。また，タイマ定義（mcfttim -t）のbtimオペランドで指定する時間監視間隔でタイムアウトが発生したかどうかを監視しています。このため，timerに設定した監視時間と実際にタイムアウトを検出する時間には秒単位の誤差が生じます。そのため，タイミングによっては，設定した監視時間よりも短い時間で起動することがあります。監視時間が小さくなるほど，誤差の影響を受けやすくなりますので，監視時間は3（単位：秒）以上の値の設定を推奨します。

●timer_id

タイマ要求識別子を設定します。

timer_idはこのタイマを一意に識別するための情報です。timer_idは，lenameで指定した論理端末内で必ずユニークになるようにしてください。

●lename

タイムアウトが発生したときにイベントを生成する論理端末名称を8バイト以内で指定します。論理端末名称の最後にはヌル文字を付けます。論理端末名称は，アプリケーション起動サービスの論理端末を指定してもかまいません。

MHPからこの関数を呼び出す場合は，論理端末名称を省略できます。省略する場合には，ヌル文字列を指定します。省略した場合，入力元論理端末を仮定します。

●apname

起動させるMHPのアプリケーション名を指定します。このアプリケーションの属性は，lenameで指定した論理端末を持つMCF通信サーバのMCF通信構成定義mcftenv -aオプションで指定したMCFアプリケーション定義内のアプリケーション属性定義（mcfaalcap）に定義してください。アプリケーション名は最大8バイトです。アプリケーション名の最後にはヌル文字を付けます。MHPは非応答型（noans型）のMHPでなければなりません。指定するアプリケーション名はユーザイベントでなければなりません。

●data

起動させるMHPに渡す，メッセージのセグメントの内容を設定します。複数のセグメントを設定できません。起動させるMHPに渡すセグメントがない場合は，ヌル文字を設定します。

●data_leng

起動させるMHPに渡すセグメントの長さを設定します。起動させるMHPに渡すセグメントがない場合は，0を設定します。

設定できる値の範囲は，0〜256です。設定できる値の最大値はMCF通信構成定義 mcfttimの-pオプションのmsgsizeオペランドに指定した最大メッセージ長に依存します。

●resv01

DCNOFLAGSを設定します。

●resv02

DCNOFLAGSを設定します。