ibm:vm370-lib:cmshelp:cpquery.helpcmd
CPQUERY
CMS Commands
- cpquery.helpcmd.txt
QUERY CP Privilege Class: All classes except Any Use the QUERY command to deterimine your system status and machine configuration by requesting: o The time you have used during a terminal session. o The number of closed input and output spool files associated with your virtual machine. o Display PER command tracesets and trace elements. o The current settings of the SET and TERMINAL command functions. o The status of all the devices on your virtual machine. o The channel operating mode of your virtual machine, whether block- multiplexer or selector. o A listing of all users who are linked to a given virtual address, together with their device addresses and access modes. o Identification and attributes associated with your virtual printer, punch, and reader spool files. o The system log message. o The number of users logged on and/or their names. o Information on the allocation of system DASD volumes. There are other operands you can use with the QUERY command if you have the privilege class required to use them. These are described in the VM/370 Operator's Guide. Also, if you are a CMS user, you can use the CMS QUERY command to query the status of your CMS virtual machine. For help on the CMS QUERY command, type HELP CMSQUERY. The format of the QUERY command for general users (class G) is: +----------+------------------------------------------------------------------+ | QUERY | ALLOC DRCT|TDSK|TEMP|MAP volser | | | CPLEVEL | | | Files [CLass c] | | | Links vaddr | | | LOGmsg | | | MAXimum | | | Names | | | PER ALL|CUrrent|Names|traceset | | | PF[nn] | | | Printer [spoolid|ALL|CLass c] | | | PRIV | | | PUnch [spoolid|ALL|CLass c] | | | Reader [spoolid|ALL|CLass c] | | | Set | | | TERMinal | | | Time | | | Users [userid] | | | userid | | | [Virtual] device | | | | | | device: | | | ALL|CHANnels|CONsole|DAsd|GRAF|LINES|STORage|TApes|UR|vaddr | +----------+------------------------------------------------------------------+ where: ALLOC DRCT | TDSK | TEMP | MAP volser displays information about specified CP-owned DASD volumes, where DRCT displays information about the VM/370 system directory. TDSK displays information about temporay minidisks. TEMP displays information about system temporary space. MAP volser displays a map of the specified system DASD volume. CPLEVEL displays information about the current version of VM/370. Files [CLass c] displays the number of spooled input and output files for your virtual machine. Files currently being processed are not included in the totals. If CLASS is specified, the number of spooled input and output files of the class specified is displayed. LINKS vaddr displays the userid, device address, and access mode at the terminal for all users linked to the specified virtual address (vaddr). LOGmsg displays the log messages of the day. MAXimum displays the maximum number of users allowed to logon the system. 000 indicates there is no limit. Names displays a list of all the users logged on and the real address of the line to which each is connected. If a user is disconnected, DSC is displayed instead of the address. PER ALL | CUrrent | Names | traceset displays PER command tracesets and trace elements. ALL displays all the current traceset elements, the value of an active PER count, and the name and contents of all the saved tracesets. CUrrent displays the current traceset elements and any active PER count. Names displays the names of all saved tracesets. traceset displays the traceset elements for the specified traceset. PF[nn] displays the 3270 Program Function key number specified, along with its associated command lines. If nn is not specified, the definitions of all PF keys are displayed. See the CP SET command for information on setting and using PF keys. PRIV displays the CP privilege level for your userid. READER | RDR | PRINTER | PRT | PUNCH | PCH [spoolid | ALL | CLass c] displays the following information, pertaining to your closed virtual reader, virtual printer, and virtual punch spool files: o Userid of user who created the file o Spool file identification (spoolid) o Class and originating device type o Number of logical records in the file o Number of copies specified for the file (has no effect for reader files) o File hold status One line of information is displayed for each spool file. The following operands display additional information for one spool file. The operand must follow the READER, PRINTER, or PUNCH operand. One line of information is displayed for each spool file. spoolid In addition to the information normally displayed for reader, printer, or punch files, the following is also displayed: o Date and time the file was created. o Filename and filetype of file (if any), up to 20 characters. o Distribution code of the file (printer and punch files only). ALL In addition to the information normally displayed for reader, printer, or punch files, the following is also displayed: o Date and time the file was created. o Filename and filetype of file (if any), up to 20 characters. o Distribution code of the file (printer and punch files only). CLASS c displays the basic information for all spool files of the class specified by c. Set displays the status of the SET command function. TERMINAL displays the current options in effect for your virtual console environment. Time displays the current time, time zone, weekday, date, connect and CPU time for the current terminal session. Users displays the number of logged on users and the number of users logically connected to other virtual machines. [Users] userid displays the user identification and the terminal device address of the specified user if he is logged on. If the user is not logged on, a message to this effect is issued. Use the QUERY USERS userid format of the command if the userid is the same as one of the other operands (for example, TAPES). Virtual CHANnels | ALL | CHANnels | CONsole | DAsd | GRAF | LINES ALL displays the status of all your virtual devices. CHANNELS displays the channel mode of operation for the virtual machine. CONSOLE displays the status of your virtual consoles. DASD displays the status of all your virtual direct access storage devices. GRAF displays the status of all your virtual display devices that are locally attached. LINES displays the status of all your virtual communication lines. Virtual STORage | TAPES | UR | vaddr STORAGE displays the size of your virtual storage. TAPES displays the status of all your virtual magnetic tape devices. UR displays the status of all your unit record devices. vaddr displays the status of the virtual device at address vaddr. Responses: QUERY ALLOC DRCT DIRECT SPACE IN USE VOLSER UNIT RANGE volser cuu nnnn-nnnn QUERY ALLOC TDSK T-DISK SPACE VOLSER UNIT RANGE volser cuu nnnn-nnnn QUERY ALLOC TEMP TEMP SPACE VOLSER UNIT ALLOC USED volser cuu nnnn nnnn QUERY ALLOC MAP VM50-1 CP OWNED VOLUME ALLOCATION VOLSER UNIT RANGE TYPE volser cuu nnnn-nnnn PERM¦DRCT¦TEMP¦TDISK QUERY CPLEVEL SYSTEM 4381-A VM/370 Version nn Level nn PLC nnnn version; date time IPL at time timezone day date PEAK LOAD= nnn USERS Information about the VM/370 system is displayed. 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 MAXimum MAX USERS = nnn The maximum number of logged in users is displayed. A value of 000 means that there is no set limit to the number of logged in users. 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 PRIV PRIV = classes Displays the privilege classes of the current user. 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.
ibm/vm370-lib/cmshelp/cpquery.helpcmd.txt · Last modified: 2023/08/06 13:36 by Site Administrator