OpenTP1 Version 7 Programming Reference C Language

[Contents][Index][Back][Next]

Appendix B.1 Message transmission interfaces

This section lists the changes to the message transmission interfaces.

Organization of this subsection
(1) dc_mcf_ap_info - Report the application information
(2) dc_mcf_ap_info_uoc - Report application information to a user exit routine
(3) dc_mcf_close - Close the MCF environment
(4) dc_mcf_commit - Commit an MHP
(5) dc_mcf_contend - Terminate continuous-inquiry response processing
(6) dc_mcf_execap - Activate an application program
(7) dc_mcf_mainloop - Start an MHP service
(8) dc_mcf_open - Open the MCF environment
(9) dc_mcf_receive - Receive a message
(10) dc_mcf_rollback - Enable MHP rollback
(11) dc_mcf_tempget - Accept temporarily-stored data
(12) dc_mcf_tempput - Update temporarily-stored data
(13) dc_mcf_timer_cancel - Cancel user timer monitoring
(14) dc_mcf_timer_set - Set user timer monitoring

(1) dc_mcf_ap_info - Report the application information

(a) ANSI C, C++
Version 6 or earlier Version 7
<For 32-bit architecture>
int  dc_mcf_ap_info(long flags,
                    char *mcfid,
                    char *apname,
                    struct DC_MCFAPINFO *apinfo,
                    char *resv01,
                    long resv02)
 
int  dc_mcf_ap_info(DCLONG flags,
                    char *mcfid,
                    char *apname,
                    struct DC_MCFAPINFO *apinfo,
                    char *resv01,
                    DCLONG resv02)
<For 64-bit architecture>
int  dc_mcf_ap_info(int flags,
                    char *mcfid,
                    char *apname,
                    struct DC_MCFAPINFO *apinfo,
                    char *resv01,
                    int resv02)
(b) K&R C
Version 6 or earlier Version 7
<For 32-bit architecture>
int  dc_mcf_ap_info(flags,
                    mcfid,
                    apname,
                    apinfo,
                    resv01,
                    resv02)
long flags;
char *mcfid;
char *apname;
struct DC_MCFAPINFO  *apinfo;
char *resv01;
long resv02;
 
int  dc_mcf_ap_info(flags,
                    mcfid,
                    apname,
                    apinfo,
                    resv01,
                    resv02)
DCLONG flags;
char *mcfid;
char *apname;
struct DC_MCFAPINFO  *apinfo;
char *resv01;
DCLONG resv02;
<For 64-bit architecture>
int  dc_mcf_ap_info(flags,
                    mcfid,
                    apname,
                    apinfo,
                    resv01,
                    resv02)
int flags;
char *mcfid;
char *apname;
struct DC_MCFAPINFO  *apinfo;
char *resv01;
int resv02;
(c) Arguments whose value is returned from OpenTP1

[Figure] apinfo

Version 6 or earlier Version 7
<For 32-bit architecture>
struct  DC_MCFAPINFO  {
              char mcf_apinfo[4];
              long mcf_resv00;
              char mcf_ap_name[9];
              char mcf_ap_mcfid[3];
              char mcf_resv01[4];
              long mcf_ap_stat;
              long mcf_ap_type;
              char mcf_sg_name[32];
              long mcf_sg_stat;
              long mcf_sg_hold;
              char mcf_sv_name[32];
              long mcf_sv_stat;
              long mcf_ap_ntmetim;
              long mcf_ap_tempsize;
              long mcf_ap_msgcnt;
              long mcf_ap_trnmode;
              long mcf_ap_quekind;
              char mcf_resv02[72];
              }
 
struct  DC_MCFAPINFO  {
              char mcf_apinfo[4];
              DCLONG mcf_resv00;
              char mcf_ap_name[9];
              char mcf_ap_mcfid[3];
              char mcf_resv01[4];
              DCLONG mcf_ap_stat;
              DCLONG mcf_ap_type;
              char mcf_sg_name[32];
              DCLONG mcf_sg_stat;
              DCLONG mcf_sg_hold;
              char mcf_sv_name[32];
              DCLONG mcf_sv_stat;
              DCLONG mcf_ap_ntmetim;
              DCLONG mcf_ap_tempsize;
              DCLONG mcf_ap_msgcnt;
              DCLONG mcf_ap_trnmode;
              DCLONG mcf_ap_quekind;
              char mcf_resv02[72];
              }
