Rational Developer for System z, Versión 7.6.1

IRZXGETS

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).

Nota: Esta API la utilizan los conversores de PL/I XML ejecutados en IMS Connect. No debe utilizarla un programa de proceso de mensajes (MPP).
Restricciones:

Parámetros:

Tabla 1. Parámetros de IRZXGETS
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:

Tabla 2. Códigos de retorno de IRZXGETS
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


Términos de uso | Comentarios

Este Information Center está basado en tecnología Eclipse. (http://www.eclipse.org)