CNC_DSCHDIR | DATA Top
Description
DATA SERVER
Changing a current folder of the ATA card with DATA SERVER function.
DATA SERVER Host
Changing a current folder of host currentry connected with DATA SERVER function, and receive the filelist of a changed connection host.
Embedded Ethernet
Changing a current folder of connection host with an embedded Ethernet function, and receive the filelist of a changed connection host.
MTConnect Fanuc Adapter Universal Fanuc Driver Fanuc Focas Library CD Declaration
#include "fwlib32.h" or "fwlib64.h"
FWLIBAPI short WINAPI cnc_dschdir(unsigned short FlibHndl, char *dev_name, char *dir, IN_DSFILE *ds_file_in, OUT_DSINFO *ds_info_out, OUT_DSFILE *ds_file_out); Arguments
FlibHndl
[ in ]
dev_name
[ in ]
Specify the pointer of a variable area that stored device name to be specify.
The device names to be specify are as follows:
DATA SERVER : "DATA_SV"
DATA SERVER Host : "DTSVR_HOST"
Embedded Ethernet : "EMB_ETHER"
dir
[ in ]
DATA SERVER
Specify the pointer to a folder name to change.
Maximum of 32 characters of ASCII character string including NULL, and place the NULL at the end.
DATA SERVER Host, Embedded Ethernet
Specify the pointer to a folder name to change.
Maximum of 128 characters of ASCII character string including NULL, and place the NULL at the end.
ds_file_in
[ in ]
(*Used only at time of DATA SERVER Host or Embedded Ethernet)
The pointer to IN_DSFILE structure which passes the setting value of file information taken out of a connection host.
IN_DSFILE structure is as follows:
typedef struct in_dsfile {
char path[256]; /* Standard File Name */
long fnum; /* Standard File Number */
long offset; /* Offset */
short req_num; /* Request File Number */
short size_type; /* Size Type */
short detail; /* File Detail */
short dummy;
} IN_DSFILE;
offset
The offset value from a head file of the file information to take out is set up.
req_num
The numder of files of file information to takeout is set up.
req_num can set up to a maximum of 32.
detail
Read only the file name or read inclusive the file information is set up for the file information to take out.
0 : Read only the file name.
1 : Read inclusive the file information.
ds_info_out
[ out ]
(*Used only at time of DATA SERVER Host or Embedded Ethernet)
The pointer to OUT_DSINFO structure which stores the file information from a connection host.
OUT_DSINFO structure is as follows:
typedef struct out_dsinfo {
short type; /* Type */
short dummy;
long fnum; /* Serial Number */
long total; /* Total File Number */
unsigned long remain_h; /* Remains Capacity (Upper)*/
unsigned long remain_l; /* Remains Capacity (Lower) */
char dir[256]; /* Current Folder */
} OUT_DSINFO
fnum
The serial numbers from the head file of the file stored in the ds_file_out are returned.
In the case of a head file, 1 is returned.
total
The number of folders/the number of files registered into a connection host's current folder are returned.
ds_file_out
[ out ]
(*Used only at time of DATA SERVER Host or Embedded Ethernet)
The pointer to OUT_DSFILE structure which stores the file information received from the connection host.
The area that can be stored the number of data specified by the variable req_num of Argument ds_file_in is needed.
OUT_DSFILE structure is as follows:
typedef struct out_dsfile {
short year; /* Last Edit Time */
short mon; /* Last Edit Time */
short day; /* Last Edit Time */
short hour; /* Last Edit Time */
short min; /* Last Edit Time */
short sec; /* Last Edit Time */
long size; /* Size */
unsigned long attr; /* Attribute */
char file[36]; /* File Name */
char info[128]; /* Infomation */
} OUT_DSFILE
file
The file name for operation is returned.
Maximum of 33 characters of ASCII character string including NULL, and place the NULL at the end.
It becomes effective only when 1 is specified to be detail variable of argument ds_file_in.
info
The file name for a display or the string of file information is returned.
Maximum of 128 characters of ASCII character string including NULL, and place the NULL at the end.
When 0 is specified to be a detail variable of argument ds_file_in,only the file name returns.
When 1 is specified to be a detail variable of argument ds_file_in,the file information returns.
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_NOOPT (6)
No option
In order to get more information for this err_no return value, execute cnc_getdtailerr() function.
The following details status will be set onto the member, err_no of ODBERR structure.
22 : The option board is nothing
24 : The DATA SERVER function is nothing.
26 : The ATA Card is nothing.
EW_BUSY (-1)
Busy
DATA SERVER or embedded Ethernet is processing.
EW_LENGTH (2)
Data block length error
The Specification of req_num is wrong.
EW_NUMBER (3)
Data number error
The Specification of detail is wrong.
EW_DTSRVR (14)
DATA SERVER error or Embedded Ethernet error
In order to get more information for this err_no return value,In order to get more information for this err_no return value,cnc_getdtailerr() function.
The following details status will be set onto the member, err_no of ODBERR structure.
DATA SERVER
464 : The ATA card is not formated.
488 : Change of a directory went wrong.
DATA SERVER Host,Embedded Ethernet
468 : Connection host is not found.
501 : Acquision of file information went wrong from the host computer.
507 : Change of a directory went wrong.
508 : Login to a connection host went wrong.
509 : Connection with a connection host went wrong.
511 : An error is in a connection host's parameter.
As for the other return codes or the details, see
"Return status of Data window function "
CNC option
For HSSB connection,
CNC parameter
This function is not related to CNC parameter.
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
H
O
T (Turning) X
X
O
O
X
-
X
X
X
X
X
X
X
X
X
H
O
LC (Loader)
-
-
-
-
-
-
X
X
X
X
X
X
X
X
X
-
-
0i-D 0i-F 16i 18i 30i-A 30i-B
P (Punch press) H
H
X
X
-
H
L (Laser)
-
-
X
-
-
H
W (Wire)
-
-
X
X
X
X
Power Mate i-D X
Power Mate i-H X
Power Motion i-A X
"O"
:
Both Ethernet and HSSB
"E"
:
Ethernet
"H"
:
HSSB
"X"
:
Cannot be used
"-"
:
None
Note) 0i-C does not support the HSSB function.
Fanuc Focas Library | Data | cnc_clrmsgbuff Clears the receive buffer or the transmit buffer.... [read more]Fanuc Focas Library | Data | cnc_dscopyfile Copying a file in the ATA card with DATA SERVER function.... [read more]Fanuc Focas Library | Data | cnc_dsftpcancel This function is used to cancel the following operetions.... [read more]Fanuc Focas Library | Data | cnc_dsftpstat The execution result(EW_OK/EW_DTSRVR) of the following function can be taken out only at once.... [read more]Fanuc Focas Library | Data | cnc_dsget_req Directs to GET a file to from a host computer at DATA SERVER. When this function is normally ended, it starts getting files from host... [read more]Fanuc Focas Library | Data | cnc_dslistdel_req According to the list which exists in the ATA card of DATA SERVER functon, two or more files are deleted. When this function carries... [read more]Fanuc Focas Library | Data | cnc_dslistget_req According to the list file which exists in the connection host of DATA SERVER function, the file transfer of two or more files is continuously carried... [read more]Fanuc Focas Library | Data | cnc_dslistput_req According to the list file which exists in the ATA card of DATA SERVER function ,the file transfer of two or more files is carried out to a connection... [read more]Fanuc Focas Library | Data | cnc_dsmget_req It directs to MGET a file from a host computer to DATA SERVER. A wild card can be used for a file name and the file transfer of two or... [read more]Fanuc Focas Library | Data | cnc_dsmkdir DATA SERVER A new folder is created to the current folder of the ATA card of DATA SERVER function. DATA SERVER... [read more]Fanuc Focas Library | Data | cnc_dsmput_req It directs to MPUT a file to a host computer from DATA SERVER. A wild card can be used for a file name and the file transfer of two or... [read more]Fanuc Focas Library | Data | cnc_dsput_req Directs to PUT a file to a host computer to DATA SERVER. When this function is normally ended, it starts putting files from host... [read more]Fanuc Focas Library | Data | cnc_dsremove DATA SERVER The file in the current folder of the ATA card of DATA SERVER function delete. DATA SERVER Host... [read more]Fanuc Focas Library | Data | cnc_dsrename DATA SERVER Changing the file or folder name which exist in the current folder of the ATA card of DATA SERVER... [read more]Fanuc Focas Library | Data | cnc_dsrmdir DATA SERVER The folder in the current folder of the ATA card of DATA SERVER function delete. DATA SERVER... [read more]Fanuc Focas Library | Data | cnc_dtsvchkdsk Checks the hard disk on the DATA SERVER whether there is an error sector etc. or not. If this function is executed while... [read more]Fanuc Focas Library | Data | cnc_dtsvcnclupdn Cancels the following if it is being executed. - Download from DATA SERVER to CNC - Upload from CNC to... [read more]Fanuc Focas Library | Data | cnc_dtsvdelete Deletes the file in the DATA SERVER. If this function is executed while... [read more]Fanuc Focas Library | Data | cnc_dtsvdownload Orders the CNC to download the file from the DATA SERVER. Therefore, normal termination of this function shows that downloading the file from the DATA SERVER... [read more]Fanuc Focas Library | Data | cnc_dtsvftpget Orders the DATA SERVER to get file from the host computer. Therefore, normal termination of this function shows that getting the file from the host computer... [read more]Fanuc Focas Library | Data | cnc_dtsvftpput Orders the DATA SERVER to put file to the host computer. Therefore, normal termination of this function shows that putting the file to the host computer has... [read more]Fanuc Focas Library | Data | cnc_dtsvftpstat The execution result of cnc_dtsvftpput ,... [read more]Fanuc Focas Library | Data | cnc_dtsvgetdncpg Gets the file name for DNC operation in the DATA SERVER.... [read more]Fanuc Focas Library | Data | cnc_dtsvgetmode Gets the current mode of the DATA SERVER(storage mode/buffer mode).... [read more]Fanuc Focas Library | Data | cnc_dtsvhdformat Formats the hard disk on the DATA SERVER. If this function is executed while... [read more]Fanuc Focas Library | Data | cnc_dtsvmntinfo Reads the following maintenance information for the DATA SERVER. This is the function for purposes of maintenance.... [read more]Fanuc Focas Library | Data | cnc_dtsvrdcram Reads the contents of the interface buffer for the DATA SERVER. This is the function for purposes of maintenance.... [read more]Fanuc Focas Library | Data | cnc_dtsvrderrmsg Reads the message of the error occurred in the DATA SERVER.... [read more]Fanuc Focas Library | Data | cnc_dtsvrdfile Transfers file from DATA SERVER to hard disk on personal computer. This function is effective for the DATA SERVER board(10BASE-T), and... [read more]Fanuc Focas Library | Data | cnc_dtsvrdpgdir Reads the directory information in the DATA SERVER. If this function is executed while... [read more]Fanuc Focas Library | Data | cnc_dtsvrdset Reads the setting data in the DATA SERVER. If this function is executed while... [read more]Fanuc Focas Library | Data | cnc_dtsvsavecram Saves the contents of the interface buffer for the DATA SERVER to the file by the name of COMMON.RAM in the hard disk of the DATA SERVER.... [read more]Fanuc Focas Library | Data | cnc_dtsvsetdncpg Sets the file name for DNC operation in the DATA SERVER.... [read more]Fanuc Focas Library | Data | cnc_dtsvsetmode Sets the current mode of the DATA SERVER(storage mode/buffer mode). If the mode of the DATA SERVER is changed, all the data in hard disk of the DATA... [read more]Fanuc Focas Library | Data | cnc_dtsvupdnstat The execution result of cnc_dtsvdownload ,... [read more]Fanuc Focas Library | Data | cnc_dtsvupload Orders the CNC to upload the file to the DATA SERVER. Therefore, normal termination of this function shows that uploading the file to the DATA SERVER has been... [read more]Fanuc Focas Library | Data | cnc_dtsvwrfile Transfers file from hard disk on personal computer to DATA SERVER. This function is effective for the DATA SERVER board(10BASE-T), and 16i/18i/21i, 0i.... [read more]Fanuc Focas Library | Data | cnc_dtsvwrset Writes the setting data in the DATA SERVER. If this function is executed while... [read more]Fanuc Focas Library | Data | cnc_rdcomlogmsg Reads logging message for DNC2.... [read more]Fanuc Focas Library | Data | cnc_rdcomopemsg Reads operator's message for DNC1,DNC2.... [read more]Fanuc Focas Library | Data | cnc_rdcomparam Reads communication parameters for DNC1, DNC2 or OSI-Ethernet function.... [read more]Fanuc Focas Library | Data | cnc_rddncfname Reads the name of the file in the host computer for DNC operation using DNC1, DNC2 or OSI-Ethernet function.... [read more]Fanuc Focas Library | Data | cnc_rddsdevinfo All the number of pages , the use number of pages, the total number of entries, and the numberof use entries are taken out from an ATA... [read more]Fanuc Focas Library | Data | cnc_rddsdir DATA SERVER The current folder name of the ATA card of DATA SERVER function is taken out with a full path.... [read more]Fanuc Focas Library | Data | cnc_rddsdncfile DATA SERVER The file name set to DNC operation at the time of the Storage mode of DATA SERVER function is taken out with... [read more]Fanuc Focas Library | Data | cnc_rddsfile DATA SERVER The list of the files in the current folder of DATA SERVER function (a sub folder is included) is taken out.... [read more]Fanuc Focas Library | Data | cnc_rdrcvmsg Reads contents of the receive buffer in which received message is stored. When this function is called, receipt status in CNC is... [read more]Fanuc Focas Library | Data | cnc_rdrcvstat Obtains receipt status of message for OSI-Ethernet. The receipt status becomes ON when CNC receives a message for OSI-Ethernet, and becomes OFF when... [read more]Fanuc Focas Library | Data | cnc_rdsndmsg Reads contents of the transmit buffer in which transmitted message is stored.... [read more]Fanuc Focas Library | Data | cnc_sendmessage Sends message to the host computer.... [read more]Fanuc Focas Library | Data | cnc_wrcomparam Writes communication parameters for DNC1,DNC2 or OSI-Ethernet function. When communication parameters are written to OSI-Ethernet board... [read more]Fanuc Focas Library | Data | cnc_wrdncfname Writes the name of the file in the host computer for DNC operation using DNC1, DNC2 or OSI-Ethernet function.... [read more]Fanuc Focas Library | Data | cnc_wrdsdncfile DATA SERVER The file for DNC operation at the time of the storage mode of DATA SERVER function is set up. DATA... [read more]Fanuc Focas Library | Data | ds_cancel The execution of the function for the following DATA SERVER is stopped.... [read more]Fanuc Focas Library | Data | ds_checkhdd Whether a defective sector exists in the hard disk is checked.... [read more]Fanuc Focas Library | Data | ds_chghdddir Change the work directory(current directory) of hard disk in the DATA SERVER. This function is available even to Fast Ethernet.... [read more]Fanuc Focas Library | Data | ds_copyhddfile The file in the hard disk of the DATA SERVER is copied. In this function, the control returns to the application without only requesting the copy of the file... [read more]Fanuc Focas Library | Data | ds_delhdddir Delete the directory in the hard disk of the DATA SERVER.... [read more]Fanuc Focas Library | Data | ds_delhddfile The file in the hard drive of the DATA SERVER is deleted. The some files can be deleted simultaneously by specifying wild-card(*,?). In this function,... [read more]Fanuc Focas Library | Data | ds_delhostfile Delete the file of host computer. The wild-card(*, ?) cannot be used to specify the name.... [read more]Fanuc Focas Library | Data | ds_download Outputs data to be registered(downloading). This function is only for Fast Ethernet board. This function is not supported at Embedded... [read more]Fanuc Focas Library | Data | ds_dwnend Notifies the end of downloading data to CNC. (This function must be executed after... [read more]Fanuc Focas Library | Data | ds_dwnstart Requests CNC to start downloading. (This function must be executed before... [read more]Fanuc Focas Library | Data | ds_formathdd The hard disk is formatted(initialization).... [read more]Fanuc Focas Library | Data | ds_gethostfile The file of the host computer is transferred to the hard disk of the DATA SERVER according to the get command of the FTP.... [read more]Fanuc Focas Library | Data | ds_ldelhddfile The files in the hard disk of the DATA SERVER are deleted according to the list file. The wild-card(*, ?)... [read more]Fanuc Focas Library | Data | ds_lgethostfile The files in the host computer are transferred to the hard disk of the DATA SERVER by the processing of FTP according to the... [read more]Fanuc Focas Library | Data | ds_lputhddfile The files in the hard disk of the DATA SERVER are transferred to the host computer by the processing of FTP according to the... [read more]Fanuc Focas Library | Data | ds_makehdddir Make the directory in the hard disk of the DATA SERVER.... [read more]Fanuc Focas Library | Data | ds_mgethostfile The files of the host computer are transferred to the hard disk of the DATA SERVER according to the mget command of the... [read more]Fanuc Focas Library | Data | ds_mputhddfile The files in the hard disk of the DATA SERVER are transferred to the host computer according to the mput command of the... [read more]Fanuc Focas Library | Data | ds_puthddfile The file in the hard disk of the DATA SERVER is transferred to the host computer side according to the put command of the FTP. The wild-card(*, ?) cannot... [read more]Fanuc Focas Library | Data | ds_rddnchddfile The file name which includes the PATH name in the hard disk which is setted for the DNC operation are acquired.... [read more]Fanuc Focas Library | Data | ds_rddnchostfile The connected host number and the file name in host computer for the DNC operation is acquired.... [read more]Fanuc Focas Library | Data | ds_rdfile Transfers file from DATA SERVER to hard disk on personal computer. This function is effective in only 16i/18i/21i. and, this function... [read more]Fanuc Focas Library | Data | ds_rdhdddir Get the file information at each file. The following information is acquired at each file. - File name... [read more]Fanuc Focas Library | Data | ds_rdhddinfo Get the information of hard disk of DATA SERVER. The following information can be acquired. - The remainder capacity of hard disk.... [read more]Fanuc Focas Library | Data | ds_rdhostdir Get the file information of host computer.... [read more]Fanuc Focas Library | Data | ds_rdhostdir2 Get the number of files and file information of login directory on the host computer. Information acquired in... [read more]Fanuc Focas Library | Data | ds_rdhostinfo Get the information of login directory of the host computer. The following information is acquired.... [read more]Fanuc Focas Library | Data | ds_rdhostno Get the host number of the connected host computer.... [read more]Fanuc Focas Library | Data | ds_rdm198hdddir The work directory for the M198(subprogram call) is acquired.... [read more]Fanuc Focas Library | Data | ds_rdm198host Connected host number for the M198(subprogram call) is acquired.... [read more]Fanuc Focas Library | Data | ds_rdmntinfo The data for troubleshooting is acquired as maintenance information for the file transfer between the DATA SERVER and CNC.... [read more]Fanuc Focas Library | Data | ds_rdmode Get the mode for the DATA SERVER.... [read more]Fanuc Focas Library | Data | ds_rdncfile The NC program is inputted from the hard drive to the NC. Storage mode : To CNC memory from hard disk(or ATA) of DATA SERVER... [read more]Fanuc Focas Library | Data | ds_rdncfile2 The NC program is inputted from the hard drive to the NC. Storage mode : To CNC memory from hard disk(or ATA) of DATA SERVER... [read more]Fanuc Focas Library | Data | ds_rdresult Get the execution result of the function for the following DATA SERVER.... [read more]Fanuc Focas Library | Data | ds_renhddfile The file name in the hard disk of the DATA SERVER is changed.... [read more]Fanuc Focas Library | Data | ds_searchresult Gets the result of ds_searchword function.... [read more]Fanuc Focas Library | Data | ds_searchword The string of the NC program in DATA SERVER at the running of M198/DNC in MEM/RMT mode is searched. The result of search can... [read more]Fanuc Focas Library | Data | ds_wrdnchddfile The file name in the hard disk of the DATA SERVER for DNC operation is set. The current work directory is... [read more]Fanuc Focas Library | Data | ds_wrdnchostfile The file name of the host computer for DNC operation is set. The current connected host computer is set... [read more]Fanuc Focas Library | Data | ds_wrfile Transfers file from hard disk on personal computer to DATA SERVER. This function is effective in only 16i/18i/21i. and, this function... [read more]Fanuc Focas Library | Data | ds_wrhostno The host computer which works the FTP server which becomes the other party of the communication of the DATA SERVER is changed.... [read more]Fanuc Focas Library | Data | ds_wrm198hdddir The work directory for the M198(subprogram call) is set. The current directory in the hard disk of the... [read more]Fanuc Focas Library | Data | ds_wrm198host Connected host number for the M198(subprogram call) is set. The connected host of now becomes the host for... [read more]Fanuc Focas Library | Data | ds_wrmode Set the mode for the DATA SERVER. The mode of the DATA SERVER which can be set is shown as follows.... [read more]Fanuc Focas Library | Data | ds_wrncfile The NC program is outputted from the NC to the hard drive. Storage mode : To hard disk(or ATA) of DATA SERVER from CNC... [read more]Fanuc Focas Library | Data | etb_rderrmsg Get the error message which occurred in the Ethernet board. This function acquires the error message of the Ethernet board... [read more]Fanuc Focas Library | Data | etb_rdparam Get the parameter of ethernet board. The following parameter can be acquired by this function.... [read more]Fanuc Focas Library | Data | etb_wrparam Set the parameter for Ethernet board. The following parameter can be set to the Ethernet board. Parameter... [read more]Fanuc Focas Library | Data | eth_clrlog Clear the logs for Ethernet function : Embedded Ethernet[Internal port ,PCMCIA Card], Fast Ethernet board, Fast DATA SERVER board, Windows CE... [read more]Fanuc Focas Library | Data | eth_dschkdsk Check disk of ATA card on DATA SERVER.... [read more]Fanuc Focas Library | Data | eth_dsformat Format ATA card on DATA SERVER.... [read more]Fanuc Focas Library | Data | eth_rddsformat Get the format of ATA card on DATA SERVER.... [read more]Fanuc Focas Library | Data | eth_rddsm198dir Get the work folder for the M198 on DATA SERVER using Strage mode.... [read more]Fanuc Focas Library | Data | eth_rddsm198host Get the connected host number and work folder for the M198 on DATA SERVER using FTP mode.... [read more]Fanuc Focas Library | Data | eth_rddsmode Get the all channel modes on DATA SERVER.... [read more]Fanuc Focas Library | Data | eth_rddsstate Get each path of maintenance information on DATA SERVER.... [read more]Fanuc Focas Library | Data | eth_rdhost Get the host number selected current Ethernet function.... [read more]Fanuc Focas Library | Data | eth_rdlog MTConnect Fanuc Adapter... [read more]Fanuc Focas Library | Data | eth_rdparam Get the parameters for Ethernet function : Fast Ethernet board, Fast DATA SERVER... [read more]Fanuc Focas Library | Data | eth_wrdsm198dir Set the work folder for the M198 on DATA SERVER using Strage mode.... [read more]Fanuc Focas Library | Data | eth_wrdsm198host Set the connected host number and work folder for the M198 on DATA SERVER using FTP mode.... [read more]Fanuc Focas Library | Data | eth_wrdsmode Change the mode for DATA SERVER function.... [read more]Fanuc Focas Library | Data | eth_wrhost Set the host number selected Ethernet function.... [read more]Fanuc Focas Library | Data | eth_wrparam Sets the parameters for Ethernet function : Fast Ethernet board, Fast DATA SERVER... [read more]Fanuc Focas Library | Data | flist_Data CNC: Function Reference related to data server,DNC1,DNC2,OSI-Ethernet... [read more]Modified: 2023-12-05