z/OSVersion 2 Release 4

MVS System Commands

IBM

SA38-0666-40

Note

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

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

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

Contents

Figures................................................................................................................ xv

Tables............................................................................................................... xvii

About this information........................................................................................ xxiWho should use this information.............................................................................................................. xxiHow to use this information...................................................................................................................... xxiz/OS information........................................................................................................................................xxi

How to send your comments to IBM...................................................................xxiiiIf you have a technical problem.............................................................................................................. xxiii

Summary of changes.......................................................................................... xxvSummary of changes for z/OS MVS System Commands for Version 2 Release 4 (V2R4)......................xxvSummary of changes in z/OS Version 2 Release 3 (V2R3).................................................................... xxviiSummary of changes for z/OS Version 2 Release 2 (V2R2) as updated December 2016.................... xxixSummary of changes for z/OS Version 2 Release 2 (V2R2) as updated June 2016............................. xxixSummary of changes for z/OS Version 2 Release 2 (V2R2) as updated March 2016........................... xxixSummary of changes for z/OS Version 2 Release 2 (V2R2) as updated December 2015.................... xxixSummary of changes in z/OS Version 2 Release 2 (V2R2)......................................................................xxx

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.....................................................................................................................................20Deferred restart....................................................................................................................................21

Controlling started tasks........................................................................................................................... 21

iii

Controlling system information recording................................................................................................ 22System management facilities.............................................................................................................22System trace.........................................................................................................................................23The generalized trace facility...............................................................................................................23Master 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..................................................................................................................................27Device boxing....................................................................................................................................... 28

Command flooding.....................................................................................................................................31Class M1 commands............................................................................................................................ 31Class M2 commands............................................................................................................................ 32Class M3 commands............................................................................................................................ 34Class C1 commands............................................................................................................................. 34Class C2 commands............................................................................................................................. 34Class C3 commands............................................................................................................................. 34Inline commands..................................................................................................................................34

Setting up hardware event data collection............................................................................................... 35Accessing the output from a hardware event data collection run........................................................... 38

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

Hardware problems..............................................................................................................................47Information provided with machine checks........................................................................................47CPU errors.............................................................................................................................................48Service processor damage...................................................................................................................50Storage errors.......................................................................................................................................51Channel subsystem errors................................................................................................................... 52I/O device errors.................................................................................................................................. 55Diagnosing problems in a switched fabric...........................................................................................63Additional recovery actions..................................................................................................................75

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

Uniprocessor (UP)................................................................................................................................ 78Multiprocessor (MP)............................................................................................................................. 78

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

Reconfiguring central storage................................................................................................................... 80Physical view of central storage.......................................................................................................... 80Specifying the RSU parameter............................................................................................................. 81

Reconfiguring channel paths..................................................................................................................... 84

iv

Actions to reconfigure channel paths.................................................................................................. 84Reconfiguring I/O devices......................................................................................................................... 85Reconfiguring a coupling facility............................................................................................................... 85

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

General characteristics of display consoles........................................................................................87Operations on display consoles in full-capability mode..................................................................... 91Handling consoles in error conditions................................................................................................. 99Placing a console in offline status..................................................................................................... 103Interchanging your consoles on a control unit..................................................................................103

Defining and changing console characteristics...................................................................................... 103Using operator commands to change CONSOLxx statements......................................................... 104Changing console characteristics......................................................................................................108Controlling system messages and commands..................................................................................123Defining program function keys (PFKs)............................................................................................. 129Processing hardcopy..........................................................................................................................132

Chapter 4. MVS system commands reference..................................................... 135Command syntax notation...................................................................................................................... 149

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

Typical format.................................................................................................................................... 151A second format................................................................................................................................. 152

ACTIVATE command............................................................................................................................... 152Restrictions........................................................................................................................................ 152Syntax................................................................................................................................................. 152Parameters......................................................................................................................................... 153

CANCEL command...................................................................................................................................156Syntax................................................................................................................................................. 157Parameters......................................................................................................................................... 157

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

CMDS command...................................................................................................................................... 182Syntax................................................................................................................................................. 182Parameters......................................................................................................................................... 182

CONFIG command...................................................................................................................................184Syntax................................................................................................................................................. 185Reconfiguring the system directly..................................................................................................... 185Reconfiguring the system with a CONFIGxx parmlib member.........................................................195Reconfiguring the system in response to a configuration display.................................................... 196

