Compartir a través de

TP_STARTED

El verbo TP_STARTED lo emite el programa de transacciones invocando (TP) y notifica a APPC que se está iniciando el TP.

Para La versión 3 de Microsoft® Windows®. x system, se recomienda usar la función WinAsyncAPPC en lugar de la versión de bloqueo de esta llamada.

En la estructura siguiente se describe el bloque de control de verbo usado por el verbo TP_STARTED .

Sintaxis

  
struct tp_started {  
    unsigned short  opcode;  
    unsigned char   opext;  
    unsigned char   reserv2;  
    unsigned short  primary_rc;  
    unsigned long   secondary_rc;  
    unsigned char   lu_alias[8];  
    unsigned char   tp_id[8];  
    unsigned char   tp_name[64];  
    unsigned char   syncpoint_rqd;  
};

Miembros

Opcode
Parámetro proporcionado. Especifica el código de operación de verbo, AP_TP_STARTED.

opext
Parámetro proporcionado. Especifica la extensión de operación de verbo. Si se establece el bit de AP_EXTD_VCB, esto indica que la estructura tp_started incluye el miembro syncpoint_rqd usado para la compatibilidad con el punto de sincronización. De lo contrario, el bloque de control de verbo finaliza inmediatamente después del miembro tp_name .

reserv2
Un campo reservado.

primary_rc
Parámetro devuelto. Especifica el código de retorno principal establecido por APPC al finalizar el verbo. Los códigos de retorno válidos varían en función del verbo APPC emitido. Consulte Códigos de retorno para obtener códigos de error válidos para este verbo.

secondary_rc
Parámetro devuelto. Especifica el código de retorno secundario establecido por APPC al finalizar el verbo. Los códigos de retorno válidos varían en función del verbo APPC emitido. Consulte Códigos de retorno para obtener códigos de error válidos para este verbo.

lu_alias
Parámetro proporcionado. Especifica el alias por el que se conoce la LU local con el TP local.

El nombre debe coincidir con un alias de LU establecido durante la configuración. APPC comprueba el alias de LU en el archivo de configuración actual de Host Integration Server. Sin embargo, debido a la arquitectura de cliente o servidor usada por Host Integration Server, este parámetro no se valida hasta que se realiza una instrucción ALLOCATE o MC_ALLOCATE .

Este parámetro es una cadena de caracteres ASCII de 8 bytes. Puede constar de los siguientes caracteres ASCII:

  • Letras mayúsculas

  • Números de 0 a 9

  • Espacios

  • Caracteres especiales $, #, % y @

El primer carácter de esta cadena no puede ser un espacio.

Si el valor de este parámetro es de menos de ocho bytes de longitud, acolchalo a la derecha con espacios ASCII (0x20).

Para usar una LU del grupo de LU predeterminado, establezca este campo en ocho ceros hexadecimales. Para obtener más información, consulte Las LU predeterminadas.

tp_id
Parámetro devuelto. Identifica el TP recién establecido.

tp_name
Parámetro proporcionado. Especifica el nombre del TP local.

En la implementación de Host Integration Server de APPC, este parámetro se omite cuando lo emite TP_STARTED. Sin embargo, este parámetro es necesario si el programa se ejecuta en IBM ES para la implementación de OS/2 versión 1.0 de APPC.

Este parámetro es una cadena de caracteres EBCDIC de 64 bytes y distingue mayúsculas de minúsculas. El parámetro tp_name puede constar de los siguientes caracteres EDCDIC:

  • Letras mayúsculas y minúsculas

  • Números de 0 a 9

  • Caracteres especiales $, #, @y period (.)

Si el nombre de TP tiene menos de 64 bytes de longitud, use espacios EBCDIC (0x40) para rellenarlo a la derecha.

La convención de SNA para un nombre de TP de servicio tiene hasta cuatro caracteres. El primer carácter es un byte hexadecimal entre 0x00 y 0x3F.

syncpoint_rqd
Este parámetro opcional solo es aplicable si se establece el bit de AP_EXTD_VCB en el parámetro opext y se requieren servicios de punto de sincronización.

  • AP_YES si se requiere punto de sincronización.
  • AP_NO si el punto de sincronización no es necesario.

Códigos de retorno

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

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

  • El nodo usado por esta conversación encontró un ABEND.

  • La conexión entre el TP y el nodo PU 2.1 se ha interrumpido (error laN).

  • SnaBase en el equipo del TP encontró un ABEND.

El administrador del sistema debe examinar el registro de errores para determinar el motivo del ABEND.

AP_COMM_SUBSYSTEM_NOT_LOADED
Código de retorno principal; No se pudo cargar ni finalizar un componente necesario mientras se procesaba el verbo. Por lo tanto, no se pudo realizar la comunicación. Póngase en contacto con el administrador del sistema para obtener una acción correctiva.

AP_INVALID_VERB_SEGMENT
Código de retorno principal; el VCB se extendió más allá del final del segmento de datos.

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

AP_TP_BUSY
Código de retorno principal; el TP local ha emitido una llamada a APPC mientras APPC estaba procesando otra llamada para el mismo TP.

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

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

Observaciones

En respuesta a TP_STARTED, APPC genera un identificador de TP para la invocación de TP. Este identificador es un parámetro necesario para los verbos APPC posteriores emitidos por la invocación de TP.

Debe ser el primer verbo APPC emitido por la invocación de TP. Por lo tanto, no existe ningún estado APPC anterior.

Si el verbo se ejecuta correctamente (primary_rc es AP_OK), el estado cambia a RESET.

En esta sección

  • Last updated on