Z/VM: 7.2 CP Commands and Utilities Reference

z/VM 7.2

CP Commands and Utilities Reference

IBM

SC24-6268-11

Note: Before you use this information and the product it supports, read the information in "Notices" on page 2251.

This edition applies to version 7, release 2 of IBM z/VM (product number 5741-A09) and to all subsequent releases and modifications until otherwise indicated in new editions. Last updated: 2022-04-08 ? Copyright International Business Machines Corporation 1991, 2022. US Government Users Restricted Rights ? Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents

Figures............................................................................................................... xix

Tables.................................................................................................................xxi

About This Document........................................................................................ xxiii

Intended Audience.................................................................................................................................. xxiii Where to Find More Information............................................................................................................. xxiii

Links to Other Documents and Websites.......................................................................................... xxiii

How to Send Your Comments to IBM................................................................... xxv

Summary of Changes for z/VM: CP Commands and Utilities Reference............... xxvii

SC24-6268-11, z/VM 7.2 (May 2022)....................................................................................................xxvii SC24-6268-10, z/VM 7.2 (December 2021)........................................................................................ xxviii SC24-6268-09, z/VM 7.2 (August 2021)..............................................................................................xxviii SC24-6268-09, z/VM 7.2 (July 2021).................................................................................................... xxix SC24-6268-08, z/VM 7.2 (March 2021)..................................................................................................xxx SC24-6268-07, z/VM 7.2 (December 2020)......................................................................................... xxxii SC24-6268-06, z/VM 7.2 (September 2020)....................................................................................... xxxiii SC24-6268-05, z/VM 7.1 (January 2020)............................................................................................ xxxiv SC24-6268-04, z/VM 7.1 (September 2019)........................................................................................ xxxv SC24-6268-03, z/VM 7.1 (June 2019)................................................................................................. xxxvi SC24-6268-02, z/VM 7.1 (April 2019).................................................................................................xxxvii SC24-6268-01, z/VM 7.1 (December 2018)...................................................................................... xxxviii SC24-6268-00, z/VM 7.1 (September 2018)..................................................................................... xxxviii

Chapter 1. Introduction......................................................................................... 1

Using Commands......................................................................................................................................... 1 Command Structure.....................................................................................................................................2

The Command Name..............................................................................................................................2 The Command Operands........................................................................................................................2 How to Enter Comments in the CP Command Language...................................................................... 2 Character Sets........................................................................................................................................ 2 Using Truncations and Abbreviations..........................................................................................................3 Syntax, Message, and Response Conventions............................................................................................ 4 Privilege Classes.......................................................................................................................................... 6 Delayed Responses to CP Commands.........................................................................................................7 Example.................................................................................................................................................. 9 Using the Online HELP Facility...................................................................................................................10

Chapter 2. CP Commands.................................................................................... 11

ASTERISK (*).............................................................................................................................................. 12 #CP.............................................................................................................................................................13 ACNT...........................................................................................................................................................15 ACTIVATE ISLINK.......................................................................................................................................16 ADJUNCT....................................................................................................................................................18 ASSOCIATE EXIT........................................................................................................................................20 ASSOCIATE MESSAGES / MSGS................................................................................................................ 24 AT................................................................................................................................................................27

iii

