z/OSVersion 2 Release 3

MVS System Commands

IBM

SA38-0666-30

Note

Before using this information and the product it supports, read the information in “Notices” on page803.

This edition applies to Version 2 Release 3 of z/OS (5650-ZOS) and to all subsequent releases and modifications untilotherwise indicated in new editions.

Last updated: 2019-06-24© Copyright International Business Machines Corporation 1988, 2018.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract withIBM Corp.

Contents

Figures............................................................................................................... xiii

Tables..................................................................................................................xv

About this information........................................................................................ xixWho should use this information.............................................................................................................. xixHow to use this information...................................................................................................................... xixz/OS information........................................................................................................................................xix

How to send your comments to IBM.....................................................................xxiIf you have a technical problem................................................................................................................xxi

Summary of changes......................................................................................... xxiiiSummary of changes in z/OS Version 2 Release 3 (V2R3)..................................................................... xxiiiSummary of changes for z/OS Version 2 Release 2 (V2R2) as updated December 2016......................xxvSummary of changes for z/OS Version 2 Release 2 (V2R2) as updated June 2016.............................. xxvSummary of changes for z/OS Version 2 Release 2 (V2R2) as updated March 2016............................ xxvSummary of changes for z/OS Version 2 Release 2 (V2R2) as updated December 2015......................xxvSummary of changes in z/OS Version 2 Release 2 (V2R2)..................................................................... xxviSummary of changes for z/OS Version 2 Release 1 (V2R1), as updated February 2015..................... xxviiSummary of changes for z/OS Version 2 Release 1 (V2R1), as updated March 2014.......................... xxixz/OS Version 2 Release 1 summary of changes......................................................................................xxix

Chapter 1. System operations................................................................................ 1Starting, loading, and initializing the system.............................................................................................. 2

Starting the system.................................................................................................................................2Preparing the system hardware............................................................................................................. 3Loading the system software................................................................................................................. 3Initializing the system software............................................................................................................. 6Logging on to the system........................................................................................................................7Starting and specifying parameters for the job entry subsystem......................................................... 9

Controlling the system................................................................................................................................. 9Displaying current system status...........................................................................................................9Displaying the status of devices and availability of paths.....................................................................9Sending commands to systems in a sysplex....................................................................................... 10Using commands that have sysplex scope..........................................................................................10Sharing system commands.................................................................................................................. 13Setting the time and changing the system parameters...................................................................... 17Using the system restart function........................................................................................................17Responding to IEA502A.......................................................................................................................18Responding to BLW004A..................................................................................................................... 18Activating a workload management service policy............................................................................. 19

Controlling time-sharing............................................................................................................................19Controlling jobs.......................................................................................................................................... 19

Starting a job.........................................................................................................................................20Stopping a job.......................................................................................................................................20Cancelling a job.................................................................................................................................... 20Passing information to a job.................................................................................................................20Restarting a job.....................................................................................................................................20

iii

Deferred restart....................................................................................................................................21Controlling started tasks............................................................................................................................21Controlling system information recording.................................................................................................22

System management facilities.............................................................................................................22System trace.........................................................................................................................................23The generalized trace facility............................................................................................................... 24Master trace..........................................................................................................................................24Component trace..................................................................................................................................24Logrec recording medium.................................................................................................................... 24

Controlling automatic tape switching........................................................................................................24Defining automatically switchable devices......................................................................................... 25Displaying information about automatically switchable devices........................................................25

Interacting with system functions.............................................................................................................26Device allocation.................................................................................................................................. 26Hot I/O detection..................................................................................................................................28Device boxing....................................................................................................................................... 28

Command flooding.....................................................................................................................................32Class M1 commands............................................................................................................................ 32Class M2 commands............................................................................................................................ 33Class M3 commands............................................................................................................................ 35Class C1 commands............................................................................................................................. 35Class C2 commands............................................................................................................................. 35Class C3 commands............................................................................................................................. 35Inline commands..................................................................................................................................35

Setting up hardware event data collection............................................................................................... 36Accessing the output from a hardware event data collection run............................................................39

Interpreting the z/OS UNIX system services output files................................................................... 41HISSERV service overview.........................................................................................................................46Bypassing HIS to exploit the CPU Measurement Facility......................................................................... 46Responding to failing devices....................................................................................................................47Quiescing the system.................................................................................................................................48Stopping the system.................................................................................................................................. 48Recovery from hardware problems........................................................................................................... 48

