CNOS

Das Verb CNOS (Change Number of Sessions) richtet APPC LU 6.2-Sitzungsgrenzwerte ein.

In der folgenden Struktur wird der verbsteuerungsblock beschrieben, der vom CNOS-Verb verwendet wird.

Syntax

  
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;   

Elemente

Opcode
Angegebener Parameter. Gibt den Verbvorgangscode AP_CNOS an.

reserv2
Ein reserviertes Feld.

primary_rc
Zurückgegebener Parameter. Gibt den primären Rückgabecode an, der von APPC am Ende des Verbs festgelegt wurde. Die gültigen Rückgabecodes variieren je nach ausgegebenen APPC-Verb. Informationen zu gültigen Fehlercodes für dieses Verb finden Sie unter "Rückgabecodes".

secondary_rc
Zurückgegebener Parameter. Gibt den von APPC festgelegten sekundären Rückgabecode am Ende des Verbs an. Die gültigen Rückgabecodes variieren je nach ausgegebenen APPC-Verb. Informationen zu gültigen Fehlercodes für dieses Verb finden Sie unter "Rückgabecodes".

Schlüssel
Angegebener Parameter. Gibt entweder den Master- oder Dienstschlüssel im ASCII-Format an, wenn das Keylock-Feature gesichert wurde.

lu_alias
Angegebener Parameter. Stellt den 8-Byte-ASCII-Namen bereit, der lokal für die LU verwendet wird.

plu_alias
Angegebener Parameter. Stellt den 8-Byte-ASCII-Namen bereit, der lokal für die Partner-LU verwendet wird.

fqplu_name
Angegebener Parameter. Stellt den Namen der logischen Partnereinheit (LU) in EBCDIC (Typ A) bereit, wenn kein plu_alias Name am lokalen Knoten definiert ist und sich die Partner-LU auf einem anderen Knoten befindet.

mode_name
Angegebener Parameter. Gibt den Namen des EBCDIC-Modus (Typ A) an, der verwendet werden soll, wenn der Wert von mode_name_select AP_ONE ist.

mode_name_select
Angegebener Parameter. Gibt den Modusnamen an, für den Ihr Programm die Sitzungsgrenzwerte festlegt oder zurückgesetzt, und die Polaritäten des Gewinners von Inhalten. Zulässige Werte sind AP_ALL oder AP_ONE.

set_negotiable
Angegebener Parameter. Gibt an, ob APPC die aktuelle Einstellung für das maximale verhandelbare Sitzungslimit ändern soll. Zulässige Werte sind AP_YES und AP_NO.

reserv4
Ein 6-Bit-reserviertes Feld.

reserv5
Ein 8-Bit-reserviertes Feld.

plu_mode_sess_lim
Angegebener Parameter. Gibt den Sitzungsgrenzwert an, wenn der Wert für set_negotiable JA ist. Zulässige Werte sind 0 bis 32767.

min_conwinners_source
Angegebener Parameter. Gibt die Anzahl der Sitzungen an, von denen die LU garantiert der Gewinner des Inhalts ist. Zulässige Werte sind 0 bis 32767.

min_conwinners_target
Angegebener Parameter. Gibt die Mindestanzahl der Sitzungen an, von denen die Ziel-LU garantiert der Gewinner des Inhalts ist. Zulässige Werte sind 0 bis 32767.

auto_act
Angegebener Parameter. Gibt die Anzahl der lokalen LUs contention-winner-Sitzungen an, damit APPC automatisch aktiviert wird. Zulässige Werte sind 0 bis 32767. Lesen Sie den Abschnitt "Hinweise" dieses Themas, bevor Sie diesen Parameter verwenden.

drain_target
Angegebener Parameter. Gibt an, ob die Ziel-LU ihre wartenden (ausgehenden) Zuordnungsanforderungen entladen kann. Zulässige Werte sind AP_YES und AP_NO.

drain_source
Angegebener Parameter. Gibt an, ob die Quell-LU ihre wartenden (ausgehenden) Zuordnungsanforderungen entladen kann. Zulässige Werte sind AP_YES und AP_NO.

