gtpc2m8qC/C++ Language Support User's Guide

tpf_yieldc-Yield Control

This function gives up control of the processor and allows other entry control blocks (ECBs) to be processed. The ECB is placed on the specified processor list.

Format

#include  <sysapi.h>
void      tpf_yieldc(enum t_yieldc_opt list);
 

list
Specifies the type of list on which you want the ECB placed. Use one of the following values:

YIELDC_READY_LIST
Assigns the ECB to the ready list. This is the highest priority list available to which the ECB can be assigned. Assigning the ECB to this list prevents any new work from being processed by this I-stream before the ECB is dispatched again. Any ECBs that are already on the ready list will be allowed to process.

YIELDC_VCT_LIST
Assigns the ECB to the virtual file access count (VCT) list. This list is used to delay the processing of an ECB until all work on the ready list has been processed. Any ECB on the VCT list is interleaved with new work. ECBs on the VCT list will still be processed, even when the system stops processing new work because a shutdown condition caused by low resources occurred.

Normal Return

Void.

Error Return

Not Applicable.

Programming Considerations

Examples

The following example adds the ECB to the ready list.

#include <sysapi.h>
 

  ·
  ·
  ·
tpf_yieldc(YIELDC_READY_LIST);

Related Information

defrc-Defer Processing of Current Entry.