SET.RC - change report code of output file.

Usage:

B:
   ret = set.rc( [unit, ] report );

C:
   #equate set_rc set.rc
   int set_rc( [FILE *unit,] int report);

Where:

unit

is the number of an open output unit. If "unit" is not specified, the current write unit is used. If an invalid "unit" is specified, SET.RC does nothing.

report

specifies the new report code. "report" must be an integer between 0 and 63 (077 octal).

ret

is zero if SET.RC is successful. If "unit" is not an open output file "ret" receives a value of -1.

Examples:

set.rc( 1, 072 );  /* write to report code 072 */

Description:

SET.RC is used to change the report code on the file described by "unit", until the file is closed or until another SET.RC or SET.MC is executed for the file.

SET.RC should only be called when you have finished outputting a complete record (e.g. after outputting an '*n', '*r' or '*f' character). If you call SET.RC to change report codes while in the middle of a record, the result is undefined.

See Also:

expl b lib set.mc

Copyright © 1996, Thinkage Ltd.