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

CLOSE3270

» 

Technical documentation

» Feedback

 » Table of Contents

 » Glossary

 » Index

CLOSE3270 emulates turning off a specified device.

Syntax

                       I         I
CLOSE3270        (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 CLOSE3270 intrinsic:

0 = Successful completion.

1 = Device not open.

22 = BASIC calling sequence error has occurred.

26 = Intrinsic call made with the parameter value out of bounds.

30 = Internal error occurred in IMF intrinsic.

301 = Illegal DB register.

302 = Invalid session.

305 = Parameter bounds violation.

315 = Internal Error.

340 = No stack space.

Description

The CLOSE3270 intrinsic is equivalent to turning off a particular device. CLOSE3270 releases the internal screen image created by the OPEN3270 intrinsic and frees the LU-LU session for other users.

Use the CLOSE3270 intrinsic in either transparent or non-transparent mode.

NOTE: Be sure to log off from the host application you are using before you issue the CLOSE3270 intrinsic. The CLOSE3270 intrinsic terminates your session with the host system, but it does not terminate the host application. If you call CLOSE3270 before you log off from the host application, the host application is left running, and you have no way of terminating it, because your session has been closed.

COBOL Calling Sequence

CALL "CCLOSE3270" USING TERMINALID RESULT. (on MPE V and in compatibility mode on MPE XL)

CALL INTRINSIC "CLOSE3270" USING TERMINALID RESULT. (in native mode on MPE XL)

Both parameters are numeric data items.

FORTRAN Calling Sequence

CALL CLOSE3270 (TERMINALID, RESULT)

Both parameters are integer variables.

BASIC Calling Sequence

CALL BCLOSE3270 (T, R) (on MPE V and in compatibility mode on MPE XL)

CALL CLOSE3270 (T, R) (in native mode on MPE XL)

Both parameters are integer variables.

SPL Calling Sequence

CLOSE3270 (TERMINALID, RESULT)

Both parameters are integer variables.

Pascal Calling Sequence

CLOSE3270 (TERMINALID, RESULT)

Both parameters are short integer variables.

C/XL Calling Sequence

CLOSE3270 (&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 CLOSE3270;  intrinsic;...{************************** Intrinsic Call **************************}CLOSE3270 (terminalid, result);
Feedback to webmaster