fddx_mod2 - reopen a DDS dataset, passing headers

SYNOPSIS

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

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

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

DESCRIPTION

Routine, "fdds_mod2", opens an input file for modification with trace headers and "Samples". If the file does not exist, then a new one will be created either from an existing file using "old_tag" or from scratch using "title".

After opening a file for input with "fddx_mod2" the input buffer Dictionary will be left open for scanning. The open process will look for "alias" for the dictionary (or usp, segy or su binary on input), "alias_data" for overriding the binary, and "alias_format" for overriding the format. The input parameter, "value", is the default value used for a fallback in cases where "alias" is not specified by the user. The input parameter, "title", should be a brief one line description of the application program. It will return a binary tag associated with the internal binary upon successful opening, a value of -2 if the dataset is not specified and no default value is given, otherwise a value of -1 to signify an open failure.

AUTHOR

Jerry Ehlers, BP America (May 2003)