OpenTP1 Version 7 Programming Reference C Language
Formats of receive communication events
This section explains the formats of the communication events indicating association statuses. Before receiving a communication event, specify the service group name and service name of an SPP for a communication event in the XATMI communication service definition. At this time, a receivable communication event depends on in which operands the service group name and the service name are specified.
If the same service group name and service name are specified in more than one operand, one SPP for a communication event can receive more than one communication event.
A communication event is reported as a structure. The structure of a communication event is defined in the header file <dcxat.h>. For a communication event processing SPP, include <dcxat.h> using #include.
struct dc_xat_event_type { int event_code; ... Communication event identification code char aso_name[9]; ... Association name char reserve1[3]; ... Reserved area 1 int aso_initiative; ... Type of association initiating and recipient DCULONG reason_code; ... Reason code char xatc_svcname[9]; ... XATMI communication service name char reserve2[63]; ... Reserved area 2 }; |
Contents of arguments
event_code
event_code contains the code identifying a communication event. The number in parentheses indicates the decimal number for an applicable code.
aso_name
aso_name contains the name of the association whose status is reported by a communication event.
reserve1
Reserved area.
aso_initiative
aso_initiative contains the value indicating whether the local system is initiating or recipient through the established association. The number in parentheses indicates the decimal number for an applicable code.
reason_code
reason_code contains a reason code if an association is released. The number in parentheses indicates the decimal number for an applicable code.
For the normal releasing of an association, reason_code contains one of the following values:
For the abnormal releasing of an association, reason_code contains one of the following values:
xatc_svcname
xatc_svcname contains an XATMI communication service name.
reserve2
Reserved area.
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.