FILEIO Subroutine

Output a string value to a file.

call WriteWord(FILE_ID_IV, SOURCE_IV)

FILE_ID_FID

A integer variable for the file id.

SOURCE_IV

An integer variable from which the low order word will be written to the file.

Description

This output subroutine allows you to create file with a non-text format. For example, if a third-party application requires offset pointers strings to be used. As the conversion of characters from ASCII to EBCDIC is performed as the bytes are written to the file, it is recommended this routine is not used when a file is opened in modes "b" or "c" (i.e. as EBCDIC), otherwise the source word will be translated before being written.

Errors

FIO_E_DISKFULL

Disk has no more space for writing. The disk to which the file is being written is full.

FIO_E_FILEHANDLE

Invalid file handle--internal error.

FIO_E_FILELOCKED

File locked by another program.

FIO_E_NOTOPEN

File has not been opened. A file must be opened before a read attempt is made.

FIO_E_OPENFORREAD

Writing to file open for reading only.

FIO_E_WRITEACC

Write access violation. Should never happen during output.

FIO_E_WRITEERR

Unknown write error occurred.

See Also

WriteString( ) subroutine.

WriteByte( ) subroutine.