Las API de los adaptadores locales optimizados en Liberty for z/OS
Los adaptadores locales optimizados de WebSphere (WOLA) en Liberty están soportados por un conjunto de interfaces de programación de aplicaciones (API) de servicios invocables de lenguaje nativo de z/OS y la Java™ EE Connector Architecture (JCA).
- Cobol
- C/C++
- PL/I
- Lenguajes de ensamblaje de alto nivel
El término conexión local hace referencia a un enlace de memoria cruzada que se crea para establecer comunicación entre un espacio de direcciones externo en el sistema z/OS y el servidor de Liberty 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 se puede utilizar solamente para un conjunto de agrupaciones de conexiones por espacio de direcciones. El número de registros exclusivos en un espacio de direcciones único está limitado solamente por la cantidad de almacenamiento disponible.
- Register - BBOA1REG
- Unregister - BBOA1URG
- Connection Get - BBOA1CNG
- Connection Release - BBOA1CNR
- Send Request - BBOA1SRQ
- Send Response - BBOA1SRP
- Send Response Exception - BBOA1SRX
- Receive Request Any - BBOA1RCA
- Receive Request Specific - BBOA1RCS
- Receive Response Length - BBOA1RCL
- Get Message Data - BBOA1GET
- Invoke - BBOA1INV
- Host Service - BBOA1SRV
- API de adaptador JCA
Register
Utilizando la API BBOA1REG, , puede registrarse con un servidor de Liberty local. La API BBOA1REG solicita que se asigne y se registre un grupo de conexiones optimizadas en un servidor de Liberty local bajo el nombre de registro especificado.
API | Sintaxis |
---|---|
BBOA1REG | BBOA1REG (wolagroupnamepart1, wolagroupnamepart2, wolagroupnamepart3, registername, minconn, maxconn, registerflags, rc, rsn) |
- wolagroupnamepart1
- Una variable de entrada o una constante de entrada que contiene la primera parte del nombre del grupo de adaptadores locales optimizados que se deben unir. Debe ser una serie terminada en nulo de 8 caracteres exactamente y se debe pasar mediante referencia.
- wolagroupnamepart2
- Una variable de entrada o una constante de entrada que contiene la segunda parte del nombre del grupo de adaptadores locales optimizados que se deben unir. Debe ser una serie rellena de blancos de 8 caracteres exactamente y se debe pasar mediante referencia.
- wolagroupnamepart3
- Una variable de entrada o una constante de entrada que contiene la tercera parte del nombre del grupo de adaptadores locales optimizados que se deben unir. Debe ser una serie rellena de blancos de 8 caracteres exactamente y se debe pasar mediante referencia.
- registername (entrada)
- Variable de entrada o constante de entrada que contiene el nombre a utilizar para registrar un conjunto de conexiones locales. Las últimas llamadas requieren este nombre para identificar la agrupación de conexiones que debe utilizarse. Tiene que ser una cadena rellenada con espacios en blanco de 12 caracteres exactamente y no la puede usar otro cliente en el grupo daemon. Si este cliente conecta con varios grupos daemon, registername solo se podrá usar una vez en este cliente.
- minconn
- Un entero que contiene el número inicial mínimo de conexiones para asignar a este registro. Durante el registro, el adaptador intenta reservar este número
de conexiones con el servidor asociado. Importante: Como mínimo, se asigna una conexión para enlazarla al servidor de destino incluso si se ha especificado el parámetro minconn como 0, por lo que si se especifica 0 es igual que si se especifica 1.
- maxconn
- Un entero que contiene el número máximo de conexiones para asignar a este registro. El adaptador intenta ampliar la agrupación de conexiones local hasta este número durante una solicitud de la API Connection Get cuando se está utilizando el número mínimo de conexiones.
- registerflags
- Palabra de distintivo de 32 bits que contiene distintivos de registro.
- reg_flag_W2Cprop - bit 31
El distintivo reg_flag_W2Cprop controla la propagación de seguridad de transacciones de salida desde el servidor de Liberty hasta CICS.
- reg_flag_C2Wprop - bit 29
El distintivo reg_flat_C2Wprop propaga la identidad de la tarea de llamada desde CICS al servidor de Liberty. Para transacciones que son entrada de CICS, el distintivo controla cómo se determina la entidad. 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 Liberty. Cuando este bit está desactivado, se utiliza la identidad de región de CICS.
- reg_flag_trcmod - bit 0
Establezca el distintivo reg_flag_trcmod si desea modificar los valores de rastreo de adaptadores locales optimizados para el registro solicitado. Si no establece este distintivo, no se realiza cambio alguno en el valor de rastreo, y se utilizan los valores predeterminados del sistema o los valores de rastreo predefinidos que se aplican al nombre de registro o nombre de trabajo.
- reg_flag_trcmore - bit 1 y reg_flag_trcsome -
bit 2
Si establece el distintivo reg_flag_trcmod en 1, también debe especificar el nivel de rastreo para el registro estableciendo el distintivo reg_flag_trcmore para el rastreo detallado o el distintivo reg_flag_trcsome para el rastreo de nivel general. Si se establece reg_flag_trcmod en 1, el hecho de establecer tanto el distintivo reg_flag_trcmore como el distintivo reg_flag_trcsome en 0 obliga a que no se realice ningún rastreo de registro independientemente de qué definiciones previas o valores predeterminados se hayan establecido.
- reg_flag_W2Cprop - bit 31
- rc
- Un código de retorno entero que indica si esta llamada se ha efectuado correctamente o con errores.
- rsn
- Un código de razón entero que describe el motivo de una anomalía en esta llamada.
- Asegúrese de que se inicie el servidor de Liberty que ha especificado en esta llamada y de que se haya habilitado el soporte para los adaptadores locales.
- El valor mínimo de conexiones solicitado se valida respecto al valor máximo de conexiones del servidor. 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 de 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. Excepto en instancias específicas, no establezca un valor grande porque los recursos del servidor de Liberty se han reservado para cada conexión.
- Se pueden realizar varias llamadas a la API Register bajo la misma tarea de espacio de direcciones, hebra o sistema de control de información de cliente (CICS); sin embargo, no pueden compartir el nombre de registro. El nombre de registro debe ser un nombre exclusivo.
- Utilice la llamada a la API Unregister para eliminar este registro y liberar la agrupación de conexiones que está asociada al mismo.
- Cuando el espacio de direcciones que forma una llamada de registro termina, 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 | 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 el código de razón | |
8 | La señal de nombre de registro ya existe. | Anule el registro de este nombre antes de llamar a la API Register. | |
12 | El valor del parámetro de número mínimo de conexiones es superior al valor 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 de conexiones. | |
14 | Se ha terminado la memoria 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. | |
74 | El nombre de registro de entrada contiene un valor nulo. | Antes de llamar a la API Register, rellene el nombre de registro con espacios en blanco para que el nombre sea de exactamente 12 caracteres de longitud. | |
236 |
La parte 2 o 3 del nombre WOLA estaba vacía o no estaba. | Asegúrese de que la parte 2 o 3 del nombre WOLA se han especificado en la llamada BBOA1REG. | |
480 |
El cliente no se ha podido convertir en cliente autorizado para invocar la función de registro. | Esta condición es inesperada. Asegúrese de que el servidor de destino se está ejecutando y de que el servicio zosLocalAdapters se ha configurado en la instancia de servidor. | |
481 |
El cliente no ha podido buscar la tabla de función autorizada para servicios zosLocalAdapters. | Asegúrese de que la característica zosLocalAdapters se ha configurado en la instancia del servidor de destino. | |
12 | 10 | La API no ha podido localizar el grupo de adaptadores locales optimizados que se ha seleccionado. | Asegúrese de que se haya iniciado el servidor de Liberty y el servidor de destino, verifique que el soporte de adaptadores locales optimizados esté activo y vuelva a intentarlo. |
14 | El ID de usuario no está autorizado para el servidor de Liberty solicitado. | Asegúrese de que el ID de usuario está autorizado para la clase CBIND SAF para el servidor de Liberty solicitado. | |
16 | No se encuentra la parte 2 o la parte 3 del nombre de grupo de adaptadores locales optimizados. | Asegúrese de que los parámetros del nombre del grupo de adaptadores locales optimizados que se pasan sean válidos y de que el servidor esté activo. | |
23 | Se ha producido un error al denominar la señal. | Consulte la información de determinación de problemas en el Sitio de soporte de WebSphere Application Server. | |
24 | Se ha producido un error al establecer la conexión inicial de comunicación local del servidor de Liberty. | Consulte los registros de la región del servidor de Liberty para obtener detalles sobre la llamada de conexión de comunicación local. | |
28 | El registro identificado con este nombre no es válido. | El nombre de registro especificado ya está registrado, pero falta el registro. Como solución temporal, llame a la API Unregister e intente llamar de nuevo a la API Register. Si el problema persiste, consulte la información sobre determinación de problemas en el Sitio de soporte de WebSphere Application Server. | |
68 | Ha fallado una conexión a la memoria compartida. | Consulte la información de determinación de problemas en el Sitio de soporte de WebSphere Application Server. | |
86 | No se ha podido localizar el BGVT maestro del servidor de Liberty. | El servidor de Liberty no se ha iniciado en la imagen del sistema operativo z/OS actual. Asegúrese de que se haya iniciado el servidor antes de iniciar cualquier proceso de cliente de adaptadores locales optimizados. | |
88 | No se ha podido localizar la tabla del apéndice de cliente maestro del servidor de Liberty. | Se ha iniciado un servidor de Liberty en la imagen del sistema operativo z/OS actual pero el servidor no se está ejecutando en el nivel que admite la tabla del apéndice de cliente de los adaptadores locales optimizados. Asegúrese de que la aplicación se está ejecutando con el nivel de apéndices de adaptadores locales optimizados compatibles con el servidor de Liberty en este sistema z/OS. | |
90 | No se ha podido localizar la ranura de tabla de apéndice cliente maestro para los adaptadores locales optimizados del servidor de Liberty. | Se ha iniciado un servidor de Liberty en la imagen del sistema operativo z/OS actual pero el servidor no se está ejecutando en el nivel que admite la tabla del apéndice de cliente de los adaptadores locales optimizados. Asegúrese de que la aplicación se está ejecutando con el nivel de apéndices de adaptadores locales optimizados compatibles con el servidor de Liberty en este sistema z/OS. | |
232 |
Se ha producido una condición de falta de memoria durante una llamada de registro. | Asegúrese de que la memoria está disponible en el cliente en la subagrupación 0. Vuelva a intentar la llamada BBOA1REG. | |
234 |
El cliente no se ha podido enlazar a la instancia de servidor Liberty. | Asegúrese de que la instancia del servidor Liberty se ha iniciado y que el servicio zosLocalAdapters se ha configurado en la instancia del servidor. | |
238 |
El cliente no ha podido localizar el registro del servidor de destino. | Esta condición es inesperada. Asegúrese de que la instancia del servidor de destino se ha iniciado y que la característica zosLocalAdapters se ha configurado. Si el servidor se ha detenido, inícielo y vuelva a intentar la llamada BBOA1REG. |
Anulación de registro
Anulación del registro desde el grupo de adaptadores locales optimizados y del servidor de Liberty utilizando la API BBOA1URG .API | Sintaxis |
---|---|
BBOA1URG | BBOA1URG (registername, unregflags, rc, rsn) |
- registername
- Una variable de entrada o una constante de entrada que contiene el nombre que se debe utilizar para anular el registro de un conjunto de conexiones locales. El valor debe ser exactamente de 12 caracteres, con relleno de espacios en blanco y se utiliza el mismo nombre que para la llamada de API Register.
- unregisterflags
- Palabra de distintivo de 32 bits que contiene distintivos de anulación de registro.
- Reserved - bit 0-30
- Force (0|1) - bit 31
Especifique 1 para forzar la solicitud de anulación de registro. De forma predeterminada, se completa una solicitud de anulación de registro si se devuelven todas las conexiones a la agrupación de conexiones. Si no se han devuelto todas las conexiones a la agrupación de conexiones, el emisor de la llamada recibe un aviso. El proceso de anulación de registro se completa cuando se devuelve la última conexión a la agrupación. Realice una segunda solicitud de registro con el bit force establecido en 1 para obligar al proceso de anulación de registro a que complete e invalide todos los manejadores de conexiones restantes para ese registro.
- rc
- Un código de retorno entero que indica si esta llamada se ha efectuado correctamente o con errores.
- rsn
- Un código de razón entero que describe el motivo de una anomalía en esta llamada.
- Asegúrese de que se inicie el servidor de Liberty que ha especificado en esta llamada y de que se haya habilitado el soporte para los adaptadores locales.
- Si no se invoca a la API Unregister y el espacio de direcciones que realizó una llamada de registro termina, automáticamente se efectúa una llamada de anulación de registro y se liberan las conexiones.
- Cualquier manejador de conexión para este registro que esté activo cuando se produce la llamada de anulación de registro puede seguir siendo válido hasta que se devuelven a la agrupación de conexión utilizando la API Connection Release. Para forzar la limpieza de los descriptores de conexión, debe realizarse 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 el 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 de registro de éste. | |
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. | |
82 | Ya se ha realizado un intento de anular el registro de este registro. | Espere a que la solicitud de anulación anterior finalice o vuelva a emitir la anulación con la opción force. | |
228 |
La llamada para anular registro no se ha podido completar porque el registro ya se ha reutilizado. | No es necesaria ninguna acción. | |
230 |
La agrupación de conexiones no se ha podido borrar en una llamada para forzar la anulación del registro. | No es necesaria ninguna acción. Para evitar el uso de una llamada para forzar la anulación del registro, asegúrese de que la aplicación devuelve todos los descriptores de conexión a la agrupación antes de llamar para anular el registro. | |
480 |
El cliente no se ha podido convertir en un cliente autorizado para llamar a la función para anular registro. | Esta condición es inesperada. Asegúrese de que el servidor de destino se está ejecutando y de que el servicio zosLocalAdapters se ha configurado en la instancia de servidor. | |
12 | 86 | No se ha podido localizar el BGVT maestro del servidor de Liberty. | El servidor de Liberty no se ha iniciado en la imagen del sistema operativo z/OS actual. Asegúrese de que se haya iniciado el servidor antes de iniciar cualquier proceso de cliente de adaptadores locales optimizados. |
88 | No se ha podido localizar la tabla del apéndice de cliente maestro del servidor de Liberty. | Se ha iniciado un servidor de Liberty en la imagen del sistema operativo z/OS actual pero el servidor no se está ejecutando en el nivel que admite la tabla del apéndice de cliente de los adaptadores locales optimizados. Asegúrese de que la aplicación se está ejecutando con el nivel de apéndices de adaptadores locales optimizados compatibles con el servidor de Liberty en este sistema z/OS. | |
90 | No se ha podido localizar la ranura de tabla de apéndice cliente maestro para los adaptadores locales optimizados del servidor de Liberty. | Se ha iniciado un servidor de Liberty en la imagen del sistema operativo z/OS actual pero el servidor no se está ejecutando en el nivel que admite la tabla del apéndice de cliente de los adaptadores locales optimizados. Asegúrese de que la aplicación se está ejecutando con el nivel de apéndices de adaptadores locales optimizados compatibles con el servidor de Liberty en este sistema z/OS. |
Connection Get
Esta API solicita que se devuelva una conexión disponible desde la agrupación que se creó con el nombre de registro seleccionado.API | Sintaxis |
---|---|
BBOA1CNG | BBOA1CNG (registername, connectionhandle, waittime, rc, rsn) |
- registername
- Variable de entrada o constante de entrada que contiene el nombre que debe utilizarse para localizar la agrupación de conexiones de la que debe recuperarse una conexión. Debe ser una serie rellenada con espacios en blanco de 12 caracteres exactamente.
- connectionhandle
- Un manejador de conexiones de 12 bytes que debe pasarse en solicitudes posteriores para acciones en esta conexión.
- waittime
- Un 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 implica que no hay tiempo de espera y la API espera indefinidamente. El parámetro waittime solo se aplica al proceso de obtención de una conexión WOLA desde la agrupación de conexiones. Cuando se obtiene la conexión, se utiliza para recibir una solicitud del servidor con un tiempo de espera ilimitado.
- rc
- Un código de retorno entero que indica si esta llamada se ha efectuado correctamente o con errores.
- rsn
- Un código de razón entero que describe el motivo de una anomalía en esta llamada.
- Asegúrese de que se inicie el servidor de Liberty que ha especificado en esta llamada y de que se haya habilitado el soporte para los adaptadores locales.
- Asegúrese de que se haya completado una llamada a la API Register de forma correcta en el espacio de direcciones actual con un nombre coincidente antes de utilizar la API Connection Get.
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 el código de razón | |
8 | La señal de nombre de registro no existe. | Registre este nombre antes de invocar al nombre con la API Connection Get. | |
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 emita la macro de terminación anómala para terminar la tarea que ha llamado a la API Connection Get. También puede aumentar las conexiones máximas definiendo la llamada a la API Register. | |
24 | Después de una llamada de registro satisfactoria, se ha producido un error al obtener una conexión de la agrupación. | Compruebe que el servidor esté iniciado. Si no funciona, reinicie el servidor e intente de nuevo la petición de API. | |
28 | Se ha encontrado el registro pero no está inactivo. | ||
224 |
Se ha encontrado un registro incompleto. | Esta condición es inesperada. Utilice el servicio BBOA1URG para anular registro y utilice el servicio BBOA1REG para volver a registrar. | |
480 |
El cliente no se ha podido convertir en un cliente autorizado para llamar a la función obtener conexión. | Esta condición es inesperada. Asegúrese de que el servidor de destino se está ejecutando y de que el servicio zosLocalAdapters se ha configurado en la instancia de servidor. | |
482 |
El cliente no se ha podido reconectar a la instancia del servidor de destino, después de que el servidor se haya reiniciado. | Esta condición es inesperada. Utilice el servicio BBOA1URG para eliminar el registro, y utilice el servicio BBOA1REG para crear uno nuevo. | |
483 |
El cliente no se ha podido reconectar a la instancia del servidor de destino, después de que el servidor se haya reiniciado. | Esta condición es inesperada. Utilice el servicio BBOA1URG para eliminar el registro, y utilice el servicio BBOA1REG para crear uno nuevo. | |
12 | 10 | La API no ha podido localizar el grupo de adaptadores locales optimizados que se ha seleccionado. | Asegúrese de que se haya iniciado el servidor de Liberty y el servidor de destino, verifique que el soporte de adaptadores locales optimizados esté activo y vuelva a intentarlo. |
14 |
El ID de usuario no está autorizado para el servidor de Liberty solicitado. | Asegúrese de que el ID de usuario está autorizado para la clase CBIND SAF para el servidor de Liberty solicitado. | |
86 | No se ha podido localizar el BGVT maestro del servidor de Liberty. | El servidor de Liberty no se ha iniciado en la imagen del sistema operativo z/OS actual. Asegúrese de que se haya iniciado el servidor antes de iniciar cualquier proceso de cliente de adaptadores locales optimizados. | |
88 | No se ha podido localizar la tabla del apéndice de cliente maestro del servidor de Liberty. | Se ha iniciado un servidor de Liberty en la imagen del sistema operativo z/OS actual pero el servidor no se está ejecutando en el nivel que admite la tabla del apéndice de cliente de los adaptadores locales optimizados. Asegúrese de que la aplicación se está ejecutando con el nivel de apéndices de adaptadores locales optimizados compatibles con el servidor de Liberty en este sistema z/OS. | |
90 | No se ha podido localizar la ranura de tabla de apéndice cliente maestro para los adaptadores locales optimizados del servidor de Liberty. | Se ha iniciado un servidor de Liberty en la imagen del sistema operativo z/OS actual pero el servidor no se está ejecutando en el nivel que admite la tabla del apéndice de cliente de los adaptadores locales optimizados. Asegúrese de que la aplicación se está ejecutando con el nivel de apéndices de adaptadores locales optimizados compatibles con el servidor de Liberty en este sistema z/OS. |
Liberación de conexión
La API Connection Release solicita que se devuelva una conexión a la agrupación de donde se ha recuperado y que esté disponible para otro solicitante.API | Sintaxis |
---|---|
BBOA1CNR | BBOA1CNR (connectionhandle, rc, rsn) |
- connectionhandle
- Un manejador de conexiones de 12 bytes que indica la conexión obtenida anteriormente que se debe volver a liberar a la agrupación de conexión.
- rc
- Un código de retorno entero que indica si esta llamada se ha efectuado correctamente o con errores.
- rsn
- Un código de razón entero que describe el motivo de una anomalía en esta llamada.
- Asegúrese de que se inicie el servidor de Liberty que ha especificado en esta llamada y de que se haya habilitado el soporte para los adaptadores locales.
- Antes de utilizar la API Connection Release, asegúrese de que se haya completado una llamada a la API Register en el espacio de direcciones actual con un nombre coincidente y que se haya realizado una llamada a la API Connection Get correctamente 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 ha podido localizar el grupo de adaptadores locales optimizados y el servidor de Liberty. Se borrará cualquier recurso relacionado a esta conexión. | Ninguna |
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 del 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. | |
12 | 86 | No se ha podido localizar el BGVT maestro del servidor de Liberty. | El servidor de Liberty no se ha iniciado en la imagen del sistema operativo z/OS actual. Asegúrese de que se haya iniciado el servidor antes de iniciar cualquier proceso de cliente de adaptadores locales optimizados. |
88 | No se ha podido localizar la tabla del apéndice de cliente maestro del servidor de Liberty. | Se ha iniciado un servidor de Liberty en la imagen del sistema operativo z/OS actual pero el servidor no se está ejecutando en el nivel que admite la tabla del apéndice de cliente de los adaptadores locales optimizados. Asegúrese de que la aplicación se está ejecutando con el nivel de apéndices de adaptadores locales optimizados compatibles con el servidor de Liberty en este sistema z/OS. | |
90 | No se ha podido localizar la ranura de tabla de apéndice cliente maestro para los adaptadores locales optimizados del servidor de Liberty. | Se ha iniciado un servidor de Liberty en la imagen del sistema operativo z/OS actual pero el servidor no se está ejecutando en el nivel que admite la tabla del apéndice de cliente de los adaptadores locales optimizados. Asegúrese de que la aplicación se está ejecutando con el nivel de apéndices de adaptadores locales optimizados compatibles con el servidor de Liberty en este sistema z/OS. |
Send Request
Estas API envían una solicitud al servidor de Liberty local para su proceso.API | Sintaxis |
---|---|
BBOA1SRQ | BBOA1SRQ (connectionhandle, requesttype, requestservicename, requestservicenamel, requestdata, requestdatalen, async(0|1), responsedatalen, rc, rsn) |
- connectionhandle
- Un manejador de conexiones de 12 bytes que se debe utilizar para esta solicitud.
- requesttype
- Un entero que contiene el tipo de solicitud que indica el tipo de solicitud de trabajo que se va a procesar. El único valor soportado es 1 para solicitudes de trabajos EJB locales.
- requestservicename
- Una serie de caracteres EBCDIC de una longitud de hasta 256 que contiene el nombre del servicio que se debe invocar. Este parámetro especifica el nombre JNDI de la interfaz empresarial local.
- requestservicenamel
- Un entero que contiene la longitud del nombre de servicio que se va a iniciar o 0 (cero) si el nombre de servicio ha terminado en un valor nulo.
- requestdata
- Un puntero de 31 bits a la dirección del inicio de los datos de solicitud que se deben enviar.
- requestdatalen
- Un valor sin signo de 32 bits que contiene la longitud de los datos que se deben enviar.
- async(0|1)
- Defina async en 1 para indicar que el interlocutor desea que se devuelva de inmediato el control, incluso aunque sea probable que la longitud de la respuesta todavía no se conozca. Si ha establecido async en 0, la hebra actual espera a que el servidor de Liberty devuelva la respuesta y la API devuelve la longitud de respuesta al parámetro de salida responsedatalen.
- responsedatalen
- Un valor sin signo de 32 bits que contiene la longitud de la respuesta. El interlocutor puede utilizar esta longitud para conseguir almacenamiento antes de realizar la llamada a la API Get Data para copiar los datos. Cuando se establece async en 1, indicando que el interlocutor desea volver a tener inmediatamente el control, el valor se establece en 0xFFFFFFFF si todavía no se ha recibido una respuesta.
- rc
- Un código de retorno entero que indica si esta llamada se ha efectuado correctamente o con errores.
- rsn
- Un código de razón entero que describe el motivo de una anomalía en esta llamada.
- Asegúrese de que se inicie el servidor de Liberty que ha especificado en esta llamada y de que se haya habilitado el soporte para los adaptadores locales.
- Asegúrese de que se haya completado una llamada a la API Register de forma correcta en el espacio de direcciones actual con un nombre coincidente antes de utilizar la API Send Request.
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 el 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. | |
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 del mensaje es más largo de lo que admite el tamaño del servidor de Liberty. Verifique que el tamaño sea válido. Si el tamaño es válido, asegúrese de que el tamaño del servidor de Liberty es lo suficientemente grande para acomodar al tamaño del mensaje. | |
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 ha encontrado el servicio de destino. | Asegúrese de que la aplicación que contiene el enterprise bean de destino esté instalada y se haya iniciado en el servidor de destino para el servidor de Liberty. | |
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 Liberty 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 los registros del servidor de Liberty para revisar los datos de excepción. | |
46 | Se ha producido un error en la llamada de envío de solicitud de comunicaciones locales. | Compruebe los registros del servidor de Liberty para determinar el error. | |
98 | No se puede acceder al principio de la solicitud de almacenamiento intermedio proporcionado. | Asegúrese de que la dirección y la longitud del almacenamiento intermedio de solicitud proporcionado sean correctos. | |
100 | No se puede acceder al final de la solicitud de almacenamiento intermedio proporcionado. | Asegúrese de que la dirección y la longitud del almacenamiento intermedio de solicitud proporcionado sean correctos. | |
12 | 10 | La API no ha podido localizar el grupo de adaptadores locales optimizados que se ha seleccionado. | Asegúrese de que se haya iniciado el servidor de Liberty y el servidor de destino, verifique que el soporte de adaptadores locales optimizados esté activo y vuelva a intentarlo. |
86 | No se ha podido localizar el BGVT maestro del servidor de Liberty. | El servidor de Liberty no se ha iniciado en la imagen del sistema operativo z/OS actual. Asegúrese de que se haya iniciado el servidor antes de iniciar cualquier proceso de cliente de adaptadores locales optimizados. | |
88 | No se ha podido localizar la tabla del apéndice de cliente maestro del servidor de Liberty. | Se ha iniciado un servidor de Liberty en la imagen del sistema operativo z/OS actual pero el servidor no se está ejecutando en el nivel que admite la tabla del apéndice de cliente de los adaptadores locales optimizados. Asegúrese de que la aplicación se está ejecutando con el nivel de apéndices de adaptadores locales optimizados compatibles con el servidor de Liberty en este sistema z/OS. | |
90 | No se ha podido localizar la ranura de tabla de apéndice cliente maestro para los adaptadores locales optimizados del servidor de Liberty. | Se ha iniciado un servidor de Liberty en la imagen del sistema operativo z/OS actual pero el servidor no se está ejecutando en el nivel que admite la tabla del apéndice de cliente de los adaptadores locales optimizados. Asegúrese de que la aplicación se está ejecutando con el nivel de apéndices de adaptadores locales optimizados compatibles con el servidor de Liberty en este sistema z/OS. |
Send Response
Esta API envía una respuesta a una solicitud al servidor de Liberty local.API | Sintaxis |
---|---|
BBOA1SRP | BBOA1SRP (connectionhandle, responsedata, responsedatalen, rc, rsn) |
- connectionhandle
- Un manejador de conexiones de 12 bytes que se debe utilizar para esta respuesta.
- responsedata
- Un puntero de 31 bits a la dirección del inicio de los datos de respuesta que se deben enviar.
- requestdatalen
- Un valor sin signo de 32 bits que contiene la longitud de los datos que se deben enviar.
- rc
- Un código de retorno entero que indica si esta llamada se ha efectuado correctamente o con errores.
- rsn
- Un código de razón entero que describe el motivo de una anomalía en esta llamada.
- Asegúrese de que se inicie el servidor de Liberty que ha especificado en esta llamada y de que se haya habilitado el soporte para los adaptadores locales.
- Asegúrese de que se haya completado una llamada a la API Register de forma correcta en el espacio de direcciones actual con un nombre coincidente antes de utilizar la API Send Response.
- Asegúrese de que se haya completado correctamente una llamada a la API Connection Get y que el manejador se proporciona como entrada en esta llamada.
- Asegúrese de que se ha emitido correctamente una llamada de recepción de cualquier solicitud, recepción de una solicitud específica o API de host y que la llamada ha regresado con los datos de solicitud para el manejador de conexiones. La conexión debe hallarse en un estado en que la API Send Response 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 el 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. | |
18 | La longitud de solicitud excede los límites de sistema. | El tamaño del mensaje es más largo de lo que admite el tamaño del servidor de Liberty. Verifique que el tamaño sea válido. Si el tamaño es válido, asegúrese de que el tamaño del servidor de Liberty es lo suficientemente grande para acomodar al tamaño del mensaje. | |
34 | No se ha encontrado el servicio de destino. | Asegúrese de que la aplicación que contiene el enterprise bean de destino esté instalada y se haya iniciado en el servidor de destino para el servidor de Liberty. | |
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 Liberty los mensajes de error de comunicaciones locales. | |
46 | Se ha producido un error en la llamada de envío de solicitud de comunicaciones locales. | Compruebe los registros del servidor de Liberty para determinar el error. | |
102 | No se puede acceder al principio del almacenamiento intermedio de respuesta proporcionado. | Asegúrese de que la dirección y longitud del almacenamiento intermedio de respuesta proporcionado sean correctas. | |
104 | No se puede acceder al final del almacenamiento intermedio de respuesta proporcionado. | Asegúrese de que la dirección y longitud del almacenamiento intermedio de respuesta proporcionado sean correctas. | |
480 |
El cliente no se ha podido convertir en un cliente autorizado para llamar a la función enviar respuesta. | Esta condición es inesperada. Asegúrese de que el servidor de destino se está ejecutando y de que el servicio zosLocalAdapters se ha configurado en la instancia de servidor. | |
12 | 10 | La API no ha podido localizar el grupo de adaptadores locales optimizados que se ha seleccionado. | Asegúrese de que se haya iniciado el servidor de Liberty y el servidor de destino, verifique que el soporte de adaptadores locales optimizados esté activo y vuelva a intentarlo. |
86 | No se ha podido localizar el BGVT maestro del servidor de Liberty. | El servidor de Liberty no se ha iniciado en la imagen del sistema operativo z/OS actual. Asegúrese de que se haya iniciado el servidor antes de iniciar cualquier proceso de cliente de adaptadores locales optimizados. | |
88 | No se ha podido localizar la tabla del apéndice de cliente maestro del servidor de Liberty. | Se ha iniciado un servidor de Liberty en la imagen del sistema operativo z/OS actual pero el servidor no se está ejecutando en el nivel que admite la tabla del apéndice de cliente de los adaptadores locales optimizados. Asegúrese de que la aplicación se está ejecutando con el nivel de apéndices de adaptadores locales optimizados compatibles con el servidor de Liberty en este sistema z/OS. | |
90 | No se ha podido localizar la ranura de tabla de apéndice cliente maestro para los adaptadores locales optimizados del servidor de Liberty. | Se ha iniciado un servidor de Liberty en la imagen del sistema operativo z/OS actual pero el servidor no se está ejecutando en el nivel que admite la tabla del apéndice de cliente de los adaptadores locales optimizados. Asegúrese de que la aplicación se está ejecutando con el nivel de apéndices de adaptadores locales optimizados compatibles con el servidor de Liberty en este sistema z/OS. |
Send Response Exception
Esta API envía una excepción ResourceException que contiene los datos de respuesta pasándolos al interlocutor de JCA del servidor de Liberty local.
API | Sintaxis |
---|---|
BBOA1SRX | BBOA1SRX (connectionhandle, excresponsedata, exresponsedatalen, rc, rsn) |
- connectionhandle
- Un manejador de conexiones de 12 bytes que se debe utilizar para esta respuesta.
- excresponsedata
- Un puntero de 31 bits a la dirección del inicio de los datos de respuesta de excepción que se deben enviar.
- excresponsedatalen
- Un valor sin signo de 32 bits que contiene 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
- Un código de retorno entero que indica si esta llamada se ha efectuado correctamente o con errores.
- rsn
- Un código de razón entero que describe el motivo de una anomalía en esta llamada.
- Asegúrese de que se inicie el servidor de Liberty que ha especificado en esta llamada y de que se haya habilitado el soporte para los adaptadores locales.
- Asegúrese de que se haya completado correctamente la API Register en el espacio de direcciones actual con un nombre coincidente antes de utilizar la llamada de respuesta de envío.
- Asegúrese de que se haya completado correctamente la API Connection Get y que se proporciona el manejador como entrada en esta API.
- Asegúrese de que se haya emitido y devuelto una llamada a la API Receive Request Any, Receive Request Specific o Host Service 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 el 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 válido. | |
16 | Uno o varios parámetros no son válidos. | Verifique que todos los parámetros sean válidos e intente efectuar de nuevo la llamada. | |
18 | La longitud de solicitud excede los límites de sistema. | El tamaño del mensaje es más largo de lo que admite el tamaño del servidor de Liberty. Verifique que el tamaño sea válido. Si el tamaño es válido, asegúrese de que el tamaño del servidor de Liberty es lo suficientemente grande para acomodar al tamaño del mensaje. | |
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 Liberty los mensajes de error de comunicaciones locales. | |
46 | Se ha producido un error en la llamada de envío de solicitud de comunicaciones locales. | Compruebe los registros del servidor de Liberty para determinar el error. | |
102 | No se puede acceder al principio del almacenamiento intermedio de respuesta proporcionado. | Asegúrese de que la dirección y longitud del almacenamiento intermedio de respuesta proporcionado sean correctas. | |
104 | No se puede acceder al final del almacenamiento intermedio de respuesta proporcionado. | Asegúrese de que la dirección y longitud del almacenamiento intermedio de respuesta proporcionado sean correctas. | |
480 |
El cliente no se ha podido convertir en un cliente autorizado para llamar a la función enviar excepción. | Esta condición es inesperada. Asegúrese de que el servidor de destino se está ejecutando y de que el servicio zosLocalAdapters se ha configurado en la instancia de servidor. | |
12 | 10 | La API no ha podido localizar el grupo de adaptadores locales optimizados que se ha seleccionado. | Asegúrese de que se haya iniciado el servidor de Liberty y el servidor de destino, verifique que el soporte de adaptadores locales optimizados esté activo y vuelva a intentarlo. |
86 | No se ha podido localizar el BGVT maestro del servidor de Liberty. | El servidor de Liberty no se ha iniciado en la imagen del sistema operativo z/OS actual. Asegúrese de que se haya iniciado el servidor antes de iniciar cualquier proceso de cliente de adaptadores locales optimizados. | |
88 | No se ha podido localizar la tabla del apéndice de cliente maestro del servidor de Liberty. | Se ha iniciado un servidor de Liberty en la imagen del sistema operativo z/OS actual pero el servidor no se está ejecutando en el nivel que admite la tabla del apéndice de cliente de los adaptadores locales optimizados. Asegúrese de que la aplicación se está ejecutando con el nivel de apéndices de adaptadores locales optimizados compatibles con el servidor de Liberty en este sistema z/OS. | |
90 | No se ha podido localizar la ranura de tabla de apéndice cliente maestro para los adaptadores locales optimizados del servidor de Liberty. | Se ha iniciado un servidor de Liberty en la imagen del sistema operativo z/OS actual pero el servidor no se está ejecutando en el nivel que admite la tabla del apéndice de cliente de los adaptadores locales optimizados. Asegúrese de que la aplicación se está ejecutando con el nivel de apéndices de adaptadores locales optimizados compatibles con el servidor de Liberty en este sistema z/OS. |
Receive Request Any
Esta API recibe una solicitud y libera datos desde un servidor de Liberty local en cualquier conexión de la agrupación para el nombre de registro que se ha pasado. La API devuelve la longitud de los datos de solicitud y un manejador de conexiones como parámetros de salida. La llamada a la API Get Data con el manejador de conexiones devuelto ha devuelto datos de mensajes recibidos.
API | Sintaxis |
---|---|
BBOA1RCA | BBOA1RCA (registername, connectionhandle, requestservicename, requestservicenamel, requestdatalen, waittime, rc, rsn) |
- registername
- Variable de entrada o constante de entrada que contiene el nombre que debe utilizarse para localizar la agrupación de conexiones de la que debe recuperarse una conexión. El valor debe ser una serie de relleno de blancos de 12 caracteres exactamente.
- waittime
- Un 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. El parámetro waittime solo se aplica al proceso de obtención de una conexión WOLA desde la agrupación de conexiones. Cuando se obtiene la conexión, se utiliza para recibir una solicitud del servidor con un tiempo de espera ilimitado.
- requestservicename
- Una serie de caracteres EBCDIC de hasta 256 bytes que contiene el nombre del servicio. Este parámetro es el nombre del servicio de destino que ha especificado la aplicación del servidor de Liberty en la interfaz InteractionSpec. Un valor de * indica una solicitud de recepción para todos los nombres de servicio que llegan bajo el nombre de registro actual.
- requestservicenamel
- Un entero que contiene la longitud del nombre de servicio que se va a iniciar o 0 si el nombre de servicio ha terminado en un valor nulo.
- connectionhandle
- Un manejador de conexiones de 12 bytes que se devuelve y que debe pasarse en solicitudes posteriores para acciones en esta conexión.
- requestdatalen
- Un valor sin signo de 32 bits se devuelve con la longitud de los datos que se van a recibir.
- rc
- Un código de retorno entero que indica si esta llamada se ha efectuado correctamente o con errores.
- rsn
- Un código de razón entero que describe el motivo de una anomalía en esta llamada.
- Asegúrese de que se inicie el servidor de Liberty que ha especificado en esta llamada y de que se haya habilitado el soporte para los adaptadores locales.
- Asegúrese de que se haya completado correctamente una llamada a la API Register 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 el 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 que se pudiera obtener la solicitud de conexión. | El comportamiento de la aplicación varía. Espere y vuelva a intentarlo o emita la macro de terminación anómala para terminar la tarea que ha llamado a la API Connection Get. También puede aumentar las conexiones máximas definiendo la llamada a la API Register. | |
16 | La longitud de nombre de servicio de solicitud no es válida. | Corrija el programa y vuelva a intentar la llamada. | |
19 | Una llamada a un servicio de comunicaciones local ha recibido un código de retorno distinto de cero. | ||
21 | Una llamada a un servicio de comunicaciones local ha recibido un código de retorno distinto de cero. | ||
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 Liberty los mensajes de error de comunicaciones locales. | |
46 | Se ha producido un error en la llamada de envío de solicitud de comunicaciones locales. | Compruebe los registros del servidor de Liberty para determinar el error. | |
224 |
Se ha encontrado un registro incompleto. | Esta condición es inesperada. Utilice el servicio BBOA1URG para anular registro y utilice el servicio BBOA1REG para volver a registrar. | |
226 |
Se ha encontrado un descriptor de conexión incompleto. | Esta condición es inesperada. Utilice el servicio BBOA1RCA para volver a intentar la solicitud. | |
480 |
El cliente no se ha podido convertir en un cliente autorizado para llamar a la función recibir solicitud. | Esta condición es inesperada. Asegúrese de que el servidor de destino se está ejecutando y de que el servicio zosLocalAdapters se ha configurado en la instancia de servidor. | |
482 |
El cliente no se ha podido reconectar a la instancia del servidor de destino, después de que el servidor se haya reiniciado. | Esta condición es inesperada. Utilice el servicio BBOA1URG para eliminar el registro, y utilice el servicio BBOA1REG para crear uno nuevo. | |
483 |
El cliente no se ha podido reconectar a la instancia del servidor de destino, después de que el servidor se haya reiniciado. | Esta condición es inesperada. Utilice el servicio BBOA1URG para eliminar el registro, y utilice el servicio BBOA1REG para crear uno nuevo. | |
12 | 10 | La API no ha podido localizar el grupo de adaptadores locales optimizados que se ha seleccionado. | Asegúrese de que se haya iniciado el servidor de Liberty y el servidor de destino, verifique que el soporte de adaptadores locales optimizados esté activo y vuelva a intentarlo. |
14 |
El ID de usuario no está autorizado para el servidor de Liberty solicitado. | Asegúrese de que el ID de usuario está autorizado para la clase CBIND SAF para el servidor de Liberty solicitado. | |
24 | Tras una llamada de registro satisfactoria, se ha producido un error al obtener una conexión de la agrupación. | Compruebe que el servidor esté iniciado. Si el servidor no se ha iniciado, reinicie el servidor y vuelva a intentar la solicitud de API. | |
86 | No se ha podido localizar el BGVT maestro del servidor de Liberty. | El servidor de Liberty no se ha iniciado en la imagen del sistema operativo z/OS actual. Asegúrese de que se haya iniciado el servidor antes de iniciar cualquier proceso de cliente de adaptadores locales optimizados. | |
88 | No se ha podido localizar la tabla del apéndice de cliente maestro del servidor de Liberty. | Se ha iniciado un servidor de Liberty en la imagen del sistema operativo z/OS actual pero el servidor no se está ejecutando en el nivel que admite la tabla del apéndice de cliente de los adaptadores locales optimizados. Asegúrese de que la aplicación se está ejecutando con el nivel de apéndices de adaptadores locales optimizados compatibles con el servidor de Liberty en este sistema z/OS. | |
90 | No se ha podido localizar la ranura de tabla de apéndice cliente maestro para los adaptadores locales optimizados del servidor de Liberty. | Se ha iniciado un servidor de Liberty en la imagen del sistema operativo z/OS actual pero el servidor no se está ejecutando en el nivel que admite la tabla del apéndice de cliente de los adaptadores locales optimizados. Asegúrese de que la aplicación se está ejecutando con el nivel de apéndices de adaptadores locales optimizados compatibles con el servidor de Liberty en este sistema z/OS. |
Receive Request Specific
Esta API recibe una solicitud y datos relacionados de un servidor de Liberty local para el manejador de conexiones especificado. La API devuelve la longitud de datos de solicitud como parámetro de salida. La llamada a la API Get Data con el manejador de conexiones ha devuelto datos de mensajes recibidos.API | Sintaxis |
---|---|
BBOA1RCS | BBOA1RCS (connectionhandle, requestservicename, requestservicenamel, requestdatalen, async(0|1), rc, rsn) |
- connectionhandle
- Un manejador de conexiones de 12 bytes que se debe utilizar para la solicitud de recepción.
- async(0|1)
- Defina async en 1 para indicar que el interlocutor desea que se devuelva de inmediato el control, incluso aunque sea probable que la longitud de la respuesta todavía no se conozca. Si establece async en 0, esta llamada espera recibir una solicitud del servidor de Liberty.
- requestservicename
- Una serie de caracteres EBCDIC de hasta 256 bytes que contiene el nombre del servicio. Este parámetro es el nombre del servicio de destino que ha especificado la aplicación del servidor de Liberty en la interfaz InteractionSpec. Un valor de * indica que se ha establecido como servidor para todos los nombres de servicio que llegan bajo el nombre del registro actual.
- requestservicenamel
- Un entero que contiene la longitud del nombre de servicio que se va a iniciar o 0 si el nombre de servicio ha terminado en un valor nulo.
- requestdatalen
- Un valor sin signo de 32 bits que contiene la longitud de los datos de solicitud recibidos. Entonces el interlocutor podrá utilizar esta longitud para conseguir almacenamiento antes de realizar la llamada a la API Get Data para copiar los datos. Cuando async se define en 1, indicando que el interlocutor desea recuperar inmediatamente el control, el valor se establece en 0xFFFFFFFF si todavía no se han recibido los datos solicitados. En este caso, deberá llamar de nuevo a la API para recuperar una solicitud de entrada.
- rc
- Un código de retorno entero que indica si esta llamada se ha efectuado correctamente o con errores.
- rsn
- Un código de razón entero que describe el motivo de una anomalía en esta llamada.
- Asegúrese de que se inicie el servidor de Liberty que ha especificado en esta llamada y de que se haya habilitado el soporte para los adaptadores locales.
- Asegúrese de que se haya completado correctamente una llamada a la API Register 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 el 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. | |
16 | La longitud de nombre de servicio de solicitud no es válida. | Corrija el programa y vuelva a intentar la llamada. | |
19 | Una llamada a un servicio de comunicaciones local ha recibido un código de retorno distinto de cero. | ||
21 | Una llamada a un servicio de comunicaciones local ha recibido un código de retorno distinto de cero. | ||
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 Liberty los mensajes de error de comunicaciones locales. | |
46 | Se ha producido un error en la llamada de envío de solicitud de comunicaciones locales. | Compruebe los registros del servidor de Liberty 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 provocado que la conexión seleccione una petición que no formaba parte de la transacción que está siendo procesada por esta conexión. | Devuelva la conexión a la agrupación de conexiones. Si el problema persiste, consulte la información sobre determinación de problemas en el Sitio de soporte de WebSphere Application Server. | |
80 | La transacción que está activa en esta conexión ha agotado el tiempo de espera y no se puede volver a establecer el estado de conexión para que se procese otra solicitud. | Devuelva la conexión a la agrupación de conexiones. Si el problema persiste, consulte la información sobre determinación de problemas en el Sitio de soporte de WebSphere Application Server. | |
226 |
Se ha encontrado un descriptor de conexión incompleto. | Esta condición es inesperada. Utilice el servicio BBOA1CNR para liberar la conexión y utilice el servicio BBOA1CNG para obtener una nueva conexión. | |
480 |
El cliente no se ha podido convertir en un cliente autorizado para llamar a la función recibir solicitud. | Esta condición es inesperada. Asegúrese de que el servidor de destino se está ejecutando y de que el servicio zosLocalAdapters se ha configurado en la instancia de servidor. | |
12 | 10 | La API no ha podido localizar el grupo de adaptadores locales optimizados que se ha seleccionado. | Asegúrese de que se haya iniciado el servidor de Liberty y el servidor de destino, verifique que el soporte de adaptadores locales optimizados esté activo y vuelva a intentarlo. |
86 | No se ha podido localizar el BGVT maestro del servidor de Liberty. | El servidor de Liberty no se ha iniciado en la imagen del sistema operativo z/OS actual. Asegúrese de que se haya iniciado el servidor antes de iniciar cualquier proceso de cliente de adaptadores locales optimizados. | |
88 | No se ha podido localizar la tabla del apéndice de cliente maestro del servidor de Liberty. | Se ha iniciado un servidor de Liberty en la imagen del sistema operativo z/OS actual pero el servidor no se está ejecutando en el nivel que admite la tabla del apéndice de cliente de los adaptadores locales optimizados. Asegúrese de que la aplicación se está ejecutando con el nivel de apéndices de adaptadores locales optimizados compatibles con el servidor de Liberty en este sistema z/OS. | |
90 | No se ha podido localizar la ranura de tabla de apéndice cliente maestro para los adaptadores locales optimizados del servidor de Liberty. | Se ha iniciado un servidor de Liberty en la imagen del sistema operativo z/OS actual pero el servidor no se está ejecutando en el nivel que admite la tabla del apéndice de cliente de los adaptadores locales optimizados. Asegúrese de que la aplicación se está ejecutando con el nivel de apéndices de adaptadores locales optimizados compatibles con el servidor de Liberty en este sistema z/OS. |
Receive Response Length
La API Receive Response Length recupera la longitud de los datos de respuesta de una llamada de solicitud de envío anterior.API | Sintaxis |
---|---|
BBOA1RCL | BBOA1RCL (connectionhandle, async(0|1), responsedatalen, rc, rsn) |
- connectionhandle
- Un manejador de conexiones de 12 bytes que se debe utilizar para esta solicitud.
- async(0|1)
- Defina async en 1 para indicar que el interlocutor desea que se devuelva de inmediato el control, incluso aunque sea probable que la longitud de la respuesta no se conozca. Si define async en 0, esta llamada espera a que el servidor de Liberty devuelva la respuesta y la API devuelve la longitud de respuesta en el parámetro responsedatalen.
- requestdatalen
- Un valor sin signo de 32 bits con la longitud de los datos recibidos. El interlocutor puede utilizar esta longitud para conseguir almacenamiento antes de realizar la llamada a la API Get Data para copiar los datos. Si establece async en 1, el valor se establece en 0xFFFFFFFF si todavía no se han recibido los datos de respuesta.
- rc
- Un código de retorno entero que indica si esta llamada se ha efectuado correctamente o con errores.
- rsn
- Un código de razón entero que describe el motivo de una anomalía en esta llamada.
- Asegúrese de que se inicie el servidor de Liberty que ha especificado en esta llamada y de que se haya habilitado el soporte para los adaptadores locales.
- Asegúrese de que se haya completado correctamente una llamada a la API Register en el espacio de direcciones actual con un nombre coincidente antes de utilizar esta API.
- Asegúrese de que se haya completado correctamente una llamada a la API Connection Get y que el manejador se proporciona como entrada en esta llamada.
- Asegúrese de que se haya completado correctamente una API Send Request antes de llevar a cabo 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 el 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. | |
19 | Una llamada a un servicio de comunicaciones local ha recibido un código de retorno distinto de cero. | ||
21 | Una llamada a un servicio de comunicaciones local ha recibido un código de retorno distinto de cero. | ||
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 Liberty los mensajes de error de comunicaciones locales. | |
226 |
Se ha encontrado un descriptor de conexión incompleto. | Esta condición es inesperada. Utilice el servicio BBOA1CNR para liberar la conexión y utilice el servicio BBOA1CNG para obtener una nueva conexión. | |
480 |
El cliente no se ha podido convertir en un cliente autorizado para llamar a la función recibir longitud. | Esta condición es inesperada. Asegúrese de que el servidor de destino se está ejecutando y de que el servicio zosLocalAdapters se ha configurado en la instancia de servidor. | |
12 | 10 | La API no ha podido localizar el grupo de adaptadores locales optimizados que se ha seleccionado. | Asegúrese de que se haya iniciado el servidor de Liberty y el servidor de destino, verifique que el soporte de adaptadores locales optimizados esté activo y vuelva a intentarlo. |
86 | No se ha podido localizar el BGVT maestro del servidor de Liberty. | El servidor de Liberty no se ha iniciado en la imagen del sistema operativo z/OS actual. Asegúrese de que se haya iniciado el servidor antes de iniciar cualquier proceso de cliente de adaptadores locales optimizados. | |
88 | No se ha podido localizar la tabla del apéndice de cliente maestro del servidor de Liberty. | Se ha iniciado un servidor de Liberty en la imagen del sistema operativo z/OS actual pero el servidor no se está ejecutando en el nivel que admite la tabla del apéndice de cliente de los adaptadores locales optimizados. Asegúrese de que la aplicación se está ejecutando con el nivel de apéndices de adaptadores locales optimizados compatibles con el servidor de Liberty en este sistema z/OS. | |
90 | No se ha podido localizar la ranura de tabla de apéndice cliente maestro para los adaptadores locales optimizados del servidor de Liberty. | Se ha iniciado un servidor de Liberty en la imagen del sistema operativo z/OS actual pero el servidor no se está ejecutando en el nivel que admite la tabla del apéndice de cliente de los adaptadores locales optimizados. Asegúrese de que la aplicación se está ejecutando con el nivel de apéndices de adaptadores locales optimizados compatibles con el servidor de Liberty en este sistema z/OS. |
Get Message Data
Esta API copia los datos de mensaje recibidos. Cuando se devuelve esta API, se elimina el mensaje de la memoria caché de mensajes del adaptador.API | Sintaxis |
---|---|
BBOA1GET | BBOA1GET (connectionhandle, msgdata, msgdatalen, rc, rsn, rv) |
- connectionhandle
- Un manejador de conexiones de 12 bytes que se debe utilizar para esta solicitud.
- msgdata
- Un puntero de 31 bits del inicio del área de datos donde efectuar la copia. El almacenamiento al que apunta este parámetro debe estar en una clave en la que el interlocutor pueda escribir.
- msgdatalen
- Un valor sin signo de 32 bits que contiene la longitud de los datos que se deben copiar.
- rc
- Un código de retorno entero que indica si esta llamada se ha efectuado correctamente o con errores.
- rsn
- Un código de razón entero que describe el motivo de una anomalía en esta llamada.
- rv
- Un 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 inicie el servidor de Liberty que ha especificado en esta llamada y de que se haya habilitado el soporte para los adaptadores locales.
- Asegúrese de que se haya completado una llamada a la API Register de forma correcta en el espacio de direcciones actual con un nombre coincidente antes de utilizar la API Send Request.
- Asegúrese de que se haya completado correctamente una llamada a la API Connection Get y que el manejador se proporciona 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: Después de que la llamada de datos de mensajes se vuelve al interlocutor, los datos de mensajes no persisten y la conexión vuelve a un estado en el que puede utilizarse para otra llamada de solicitud de envío o recepción. Una llamada subsiguiente para obtener datos de mensaje o recibir la longitud de la respuesta da lugar a un error.
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 el 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 Liberty los mensajes de error de comunicaciones locales. | |
48 | Se ha producido un error en la solicitud de lectura de comunicaciones locales. | Compruebe los registros del servidor de Liberty 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. | |
98 | No se puede acceder al principio de la solicitud de almacenamiento intermedio proporcionado. | Asegúrese de que la dirección y la longitud del almacenamiento intermedio de solicitud proporcionado sean correctos. | |
100 | No se puede acceder al final de la solicitud de almacenamiento intermedio proporcionado. | Asegúrese de que la dirección y la longitud del almacenamiento intermedio de solicitud proporcionado sean correctos. | |
102 | No se puede acceder al principio del almacenamiento intermedio de respuesta proporcionado. | Asegúrese de que la dirección y longitud del almacenamiento intermedio de respuesta proporcionado sean correctas. | |
104 | No se puede acceder al final del almacenamiento intermedio de respuesta proporcionado. | Asegúrese de que la dirección y longitud del almacenamiento intermedio de respuesta proporcionado sean correctas. | |
226 |
Se ha encontrado un descriptor de conexión incompleto. | Esta condición es inesperada. Utilice el servicio BBOA1CNR para liberar la conexión y utilice el servicio BBOA1CNG para obtener una nueva conexión. | |
480 |
El cliente no se ha podido convertir en un cliente autorizado para llamar a la función obtener datos. | Esta condición es inesperada. Asegúrese de que el servidor de destino se está ejecutando y de que el servicio zosLocalAdapters se ha configurado en la instancia de servidor. | |
12 | 10 | La API no ha podido localizar el grupo de adaptadores locales optimizados que se ha seleccionado. | Asegúrese de que se haya iniciado el servidor de Liberty y el servidor de destino, verifique que el soporte de adaptadores locales optimizados esté activo y vuelva a intentarlo. |
86 | No se ha podido localizar el BGVT maestro del servidor de Liberty. | El servidor de Liberty no se ha iniciado en la imagen del sistema operativo z/OS actual. Asegúrese de que se haya iniciado el servidor antes de iniciar cualquier proceso de cliente de adaptadores locales optimizados. | |
88 | No se ha podido localizar la tabla del apéndice de cliente maestro del servidor de Liberty. | Se ha iniciado un servidor de Liberty en la imagen del sistema operativo z/OS actual pero el servidor no se está ejecutando en el nivel que admite la tabla del apéndice de cliente de los adaptadores locales optimizados. Asegúrese de que la aplicación se está ejecutando con el nivel de apéndices de adaptadores locales optimizados compatibles con el servidor de Liberty en este sistema z/OS. | |
90 | No se ha podido localizar la ranura de tabla de apéndice cliente maestro para los adaptadores locales optimizados del servidor de Liberty. | Se ha iniciado un servidor de Liberty en la imagen del sistema operativo z/OS actual pero el servidor no se está ejecutando en el nivel que admite la tabla del apéndice de cliente de los adaptadores locales optimizados. Asegúrese de que la aplicación se está ejecutando con el nivel de apéndices de adaptadores locales optimizados compatibles con el servidor de Liberty en este sistema z/OS. |
Invoke
Esta API utiliza otras funciones API primitivas subyacentes para invocar a un método en un servidor de Liberty local. Está diseñada para ser utilizada en situaciones en la que se conoce de antemano el tamaño máximo del área de salida de la respuesta.API | Sintaxis |
---|---|
BBOA1INV | BBOA1INV (registername, requesttype, requestservicename, requestservicenamel, requestdata, requestdatalen, responsedata, responsedatalen, waittime, rc, rsn, rv) |
- registername
- Una variable de entrada o constante de entrada que contiene el nombre que debe utilizarse para localizar la agrupación de conexiones con el fin de recuperar una conexión para esta invocación. El valor debe ser una serie de relleno de blancos de 12 caracteres exactamente.
- requesttype
- Un entero que contiene el tipo de solicitud que indica el tipo de solicitud de trabajo que se va a procesar. El único valor soportado es 1 para solicitudes de trabajos EJB locales.
- requestservicename
- Una serie de caracteres EBCDIC de una longitud de hasta 256 que contiene el nombre del servicio que se debe invocar. Este parámetro especifica el nombre JNDI de la interfaz empresarial local.
- requestservicenamel
- Un entero que contiene la longitud del nombre de servicio que se va a iniciar o 0 si el nombre de servicio ha terminado en un valor nulo.
- requestdata
- Un puntero de 31 bits a la dirección del inicio de los datos de solicitud que se deben enviar.
- requestdatalen
- Un valor sin signo de 32 bits que contiene la longitud de los datos de solicitud que se deben enviar.
- responsedata
- Un puntero de 31 bits del inicio del área de datos de respuesta donde efectuar la copia. El almacenamiento al que apunta este parámetro debe estar en una clave en la que el interlocutor pueda escribir.
- responsedatalen
- Un valor sin signo de 32 bits que contiene la longitud de los datos de respuesta que se deben enviar.
- waittime
- Un 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. El parámetro waittime solo se aplica al proceso de obtención de una conexión WOLA desde la agrupación de conexiones. Cuando se obtiene la conexión, se utiliza para recibir una solicitud del servidor con un tiempo de espera ilimitado.
- rc
- Un código de retorno entero que indica si esta llamada se ha efectuado correctamente o con errores.
- rsn
- Un código de razón entero que describe el motivo de una anomalía en esta llamada.
- rv
- Un valor de retorno entero de 32 bits que contiene el tamaño del almacenamiento intermedio de datos que se han recibido y copiado en el área de respuestas del interlocutor.
- Asegúrese de que se inicie el servidor de Liberty que ha especificado en esta llamada y de que se haya habilitado el soporte para los adaptadores locales.
- Asegúrese de que se haya completado una llamada a la API Register de forma correcta en el espacio de direcciones actual con un nombre coincidente antes de utilizar la API Send Request.
- 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 el código de razón | |
8 | La señal de nombre de registro no 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 que se obtenga 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. | |
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 del mensaje es más largo de lo que admite el tamaño del servidor de Liberty. Verifique que el tamaño sea válido. Si el tamaño es válido, asegúrese de que el tamaño del servidor de Liberty es lo suficientemente grande para acomodar al tamaño del mensaje. | |
19 | Una llamada a un servicio de comunicaciones local ha recibido un código de retorno distinto de cero. | ||
21 | Una llamada a un servicio de comunicaciones local ha recibido un código de retorno distinto de cero. | ||
24 | Después de una llamada de registro satisfactoria, se ha producido un error al obtener una conexión de la agrupación. | Compruebe que el servidor esté iniciado. Si no funciona, reinicie el servidor e intente de nuevo la petición de API. | |
26 | No se puede iniciar la transacción global. | ||
28 | Se ha encontrado el registro pero no 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 haya instalado e iniciado en el servidor de Liberty 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 Liberty 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 los registros del servidor de Liberty para revisar los datos de excepción. | |
46 | Se ha producido un error en la solicitud de envío de comunicaciones locales. | Consulte los registros del servidor de Liberty para determinar el error. | |
48 | Se ha producido un error en la solicitud de lectura de comunicaciones locales. | Compruebe los registros del servidor de Liberty 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. | |
98 | No se ha podido acceder al inicio del almacenamiento intermedio de solicitud proporcionado. | Asegúrese de que la dirección y la longitud del almacenamiento intermedio de solicitud proporcionado sean correctos. | |
100 | No se ha podido acceder al final del almacenamiento intermedio de solicitud proporcionado. | Asegúrese de que la dirección y la longitud del almacenamiento intermedio de solicitud proporcionado sean correctos. | |
102 | No se ha podido acceder al inicio del almacenamiento intermedio de respuesta proporcionado. | Asegúrese de que la dirección y longitud del almacenamiento intermedio de respuesta proporcionado sean correctas. | |
104 | No se ha podido acceder al final del almacenamiento intermedio de respuesta proporcionado. | Asegúrese de que la dirección y longitud del almacenamiento intermedio de respuesta proporcionado sean correctas. | |
224 |
Se ha encontrado un registro incompleto. | Esta condición es inesperada. Utilice el servicio BBOA1URG para anular registro y utilice el servicio BBOA1REG para volver a registrar. | |
226 |
Se ha encontrado un descriptor de conexión incompleto. | Esta condición es inesperada. Utilice el servicio BBOA1INV para volver a intentar la solicitud. | |
480 |
El cliente no se ha podido convertir en un cliente autorizado para llamar a la función invocar. | Esta condición es inesperada. Asegúrese de que el servidor de destino se está ejecutando y de que el servicio zosLocalAdapters se ha configurado en la instancia de servidor. | |
482 |
El cliente no se ha podido reconectar a la instancia del servidor de destino, después de que el servidor se haya reiniciado. | Esta condición es inesperada. Utilice el servicio BBOA1URG para eliminar el registro, y utilice el servicio BBOA1REG para crear uno nuevo. | |
483 |
El cliente no se ha podido reconectar a la instancia del servidor de destino, después de que el servidor se haya reiniciado. | Esta condición es inesperada. Utilice el servicio BBOA1URG para eliminar el registro, y utilice el servicio BBOA1REG para crear uno nuevo. | |
12 | 10 | La API no ha podido localizar el grupo de adaptadores locales optimizados que se ha seleccionado. | Asegúrese de que se haya iniciado el servidor de Liberty y el servidor de destino, verifique que el soporte de adaptadores locales optimizados esté activo y vuelva a intentarlo. |
14 |
El ID de usuario no está autorizado para el servidor de Liberty solicitado. | Asegúrese de que el ID de usuario está autorizado para la clase CBIND SAF para el servidor de Liberty solicitado. | |
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. | Compruebe que el servidor esté iniciado. Si no se ha iniciado, reinicie el servidor e intente de nuevo la petición de API. | |
86 | No se ha podido localizar el BGVT maestro del servidor de Liberty. | El servidor de Liberty no se ha iniciado en la imagen del sistema operativo z/OS actual. Asegúrese de que se haya iniciado el servidor antes de iniciar cualquier proceso de cliente de adaptadores locales optimizados. | |
88 | No se ha podido localizar la tabla del apéndice de cliente maestro del servidor de Liberty. | Se ha iniciado un servidor de Liberty en la imagen del sistema operativo z/OS actual pero el servidor no se está ejecutando en el nivel que admite la tabla del apéndice de cliente de los adaptadores locales optimizados. Asegúrese de que la aplicación se está ejecutando con el nivel de apéndices de adaptadores locales optimizados compatibles con el servidor de Liberty en este sistema z/OS. | |
90 | No se ha podido localizar la ranura de tabla de apéndice cliente maestro para los adaptadores locales optimizados del servidor de Liberty. | Se ha iniciado un servidor de Liberty en la imagen del sistema operativo z/OS actual pero el servidor no se está ejecutando en el nivel que admite la tabla del apéndice de cliente de los adaptadores locales optimizados. Asegúrese de que la aplicación se está ejecutando con el nivel de apéndices de adaptadores locales optimizados compatibles con el servidor de Liberty en este sistema z/OS. |
Host Service
La API Host Service utiliza otras funciones de API primitivas subyacentes para configurar un programa de z/OS de lenguaje nativo como servidor y destino para las llamadas de adaptadores locales optimizados desde un servidor de Liberty local. Utilice la API cuando conozca el tamaño máximo del área de solicitudes antes de llamar a la API.API | Sintaxis |
---|---|
BBOA1SRV | BBOA1SRV (registername, requestservicename, requestservicenamel, requestdata, requestdatalen, connectionhandle, waittime, rc, rsn, rv) |
- registername
- Una variable de entrada o constante de entrada que contiene el nombre que debe utilizarse para localizar la agrupación de conexiones con el fin de recuperar una conexión para esta llamada. El valor debe ser una serie rellena de blancos de 12 caracteres exactamente.
- requestdata
- Un puntero de 31 bits a la dirección del inicio de los datos de solicitud recibidos. El almacenamiento al que apunta este parámetro debe estar en una clave en la que el interlocutor pueda escribir.
- requestdatalen
- Un valor sin signo de 32 bits que contiene la longitud del área de datos donde se ha recibido el mensaje.
- connectionhandle
- Un manejador de conexiones de 12 bytes que se devuelve al emisor de llamada y se utiliza para enviar una respuesta para esta solicitud.
- waittime
- Un 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 la API espera indefinidamente. El parámetro waittime solo se aplica al proceso de obtención de una conexión WOLA desde la agrupación de conexiones. Cuando se obtiene la conexión, se utiliza para recibir una solicitud del servidor con un tiempo de espera ilimitado.
- requestservicename
- Una serie de caracteres EBCDIC de hasta 256 bytes que contiene el nombre del servicio. Este parámetro es el nombre del servicio de destino que ha especificado la aplicación del servidor de Liberty en la interfaz InteractionSpec. Un valor de * indica una configuración como servidor para todos los nombres de servicio que llegan bajo el nombre de registro actual.
- requestservicenamel
- Un entero que contiene la longitud del nombre de servicio que se va a iniciar o 0 si el nombre de servicio ha terminado en un valor nulo.
- rc
- Un código de retorno entero que indica si esta llamada se ha efectuado correctamente o con errores.
- rsn
- Un código de razón entero que describe el motivo de una anomalía en esta llamada.
- rv
- Un valor de retorno entero de 32 bits que contiene el tamaño del almacenamiento intermedio de datos que se han recibido y copiado en el área de respuestas del interlocutor.
- Asegúrese de que se inicie el servidor de Liberty que ha especificado en esta llamada y de que se haya habilitado el soporte para los adaptadores locales.
- Asegúrese de que se haya completado correctamente una llamada a la API Register 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.
- El manejador de conexiones devuelto debe suministrarse en cualquier respuesta para esta llamada de servicio host utilizando la API Send Response.
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 el 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 haya pasado un manejador de conexiones correcto. | |
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 excedía los límites de sistema. | El tamaño del mensaje es más largo de lo que admite el tamaño del servidor de Liberty. Verifique que el tamaño sea válido. Si el tamaño es válido, asegúrese de que el tamaño del servidor de Liberty es lo suficientemente grande para acomodar al tamaño del mensaje. | |
40 | Se ha producido un error de comunicaciones locales. | Consulte en el registro cronológico de servidor de Liberty los mensajes de error de comunicaciones locales. | |
46 | Se ha producido un error en la solicitud de envío de comunicaciones locales. | Compruebe los registros del servidor de Liberty para determinar el error. | |
48 | Se ha producido un error en la solicitud de lectura de comunicaciones locales. | Compruebe los registros del servidor de Liberty 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. | |
98 | No se puede acceder al principio de la solicitud de almacenamiento intermedio proporcionado. | Asegúrese de que la dirección y la longitud del almacenamiento intermedio de solicitud proporcionado sean correctos. | |
100 | No se puede acceder al final de la solicitud de almacenamiento intermedio proporcionado. | Asegúrese de que la dirección y la longitud del almacenamiento intermedio de solicitud proporcionado sean correctos. | |
224 |
Se ha encontrado un registro incompleto. | Esta condición es inesperada. Utilice el servicio BBOA1URG para anular registro y utilice el servicio BBOA1REG para volver a registrar. | |
226 |
Se ha encontrado un descriptor de conexión incompleto. | Esta condición es inesperada. Utilice el servicio BBOA1SRV para volver a intentar la solicitud. | |
480 |
El cliente no se ha podido convertir en un cliente autorizado para llamar a la función de host. | Esta condición es inesperada. Asegúrese de que el servidor de destino se está ejecutando y de que el servicio zosLocalAdapters se ha configurado en la instancia de servidor. | |
482 |
El cliente no se ha podido reconectar a la instancia del servidor de destino, después de que el servidor se haya reiniciado. | Esta condición es inesperada. Utilice el servicio BBOA1URG para eliminar el registro, y utilice el servicio BBOA1REG para crear uno nuevo. | |
483 |
El cliente no se ha podido reconectar a la instancia del servidor de destino, una vez que se haya reiniciado el servidor. | Esta condición es inesperada. Utilice el servicio BBOA1URG para eliminar el registro, y utilice el servicio BBOA1REG para crear uno nuevo. | |
12 | 10 | La API no ha podido localizar el grupo de adaptadores locales optimizados que se ha seleccionado. | Asegúrese de que se haya iniciado el servidor de Liberty y el servidor de destino, verifique que el soporte de adaptadores locales optimizados esté activo y vuelva a intentarlo. |
14 |
El ID de usuario no está autorizado para el servidor de Liberty solicitado. | Asegúrese de que el ID de usuario está autorizado para la clase CBIND SAF para el servidor de Liberty solicitado. | |
86 | No se ha podido localizar el BGVT maestro del servidor de Liberty. | El servidor de Liberty no se ha iniciado en la imagen del sistema operativo z/OS actual. Asegúrese de que se haya iniciado el servidor antes de iniciar cualquier proceso de cliente de adaptadores locales optimizados. | |
88 | No se ha podido localizar la tabla del apéndice de cliente maestro del servidor de Liberty. | Se ha iniciado un servidor de Liberty en la imagen del sistema operativo z/OS actual pero el servidor no se está ejecutando en el nivel que admite la tabla del apéndice de cliente de los adaptadores locales optimizados. Asegúrese de que la aplicación se está ejecutando con el nivel de apéndices de adaptadores locales optimizados compatibles con el servidor de Liberty en este sistema z/OS. | |
90 | No se ha podido localizar la ranura de tabla de apéndice cliente maestro para los adaptadores locales optimizados del servidor de Liberty. | Se ha iniciado un servidor de Liberty en la imagen del sistema operativo z/OS actual pero el servidor no se está ejecutando en el nivel que admite la tabla del apéndice de cliente de los adaptadores locales optimizados. Asegúrese de que la aplicación se está ejecutando con el nivel de apéndices de adaptadores locales optimizados compatibles con el servidor de Liberty en este sistema z/OS. |
API de adaptadores JCA (Java EE Connector Architecture)
- ConnectionSpec
- InteractionSpec
- Record I/O
ConnectionSpec
Utilice la interfaz ConnectionSpec para pasar parámetros específicos de la conexión cuando obtenga una conexión de una fábrica de conexiones. Estos parámetros pueden alterar temporalmente los parámetros del mismo nombre que están definidos en la fábrica de conexiones. Para los adaptadores locales optimizados, esta interfaz se implementa como la clase com.ibm.websphere.ola.ConnectionSpecImpl. La clase ConnectionSpecImpl le permite especificar con qué nombre de registro de adaptadores locales optimizados desea comunicarse.Cuando se comunique con un servidor de enlaces CICS, la clase ConnectionSpecImpl proporciona métodos que puede utilizar para alterar temporalmente los valores que el servidor de enlaces utiliza. Por ejemplo, puede especificar el ID de transacciones de cuatro caracteres de la transacción de invocación del servidor de enlaces, BBO#. También puede especificar si desea almacenar los datos de solicitudes en un objeto COMMAREA o CONTAINER de CICS.
Para obtener información sobre los métodos de la clase ConnectionSpecImpl, consulte la Documentación de la API generada.
InteractionSpec
Utilice la interfaz InteractionSpec para especificar parámetros específicos de la solicitud para la instancia del adaptador de recursos a la que está conectado. Para los adaptadores locales optimizados, esta interfaz se implementa como la clase com.ibm.websphere.ola.InteractionSpecImpl. Puede utilizar la clase InteractionSpecImpl para definir el nombre de servicio para la aplicación con el que se va a comunicar. El nombre de servicio lo aloja el nombre de registro que se ha especificado cuando se obtuvo la conexión.Para obtener información sobre los métodos de la clase InteractionSpecImpl, consulte la Documentación de la API generada.
Record I/O
Utilice la interfaz Record para pasar datos de solicitud y respuesta a la instancia del adaptador de recursos a la que está conectado. Los adaptadores locales optimizados proporcionan dos implementaciones de la interfaz Record, IndexedRecord y MappedRecord. Puede crear ambas implementaciones obteniendo una referencia a RecordFactory a partir de la instancia de conexiones JCA que utiliza la aplicación.Utilice un objeto IndexedRecord si está pasando datos a un programa por lotes o UNIX System Services o si se está comunicando con CICS utilizando un objeto COMMAREA o un objeto CONTAINER simple. Añada una matriz de bytes (byte[]) al objeto IndexRecord para representar los datos que envía el programa al solicitársele. La respuesta también se recibe en un objeto IndexedRecord. Puede obtener los datos de respuesta recuperando la primera entrada del objeto IndexedRecord y difundiéndola en una matriz de bytes.
Utilice un objeto MappedRecord si está pasando datos a CICS en varios objetos CONTAINER. El objeto MappedRecord contiene pares de nombre-valor, similares a lo que almacenan los objetos de correlación. En los pares nombre-valor, el nombres es el nombre del contenedor al que se transfieren los datos y el valor son los datos reales, especificados como matriz de bytes (byte[]). Cuando se utiliza un objeto MappedRecord para enviar una solicitud, la respuesta también se envía utilizando un objeto MappedRecord. La respuesta contiene el nombre de cada contenedor que contenía los datos de respuesta y los datos asociados.