HP 3000 Manuals HP 3000 Manuals
CLOSE3270
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);