#------------------------------------------------------------------------------
#
#  NSSDC/CDF						CDFexport inline help.
#
#  Version 1.0, 15-Sep-95, Hughes STX.
#
#  Modification history:
#
#   V1.0  15-Sep-95, J Love	Original version.
#
#------------------------------------------------------------------------------

#section 1
#item
#title "CDF(s) Specification"
At the "CDF(s):" prompt enter the absolute or relative path of the CDF or
wildcard/directory specification you would like to open for input.  If a CDF
is specified, it will be opened and part 1 of the SelectionWindow will be
displayed.  If a wildcard/directory specification is entered, the CDFs
matching the specification will be displayed in the "CDF Selection" window.
From that window one of the CDFs may be selected.  The supported wildcard
characters are as follows...

  `*'    Matches any pattern of zero or more characters.
#ifos unix mac
  `?'    Matches any single character.
#endos
#ifos dos
  `?'    Matches any single character or zero characters.
#endos
#ifos vms
  `%'    Matches any single character.
#endos


The following functions are supported...

   Open:     Opens the specified CDF or wildcard/directory specification.

   Help:     Displays this online help.

   Exit:     Exits CDFexport.

The keys associated with each of these functions are defined in the
KeyDefinitions window.
#endsection

#section 2
#item
#title "CDF Selection"
A window containing one or more CDF names should be displayed.  Use the
up and down arrow keys to highlight the CDF to be opened for input.

The following functions are supported...

   Open:     Opens the currently highlighted CDF for input.

   Help:     Displays this online help.

   Exit:     Exits to the CDF(s) Specification prompt.

The keys associated with each of these functions are defined in the
KeyDefinitions window.
#endsection

#section 3
#item
#title "SelectionWindow, part 1"
This is online help for part 1 of the SelectionWindow.  The SelectionWindow
consists of three parts and is used to select the items/variables to be
exported and/or filtered.  Part 1 of the SelectionWindow contains columns
for the item/variable name, data specification, dimensionalitiy, variances,
and output setting...

   The item/variable column will contain either `Record', `Indices', or
   a variable name.  `Record' allows the record number to be exported
   or filtered.  `Indices' allows the dimension indices to be exported
   or filtered but only in those cases where the dimensionality of each
   variable being exported or filtered is the same.

   The data specification, dimensionality, and variances apply only to
   variables.

   The output setting (`Yes' or `No') indicates whether or not the
   item/variable should be exported.  Note that the `Record' and `Indices'
   items cannot be exported to a CDF.


The following functions are supported...

   Modify:   Selects the currently highlighted field for modification.  Note
             that only the `output' fields can be modified (toggling between
             `Yes' and `No').

   Part 2:   Change to part 2 of the SelectionWindow.

   Options:  Displays the OptionMenu.  The OptionMenu allows the modification
             of various settings which affect how items/variables are exported.

   Actions:  Displays the ActionMenu.  The ActionMenu allows the various
             exports to be generated (eg. screen/file listings and new CDFs) 
             as well as "block" changes to the fields in the SelectionWindow.

   Reverse:  Reverse the line containing the currently highlighted field with
             the following line (or the first line if at the last line).  The
             order of the lines in the SelectionWindow determines the order
             of the items/variables in the exports.

   Delete:   Deletes (empties) the currently highlighted field.  Note that not
             all fields can be deleted (emptied).
            
   Help:     Displays this online help.

   Exit:     Exit the CDF.

The keys associated with each of these functions are defined in the
KeyDefinitions window.
#endsection

