IPC_$GET_EC                       Domain/OS                        IPC_$GET_EC


NAME
     ipc_$get_ec - get an IPC eventcount

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

     void ipc_$get_ec(
          ipc_$socket_handle_t socket_handle,
          ec2_$ptr_t *eventcount_ptr,
          status_$t *status)

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

     procedure ipc_$get_ec(
          in socket_handle: ipc_$socket_handle_t;
          out eventcount_ptr: ec2_$ptr_t;
          out status: status_$t);

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

           integer*4 status, ec_value
           character socket_handle*20
           integer*2 event(3)

           equivalence (ec_value, event(1))

           integer*4 eventcount_ptr
           pointer /eventcount_ptr/ event

           call ipc_$get_ec(socket_handle, eventcount_ptr, status)

DESCRIPTION
     Ipc_$get_ec gets a pointer to an eventcount that advances whenever a
     datagram arrives in the socket on socket_handle.

     socket_handle
          The handle for an open socket.

     eventcount_ptr
          A pointer to the eventcount.

     status
          The completion status.

NOTES
     IPC eventcounts are useful when a program uses more than one socket.  If
     a program uses only one socket, ipc_$wait or ipc_$sar are usually suffi-
     cient.

SEE ALSO
     ec2_$intro.