Resumen del verbo de APPC

En esta sección se describe brevemente cada verbo APPC, agrupado por función.

Verbos para iniciar conversaciones

ASIGNARo MC_ALLOCATE
Emitido por el programa de transacciones local (TP). Este verbo asigna una sesión entre la unidad lógica local (LU) y una LU del asociado, y establece una conversación entre el TP local y el TP del asociado.

ALLOCATE puede establecer una conversación básica o asignada. MC_ALLOCATE solo puede iniciar una conversación asignada. Una vez asignada la conversación, APPC usa este verbo para devolver un identificador de conversación (conv_id).

RECEIVE_ALLOCATE
Emitido por el TP del asociado. Este verbo confirma que el TP del asociado está listo para iniciar una conversación con el TP local que emitió ALLOCATE o MC_ALLOCATE. Tras la ejecución correcta, este verbo devuelve un identificador tp (tp_id) para el TP del asociado y el conv_id.

TP_STARTED
Emitido por el TP local. Este verbo notifica a APPC que se está iniciando el TP local. Tras la ejecución correcta, este verbo devuelve un tp_id para el TP local.

Verbos para enviar datos

CONFIRMARo MC_CONFIRM
Envía el contenido del búfer de envío de lu local y una solicitud de confirmación al TP del asociado.

FLUSHo MC_FLUSH
Vacía el búfer de envío de la LU local, enviando el contenido del búfer a la LU del asociado y el TP. Si el búfer de envío está vacío, no se realiza ninguna acción.

PREPARE_TO_RECEIVEo MC_PREPARE_TO_RECEIVE
Cambia el estado de la conversación de SEND a RECEIVE. Antes de cambiar el estado de la conversación, este verbo realiza el equivalente de FLUSH, MC_FLUSH, CONFIRM o MC_CONFIRM. Después de que este verbo se haya ejecutado correctamente, el TP local puede recibir datos.

REQUEST_TO_SENDo MC_REQUEST_TO_SEND
Informa al TP del asociado que el TP local quiere enviar datos. El TP local debe esperar hasta que los problemas de TP del asociado PREPARE_TO_RECEIVE, MC_PREPARE_TO_RECEIVE, RECEIVE_AND_WAIT o MC_RECEIVE_AND_WAIT, y el estado de conversación cambia a RECEIVE para el TP del asociado, antes de que el TP local comience a enviar datos.

SEND_DATAo MC_SEND_DATA
Coloca los datos en el búfer de envío de lu local para su transmisión al TP del asociado.

Los datos recopilados en el búfer de envío de la LU local se transmiten al LU asociado y al TP del asociado cuando se produce una de las siguientes acciones:

• El búfer de envío se rellena.

• Los problemas de TP locales FLUSH, MC_FLUSH, CONFIRM, MC_CONFIRM, DEALLOCATE, MC_DEALLOCATE u otro verbo que vacía el búfer de envío de la LU local.

Verbos para recibir datos

POST_ON_RECEIPT o MC_POST_ON_RECEIPT
La emisión de este verbo permite a la aplicación registrarse para recibir una notificación cuando los datos o el estado llegan a la LU local sin recibirlo realmente al mismo tiempo. Este verbo solo se puede emitir mientras está en estado RECEIVE y nunca provoca un cambio en el estado de la conversación.

Cuando el TP emite este verbo, APPC devuelve el control al TP inmediatamente. Cuando se cumplen las condiciones especificadas, se señala el evento Win32® especificado como parámetro y se completa el verbo. A continuación, el TP examina el código de retorno en el bloque de control de verbos para determinar si algún dato o notificación de estado ha llegado a la LU local y emite un RECEIVE_IMMEDIATE o RECEIVE_AND_WAIT verbo para recibir realmente los datos o la notificación de estado.

RECEIVE_AND_POSTo MC_RECEIVE_AND_POST
Emitir este verbo mientras la conversación está en estado RECEIVE cambia el estado de la conversación a PENDING_POST y hace que el TP local reciba datos de forma asincrónica. Esto permite que el TP local continúe con el procesamiento mientras los datos siguen llegando a la LU local.

