![[z/OS]](../images/ngzos.gif)
Adaptadores locales optimizados para API de z/OS
Los adaptadores locales optimizados de WebSphere Application Server en z/OS están soportados por un conjunto de servicios invocables de lenguaje nativo de z/OS o interfaces de programación de aplicaciones (API) y Java™ EE Connector Architecture (JCA).
- Cobol
- C/C++
- PL/I
- High Level Assembler
Los interlocutores que se ejecutan en la modalidad AMODE 64 pueden utilizar las versiones AMODE 31 de las API, siempre que la lista de parámetros esté debajo de la barra y pase el parámetro utilizando convenios de 31 bits (el puntero de cada parámetro es una dirección de 31 bits). Los interlocutores que se ejecutan en modalidad de 64 bits deben ser de lenguaje C, C++ o Assembler y ejecutar la modalidad de direccionamiento de 64 bits. Cuando se utilizan las API de 64 bits de BBGA1* desde las aplicaciones de ensamblador, será necesaria un área de guardado de 64 bits con formato 4, o F4SA, que utilizarán los apéndices de los adaptadores locales optimizados para guardar y restaurar los registros del interlocutor. Cuando se realiza una invocación desde C o C++, la cabecera de ejemplo de <raíz_FS_prod>/util/zos/OLASamples/bboaapi.h define las API de 64 bits como OS_NOSTACK externa, lo que garantiza que se han invocado con el enlace y los convenios de área de guardado correctos.
Cuando se utiliza el término conexión local en esta documentación de la API, se hace una referencia a un enlace de memoria cruzada que se crea para las comunicaciones entre un espacio de direcciones externo del sistema z/OS y WebSphere Application Server en el mismo sistema z/OS . El espacio de direcciones de cliente se debe ejecutar en la misma imagen z/OS. La API de adaptador gestiona estas conexiones locales en agrupaciones que están asociadas con cada emisor de llamada registrado de manera exclusiva. El nombre de registro de 12 caracteres puede utilizarse solo para un conjunto de agrupaciones de conexión por espacio de direcciones. No existe ningún límite en el número de registros exclusivos en un solo espacio de direcciones. Sólo está limitado por la cantidad de almacenamiento disponible.
- Registro - BBOA1REG/BBGA1REG
- Anulación de registro - BBOA1URG/BBGA1URG
- Obtención de conexión - BBOA1CNG/BBGA1CNG
- Liberación de conexión - BBOA1CNR/BBGA1CNR
- Envío de solicitud - BBOA1SRQ/BBGA1SRQ
- Envío de respuesta - BBOA1SRP/BBGA1SRP
- Envío de respuesta Excepción - BBOA1SRX/BBGA1SRX
- Recepción de solicitud Cualquiera - BBOA1RCA/BBGA1RCA
- Recepción de solicitud específica - BBOA1RCS/BBGA1RCS
- Recepción de longitud de respuesta - BBOA1RCL/BBGA1RCL
- Obtención de datos de mensaje - BBOA1GET/BBGA1GET
- Invocación - BBOA1INV/BBGA1INV
- Servicio de host - BBOA1SRV/BBGA1SRV
- API de adaptador JCA
Registro
Mediante la API BBOA1REG (para interlocutores de 31 bits) y BBGA1REG (para interlocutores de 64 bits), puede registrarse con un grupo daemon y servidor locales deWebSphere Application Server para z/OS. Las API BBOA1REG y BBGA1REG solicitan que un grupo de conexiones optimizadas a un grupo de daemon y servidor locales de WebSphere Application Server estén ubicadas y registradas como "registername".
API | Sintaxis |
---|---|
BBOA1REG o BBGA1REG | BBOA1REG ( daemongroupname , nodename , servername , registername , minconn , maxconn , registerflags , rc, rsn ) BBGA1REG ( daemongroupname , nodename , servername , registername , minconn , maxconn , registerflags , rc, rsn ) |
Parámetros
daemongroupname (entrada)Variable de entrada o constante de entrada que contiene el nombre del WebSphere Application Server para el grupo de daemons de z/OS al que se debe unir. El nombre del grupo de daemons debe ser el mismo que el nombre abreviado de célula, no el nombre de trabajo del daemon.
Esta variable o constante de entrada debe ser una serie de 8 caracteres exactamente terminada en nulo y debe pasarse como consulta. El daemon de WebSphere Application Server para z/OS debe estar en ejecución e inicializado en el sistema local.
nodename (entrada)Variable de entrada o constante de entrada que contiene el nombre del WebSphere Application Server para el nodo z/OS (nombre abreviado) al que se debe unir. La variable o la constante de entrada se deben pasar por referencia. El servidor WebSphere Application Server z/OS debe estar en ejecución e inicializado en el sistema local. Debe ser una serie llena de espacios en blanco de 8 caracteres exactamente.
servername (entrada)Variable de entrada o constante de entrada que contiene el nombre de WebSphere Application Server para z/OS (nombre abreviado) al que se debe unir. La variable o la constante de entrada se deben pasar por referencia. El servidor WebSphere Application Server z/OS debe estar en ejecución e inicializado en el sistema local. Debe ser una serie llena de espacios en blanco de 8 caracteres exactamente.
registername (entrada)Variable de entrada o constante de entrada que contiene el nombre a utilizar para registrar un conjunto de conexiones locales. Las llamadas posteriores necesitan este nombre para identificar la agrupación de conexiones a utilizar. Debe ser una serie llena de espacios en blanco de 12 caracteres exactamente y que no se puede estar utilizando en el espacio de direcciones actual.
minconn (entrada)Entero que contiene el número máximo de conexiones que se deben asignar para este registro. El adaptador intenta ampliar la agrupación de conexiones locales hasta este número durante una solicitud de obtención de conexión cuando se está utilizando el número mínimo de conexiones.
registerflags (entrada)- reg_flag_trans - bit 30
Contiene un 1 si la recuperación de transacciones se debe soportar a través de las conexiones de este registro y un 0 (cero) si no se debe soportar la recuperación de transacciones.
Cuando el parámetro transaccional está habilitado, la API del adaptador intenta registrarse con los servicios de recuperación de recursos de z/OS (RRS) y una transacción global que da soporte al compromiso en dos fases se crea entre WebSphere Application Server y el entorno del explotador de la API.
A partir de la versión 8.5.0.2, si está trabajando en una región dependiente de IMS y establece este distintivo en 1, asegúrese de que está ejecutando el entorno IMS con RRS=YES y el servidor o de que la variable de entorno a nivel de nodo ola_rrs_context_propagate se haya añadido a la configuración y se haya establecido en true (o 1). En IMS, el contexto de RRS está en vigor en la hebra cuando se propaga y se confirma la llamada a la API WOLA de Invocación o Envío de solicitud en el contenedor EJB de WebSphere Application Server para z/OS.
Avoid trouble: Si tiene que añadir la variable ola_rrs_context_propagate a los valores de configuración o cambiar el valor de esta variable a true, debe reiniciar el servidor tras realizar este cambio de configuración. gotcha
- reg_flag_W2Cprop - bit 31 o bit 64
Los controles de reg_flag_W2Cprop WebSphere Application Server para la propagación de seguridad de transacción de salida de CICS.
- reg_flag_C2Wprop - bit 29Propaga la identidad de la tarea de llamada de CICS a WebSphere Application Server. Para las transacciones que son de entrada de CICS a WebSphere Application Server, el distintivo de registro reg_flag_C2Wprop controla el modo en que se determina la identidad. Cuando este bit está activado, la identidad de la tarea de la aplicación CICS se utiliza en el proceso de autorización del servidor de WebSphere Application Server. Cuando este bit está desactivado, se utiliza la identidad de región de CICS.Atención: Debe habilitar WebSphere Application Server para que se solicite la seguridad de nivel de aplicación de CICS. Establezca la variable de entorno de WebSphere, ola_cicsuser_identity_propagate, en 1 a través de la consola administrativa para establecer este tipo de propagación de seguridad.
- reg_flag_trcmod - bit 0
Establezca reg_flag_trcmod si desea modificar los valores de rastreo de adaptador local optimizado para el registro solicitado. Si no establece este distintivo, no se realizará ningún cambio en el valor de rastreo y se utilizarán los valores predeterminados del sistema o los valores de rastreo predefinidas que se aplican al nombre de registro o nombre de trabajo.
- reg_flag_trcmore - bit 1 y reg_flag_trcsome -
bit 2
Con reg_flag_trcmod en 1, establezca reg_flag_trcmore o reg_flag_trcsome para especificar un valor de rastreo si desea rastreo de nivel de poco detalle o rastreo detallado. Dejando ambos en "off", con reg_flag_trcmod establecido en 1 se fuerza que no haya rastreo para el registro, independientemente de las pre-definiciones o valores predeterminados que estén establecidos.
Código de retorno entero que indica si esta llamada se ha realizado de manera satisfactoria o anómala.
rsn (salida)Código de razón de entero que describe la razón de una anomalía en esta llamada.
- Asegúrese de que se ha iniciado el grupo de daemons y el servidor deWebSphere Application Server para z/OS especificados y de que el soporte para los adaptadores locales está habilitado.
- El número mínimo de conexiones solicitadas se valida con el número máximo de conexiones de servidor, que se puede configurar utilizando la consola administrativa de WebSphere Application Server . Un valor mínimo de conexiones (minconn) de 3 significa que se reservan
tres conexiones durante la llamada de registro. Si se solicitan en cualquier
momento más tres conexiones, la agrupación de conexiones puede aumentar al
valor máximo de conexiones (maxconn). Cuando el número de todas las conexiones a
un servidor alcanza el máximo permitido, se rechazan todas las solicitudes
de API de obtención de conexión subsiguientes para ese servido, aunque
no se haya alcanzado aún el valor de maxconn.
Importante: Tenga cuidado al establecer el valor mínimo de conexiones. Exceptuando casos específicos, un valor grande no se recomienda, ya que los recursos de la región de control de WebSphere Application Server están reservados para cada conexión.
- Se pueden realizar varias llamadas a la API de registro bajo el mismo espacio de direcciones, hebra o tarea de CICS (Customer Information Control System), sin embargo, no pueden compartir el mismo nombre de registro. El nombre de registro debe ser un nombre exclusivo.
- Si se establece el parámetro de transacción en 1, todas las conexiones para este registro se ejecutarán con transaccionalidad. Esto significa que RRS se conecta desde el espacio de direcciones actual. Consulte la sección que trata sobre la Propagación de transacciones para obtener más detalles sobre los requisitos y la configuración para ello. La transaccionalidad sólo se soporta entre WebSphere Application Server y CICS. Las solicitudes de transaccional(1) desde otros entornos hacen que se produzca un aviso durante la llamada de registro, que se ignore el distintivo y que continúe el proceso.
- Utilice la llamada de anulación de registro de API para eliminar este registro y liberar la agrupación de conexiones asociada al mismo.
- Cuando termina el espacio de direcciones que efectúa una llamada de registro, el registro termina automáticamente y se liberan las conexiones.
Código de retorno | Código de razón | Descripción | Acción |
---|---|---|---|
0 | - | Correcta | |
4 | - | Aviso - vea código de razón | |
4 | El distintivo de registro de transacción se ha establecido en 1 en un entorno donde el adaptador no soporta las transacciones globales. | Este valor se ignora y el proceso continúa. | |
8 | - | Error - vea código de razón | |
8 | La señal de nombre de registro ya existe. | Debe anular el registro de este nombre antes de llamar a la API de registro para el mismo. | |
10 | El parámetro de número máximo de conexiones excede el número máximo de conexiones permitidas para cualquier registro individual. | Se rechaza la solicitud de API de registro. Asegúrese de que el valor de adaptador local optimizado máximo del servidor de destino sea suficientemente grande para incluir ésta y todas las demás solicitudes. Para obtener más información sobre la variable de entorno WAS_DAEMON_ONLY_adapter_max_conn, consulte el tema Propiedades personalizadas de adaptadores locales optimizados y el tema Habilitación del entorno de servidor para utilizar adaptadores locales optimizados. | |
12 | El parámetro de número mínimo de conexiones especificado es mayor que el número máximo. | Asegúrese de que el valor de número mínimo de conexiones sea inferior o igual al valor de número máximo. | |
14 | Fuera de memoria compartida al intentar crear el registro. | Aumente la asignación de memoria compartida para el adaptador local optimizado o emita la anulación de registro de llamadas para reducir el consumo de recursos. | |
21 | Se ha producido un error al intentar establecer contacto con el WebSphere Application Server local. | Si establece el bit reg_flag_C2Wprop (bit 29) en 1, asegúrese de que la variable de entorno de WebSphere , ola_cicsuser_identity_propagate, esté establecida en 1. | |
25 | El gestor de transacciones no se puede inicializar. | Llame al servicio de soporte de IBM® para obtener ayuda. | |
70 | Se ha agotado la memoria compartida al intentar crear una conexión. | Aumente la asignación de memoria compartida para el adaptador local optimizado. | |
74 | El nombre de registro de entrada contiene un nulo. | Rellene con espacios en blanco el nombre de registro antes de iniciar la API de registro. | |
12 | 4 | Se ha producido un error al localizar el módulo BBOACALL. | Asegúrese de que el conjunto de datos que contiene el módulo BBOACALL de WebSphere Application Server está disponible en la STEPLIB LNKLST. |
10 | No se puede localizar el grupo de daemons de WebSphere Application Server seleccionado. | Asegúrese de que se han iniciado el daemon y el servidor de destino de WebSphere Application Server, verifique que el soporte de adaptadores locales optimizados está activo y vuelva a intentarlo. | |
14 | El ID de usuario no está autorizado para el WebSphere Application Server solicitado. | Asegúrese de que el ID de usuario está autorizado en la clase SAF CBIND para el WebSphere Application Server solicitado. | |
16 | No se encuentra el nombre de nodo o el nombre de servidor. | Asegúrese de que los parámetros de nombre de nodo y nombre de servidor que se están pasando son válidos y que el servidor está activo. | |
23 | Se ha producido un error al denominar la señal. | Llame al servicio de soporte de IBM para obtener ayuda. | |
24 | Se ha producido un error al establecer la conexión de comunicaciones locales de WebSphere Application Server inicial. | Consulte los registros de región de WebSphere Application Server para obtener detalles sobre la llamada de conexión de comunicación global. | |
28 | El registro identificado con este nombre no es válido. | El nombre de registro especificado ya está registrado, pero falta el RGE. Póngase en contacto con el servicio de soporte de IBM e informe del error. Un método alternativo consiste en llamar a la API de anulación de registro e intentar llamar de nuevo a la API de registro. | |
30 | El grupo de daemons no se ejecuta en la propiedad WAS_DAEMON_ONLY_enable_adapter establecida en 1. | Añada la variable WAS_DAEMON_ONLY_enable_adapter=1 mediante la consola administrativa de WebSphere Application Server. | |
34 | Se utiliza un apéndice de la API de 64 bits en un entorno IMS. | Las API de 64 bits no reciben soporte en IMS. | |
38 | Se ha utilizado un apéndice de la API de 64 bits en un entorno CICS. | Las API de 64 bits no reciben soporte en CICS. | |
68 | Ha fallado una conexión a la memoria compartida. | Llame al servicio de soporte de IBM para obtener ayuda. | |
86 | No se ha podido encontrar la BGVT maestra de WebSphere Application Server para z/OS | WebSphere no se ha iniciado todavía en la imagen actual del sistema z/OS. Asegúrese de que se haya iniciado el daemon y un nodo/servidor antes de iniciar cualquier proceso cliente de adaptadores locales optimizados de WebSphere Application Server. | |
88 | No se ha podido encontrar la tabla de apéndices de cliente maestra de WebSphere Application Server para z/OS | Se ha iniciado WebSphere Application Server en la imagen actual del sistema z/OS pero no se está ejecutando a un nivel admitido por la tabla de apéndices cliente de adaptadores locales optimizados. Posiblemente esté ejecutando la interfaz de apéndices de adaptadores locales optimizados de la versión 8.0.0.1 de WebSphere Application Server que no es compatible con el nivel de mantenimiento del servidor de aplicaciones. Para utilizar los apéndices de adaptadores locales optimizados de la versión 8.0.0.1, el servidor de aplicaciones también tiene que estar ejecutando el nivel de la versión 8.0.0 de WebSphere Application Server . Asegúrese de que su aplicación se esté ejecutando en el nivel compatible de los apéndices de adaptadores locales optimizados para WebSphere Application Server en este sistema z/OS. | |
90 | No se ha podido encontrar la ranura de la tabla de apéndices de cliente maestra de adaptadores locales optimizados de WebSphere Application Server para z/OS. | Se ha iniciado WebSphere Application Server en la imagen actual del sistema z/OS pero no se está ejecutando a un nivel admitido por la tabla de apéndices cliente de adaptadores locales optimizados. Posiblemente esté ejecutando la interfaz de apéndices de adaptadores locales optimizados de la versión 8.0.0.1 de WebSphere Application Server que no es compatible con el nivel de mantenimiento del servidor de aplicaciones. Para utilizar los apéndices de adaptadores locales optimizados de la versión 8.0.0.1, el servidor de aplicaciones también tiene que estar ejecutando el nivel de la versión 8.0.0 de WebSphere Application Server . Asegúrese de que su aplicación se esté ejecutando en el nivel compatible de los apéndices de adaptadores locales optimizados para WebSphere Application Server en este sistema z/OS. |
Anulación de registro
Anulación del registro desde el grupo de daemon y servidor locales de WebSphere Application Server para z/OS utilizando las API BBOA1URG (para interlocutores de 31 bits) y BBGA1URG (para interlocutores de 64 bits).API | Sintaxis |
---|---|
BBOA1URG o BBGA1URG | BBOA1URG (registername, unregflags, rc, rsn) BBGA1URG (registername, unregflags, rc, rsn) |
Parámetros:
registername (entrada)Variable de entrada o constante de entrada que contiene el nombre a utilizar para anular el registro de un conjunto de conexiones locales. Debe tener 12 caracteres exactamente, rellenados con espacios en blanco, y el mismo nombre utilizado en BBOA1REG.
unregisterflags (entrada)- Reservado - bit 0-30
- Forzar (0|1) - bit 31 o bit 64
Contiene un 1 si se debe forzar la solicitud de anulación de registro. De manera predeterminada, una solicitud de anulación de registro está completa si se han devuelto todas las conexiones a la agrupación de conexiones. Si no se han devuelto todas las conexiones a la agrupación, se devuelve un aviso al emisor de la llamada. El proceso de anulación de registro se completa cuando se ha devuelto la última conexión a la agrupación. Se puede efectuar una segunda solicitud de anulación de registro con el bit force establecido en 1, lo cual fuerza la realización del proceso de anulación del registro y todos los manejadores de conexiones restantes para ese registro se invalidan.
Código de retorno entero que indica si esta llamada se ha realizado de manera satisfactoria o anómala.
rsn (salida)Código de razón de entero que describe la razón de una anomalía en esta llamada.
- Asegúrese de que se ha iniciado el grupo de daemons y el servidor deWebSphere Application Server para z/OS especificados y de que el soporte para los adaptadores locales está habilitado.
- Si no se llama a la API de anulación de registro y termina el espacio de direcciones que ha efectuado una llamada de registro, se realiza automáticamente una llamada de anulación de registro y se liberan las conexiones.
- Los descriptores de conexión de este registro que están activos cuando se produce la llamada de anulación de registro pueden seguir siendo válidos hasta que se devuelven a la agrupación de conexiones mediante la API BBOA1CNR. Para forzar la limpieza de los manejadores de conexiones, se debe efectuar una segunda llamada de anulación de registro, especificando el distintivo force. Esto invalida todos los manejadores de conexiones pendientes.
Código de retorno | Código de razón | Descripción | Acción |
---|---|---|---|
0 | - | Correcta | |
4 | - | Aviso - vea código de razón | |
66 | La llamada de anulación de registro se retarda hasta que se devuelven todas las conexiones a la agrupación. | La anulación de registro se realiza cuando se devuelve la última conexión a la agrupación libre. | |
8 | - | Error - vea código de razón | |
8 | No existe el nombre de señal de registro. | Debe registrar este nombre antes de llamar a la API de anulación del registro. | |
64 | No se puede especificar la opción force hasta que se emita una anulación de registro normal. | Llame a la API de anulación de registro sin especificar la opción force. | |
76 | Ha fallado un intento de comunicación con el servidor porque el servidor ya no está en ejecución. | Inicie el servidor y vuelva a intentar la comunicación. | |
82 | Ya se ha realizado un intento para eliminar este registro. | Espere a que se complete la solicitud previa de anulación de registro o vuelva a emitir esta anulación de registro con la opción force. | |
96 | Esta API no se puede controlar durante la inicialización de IMS (Information Management System) ni durante una salida de inicialización previa de IMS. | Llame a esta API después de que la inicialización de IMS haya finalizado. | |
12 | 34 | Se utiliza un apéndice de la API de 64 bits en un entorno IMS. | Las API de 64 bits no reciben soporte en IMS. |
38 | Se ha utilizado un apéndice de la API de 64 bits en un entorno CICS. | Las API de 64 bits no reciben soporte en CICS. | |
86 | No se ha podido encontrar la BGVT maestra de WebSphere Application Server para z/OS | WebSphere no se ha iniciado todavía en la imagen actual del sistema z/OS. Asegúrese de que se haya iniciado el daemon y un nodo/servidor antes de iniciar cualquier proceso cliente de adaptadores locales optimizados de WebSphere Application Server. | |
88 | No se ha podido encontrar la tabla de apéndices de cliente maestra de WebSphere Application Server para z/OS | Se ha iniciado WebSphere Application Server en la imagen actual del sistema z/OS pero no se está ejecutando a un nivel admitido por la tabla de apéndices cliente de adaptadores locales optimizados. Posiblemente esté ejecutando la interfaz de apéndices de adaptadores locales optimizados de la versión 8.0.0.1 de WebSphere Application Server que no es compatible con el nivel de mantenimiento del servidor de aplicaciones. Para utilizar los apéndices de adaptadores locales optimizados de la versión 8.0.0.1, el servidor de aplicaciones también tiene que estar ejecutando el nivel de la versión 8.0.0 de WebSphere Application Server . Asegúrese de que su aplicación se esté ejecutando en el nivel compatible de los apéndices de adaptadores locales optimizados para WebSphere Application Server en este sistema z/OS. | |
90 | No se ha podido encontrar la ranura de la tabla de apéndices de cliente maestra de adaptadores locales optimizados de WebSphere Application Server para z/OS. | Se ha iniciado WebSphere Application Server en la imagen actual del sistema z/OS pero no se está ejecutando a un nivel admitido por la tabla de apéndices cliente de adaptadores locales optimizados. Posiblemente esté ejecutando la interfaz de apéndices de adaptadores locales optimizados de la versión 8.0.0.1 de WebSphere Application Server que no es compatible con el nivel de mantenimiento del servidor de aplicaciones. Para utilizar los apéndices de adaptadores locales optimizados de la versión 8.0.0.1, el servidor de aplicaciones también tiene que estar ejecutando el nivel de la versión 8.0.0 de WebSphere Application Server . Asegúrese de que su aplicación se esté ejecutando en el nivel compatible de los apéndices de adaptadores locales optimizados para WebSphere Application Server en este sistema z/OS. |
Obtención de conexión
Esta API solicita que se devuelva una conexión disponible de la agrupación creada con el nombre de registro seleccionado.API | Sintaxis |
---|---|
BBOA1CNG o BBGA1CNG | BBOA1CNG ( registername, connectionhandle, waittime, rc, rsn ) BBGA1CNG ( registername, connectionhandle, waittime, rc, rsn ) |
Parámetros:
registername (entrada)Variable de entrada o constante de entrada que contiene el nombre que se debe utilizar para localizar la agrupación de conexiones de la que se debe recuperar una conexión. Debe ser una serie rellena de espacios en blanco de 12 caracteres exactamente.
connectionhandle (salida)Manejador de conexiones de 12 bytes que se debe pasar en posteriores solicitudes de acciones en esta conexión.
waittime (entrada)Entero que contiene el número de segundos que se deben esperar a que se complete la conexión antes de devolver un código de razón de conexión no disponible. Un valor 0 implica que no hay tiempo de espera y que la API espera indefinidamente.
rc (salida)Código de retorno entero que indica si esta llamada se ha realizado de manera satisfactoria o anómala.
rsn (salida)Código de razón de entero que describe la razón de una anomalía en esta llamada.
- Asegúrese de que se ha iniciado el grupo de daemons y el servidor deWebSphere Application Server para z/OS especificados y de que el soporte para los adaptadores locales está habilitado.
- Asegúrese de que se ha completado una llamada de registro (BBOA1REG) satisfactoria en el espacio de direcciones actual con un nombre coincidente antes de utilizar la API de obtención de conexión.
Código de retorno | Código de razón | Descripción | Acción |
---|---|---|---|
0 | - | Correcta | |
4 | - | Aviso - vea código de razón | |
8 | - | Error - vea código de razón | |
8 | La señal de nombre de registro no existe. | Asegúrese de haber registrado este nombre antes de intentar llamar al nombre con la API de obtención de conexión. | |
10 | La conexión no está disponible. El tiempo de espera ha caducado antes de que se pudiera obtener la solicitud de conexión. | El comportamiento de la aplicación varía. Espere y vuelva a intentarlo o termine anormalmente esta conexión. Otra opción es aumentar el valor de número máximo de conexiones en la llamada de API de registro. | |
24 | Después de una llamada de registro satisfactoria, se ha producido un error al obtener una conexión de la agrupación. | Verifique que se inicie el servidor. Si no funciona, reinicie el servidor y vuelva a intentar la solicitud de API. | |
28 | Se ha encontrado el registro, pero está inactivo. | ||
96 | Esta API no se puede controlar durante la inicialización de IMS ni durante una salida de inicialización previa de IMS. | Llame a esta API después de que la inicialización de IMS haya finalizado. | |
12 | 10 | No se puede localizar el grupo de daemons o el servidor de WebSphere Application Server . | Asegúrese de que el daemon y el servidor de WebSphere Application Server se hayan iniciado y que el soporte de conexiones locales esté activo y vuelva a intentar la operación. |
34 | Se utiliza un apéndice de la API de 64 bits en un entorno IMS. | Las API de 64 bits no reciben soporte en IMS. | |
38 | Se ha utilizado un apéndice de la API de 64 bits en un entorno CICS. | Las API de 64 bits no reciben soporte en CICS. | |
86 | No se ha podido encontrar la BGVT maestra de WebSphere Application Server para z/OS | WebSphere no se ha iniciado todavía en la imagen actual del sistema z/OS. Asegúrese de que se haya iniciado el daemon y un nodo/servidor antes de iniciar cualquier proceso cliente de adaptadores locales optimizados de WebSphere Application Server. | |
88 | No se ha podido encontrar la tabla de apéndices de cliente maestra de WebSphere Application Server para z/OS | Se ha iniciado WebSphere Application Server en la imagen actual del sistema z/OS pero no se está ejecutando a un nivel admitido por la tabla de apéndices cliente de adaptadores locales optimizados. Posiblemente esté ejecutando la interfaz de apéndices de adaptadores locales optimizados de la versión 8.0.0.1 de WebSphere Application Server que no es compatible con el nivel de mantenimiento del servidor de aplicaciones. Para utilizar los apéndices de adaptadores locales optimizados de la versión 8.0.0.1, el servidor de aplicaciones también tiene que estar ejecutando el nivel de la versión 8.0.0 de WebSphere Application Server . Asegúrese de que su aplicación se esté ejecutando en el nivel compatible de los apéndices de adaptadores locales optimizados para WebSphere Application Server en este sistema z/OS. | |
90 | No se ha podido encontrar la ranura de la tabla de apéndices de cliente maestra de adaptadores locales optimizados de WebSphere Application Server para z/OS. | Se ha iniciado WebSphere Application Server en la imagen actual del sistema z/OS pero no se está ejecutando a un nivel admitido por la tabla de apéndices cliente de adaptadores locales optimizados. Posiblemente esté ejecutando la interfaz de apéndices de adaptadores locales optimizados de la versión 8.0.0.1 de WebSphere Application Server que no es compatible con el nivel de mantenimiento del servidor de aplicaciones. Para utilizar los apéndices de adaptadores locales optimizados de la versión 8.0.0.1, el servidor de aplicaciones también tiene que estar ejecutando el nivel de la versión 8.0.0 de WebSphere Application Server . Asegúrese de que su aplicación se esté ejecutando en el nivel compatible de los apéndices de adaptadores locales optimizados para WebSphere Application Server en este sistema z/OS. |
Liberación de conexión
La API de liberación de conexión solicita que se devuelva una conexión a la agrupación de la que se ha recuperado, para que pase a estar disponible para otro solicitante.API | Sintaxis |
---|---|
BBOA1CNR o BBGA1CNR | BBOA1CNR ( connectionhandle, rc, rsn ) BBGA1CNR ( connectionhandle, rc, rsn ) |
Parámetros:
connectionhandle (entrada)Manejador de conexiones de 12 bytes que indica la conexión obtenida anteriormente que se debe volver a liberar en la agrupación de conexiones.
rc (salida)Código de retorno entero que indica si esta llamada se ha realizado de manera satisfactoria o anómala.
rsn (salida)Un código de razón entero que describe la razón por la que ha fallado la llamada.
- Asegúrese de que hayan iniciado el grupo de daemons y el servidor de WebSphere Application Server para z/OS que se especifican en esta llamada y que esté habilitado el soporte para los adaptadores locales.
- Antes de utilizar la API de liberación de conexión, asegúrese de que se haya completado una llamada (API BBOA1REG o BBGA1REG) de registro satisfactoria en el espacio de direcciones actual con un nombre coincidente y que se haya completado una llamada (BBOA1CNG o BBGA1CNG) de obtención de conexión satisfactoria para obtener la conexión que ahora se debe liberar.
Código de retorno | Código de razón | Descripción | Acción |
---|---|---|---|
0 | - | Correcta | |
4 | - | No se puede localizar el grupo de daemons ni el servidor de WebSphere Application Server . Se han borrado los recursos que están relacionados con esta conexión. | Ninguno |
8 | - | Error - vea código de razón | |
36 | El estado de conexión no es válido. | El manejador de conexiones que se utiliza para esta solicitud está en un estado incorrecto. Consulte la documentación de la API para conocer las reglas sobre los estados de conexión. | |
38 | El manejador de conexiones de cliente no es válido. | El manejador de conexiones de cliente que se utiliza para esta solicitud no es válido. Consulte la documentación de la API para obtener información sobre los manejadores de conexiones de cliente. | |
96 | Esta API no se puede controlar durante la inicialización de IMS ni durante una salida de inicialización previa de IMS. | Llame a esta API después de que la inicialización de IMS haya finalizado. | |
12 | 14 | No se puede localizar o verificar el vector de llamada de API que utiliza el manejador de conexiones proporcionado. | El manejador de conexiones no es válido o una llamada de anulación de registro (API BBOA1URG) puede haber invalidado la agrupación de conexiones. |
34 | Se utiliza un apéndice de la API de 64 bits en un entorno IMS. | Las API de 64 bits no reciben soporte en IMS. | |
38 | Se ha utilizado un apéndice de la API de 64 bits en un entorno CICS. | Las API de 64 bits no reciben soporte en CICS. | |
86 | No se ha podido encontrar la BGVT maestra de WebSphere Application Server para z/OS | WebSphere no se ha iniciado todavía en la imagen actual del sistema z/OS. Asegúrese de que se haya iniciado el daemon y un nodo/servidor antes de iniciar cualquier proceso cliente de adaptadores locales optimizados de WebSphere Application Server. | |
88 | No se ha podido encontrar la tabla de apéndices de cliente maestra de WebSphere Application Server para z/OS | Se ha iniciado WebSphere Application Server en la imagen actual del sistema z/OS pero no se está ejecutando a un nivel admitido por la tabla de apéndices cliente de adaptadores locales optimizados. Posiblemente esté ejecutando la interfaz de apéndices de adaptadores locales optimizados de la versión 8.0.0.1 de WebSphere Application Server que no es compatible con el nivel de mantenimiento del servidor de aplicaciones. Para utilizar los apéndices de adaptadores locales optimizados de la versión 8.0.0.1, el servidor de aplicaciones también tiene que estar ejecutando el nivel de la versión 8.0.0 de WebSphere Application Server . Asegúrese de que su aplicación se esté ejecutando en el nivel compatible de los apéndices de adaptadores locales optimizados para WebSphere Application Server en este sistema z/OS. | |
90 | No se ha podido encontrar la ranura de la tabla de apéndices de cliente maestra de adaptadores locales optimizados de WebSphere Application Server para z/OS. | Se ha iniciado WebSphere Application Server en la imagen actual del sistema z/OS pero no se está ejecutando a un nivel admitido por la tabla de apéndices cliente de adaptadores locales optimizados. Posiblemente esté ejecutando la interfaz de apéndices de adaptadores locales optimizados de la versión 8.0.0.1 de WebSphere Application Server que no es compatible con el nivel de mantenimiento del servidor de aplicaciones. Para utilizar los apéndices de adaptadores locales optimizados de la versión 8.0.0.1, el servidor de aplicaciones también tiene que estar ejecutando el nivel de la versión 8.0.0 de WebSphere Application Server . Asegúrese de que su aplicación se esté ejecutando en el nivel compatible de los apéndices de adaptadores locales optimizados para WebSphere Application Server en este sistema z/OS. |
Envío de solicitud
Estas API envían una solicitud al WebSphere Application Server local para su proceso.API | Sintaxis |
---|---|
BBOA1SRQ o BBGA1SRQ | BBOA1SRQ ( connectionhandle, requesttype, requestservicename, requestservicenamel, requestdata, requestdatalen, async(0|1), responsedatalen, rc, rsn ) BBGA1SRQ ( connectionhandle, requesttype, requestservicename, requestservicenamel, requestdata, requestdatalen, async(0|1), responsedatalen, rc, rsn ) |
Parámetros:
connectionhandle (entrada)Manejador de conexiones de 12 bytes que se debe utilizar para esta solicitud.
requesttype (entrada)Un entero que contiene el tipo de solicitud que indica el tipo de solicitud de trabajo que se debe procesar. Valores de tipo soportados: 1 = solicitudes de trabajos EJB local, 2 = solicitudes de trabajo EJB remoto.
requestservicename (entrada)Serie de caracteres EBCDIC de una longitud máxima de 256 bytes que contiene el nombre del servicio que se deben invocar. Para Type=1, EJB y Type 2, EJB remoto, es el nombre de inicio JNDI del destino.
requestservicenamel (entero)Entero que contiene la longitud del nombre de servicio a iniciar o 0 (cero) si el nombre de servicio termina en nulo.
requestdata (entrada)Puntero de 31 bits o de 64 bits a la dirección del inicio de los datos de solicitud a enviar.
requestdatalen (entrada)Un valor no firmado de 32 bits en modalidad de 31 bits o un valor no firmado de 64 bits en modalidad de 64 bits que contiene la longitud de los datos a enviar.
async(0|1) (entrada)Valor entero que cuando se establece en 1 indica que el emisor de la llamada desea que se devuelva el control inmediatamente, incluso aunque no se conozca aún la longitud de respuesta. Para async(0), la hebra actual solicita que se espere la devolución de una respuesta de WebSphere Application Server y la longitud de la respuesta se devuelve en el argumento de salida longDatosRespuesta.
responsedatalen (salida)Un valor no firmado de 32 bits en modalidad de 31 bits o un valor no firmado de 64 bits en modalidad de 64 bits que contiene la longitud de la respuesta. Entonces el emisor de la llamada puede utilizar esta longitud para adquirir almacenamiento antes de llamar a la API de obtención de datos para copiarlo en ella. Cuando async se establece en 1, que indica que el emisor de la llamada desea que se devuelva el control inmediatamente, este valor se establece en 0xFF si la respuesta aún no se ha recibido.
rc (salida)Código de retorno entero que indica si esta llamada se ha realizado de manera satisfactoria o anómala.
rsn (salida)Código de razón de entero que describe la razón de una anomalía en esta llamada.
- Asegúrese de que se ha iniciado el grupo de daemons y el servidor deWebSphere Application Server para z/OS especificados y de que el soporte para los adaptadores locales está habilitado.
- Asegúrese de que se ha completado una llamada de registro (BBOA1REG) satisfactoria en el espacio de direcciones actual con un nombre coincidente antes de utilizar la API de envío de solicitud.
Código de retorno | Código de razón | Descripción | Acción |
---|---|---|---|
0 | - | Correcta | |
4 | - | Aviso - vea código de razón | |
8 | - | Error - vea código de razón | |
8 | La señal de nombre de registro ya existe. | Asegúrese de que el nombre de registro pasado es válido. | |
14 | Se ha producido una condición de escasez de memoria mientras se guardaba el mensaje. | No hay suficiente memoria disponible para que el envío de solicitud procese el mensaje. El espacio de direcciones actual se ha quedado sin almacenamiento privado. | |
16 | La longitud de nombre de servicio de solicitud no es válida. | Corrija el programa y vuelva a intentarlo. | |
18 | La longitud de solicitud excede los límites de sistema. | El tamaño de mensaje es mayor que el tamaño que WebSphere Application Server puede soportar. Verifique que el tamaño sea válido. Si el tamaño es válido, asegúrese de que el tamaño de WebSphere Application Server es suficientemente grande para dar cabida al tamaño de mensaje. | |
26 | La transacción global no ha podido empezar. | ||
32 | El tipo de solicitud de llamada de API no es válido. | El tipo de solicitud no es válido. Corrija el programa y vuelva a intentar la llamada. | |
34 | No se encuentra el servicio de destino. | Asegúrese de que la aplicación que contiene el enterprise bean de destino se ha instalado e iniciado en el servidor de destino para WebSphere Application Server. | |
36 | El estado de conexión no es válido. | El manejador de conexiones que se utiliza para la solicitud está en un estado incorrecto. Consulte la documentación de la API para conocer las reglas sobre los estados de conexión. | |
38 | El manejador de conexiones de cliente no es válido. | El manejador de conexiones de cliente que se utiliza para la solicitud no es válido. Consulte la documentación de la API para obtener información sobre los manejadores de conexiones de cliente. | |
40 | Se ha producido un error de comunicaciones locales. | Consulte en el registro cronológico de servidor de WebSphere Application Server los mensajes de error de comunicaciones locales. | |
44 | Se ha producido una excepción o una condición inesperada en el enterprise bean de destino. | Consulte el registro cronológico de WebSphere Application Server para revisar los datos de excepción. | |
46 | Se ha producido un error en la llamada de envío de solicitud de comunicaciones locales. | Consulte el registro cronológico de WebSphere Application Server para determinar el error. | |
96 | Esta API no se puede controlar durante la inicialización de IMS ni durante una salida de inicialización previa de IMS. | Llame a esta API después de que la inicialización de IMS haya finalizado. | |
98 | No se ha podido acceder al inicio del almacenamiento intermedio de la solicitud proporcionado. | Asegúrese de que la dirección y la longitud del almacenamiento intermedio de la solicitud proporcionado sean correctos. | |
100 | No se ha podido acceder al final del almacenamiento intermedio de la solicitud proporcionado. | Asegúrese de que la dirección y la longitud del almacenamiento intermedio de la solicitud proporcionado sean correctos. | |
12 | 10 | No se puede localizar el grupo de daemons o el servidor de WebSphere Application Server . | Asegúrese de que el daemon y el servidor de WebSphere Application Server se hayan iniciado y que el soporte de conexiones locales esté activo. Vuelva a intentar localizar el grupo de daemons y el servidor de WebSphere Application Server. |
14 | No se puede localizar o verificar el vector de llamada de API que utiliza el manejador de conexiones proporcionado. | El manejador de conexiones no es válido o una llamada de anulación de registro (API BBOA1URG) puede haber invalidado la agrupación de conexiones. | |
34 | Se utiliza un apéndice de la API de 64 bits en un entorno IMS. | Las API de 64 bits no reciben soporte en IMS. | |
38 | Se ha utilizado un apéndice de la API de 64 bits en un entorno CICS. | Las API de 64 bits no reciben soporte en CICS. | |
86 | No se ha podido encontrar la BGVT maestra de WebSphere Application Server para z/OS | WebSphere no se ha iniciado todavía en la imagen actual del sistema z/OS. Asegúrese de que se haya iniciado el daemon y un nodo/servidor antes de iniciar cualquier proceso cliente de adaptadores locales optimizados de WebSphere Application Server. | |
88 | No se ha podido encontrar la tabla de apéndices de cliente maestra de WebSphere Application Server para z/OS | Se ha iniciado WebSphere Application Server en la imagen actual del sistema z/OS pero no se está ejecutando a un nivel admitido por la tabla de apéndices cliente de adaptadores locales optimizados. Posiblemente esté ejecutando la interfaz de apéndices de adaptadores locales optimizados de la versión 8.0.0.1 de WebSphere Application Server que no es compatible con el nivel de mantenimiento del servidor de aplicaciones. Para utilizar los apéndices de adaptadores locales optimizados de la versión 8.0.0.1, el servidor de aplicaciones también tiene que estar ejecutando el nivel de la versión 8.0.0 de WebSphere Application Server . Asegúrese de que su aplicación se esté ejecutando en el nivel compatible de los apéndices de adaptadores locales optimizados para WebSphere Application Server en este sistema z/OS. | |
90 | No se ha podido encontrar la ranura de la tabla de apéndices de cliente maestra de adaptadores locales optimizados de WebSphere Application Server para z/OS. | Se ha iniciado WebSphere Application Server en la imagen actual del sistema z/OS pero no se está ejecutando a un nivel admitido por la tabla de apéndices cliente de adaptadores locales optimizados. Posiblemente esté ejecutando la interfaz de apéndices de adaptadores locales optimizados de la versión 8.0.0.1 de WebSphere Application Server que no es compatible con el nivel de mantenimiento del servidor de aplicaciones. Para utilizar los apéndices de adaptadores locales optimizados de la versión 8.0.0.1, el servidor de aplicaciones también tiene que estar ejecutando el nivel de la versión 8.0.0 de WebSphere Application Server . Asegúrese de que su aplicación se esté ejecutando en el nivel compatible de los apéndices de adaptadores locales optimizados para WebSphere Application Server en este sistema z/OS. |
Envío de respuesta
Esta API devuelve una respuesta a una solicitud al WebSphere Application Server local.API | Sintaxis |
---|---|
BBOA1SRP o BBGA1SRP | BBOA1SRP ( connectionhandle, responsedata, responsedatalen, rc, rsn ) BBGA1SRP ( connectionhandle, responsedata, responsedatalen, rc, rsn ) |
Parámetros:
connectionhandle (entrada)Manejador de conexiones de 12 bytes que se debe utilizar para esta respuesta.
responsedata (entrada)Puntero de 31 bits o de 64 bits a la dirección del inicio de los datos de respuesta a enviar.
responsedatalen (entrada)Un valor no firmado de 32 bits en modalidad de 31 bits o un valor no firmado de 64 bits en modalidad de 64 bits que contiene la longitud de los datos a enviar.
rc (salida)Código de retorno entero que indica si esta llamada se ha realizado de manera satisfactoria o anómala.
rsn (salida)Código de razón de entero que describe la razón de una anomalía en esta llamada.
- Asegúrese de que se ha iniciado el grupo de daemons y el servidor deWebSphere Application Server para z/OS especificados y de que el soporte para los adaptadores locales está habilitado.
- Asegúrese de que se ha completado una llamada de registro (API BBOA1REG o BBGA1REG) satisfactoria en el espacio de direcciones actual con un nombre coincidente antes de utilizar la API de envío de respuesta.
- Asegúrese de que se ha completado una llamada de obtención de conexión (BBOA1CNG o BBGA1CNG) satisfactoria y de que se proporciona el manejador como entrada en esta llamada.
- Asegúrese de que se ha emitido una llamada satisfactoria de API de Recepción de solicitud cualquiera, Recepción de solicitud específica o Host y de que se ha devuelto dicha llamada con datos de solicitud para el descriptor de conexiones. La conexión debe estar en un estado en el que la API de envío de respuesta sea válida.
Código de retorno | Código de razón | Descripción | Acción |
---|---|---|---|
0 | - | Correcta | |
4 | - | Aviso - vea código de razón | |
8 | - | Error - vea código de razón | |
8 | La señal de nombre de registro ya existe. | Asegúrese de que el nombre de registro pasado es válido. | |
14 | Se ha producido una condición de escasez de memoria mientras se guardaba el mensaje. | No hay suficiente memoria disponible para que el envío de respuesta procese el mensaje. El espacio de direcciones actual se ha quedado sin almacenamiento privado. | |
18 | La longitud de respuesta excede los límites de sistema. | El tamaño de mensaje es mayor que el tamaño que WebSphere Application Server puede soportar. Verifique que el tamaño sea válido. Si el tamaño es válido, asegúrese de que el tamaño de WebSphere Application Server es suficientemente grande para dar cabida al tamaño de mensaje. | |
34 | No se encuentra el servicio de destino. | Asegúrese de que la aplicación que contiene el EJB de destino se ha instalado e iniciado en el WebSphere Application Server de destino. | |
36 | El estado de conexión no es válido. | El manejador de conexiones utilizado para esta solicitud está en un estado incorrecto. Consulte la documentación de la API para conocer las reglas sobre los estados de conexión. | |
38 | El manejador de conexiones de cliente no es válido. | El manejador de conexiones de cliente utilizado para esta solicitud no es válido. Consulte la documentación de la API para obtener información sobre los manejadores de conexiones de cliente. | |
40 | Se ha producido un error de comunicaciones locales. | Consulte en el registro cronológico de servidor de WebSphere Application Server los mensajes de error de comunicaciones locales. | |
46 | Se ha producido un error en la llamada de envío de solicitud de comunicaciones locales. | Consulte el registro cronológico de WebSphere Application Server para determinar el error. | |
96 | Esta API no se puede controlar durante la inicialización de IMS ni durante una salida de inicialización previa de IMS. | Llame a esta API después de que la inicialización de IMS haya finalizado. | |
102 | No se ha podido acceder al inicio del almacenamiento intermedio de la respuesta proporcionado. | Asegúrese de que la dirección y la longitud del almacenamiento intermedio de la respuesta proporcionado sean correctos. | |
104 | No se ha podido acceder al final del almacenamiento intermedio de la respuesta proporcionado. | Asegúrese de que la dirección y la longitud del almacenamiento intermedio de la respuesta proporcionado sean correctos. | |
12 | 10 | No se puede localizar el grupo de daemons o el servidor de WebSphere Application Server . | Asegúrese de que el daemon y el servidor de WebSphere Application Server se hayan iniciado y que el soporte de conexiones locales esté activo y vuelva a intentar la llamada. |
14 | No se puede localizar o verificar el vector de llamada de API que utiliza el manejador de conexiones proporcionado. | El manejador de conexiones no es válido o es posible que una llamada de anulación de registro (BBOA1URG) haya invalidado la agrupación de conexiones. | |
34 | Se utiliza un apéndice de la API de 64 bits en un entorno IMS. | Las API de 64 bits no reciben soporte en IMS. | |
38 | Se ha utilizado un apéndice de la API de 64 bits en un entorno CICS. | Las API de 64 bits no reciben soporte en CICS. | |
86 | No se ha podido encontrar la BGVT maestra de WebSphere Application Server para z/OS | WebSphere no se ha iniciado todavía en la imagen actual del sistema z/OS. Asegúrese de que se haya iniciado el daemon y un nodo/servidor antes de iniciar cualquier proceso cliente de adaptadores locales optimizados de WebSphere Application Server. | |
88 | No se ha podido encontrar la tabla de apéndices de cliente maestra de WebSphere Application Server para z/OS | Se ha iniciado WebSphere Application Server en la imagen actual del sistema z/OS pero no se está ejecutando a un nivel admitido por la tabla de apéndices cliente de adaptadores locales optimizados. Posiblemente esté ejecutando la interfaz de apéndices de adaptadores locales optimizados de la versión 8.0.0.1 de WebSphere Application Server que no es compatible con el nivel de mantenimiento del servidor de aplicaciones. Para utilizar los apéndices de adaptadores locales optimizados de la versión 8.0.0.1, el servidor de aplicaciones también tiene que estar ejecutando el nivel de la versión 8.0.0 de WebSphere Application Server . Asegúrese de que su aplicación se esté ejecutando en el nivel compatible de los apéndices de adaptadores locales optimizados para WebSphere Application Server en este sistema z/OS. | |
90 | No se ha podido encontrar la ranura de la tabla de apéndices de cliente maestra de adaptadores locales optimizados de WebSphere Application Server para z/OS. | Se ha iniciado WebSphere Application Server en la imagen actual del sistema z/OS pero no se está ejecutando a un nivel admitido por la tabla de apéndices cliente de adaptadores locales optimizados. Posiblemente esté ejecutando la interfaz de apéndices de adaptadores locales optimizados de la versión 8.0.0.1 de WebSphere Application Server que no es compatible con el nivel de mantenimiento del servidor de aplicaciones. Para utilizar los apéndices de adaptadores locales optimizados de la versión 8.0.0.1, el servidor de aplicaciones también tiene que estar ejecutando el nivel de la versión 8.0.0 de WebSphere Application Server . Asegúrese de que su aplicación se esté ejecutando en el nivel compatible de los apéndices de adaptadores locales optimizados para WebSphere Application Server en este sistema z/OS. |
Envío de excepción de respuesta
Esta API envía datos de respuesta de excepción al emisor de la llamada JCA en WebSphere Application Server. La respuesta es una excepción ResourceAdapterException que devuelve los datos de respuesta de excepción especificados.
API | Sintaxis |
---|---|
BBOA1SRX o BBGA1SRX | BBOA1SRX ( connectionhandle, excresponsedata, exresponsedatalen, rc, rsn ) BBGA1SRX ( connectionhandle, excresponsedata, exresponsedatalen, rc, rsn ) |
Parámetros:
connectionhandle (entrada)Manejador de conexiones de 12 bytes que se utiliza para la respuesta.
excresponsedata (entrada)Especifica un puntero de 31 bits o de 64 bits a la dirección del inicio de los datos de respuesta de excepción que se deben enviar.
excresponsedatalen (entrada)Especifica un valor no firmado de 32 bits en modalidad de 31 bits o un valor no firmado de 64 bits en modalidad de 64 bits de la longitud de los datos de respuesta de excepción que se deben enviar. Los datos de respuesta de excepción son una serie EBCDIC que describe el error.
rc (salida)Código de retorno entero que indica si esta llamada se ha realizado de manera satisfactoria o anómala.
rsn (salida)Código de razón de entero que describe la razón de una anomalía en esta llamada.
- Asegúrese de que hayan iniciado el grupo de daemons y el servidor de WebSphere Application Server para z/OS que se especifican en esta llamada y que esté habilitado el soporte para los adaptadores locales.
- Asegúrese de que se ha completado una llamada de registro (API BBOA1REG o BBGAREG) satisfactoria en el espacio de direcciones actual con un nombre coincidente antes de utilizar la llamada de envío de respuesta.
- Asegúrese de que se ha completado una llamada de obtención de conexión (API BBOA1CNG o BBGA1CNG) satisfactoria y de que se proporciona el manejador para ello como entrada en esta llamada.
- Asegúrese de que se ha emitido una llamada satisfactoria de API de Recepción de solicitud cualquiera, Recepción de solicitud específica o Host, y de que se ha devuelto dicha llamada con datos de solicitud para el manejador de conexiones. La conexión debe estar en un estado en el que las API de envío de respuesta y de envío de excepción de respuesta sean válidas.
Código de retorno | Código de razón | Descripción | Acción |
---|---|---|---|
0 | - | Correcta | |
4 | - | Aviso - vea código de razón | |
8 | - | Error - vea código de razón | |
8 | La señal de nombre de registro ya existe. | Asegúrese de que el nombre de registro pasado es válido. | |
10 | El manejador de conexiones está en un estado liberado o no válido. | Asegúrese de que se ha pasado un manejador de conexiones adecuado. | |
14 | Se ha producido una condición de escasez de memoria mientras se guardaba el mensaje. | No hay suficiente memoria disponible para que el envío de excepción de respuesta procese el mensaje. El espacio de direcciones actual se ha quedado sin almacenamiento privado. | |
16 | Uno o varios parámetros no son válido. | Verifique que todos los parámetros sean válidos e intente efectuar de nuevo la llamada. | |
18 | La longitud de respuesta excede los límites de sistema. | El tamaño de mensaje es mayor que el tamaño que WebSphere Application Server puede soportar. Verifique que el tamaño sea válido. Si el tamaño es válido, asegúrese de que el tamaño de WebSphere Application Server es suficientemente grande para dar cabida al tamaño de mensaje. | |
20 | Uno o varios parámetros no son válido. | Verifique que todos los parámetros sean válidos e intente efectuar de nuevo la llamada. | |
28 | El registro con el que el manejador de conexiones estaba asociado ya no está activo. | Llame otra vez el registro con el nombre de registro antes de realizar las llamadas de obtención de conexión y de solicitud de conexión. | |
36 | El estado de conexión no es válido. | El manejador de conexiones utilizado para esta solicitud está en un estado incorrecto. Consulte la documentación de la API para conocer las reglas sobre los estados de conexión. | |
38 | El manejador de conexiones de cliente no es válido. | El manejador de conexiones de cliente utilizado para esta solicitud no es válido. Consulte la documentación de la API para obtener información sobre los manejadores de conexiones de cliente. | |
40 | Se ha producido un error de comunicaciones locales. | Consulte en el registro cronológico de servidor de WebSphere Application Server los mensajes de error de comunicaciones locales. | |
46 | Se ha producido un error en la llamada de envío de solicitud de comunicaciones locales. | Consulte el registro cronológico de WebSphere Application Server para determinar el error. | |
96 | Esta API no se puede controlar durante la inicialización de IMS ni durante una salida de inicialización previa de IMS. | Llame a esta API después de que la inicialización de IMS haya finalizado. | |
102 | No se ha podido acceder al inicio del almacenamiento intermedio de la respuesta proporcionado. | Asegúrese de que la dirección y la longitud del almacenamiento intermedio de la respuesta proporcionado sean correctos. | |
104 | No se ha podido acceder al final del almacenamiento intermedio de la respuesta proporcionado. | Asegúrese de que la dirección y la longitud del almacenamiento intermedio de la respuesta proporcionado sean correctos. | |
12 | 10 | No se puede localizar el grupo de daemons o el servidor de WebSphere Application Server . | Asegúrese de que el daemon y el servidor de WebSphere Application Server se hayan iniciado y que el soporte de conexiones locales esté activo y vuelva a intentar la llamada. |
14 | No se puede localizar o verificar el vector de llamada de API que utiliza el manejador de conexiones proporcionado. | El manejador de conexiones no es válido o una llamada de anulación de registro (API BBOA1URG) puede haber invalidado la agrupación de conexiones. | |
34 | Se utiliza un apéndice de la API de 64 bits en un entorno IMS. | Las API de 64 bits no reciben soporte en IMS. | |
38 | Se ha utilizado un apéndice de la API de 64 bits en un entorno CICS. | Las API de 64 bits no reciben soporte en CICS. | |
86 | No se ha podido encontrar la BGVT maestra de WebSphere Application Server para z/OS | WebSphere no se ha iniciado todavía en la imagen actual del sistema z/OS. Asegúrese de que se haya iniciado el daemon y un nodo/servidor antes de iniciar cualquier proceso cliente de adaptadores locales optimizados de WebSphere Application Server. | |
88 | No se ha podido encontrar la tabla de apéndices de cliente maestra de WebSphere Application Server para z/OS | Se ha iniciado WebSphere Application Server en la imagen actual del sistema z/OS pero no se está ejecutando a un nivel admitido por la tabla de apéndices cliente de adaptadores locales optimizados. Posiblemente esté ejecutando la interfaz de apéndices de adaptadores locales optimizados de la versión 8.0.0.1 de WebSphere Application Server que no es compatible con el nivel de mantenimiento del servidor de aplicaciones. Para utilizar los apéndices de adaptadores locales optimizados de la versión 8.0.0.1, el servidor de aplicaciones también tiene que estar ejecutando el nivel de la versión 8.0.0 de WebSphere Application Server . Asegúrese de que su aplicación se esté ejecutando en el nivel compatible de los apéndices de adaptadores locales optimizados para WebSphere Application Server en este sistema z/OS. | |
90 | No se ha podido encontrar la ranura de la tabla de apéndices de cliente maestra de adaptadores locales optimizados de WebSphere Application Server para z/OS. | Se ha iniciado WebSphere Application Server en la imagen actual del sistema z/OS pero no se está ejecutando a un nivel admitido por la tabla de apéndices cliente de adaptadores locales optimizados. Posiblemente esté ejecutando la interfaz de apéndices de adaptadores locales optimizados de la versión 8.0.0.1 de WebSphere Application Server que no es compatible con el nivel de mantenimiento del servidor de aplicaciones. Para utilizar los apéndices de adaptadores locales optimizados de la versión 8.0.0.1, el servidor de aplicaciones también tiene que estar ejecutando el nivel de la versión 8.0.0 de WebSphere Application Server . Asegúrese de que su aplicación se esté ejecutando en el nivel compatible de los apéndices de adaptadores locales optimizados para WebSphere Application Server en este sistema z/OS. |
Recepción de solicitud cualquiera
Reciba una solicitud de un servidor WebSphere Application Server local en cualquier conexión. Reciba una solicitud y datos relacionados en cualquier conexión disponible de la agrupación para el nombre de registro pasado. Devuelve la longitud de datos de solicitud como un parámetro de salida. Un manejador de conexiones es también un parámetro de salida devuelto al emisor de llamada. Una llamada de API de obtención de datos con el manejador de conexiones devuelto devuelve los datos de mensaje recibidos.
API | Sintaxis |
---|---|
BBOA1RCA o BBGA1RCA | BBOA1RCA ( registername, connectionhandle, requestservicename, requestservicenamel, requestdatalen, waittime, rc, rsn ) BBGA1RCA ( registername, connectionhandle, requestservicename, requestservicenamel, requestdatalen, waittime, rc, rsn ) |
Parámetros:
registername (entrada)Variable de entrada o constante de entrada que contiene el nombre que se debe utilizar para localizar la agrupación de conexiones de la que se debe recuperar una conexión. Debe ser una serie rellena de espacios en blanco de 12 caracteres exactamente.
connectionhandle (salida)Manejador de conexiones de 12 bytes que se devuelve y se debe pasar en posteriores solicitudes de acciones en esta conexión.
requestservicename (entrada/salida)Serie de caracteres EBCDIC de un máximo de 256 bytes que contiene el nombre del servicio. Es el nombre del servicio de destino especificado en InteractionSpec por la aplicación WebSphere Application Server. El valor * indica un solicitud de recepción para todos los nombres de servicio que llegan en el nombre de registro actual.
requestservicenamel (entrada/salida)Entero que contiene la longitud del nombre de servicio a iniciar o 0 si el nombre de servicio termina en nulo.
requestdatalen (salida)Se devuelve un valor no firmado de 32 bits en modalidad de 31 bits o un valor no firmado de 64 bits en modalidad de 64 bits que contiene la longitud de los datos que se deben recibir.
waittime (entrada)Entero que contiene el número de segundos que se deben esperar a que se complete la conexión antes de devolver un código de razón de conexión no disponible. Un valor de 0 indica que no hay tiempo de espera y que la API espera indefinidamente.
rc (salida)Código de retorno entero que indica si esta llamada se ha realizado de manera satisfactoria o anómala.
rsn (salida)Código de razón de entero que describe la razón de una anomalía en esta llamada.
- Asegúrese de que se ha iniciado el grupo de daemons y el servidor deWebSphere Application Server para z/OS especificados y de que el soporte para los adaptadores locales está habilitado.
- Asegúrese de que se ha completado una llamada de registro (API BBOA1REG o BBGA1REG) satisfactoria en el espacio de direcciones actual con un nombre coincidente antes de utilizar esta API.
Código de retorno | Código de razón | Descripción | Acción |
---|---|---|---|
0 | - | Correcta | |
4 | - | Aviso - vea código de razón | |
8 | - | Error - vea código de razón | |
8 | La señal de nombre de registro ya existe. | Asegúrese de que el nombre de registro pasado es válido. | |
11 | Se han enviado datos erróneos de WebSphere Application Server | ||
16 | La longitud de nombre de servicio de solicitud no es válida. | Corrija el programa y vuelva a intentar la llamada. | |
19 | Anomalía de datos existentes de comunicaciones locales | ||
21 | Anomalía de datos de vista previa de comunicaciones locales | ||
38 | El manejador de conexiones de cliente no es válido. | Se ha determinado que el manejador de conexiones de cliente utilizado para esta solicitud no es válido. Consulte la documentación de la API para obtener información sobre los manejadores de conexiones de cliente. | |
40 | Se ha producido un error de comunicaciones locales. | Consulte en el registro cronológico de servidor de WebSphere Application Server los mensajes de error de comunicaciones locales. | |
46 | Se ha producido un error en la llamada de envío de solicitud de comunicaciones locales. | Consulte el registro cronológico de WebSphere Application Server para determinar el error. | |
76 | Ha fallado un intento de comunicación con el servidor porque el servidor ya no está en ejecución. | Inicie el servidor y vuelva a intentar la comunicación. | |
96 | Esta API no se puede controlar durante la inicialización de IMS ni durante una salida de inicialización previa de IMS. | Llame a esta API después de que la inicialización de IMS haya finalizado. | |
12 | 10 | No se puede localizar el grupo de daemons o el servidor de WebSphere Application Server. | Asegúrese de que el daemon y el servidor de WebSphere Application Server se hayan iniciado y que el soporte de conexiones locales esté activo y vuelva a intentar la llamada. |
24 | Después de una llamada de registro satisfactoria, se ha producido un error al obtener una conexión de la agrupación. | Verifique que se inicie el servidor. Si el servidor no se ha iniciado, reinicie el servidor y vuelva a intentar la solicitud de API. | |
34 | Se utiliza un apéndice de la API de 64 bits en un entorno IMS. | Las API de 64 bits no reciben soporte en IMS. | |
38 | Se ha utilizado un apéndice de la API de 64 bits en un entorno CICS. | Las API de 64 bits no reciben soporte en CICS. | |
44 | Creación de CP errónea para llamada de servicio | ||
46 | Obtención de CP errónea para célula de servicio | ||
48 | CP erróneo libre para célula de servicio | ||
60 | No se puede obtener bloqueo SRVQ | ||
62 | No se puede desbloquear el bloqueo SRVQ | ||
86 | No se ha podido encontrar la BGVT maestra de WebSphere Application Server para z/OS | WebSphere no se ha iniciado todavía en la imagen actual del sistema z/OS. Asegúrese de que se haya iniciado el daemon y un nodo/servidor antes de iniciar cualquier proceso cliente de adaptadores locales optimizados de WebSphere Application Server. | |
88 | No se ha podido encontrar la tabla de apéndices de cliente maestra de WebSphere Application Server para z/OS | Se ha iniciado WebSphere Application Server en la imagen actual del sistema z/OS pero no se está ejecutando a un nivel admitido por la tabla de apéndices cliente de adaptadores locales optimizados. Posiblemente esté ejecutando la interfaz de apéndices de adaptadores locales optimizados de la versión 8.0.0.1 de WebSphere Application Server que no es compatible con el nivel de mantenimiento del servidor de aplicaciones. Para utilizar los apéndices de adaptadores locales optimizados de la versión 8.0.0.1, el servidor de aplicaciones también tiene que estar ejecutando el nivel de la versión 8.0.0 de WebSphere Application Server . Asegúrese de que su aplicación se esté ejecutando en el nivel compatible de los apéndices de adaptadores locales optimizados para WebSphere Application Server en este sistema z/OS. | |
90 | No se ha podido encontrar la ranura de la tabla de apéndices de cliente maestra de adaptadores locales optimizados de WebSphere Application Server para z/OS. | Se ha iniciado WebSphere Application Server en la imagen actual del sistema z/OS pero no se está ejecutando a un nivel admitido por la tabla de apéndices cliente de adaptadores locales optimizados. Posiblemente esté ejecutando la interfaz de apéndices de adaptadores locales optimizados de la versión 8.0.0.1 de WebSphere Application Server que no es compatible con el nivel de mantenimiento del servidor de aplicaciones. Para utilizar los apéndices de adaptadores locales optimizados de la versión 8.0.0.1, el servidor de aplicaciones también tiene que estar ejecutando el nivel de la versión 8.0.0 de WebSphere Application Server . Asegúrese de que su aplicación se esté ejecutando en el nivel compatible de los apéndices de adaptadores locales optimizados para WebSphere Application Server en este sistema z/OS. |
Recepción de solicitud específica
Reciba una solicitud de un WebSphere Application Server local en una conexión específica. Reciba una solicitud y datos relacionados para el manejador de conexiones de entrada proporcionado. Devuelve la longitud de datos de solicitud. Una llamada de API de obtención de datos con el manejador de conexiones devuelto devuelve los datos de mensaje recibidos.API | Sintaxis |
---|---|
BBOA1RCS o BBGA1RCS | BBOA1RCS ( connectionhandle, requestservicename, requestservicenamel, requestdatalen, async(0|1), rc, rsn ) BBGA1RCS ( connectionhandle, requestservicename, requestservicenamel, requestdatalen, async(0|1), rc, rsn ) |
Parámetros:
connectionhandle (entrada)Manejador de conexiones de 12 bytes que se debe utilizar para la solicitud de recepción.
requestservicename (entrada/salida)Serie de caracteres EBCDIC de un máximo de 256 bytes que contiene el nombre del servicio. Es el nombre del servicio de destino especificado en InteractionSpec por la aplicación WebSphere Application Server. El valor * indica que se configura como servidor para todos los nombres de servicio que llegan bajo el nombre de registro actual.
requestservicenamel (entrada/salida)Entero que contiene la longitud del nombre de servicio a iniciar o 0 si el nombre de servicio termina en nulo.
requestdatalen (salida)Se devuelve un valor no firmado de 32 bits en modalidad de 31 bits o un valor no firmado de 64 bits en modalidad de 64 bits que contiene la longitud de los datos de solicitud recibidos. Entonces el emisor de la llamada puede utilizar esta longitud para adquirir almacenamiento antes de llamar a la API de obtención de datos para copiarlo en ella. Cuando async se establece en 1, que indica que el emisor de la llamada desea que se devuelva el control inmediatamente, este valor se establece en todo 0xFF si los datos de solicitud aún no se han recibido. En este caso, se debe llamar otra vez a la API para recuperar una solicitud de entrada.
async(0|1) (entrada)Valor entero que cuando se establece en 1 indica que el emisor de la llamada desea que se devuelva el control inmediatamente, incluso aunque no se conozca aún la longitud de solicitud. Cuando async se establece en 0, esta llamada esperará a que se reciba una solicitud de WebSphere Application Server.
rc (salida)Código de retorno entero que indica si esta llamada se ha realizado de manera satisfactoria o anómala.
rsn (salida)Código de razón de entero que describe la razón de una anomalía en esta llamada.
- Asegúrese de que se ha iniciado el grupo de daemons y el servidor deWebSphere Application Server para z/OS especificados y de que el soporte para los adaptadores locales está habilitado.
- Asegúrese de que se ha completado una llamada de registro (API BBOA1REG) satisfactoria en el espacio de direcciones actual con un nombre coincidente antes de utilizar esta API.
Código de retorno | Código de razón | Descripción | Acción |
---|---|---|---|
0 | - | Correcta | |
4 | - | Aviso - vea código de razón | |
8 | - | Error - vea código de razón | |
8 | La señal de nombre de registro ya existe. | Asegúrese de que el nombre de registro pasado es válido. | |
10 | El manejador de conexiones está en un estado liberado o inadecuado. | Asegúrese de que se ha pasado un manejador de conexiones válido. | |
11 | Se han enviado datos erróneos de WebSphere Application Server | ||
16 | La longitud de nombre de servicio de solicitud no es válida. | Corrija el programa y vuelva a intentar la llamada. | |
19 | Anomalía de datos existentes de comunicaciones locales | ||
21 | Anomalía de datos de vista previa de comunicaciones locales | ||
28 | El registro con el que el manejador de conexiones estaba asociado ya no está activo. | Llame otra vez el nombre de registro antes de llamar a la obtención de conexión y la solicitud de recepción específica. | |
36 | El estado de conexión no es válido. | El manejador de conexiones utilizado para esta solicitud está en un estado incorrecto. Consulte la documentación de la API para conocer las reglas sobre los estados de conexión. | |
38 | El manejador de conexiones de cliente no es válido. | El manejador de conexiones de cliente utilizado para esta solicitud no es válido. Consulte la documentación de la API para obtener información sobre los manejadores de conexiones de cliente. | |
40 | Se ha producido un error de comunicaciones locales. | Consulte en el registro cronológico de servidor de WebSphere Application Server los mensajes de error de comunicaciones locales. | |
46 | Se ha producido un error en la llamada de envío de solicitud de comunicaciones locales. | Consulte el registro cronológico de WebSphere Application Server para determinar el error. | |
76 | Ha fallado un intento de comunicación con el servidor porque el servidor ya no está en ejecución. | Inicie el servidor y vuelva a intentar la comunicación. | |
78 | Se ha producido un error interno que ha hecho que la conexión seleccione una solicitud que no era una parte de la transacción que estaba procesando esta conexión. | Devuelva la conexión a la agrupación de conexiones. Si el problema persiste, póngase en contacto con el servicio de soporte de IBM. | |
80 | La transacción que está activa en esta conexión ha excedido el tiempo de espera y el estado de conexión no se ha podido restablecer de modo que se procesa otra solicitud. | Devuelva la conexión a la agrupación de conexiones. Si el problema persiste, póngase en contacto con el servicio de soporte de IBM. | |
96 | Esta API no se puede controlar durante la inicialización de IMS ni durante una salida de inicialización previa de IMS. | Llame a esta API después de que la inicialización de IMS haya finalizado. | |
12 | 10 | No se puede localizar el grupo de daemons o el servidor de WebSphere Application Server. | Asegúrese de que el daemon y el servidor de WebSphere Application Server se hayan iniciado y que el soporte de conexiones locales esté activo y vuelva a intentar la llamada. |
14 | No se puede localizar o verificar el vector de llamada de API que utiliza el manejador de conexiones proporcionado. | El manejador de conexiones no es válido o una llamada de anulación de registro (API BBOA1URG) puede haber invalidado la agrupación de conexiones. | |
34 | Se utiliza un apéndice de la API de 64 bits en un entorno IMS. | Las API de 64 bits no reciben soporte en IMS. | |
38 | Se ha utilizado un apéndice de la API de 64 bits en un entorno CICS. | Las API de 64 bits no reciben soporte en CICS. | |
44 | Creación de CP errónea para célula de servicio | ||
46 | Obtención de CP errónea para llamada de servicio | ||
48 | CP erróneo libre para célula de servicio | ||
60 | No se puede obtener bloqueo SRVQ | ||
62 | No se puede desbloquear el bloqueo SRVQ | ||
86 | No se ha podido encontrar la BGVT maestra de WebSphere Application Server para z/OS | WebSphere no se ha iniciado todavía en la imagen actual del sistema z/OS. Asegúrese de que se haya iniciado el daemon y un nodo/servidor antes de iniciar cualquier proceso cliente de adaptadores locales optimizados de WebSphere Application Server. | |
88 | No se ha podido encontrar la tabla de apéndices de cliente maestra de WebSphere Application Server para z/OS | Se ha iniciado WebSphere Application Server en la imagen actual del sistema z/OS pero no se está ejecutando a un nivel admitido por la tabla de apéndices cliente de adaptadores locales optimizados. Posiblemente esté ejecutando la interfaz de apéndices de adaptadores locales optimizados de la versión 8.0.0.1 de WebSphere Application Server que no es compatible con el nivel de mantenimiento del servidor de aplicaciones. Para utilizar los apéndices de adaptadores locales optimizados de la versión 8.0.0.1, el servidor de aplicaciones también tiene que estar ejecutando el nivel de la versión 8.0.0 de WebSphere Application Server . Asegúrese de que su aplicación se esté ejecutando en el nivel compatible de los apéndices de adaptadores locales optimizados para WebSphere Application Server en este sistema z/OS. | |
90 | No se ha podido encontrar la ranura de la tabla de apéndices de cliente maestra de adaptadores locales optimizados de WebSphere Application Server para z/OS. | Se ha iniciado WebSphere Application Server en la imagen actual del sistema z/OS pero no se está ejecutando a un nivel admitido por la tabla de apéndices cliente de adaptadores locales optimizados. Posiblemente esté ejecutando la interfaz de apéndices de adaptadores locales optimizados de la versión 8.0.0.1 de WebSphere Application Server que no es compatible con el nivel de mantenimiento del servidor de aplicaciones. Para utilizar los apéndices de adaptadores locales optimizados de la versión 8.0.0.1, el servidor de aplicaciones también tiene que estar ejecutando el nivel de la versión 8.0.0 de WebSphere Application Server . Asegúrese de que su aplicación se esté ejecutando en el nivel compatible de los apéndices de adaptadores locales optimizados para WebSphere Application Server en este sistema z/OS. |
Recepción de longitud de respuesta
Recepción de longitud de respuesta se utiliza para recuperar la longitud de los datos de respuesta de una llamada de solicitud de envío anterior.API | Sintaxis |
---|---|
BBOA1RCL o BBGA1RCL | BBOA1RCL ( connectionhandle, async(0|1), responsedatalen, rc, rsn ) BBGA1RCL ( connectionhandle, async(0|1), responsedatalen, rc, rsn ) |
Parámetros:
connectionhandle (entrada)Manejador de conexiones de 12 bytes que se debe utilizar para esta solicitud.
async (entrada)Valor entero que cuando se establece en 1 indica que el emisor de la llamada desea que se devuelva el control inmediatamente, incluso aunque no se conozca la longitud de respuesta. Cuando async se establece en 0, esta llamada espera a que se devuelva la respuesta de WebSphere Application Server y la longitud de respuesta en el valor de parámetro responsedatalen.
responsedatalen (salida)Se devuelve un valor no firmado de 32 bits en modalidad de 31 bits o un valor no firmado de 64 bits en modalidad de 64 bits que contiene la longitud de los datos recibidos. El emisor de la llamada puede utilizar esta longitud para adquirir almacenamiento antes de llamar a la API de obtención de datos para copiarlo en ella. Si async es 1, es posible que se devuelva como FF si aún no se han recibido los datos de respuesta
rc (salida)Código de retorno entero que indica si esta llamada se ha realizado de manera satisfactoria o anómala.
rsn (salida)Código de razón de entero que describe la razón de una anomalía en esta llamada.
- Asegúrese de que se ha iniciado el grupo de daemons y el servidor deWebSphere Application Server para z/OS especificados y de que el soporte para los adaptadores locales está habilitado.
- Asegúrese de que se ha completado una llamada de registro (API BBOA1REG o BBGA1REG) satisfactoria en el espacio de direcciones actual con un nombre coincidente antes de utilizar esta API.
- Asegúrese de que se ha completado una llamada de obtención de conexión (API BBOA1CNG o BBGA1CNG) satisfactoria y de que se proporciona el manejador como entrada en esta llamada.
- Asegúrese de que se ha completado una llamada de solicitud de envío (API BBOA1SRQ o BBGA1SRQ) satisfactoria antes de realizar esta llamada.
Código de retorno | Código de razón | Descripción | Acción |
---|---|---|---|
0 | - | Correcta | |
4 | - | Aviso - vea código de razón | |
8 | - | Error - vea código de razón | |
8 | La señal de nombre de registro ya existe. | Asegúrese de que el nombre de registro pasado es válido. | |
11 | Se han enviado datos erróneos de WebSphere Application Server. | ||
19 | Anomalía de datos existentes de comunicaciones locales | ||
21 | Anomalía de datos de vista previa de comunicaciones locales | ||
34 | No se ha encontrado el servicio de destino. | Asegúrese de que la aplicación que contiene el enterprise bean de destino se ha instalado e iniciado en el WebSphere Application Server de destino. | |
36 | El estado de conexión no es válido. | Se ha determinado que el manejador de conexiones utilizado para esta solicitud está en un estado incorrecto. Consulte la documentación de la API para conocer las reglas sobre los estados de conexión. | |
38 | El manejador de conexiones de cliente no es válido. | Se ha determinado que el manejador de conexiones de cliente utilizado para esta solicitud no es válido. Consulte la documentación de la API para obtener información sobre los manejadores de conexiones de cliente. | |
40 | Se ha producido un error de comunicaciones locales. | Consulte en el registro cronológico de servidor de WebSphere Application Server los mensajes de error de comunicaciones locales. | |
96 | Esta API no se puede controlar durante la inicialización de IMS ni durante una salida de inicialización previa de IMS. | Llame a esta API después de que la inicialización de IMS haya finalizado. | |
12 | 10 | No se puede localizar el grupo de daemons o el servidor de WebSphere Application Server. | Asegúrese de que el daemon y el servidor de WebSphere Application Server se hayan iniciado y que el soporte de conexiones locales esté activo y vuelva a intentar la llamada. |
14 | No se puede localizar o verificar el vector de llamada de API que utiliza el manejador de conexiones proporcionado. | El manejador de conexiones no es válido o una llamada de anulación de registro (API BBOA1URG) puede haber invalidado la agrupación de conexiones. | |
34 | Se utiliza un apéndice de la API de 64 bits en un entorno IMS. | Las API de 64 bits no reciben soporte en IMS. | |
38 | Se ha utilizado un apéndice de la API de 64 bits en un entorno CICS. | Las API de 64 bits no reciben soporte en CICS. | |
86 | No se ha podido encontrar la BGVT maestra de WebSphere Application Server para z/OS | WebSphere no se ha iniciado todavía en la imagen actual del sistema z/OS. Asegúrese de que se haya iniciado el daemon y un nodo/servidor antes de iniciar cualquier proceso cliente de adaptadores locales optimizados de WebSphere Application Server. | |
88 | No se ha podido encontrar la tabla de apéndices de cliente maestra de WebSphere Application Server para z/OS | Se ha iniciado WebSphere Application Server en la imagen actual del sistema z/OS pero no se está ejecutando a un nivel admitido por la tabla de apéndices cliente de adaptadores locales optimizados. Posiblemente esté ejecutando la interfaz de apéndices de adaptadores locales optimizados de la versión 8.0.0.1 de WebSphere Application Server que no es compatible con el nivel de mantenimiento del servidor de aplicaciones. Para utilizar los apéndices de adaptadores locales optimizados de la versión 8.0.0.1, el servidor de aplicaciones también tiene que estar ejecutando el nivel de la versión 8.0.0 de WebSphere Application Server . Asegúrese de que su aplicación se esté ejecutando en el nivel compatible de los apéndices de adaptadores locales optimizados para WebSphere Application Server en este sistema z/OS. | |
90 | No se ha podido encontrar la ranura de la tabla de apéndices de cliente maestra de adaptadores locales optimizados de WebSphere Application Server para z/OS. | Se ha iniciado WebSphere Application Server en la imagen actual del sistema z/OS pero no se está ejecutando a un nivel admitido por la tabla de apéndices cliente de adaptadores locales optimizados. Posiblemente esté ejecutando la interfaz de apéndices de adaptadores locales optimizados de la versión 8.0.0.1 de WebSphere Application Server que no es compatible con el nivel de mantenimiento del servidor de aplicaciones. Para utilizar los apéndices de adaptadores locales optimizados de la versión 8.0.0.1, el servidor de aplicaciones también tiene que estar ejecutando el nivel de la versión 8.0.0 de WebSphere Application Server . Asegúrese de que su aplicación se esté ejecutando en el nivel compatible de los apéndices de adaptadores locales optimizados para WebSphere Application Server en este sistema z/OS. |
Obtención de datos de mensaje
Esta API se utiliza par copiar los datos de mensaje recibidos. Cuando se devuelve esta llamada, el mensaje se elimina de la memoria caché de mensajes de adaptador.API | Sintaxis |
---|---|
BBOA1GET o BBGA1GET | BBOA1GET ( connectionhandle, msgdata, msgdatalen, rc, rsn, rv ) BBGA1GET ( connectionhandle, msgdata, msgdatalen, rc, rsn, rv ) |
Parámetros:
connectionhandle (entrada)Manejador de conexiones de 12 bytes que se debe utilizar para esta solicitud.
msgdata (entrada)Puntero de 31 bits o de 64 bits a la dirección del inicio del área de datos en la se deben realizar las copias. El almacenamiento al que éste apunta debe estar en una clave en la que el emisor de la llamada pueda escribir.
msgdatalen (entrada)Un valor no firmado de 32 bits en modalidad de 31 bits o un valor no firmado de 64 bits en modalidad de 64 bits que contiene la longitud de los datos que se deben copiar.
rc (salida)Código de retorno entero que indica si esta llamada se ha realizado de manera satisfactoria o anómala.
rsn (salida)Código de razón de entero que describe la razón de una anomalía en esta llamada.
rv (salida)Valor de retorno entero de 32 bits que contiene el tamaño del almacenamiento intermedio de contexto para esta solicitud.
- Asegúrese de que se ha iniciado el grupo de daemons y el servidor deWebSphere Application Server para z/OS especificados y de que el soporte para los adaptadores locales está habilitado.
- Asegúrese de que se ha completado una llamada de registro (API BBOA1REG o BBGA1REG) satisfactoria en el espacio de direcciones actual con un nombre coincidente antes de utilizar la API de envío de solicitud.
- Asegúrese de que se ha completado una llamada de obtención de conexión (API BBOA1CNG o BBGA1CNG) satisfactoria y de que se proporciona el manejador como entrada en esta llamada.
- Si el parámetro msgdatalen de entrada de emisor de llamada de API es mayor que la respuesta de mensaje real, el código de retorno contiene un 0 y se proporciona la longitud de mensaje real en el valor de retorno.
- Importante: Una vez que la llamada de obtención de datos de mensaje vuelve al emisor de la llamada, los datos de mensaje no permanecen y se devuelve la conexión a un estado donde se puede utilizar para otra llamada de solicitud de envío o recepción. Se devuelve con un error una llamada subsiguiente para obtener datos de mensaje o recibir la longitud de respuesta.
Código de retorno | Código de razón | Descripción | Acción |
---|---|---|---|
0 | - | Correcta | |
4 | - | Aviso - vea código de razón | |
8 | - | Error - vea código de razón | |
8 | La señal de nombre de registro ya existe. | Asegúrese de que el nombre de registro pasado es válido. | |
36 | El estado de conexión no es válido. | Se ha determinado que el manejador de conexiones utilizado para esta solicitud está en un estado incorrecto. Consulte la documentación de la API para conocer las reglas sobre los estados de conexión. | |
38 | El manejador de conexiones de cliente no es válido. | Se ha determinado que el manejador de conexiones de cliente utilizado para esta solicitud no es válido. Consulte la documentación de la API para obtener información sobre los manejadores de conexiones de cliente. | |
40 | Se ha producido un error de comunicaciones locales. | Consulte en el registro cronológico de servidor de WebSphere Application Server los mensajes de error de comunicaciones locales. | |
48 | Se ha producido un error en la solicitud de lectura de comunicaciones locales. | Consulte el registro cronológico de WebSphere Application Server para determinar el error. | |
50 | La conexión con WebSphere Application Server ha terminado. | Consulte el registro cronológico de WebSphere Application Server para determinar el error. | |
72 | El parámetro de entrada de longitud de respuesta no es suficientemente grande para contener el mensaje de respuesta. | Sólo se devuelve una parte del mensaje. El resto se descarta. Consulte en el valor de retorno el tamaño de la respuesta de mensaje. | |
96 | Esta API no se puede controlar durante la inicialización de IMS ni durante una salida de inicialización previa de IMS. | Llame a esta API después de que la inicialización de IMS haya finalizado. | |
98 | No se ha podido acceder al inicio del almacenamiento intermedio de la solicitud proporcionado. | Asegúrese de que la dirección y la longitud del almacenamiento intermedio de la solicitud proporcionado sean correctos. | |
100 | No se ha podido acceder al final del almacenamiento intermedio de la solicitud proporcionado. | Asegúrese de que la dirección y la longitud del almacenamiento intermedio de la solicitud proporcionado sean correctos. | |
102 | No se ha podido acceder al inicio del almacenamiento intermedio de la respuesta proporcionado. | Asegúrese de que la dirección y la longitud del almacenamiento intermedio de la respuesta proporcionado sean correctos. | |
104 | No se ha podido acceder al final del almacenamiento intermedio de la respuesta proporcionado. | Asegúrese de que la dirección y la longitud del almacenamiento intermedio de la respuesta proporcionado sean correctos. | |
12 | 10 | No se puede localizar el grupo de daemons o el servidor de WebSphere Application Server. | Asegúrese de que el daemon y el servidor de WebSphere Application Server se hayan iniciado y que el soporte de conexiones locales esté activo y vuelva a intentar la operación. |
12 | 10 | No se puede localizar el grupo de daemons o el servidor de WebSphere Application Server. | Asegúrese de que el daemon y el servidor de WebSphere Application Server se hayan iniciado y que el soporte de conexiones locales esté activo y vuelva a intentar la llamada. |
14 | No se puede localizar o verificar el vector de llamada de API que utiliza el manejador de conexiones proporcionado. | El manejador de conexiones no es válido o una llamada de anulación de registro (API BBOA1URG) puede haber invalidado la agrupación de conexiones. | |
34 | Se utiliza un apéndice de la API de 64 bits en un entorno IMS. | Las API de 64 bits no reciben soporte en IMS. | |
38 | Se ha utilizado un apéndice de la API de 64 bits en un entorno CICS. | Las API de 64 bits no reciben soporte en CICS. | |
86 | No se ha podido encontrar la BGVT maestra de WebSphere Application Server para z/OS | WebSphere no se ha iniciado todavía en la imagen actual del sistema z/OS. Asegúrese de que se haya iniciado el daemon y un nodo/servidor antes de iniciar cualquier proceso cliente de adaptadores locales optimizados de WebSphere Application Server. | |
88 | No se ha podido encontrar la tabla de apéndices de cliente maestra de WebSphere Application Server para z/OS | Se ha iniciado WebSphere Application Server en la imagen actual del sistema z/OS pero no se está ejecutando a un nivel admitido por la tabla de apéndices cliente de adaptadores locales optimizados. Posiblemente esté ejecutando la interfaz de apéndices de adaptadores locales optimizados de la versión 8.0.0.1 de WebSphere Application Server que no es compatible con el nivel de mantenimiento del servidor de aplicaciones. Para utilizar los apéndices de adaptadores locales optimizados de la versión 8.0.0.1, el servidor de aplicaciones también tiene que estar ejecutando el nivel de la versión 8.0.0 de WebSphere Application Server . Asegúrese de que su aplicación se esté ejecutando en el nivel compatible de los apéndices de adaptadores locales optimizados para WebSphere Application Server en este sistema z/OS. | |
90 | No se ha podido encontrar la ranura de la tabla de apéndices de cliente maestra de adaptadores locales optimizados de WebSphere Application Server para z/OS. | Se ha iniciado WebSphere Application Server en la imagen actual del sistema z/OS pero no se está ejecutando a un nivel admitido por la tabla de apéndices cliente de adaptadores locales optimizados. Posiblemente esté ejecutando la interfaz de apéndices de adaptadores locales optimizados de la versión 8.0.0.1 de WebSphere Application Server que no es compatible con el nivel de mantenimiento del servidor de aplicaciones. Para utilizar los apéndices de adaptadores locales optimizados de la versión 8.0.0.1, el servidor de aplicaciones también tiene que estar ejecutando el nivel de la versión 8.0.0 de WebSphere Application Server . Asegúrese de que su aplicación se esté ejecutando en el nivel compatible de los apéndices de adaptadores locales optimizados para WebSphere Application Server en este sistema z/OS. |
Invoke
Esta API utiliza otras funciones API primitivas subyacentes para llamar a un método en un WebSphere Application Server local. Se ha diseñado para utilizarse en situaciones donde se conozca de antemano el tamaño máximo de área de salida de respuesta.API | Sintaxis |
---|---|
BBOA1INV o BBGA1INV | BBOA1INV ( registername, requesttype, requestservicename, requestservicenamel, requestdata, requestdatalen, responsedata, responsedatalen, waittime, rc, rsn, rv ) BBGA1INV ( registername, requesttype, requestservicename, requestservicenamel, requestdata, requestdatalen, responsedata, responsedatalen, waittime, rc, rsn, rv ) |
Parámetros:
registername (entrada)Variable de entrada o constante de entrada que contiene el nombre que se debe utilizar para localizar la agrupación de conexiones a fin de recuperar una conexión para esta invocación. Debe ser una serie rellena de espacios en blanco de 12 caracteres exactamente.
requesttype (entrada)Un entero que contiene el tipo de solicitud que indica el tipo de solicitud de trabajo que se debe procesar. Valores de tipo soportados: 1 = solicitudes de trabajos EJB local, 2 = solicitudes de trabajo EJB remoto.
requestservicename (entrada)Serie de caracteres EBCDIC de una longitud máxima de 256 bytes que contiene el nombre del servicio que se deben invocar. Para Type=1, EJB, es el nombre de inicio JNDI del destino.
requestservicenamel (entero)Entero que contiene la longitud del nombre de servicio a iniciar o 0 si el nombre de servicio termina en nulo.
requestdata (entrada)Puntero de 31 bits o de 64 bits a la dirección del inicio de los datos de solicitud a enviar.
requestdatalen (entrada)Un valor no firmado de 32 bits en modalidad de 31 bits o un valor no firmado de 64 bits en modalidad de 64 bits que contiene la longitud de los datos a enviar.
responsedata (entrada)Puntero de 31 bits o de 64 bits a la dirección del inicio del área de datos de respuesta en la se deben realizar las copias. El almacenamiento al que éste apunta debe estar en una clave en la que el emisor de la llamada pueda escribir.
responsedatalen (entrada)Un valor no firmado de 32 bits en modalidad de 31 bits o un valor no firmado de 64 bits en modalidad de 64 bits que contiene la longitud de los datos a enviar.
waittime (entrada)Entero que contiene el número de segundos que se deben esperar a que se complete la conexión antes de devolver un código de razón de conexión no disponible. Un valor de 0 (cero) indica que no hay tiempo de espera y que esta API espera indefinidamente.
rc (salida)Código de retorno entero que indica si esta llamada se ha realizado de manera satisfactoria o anómala.
rsn (salida)Código de razón de entero que describe la razón de una anomalía en esta llamada.
rv (salida)Valor de retorno entero de 32 bits que contiene el tamaño de los datos de mensaje que se han recibido y copiado en el área de respuesta del llamante.
- Asegúrese de que se ha iniciado el grupo de daemons y el servidor deWebSphere Application Server para z/OS especificados y de que el soporte para los adaptadores locales está habilitado.
- Asegúrese de que se ha completado una llamada de registro (API BBOA1REG o BBGA1REG) satisfactoria en el espacio de direcciones actual con un nombre coincidente antes de utilizar la API de envío de solicitud.
- Si el parámetro responsedatalen de entrada de emisor de llamada de API es mayor que la respuesta de mensaje real, el código de retorno contiene un 0 (cero) y se proporciona la longitud de mensaje real en el valor de retorno.
Código de retorno | Código de razón | Descripción | Acción |
---|---|---|---|
0 | - | Correcta | |
4 | - | Aviso - vea código de razón | |
8 | - | Error - vea código de razón | |
8 | La señal de nombre de registro ya existe. | Asegúrese de que el nombre de registro pasado es válido. | |
10 | La conexión no está disponible. El tiempo de espera ha caducado antes de obtener la solicitud de conexión. | El comportamiento de la aplicación varía. Espere y vuelva a intentarlo o acepte esta llamada de API de invocación anómala. Otra opción es aumentar el valor de número máximo de conexiones en la llamada de API de registro. | |
11 | Se han enviado datos erróneos de WebSphere Application Server. | ||
14 | Se ha producido una condición de escasez de memoria mientras se guardaba el mensaje. | No hay suficiente memoria disponible para que la invocación procese el mensaje. El espacio de direcciones actual se ha quedado sin almacenamiento privado. | |
16 | La longitud de nombre de servicio de solicitud no es válida. | Corrija el programa y vuelva a intentar la llamada. | |
18 | La longitud de respuesta excedía los límites de sistema. | El tamaño de mensaje es mayor que el tamaño que WebSphere Application Server puede soportar. Verifique que el tamaño sea válido. Si el tamaño es válido, asegúrese de que el tamaño de WebSphere Application Server es suficientemente grande para dar cabida al tamaño de mensaje. | |
19 | Anomalía de datos existentes de comunicaciones locales. | ||
21 | Anomalía de datos de vista previa de comunicaciones locales. | ||
24 | Después de una llamada de registro satisfactoria, se ha producido un error al obtener una conexión de la agrupación. | Verifique que se inicie el servidor. Si no funciona, reinicie el servidor y vuelva a intentar la solicitud de API. | |
26 | La transacción global no ha podido empezar. | ||
28 | Se ha encontrado el registro, pero está inactivo. | ||
32 | El tipo de solicitud en la llamada de API no es válido. | El parámetro de tipo de solicitud no es válido. Corrija el programa y vuelva a intentar la llamada. | |
34 | No se ha encontrado el servicio de destino. | Asegúrese de que la aplicación que contiene el enterprise bean de destino se ha instalado e iniciado en el WebSphere Application Server de destino. | |
36 | El estado de conexión no es válido. | Se ha determinado que el manejador de conexiones utilizado para esta solicitud está en un estado incorrecto. Consulte la documentación de la API para conocer las reglas sobre los estados de conexión. | |
38 | El manejador de conexiones de cliente no es válido. | Se ha determinado que el manejador de conexiones de cliente utilizado para esta solicitud no es válido. Consulte la documentación de la API para obtener información sobre los manejadores de conexiones de cliente. | |
40 | Se ha producido un error de comunicaciones locales. | Consulte en el registro cronológico de servidor de WebSphere Application Server los mensajes de error de comunicaciones locales. | |
44 | Se ha producido una excepción o una condición inesperada en el enterprise bean de destino. | Consulte el registro cronológico de WebSphere Application Server para revisar los datos de excepción. | |
46 | Se ha producido un error en la solicitud de envío de comunicaciones locales. | Consulte el registro cronológico de WebSphere Application Server para determinar el error. | |
48 | Se ha producido un error en la solicitud de lectura de comunicaciones locales. | Consulte el registro cronológico de WebSphere Application Server para determinar el error. | |
50 | La conexión con WebSphere Application Server ha terminado. | Consulte el WebSphere Application Server para determinar el error. | |
72 | El parámetro de entrada de longitud de respuesta no es suficientemente grande para contener el mensaje de respuesta. | Sólo se devuelve una parte del mensaje. El resto se descarta. Consulte en el valor de retorno el tamaño de la respuesta de mensaje. | |
96 | Esta API no se puede controlar durante la inicialización de IMS ni durante una salida de inicialización previa de IMS. | Llame a esta API después de que la inicialización de IMS haya finalizado. | |
98 | No se ha podido acceder al inicio del almacenamiento intermedio de la solicitud proporcionado. | Asegúrese de que la dirección y la longitud del almacenamiento intermedio de la solicitud proporcionado sean correctos. | |
100 | No se ha podido acceder al final del almacenamiento intermedio de la solicitud proporcionado. | Asegúrese de que la dirección y la longitud del almacenamiento intermedio de la solicitud proporcionado sean correctos. | |
102 | No se ha podido acceder al inicio del almacenamiento intermedio de la respuesta proporcionado. | Asegúrese de que la dirección y la longitud del almacenamiento intermedio de la respuesta proporcionado sean correctos. | |
104 | No se ha podido acceder al final del almacenamiento intermedio de la respuesta proporcionado. | Asegúrese de que la dirección y la longitud del almacenamiento intermedio de la respuesta proporcionado sean correctos. | |
12 | 10 | No se puede localizar el grupo de daemons o el servidor de WebSphere Application Server. | Asegúrese de que el daemon y el servidor de WebSphere Application Server se hayan iniciado y que el soporte de conexiones locales esté activo y vuelva a intentar la llamada. |
14 | No se puede localizar o verificar el vector de llamada de API que utiliza el manejador de conexiones proporcionado. | El manejador de conexiones no es válido o una llamada de anulación de registro (API BBOA1URG) puede haber invalidado la agrupación de conexiones. | |
24 | Después de una llamada de registro satisfactoria, se ha producido un error al obtener una conexión de la agrupación de conexiones. | Verifique que se inicie el servidor. Si no se inicia, reinicie el servidor e intente de nuevo la solicitud de API. | |
34 | Se utiliza un apéndice de la API de 64 bits en un entorno IMS. | Las API de 64 bits no reciben soporte en IMS. | |
38 | Se ha utilizado un apéndice de la API de 64 bits en un entorno CICS. | Las API de 64 bits no reciben soporte en CICS. | |
86 | No se ha podido encontrar la BGVT maestra de WebSphere Application Server para z/OS | WebSphere no se ha iniciado todavía en la imagen actual del sistema z/OS. Asegúrese de que se haya iniciado el daemon y un nodo/servidor antes de iniciar cualquier proceso cliente de adaptadores locales optimizados de WebSphere Application Server. | |
88 | No se ha podido encontrar la tabla de apéndices de cliente maestra de WebSphere Application Server para z/OS | Se ha iniciado WebSphere Application Server en la imagen actual del sistema z/OS pero no se está ejecutando a un nivel admitido por la tabla de apéndices cliente de adaptadores locales optimizados. Posiblemente esté ejecutando la interfaz de apéndices de adaptadores locales optimizados de la versión 8.0.0.1 de WebSphere Application Server que no es compatible con el nivel de mantenimiento del servidor de aplicaciones. Para utilizar los apéndices de adaptadores locales optimizados de la versión 8.0.0.1, el servidor de aplicaciones también tiene que estar ejecutando el nivel de la versión 8.0.0 de WebSphere Application Server . Asegúrese de que su aplicación se esté ejecutando en el nivel compatible de los apéndices de adaptadores locales optimizados para WebSphere Application Server en este sistema z/OS. | |
90 | No se ha podido encontrar la ranura de la tabla de apéndices de cliente maestra de adaptadores locales optimizados de WebSphere Application Server para z/OS. | Se ha iniciado WebSphere Application Server en la imagen actual del sistema z/OS pero no se está ejecutando a un nivel admitido por la tabla de apéndices cliente de adaptadores locales optimizados. Posiblemente esté ejecutando la interfaz de apéndices de adaptadores locales optimizados de la versión 8.0.0.1 de WebSphere Application Server que no es compatible con el nivel de mantenimiento del servidor de aplicaciones. Para utilizar los apéndices de adaptadores locales optimizados de la versión 8.0.0.1, el servidor de aplicaciones también tiene que estar ejecutando el nivel de la versión 8.0.0 de WebSphere Application Server . Asegúrese de que su aplicación se esté ejecutando en el nivel compatible de los apéndices de adaptadores locales optimizados para WebSphere Application Server en este sistema z/OS. |
Servicio de host
Servicio de host para un WebSphere Application Server local. Esta API utiliza otras funciones API primitivas subyacentes pera configurar un programa z/OS de lenguaje nativo como servidor y destino para las llamadas de adaptador locales optimizadas desde un WebSphere Application Server local. Se ha diseñado para utilizarse en situaciones donde se conoce de antemano el tamaño máximo de área de solicitud.API | Sintaxis |
---|---|
BBOA1SRV o BBGA1SRV | BBOA1SRV ( registername, requestservicename, requestservicenamel, requestdata, requestdatalen, connectionhandle, waittime, rc, rsn, rv ) BBGA1SRV ( registername, requestservicename, requestservicenamel, requestdata, requestdatalen, connectionhandle, waittime, rc, rsn, rv ) |
Parámetros:
registername (entrada)Variable de entrada o constante de entrada que contiene el nombre que se debe utilizar para localizar la agrupación de conexiones de la que recuperar una conexión para esta llamada. Debe ser una serie rellena de espacios en blanco de 12 caracteres exactamente.
requestservicename (entrada/salida)Serie de caracteres EBCDIC de un máximo de 256 bytes que contiene el nombre del servicio. Es el nombre del servicio de destino especificado en InteractionSpec por la aplicación WebSphere Application Server. Un valor * indica que se debe configurar como servidor para todos los nombres de servicio que llegan bajo el nombre de registro actual.
requestservicenamel (entrada/salida)Entero que contiene la longitud del nombre de servicio a iniciar o 0 si el nombre de servicio termina en nulo.
requestdata (entrada)Puntero de 31 bits o de 64 bits a la dirección del inicio de los datos de solicitud recibidos. El almacenamiento al que éste apunta debe estar en una clave en la que el emisor de la llamada pueda escribir.
requestdatalen (entrada)Un valor no firmado de 32 bits en modalidad de 31 bits o un valor no firmado de 64 bits en modalidad de 64 bits que contiene la longitud del área de datos en la que se va a recibir el mensaje.
connectionhandle (salida)Manejador de conexiones de 12 bytes que se devuelve al emisor de llamada y se utiliza para enviar una respuesta para esta solicitud.
waittime (entrada)Entero que contiene el número de segundos que se deben esperar a que se complete la conexión antes de devolver un código de razón de conexión no disponible. Un valor de 0 (cero) implica que no hay tiempo de espera y que la API espera indefinidamente.
rc (salida)Código de retorno entero que indica si esta llamada se ha realizado de manera satisfactoria o anómala.
rsn (salida)Código de razón de entero que describe la razón de una anomalía en esta llamada.
rv (salida)Valor de retorno entero de 32 bits que contiene el tamaño de los datos de solicitud de mensaje que se han recibido y copiado en el área del emisor de llamada.
Notas sobre la utilización
- Asegúrese de que se ha iniciado el grupo de daemons y el servidor deWebSphere Application Server para z/OS especificados y de que el soporte para los adaptadores locales está habilitado.
- Asegúrese de que se ha completado una llamada de registro (API BBOA1REG o BBGA1REG) satisfactoria en el espacio de direcciones actual con un nombre coincidente antes de utilizar esta API.
- Si el parámetro requestdatalen de entrada de emisor de llamada de API es mayor que la respuesta de mensaje real, el código de retorno contiene un 0 (cero) y se proporciona la longitud de mensaje real en el valor de retorno.
- Se debe proporcionar el manejador de conexiones devuelto en cualquier respuesta a esta llamada de host utilizando la API BBOA1SRP o BBGA1SRP. Una llamada de API BBOA1SRV o BBGA1SRVAPI subsiguiente vuelve a utilizar el mismo manejador de conexiones. Si es así, la API supone que no hay ninguna respuesta para la solicitud anterior.
- Importante: Una vez que la llamada de Servicio de host vuelve al emisor de la llamada, los datos de mensaje no permanecen y se devuelve la conexión a un estado donde se puede utilizar para otra solicitud de API.
Código de retorno | Código de razón | Descripción | Acción |
---|---|---|---|
0 | - | Correcta | |
4 | - | Aviso - vea código de razón | |
8 | - | Error - vea código de razón | |
8 | La señal de nombre de registro ya existe. | Asegúrese de que el nombre de registro pasado es válido. | |
10 | El manejador de conexiones está en un estado liberado. | Asegúrese de que se ha pasado un manejador de conexiones apropiado. | |
12 | El manejador de conexiones no está en la conexión que hay en el nombre de registro. | Corrija el programa y vuelva a intentar la llamada. | |
16 | La longitud de nombre de servicio de solicitud no es válida. | Corrija el programa y vuelva a intentar la llamada. | |
18 | La longitud de respuesta excede los límites de sistema. | El tamaño de mensaje es mayor que el tamaño que WebSphere Application Server puede soportar. Verifique que el tamaño sea válido. Si el tamaño es válido, asegúrese de que el tamaño de WebSphere Application Server es suficientemente grande para dar cabida al tamaño de mensaje. | |
40 | Se ha producido un error de comunicaciones locales. | Consulte en el registro cronológico de servidor de WebSphere Application Server los mensajes de error de comunicaciones locales. | |
46 | Se ha producido un error en la llamada de envío de solicitud de comunicaciones locales. | Consulte el registro cronológico de WebSphere Application Server para determinar el error. | |
48 | Se ha producido un error en la solicitud de lectura de comunicaciones locales. | Consulte el registro cronológico de WebSphere Application Server para determinar el error. | |
50 | La conexión con WebSphere Application Server ha terminado. | Consulte el registro cronológico de WebSphere Application Server para determinar el error. | |
72 | El parámetro de entrada de longitud de respuesta no es suficientemente grande para contener el mensaje de respuesta. | Sólo se devuelve una parte del mensaje. El resto se descarta. Consulte en el valor de retorno el tamaño de la respuesta de mensaje. | |
76 | Ha fallado un intento de comunicación con el servidor porque el servidor ya no está en ejecución. | Inicie el servidor y vuelva a intentar la comunicación. | |
96 | Esta API no se puede controlar durante la inicialización de IMS ni durante una salida de inicialización previa de IMS. | Llame a esta API después de que la inicialización de IMS haya finalizado. | |
98 | No se ha podido acceder al inicio del almacenamiento intermedio de la solicitud proporcionado. | Asegúrese de que la dirección y la longitud del almacenamiento intermedio de la solicitud proporcionado sean correctos. | |
100 | No se ha podido acceder al final del almacenamiento intermedio de la solicitud proporcionado. | Asegúrese de que la dirección y la longitud del almacenamiento intermedio de la solicitud proporcionado sean correctos. | |
12 | 10 | No se puede localizar el grupo de daemons o el servidor de WebSphere Application Server. | Asegúrese de que el daemon y el servidor de WebSphere Application Server se hayan iniciado y que el soporte de conexiones locales esté activo y vuelva a intentar la operación. |
14 | No se puede localizar o verificar el vector de llamada de API que utiliza el manejador de conexiones proporcionado. | El manejador de conexiones no es válido o una llamada de anulación de registro (API BBOA1URG o BBGA1URG) puede haber invalidado la agrupación de conexiones. | |
34 | Se utiliza un apéndice de la API de 64 bits en un entorno IMS. | Las API de 64 bits no reciben soporte en IMS. | |
38 | Se ha utilizado un apéndice de la API de 64 bits en un entorno CICS. | Las API de 64 bits no reciben soporte en CICS. | |
44 | Creación de CP errónea para célula de servicio. | ||
46 | Obtención de CP errónea para célula de servicio. | ||
48 | CP erróneo libre para célula de servicio. | ||
60 | No se puede obtener bloqueo SRVQ. | ||
62 | No se puede desbloquear el bloqueo SRVQ. | ||
86 | No se ha podido encontrar la BGVT maestra de WebSphere Application Server para z/OS | WebSphere no se ha iniciado todavía en la imagen actual del sistema z/OS. Asegúrese de que se haya iniciado el daemon y un nodo/servidor antes de iniciar cualquier proceso cliente de adaptadores locales optimizados de WebSphere Application Server. | |
88 | No se ha podido encontrar la tabla de apéndices de cliente maestra de WebSphere Application Server para z/OS | Se ha iniciado WebSphere Application Server en la imagen actual del sistema z/OS pero no se está ejecutando a un nivel admitido por la tabla de apéndices cliente de adaptadores locales optimizados. Posiblemente esté ejecutando la interfaz de apéndices de adaptadores locales optimizados de la versión 8.0.0.1 de WebSphere Application Server que no es compatible con el nivel de mantenimiento del servidor de aplicaciones. Para utilizar los apéndices de adaptadores locales optimizados de la versión 8.0.0.1, el servidor de aplicaciones también tiene que estar ejecutando el nivel de la versión 8.0.0 de WebSphere Application Server . Asegúrese de que su aplicación se esté ejecutando en el nivel compatible de los apéndices de adaptadores locales optimizados para WebSphere Application Server en este sistema z/OS. | |
90 | No se ha podido encontrar la ranura de la tabla de apéndices de cliente maestra de adaptadores locales optimizados de WebSphere Application Server para z/OS. | Se ha iniciado WebSphere Application Server en la imagen actual del sistema z/OS pero no se está ejecutando a un nivel admitido por la tabla de apéndices cliente de adaptadores locales optimizados. Posiblemente esté ejecutando la interfaz de apéndices de adaptadores locales optimizados de la versión 8.0.0.1 de WebSphere Application Server que no es compatible con el nivel de mantenimiento del servidor de aplicaciones. Para utilizar los apéndices de adaptadores locales optimizados de la versión 8.0.0.1, el servidor de aplicaciones también tiene que estar ejecutando el nivel de la versión 8.0.0 de WebSphere Application Server . Asegúrese de que su aplicación se esté ejecutando en el nivel compatible de los apéndices de adaptadores locales optimizados para WebSphere Application Server en este sistema z/OS. |
API de adaptadores JCA
- ConnectionSpec
- InteractionSpec
- E/S de registro
La API ConnectionSpec se utiliza para indicar con qué nombre de registro se debe comunicar. El nombre de registro se crea cuando se utiliza la API de registro. Esto también identifica con qué subsistema se debe conectar. Un subsistema puede tener más de un nombre de registro.
El nombre del ID de transacción de enlace de programa se pueden pasar de WebSphere Application Server a CICS y se utiliza para ejecutar la tarea de invocación de enlace de programa. Debe tener 4 caracteres y estar definido en la región CICS. Debe configurarlo con los mismos atributos y nombres de programa que la transacción BBO# (programa: BBOACLNK). Cuando este ID de transacción se pasa utilizando el método setLinkTaskTranid, altera temporalmente la API BBO# y cualquier ID de transacción que se haya especificado utilizando BBOC con el parámetro LTX=xxx.
Puede utilizar el método setUseCICSContainer o la interfaz MappedRecord de JCA para enviar aplicaciones a CICS utilizando canales y contenedores.
- Se proporciona el método setUseCICSContainer en ConnectionSpecImpl.
Cuando se establece en 1, el nombre y el tipo de un contenedor CICS de
solicitud de mensaje se pueden pasar a CICS utilizando los métodos
setLinkTaskReqContid() y setLinkTaskReqContType(0|1), donde
0=CHAR y 1=BIT. Cuando se pasa el contenedor CICS de la solicitud de mensaje a CICS, se pasan los propios datos de entrada del programa de destino en el contenedor mencionado, que se crea
con el tipo seleccionado de BIT o CHAR.
El nombre y el tipo de un contenedor CICS de respuesta de mensaje se pueden pasar a CICS utilizando los métodos, setLinkTaskRspContid() y setLinkTaskRspContType(bit|char). Cuando se pasa esto, se espera que la respuesta del programa de destino proceda del contenedor mencionado con el tipo seleccionado de BIT o CHAR.
- La interfaz MappedRecord de JCA puede utilizarse para pasar uno o varios contenedores a CICS. Cuando se utiliza una interfaz MappedRecord de JCA, el canal mencionado se utiliza para comunicarse con el programa de destino. Si utiliza la interfaz MappedRecord, debe establecer UseCICSContainer en 1 y el nombre y el tipo de un canal CICS se deben pasar a CICS
utilizando los métodos setLinkTaskChanID() y setLinkTaskChanType(bit|char).
Avoid trouble: La interfaz MappedRecord de JCA que se utiliza para pasar contenedores a CICS se obtiene llamando al método recordFactory.createMappedRecord(), utilizando la recordFactory que se obtiene del objeto de conexión WOLA. No utilice el método setLinkTaskReqContId(), setLinkTaskReqContType(), setLinkTaskRspContId() o SetLinkTaskRspContType() con la interfaz MappedRecord de JCA.gotcha
Para las transacciones de aplicación IMS, utilice el método setOTMAMaxRecvSize(nnn) en la Especificación de conexión para establecer el Tamaño máximo de recepción de mensaje. Para establecer el valor de nivel de conexión de Número máximo de segmentos utilice el método setOTMAMaxSegments(nnn) en la Especificación de conexión. Para obtener más información sobre la utilización de adaptadores locales optimizados con IMS a través de OTMA, consulte el tema Llamada a las transacciones existentes de IMS con adaptadores locales optimizados en OTMA.
InteractionSpec
La API InteractionSpec se utiliza para especificar qué servicio debe iniciar el destino. Esto depende del subsistema o proceso por lotes que se inicie. El proceso puede elegir para recibir solicitudes para un servicio específico o para cualquier servicio. Para CICS, el nombre de servicio debe ser el nombre del programa a iniciar en CICS.
E/S de registro
Las aplicaciones pueden pasar datos al adaptador y recibir datos del adaptador utilizando la interfaz de registro JCA. Esta API de adaptador propone utilizar la interfaz de registro indexado para permitir al emisor de llamada que pase una o más estructuras de datos, incluyendo libros de copias Cobol y estructuras C, al espacio de direcciones externo. Cada índice de la lista se toma como un libro de copias independiente y se pasa al destino en ese orden.
Cuando se utiliza para aceptar parámetros de retorno de una llamada de función, se puede definir previamente IndexedRecordImpl para que acepte un número determinado de parámetros y se pueden proporcionar los nombres de clase generados por las herramientas de ensamblaje para los libros de copias y las estructuras individuales. IndexedRecordImpl hincha los libros de copias y las estructuras serializados y los establece en IndexedRecordImpl para que se puedan recuperar y utilizar sin tratar con las representaciones de byte[] serializadas.
Para proporcionar una idea general de cómo funciona esta API, sólo se muestran los métodos seleccionados. Se implementan todos los métodos de la interfaz.