News CNCnetPDM About us Support  
         
  

CNC_RDOMHISTRY2 | HISTORY

Description

Reads the external operator's message history data. Please use this function for Series 30i, 0i-D/F and PMi-A.

The unit of one external operator's message history data is called a record.

The operation history data and the alarm history data are automatically recorded on the CNC. When these data are accessed, it is necessary to temporarily stop sampling on the CNC. Therefore, it is necessary to execute "Stop logging operation history data"(cnc_stopophis) before this function is used.
And it is necessary to execute "Restart logging operation history data" (cnc_startophis) after reading to make the sampling stop time of the history data as short as possible.

The start/end record number means the relative number uesd at reading the alarm history data. These record numbers are valid only at the period from the execution of "Stop logging operation history data" until the execution of "Restart logging operation history data".

The message history data is acquired in old order.

MTConnect Fanuc Adapter

Universal Fanuc Driver

Fanuc Focas Library CD

Declaration

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

FWLIBAPI short WINAPI cnc_rdomhistry2(unsigned short FlibHndl, unsigned short s_no,unsigned short e_no, unsigned short length,ODBOMHIS2 *his);

Arguments

FlibHndl   [ in ]

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

s_no   [ in ]

Specify the start record number. (specify 1 or more.)

e_no   [ in ]

Specify the end record number. (specify 1 or more.)

length   [ in ]

Specify the data block length. (size of ODBOMHIS2 structure)


his   [ out ]

Pointer to the ODBOMHIS2 structure in which the alarm history data is stored. The ODBOMHIS2 structure is as follows.

typedef struct odbmhis2 {
    unsigned short  s_no;       /* Start record number       */
    unsigned short  e_no;       /* Most recently entered     */
                                /* record number             */
    struct {
        short   dsp_flg;        /* Flag for displaying       */
        short   om_no;          /* operator's message number */
        short   year;           /* year                      */
        short   month;          /* month                     */
        short   day;            /* day                       */
        short   hour;           /* hour                      */
        short   minute;         /* minute                    */
        short   second;         /* second                    */
        char    ope_msg[256];   /* operator's message        */
    } opm_his[N];               /* N : number of external operator's 
                                       message history data to be read */
} ODBOMHIS2;
dsp_flg
Flag for displaying
1:display "EXxxxx"
0:display as it is
om_no
operator's message number
year
year (1995,...,2094)
month
month (1,...,12)
day
day (1,...,31)
hour
hour (0,...,23)
minute
minute (0,...,59)
second
second (0,...,59)
ope_msg
operator's message
The last character is 'NULL(\0)'.

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_FUNC
(1)
cnc_stopophis function has not been executed.
EW_LENGTH
(2)
Data block length error
Size of ODBOMHIS2 structure(length) is wrong.
(e_no-s_no+1) * sizeof(data[0]) + 4 > length
EW_NUMBER
(3)
Data number error
The specification of the record number (s_no, e_no) is wrong.
EW_NOOPT
(6)
No option
The external message option or the external data input option, and the extended driver/ library function are necessary.
EW_PARAM
(9)
CNC parameter error
CNC parameter '3112#2' must be 1.

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.

    The external message option or the external data input option.

For HSSB connection,

    The extended driver/library function is necessary.

CNC parameter

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

    3112#2=1, 3196#6=0 (must be set)
    6301#1 (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)X X O O X X X X X X X X X X X O O
T (Turning) X X O O X - X X X X X X X X X O O
LC (Loader) - - - - - - X X X X X X X X X - -

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


Power Mate i-DX
Power Mate i-HX
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.

See Also

cnc_stopophis   cnc_startophis   cnc_rdomhisno   cnc_clearophis  

Privacy notice

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

