diff --git a/src/ca/CAref.html b/src/ca/CAref.html index 4432eaaca..1857ea734 100644 --- a/src/ca/CAref.html +++ b/src/ca/CAref.html @@ -209,6 +209,7 @@ $Date$
dbr_size[]dbr_size[]#include <db_access.h> extern unsigned dbr_size[/* TYPE */];@@ -3946,11 +3947,12 @@ int ca_sg_create ( CA_SYNC_GID *PGID );
A synchronous group can be used to guarantee that a set of channel access
requests have completed. Once a synchronous group has been created then channel
-access get and put requests may be issued within it using ca_sg_get() and
-ca_sg_put() respectively. The routines ca_sg_block() and ca_sg_test() can be
+access get and put requests may be issued within it using
+ca_sg_array_get() and ca_sg_array_put() respectively.
+The routines ca_sg_block() and ca_sg_test() can be
used to block for and test for completion respectively. The routine
-ca_sg_reset() is used to discard knowledge of old requests which have timed out
-and in all likelihood will never be satisfied.
ca_sg_reset() is used to discard knowledge of old requests which
+have timed out and in all likelihood will never be satisfied.
Any number of asynchronous groups can have application requested operations outstanding within them at any given time.
@@ -4124,16 +4126,20 @@ status = ca_sg_reset(gid);ca_sg_array_put()#include <cadef.h>
+int ca_sg_put ( CA_SYNC_GID GID, chtype TYPE,
+ chid CHID, void *PVALUE );
int ca_sg_array_put ( CA_SYNC_GID GID, chtype TYPE,
unsigned long COUNT, chid CHID, void *PVALUE );
-Write a value, or array of values, to a channel and increment the
-outstanding request count of a synchronous group. The ca_sg_array_put()
-functionality is implemented using ca_array_put_callback().
Write a value, or array of values, to a channel and increment the outstanding
+request count of a synchronous group. The ca_sg_put() and
+ca_sg_array_put() functionality is implemented using
+ca_array_put_callback().
All remote operation requests such as the above are accumulated (buffered)
-and not forwarded to the server until one of ca_flush_io(), ca_pend_io(),
-ca_pend_event(), or ca_sg_block() are called. This allows several requests to be
+and not forwarded to the server until one of ca_flush_io(),
+ca_pend_io(), ca_pend_event(), or
+ca_sg_block() are called. This allows several requests to be
efficiently sent in one message.
If a connection is lost and then resumed outstanding puts are not @@ -4186,6 +4192,8 @@ reissued.
ca_sg_array_get()#include <cadef.h>
+int ca_sg_get ( CA_SYNC_GID GID, chtype TYPE,
+ chid CHID, void *PVALUE );
int ca_sg_array_get ( CA_SYNC_GID GID,
chtype TYPE, unsigned long COUNT,
chid CHID, void *PVALUE );
@@ -4193,16 +4201,19 @@ int ca_sg_array_get ( CA_SYNC_GID GID,
Read a value from a channel and increment the outstanding request count of a
-synchronous group. The ca_sg_array_get() functionality is implemented using
+synchronous group. The ca_sg_get() and
+ca_sg_array_get() functionality is implemented using
ca_array_get_callback().
The values written into your program's variables by ca_sg_get() should not be
-referenced by your program until ECA_NORMAL has been received from ca_sg_block(),
-or until ca_sg_test() returns ECA_IODONE.
The values written into your program's variables by ca_sg_get()
+or ca_sg_array_get() should not be referenced by your program until
+ECA_NORMAL has been received from ca_sg_block(), or until
+ca_sg_test() returns ECA_IODONE.
All remote operation requests such as the above are accumulated (buffered)
-and not forwarded to the server until one of ca_flush_io(), ca_pend_io(),
-ca_pend_event(), or ca_sg_block() are called. This allows several requests to be
+and not forwarded to the server until one of ca_flush_io(),
+ca_pend_io(), ca_pend_event(), or
+ca_sg_block() are called. This allows several requests to be
efficiently sent in one message.
If a connection is lost and then resumed outstanding gets are not