ATTACH...................................................................................................................................................... 30 ATTN........................................................................................................................................................... 49 AUTOLOG....................................................................................................................................................50 BACKSPACE/BACKWARD.......................................................................................................................... 54 BEGIN.........................................................................................................................................................56 CHANGE..................................................................................................................................................... 58 CLOSE......................................................................................................................................................... 68 COMMANDS............................................................................................................................................... 78 COMMIT..................................................................................................................................................... 80 CONCOPY TERMINATE.............................................................................................................................. 82 COUPLE...................................................................................................................................................... 83 CP............................................................................................................................................................... 88 CPACCESS.................................................................................................................................................. 89 CPCACHE....................................................................................................................................................94 CPHX.......................................................................................................................................................... 96 CPLISTFILE................................................................................................................................................ 99 CPRELEASE.............................................................................................................................................. 103 CPTYPE.................................................................................................................................................... 105 CPU...........................................................................................................................................................107 CPVLOAD.................................................................................................................................................. 109 CPXLOAD.................................................................................................................................................. 111 CPXUNLOAD.............................................................................................................................................117 DEACTIVE CONV...................................................................................................................................... 119 DEACTIVE ISLINK....................................................................................................................................120 DEFINE.....................................................................................................................................................122 DEFINE ALIAS..........................................................................................................................................127 DEFINE CFLINK....................................................................................................................................... 130 DEFINE CHPID / PATH.............................................................................................................................132 DEFINE COMMAND / CMD.......................................................................................................................143 DEFINE CONSOLE....................................................................................................................................149 DEFINE CPOWNED.................................................................................................................................. 150 DEFINE CPU............................................................................................................................................. 152 DEFINE CPUPOOL....................................................................................................................................156 DEFINE CRYPTO...................................................................................................................................... 157 DEFINE CTCA........................................................................................................................................... 159 DEFINE CU / CNTLUNIT...........................................................................................................................161 DEFINE DEVICE / IODEVICE................................................................................................................... 167 DEFINE DIAGNOSE..................................................................................................................................172 DEFINE EXIT............................................................................................................................................ 176 DEFINE GRAF...........................................................................................................................................179 DEFINE HYPERPAVALIAS........................................................................................................................180 DEFINE LAN............................................................................................................................................. 181 DEFINE LINE............................................................................................................................................186 DEFINE LPAR........................................................................................................................................... 187 DEFINE MDISK........................................................................................................................................ 188 DEFINE MSGPROC...................................................................................................................................191 DEFINE NIC..............................................................................................................................................194 DEFINE PAVALIAS................................................................................................................................... 197 DEFINE PCIFUNCTION............................................................................................................................198 DEFINE RELODOMAIN.............................................................................................................................202 DEFINE RESPOOL.................................................................................................................................... 204 DEFINE (Spooling Device)....................................................................................................................... 208 DEFINE STORAGE....................................................................................................................................212 DEFINE SUBSTITUTE.............................................................................................................................. 221 DEFINE (Temporary Disk)........................................................................................................................222 DEFINE TIMEZONE..................................................................................................................................224 DEFINE (Virtual Device)...........................................................................................................................226 DEFINE (Virtual Disk in Storage)............................................................................................................. 229

iv

