HPlogo Asynchronous Serial Communications Programmer's Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 8 Intrinsics Reference

FCONTROL(38)

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Glossary

 » Index

Parameters

controlcode

38 — Sets terminal type.

param

16-bit unsigned integer by reference (required)

Passes the value if the system defined terminal type to be associated with an asynchronous port.

Notes

FCONTROL with a controlcode value of 38 allows you to change the terminal type associated with a port to another system defined terminal type. The new terminal type will be in effect for the port until you change it through another FCONTROL call, or until the device is closed. When the device is closed, the port is reset to its configured default.

If you change the terminal type of a terminal running an interactive session, you should be sure to reset it to the previously assigned terminal type when your program ends, unless you want the new terminal type to be in effect for other files opened on the device. To be sure you are able to reset to the previous terminal type, your program should call FCONTROL(39) to determine the current terminal type before calling FCONTROL(38) to change to the new setting. (Note that the current terminal type may be different from the default (configured) terminal type.)

The terminal type specified by FCONTROL(38) must be a system defined terminal type currently supported on MPE/iX systems. If any other value is used, the intrinsic will return an error condition of CCL.

You cannot use FCONTROL to change to or from a user defined terminal type. You must use FDEVICECONTROL to perform this function with terminal types defined through Workstation Configurator.

If issued against a terminal connected via PAD, DTC Telnet, or Telnet/iX, this call will change the terminal type setting, but will have no impact on how the device actually operates. A CCE condition code will be returned.

If issued against a terminal connected via VT from an MPE/iX or MPE V local client, this call will change the terminal type setting and the characteristics of the terminal type supported by VT. The controlcode value is not supported for VT connections from a PC or HP-UX local client.

Condition Codes

CCE

Request granted.

CCG

Not returned by this intrinsic.

CCL

Request failed because the process does not own the logical device, the device is not a terminal, or the terminal type entered is not supported.

Additional Discussion

See also the discussions of FCONTROL(37) and FCONTROL(39) in this manual. Refer to Chapter 7 “Programming for PAD, DTC Telnet, Telnet/iX Server, and VT Devices” for more information on terminal type specifications for devices connected via PAD or DTC Telnet.

Feedback to webmaster