Open(SSCP)-Anforderung

Die Open(SSCP)-Anforderungsnachricht fließt von der Anwendung zum Knoten. Sie wird mit einer SSCP-Verbindung (System Services Control Point) verwendet.

Syntax

struct Open(SSCP) Request {  
    PTRBFHDR  nxtqptr;  
    PTRBFELT  hdrept;  
    CHAR      numelts;  
    CHAR      msgtype;  
    CHAR      srcl;  
    CHAR      srcp;  
    INTEGER   srci;  
    CHAR      destl;  
    CHAR      destp;  
    INTEGER   desti;  
    CHAR      ophdr.openqual;  
    CHAR      ophdr.opentype;  
    CHAR      ophdr.appltype;  
    CHAR      ophdr.opluno;  
    INTEGER   ophdr.opresid;  
    INTEGER   ophdr.icreditr;  
    INTEGER   ophdr.icredits;  
    CHAR      ophdr.opninfo1;  
    CHAR      ophdr.opnpad1;  
};   
struct Open(SSCP) Request {  
    PTRBFELT   hdreptr->elteptr;  
    INTEGER    hdreptr->startd;  
    INTEGER    hdreptr->endd;  
    CHAR       hdreptr->trpad;  
    CHAR[268]  hdreptr->dataru;  
};  
struct Open(SSCP) Request {  
    PTRBFELT  hdreptr->elteptr->elteptr;  
    INTEGER   hdreptr->elteptr->startd;  
    INTEGER   hdreptr->elteptr->endd;  
    CHAR      hdreptr->elteptr->trpad;  
    CHAR[268] hdreptr->elteptr->dataru;  
};  

Elemente

nxtqptr
Zeiger auf den nächsten Pufferheader.

hdrept
Zeiger auf das erste Pufferelement.

numelts
Anzahl der Pufferelemente (0x02).

msgtype
Nachrichtentyp OPENMSG (0x01).

srcl
Quelllokalität.

srcp
Quellpartner. (Weitere Informationen finden Sie in den Hinweisen.)

srci
Quellindex.

destl
Zielgebietsschema.

destp
Zielpartner.

desti
Zielindex.

ophdr.openqual
Öffnen Sie den Qualifizierer REQU (0x01).

ophdr.opentype
Open type SSCPSEC (0x01).

ophdr.appltype
Anwendungsprogrammschnittstellentyp.

Funktionsverwaltungsschnittstelle (FMI) ohne Blockierung (0x02).

FMI mit Blockierung (0x82). (Weitere Informationen finden Sie in den Hinweisen.)

ophdr.opluno
Wahrheitseinheitsnummer. (Weitere Informationen finden Sie in den Hinweisen.)

ophdr.opresid
Ressourcenbezeichner.

ophdr.icreditr
Reserviert.

ophdr.icredits
Reserviert.

ophdr.opninfo1
Reserviert.

ophdr.opnpad1
Open force type. (Weitere Informationen finden Sie in den Hinweisen.)

OPEN_TEST (0x00)

OPEN_FORCE (0x01)

Element 1

hdreptr-elteptr>
Zeiger auf das nächste Pufferelement.

hdreptr–>startd
Anfang der Daten in diesem Pufferelement (1).

hdreptr–>endd
Ende der Daten in diesem Pufferelement.

hdreptr-trpad>
Reserviert (1 Byte).

hdreptr-dataru>
Datenanforderungs-/Antworteinheit (RU) wie folgt:

dataru[0–9]

Quellname. Sollte mit Leerzeichen gefüllt werden.

dataru[10–19]

Zielname. Legen Sie diese Eigenschaft auf die logische Einheit (LU) fest, mit der Sie kommunizieren möchten.

dataru[20]

Sense 4003-Kennzeichnung.

dataru[21]

Sense 4004-Kennzeichnung.

dataru[22]

Sense 4006-Kennzeichnung.

dataru[23]

Sense 4007-Kennzeichnung.

dataru[24]

Sense 4009-Kennzeichnung.

dataru[25]

Sense 400A-Kennzeichnung.

dataru[26]

Sense 400B-Kennzeichnung.

dataru[27]

Sense 400C-Kennzeichnung.

dataru[28]

Sense 400D-Kennzeichnung.

dataru[29]

Sense 400F-Kennzeichnung.

dataru[30]

Sense 4011-Kennzeichnung.

dataru[31]

Sense 4012-Kennzeichnung.

dataru[32]

Sense 4014-Kennzeichnung.

dataru[33]

Indikator mit hoher Priorität.

HIGH (0x01)

NIEDRIG (0x02)

dataru[34]

Logische Einheitsanwendung (LUA) unterstützter Indikator.

Unterstützt (0x01)

Nicht unterstützt (0x00)

dataru[35–36]

Blockgröße, die aus dem Dynamic Access Module (DMOD) abgerufen wird. (Weitere Informationen finden Sie in den Hinweisen.)

dataru[37]

Segmentzustellungsoption.

Keine Anforderungs-/Antworteinheitssegmente (RU) (0x00)

Bereitstellen von RU-Segmenten (0x01)

dataru[38]

High-Level Language Application Programming Interface (HLLAPI) Sitzungsbezeichner. (Weitere Informationen finden Sie in den Hinweisen.)

Element 2

hdreptr-elteptr-elteptr-elteptr>>
Zeiger auf das nächste Pufferelement (NIL).

hdreptr-elteptr>–>startd
Anfang der Daten in diesem Pufferelement (1).

hdreptr-elteptr>–>endd
Ende der Daten in diesem Pufferelement.

hdreptr-elteptr-trpad>>
Reserviert.

