Process Help

LINK - link an external Datamine file to the current project

 

Process Name

Menu Path

Link to Command Table

LINK

Command line only

Click here

 

Introduction

Links a Datamine binary file outside the project folder to a file inside the project folder.

This process is valid only for Datamine (*.dm) files introduced with Version 3.0 of Studio 3 and can be specified only as part of a recorded macro.

How to use

The database file name is attached to symbolic file &OUT. The name of the external binary file is requested interactively.

The external filename cannot be a catalogue file.

This command is maintained for macro backward compatibility with earlier product versions released before the advent of the Studio range. The Link command is intended to only be run from macros.


Files, Fields and Parameters

Input Files

Name

Description

I/O Status

Required

Type

Output Files

Name

I/O Status

Required

Type

Description

OUT

Output

Yes

Table

Database file name.


Notes

LINK may be used to create a new Datamine file (*.dm) inside the project folder, by linking an existing Datamine binary file located outside of the project folder.

LINK with a catalogue file input may be used to restructure a set of *.dm files in the project folder. First files are unlinked (!UNLINK) individually; your application is exited (!LOGOFF); the existing database is deleted using system delete commands; your application is then re-entered, re-creating the database; then !LINK is entered using the catalogue file copied out previously.

The length of the system file name, including the full path name, is restricted to 56 characters.


Example

!LINK  

 &OUT(DBFILE)

SYSFILE>\#Product Folder#\system\extfile.dm<return>


Error and Warning Messages

Message

Description

Solution

>>> LINK ONLY WORKS WITH NATIVE-FILE DATABASES <<<

The LINK process only works with native-files (*.dm). Fatal; the process is exited.

 

 

 

 

>>> SYSTEM FILE DOES NOT EXIST <<<

The named file does not exist. Fatal; the process is exited.

 

 

 

 

>>> ERR 120 <<< ( fileno) IN LINK

Error in format or specifications of the file. This usually means that the external file already exists, but is not in the correct binary format. Fatal; the process is exited.