AMX 86 ajsmtag ajsmtag

AMX 86 Procedures

DAK

309

ajsmtag ajsmtag

Purpose Find a Semaphore

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

Setup AMXID semid;

char tag[4];

int status;

status = ajsmtag(&semid, tag);

AX BX= [DX:CX] see note

Where semid is a pointer to storage for the semaphore id of the semaphore of

interest.

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

interest.

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

call.

Status is returned.

AEROK = Call successful

AERNSS = No semaphore with matching tag can be found

If more than one semaphore was created with the same tag, you will get

back the semaphore id of one of them, but which one is not certain.

If a semaphore with the given tag cannot be located, the semaphore id in

semid will be undefined.

Semaphore 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.