OpenTP1 Version 7 Programming Reference C Language
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. |
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.