getdes

Name

getdes — Load dataset descriptor

Synopsis

subroutine getdes(handle,name,dummy,status)
integer*4 handle
character*(*) name
integer*4 dummy
integer*4 status

Description

getdes copies the descriptor of the dataset name from the database to the relational table buffer. Note that, unlike the C API, only one single relational table or descriptor can reside in the table buffer. Thus, any data in the table buffer will be deleted before the new table is loaded with getdes.

Parameters

handle: Database unit number (input). The file unit handle may not exceed the maximum number of simultaneously open databases.
name: Name of dataset descriptor to be loaded (input). The string may not exceed the maximum dataset name length.
dummy: Dummy variable (input).
status: Status code returned (output). Upon successful completion of the operation, the status value 0 is returned. A negative value is returned, if an error has been detected. A positive value is returned, if a warning has been issued. See MemCom error codes.