#section 4
#item
#title "SelectionWindow, part 2"
This is online help for part 2 of the SelectionWindow.  The SelectionWindow
consists of three parts and is used to select the items/variables to be
exported and/or filtered.  Part 2 of the SelectionWindow contains columns
for the item/variable name, minimum and maximum filter values, and filter
setting...

   The item/variable column will contain either `Record', `Indices', or
   a variable name.  `Record' allows the record number to be exported
   or filtered.  `Indices' allows the dimension indices to be exported
   or filtered but only in those cases where the dimensionality of each
   variable being exported or filtered is the same.

   The minimum filter value for an item/variable is the minimum value
   to be output.  Whether the filter for an item/variable is inclusive
   or exclusive (as described below) will affect how this value is used.

   The maximum filter value for an item/variable is the maximum value
   to be output.  Whether the filter for an item/variable is inclusive
   or exclusive (as described below) will affect how this value is used.

   The filter setting indicates whether or not the item/variable should be
   filtered.  Depending on whether or not exclusive filters are allowed,
   one of the following values will be shown...

      Exclusive filters allowed...

        YeS    Put an inclusive filter on the item/variable.
        yEs    Put an exclusive filter on the item/variable.
        no     Do not filter the item/variable.

      Exclusive filters not allowed...

        YES    Put an inclusive filter on the item/variable.
        no     Do not filter the item/variable.

   Inclusive filters pass the minimum and maximum values.  Exclusive filters
   do not pass the minimum and maximum values - only the values that are
   greater than the minimum and less than the maximum will pass.  Whether or
   not exclusive filters are allowed can be specified when CDFexport is
   executed (if the default mode is not what is desired).

   If the filter setting is enclosed in parenthesis, then overall filtering
   is currently disabled.  Overall filtering must be enabled for any filtering
   to occur.  Overall filtering is selected on the OptionMenu.


The following functions are supported...

   Modify:   Selects the currently highlighted field for modification.  If
             a minimum or maximum field is highlighted, a prompt will be
             displayed for the new minimum or maximum value.  If a `filter'
             field is highlighted, the value will be cycled through the
             possible values described above (and overall filtering will be
             enabled if it was disabled).

   Part 3:   Change to part 3 of the SelectionWindow.

   Options:  Displays the OptionMenu.  The OptionMenu allows the modification
             of various settings which affect how items/variables are exported.

   Actions:  Displays the ActionMenu.  The ActionMenu allows the various
             exports to be generated (eg. screen/file listings and new CDFs) 
             as well as "block" changes to the fields in the SelectionWindow.

   Reverse:  Reverse the line containing the currently highlighted field with
             the following line (or the first line if at the last line).  The
             order of the lines in the SelectionWindow determines the order
             of the items/variables in the exports.

   Delete:   Deletes (empties) the currently highlighted field.  Note that not
             all fields can be deleted (emptied).
            
   Help:     Displays this online help.

   Exit:     Exit the CDF.

The keys associated with each of these functions are defined in the
KeyDefinitions window.
#endsection

#section 5
#item
#title "SelectionWindow, part 3"
This is online help for part 3 of the SelectionWindow.  The SelectionWindow
consists of three parts and is used to select the items/variables to be
exported and/or filtered.  Part 3 of the SelectionWindow contains columns
for the item/variable name, fill value, monotonicity, format, and width...

   The item/variable column will contain either `Record', `Indices', or
   a variable name.  `Record' allows the record number to be exported
   or filtered.  `Indices' allows the dimension indices to be exported
   or filtered but only in those cases where the dimensionality of each
   variable being exported or filtered is the same.

   The fill value for a variable is the value which was used to indicate
   missing/invalid data.  When filtering a variable's values, a value equal
   to the fill value will always pass the filters regardless of whether or
   not the value is within the minimum/maximum filter range.

   The monotonicity field indicates if a variable is strictly increasing,
   decreasing, or neither.  Monotonicity only applies to variables which
   vary along just one dimension.  Records are considered another dimension
   when dealing with monotonicity.  Correctly setting the monotonicity of
   a variable being filtered can significantly improve the performance of
   CDFexport.  The following monotonicities are possible...

      Increase      The variable's values strictly increase along the one
                    dimension.
      Decrease      The variable's values strictly decrease along the one
                    dimension.
      False         The variable is not monotonic.
      ?             The variable's monotonicity is unknown.
      (n/a)         The variable varies along zero or more than one dimension.

   The format field contains a C, Fortran, or custom EPOCH format (or may
   be empty).

      For variables not of type CDF_EPOCH, the C or Fortran format will be
      used when encoding the variable's values in a screen or file listing.
      If this field is empty, a default format will be used depending on the
      variable's data type.

      The setting of the EPOCH style on the OptionMenu determines how this
      format will be used. For variables of type CDF_EPOCH, a custom EPOCH
      format may also be specified as described in the documentation for
      `EPOCHx'.  If the EPOCH style is the standard style or one of the
      alternate styles, this format is ignored and will be enclosed in
      parenthesis.  Otherwise, the C, Fortran, or custom EPOCH format will
      be used as appropriate (unless this field is empty in which case a
      default format will be used).

   The width field contains the number of characters to be used for each
   variable value in a screen or file listing.  This width is generally
   initially set based on the format field.  Modifying this width allows
   the columns of a listing to be adjusted as desired.


The following functions are supported...

   Modify:   Selects the currently highlighted field for modification.  If
             a fill value, format, or width field is highlighted, a prompt
             will be displayed for the new value.  If a `monotonicity' field
             is highlighted, the value will be cycled through the possible
             values described above.

   Part 1:   Change to part 1 of the SelectionWindow.

   Options:  Displays the OptionMenu.  The OptionMenu allows the modification
             of various settings which affect how items/variables are exported.

   Actions:  Displays the ActionMenu.  The ActionMenu allows the various
             exports to be generated (eg. screen/file listings and new CDFs) 
             as well as "block" changes to the fields in the SelectionWindow.

   Reverse:  Reverse the line containing the currently highlighted field with
             the following line (or the first line if at the last line).  The
             order of the lines in the SelectionWindow determines the order
             of the items/variables in the exports.

   Delete:   Deletes (empties) the currently highlighted field.  Note that not
             all fields can be deleted (emptied).
            
   Help:     Displays this online help.

   Exit:     Exit the CDF.

