OpenTP1 Version 7 Programming Reference C Language

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

Structure format of mcf event that reports discarding of a timer-start message (ERREVT4)

The format of the structure passed as the first segment of the event that reports discarding of a timer-start message (ERREVT4) is shown below. This structure is defined in the header file <dcmcf.h>. Include the file <dcmcf.h> with the #include statement for the MHP which handles the MCF event information. For the format of MCF event information other than ERREVT4, see the explanation in the applicable OpenTP1 Protocol manual.

MCF event information common header

struct  dc_mcf_evtheader {
     char  mcfevt_name[9]; ... MCF event code
     char  le_name[16];    ... Input source logical terminal name
     char  cn_name[9];     ... Connection name
     unsigned  char  format_kind; ... Area used by the MCF
     char  reserve01;      ... Reserved
     DCLONG  time;         ... Message input time
} ;

ERREVT4 format

struct  dc_mcf_evt4_type {
     struct  dc_mcf_evtheader evtheader; ... MCF event common
                                             header
     char  reserve01[12]; ... Reserved
     char  reserve02[10]; ... Reserved
     char  reserve03[2]; ... Reserved
     char  ap_name[10]; ... Application name (corresponding to
                             timer-start message)
     short  reason_code; ... Reason code
} ;

Arguments

le_name

The name of the logical terminal where the message was input is set here. In the following cases, '*' is set here:

cn_name

The connection name is set here. In the following cases, '*' is set here:

time

The message input time is set here as the number of seconds counted from 00:00:00 on January 1, 1970.

ap_name

The name of the application which is specified in the timer-started function dc_mcf_execap() and encountered an error is set here.

reason_code

The ERREVT4 reason code is set here. The reason codes are detailed below.

Reason code in C language (hexadecimal) Reason
DCMCF_SCD_ERR (0020) The MHP or SPP could not be activated because of an RPC error or inactive server.
DCMCF_QUE_BUF_ERR (0030) Since memory became insufficient, data could not be written to the input queue.
DCMCF_QUE_FIL_OVER (0031) Since the queue file is full, data could not be written to the input queue.
DCMCF_QUE_LIMIT_OVER (0032) Since the maximum number of storable input messages exceeded the defined value, data could not be written to the input queue.
DCMCF_QUE_IO_ERR (0033) An error occurred in writing to the input queue.
DCMCF_AP_CLOSE (0040) An MHP application is being shut down.
DCMCF_AP_SECURE (0041) An MHP application is in the secure status.
DCMCF_SERV_CLOSE (0042) An MHP service or service group is being shut down.
DCMCF_SERV_SECURE (0043) An MHP service group is in the secure status.