CONTROL command................................................................................................................................197Scope in a sysplex..............................................................................................................................198Syntax................................................................................................................................................. 199Changing out of line display area specifications............................................................................... 199Deleting retained action messages................................................................................................... 200Halting the printing or the display of a status display.......................................................................201Controlling displays in areas..............................................................................................................202

v

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

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

DISPLAY command..................................................................................................................................238Scope in a sysplex..............................................................................................................................241Syntax................................................................................................................................................. 242Displaying MVS device allocation group locks information.............................................................. 243Displaying MVS device allocation settings information.................................................................... 244Displaying MVS device allocation IGDE information.........................................................................244Displaying APPC/MVS information.................................................................................................... 245Displaying ASCH configuration information...................................................................................... 249Displaying auxiliary storage information........................................................................................... 251Displaying auto-reply policy and WTORs information...................................................................... 253Displaying the current system-level Language Environment runtime options................................ 254Displaying CONTROL command functions........................................................................................ 256Displaying attached coupling facility information.............................................................................256Displaying console group definitions.................................................................................................257Displaying console status information.............................................................................................. 258Displaying DEVSUP settings...............................................................................................................262Displaying 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.......................................................................................... 304Displaying captured UCB information............................................................................................... 304Displaying IOS control unit group information..................................................................................305Displaying dynamic channel path management information........................................................... 306Displaying encryption key manager (EKM) status.............................................................................306Displaying zHPF facility status...........................................................................................................307Displaying FICON switch data information....................................................................................... 307

vi

Displaying IOS group information......................................................................................................308Displaying IOS HYPERPAV information............................................................................................. 308Displaying the IBM zHyperWrite data replication status.................................................................. 308Displaying MIDAW facility status.......................................................................................................309Displaying MIH and I/O timing limits.................................................................................................309Displaying IOS recovery options .......................................................................................................312Displaying the IOSSPOF system service options ............................................................................. 312Displaying IOS storage residency information..................................................................................313Displaying the devices stopped by the IOACTION command.......................................................... 313Displaying the current status of the zHyperLink facility................................................................... 313Displaying IPL information.................................................................................................................314Displaying PCIE-related parameters.................................................................................................315Displaying parameter settings for the z/OS Management Facility server........................................ 316Displaying system activity..................................................................................................................317Displaying started task status........................................................................................................... 325Displaying library lookaside information...........................................................................................327Displaying the system logger and its log streams.............................................................................328Displaying the logrec recording medium...........................................................................................338Displaying system configuration information....................................................................................339Displaying message flood automation information.......................................................................... 345Displaying MVS message service status and languages...................................................................347Displaying message suppression, retention, color, intensity, and highlighting options..................347Displaying OAM component information...........................................................................................349Displaying status of z/OS UNIX System Services .............................................................................350Displaying operator information (OPDATA).......................................................................................367Displaying PCIE information.............................................................................................................. 368Displaying PARMLIB information.......................................................................................................369Displaying commands defined for PFKs............................................................................................371Displaying PPTs..................................................................................................................................372Displaying registered products..........................................................................................................374Displaying entries in the list of APF-authorized libraries..................................................................377Displaying PROG defaults.................................................................................................................. 378Displaying dynamic exits................................................................................................................... 378Displaying LNKLST information......................................................................................................... 380Displaying LPA information................................................................................................................382Displaying the status of the REFRPROT option.................................................................................382Displaying the status of the TRACKDIRLOAD option........................................................................ 382Displaying system requests...............................................................................................................383Displaying resource recovery services (RRS) information................................................................ 388Displaying SLIP trap information.......................................................................................................391Displaying SMF data...........................................................................................................................392Displaying the in-storage copy of the SMF limits..............................................................................393Displaying storage management subsystem information................................................................ 396Displaying information about all subsystems................................................................................... 412Displaying static system symbols......................................................................................................415Displaying the local and coordinated universal time and date.........................................................416Displaying component or transaction trace status........................................................................... 416Displaying device status and allocation............................................................................................ 420Displaying Unicode services.............................................................................................................. 422Displaying virtual storage information.............................................................................................. 425Displaying workload manager information....................................................................................... 425Displaying cross system coupling facility (XCF) information............................................................431

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

