TP_STARTED
El programa de transacción que realiza la llamada emite el verbo TP_STARTED y este notifica a APPC que el TP se está iniciando.
Con la versión 3.x del sistema Microsoft® Windows®, se recomienda utilizar 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 que se usa en 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 del verbo, AP_TP_STARTED.
opext
Parámetro proporcionado. Especifica la extensión de la operación del verbo. Si se establece AP_EXTD_VCB, indica que la estructura tp_started incluye el miembro syncpoint_rqd que se usa para admitir el punto de sincronización. De lo contrario, el bloque de control de verbo finaliza inmediatamente después del miembro tp_name.
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.
lu_alias
Parámetro proporcionado. Especifica el alias con el cual el TP local conoce la LU local.
El nombre debe coincidir con un alias de LU establecido durante la configuración. APPC comprueba el alias de LU con el archivo de configuración de Host Integration Server actual. Sin embargo, debido a la arquitectura cliente/servidor que Host Integration Server utiliza, este parámetro no se valida hasta que se realiza una operación ALLOCATE o MC_ALLOCATE.
Este parámetro es una cadena de caracteres ASCII de 8 bytes. Puede constar de los caracteres ASCII siguientes:
Letras mayúsculas
Números del 0 al 9
Espacios
Caracteres especiales $, #, % y @
El primer carácter de esta cadena no puede ser un espacio.
Si el valor de este parámetro tiene menos de ocho bytes de longitud, agregue espacios ASCII (0x20) a la derecha como relleno.
Si desea usar una LU del grupo de LU predeterminado, establezca este campo en ocho ceros hexadecimales. Para más información, consulte el artículo sobre 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, se omite este parámetro cuando lo emite TP_STARTED. Sin embargo, este parámetro es necesario si el programa se ejecuta en la implementación de la versión 1.0 de IBM ES para OS/2 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 caracteres EDCDIC siguientes:
Letras mayúsculas y minúsculas
Números del 0 al 9
Caracteres especiales $, #, @, y punto (.)
Si el nombre del TP tiene menos de 64 bytes de longitud, use espacios EBCDIC (0x40) como relleno a la derecha.
La convención de SNA para el nombre de un TP de servicio es de 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 el bit AP_EXTD_VCB está establecido en el parámetro opext y se requieren los 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.
Códigos de retorno
AP_OK
Código de retorno principal; el verbo se ha ejecutado correctamente.
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_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_TP_BUSY
Código de retorno principal; el TP local ha emitido una llamada a APPC mientras APPC procesaba otra llamada para el mismo TP.
AP_THREAD_BLOCKING
Código de retorno principal; el subproceso que llama ya está en una llamada de bloqueo.
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
En respuesta a TP_STARTED, APPC genera un identificador de TP para el TP que realiza la llamada. Este identificador es un parámetro requerido para los verbos APP subsiguientes que emite el TP que realiza la llamada.
Este debe ser el primer verbo APPC emitido por el TP que realiza la llamada. Por lo tanto, no existe ningún estado de APPC anterior.
Si el verbo se ejecuta correctamente (es decir, si primary_rc es AP_OK), el estado cambia a RESET.