News CNCnetPDM About us Support  
         
  

CNC_RDOPMSG3 | MISC

Description

Reads the contents of the operator's message in CNC. The operator's message is stored in "data" of "opmsg".

MTConnect Fanuc Adapter

Universal Fanuc Driver

Fanuc Focas Library CD

Declaration

#include "fwlib32.h" or "fwlib64.h"

FWLIBAPI short WINAPI cnc_rdopmsg3(unsigned short FlibHndl,short type, short *number, OPMSG3 *opmsg);

Arguments

FlibHndl   [ in ]

Specify the library handle. See "Library handle" for details.

type   [ in ]
Specify the kind of operator's message.
 0:1st message
 1:2nd message
 2:3rd message
 3:4th message
 4:macro message
5~16: 5th - 16th message(30i, 0i-D/F, PMi-A olny)
-1:all message
In case of one operator's messages with the Series 16/18/21, 16i/18i/21i, 0i-A/B/C, if the values other than -1,0,4 are set, the error occurs.
In case of four operator's messages with the Series 30i, 0i-D/F and PMi-A, if the values 5-16 are set, the error occurs.
And, if four is specified for NC in which the macro message reading function is not provided, the error occurs.
number   [ in/out ]
Specify the pointer to the number of message to be read.
This function returns the number of message, which was read actually.
Please specify "1" for type=0-4(type=0-16 30i, 0i-D/F, PMi-A).
And when the type is "-1", specify "5" in case of 4 operator's messages and specify "17" in case of 16 operator's messages (30i, 0i-D/F, PMi-A only).
opmsg   [ out ]

Pointer to the OPMSG3 structure including the operator's message. The OPMSG3 structure is as follows.

typedef struct opmsg3 {
     short  datano ;         /* Number of operator's message */
     short  type ;           /* Kind of operator's message */
     short  char_num ;       /* Message length */
     char   data[MSG_SIZE] ; /* Operator's message strings */
} OPMSG3;                    /* MSG_SIZE : Message length */
datano
The number of operator's message is stored.
Judge the existence of the operator's message by message number of datano. (When the datano is -1, the operator's message does not exist).
    • message exists
    • Series 15/15i
    • 0~999
    • Series 16/18/21, 16i/18i/21i, 0i-A/B/C, Power Mate i
    • number exist : 2000 to 2099
      number does not exist : 2100 to 2999
    • Series 30i, 0i-D/F, PMi-A
    • * In case of Parameter No.6301#1=0
      number exist : 2000 to 2099
      number does not exist : 2100 to 2999
      * In case of Parameter No.6301#1=1
      number exist : 0 - 99
      number does not exist : 100 - 4095
    • message does not exist
    • -1
type
Kind of operator's message is stored.
    0 to 3:1st to 4th message
    4:macro message
    5 to 16:5th to 16th message(30i, 0i-D/F, PMi-A only)
char_num
The operator's message length is stored. The '\0' at the end of strings is included in the length.
data
The operator's message strings are stored. The '\0' is set at the end of strings.
The message is acquired in the following character-codes.
    English : ASCII
    Japanese : Shift-JIS
    Simplified Chinese : Shift-JIS
    Traditional Chinese : GB2312
    Korean : Code Page 949
    Cyrillic : Code Page 1251
    Turkish : Code Page 1254
    Others European : Western Europe
Note1) In CNC except Series 30i, 0i-D/F and PMi-A, messages except English and Japanese cannot be correctly acquired.
Note2) Korean cannot be correctly acquired with FOCAS2/Ethernet.(Except 30i-B, 0i-D/F and PMi-A)

Return

EW_OK is returned on successful completion, otherwise any value except EW_OK is returned.

The major error codes are as follows.

Return code Meaning/Error handling
EW_LENGTH
(2)
message number(number) error
EW_ATTRIB
(4)
data attribute error
The specification of the kind of operator's message(type) is wrong.
EW_NOOPT
(6)
no option
Set necessary CNC option.

