<<

Contents

Search

>>

 

NEWNAME

 

 

Instruction

 

 

Syntax:

NEWNAME(<Name of Index File>) = <Physical Name>

 

<Name of Index File>

= <INDEX FILE NAME>

<Physical Name>

= <STRING-EXPRESSION>

 

 

Meaning:

Defines a new physical name of an Index File.

 

By default, the physical name of an index file is identical with the name of the Index File in Ebus-J. With NEWNAME a different physical name can be specified. The new name only takes effect when the Index File is opened. That is why the instruction NEWNAME only makes sense in the Macro before Index-Open or after the instruction ICLOSE.

 

Even if a new physical name has been specified for the Index File, it is still handled under the original name <Inde File Name> in the macros.

 

<Physical Name> must contain a valid file name.

 

In the case of an error OK is set to –1, otherwise OK = 0.

 

Parameter:

Name of Index File

Name of Index File

Physical Name

Physical name of Index File

 

Sample:

ICLOSE(DATA)

NEWNAME(DATA) = "DATA_2007"

IOPEN(DATA)

INITIALIZE DATA

START DATA ON ERROR … END

 

See also:

IOPEN

ICLOSE

PATH

GET_PATH_INDEXFILE$

OPENMODE