DEFINE VSWITCH.................................................................................................................................... 231 DEFSEG.................................................................................................................................................... 245 DEFSYS.....................................................................................................................................................252 DELETE CHPID / PATH.............................................................................................................................258 DELETE CPUPOOL....................................................................................................................................261 DELETE CU / CNTLUNIT...........................................................................................................................262 DELETE DEVICE / IODEVICE................................................................................................................... 264 DELETE EDEVICE..................................................................................................................................... 267 DELETE LPAR........................................................................................................................................... 269 DELETE PCIFUNCTION............................................................................................................................271 DELETE RDEVICE.....................................................................................................................................273 DELETE RESPOOL.................................................................................................................................... 275 DESTAGE.................................................................................................................................................. 276 DETACH.................................................................................................................................................... 278 DETACH CFLINK.......................................................................................................................................281 DETACH CPU............................................................................................................................................ 283 DETACH CRYPTO......................................................................................................................................285 DETACH LAN............................................................................................................................................ 289 DETACH MSGPROC.................................................................................................................................. 291 DETACH NIC.............................................................................................................................................292 DETACH PCIFUNCTION........................................................................................................................... 293 DETACH (Real Device)............................................................................................................................. 295 DETACH SYSASCII................................................................................................................................... 301 DETACH (Virtual Device)..........................................................................................................................303 DETACH VSWITCH................................................................................................................................... 306 DIAL......................................................................................................................................................... 307 DISABLE (Device).................................................................................................................................... 310 DISABLE COMMAND / CMD.....................................................................................................................312 DISABLE DIAGNOSE................................................................................................................................315 DISABLE EXITS........................................................................................................................................ 318 DISABLE HCD...........................................................................................................................................320 DISASSOCIATE........................................................................................................................................ 323 DISCARD PINNED....................................................................................................................................326 DISCONNECT........................................................................................................................................... 328 DISPLAY................................................................................................................................................... 330 DISPLAY ACCESS LIST.............................................................................................................................334 DISPLAY (Guest Storage - ESA/XC, z/XC)............................................................................................... 336 DISPLAY (Guest Storage - ESA/390).......................................................................................................344 DISPLAY (Guest Storage - z/Architecture) ............................................................................................. 353 DISPLAY (Host Storage).......................................................................................................................... 362 DISPLAY LKS............................................................................................................................................ 367 DISPLAY PREFIX......................................................................................................................................371 DISPLAY PSW...........................................................................................................................................372 DISPLAY PSWG........................................................................................................................................ 375 DISPLAY (Registers)................................................................................................................................ 377 DISPLAY SCHIB....................................................................................................................................... 382 DRAIN (Disk)............................................................................................................................................ 385 DRAIN UR (Unit Record Device).............................................................................................................. 387 DUMP....................................................................................................................................................... 394 DUMP ACCESS LIST................................................................................................................................. 398 DUMP (Guest Storage - ESA/XC, z/XC)....................................................................................................400 DUMP (Guest Storage - ESA/390)........................................................................................................... 407 DUMP (Guest Storage - z/Architecture).................................................................................................. 415 DUMP (Host Storage)...............................................................................................................................423 DUMP LKS................................................................................................................................................ 428 DUMP PREFIX.......................................................................................................................................... 432 DUMP PSW............................................................................................................................................... 433 DUMP PSWG............................................................................................................................................ 436

v

DUMP (Registers).....................................................................................................................................438 DUMP SCHIB............................................................................................................................................444 DUPLEX.................................................................................................................................................... 447 ECHO........................................................................................................................................................ 456 ENABLE (Device)......................................................................................................................................457 ENABLE COMMAND / CMD...................................................................................................................... 459 ENABLE DIAGNOSE................................................................................................................................. 462 ENABLE EXITS......................................................................................................................................... 464 EXPLORE FCP...........................................................................................................................................466 EXTERNAL................................................................................................................................................ 468 FLASHCOPY............................................................................................................................................. 470 FLASHCOPY BACKGNDCOPY.................................................................................................................. 479 FLASHCOPY ESTABLISH..........................................................................................................................482 FLASHCOPY RESYNC...............................................................................................................................488 FLASHCOPY TGTWRITE...........................................................................................................................491 FLASHCOPY WITHDRAW.........................................................................................................................493 FLUSH.......................................................................................................................................................497 FOR...........................................................................................................................................................500 FORCE...................................................................................................................................................... 503 FORWARD................................................................................................................................................ 507 FREE LOGON............................................................................................................................................ 509 FREE PRINTER/PUNCH........................................................................................................................... 510 GIVE......................................................................................................................................................... 512 GIVE (Real Device)...................................................................................................................................514 GIVE (Virtual Device)............................................................................................................................... 517 HALT......................................................................................................................................................... 519 HOLD LOGON........................................................................................................................................... 521 HOLD PRINTER/PUNCH.......................................................................................................................... 522 HYPERSWAP............................................................................................................................................ 524 INDICATE................................................................................................................................................. 530 INDICATE ACTIVE....................................................................................................................................531 INDICATE I/O...........................................................................................................................................533 INDICATE LOAD....................................................................................................................................... 534 INDICATE MULTITHREAD........................................................................................................................538 INDICATE NSS......................................................................................................................................... 542 INDICATE PAGING...................................................................................................................................545 INDICATE QUEUES.................................................................................................................................. 547 INDICATE SPACES................................................................................................................................... 551 INDICATE USER....................................................................................................................................... 554 IPL............................................................................................................................................................ 564 LINK......................................................................................................................................................... 573 LOADBUF..................................................................................................................................................587 LOADVFCB................................................................................................................................................593 LOCATE.....................................................................................................................................................597 LOCATE CMDBK....................................................................................................................................... 598 LOCATE DGNBK....................................................................................................................................... 603 LOCATE FILID.......................................................................................................................................... 605 LOCATE FRAMETBL..................................................................................................................................607 LOCATE ICLBK......................................................................................................................................... 609 LOCATE LDEV........................................................................................................................................... 611 LOCATE RDEV...........................................................................................................................................613 LOCATE RPCI........................................................................................................................................... 616 LOCATE SHPBK........................................................................................................................................ 618 LOCATE SNABK........................................................................................................................................ 620 LOCATE SPFBK.........................................................................................................................................622 LOCATE (Storage).....................................................................................................................................625 LOCATE SXSTE......................................................................................................................................... 629 LOCATE SYMBOL......................................................................................................................................631