DUMPDS command................................................................................................................................. 460

vii

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

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

HALT command....................................................................................................................................... 472Syntax................................................................................................................................................. 473

IOACTION command...............................................................................................................................473Syntax................................................................................................................................................. 473Parameters......................................................................................................................................... 474

LIBRARY command................................................................................................................................. 475LOG command......................................................................................................................................... 475

Syntax................................................................................................................................................. 475Parameters......................................................................................................................................... 475

LOGOFF command...................................................................................................................................475Syntax................................................................................................................................................. 475

LOGON command.................................................................................................................................... 476Syntax................................................................................................................................................. 477Parameters......................................................................................................................................... 477

MODE command...................................................................................................................................... 478Syntax................................................................................................................................................. 479Controlling the recording of hard machine check interruptions.......................................................481Controlling the recording of system recovery and degradation machine check interruptions........482Displaying recording and monitoring status......................................................................................484

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

viii

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

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

MONITOR command................................................................................................................................533Scope in a sysplex..............................................................................................................................534Syntax................................................................................................................................................. 534Parameters......................................................................................................................................... 534

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

PAGEADD command................................................................................................................................537Syntax................................................................................................................................................. 538Parameters......................................................................................................................................... 538

PAGEDEL command.................................................................................................................................538Syntax................................................................................................................................................. 539Parameters......................................................................................................................................... 539

QUIESCE command................................................................................................................................. 540Syntax................................................................................................................................................. 540

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

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

ROUTE command.....................................................................................................................................550Restrictions........................................................................................................................................ 551How MVS displays aggregated response from ROUTE..................................................................... 551Using system symbols in ROUTE commands....................................................................................552Syntax................................................................................................................................................. 553Parameters......................................................................................................................................... 553

SEND command.......................................................................................................................................557Scope in a sysplex..............................................................................................................................557Syntax................................................................................................................................................. 558Communicating with other operators................................................................................................558Communicating with specified users.................................................................................................558Communicating with all logged-on terminal users........................................................................... 560

ix

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

SET command..........................................................................................................................................562Scope in a sysplex..............................................................................................................................564Syntax................................................................................................................................................. 564Parameters......................................................................................................................................... 565

SETALLOC command............................................................................................................................... 576Syntax................................................................................................................................................. 576Parameters......................................................................................................................................... 577

SETAPPC command.................................................................................................................................586Syntax................................................................................................................................................. 587Parameters......................................................................................................................................... 587

SETAUTOR command.............................................................................................................................. 591Syntax................................................................................................................................................. 591Parameters......................................................................................................................................... 592Examples............................................................................................................................................ 592

SETCEE command................................................................................................................................... 592Syntax................................................................................................................................................. 592Parameters......................................................................................................................................... 593

SETCON command.................................................................................................................................. 593Scope in a sysplex..............................................................................................................................594Syntax................................................................................................................................................. 594Parameters......................................................................................................................................... 594

SETETR command................................................................................................................................... 595Syntax................................................................................................................................................. 595Parameters......................................................................................................................................... 595

SETFXE command................................................................................................................................... 595Syntax................................................................................................................................................. 595Parameters......................................................................................................................................... 596

SETGRS command...................................................................................................................................597Syntax................................................................................................................................................. 597Parameters......................................................................................................................................... 597

SETGTZ command................................................................................................................................... 601Syntax................................................................................................................................................. 601SETGTZ TRACKING command...........................................................................................................602SETGTZ CLEAR command..................................................................................................................602SETGTZ EXCLUDE command............................................................................................................. 603SETGTZ DEBUG command.................................................................................................................607SETGTZ DIAGNOSE command.......................................................................................................... 608SETGTZ PERSIST command.............................................................................................................. 609

SETHS command..................................................................................................................................... 609Syntax................................................................................................................................................. 609

SETICSF command..................................................................................................................................610SETIOS command....................................................................................................................................610

Syntax................................................................................................................................................. 611Parameters......................................................................................................................................... 612

SETIZU command....................................................................................................................................621Syntax................................................................................................................................................. 622Parameters......................................................................................................................................... 623

SETLOAD command.................................................................................................................................628Syntax................................................................................................................................................. 628Parameters......................................................................................................................................... 629

