CRE Programmer's Guide

CRE Service Functions
Common Run-Time Environment (CRE) Programmer’s Guide—528146-004
6-6
CRE_File_Control_
•
A negative number, which is the negation of a CRE error number from the following
table:
Considerations
CRE_File_Close_ decrements its count of the number of connections it has granted. If
after decrementing its count by one, the number of outstanding connections is nonzero,
CRE_File_Close_ returns to its caller without taking further action. If the result of
decrementing the number of outstanding connections goes to zero, CRE_File_Close_
calls:
•
The CLOSEEDIT system procedure if the file was opened by a call to OPENEDIT.
•
The SPOOLEND system procedure and then the FILE_CLOSE_ system procedure
if the file was a spooler collector that was open for buffered (level-3) spooling.
•
The FILE_CLOSE_ system procedure for all other files.
CRE_File_Control_
The CRE_File_Control_ function invokes the CONTROL or SPOOLCONTROL system
procedures, passing the parameters you specify when you call CRE_File_Control_.
file_ordinal
identifies the standard file to which to send a control operation. You can use the
following symbolic names for
file_ordinal:
CRE^Standard^Input
CRE^Standard^Output
CRE^Standard^Log
operation
is the operation parameter to pass to the CONTROL or SPOOLCONTROL system
procedures.
Error Code Cause
16 Checkpoint list exhausted
55 Missing or invalid parameter
63 Undefined shared file
INT PROC CRE_File_Control_( file_ordinal, operation, param );
INT file_ordinal; ! in, required
INT operation; ! in, required
INT param; ! in, required TNS,native