Skip to main content

ForeignLogicalFileName

STD.File.ForeignLogicalFileName( filename [, foreigndali ] [, absolutepath ] [, omitClusterPrefix ] )

filenameA null-terminated string containing the logical name of the file.
foreigndaliA null-terminated string containing the IP address of the foreign Dali. If omitted, the filename is presumed to be a foreign logical file name, which is converted to a local logical file name.
absolutepathOptional. A boolean TRUE/FALSE to indicate whether to prepend a tilde (~) to the resulting foreign logical file name. If omitted, the default is FALSE.
omitClusterPreifxOptional. A boolean TRUE/FALSE to indicate whether the target cluster's prefix should automatically be added if 'filename' is a relative logical file name. If omitted, the default is FALSE.
Return: ForeignLogicalFileName returns returns a VARSTRING (null-terminated) value.

The ForeignLogicalFileName function returns either a foreign logical file name (if the foreigndali parameter is present) or a local logical file name.

Example:

sf := '~thor_data400::BASE::Business_Header';
ff := STD.File.ForeignLogicalFileName(sf,'10.150.29.161',true);
 //results in: ~foreign::10.150.29.161::thor_data400::base::business_header
lf := STD.File.ForeignLogicalFileName(ff,'',true);
 //results in: ~thor_data400::base::business_header