Hardware problems..............................................................................................................................48Information provided with machine checks........................................................................................49CPU errors.............................................................................................................................................49Service processor damage...................................................................................................................52Storage errors.......................................................................................................................................52Channel subsystem errors................................................................................................................... 53I/O device errors...................................................................................................................................56Diagnosing problems in a switched fabric...........................................................................................64Additional recovery actions..................................................................................................................77

Chapter 2. System Reconfiguration...................................................................... 79Dynamic I/O configuration.........................................................................................................................79Logical and physical reconfiguration.........................................................................................................80Reconfiguration support according to processor types............................................................................80

Uniprocessor (UP)................................................................................................................................ 80Multiprocessor (MP)............................................................................................................................. 80

Reconfiguring a central processor.............................................................................................................80Actions to reconfigure a central processor offline.............................................................................. 80Reconfiguring a central processor with an ICRF................................................................................. 81Actions to bring online a central processor and its ICRF.................................................................... 81Removing the last ICRF........................................................................................................................82Actions to take offline a central processor and its ICRF..................................................................... 82

Reconfiguring central storage....................................................................................................................82Physical view of central storage...........................................................................................................82

iv

Specifying the RSU parameter............................................................................................................. 83Reconfiguring channel paths..................................................................................................................... 86

Actions to reconfigure channel paths.................................................................................................. 86Reconfiguring I/O devices..........................................................................................................................87Reconfiguring a coupling facility................................................................................................................87

Chapter 3. z/OS operator console operations........................................................ 89Console characteristics and operations....................................................................................................89

General characteristics of display consoles........................................................................................ 89Operations on display consoles in full-capability mode..................................................................... 93Handling consoles in error conditions............................................................................................... 101Placing a console in offline status..................................................................................................... 105Interchanging your consoles on a control unit..................................................................................105

Defining and changing console characteristics...................................................................................... 105Using operator commands to change CONSOLxx statements......................................................... 105Changing console characteristics...................................................................................................... 110Controlling system messages and commands..................................................................................125Defining program function keys (PFKs)............................................................................................. 131Processing hardcopy.......................................................................................................................... 134

Chapter 4. MVS system commands reference......................................................137Command syntax notation...................................................................................................................... 151

How to read syntax conventions........................................................................................................151System command formats...................................................................................................................... 153

Typical format.....................................................................................................................................153A second format................................................................................................................................. 154

ACTIVATE command................................................................................................................................154Restrictions........................................................................................................................................ 154Syntax................................................................................................................................................. 154Parameters......................................................................................................................................... 155

CANCEL command...................................................................................................................................158Syntax................................................................................................................................................. 159Parameters......................................................................................................................................... 159

CHNGDUMP command............................................................................................................................ 163Dump options and modes..................................................................................................................163Changing the dump mode and options..............................................................................................163Scope in a sysplex.............................................................................................................................. 164Syntax variations for CHNGDUMP..................................................................................................... 164Removing options from or resetting the system dump options lists................................................ 164Parameters......................................................................................................................................... 164Options for SDUMP, SYSABEND, SYSUDUMP, and SYSMDUMP........................................................ 166Resetting dump mode to add and the dump options to initial values..............................................172Example: How CHNGDUMP commands affect dump modes and options....................................... 172Setting the dump modes and options............................................................................................... 174

CMDS command...................................................................................................................................... 183Syntax................................................................................................................................................. 183Parameters......................................................................................................................................... 184

CONFIG command...................................................................................................................................186Syntax................................................................................................................................................. 186Reconfiguring the system directly..................................................................................................... 186Reconfiguring the system with a CONFIGxx parmlib member......................................................... 197Reconfiguring the system in response to a configuration display.................................................... 197

CONTROL command................................................................................................................................ 198Scope in a sysplex.............................................................................................................................. 200Syntax................................................................................................................................................. 200Changing out of line display area specifications............................................................................... 200Deleting retained action messages................................................................................................... 201

v