<For 64-bit architecture>
struct  DC_MCFAPINFO  {
              char mcf_apinfo[4];
              int mcf_resv00;
              char mcf_ap_name[9];
              char mcf_ap_mcfid[3];
              char mcf_resv01[4];
              int mcf_ap_stat;
              int mcf_ap_type;
              char mcf_sg_name[32];
              int mcf_sg_stat;
              int mcf_sg_hold;
              char mcf_sv_name[32];
              int mcf_sv_stat;
              int mcf_ap_ntmetim;
              int mcf_ap_tempsize;
              int mcf_ap_msgcnt;
              int mcf_ap_trnmode;
              int mcf_ap_quekind;
              char mcf_resv02[72];
              }

(2) dc_mcf_ap_info_uoc - Report application information to a user exit routine

(a) ANSI C, C++
Version 6 or earlier Version 7
<For 32-bit architecture>
int  dc_mcf_ap_info_uoc(long flags,
                        char *apname,
                        struct DC_MCFAPINFO_UOC *apinfo)
 
int  dc_mcf_ap_info_uoc(DCLONG flags,
                        char *apname,
                        struct DC_MCFAPINFO_UOC *apinfo)
<For 64-bit architecture>
int  dc_mcf_ap_info_uoc(int flags,
                     char *apname,
   struct DC_MCFAPINFO_UOC *apinfo)
(b) K&R C
Version 6 or earlier Version 7
<For 32-bit architecture>
int dc_mcf_ap_info_uoc(flags,apname,
                       apinfo)
long flags;
char *apname;
struct DC_MCFAPINFO_UOC *apinfo;
 
int dc_mcf_ap_info_uoc(flags,apname,
                       apinfo)
DCLONG flags;
char *apname;
struct DC_MCFAPINFO_UOC *apinfo;
<For 64-bit architecture>
int dc_mcf_ap_info_uoc(flags,apname,
                       apinfo)
int flags;
char *apname;
struct DC_MCFAPINFO_UOC *apinfo;
(c) Arguments whose value is returned from OpenTP1

[Figure] apinfo

Version 6 or earlier Version 7
<For 32-bit architecture>
struct  DC_MCFAPINFO_UOC  {
            char mcf_apinfo[4];
            long mcf_resv00;
            char mcf_ap_name[9];
            char mcf_ap_mcfid[3];
            char mcf_resv01[4];
            long mcf_ap_stat;
            long mcf_ap_type;
            long mcf_ap_msgcnt;
            char mcf_sg_name[32];
            long mcf_sg_stat;
            long mcf_sg_hold;
            long mcf_sg_msgcnt;
            char mcf_sv_name[32];
            long mcf_sv_stat;
            long mcf_ap_ntmetim;
            long mcf_ap_tempsize;
            long mcf_ap_max_msgcnt;
            long mcf_ap_trnmode;
            long mcf_ap_quekind;
            char mcf_resv02[64];
            };
 
struct  DC_MCFAPINFO_UOC  {
            char mcf_apinfo[4];
            DCLONG mcf_resv00;
            char mcf_ap_name[9];
            char mcf_ap_mcfid[3];
            char mcf_resv01[4];
            DCLONG mcf_ap_stat;
            DCLONG mcf_ap_type;
            DCLONG mcf_ap_msgcnt;
            char mcf_sg_name[32];
            DCLONG mcf_sg_stat;
            DCLONG mcf_sg_hold;
            DCLONG mcf_sg_msgcnt;
            char mcf_sv_name[32];
            DCLONG mcf_sv_stat;
            DCLONG mcf_ap_ntmetim;
            DCLONG mcf_ap_tempsize;
            DCLONG mcf_ap_max_msgcnt;
            DCLONG mcf_ap_trnmode;
            DCLONG mcf_ap_quekind;
            char mcf_resv02[64];
            };
