z/VM: CP Commands and Utilities Reference - z/VM - IBM

TERMINAL BRKKEY
TERMINAL BRKKEY
►►
TERMinal
Authorization
Purpose
Operands
BRKkey
Usage Notes
key
NONE
Privilege Class: G
1580 z/VM: CP Commands and Utilities Reference
Use TERMINAL BRKKEY to define the key to control CP break-in for full-screen
guests.
key
must be one of the following: PA1, PA2, PFnn, or CLEAR. PFnn can be any PF
key on your display station, from PF1 to PF24.
NONE
specifies that no BRKKEY can be defined.
1. The break key is in effect in line mode as well as in full-screen mode.
2. When you first logon, the default key to control break-in by CP for full-screen
guests is PA1. However, if you intend to run an operating system in your virtual
machine that requires the PA1 key for some other function, you can use this
command to define an alternate break key.
3. After you enter this command, the new break key remains in effect for the
duration of the session or until you reissue this command during the current
session. If you use this command to define a new break key and then, at some
point in the session, prefer to use the default break key again, the PA1 option
lets you do so.
4. If you use this command to define a key other than PA1 as the break key, CP
passes control of the PA1 key to your virtual machine.
5. When NONE is specified, the guest has complete control of the keyboard. If
you are in full-screen you can only return to CP mode if the full-screen
program provides a way for you or by typing #CP.
6. Entry to the protected application environment disables the BRKKEY. To
reenable it within the protected application, enter the TERMINAL BRKKEY
command. Upon exit from the protected application, CP restores the break key
setting to what it was before entry into the same protected application. If the
break key was changed while in the protected application, it remains
unchanged when you exit the application.
7. For the BRKKEY option, only PA1 and NONE are supported for SNA/CCS
terminals. If you enter TERMINAL BRKKEY with any other options from an
SNA/CCS terminal, the command is not processed and you receive a message
that indicates an invalid device type error.
8. If you change the break key setting while logged on to a local display,
disconnect and reconnect to an SNA/CCS terminal. Your TERMINAL BRKKEY
setting is affected in the following way during the reconnection processing:
►◄