Condividi tramite


CNOS

Il verbo CNOS (Change Number of Sessions) stabilisce i limiti di sessione DI APPC LU 6.2.

La struttura seguente descrive il blocco di controllo verbo utilizzato dal verbo CNOS .

Sintassi

  
typedef struct cnos {  
    unsigned short  opcode;  
    unsigned char   reserv2[2];  
    unsigned short  primary_rc;  
    unsigned long   secondary_rc;  
    unsigned char   key[8];  
    unsigned char   lu_alias[8];  
    unsigned char   plu_alias[8];  
    unsigned char   fqplu_name[17];  
    unsigned char   reserv3;  
    unsigned char   mode_name[8];  
    unsigned int    mode_name_select:1;  
    unsigned int    set_negotiable:1;  
    unsigned int    reserv4:6;  
    unsigned int    reserv5:8;  
    unsigned short  plu_mode_sess_lim;  
    unsigned short  min_conwinners_source;  
    unsigned short  min_conwinners_target;  
    unsigned short  auto_act;  
    unsigned int    drain_target:1;  
    unsigned int    drain_source:1;  
    unsigned int    responsible:1;  
    unsigned int    reserv6:5;  
    unsigned int    reserv7:8;  
} CNOS;   

Members

Opcode
Parametro fornito. Specifica il codice dell'operazione verbo AP_CNOS.

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.

Key
Parametro fornito. Specifica la chiave master o del servizio in ASCII, se la funzionalità di keylock è stata protetta.

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

plu_alias
Parametro fornito. Fornisce il nome ASCII a 8 byte usato localmente per l'lu del partner.

fqplu_name
Parametro fornito. Fornisce il nome dell'unità logica partner (LU) 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.

mode_name
Parametro fornito. Specifica il nome della modalità EBCDIC (tipo A) da utilizzare quando il valore di mode_name_select è AP_ONE.

mode_name_select
Parametro fornito. Specifica il nome della modalità selezionato per il quale il programma sta impostando o reimpostando i limiti di sessione e le polarità dei conflitti. I valori consentiti sono AP_ALL o AP_ONE.

set_negotiable
Parametro fornito. Specifica se APPC deve modificare l'impostazione corrente per il limite massimo di sessione negoziabile. I valori consentiti sono AP_YES e AP_NO.

reserv4
Campo riservato a 6 bit.

reserv5
Campo riservato a 8 bit.

plu_mode_sess_lim
Parametro fornito. Specifica il limite di sessione quando il valore per set_negotiable è SÌ. I valori consentiti sono compresi tra 0 e 32767.

min_conwinners_source
Parametro fornito. Specifica il numero di sessioni di cui è garantito che l'lu sia il vincitore della contesa. I valori consentiti sono compresi tra 0 e 32767.

min_conwinners_target
Parametro fornito. Specifica il numero minimo di sessioni di cui è garantito che l'lu di destinazione sia il vincitore della contesa. I valori consentiti sono compresi tra 0 e 32767.

auto_act
Parametro fornito. Specifica il numero di sessioni locali con contesa di unità di conflitto per APPC da attivare automaticamente. I valori consentiti sono compresi tra 0 e 32767. Vedere la sezione Osservazioni di questo argomento prima di usare questo parametro.

drain_target
Parametro fornito. Specifica se l'lu di destinazione può svuotare le richieste di allocazione in attesa (in uscita). I valori consentiti sono AP_YES e AP_NO.

drain_source
Parametro fornito. Specifica se l'lu di origine può svuotare le richieste di allocazione in attesa (in uscita). I valori consentiti sono AP_YES e AP_NO.

Responsabile
Parametro fornito. Specifica quale LU è responsabile della disattivazione delle sessioni in seguito alla reimpostazione del limite di sessione per le connessioni di sessione parallele. I valori consentiti sono AP_SOURCE e AP_TARGET.

reserv6
Campo riservato a 5 bit.

reserv7
Campo riservato a 8 bit.

Codici restituiti

AP_OK
Codice restituito primario; il verbo eseguito correttamente.

AP_CNOS_ACCEPTED
Codice restituito secondario; APPC accetta i limiti e la responsabilità della sessione come specificato.

