Compartir a través de

GET_LU_STATUS

El verbo GET_LU_STATUS devuelve el estado de una unidad lógica determinada (LU). Este verbo de conversación solo está disponible cuando se admiten conversaciones de punto de sincronización.

En la estructura siguiente se describe el bloque de control de verbos (VCB) usado por el verbo GET_LU_STATUS .

Sintaxis

  
struct get_type {  
    unsigned short   opcode;  
    unsigned char    opext;  
    unsigned char    reserv2;  
    unsigned short   primary_rc;  
    unsigned long    secondary_rc;  
    unsigned char    tp_id[8];  
    unsigned char    plu_alias[8];  
    unsigned short   active_sess;  
    unsigned char    zero_sess;  
    unsigned char    local_only;  
    unsigned char    synchpoint;  
    unsigned char    pool_member;  
    unsigned char    reserv3[7];  
};

Miembros

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

opext
Este campo no lo usa el verbo GET_LU_STATUS .

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.

tp_id
Parámetro proporcionado. Identifica el programa de transacciones local (TP). El valor de este parámetro lo devolvió TP_STARTED en la invocación de TP, o mediante RECEIVE_ALLOCATE o RECEIVE_ALLOCATE_EX en el TP invocado.

plu_alias
Parámetro proporcionado. Proporciona el identificador de la LU sobre la que se solicita este TP. El valor de este parámetro lo devolvió MC_ALLOCATE o ALLOCATE en el TP invocado o mediante RECEIVE_ALLOCATE en el TP invocado.

No es necesario si local_only está establecido en AP_YES

active_sess
Parámetro devuelto. Proporciona el número de sesiones activas en esta LU.

zero_sess
Parámetro devuelto. Indica si una sesión cero está en esta LU. Los valores son AP_YES o AP_NO.

active_sess
Parámetro devuelto.

zero_sess
Parámetro devuelto.

local_only
Si este campo se establece en AP_YES, no es necesario especificar el plu_alias y el verbo solo devuelve la información de LU local: punto de sincronización y default_pool.

synchpoint
Parámetro devuelto.

pool_member
Si este campo se establece en AP_YES, no es necesario especificar el plu_alias y el verbo solo devuelve la información de LU local: punto de sincronización y default_pool.

reserv3
Un campo reservado.

Códigos de retorno

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

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

AP_BAD_LU_ALIAS

Código de retorno secundario; el valor de plu_alias no coincidía con ninguna LU asignada por APPC.

AP_BAD_TP_ID

Código de retorno secundario; el valor de tp_id no coincide con un identificador tp asignado por APPC.

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_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_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 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

La conversación puede estar en cualquier estado excepto RESET cuando el TP emite este verbo.

No hay ningún cambio de estado.

La versión actual de GET_LU_STATUS permite que una aplicación recupere parámetros de configuración para una LU appC local.

Para comprobar la configuración de una LU local determinada antes de emitir un verbo RECEIVE_ALLOCATE_EX, se debe emitir la siguiente secuencia de verbos:

  • TP_STARTED (especificando la LU local de interés)

  • GET_LU_STATUS (con local_only establecido en AP_YES)

  • TP_ENDED (AP_SOFT)

  • Last updated on