As for the other return codes or the details, see "Return status of Data window function"

CNC option

This function need the following CNC option.

  • Series 15/15i
  • The External data I/O function
  • Series 16i/18i/21i, 0i-A/B/C
  • External message
    External data input
    Custom macro B
  • Series 30i, 0i-D/F, PMi-A
  • External message
    External data input
    Custom macro

For HSSB connection,

    The extended driver/library function is necessary.

For Ethernet connection,

    Ethernet function and the extended driver/library function are necessary.

    However, in case of Series 16i/18i/21i-B, 0i-B/C/D/F, Series 30i and PMi-A, the required CNC option is as follows.

    When Embedded Ethernet is used,

    The two optional functions are not required.

    When Ethernet board is used,

    Only an Ethernet function is required.

CNC parameter

This function is related to the following CNC parameter.
See the manual of CNC parameter for details.

  • Series 16/18/21, 16i/18i/21i, 0i-A/B/C
  • 3207#0(set in case of four operator's messages)
  • Series 30i, 0i-D/F, PMi-A
  • 11931#1 =0(4 operator's messages) --- influenced by setting
    =1(16 operator's messages)
    6301#1 =0(A message number from 0 to 999 can be sent.) --- influenced by setting
    =1(A message number from 0 to 4095 can be sent.)
    6310 (Setting for number addition to external operator messages) --- influenced by setting

    CNC mode

    This function can be used in any CNC mode.

    Available CNC

    0i-A 0i-B/C(Note) 0i-D 0i-F 15 15i 16 18 21 16i-A 18i-A 21i-A 16i-B 18i-B 21i-B 30i-A 30i-B
    M (Machining)H O O O H O X X X O O O O O O O O
    T (Turning) H O O O H - X X X O O O O O O O O
    LC (Loader) - - - - - - X X X H H H H H H - -

    0i-D0i-F16i18i30i-A30i-B
    P (Punch press)O O O O - O
    L (Laser) - - O - - O
    W (Wire) - - X X O O


    Power Mate i-DO
    Power Mate i-HO
    Power Motion i-AO

    "O" : Both Ethernet and HSSB
    "E" : Ethernet
    "H" : HSSB
    "X" : Cannot be used
    "-" : None

    Note) 0i-C does not support the HSSB function.

    Privacy notice

    This website uses cookies. By continuing to use it you agree to our privacy policy. 

    https://www.inventcom.net/fanuc-focas-library/misc/cnc_rdopmsg3

    Fanuc Focas Library | Misc | cnc_adcnv

    Reads the A/D conversion data. The A/D conversion data is stored in data of ODBAD.... [read more]
    cnc_adcnv

    Fanuc Focas Library | Misc | cnc_alarm

    Reads the alarm status of CNC. Various information is stored in data of ODBALM. This function is used for watching CNC's alarm... [read more]
    cnc_alarm

    Fanuc Focas Library | Misc | cnc_alarm2

    Reads the alarm status of CNC. This function is the improved version of the... [read more]
    cnc_alarm2

    Fanuc Focas Library | Misc | cnc_cexesramsize

    Reads the maximum size of the SRAM variable area for C language executor. The maximum size is read by the unit of byte.... [read more]
    cnc_cexesramsize

    Fanuc Focas Library | Misc | cnc_chgprotbit

    Sets the state of various NC data protection (protection pattern data). The protection pattern data is bit pattern data which collects flags corresponding to... [read more]
    cnc_chgprotbit

    Fanuc Focas Library | Misc | cnc_clralm

    Clears the CNC alarm state specified by id.... [read more]
    cnc_clralm

    Fanuc Focas Library | Misc | cnc_diagnosr

    Reads the diagnosis data specified by s_number,e_number,axis(only for the diagnosis data with axis). The data format depends on each diagnosis data. The... [read more]
    cnc_diagnosr

    Fanuc Focas Library | Misc | cnc_diagnoss

    Reads the diagnosis specified by number,axis (only for the diagnosis with axis). The data format depends on each diagnosis. The format of Byte/Word/2-Word... [read more]
    cnc_diagnoss

    Fanuc Focas Library | Misc | cnc_fromget

    Reads the F-ROM data from CNC. After F-ROM data reading, execute... [read more]
    cnc_fromget

    Fanuc Focas Library | Misc | cnc_fromgetend

    Indicates the termination of reading the F-ROM data from CNC.... [read more]
    cnc_fromgetend

    Fanuc Focas Library | Misc | cnc_fromgetstart

    Indicates the start of reading the F-ROM data from CNC. However, the system control software cannot be... [read more]
    cnc_fromgetstart

    Fanuc Focas Library | Misc | cnc_fromput

    Writes the F-ROM data to CNC. After F-ROM data writing, execute... [read more]
    cnc_fromput

    Fanuc Focas Library | Misc | cnc_fromputend

    Indicates the termination of writing the F-ROM data to CNC. This function waits until the termination of writing process of the F-ROM data on CNC.... [read more]
    cnc_fromputend

    Fanuc Focas Library | Misc | cnc_fromputstart

    Indicates the start of writing the F-ROM data to CNC. The data which can be written in F-ROM is system data (CNC Control software... [read more]
    cnc_fromputstart

    Fanuc Focas Library | Misc | cnc_fromremove

    Deletes the System data from F-ROM on CNC. However, the system control software cannot be deleted in the Ethernet version.... [read more]
    cnc_fromremove

    Fanuc Focas Library | Misc | cnc_getdtailerr

    Gets the detailed error information after the function has been executed. The detailed error information is stored in err_no, err_dtno of... [read more]
    cnc_getdtailerr

    Fanuc Focas Library | Misc | cnc_getfigure

    Reads the maximum valid figures and the number of decimal places under the input/output unit, which is related to various data of CNC. The... [read more]
    cnc_getfigure

    Fanuc Focas Library | Misc | cnc_getfrominfo

    Reads the various information of F-ROM on CNC. The various information is stored in each member of ODBFINFORM.... [read more]
    cnc_getfrominfo

    Fanuc Focas Library | Misc | cnc_getlanguage

    The display language of NC is acquired.... [read more]
    cnc_getlanguage

    Fanuc Focas Library | Misc | cnc_getlockstat

    Gets the present state of various NC data protection.... [read more]
    cnc_getlockstat

    Fanuc Focas Library | Misc | cnc_getpath

    Reads the current selected path number which is the target path of the Data window functions.... [read more]
    cnc_getpath

    Fanuc Focas Library | Misc | cnc_getsraminfo

    Reads the various information of S-RAM on CNC. The various information is stored in each member of ODBSINFO.... [read more]
    cnc_getsraminfo

    Fanuc Focas Library | Misc | cnc_gettimer

    Gets the date or time data from the calendar timer device of the CNC unit.... [read more]
    cnc_gettimer

    Fanuc Focas Library | Misc | cnc_modal

    Reads the modal information of CNC. Various information is stored in each member of ODBMDL. The readable modal data are modal G code or commanded data... [read more]
    cnc_modal

    Fanuc Focas Library | Misc | cnc_rd3dcdcnv

    Reads the mode and data of the 3-dimensional coordinate conversion. These are stored in each member of ODB3DCD structure. The... [read more]
    cnc_rd3dcdcnv

    Fanuc Focas Library | Misc | cnc_rd3dtofs

    Reads the mode and vector of the 3-dimensional tool compensation. These are stored in each member of ODB3DTO structure. The places of decimal... [read more]
    cnc_rd3dtofs

    Fanuc Focas Library | Misc | cnc_rdalminfo

    Reads the detailed information of currently arising CNC alarms. Various information is stored in data of ALMINFO. This function is... [read more]
    cnc_rdalminfo

    Fanuc Focas Library | Misc | cnc_rdalmmsg

    Reads the currently arising CNC alarm messages. All alarm messages can be read at once. Differing from... [read more]
    cnc_rdalmmsg

    Fanuc Focas Library | Misc | cnc_rdalmmsg2

    Reads the currently arising CNC alarm messages. All alarm messages can be read at once. Differing from... [read more]
    cnc_rdalmmsg2

    Fanuc Focas Library | Misc | cnc_rdbrstrinfo

    Reads the data of block restart. These are stored in each member of ODBBRS structure. The destination and the distance to go of block restart are valid... [read more]
    cnc_rdbrstrinfo

    Fanuc Focas Library | Misc | cnc_rdcdrotate

    Reads the mode and data of the coordinate rotation. These are stored in each member of ODBROT structure. The places of decimal points can be got by... [read more]
    cnc_rdcdrotate

    Fanuc Focas Library | Misc | cnc_rdcexesram

    Reads the SRAM variable area for C language executor specified by offset, length. When this function accesses this area, exclusive control with the C... [read more]
    cnc_rdcexesram

    Fanuc Focas Library | Misc | cnc_rdcncid

    Reads the CNC ID number. The CNC ID numbers are stored in cncid with unsigned binary format.... [read more]
    cnc_rdcncid

    Fanuc Focas Library | Misc | cnc_rdcommand

    Reads the commanded data of CNC. Various information is stored in each member of ODBCMD. The readable data are the modal data except G code, and the... [read more]
    cnc_rdcommand

    Fanuc Focas Library | Misc | cnc_rdcoordnum

    Reads the number of the additional workpiece coordinate systems of the workpiece coordinate systems.... [read more]
    cnc_rdcoordnum

    Fanuc Focas Library | Misc | cnc_rddiaginfo

    Reads the CNC diagnosis data information specified by s_number and read_no. The CNC diagnosis data is basically non-continuous, and the attribute like... [read more]
    cnc_rddiaginfo

    Fanuc Focas Library | Misc | cnc_rddiagnum

    Reads minimum, maximum, total number of the CNC diagnosis data. The distribution of the diagnosis data is different in each CNC model, and the new diagnosis... [read more]
    cnc_rddiagnum

    Fanuc Focas Library | Misc | cnc_rddiag_ext

    Reads the random number diagnosis data. The diagnosis data numbers are specified by the array of long type (prm_no[]). And the number of the array is specified... [read more]
    cnc_rddiag_ext

    Fanuc Focas Library | Misc | cnc_rdetherinfo

    Reads the Ethernet board inforamtion in CNC.... [read more]
    cnc_rdetherinfo

    Fanuc Focas Library | Misc | cnc_rdfixcycle

    Reads the mode and data of the canned cycle. These are stored in each member of ODBFIX structure. The places of decimal points can be got by... [read more]
    cnc_rdfixcycle

    Fanuc Focas Library | Misc | cnc_rdgcode

    Reads the information of CNC about the commanded G code. Various information is stored in each member of ODBGCD. The readable data are modal G code and one... [read more]
    cnc_rdgcode

    Fanuc Focas Library | Misc | cnc_rdlenofs

    Reads the mode and vector of the tool length compensation. These are stored in each member of ODBLOFS structure. The places of decimal... [read more]
    cnc_rdlenofs

    Fanuc Focas Library | Misc | cnc_rdmdlconfig

    Reads the module configuration of CNC system. These information are stored in each member of ODBMDLC. Reading the data which depends on the path... [read more]
    cnc_rdmdlconfig

    Fanuc Focas Library | Misc | cnc_rdmdlconfig2

    Reads the module configuration of CNC system.... [read more]
    cnc_rdmdlconfig2

    Fanuc Focas Library | Misc | cnc_rdmenuswitch

    Reads the menu switch signals.... [read more]
    cnc_rdmenuswitch

    Fanuc Focas Library | Misc | cnc_rdmirimage

    Reads the mode of the programmable mirror image and the absolute position of center of mirror image. These are stored in each member of ODBMIR... [read more]
    cnc_rdmirimage

    Fanuc Focas Library | Misc | cnc_rdopmsg

    Reads the contents of the operator's message in CNC. The operator's message is stored in data of OPMSG.... [read more]
    cnc_rdopmsg

    Fanuc Focas Library | Misc | cnc_rdopmsg2

    Reads the contents of the operator's message in CNC. The operator's message is stored in data of OPMSG2. This function can be used in... [read more]
    cnc_rdopmsg2

    Fanuc Focas Library | Misc | cnc_rdopnlgnrl

    Reads the general output signal image of software operator's panel.... [read more]
    cnc_rdopnlgnrl

    Fanuc Focas Library | Misc | cnc_rdopnlgsname

    Reads the general signal name of software operator's panel.... [read more]
    cnc_rdopnlgsname

    Fanuc Focas Library | Misc | cnc_rdopnlsgnl

    Reads the output signal image of software operator's panel.... [read more]
    cnc_rdopnlsgnl

    Fanuc Focas Library | Misc | cnc_rdpm_cncitem

    Reads the item name relating the cnc specified by the item index.... [read more]
    cnc_rdpm_cncitem

    Fanuc Focas Library | Misc | cnc_rdpm_item

    Reads all data specified by the item index. The acquired data is as follows. - Name - Life count... [read more]
    cnc_rdpm_item

    Fanuc Focas Library | Misc | cnc_rdpm_mcnitem

    Reads the item name relating the machine specified by the item index.... [read more]
    cnc_rdpm_mcnitem

    Fanuc Focas Library | Misc | cnc_rdposofs

    Reads the mode and vector of the tool position compensation. These are stored in each member of ODBPOFS structure. The... [read more]
    cnc_rdposofs

    Fanuc Focas Library | Misc | cnc_rdprstrinfo

    Reads the program restart information. The program restart information is stored in each member of ODBPRS.... [read more]
    cnc_rdprstrinfo

    Fanuc Focas Library | Misc | cnc_rdradofs

    Reads the mode and vector of the cutter compensation(tool nose radius compensation). These are stored in each member of... [read more]
    cnc_rdradofs

    Fanuc Focas Library | Misc | cnc_rdrepeatval

    Get the counter of the subprogram call and the repeat for fixed cycle. In case of subprogram call, the remainder counter is acquired.... [read more]
    cnc_rdrepeatval

    Fanuc Focas Library | Misc | cnc_rdrepeatval_ext

    Get the counter of the subprogram call and the repeat for fixed cycle. The total repetition number and the remainder counter are... [read more]
    cnc_rdrepeatval_ext

    Fanuc Focas Library | Misc | cnc_rdscaling

    Reads the mode and data of the scaling. These are stored in each member of ODBSCL structure. The places of... [read more]
    cnc_rdscaling

    Fanuc Focas Library | Misc | cnc_rdsyshard

    Reads the hardware configuration of CNC. These information are stored in each member of ODBSYSH. The 25... [read more]
    cnc_rdsyshard

    Fanuc Focas Library | Misc | cnc_rdsyssoft

    Reads the series/version of CNC system software. These information are stored in each member of ODBSYSS. Reading the data which depends on the path needs... [read more]
    cnc_rdsyssoft

    Fanuc Focas Library | Misc | cnc_rdsyssoft2

    Reads the series/version of CNC system software. These information are stored in each member of ODBSYSS2. This function can read data which... [read more]
    cnc_rdsyssoft2

    Fanuc Focas Library | Misc | cnc_rdsyssoft3

    Reads the series/version of CNC system software. These information are stored in each member of ODBSYSS3. This function can read the series/version... [read more]
    cnc_rdsyssoft3

    Fanuc Focas Library | Misc | cnc_rdtimer

    Gets cutting time, cycle time, and other timer data of CNC.... [read more]
    cnc_rdtimer

    Fanuc Focas Library | Misc | cnc_reset

    Executes the external reset of CNC.... [read more]
    cnc_reset

    Fanuc Focas Library | Misc | cnc_reset2

    CNC is reset. When this function is executed, reset is executed to all paths or the path selected bt CNC... [read more]
    cnc_reset2

    Fanuc Focas Library | Misc | cnc_rstrseqsrch

    Searches the sequence number for program restart.... [read more]
    cnc_rstrseqsrch

    Fanuc Focas Library | Misc | cnc_rstrseqsrch2

    Searches the sequence number for program restart.... [read more]
    cnc_rstrseqsrch2

    Fanuc Focas Library | Misc | cnc_setpath

    Selects the path number which is the target path in the multi-path system or system with loader control. All Data window library functions input... [read more]
    cnc_setpath

    Fanuc Focas Library | Misc | cnc_settimer

    Sets the date or time data to the calendar timer device of the CNC unit.... [read more]
    cnc_settimer

    Fanuc Focas Library | Misc | cnc_sramget

    Reads the S-RAM data from CNC. The SRAM data which was read by this function should be restored by using the Boot function.(The SRAM... [read more]
    cnc_sramget

    Fanuc Focas Library | Misc | cnc_sramgetend

    Indicates the termination of reading the S-RAM data from CNC.... [read more]
    cnc_sramgetend

    Fanuc Focas Library | Misc | cnc_sramgetstart

    Indicates the start of reading the S-RAM data from CNC.... [read more]
    cnc_sramgetstart

    Fanuc Focas Library | Misc | cnc_statinfo

    Reads the status information of CNC. The various information is stored in each member of ODBST.... [read more]
    cnc_statinfo

    Fanuc Focas Library | Misc | cnc_statinfo2

    Reads the status information of CNC. The various information is stored in each member of ODBST2.... [read more]
    cnc_statinfo2

    Fanuc Focas Library | Misc | cnc_sysconfig

    Reads the CNC system configuration information. Various information is stored in each member of ODBSYSC. This function cannot be... [read more]
    cnc_sysconfig

    Fanuc Focas Library | Misc | cnc_sysinfo

    Reads system information such as kind of CNC system, Machining(M) or Turning(T), series and version of CNC system software and number of the controlled axes.... [read more]
    cnc_sysinfo

    Fanuc Focas Library | Misc | cnc_sysinfo_ex

    Reads system information such as distinction of Machining(M) or Turning(T), number of path and number of the controlled axes.... [read more]
    cnc_sysinfo_ex

    Fanuc Focas Library | Misc | cnc_wrcexesram

    Writes the SRAM variable area for C language executor specified by offset, length. When this function accesses this area, exclusive control with the... [read more]
    cnc_wrcexesram

    Fanuc Focas Library | Misc | cnc_wrmenuswitch

    Writes the menu switch signals.... [read more]
    cnc_wrmenuswitch

    Fanuc Focas Library | Misc | cnc_wropnlgnrl

    Writes the general output signal of software operator's panel.... [read more]
    cnc_wropnlgnrl

    Fanuc Focas Library | Misc | cnc_wropnlgsname

    Writes the general signal name of software operator's panel.... [read more]
    cnc_wropnlgsname

    Fanuc Focas Library | Misc | cnc_wropnlsgnl

    Writes the output signal of software operator's panel.... [read more]
    cnc_wropnlsgnl

    Fanuc Focas Library | Misc | cnc_wrpm_item

    Writes all data specified by the item index. The acquired data is as follows. - Name - Life count... [read more]
    cnc_wrpm_item

    Fanuc Focas Library | Misc | cnc_wrpm_mcnitem

    Writes the item name relating the machine specified by the item index.... [read more]
    cnc_wrpm_mcnitem

    Fanuc Focas Library | Misc | cnc_wrtimer

    Sets cutting time, cycle time, and other timer data of CNC.... [read more]
    cnc_wrtimer

    Fanuc Focas Library | Misc | flist_Misc

    CNC: Function related to others... [read more]
    flist_Misc
    Modified: 2018-06-11