AP_CNOS_NEGOTIATED
Codice restituito secondario; APPC accetta i limiti e la responsabilità della sessione come negoziabili dal lu partner. I valori che è possibile negoziare sono:

plu_mode_session_limit

min_conwinners_source

min_conwinners_target

Responsabile

drain_target

AP_ALLOCATION_ERROR
Codice restituito primario; APPC non è riuscito ad allocare una conversazione. Lo stato della conversazione è impostato su RESET.

Questo codice può essere restituito tramite un verbo emesso dopo ALLOCATE o MC_ALLOCATE.

AP_ALLOCATION_FAILURE_NO_RETRY
Codice restituito secondario; la conversazione non può essere allocata a causa di una condizione permanente, ad esempio un errore di configurazione o un errore del protocollo di sessione. Per determinare l'errore, l'amministratore di sistema deve esaminare il file di log degli errori. Non ripetere l'allocazione finché l'errore non è stato corretto.

AP_ALLOCATION_FAILURE_RETRY
Codice restituito secondario; Impossibile allocare la conversazione a causa di una condizione temporanea, ad esempio un errore di collegamento. Il motivo dell'errore viene registrato nel log degli errori di sistema. Riprovare l'allocazione.

AP_CNOS_LOCAL_RACE_REJECT
Codice restituito primario; APPC sta attualmente elaborando un verbo CNOS rilasciato da un lu locale.

AP_CNOS_PARTNER_LU_REJECT
Codice restituito primario; l'lu partner ha rifiutato una richiesta CNOS dall'lu locale.

AP_CNOS_MODE_CLOSED
Codice restituito secondario; l'lu locale non può negoziare un limite di sessione diverso da zero perché il limite massimo di sessione locale al lu partner è zero.

AP_CNOS_MODE_NAME_REJECT
Codice restituito secondario; l'lu partner non riconosce il nome della modalità specificato.

AP_CNOS_COMMAND_RACE_REJECT
Codice restituito secondario; l'lu locale sta attualmente elaborando un verbo CNOS rilasciato dall'LU partner.

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 programma di transazione (TP) e il nodo pu 2.1 è stato interrotto (errore di rete locale).

Il 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 obbligatorio durante l'elaborazione del verbo. Pertanto, la comunicazione non poteva essere eseguita. Contattare l'amministratore di sistema per un'azione correttiva.

AP_INVALID_KEY
Codice restituito primario; la chiave specificata non è corretta.

AP_INVALID_VERB_SEGMENT
Codice restituito primario; VCB esteso oltre la fine del segmento di dati.

AP_PARAMETER_CHECK
Codice restituito primario; il verbo non è stato eseguito a causa di un errore di parametro.

AP_ALL_MODE_MUST_RESET
Codice restituito secondario; APPC non consente un limite di sessione diverso da zero quando il parametro mode_name_select indica AP_ALL .

AP_AUTOACT_EXCEEDS_SESSLIM
Codice restituito secondario; nel verbo CNOS il valore per auto_act è maggiore del valore per plu_mode_sess_lim.

AP_BAD_LU_ALIAS
Codice restituito secondario; APPC non riesce a trovare il lu_alias specificato tra quelli definiti.

AP_BAD_PARTNER_LU_ALIAS
Codice restituito secondario; APPC non ha riconosciuto la plu_alias fornita.

AP_BAD_SNASVCMG_LIMITS
Codice restituito secondario; il programma specificato non è valido per plu_mode_sess_lim, min_conwinners_source o min_conwinners_targetquando mode_name è stato fornito.

AP_CHANGE_SRC_DRAINS
Codice restituito secondario; APPC non consente mode_name_select (ONE) e drain_source (YES) quando drain_source (NO) è attualmente effettivo per la modalità specificata.

AP_CNOS_IMPLICIT_PARALLEL
Codice restituito secondario; APPC non consente a un programma di modificare il limite di sessione per una modalità diversa dalla modalità SNASVCMG per il modello partner implicito quando il modello specifica sessioni parallele. Il termine "modello" viene usato perché molti dei valori effettivi non sono ancora compilati.

AP_CPSVCMG_MODE_NOT_ALLOWED
Codice restituito secondario; la modalità denominata CPSVCMG non può essere specificata come mode_name nel verbo della sessione disattivata.