SETLOGR command.................................................................................................................................630Scope in a Sysplex..............................................................................................................................631Syntax................................................................................................................................................. 631SETLOGR CTRACE command.............................................................................................................631SETLOGR FORCE command...............................................................................................................632

x

SETLOGR MANAGE command........................................................................................................... 638SETLOGR MONITOR command......................................................................................................... 641SETLOGR ZAI command.................................................................................................................... 643

SETLOGRC command.............................................................................................................................. 646Syntax................................................................................................................................................. 647Parameters......................................................................................................................................... 647

SETMF command.....................................................................................................................................648Syntax................................................................................................................................................. 648Parameters......................................................................................................................................... 648

SETOMVS command................................................................................................................................ 650Syntax................................................................................................................................................. 650Parameters......................................................................................................................................... 652

SETPROG command................................................................................................................................ 661Syntax................................................................................................................................................. 662Updating the APF list..........................................................................................................................662Updating dynamic exits......................................................................................................................664Updating LNKLST concatenations..................................................................................................... 668Managing dynamic LPA content.........................................................................................................672Protecting REFR programs.................................................................................................................675Tracking directed load modules........................................................................................................ 675

SETRRS command................................................................................................................................... 676Syntax................................................................................................................................................. 676SETRRS ARCHIVELOGGING command............................................................................................. 676SETRRS CANCEL command............................................................................................................... 677SETRRS SHUTDOWN command........................................................................................................ 678

SETSMF command...................................................................................................................................679Syntax................................................................................................................................................. 679Parameters......................................................................................................................................... 679

SETSMS command...................................................................................................................................680Scope in a sysplex..............................................................................................................................682Syntax................................................................................................................................................. 682Parameters......................................................................................................................................... 683

SETSSI command.................................................................................................................................... 696Syntax................................................................................................................................................. 697Parameters......................................................................................................................................... 697

SETUNI command................................................................................................................................... 699Syntax................................................................................................................................................. 699Parameters......................................................................................................................................... 700

SETXCF command................................................................................................................................... 711Scope in a sysplex..............................................................................................................................711Syntax................................................................................................................................................. 712SETXCF COUPLE command............................................................................................................... 712SETXCF DUMPCF command.............................................................................................................. 715SETXCF FORCE command..................................................................................................................715SETXCF FUNCTIONS command.........................................................................................................717SETXCF MODIFY command............................................................................................................... 718SETXCF PRSMPOLICY command.......................................................................................................721SETXCF START command..................................................................................................................721SETXCF STOP command....................................................................................................................729

SLIP command.........................................................................................................................................733Syntax................................................................................................................................................. 733Using SLIP commands....................................................................................................................... 734Processing of SLIP commands.......................................................................................................... 735Coding SLIP command parameters...................................................................................................735Setting a SLIP trap............................................................................................................................. 740Modifying an existing SLIP trap......................................................................................................... 804Deleting an existing SLIP trap............................................................................................................805

START command..................................................................................................................................... 806

xi

Syntax................................................................................................................................................. 807Starting a system task from a console.............................................................................................. 807Starting the APPC/MVS address space..............................................................................................811Starting the APPC/MVS transaction scheduler address space.........................................................811Starting the Common Event Adapter address space........................................................................ 812Starting the Generalized Trace Facility..............................................................................................812Starting IBM Generic Tracker for z/OS.............................................................................................. 814Starting hardware instrumentation services (HIS) .......................................................................... 814Starting the Base Control Program internal interface (BCPii) address space after BCPii has

been terminated............................................................................................................................815Starting IBM Health Checker for z/OS............................................................................................... 816Starting the library lookaside (LLA) address space...........................................................................816Starting the Object Access Method (OAM)........................................................................................ 817Starting Resource Recovery Services (RRS)......................................................................................817Starting the System Object Model (SOM) subsystem....................................................................... 818Starting TSO/VTAM time-sharing...................................................................................................... 819Starting the virtual lookaside facility or data lookaside facility........................................................ 820Starting an external writer................................................................................................................. 820