Halting the printing or the display of a status display.......................................................................202Controlling displays in areas..............................................................................................................203Removing information from the screen.............................................................................................204Activating, deactivating, or displaying the status of the action message retention facility.............205Changing or displaying the number of allowed WTL SYSLOG buffers.............................................. 206Changing or displaying the number of allowed WTO and WTOR message buffers..........................206Changing the time the system waits for ROUTE command responses............................................ 207Increasing the maximum number of reply IDs................................................................................. 208Changing or displaying the status of WTO installation exit IEAVMXIT ............................................ 208Displaying the SMCS APPLID of the current system and VTAM generic resource name for SMCS. 209Setting the APPLID of the system......................................................................................................209Setting or turning off the VTAM generic resource name for SMCS................................................... 210Changing a PFK definition.................................................................................................................. 211Deleting message queues..................................................................................................................213Changing or displaying message deletion and format specifications.............................................. 213Changing the operating mode of a console....................................................................................... 217Selecting the message levels for a console.......................................................................................217

DEVSERV command.................................................................................................................................219Using the DEVSERV QDASD option.................................................................................................... 220Using the DEVSERV QTAPE option.....................................................................................................220Using the DEVSERV QPAVS option.....................................................................................................221Using the DEVSERV QLIB option........................................................................................................221Syntax................................................................................................................................................. 221Parameters......................................................................................................................................... 222

DISPLAY command..................................................................................................................................239Scope in a sysplex.............................................................................................................................. 242Syntax................................................................................................................................................. 243Displaying MVS device allocation group locks information.............................................................. 244Displaying MVS device allocation settings information.................................................................... 244Displaying MVS device allocation IGDE information.........................................................................245Displaying APPC/MVS information.................................................................................................... 246Displaying ASCH configuration information...................................................................................... 250Displaying auxiliary storage information........................................................................................... 252Displaying auto-reply policy and WTORs information...................................................................... 254Displaying the current system-level Language Environment runtime options................................ 255Displaying CONTROL command functions........................................................................................ 257Displaying attached coupling facility information.............................................................................257Displaying console group definitions.................................................................................................258Displaying console status information.............................................................................................. 258Displaying DIAG parmlib information................................................................................................262Displaying data lookaside facility information.................................................................................. 263Displaying dump options or dump data set status............................................................................265Displaying extended MCS information.............................................................................................. 268Displaying the timer synchronization mode and ETR ports.............................................................. 273Displaying function enablement state information ..........................................................................274Displaying global resource serialization information........................................................................ 276Displaying Generic Tracker information............................................................................................ 288Displaying hardware event data collection status............................................................................ 295Displaying Basic HyperSwap information......................................................................................... 298Displaying ICSF information.............................................................................................................. 299Displaying the data set optimization configuration...........................................................................299Displaying TSO/E parmlib information.............................................................................................. 302Displaying I/O configuration information.......................................................................................... 303Displaying captured UCB information............................................................................................... 304Displaying IOS control unit group information..................................................................................304Displaying dynamic channel path management information........................................................... 305Displaying encryption key manager (EKM) status.............................................................................305Displaying zHPF facility status...........................................................................................................307

vi

Displaying FICON switch data information....................................................................................... 307Displaying IOS group information......................................................................................................307Displaying IOS HYPERPAV information............................................................................................. 308Displaying the IBM zHyperWrite data replication status.................................................................. 308Displaying MIDAW facility status.......................................................................................................308Displaying MIH and I/O timing limits.................................................................................................309Displaying IOS recovery options .......................................................................................................312Displaying the IOSSPOF system service options ............................................................................. 312Displaying IOS storage residency information.................................................................................. 312Displaying the devices stopped by the IOACTION command.......................................................... 313Displaying the current status of the zHyperLink facility................................................................... 313Displaying IPL information.................................................................................................................313Displaying PCIE-related parameters................................................................................................. 315Displaying system activity..................................................................................................................315Displaying started task status........................................................................................................... 324Displaying library lookaside information...........................................................................................326Displaying the system logger and its log streams............................................................................. 328Displaying the logrec recording medium...........................................................................................337Displaying system configuration information....................................................................................338Displaying message flood automation information.......................................................................... 345Displaying MVS message service status and languages................................................................... 346Displaying message suppression, retention, color, intensity, and highlighting options...................347Displaying OAM component information...........................................................................................348Displaying status of z/OS UNIX System Services .............................................................................349Displaying operator information (OPDATA)....................................................................................... 368Displaying PCIE information.............................................................................................................. 369Displaying PARMLIB information.......................................................................................................369Displaying commands defined for PFKs............................................................................................372Displaying PPTs.................................................................................................................................. 373Displaying registered products..........................................................................................................375Displaying entries in the list of APF-authorized libraries..................................................................376Displaying PROG defaults.................................................................................................................. 377Displaying dynamic exits....................................................................................................................378Displaying LNKLST information......................................................................................................... 380Displaying LPA information................................................................................................................ 381Displaying the status of the REFRPROT option................................................................................. 381Displaying the status of the TRACKDIRLOAD option........................................................................ 382Displaying system requests............................................................................................................... 382Displaying resource recovery services (RRS) information................................................................ 387Displaying SLIP trap information....................................................................................................... 390Displaying SMF data...........................................................................................................................391Displaying the in-storage copy of the SMF limits.............................................................................. 392Displaying storage management subsystem information.................................................................395Displaying information about all subsystems................................................................................... 411Displaying static system symbols......................................................................................................414Displaying the local and coordinated universal time and date.........................................................415Displaying component or transaction trace status........................................................................... 415Displaying device status and allocation............................................................................................ 419Displaying Unicode services.............................................................................................................. 421Displaying virtual storage information...............................................................................................424Displaying workload manager information........................................................................................424Displaying cross system coupling facility (XCF) information............................................................ 430

