GetLabel / SetLabel / RNtfLabel

GetLabel

OCA‑Objekte können zur besseren Erkennbarkeit mit einer Beschriftung versehen werden. Die Methode GetLabel dient zur Abfrage dieser Eigenschaft des OCA‑Objektes. Wenn die Abfrage erfolgreich war, wird das Resultat in der Eigenschaft stLabel ausgegeben.

	Zyklischer Methodenaufruf Da zwischen dem Absenden und der Antwort des Gerätes einige SPS-Zyklen liegen können, sollte diese Methode zyklisch ausgeführt werden.

Syntax

VAR_INPUT
   pLink    : POINTER TO ST_Link; 
   bExecute : BOOL; 
END_VAR

Eingänge

Name	Typ	Beschreibung
pLink	POINTER TO ST_Link	Zeiger zum Herstellen einer Verbindung zwischen OCA-Objekten und dem OCA Device
bExecute	BOOL	Mit einer positiven Flanke am Eingang bExecute wird die Methode ausgeführt.

SetLabel

Mit der Methode SetLabel kann die Beschriftung eines OCA‑Objektes gesetzt werden. Wenn die Methode erfolgreich ausgeführt wurde, wird das Resultat in der Eigenschaft stLabel ausgegeben.

	Zyklischer Methodenaufruf Da zwischen dem Absenden und der Antwort des Gerätes einige SPS-Zyklen liegen können, sollte diese Methode zyklisch ausgeführt werden.

Syntax

VAR_INPUT
   pLink    : POINTER TO ST_Link; 
   bExecute : BOOL;
   sLabel   : STRING;
   eCmdMode : E_OcaMessageTypeCmd;
END_VAR

Eingänge

Name	Typ	Beschreibung
pLink	POINTER TO ST_Link	Zeiger zum Herstellen einer Verbindung zwischen OCA‑Objekten und dem OCA Device
bExecute	BOOL	Mit einer positiven Flanke am Eingang bExecute wird die Methode ausgeführt.
sLabel	STRING	Beschriftung, die das OCA Objekt erhalten soll
eCmdMode	E_ OcaMessageTypeCmd	Abhängig davon, ob eine Bestätigung erforderlich ist oder nicht wird diese Eingangsvariable auf E_OcaMessageTypeCmd.OcaCmdRrq oder E_OcaMessageTypeCmd.OcaCmd gesetzt.

RNtfLabel

Wenn das OCA‑Objekt aufgefordert wird, Änderungen bekanntzugeben (mittels der Methode Subscribtion), werden mit der Methode RNtfLabel eingehende „Notifications“ (Benachrichtigungen) gelesen.

	Zyklischer Methodenaufruf Da zwischen dem Absenden und der Antwort des Gerätes einige SPS-Zyklen liegen können, sollte diese Methode zyklisch ausgeführt werden.

Syntax

VAR_INPUT
   pLink           : POINTER TO ST_Link;
   bEnable         : BOOL;
   nSubscribtionNo : UDINT;
END_VAR

Eingänge

Name	Typ	Beschreibung
pLink	POINTER TO ST_Link	Zeiger zum Herstellen einer Verbindung zwischen OCA‑Objekten und dem OCA Device.
bExecute	BOOL	Mit einer positiven Flanke am Eingang bExecute wird die Methode ausgeführt.
nSubscribtionNo	UDINT	Eindeutige Nummer zur Lokalisierung der jeweiligen Subscription.