STD.File.ExternalLogicalFileName( machineIP, filename )
| machineIP | A null-terminated string containing the IP address of the remote machine. |
| filename | A null-terminated string containing the path/name of the file. |
| Return: | ExternalLogicalFileName returns returns a VARSTRING (null-terminated) value. |
The ExternalLogicalFileName function returns an appropriately encoded external logical file name that can be used to directly read a file from any node that is running the dafilesrv utility (typically a landing zone). It handles upper case characters by escaping those characters in the return string.
Example:
IP := '10.150.254.6';
file := '/c$/training/import/AdvancedECL/people';
DS1 := DATASET(STD.File.ExternalLogicalFileName(IP,file),
Training_Advanced.Layout_PeopleFile, FLAT);
OUTPUT(STD.File.ExternalLogicalFileName(IP,file));
//returns:
//~file::10.150.254.6::c$::training::import::^advanced^e^c^l::people
OUTPUT(DS1);
//returns records from the external file