HP 3000 Manuals

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