clr_flg/iclr_flg | CS+ V8.02.00

clr_flg

iclr_flg

Outline

Clear eventflag.

C format
 ER      clr_flg (ID flgid, FLGPTN clrptn);
 ER      iclr_flg (ID flgid, FLGPTN clrptn);
Parameter(s)
I/O

Parameter

Description
I
 ID      flgid;
ID number of the eventflag.
I
 FLGPTN  clrptn;
Bit pattern to clear.
Explanation

This service call sets the result of ANDing the bit pattern set to the eventflag specified by parameter flgid and the bit pattern specified by parameter clrptn as the bit pattern of the target eventflag.

Return value

Macro

Value

Description

E_OK

0

Normal completion.

E_ID

-18

Invalid ID number.

- flgid < 0

- flgid > VTMAX_FLG

E_CTX

-25

Context error.

- This service call was issued in the CPU locked state.

- This service call was issued in the status "PSW.IPL > kernel interrupt mask level".

Note When the iclr_flg is issued from task or the clr_flg is issued from non-task, the context error is not detected and normal operation of the system is not guaranteed.

E_NOEXS

-42

Non-existent object.

- The eventflag specified by flgid does not exist.

I/O	Parameter	Description
I	ID flgid;	ID number of the eventflag.
I	FLGPTN clrptn;	Bit pattern to clear.

Macro	Value	Description
E_OK	0	Normal completion.
E_ID	-18	Invalid ID number. - flgid < 0 - flgid > VTMAX_FLG
E_CTX	-25	Context error. - This service call was issued in the CPU locked state. - This service call was issued in the status "PSW.IPL > kernel interrupt mask level". Note When the iclr_flg is issued from task or the clr_flg is issued from non-task, the context error is not detected and normal operation of the system is not guaranteed.
E_NOEXS	-42	Non-existent object. - The eventflag specified by flgid does not exist.