La API IRZXGETS recupera una estructura SOAP del almacenamiento intermedio de entrada de IMS Connect y devuelve la información al interlocutor en una estructura de lenguaje de alto nivel.
Dado que la cola de mensajes de IMS no está disponible para la conversión de XML en IMS Connect, IRZXGETS recupera las estructuras de lenguaje del almacenamiento intermedio de entrada de IMS Connect. El formato esperado del almacenamiento intermedio de entrada de IMS Connect es una matriz de segmentos de mensaje IMS (LLZZDATA).
Las estructuras y variables a las que se hace referencia en este tema se definen en el archivo de inclusión IRZPWSH (consulte la sección Archivo de inclusión IRZPWSH).
Parámetros:
| Parámetro: | Tipo: | Uso: | Descripción: |
|---|---|---|---|
| @irz_async_msg_header_ptr | POINTER BYADDR | Salida | Puntero por referencia a la instancia de @irz_async_msg_header recibida en el almacenamiento intermedio de entrada de IMS Connect. |
| @irz_icon_buf_ptr | POINTER BYVALUE | Entrada | Puntero por valor al almacenamiento intermedio de mensajes de entrada de IMS Connect. El formato esperado del almacenamiento intermedio es una matriz de LLZZDATA. |
| @irz_icon_buf_len | SIGNED FIXED BIN(31) BYVALUE | Entrada | Entero por valor que especifica la longitud en bytes del almacenamiento intermedio al que señala @irz_icon_buf_ptr. |
| @irz_struct_type | SIGNED FIXED BIN(31) BYVALUE | Entrada | Entero por valor que especifica el tipo de estructura que debe recuperarse del almacenamiento intermedio de entrada de IMS Connect. Pueden utilizarse las constantes siguientes definidas en el archivo de inclusión IRZPWSH: @irz_soap_body_struct. |
| @irz_struct_name | WCHAR(100) VARYING BYADDR | Entrada | Serie por referencia que contiene el nombre de la estructura de lenguaje que debe recuperarse del almacenamiento intermedio de entrada de IMS Connect. El valor de este parámetro debe corresponder al valor del parámetro @irz_struct_type. |
| @irz_struct_ptr | POINTER BYADDR | Salida | Puntero por referencia en el que IRZXGETS escribe la dirección de
un almacenamiento intermedio que contiene los bytes de la estructura solicitada en los
parámetros @irz_struct_type e @irz_struct_name. Importante: El conversor de
XML debe liberar este almacenamiento intermedio antes de efectuar el retorno a
IMS Connect, ya que el enclave de
Language Environment en el
que se ejecutan los conversores de XML es persistente.
|
| @irz_struct_size | SIGNED FIXED BIN(31) BYADDR | Salida | Entero por referencia en el que IRZXGETS escribe el tamaño en bytes de la estructura devuelta en el parámetro @irz_struct_ptr. |
| @irz_cee_feedback_ptr | POINTER BYVALUE | Entrada | Puntero por valor a una instancia de @irz_cee_feedback que define
una señal de condición de Language
Environment. Esta instancia se actualiza cada vez que IRZXGETS invoca a
Language Environment Callable
Services. Nota: Si el código de retorno de IRZXGETS es 998,
utilice la publicación Language
Environment Run-Time Messages (SA22-7566-10) para examinar el contenido de la
señal de condición y determinar la causa del error.
|
| @irz_debug | BIT(1) OPTIONAL | Entrada | Bit opcional que indica si IRZXGETS debe visualizar información de rastreo (consulte la sección Salida de rastreo de WSDL2PLI). |
Códigos de retorno:
Los códigos de retorno de IRZXGETS son constantes definidas en el archivo de inclusión IRZPWSH:
| Tipo: | Nombre: | Valor: |
|---|---|---|
| SIGNED FIXED BIN (31) | @irz_success | 000 |
| @irz_omitted_parameter | 100 | |
| @irz_invalid_pointer | 101 | |
| @irz_invalid_struct_type | 102 | |
| @irz_struct_not_found | 103 | |
| @irz_struct_name_mismatch | 104 | |
| @irz_invalid_struct_order | 105 | |
| @irz_icon_buf_exhausted | 997 | |
| @irz_cee_call_failure | 998 |