For z/OS platforms[16.0.0.4 and later]

API de vérification d'ange

L'API de vérification d'ange permet de vérifier si un ange spécifique désigné ou celui par défaut est en exécution.

Les blocs de contrôle BBGZACHK, BGVT, and ECVT contiennent les emplacements de pointeur requis pour déterminer si l'ange désigné est en opération. Le tableau suivant répertorie l'emplacement de pointeur for l'API de vérification d'ange ou un bloc de contrôle.
Tableau 1. Emplacement du pointeur pour l'API de vérification d'ange ou un bloc de contrôle
API ou bloc de contrôle Emplacement du pointeur
API de vérification d'ange Décalage 0x14 du bloc de contrôle BBGZACHK
Bloc de contrôle BBGZACHK Décalage 0x2AC du bloc de contrôle BGVT

Si le pointeur a pour valeur NULL, aucun ange n'a été démarré.

Bloc de contrôle BGVT Décalage 0x234 du bloc de contrôle ECVT.

Si le pointeur a pour valeur NULL, aucun ange n'a été démarré. Pour plus d'informations sur le bloc de contrôle ECVT, voir MVS Data Areas, Volume 1 (ABE- IAX).

Environnement

Le tableau suivant décrit les exigences pour l'appelant.
Tableau 2. Facteurs environnementaux et exigences associées
Facteur environnemental Exigence
AMODE 64 bits
Mode ASC Principal
Niveau minimal d'autorisation État Incident ou état Superviseur
  • Le bloc de contrôle est disponible depuis n'importe quelle clé de protection PSW (Program Status Word) 0-15.

Informations du registre d'entrée

Le tableau suivant décrit les registres d'entrée pour l'API de vérification d'ange.
Tableau 3. Registres d'entrée et contenus
Registre Contenu
1 Adresse de la chaîne de nom d'ange à terminaison null, ou NULL.
  • Pour vérifier si un ange spécifique est en opération, vérifiez que le registre 1 contient un pointeur vers le nom de cet ange sous forme de chaîne à terminaison nulle lors de l'appel de l'API de vérification d'ange.
  • Pour vérifier si l'ange par défaut est en opération, vérifiez que le registre 1 est vide lors de l'appel de l'API de vérification d'ange.
13 Zone d'enregistrement à 144 octets au format F4SA.
14 Adresse à laquelle revenir.

Informations du registre de sortie

Le tableau suivant décrit le registre de sortie de l'API de vérification d'ange.
Tableau 4. Registre de sortie et contenu
Registre Contenu
15 Code retour 0 si l'ange spécifié est en opération, non zéro autrement

Macro BBGZAACK pour appel de l'API de vérification d'ange

Pour simplifier l'appel de l'API de vérification d'ange, vous pouvez utiliser la macro BBGZAACK située sous ${wlp.install.dir}/dev/api/ibm/zos/BBGZAACK.

Le tableau suivant décrit la syntaxe de la macro BBGZAACK.
Tableau 5. Syntaxe de la macro BBGZAACK
Syntaxe Description
nom nom : Symbole. Commencez par nom dans la colonne 1.
ƀ Un ou plusieurs blancs doivent précéder BBGZAACK.
BBGZAACK
ƀ Un ou plusieurs blancs doivent suivre BBGZAACK.
ANAME=nom_ange Adresse de type A ou registre (2) - (12).

Paramètres

Ci-après l'explication du paramètre :
ANAME
Spécifie l'adresse de l'ange à vérifier. En incluant la valeur null de fin, la longueur de ce paramètre doit être comprise entre 1 et 55 caractères. Utilisez un seul caractère null pour spécifier le nom de l'ange.

Codes retour et motifs

Lorsque la macro BBGZAACK rend le contrôle, le registre général (GPR) 15 contient le code retour. Un code retour 0 indique que l'ange spécifié a été détecté et qu'il est actif. Un code retour différent de zéro indique que l'ange spécifié n'a pas été trouvé ou n'est pas actif.

Exemples

Les exemples suivants supposent que vous avez copié le fichier ${wlp.install.dir}/dev/api/ibm/zos/BBGZAACK dans votre MACLIB.

Exemple 1

Vérification si l'ange par défaut est actif.
   USING PARMS,5         
   XC ANGLPARM,ANGLPARM Clear storage / null term
   BBGZAACK ANAME=ANGLPARM
   ST 15,ANGLRC Store return code
*
PARMS DSECT
ANGLPARM DS CL1
ANGLRC DS F

Exemple 2

Vérification si l'ange nommé ANGEL01 est actif.
         
   USING PARMS,5 XC   
   ANGLPARM,ANGLPARM Clear storage / null term
   MVC ANGLPARM(7),ANGLNAME Copy angel name
   BBGZAACK ANAME=ANGLPARM
   ST 15,ANGLRC Store return code
*
   LTORG
   ANGLNAME DC CL7'ANGEL01'
*
PARMS DSECT
ANGLPARM DS CL8
ANGLRC DS F

Icône indiquant le type de rubrique Rubrique de référence

Nom du fichier : rwlp_angel_check.html