MemCom Reference Manual > MemCom ftn Fortran API > Database Manager (DB) > mcf_db_get_set_att

Name

mcf_db_get_set_att — Get dataset attributes (Fortran API)

Synopsis

subroutine mcf_db_get_set_att(handle,name,type,ndim,dims,
                              size,dsize,faddr,status)

subroutine mcf_db_get_set_att_type(handle,name,type,status)

subroutine mcf_db_get_set_att_dims(handle,name,ndim,dims,status)

subroutine mcf_db_get_set_att_size(handle,name,size,status)

subroutine mcf_db_get_set_att_dsize(handle,name,dsize,status)

subroutine mcf_db_get_set_att_address(handle,name,faddr,status)

integer*4 handle
character*(*) name
character*4 type
integer*4 ndim
integer*8 dims(ndim)
integer*8 size
integer*8 dsize
integer*8 faddr
integer*4 status

Description

The mcf_db_get_set_att functions check if a sets exists anf if so, they return the dataset attributes of a dataset name identified by handle. mcf_db_get_set_att returns all attributes. The other functions return one attribute at the time. Note that the functions mcf_db_get_set_att never abort, i.e if the set is not found the status 1 is returned and the output values remain undefined.

Parameters

handle

Handle of database file on which the set(s) reside (input).

name

Name of dataset (input). The string may not exceed the maximum dataset name length.

type

Dataset type (output). The dataset type must consist of a character*4 buffer.

ndim

Number of dimensions of dataset (output).

dims

Size of each of the ndim dimensions (output).

size

Total size of dataset (output). size is equal to the sum of all dims.

dsize

Size of descriptor in bytes (output). A value of 0 means that no descriptor is defined.

faddr

Byte start address on database file of the data of dataset name. Byte addresses start with 0.

status

Status code returned (output). Upon successful completion of the operation, the status value 0 is returned. If the set was not found 1 is returned (no abort).