DUMP command...................................................................................................................................... 441Wildcards............................................................................................................................................441Syntax................................................................................................................................................. 441Parameters......................................................................................................................................... 442Specifying dump options................................................................................................................... 443

DUMPDS command..................................................................................................................................459

vii

Syntax................................................................................................................................................. 460Adding system dump resources........................................................................................................ 460Enabling and disabling automatic dump data set allocation............................................................463Making dump data sets ready to receive dumps...............................................................................464Deleting system dump resources...................................................................................................... 464Setting the name-pattern for dump data sets...................................................................................466

FORCE command..................................................................................................................................... 467Considerations................................................................................................................................... 468Syntax................................................................................................................................................. 469Parameters......................................................................................................................................... 469

HALT command........................................................................................................................................471Syntax................................................................................................................................................. 472

IOACTION command...............................................................................................................................472Syntax................................................................................................................................................. 472Parameters......................................................................................................................................... 473

LIBRARY command................................................................................................................................. 474LOG command......................................................................................................................................... 474

Syntax................................................................................................................................................. 474Parameters......................................................................................................................................... 474

LOGOFF command...................................................................................................................................474Syntax................................................................................................................................................. 474

LOGON command.................................................................................................................................... 475Syntax................................................................................................................................................. 476Parameters......................................................................................................................................... 476

MODE command...................................................................................................................................... 477Syntax................................................................................................................................................. 478Controlling the recording of hard machine check interruptions....................................................... 480Controlling the recording of system recovery and degradation machine check interruptions........481Displaying recording and monitoring status......................................................................................483

MODIFY command...................................................................................................................................483Summary of MODIFY..........................................................................................................................483Using asterisks in MODIFY commands..............................................................................................485MODIFY command syntax................................................................................................................. 486Syntax................................................................................................................................................. 486Parameters......................................................................................................................................... 487Passing information to a z/OS UNIX System Services application................................................... 488Controlling the CIM server................................................................................................................. 488Modifying TSO/VTAM time sharing.................................................................................................... 489Communicating with System REXX................................................................................................... 490Controlling z/OS UNIX System Services (z/OS UNIX)....................................................................... 492Communicating with the catalog address space.............................................................................. 498Processing the common event adapter (CEA) parameters...............................................................498Refreshing the common event adapter (CEA) component information........................................... 499Displaying the common event adapter (CEA) component TSO/E address space information........ 499Managing common event adapter (CEA) REXX exec tracing ............................................................500Displaying the common event adapter (CEA) environment..............................................................500Disconnecting the common event adapter (CEA) from the IPCS sysplex dump directory data set 502Adjusting the common event adapter (CEA) mode of operation...................................................... 502Communicating with the device manager address space................................................................ 503Changing the DLF processing mode.................................................................................................. 507Changing the DLF parameters........................................................................................................... 507Displaying DLF status.........................................................................................................................508Starting, configuring, and stopping hardware event data collection................................................508Building and replacing library lookaside directories.........................................................................519Operating with the network file system server................................................................................. 520Managing the object access method (OAM)......................................................................................520Recycling z/OS UNIX System Services (z/OS UNIX)......................................................................... 520Dynamically activating maintenance for z/OS UNIX System Services (z/OS UNIX)........................ 521

