Index Page dskopn_c

A B C D E F G H I J K L M N O P Q R S T U V W X

Procedure Abstract Required_Reading Keywords Brief_I/O Detailed_Input | Detailed_Output Parameters Exceptions Files Particulars Examples | Restrictions Literature_References Author_and_Institution Version Index_Entries

#### Procedure

       void dskopn_c ( ConstSpiceChar  * fname,
                       ConstSpiceChar  * ifname,
                       SpiceInt          ncomch,
                       SpiceInt       *  handle )

#### Abstract

       Open a new DSK file for subsequent write operations.

#### Required_Reading

       DAS
       DSK

#### Keywords

       DAS
       DSK
       FILES

#### Brief_I/O

       Variable  I/O  Description
       --------  ---  --------------------------------------------------
       fname      I   Name of a DSK file to be opened.
       ifname     I   Internal file name.
       ncomch     I   Number of comment characters to allocate.
       handle     O   Handle assigned to the opened DSK file.

#### Detailed_Input

       fname       is the name of a new DSK file to be created.  The
                   file will be left opened for write access.

       ifname      is the internal file name for the new file.  The name
                   may contain as many as 60 characters.  All characters
                   of `ifname' should be printing characters (ASCII codes
                   32-126 decimal). This name should uniquely identify
                   the file.

       ncomch      is the number of comment characters to allocate.
                   Allocating comment characters at file creation time
                   may reduce the likelihood of having to expand the
                   comment area later.

#### Detailed_Output

       handle      is the file handle associated with the file. This
                   handle is used to identify the file in subsequent
                   calls to other DSK routines.

#### Parameters

       None.

#### Exceptions

       1) If the input filename is blank, the error will be diagnosed by
          routines in the call tree of this routine.  No file will be
          created.

       2) If the specified file cannot be opened without exceeding
          the maximum allowed number of open DAS files, the error
          will be diagnosed by routines in the call tree of this
          routine.  No file will be created.

       3) If the file cannot be opened properly, the error will be
          diagnosed by routines in the call tree of this routine.  No
          file will be created.

       4) If the initial records in the file cannot be written, the
          error is diagnosed by routines in the call tree of this
          routine.  No file will be created.

       5) If no logical units are available, the error will be diagnosed
          by routines in the call tree of this routine. No file will be
          created.

       6) If the internal file name contains nonprinting characters (ASCII
          codes decimal 0-31 and 127-255), the error will be diagnosed
          by routines in the call tree of this routine.  No file will be
          created.

       7) If the number of comment characters allocated NCOMCH is
          negative, the error will be diagnosed by routines in the call
          tree of this routine.  No file will be created.

#### Files

       See argument FNAME.

#### Particulars

       DSK files are built using the DLA low-level format and
       the DAS architecture; DLA files are a specialized type of DAS
       file in which data are organized as a doubly linked list of
       segments.  Each segment's data belong to contiguous components of
       character, double precision, and integer type.

       This routine creates a new DSK file and sets the type of the
       file to the mnemonic code passed to it.

       DSK files created by this routine have initialized file records.
       The ID word in a DSK file record has the form

          DAS/DSK

       where the characters following the slash are supplied by the
       caller of this routine.

#### Examples

       1)  Create a new DSK file, using an internal file name that
           attempts to serve as an unique identifier.  No room for
           comments will be reserved.

              fname  =  "TEST.DSK";
              ifname =  "TEST.DSK/NAIF/NJB/20-OCT-2006/14:37:00";
              ncomch =   0;

              dskopn_c ( fname, ifname, ncomch, &handle );

#### Restrictions

       None.

#### Literature_References

       None.

#### Author_and_Institution

       N.J. Bachman    (JPL)

#### Version

       -CSPICE Version 1.0.1, 23-JAN-2016 (NJB)

          Corrected spelling errors in comments.

       -DSKLIB_C Version 1.0.0, 12-FEB-2010 (NJB)

#### Index_Entries

       open a new dsk file
       open a new dsk file with write access

#### Link to routine dskopn_c source file dskopn_c.c

    Wed Apr  5 17:54:32 2017