SET CP Privilege Class: G Use the SET command to control various functions within your virtual system. If you are a CMS user, you can use the CMS SET command to control various functions related to your CMS virtual machine. For help on the CMS SET command, type HELP CMSSET. The format of the SET command is: +----------+------------------------------------------------------------------+ | SET | ACNT|ECmode|IMSG|ISAM|LINEDit|MSG|NOTRans|PAGEX|RUN|WNG ON|OFF | | | EMSG ON|OFF|CODE|TEXT | | | TIMER ON|OFF|REAL | | | ASsist OFF|[ON][SVC|NOSVC] | | | PFnn DELayed|IMMed [pfdata1#pfdata2...] | | | PFnn RECALL|RETRIEVE | | | PFnn [TAB n1 n2...] | | | PFnn COPY [cuu|resid] | +----------+------------------------------------------------------------------+ where: ACNT ON | OFF controls whether accounting information is displayed at the terminal or not (ON and OFF, respectively) when the operator issues the CP ACNT command. When you log on VM/370, ACNT is set on. ECmode ON | OFF controls whether the virtual machine operating system may use System/370 extended control mode and control registers 1 through 15. Control register 0 may be used with ECMODE either ON or OFF. When you log on VM/370, ECMODE is set according to the user's directory option; ON if ECMODE was specified and OFF if not. Note: Execution of the SET ECMODE command always causes a virtual system reset. Setting ECMODE does not change the PSW EC mode bit. IMSG ON | OFF controls whether certain informational responses issued by the CP CHANGE, DEFINE, DETACH, 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 displayed. If OFF is specified, they are not. The SET IMSG ON or OFF command line has no effect on the handling of error messages set by the SET EMSG command. When you log on to VM/370, IMSG is set ON. ISAM ON | OFF controls whether additional checking is performed on virtual I/O requests to DASD in order to support the OS Indexed Sequential Access Method (ISAM). When you log on VM/370, ISAM is set according to the user's directory options; ON if ISAM was specified and OFF if not. LINEDit ON | OFF controls the line editing functions. ON specifies that the line editing functions and the symbols of the VM/370 system are to be used to edit virtual processor console input requests. This 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. MSG ON | OFF controls whether messages sent by the MSG command from other users are to be received at the terminal. If ON is specified, the messages are displayed. If OFF is specified, no messages are received. In addition to controlling messages generated by 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, MSG is set on. NOTRans ON | OFF controls CCW translation for CP. NOTRANS can be specified only by a virtual machine that occupies the virtual=real space. It causes all virtual I/O from the issuing virtual machine to bypass the CP CCW translation except under the following conditions: o SIO tracing active o First CCW not in the V=R region o I/O operation is a sense command o I/O device is a dial-up terminal o I/O is for a non-dedicated device o Pending 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 IPL command. (IPL sets the NOTRANS option to an OFF condition.) PAGEX ON | OFF controls the pseudo page fault portion of the VM/VS handshaking feature. PAGEX ON or OFF should only be issued for a virtual machine that has the VM/VS handshaking feature active. It can only be specified for a virtual machine that has the extended control mode (ECMODE) option. PAGEX ON sets on the pseudo page fault portion of handshaking; PAGEX OFF sets it off. When 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 portion of handshaking, you must issue SET PAGEX ON after you load your operating system. RUN ON | OFF controls whether the virtual machine stops when the attention key is pressed. ON allows you to activate the attention key (causing 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 log on VM/370, RUN is set off. WNG ON | OFF controls whether warning messages are displayed at the terminal. If 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 received. When you log on to VM/370, WNG is set ON. EMSG ON | OFF | CODE | TEXT controls error message handling. ON specifies that both the error code and text are displayed at the terminal. OFF specifies that no error message is to be displayed. CODE specifies that only the error code is be displayed. TEXT specifies that only text is displayed. When you log on to VM/370, EMSG is set to TEXT. If the console is being spooled for error messages from CP, the OFF setting is ignored for the spooled output and the full error message appears in the spooled output. The other three settings result in spooled output that matches the console printout. It is the responsibility of the operating system running under CP to determine whether or not its own error messages will honor the EMSG setting in the spooled output. Note: CMS always recognizes EMSG settings for all error (E), information (I), and warning (W) messages, but ignores the EMSG setting and displays the complete message (error code and text) for all response (R), severe error (S), and terminal (T) messages. Also, data written by means of type in, such as a list of names following a message, are not controlled by the EMSG operand. TIMER ON | OFF | REAL controls the virtual timer. ON specifies that the virtual timer is to be updated only when the virtual processor is running. OFF specifies that the virtual timer is not to be updated. REAL specifies that the virtual timer is to be updated during 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. ASsist OFF | [ON] [SVC | NOSVC] all functions of SET ASSIST operands pertain to VM/370 hardware assist. VM/370 hardware assist consists of processor hardware that assists the processor in the execution of certain instructions, series of instructions, privileged operations, and interrupt processing that are normally handled by the control program portion of VM/370. All, some, or none of the function performed by VM/370 hardware assist may be available on the processor that the virtual machine is logged on. If the user requests VM/370 hardware assist and it is available and active, the request is honored; if VM/370 hardware assist is not active but is available and the user attempts to enable hardware assist, the virtual machine remembers the enabling attempt and an appropriate message is sent to the user. When the system operator enables hardware assist, it is immediately utilized by the virtual machine. In the event that hardware assist is not available or active on the system, an appropriate error message is issued. PFnn [DELayed | IMMED] [pfdata1#pfdata2#...] defines a program function for a program function key on a 3270 Display station and indicates when that function is to be executed. If PFnn is specified with no operands, that program function key is considered "undefined." See the VM/370 Terminal User's Guide for a description of how to use the 3270 program function keys. nn is a number from 1 (or 01) to 24 that corresponds to a key on a 3270 display station. The program function is a programming capability you create by defining a series of VM/370 commands or data you want executed. This series of commands is executed when you press the appropriate program function key. IMMED specifies that the program function is executed immediately after you press the program function key. DELAYED specifies that execution of the program function is delayed for a display terminal. When the program function is entered, it is displayed in the input area and not executed until you press the Enter key. DELAYED is the default value for display terminals. pfdata1#pfdata2#... defines the VM/370 command or data lines that constitute the program function. If more than one command line is to be entered, the pound sign (#) must separate the lines. If you use the pound sign (#) to separate commands that you want executed with the designated PF key, you must precede the command line with #CP, turn line editing off, or precede each pound sign with the logical escape character ("). If no command lines are entered following the PFnn designation, then the program function is marked undefined. Program functions cannot be embedded within one another. PFnn RECALL | RETRIEVE specifies that the program function key numbered nn carries out the RETRIEVE function on a 3270 display terminal. The number of the PF key, nn, can be a value from 1 (or 01) to 24. Once you have defined a RETRIEVE program function key, CP begins saving your input lines. When you press the designated PF key, VM/370 displays either the most recently saved input line so that you can modify and reenter the data. When you first press the RETRIEVE program function key, VM/370 displays the most current input line. If you press the key again, VM/370 displays the previous input line. Each time you press the key, VM/370 scrolls through the input lines, retrieving older input lines, and displaying them one at a time. After VM/370 reaches the oldest line stored, it returns to the most current line once again. PFnn [TAB n1 n2 ...] specifies a program function key number to be associated with tab settings on a terminal. The number of the PF key, nn, can be a value from 1 (or 01) to 24. TAB is a keyword identifying the tab function. The tab settings (n1 n2 ...) may be entered in any sequence: SET PF09 TAB 20 30 40 defines tab settings on columns 20, 30, and 40 of your command line. PFnn [COPY [cuu | resid]] specifies that the program function key numbered nn performs a COPY function for a remote 3270 Information Display terminal. The number, nn, must be a value from 1 (or 01) to 24. The COPY function produces a printed output of the entire screen display at the time the PF key is pressed. The output is printed on an IBM printer connected to the same control unit as your display terminal; if no printer is connected, the copy function is not available. cuu represents the real hardware address of the display printer, and may specify a printer that is on a different control unit than the one to which your 3270 is attached. If you do not specify cuu, the printer with the lowest cuu that is available on the same control unit as your 3270 is selected. resid may be specified if more than one printer is connected to the same control unit as your display terminal. It is a two- character hexadecimal resource identification number assigned to a specific printer. If resid is entered, the printed copy is directed to a specific printer; if not, the copy is printed on the printer with the lowest resid number. The resid numbers of the printers available to your display terminal can be obtained from your system operator. If only one printer is available, as with the 3275 Display Station, resid need not be specified. Responses: QUERY FILES [CLASS c] FILES: nnn¦NO RDR, nnn¦no PRT, nnn¦NO PUN The total number of spool files in your system is displayed. If you specify the CLASS option, only the totals for the class you specify are displayed. QUERY LINKS vaddr userid vaddr R/W ¦ R/O, ... A list of users who are currently linked to the device at virtual address vaddr is displayed, where userid is the identification of the user who originated the link. vaddr is the virtual address by which the user (userid) refers to the device. R/O¦R/W is the type of access the user (userid) has to the device. QUERY LOGMSG * logmsg text line All lines (both those with an asterisk and without) in the log message file are displayed. QUERY NAMES userid - DSC ¦ raddr ¦ resid, ... A list of all logged-on users is displayed. If the user is currently connected, the real address (raddr) or the resource id of a 3704/3705 line (resid) to which he is connected is displayed. If he is not connected, DSC is displayed. QUERY PFnn PFnn IMMED ¦ DELAY pfdata... The program function defined for a program function key is displayed. If there is no function defined for the key, this message is displayed: PFnn UNDEFINED QUERY READER, QUERY PRINTER, QUERY PUNCH OWNERID FILE CLASS RECDS CPY HOLD [ DATE TIME NAME TYPE DIST ] userid spid c typ norecs nn stat [mm/dd hh:mm:ss fn ft distcode] where: userid is the user who originally created the file. spid is a unique, system-assigned number which is used by VM/370 to identify the file. c is the spool file class. typ is the originating device type (PRT, PUN, CON, or RDR). norecs is the number of logical records contained in the file. nn is the number of copies assigned to the file (it has no effect for virtual reader files). stat is the file hold status: NONE (no hold), USER (user hold), SYS (system hold), or USYS (system and user hold). mm/dd is the date the file was created in month/day. hh:mm:ss is the time the file was opened for creation in hours:minutes: seconds. fn is the filename assigned to the file, if any. If the file has a 24-character data set name (dsname), only 20 characters are displayed. ft is the filetype assigned to the file, if any. distcode is the distribution code assigned to the file. When you issue QUERY READR, QUERY PRINTER, or QUERY PUNCH, CP responds by listing (as describe above) all the files associated with your virtual reader, printer, or punch. The optional information is displayed only when you specify the ALL or spoolid operands. QUERY SET MSG ON¦OFF , WNG ON¦OFF , EMSG ON¦OFF¦CODE¦TEXT, ACNT ON¦OFF , RUN ON¦OFF LINEDIT ON¦OFF , TIMER ON¦OFF¦REAL, ISAM ON¦OFF, ECMODE ON¦OFF ASSIST ON SVC¦ON NOSVC¦OFF, PAGEX ON¦OFF, AUTOPOLL ON¦OFF IMSG ON¦OFF The settings of all functions controlled by the SET command and the VM/370 ISAM and ECMODE options are displayed. See the CP SET command for information on each of these settings. QUERY TERMINAL LINEND #¦OFF , LINEDEL n¦OFF, CHARDEL n¦OFF, ESCAPE n¦OFF, TABCHAR ON¦OFF LINESIZE nnn, ATTN ON¦OFF , APL ON¦OFF, TEXT ON¦OFF, MODE CP¦VM, HILIGHT ON¦OFF AUTOCR ON¦OFF, MORE nnn nnn, HOLD ON¦OFF , TIMESTAMP ON¦OFF The settings of all functions that are controlled by the TERMINAL command are displayed. See the CP TERMINAL command for information on each of these settings. QUERY TIME TIME IS hh:mm:ss zone weekday mm/dd/yy The current real clock time in hours:minutes:seconds, the time zone (for example, EST), the day of the week and the calendar date (month/day/year) are displayed. CONNECT= hh:mm:ss VIRTCPU= mmm:ss.hs TOTCPU= mm:ss.hs The time spent in the current terminal session is displayed, where: CONNECT= hh:mm:ss is the actual clock time spent in the current terminal session in hours:minutes:seconds. VIRTCPU= mmm:ss.hs is the virtual CPU time used in the current terminal session in minutes:seconds.hundredths of seconds. TOTCPU= mmm:ss.hs is the total CPU time (virtual and overhead) used in the current terminal session in minutes:seconds.hundredths of seconds. QUERY USERS nnn USERS, mm DIALED The number of users logged on and dialed to VM/370 is displayed, where: nnn is the total number of logged-on users. mmm is the total number of users attached via DIAL to virtual machines. QUERY userid ¦ QUERY USERS userid userid - raddr ¦ resid The real address (raddr) or the resource id of a 3704/3705 line (resid) to which he is connected is displayed. QUERY VIRTUAL ALL This has the same effect as if all the following commands were issued: QUERY VIRTUAL STORAGE QUERY VIRTUAL LINES QUERY VIRTUAL TAPE QUERY VIRTUAL UR QUERY VIRTUAL DASD QUERY VIRTUAL GRAF QUERY VIRTUAL CONSOLE QUERY VIRTUAL CHANNELS QUERY VIRTUAL CHANNELS CHANNELS= BMX¦SEL The operating mode of the virtual machine channels is displayed. This response applies to all of the virtual machine channels except channel 0, which is always a byte multiplexer channel, and any channels with virtual or real channel-to-channel adapters, which are always selector channels. QUERY VIRTUAL CONSOLE CONS vaddr ON GRAF ¦ LINE raddr TERM ¦ NOTERM START ¦ STOP vaddr CL c CONT ¦ NOCONT HOLD ¦ NOHOLD COPY nn READY ¦ NOTREADY vaddr TO ¦ FOR userid DIST distcode For virtual machine consoles, a three-line response is displayed. The first line shows the console status and options and the next two lines show the virtual console spooling status, where: vaddr is the virtual address of the virtual machine console. raddr is the real address of the terminal associated with the virtual console. c is the spooling class of the console. nn is the number of copies specified. userid is the user identification. distcode is the distribution code. The other fields indicate the setting of the respective options in the SPOOL command. The default settings for a virtual console are: CONS vaddr ON dev raddr TERM STOP vaddr CL T NOCONT NOHOLD COPY 01 READY vaddr FOR userid DIST distcode QUERY VIRTUAL DASD DASD vaddr type volser R/W ¦ R/O nnn CYL The status of each virtual disk defined for your system is displayed, where: vaddr is the virtual address to which the DASD device is attached. type is one of the following device types: 231T (2311 at top of 2314) 2314 231B (2311 at bottom of 2314) 3330 2311 3340 2305 3350 volser is the volume serial number of the system disk on which this virtual disk resides. R/W ¦ R/O indicates the read/write status of the disk. nnn is the number of cylinders on the virtual disk. QUERY VIRTUAL GRAF GRAF vaddr ON DEV raddr ¦ NOT READY The status of all locally attached virtual display devices defined to your virtual machine is displayed, where: vaddr is the virtual address to which the device is attached. raddr is the real address of the device. NOT READY shows the status of a virtual display device that has not been attached via the DIAL command. QUERY VIRTUAL LINES LINE vaddr ON DEV raddr The status of all communication lines defined in your virtual machine is displayed, where: vaddr is the virtual address to which the line is attached. raddr is the real address of the line. QUERY VIRTUAL STORAGE STORAGE = nnnnnK The size of the virtual machine in multiples of 1024 bytes is displayed. QUERY VIRTUAL TAPES TAPE vaddr ON DEV raddr The status of each tape drive defined for your system is displayed, where: vaddr is the virtual address to which the tape is attached. raddr is the real address of the tape. QUERY VIRTUAL UR RDR vaddr CL c CONT ¦ NOCONT HOLD ¦ NOHOLD EOF ¦ NOEOF READY ¦ NOTREADY The status of all the virtual readers attached to your virtual machine is displayed, where: vaddr is the virtual device address of the virtual reader. c is the spool class which the device services. A class of * indicates the device services all classes of spool files for input. The other fields indicate the settings of the respective options in the SPOOL command. The default settings for a reader are: RDR vaddr CL * NOCONT NOHOLD READY EOF PRT ¦ PUN vaddr CL c CONT ¦ NOCONT HOLD ¦ NOHOLD COPY nn READY ¦ NOTREADY vaddr TO ¦ FOR userid DIST distcode The status of all the virtual printers and punches attached to your virtual machine is displayed, where: vaddr is the virtual device address of the virtual printer or punch. c is the output class assigned to spool files produced from the device. nn is the number of copies of each output file to be produced. TO userid indicates that the output from the device, when closed, becomes a reader input spool file for the indicated userid. FOR userid indicates the user identification (spool file owner) assigned to spool files produced from the device. distcode is the distribution code assigned to each spool file produced from the device. Note: the distcode in this case indicates the FOR userid; however, the distcode produced on the output file when the file is close is the distcode assigned to the FOR userid as specified in the VM/370 directory. The other fields indicate the settings of the respective options in the SPOOL command. The default settings are: PRT ¦ PUN vaddr CL A NOCONT NOHOLD COPY 01 READY vaddr FOR userid DIST distcode FLASHC 00 vaddr FLASH CHAR MDFY FCB QUERY VIRTUAL vaddr The response is in the same format as QUERY VIRTUAL DASD, TAPES, LINES or UR, depending on the virtual device type.