RECEIVE_ALLOCATE

El RECEIVE_ALLOCATE de transacciones invocado emite el verbo RECEIVE_ALLOCATE para confirmar que el TP invocado está listo para iniciar una conversación con el TP invocando que emitió ALLOCATE o MC_ALLOCATE.

La siguiente estructura describe el bloque de control de verbo (VCB) utilizado por el verbo RECEIVE_ALLOCATE verbo.

Sintaxis

  
struct receive_allocate {  
    unsigned short   opcode;  
    unsigned char    opext;  
    unsigned char    reserv2;  
    unsigned short   primary_rc;  
    unsigned long    secondary_rc;  
    unsigned char    tp_name[64];  
    unsigned char    tp_id[8];  
    unsigned long    conv_id;  
    unsigned char    sync_level;  
    unsigned char    conv_type;  
    unsigned char    user_id[10];  
    unsigned char    lu_alias[8];  
    unsigned char    plu_alias[8];  
    unsigned char    mode_name[8];  
    unsigned char    reserv3[2];  
    unsigned long    conv_group_id;  
    unsigned char    fqplu_name[17];  
    unsigned char    pip_incoming;  
    unsigned char    syncpoint_rqd;  
    unsigned char    reserv4[3];  
};   

Miembros

opcode
Parámetro proporcionado. Especifica el código de operación de verbo, AP_RECEIVE_ALLOCATE.

opext
Parámetro proporcionado. Especifica la extensión de operación de verbo, AP_BASIC_CONVERSATION.

reserv2
Campo reservado.

primary_rc
Parámetro devuelto. Especifica el código de retorno principal que establece APPC al finalizar el verbo. Los códigos de retorno válidos varían en función del verbo APPC que se emita. Consulte la sección de códigos de retorno para obtener los códigos de error válidos para este verbo.

secondary_rc
Parámetro devuelto. Especifica el código de retorno secundario que establece APPC al finalizar el verbo. Los códigos de retorno válidos varían en función del verbo APPC que se emita. Consulte la sección de códigos de retorno para obtener los códigos de error válidos para este verbo.

tp_name
Parámetro proporcionado. Proporciona el nombre del TP local. El valor de tp_name debe coincidir con el nombre de TP configurado a través de variables de registro o de entorno. APPC coincide con el parámetro tp_name del verbo RECEIVE_ALLOCATE con el nombre TP especificado por la asignación entrante, generado por MC_ALLOCATE o ALLOCATE en el TP de invocación.

Este parámetro es una cadena de caracteres EBCDIC de 64 bytes y distingue mayúsculas de minúsculas. El tp_name parámetro puede constar de caracteres del tipo juego de caracteres AE EBCDIC:

  • Letras mayúsculas y minúsculas

  • Números del 0 al 9

  • Caracteres especiales $, #y period (.)

    Si tp_name menos de 64 bytes, use espacios EBCDIC (0x40) para hacerlo a la derecha.

    La convención de SNA es que un nombre tp de servicio puede tener hasta cuatro caracteres. El primer carácter es un byte hexadecimal entre 0x00 y 0x3F. Los demás caracteres son del tipo AE EBCDIC juego de caracteres.

    tp_id
    Parámetro devuelto. Identifica el TP local.

    conv_id
    Parámetro devuelto. Proporciona el identificador de conversación. Identifica la conversación que APPC ha establecido entre los dos puntos de conexión asociados.

    sync_level
    Parámetro devuelto. Especifica el nivel de sincronización de la conversación. Determina si los TP pueden solicitar confirmación de recepción de datos y confirmar la recepción de datos.

  • AP_NONE especifica que el procesamiento de confirmación no se usará en esta conversación.

  • AP_CONFIRM_SYNC_LEVEL especifica que los TP pueden usar el procesamiento de confirmación en esta conversación.

  • AP_SYNCPT especifica que los puntos de conexión pueden usar el procesamiento de confirmación de nivel 2 de punto de sincronización en esta conversación.

    conv_type
    Parámetro devuelto. Especifica el tipo de conversación elegido por el TP del asociado, mediante MC_ALLOCATE o ALLOCATE. Estos son los valores posibles:

    AP_BASIC_CONVERSATION

    AP_MAPPED_CONVERSATION

    user_id
    Parámetro devuelto. Proporciona el identificador de usuario especificado por el TP del asociado mediante MC_ALLOCATE o ALLOCATE (si el TP del asociado establece el parámetro de seguridad del verbo MC_ALLOCATE o ALLOCATE en AP_PGM o AP_SAME). Es una cadena de caracteres EBCDIC de tipo AE.

    lu_alias
    Parámetro devuelto. Proporciona el alias por el que la unidad lógica local (LU) es conocida por el TP local. Es una cadena de caracteres ASCII.

    plu_alias
    Parámetro devuelto. Proporciona el alias por el que el TP local conoce la LU del asociado (que inició la asignación entrante). Es una cadena de caracteres ASCII.

    mode_name
    Parámetro devuelto. Proporciona el nombre de modo especificado por MC_ALLOCATEo ALLOCATE en el TP del asociado. Es el nombre de un conjunto de características de red definidas durante la configuración. El mode_name es una cadena de caracteres EBCDIC de tipo A.

    reserv3
    Campo reservado.

    conv_group_id
    Identificador del grupo de conversación.

    fqplu_name
    Este parámetro devuelto proporciona el nombre completo de LU.

    pip_incoming
    Este parámetro proporcionado y devuelto opcional solo es aplicable si se requieren servicios de punto de sincronización.

    Para el parámetro proporcionado:

    AP_YES si TP acepta datos PIP.

    AP_NO si TP no acepta datos PIP.

    Para el parámetro devuelto:

    AP_YES si hay datos PIP disponibles.

    AP_NO si los datos pip no están disponibles.

    syncpoint_rqd
    Este parámetro indica si se requieren servicios de punto de sincronización.

    AP_YES si se requiere el punto de sincronización.

    AP_NO si no se requiere el punto de sincronización.

    reserv4
    Campo reservado.

