CRE Programmer's Guide

CRE Service Functions
Common Run-Time Environment (CRE) Programmer’s Guide—528146-004
6-9
CRE_File_Message_
Considerations
CRE_File_Input_ reads the next sequential record from the file referenced by
file_ordinal unless file_ordinal specifies a null file in which case
CRE_File_Input_ returns end of file without taking any other action.
If
file_ordinal does not reference a null file, CRE_File_Input_ reads the next
sequential record by calling:
•
READEDIT if the file is an EDIT file that was opened by calling OPENEDIT.
•
EDITREAD if the file is an EDIT file that was opened by calling FILE_OPEN_ and
EDITREADINIT.
•
WRITEREADX if the file is a terminal or process (other than a spooler collector)
and
write_count is not equal to -1. In this case, write_count specifies the
number of bytes to write from
buffer during the write portion of the
WRITEREADX operation.
•
READX for all other cases.
CRE_File_Input_ does not retry operations that return an error.
CRE_File_Message_
The CRE_File_Message_ function sends a message to a standard file.
file_ordinal
identifies the standard file to which to send a message. You can use the following
symbolic names for
file_ordinal:
buffer:message_bytes
is the message to send. If read_count is not -1, CRE_File_Message_ stores a
response, if one is received, at
buffer.
INT PROC CRE_File_Message_( file_ordinal,
buffer:message_bytes,
indent_bytes, read_count,
count_read )
EXTENSIBLE;
INT file_ordinal; ! in, required
STRING .EXT buffer; ! in/out, required
INT message_bytes; ! in, required
INT indent_bytes; ! in, optional
INT read_count; ! in, optional
INT .EXT count_read; ! out, optional TNS,native
CRE File Ordinal Symbolic Names
CRE^Standard^Output
CRE^Standard^Log