verantwortlich
Angegebener Parameter. Gibt an, welche LU für die Deaktivierung der Sitzungen durch das Zurücksetzen des Sitzungslimits für Parallelsitzungsverbindungen verantwortlich ist. Zulässige Werte sind AP_SOURCE und AP_TARGET.

reserv6
Ein 5-Bit-reserviertes Feld.

Reserv7
Ein 8-Bit-reserviertes Feld.

Rückgabecodes

AP_OK
Primärer Rückgabecode; das Verb erfolgreich ausgeführt wurde.

AP_CNOS_ACCEPTED
Sekundärer Rückgabecode; APPC akzeptiert die Sitzungsgrenzwerte und -verantwortung wie angegeben.

AP_CNOS_NEGOTIATED
Sekundärer Rückgabecode; APPC akzeptiert die Sitzungsgrenzwerte und -verantwortung als verhandelbar durch die Partner-LU. Werte, die ausgehandelt werden können, sind:

plu_mode_session_limit

min_conwinners_source

min_conwinners_target

Verantwortlich

drain_target

AP_ALLOCATION_ERROR
Primärer Rückgabecode; APPC konnte eine Unterhaltung nicht zuordnen. Der Unterhaltungszustand ist auf RESET festgelegt.

Dieser Code kann über ein Verb zurückgegeben werden, das nach ALLOCATE oder MC_ALLOCATE ausgegeben wurde.

AP_ALLOCATION_FAILURE_NO_RETRY
Sekundärer Rückgabecode; die Unterhaltung kann aufgrund einer dauerhaften Bedingung nicht zugewiesen werden, z. B. aufgrund eines Konfigurationsfehlers oder sitzungsprotokollfehlers. Um den Fehler zu ermitteln, sollte der Systemadministrator die Fehlerprotokolldatei untersuchen. Wiederholen Sie die Zuordnung erst, wenn der Fehler behoben wurde.

AP_ALLOCATION_FAILURE_RETRY
Sekundärer Rückgabecode; die Unterhaltung konnte aufgrund einer temporären Bedingung, z. B. aufgrund eines Verknüpfungsfehlers, nicht zugewiesen werden. Der Grund für den Fehler wird im Systemfehlerprotokoll protokolliert. Wiederholen Sie die Zuordnung.

AP_CNOS_LOCAL_RACE_REJECT
Primärer Rückgabecode; APPC verarbeitet derzeit ein CNOS-Verb , das von einer lokalen LU ausgegeben wird.

AP_CNOS_PARTNER_LU_REJECT
Primärer Rückgabecode; die Partner-LU hat eine CNOS-Anforderung von der lokalen LU abgelehnt.

AP_CNOS_MODE_CLOSED
Sekundärer Rückgabecode; Die lokale LU kann keinen Grenzwert für eine nichtzero-Sitzung aushandeln, da die lokale maximale Sitzungsgrenze bei der Partner-LU null ist.

AP_CNOS_MODE_NAME_REJECT
Sekundärer Rückgabecode; die Partner-LU erkennt den angegebenen Modusnamen nicht.

AP_CNOS_COMMAND_RACE_REJECT
Sekundärer Rückgabecode; die lokale LU verarbeitet derzeit ein vom Partner LU ausgestelltes CNOS-Verb .

AP_COMM_SUBSYSTEM_ABENDED
Primärer Rückgabecode; gibt eine der folgenden Bedingungen an:

Der von dieser Unterhaltung verwendete Knoten hat einen ABEND gefunden.

Die Verbindung zwischen dem Transaktionsprogramm (TP) und dem PU 2.1-Knoten wurde unterbrochen (ein Lokaler Netzwerkfehler).

Die SnaBase auf dem Computer der TPs hat einen ABEND gefunden.

Der Systemadministrator sollte das Fehlerprotokoll untersuchen, um den Grund für den ABEND zu ermitteln.