Emitir este verbo mientras la conversación está en estado SEND vacía el búfer de envío de la LU y cambia el estado de la conversación a PENDING_POST. A continuación, el TP local comienza a recibir datos de forma asincrónica.

RECEIVE_AND_WAITo MC_RECEIVE_AND_WAIT
La emisión de este verbo mientras la conversación está en estado RECEIVE hace que el TP local reciba los datos disponibles actualmente del TP del asociado. Si no hay datos disponibles, el TP local espera a que lleguen los datos.

Emitir este verbo mientras la conversación está en estado SEND vacía el búfer de envío de la LU y cambia el estado de conversación a RECEIVE. A continuación, el TP local comienza a recibir datos.

RECEIVE_IMMEDIATEo MC_RECEIVE_IMMEDIATE
Recibe los datos que están disponibles actualmente en el TP del asociado. Si no hay datos disponibles, el TP local no espera.

TEST_RTSo MC_TEST_RTS
Determina si se ha recibido un REQUEST_TO_SEND o un MC_REQUEST_TO_SEND o una notificación.

Verbos para confirmar errores de datos o informes

CONFIRMADOo MC_CONFIRMED
Responde a una solicitud de confirmación del TP del asociado. Informa al TP del asociado de que el TP local ha recibido y procesado los datos sin errores.

RECEIVE_LOG_DATAo MC_RECEIVE_LOG_DATA
La emisión de este verbo permite al usuario registrarse para recibir los datos de registro asociados a un informe de error de encabezado de administración de funciones entrante 7 (FMH7). El verbo pasa un búfer a APPC y los datos de registro recibidos se colocan en ese búfer. APPC sigue usando este búfer cuando llegan fmH7 sucesivos hasta que se proporciona con otro búfer (es decir, hasta que el TP emite otra RECEIVE_LOG_DATA o MC_RECEIVE_LOG_DATA especificar un búfer diferente o ningún búfer en absoluto).

SEND_CONVERSATIONo MC_SEND_CONVERSATION
Emitido por la invocación de TP, este verbo asigna una sesión entre la LU local y la LU del asociado, envía datos en la sesión y, a continuación, desasigna la sesión.

SEND_ERRORo MC_SEND_ERROR
Notifica al TP del asociado que el TP local ha encontrado un error de nivel de aplicación.

Verbos para obtener y establecer información

GET_ATTRIBUTESo MC_GET_ATTRIBUTES
Usado por un TP para obtener los atributos de la conversación.

GET_LU_STATUS
Se usa para notificar el estado de una LU remota determinada.

GET_STATE
Usado por un TP para interrogar el estado de una conversación determinada.

GET_TP_PROPERTIES
Devuelve los atributos del TP y la transacción actual.

GET_TYPE
Usado por un TP para determinar el tipo de conversación (básico o asignado) de una conversación determinada. Con esta información, el TP puede decidir si emitir verbos de conversación básicos o asignados.

SET_TP_PROPERTIES
Se usa para establecer los atributos del TP y la transacción actual.

Verbos que proporcionan funciones de administración

ACTIVATE_SESSION
Activa una sesión entre la LU local y una LU de asociado especificada mediante un modo especificado.

CNOS(Cambiar número de sesiones)
Establece los límites de sesión de APPC LU 6.2.

DEACTIVATE_SESSION
Desactiva una sesión determinada o todas las sesiones en un modo determinado.

PANTALLA
Devuelve información de configuración y valores operativos actuales para el nodo SNA.

Verbos para las conversaciones finales

DEALLOCATEo MC_DEALLOCATE
Desasigna una conversación entre dos CSP. Antes de desasignar la conversación, este verbo realiza el equivalente de FLUSH, MC_FLUSH, CONFIRM o MC_CONFIRM.

TP_ENDED
Emitido tanto por los CSP locales como por los asociados. Notifica a APPC que el TP está finalizando. La emisión de este verbo también finaliza las conversaciones activas.