DEACTIVATE_SESSION

El DEACTIVATE_SESSION verbo solicita a Microsoft® Host Integration Server que desactive 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 verbo 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;   

Miembros

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

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.

reserv3
Un campo reservado.

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

identificador_de_sesión
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 finalicen todas las conversaciones que usan la sesión.

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

reserv4
Un 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
Un campo reservado.

Códigos de retorno

AP_OK
Código de retorno principal; el verbo se ejecutó 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 una de las condiciones siguientes:

El nodo usado por esta conversación encontró un ABEND.

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

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_COMM_SUBSYSTEM_NOT_LOADED
Código de retorno principal; No se pudo cargar ni finalizar un componente necesario mientras se procesaba el verbo. Por lo tanto, no se pudo realizar la comunicación. Póngase en contacto con el administrador del sistema para obtener una acción correctiva.

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