Códigos de retorno

AP_OK
Código de retorno principal; el verbo se ha ejecutado correctamente.

AP_PARAMETER_CHECK
Código de retorno principal; el verbo no se ha ejecutado debido a un error en un parámetro.

AP_UNDEFINED_TP_NAME

Código de retorno secundario; el nombre de TP no se configuró correctamente.

AP_STATE_CHECK
Código de retorno principal; el verbo no se ejecutó porque se emitió en un estado no válido.

AP_ALLOCATE_NOT_PENDING

Código de retorno secundario; APPC no encontró una asignación entrante (del TP invocando) para que coincida con el valor de tp_name, proporcionado por RECEIVE_ALLOCATE. RECEIVE_ALLOCATE esperó la asignación entrante y finalmente se agotó el tiempo de espera.

AP_INVALID_PROCESS

Código de retorno secundario; el proceso que emite RECEIVE_ALLOCATE era diferente del iniciado por APPC.

AP_COMM_SUBSYSTEM_ABENDED
Código de retorno principal; indica una de las condiciones siguientes:

  • El nodo utilizado por esta conversación encontró una anulación.

  • La conexión entre el TP y el nodo PU 2.1 se interrumpió (un error de LAN).

  • El proceso SnaBase que se ejecuta en el equipo del TP encontró una anulación.

    El administrador del sistema debe examinar el registro de errores a fin de determinar el motivo de la anulación.

    AP_CONV_BUSY
    Código de retorno principal; solo puede haber un verbo de conversación pendiente a la vez en cualquier conversación.

    AP_THREAD_BLOCKING
    Código de retorno principal; el subproceso que llama ya está en una llamada de bloqueo.

    AP_COMM_SUBSYSTEM_NOT_LOADED
    Código de retorno principal; no se pudo cargar o finalizar un componente necesario durante el procesamiento del verbo. Por tanto, no se pudo establecer la comunicación. Consulte con el administrador del sistema para aplicar una acción correctiva.

    AP_INVALID_VERB_SEGMENT
    Código de retorno principal; el bloque de control de verbo (VCB) se ha extendido más allá del final del segmento de datos.

    AP_STACK_TOO_SMALL
    Código de retorno principal; el tamaño de la pila de la aplicación es demasiado pequeño para ejecutar el verbo. Aumente el tamaño de pila de la aplicación.

    AP_UNEXPECTED_DOS_ERROR
    Código de retorno principal; el sistema operativo devolvió un error a APPC al procesar una llamada de APPC desde el TP local. El código de retorno del sistema operativo se devuelve a través de secondary_rc. Aparece en el orden de intercambio de bytes de Intel. Si el problema persiste, consulte con el administrador del sistema.

Comentarios

Debe ser el primer verbo APPC emitido por el TP invocado. El estado inicial es RESET. Si el verbo se ejecuta correctamente (primary_rc se AP_OK), el estado cambia a RECEIVE.

En respuesta a este verbo, APPC establece una conversación entre los dos TP y genera un identificador TP para el TP invocado y un identificador de conversación. Estos identificadores son parámetros necesarios para los verbos de APPC posteriores.

Si el TP invocado emite RECEIVE_ALLOCATE y no existe un asignado entrante correspondiente (resultante de MC_ALLOCATE o ALLOCATE emitido por el TP invocando), el TP invocado espera hasta que llega la asignación entrante o se supera el tiempo de espera del verbo. El administrador del sistema establece el valor de tiempo de espera.

Host Integration Server también admite las funciones RECEIVE_ALLOCATE_EX y RECEIVE_ALLOCATE_EX_END APPC, para simplificar el diseño y la implementación de algunos programas de transacciones invocables. Esta función permite que una aplicación APPC reciba todas las solicitudes de asociación FMH-5 entrantes recibidas por Host Integration Server a través de una LU de APPC local específica, lo que permite que una aplicación actúe como un "administrador de asociación". Un administrador de adjuntar es un programa que controla una solicitud de asociación FMH-5 entrante para iniciar una conversación de LU6.2. Cuando una aplicación APPC llama a RECEIVE_ALLOCATE (en lugar de RECEIVE_ALLOCATE_EX), Host Integration Server la funcionalidad del administrador de adjuntar.

Para obtener más información sobre el administrador de adjuntar, vea RECEIVE_ALLOCATE_EX.