STD.File.ForeignLogicalFileName( filename [, foreigndali ] [, absolutepath ] [, omitClusterPrefix ] )
| filename | A null-terminated string containing the logical name of the file. |
| foreigndali | A 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. |
| absolutepath | Optional. A boolean TRUE/FALSE to indicate whether to prepend a tilde (~) to the resulting foreign logical file name. If omitted, the default is FALSE. |
| omitClusterPreifx | Optional. 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