GET_STATE
El verbo GET_STATE devuelve el estado de una conversación determinada.
En la estructura siguiente se describe el bloque de control de verbos (VCB) usado por el verbo GET_STATE .
Sintaxis
struct get_state {
unsigned short opcode;
unsigned char opext;
unsigned char reserv2;
unsigned short primary_rc;
unsigned long secondary_rc;
unsigned char tp_id[8];
unsigned long conv_id;
unsigned char conv_state;
};
Miembros
opcode
Parámetro proporcionado. Especifica el código de operación de verbo, AP_GET_STATE.
opext
El verbo GET_STATE no usa este campo.
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_id
Parámetro proporcionado. Identifica el programa de transacciones local (TP). El valor de este parámetro lo devolvió TP_STARTED en el TP invocado o por RECEIVE_ALLOCATE en el TP invocado.
conv_id
Parámetro proporcionado. Proporciona el identificador de la conversación sobre la que se pregunta este TP. El valor de este parámetro fue devuelto por MC_ALLOCATE o ALLOCATE en el TP invocado o por RECEIVE_ALLOCATE en el TP invocado.
conv_state
Parámetro devuelto. Indica el estado de la conversación. El parámetro conv_state puede ser uno de los siguientes valores:
AP_RESET_STATE
La conversación está en estado RESET.
AP_SEND_STATE
La conversación está en estado SEND.
AP_RECEIVE_STATE
La conversación está en estado RECEIVE.
AP_CONFIRM_STATE
La conversación está en estado CONFIRM.
AP_CONFIRM_SEND_STATE
La conversación está en estado CONFIRM_SEND.
AP_CONFIRM_DEALL_STATE
La conversación está en estado CONFIRM_DEALLOCATE.
AP_PEND_POST_STATE
La conversación tiene un verbo POST pendiente.
AP_PEND_DEALL_STATE
La conversación tiene un verbo DEALLOCATE pendiente.
AP_END_CONV_STATE
La conversación está en estado END_CONVERSATION.
AP_SEND_PENDING_STATE
La conversación está en estado SEND_PENDING.
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_BAD_CONV_ID
Código de retorno secundario; el valor de conv_id no coincidía con un identificador de conversación asignado por APPC.
AP_BAD_TP_ID
Código de retorno secundario; el valor de tp_id no coincidía con un identificador de TP asignado 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_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_CONV_BUSY
Código de retorno principal; solo puede haber un verbo de conversación pendiente a la vez en cualquier conversación. Esto puede ocurrir si el TP local tiene varios subprocesos y más de un subproceso emite llamadas APPC con el mismo conv_id.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
La conversación puede estar en cualquier estado cuando el TP emite este verbo.
No hay ningún cambio de estado.