STOP command....................................................................................................................................... 821Syntax................................................................................................................................................. 822Stopping a running program.............................................................................................................. 822Parameters......................................................................................................................................... 822Stopping an ASCH initiator.................................................................................................................824Stopping System REXX...................................................................................................................... 825Stopping the data lookaside facility (DLF).........................................................................................825Stopping the generalized tracking facility......................................................................................... 825Stopping the hardware instrumentation services (HIS) .................................................................. 826Stopping the Base Control Program internal interface (BCPii) address space................................ 826Stopping IBM Health Checker for z/OS............................................................................................. 827Stopping the library lookaside (LLA) address space......................................................................... 827Stopping the Object Access Method (OAM) Address Space.............................................................827Stopping a System Object Model (SOM)............................................................................................827Stopping a temporary file system (TFS)............................................................................................ 828Stopping the virtual lookaside facility (VLF)......................................................................................828

STOPMN command..................................................................................................................................828Scope in a sysplex..............................................................................................................................828Syntax................................................................................................................................................. 829Parameters......................................................................................................................................... 829

SWAP command...................................................................................................................................... 829Syntax................................................................................................................................................. 830Operator-requested DDR...................................................................................................................830System-initiated DDR.........................................................................................................................831

SWITCH command.................................................................................................................................. 831Syntax................................................................................................................................................. 831Parameters......................................................................................................................................... 831

TRACE command..................................................................................................................................... 832Syntax................................................................................................................................................. 832Parameters......................................................................................................................................... 832Specifying TRACE CT options.............................................................................................................836Specifying TRACE TT options.............................................................................................................838

UNLOAD command..................................................................................................................................841Scope in a sysplex..............................................................................................................................841Syntax................................................................................................................................................. 841Parameters......................................................................................................................................... 841

VARY command....................................................................................................................................... 841Scope in a sysplex..............................................................................................................................843Syntax................................................................................................................................................. 844Controlling problem determination mode for the system console...................................................844

xii

Controlling MCS, HMCS and SMCS consoles.....................................................................................846Controlling hardcopy processing....................................................................................................... 854Placing a console online or offline.....................................................................................................857Processing devices or a path to devices attached to a control unit................................................. 858Defining a tape device as automatically switchable......................................................................... 859Placing an I/O device or a range of I/O devices online or offline..................................................... 860Allowing or preventing allocation from using an offline tape device................................................863Controlling a global resource serialization complex......................................................................... 864Placing an I/O Path or Paths Online or Offline.................................................................................. 865Changing the zHyperLink eligibility of a data set.............................................................................. 868Changing the state of coupling facility cache structures and volumes............................................ 869Placing an optical drive or library online or offline............................................................................872Placing a system-managed tape library online or offline................................................................. 872Analyzing the state of the PDSE subsystem......................................................................................872Releasing PDSE latches..................................................................................................................... 872Modifying processing of PDSE monitor............................................................................................. 872Displaying current state of the PDSE monitor...................................................................................873Changing the SMS status of a storage group or volume................................................................... 873Updating space statistics for volumes in the SMS configuration......................................................875Validating and correcting the VTOC and VTOCIX for a volume or storage group ............................876Controlling DFSMStvs processing......................................................................................................878Controlling CICSVR processing..........................................................................................................885Placing a switch port online or offline............................................................................................... 886Controlling an application environment............................................................................................ 887Activating a service policy..................................................................................................................889Removing a system from the XCF sysplex........................................................................................ 890

WRITELOG command..............................................................................................................................891Syntax................................................................................................................................................. 892Parameters......................................................................................................................................... 892

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

Appendix A. HIS MAP format............................................................................. 895

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

Notices..............................................................................................................907Terms and conditions for product documentation.................................................................................908IBM Online Privacy Statement................................................................................................................ 909Policy for unsupported hardware............................................................................................................909Minimum supported hardware................................................................................................................909Trademarks..............................................................................................................................................910

Index................................................................................................................ 911

xiii

xiv

Figures

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

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

3. Boxed device recovery procedure.............................................................................................................. 30

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

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

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

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

8. Example of a switched fabric...................................................................................................................... 64

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

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

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

12. Example of link aggregation..................................................................................................................... 66

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

14. Example of dynamic routing..................................................................................................................... 71

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

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

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

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

19. Typical system command format........................................................................................................... 151

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

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

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

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

xv

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

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

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

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

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

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

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

31. DISPLAY SMS command syntax............................................................................................................. 397

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

33. IEAVTSZR procedure example............................................................................................................... 750

xvi

Tables

1. Possible values for IMS characters..