Database Access Routines |
 
|
Database Access Routines |
|
The database access routines are a collection of procedures that allow the retrieval of results directly from the database files. These procedures are packaged in the dynamic link library (DLL) mcsdar.dll.
In order to build these routines into your FORTRAN or Visual C++ program you need:
1.To reference the symbol export library mcsdar.lib in your program, and
2.To call the routines using the predefined calling convention as described in each routine interface.
To run your program you need to place a copy of the mcsdar.dll in the same folder as your executable.
The calling convention of each routine is Standard Call by Reference. This allows all arguments to be passed by reference. Character strings are passed by reference along with their length. The length of the character strings is a hidden argument in FORTRAN. The name of each routine is decorated with an underscore prefix (_) and a @n suffix. The number n represents the length of the argument list in bytes. Integer and real data types are 4 bytes long. A single character is 1 byte long.
The procedures available are listed below:
•GetDatabaseInfo returns information about the database files and the model. This must be called first.
•XIT deallocates memory and closes the database files, if opened. This function must be called last after all data of interest has been retrieved.
•GetAnalysisDetails returns the analysis name/title, gravity constant and two flags indicating if this is a static analysis and if the time-step is fixed or variable.
•GetProcessedDirectStressStrainData returns all processed nonlinear direct stress-strain relationships in the format of axial strain - axial force
•GetNodeProperties returns the node properties in terms of initial co-ordinates, as specified directly by the user, or as computed by the Cable Pre-Static Step, if a cable was specified in the model
•GetElementProperties returns the properties associated with this element
•GetRequestedHistory returns the requested history
•GetRequestedHistoryError flags the errors that occurred during the last history request
•GetRequestedSingleValue returns the requested single value
•GetRequestedSingleValueError flags the errors that occurred during the last single value request
Each of these routines is now described in turn.