AMX 86 ajsmfre ajsmfre

AMX 86 Procedures

DAK

303

ajsmfre ajsmfre

Purpose Unconditionally Free a Resource Semaphore

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

Setup AMXID semid;

int status;

status = ajsmfre(semid);

AX BX

Where semid is the semaphore id of a resource semaphore acquired by a call to

ajsmcre.

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

call.

Status is returned.

AEROK = Call successful

AERNSS = Invalid semaphore id

AERRNY = Resource semaphore cannot be released since the calling

task does not own the resource.

Note The resource's use count is immediately set to zero and the resource freed.

The resource will immediately be given to the task (if any) which is

waiting at the head of the resource semaphore wait queue. Task

rescheduling occurs immediately if necessary.

Restriction You must not attempt to free a counting semaphore. Use ajsmsig for that

purpose.