gettab

Name

gettab — Load relational table

Synopsis

subroutine gettab(handle,name,idiv,status)
integer*4 handle
character*(*) name
integer*4 idiv
integer*4 status

Description

gettab copies the relational table dataset from the database to the 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 gettab.

Parameters

handle: Database unit number (input). The file unit handle may not exceed the maximum number of simultaneously open databases.
name: Name of dataset (input). The string may not exceed the maximum dataset name length.
idiv: Sub-division number (input). idiv must be greater than or equal to 0.
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.