ma_submit(3xma) — Subroutines
(c) Digital Equipment Corporation. 1994. All rights reserved.
Name
ma_submit − Submits a communique.
Syntax
OM_return_code = ma_submit (session, communique, submission_results)
| Argument | Data Type | Access |
| session | OM_private_object | read only |
| communique | OM_object | read only |
| submission_results | OM_private_object | write only |
| return_code | OM_return_code |
C Binding
OM_return_code ma_submit (session, communique, submission_results ) OM_private_object session;
OM_object communique;
OM_private_object submission_results;
Arguments
SessionAn established MA session between a Client and the Service; an instance of the Session class.
CommuniqueThe object to be submitted; an instance of the Submitted Communique class. The originator of the object should be among the users associated with the session. The Service makes the communique inaccessible to the Client if it is a private object.
Submission ResultsThe results of the submission; an instance of the Submission Results class. This argument is present only if the Return Value indicates success.
Description
This routine submits a communique by adding it to the submission queue to which a session provides access. This transfers responsibility for the communique from the Client to the Service. The routine first checks the integrity of the communique; that is, it checks that the communique has all the attributes it should have and that all the attribute values are legal.
Return Values
MH_RC_FEATURE_UNAVAILABLE
OM_MEMORY_INSUFFICIENT
OM_NETWORK_ERROR
MH_RC_ORIGINATOR_IMPROPER
OM_SUCCESS
OM_SYSTEM_ERROR
MH_RC_UNSUPP_CRITICAL_FUNCTION
MH_RC_WRONG_CLASS
OM_WRONG_VALUE_MAKEUP
MH_RC_BAD_MESSAGE
Plus errors returned from:
om_create
om_instance
om_put
Examples
om_status = ma_submit ( session, submitted_message, &submission_results );