|
Purpose
|
Creates and writes to a multi-order, single-field vdata. |
|
Return value
|
Returns the reference number of the newly created vdata if successful, and FAIL (or -1) otherwise. |
|
Description
|
VHstoredatam creates a vdata with the name specified by the parameter vdata_name and a class name specified by the parameter vdata_class in the file identified by the parameter file_id. The data type of the vdata is specified by the parameter data_type. The vdata contains one field with the name specified by the parameter fieldname. The order of the field, order, indicates the number of vdata values stored per field. The vdata contains the number of records specified by the parameter n_records. The buf parameter should contain n_records records that will be stored in the vdata. |
|
|
Vstart must precede VHstoredatam. It is not necessary, however, to call VSattach or VSdetach in conjunction with VHstoredatam. |
|
|
This routine provides a high-level method for creating multi-order, single-field vdatas. |
|
|
Note that there are two FORTRAN-77 versions of this routine; one for numeric data (vhfsdm) and the other for character data (vhfscdm). |