vi

LOCATE VDEV...........................................................................................................................................634 LOCATE VMDBK....................................................................................................................................... 637 LOCATE VPCI............................................................................................................................................639 LOCATE VSMBK........................................................................................................................................641 LOCATE XITBK......................................................................................................................................... 643 LOCATEVM............................................................................................................................................... 645 LOCK.........................................................................................................................................................648 LOGOFF.................................................................................................................................................... 653 LOGON......................................................................................................................................................656 MESSAGE................................................................................................................................................. 667 MESSAGE ALL.......................................................................................................................................... 668 MESSAGE (User)...................................................................................................................................... 670 MODIFY CHPID / PATH............................................................................................................................ 673 MODIFY COMMAND / CMD...................................................................................................................... 677 MODIFY CU / CNTLUNIT..........................................................................................................................682 MODIFY DEVICE / IODEVICE.................................................................................................................. 687 MODIFY DIAGNOSE.................................................................................................................................691 MODIFY EXIT........................................................................................................................................... 694 MODIFY PCIFUNCTION...........................................................................................................................697 MODIFY PRIV_CLASSES.......................................................................................................................... 699 MONITOR................................................................................................................................................. 701 MONITOR EVENT..................................................................................................................................... 704 MONITOR SAMPLE.................................................................................................................................. 712 MONITOR START/STOP........................................................................................................................... 721 MSGNOH.................................................................................................................................................. 725 NOTREADY............................................................................................................................................... 728 ORDER......................................................................................................................................................729 PER........................................................................................................................................................... 733 PURGE...................................................................................................................................................... 734 PURGE IMG.............................................................................................................................................. 737 PURGE NLS.............................................................................................................................................. 739 PURGE NSS.............................................................................................................................................. 741 PURGE TRFILES....................................................................................................................................... 743 PURGE UCR.............................................................................................................................................. 745 QUERY ABEND......................................................................................................................................... 747 QUERY ACCOUNT.....................................................................................................................................749 QUERY ADJUNCT..................................................................................................................................... 750 QUERY AGELIST.......................................................................................................................................751 QUERY ALL............................................................................................................................................... 753 QUERY ALLOC.......................................................................................................................................... 767 QUERY BYUSER....................................................................................................................................... 775 QUERY CACHE..........................................................................................................................................776 QUERY CACHEFW.................................................................................................................................... 778 QUERY CAPABILITY.................................................................................................................................780 QUERY CFLINKS...................................................................................................................................... 782 QUERY CHPID.......................................................................................................................................... 785 QUERY CHPIDS........................................................................................................................................ 790 QUERY CHPIDV........................................................................................................................................ 792 QUERY CMDLIMIT....................................................................................................................................793 QUERY COLLECT...................................................................................................................................... 794 QUERY COMMANDS.................................................................................................................................796 QUERY CONCOPY.................................................................................................................................... 798 QUERY CONFIGMODE............................................................................................................................. 800 QUERY CONTROLLER.............................................................................................................................. 802 QUERY CONV........................................................................................................................................... 804 QUERY CPCHECKING.............................................................................................................................. 810 QUERY CPCMDS.......................................................................................................................................811 QUERY CPDISKS...................................................................................................................................... 818

