ec2_$advance — Apollo

EC2_$ADVANCE                      Domain/OS                       EC2_$ADVANCE


NAME
     ec2_$advance - increment an eventcount

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/ec2.h>

     void ec2_$advance(
          ec2_$eventcount_t *eventcount,
          status_$t *status)

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/ec2.ins.pas';

     procedure ec2_$advance(
          var eventcount: ec2_$eventcount_t;
          out status: status_$t);

SYNOPSIS (FORTRAN)
     %include '/sys/ins/base.ins.ftn'
     %include '/sys/ins/ec2.ins.ftn'

           integer*4 status, value
           integer*2 eventcount(3)

           equivalence (value, eventcount(1))

           call ec2_$advance(eventcount, status)

DESCRIPTION
     Ec2_$advance increments the user-defined eventcount eventcount.  A pro-
     cess must have mappped eventcount into its address space before calling
     ec2_$advance.

     eventcount
          The eventcount to increment.

     status
          The completion status.

NOTES
     A program should not attempt to advance a system eventcount with
     ec2_$advance.  System eventcounts are advanced by the system, and
     attempts by user processes to advance them will lead to unexpected
     results.
Museum
