Open(SSCP) Request
The Open(SSCP) Request message flows from the application to the node. It is used with an SSCP connection.
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;
};
Element 1
struct Open(SSCP) Request {
PTRBFELT hdreptr->elteptr;
INTEGER hdreptr->startd;
INTEGER hdreptr->endd;
CHAR hdreptr->trpad;
CHAR[268] hdreptr->dataru;
};
Element 2
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;
};
Members
-
nxtqptr
-
Pointer to next buffer header.
-
hdrept
-
Pointer to first buffer element.
-
numelts
-
Number of buffer elements (0x02).
-
msgtype
-
Message type OPENMSG (0x01).
-
srcl
-
Source locality.
-
srcp
-
Source partner (see Remarks).
-
srci
-
Source index.
-
destl
-
Destination locality.
-
destp
-
Destination partner.
-
desti
-
Destination index.
-
ophdr.openqual
-
Open qualifier REQU (0x01).
-
ophdr.opentype
-
Open type SSCPSEC (0x01).
-
ophdr.appltype
-
Application program interface type
FMI without chunking (0x02)
FMI with chunking (0x82) (see Remarks).
-
ophdr.opluno
-
Logical unit number (see Remarks).
-
ophdr.opresid
-
Resource identifier.
-
ophdr.icreditr
-
Reserved.
-
ophdr.icredits
-
Reserved.
-
ophdr.opninfo1
-
Reserved.
-
ophdr.opnpad1
-
Open force type (see Remarks)
OPEN_TEST (0x00)
OPEN_FORCE (0x01)
Element 1
-
hdreptr–>elteptr
-
Pointer to next buffer element.
-
hdreptr–>startd
-
Start of data in this buffer element (1).
-
hdreptr–>endd
-
End of data in this buffer element.
-
hdreptr–>trpad
-
Reserved (1 byte).
-
hdreptr–>dataru
-
Data RU, as follows:
-
dataru[0–9]
-
Source name. Should be filled with blanks.
-
dataru[10–19]
-
Destination name. Set to the LU you want to communicate with.
-
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]
-
High priority indicator
HIGH (0x01)
LOW (0x02)
-
dataru[34]
-
LUA supported indicator
Supported (0x01)
Not supported (0x00)
-
dataru[35–36]
-
Chunk size obtained from DMOD (see Remarks).
-
dataru[37]
-
Segment delivery option
Do not deliver RU segments (0x00)
Deliver RU segments (0x01)
-
dataru[38]
-
HLLAPI session identifier (see Remarks).
Element 2
-
hdreptr–>elteptr–>elteptr
-
Pointer to next buffer element (NIL).
-
hdreptr–>elteptr–>startd
-
Start of data in this buffer element (1).
-
hdreptr–>elteptr–>endd
-
End of data in this buffer element.
-
hdreptr–>elteptr–>trpad
-
Reserved.
-
hdreptr–>elteptr–>dataru
-
Data RU, as follows:
-
dataru[0]
-
ASCII string identifying the 3270 emulator (see Remarks).
Remarks
-
The Open(SSCP) Request message consists of a buffer header and two buffer elements.
-
The source L value, the destination LPI values, and the source name are reserved.
-
For a 3270 emulator, the source P value must be set to S3PROD (0x12), which identifies the application as a 3270 emulator. The destination name should be set to the LU name or pool name taken from the 3270 user record (right-filled with ASCII spaces if fewer than 10 characters).
-
An LUA application uses the source P value LUAPROD (0x1D). This is independent of the value of the LUA supported indicator (see below), which selects the LUA variant of the FMI.
-
The SNS4003 to SNS4014 fields together with the high priority indicator are referred to in the text (see Opening the SSCP Connection) as the SSCP connection information control block (CICB). A value of 0x00 indicates that the DFC receive check corresponding to the sense code is not supported for this LU. A value of 0x01 indicates that it is supported. Note that the corresponding send checks are always performed regardless of these values.
-
The LU number is only used internally in the local node on the Open(SSCP) Request. It is generated from the destination name in the first element.
-
The open force type field is used when locating resources across more than one server and for automatic activation of connections when the application wishes to use an LU for which the connection is inactive. The application does not need to set this flag; it is used by the DL-BASE. See Opening the SSCP Connection for details.
-
The application program interface type field defines whether RU chunking is used from the local node to the application; this may be necessary if large RUs are being used. See Pacing and Chunking for more information on FMI chunking. This feature is not yet supported in SNA Server but is described here for completeness because support is planned for a future version.
-
The chunk size field (at dataru[35]) is an integer value.
-
The segment delivery option specifies whether the local node should deliver segments of RUs to the application as soon as they are received or should assemble whole RUs before delivering them to the application. Segment delivery allows the application to update the user's screen as soon as data is received ("window shading"), which can result in a faster perceived response. See Segment Delivery for more information. This option is required only when chunking is being used; it is included on this message so that the local node can calculate the initial chunk credit values on the corresponding PLU connection. The option must still be set on the Open(PLU) Response; the setting specified on that message will override the one specified here if there is a conflict. If this happens, the initial credit values may not be suitable.
-
The LUA supported indicator specifies whether the application uses the LUA variant of the FMI.
-
If the element is shorter than (s+34) bytes, SNA Server assumes no LUA and no chunking. This ensures backward compatibility with previous versions of the local node software in which these options were not available.
-
The HLLAPI session identifier is a single ASCII character that identifies the 3270 display session to which the Open(SSCP) applies. HLLAPI uses this to identify a particular 3270 presentation space to which an HLLAPI function refers; it is also referred to by 3270 as the session's short name, or by HLLAPI as the presentation space identifier (PS identifier). If the 3270 emulator does not support session identifiers, this field should be set to zero.
-
The second element contains an ASCII string that you can use to identify the type of 3270 emulator, such as "Select SNA Server OS/2 3270." This string will be logged in the audit log file by the client's DL-BASE and can also be seen in traces. The startd and endd fields must be set up to define the limits of this string.