Manuel des Scripts Automation Engine > Organisation fonctionnelle > Arithmetics > GET_BIT

GET_BIT

Fonction de script : Vérifie si un bit particulier est défini dans un champ de bit.

Syntaxe

GET_BIT(Number, Bit Position)

Syntaxe	Description / format
Nombre	Nombre qui est transformé au format binaire (champ de bit). Format : Nombre ou variable de script
Position de bit	Position dans le champ de bit qui doit être vérifiée. Format : Nombre ou variable de script

Code retour
"0" - Le bit est activé. "1" – Le bit n'est pas activé.

Commentaires

Cette fonction de script convertit au format binaire le nombre transmis avec le premier paramètre. On obtient alors ce qu'on appelle un champ de bit. Le système vérifie ensuite si le bit de la position indiquée est activé ou non.

La position du bit est toujours déterminée en partant de la droite.

Cette fonction de script est aussi utlisée pour interroger les champs à 16 bits MSG_DESCRIPTOR, MSG_LEVEL et MSG_MISC d'un message de console dans z/OS. Ils peuvent également être demandés directement avec la fonction de script GET_CONSOLE.

Exemples

Dans le premier exemple, le système vérifie si le troisième bit du champ de bit ("110"), qui correspond au nombre 6, est activé. Le Code Retour "1" (le bit est activé) est émis dans le protocole d'activation.

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

Le deuxième exemple détermine un élément du message de console dans z/OS. Le nombre renvoyé est ensuite converti sous forme binaire et vérifié dans la position de bit 3.

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

Rubriques connexes :

Elément de script	Description
GET_CONSOLE	Lit les données de message de l'événement de console survenu.

Eléments de script - Calculs

Généralités sur les scripts
Eléments de script - Liste alphabétique
Eléments de script – Répartition fonctionnelle