viii

Stopping a physical file system (PFS) through a logical file system (LFS) interface........................ 522Passing a MODIFY command string to a physical file system (PFS) through a logical file system

(LFS).............................................................................................................................................. 522Replacing the sysplex root file system in the shared file system configuration (z/OS UNIX)..........523Stopping a temporary file system (TFS)............................................................................................ 524Changing the virtual lookaside facility (VLF) parameters................................................................. 524Enabling and disabling the Application Response Measurement (ARM) services........................... 524Changing workload manager resource states................................................................................... 525Specifying data set selection criteria for an external writer............................................................. 525Causing an external writer to pause.................................................................................................. 527MODIFY (F) JES3 commands.............................................................................................................529

MONITOR command................................................................................................................................529Scope in a sysplex.............................................................................................................................. 530Syntax................................................................................................................................................. 530Parameters......................................................................................................................................... 530

MOUNT command................................................................................................................................... 531Scope in a sysplex.............................................................................................................................. 531Syntax................................................................................................................................................. 531Parameters......................................................................................................................................... 531Tape library dataserver considerations............................................................................................. 532Tape multi-volume considerations.................................................................................................... 532

PAGEADD command................................................................................................................................533Syntax................................................................................................................................................. 534Parameters......................................................................................................................................... 534

PAGEDEL command.................................................................................................................................534Syntax................................................................................................................................................. 535Parameters......................................................................................................................................... 535

QUIESCE command................................................................................................................................. 536Syntax................................................................................................................................................. 537

REPLY command......................................................................................................................................537Using system symbols in REPLY commands..................................................................................... 538Scope in a sysplex.............................................................................................................................. 538Syntax................................................................................................................................................. 538Replying to system information requests..........................................................................................538Replying to system requests during recovery processing.................................................................539Replying to system security WTORs.................................................................................................. 539Setting the time-of-day clock............................................................................................................ 539Specifying component trace options.................................................................................................541Specifying dump options................................................................................................................... 541Specifying SMF options......................................................................................................................542Specifying system parameters.......................................................................................................... 542

RESET command..................................................................................................................................... 543Scope in a sysplex.............................................................................................................................. 544Syntax................................................................................................................................................. 544Forcing a hung console offline or freeing console resources............................................................544Changing service classes or quiescing work..................................................................................... 545

ROUTE command.....................................................................................................................................547Restrictions........................................................................................................................................ 547How MVS displays aggregated response from ROUTE..................................................................... 548Using system symbols in ROUTE commands.................................................................................... 549Syntax................................................................................................................................................. 549Parameters......................................................................................................................................... 550

SEND command.......................................................................................................................................553Scope in a sysplex.............................................................................................................................. 554Syntax................................................................................................................................................. 554Communicating with other operators................................................................................................554Communicating with specified users.................................................................................................555Communicating with all logged-on terminal users........................................................................... 556

ix

Saving messages in the broadcast data set...................................................................................... 557Listing the notices section of the broadcast data set....................................................................... 558Deleting a message from the broadcast data set (notices section)................................................. 558

SET command..........................................................................................................................................559Scope in a sysplex.............................................................................................................................. 560Syntax................................................................................................................................................. 561Parameters......................................................................................................................................... 562

SETALLOC command............................................................................................................................... 571Syntax................................................................................................................................................. 571Parameters......................................................................................................................................... 573

SETAPPC command................................................................................................................................. 582Syntax................................................................................................................................................. 583Parameters......................................................................................................................................... 583

SETAUTOR command.............................................................................................................................. 587Syntax................................................................................................................................................. 587Parameters......................................................................................................................................... 588Examples............................................................................................................................................ 588

SETCEE command................................................................................................................................... 588Syntax................................................................................................................................................. 588Parameters......................................................................................................................................... 589

SETCON command...................................................................................................................................589Scope in a sysplex.............................................................................................................................. 590Syntax................................................................................................................................................. 590Parameters......................................................................................................................................... 590

SETETR command................................................................................................................................... 590Syntax................................................................................................................................................. 591Parameters......................................................................................................................................... 591

SETFXE command................................................................................................................................... 591Syntax................................................................................................................................................. 591Parameters......................................................................................................................................... 591

SETGRS command...................................................................................................................................593Syntax................................................................................................................................................. 593Parameters......................................................................................................................................... 593