AP_COMM_SUBSYSTEM_NOT_LOADED
Primärer Rückgabecode; Eine erforderliche Komponente konnte beim Verarbeiten des Verbs nicht geladen oder beendet werden. So konnte die Kommunikation nicht stattfinden. Wenden Sie sich an den Systemadministrator, um Korrekturmaßnahmen zu ergreifen.

AP_INVALID_KEY
Primärer Rückgabecode; Der angegebene Schlüssel war falsch.

AP_INVALID_VERB_SEGMENT
Primärer Rückgabecode; die VCB über das Ende des Datensegments hinaus erweitert wurde.

AP_PARAMETER_CHECK
Primärer Rückgabecode; das Verb wurde aufgrund eines Parameterfehlers nicht ausgeführt.

AP_ALL_MODE_MUST_RESET
Sekundärer Rückgabecode; APPC lässt keinen Grenzwert für eine nichtzero-Sitzung zu, wenn der mode_name_select-Parameter AP_ALL angibt.

AP_AUTOACT_EXCEEDS_SESSLIM
Sekundärer Rückgabecode; im CNOS-Verb ist der Wert für auto_act größer als der Wert für plu_mode_sess_lim.

AP_BAD_LU_ALIAS
Sekundärer Rückgabecode; APPC kann die angegebene lu_alias unter diesen definierten nicht finden.

AP_BAD_PARTNER_LU_ALIAS
Sekundärer Rückgabecode; APPC hat die bereitgestellte plu_alias nicht erkannt.

AP_BAD_SNASVCMG_LIMITS
Sekundärer Rückgabecode; Das Programm hat ungültige Einstellungen für plu_mode_sess_lim, min_conwinners_source oder min_conwinners_target angegeben, wenn mode_name angegeben wurde.

AP_CHANGE_SRC_DRAINS
Sekundärer Rückgabecode; APPC lässt mode_name_select (ONE) und drain_source (JA) nicht zu, wenn drain_source (NEIN) derzeit für den angegebenen Modus wirksam ist.

AP_CNOS_IMPLICIT_PARALLEL
Sekundärer Rückgabecode; APPC erlaubt keine Änderung des Sitzungslimits für einen anderen Modus als den SNASVCMG-Modus für die implizite Partnervorlage, wenn die Vorlage parallele Sitzungen angibt. (Der Begriff "Vorlage" wird verwendet, da viele der tatsächlichen Werte noch ausgefüllt werden müssen.)

AP_CPSVCMG_MODE_NOT_ALLOWED
Sekundärer Rückgabecode; der Modus "CPSVCMG" kann nicht als mode_name im Deaktivierungssitzungsverb angegeben werden.

AP_EXCEEDS_MAX_ALLOWED
Sekundärer Rückgabecode; Ihr Programm hat ein CNOS-Verb ausgegeben, das eine plu_mode_sess_lim Zahl und set_negotiable (AP_NO ) angibt.

AP_MIN_GT_TOTAL
Sekundärer Rückgabecode; die Summe der min_conwinners_source und min_conwinners_target gibt eine Zahl an, die größer als plu_mode_sess_lim ist.

AP_MODE_CLOSED
Sekundärer Rückgabecode; Die lokale LU kann keinen Grenzwert für eine nichtzero-Sitzung aushandeln, da die lokale maximale Sitzungsgrenze bei der Partner-LU null ist.

AP_RESET_SNA_DRAINS
Sekundärer Rückgabecode; SNASVCMG unterstützt die Entwässerungsparameterwerte nicht.

AP_SINGLE_NOT_SRC_RESP
Sekundärer Rückgabecode; bei einem CNOS-Verb mit einer einzigen Sitzung kann APPC nur die lokale LU (Quell-LU) für die Deaktivierung von Sitzungen verantwortlich sein.

AP_STACK_TOO_SMALL
Primärer Rückgabecode; Die Stapelgröße der Anwendung ist zu klein, um das Verb auszuführen. Erhöhen Sie die Stapelgröße Ihrer Anwendung.

AP_STATE_CHECK
Primärer Rückgabecode; das Verb wurde nicht ausgeführt, weil es in einem ungültigen Zustand ausgegeben wurde.

