gtpc2m2pC/C++ Language Support User's Guide

filnc_ext-File a Record with No Release and Extended Options

This function writes a working storage block from an entry control block (ECB) data level to file. The ECB must be holding a storage block on the specified level.

This service files a record to either VFA or DASD.

The filnc_ext function does not return the block of storage to the appropriate pool but retains it on the specified level following return from a subsequent waitc.

Format

#include   <tpfio.h>
void       filnc_ext(enum t_lvl level, unsigned int ext);

level
One of 16 possible values representing a valid data level from the enumeration type t_lvl, expressed as Dx, where x represents the hexadecimal number of the level (0-F). The working storage block on this CBRW level is the record to be filed.

ext
Sum of the following bit flags that are defined in tpfio.h.

FILE_GDS
Use FILE_GDS to specify that the record to be filed resides in a general file or general data set. If FILE_GDS is not specified, filnc_ext accesses the record on the online database.

FILE_NOTAG
The TPF system code that places the program identification in the record header is bypassed. This flag should only be used when the application updating the record has placed the required program identification in the header directly.
Note:
If neither of the above flags are needed the default extended options flag, FILE_DEFEXT, should be coded. Consider using the filnc function.

Normal Return

Void.

Error Return

Not applicable.

Programming Considerations

Examples

The following example writes the data in the working storage block on level D7 to a general data set and bypasses the record header update. The working storage block remains attached to the data level.

#include <tpfio.h>

  ·
  ·
  ·
filnc_ext(D7,FILE_NOTAG|FILE_GDS); if (waitc()) { serrc_op(SERRC_EXIT,0x12345,"I/O ERROR OCCURRED",NULL); } /* This serrc_op call is the ISO-C version of the TARGET(TPF) call: errno = 0x1234; perror("I/O ERROR OCCURRED"); abort(); */

Related Information