RESET3270 [ SNA IMF Programmer's Reference Manual ] MPE/iX 5.0 Documentation
SNA IMF Programmer's Reference Manual
RESET3270
RESET3270 emulates pressing the RESET key on an IBM 3278 display station
keyboard.
Syntax
________________________________________
| |
| I I |
| RESET3270 (terminalid, result)|
________________________________________
Parameters
terminalid (input)
Integer identifying the terminal. The terminalid is returned in a call
to the OPEN3270 intrinsic.
result (output)
The following values can be generated by the RESET3270 intrinsic:
0 = Successful completion.
1 = Device not open.
22 = BASIC calling sequence error has occurred.
25 = Intrinsic call made while in split stack
mode.
26 = Intrinsic call made with the parameter value
out of bounds.
29 = Called intrinsic with a request already
outstanding. (No-wait I/O only)
30 = Internal error occurred in IMF intrinsic.
53 = Invalid intrinsic called for data stream mode
device.
Description
Using the RESET3270 intrinsic is equivalent to pressing the RESET key on
an IBM 3278 keyboard. The RESET3270 intrinsic unlocks the physical
keyboard so you can issue intrinsics like WRITEFIELD and STREAM3270 that
write to the internal screen image.
If input is inhibited, and you try to write to the internal screen image
with an intrinsic like WRITEFIELD or STREAM3270, the logical keyboard
that exists in memory locks. Then, the only way you can release it is by
calling the RESET3270 intrinsic. This intrinsic sets the input inhibit
bit to zero, which is equivalent to receiving a keyboard enable command
from the host.
The TRAN3270 intrinsic disables input when it executes successfully. It
also disables input if it returns error codes 14, 16, or 30. Usually,
the RECV3270 intrinsic is the first intrinsic called after a call to
TRAN3270, and your program receives a keyboard enable in the transmission
from the host. However, if you are not expecting the host to send data
in response to your TRAN3270 call, or if your call to TRAN3270 did not
execute successfully, you should call RESET3270 to enable input.
Use the RESET3270 intrinsic in non-transparent mode.
COBOL Calling Sequence
CALL "CRESET3270" USING TERMINALID RESULT. (on MPE V and in compatibility
mode on MPE XL)
CALL INTRINSIC "RESET3270" USING TERMINALID RESULT. (in native mode on
MPE XL)
Both parameters are numeric data items.
FORTRAN Calling Sequence
CALL RESET3270 (TERMINALID,RESULT)
Both parameters are integer variables.
BASIC Calling Sequence
CALL BRESET3270 (T, R) (on MPE V and in compatibility mode on MPE XL)
CALL RESET3270 (T, R) (in native mode on MPE XL)
Both parameters are integer variables.
SPL Calling Sequence
RESET3270 (TERMINALID, RESULT)
Both parameters are integer variables.
Pascal Calling Sequence
RESET3270 (TERMINALID, RESULT);
Both parameters are short integer variables.
C/XL Calling Sequence
RESET3270 (&TERMINALID, &RESULT);
Both parameters are of type short.
Pascal Program Excerpts
Following are excerpts from a Pascal program that calls SNA IMF
intrinsics. For examples of complete Pascal programs in non-transparent
and transparent modes, see appendix F, "Sample Programs."
{************************** Global Declarations **************************}
type
shortint = -32768..32767; { global type, two bytes (half word) }
.
.
.
var
terminalid : shortint; { value returned by OPEN3270 intrinsic }
result : shortint;
.
.
.
procedure RESET3270; intrinsic;
.
.
.
{************************** Intrinsic Call **************************}
RESET3270 (terminalid, result);
MPE/iX 5.0 Documentation