<For 64-bit architecture>
struct  DC_MCFAPINFO_UOC  {
            char mcf_apinfo[4];
            int mcf_resv00;
            char mcf_ap_name[9];
            char mcf_ap_mcfid[3];
            char mcf_resv01[4];
            int mcf_ap_stat;
            int mcf_ap_type;
            int mcf_ap_msgcnt;
            char mcf_sg_name[32];
            int mcf_sg_stat;
            int mcf_sg_hold;
            int mcf_sg_msgcnt;
            char mcf_sv_name[32];
            int mcf_sv_stat;
            int mcf_ap_ntmetim;
            int mcf_ap_tempsize;
            int mcf_ap_max_msgcnt;
            int mcf_ap_trnmode;
            int mcf_ap_quekind;
            char mcf_resv02[64];
            };

(3) dc_mcf_close - Close the MCF environment

(a) ANSI C, C++
Version 6 or earlier Version 7
<For 32-bit architecture>
void  dc_mcf_close(long flags)
 
void  dc_mcf_close(DCLONG flags)
<For 64-bit architecture>
void  dc_mcf_close(int flags)
(b) K&R C
Version 6 or earlier Version 7
<For 32-bit architecture>
void  dc_mcf_close(flags)
long flags;
 
void  dc_mcf_close(flags)
DCLONG flags;
<For 64-bit architecture>
void  dc_mcf_close(flags)
int flags;

(4) dc_mcf_commit - Commit an MHP

(a) ANSI C, C++
Version 6 or earlier Version 7
<For 32-bit architecture>
int  dc_mcf_commit(long action)
 
int  dc_mcf_commit(DCLONG action)
<For 64-bit architecture>
int  dc_mcf_commit(int action)
(b) K&R C
Version 6 or earlier Version 7
<For 32-bit architecture>
int   dc_mcf_commit(action)
long action;
 
int   dc_mcf_commit(action)
DCLONG action;
<For 64-bit architecture>
int   dc_mcf_commit(action)
int action;

(5) dc_mcf_contend - Terminate continuous-inquiry response processing

(a) ANSI C, C++
Version 6 or earlier Version 7
<For 32-bit architecture>
int  dc_mcf_contend(long action,
                    char *resv01)
 
int  dc_mcf_contend(DCLONG action,
                    char *resv01)
<For 64-bit architecture>
int  dc_mcf_contend(int action,
                    char *resv01)
(b) K&R C
Version 6 or earlier Version 7
<For 32-bit architecture>
int  dc_mcf_contend(action,resv01)
long action;
char *resv01;
 
int  dc_mcf_contend(action,resv01)
DCLONG action;
char *resv01;
<For 64-bit architecture>
int  dc_mcf_contend(action,resv01)
int action;
char *resv01;

(6) dc_mcf_execap - Activate an application program

(a) ANSI C, C++
Version 6 or earlier Version 7
<For 32-bit architecture>
int  dc_mcf_execap(long action,
                   long commform,
                   char *resv01,
                   long active,
                   char *apnam,
                   char *comdata,
                   long cdataleng)
 
int  dc_mcf_execap(DCLONG action,
                   DCLONG commform,
                   char *resv01,
                   DCLONG active,
                   char *apnam,
                   char *comdata,
                   DCLONG cdataleng)
<For 64-bit architecture>
int  dc_mcf_execap(int action,
                   int commform,
                   char *resv01,
                   int active,
                   char *apnam,
                   char *comdata,
                   int cdataleng)
(b) K&R C
Version 6 or earlier Version 7
<For 32-bit architecture>
int  dc_mcf_execap(action,commform,
                   resv01,active,apnam,
                   comdata,cdataleng)
long action;
long commform;
char *resv01;
long active;
char *apnam;
char *comdata;
long cdataleng;
 
int  dc_mcf_execap(action,commform,
                   resv01,active,apnam,
                   comdata,cdataleng)
DCLONG action;
DCLONG commform;
char  *resv01;
DCLONG active;
char *apnam;
char *comdata;
DCLONG cdataleng;
<For 64-bit architecture>
int  dc_mcf_execap(action,commform,
                   resv01,active,apnam,
                   comdata,cdataleng)
int action;
int commform;
char *resv01;
int active;
char *apnam;
char *comdata;
int cdataleng;

(7) dc_mcf_mainloop - Start an MHP service

