CREATE Statement
Creates a host file or Reality item that has been opened for sequential access using OPENSEQ with the EXISTING keyword.
This statement is provided for compatibility with other MultiValue systems.
Syntax
CREATE seqfile-var {SETTING setting-var} {ON ERROR statement(s)} [ THEN statement(s) | ELSE statement(s) ]
Syntax Elements
seqfile-varis the name of a variable containing a sequential file reference (assigned via an OPENSEQ statement).
setting-varThe name of a variable to which the return status is assigned. See Operation for details of the possible values for this variable.
statement(s)A sequence of one or more valid DataBasic statements, either separated by semicolons, or contained on separate lines and followed by an END statement.
Operation
The following details circumstances under which the different clauses are executed and the values returned in setting-var:
|
Clause Executed |
Reason |
setting-var |
STATUS() Value |
|---|---|---|---|
|
THEN |
File or item created successfully |
0 |
0 |
|
ELSE |
File or item already exists |
0 |
0 |
|
ON ERROR |
File or item opened, but not for sequential access (should have been opened with OPENSEQ) |
B45 |
12 |
|
File or item not open |
B12 |
12 |
|
|
General file error |
Error number |
Error number |
Note
-
If an error occurs but there is no ON ERROR clause, the DataBasic Debugger will be entered with error B53 as well as the setting-var value.
-
The final column gives the values returned by the STATUS function if this is used instead of a SETTING clause.
See Also
OPENSEQ statement.