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).
Puede utilizar los servicios invocables desde los siguientes lenguajes de programación nativos:
- 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 debe estar ejecutándose en la misma imagen de
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.
Liberty da soporte a las API de adaptadores locales
optimizados siguientes:
Register
Utilizando la API BBOA1REG, puede realizar un registro 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.
Tabla 1. BBOA1REG | API |
Sintaxis |
| BBOA1REG |
BBOA1REG (wolagroupnamepart1, wolagroupnamepart2,
wolagroupnamepart3, registername, minconn, maxconn, registerflags,
rc, rsn) |
La API BBOA1REG acepta los siguientes parámetros de entrada:
- 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
- Una variable de entrada o una constante de entrada que contiene el nombre que se utiliza para registrar un conjunto de conexiones locales. Las últimas llamadas requieren este nombre para
identificar la agrupación de conexiones que debe utilizarse. Debe ser una serie rellena de blancos de exactamente 12 caracteres y no se puede utilizar en el espacio de direcciones actual.
- 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 se activa (on), se utiliza la identidad de la tarea de aplicaciones CICS en el proceso de autorización del servidor de Liberty. Cuando este bit está desactivado (off), 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.
La API BBOA1REG acepta los siguientes parámetros de salida:
- 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.
Códigos de retorno y de razón:
Tabla 2. BBOA1REG | Código de retorno |
Código de razón |
Descripción |
Acción |
| 0 |
- |
Correcta |
|
| 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. |
| |
25 |
El gestor de transacciones no se puede inicializar. |
Consulte la información de determinación de problemas en el Sitio de soporte de WebSphere Application Server. |
| |
70 |
Se ha agotado la memoria compartida al intentar crear una conexión. |
Aumente la asignación de memoria compartida para el
adaptador local optimizado. |
| |
74 |
El nombre de registro de entrada contiene un 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. |
| 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. |
Anulación de registro
Anulación del registro desde el grupo de adaptadores locales optimizados y del servidor de
Liberty utilizando la API BBOA1URG
.
Tabla 3. BBOA1URG . Esta API solicita que se libere un grupo de conexiones optimizadas a un grupo de adaptadores locales optimizados local y a un servidor de
Liberty utilizando el nombre de registro especificado.| API |
Sintaxis |
| BBOA1URG |
BBOA1URG (registername, unregflags,
rc, rsn) |
La API BBOA1URG acepta los siguientes parámetros de entrada:
- 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.
La API BBOA1URG APIacepta los parámetros de salida siguientes:
- 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.
Notas sobre el uso:
- 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ódigos de retorno y de razón:
Tabla 4. BBOA1URG | 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. |
| |
76 |
Ha fallado un intento de comunicación con el servidor
porque el servidor ya no está en ejecución. |
Inicie el servidor y vuelva a intentar la comunicación. |
| |
82 |
Ya se ha realizado un intento 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. |
| 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.
Tabla 5. BBOA1CNG | API |
Sintaxis |
| BBOA1CNG |
BBOA1CNG (registername, connectionhandle,
waittime, rc, rsn) |
La API BBOA1CNG acepta los siguientes parámetros de entrada:
- 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.
La API BBOA1CNG acepta los siguientes parámetros de salida:
- 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.
Notas sobre el uso:
- 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ódigos de retorno y de razón:
Tabla 6. BBOA1CNG | 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. |
|
| 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. |
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.
Tabla 7. BBOA1CNR | API |
Sintaxis |
| BBOA1CNR |
BBOA1CNR (connectionhandle, rc, rsn) |
La API BBOA1CNR acepta el siguiente parámetro de entrada:
- 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.
La API BBOA1CNR acepta los siguientes parámetros de salida:
- 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.
Notas sobre la utilización
- 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.
Tabla 8. BBOA1CNR | 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 |
14 |
No se puede localizar o verificar el vector de llamada de
API que utiliza el manejador de conexiones proporcionado. |
El manejador de conexiones no es válido o puede que una llamada a la API
Unregister haya invalidado la agrupación de conexiones. |
| |
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.
Tabla 9. BBOA1SRQ | API |
Sintaxis |
| BBOA1SRQ |
BBOA1SRQ (connectionhandle, requesttype,
requestservicename, requestservicenamel, requestdata, requestdatalen,
async(0|1), responsedatalen, rc, rsn) |
La API BBOA1SRQ acepta los siguientes parámetros de entrada:
- 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.
La API BBOA1SRQ acepta los siguientes parámetros de salida:
- 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.
Notas sobre el uso:
- 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ódigos de retorno y de razón:
Tabla 10. BBOA1SRQ | 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. |
| |
14 |
Se ha producido una condición de escasez de memoria mientras
se guardaba el mensaje. |
No hay suficiente memoria disponible para que
el envío de solicitud procese el mensaje. El espacio de direcciones actual
se ha quedado sin almacenamiento privado. |
| |
16 |
La longitud de nombre de servicio de solicitud no es válida. |
Corrija el programa y vuelva a intentarlo. |
| |
18 |
La longitud de solicitud excede los límites de sistema. |
El tamaño 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. |
| |
26 |
No se puede iniciar la transacción global. |
|
| |
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. |
Compruebe en el registro del servidor de Liberty los mensajes de error de comunicación local. |
| |
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. |
| |
14 |
El vector de llamada de la API que utiliza el
manejador de conexiones proporcionado no puede localizarse ni verificarse. |
El manejador de conexiones no es válido o puede que una llamada de anulación de registro
(BBOA1URG API) haya invalidado la agrupación de conexiones. |
| |
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.
Tabla 11. BBOA1SRP | API |
Sintaxis |
| BBOA1SRP |
BBOA1SRP (connectionhandle, responsedata,
responsedatalen, rc, rsn) |
La API BBOA1SRP acepta los siguientes parámetros de entrada:
- 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.
La API BBOA1SRP acepta los siguientes parámetros de salida:
- 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.
Notas sobre el uso:
- 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ódigos de retorno y de razón:
Tabla 12. BBOA1SRP | 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. |
| |
14 |
Se ha producido una condición de escasez de memoria mientras
se guardaba el mensaje. |
No hay suficiente memoria disponible para que la API Send Response procese el mensaje. El espacio de direcciones actual
se ha quedado sin almacenamiento privado. |
| |
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. |
Compruebe en el registro del servidor de Liberty los mensajes de error de comunicación local. |
| |
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. |
| 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 |
No se puede localizar o verificar el vector de llamada de
API que utiliza el manejador de conexiones proporcionado. |
El manejador de conexiones no es válido o una llamada
de anulación de registro (API BBOA1URG) puede haber invalidado la
agrupación de conexiones. |
| |
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.
Tabla 13. BBOA1SRX | API |
Sintaxis |
| BBOA1SRX |
BBOA1SRX (connectionhandle, excresponsedata,
exresponsedatalen, rc, rsn)
|
La API BBOA1SRX acepta los siguientes parámetros de entrada:
- 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.
La API BBOA1SRX acepta los siguientes parámetros de salida:
- 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.
Notas sobre el uso:
- 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ódigos de retorno y de razón:
Tabla 14. BBOA1SRX | 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. |
| |
14 |
Se ha producido una condición de escasez de memoria mientras
se guardaba el mensaje. |
No hay suficiente memoria disponible para que la API Send Response Exception procese el mensaje. El espacio de direcciones actual
se ha quedado sin almacenamiento privado. |
| |
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. |
| |
20 |
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. |
| |
28 |
El registro con el que estaba asociado el manejador de conexiones conexión ya no está activo. |
Vuelva a invocar a la API Register con el nombre de registro y, a continuación, invoque a las API
Connection Get y Send Request. |
| |
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. |
Compruebe en el registro del servidor de Liberty los mensajes de error de comunicación local. |
| |
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. |
| 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 |
No se puede localizar o verificar el vector de llamada de
API que utiliza el manejador de conexiones proporcionado. |
El manejador de conexiones no es válido o una llamada
de anulación de registro (API BBOA1URG) puede haber invalidado la
agrupación de conexiones. |
| |
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.
Tabla 15. BBOA1RCA | API |
Sintaxis |
| BBOA1RCA |
BBOA1RCA (registername, connectionhandle,
requestservicename, requestservicenamel, requestdatalen, waittime,
rc, rsn) |
La API BBOA1RCA acepta los siguientes parámetros de entrada:
- 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.
La API BBOA1RCA acepta los siguientes parámetros de entrada o de salida:
- 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.
La API BBOA1RCA acepta los siguientes parámetros de salida:
- 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.
Notas sobre el uso:
- 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ódigos de retorno y de razón:
Tabla 16. BBOA1RCA | 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. |
| |
11 |
Se han enviado datos erróneos desde el servidor de Liberty. |
|
| |
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. |
Compruebe en el registro del servidor de Liberty los mensajes de error de comunicación local. |
| |
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. |
| 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. |
| |
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. |
| |
44 |
Ha fallado una llamada al servicio CSRC4BLD
de z/OS. |
|
| |
46 |
Ha fallado una llamada al servicio CSRC4GT1
de z/OS. |
|
| |
48 |
Ha fallado una llamada al servicio CSRC4FR1
de z/OS. |
|
| |
60 |
El servicio de la API no ha podido obtener el bloqueo de la cola de servicio. |
|
| |
62 |
El servicio de la API no ha podido liberar el bloqueo de la cola de servicio. |
|
| |
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.
Tabla 17. BBOA1RCS sintaxis de API| API |
Sintaxis |
| BBOA1RCS |
BBOA1RCS (connectionhandle, requestservicename,
requestservicenamel, requestdatalen, async(0|1), rc, rsn) |
La API BBOA1RCS acepta los siguientes parámetros de entrada:
- 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.
La API BBOA1RCS acepta los siguientes parámetros de entrada o de salida:
- 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.
La API BBOA1RCS acepta los siguientes parámetros de salida:
- 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.
Notas sobre el uso:
- 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ódigos de retorno y de razón:
Tabla 18. BBOA1RCS | 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. |
| |
11 |
Se han enviado datos erróneos desde el servidor de Liberty. |
|
| |
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. |
|
| |
28 |
El registro con el que estaba asociado el manejador de conexiones conexión ya no está activo. |
Vuelva a llamar al nombre de registro antes de llamar a la API específica Connection Get y Receive Request. |
| |
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. |
Compruebe en el registro del servidor de Liberty los mensajes de error de comunicación local. |
| |
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. |
| 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 |
No se puede localizar o verificar el vector de llamada de
API que utiliza el manejador de conexiones proporcionado. |
El manejador de conexiones no es válido o una llamada
de anulación de registro (API BBOA1URG) puede haber invalidado la
agrupación de conexiones. |
| |
44 |
Ha fallado una llamada al servicio CSRC4BLD
de z/OS. |
|
| |
46 |
Ha fallado una llamada al servicio CSRC4GT1
de z/OS. |
|
| |
48 |
Ha fallado una llamada al servicio CSRC4FR1
de z/OS. |
|
| |
60 |
El servicio de la API no ha podido obtener el bloqueo de la cola de servicio. |
|
| |
62 |
El servicio de la API no ha podido liberar el bloqueo de la cola de servicio. |
|
| |
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.
Tabla 19. BBOA1RCL | API |
Sintaxis |
| BBOA1RCL |
BBOA1RCL (connectionhandle, async(0|1),
responsedatalen, rc, rsn) |
La API BBOA1RCL acepta los siguientes parámetros de entrada:
- 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.
La API BBOA1RCL acepta los siguientes parámetros de salida:
- 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.
Notas sobre el uso:
- 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ódigos de retorno y de razón:
Tabla 20. BBOA1RCL | 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. |
| |
11 |
Se han enviado datos erróneos desde el servidor de Liberty. |
|
| |
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. |
Compruebe en el registro del servidor de Liberty los mensajes de error de comunicación local. |
| 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 |
No se puede localizar o verificar el vector de llamada de
API que utiliza el manejador de conexiones proporcionado. |
El manejador de conexiones no es válido o puede que una llamada a la API
Unregister haya invalidado la agrupación de conexiones. |
| |
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.
Tabla 21. BBOA1GET | API |
Sintaxis |
| BBOA1GET |
BBOA1GET (connectionhandle, msgdata,
msgdatalen, rc, rsn, rv) |
La API BBOA1GET acepta los siguientes parámetros de entrada:
- 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.
La API BBOA1GET acepta los siguientes parámetros de salida:
- 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.
Notas sobre el uso:
- 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ódigos de retorno y de razón:
Tabla 22. BBOA1GET | 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. |
Compruebe en el registro del servidor de Liberty los mensajes de error de comunicación local. |
| |
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. |
| |
50 |
Se ha terminado la conexión con el servidor de Liberty. |
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. |
| 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 |
No se puede localizar o verificar el vector de llamada de
API que utiliza el manejador de conexiones proporcionado. |
El manejador de conexiones no es válido o puede que una llamada a la API
Unregister haya invalidado la agrupación de conexiones. |
| |
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.
Tabla 23. BBOA1INV | API |
Sintaxis |
| BBOA1INV |
BBOA1INV (registername, requesttype,
requestservicename, requestservicenamel, requestdata, requestdatalen,
responsedata, responsedatalen, waittime, rc, rsn, rv) |
La API BBOA1INV acepta los siguientes parámetros de entrada:
- 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.
La API BBOA1INV acepta los siguientes parámetros de salida:
- 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.
Notas sobre el uso:
- 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ódigos de retorno y de razón:
Tabla 24. BBOA1INV | 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. |
| |
11 |
Se han enviado datos erróneos desde el servidor de Liberty. |
|
| |
14 |
Se ha producido una condición de escasez de memoria mientras
se guardaba el mensaje. |
No hay suficiente memoria disponible para que
la invocación procese el mensaje. El espacio de direcciones actual
se ha quedado sin almacenamiento privado. |
| |
16 |
La longitud de nombre de servicio de solicitud no es válida. |
Corrija el programa y vuelva a intentar la llamada. |
| |
18 |
La longitud de respuesta excedía los límites de sistema. |
El tamaño 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. |
Compruebe en el registro del servidor de Liberty los mensajes de error de comunicación local. |
| |
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. |
| |
50 |
Se ha terminado la conexión con el servidor de Liberty. |
Compruebe el 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. |
| 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 |
No se puede localizar o verificar el vector de llamada de
API que utiliza el manejador de conexiones proporcionado. |
El manejador de conexiones no es válido o puede que una llamada a la API
Unregister haya invalidado la agrupación de conexiones. |
| |
24 |
Después de una llamada de registro satisfactoria, se ha
producido un error al obtener una conexión de la agrupación de conexiones. |
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.
Tabla 25. BBOA1SRV | API |
Sintaxis |
| BBOA1SRV |
BBOA1SRV (registername, requestservicename,
requestservicenamel, requestdata, requestdatalen, connectionhandle,
waittime, rc, rsn, rv) |
La API BBOA1SRV acepta los siguientes parámetros de entrada:
- 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.
La API BBOA1SRV acepta los siguientes parámetros de entrada o de salida:
- 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.
La API BBOA1SRV acepta los siguientes parámetros de salida:
- 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.
Notas sobre el uso:
- 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ódigos de retorno y de razón:
Tabla 26. BBOA1SRV | 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. |
Compruebe en el registro del servidor de Liberty los mensajes de error de comunicación local. |
| |
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. |
| |
50 |
Se ha terminado la conexión con el servidor de Liberty. |
Compruebe el 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. |
| |
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. |
| |
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. |
| |
14 |
No se puede localizar o verificar el vector de llamada de
API que utiliza el manejador de conexiones proporcionado. |
El manejador de conexiones no es válido o puede que una llamada a la API
Unregister haya invalidado la agrupación de conexiones. |
| |
44 |
Ha fallado una llamada al servicio CSRC4BLD
de z/OS. |
|
| |
46 |
Ha fallado una llamada al servicio CSRC4GT1
de z/OS. |
|
| |
48 |
Ha fallado una llamada al servicio CSRC4FR1
de z/OS. |
|
| |
60 |
El servicio de la API no ha podido obtener el bloqueo de la cola de servicio. |
|
| |
62 |
El servicio de la API no ha podido liberar el bloqueo de la cola de servicio. |
|
| |
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)
Para las llamadas desde el servidor de Liberty en un programa por lotes o subsistema, la aplicación de servidor de Liberty utiliza las API JCA estándar. Las interfaces siguientes se personalizan para utilizarlas con los adaptadores locales optimizados:
- 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.