Data Dictionary System: Developers Fortran Convenience (fddx

fddx_out - open a DDS dictionary for output

SYNOPSIS

#include <fdds.h> (fixed-format sources)
#include <f90dds.h> (free-format sources)

integer function fddx_out(alias, value, title, old_tag)

character*(*) alias
character*(*) value
character*(*) title
integer old_tag

DESCRIPTION

"fddx_out" prepares the DDS dictionary for an output data stream. After the dictionary is opened, it is left in "print" mode, which enables printing of application specific definitions with fdds_printf. After the application specific definitions are set, fdds_lseek8 is used to freeze the output dictionary and open the output data stream.

ARGUMENTS

"alias" is used to interrogate the par: dictionary for optional definitions

   alias= dictionary name
   alias_data= binary file name
   alias_format= [segy,fcube,...]

"value" is used as a fallback when alias= is absent. "value" is commonly set to "stdout:" to allow piped output, but can have other application specific names as well. E.g. "tmp_data".

"title" should be a brief , one line description of the application program.

"old_tag" is a binary tag containing historical information about data being written. The history is passed to the output dictionary. If "old_tag" is negative then an fcube dataset will be created from scratch using "title". The format and trace structure can be changed by printing definitions for "format", "fmt:ASP_TRACE" and/or "fmt:SAMPLE_TYPE", before opening the binary stream with fdds_lseek8.

OUTPUT

fddx_out returns a binary tag for the output buffer binary, a value of -2 if the dataset is not specified and no default value is given, or a value of -1 to signify other open failures.

AUTHOR