AMX 86 ajmxtag ajmxtag

276

DAK

AMX 86 Procedures

ajmxtag ajmxtag

Purpose Find a Message Exchange

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

Setup AMXID exchange;

char tag[4];

int status;

status = ajmxtag(&exchange, tag);

AX BX= [DX:CX] see note

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

message exchange of interest.

tag is a pointer to a 4-character name identifying the message exchange of

interest.

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

call.

Status is returned.

AEROK = Call successful

AERNSX = No message exchange with matching tag can be found

If more than one message exchange was created with the same tag, you

will get back the message exchange id of one of them, but which one is

not certain.

If a message exchange with the given tag cannot be located, the message

exchange id in exchange will be undefined.

Message exchange tags are 4 characters long. All characters must match

your search tag exactly.

Note A tag 'ABCD' is presented in register DX:CX with 'A' in CL and 'D' in

DH.