(a) ANSI C, C++
Version 6 or earlier Version 7
<For 32-bit architecture>
int  dc_mcf_mainloop(long flags)
 
int  dc_mcf_mainloop(DCLONG flags)
<For 64-bit architecture>
int  dc_mcf_mainloop(int flags)
(b) K&R C
Version 6 or earlier Version 7
<For 32-bit architecture>
int  dc_mcf_mainloop(flags)
long flags;
 
int  dc_mcf_mainloop(flags)
DCLONG flags;
<For 64-bit architecture>
int  dc_mcf_mainloop(flags)
int flags;

(8) dc_mcf_open - Open the MCF environment

(a) ANSI C, C++
Version 6 or earlier Version 7
<For 32-bit architecture>
int  dc_mcf_open(long flags)
 
int  dc_mcf_open(DCLONG flags)
<For 64-bit architecture>
int  dc_mcf_open(int flags)
(b) K&R C
Version 6 or earlier Version 7
<For 32-bit architecture>
int  dc_mcf_open(flags)
long flags;
 
int  dc_mcf_open(flags)
DCLONG flags;
<For 64-bit architecture>
int  dc_mcf_open(flags)
int flags;

(9) dc_mcf_receive - Receive a message

(a) ANSI C, C++
Version 6 or earlier Version 7
<For 32-bit architecture>
int  dc_mcf_receive(long action,
                    long commform,
                    char *termnam,
                    char *resv01,
                    char *recvdata,
                    long *rdataleng,
                    long inbufleng,
                    long *time)
 
int  dc_mcf_receive(DCLONG action,
                 DCLONG commform,
                 char *termnam,
                 char *resv01,
                 char *recvdata,
                 DCLONG *rdataleng,
                 DCLONG inbufleng,
                 DCLONG *time)
<For 64-bit architecture>
int  dc_mcf_receive(int action,
                    int commform,
                    char *termnam,
                    char *resv01,
                    char *recvdata,
                    int *rdataleng,
                    int inbufleng,
                    int *time)
(b) K&R C
Version 6 or earlier Version 7
<For 32-bit architecture>
int  dc_mcf_receive(action,commform,
                    termnam,resv01,
                    recvdata,rdataleng,
                    inbufleng,time)
long action;
long commform;
char *termnam;
char *resv01;
char *recvdata;
long *rdataleng;
long inbufleng;
long *time;
 
int  dc_mcf_receive(action,commform,
                termnam,resv01,
                recvdata,rdataleng,
                inbufleng,time)
DCLONG action;
DCLONG commform;
char *termnam;
char *resv01;
char *recvdata;
DCLONG *rdataleng;
DCLONG inbufleng;
DCLONG *time;
<For 64-bit architecture>
int  dc_mcf_receive(action,commform,
                    termnam,resv01,
                    recvdata,rdataleng,
                    inbufleng,time)
int action;
int commform;
char *termnam;
char *resv01;
char *recvdata;
int *rdataleng;
int inbufleng;
int *time;

(10) dc_mcf_rollback - Enable MHP rollback

(a) ANSI C, C++
Version 6 or earlier Version 7
<For 32-bit architecture>
int  dc_mcf_rollback(long action)
 
int  dc_mcf_rollback(DCLONG action)
<For 64-bit architecture>
int  dc_mcf_rollback(int action)
(b) K&R C
Version 6 or earlier Version 7
<For 32-bit architecture>
int  dc_mcf_rollback(action)
long action;
 
int  dc_mcf_rollback(action)
DCLONG action;
<For 64-bit architecture>
int  dc_mcf_rollback(action)
int action;

(11) dc_mcf_tempget - Accept temporarily-stored data

(a) ANSI C, C++
Version 6 or earlier Version 7
<For 32-bit architecture>
int  dc_mcf_tempget(long action,
                    char *getdata,
                    long gtempleng,
                    long *gdataleng,
                    char *resv01)
 
int  dc_mcf_tempget(DCLONG action,
                 char *getdata,
                 DCLONG gtempleng,
                 DCLONG *gdataleng,
                 char *resv01)
<For 64-bit architecture>
int  dc_mcf_tempget(int action,
                    char *getdata,
                    int gtempleng,
                    int *gdataleng,
                    char *resv01)
