#ifos mac
CDFconvert is used to convert one or more CDFs.  Conversions can be from
older releases of CDF (eg. Version 2.4 CDFs) to the current release and/or
to change the format, majority, or encoding.  The parameters/qualifiers
dialog box displayed when CDFconvert is `executed' contains the following
controls.

Edit fields for...

  Source:              The source CDF specification.  This can be either a
                       single CDF pathname or a folder/wildcard path in
                       which case all CDFs which match the specification will
                       be converted.  Wildcards are allowed in the CDF name
                       but not in the folder path.  In either case, do not
                       specify an extension.

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

  Destination:         The destination of the converted CDF(s).  This may be
                       a single CDF pathname only if the source specification
                       is a single CDF pathname.  If the folder paths are the
                       same, then a different CDF name must be specified.  If
                       more than one CDF is being converted, then this must be
                       a folder path (other than the source folder path).
                       This may also be a directory path if only one CDF is
                       being converted.  In any case, do not specify an
                       extension.

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

  Skeleton:            The pathname of a skeleton CDF to be used during the
                       conversions (do not enter an extension).  Specifying a
                       skeleton CDF is optional.  The skeleton CDF is used in
                       the following cases...

                         1. If a format for the destination CDF(s) was not
                            specified, then the format of the skeleton CDF
                            will be used.

                         2. If a majority for the destination CDF(s) was not
                            specified, then the majority of the skeleton CDF
                            will be used.

                         3. If an encoding for the destination CDF(s) was not
                            specified, then the encoding of the skeleton CDF
                            will be used.

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

Check boxes for...

  Log progress:        Whether or not progress messages are displayed.

  Display percentages: Whether or not the percentage of a variable's values
                       converted is displayed during the conversion of that
                       variable.  Progress message logging must also be
                       enabled.

  Delete existing:     Whether or not an existing CDF is deleted if a new
                       CDF with the same name is to be created.

  Page output:         Whether or not the output is displayed one page (screen)
                       at a time.

  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.

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

  Display statistics:  Whether or not caching statistics are displayed at the
                       end of each comparison of two CDFs.

Radio buttons for...

  Format:              The format of the destination CDF(s).
                            Source...the same as the source CDF (unless a
                                     skeleton CDF was specified).
                            Single...single-file.
                            Multi....multi-file.

  Majority:            The variable majority of the destination CDF(s).
                            Source...the same as the source CDF (unless a
                                     skeleton CDF was specified).
                            Row......row-major.
                            Column...column-major.

  Encoding:            The encoding of the destination CDF(s).
                            Source.......the same as the source CDF (unless a
                                         skeleton CDF was specified).
                            Host.........the host machine's encoding (ie.,
                                         Macintosh encoding).
                            Network......network encoding.
                            Sun..........Sun encoding.
                            VAX..........VAX encoding.
                            SGi..........SGi encoding.
                            HP...........HP encoding.
                            IBM PC.......IBM PC encoding.
                            IBM RS.......IBM RS encoding
                            Macintosh....Macintosh encoding.
                            DECstation...DECstation encoding.
                            NeXT.........NeXT encoding.
                            Alpha/VMSd...DEC Alpha/VMS D_FLOAT encoding.
                            Alpha/VMSg...DEC Alpha/VMS G_FLOAT encoding.
                            Alpha/OSF1...DEC Alpha/OSF1 encoding.

  zMode:               The zMode to be used for the source CDF(s).
                            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.

Buttons for...

  Enter                Causes CDFconvert to convert CDF(s) based on the
                       parameters/qualifiers specified.

  Help                 Causes this online help to be displayed.

  Quit                 Causes CDFconvert to terminate.  (No CDFs are
                       converted.)  This button is only present the
                       first time the parameters/qualifiers dialog box
                       is displayed.

  Cancel               Causes the parameters/qualifiers dialog box to
                       be closed.  (No CDFs are converted.)  This
                       button is only present after the first time the
                       parameters/qualifiers dialog box is displayed.
#else
#ifos vms
Usage:       $ CDFCONVERT [/SKELETON=<skt-cdf-path>] [/[NO]LOG]
                          [/[NO]PERCENT] [/REPORT=(<types>)]
                          [/CACHE=<size>] [/[NO]PAGE] [/[NO]STATISTICS]
                          <src-cdf-spec>
                             [/ZMODE=<mode>] [/[NO]NEG2POSFP0]
                          <dst-cdf-spec>
                             [/SINGLE | /MULTI] [/ROW | /COLUMN] [/[NO]DELETE]
                             [/HOST | /NETWORK | /ENCODING=<encoding>]
#endos
#ifos unix     
Usage:       % cdfconvert [-skeleton <skt-cdf-path>] [-[no]log]
                          [-[no]percent] [-report "<types>"]
                          [-cache <size>] [-[no]page] [-[no]statistics]
                          <src-cdf-spec>
                             [-zmode <mode>] [-[no]neg2posfp0]
                          <dst-cdf-spec>
                             [-single | -multi] [-row | -column] [-[no]delete]
                             [-host | -network | -encoding <encoding>]
#endos
#ifos dos
Usage:       > cdfconvert [-skeleton <skt-cdf-path>] [-[no]log]
                          [-[no]percent] [-report "<types>"]
                          [-cache <size>] [-[no]page] [-[no]statistics]
                          <src-cdf-spec>
                             [-zmode <mode>] [-[no]neg2posfp0]
                          <dst-cdf-spec>
                             [-single | -multi] [-row | -column]  [-[no]delete]
                             [-host | -network | -encoding <encoding>]
#endos

Purpose:       CDFconvert is used to convert one or more CDFs.  Conversions
               can be from older releases of CDF (eg. Version 2.4 CDFs) to
               the current release and/or to change the format, majority, or
               encoding.

Parameter(s):  <src-cdf-spec>
                  The source CDF(s).  This can be either a single CDF
                  pathname or a directory/wildcard path in which case all
                  CDFs which match the specification will be converted.
                  Wildcards are allowed in the CDF name but not in the
                  directory path.  In either case, do not specify an
                  extension.

               <dst-cdf-spec>
                  The destination of the converted CDF(s).  This may be
                  a single CDF pathname only if <src-cdf-spec> is a
                  single CDF pathname.  If the directory paths are the
                  same, then a different CDF name must be specified.  If
                  more than one CDF is being converted, this must be a
                  directory path (other than the source directory path).
                  This may also be a directory path if only one CDF
                  is being converted.  In any case, do not specify an
                  extension.

#ifos vms
Qualifier(s):  /SKELETON=<skt-cdf-path>
#else
Qualifier(s):  -skeleton <skt-cdf-path>
#endos
                  The pathname of a skeleton CDF to be used during the
                  conversions (do not enter an extension).  The skeleton
                  CDF is used in the following cases.

                    1. If a format for the destination CDF(s) was not
                       specified, then the format of the skeleton CDF will
                       be used.

                    2. If a majority for the destination CDF(s) was not
                       specified, then the majority of the skeleton CDF will
                       be used.

                    3. If an encoding for the destination CDF(s) was not
                       specified, then the encoding of the skeleton CDF will
                       be used.

                  Specifying a skeleton CDF is optional.

#ifos vms
               /[NO]LOG
#else
               -[no]log
#endos
                  Specifies whether or not messages are displayed
                  indicating the progress of a conversion.

#ifos vms
               /[NO]PERCENT
#else
               -[no]percent
#endos
                  Specifies whether or not the percentage of a variable
                  converted is displayed during the conversion of that
                  variable.  Message logging must also be enabled.

#ifos vms
               /[NO]PAGE
#else
               -[no]page
#endos
                  Specifies whether or not the output is displayed a page
                  at a time.

#ifos vms
               /ZMODE=<mode>
#else
               -zmode <mode>
#endos
                  Specifies which zMode should be used with the source CDF(s).
                  <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.

                  Note that using zMode/1 or zMode/2 on a source CDF which
                  contains rVariables will produce a destination CDF
                  containing only zVariables.  The zMode "view" provided
                  for the source CDF is written to the destination CDF
                  during the conversion.

#ifos vms
               /SINGLE | /MULTI
#else
               -single | -multi
#endos
                  The format of the destination CDF(s).  This overrides the
                  format of the skeleton CDF (if specified).  If neither
                  this qualifier nor a skeleton CDF is specified, then the
                  format of the destination CDF(s) will be the same as that
                  of the source CDF(s).

#ifos vms
               /ROW | /COLUMN
#else
               -row | -column
#endos
                  The majority of the destination CDF(s).  This overrides
                  the majority of the skeleton CDF (if specified).  If
                  neither this qualifier nor a skeleton CDF is specified,
                  then the majority of the destination CDF(s) will be the
                  same as that of the source CDF(s).

#ifos vms
               /HOST | /NETWORK | /ENCODING=<encoding>
#else
               -host | -network | -encoding <encoding>
#endos
                  The encoding of the destination CDF(s).  Specify only one
                  of these qualifiers.  This overrides the encoding of the
                  skeleton CDF (if specified).  If neither this qualifier nor
                  a skeleton CDF is specified, then the encoding of a
                  destination CDF will be the same as that of the source
#ifos vms
                  CDF.  The possible values of <encoding> are HOST,
                  NETWORK, SUN, VAX, DECSTATION, SGi, IBMPC, IBMRS,, HP,
                  NeXT, ALPHAOSF1, ALPHAVMSd, and ALPHAVMSg.

                  Note that /HOST and /NETWORK are no longer necessary
                  (but are supported for compatibility with previous CDF
                  distributions).
#else
                  CDF.  The possible values of <encoding> are `host',
                  `network', `sun', `vax', `decstation', `sgi', `ibmpc',
                  `ibmrs', `mac', `hp', `next', `alphaosf1', `alphavmsd',
                  and `alphavmsg'.

                  Note that `-host' and `-network' are no longer necessary
                  (but are  supported for compatibility with previous CDF
                  distributions).