hdreptr-elteptr-dataru>>
Daten-RU, wie folgt:

dataru[0]

ASCII-Zeichenfolge, die den 3270-Emulator identifiziert. (Weitere Informationen finden Sie in den Hinweisen.)

Bemerkungen

• Die Anforderungsnachricht "Open(SSCP)" besteht aus einem Pufferheader und zwei Pufferelementen.

• Der Quell-L-Wert, die LPI-Werte (Locality Partner Index) des Ziels und der Quellname sind reserviert.

• Für einen 3270-Emulator muss der Quell-P-Wert auf S3PROD (0x12) festgelegt werden, wodurch die Anwendung als 3270-Emulator identifiziert wird. Der Zielname sollte auf den LU-Namen oder den Poolnamen festgelegt werden, der aus dem 3270-Benutzerdatensatz stammt (mit ASCII-Leerzeichen gefüllt, wenn weniger als 10 Zeichen vorhanden sind).

• Eine LUA-Anwendung verwendet den Quell-P-Wert LUAPROD (0x1D). Dies ist unabhängig vom Wert des unterstützten LUA-Indikators, der die LUA-Variante des FMI auswählt.

• Die SNS4003 zu SNS4014 Feldern, zusammen mit dem Indikator mit hoher Priorität, werden im Text als SSCP-Verbindungsinformationssteuerungsblock (CICB) bezeichnet. (Weitere Informationen finden Sie unter Öffnen der SSCP-Verbindung.) Ein Wert von 0x00 gibt an, dass die Datenflusssteuerung (Data Flow Control, DFC) eine Überprüfung erhält, die dem Sinnescode entspricht, für diese LU nicht unterstützt wird. Ein Wert von 0x01 gibt an, dass er unterstützt wird. Beachten Sie, dass die entsprechenden Sendeprüfungen unabhängig von diesen Werten immer durchgeführt werden.

• Die LU-Nummer wird nur intern im lokalen Knoten in der Open(SSCP)-Anforderung verwendet. Sie wird aus dem Zielnamen im ersten Element generiert.

• Das Feld für den offenen Erzwingungstyp wird verwendet, wenn Ressourcen über mehrere Server und für die automatische Aktivierung von Verbindungen gefunden werden, wenn die Anwendung eine LU verwenden möchte, für die die Verbindung inaktiv ist. Diese Kennzeichnung muss von der Anwendung nicht festgelegt werden. Sie wird von der DL-BASE verwendet. Ausführliche Informationen finden Sie unter Öffnen der SSCP-Verbindung.

• Das Feld "Anwendungsprogrammschnittstellentyp" definiert, ob RU-Blöcke vom lokalen Knoten in die Anwendung verwendet werden. Dies kann erforderlich sein, wenn große RUs verwendet werden. Weitere Informationen zum FMI-Blocking finden Sie unter Pacing und Chunking.

• Das Feld "Blockgröße" (bei dataru[35]) ist ein ganzzahliger Wert.

• Die Segmentbereitstellungsoption gibt an, ob der lokale Knoten Segmente von RUs an die Anwendung liefern soll, sobald sie empfangen werden oder ganze RUs zusammensetzen sollen, bevor sie an die Anwendung übermittelt werden. Die Segmentbereitstellung ermöglicht es der Anwendung, den Bildschirm des Benutzers zu aktualisieren, sobald Daten empfangen werden, die als Fensterschattierung bezeichnet werden, was zu einer schneller wahrgenommenen Antwort führen kann. Weitere Informationen finden Sie unter Segmentbereitstellung. Diese Option ist nur erforderlich, wenn Blöcke verwendet werden. Sie ist in dieser Meldung enthalten, sodass der lokale Knoten die anfänglichen Blöcke für die entsprechende primäre logische Einheit (PLU)-Verbindung berechnen kann. Die Option muss weiterhin für die Open(PLU)-Antwort festgelegt werden. Die für diese Nachricht angegebene Einstellung überschreibt die hier angegebene Einstellung, wenn ein Konflikt vorliegt. In diesem Fall sind die anfänglichen Kreditwerte möglicherweise nicht geeignet.

• Der unterstützte LUA-Indikator gibt an, ob die Anwendung die LUA-Variante des FMI verwendet.

• Wenn das Element kürzer als (s+34) Bytes ist, geht Microsoft® Host Integration Server davon aus, dass keine LUA und keine Blöcke vorhanden sind. Dadurch wird die Abwärtskompatibilität mit früheren Versionen der lokalen Knotensoftware sichergestellt, in der diese Optionen nicht verfügbar waren.

• Der HLLAPI-Sitzungsbezeichner ist ein einzelnes ASCII-Zeichen, das die 3270-Anzeigesitzung identifiziert, auf die die Open(SSCP) angewendet wird. HLLAPI verwendet dies, um einen bestimmten 3270 Präsentationsbereich zu identifizieren, auf den eine HLLAPI-Funktion verweist. Sie wird auch von 3270 als Kurzname der Sitzung oder von HLLAPI als Präsentationsraumbezeichner (PS-Bezeichner) bezeichnet. Wenn der Emulator 3270 keine Sitzungsbezeichner unterstützt, sollte dieses Feld auf Null festgelegt werden.

• Das zweite Element enthält eine ASCII-Zeichenfolge, mit der Sie den Typ des 3270-Emulators identifizieren können. Diese Zeichenfolge wird in der Überwachungsprotokolldatei von der DL-BASE des Clients protokolliert und kann auch in Ablaufverfolgungen angezeigt werden. Die Anfangs - und Endfelder müssen eingerichtet werden, um die Grenzwerte dieser Zeichenfolge zu definieren.