MemCom Reference Manual > MemCom (Old) Fortran77 API > Database Manager Functions > inqsdb

Name

inqsdb — Check existence of dataset

Synopsis

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

Description

inqsdb tests if a dataset exists on a database. The flag iex is set to 1 if the dataset exists. If the set does not exist iex is set to 0. inqsdb is a simplified version of lgtdb and prpdb.

Parameters

handle

Database handle (input). The file handle 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.

exist

Flag returned (output). A value of 1 means that the dataset exists. A value of 0 means that the dataset does not exist.

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..