GET_BIT

Verwenden Sie die Script-Funktion GET_BIT, um eine Zahl in ein Binärformat zu konvertieren, woraus sich ein Bitfeld ergibt. Die Script-Funktion prüft, ob das Bit an einer bestimmten Position gesetzt ist.

Tipp: Sie können diese Script-Funktion auch verwenden, um die 16-Bit-Felder MSG_DESCRIPTOR, MSG_LEVEL und MSG_MISC einer Konsolenmeldung in z/OS anzufordern. Sie können diese Felder jedoch direkt mit der Script-Funktion GET_CONSOLE abfragen. Weitere Informationen finden Sie unter GET_CONSOLE, GET_EVENT_INFO.

Syntax

GET_BIT (Zahl, Bit-Position)

Parameter

• GET_BIT
  Script-Funktion, die überprüft, ob ein Bit in einem Bitfeld gesetzt ist
  Rückgabewert: 0, wenn das Bit gesetzt ist, 1, wenn das Bit nicht gesetzt ist.

• Zahl
  Zahl, die in ein binäres Format umgewandelt werden soll (Bit-Feld)
  Format: Zahl oder Script-Variable

• Bit-Position
  Position in einem Bitfeld, die überprüft werden soll, wobei immer von rechts her gezählt wird
  Format: Script-Literal, Script-Variable oder Zahl ohne Anführungszeichen

Beispiele

Im folgenden Beispiel prüft die Script-Funktion, ob das dritte Bit im Bitfeld (110) gesetzt ist. Das Bitfeld in diesem Beispiel ist das binäre Format der Zahl 6. Das Script gibt auch den zurückgegebenen Wert (1, das gesetzte Bit) an den Aktivierungsreport aus.

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

Die erste Script-Funktion im folgenden Beispiel prüft eine Komponente der Konsolenmeldung in z/OS. Die zweite Script-Funktion wandelt die zurückgegebene Zahl in eine binäre Zahl um und überprüft sie in Bitposition 3.

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

Siehe auch: