OMwrite_obj


Synopsis



int  OMwrite_obj (
OMobj_id  object,
char *  filename,
int  mode  );

Description

OMwrite_obj saves object (including its subobjects) to a file. The mode parameter indicates which state information to save and whether to append the output in the case of an existing file.

Arguments

object

The object id.

filename

A filename. You can specify an absolute pathname or a path relative to the current directory of the calling process.

mode

A mode specifying which state information to save and whether to append the output in the case of an existing file.

For state information, specify one of the following:

•      0 -- Save all information, including program, user, and transient state.

•      OM_SAVE_USR -- Save program and user state only.

•      OM_SAVE_PGM -- Save program state only.

You can also OR in the symbolic constant OM_WRITE_APPEND to append the output to the file. Otherwise, the Object Manager overwrites the file.

Returned value

The status code (see Return Status ).