CNC_RDUNSOLICMSG2 | UNSOLIC

Handle for the Message data reading. Specify the value acquired by the cnc_unsolicstart or the value notified by the argument(lParam) of the message reception function.

Pointer to IDBUNSOLICMSG2 structure in which the unsolicited messaging data will be stored.

The IDBUNSOLICMSG2 structure is as follows.

typedef struct idbunsolicmsg2 {
    unsigned short      getnum;
    char                dummy[2];
    UNSOLICMSG_TYPE_MSG get[3];
} IDBUNSOLICMSG2 ;

typedef struct unsolicmsg_type_msg {
    unsigned short      type;
    char                dummy1[2];
    union {
        typedef {
            unsigned short  path;
            char            dummy2[2];
            unsigned long   size;
            void            *data;
        } pmc;
        typedef {
            unsigned short  path;
            char            dummy3[2];
            unsigned long   num;
            void            *data;
        } macro;
    } msg;
} UNSOLICMSG_TYPE_MSG ;

getnum

Acquired message number

Number of the Message data which was acquired by the unsolicited messaging.

Range) 1 - 3

get[n].msg.type

Kind of the unsolicited messaging data.

1	:	PMC data
3	:	Custom macro variables
4	:	Temporary RTM variables
5	:	Permanent RTM variables(0i-F,30i/31i/32i only)

get[n].msg.pmc.path

Unit type number of PMC

When the value of "Kind of the unsolicited messaging data" is "1", this value is effective.

Range) 1 - 3 (The range depends on an effective PMC unit type number.)

get[n].msg.pmc.size

The size of PMC data (bytes)

When the value of "Kind of the unsolicited messaging data" is "1", this value is effective.

Range) (The range depends on an effective PMC area and transmission number.)

get[n].msg.pmc.data

Pointer to the buffer where PMC data is stored.

The size specified by "PMC size of the parameter for the transmission (byte)" of cnc_wrunsolicprm2 function is necessary for the size of this data.

When the value of "Kind of the unsolicited messaging data" is "1", this value is effective.

get[n].msg.macro.path

Path number of CNC

When the value of "Kind of the unsolicited messaging data" is "3", "4" and "5", this value is effective.

Range) 1 - 3 (The range depends on an effective PMC unit type number.)

get[n].msg.macro.num

Number of Macro variable data

When the value of "Kind of the unsolicited messaging data" is "3", "4" and "5", this value is effective.

Range) (The range depends on an effective Macro variable data and transmission number.)

get[n].msg.macro.data

Pointer to the buffer where Macro variable data is stored.

The size specified by "Number of macro variables of the parameter for the transmission" of cnc_wrunsolicprm2 function is necessary for the size of this data.

When the value of "Kind of the unsolicited messaging data" is "3", "4" and "5", this value is effective.

Setting example)

IP address	:	192.168.0.1
Port number	:	8196
Control method	:	Simple method
Conterl parameter	:	PMC address"1:R2000"
Retry number	:	3
Timeout	:	10 sec
Transmission number	:	3
Parameter for transmission[0]	:	PMC area"1:R2100-1:R2149"
Parameter for transmission[1]	:	Custom macro variables"1:3011"
Parameter for transmission[2]	:	Temporary RTM variables"1:0-1:4"
IDBUNSOLICMSG2 data2; char msg1[50]; // stored buffer for msg1 double msg2[2]; // stored buffer for msg2 double msg3[5]; // stored buffer for msg3

data2.get[0].msg.pmc.data = msg1;	//	Contents of 1:R2100-1:2149
data2.get[1].msg.macro.data = msg2;	//	Contents of 1:3011
data2.get[2].msg.macro.data = msg3;	//	Contents of 1:0-1:4