DEACTIVATE_SESSION

Il verbo DEACTIVATE_SESSION richiede a Microsoft® Host Integration Server di disattivare una determinata sessione tra l'unità logica locale (LU) e un lu partner specificato o tutte le sessioni in una determinata modalità.

Nella struttura seguente viene descritto il blocco di controllo verbo utilizzato dal verbo DEACTIVATE_SESSION .

Sintassi

  
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
Parametro fornito. Specifica il codice dell'operazione verbo AP_DEACTIVATE_SESSION.

reserv2
Un campo riservato.

Primary_rc
Parametro restituito. Specifica il codice restituito primario impostato da APPC al completamento del verbo. I codici restituiti validi variano a seconda del verbo APPC emesso. Per questo verbo, vedere Codici restituiti per codici di errore validi.

Secondary_rc
Parametro restituito. Specifica il codice restituito secondario impostato da APPC al completamento del verbo. I codici restituiti validi variano a seconda del verbo APPC emesso. Per questo verbo, vedere Codici restituiti per codici di errore validi.

reserv3
Un campo riservato.

Lu_alias
Parametro fornito. Fornisce il nome ASCII a 8 byte usato localmente per l'unità lu.

session_id
Parametro fornito. Fornisce l'identificatore a 8 byte della sessione da disattivare (restituito nel verbo ACTIVATE_SESSION ). Se questo campo è impostato su 8 zeri binari, Host Integration Server disattiva tutte le sessioni per l'lu e la modalità partner.

plu_alias
Parametro fornito. Fornisce il nome ASCII a 8 byte usato localmente per l'lu del partner. Se l'unità lu remota predefinita deve essere usata, compilare questo parametro con spazi. Se il lu partner deve essere specificato con il parametro fqplu_name , compilare questo parametro con zeri binari.

mode_name
Parametro fornito. Specifica il nome della modalità EBCDIC (tipo A).

tipo
Parametro fornito. Specifica il tipo di disattivazione. I valori possibili sono:

AP_DEACT_CLEANUP
Disattivare immediatamente la sessione, senza attendere la fine delle sessioni.

AP_DEACT_NORMAL
Non disattivare la sessione fino al termine di tutte le conversazioni che usano la sessione.

sense_data
Parametro restituito. Specifica i dati del senso di disattivazione per la sessione.

reserv4
Un campo riservato.

fqplu_name
Parametro fornito. Fornisce il nome lu partner in EBCDIC (tipo A) quando non viene definito alcun nome di plu_alias nel nodo locale e l'lu del partner si trova in un nodo diverso. Questo parametro viene ignorato se viene specificato plu_alias .

reserv5
Un campo riservato.

Codici restituiti

AP_OK
Codice restituito primario; il verbo eseguito correttamente. Il codice restituito secondario indica la polarità della sessione stabilita. È possibile restituire i valori seguenti.

AP_PARAMETER_CHECK
Codice restituito primario; il verbo non è stato eseguito a causa di un errore di parametro, specificato da uno dei codici restituiti secondari seguenti:

AP_INVALID_LU_ALIAS
Codice restituito secondario; APPC non è in grado di trovare il lu_alias specificato tra quelli definiti.

AP_INVALID_PLU_ALIAS
Codice restituito secondario; APPC non riconosce il plu_alias specificato.

AP_INVALID_SESSION_ID
Codice restituito secondario; APPC non riconosce il session_id specificato.

AP_INVALID_MODE_NAME
Codice restituito secondario; APPC non riconosce il mode_name specificato.

AP_INVALID_FQPLU_NAME
Codice restituito secondario; APPC non riconosce il fqplu_name specificato.

AP_INVALID_TYPE
Codice restituito secondario; APPC non riconosce il tipo specificato.

AP_COMM_SUBSYSTEM_ABENDED
Codice restituito primario; indica una delle condizioni seguenti:

Il nodo usato da questa conversazione ha rilevato un ABEND.

La connessione tra il tp e il nodo pu 2.1 è stata interrotta (si è verificato un errore di rete locale).

SnaBase nel computer tp ha rilevato un ABEND.

L'amministratore di sistema deve esaminare il log degli errori per determinare il motivo di ABEND.

AP_COMM_SUBSYSTEM_NOT_LOADED
Codice restituito primario; Impossibile caricare o terminare un componente richiesto durante l'elaborazione del verbo. Pertanto, la comunicazione non poteva avvenire. Contattare l'amministratore di sistema per un'azione correttiva.

AP_STACK_TOO_SMALL
Codice restituito primario; le dimensioni dello stack dell'applicazione sono troppo piccole per eseguire il verbo. Aumentare le dimensioni dello stack dell'applicazione.

AP_THREAD_BLOCKING
Codice restituito primario; il thread chiamante è già in una chiamata di blocco.