https://www.inventcom.net/fanuc-focas-library/history/cnc_rdomhistry2
Fanuc Focas Library | History | cnc_clearomhis
Description Clears the external operator's message history data. The specification for Series 30i, 0i-D/F and... [read more]
cnc_clearomhis
Fanuc Focas Library | History | cnc_clearophis
Description Clears the operation history data and the alarm history data. At Series 30i 0i-D/F and PMi-A, the external operator's message history data are also... [read more]
cnc_clearophis
Fanuc Focas Library | History | cnc_rdalmhisno
Description Reads the number of alarm history data. It is necessary to stop sampling the alarm history data by using... [read more]
cnc_rdalmhisno
Fanuc Focas Library | History | cnc_rdalmhistry
Description Reads the alarm history data. The unit of one alarm history data is called a record.... [read more]
cnc_rdalmhistry
Fanuc Focas Library | History | cnc_rdalmhistry2
Description Reads the alarm history data. Please use this function instead of cnc_rdalmhistry for Series 15i.... [read more]
cnc_rdalmhistry2
Fanuc Focas Library | History | cnc_rdalmhistry3
Description Reads the alarm history data. The unit of one alarm history data is called a record.... [read more]
cnc_rdalmhistry3
Fanuc Focas Library | History | cnc_rdalmhistry4
Description Reads the alarm history data. Please use this function instead of... [read more]
cnc_rdalmhistry4
Fanuc Focas Library | History | cnc_rdalmhistry5
Description Reads the alarm history data. Please use this function instead of... [read more]
cnc_rdalmhistry5
Fanuc Focas Library | History | cnc_rdhissgnl
Description Reads the target signal for the operation history. Please use... [read more]
cnc_rdhissgnl
Fanuc Focas Library | History | cnc_rdhissgnl2
Description Reads the target signal for the operation history. Please use this function instead of... [read more]
cnc_rdhissgnl2
Fanuc Focas Library | History | cnc_rdhissgnl3
Description Reads the target signal for the operation history. Please use this function instead of... [read more]
cnc_rdhissgnl3
Fanuc Focas Library | History | cnc_rdomhisinfo
Description Reads the maximum number, current number and maximum string length of external operator's message history data.... [read more]
cnc_rdomhisinfo
Fanuc Focas Library | History | cnc_rdomhisno
Description Reads the number of the external operator's message history data. It is necessary to execute "Stop... [read more]
cnc_rdomhisno
Fanuc Focas Library | History | cnc_rdomhistry
Description Reads the external operator's message history data. Because the external operator's message history data is recorded... [read more]
cnc_rdomhistry
Fanuc Focas Library | History | cnc_rdophisno
Description Reads the number of operation history data. It is necessary to stop sampling the operation history data by using... [read more]
cnc_rdophisno
Fanuc Focas Library | History | cnc_rdophistry
Description Reads the operation history data. Please use... [read more]
cnc_rdophistry
Fanuc Focas Library | History | cnc_rdophistry2
Description Reads the operation history data. Please use this function instead of... [read more]
cnc_rdophistry2
Fanuc Focas Library | History | cnc_rdophistry3
Description Reads the operation history data. Please use this function instead of... [read more]
cnc_rdophistry3
Fanuc Focas Library | History | cnc_rdophistry4
Description Reads the operation history data. Please use this function instead of... [read more]
cnc_rdophistry4
Fanuc Focas Library | History | cnc_startomhis
Description Restarts logging the external operator's message history data. The specification for Series 30i,... [read more]
cnc_startomhis
Fanuc Focas Library | History | cnc_startophis
Description Restarts sampling the operation history data and the alarm history data of CNC. In Series 30i, 0i-D/F... [read more]
cnc_startophis
Fanuc Focas Library | History | cnc_stopomhis
Description Stops logging the external operator's message history data. The specification for Series 30i,... [read more]
cnc_stopomhis
Fanuc Focas Library | History | cnc_stopophis
Description Stops sampling the operation history data and the alarm history data of CNC. In Series 30i/31i/32i, 0i-D/F and PMi-A, the... [read more]
cnc_stopophis
Fanuc Focas Library | History | cnc_wrhissgnl
Description Writes the target signal for the operation history. Please use... [read more]
cnc_wrhissgnl
Fanuc Focas Library | History | cnc_wrhissgnl2
Description Writes the target signal for the operation history. Please use this function instead of... [read more]
cnc_wrhissgnl2
Fanuc Focas Library | History | cnc_wrhissgnl3
Description Writes the target signal for the operation history. Please use this function instead of... [read more]
cnc_wrhissgnl3
Fanuc Focas Library | History | cnc_wrkeyhistry
Description The specified key code is recorded in the operation history in CNC. Even... [read more]
cnc_wrkeyhistry
Fanuc Focas Library | History | flist_History
CNC: Function related to history data... [read more]
flist_History
Modified: 2018-06-11