Open(SSCP) Request
Die Open(SSCP) Request-Nachricht 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;
};
Member
nxtqptr
Zeiger auf den nächsten Pufferheader.
hdrept
Zeiger auf das erste Pufferelement.
numelts
Anzahl der Pufferelemente (0x02).
msgtype
Nachrichtentyp OPENMSG (0x01).
srcl
Quellspeicherort.
srcp
Quellpartner. (Weitere Informationen finden Sie in den Hinweisen.)
srci
Quellindex.
destl
Zielspeicherort.
destp
Zielpartner.
desti
Zielindex.
ophdr.openqual
Öffnen Sie den Qualifizierer REQU (0x01).
ophdr.opentype
Öffnen Sie den Typ SSCPSEC (0x01).
ophdr.appltype
Schnittstellentyp des Anwendungsprogramms.
Funktionsverwaltungsschnittstelle (Function Management Interface, FMI) ohne Blockierung (0x02).
FMI mit Blockierung (0x82). (Weitere Informationen finden Sie in den Hinweisen.)
ophdr.opluno
Nummer der logischen Einheit. (Weitere Informationen finden Sie in den Hinweisen.)
ophdr.opresid
Ressourcenbezeichner.
ophdr.icreditr
Reserviert.
ophdr.icredits
Reserviert.
ophdr.opninfo1
Reserviert.
ophdr.opnpad1
Öffnen Sie den Force-Typ. (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
Start der Daten in diesem Pufferelement (1).
hdreptr–>endd
Ende der Daten in diesem Pufferelement.
hdreptr–>trpad
Reserviert (1 Byte).
hdreptr–>dataru
Datenanforderungs-/Antworteinheit (DATA Request/Response Unit, RU):
dataru[0–9]
Quellname. Sollte mit Leerzeichen gefüllt werden.
dataru[10–19]
Zielname. Legen Sie auf die logische Einheit (LU) fest, mit der Sie kommunizieren möchten.
dataru[20]
Sense 4003-Flag.
dataru[21]
Sense 4004-Flag.
dataru[22]
Sense 4006-Flag.
dataru[23]
Sense 4007-Flag.
dataru[24]
Sense 4009-Flag.
dataru[25]
Sense 400A-Flag.
dataru[26]
Sense 400B-Flag.
dataru[27]
Sense 400C-Flag.
dataru[28]
Sense 400D-Flag.
dataru[29]
Sense 400F-Flag.
dataru[30]
Sense 4011-Flag.
dataru[31]
Sense 4012-Flag.
dataru[32]
Sense 4014-Flag.
dataru[33]
Indikator für hohe Priorität.
HIGH (0x01)
LOW (0x02)
dataru[34]
LuA(Logical Unit Application) unterstützter Indikator.
Unterstützt (0x01)
Nicht unterstützt (0x00)
dataru[35–36]
Blockgröße, die vom DMOD-Modul (Dynamic Access Module) abgerufen wurde. (Weitere Informationen finden Sie in den Hinweisen.)
dataru[37]
Segmentübermittlungsoption.
Ru-Segmente (Request/Response Unit) nicht bereitstellen (0x00)
Bereitstellen von RU-Segmenten (0x01)
dataru[38]
HLLAPI-Sitzungsbezeichner (High-Level Language Application Programming Interface) (Weitere Informationen finden Sie in den Hinweisen.)
Element 2
hdreptr–>elteptr–>elteptr
Zeiger auf das nächste Pufferelement (NIL).
hdreptr–>elteptr–>startd
Start 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 Emulator 3270 identifiziert. (Weitere Informationen finden Sie in den Hinweisen.)
Hinweise
Die Open(SSCP)-Anforderungsnachricht besteht aus einem Pufferheader und zwei Pufferelementen.
Der Quell-L-Wert, die LPI-Werte (Locality Partner Index) des Ziels und der Quellname sind reserviert.
Bei einem 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 poolnamen festgelegt werden, der aus dem 3270-Benutzerdatensatz stammt (rechts 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 LUA-unterstützten Indikators, der die LUA-Variante des FMI auswählt.
Die SNS4003 zu SNS4014 Feldern werden zusammen mit dem Indikator mit hoher Priorität im Text als SSCP-Verbindungsinformationskontrollblock (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. Der Wert 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 für die Open(SSCP)-Anforderung verwendet. Sie wird aus dem Zielnamen im ersten Element generiert.
Das Feld open force type wird beim Suchen von Ressourcen auf mehreren Servern und für die automatische Aktivierung von Verbindungen verwendet, wenn die Anwendung eine LU verwenden möchte, für die die Verbindung inaktiv ist. Die Anwendung muss dieses Flag nicht festlegen. Es wird von der DL-BASE verwendet. Ausführliche Informationen finden Sie unter Öffnen der SSCP-Verbindung.
Das Feld Schnittstellentyp des Anwendungsprogramms definiert, ob RU-Blöcke vom lokalen Knoten zur Anwendung verwendet werden. Dies kann erforderlich sein, wenn große RUs verwendet werden. Weitere Informationen zu FMI-Blöcken finden Sie unter Pacing and Chunking.For more information about FMI chunking, see Pacing and Chunking.
Das Feld "Blockgröße" (bei dataru[35]) ist ein ganzzahliger Wert.
Die Option segment delivery gibt an, ob der lokale Knoten Segmente von RUs an die Anwendung übermitteln soll, sobald sie empfangen werden, oder ob ganze RUs vor der Übermittlung an die Anwendung zusammengesetzt werden soll. 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 schnelleren wahrgenommenen Reaktion führen kann. Weitere Informationen finden Sie unter Segmentübermittlung. Diese Option ist nur erforderlich, wenn Blöcke verwendet werden. Sie ist in dieser Nachricht enthalten, sodass der lokale Knoten die anfänglichen Guthabenwerte für die entsprechende PLU-Verbindung (Primary Logical Unit) 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 Gutschriftenwerte möglicherweise nicht geeignet.
Der LUA-unterstützte 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 von keiner LUA und keine Blockierung aus. Dadurch wird die Abwärtskompatibilität mit früheren Versionen der lokalen Knotensoftware sichergestellt, in denen diese Optionen nicht verfügbar waren.
Der HLLAPI-Sitzungsbezeichner ist ein einzelnes ASCII-Zeichen, das die 3270-Anzeigesitzung angibt, für die open(SSCP) gilt. HLLAPI verwendet dies, um einen bestimmten 3270-Präsentationsraum zu identifizieren, auf den sich eine HLLAPI-Funktion bezieht. Es wird auch von 3270 als kurzer Name der Sitzung oder von HLLAPI als Präsentationsraumbezeichner (PS-Bezeichner) bezeichnet. Wenn der Emulator 3270 keine Sitzungsbezeichner unterstützt, sollte dieses Feld auf 0 festgelegt werden.
Das zweite Element enthält eine ASCII-Zeichenfolge, mit der Sie den Typ des Emulators 3270 identifizieren können. Diese Zeichenfolge wird in der Überwachungsprotokolldatei von der DL-BASE des Clients protokolliert und kann auch in Ablaufverfolgungen angezeigt werden. Die gestarteten und enden Felder müssen eingerichtet werden, um die Grenzwerte dieser Zeichenfolge zu definieren.