Guardian Programming Reference Summary for C

Functions Summary (D-F)
Guardian Programming Reference Summary for C—522630-001
5-35
FILE_OPEN_CHKPT_
Is called by a primary process to open a designated file for its backup process.
This passive backup procedure is not supported in C programs. For a comparison of
active backup and passive backup, refer to the Guardian Programmer’s Guide.
FILE_PURGE_
Deletes a disk file that is not open. This procedure operates only on Guardian objects.
FILE_RENAME_
Changes the name of an open disk file.
Bit 3 Any file number for backup open. When performing a backup open,
specifies that the system can use any file number for the backup open. 0
specifies that the backup open is to have the same file number as the primary
open. Error 12 is returned if that file number is already in use.
Bits 4-9 Reserved (specify 0).
Bit 10 Open an OSS file by its OSS pathname. Specifies that the file to be opened is
identified by the pathname parameter.
Bit 11 Reserved (specify 0).
Bit 12 No transactions. For $RECEIVE, system messages do not include transaction
identifiers. Must be 0 if bit 15 is 1.
Bit 13 I18N locale support. For $RECEIVE, data messages include
internationalization locale information. Must be 0 if bit 15 is 1.
Bit 14 Old format system messages. For $RECEIVE, system messages should be
delivered in C-series format. If this bit is 0, D-series format messages are
delivered. For other device types, this bit must be 0.
Bit 15 No file management system messages. For $RECEIVE, specifies that the
caller does not wish to receive process open, process close, CONTROL,
SETMODE, SETPARAM, RESETSYNC, and CONTROLBUF messages. If
this bit is 0, messages are delivered as normal. For other device types, this bit
must be 0.
#include <cextdecs(FILE_PURGE_)>
short FILE_PURGE_ ( const char *filename /* i */
,short length ); /* i */
#include <cextdecs(FILE_RENAME_)>
short FILE_RENAME_ ( short filenum /* i */
,const char *newname /* i */
,short length ); /* i */