SETGTZ command................................................................................................................................... 597Syntax................................................................................................................................................. 597SETGTZ TRACKING command........................................................................................................... 598SETGTZ CLEAR command.................................................................................................................. 598SETGTZ EXCLUDE command............................................................................................................. 598SETGTZ DEBUG command.................................................................................................................603SETGTZ DIAGNOSE command...........................................................................................................604SETGTZ PERSIST command.............................................................................................................. 604

SETHS command..................................................................................................................................... 605Syntax................................................................................................................................................. 605

SETICSF command.................................................................................................................................. 606SETIOS command....................................................................................................................................607

Syntax................................................................................................................................................. 607Parameters......................................................................................................................................... 609

SETLOAD command.................................................................................................................................617Syntax................................................................................................................................................. 617

SETLOGRC command.............................................................................................................................. 618SETOMVS command................................................................................................................................ 619

Syntax................................................................................................................................................. 619Parameters......................................................................................................................................... 620

SETPROG command................................................................................................................................ 630Updating dynamic exits......................................................................................................................631Updating LNKLST concatenations..................................................................................................... 635Tracking directed load modules........................................................................................................ 639

SETSMF command...................................................................................................................................639

x

SETSMS command...................................................................................................................................639Parameters......................................................................................................................................... 641

SETSSI command.................................................................................................................................... 654SETUNI command................................................................................................................................... 654

Parameters......................................................................................................................................... 654SLIP command.........................................................................................................................................665

Syntax................................................................................................................................................. 665Using SLIP commands....................................................................................................................... 666Processing of SLIP commands.......................................................................................................... 666Coding SLIP command parameters...................................................................................................666Setting a SLIP trap..............................................................................................................................669Modifying an existing SLIP trap......................................................................................................... 727Deleting an existing SLIP trap............................................................................................................727

START command......................................................................................................................................727Starting a system task from a console...............................................................................................728Starting the APPC/MVS address space..............................................................................................732Starting the APPC/MVS transaction scheduler address space.........................................................733Starting the Common Event Adapter address space........................................................................ 733Starting the Generalized Trace Facility..............................................................................................734Starting IBM Generic Tracker for z/OS.............................................................................................. 735Starting hardware instrumentation services (HIS) ...........................................................................736Starting the Base Control Program internal interface (BCPii) address space after BCPii has

been terminated............................................................................................................................736Starting IBM Health Checker for z/OS............................................................................................... 737Starting the library lookaside (LLA) address space...........................................................................737Starting the Object Access Method (OAM)........................................................................................ 738Starting Resource Recovery Services (RRS)......................................................................................738Starting the System Object Model (SOM) subsystem....................................................................... 739Starting TSO/VTAM time-sharing.......................................................................................................740Starting the virtual lookaside facility or data lookaside facility........................................................ 741Starting an external writer................................................................................................................. 742

STOP command....................................................................................................................................... 743Stopping a running program.............................................................................................................. 743Stopping an ASCH initiator.................................................................................................................744Stopping the data lookaside facility (DLF).........................................................................................744Stopping the generalized tracking facility......................................................................................... 744Stopping the hardware instrumentation services (HIS) ...................................................................744Stopping the Base Control Program internal interface (BCPii) address space................................ 745Stopping IBM Health Checker for z/OS............................................................................................. 745Stopping the library lookaside (LLA) address space......................................................................... 746Stopping the Object Access Method (OAM) Address Space............................................................. 746Stopping a System Object Model (SOM)............................................................................................746Stopping a temporary file system (TFS)............................................................................................ 747Stopping the virtual lookaside facility (VLF)......................................................................................747

SWAP command...................................................................................................................................... 747Operator-requested DDR................................................................................................................... 748System-initiated DDR.........................................................................................................................749

TRACE command..................................................................................................................................... 749Specifying TRACE CT options.............................................................................................................749

VARY command....................................................................................................................................... 751Controlling problem determination mode for the system console...................................................753Controlling hardcopy processing....................................................................................................... 754Placing a console online or offline..................................................................................................... 757Processing devices or a path to devices attached to a control unit..................................................758Defining a tape device as automatically switchable......................................................................... 759Placing an I/O device or a range of I/O devices online or offline......................................................759Allowing or preventing allocation from using an offline tape device................................................763Controlling a global resource serialization complex......................................................................... 764

xi

