CP Command Reference for General Users (Rel 6 PLC 17 Apr81)
Page129(141 of 213)
SET Use the SET to control various functions within your virtual system. The format of the SET command is: r SET L r ACNT [Nl AUTOPoll MSG I WNG IMSG RUN LINEDit OFF ECmode ISAM NOTRans t?AGEX EMSG { ON } OFF CODE TEXT TIMER "}' REAL r , AFFinity I I IQ}! I IOFFI L .J cpuid bbbbbb r "1 F "j F 1 ASsist ION I I S VC I I T M R I I I INOSVCI INOTMRI L.JL .JL J OFF r , PFnn IIMMed I rpfdata1#pfdata2# ••• pfdatan] I Q£;1sygg I L .J PFnn [ TAB n1 n2 ... 1 PFnn r COpy [resid]] PFnn r COpy (cu u]] section 5. Format of CP :ommands 129
SET } controls whether ter-minal or not issues the CP accounting information is displayed at the (ON and OFF, respectively) when the operator ACNT command. When you log on VM/370, ACNT is set on. AUTOPOLL {g;F} MSG {ON } OFF SMSG WNG {ON .} OFF TMSG controls whether or not cp tests each BTAM autopoll C:W to see if it has been dynamically modified. ON indicates that (1) CP testing, and (2) the VS1 operating system is to notify CP, via the DIAGNOSE instruction code X'0028', after an crw has been modified. ON substantially reduces the over-head required by CP to service BTAM autopoll channel pr-oqrams. OFF causes CP to check each autopoll C:W after each execution of the channel program and is the default status when the user logs on. NQtg: T¥ you SET AUTOPOLL ON and the virtual operating system does not have the appropriate Diagnose interface, :P does not detect chanqes to BTAM channel programs and unpredictabie results can occur. OS/VS 1 Release 6.0, however, does have this interface. controls whether messages sent by the MSG command from other user-s ar-e to be received at the terminal. If ON is specified, the messages are displayed. If OFF is specified, no messages ar-e received. In addition to controlling messages generated bV the MESSAGE command, spooling messages generated by users sending punch, printer or reader files to another virtual machine are also suppressed if OFF is specified. When you log on VM/370, is set on. whether a virtual machine is rece1v1ng special messages or not. If OFF is specified, the virtual machine cannot receive special msssages. controls whether warning messages are displayed at the terminal. I¥ ON is specified, all warning messages sent via the CP WARNING command from the system operator are received at the terminal. If OFF is specified, no warning messages are r-eceived. When you log on VM/370, WNG is set on. controls whether certain informational responses issued by the CP CHANGE, DEFINE, DETACH, IPL, ORDER, PURGE, and TRANSFER commands are displayed at the terminal or not. The descriptions of these CP commands tell which responses are affected. If ON is specified the informational responses are If OFF is specified, they are not. The SET IMSG ON or OFF command line has no effect on the handling of error messaqes set by the SET EMSG command. When you log on VM/370, IMSG is set on. 130 IBM VM/370 CP Command Reference for General Users
REWIND Use the command to rewind (but not unload) a real tape unit attached to your virtual machine at a specific virtual device address. The format of the REWIND command is: r REWind vaddr L vaddr is the virtcral device address (cuu) of the tape unit to be rewound. The REWIND accomplishes the manual operation of rewinding and makinq the tape ready at the tape unit. REWI ND COM:PLETE is the response you receive upon the the successful initiation of the =ommand. Receivinq this message does not imply that the tape is physically rewound yet. REWIND NOT PERFORMED is the response vou receive if the real tape unit is not ready. 128 IBM VM/370 CP Command Reference for General Users
SET Use the SET to control various functions within your virtual system. The format of the SET command is: r SET L r ACNT [Nl AUTOPoll MSG I WNG IMSG RUN LINEDit OFF ECmode ISAM NOTRans t?AGEX EMSG { ON } OFF CODE TEXT TIMER "}' REAL r , AFFinity I I IQ}! I IOFFI L .J cpuid bbbbbb r "1 F "j F 1 ASsist ION I I S VC I I T M R I I I INOSVCI INOTMRI L.JL .JL J OFF r , PFnn IIMMed I rpfdata1#pfdata2# ••• pfdatan] I Q£;1sygg I L .J PFnn [ TAB n1 n2 ... 1 PFnn r COpy [resid]] PFnn r COpy (cu u]] section 5. Format of CP :ommands 129
CP Command Reference for General Users (Rel 6 PLC 17 Apr81)
Page127(139 of 213)
RESET use the RESET command to clear all pending interrupts virtual devi=e. The format of the RESET command is: r I RESET L vaddr specified ___ J vaddr is a virtual device address (cuuj of the device to be reset. 1. In adaition to clearing all pending interrupts, all error occurring as a result of unit checks and virtual sense bytes are reset. 2. When the DIAL command is issued from virtlal system user must use the CP dialed connection. a local 3270 command RESET terminal, the to drop the DEVICE RESET i3 the response you receive upon the the successful completion of the command. section 5. Format of CP Commands 127
REWIND Use the command to rewind (but not unload) a real tape unit attached to your virtual machine at a specific virtual device address. The format of the REWIND command is: r REWind vaddr L vaddr is the virtcral device address (cuu) of the tape unit to be rewound. The REWIND accomplishes the manual operation of rewinding and makinq the tape ready at the tape unit. REWI ND COM:PLETE is the response you receive upon the the successful initiation of the =ommand. Receivinq this message does not imply that the tape is physically rewound yet. REWIND NOT PERFORMED is the response vou receive if the real tape unit is not ready. 128 IBM VM/370 CP Command Reference for General Users
CP Command Reference for General Users (Rel 6 PLC 17 Apr81)
Page131(143 of 213)
SET RUN {ON } OFF controls whether the virtual machine stops when the attention key is pressed. ON allows you to activate the attention key (causinq a read of a CP command) without stopping your virtual machine. When the CP command is entered, it is immediately executed and the virtual machine resumes execution. OFF places the virtual machine in the normal CP environment, so that when the attention key is pressed, the virtual machine stops. When you loq on VM/370, RUN is set off. LTNEDTT } OFF RCMODE TSAft1 NOTRANS controls the line editinq functions. ON specifies that the line editing functions and the symbols of the system are to be used to edit virtual processor console input reqaestSe establishes line editing features in systems that do not normally provide them. OFF specifies that no character or line editing is to be used for the virtual machine operating system. When you log on VM/370, LINEDIT is set on. { ON} OFF controls whether the virtual machine operating system may use System/370 extended control mode and control registers 1 15. Control reqister 0 may be used with E:MODE either ON or OFF. When you loq on VM/370, ECMODE is set according to the user's directory option; ON if was specified and OFF if not. NQl§: Execution of the SET ECMODE {ONIOFF} command always causes a virtual system reset, but does not change the PSW ECMODE bit. controls whether additional checking is performed on virtual IIO requests to DASD in order to support the OS Indexed SeQ1entiai Access Method (ISAH). When you log on VM/370, ISAM is set accordinq to the user's directory options; ON if was soecified and OFF if not. controls ccw translation for CP. NOTFANS can be specified only by a virtual machine that occupies the virtual=real space. It causes all virtual 1/0 from the issuing virtual machine to bypass the CP CCW translation except under the following conditions: • SIO tracinq active • First ccw not in the V=R region • I/O operation is a sense command • I/O device is a dial-up terminal • 1/0 is for a non-dedicated device • Pendinq device status Any of the above conditions forces CCW translation. To be in effect in the virtual=real environment, SET NOTRANS ON must be issued after the virtual=real machine is loaded via the Tot command. (IPL sets the NOTRANS option to an OFF condi tion. ) Section 5. Format of CP Commands 131
SET PAGE'( { ON } OFF controls the pseudo page fault portion of the VM/VS handshakinq feature. PAGEX ON or OFF should only be issued for a viLtual machine that has the VM/VS handshaking feature It can only be specified for a virtual machine that has the extended control mode option. PAGEX ON sets on the Dseudo page fault portion of handshakinq; PAGEX OFF sets it off. you log on to VM/370, PAGEX is set OFF. Also, each time you IPL your virtual machine, PAGEX is set off. If you want to use the pseudo page fault handling pOLtion of handshaking, you must issue SET PAGEX ON after you load vour operatinq system. EMSG TEXT TIMEB controls error message handling. ON specifies that both the error code and text are displayed at the terminal. TEXT that only text is displayed. CODE specifies that only the error code is to be displayed. OFF specifies that no error messaqe is to be displayed. When you log on VM/370, EMSG is set to TEXT. If the console is beinq spooled, the OFF setting is ignored fOL the spooled output and the full error message appears in the spooled output. The other three settinqs result in spooled output that matches the console printout. Not?: recognizes EMSG settings for all error (E), iof;rmation (I), and warning (W) messages, but iqnores the EMSG setting and displays the complete message (error code and text) all response (R), severe error (S), and terminal (T) messaqes. Also, data tyPed in such as a list of names followiinq a message, will not be controlled by the settinq. } REAL controls the virtual timer. ON specifies that the virtual tim2r is to be updated only when the virtual processor is runninq. OFF specifies that the virtual timer is not to be updated. REAL specifies that the virtual timer is to be updated durinq virtual CPU run time and also during virtual wait time. If the REALTIMER option is specified in your VM/370 directory entry, TIMER is set to REAL when you log on; otherwise it is set to ON when you log on. r , FFI NIrv ,OFF, ,ON I L controls whether or not CP dispatches a virtual machine and exe=ute its programs on either the main processor or the attached processor of an attached processor system. Normal mode is AFFINITY OFF, allowing virtual machine execution on either processor. AFFINITY ON causes the directory to be interroqated for an affinity setting; if there is none in the directory, the user receives an informational message. In uniprocessor mode, affinity is meaningless because all virtual execute on the main processor. 132 VM/37Q CP Command Reference for General Users