[Next] [Up] [Back] [Previous] [Contents]

3.26 DIINI


Calling sequence : CALL DIINI (LUOPT, LUBASE, LUINDX, LUNEUT, LUTEMP,

ITFNUM, LUREAD, LUWRTE, LUMES1, LUMES2, IEXIT)

Purpose : To initialise the Database Interface routines.

Parameters :

In

LUOPT Access option (Integer)

1 Access FEMVIEW database directly

2 Output to neutral text file

3 Do both 1. and 2.

LUBASE Channel number for FEMVIEW data base file (Integer)
LUINDX Channel number for FEMVIEW index file (Integer)
LUNEUT Channel number for neutral file (Integer)
LUTEMP Channel numbers for temporary file (Integer array length 10)
ITFNUM Number of temporary files to be opened at the same time (Integer)
LUREAD Not used (Integer)
IFORMT Character file format indicator (Integer)

Default is 5 digit node and element numbers, if IFORMT is set to 10; a 10 digit character file format will be used.

LUMES1 Channel number for messages (Integer) (set to 99 if not required)
LUMES2 Channel number for messages (Integer) (set to 99 if not required)

Out

IEXIT Error condition (Integer)

Use : This routine is called to initialise the database interface routines. It must be called before calling any of the other routines. The user indicates whether they wish to access the FEMVIEW database or output to a character file, or both with the value of LUOPT.

When accessing the database, the user provides the channel numbers for the database and index files (LUBASE and LUINDX), the opening of these files is controlled by routine DIDBI.

When outputting to a neutral character file, the user must open the file and supply the channel number (LUNEUT) to write to. For either access method the user supplies the channel number(s) (LUTEMP) of a binary temporary file(s) that the user must open. The file format (5 digit or 10 digit) must also be defined. If IFORMT is set to any number other than 10 a 5 digit format will be used.

Up to 10 temporary files may be opened simultaneously to enable data sets to be created and processed in parallel. More information on this is given in chapter one.

Channel numbers : FEMGV will perform its own file management and it is assumed that the pre-connected channel numbers for terminal I/O are available.

Errors : The error condition is indicated by the value of IEXIT

IEXIT Meaning

0     Successful call
11     Database interface routines already initialised
12     Invalid initialisation option (luopt)
13     Invalid number of temporary files (itfnum)
24     Cannot access database with dummy library



[Next] [Up] [Back] [Previous] [Contents]