mt_transfer_out(3xmt) — Subroutines

Name

mt_transfer_out − Adds a communique or a report to the output queue.

Syntax

OM_return_code = mt_transfer_out (session, object)

Argument	Data Type	Access
session	OM_private_object	read only
object	OM_object	read only
return_code	OM_return_code

C Binding

OM_return_code mt_transfer_out (session, object) OM_private_object session;
OM_object object;

Arguments

SessionAn established MT session between a Client and the Service; an instance of the Session class.

ObjectThe object to be added to the output queue; an instance of the Communique or the Report class. The routine does not reserve the object; otherwise it would be being made inaccessible for mt_finish_transfer_in. If the object is private, it is made inaccessible.

Description

This routine adds a communique or a report to the output queue to which a session provides access. This transfers responsibility for that object from the Client to the Service. The routine first checks the integrity of the object, that is, that it has all the attributes it should have and that all the attribute values are legal.

Return Values

MH_RC_BAD_MESSAGE

MH_RC_FEATURE_UNAVAILABLE

OM_MEMORY_INSUFFICIENT

OM_NETWORK_ERROR

MH_RC_NOT_UNRESERVED

OM_SUCCESS

OM_SYSTEM_ERROR

MH_RC_WRONG_CLASS

Plus errors returned from:

om_create

om_instance

om_put

Examples

    /∗
    ∗∗ transfer out the private object
    ∗/
    om_status = mt_transfer_out ( session, communique);

Museum