#endos

#ifos vms
               /[NO]DELETE
#else
               -[no]delete
#endos
                  Specifies whether or not an existing CDF is deleted if
                  a new CDF with the same name is to be created.

#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
                  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' file
                  of both the source and destination CDF (ie., the only files
                  if they are both single-file CDFs).  If omitted, default
                  cache sizes as chosen by the CDF library are used.  The
                  cache size is the number of 512-byte buffers to be used.

#ifos vms
               /[NO]STATISTICS
#else
               -[no]statistics
#endos
                  Specifies whether or not caching statistics are displayed
                  at the end of each conversion.

#ifos vms
Example(s):    $ CDFCONVERT CDF$SMPL:TPLATE0 TEMPLATE0X/ENCODING=IBMPC
               $ CDFCONVERT/REPORT=(ERRORS) CDF$SMPL: USER_DISK:[USER.CDF]
               $ CDFCONVERT CAC_SST_BLENDED CAC_SST_BLENDEDX/SINGLE/NETWORK
               $ CDFCONVERT/SKELETON=CDF$SMPL:TPLATE3 CAC_SST_* [USER.CDF]
#endos
#ifos unix
Example(s):    % cdfconvert ../samples/tplate0 template0x -encoding ibmpc
               % cdfconvert -report "errors" ../samples/ /disk4/user/cdf/
               % cdfconvert cac_sst_blended cac_sst_1 -single -network
               % cdfconvert -skeleton tplate3 '../cdf/cac_sst_*' ~user/cdf
#endos
#ifos dos
Example(s):    > cdfconvert ..\samples\tplate0 tplate0x -encoding ibmpc
               > cdfconvert -report "errors" ..\samples c:\disk4\user\cdf
               > cdfconvert cac_sst cac_sst1 -single -network
               > cdfconvert -skeleton tplate3 ..\cac_sst* b:\user\cdf
#endos
#endos
