cobol1.hlp (Topic list)
CBL_WRITE_FILE Details (↑ Library of Routines)
 Key Summary                             Up Contents Index Back
────────────────────────────────────────────────────────────────────────────
 
  Description:
 
     See Introduction to Byte-Stream Routines
 
  Parameters on Entry:
 
     file-handle             The file handle returned when the file was
                             opened.
 
     file-offset             The offset in file at which to write. This
                             field is currently limited to a maximum value
                             of x"00FFFFFFFF".
 
     byte-count              The number of bytes to write. This field is
                             currently limited to a maximum value of
                             x"00FFFF".
 
                             Putting a value of zero in this field will
                             cause the file to be truncated or extended to
                             the size specified in the file-offset field.
 
     flags                   This parameter can take the following value:
 
                                 0 for standard write
 
     buffer                  The buffer from which the bytes are written.
                             It is your responsibility to ensure that the
                             buffer is large enough to hold the number of
                             bytes to be written.
 
                             The buffer parameter is allowed to cross a 64K
                             segment boundary.
 
  Parameters on Exit:
 
     None
                                    -♦-