FILEIO Subroutine

Output a string value to a file.

call WriteByte(FILE_ID_IV, SOURCE_IV)

FILE_ID_FID

A integer variable for the file id.

SOURCE_IV

An integer variable from which the lowest order byte 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 strings to be null terminated. 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 byte 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.

WriteWord( ) subroutine.