HP 3000 Manuals

Ap C. File Status [ Micro Focus COBOL Language Reference ] MPE/iX 5.0 Documentation


Micro Focus COBOL Language Reference

Appendix C  File Status 

ANSI File Status Summary 

See the chapter Program Definition and your COBOL System Reference  for
more details.

ANSI'74 File Status Codes 

Status Status              Description 
key 1  key 2 

----------------------------------------------------

  0      0    Successful completion

         2    , Indexed files only.  One of two
              possibilities:

              a.  For a READ statement, the key
              value for the current key is equal to
              the value of that same key in the next
              record within the current key of
              reference.

              b.  For a WRITE or REWRITE statement,
              the record just written created a
              duplicate key value for at least one
              alternate record key for which
              duplicates are allowed.

  1      0    , There is no next logical record.
              You have reached the end of the file.

Status Status              Description 
key 1  key 2 
----------------------------------------------------

  2      1    For sequentially accessed files only.
              Indicates a sequence error.  The
              ascending key requirement of
              successive record key values has been
              violated,, or,, the prime record key
              value has been changed by a COBOL
              program between successful execution
              of a READ statement and the execution
              of the next REWRITE statement for that
              file.

         2    Relative and indexed files only.
              Indicates a duplicate key value.  An
              attempt has been made to write or
              rewrite a record that would create a
              duplicate key in a relative or indexed
              file.

         3    Indicates no record found.  An attempt
              has been made to access a record,,
              indentified by a key,, and that record
              does not exist in the file.

  3      0    The input-output statement was
              unsuccessfully executed as the result
              of a boundary violation for a
              sequential file or as the result of an
              input-output error,, such as a data
              check parity error,, or a transmission
              error.

         4    The input-output statement failed
              because of a boundary violation.  This
              condition indicates that an attempt
              has been made to write beyond the
              externally define d boundaries of a
              sequential file.

  9           Extended file Status Code

ANSI'85 File Status Codes 

ANSI'85 file status codes include all ANSI'74 together with the following
status codes:

Status Status              Description 
key 1  key 2 

----------------------------------------------------

  0      4    The length of the record being
              processed does not conform to the
              fixed file attributes for that file.

         5    The referenced optional file is not
              present at the time the OPEN statement
              is executed.

         7    Sequential files only.  For a CLOSE
              statement with the REEL/UNIT phrase
              the referenced file is a non-reel/unit
              medium.

  1      4    Relative files only.  The number of
              significant digits in the relative
              record number is larger than the size
              of the relative key data item
              described for that file.

  2      2    For indexed and relative files only,,
              indicates a duplicate key condition.
              An attempt has been made to store a
              record that would create:  a duplicate
              key in the indexed or relative file or
              a duplicate alternate record key for a
              file that does not allow duplicates.

         3    The conditions listed under ANSI'74
              code "23".  In addition,, a START or
              READ statement has been attempted on
              an optional input file that is not
              present

         4    Relative and indexed files only:
              Indicates a boundary violation arising
              from one of the following conditions:

              a.  An atttempt has been made to write
              beyond the externally defined
              boundaries of a file.

Status Status              Description 
key 1  key 2 

----------------------------------------------------

              b.  A sequential WRITE statement is
              attempted for a relative file,, but
              the number of significant digits in
              the relative record number is larger
              than the size of the relative key data
              item described for the file.

  3      5    An OPEN statement with the I-O, INPUT,
              or EXTEND phrases has been attempted
              on a nonOPTIONAL file that is not
              present.

         7    An OPEN statement has been attempted
              on a file which does not support the
              open mode specified in the OPEN
              statement.

         8    An OPEN statement has been attempted
              on a file previously closed with a
              lock.

         9    A conflict has been detected between
              the fixed file attributes specified
              for that file in the program.

  4      1    An OPEN has been attempted on a file
              already opened.

         2    A CLOSE has been attempted on a file
              already closed.

         3    Files in sequential access mode:  the
              last I-O statement executed for the
              file,, prior to the execution of a
              DELETE or REWRITE statement,, was not
              a READ statement.

         4    A boundary violation exists.

         6    A sequential READ statement has been
              attempted on a file open in the INPUT
              or I-O mode but no valid next record
              has been established.

Status Status              Description 
key 1  key 2 

----------------------------------------------------

         7    A READ or START statement has been
              attempted on a file not opened INPUT
              or I-O.

         8    A WRITE statement has been attempted:
              on a file not opended in the OUTPUT,,
              I-O or EXTEND mode; or on a file open
              I-O in the sequential access mode.

         9    A DELETE or REWRITE statement has been
              attempted on a file that is not opened
              I-O.



MPE/iX 5.0 Documentation