The keys associated with each of these functions are defined in the
KeyDefinitions window.
#endsection

#section 6
#item
#title "ActionMenu"
The ActionMenu allows a variety of actions to be performed.  The following
actions are supported...

  Export to ASCII/screen

     Displays on the screen an ASCII listing based on the selections in
     the three parts of the SelectionWindow and the options selected on
     the OptionMenu.

  Export to ASCII/file...

     Writes to a file an ASCII listing based on the selections in the three
     parts of the SelectionWindow and the options selected on the OptionMenu.
     Before the listing begins, a prompt will be displayed for the pathname
     of the listing file.

  Export to CDF...

     Creates a new CDF based on the selections in the three parts of the
     SelectionWindow and the options selected on the OptionMenu.  Before the
     output begins, a prompt will be displayed for the pathname of the new
     CDF.

  Output all items/variables

     Changes the output setting of each item/variable to `YES'.

  Output no items/variables

     Changes the output setting of each item/variable to `no'.

  Filter all items/variables

     Changes the filter setting of each item/variable to `YES/YeS/yEs'
     (depending on whether or not exclusive filters are allowed) but
     only if a minimum and/or maximum filter value exists.

  Filter no items/variables

     Changes the filter setting of each item/variable to `no'.

  Save settings

     Saves the current settings in the SelectionWindow(s) and on the
     OptionMenu (to a file named `export.set').

  Restore settings

     Restores the settings in the SelectionWindow(s) and on the OptionMenu
     to those values that were previously saved.

  Set monotoniticities

     Sets the monotonicity of each variable.  Note that this can be time
     consuming for large CDFs.  Properly set monotonicities can greatly
     improve filtering efficiency.

  OptionMenu...

     Displays the OptionMenu.

The following functions are supported...

   Select:   Performs the currently highlighted action.

   Help:     Displays this online help.

   Exit:     Exits the ActionMenu.

The keys associated with each of these functions are defined in the
KeyDefinitions window.
#endsection

#section 7
#item
#title "OptionMenu"
The OptionMenu allows the selection of various options which affect the
operation of CDFexport.  The following options are supported...

  Use filters: [yes|no]

     Whether or not any filtering is performed.  This overrides the filter
     settings on part 2 of the SelectionWindow.

  Use fill values: [yes|no]

     Whether or not the fill values on part 3 of the SelectionWindow are to
     be used when filtering.

  Create [single-file | multi-file] CDFs

     If single-file or multi-file CDFs should be created when exporting to
     a CDF.

  Create [host-encoded | network-encoded] CDFs

     If host-encoded or network-encoded CDFs should be created when exporting
     to a CDF.

  EPOCH style: [standard | alternate/1 | alternate/2 | alternate/3 |
                Format/C_Fortran | Format/custom]

     The style to use when encoding a value for a variable having the
     CDF_EPOCH data type.  The supported styles are...

        standard             dd-mon-yyyy hh:mm:ss.ccc
        alternate/1          yyyymmdd.ttttttt
        alternate/2          yyyymoddhhmmss
        alternate/3          yyyy-mo-ddThh:mm:ss.cccZ
        Format/C_Fortran     Encoded double-precision floating-point value
                             using the C or Fortran format specification.
        Format/custom        Encoded using the custom format as described
                             for EPOCHx.

  [Vertical | Horizontal] listings

     Produce screen/file listings in a vertical or horizontal mode.  Vertical
     listings are affected by the dimensionalities of the variables.  Each
     type of listing is described as follows...

        Vertical listing, variables having the same dimensionality...

           Each line of the listing corresponds to a record/indices
           combination.  The indices are incremented according to the
           selected majority.  For example, assume each variable has
           a dimensionality of 2:[2,3].  A listing of the first two
           records assuming row-majority would be...

              Record   Indices   Variable1   Variable2   Variable3
             ------------------------------------------------------
              1        [1,1]        1(1,1)      1(1,1)      1(1,1)
              1        [1,2]        1(1,2)      1(1,2)      1(1,2)
              1        [1,3]        1(1,3)      1(1,3)      1(1,3)
              1        [2,1]        1(2,1)      1(2,1)      1(2,1)
              1        [2,2]        1(2,2)      1(2,2)      1(2,2)
              1        [2,3]        1(2,3)      1(2,3)      1(2,3)
              2        [1,1]        2(1,1)      2(1,1)      2(1,1)
              2        [1,2]        2(1,2)      2(1,2)      2(1,2)
              2        [1,3]        2(1,3)      2(1,3)      2(1,3)
              2        [2,1]        2(2,1)      2(2,1)      2(2,1)
              2        [2,2]        2(2,2)      2(2,2)      2(2,2)
              2        [2,3]        2(2,3)      2(2,3)      2(2,3)

           ...where r(x1,x2) is the value at record `r' and dimension
           indices `x1,x2' for a variable.

        Vertical listing, variables having different dimensionalities...

           A variable's values at a particular record are displayed one
           per line according to the selected majority.  The number of
           lines corresponding to a record depends on the variable having
           the most values per record.  Because one or more of the other
           variable will have fewer values per record there will be blanks
           for those variables after their last values.  For example,
           assume there are variables having dimensionalities of 0:[],
           1:[4], and 2:[2,3].  A listing of the first two records assuming
           column-majority would be...

                   Record   Variable1   Variable2   Variable3
                  --------------------------------------------
                   1              1()        1(1)      1(1,1)
                   1                         1(2)      1(2,1)
                   1                         1(3)      1(1,2)
                   1                         1(4)      1(2,2)
                   1                                   1(1,3)
                   1                                   1(2,3)
                   2              2()        2(1)      2(1,1)
                   2                         2(2)      2(2,1)
                   2                         2(3)      2(1,2)
                   2                         2(4)      2(2,2)
                   2                                   2(1,3)
                   2                                   2(2,3)

           ...where r() is the value at record `r' for Variable1, r(x1) is
           the value at record `r' and dimension index `x1' for Variable2,
           and r(x1,x2) is the value at record `r' and dimension indices
           `x1,x2' for Variable3.

        Horizontal listing...

           Each line of the listing corresponds to a record.  All of the
           values for a variable at that record are displayed from left
           to right according to the selected majority.  For example,
           assume there are variables having dimensionalities of 0:[],
           1:[2], and 2:[2,2].  A listing of the first 9 records assuming
           row-majority would be...

             Record  Variable1  Variable2           Variable3
            -----------------------------------------------------------
                  1     1()     1(1) 1(2)  1(1,1) 1(1,2) 1(2,1) 1(2,2)
                  2     2()     2(1) 2(2)  2(1,1) 2(1,2) 2(2,1) 2(2,2)
                  3     3()     3(1) 3(2)  3(1,1) 3(1,2) 3(2,1) 3(2,2)
                  4     4()     4(1) 4(2)  4(1,1) 4(1,2) 4(2,1) 4(2,2)
                  5     5()     5(1) 5(2)  5(1,1) 5(1,2) 5(2,1) 5(2,2)
                  6     6()     6(1) 6(2)  6(1,1) 6(1,2) 6(2,1) 6(2,2)
                  7     7()     7(1) 7(2)  7(1,1) 7(1,2) 7(2,1) 7(2,2)
                  8     8()     8(1) 8(2)  8(1,1) 8(1,2) 8(2,1) 8(2,2)
                  9     9()     9(1) 9(2)  9(1,1) 9(1,2) 9(2,1) 9(2,2)

           ...where r() is the value at record `r' for Variable1, r(x1) is
           the value at record `r' and dimension index `x1' for Variable2,
           and r(x1,x2) is the value at record `r' and dimension indices
           `x1,x2' for Variable3.

  CDF/listing majority: [row|column|input]

     When exporting to a CDF, if a row-major, column-major, or input-major
     CDF should be created.  When exporting to a screen/file listing, if the
     indices/values should be incremented with row-majority, column-majority,
     or input-majority.  Input-majority is the majority of the input CDF.

  Show filtered lines: [yes|no]

     When exporting to a screen/file listing, whether or not the lines which
     are filtered out are shown.  A value filtered out on a listing is shown
     as dashes (eg. `--------').  If a value being filtered out will cause
     an entire line (or set of lines) of a listing to be filtered out depends
     on the type of listing as follows...

        Vertical listing, variables having the same dimensionality...

           If a value on a line fails a filter, then the entire line will be
           filtered out.

        Vertical listing, variables having different dimensionalities...

           If a scalar variable fails a filter, then all of the lines for the
           corresponding record will be filtered out.

        Horizontal listing...

           If a scalar variable fails a filter, then the entire line will be
           filtered out.

     These listing types are described above.

  Item/variable spacing: [0,1,...]

     When exporting to a screen/file listing, the number of spaces between
     items/variables.

  Delete existing CDF: [yes|no]

     Whether or not an existing CDF should be deleted if a new CDF is being
     created with the same name.

  Preallocate records: [yes|no]

     Whether or not the variable records for a new CDF being created should
     be preallocated.  This takes additional time but results in a CDF that
     contains less indexing overhead.

The following functions are supported...

   Toggle:     Toggles the value of the currently highlighted option.

   Increment:  Increments the value of the currently highlighted option.
               Note that not all options may be incremented.

   Decrement:  Decrements the value of the currently highlighted option.
               Note that not all options may be decremented.

   Help:       Displays this online help.

   Exit:       Exits the OptionMenu.  Any changes made will be in affect.

The keys associated with each of these functions are defined in the
KeyDefinitions window.
#endsection

#section 8
#item
#title "Minimum/Maximum Record Prompt"
Enter a new minimum/maximum record number for filtering.  Note that the
minimum record number must not be greater than the maximum record number.
This may affect the order in which you must specify new minimum and maximum
record numbers.  For example, if the current minimum/maximum record numbers
are 23/45 and you would like them to be 5/8, then you would have to first
change the minimum record number.  If you changed the maximum record number
first the intermediate state of 23/8 would occur (which is illegal).

The following functions are supported...

   Enter:      Changes the minimum/maximum record number to the value entered.

   Help:       Displays this online help.

   Exit:       Exits without changing the minimum/maximum record number.

The keys associated with each of these functions are defined in the
KeyDefinitions window.
#endsection

#section 9
#item
#title "Minimum/Maximum Indices Prompt"
Enter new minimum/maximum dimension indices for filtering.  Note that
filtering on dimension indices is only allowed if the variables being output
or filtered have the same dimensionalities.

The syntax of dimension indices is `[<dim1>,<dim2>,...,<dimN>]'.  Examples
would be `[4]', `[1,1]', and `[3,55,101]'.  Note that `[]' is allowed for
0-dimensional variables but has no real affect.

The following functions are supported...

   Enter:      Changes the minimum/maximum dimension indices to the values
               entered.

   Help:       Displays this online help.

   Exit:       Exits without changing the minimum/maximum dimension indices.

The keys associated with each of these functions are defined in the
KeyDefinitions window.
#endsection

#section 10
#item
#title "Minimum/Maximum Value Prompt"
Enter a new minimum/maximum variable value for filtering.  Note that the
minimum value must not be greater than the maximum value.  This may affect
the order in which you must specify new minimum and maximum values.  For
example, if the current minimum/maximum values are 230.5/456.0 and you would
like them to be 3.22/9.99, then you would have to first change the minimum
value.  If you changed the maximum value first the intermediate state of
230.5/9.99 would occur (which is illegal).

The following functions are supported...

   Enter:      Changes the minimum/maximum variable value.

   Help:       Displays this online help.

   Exit:       Exits without changing the minimum/maximum variable value.

The keys associated with each of these functions are defined in the
KeyDefinitions window.
#endsection

#section 11
#item
#title "Fill Value Prompt"
Enter a new variable fill value for filtering.

The following functions are supported...

   Enter:      Changes the variable fill value.

   Help:       Displays this online help.

   Exit:       Exits without changing the variable fill value.

The keys associated with each of these functions are defined in the
KeyDefinitions window.
#endsection

#section 12
#item
#title "Format Prompt"
Enter a new variable value format for ASCII listings.

The following functions are supported...

   Enter:      Changes the variable value format.

   Help:       Displays this online help.

   Exit:       Exits without changing the variable value format.

The keys associated with each of these functions are defined in the
KeyDefinitions window.
#endsection

#section 13
#item
#title "Width Prompt"
Enter a new item/variable width for ASCII listings.

The following functions are supported...

   Enter:      Changes the item/variable width to the value entered.

   Help:       Displays this online help.

   Exit:       Exits without changing the item/variable width.

The keys associated with each of these functions are defined in the
KeyDefinitions window.
#endsection

#section 14
#item
#title "Screen Listing"
A screen listing is displayed one page at a time.  After each page a prompt
is issued for the next action to be taken.

The following functions (actions) are supported...

   More:        Displays the next page of the listing.

   Continuous:  Displays pages of the listing as quickly as possible
                without prompting after each page.  The `stop' key may
                be used to stop the continuous display and return to
                prompting after each page.

   Help:        Displays this online help.

   Exit:        Exits the listing.

The keys associated with each of these functions are defined in the
KeyDefinitions window.
#endsection

#section 15
#item
#title "Listing File"
Enter a pathname (absolute or relative) for the listing file.  You must
explicitly specify the file extension (there is not a default).

The following functions are supported...

   Enter:      Accepts the pathname entered and begins the listing.

   Help:       Displays this online help.

   Exit:       Exits without creating a listing.

The keys associated with each of these functions are defined in the
KeyDefinitions window.
#endsection

#section 16
#item
#title "Output CDF"
Enter a pathname (absolute or relative) for the output CDF.  Do not specify
an extension - the default CDF file extensions will be used.

The following functions are supported...

   Enter:      Accepts the pathname entered and begins the creation of the
               output CDF.

   Help:       Displays this online help.

   Exit:       Exits without creating an output CDF.

The keys associated with each of these functions are defined in the
KeyDefinitions window.
#endsection

#section 99
#edit
#title "Command Line Parameters/Qualifiers/Options"
#ifos mac
CDFexport allows the contents of a CDF to be exported to a variety of formats.
The parameters/qualifiers dialog box displayed when CDFexport is `executed'
contains the following controls.

Edit fields for...

  CDF:              The specification of the CDF(s) to be exported (do not
                    enter an extension).  This may be either a single CDF
                    pathname or a folder/wildcard path.  Wildcards are
                    allowed in the CDF name but not in the folder path.

                    At the end of this field a button labeled "Select" is
                    present.  When "Select" is selected, a standard input
                    file dialog is displayed from which the CDF may be
                    selected.

  Cache size:       The number of 512-byte buffers to be used for a CDF's
                    `.cdf' file (ie., the only file if a single-file CDF).
                    If this field is left blank, a default cache size chosen
                    by the CDF library is used.

Check boxes for...

  -0.0 to 0.0:      Whether or not -0.0 is converted to 0.0 by the CDF
                    library when read from or written to a CDF.

  Report info's:    Whether or not informational status codes from the CDF
                    library should be reported.

  Report warnings:  Whether or not warning status codes from the CDF library
                    should be reported.

  Report errors:    Whether or not error status codes from the CDF library
                    should be reported.

  Outputs enabled:  Whether or not each item/variable is initially output.

  Filters enabled:  Whether or not each item/variable is initially filtered.

  Use fills:        Whether or not the use of fill values is enabled on the
                    OptionMenu.

  Use FORMAT:       Whether or not a variable's FORMAT attribute entry is
                    used as its initial `format'.

  Use FILLVAL:      Whether or not a variable's FILLVAL attribute entry is
                    used as its initial `fill value'.

  Use VALIDMIN:     Whether or not a variable's VALIDMIN attribute entry is
                    used as its initial minimum filter value.

  Use VALIDMAX:     Whether or not a variable's VALIDMAX attribute entry is
                    used as its initial maximum filter value.

  Use MONOTON:      Whether or not a variable's MONOTON attribute entry is
                    used as its initial monotonicity.

  Show `Record':    Whether or not the `Record' item is shown in the
                    SelectionWindow.

  Show `Indices':   Whether or not the `Indices' item is shown in the
                    SelectionWindow.

  Exclusive filters:

                    Whether or not exclusive filters are allowed.

  Display statistics:

                    Whether or not caching statistics are displayed when
                    a CDF (input or output) is closed.

  Delete existing CDF:

                    The initial setting on the OptionMenu as to whether or
                    not an existing CDF will be deleted when a new CDF is
                    created with the same name.

  Preallocate records:

                    The initial setting on the OptionMenu as to whether
                    or not variable records are to be preallocated when
                    creating a new CDF.

Radio buttons for...

  zMode:            The zMode to be used for CDFs being exported from.

                         0...zMode is disabled.
                         1...zMode/1 should be used.  The dimension
                             variances of the rVariables will be preserved.
                         2...zMode/2 should be used.  The dimensions of
                             rVariables having a variance of NOVARY (false)
                             are hidden.

  New format:       Whether single-file or multi-file CDFs are selected on
                    the OptionMenu.

  New encoding:     Whether host-encoded or network-encoded CDFs are
                    selected on the OptionMenu.

  Majority:         Whether row-major, column-major, or input-major
                    CDFs/listings are selected on the OptionMenu.
                    Input-major is the majority of the input CDF

  EPOCH style:      The EPOCH encoding style selected on the OptionMenu.

  Orientation:      Whether horizontal or vertical listings are selected
                    on the OptionMenu.

Buttons for...

  Enter             Causes CDFexport to export from CDF(s) based on the
                    parameters/qualifiers specified.

  Help              Causes this online help to be displayed.

  Quit              Causes CDFexport to terminate.
#else
#ifos vms
Usage:         $ CDFEXPORT [/INITIAL=(<options>)] [/[NO]NEG2POSFP0]
                           [/ZMODE=<mode>] [/REPORT=(<types>)] [/[NO]PROMPT]
                           [/CACHE=<size>] [/[NO]STATISTICS] <cdf-spec>
#endos
#ifos unix
Usage:         % cdfexport [-initial "<options>"] [-[no]neg2posfp0]
                           [-zmode <mode>] [-report "<types>"] [-[no]prompt]
                           [-cache <size>] [-[no]statistics] <cdf-spec>
#endos
#ifos dos
Usage:         > cdfexport [-initial "<options>"] [-[no]neg2posfp0]
                           [-zmode <mode>] [-report "<types>"] [-[no]prompt]
                           [-cache <size>] [-[no]statistics] <cdf-spec>
#endos

Purpose:       CDFexport allows the contents of a CDF to be exported to a
               variety of formats.

Parameter(s):  <cdf-spec>
                  The specification of the CDF(s) from which to export (do
                  not specify an extension).  This may be either a single
                  CDF pathname or a directory/wildcard path.  Wildcards are
                  allowed in the CDF name but not in the directory path.  If
                  the `prompt' qualifier is used, <cdf-spec> will appear as
                  the initial specification at the "CDF(s) Specification"
                  prompt.  If this parameter is omitted the `prompt' qualifier
                  must be specified (and the initial specification at the
                  "CDF(s) Specification" prompt will be all CDFs in the
                  current directory).

#ifos vms
Qualifier(s):  /[NO]PROMPT
#else
Qualifier(s):  -[no]prompt
#endos
                  If this qualifier is specified along with the <cdf-spec>
                  parameter, the "CDF(s) Specification" prompt will be
                  displayed with <cdf-spec> as the initial specification.
                  If this qualifier is specified without the <cdf-spec>
                  parameter, the "CDF(s) Specification" prompt will be
                  displayed with all CDFs in the current directory as the
                  initial specification.  If this qualifier is not specified,
                  the <cdf-spec> parameter is required and is automatically
                  opened.

#ifos vms
               /INITIAL=(<options>)
#else
               -initial "<options>"
#endos
                  This qualifier is used to specify a variety of initial
                  options to be used when a CDF is opened.  <options> is a
                  comma-separated list of one or more of the following...

                     [no]filter             Whether or not each item/variable
                                            is initially filtered.

                     [no]fills              Whether or not the use of
                                            fill values is enabled on the
                                            OptionMenu.

                     [no]format             Whether or not a variable's
                                            FORMAT attribute entry is used
                                            as its initial `format'.

                     [no]fillval            Whether or not a variable's
                                            FILLVAL attribute entry is used
                                            as its initial `fill value'.

                     [no]validmin           Whether or not a variable's
                                            VALIDMIN attribute entry is used
                                            as its initial minimum filter
                                            value.

                     [no]validmax           Whether or not a variable's
                                            VALIDMAX attribute entry is used
                                            as its initial maximum filter
                                            value.

                     [no]monoton            Whether or not a variable's
                                            MONOTON attribute entry is used
                                            as its initial monotonicity.

                     [no]record             Whether or not the `Record' item
                                            is shown in the SelectionWindow.

                     [no]indices            Whether or not the `Indices' item
                                            is shown in the SelectionWindow.

                     [no]exclusive          Whether or not exclusive filters
                                            are allowed.

                     [no]output             Whether or not each item/variable
                                            is initially output.

                     [no]delete             The initial setting on the
                                            OptionMenu as to whether or
                                            not an existing CDF will be
                                            deleted when a new CDF is
                                            created with the same name.

                     [no]preallocate        The initial setting on the
                                            OptionMenu as to whether or
                                            not variable records are to be
                                            preallocated when creating a
                                            new CDF.

                     single | multi         Whether single-file or multi-file
                                            CDFs are selected on the
                                            OptionMenu.

                     host | network         Whether host-encoded or
                                            network-encoded CDFs are
                                            selected on the OptionMenu.

                     row | column |         Whether row-major, column-major,
                     (neither)              or input-major CDFs/listings are
                                            selected on the OptionMenu.
                                            Input-major is the majority of
                                            the input CDF (and is requested
                                            by specifying neither `row' nor
                                            `column').

                     epoch | epoch1 |       The EPOCH encoding style selected
                     epoch2 | epoch3 |      on the OptionMenu.
                     epochf | epochx

                     horizontal | vertical  Whether horizontal or vertical
                                            listings are selected on the
                                            OptionMenu.

                  Note that the options selected for the OptionMenu can be
                  changed at any time after the CDF has been opened.  If this
                  qualifier is not specified, each of these options has a
                  default setting.

#ifos vms
               /ZMODE=<mode>
#else
               -zmode <mode>
#endos

                  Specifies which zMode should be used for CDFs being exported
                  from.  <mode> may be one of the following...

                     0       Indicates that zMode is disabled.
                     1       Indicates that zMode/1 should be used (the
                             dimension variances of rVariables will be
                             preserved).
                     2       Indicates that zMode/2 should be used (the
                             dimensions of rVariables having a variance
                             of NOVARY (false) are hidden.

#ifos vms
               /[NO]NEG2POSFP0
#else
               -[no]neg2posfp0
#endos
                  Specifies whether or not -0.0 is converted to 0.0 by the
                  CDF library when read from or written to a CDF.  -0.0 is
                  an illegal floating point value on VAXes and DEC Alphas
                  running OpenVMS.

#ifos vms
               /REPORT=(<types>)
#else
               -report "<types>"
#endos
                  Specifies the types of return status codes from the CDF
                  library which should be reported/displayed.  <types> is
                  a comma-separated list of zero or more of the following
                  symbols: `errors', `warnings', or `informationals'.  Note
                  that these symbols can be truncated (eg. `e', `w', and `i').

#ifos vms
               /CACHE=<size>
#else
               -cache <size>
#endos
                  Specifies the cache size to be used for the CDF's `.cdf'
                  file (ie., the only file if a single-file CDF).  If omitted,
                  a default cache size as chosen by the CDF library is used.
                  The cache size is the number of 512-byte buffers to be used.

#ifos vms
               /[NO]STATISTICS
#else
               -[no]statistics
#endos
                  Whether or not caching statistics are displayed when a CDF
                  (input or output) is closed.

#ifos vms
Example(s):    $ CDFEXPORT [.SAMPLES]
               $ CDFEXPORT/ZMODE=2/CACHE=50 GISS_WETLX
               $ CDFEXPORT/PROMPT/REPORT=(W,E)/INITIAL=(EXCLUSIVE,NOFORMAT)
#endos
#ifos unix
Example(s):    % cdfexport samples
               % cdfexport -zmode 2 -cache 50 giss_wetl
               % cdfexport -prompt -report "w,e" -initial "exclusive,noformat"
#endos
#ifos dos
Example(s):    > cdfexport samples
               > cdfexport -zmode 2 -cache 50 giss_wetl
               > cdfexport -prompt -report "w,e" -initial "exclusive,noformat"
#endos
#endos
#endsection
