[16.0.0.4 and later]

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.

Los bloques de control BBGZACHK, BGVT y ECVT contienen las ubicaciones de puntero necesarias para determinar si se está ejecutando un ángel determinado. La tabla siguiente lista la ubicación de puntero para la API de comprobación de ángel o un bloque de control.
Tabla 1. Ubicación de puntero para la API de comprobación de ángel o un bloque de control
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

En la tabla siguiente se proporcionan los requisitos del llamante.
Tabla 2. Factores ambientales y sus requisitos
Factor ambiental Requisito
AMODE 64 bits
Modalidad ASC Principal
Autorización mínima Estado de problema o estado de supervisor
  • El bloque de control BBGZACHK está disponible desde cualquier clave de almacenamiento de palabra de estado de programa (PSW) 0-15.

Información de registros de entrada

En la tabla siguiente se proporcionan los registros de entrada para la API de comprobación de ángel.
Tabla 3. Registros de entrada y su contenido
Register Contenido
1 La dirección de la serie de nombre de ángel con terminación nula, o NULL.
  • Para comprobar si se está ejecutando un ángel con un nombre específico, asegúrese de que el registro 1 contenga un puntero al nombre del ángel como una serie con terminación nula al llamar a la API de comprobación de ángel.
  • Para comprobar si se está ejecutando el ángel predeterminado, asegúrese de que el registro 1 se haya borrado al llamar a la API de comprobación de ángel.
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

En la tabla siguiente se proporciona el registro de salida para la API de comprobación de ángel.
Tabla 4. Registro de salida y su contenido
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.

En la tabla siguiente se proporciona la sintaxis de la macro BBGZAACK.
Tabla 5. Sintaxis de la macro 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

El parámetro se explica de la forma siguiente:
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

Compruebe si el ángel predeterminado está activo.
   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

Compruebe si un angel denominado ANGEL01 está activo.
         
   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

Icono que indica el tipo de tema Tema de referencia

Nombre de archivo: rwlp_angel_check.html