RFC1205 日本語訳
1205 5250 Telnet interface. P. Chmielewski. February 1991. (Format: TXT=27179 bytes) (Updated by RFC2877) (Status: INFORMATIONAL)
プログラムでの自動翻訳です。
RFC一覧
英語原文
Network Working Group P. Chmielewski
Request for Comments: 1205 IBM Corporation
February 1991
Network Working Group P. Chmielewski Request for Comments: 1205 IBM Corporation February 1991
5250 Telnet Interface
5250 Telnet Interface
Status of this Memo
Status of this Memo
This RFC is being distributed in order to document the interface to the IBM 5250 Telnet implementation. This information is being provided for hosts on the Internet that want to support the 5250 work station data stream within the Telnet protocol. This memo provides information for the Internet community. It does not specify any standard. Distribution of this memo is unlimited.
This RFC is being distributed in order to document the interface to the IBM 5250 Telnet implementation. This information is being provided for hosts on the Internet that want to support the 5250 work station data stream within the Telnet protocol. This memo provides information for the Internet community. It does not specify any standard. Distribution of this memo is unlimited.
1. Introduction
1. Introduction
This RFC describes the interface to the IBM 5250 Telnet implementation. The purpose of this memo is to describe the details of the interface so that a person wanting to implement a client Telnet which emulates an IBM 5250 work station would be able to do so. This memo does not describe all of the 5250 commands, aid codes, and other information specific to the 5250 data stream. That information is contained in the IBM 5250 Information Display System, Functions Reference Manual, IBM publication number SA21-9247. Corrections and additions to this manual are documented in this RFC in section 5.
This RFC describes the interface to the IBM 5250 Telnet implementation. The purpose of this memo is to describe the details of the interface so that a person wanting to implement a client Telnet which emulates an IBM 5250 work station would be able to do so. This memo does not describe all of the 5250 commands, aid codes, and other information specific to the 5250 data stream. That information is contained in the IBM 5250 Information Display System, Functions Reference Manual, IBM publication number SA21-9247. Corrections and additions to this manual are documented in this RFC in section 5.
2. Telnet Options
2. Telnet Options
No new Telnet options are defined for 5250 mode of operation. However, to enable 5250 mode, both the client and server must agree to at least support the Binary, End-Of-Record (EOR), and Terminal- Type Telnet options. The complete list of 5250 terminal types is maintained in the Assigned Numbers RFC and includes the following:
No new Telnet options are defined for 5250 mode of operation. However, to enable 5250 mode, both the client and server must agree to at least support the Binary, End-Of-Record (EOR), and Terminal- Type Telnet options. The complete list of 5250 terminal types is maintained in the Assigned Numbers RFC and includes the following:
IBM-5555-C01 24 x 80 Double-Byte Character Set color display
IBM-5555-B01 24 x 80 Double-Byte Character Set (DBCS)
IBM-3477-FC 27 x 132 color display
IBM-3477-FG 27 x 132 monochrome display
IBM-3180-2 27 x 132 monochrome display
IBM-3179-2 24 x 80 color display
IBM-3196-A1 24 x 80 monochrome display
IBM-5292-2 24 x 80 color display
IBM-5291-1 24 x 80 monochrome display
IBM-5251-11 24 x 80 monochrome display
IBM-5555-C01 24 x 80 Double-Byte Character Set color display IBM-5555-B01 24 x 80 Double-Byte Character Set (DBCS) IBM-3477-FC 27 x 132 color display IBM-3477-FG 27 x 132 monochrome display IBM-3180-2 27 x 132 monochrome display IBM-3179-2 24 x 80 color display IBM-3196-A1 24 x 80 monochrome display IBM-5292-2 24 x 80 color display IBM-5291-1 24 x 80 monochrome display IBM-5251-11 24 x 80 monochrome display
Chmielewski [Page 1] RFC 1205 5250 Telnet Interface February 1991
Chmielewski [Page 1] RFC 1205 5250 Telnet Interface February 1991
An example of a typical negotiation process to establish 5250 mode of operation is shown below. In this example, the server initiates the negotiation by sending the DO TERMINAL-TYPE request.
An example of a typical negotiation process to establish 5250 mode of operation is shown below. In this example, the server initiates the negotiation by sending the DO TERMINAL-TYPE request.
Server: IAC DO TERMINAL-TYPE
Client: IAC WILL TERMINAL-TYPE
Server: IAC SB TERMINAL-TYPE SEND IAC SE
Client: IAC SB TERMINAL-TYPE IS IBM-5251-11 IAC SE
(The client has specified its terminal-type is an IBM-5251-11)
Server: IAC DO TERMINAL-TYPE Client: IAC WILL TERMINAL-TYPE Server: IAC SB TERMINAL-TYPE SEND IAC SE Client: IAC SB TERMINAL-TYPE IS IBM-5251-11 IAC SE (The client has specified its terminal-type is an IBM-5251-11)
Server: IAC DO END-OF-RECORD
Client: IAC WILL END-OF-RECORD
Server: IAC WILL END-OF-RECORD
Client: IAC DO END-OF-RECORD
(The server and client have both agreed to transmit EORs)
Server: IAC DO END-OF-RECORD Client: IAC WILL END-OF-RECORD Server: IAC WILL END-OF-RECORD Client: IAC DO END-OF-RECORD (The server and client have both agreed to transmit EORs)
Server: IAC DO TRANSMIT-BINARY
Client: IAC WILL TRANSMIT-BINARY
Server: IAC WILL TRANSMIT-BINARY
Client: IAC DO TRANSMIT-BINARY
(The server and client have both agreed to binary transmission)
Server: IAC DO TRANSMIT-BINARY Client: IAC WILL TRANSMIT-BINARY Server: IAC WILL TRANSMIT-BINARY Client: IAC DO TRANSMIT-BINARY (The server and client have both agreed to binary transmission)
3. Data Stream Format
3. Data Stream Format
The actual data stream that is exchanged between the client and server is composed of a header followed by the 5250 work station data stream. For information about the 5250 work station data stream refer to the IBM 5250 Information Display System, Functions Reference Manual (SA21-9247). The header which prefixes the 5250 data stream was originally designed for the 5250 Display Station Pass-Through (DSPT) application. 5250 DSPT is an application similar to Telnet which runs on the IBM AS/400, System/36, and System/38 over an SNA network. This header is designed to be variable in length and is composed of two parts. The first, fixed part is always 6 octets long and has the following format:
The actual data stream that is exchanged between the client and server is composed of a header followed by the 5250 work station data stream. For information about the 5250 work station data stream refer to the IBM 5250 Information Display System, Functions Reference Manual (SA21-9247). The header which prefixes the 5250 data stream was originally designed for the 5250 Display Station Pass-Through (DSPT) application. 5250 DSPT is an application similar to Telnet which runs on the IBM AS/400, System/36, and System/38 over an SNA network. This header is designed to be variable in length and is composed of two parts. The first, fixed part is always 6 octets long and has the following format:
0 1 2 3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Logical Record Length | Record Type |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Reserved |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Logical Record Length | Record Type | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Reserved | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Logical Record Length: 16 bits
Logical Record Length: 16 bits
This field indicates the length, in octets, of this logical record
including the header length. The length is calculated BEFORE
This field indicates the length, in octets, of this logical record including the header length. The length is calculated BEFORE
Chmielewski [Page 2] RFC 1205 5250 Telnet Interface February 1991
Chmielewski [Page 2] RFC 1205 5250 Telnet Interface February 1991
doubling any IAC characters in the data stream. The length does
not include the <IAC><EOR> that is appended to the end of the data
stream to mark the end of this logical record. The length is
specified with the most significant octet first. For example, a
length of 36 (decimal) would be specified as '0024'X.
doubling any IAC characters in the data stream. The length does not include the <IAC><EOR> that is appended to the end of the data stream to mark the end of this logical record. The length is specified with the most significant octet first. For example, a length of 36 (decimal) would be specified as '0024'X.
Record Type: 16 bits
Record Type: 16 bits
This field indicates the SNA record type. It should always be set
to '12A0'X to indicate the General Data Stream (GDS) record type.
This field indicates the SNA record type. It should always be set to '12A0'X to indicate the General Data Stream (GDS) record type.
Reserved: 16 bits
Reserved: 16 bits
This field is currently not used.
This field is currently not used.
The second part of the header is designed to be variable in length. The length of this variable part is specified in the first octet. Currently this portion of the header will always be 4 octets long and has the following format:
The second part of the header is designed to be variable in length. The length of this variable part is specified in the first octet. Currently this portion of the header will always be 4 octets long and has the following format:
0 1 2 3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| |E|A| | | |S|T|H| | |
| Var Hdr Len |R|T| | | |R|R|L| | Opcode |
| |R|N| | | |Q|Q|P| | |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | |E|A| | | |S|T|H| | | | Var Hdr Len |R|T| | | |R|R|L| | Opcode | | |R|N| | | |Q|Q|P| | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Var Hdr Len: 8 bits
Var Hdr Len: 8 bits
The length, in octets, of the variable portion of the header.
Currently this is always '04'X.
The length, in octets, of the variable portion of the header. Currently this is always '04'X.
Flags: 16 bits
Flags: 16 bits
Bit 0: ERR This bit is set to indicate a data stream
output error. The negative response code
is sent as data following the opcode field.
Bit 1: ATN This bit is set to indicate that the 5250
attention key was pressed.
Bits 2-4: * These bits are reserved (set to zero).
Bit 5: SRQ This bit is set to indicate that the 5250
System Request key was pressed.
Bit 6: TRQ This bit is set to indicate that the 5250
Test Request key was pressed.
Bit 7: HLP This bit is set to indicate the Help in
Error State function. The error code is
sent as data following the header and is
Bit 0: ERR This bit is set to indicate a data stream output error. The negative response code is sent as data following the opcode field. Bit 1: ATN This bit is set to indicate that the 5250 attention key was pressed. Bits 2-4: * These bits are reserved (set to zero). Bit 5: SRQ This bit is set to indicate that the 5250 System Request key was pressed. Bit 6: TRQ This bit is set to indicate that the 5250 Test Request key was pressed. Bit 7: HLP This bit is set to indicate the Help in Error State function. The error code is sent as data following the header and is
Chmielewski [Page 3] RFC 1205 5250 Telnet Interface February 1991
Chmielewski [Page 3] RFC 1205 5250 Telnet Interface February 1991
a four digit packed decimal number. For
example, an error code of '0005'X indicates
the operator attempted to type in an area of
the display that is not enabled for input.
Bits 8-15: * These bits are reserved (set to zero).
a four digit packed decimal number. For example, an error code of '0005'X indicates the operator attempted to type in an area of the display that is not enabled for input. Bits 8-15: * These bits are reserved (set to zero).
Opcode: 8 bits
Opcode: 8 bits
This field contains the operation code. It is set to indicate the
type of operation requested by the sender. The following are the
valid values:
This field contains the operation code. It is set to indicate the type of operation requested by the sender. The following are the valid values:
'00'X: No Operation
'01'X: Invite Operation
'02'X: Output Only
'03'X: Put/Get Operation
'04'X: Save Screen Operation
'05'X: Restore Screen Operation
'06'X: Read Immediate Operation
'07'X: Reserved
'08'X: Read Screen Operation
'09'X: Reserved
'0A'X: Cancel Invite Operation
'0B'X: Turn On Message Light
'0C'X: Turn Off Message Light
'00'X: No Operation '01'X: Invite Operation '02'X: Output Only '03'X: Put/Get Operation '04'X: Save Screen Operation '05'X: Restore Screen Operation '06'X: Read Immediate Operation '07'X: Reserved '08'X: Read Screen Operation '09'X: Reserved '0A'X: Cancel Invite Operation '0B'X: Turn On Message Light '0C'X: Turn Off Message Light
The actual 5250 work station data stream will immediately follow the opcode field in the header and will be terminated by the <IAC><EOR> pair. For some operations the header will be immediately followed by an <IAC><EOR> without any 5250 work station data stream in between. For example, the following request to turn on the message light could be sent by the server:
The actual 5250 work station data stream will immediately follow the opcode field in the header and will be terminated by the <IAC><EOR> pair. For some operations the header will be immediately followed by an <IAC><EOR> without any 5250 work station data stream in between. For example, the following request to turn on the message light could be sent by the server:
000A 12A0 0000 0400 000B FFEF
| | | | | | |
| | | | | | End Of Record marker
| | | | | |
| | | | | Opcode = Turn On Message Light ('0B'X)
| | | | |
| | | | Flags = '0000'X
| | | |
| | | Variable Header Length = '04'X
| | |
| | Reserved - Set to '0000'X
| |
| Record Type = General Data Stream ('12A0'X)
|
Logical Record Length = '000A'X for this record
000A 12A0 0000 0400 000B FFEF | | | | | | | | | | | | | End Of Record marker | | | | | | | | | | | Opcode = Turn On Message Light ('0B'X) | | | | | | | | | Flags = '0000'X | | | | | | | Variable Header Length = '04'X | | | | | Reserved - Set to '0000'X | | | Record Type = General Data Stream ('12A0'X) | Logical Record Length = '000A'X for this record
Chmielewski [Page 4] RFC 1205 5250 Telnet Interface February 1991
Chmielewski [Page 4] RFC 1205 5250 Telnet Interface February 1991
In this example the requested operation is indicated by the opcode and there is no associated work station data stream.
In this example the requested operation is indicated by the opcode and there is no associated work station data stream.
4. Data Flow Examples
4. Data Flow Examples
The following examples illustrate the flow of data between the client and server for some of the more common operations. These examples are intended to show the order in which the logical records are sent between the client and server and the content of those records. The hex representation of the records which are exchanged between the client and server is shown. The way in which a client implements the various operations will differ between implementations and those details are not discussed here. In these examples, when the value of a field is dependent on the length of the screen data for a particular logical record, it will be represented as 'LLLL'.
The following examples illustrate the flow of data between the client and server for some of the more common operations. These examples are intended to show the order in which the logical records are sent between the client and server and the content of those records. The hex representation of the records which are exchanged between the client and server is shown. The way in which a client implements the various operations will differ between implementations and those details are not discussed here. In these examples, when the value of a field is dependent on the length of the screen data for a particular logical record, it will be represented as 'LLLL'.
4.1 Query Device Example
4.1 Query Device Example
A Query command may be sent by the server system in order to determine the attributes of the device it is talking to. When a client receives a Query command, it must send the Query Reply back to the server. See section 5 for a complete description of the format for the Query command and Query Reply.
A Query command may be sent by the server system in order to determine the attributes of the device it is talking to. When a client receives a Query command, it must send the Query Reply back to the server. See section 5 for a complete description of the format for the Query command and Query Reply.
Server: Sends Write Structured 001112A0 00000400 000304F3 0005D970
Field Query command. 00FFEF
Server: Sends Write Structured 001112A0 00000400 000304F3 0005D970 Field Query command. 00FFEF
Client: Responds with a Query 004712A0 00000400 00000000 88003AD9
Reply, in this case, 70800600 01030000 00000000 00000000
for a 3180-2. 00000000 00000001 F3F1F8F0 F0F0F202
00000061 50000100 00000018 11000000
00000000 000000FF EF
Client: Responds with a Query 004712A0 00000400 00000000 88003AD9 Reply, in this case, 70800600 01030000 00000000 00000000 for a 3180-2. 00000000 00000001 F3F1F8F0 F0F0F202 00000061 50000100 00000018 11000000 00000000 000000FF EF
4.2 Cancel Invite Example
4.2 Cancel Invite Example
The server will send a Cancel Invite when it needs to reverse the normal flow direction. When a client receives a Cancel Invite, it should reply with a Cancel Invite and not send any user data until the server has once again "invited" the work station. A work station is said to be "invited" when the server has sent a read command to the client. The Cancel Invite flow is as follows:
The server will send a Cancel Invite when it needs to reverse the normal flow direction. When a client receives a Cancel Invite, it should reply with a Cancel Invite and not send any user data until the server has once again "invited" the work station. A work station is said to be "invited" when the server has sent a read command to the client. The Cancel Invite flow is as follows:
Server: Sends header with the 000A12A0 00000400 000AFFEF
Opcode = Cancel Invite.
Server: Sends header with the 000A12A0 00000400 000AFFEF Opcode = Cancel Invite.
Client: Sends header with the 000A12A0 00000400 000AFFEF
Opcode = Cancel Invite
Client: Sends header with the 000A12A0 00000400 000AFFEF Opcode = Cancel Invite
Chmielewski [Page 5] RFC 1205 5250 Telnet Interface February 1991
Chmielewski [Page 5] RFC 1205 5250 Telnet Interface February 1991
to indicate that the
work station is no
longer invited.
to indicate that the work station is no longer invited.
4.3 System Request Example
4.3 System Request Example
The 5250 System Request operation is invoked when a client wants to interrupt the server job to perform some function. The typical scenario would be for a user to press the system request key, or whatever key is mapped to a system request key, which would cause the client Telnet to initiate the following flow:
The 5250 System Request operation is invoked when a client wants to interrupt the server job to perform some function. The typical scenario would be for a user to press the system request key, or whatever key is mapped to a system request key, which would cause the client Telnet to initiate the following flow:
Client: Sends header with the 000A12A0 00000404 0000FFEF
System Request bit set.
Client: Sends header with the 000A12A0 00000404 0000FFEF System Request bit set.
Note: It is possible for a client to include user data in this record following the header. This data would be interpreted by the server as an option to be selected from the system request menu. If this were the case, the server would not send the system request menu and the flow would continue based on the option selected. For this example, the client does not send any user data and the flow would continue as follows:
Note: It is possible for a client to include user data in this record following the header. This data would be interpreted by the server as an option to be selected from the system request menu. If this were the case, the server would not send the system request menu and the flow would continue based on the option selected. For this example, the client does not send any user data and the flow would continue as follows:
Server: Sends header with the 000A12A0 00000400 000AFFEF
Opcode = Cancel Invite.
Server: Sends header with the 000A12A0 00000400 000AFFEF Opcode = Cancel Invite.
Client: Sends header with the 000A12A0 00000400 000AFFEF
Opcode = Cancel Invite
to indicate that the
work station is no
longer invited.
Client: Sends header with the 000A12A0 00000400 000AFFEF Opcode = Cancel Invite to indicate that the work station is no longer invited.
Server: Sends Save (Immediate) 000C12A0 00000400 00040402 FFEF
command with
Opcode = Save Screen.
Server: Sends Save (Immediate) 000C12A0 00000400 00040402 FFEF command with Opcode = Save Screen.
Client: Sends the screen image LLLL12A0 00000400 00040412
to be saved. <Screen Image> FFEF
Client: Sends the screen image LLLL12A0 00000400 00040412 to be saved. <Screen Image> FFEF
Server: Sends System Request LLLL12A0 00000400 0003
menu with <System Request Menu> FFEF
Opcode = Put/Get.
Server: Sends System Request LLLL12A0 00000400 0003 menu with <System Request Menu> FFEF Opcode = Put/Get.
Client: Sends User Input to LLLL12A0 00000400 0000
the Sys Req menu. <User Input> FFEF
Client: Sends User Input to LLLL12A0 00000400 0000 the Sys Req menu. <User Input> FFEF
Note: What happens next will depend on the System Request option selected by the user. After any System Request processing has
Note: What happens next will depend on the System Request option selected by the user. After any System Request processing has
Chmielewski [Page 6] RFC 1205 5250 Telnet Interface February 1991
Chmielewski [Page 6] RFC 1205 5250 Telnet Interface February 1991
completed, the server will continue with the following restore operation:
completed, the server will continue with the following restore operation:
Server: Sends the saved LLLL12A0 00000400 00050412
screen to be restored, <Saved Screen> FFEF
Opcode = Restore Screen.
Server: Sends the saved LLLL12A0 00000400 00050412 screen to be restored, <Saved Screen> FFEF Opcode = Restore Screen.
(No reply is necessary from the client)
(No reply is necessary from the client)
Server: Sends Read Modified 000E12A0 00000400 00010452 0000FFEF
Data Tag (MDT) command,
opcode = Invite.
Server: Sends Read Modified 000E12A0 00000400 00010452 0000FFEF Data Tag (MDT) command, opcode = Invite.
At this point the client would "invite" the workstation and enter the state that it was in prior to the System Request key being hit.
At this point the client would "invite" the workstation and enter the state that it was in prior to the System Request key being hit.
5. 5250 Data Stream Enhancements
5. 5250 Data Stream Enhancements
This section is intended to be used as an addendum to the IBM 5250 Information Display System, Functions Reference Manual. Described here are enhancements to the 5250 data stream which are not yet documented in the current version of that manual. The current version of that manual at the time of this writing has the IBM publication number SA21-9247-6. Also described in this section are corrections to erroneous information contained in SA21-9247-6. Listed below are the specific corrections and enhancements, with an approximate page number reference to the above manual.
This section is intended to be used as an addendum to the IBM 5250 Information Display System, Functions Reference Manual. Described here are enhancements to the 5250 data stream which are not yet documented in the current version of that manual. The current version of that manual at the time of this writing has the IBM publication number SA21-9247-6. Also described in this section are corrections to erroneous information contained in SA21-9247-6. Listed below are the specific corrections and enhancements, with an approximate page number reference to the above manual.
5.1 Errors or Inconsistencies in SA21-9247-6
5.1 Errors or Inconsistencies in SA21-9247-6
The Insert Cursor (IC) order on pages 2-136 and 2-137 is incorrectly listed with a value of Hex 03; the correct value is Hex 13.
The Insert Cursor (IC) order on pages 2-136 and 2-137 is incorrectly listed with a value of Hex 03; the correct value is Hex 13.
On page 2-137, the listed "Restrictions" for the Insert Cursor, Repeat to Address, and Set Buffer Address orders should be updated to describe how Row and Column values must be valid for the current display screen size (either 24 x 80 or 27 x 132).
On page 2-137, the listed "Restrictions" for the Insert Cursor, Repeat to Address, and Set Buffer Address orders should be updated to describe how Row and Column values must be valid for the current display screen size (either 24 x 80 or 27 x 132).
5.2 Enhancements to Existing 5250 Data Stream Commands/Orders
5.2 Enhancements to Existing 5250 Data Stream Commands/Orders
A new flag is added to the second byte of the Control Character on page 2-40. This flag is used to specify whether the cursor should be moved or not moved at the end of the Write to Display processing. Bit 1 of the second byte, which was previously reserved, will now be used for this flag. If bit 1 is a 0, the cursor continues to be moved to the system IC address on a Lock-to-Unlock keyboard transition. If bit 1 is a 1, the cursor is not moved.
A new flag is added to the second byte of the Control Character on page 2-40. This flag is used to specify whether the cursor should be moved or not moved at the end of the Write to Display processing. Bit 1 of the second byte, which was previously reserved, will now be used for this flag. If bit 1 is a 0, the cursor continues to be moved to the system IC address on a Lock-to-Unlock keyboard transition. If bit 1 is a 1, the cursor is not moved.
Chmielewski [Page 7] RFC 1205 5250 Telnet Interface February 1991
Chmielewski [Page 7] RFC 1205 5250 Telnet Interface February 1991
A new Field Control Word (FCW) will be added on page 2-65 to indicate an entry field contains transparent data. This means the entry field contents are sent from the display screen directly to the host at read time with no formatting. Therefore, an entry field can contain any values (Hex 00 to Hex FF). A transparent field is indicated by a Hex 84xx FCW, where xx is any value. Note: unpredictable results will occur if a field is defined as both signed numeric and a transparent field.
A new Field Control Word (FCW) will be added on page 2-65 to indicate an entry field contains transparent data. This means the entry field contents are sent from the display screen directly to the host at read time with no formatting. Therefore, an entry field can contain any values (Hex 00 to Hex FF). A transparent field is indicated by a Hex 84xx FCW, where xx is any value. Note: unpredictable results will occur if a field is defined as both signed numeric and a transparent field.
The Read Immediate, Read Input Fields, and Read MDT Fields commands have been enhanced to include support for transparent fields (page 2-5). If a transparent FCW is found for an input field, the field data is not formatted (for example, nulls are not converted to blanks).
The Read Immediate, Read Input Fields, and Read MDT Fields commands have been enhanced to include support for transparent fields (page 2-5). If a transparent FCW is found for an input field, the field data is not formatted (for example, nulls are not converted to blanks).
The restriction listed for the Set Buffer Address (SBA) order (page 2-138) on the column address equal to zero is no longer always the case. A reference to Start of Field (SF) row 1/column 1 field support should be made. A note should be added in SF to describe Row 1/Column 1 field support. A Row 1/Column 1 field is defined by a SBA of row 1/column 0, followed by an SF. For a Row 1/Column 1 input field, the first input-capable position is row 1/column 1. If the SF defines an input field, the screen attribute is not allowed to be nondisplay. Writing of the screen attribute is suppressed for a Row 1/Column 1 field and the attribute discarded.
The restriction listed for the Set Buffer Address (SBA) order (page 2-138) on the column address equal to zero is no longer always the case. A reference to Start of Field (SF) row 1/column 1 field support should be made. A note should be added in SF to describe Row 1/Column 1 field support. A Row 1/Column 1 field is defined by a SBA of row 1/column 0, followed by an SF. For a Row 1/Column 1 input field, the first input-capable position is row 1/column 1. If the SF defines an input field, the screen attribute is not allowed to be nondisplay. Writing of the screen attribute is suppressed for a Row 1/Column 1 field and the attribute discarded.
5.3 New 5250 Data Stream Commands/Orders
5.3 New 5250 Data Stream Commands/Orders
The Read MDT Fields Alternate input command has been added. It is the same as the Read MDT Fields command except:
The Read MDT Fields Alternate input command has been added. It is the same as the Read MDT Fields command except:
- The command is indicated by a X'82'
- Leading and embedded nulls within the field remain as nulls
- The command is indicated by a X'82' - Leading and embedded nulls within the field remain as nulls
The Read MDT Fields Immediate Alternate input command has been added. It is the same as the Read MDT Fields Alternate command except:
The Read MDT Fields Immediate Alternate input command has been added. It is the same as the Read MDT Fields Alternate command except:
- The command is indicated by a X'83'
- The command is an immediate read command like Read Immediate;
therefore, no control characters follow the command byte,
field data is returned immediately, and the aid code is X'00'.
- The command is indicated by a X'83' - The command is an immediate read command like Read Immediate; therefore, no control characters follow the command byte, field data is returned immediately, and the aid code is X'00'.
The Move Cursor order (MC) has been added (page 2-137). The MC order moves the cursor to the location specified by the two bytes following the order. Byte 1 gives the row address and byte 2 gives the column address. The MC order is useful when the cursor is to be moved without affecting the system IC address. The MC order is unaffected by the Write to Display control character values including the "Leave
The Move Cursor order (MC) has been added (page 2-137). The MC order moves the cursor to the location specified by the two bytes following the order. Byte 1 gives the row address and byte 2 gives the column address. The MC order is useful when the cursor is to be moved without affecting the system IC address. The MC order is unaffected by the Write to Display control character values including the "Leave
Chmielewski [Page 8] RFC 1205 5250 Telnet Interface February 1991
Chmielewski [Page 8] RFC 1205 5250 Telnet Interface February 1991
Cursor" flag (CC1 bit 1). If more than one MC or IC are found in the data stream, the cursor will move to the address specified in the last MC or IC.
Cursor" flag (CC1 bit 1). If more than one MC or IC are found in the data stream, the cursor will move to the address specified in the last MC or IC.
Restrictions:
Restrictions:
A parameter error will be posted when:
- There are fewer then two bytes following the order.
- The row address is zero or greater than the number of
rows on the display screen.
- The column address is zero or greater than the number of
columns on the display screen.
A parameter error will be posted when: - There are fewer then two bytes following the order. - The row address is zero or greater than the number of rows on the display screen. - The column address is zero or greater than the number of columns on the display screen.
Format:
Format:
Move Cursor Order Byte 1 Byte 2
Move Cursor Order Byte 1 Byte 2
X'14' Row Address Column Address
X'14' Row Address Column Address
Results:
Results:
The address specified by the MC order is used to move the
cursor when the Write to Display is completed.
The address specified by the MC order is used to move the cursor when the Write to Display is completed.
The Transparent Data order (TD) has been added (page 2-137). The TD order is followed by two length bytes and transparent data. The transparent data is written to the display screen at the current display address; any values (Hex 00 to Hex FF) are allowed in the transparent data. All length values are valid as long as the end of the display screen is not overwritten.
The Transparent Data order (TD) has been added (page 2-137). The TD order is followed by two length bytes and transparent data. The transparent data is written to the display screen at the current display address; any values (Hex 00 to Hex FF) are allowed in the transparent data. All length values are valid as long as the end of the display screen is not overwritten.
Restrictions:
Restrictions:
A parameter error will be posted when:
- There are fewer then two bytes following the order.
- There are fewer bytes in the data stream then specified in the
length field.
- Attempting to write beyond the end of the display screen.
A parameter error will be posted when: - There are fewer then two bytes following the order. - There are fewer bytes in the data stream then specified in the length field. - Attempting to write beyond the end of the display screen.
Format:
Format:
TD Order Bytes 1 and 2 Bytes 3 to ?
TD Order Bytes 1 and 2 Bytes 3 to ?
X'10' Length of transparent Transparent data
data (not counting
length bytes)
X'10' Length of transparent Transparent data data (not counting length bytes)
Chmielewski [Page 9] RFC 1205 5250 Telnet Interface February 1991
Chmielewski [Page 9] RFC 1205 5250 Telnet Interface February 1991
Results:
The transparent data is written to the display.
Results: The transparent data is written to the display.
The Query command is a new input command (page 2-5) and is used by the server to obtain information on the functional capabilities of the client 5250 display. When the client receives a Query command, the client sends a Query Reply describing its capabilities back to the server.
The Query command is a new input command (page 2-5) and is used by the server to obtain information on the functional capabilities of the client 5250 display. When the client receives a Query command, the client sends a Query Reply describing its capabilities back to the server.
The Query command must follow an Escape ('04'X) and Write Structured
Field command ('F3'X). The format of the Query command is as
follows:
The Query command must follow an Escape ('04'X) and Write Structured Field command ('F3'X). The format of the Query command is as follows:
Byte Value Description
====== ======= ========================
0-1 X'0005' Length of command
2 X'D9' Command Class
3 X'70' Command Type - Query
4 X'00' Flag Byte
Bit 0: B'0' - Query Command
Bit 1-7: - Reserved (set to zero)
Byte Value Description ====== ======= ======================== 0-1 X'0005' Length of command 2 X'D9' Command Class 3 X'70' Command Type - Query 4 X'00' Flag Byte Bit 0: B'0' - Query Command Bit 1-7: - Reserved (set to zero)
The format of the Query Reply is as follows:
The format of the Query Reply is as follows:
Byte Value Description
===== ======== ===================================
0-1 X'0000' Cursor Row/Column (set to zero)
2 X'88' Inbound Write Structured Field Aid
3-4 X'003A' Length of Query Reply
5 X'D9' Command Class
6 X'70' Command Type - Query
7 X'80' Flag Byte
Bit 0: B'1' - Query Reply
Bit 1-7: - Reserved (set to zero)
8-9 Controller Hardware Class
X'0001' - Local Twinax Controller
X'0061' - Local ASCII Controller
X'0101' - SDLC/X.21/X.25 Twinax Controller
(5394 emulating a 5294)
X'0103' - SDLC/X.21/X.25 Twinax Controller (5394)
X'0200' - PC DOS non-DBCS WSF
X'0300' - OS/2 non-DBCS WSF
X'0400' - PC DOS DBCS WSF
X'0500' - OS/2 DBCS WSF
X'0600' - Other WSF or any other 5250 Emulator
10-12 Controller Code Level
X'010300' - For example, Version 1 Rel 3.0
13-28 X'00' Reserved (set to zero)
Byte Value Description ===== ======== =================================== 0-1 X'0000' Cursor Row/Column (set to zero) 2 X'88' Inbound Write Structured Field Aid 3-4 X'003A' Length of Query Reply 5 X'D9' Command Class 6 X'70' Command Type - Query 7 X'80' Flag Byte Bit 0: B'1' - Query Reply Bit 1-7: - Reserved (set to zero) 8-9 Controller Hardware Class X'0001' - Local Twinax Controller X'0061' - Local ASCII Controller X'0101' - SDLC/X.21/X.25 Twinax Controller (5394 emulating a 5294) X'0103' - SDLC/X.21/X.25 Twinax Controller (5394) X'0200' - PC DOS non-DBCS WSF X'0300' - OS/2 non-DBCS WSF X'0400' - PC DOS DBCS WSF X'0500' - OS/2 DBCS WSF X'0600' - Other WSF or any other 5250 Emulator 10-12 Controller Code Level X'010300' - For example, Version 1 Rel 3.0 13-28 X'00' Reserved (set to zero)
Chmielewski [Page 10] RFC 1205 5250 Telnet Interface February 1991
Chmielewski [Page 10] RFC 1205 5250 Telnet Interface February 1991
29 Device Type
X'01' - 5250 Display or 5250 Emulation
30-33 C'cccc' Device Type (e.g. 3180 for 3180 Mod 2)
34-36 C'ccc' Device Model (e.g. 002 for 3180 Mod 2)
37 Keyboard ID
X'02' - Standard Keyboard
X'82' - G Keyboard
38 X'00' Extended Keyboard ID
39 X'00' Reserved
40-43 X'xxxxxxxx' Display Serial Number
44-45 Maximum number of input fields
X'0100' - Typically = 256 input fields
46-48 X'00' Reserved (set to zero)
49-53 Controller/Display Capability
Bit 0-1: B'00' - No Row 1/Col 1 support
B'01' - Row 1/Col 1 support
Bit 2: B'0' - No Read MDT Alternate Command support
B'1' - Read MDT Alternate Command support
Bit 3: B'0' - Display does not have PA1/PA2 support
B'1' - Display does have PA1/PA2 support
Bit 4: B'0' - Display does not have PA3 support
B'1' - Display does have PA3 support
Bit 5: B'0' - Display does not have Cursor Select support
B'1' - Display does have Cursor Select support
Bit 6: B'0' - Display does not have Move Cursor Order support
B'1' - Display does have Move Cursor Order support
Bit 7: B'0' - No Read MDT Immediate Alt Command support
B'1' - Read MDT Immediate Alt Command support
50
Bit 0-3: B'0001' - 24 x 80 Screen Size
B'0011' - Capable of 24 x 80 and 27 x 132
Bit 4: B'0' - No light pen support
B'1' - Light pen support
Bit 5: B'0' - No Mag Stripe Reader support
B'1' - Mag Stripe Reader support
Bit 6-7: B'00' - Mono display
B'01' - 5292/3179 style color, including color PCs
51 X'00' - Reserved
52
Bit 0-2: B'000' - No Double Byte Character Set (DBCS)
capability
B'001' - Presentation screen DBCS capability only
Bit 3-7: B'00000' - Reserved
53
Bit 0-2: B'000' - No graphics capability
B'001' - 5292-2 style graphics
Bit 3-7: B'00000' - Reserved
54-60 X'00' Reserved (set to zero)
入力のG Keyboard38X'00'Extended Keyboard ID39X'00'Reserved40-43X'xxxxxxxx'Display Serial Number44-45Maximum番号がX'0100'をさばくという'29デバイスType X'01'--5250Displayか5250Emulation30-33C'cccc'Device Type(例えば、3180Mod2のための3180)34-36C'ccc'Device Model(例えば、3180Mod2のための002)37Keyboard ID X'02'--標準のKeyboard X82年'は256入力フィールド46-48X'00'Reserved(ゼロに設定する)49-53Controller/ディスプレイCapability Bit0-1と通常等しいです: B'00'(いいえ通りの1/あん部1つのサポートB'01')は1 1/あん部サポートBit2を船をこいで運びます: どんなRead MDT Alternate CommandもB'1'をサポートしないというB'0'はMDT Alternate CommandサポートBit3を読みます: B'0'--ディスプレイで、PA1/PA2はB'1'をサポートしません--ディスプレイで、PA1/PA2はBit4をサポートします: B'0'--ディスプレイで、PA3はB'1'をサポートしません--ディスプレイで、PA3はBit5をサポートします: B'0'--ディスプレイで、Cursor SelectはB'1'をサポートしません--ディスプレイで、Cursor SelectはBit6をサポートします: B'0'--ディスプレイで、Move Cursor OrderはB'1'をサポートしません--ディスプレイで、Move Cursor OrderはBit7をサポートします: どんなRead MDT Immediate Alt CommandもB'1'をサポートしないというB'0'はMDT Immediate Alt Commandサポート50Bit0-3を読みます: 24x80と27x132ができる'B'0001'--24x80はSize B0011年を上映する'Bit4: B'0'--軽いペンサポートがありませんB'1'--ライトペンサポートBit5: B'0'--いいえMag Stripe読者サポートB'1'--雑誌Stripe読者サポートBit6-7: B'00'(カラーPC51X'00'を含むモノタイプディスプレイB'01'--5292/3179スタイル色)は52Bit0-2を予約しました: B'000'--いいえ、Double Byte文字コード(DBCS)能力B'001'--プレゼンテーションは3-7にDBCS能力Bitだけを上映します: B'00000'--予約された53に0-2に噛み付きました: B'000'--いいえグラフィックス能力B'001'--5292-2 グラフィックスBit3-7を流行に合わせてください: B'00000'--予約された54-60 予約されたX'00'(ゼロへのセット)
Chmielewski [Page 11] RFC 1205 5250 Telnet Interface February 1991
Chmielewski[11ページ]RFC1205 5250telnetインタフェース1991年2月
6. References
6. 参照
1. IBM, "IBM 5250 Information Display System, Functions
Reference Manual", SA21-9247-6, March 1987.
1. IBM、「IBM5250情報ディスプレイ・システム、機能はマニュアルに参照をつける」SA21-9247-6が1987を行進させます。
2. Postel, J. and J. Reynolds, "Telnet Protocol Specification",
RFC 854, USC/Information Sciences Institute, May 1983.
2. ポステル、J.、およびJ.レイノルズ(「telnetプロトコル仕様」、RFC854、科学が設けるUSC/情報)は1983がそうするかもしれません。
3. Postel, J. and J. Reynolds, "Telnet Option Specifications",
RFC 855, USC/Information Sciences Institute, May 1983.
3. ポステル、J.、およびJ.レイノルズ(「telnetオプション仕様」、USC/情報科学が設けるRFC855)は1983がそうするかもしれません。
4. Postel, J. and J. Reynolds, "Telnet Binary Transmission",
RFC 856, USC/Information Sciences Institute, May 1983.
4. ポステル、J.、およびJ.レイノルズ(「telnetバイナリー送信」、RFC856、科学が設けるUSC/情報)は1983がそうするかもしれません。
5. VanBokkeln, J., "Telnet Terminal-Type Option", RFC 1091,
FTP Software, Inc., February 1989.
5. VanBokkeln、J.、「telnet端末のタイプオプション」、RFC1091、FTPソフトウェアInc.、1989年2月。
6. Postel, J. and J. Reynolds, "Telnet End of Record Option",
RFC 885, USC/Information Sciences Institute, December 1983.
6. ポステルとJ.とJ.レイノルズ、「記録的なオプションのtelnet終わり」、RFC885、科学が1983年12月に任命するUSC/情報。
Security Considerations
セキュリティ問題
Security issues are not discussed in this memo.
このメモで安全保障問題について議論しません。
Author's Address
作者のアドレス
Paul Chmielewski IBM Corporation Highway 52 and 37 Street North West Rochester, Minnesota 55901
North Westロチェスター、ポールChmielewski IBM社のHighway52と37通りミネソタ 55901
Phone: (507) 253-6315
以下に電話をしてください。 (507) 253-6315
EMail: paulc@rchland.iinus1.ibm.com
メール: paulc@rchland.iinus1.ibm.com
Chmielewski [Page 12]
Chmielewski[12ページ]
一覧
スポンサーリンク
