Compartir a través de

GET_ATTRIBUTES

  • Artículo

El verbo GET_ATTRIBUTES devuelve los atributos de la conversación.

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

Sintaxis

  
struct get_attributes {  
    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    reserv3;  
    unsigned char    sync_level;  
    unsigned char    mode_name[8];  
    unsigned char    net_name[8];  
    unsigned char    lu_name[8];  
    unsigned char    lu_alias[8];  
    unsigned char    plu_alias[8];  
    unsigned char    plu_un_name[8];  
    unsigned char    reserv4[2];  
    unsigned char    fqplu_name[17];  
    unsigned char    reserv5;  
    unsigned char    user_id[10];  
    unsigned long    conv_group_id;  
    unsigned char    conv_corr_len;  
    unsigned char    conv_corr[8];  
    unsigned char    reserv6[13];  
NOTE: The following fields are present when the high bit of opext is set (opext & AP_EXTD_VCB) != 0.   
    unsigned char    luw_id[26];  
    unsigned char    sess_id[8];  
};

Miembros

opcode
Parámetro proporcionado. Especifica el código de operación de verbo, AP_B_GET_ATTRIBUTES.

opext
Parámetro proporcionado. Especifica la extensión de operación de verbo, AP_BASIC_CONVERSATION.

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 devuelve TP_STARTED en el TP invocado o por RECEIVE_ALLOCATE en el TP invocado.

conv_id
Parámetro proporcionado. Proporciona el identificador de conversación. El valor de este parámetro lo devuelve ALLOCATE en el TP invocado o por RECEIVE_ALLOCATE en el TP invocado.

sync_level
Parámetro devuelto. Especifica el nivel de procesamiento de sincronización para la conversación. Este parámetro determina si los CSP pueden solicitar confirmación de la recepción de datos y confirmar la recepción de datos.

  • AP_NONE indica que el procesamiento de confirmación no se usará en esta conversación.

  • AP_CONFIRM_SYNC_LEVEL indica que los CSP pueden usar el procesamiento de confirmación en esta conversación.

  • AP_SYNCPT indica que los TP pueden usar el procesamiento de confirmación de nivel 2 de punto de sincronización en esta conversación.

    mode_name
    Parámetro devuelto. Especifica el nombre de un conjunto de características de red. Es un tipo cadena de caracteres EBCDIC.

    net_name
    Parámetro devuelto. Especifica el nombre de la red SNA que contiene la unidad lógica local (LU) usada por este TP. Es un tipo cadena de caracteres EBCDIC.

    lu_name
    Parámetro devuelto. Proporciona el nombre de la LU local.

    lu_alias
    Parámetro devuelto. Proporciona el alias por el que se conoce la LU local con el TP local. Es una cadena de caracteres ASCII.

    plu_alias
    Parámetro devuelto. Proporciona el alias por el que se conoce la LU del asociado al TP local. Es una cadena de caracteres ASCII.

    plu_un_name
    Parámetro devuelto. Especifica el nombre nointerpretado de la LU del asociado: el nombre de la LU del asociado tal y como se define en el punto de control de servicios del sistema (SSCP). Es una cadena de caracteres EBCDIC de tipo AE. Este parámetro solo se devuelve si la LU local depende.

    fqplu_name
    Parámetro devuelto. Proporciona el nombre completo de la LU del asociado. Es un tipo cadena de caracteres EBCDIC. El campo contiene el nombre de red, un punto EBCDIC y el nombre de PARTNER-LU.

    user_id
    Parámetro devuelto. Especifica el identificador de usuario enviado por el TP invocando a través de ALLOCATE para tener acceso al TP invocado (si procede). Es una cadena de caracteres EBCDIC de tipo AE. El campo contiene el identificador de usuario si se cumplen las condiciones siguientes:

  • El TP invocado requiere seguridad de conversación.

  • GET_ATTRIBUTES fue emitido por el TP invocado.

    De lo contrario, el campo contiene espacios.

    conv_group_id
    Parámetro devuelto. Especifica el identificador del grupo de conversación de la sesión a la que se ha asignado la conversación. Esto también se devuelve en ALLOCATE y RECEIVE_ALLOCATE.

    conv_corr_len
    Parámetro devuelto. Especifica la longitud del identificador del correlador de conversación que se devuelve.

    conv_corr
    Parámetro devuelto. Especifica el identificador del correlator de conversación (si existe) que la LU de origen asigna para identificar la conversación, que es única para el par de LU de origen o asociado. La LU de origen la envía en la solicitud de asignación.

Nota

Los campos siguientes están presentes cuando se establece el bit alto de opext (opext & AP_EXTD_VCB) != 0.Estos campos solo están presentes cuando se usa compatibilidad con el nivel de punto de sincronización 2.

luw_id
Identificador de unidad de trabajo lógico.

sess_id
Identificador de la sesión.

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 coincide con un identificador de conversación asignado por APPC.

AP_BAD_TP_ID

Código de retorno secundario; el valor de tp_id no coincide 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_CONVERSATION_TYPE_MIXED
    Código de retorno principal; el TP ha emitido verbos de conversación básicos y asignados. Solo se puede emitir un tipo en una sola conversació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 la misma 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 excepto RESET cuando el TP emite este verbo.

No hay ningún cambio de estado.