(b) K&R C
Version 6 or earlier Version 7
<For 32-bit architecture>
int  dc_mcf_tempget(action,getdata,
                    gtempleng,gdataleng,
                    resv01)
long action;
char *getdata;
long gtempleng;
long *gdataleng;
char *resv01;
 
int  dc_mcf_tempget(action,getdata,
                    gtempleng,gdataleng,
                    resv01)
DCLONG action;
char *getdata;
DCLONG gtempleng;
DCLONG *gdataleng;
char *resv01;
<For 64-bit architecture>
int  dc_mcf_tempget(action,getdata,
                    gtempleng,gdataleng,
                    resv01)
int action;
char *getdata;
int gtempleng;
int *gdataleng;
char *resv01;

(12) dc_mcf_tempput - Update temporarily-stored data

(a) ANSI C, C++
Version 6 or earlier Version 7
<For 32-bit architecture>
int  dc_mcf_tempput(long action,
                    char *putdata,
                    long pdataleng,
                    char *resv01)
 
int  dc_mcf_tempput(DCLONG action,
                 char *putdata,
                 DCLONG pdataleng,
                 char *resv01)
<For 64-bit architecture>
int  dc_mcf_tempput(int action,
                    char *putdata,
                    int pdataleng,
                    char *resv01)
(b) K&R C
Version 6 or earlier Version 7
<For 32-bit architecture>
int  dc_mcf_tempput(action,putdata,
                    pdataleng,resv01)
long action;
char *putdata;
long pdataleng;
char *resv01;
 
int  dc_mcf_tempput(action,putdata,
                    pdataleng,resv01)
DCLONG action;
char *putdata;
DCLONG pdataleng;
char *resv01;
<For 64-bit architecture>
int  dc_mcf_tempput(action,putdata,
                    pdataleng,resv01)
int action;
char *putdata;
int pdataleng;
char *resv01;

(13) dc_mcf_timer_cancel - Cancel user timer monitoring

(a) ANSI C, C++
Version 6 or earlier Version 7
<For 32-bit architecture>
int dc_mcf_timer_cancel(long flags,
                        long timer_id,
                        char *lename)
 
int dc_mcf_timer_cancel(DCLONG flags,
                    DCLONG timer_id,
                    char *lename)
<For 64-bit architecture>
int dc_mcf_timer_cancel(int flags,
                        int timer_id,
                        char *lename)
(b) K&R C
Version 6 or earlier Version 7
<For 32-bit architecture>
int dc_mcf_timer_cancel(flags,
                        timer_id,
                        lename)
long flags;
long timer_id;
char *lename;
 
int dc_mcf_timer_cancel(flags,
                        timer_id,
                        lename)
DCLONG flags;
DCLONG timer_id;
char *lename;
<For 64-bit architecture>
int dc_mcf_timer_cancel(flags,
                        timer_id,
                        lename)
int flags;
int timer_id;
char *lename;

(14) dc_mcf_timer_set - Set user timer monitoring

(a) ANSI C, C++
Version 6 or earlier Version 7
<For 32-bit architecture>
int dc_mcf_timer_set(long flags,
                     long timer,
                     long timer_id,
                     char *lename,
                     char *apname,
                     char *data,
                     long data_leng,
                     long resv01,
                     long resv02)
 
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)
<For 64-bit architecture>
int dc_mcf_timer_set(int flags,
                     int timer,
                     int timer_id,
                     char *lename,
                     char *apname,
                     char *data,
                     int data_leng,
                     int resv01,
                     int resv02)
(b) K&R C
Version 6 or earlier Version 7
<For 32-bit architecture>
int dc_mcf_timer_set(flags,timer,
                  timer_id,lename,
                  apname,data,data_leng,
                  resv01,resv02)
long flags;
long timer;
long timer_id;
char *lename;
char *apname;
char *data;
long data_leng;
long resv01;
long resv02;
 
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;
<For 64-bit architecture>
int dc_mcf_timer_set(flags,timer,
                  timer_id,lename,
                  apname,data,data_leng,
                  resv01,resv02)
int flags;
int timer;
int timer_id;
char *lename;
char *apname;
char *data;
int data_leng;
int resv01;
int resv02;

[Contents][Back][Next]

[Trademarks]

All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.