ma_size(3xma) — Subroutines
(c) Digital Equipment Corporation. 1994. All rights reserved.
Name
ma_size − Returns the number of messages and reports in the delivery queue.
Syntax
OM_return_code = ma_size (session, number)
| Argument | Data Type | Access |
| session | OM_private_object | read only |
| number | MH_object_count | write only |
| return_code | OM_return_code |
C Binding
OM_return_code ma_size (session, number) OM_private_object session;
MH_object_count ∗number;
Arguments
SessionAn established MA session between a Client and the Service; an instance of the Digital Session class.
NumberThe number of unreserved objects in the delivery queue. If this number exceeds , the routine returns present only if the Return Value indicates success.
Description
This routine returns the number of unreserved objects in the input queue to which a session provides access. Each object is a message or report.
Return Values
MH_RC_FEATURE_UNAVAILABLE
OM_MEMORY_INSUFFICIENT
OM_NETWORK_ERROR
OM_SUCCESS
OM_SYSTEM_ERROR
MH_RC_WRONG_CLASS
Plus errors returned from:
om_instance
Examples
om_status = ma_size (session, &queue_size);