AP_EXCEEDS_MAX_ALLOWED
Codice restituito secondario; il programma ha rilasciato un verbo CNOS , specificando un numero di plu_mode_sess_lim e set_negotiable (AP_NO).

AP_MIN_GT_TOTAL
Codice restituito secondario; la somma di min_conwinners_source e min_conwinners_target specifica un numero maggiore di plu_mode_sess_lim.

AP_MODE_CLOSED
Codice restituito secondario; l'lu locale non può negoziare un limite di sessione diverso da zero perché il limite massimo di sessione locale al lu partner è zero.

AP_RESET_SNA_DRAINS
Codice restituito secondario; SNASVCMG non supporta i valori dei parametri di scarico.

AP_SINGLE_NOT_SRC_RESP
Codice restituito secondario; per un verbo CNOS a sessione singola, APPC consente solo all'LU locale (origine) di essere responsabile della disattivazione delle sessioni.

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_STATE_CHECK
Codice restituito primario; il verbo non è stato eseguito perché è stato rilasciato in uno stato non valido.

AP_CANT_RAISE_LIMITS
Codice restituito secondario; APPC non consente di impostare i limiti di sessione su un valore diverso da zero, a meno che i limiti attualmente non siano zero.

AP_LU_DETACHED
Codice restituito secondario; un comando ha reimpostato la definizione dell'LU locale prima che CNOS tenti di specificare l'LU.

AP_SNASVCMG_RESET_NOT_ALLOWED
Codice restituito secondario; il programma locale ha tentato di emettere il verbo CNOS per la modalità denominata SNASVCMG, specificando un limite di sessione pari a zero.

AP_UNEXPECTED_DOS_ERROR
Codice restituito primario; il sistema operativo ha restituito un errore all'APPC durante l'elaborazione di un verbo APPC dal TP locale. Il codice restituito dal sistema operativo viene restituito tramite il secondary_rc. Viene visualizzato nell'ordine di scambio di byte Intel. Se il problema persiste, consultare l'amministratore di sistema.

Commenti

CNOS identifica un lu solo per alias. Se lo stesso alias LU locale viene usato più volte in un dominio (per il backup o altri scopi) e tale alias LU viene specificato tramite CNOS, il verbo può passare a un lu diverso rispetto a quello previsto.

Se CNOS non viene rilasciato per impostare il limite di sessione in modalità prima che un programma eseprima la prima allocazione APPC,MC_ALLOCATE, SEND_CONVERSATION o MC_SEND_CONVERSATION o la chiamata allocata Common Programming Interface for Communications (CPI-C) per un determinato partner LU e modalità, APPC genererà internamente un limite di sessione usando il valore dalla definizione della modalità.

Quando si impostano i limiti per una connessione di sessione parallela, i due UNITÀ negoziano i limiti della sessione di modalità, le impostazioni di svuotamento e i valori di responsabilità. APPC aggiorna questi parametri in CNOS per riflettere le impostazioni concordate da entrambe le UNITÀ durante la negoziazione. Il programma può rilasciare DISPLAY per ottenere i valori negoziati per il limite di sessione in modalità.

Nessuna negoziazione CNOS si verifica quando si impostano i limiti per una singola sessione, ovvero i due LUS non negoziano impostazioni di svuotamento o valori di responsabilità. Pertanto, coordinare le impostazioni dei parametri di definizione della modalità tra le UNITÀ di rete partner usando una connessione a sessione singola definendo una singola modalità sessione in ogni nodo.

Nell'ambito della configurazione dei limiti iniziali, CNOS imposta anche il numero minimo di sessioni di contesa e contesa e imposta il conteggio dell'attivazione automatica per le sessioni di contesa dell'LUs di origine. L'azione di CNOS influisce normalmente solo sul gruppo di sessioni con il nome della modalità specificato tra l'lu di origine e l'lu di destinazione. In alternativa, un CNOS può reimpostare i limiti della sessione di tutte le modalità per un lu partner.

APPC applica il nuovo limite di sessione in modalità e le polarità del vincitore della contesa fino a quando una o l'altra le modifica rilasciando un verbo CNOS successivo. La transazione CNOS è invisibile all'API dell'LU di destinazione, indipendentemente dalla destinazione lu. I risultati della transazione CNOS possono essere ottenuti usando DISPLAY.