![[16.0.0.4 and later]](../ng_v16004plus.gif)
API de comprobación de ángel
Utilice la API de comprobación de ángel para comprobar si está ejecutándose un angel con un nombre específico o el angel predeterminado.
API o bloque de control | Ubicación de puntero |
---|---|
La API de comprobación de ángel | Desplazamiento 0x14 del bloque de control BBGZACHK |
El bloque de control BBGZACHK | Desplazamiento 0x2AC del bloque de control BGVT Si el puntero es NULL, no se ha iniciado ningún ángel. |
El bloque de control BGVT | Desplazamiento 0x234 del bloque de control ECVT. Si el puntero es NULL, no se ha iniciado ningún ángel. Para obtener más información sobre el bloque de control ECVT, consulte MVS Data Areas, Volume 1 (ABE- IAX). |
Entorno
Factor ambiental | Requisito |
---|---|
AMODE | 64 bits |
Modalidad ASC | Principal |
Autorización mínima | Estado de problema o estado de supervisor
|
Información de registros de entrada
Register | Contenido |
---|---|
1 | La dirección de la serie de nombre de ángel con terminación nula, o NULL.
|
13 | Área de guardar de 144 bytes en formato F4SA. |
14 | La dirección a la que se volverá. |
Información de registros de salida
Register | Contenido |
---|---|
15 | Código de retorno de 0 si el ángel especificado se está ejecutando; en caso contrario, distinto de cero |
Macro BBGZAACK para llamar a la API de comprobación de ángel
Para simplificar la llamada a la API de comprobación de ángel, puede utilizar la macro BBGZAACK que se encuentra en ${wlp.install.dir}/dev/api/ibm/zos/BBGZAACK.
Sintaxis | Descripción |
---|---|
nombre | nombre: símbolo. nombre de inicio en la columna 1. |
ƀ | Uno o varios espacios en blanco deben preceder a BBGZAACK. |
BBGZAACK | |
ƀ | Uno o varios espacios en blanco deben ir a continuación de BBGZAACK. |
ANAME=nombre_ángel | Una dirección de tipo A o registro (2) - (12). |
Parámetros
- ANAME
- Especifica la dirección del nombre del ángel que se comprueba. Incluida la terminación nula, la longitud de este parámetro debe estar entre 1 y 55 caracteres, estos inclusive. Utilice un único carácter nulo para especificar el ángel predeterminado.
Códigos de retorno y razón
Cuando se devuelve el control de la macro BBGZAACK, el registro de finalidad general (GPR) 15 contiene el código de retorno. El código de retorno 0 indica que se ha encontrado el ángel especificado y que está activo. Un código de retorno distinto de cero indica que no se ha encontrado el ángel especificado o que no está activo.
Ejemplos
Los ejemplos siguientes suponen que ha copiado el archivo ${wlp.install.dir}/dev/api/ibm/zos/BBGZAACK en el MACLIB.
Ejemplo 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
Ejemplo 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