Rational Developer for System z, Versión 7.6.1

IRZXSETS

La API IRZXSETS crea una estructura SOAP a partir de la información de una estructura de lenguaje pasada como entrada. Además, si se especifica, IRZXSETS copia la estructura SOAP actual y todas las estructuras SOAP suministradas anteriormente en el almacenamiento intermedio de salida de IMS Connect.

Dado que la cola de mensajes de IMS no está disponible para la conversión de XML en IMS Connect, IRZXSETS inserta estructuras de lenguaje en el almacenamiento intermedio de salida de IMS Connect. El formato del almacenamiento intermedio de salida 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 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).
Limitaciones:

Parámetros:

Tabla 1. Parámetros de IRZXSETS
Parámetro: Tipo: Uso: Descripción:
@irz_async_msg_header_ptr POINTER BYVALUE Entrada Puntero por valor a la instancia de @irz_async_msg_header que debe enviarse como primer segmento del mensaje IMS.
@irz_icon_buf_ptr POINTER BYVALUE Entrada Puntero por valor al almacenamiento intermedio de mensajes de salida de IMS Connect. El formato esperado del almacenamiento intermedio es una matriz de segmentos de mensaje IMS (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_icon_buf_used SIGNED FIXED BIN(31) BYADDR Salida Entero por referencia en el que IRZXSETS escribe el número de bytes necesarios para formatear la estructura de lenguaje como mensaje IMS multisegmento en el almacenamiento intermedio de salida de IMS Connect. El valor de este parámetro siempre es superior en 4 bytes como mínimo al tamaño real de la estructura de lenguaje.
@irz_struct_type SIGNED FIXED BIN(31) BYVALUE Entrada Entero por valor que especifica el tipo de estructura de lenguaje que debe establecerse en el almacenamiento intermedio de salida de IMS Connect. Pueden utilizarse las constantes siguientes definidas en el archivo de inclusión IRZPWSH: @irz_soap_body_struct.
@irz_struct_name WCHAR(128) VARYING BYADDR Entrada Serie por referencia que contiene el nombre de la estructura de lenguaje correspondiente al valor del parámetro @irz_struct_type.
@irz_struct_ptr POINTER BYVALUE Entrada Puntero por valor a una estructura correspondiente a la estructura especificada en los parámetros @irz_struct_type e @irz_struct_name.
@irz_struct_size SIGNED FIXED BIN(31) BYVALUE Entrada Entero por valor que especifica el tamaño en bytes de la estructura a la que apunta el parámetro @irz_struct_ptr.
@irz_commit_structs BIT(1) BYVALUE Entrada Bit por valor que indica si IRZXSETS debe copiar la estructura de lenguaje actual y todas las estructuras de lenguaje suministradas anteriormente en el almacenamiento intermedio de salida de IMS Connect.
@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 IRZXSETS invoca a Language Environment Callable Services.
Nota: Si el código de retorno de IRZXSETS 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 IRZXSETS 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 IRZXSETS son constantes definidas en el archivo de inclusión IRZPWSH:

Tabla 2. Códigos de retorno de IRZXSETS
Tipo: Nombre: Valor:
SIGNED FIXED BIN (31) @irz_success 000
@irz_omitted_parameter 100
@irz_invalid_pointer 101
@irz_invalid_struct_type 102
@irz_invalid_struct_order 105
@irz_invalid_struct_size 106
@irz_invalid_struct_name 107
@irz_struct_already_set 108
@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)