CRE Programmer's Guide

CRE Service Functions
Common Run-Time Environment (CRE) Programmer’s Guide—528146-004
6-7
CRE_File_Control_
param
is the param parameter to pass to the CONTROL or SPOOLCONTROL system
procedures.
Return Value
CRE_File_Control_ returns one of the following:
•
0 if the control operation is successful
•
A positive number, which is a file system error number
•
A negative number, which is the negation of a CRE error number from the following
table:
Considerations
If the standard file associated with file_ordinal is a spooler collector,
CRE_File_Control_:
•
Invokes the SPOOLSTART system procedure, if SPOOLSTART has not been
invoked yet for
file_ordinal.
•
Invokes the SPOOLCONTROL system procedure, passing operation and
param to the corresponding SPOOLCONTROL parameters.
If the standard file associated with
file_ordinal is not a spooler collector,
CRE_File_Control_ calls the CONTROL system procedure, passing
operation and
param to the CONTROL procedure.
CRE_File_Control_ does not retry operations that return an error.
For more information on the SPOOLSTART and SPOOLCONTROL system
procedures, see the
Spooler Programmer’s Guide.
For more information on the CONTROL system procedure, see the
Guardian
Procedure Calls Reference Manual.
Error Code Meaning
55 Missing or invalid parameter
57 Parameter value not accepted
63 Undefined shared file
64 File not open