AMX 86 ajmxcre ajmxcre

AMX 86 Procedures

DAK

271

ajmxcre ajmxcre

Purpose Create a Message Exchange

Used by n Task o IS P o Timer Procedure n Restart Procedure n Exit Procedure

Setup AMXID exchange;

int mb0, mb1, mb2, mb3;

char tag[4];

int status;

status = ajmxcre(&exchange, mb0, mb1, mb2, mb3, tag);

AX BX= @ES:BX (see note) [DX:CX]

Where &exchange is a pointer to storage for the message exchange id of the

message exchange allocated to the caller.

mb0, mb1, mb2, mb3 are integers defining the maximum number of

message envelopes which can reside in each of the message exchange

message queues (0 <= mbi <= 32767).

tag is the 4-character tag for the message exchange.

Results Interrupts are disabled and then restored to their state at the time of the

call.

Status is returned.

AEROK = Call successful.

exchange contains a valid message exchange id.

AERNXB = No free message exchange

AERMBZ = Invalid message queue (mailbox) depth

If the call is unsuccessful, exchange is undefined.

Note For assembly language users, ES:BX contains a pointer to four 16-bit

integers defining the maximum depth of each of the four message queues.