Placing an I/O Path or Paths Online or Offline.................................................................................. 765Changing the zHyperLink eligibility of a data set.............................................................................. 768Changing the state of coupling facility cache structures and volumes............................................ 769Placing an optical drive or library online or offline............................................................................771Placing a system-managed tape library online or offline..................................................................772Analyzing the state of the PDSE subsystem......................................................................................772Releasing PDSE latches..................................................................................................................... 772Modifying processing of PDSE monitor..............................................................................................772Display current state of the PDSE monitor........................................................................................ 773Changing the SMS status of a storage group or volume....................................................................773Updating space statistics for volumes in the SMS configuration......................................................775Controlling DFSMStvs processing......................................................................................................776Placing a switch port online or offline............................................................................................... 783Controlling an application environment............................................................................................ 784Activating a service policy..................................................................................................................784Removing a System from the XCF Sysplex........................................................................................ 785

Chapter 5. System REXX commands reference................................................... 789Displaying real storage memory statistics..............................................................................................789

Appendix A. HIS MAP format............................................................................. 791

Appendix B. Accessibility...................................................................................799Accessibility features.............................................................................................................................. 799Consult assistive technologies................................................................................................................ 799Keyboard navigation of the user interface.............................................................................................. 799Dotted decimal syntax diagrams.............................................................................................................799

Notices..............................................................................................................803Terms and conditions for product documentation................................................................................. 804IBM Online Privacy Statement................................................................................................................ 805Policy for unsupported hardware............................................................................................................805Minimum supported hardware................................................................................................................806

Index................................................................................................................ 807

xii

Figures

1. Format of the LOAD parameter..................................................................................................................... 4

2. Example of a Successful Response to a DISPLAY AUTOSWITCH Command............................................ 26

3. Boxed device recovery procedure.............................................................................................................. 31

4. Data structure of a guest program parameter under a TCB.......................................................................45

5. Data structure of a guest program parameter under an SRB.....................................................................45

6. DASD Devices shared between two systems............................................................................................. 55

7. DASD device shared by three systems....................................................................................................... 64

8. Example of a switched fabric...................................................................................................................... 65

9. Example of source and destination directors.............................................................................................66

10. Example of static routing in a switched fabric......................................................................................... 67

11. Example of dynamic routing in a switched fabric.................................................................................... 67

12. Example of link aggregation......................................................................................................................68

13. Example of static routing with aggregate links........................................................................................ 71

14. Example of dynamic routing..................................................................................................................... 72

15. Comparison of the display screens of full-capability and output-only display consoles....................... 92

16. DISPLAY CONSOLES,BACKLOG command output.................................................................................104

17. DISPLAY CONSOLES,ROUT=5 command output................................................................................... 109

18. Format of a console screen in message stream mode.......................................................................... 124

19. Typical system command format........................................................................................................... 153

20. System command format required for some commands...................................................................... 154

21. Display output illustration (column descriptions)..................................................................................325

22. Display output from D A,WTOR (Membername).................................................................................... 325

23. Display output for D A,WTOR (Membername and Identifier)................................................................ 325

xiii

24. Display output for D A,WTOR (Membername and JOBNAME).............................................................. 326

25. Display output from D A,SYM1............................................................................................................... 326

26. Display output from D A,SYMTEST......................................................................................................... 326

27. Display output from D A,SYMBOLS........................................................................................................ 326

28. Sample output for the DISPLAY SMFLIM,S command...........................................................................393

29. Sample output for the DISPLAY SMFLIM,R command.......................................................................... 394

30. Output of DISPLAY SMFLIM,R,MEMBER=SMFLIMU6,RULE=1 .............................................................394

31. DISPLAY SMS command syntax............................................................................................................. 396

32. Output for SET SMFLIM=(S1,S2,C) ........................................................................................................ 571

33. IEAVTSZR procedure example............................................................................................................... 677

xiv

Tables

1. Possible values for IMS characters...............................................................................................................5

2. MVS system commands with sysplex scope.............................................................................................. 11

3. Correcting boxed conditions....................................................................................................................... 31

4. z/OS UNIX files generated by the HIS Profiler........................................................................................... 41

5. IBM Defaults for PFKs................................................................................................................................. 96

6. Checking the Commands Defined for Each PFK.........................................................................................96

7. Comparison of system commands and CONSOLE parameters in CONSOLxx.........................................106

