![[16.0.0.4 and later]](../ng_v16004plus.gif)
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.
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
Facteur environnemental | Exigence |
---|---|
AMODE | 64 bits |
Mode ASC | Principal |
Niveau minimal d'autorisation | État Incident ou état Superviseur
|
Informations du registre d'entrée
Registre | Contenu |
---|---|
1 | Adresse de la chaîne de nom d'ange à terminaison null, ou NULL.
|
13 | Zone d'enregistrement à 144 octets au format F4SA. |
14 | Adresse à laquelle revenir. |
Informations du registre de sortie
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.
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
- 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
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
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