DEACTIVATE_SESSION

El DEACTIVATE_SESSION verbo solicita a Microsoft® Host Integration Server desactivar una sesión determinada entre la unidad lógica local (LU) y una LU de asociado especificada, o todas las sesiones en un modo determinado.

En la estructura siguiente se describe el bloque de control de verbos usado por el verbo DEACTIVATE_SESSION .

Sintaxis

  
typedef struct deactivate_session {  
    unsigned short  opcode;  
    unsigned char   reserv2[2];  
    unsigned short  primary_rc;  
    unsigned long   secondary_rc;  
    unsigned char   reserv3[8];  
    unsigned char   lu_alias[8];  
    unsigned char   session_id[8];  
    unsigned char   plu_alias[8];  
    unsigned char   mode_name[8];  
    unsigned char   type;  
    unsigned char   reserv4[3];  
    unsigned short  sense_data;  
    unsigned char   fqplu_name[17];  
    unsigned char   reserv5[19];  
} DEACTIVATE_SESSION;   

Members

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

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.

reserv3
Campo reservado.

lu_alias
Parámetro proporcionado. Proporciona el nombre ASCII de 8 bytes que se usa localmente para la LU.

session_id
Parámetro proporcionado. Proporciona el identificador de 8 bytes de la sesión que se va a desactivar (devuelto en el verbo ACTIVATE_SESSION ). Si este campo se establece en 8 ceros binarios, Host Integration Server desactiva todas las sesiones para la LU y el modo del asociado.

plu_alias
Parámetro proporcionado. Proporciona el nombre ASCII de 8 bytes que se usa localmente para la LU del asociado. Si se va a usar la LU remota predeterminada, rellene este parámetro con espacios. Si se va a especificar la LU del asociado con el parámetro fqplu_name , rellene este parámetro con ceros binarios.

mode_name
Parámetro proporcionado. Especifica el nombre del modo EBCDIC (tipo A).

tipo
Parámetro proporcionado. Especifica el tipo de desactivación. Los valores posibles son:

AP_DEACT_CLEANUP
Desactive la sesión inmediatamente, sin esperar a que finalicen las sesiones.

AP_DEACT_NORMAL
No desactive la sesión hasta que todas las conversaciones que usen la sesión hayan finalizado.

sense_data
Parámetro devuelto. Especifica los datos del sentido de desactivación de la sesión.

reserv4
Campo reservado.

fqplu_name
Parámetro proporcionado. Proporciona el nombre de LU del asociado en EBCDIC (tipo A) cuando no se define ningún nombre plu_alias en el nodo local y la LU del asociado se encuentra en un nodo diferente. Este parámetro se omite si se especifica plu_alias .

reserv5
Campo reservado.

Códigos de retorno

AP_OK
Código de retorno principal; el verbo se ha ejecutado correctamente. El código de retorno secundario indica la polaridad de la sesión establecida. Se pueden devolver los valores siguientes.

AP_PARAMETER_CHECK
Código de retorno principal; el verbo no se ejecutó debido a un error de parámetro, especificado por uno de los siguientes códigos de retorno secundarios:

AP_INVALID_LU_ALIAS
Código de retorno secundario; APPC no encuentra el lu_alias especificado entre los definidos.

AP_INVALID_PLU_ALIAS
Código de retorno secundario; APPC no reconoció el plu_alias especificado.

AP_INVALID_SESSION_ID
Código de retorno secundario; APPC no reconoció el session_id especificado.

AP_INVALID_MODE_NAME
Código de retorno secundario; APPC no reconoció el mode_name especificado.

AP_INVALID_FQPLU_NAME
Código de retorno secundario; APPC no reconoció el fqplu_name especificado.

AP_INVALID_TYPE
Código de retorno secundario; APPC no reconoció el tipo especificado.

AP_COMM_SUBSYSTEM_ABENDED
Código de retorno principal; indica que se ha producido una de las condiciones siguientes:

El nodo utilizado por esta conversación encontró una anulación.

Se ha interrumpido la conexión entre el TP y el nodo PU 2.1 (se produjo un error de red de área local).

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 al administrador del sistema para aplicar una acción correctiva.

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_THREAD_BLOCKING
Código de retorno principal; el subproceso que llama ya está en una llamada de bloqueo.