HPlogo SNA IMF Programmer's Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 3 Intrinsics Used with Standard MPE I/O

RESET3270

» 

Technical documentation

» Feedback

 » Table of Contents

 » Glossary

 » Index

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);
Feedback to webmaster