8. Comparison of system commands and INIT statements in CONSOLxx..................................................107

9. Comparison of VARY HARDCPY commands and HARDCOPY statements in CONSOLxx........................108

10. Command groups used to determine command authority....................................................................111

11. MVS Commands, RACF Access Authorities, and Resource Names.......................................................112

12. Message Routing Codes..........................................................................................................................126

13. System command summary................................................................................................................... 138

14. Syntax conventions.................................................................................................................................152

15. Specifying FORCE with EMIF.................................................................................................................. 157

16. CANCEL Command Tasks....................................................................................................................... 158

17. Summary of common CHNGDUMP tasks............................................................................................... 163

18. Affects on the CSA storage captured in an SVC dump...........................................................................167

19. Example of how CHNGDUMP commands affect dump modes and options......................................... 172

20. Summary of the CONFIG Command...................................................................................................... 186

21. Summary of the CONTROL Command....................................................................................................199

22. Sysplex Scope for CONTROL Command.................................................................................................200

23. Summary of the DISPLAY command......................................................................................................239

xv

24. Sysplex Scope for DISPLAY Command.................................................................................................. 242

25. Summary of the Display GTZ Command................................................................................................ 288

26. Displaying System Activity: Information for the LIST Operand.............................................................317

27. Displaying System Activity: Information for the ALL Operand.............................................................. 318

28. Displaying System Activity: Information for a Specific Name............................................................... 320

29. Examples of START Commands to Start Jobs........................................................................................322

30. Examples of DISPLAY Commands..........................................................................................................322

31. Affects on the CSA storage captured in an SVC dump...........................................................................448

32. Summary of the DUMPDS Command..................................................................................................... 459

33. FORCE command tasks...........................................................................................................................468

34. Summary of the MODE Command..........................................................................................................478

35. MODE parameters allowed for machine check interruptions................................................................479

36. Summary of the MODIFY command.......................................................................................................483

37. Examples of START commands to start jobs......................................................................................... 486

38. Examples of MODIFY commands...........................................................................................................486

39. Possible Volume and Device Combinations on MOUNT Command.......................................................532

40. Summary of the REPLY Command..........................................................................................................537

41. Summary of the RESET Command......................................................................................................... 543

42. Summary of the SEND Command...........................................................................................................554

43. Sysplex Scope for SET Command...........................................................................................................560

44. Syntax for the SET command................................................................................................................. 561

45. Summary of the SETGTZ command....................................................................................................... 597

46. SETGTZ TRACKING command................................................................................................................598

47. SETGTZ CLEAR command.......................................................................................................................598

48. SETGTZ EXCLUDE command.................................................................................................................. 599

xvi

49. SETGTZ DEBUG command......................................................................................................................603

50. SETGTZ DIAGNOSE command............................................................................................................... 604

51. SETGTZ PERSIST command................................................................................................................... 605

52. One-character parameter limit multipliers............................................................................................ 620

53. Comparison of SET SMS with SETSMS................................................................................................... 641

54. Incorrect Combinations of SETSMS Parameters................................................................................... 641

55. Summary of the SLIP Command............................................................................................................ 665

56. Affects on the CSA storage captured in an SVC dump...........................................................................720

57. Summary of the START command..........................................................................................................727

58. Summary of the STOP Command........................................................................................................... 743

59. Summary of the SWAP Command.......................................................................................................... 748

60. Summary of the VARY Command........................................................................................................... 751

61. General map record header format........................................................................................................791

62. Type I - Information record.................................................................................................................... 791

63. Type B = Boundary record...................................................................................................................... 792

64. Type A = Address Space record .............................................................................................................793

65. Type M = Module record......................................................................................................................... 793

66. Type C= CSECT record............................................................................................................................ 795

67. Type E = Entry Point ............................................................................................................................... 797

xvii

xviii

About this information

This information describes how to use MVS™ system operator commands for the z/OS operating system.Although you can also perform many of the tasks described in this information using JES2 or JES3commands, this information describes only the MVS (base control program) system commands. Forinformation about commands for other z/OS elements, such as z/OS Communications Server (IP andSNA), DFSMS, JES2, JES3, and RACF®, see z/OS Information Roadmap. For information about commandsfor other software products that run on z/OS, see z/OS Software Products Collection, SK3T-4270.

Who should use this informationThis information is intended for anyone using a console and system commands to control the operatingsystem. This i