ec2_read() — Apollo

EC2_$READ                         Domain/OS                          EC2_$READ


NAME
     ec2_$read - return an eventcount value

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

     long ec2_$read(ec2_$eventcount_t &eventcount)

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

     function ec2_$read(in eventcount: ec2_$eventcount_t): integer32;

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

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

           equivalence (value, eventcount(1))

           ec_value = ec2_$read(eventcount)

DESCRIPTION
     Ec2_$read returns the value of an eventcount.  Before a process can
     access an eventcount with ec2_$read, it must map the eventcount into its
     address space.

     eventcount
          The eventcount to read.

NOTES
     A program should not attempt to read the value of an eventcount directly
     by dereferencing an eventcount pointer.  Eventcounts are shared by the
     system, and attempts to circumvent the ec2_$read interface will lead to
     unexpected results.

SEE ALSO
     ms_$mapl.
Museum
