mcf_db_print_dirrectory — Print database file directory (Fortran API)
subroutine mcf_db_print_directory(handle,pattern,status)
mcf_db_print_directory
prints the table
of contents, i.e the list of the dataset names and attributes, of
the database file identified by handle
to the
Fortran formatted output unit io
.
pattern
defines the pattern-matching
string.
Note that the Fortran formatted output unit specification is implementation-dependent, i.e on some implementations the output is printed to the standard output unit.
handle
File handle of file to be printed (input).
pattern
String containing pattern-matching criteria for
selective output. The pattern matching mechanism is the same
as the one found in the UNIX
Bourne shell. If all datasets are to be
listed, set pattern
to
"*"
or specify an empty string.
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.