Automation Engine Script-Leitfaden > Funktionelle Gliederung > Rechnen > GET_BIT

GET_BIT

Script-Funktion: Prüft, ob in einem Bit-Feld ein bestimmtes Bit gesetzt ist

Syntax

GET_BIT(Number, Bit Position)

Syntax	Beschreibung/Format
Zahl	Zahl, welche in ein binäres Format (Bit-Feld) umgewandelt wird. Format: Zahl oder Script-Variable
Bit-Position	Position innerhalb des Bit-Feldes, welche geprüft werden soll. Format: Zahl oder Script-Variable

Rückgabewert
"0" - Bit ist gesetzt. "1" - Bit ist nicht gesetzt.

Anmerkungen

Die Script-Funktion wandelt die Zahl, welche mit dem ersten Parameter übergeben wird, in ein binäres Format um. Ergebnis ist ein sogenanntes Bit-Feld. Anschließend wird geprüft, ob das Bit an der angegebenen Position gesetzt ist oder nicht.

Die Bit-Position wird immer von rechts gezählt.

Die Script-Funktion wird auch dazu verwendet, um die 16 Bit-Felder MSG_DESCRIPTOR, MSG_LEVEL und MSG_MISC einer Konsolen-Meldung in z/OS abfragen zu können. Diese können aber auch direkt mit der Script-Funktion GET_CONSOLE abgefragt werden.

Beispiele

Im ersten Beispiel wird geprüft, ob das 3. Bit des Bit-Feldes ("110"), welches der Zahl "6" entspricht, gesetzt ist. Der Rückgabewert "1" (Bit ist gesetzt) wird im Aktivierungsprotokoll ausgegeben.

:SET &RET# = GET_BIT(6, 3)
:PRINT &RET#

Das zweite Beispiel ermittelt einen Bestandteil der Konsolen-Meldung in z/OS. Die zurückgegebene Zahl wird anschließend binär umgerechnet und auf Bit-Position 3 geprüft.

:SET &RET# = GET_CONSOLE("MSG_DESCRIPTOR")
:SET &RET# = GET_BIT(&RET#, 3)

Siehe auch:

Script-Sprachmittel	Beschreibung
GET_CONSOLE	Liest Meldungsdaten des eingetretenen Konsolen-Ereignisses aus

Script-Sprachmittel - Rechnen

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support