vii

QUERY CPLANGLIST................................................................................................................................820 QUERY CPLANGUAGE..............................................................................................................................822 QUERY CPLEVEL...................................................................................................................................... 823 QUERY CPLOAD........................................................................................................................................826 QUERY CPOWNED....................................................................................................................................828 QUERY CPPROTECT................................................................................................................................. 830 QUERY CPSERVICE.................................................................................................................................. 833 QUERY CPTRACE..................................................................................................................................... 836 QUERY CPUAFFINITY.............................................................................................................................. 839 QUERY CPUID.......................................................................................................................................... 840 QUERY CPUPOOL.....................................................................................................................................841 QUERY CPXLOAD..................................................................................................................................... 842 QUERY CRYPTO........................................................................................................................................847 QUERY CTCA............................................................................................................................................ 851 QUERY CU................................................................................................................................................ 854 QUERY D8ONECMD................................................................................................................................. 859 QUERY DASD............................................................................................................................................861 QUERY DASDFW...................................................................................................................................... 873 QUERY DATEFORMAT.............................................................................................................................. 875 QUERY DEVICES...................................................................................................................................... 877 QUERY DIAGNOSE...................................................................................................................................879 QUERY DUMP........................................................................................................................................... 881 QUERY DUMPDEV.................................................................................................................................... 884 QUERY DUPLEX........................................................................................................................................885 QUERY DYNAMIC_I/O............................................................................................................................. 887 QUERY EDEVICE...................................................................................................................................... 890 QUERY ENCRYPT..................................................................................................................................... 896 QUERY EQID............................................................................................................................................ 897 QUERY EXITS........................................................................................................................................... 899 QUERY FCP...............................................................................................................................................903 QUERY FENCES........................................................................................................................................907 QUERY FILES........................................................................................................................................... 909 QUERY FLASHCOPY.................................................................................................................................912 QUERY FRAMES....................................................................................................................................... 917 QUERY GATEWAY.....................................................................................................................................921 QUERY GRAF............................................................................................................................................923 QUERY HCD..............................................................................................................................................926 QUERY HOLD............................................................................................................................................928 QUERY HOTIO..........................................................................................................................................930 QUERY HYPERSWAP................................................................................................................................933 QUERY ICLNAME..................................................................................................................................... 935 QUERY IMG.............................................................................................................................................. 937 QUERY IO_OPT.........................................................................................................................................940 QUERY IOASSIST.....................................................................................................................................942 QUERY IOPRIORITY................................................................................................................................ 944 QUERY IPLPARMS....................................................................................................................................946 QUERY ISFC............................................................................................................................................. 948 QUERY ISLINK......................................................................................................................................... 951 QUERY IUCV.............................................................................................................................................953 QUERY JOURNAL..................................................................................................................................... 955 QUERY KEYALIAS.....................................................................................................................................956 QUERY LAN.............................................................................................................................................. 958 QUERY LDEVS.......................................................................................................................................... 965 QUERY LINES........................................................................................................................................... 968 QUERY LINKS...........................................................................................................................................971 QUERY LKFAC.......................................................................................................................................... 973 QUERY LKFACR........................................................................................................................................ 975 QUERY LOADDEV..................................................................................................................................... 977

viii

 ................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download