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 earlierVersion 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 earlierVersion 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 earlierVersion 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 earlierVersion 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 earlierVersion 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 earlierVersion 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 earlierVersion 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 earlierVersion 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 earlierVersion 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 earlierVersion 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 earlierVersion 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 earlierVersion 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 earlierVersion 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 earlierVersion 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 earlierVersion 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 earlierVersion 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 earlierVersion 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 earlierVersion 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 earlierVersion 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 earlierVersion 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 earlierVersion 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 earlierVersion 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 earlierVersion 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 earlierVersion 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 earlierVersion 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 earlierVersion 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 earlierVersion 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 earlierVersion 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 earlierVersion 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 earlierVersion 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;