AP_CANT_RAISE_LIMITS
Sekundärer Rückgabecode; APPC lässt das Festlegen von Sitzungsgrenzwerten auf einen Wert ungleich Null nicht zu.

AP_LU_DETACHED
Sekundärer Rückgabecode; ein Befehl hat die Definition der lokalen LU zurückgesetzt, bevor CNOS versucht hat, die LU anzugeben.

AP_SNASVCMG_RESET_NOT_ALLOWED
Sekundärer Rückgabecode; Ihr lokales Programm hat versucht, das CNOS-Verb für den Modus mit dem Namen SNASVCMG auszustellen und einen Sitzungsgrenzwert von Null anzugeben.

AP_UNEXPECTED_DOS_ERROR
Primärer Rückgabecode; das Betriebssystem hat beim Verarbeiten eines APPC-Verbs aus dem lokalen TP einen Fehler an APPC zurückgegeben. Der Rückgabecode des Betriebssystems wird über die secondary_rc zurückgegeben. Es wird in intel byte-getauschter Reihenfolge angezeigt. Wenn das Problem weiterhin besteht, wenden Sie sich an den Systemadministrator.

Bemerkungen

CNOS identifiziert eine LU allein nach Alias. Wenn derselbe lokale LU-Alias mehrmals in einer Domäne (für Sicherungen oder andere Zwecke) verwendet wird und dieser LU-Alias über CNOS angegeben wird, kann das Verb zu einer anderen LU als die beabsichtigte fließen.

Wenn CNOS nicht ausgegeben wird, um den Sitzungsgrenzwert für den Modus festzulegen, bevor ein Programm seine erste APPC ASSIGNED-, MC_ALLOCATE-, SEND_CONVERSATION- oder MC_SEND_CONVERSATION- oder Common Programming Interface for Communications (CPI-C) Zuweisen eines Anrufs für eine bestimmte Partner-LU und den Modus ausgibt, generiert APPC intern einen Sitzungsgrenzwert mithilfe des Werts aus der Modusdefinition.

Wenn Sie die Grenzwerte für eine parallele Sitzungsverbindung festlegen, verhandeln die beiden LUs die Modussitzungsgrenzwerte, Entwässerungseinstellungen und Verantwortungswerte. APPC aktualisiert diese Parameter in CNOS , um die einstellungen widerzuspiegeln, die von beiden LUs während der Aushandlung vereinbart wurden. Ihr Programm kann DISPLAY ausgeben, um die ausgehandelten Werte für den Sitzungsgrenzwert für den Modus abzurufen.

Es tritt keine CNOS-Aushandlung auf, wenn die Grenzwerte für eine einzelne Sitzung festgelegt werden (d. h. die beiden LUs verhandeln keine Entwässerungseinstellungen oder Verantwortungswerte). Koordinieren Sie daher die Einstellungen der Modusdefinitionsparameter zwischen Partner-LUs mithilfe einer Einzelsitzungsverbindung, indem Sie einen einzelnen Sitzungsmodus auf jedem Knoten definieren.

Im Rahmen der Einrichtung der anfänglichen Grenzwerte legt CNOS auch die garantierte (d. h. die mindeste) Anzahl der Contention-Gewinner- und Inhaltslosersitzungen fest und legt die automatische Aktivierungsanzahl für die Quell-LUs contention-winner-Sitzungen fest. Die Aktion von CNOS wirkt sich normalerweise nur auf die Gruppe von Sitzungen mit dem angegebenen Modusnamen zwischen der Quell-LU und der Ziel-LU aus. Alternativ kann ein CNOS die Sitzungsgrenzwerte aller Modi für eine Partner-LU zurücksetzen.

APPC erzwingt das neue Modus-Sitzungslimit und die Inhaltsgewinner-Polaritäten, bis eine Seite oder die anderen sie ändern, indem ein nachfolgendes CNOS-Verb ausgestellt wird. Die CNOS-Transaktion ist bei der ZIEL-LU-API unsichtbar, unabhängig davon, welche LU das Ziel ist. Die Ergebnisse der CNOS-Transaktion können mit DISPLAY abgerufen werden.