March 30, 1979 Appendix C: Considerations for 3270 Display Terminal Users The IBM 3270 display terminal w commonly referred to as a 3270, functions somewhat differently from a typewriter-style terminal when you use it as a virtual machine console under VM/370. Apart from the obvious difference in the way output is displayed, there are special techniques you can use with a 3270 that you cannot use on a 2741 or other typewriter terminal. This appendix describes how to use a 3270 and provides additional notes to supplement discussions in the first part of this publication. Entering Commands Since the keyboard on a 3270 is never locked during the execution of a command or program, you can enter successive command lines without waiting for the completion of the previous com.and. This stacking function can be combined with the other methods of stacking lines, such as using the logical line end symbol (I) to stack several command lines. If you try to enter more lines than the terminal buffer can accoamodate, however: you receive the status aessage NOT ACCEPTED and you must wait until the buffer is cleared before you can enter the line. You will find, as you becoae accustoaed to using a 3270, that the 'CP function is very The ICP function 6 reaember 6 is a function that allows you to pass a command line to the control program i.mediately, bypassing any processing by the virtual machine (eeS). The tcp function can be used in any VM/370 environment, and you can enter it even when a program is executing. You do not have to interrupt a program's execution to enter a command line such as: Icp display psw to display the current PSW, or: Icp spool printer class s to spool your virtual printer. If there are CP and CMS commands that you use frequently, you can set the program function (PF) keys on your terminal to execute thea. Soae examples of commands you might wish to catalog on PF keys are: .CP DISPLAY PSW ICP QUERY PRINTER ALL QUERY SEARCH To set functions keys 1, 2, and 3 to perform these co.mand functions, enter: cp set pf1 immed "Icp display psw cp set pf2 iamed "Icp query printer all cp set pf3 im.ed query search Appendix C: Considerations for 3270 Display Terminal Users 339
March 30, 1979 Appendix C: Considerations for 3270 Display Terminal Users The IBM 3270 display terminal w commonly referred to as a 3270, functions somewhat differently from a typewriter-style terminal when you use it as a virtual machine console under VM/370. Apart from the obvious difference in the way output is displayed, there are special techniques you can use with a 3270 that you cannot use on a 2741 or other typewriter terminal. This appendix describes how to use a 3270 and provides additional notes to supplement discussions in the first part of this publication. Entering Commands Since the keyboard on a 3270 is never locked during the execution of a command or program, you can enter successive command lines without waiting for the completion of the previous com.and. This stacking function can be combined with the other methods of stacking lines, such as using the logical line end symbol (I) to stack several command lines. If you try to enter more lines than the terminal buffer can accoamodate, however: you receive the status aessage NOT ACCEPTED and you must wait until the buffer is cleared before you can enter the line. You will find, as you becoae accustoaed to using a 3270, that the 'CP function is very The ICP function 6 reaember 6 is a function that allows you to pass a command line to the control program i.mediately, bypassing any processing by the virtual machine (eeS). The tcp function can be used in any VM/370 environment, and you can enter it even when a program is executing. You do not have to interrupt a program's execution to enter a command line such as: Icp display psw to display the current PSW, or: Icp spool printer class s to spool your virtual printer. If there are CP and CMS commands that you use frequently, you can set the program function (PF) keys on your terminal to execute thea. Soae examples of commands you might wish to catalog on PF keys are: .CP DISPLAY PSW ICP QUERY PRINTER ALL QUERY SEARCH To set functions keys 1, 2, and 3 to perform these co.mand functions, enter: cp set pf1 immed "Icp display psw cp set pf2 iamed "Icp query printer all cp set pf3 im.ed query search Appendix C: Considerations for 3270 Display Terminal Users 339
r Co.mand LOADVFCB LOCATE LOCK LOGOFF LOGON KESSAGE MONITOR MSGNOH NETWORK NOTREADY ORDER PURGE QUERY READY REPEAT REQUEST RESET REWIND SAVESYS SET Karch 30, 1979 Privilege Class Usage G Load virtual forms control buffer for a virtual 3203 or 3211 printer. C,E Find CP control blocks. A Bring virtual pages into real storage and lock them; thus, excluding them from future paging. any Disable access to CP. any Provide access to CP. A,B,any Transmit messages to other users. A,E Trace events of the real machine and record system performance data. B Send a specified message, without the standard message header, from one virtual machine to another. A,B,F Load, dump, trace, and control the operation of G D,G D,G A,B,C,D, E,F,G G D G G G E the 310X control program. Control the operation of 3270 remote devices. Simulate "not ready" for a device to a virtual machine. Rearrange closed spool files in a specific order. Remove closed spool file from system. Request information about machine configuration and system status. Simulate device end interruption for a virtual device. Repeat (a specified number of times) printing or punching of a specific real spool output file. Make an attention pending for the virtual machine console. Clear and reset all pending interruptions for a specified virtual device and reset all error conditions. Rewind (to load point) a tape and ready a tape unit. Save virtual machine storage contents, registers, and PSi. A,B,E,F, Operator--establish system parameters. G User--control various functions within the virtual machine. Figure 27. CP Command Summary (Part 3 of 4) 336 IBM VK/370 CMS User's Guide
March 30, 1979 I IPrivilegel I Command I Class I Usage 1 -------------------------------------------------------------------1 SHUTDOWN A SLEEP any SMSG G SPACE D SPOOL G SPTAPE D START D STCP C STORE G SYSTEM G TAG G TERMINAL G TRACE G TRANSFER D,G UNLOCK A VARY B WARNING A,B Terminate all VM/370 functions and checkpoint CPI system for warm start. I place virtual machine in dormant state. Send special message to virtual machine. Force single spacing on printer. Alter spooling control options; direct a file to another virtual machine or to a remote location via the RSCS virtual machine. Dump output spool files cn tape or load output spool files from tape. Start spooling device after draining or changing output classes. Change the contents of real storage. Alter specified virtual storage locations and registers. Simulate RESET, CLEAR STORAGE, and RESTART buttons on a real system console. specify variable information to be associated with a spool file or output unit record device. Interrogate the current TAG text setting of a given spool file or output unit record device. Define or redefine the input and attention handling characteristics of your virtual console. Trace specified virtual machine activity at your terminal, spooled printer, or both. Transfer input files to or reclaim input files from a specified user's virtual card reader. Unlock previously locked page frames. Mark a device unavailable or available. Transmit a high priority message to a specified user or to all users. Figure 27. CP Command Sum.ary (Part 4 of 4) Appendix B: Summary of CP Co •• ands 331
Pg. of GC20-1819-2 Rev March 30, 1979 by Supp. SD23-9024-1 for 5748-XX8 When you want to execute a ICP function with a PP key, or you want a PF key to execute a series of commands, you must use the logical escape symbol (") when you enter the SET command. Par example: cp set pf5 immed edit test file"tbo"tinput line"'file sets the PP5 key as: EDIT TEST PILEIBOIINPUT LINEIFILE You cannot set lowercase characters in a PF key. The above examples use the IMMED operand of the SET command, which specifies that the function is performed as soon as you press the PF key. You can also set a key so that it is delayed; that is, the command or data line is placed in the user input area. Then, you must press the Enter key to execute the command. You may modify the line before you enter it. This is the default setting (DELAY) for program function keys. For example, you might set a key as: QUERY DISK X(I} When you press this PP key, the command line is placed in the user input area, with the cursor positioned following the "(I)" logical character delete symbol; you can enter the mode letter of the disk you are querying before you press the Enter key to execute the command. If you enter 'A', the resulting command as seen by CMS is 'QUERY DISK A'. You can set all of your program function keys in your PROFILE EXEC, so they are set each time you load CMS. You can change a PP key setting any time during a terminal session, according to your needs. If, for example, you discover that you are repeating several procedures a number of times, and the procedure does not lend itself to being written into an EXEC, you could use your program function keys. All the lines in an EXEC procedure are scanned, and strings are truncated to eight characters, so if you command line, insert spaces where possible: CP SET PF5 IMMED EDIT TEST PILE IBO' INPUT all character enter a long To change PP settings within the edit filename that begins with a dollar sign macro. environment, give the EXEC a ($), so it functions as an edit For more details on setting PP keys, see the Controlling the Display Screen During a CP or CMS session (other than an EDIT session) messages and warnings from the system operator or other users are highlighted. This distinguishes these messages from other output and lessens the possibility of important messages being lost or ignored. A major feature of a 3270 display screen is the screen status area, which indicates, at all times that you are on, the current operating condition your virtual machine is 1n. Understanding the status conditions can help you use CMS on a 3270 more effectively. The screen status area indicates one of six conditions: 340 IBM VM/370 CMS User's Guide
Pg. of GC20-1819-2 Rev Karch 30, 1919 by Supp. SD23-9024-1 for 5748-XX8 After you log on, this is the first status aessage you see; it indicates that the ter.inal is waiting for a line to be read by the control program. You can enter only CP commands when the screen status area indicates a CP READ. Appendix C: Considerations for 3210 Display Terminal Users 340.1