OS/390 IBM

MVS System Commands Summary

GX22-0040-07

OS/390 IBM
MVS System Commands Summary



GX22-0040-07
Note
Before using this information and the product it supports, be sure to read the general information under
Appendix A, Notices on page 151.
Eighth Edition, September 1999
This is a major revision of GX22-0040-06.
This edition applies to Version 2 Release 8 of OS/390 (5647-A01) and to all subsequent releases and modifications
until otherwise indicated in new editions.
Order publications through your IBM representative or the IBM branch office serving your locality. Publications are not
stocked at the address below.
IBM welcomes your comments. A form for readers' comments may be provided at the back of this publication, or you
may address your comments to the following address:
International Business Machines Corporation
Department 55JA, Mail Station P384
522 South Road
Poughkeepsie, New York 12601-5400
United States of America

FAX (United States & Canada): 1+914+432-9405
FAX (Other Countries):
Your International Access Code +1+914+432-9405

IBMLink (United States customers only): IBMUSM10(MHVRCFS)
IBM Mail Exchange: USIB6TC9 at IBMMAIL
Internet e-mail: mhvrcfs@us.ibm.com
World Wide Web: http://www.ibm.com/s390/os390/
If you would like a reply, be sure to include your name, address, telephone number, or FAX number.
Make sure to include the following in your comment or note:
Title and order number of this book
Page number or topic related to your comment
When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way
it believes appropriate without incurring any obligation to you.
Copyright International Business Machines Corporation 1988, 1999. All rights reserved.
US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.

Contents
About This Book . . . . . . . . . . . . . . . . v
Who Should Use This Book . . . . . . . . . . . v
Summary of Changes . . . . . . . . . . . . vii
Syntax Notation . . . . . . . . . . . . . . . xiii
MVS System Commands Syntax . . . . . . . 1
ACTIVATE Command . . . . . . . . . . . . . . 1
CANCEL Command (C) . . . . . . . . . . . . . 2
CHNGDUMP Command (CD) . . . . . . . . . . 3
CONFIG Command (CF) . . . . . . . . . . . . 8
CONTROL Command (K) . . . . . . . . . . . 10
DEVSERV Command (DS) . . . . . . . . . . 16
DISPLAY Command (D) . . . . . . . . . . . . 18
DUMP Command . . . . . . . . . . . . . . . 55
DUMPDS Command (DD) . . . . . . . . . . . 56
FORCE Command . . . . . . . . . . . . . . 59
HALT Command (Z) . . . . . . . . . . . . . . 60
IOACTION Command (IO) . . . . . . . . . . 61
LIBRARY Command (LI) . . . . . . . . . . . 62
LOG Command (L) . . . . . . . . . . . . . . 64
LOGOFF Command . . . . . . . . . . . . . . 65
LOGON Command . . . . . . . . . . . . . . 66
MODE Command . . . . . . . . . . . . . . . 67
MODIFY Command (F) . . . . . . . . . . . . 69
MONITOR Command (MN) . . . . . . . . . . 81
MOUNT Command (M) . . . . . . . . . . . . 82
MSGRT Command (MR) . . . . . . . . . . . 83
PAGEADD Command (PA) . . . . . . . . . . 84
PAGEDEL Command (PD) . . . . . . . . . . 85
QUIESCE Command . . . . . . . . . . . . . 86
REPLY Command (R) . . . . . . . . . . . . . 87
RESET Command (E) . . . . . . . . . . . . . 90
ROUTE Command (RO) . . . . . . . . . . . 91
SEND Command (SE) . . . . . . . . . . . . . 92
SET Command (T) . . . . . . . . . . . . . . 94
SETDMN Command (SD) . . . . . . . . . . . 96
SETETR Command . . . . . . . . . . . . . . 97
SETGRS Command . . . . . . . . . . . . . . 98
SETIOS Command . . . . . . . . . . . . . . 99
SETLOAD Command . . . . . . . . . . . . 100
SETLOGRC Command . . . . . . . . . . . 101
SETOMVS Command . . . . . . . . . . . . 102
SETPROG Command . . . . . . . . . . . . 103
SETRRS CANCEL Command . . . . . . . . 109
SETSMF Command (SS) . . . . . . . . . . 110
SETSMS Command . . . . . . . . . . . . . 111
SETSSI Command . . . . . . . . . . . . . 112
SETXCF Command . . . . . . . . . . . . . 113
SLIP Command (SL) . . . . . . . . . . . . 119
START Command (S) . . . . . . . . . . . . 127
STOP Command (P) . . . . . . . . . . . . 132
STOPMN Command (PM) . . . . . . . . . . 133
STOPTR Command (PT) . . . . . . . . . . 134
SWAP Command (G) . . . . . . . . . . . . 135
SWITCH Command (I) . . . . . . . . . . . 136
TRACE Command . . . . . . . . . . . . . . 137
TRACK Command (TR) . . . . . . . . . . . 138
UNLOAD Command (U) . . . . . . . . . . . 139
VARY Command (V) . . . . . . . . . . . . 140
WRITELOG Command (W) . . . . . . . . . 150
Appendix A. Notices . . . . . . . . . . . 151
Trademarks . . . . . . . . . . . . . . . . . 153
Copyright IBM Corp. 1988, 1999 iii
iv OS/390 V2R8.0 MVS System Commands Summary
About This Book
This book shows the syntax and provides a brief description of the function of the MVS
system commands (also known as "operator commands" or "console commands") you
can use to operate a processor under the OS/390 operating system. It lists the
commands in alphabetical order. For more detailed descriptions of command functions,
syntax, or parameters, see OS/390 MVS System Commands.
Although you can perform many of the tasks described in this book using either system
commands or subsystem (JES2 or JES3) commands, this book describes only the MVS
system commands. For information about JES subsystem commands and their
functions, see OS/390 JES2 Commands or OS/390 JES3 Commands.
For information on system messages referred to in this publication, see OS/390 MVS
System Messages.
Who Should Use This Book
This book is intended for anyone using a console and operator system commands to
control the OS/390 operating system. This book assumes that the user understands
the hardware controls and features of the installation. It also assumes that the user
understands the general organization and functions of an OS/390 system.
Copyright IBM Corp. 1988, 1999 v
vi OS/390 V2R8.0 MVS System Commands Summary
Summary of Changes
| Summary of Changes
| for GX22-0040-07
| OS/390 Version 2 Release 8
| This publication contains information previously presented in GX22-0040-06, which
| supports OS/390 Version 2 Release 7. The following summarizes the changes to that
| information.
| Changed Information
| Two parameters are added to the SETOMVS command: RESET=(xx), and
| SYSCALL_COUNTS=(YES|NO).
| Notices and the list of trademarks used in this book now appear as Appendix A
| following all command descriptions.
| This and each prior edition of this book also reflect the addition, modification, and
| deletion of information to support miscellaneous terminology, maintenance, and editorial
| changes. Vertical lines in the left margin of this edition indicate technical changes or
| additions to the text and illustrations in this edition.
Summary of Changes
for GX22-0040-06
OS/390 Version 2 Release 7
This publication contains information previously presented in GX22-0040-05, which
supports OS/390 Version 2 Release 6. The following summarizes the changes to that
information.
New Information
DISPLAY EMCS command
This command displays the information about extended MCS (EMCS) consoles.
Changed Information
Three new parameters are added to the MODIFY BPXOINIT command:
SHUTDOWN=FORKS, RESTART=FORKS, and DUMP=pid.
New subparameter ECSHR (to support enhanced catalog sharing, ECS), is added
to the MODIFY CATALOG command.
New subparameter REPORT,PERFORMANCE (to display the performance of key
events occurring in the catalog address space) is added to the MODIFY CATALOG
command.
Copyright IBM Corp. 1988, 1999 vii
Summary of Changes
for GX22-0040-05
OS/390 Version 2 Release 6
This publication contains information previously presented in GX22-0040-04, which
supports OS/390 Version 2 Release 5. The following summarizes the changes to that
information.
New Information
DISPLAY LOGGER command
This command displays the current status of the system logger, individual log
streams, or log streams from a sysplex view.
Changed Information
The SYS= parameter is added to the DISPLAY CONSOLES command.
The MCONLY parameter is added to the DISPLAY CONSOLES command.
The TITLE and PARMLIB parameters are added to the DUMP command.
The RESMIL and TOLINT parameters are added to the SETGRS command.
The MSGONLY parameter is added to the SETIOS command.
As part of the name change of OS/390 OpenEdition to OS/390 UNIX System
Services, occurrences of OpenEdition have been changed to OS/390 UNIX System
Services or its abbreviated name, OS/390 UNIX. OpenEdition may continue to
appear in messages, panel text, and other code with OS/390 UNIX.
This edition of the book also reflects the addition, modification, and deletion of
information to support miscellaneous terminology, maintenance, and editorial changes.
These include the addition of a Table of Contents and page headings with the
command names.
Summary of Changes
for GX22-0040-04
OS/390 Version 2 Release 5
This publication contains information previously presented in GX22-0040-03, which
supports OS/390 Version 2 Release 4. The revisions include only terminology,
maintenance, and editorial changes.
Summary of Changes
for GX22-0040-03
OS/390 Version 2 Release 4
The publication contains information previously presented in GX22-0040-02, which
supports OS/390 Version 1 Release 3. The following summarizes the changes to that
information.
viii OS/390 V2R8.0 MVS System Commands Summary
New Information
DISPLAY RTLS
This command displays the current status of the run-time library services (RTLS)
environment.
DISPLAY WLM,RESOURCE=resourcename
This command displays the status of resources.
DISPLAY WLM,SCHENV=schenvname
This command displays the status of scheduling environments.
MODIFY WLM,RESOURCE=resourcename
This command changes resource state settings (to ON, OFF, or RESET).
SET RTLS=xx
This command allows you to change the RTLS configuration.
VARY WLM,POLICY=policyname,REFRESH
This command discards historical workload characterization data, then resets and
activates the named policy and starts data collection anew.
Changed Information
DISPLAY PROG,LPA
This command displays information about modules dynamically added to the LPA,
and displays the minimum amount of CSA and ECSA that must remain after
adding a module to the LPA.
SET PROG=xx
This command activates a PROGxx member containing definitions of modules that
are to be added to or deleted from the LPA after IPL.
SETPROG LPA
This command enables you to identify modules to add to or delete from the LPA
any time after IPL. It also allows you to specify threshhold values for minimum
amounts of CSA storage that still must be available after an ADD operation.
Summary of Changes
for GX22-0040-02
OS/390 Release 3
This publication contains information previously presented in GX22-0040-01, which
supports OS/390 Version 1 Release 2. The following summarizes the changes to that
information.
New Information
SETGRS command
This command provides the ability to migrate from a global resource serialization
(GRS) ring complex to a star complex, without a complex-wide IPL.
Summary of Changes ix
DISPLAY WLM,APPLENV=applenvname
This command displays the status of application environments.
VARY WLM,APPLENV=applenvname
This command controls application environments (with REFRESH, QUIESCE, and
RESUME options).
Changed Information
CANCEL
Special CANCEL considerations may apply if the system is part of a global
resource serialization complex.
Summary of Changes
for GX22-0040-01
OS/390 Release 2
This publication contains information previously presented in GX22-0040-00, which
supports OS/390 Version 1 Release 1. The following summarizes the changes to that
information.
New Information
SETLOAD command
This command provides the ability to change the parmlib concatenation (logical
parmlib) dynamically.
SETGRS command
This command provides the ability to migrate from a global resource serialization
ring complex to a star complex without a complex-wide IPL.
DISPLAY PARMLIB
This command displays information about the logical parmlib setup for a system.
DISPLAY IPLINFO
This command displays information about the general IPL information that the
system uses.
DISPLAY PROG,EXIT,EXITNAME=exitname,DIAG
This command displays diagnostic information about the specified exit, including
entry point and load addresses.
DISPLAY PROG,LNKLST
This command displays information about the LNKLST concatenation defined
through PROGxx or LNKLSTxx.
Changed Information
SETXCF COUPLE
GRS is added to the list of services supported by the TYPE=(name,name...)
parameter.
x OS/390 V2R8.0 MVS System Commands Summary
DISPLAY GRS
The Display command now includes the global resource serialization star
configuration. Message ISG020I is replaced by message ISG343I.
CANCEL
GRS=STAR is added to the list of parameters that invoke global resource
serialization.
Summary of Changes
for GX22-0040-00
OS/390 Release 1
This publication contains information previously presented in GX22-0022, which
supports MVS/ESA System Product Version 5. The revisions include only terminology,
maintenance, and editorial changes.
Summary of Changes xi
xii OS/390 V2R8.0 MVS System Commands Summary

Syntax Notation
You must follow certain syntactical rules when you code commands. As you code the
MVS commands described in this book, use Figure 1 for help with the syntax.
Figure 1. System Command Syntax Notation
Notation Meaning Example Book Syntax
Apostrophes Must be entered as shown. SEND 'message',NOW
Comma Must be entered as shown. DISPLAY C,K
Ellipsis ... The parameter can be repeated. Do not
enter the ellipsis.
VARY (conspec[,conspec]...),ONLINE
Lower Case
Parameter
A parameter must be substituted. You can
enter the command and the parameter in
either upper or lower case.
MOUNT devnum
Or-bar (|) You must enter one of the items. You
cannot enter more than one.
ACTIVATE[,RECOVER=SOURCE|TARGET]
Parentheses and
special characters
Must be entered as shown. DUMP COMM=(text)
Single parameter
in brackets
The parameter is optional. DISPLAY DMN[=domainum]
Stacked items in
braces
You must enter one of the items. You
cannot enter more than one.
MN {DSNAME}
{SPACE }
{STATUS}
Stacked items
with or-bars (|)
and brackets
Optional, mutually exclusive parameters.
Enter one or none.
CD RESET [ ,SDUMP ]
|,SYSABEND
|,SYSUDUMP
|,SYSMDUMP
|,ALL
Underline If you do not enter one of the parameters,
the system supplies the underlined
parameter, which is the default
K T [,REF ]
[,UTME=nnn]
Upper Case
Parameter
The parameter must be spelled as shown.
You can enter the command and the
parameter in either upper or lower case.
DISPLAY SMF
Copyright IBM Corp. 1988, 1999 xiii
xiv OS/390 V2R8.0 MVS System Commands Summary
ACTIVATE Command
MVS System Commands Syntax
ACTIVATE Command
ACTIVATE
ACTIVATE {[,IODF=xx][,EDT=xx][,PROC=procname][,CFID=id] }
{ [,RECOVER=SOURCE|TARGET][,ACTIOCDS=xx] }
{[,SOFT[=VALIDATE|=NOVALIDATE] ] }
{ |,TEST }
{ |,FORCE }
{ |,FORCE={DEVICE } }
{ {CANDIDATE } }
{ {(DEVICE,CANDIDATE)} }
{ {(CANDIDATE,DEVICE)} }
NOTE: Do not specify a comma before the first parameter
following ACTIVATE.
Description:
Dynamically activate or test a new I/O configuration definition.
IODF=xx Activates the SYS1.IODFxx data set. The default is the current data set.
EDT=xx Activates the EDT that the system is to construct from the target IODF. The default is the current EDT.
PROC=procname
Activates the processor whose IODF definition the system will use. The default is the current processor.
CFID=id Activates the configuration identifier that indicates the operating system definition in the target IODF. The default is
the current configuration identifier.
ACTIOCDS=xx
Activates the specified IOCDS name. If you specify only this keyword, the system will not perform any other
dynamic changes.
SOFT={VALIDATE|NOVALIDATE}
Activates only software changes to the I/O configuration. When you specify SOFT, you cannot specify FORCE.
RECOVER Allows the installation to continue a dynamic change.
TEST Activates test mode. The system checks, but does not change, the configuration. When you specify TEST you
cannot specify FORCE.
FORCE Activates the ability to delete hardware resources that may affect other partitions. When you specify FORCE, you
cannot specify SOFT or TEST.
Copyright IBM Corp. 1988, 1999 1
CANCEL Command
CANCEL Command (C)
CANCEL or C
C {jobname }[,DUMP][,A=asid][,ARMRESTART]
{U=userid }
{[jobname.]identifier}
Description:
Immediately end an active job, started task, or time-sharing user.
jobname The named job to end, which can be a batch job, started task, or APPC/MVS transaction program.
U=userid Cancel the specified user or, if the user does not have a unique name yet, cancel the user logging on at address
asid, using the following command: CANCEL U=LOGON, A=asid where asid is the hexadecimal address space
identifier.
[jobname.]identifier
The identifier for the unit of work that you want to cancel, optionally preceded by the job name.
The following types of identifiers can be used:
The identifier that was specified on the START command.
[/]devnum, the device number specified on the START or MOUNT command.
devicetype, the type of device specified on the START or MOUNT command.
DUMP Take a user dump. Dumps are not taken during job allocation or deallocation.
A=asid The hexadecimal address space identifier of the work unit you want to cancel.
ARMRESTART
Indicates the batch job or started task should be automatically restarted, if it has registered as an element of the
automatic restart manager.
2 OS/390 V2R8.0 MVS System Commands Summary
CHNGDUMP Command
CHNGDUMP Command (CD)
CHNGDUMP or CD
CD DEL[,SDUMP[=(option[,option]...)] ]
[ [,Q={YES|NO}] ]
[ [,TYPE={XMEM|XMEME}] ]
[ [,ALL] ]
[ [,SYSFAIL,STRLIST={ALL|(STRNAME=strname[,STRNAME=strname]...)}]]
[ ]
[{,SYSABEND}[,SDATA=(option[,option]...) ] ]
[{,SYSUDUMP} |,PDATA=(option[,option]...) ]
[ |,ALL ]
[ ]
[,SYSMDUMP[=(option[,option]...)] ]
[ |,ALL ]
[ ]
[,ALL ]
MVS System Commands Syntax 3
CHNGDUMP Command
Description:
Remove options from or reset the options lists.
SDUMP Set SDUMP dump mode to ADD and empty the options list.
SDUMP=(options)
Remove the specified options from the options list.
SDUMP,TYPE=XMEM
Turn off the cross memory option.
SDUMP,TYPE=XMEME
Turn off the cross memory at the time of the error option.
SDUMP,Q=YES or NO
Specify whether to quiesce the system while dumping SQA and CSA.
SDUMP,ALL Same as DEL,SDUMP.
SDUMP,SYSFAIL,STRLIST={ALL or (STRNAME=strname)}
Delete STRNAME specifications from the dump options list.
SYSABEND Set the SYSABEND dump mode to ADD, and reset the options list to the values established during system
initialization.
SYSABEND,{SDATA=(options) or PDATA=(options)}
Remove any SDATA or PDATA options that previous CHNGDUMP commands put into the options list.
SYSABEND,ALL
Same as DEL,SYSABEND.
SYSUDUMP Set the SYSUDUMP dump mode to ADD, and reset the options list to the values established during system
initialization.
SYSUDUMP,{SDATA=(options) or PDATA=(options)}
Remove any SDATA or PDATA options that previous CHNGDUMP commands put into the options list.
SYSUDUMP,ALL
Same as DEL,SYSUDUMP.
SYSMDUMP Set the SYSMDUMP dump mode to ADD, and reset the options list to the values established during system
initialization.
SYSMDUMP=(options)
Remove any specified options that previous CHNGDUMP commands put into the options list.
SYSMDUMP,ALL
Same as DEL,SYSMDUMP.
ALL Set all dump modes to ADD, and reset all system dump options lists to the values established during system
initialization.
4 OS/390 V2R8.0 MVS System Commands Summary
CHNGDUMP Command
CD RESET[,SDUMP ]
|,SYSABEND
|,SYSUDUMP
|,SYSMDUMP
|,ALL
Description:
RESET or RESET,ALL
Set all dump modes to ADD and reset the system dump options list to the values established during system
initialization.
RESET,SDUMP or SYSABEND or SYSUDUMP or SYSMDUMP
Set the specified dump type mode to ADD and reset the options list to the values established during initialization.
CD SET,{NODUMP }
{ }
{OVER }
{ }
{ADD }
{ }
{SDUMP[=(option[,option]...)] }
{ [,Q={YES|NO}] }
{ [,TYPE={XMEM|XMEME}] }
{ [,BUFFERS={nnnnK|nnnM}] }
{ [,MAXSPACE=xxxxxxxxM] }
{ [,MSGTIME=yyyyy] }
{ [,SYSFAIL,STRLIST=(s-option[,s-option]...)] }
{ [,NODUMP] }
{ |,OVER }
{ |,ADD }
{ }
{{SYSABEND}[,SDATA=(option[,option]...) ][,NODUMP] }
{{SYSUDUMP} |,PDATA=(option[,option]...) |,OVER }
{ |,ADD }
{ }
{SYSMDUMP[=(option[,option]...)][,NODUMP] }
{ |,OVER }
{ |,ADD }
MVS System Commands Syntax 5
CHNGDUMP Command
Where s-option represents:
STRNAME=strname
[,CONNAME=conname ]
[ ]
[,ACCESSTIME={ENFORCE|NOLIMIT|NOLIM} ]
[ ]
[,LOCKENTRIES ]
[ ]
[,USERCNTLS ]
[ ]
[,EVENTQS ]
[ ]
[,(EMCONTROLS={ALL|(list))} ]
[ ]
[,({COCLASS|STGCLASS|LISTNUM}={ALL|(list)} ]
[ {[,ADJUNCT={CAPTURE|DIRECTIO}][,ENTRYDATA={UNSERIALIZE|SERIALIZE}]} ]
[ {[,SUMMARY] }) ]
Description:
Set the dump modes and options.
NODUMP or ADD or OVER
Set the SDUMP, SYSABEND, SYSUDUMP, and SYSMDUMP dump modes.
SDUMP, NODUMP or ADD or OVER
Set the SDUMP dump mode.
SDUMP = (options)
Put the options in SDUMP options list.
SDUMP,TYPE=XMEM
Set the SDUMP options list to cross memory.
SDUMP,TYPE=XMEME
Set the SDUMP options list to cross memory at the time of error.
STRNAME=strname
Designate a particular coupling facility structure.
CONNAME=conname
The name of a user connected to the coupling facility structure.
ACCESSTIME={ENFORCE or NOLIMIT}
Determine whether or not to enforce the ACCESSTIME parameter of the IXLCONN macro.
LOCKENTRIES
Include the lock table entries for the requested structure in the dump.
USERCNTLS
Request that the user-attached controls be included in the dump.
6 OS/390 V2R8.0 MVS System Commands Summary
CHNGDUMP Command
COCLASS={ALL or (list)}
Specify which cast-out classes are included in the dump.
STGCLASS={ALL or (list)}
Specify which storage classes are included in the dump.
LISTNUM={ALL or (list)}
Specify which lists are included in the dump.
ADJUNCT={CAPTURE or DIRECTIO}
Indicate that the adjunct data is included in the dump.
ENTRYDATA={UNSERIALIZE or SERIALIZE}
Indicate that the entry data is included in the dump.
SUMMARY Indicate that a summary of the range of classes or lists is dumped.
SDUMP,Q=YES or NO
Specify whether to quiesce the system while dumping.
SDUMP,MAXSPACE=xxxxxxxx
The amount of space that the SVC Dump uses, in megabytes.
SDUMP,MSGTIME=yyyyy
The amount of time that the message IEA793A appears on the console, in minutes.
SDUMP,BUFFERS=nnnnK or nnnM
Reserve storage for SVC dump to use while the system captures the contents of common area storage. The
amount can be expressed in either kilobytes (K) or megabytes (M).
SDUMP,SYSFAIL,STRLIST=(structure names and options)
Set structures to be dumped. The default is 0.
SYSABEND,NODUMP or OVER or ADD
Set the SYSABEND dump mode.
SYSABEND,SDATA=(options) or PDATA=(options)
Put the specified options in the option list.
SYSUDUMP,ADD or OVER or NODUMP
Set the SYSUDUMP mode.
SYSUDUMP,SDATA=(options) or PDATA=(options)
Put the specified options in the option list.
SYSMDUMP,ADD or OVER or NODUMP
Set the SYSMDUMP mode.
SYSMDUMP=(options)
Put the specified options in the option list.
MVS System Commands Syntax 7
CONFIG Command
CONFIG Command (CF)
CONFIG or CF
CF {{CPUAD|CPU}(x[,x]...)[,{ONLINE|ON}[,VFON ]|,{OFFLINE|OFF}] }
{ |,VFOFF }
{ }
{VF(x[,x]...)[,{ONLINE|ON}|,{OFFLINE|OFF}] }
{ }
{{STORAGE|STOR}{(ddddM) }[,{ONLINE|ON}|,{OFFLINE|OFF}] }
{ {(ddddM-ddddM)} }
{ {(E=id) } }
{ }
{ESTOR(E=id)[,{ONLINE|ON}|,{OFFLINE|OFF}] }
{ }
{CHP{(xx) }[,{ONLINE|ON}[NOVARY]|,{OFFLINE|OFF}[,UNCOND]] }
{ {(aa-bb) } |,FORCE }
{ {(list) } }
{ {(ALL,id)} }
Description: Change or check the configuration of the system.
CPUAD or CPU
Indicator to reconfigure one or more processors.
(x[,x]...) The processors to reconfigure, identified by x (0 through F).
VFON or VFOFF
Bring online or keep offline the Vector Facility attached to each processor.
VF Reconfigure one or more Vector Facilities attached to the indicated processors (x[,x]...).
ONLINE or ON
The system is to bring online the specified processors.
ONLINE,NOVARY
The system is to bring online the specified channel paths, without bringing online the paths to the associated
devices.
OFFLINE or OFF
The system is to take offline the specified processor(s).
STORAGE or STOR
Reconfigure central storage.
ddddM The amount of central storage to be reconfigured in megabytes (M). It must be a multiple of the storage increment
size (usually 2, 4, or 8).
ddddM-ddddM
The starting and ending addresses of the storage.
8 OS/390 V2R8.0 MVS System Commands Summary
CONFIG Command
E=id The storage or expanded storage element identified by the storage element ID.
ESTOR Reconfigure expanded storage, both logically and physically.
CHP Reconfigure one or more channel paths.
(xx) or (aa-bb)
A single channel path or range of paths. Values range from 0 to FF.
(list) A list of single or ranges of paths.
(ALL,id) Reconfigure all channel paths associated with one side of a partitioned processor complex. The id identifies the
side (0 or 1).
OFFLINE,UNCOND
Take the path offline even if it is the last path to a device. This command is rejected if the device is in use,
allocated, a TP device, or is the only active console.
OFFLINE,FORCE
CAUTION: FORCE is very powerful. Be sure you understand all of its consequences. Take the path offline even
if it is the last path, except if the device is the only active console.
CF MEMBER[(member-id)]
Description:
The system is to use a CONFIGxx member of SYS1.PARMLIB to reconfigure available processors, storage sections, vector
facilities, and channel paths. The identifier(xx) of the CONFIGxx member you want the system to use is specified by the
member-id. The default is 00.
CF {ONLINE|ON }[,L={ a }]
{OFFLINE|OFF} {cc }
{cca }
{name }
{name-a}
Description:
The system displays the system configuration so that you can decide which processors, central or expanded storage elements,
vector facilities, and channel paths you want to bring online/offline. It then brings online/offline items specified in response to
message IEE522D.
L=a, cc, cca, name or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the system is to
display the system configuration.
MVS System Commands Syntax 9
CONTROL Command
CONTROL Command (K)
CONTROL or K
K A[,nn[,nn]...][,L={cc }]
|,NONE {name}
|,REF
Description:
Change the display area specifications.
nn[,nn]... The number of message lines in each display area. The first number defines the bottom area of the screen and
the rest work towards the top.
NONE All out-of-line display area specifications are removed for the specified console.
REF Display the size of out-of-line display areas for the specified console.
L=cc or name
The display console to be changed or referenced.
K C,{A|I|E|CE},{id|id-id[,id|id-id]...}
Description:
Delete one or more action messages that the action message retention facility has retained.
A Delete immediate action(descriptor code 1 or 2), eventual action (code 3), or critical eventual action (code 11)
messages.
I Delete immediate action messages (code 1 or 2).
E Delete eventual action messages (code 3).
CE Delete critical eventual action messages (code 11).
id or id-id The message id number or range to be deleted.
K C,D,id[,L={a }]
{cc }
{cca }
{name }
{name-a}
Description:
C,D Stop the in-line display.
id Three digit identification number of the status display you want to stop.
L=cc or name
The identification number or name of the active MCS console where the display is to be stopped.
10 OS/390 V2R8.0 MVS System Commands Summary
CONTROL Command
K D[,N[,HOLD] ]
|{,F|,H|,U}[,L={a|cca|name-a}]
|,PFK
Description:
Display information on the screen.
N Remove consecutively numbered messages on the screen.
HOLD Renumber messages after a message deletion.
F Display the next frame of the status display.
H Suppress the updating of a dynamic status display.
U Resume the updating of a dynamic status display.
PFK Display the numbers of the program function keys.
L=a or cca or name-a
The display area (a), console id and display area (cca), or console name and display area (name-a) where
information is displayed.
K E[,nn ]
|,nn,nn
|,SEG
|,F
|,N
|,PFK
|,D[,L={a }]
{cc }
{cca }
{name }
{name-a}
Description:
nn Remove a single deletable message from the screen (nn is a decimal).
nn,nn Remove a range of deletable messages.
SEG Remove deletable messages in the predefined message segment.
F Remove all flagged (having a vertical or horizontal bar in position 3) messages.
N Consecutively number messages on the screen.
D Delete a status display at the console and display area specified by L={cca or name-a}.
PFK Erase the numbers from the program function key (PFK) display line.
K M[,AMRF={Y|N}]
|,REF
K M[,REF|[,MLIM=nnnn][,RLIM=mmmm]]
MVS System Commands Syntax 11
CONTROL Command
K M[,UEXIT={Y|N}]
|,REF
Description:
AMRF Activate (Y) or deactivate (N) the action message retention facility.
MLIM=nnnn The maximum number of WTO (write-to-operator) message buffers to be allowed where nnnn can be a decimal
number from 20 to 9999.
RLIM=mmmm
The maximum number of WTOR (write-to-operator-with-reply) message buffers to be allowed where mmm can be
a decimal number from 5 to 9999.
UEXIT Activate(Y) or deactivate(N) the general user exit routine IEAVMXIT. If IEAVMXIT is already active and you want a
new copy, deactivate it, refresh the library lookaside (LLA), and then reactivate IEAVMXIT.
REF Display the current values for CONTROL M operands in the entry area of the master console. If the master
console is not a display console, the operands and values are printed in message IEE144I.
K M[,LOGLIM={nnnnnn|}]
|,REF
Description:
LOGLIM=nnnnnn
The maximum number of outstanding WTL requests that the system can hold in buffers on the system, from 20 to
999999.
LOGLIM=0 The maximum number of outstanding WTL requests is set to 0. All outstanding WTL buffer storage is freed. Use
this only at the direction of the system programmer.
REF Display the current value of CONTROL M.
K M[,ROUTTIME=nnn ]
|,REF
Description:
Display or change the maximum time that ROUTE commands wait for a response before aggregating responses.
ROUTTIME=nnn
Dynamically changes the maximum number of seconds the ROUTE *ALL or ROUTE systemgroupname command
waits for command responses from each system before aggregating the responses. (If not specified in CONSOLxx,
the IBM-supplied default value is 30 seconds.) The nnn value is a decimal number from 0-999.
REF Display the current value of the CONTROL M,ROUTTIME operand.
Display or dynamically increase the maximum number of reply IDs.
K M[,RMAX=nnnn ]
|,REF
Description:
RMAX=nnnn Dynamically increase the maximum number of reply IDs, where nnnn is a decimal number from 99 to 9999.
Note: The value for RMAX also determines the size of the reply ID displayed in the message text.
REF Display the current value of the CONTROL M,RMAX operand.
12 OS/390 V2R8.0 MVS System Commands Summary
CONTROL Command
K N,PFK={(nn1{,CMD='text[;text]...'})[,CON={Y|N}] }
{ {,KEY=nn2[,nn2]... } }
{ }
{nnnnnnnn[,L={cc|name}] }
Description:
nn1 The number of the program function key (PFK) to be defined.
CMD=text[;text] ...
The text of the operators commands to be associated with PFK nn1. A maximum of 110 characters can be
included in the quotes. Separate different commands with semi-colons.
KEY=nn2[,nn2] ...
The number(s) of the PFK commands that can be associated with PFK nn1, separated by commas.
CON=Y or N Specify whether conversational mode of command entry is in effect.
nnnnnnnn The name of the PFK table that contains the commands that define the PFKs for a console defined by L={cc or
name}.
K Q[,R={dd }][,L={cc|name}]
{name}
{HC }
Description:
Change or display a console's message queue.
R Reroute the message queue to the specified console (dd or name) or specified hardcopy device (HC).
L=cc or name
The id name or console whose message queue is to be rerouted.
MVS System Commands Syntax 13
CONTROL Command
K S[,REF ]
|
|[,CON={Y|N}][,SEG=nn][,DEL={Y|N|R|RD|W}]
[,RNUM=nn][,RTME=nnn][,MFORM=(option[,option]...)]
[,L={cc|name}]
Description:
Change or display message deletion and format specifications.
CON=Y or N Request(Y) or cancel(N) conversational message deletion.
REF Display the current specification values in the entry area in CONTROL command format.
SEG=nn Change the number of lines(nn) to be included in the segment of messages to be deleted when a CONTROL
E,SEG command is issued.
DEL=Y All flagged messages are removed from the screen whenever the screen becomes full.
DEL=N All messages must be moved manually.
DEL=R Roll mode goes into effect. A specified number of messages (set by RNUM) roll off the screen each specified
interval (set by RTME).
DEL=RD Same as DEL=R, except action messages accumulate at the top of the screen.
DEL=W New messages overlay older ones when the screen is full.
RNUM=nn The number of lines in the message roll.
RTME=nnn The time interval in seconds between message rolls.
MFORM=(option[,option] ...)
Change the format of messages sent to a console. You can request that each message appear with a time
stamp(T), the name of the system that issues the message(S), the job name or ID of its issuer(J), or none of the
above(M).
L=cc or name
The console this command is to affect.
K T[,REF ][,L={cc }]
|,UTME=nnn {name}
Description:
Change or display time intervals for dynamic displays.
REF Display the current value of the time interval in the entry area in CONTROL command form.
UTME Change the time interval for updating status displays (in seconds).
L=cc or name
The console where the time interval updating is to occur.
K V[,REF ][,L={cc }]
| {name}
|,USE={FC|SD|MS}[,CMDSYS={sysname|}]
14 OS/390 V2R8.0 MVS System Commands Summary
CONTROL Command
K V[,REF ][,L={cc }]
| {name}
|,LEVEL=(type[,type]...)
Description:
Change the operating mode or message levels of a console.
USE Change the console to full-capability mode (FC), to output-only for presentation of status display (SD), or to
output-only for presentation of messages other than status displays (MS).
REF Display the current COMMAND V operand values.
L=cc or name
The console where the specified action is to take place.
LEVEL=(type[,type] ...)
Change the message levels for the console. The following are the valid message types that can be displayed: CE
(critical eventual action), E (eventual action), I (immediate action), IN (informational), R (WTOR), ALL (including
broadcast messages), NB (broadcast messages are NOT displayed), and UNCOND (executes the command even
if it means some messages will not be assigned a console).
CMDSYS Indicate the system where all commands will be sent for processing.
* The system where you issue the command.
MVS System Commands Syntax 15
DEVSERV Command
DEVSERV Command (DS)
DEVSERV or DS
DS {PATHS|P},[/]devnum[,nn][,ONLINE|,ON ][,NOSYM|,NOS][,DUMP]
{SMS|S } |,OFFLINE|,OFF
[,L={a|cc|cca}]
{QDASD | QD}[,? |
[ [ [,ccuu [,1] | ,VOL=volser ] [ [,UCB] [,DCE][,SSSCB] [,DPCT]
[ [,NOIO] | [,RDC] [,RCD] [,SNSS] ] ] ] |
,ccuu,nnn |
[,ccuu,nnn] ,VOL=volser |
,MACH=[mmpp-sssss | XXXX-sssss] |
,SSID=[ssid | ALL] |
,TYPE=[type | ALL] ]
[,ONLINE] [,OFFLINE] [,DEFINED] [,CHKFAIL] [,VALIDATE] [,TOTALCYL]
{QTAPE | QT}[,? |
[ [ [,ccuu [,1] ] [ [,UCB] [,DCE][ [,NOIO] | [,RDC]
[,RCD] ] ] ] | ,ccuu,nnn |
[,ccuu,nnn] ,LIB=libid | ALL |
,MACH=[mmpp-sssss | XXXX-sssss] |
,TYPE=[type | ALL] ]
[,ONLINE] [,OFFLINE] [,DEFINED]
Description:
Display the status of DASD or tape devices.
PATHS or P Display (in message IEE459I) the status of specified devices. This does not show any SMS information such as
volume or storage group status.
SMS or S Display (in message IGD001I) the volume and storage group status of specified device(s) managed by SMS.
[/]devnum Device number of the device for which the system is to display information.
nn Number of devices (from 1 to 32) for which the system is to display the information in ascending
order beginning with the device that you specify.
ONLINE or ON and OFFLINE or OFF
Signal to display information only about those devices that are online or offline, depending on which
is specified. If unspecified, the display will contain both.
NOSYM or NOS
Signal not to display the definitions of the symbols with message IEE459I.
DUMP Request to take an SVC dump after executing the DEVSERV PATHS command.
L=a, cc, cca, name, name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a), where the
display is to appear.
16 OS/390 V2R8.0 MVS System Commands Summary
DEVSERV Command
QDASD Display selected information about specified DASD devices and storage control units.
? Request to view online help text.
ccuu Number of the DASD device you are querying.
nnn Number of DASD devices or units to query.
VOL=volser
Serial number of the online volume whose information DEVSERV is to display.
MACH=mmpp-sssss | XXXX-sssss
Serial number of the DASD device or storage control unit whose information DEVSERV is to display.
SSID=ssid | ALL
Identifying number of the subsystem whose information DEVSERV is to display.
TYPE=type | ALL
Type of DASD or storage control unit whose information DEVSERV is to display.
ONLINE or ON and OFFLINE or OFF
Signal to display information only about those devices that are online or offline, depending on which is
specified. If unspecified, the display will contain both.
DEFINED DASD units (whose information DEVSERV is to display) defined to the system.
CHKFAIL Information about devices with inconsistent definitions.
VALIDATE
Information inconsistent between device definitions and data acquired directly from the devices.
TOTALCYL
Accumulated total capacity of all accessible devices.
NOIO Signal to prevent I/O operations; allows a display only of storage resident information.
QTAPE Display selected information about specified tape devices and tape control units.
? Request to view online help text.
ccuu Number of the tape device you are querying.
nnn Number of tape devices or units to query.
LIB=libid | ALL
Library containing the volumes whose information DEVSERV is to display.
MACH=mmpp-sssss
Serial number of the tape control unit or tape device whose information DEVSERV is to display.
TYPE=type | ALL
Type of tape or control unit whose information DEVSERV is to display.
ONLINE or ON and OFFLINE or OFF
Signal to display information only about those devices that are online or offline, depending on which is
specified. If unspecified, the display will contain both.
DEFINED Tape units (whose information DEVSERV is to display) defined to the system.
NOIO Signal to prevent I/O operations; allows a display only of storage resident information.
MVS System Commands Syntax 17
DISPLAY Command
DISPLAY Command (D)
DISPLAY or D APPC
D APPC,{TP[,SUMMARY|SUM|S][,{ASID|A}=asid] }
{ |,LIST|,L [,ASNAME=asname] }
{ |,ALL|,A [,DIR=IN|OUT] }
{ [,IT=sssss[.ttt]] }
{ [,LLUN=lluname] }
{ [,LTPN=ltpname] }
{ [,PNET=pnetid] }
{ [,PLUN=pluname] }
{ [,PTPN=ptpname] }
{ [,SCHED={schedname}] }
{ {NONE } }
{ [,STPN=stpname] }
{ [,USERID=userid] }
{ }
{UR[,SUMMARY|SUM|S][,URID=urid] }
{ |,LIST|,L [,LUWID=luwid] }
{ |,ALL|,A [,PNET=pnetid] }
{ [,PLUN=pluname] }
{ [,LLUN=lluname] }
{ }
{SERVER[,SUMMARY|SUM|S][,{ASID|A}=asid] }
{ |,LIST|,L [,ASNAME=asname] }
{ |,ALL|,A [,LLUN=lluname] }
{ [,STPN=stpname] }
{ }
{LU[,SUMMARY|SUM|S][,LLUN=lluname] }
{ |,LIST|L [,PNET=pnetid] }
{ [,PLUN=pluname] }
{ |,ALL|A [,SCHED={schedname}] }
{ {NONE } }
[,L={a|cc|cca|name|name-a}]
Description:
Display APPC configuration information.
TP The system is to display information about the transaction program or server.
LU The system is to display information about the logical unit.
SERVER The system is to display information about APPC/MVS servers and the allocate queues they serve.
18 OS/390 V2R8.0 MVS System Commands Summary
DISPLAY Command
SUMMARY or SUM or S
The system is to use the SUMMARY form of output.
LIST or L The system is to use the LIST form of output.
ALL or A The system is to use the ALL form of output.
ASID=asid or A=asid
The address space identifier of the local transaction program.
DIR= {IN or OUT}
The direction of the conversation.
IT=sssss[.ttt]
The idle time of the conversation, in seconds.
LLUN=lluname
The local logical unit name.
LTPN=ltpname
The local transaction program name.
USERID=userid
The userid of the transaction program that is running due to an allocate request.
ASNAME=asname
The address space name of the transaction program or server.
PLUN=pluname
The partner logical unit name.
PTPN=ptpname
The partner transaction program name.
SCHED=schedname or *NONE*
The transaction scheduler name. or *NONE*.
STPN=stpname
The name of the served transaction program.
L=a, cc, cca, name, or name-a
Specify the display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
MVS System Commands Syntax 19
DISPLAY Command
DISPLAY or D ASCH
D ASCH{[,SUMMARY|,SUM|,S ][,{ASID|A}=asid] }
{ |,LIST|,L [,{CLASS|C}=classname] }
{ |,ALL|,A [,LTPN=ltpname] }
{ [,QT=sssss[.ttt]] }
{ [,TPST=schedtype] }
{ [,USERID=userid]} }
[,L={a|cc|cca|name|name-a}]
Description:
Display ASCH configuration information.
SUMMARY or SUM or S
The system is to use the SUMMARY form of output.
LIST or L The system is to use the LIST form of output.
ALL or A The system is to use the ALL form of output.
ASID=asid or A=asid
The address space identifier of the local transaction program.
CLASS=classname or C=classname
The name of the APPC transaction scheduler class.
LTPN=ltpname
The local transaction program name
USERID=userid
The userid of the transaction program that is running due to an allocate request.
QT=sssss[.ttt]
The queue time, in seconds, of a local transaction program waiting for initiation.
TPST=schedtype
The transaction program schedule type.
L=a, cc, cca, name, or name-a
Specify the display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
20 OS/390 V2R8.0 MVS System Commands Summary
DISPLAY Command
DISPLAY or D ASM
D ASM[,PLPA ]
|,COMMON
|,DUPLEX
|,LOCAL
|,ALL
|,PAGE=[dsname|ALL]
|,SWAP=[dsname|ALL]
|,PAGEDEL
[,L={a|cc|cca|name|name-a}]
Description:
Display page and swap data set information.
PLPA Display information about the PLPA page data set.
COMMON Display information about the common page data set.
DUPLEX Display information about the duplex page data set.
LOCAL Display information about all local page data sets.
ALL Display information about all page and swap data sets, and the processing status of the PAGEDEL command.
PAGE Display information about a single page data set (dsname) or ALL page data sets.
SWAP Display information about a single swap data set (dsname) or ALL swap data sets.
PAGEDEL Display information about the PAGEDEL command. When the PAGEDEL command is waiting for jobs to be
swapped in, a list of jobname(s) delaying the PAGEDEL command is displayed.
L=a, cc, cca, name, or name-a
Specify the display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
DISPLAY or D C
D C,K[,L={a|cc|cca|name|name-a}]
Description:
C,K Display a summary of CONTROL command operands.
L=a, cc, cca, name, or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display of a
summary of CONTROL command operands will appear.
MVS System Commands Syntax 21
DISPLAY Command
DISPLAY or D CF
D CF[,CFNAME={(cfname[,cfname]...)]
Description:
CF Display information about the coupling facilities that are attached to the system.
CFNAME= or CFNM= cfname
Display information for one or more named coupling facilities.
DISPLAY or D CNGRP
D CNGRP[,{GROUP|G}[=(name[,name]...)]][,L={a|cc|cca|name|name-a}]
Description:
Display console group definitions in effect for the sysplex.
CNGRP The system is to display information about the console groups currently defined to the system or sysplex. If you
specify this keyword alone, the system outputs all the group names associated with each group.
GROUP or G
The system is to display information on specific console groups. If GROUP is the last keyword in the command,
then the system will display only the names of the active groups.
name The groups about which to display information.
L=a, cc, cca, name, or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
22 OS/390 V2R8.0 MVS System Commands Summary
DISPLAY Command
DISPLAY or D CONSOLES or C
D {CONSOLES},{{ACTIVE|A }[,CA={name }][,ROUT={NONE|ALL|rr }] }
{C } {{SS } {(name[,name]...)} {(rr-ss) } }
{{NACTIVE|N}[MSTR] {(rr[,ss]...)} }
{ [,SYS=system name] }
{ }
{KEY[=key] }
{ }
{{BACKLOG|B} }
{ }
{{MASTER|M}[,SYS=system name] }
{ }
{{MCONLY} }
{ }
{ }
{ }
{{LIST|L} }
{ }
{{HARDCOPY|HC}[,SYS=system name] }
{ }
{CN={xx }[,ROUT={NONE|ALL|rr }] }
{ {(xx[,yy]...)} {(rr-ss) } }
{ {(xx-yy) } {(rr[,ss]...)} }
{ [,SYS=system name] }
{ }
{HCONLY }
{ }
{U={([/]devnum1[,[/]devnum2]...)} }
{ {([/]lowdevnum-[/]highdevnum)} }
{ {[/]devnum } }
{MSTR[,SYS=system name] }
[,L={a|cc|cca|name|name-a}]
Description:
Display console status information.
ACTIVE or A Display the status of all active MCS consoles.
NACTIVE or N
Display the status of all inactive MCS consoles.
SS Display the status of all subsystem-allocatable consoles.
KEY Display a list of available class names or active operators in specified console class (key)
CN Display the status of a single console, list of consoles, or range of consoles, all identified by their console id or
name.
MVS System Commands Syntax 23
DISPLAY Command
U Display the status of a single console, list of consoles, or range of consoles, each identified by a device number.
CA Display console/system association list or specified console name (name) to match keyword, ACTIVE or NACTIVE.
ROUT Display the status of all consoles that receive messages by the specified routing code, list of codes, or range of
codes. NONE displays the status of all consoles to which no messages are routed by routing code. ALL displays
all those consoles that accept messages by routing codes.
BACKLOG or B
Display the status of all consoles with a message backlog.
MASTER or M
Display the status of the master and pseudo-master consoles.
MCONLY Display the status of the current master console, if any.
* Display the status of the console that issues the DISPLAY.
LIST or L Display the status of all consoles defined to the sysplex.
HCONLY Display information on messages in the hardcopy message set that are not directed to any console.
HARDCOPY or HC
Display information about the hardcopy message set or the hardcopy medium.
L=a, cc, cca, name or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
DISPLAY or D DLF
D DLF[,RES={({qname|}[,rname|,])}][,HEX]
[,L={a|cc|cca|name|name-a}]
Description:
Display a list of major names or resource information for the specified resource(s).
RES=(qname,[rname])
The major name (qname), required, and minor name (rname), optional, of the specified resource. An asterisk at
the end of a name tells the system to include all names that match the portion of the name given before the
asterisk. A single asterisk means to include all resources. If either name contains hexadecimal values or a single
quote specify the name in hexadecimal form as Xqname or Xrname.
HEX Display resource information in hexadecimal as well as EBCDIC.
L=a, cc, cca, name or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
24 OS/390 V2R8.0 MVS System Commands Summary
DISPLAY Command
DISPLAY or D DMN
D DMN[=domainnum][,L={a|cc|cca|name|name-a}]
Description:
Display the domain description table or a specific table entry (domainnum from 2 to 129).
DMN[=domainnum]
The domain description table to display (message IEE796I).
L=a, cc, cca, name or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
Note: Not valid on systems operating in workload management goal mode.
MVS System Commands Syntax 25
DISPLAY Command
DISPLAY or D DUMP
D {DUMP},{{STATUS|ST|S} }
{D } { }
{{OPTIONS|O} }
{ }
{{TITLE|T }{,AUTODSN={aaa|ALL} }}
{{ERRDATA|ER|E}{ }}
{ {,DSN={ALL|(ALL) } }}
{ { {nn|(nn[,nn]...) } }}
{ { {nn-nn|(nn-nn[,nn-nn]...) } }}
{ { {(nn[,nn]...,nn-nn[,nn-nn]...)} }}
{ { }}
{ {,DUMPID={xxx|(yyy[,zzz]...) }}}
{ { {aaa-bbb|(aaa-bbb[,ccc-ddd]...) }}}
{ { {(yyy[,zzz]...,aaa-bbb[,ccc-ddd]...)}}}
[,L={a|cc|cca|name|name-a}]
Description:
Display the dump options or dump data set status.
STATUS or ST or S
Display a summary of the full or available status of each defined SYS1.DUMP data set.
OPTIONS or O
Display the dump mode and options in effect for the SDUMP, SYSABEND, SYSUDUMP, and SYSMDUMP dump
types.
TITLE or T Display the dump title and time of dump for each full direct access dump that you specify in the DSN parameter.
ERRDATA or ER or E
Display error data for each full direct access data set specified in the DSN parameter.
AUTODSN= Display requested dump information about dump data sets most recently allocated.
DSN= Specify one or more single data sets, one or more ranges of data sets, or all data sets. For all specifications, nn
has a range of 00-99.
DUMPID= Specify the 3-character dump identifier for a captured dump. You can specify more than one dump (xxx[zzz,...]) or
a sequential series ([aaa-ddd]).
L=a, cc, cca, name or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
26 OS/390 V2R8.0 MVS System Commands Summary
DISPLAY Command
DISPLAY or D EMCS
D EMCS,{SUMMARY|S }
{INFO|I }
{FULL|F }
{ }
{STATUS=A|N|L|B[{nn}]|ERR }
{ST }
{ }
{CN=consname| }
{ }
{SYS=sysname| }
{ }
{KEY=keyname| }
{ }
{AUTH={ANY} }
{ {MASTER} }
{ {SYS} }
{ {IO} }
{ {CONS} }
{ {ALL} }
{ {INFO} }
{ {SYSONLY} }
{ {IOONLY} }
{ {CONSONLY} }
{ {ALLONLY} }
{ {INFOONLY} }
{ }
{ATTR={ANY} }
{ {YES} }
{ {ROUT} }
{ {UD(YES|NO)} }
{ {HC} }
{ {AUTO(YES|NO)} }
{ {MN} }
{ {NONE} }
{ }
{DOM={ANY} }
{ {NORMAL} }
{ {ALL} }
{ {NONE} }
{ {YES} }
[,L={a|cc|cca|name|name-a}]
MVS System Commands Syntax 27
DISPLAY Command
Description:
Display information about extended MCS (EMCS) consoles.
SUMMARY or S
Display only the numbers and names for the consoles that meet the criteria.
INFO or I Display all console information, except statistics on the console's message data space, for the consoles that meet
the criteria.
FULL or F Display all available information about the consoles that meet the criteria. Message data space statistics can only
be displayed for consoles that are active on the system where the command is processed.
The following keyword parameters define the criteria used to limit the number of consoles displayed:
STATUS|ST=A|N|L|B[(nn)]|ERR
The system is to display information about EMCS consoles according to console status:
A All EMCS consoles that are active.
N All EMCS consoles that are not active.
L Both active and inactive EMCS consoles.
B[(nn)] All consoles with a backlog of more than nn unretrieved delivered messages, where nn is a number from
1 to 999999. If you omit nn, the default is 10 unretrieved messages. Backlog information can only be
displayed for consoles attached to the system that processes the command.
ERR All consoles in an error state, such as consoles with queueing suspended. Error state information can
only be displayed for consoles attached to the system that processes the command.
Note: Specifying B or ERR on STATUS forces the amount of information to be FULL.
CN=consname
Display information according to console name. You can specify wildcard characters (* and ?) in the console
name.
CN=* is a special case because * is not a wildcard character. CN=* means that the system is to display
information about this console, the console you are using to enter the command.
Note: Specifying CN=*, or a console name with no wildcard characters, automatically forces STATUS=L.
SYS=sysname
Display information about any consoles that (1) are active or eligible for activation on the system you name and (2)
match the other specified parameters. A system name can be from 1 to 8 characters. You can specify wildcard
characters (* and ?). The default is SYS=*, which matches all system names.
KEY=keyname
The system is to display information according to console key name, where keyname is the name your installation
has assigned to a console group. (See OS/390 MVS Planning: Operations for more information.) The name can
be from 1 to 8 characters. You can specify wildcard characters (* and ?). The default is KEY=*, which matches all
console class names.
28 OS/390 V2R8.0 MVS System Commands Summary
DISPLAY Command
AUTH= Display information about consoles with a specific which may be one of the following:
ANY Consoles with any authority.
MASTER Consoles with MASTER authority.
SYS Consoles with at least SYS authority (meaning MASTER authority, SYS authority alone, or SYS
combined with IO or CONS or both).
IO Consoles with at least IO authority.
CONS Consoles with at least CONS authority.
ALL Consoles with at least ALL authority (SYS, IO, and CONS).
INFO Consoles with at least INFO authority.
SYSONLY Consoles with SYS authority only (not MASTER, CONS, or IO).
IOONLY Consoles with IO authority only.
CONSONLY
Consoles with CONS authority only.
ALLONLY Consoles with ALL authority only (meaning consoles with SYS, IO, and CONS authority, but not
MASTER authority).
INFOONLY
Consoles with INFO authority only.
ATTR= The system is to display information about EMCS consoles that receive messages with a specific routing attribute,
which may be one of the following:
ANY Any consoles, regardless of routing attributes.
YES Consoles that receive some type of unsolicited messages (either routing codes, UD messages,
hardcopy messages, AUTO(YES) messages, or MONITOR messages.)
ROUT Consoles that receive any routing codes.
UD[(YES|NO)]
Consoles that are or are not receiving UD messages. The default is YES.
HC Consoles receiving the hardcopy message set.
AUTO[(YES|NO)]
Consoles that are or are not receiving AUTO(YES) messages. The default is YES.
MN Consoles receiving any type of MONITOR messages.
NONE Consoles with no routing attributes.
DOM= The system is to display information about EMCS consoles according to specific DOM attributes.
ANY Any consoles, regardless of DOM attributes.
NORMAL Only consoles defined with DOM(NORMAL).
ALL Only consoles defined with DOM(ALL).
NONE Only consoles defined with DOM(NONE).
YES Consoles defined with either DOM(ALL) or DOM(NORMAL).
L={a|cc|cca|name|name-a}]
Specifies the display area (a), console (cc), both (cca), console name (name), or both (name-a) where the system
is to present the display. For cc, you must specify a decimal number from 1 to 99.
If you omit this operand, the system presents the display in the first available display area or the message area of
the console through which you enter the command (unless routing instructions are in effect; see the MSGRT
command later in this chapter).
MVS System Commands Syntax 29
DISPLAY Command
DISPLAY or D ETR
D ETR[,DATA][,L={a|cc|cca|name|name-a}]
Description:
Display current External Timer Reference synchronization.
DATA Display status of each ETR port including ETR network ID, port number, and ETR ID.
L = a, cc, cca, name or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
DISPLAY or D GRS
D GRS{[,SYSTEM|,LINK|,ALL|,A|,DELAY|,D|,SUSPEND|S][,CONTENTION|,C] }
{ [,RES=(qname|[,rname|,])][,HEX][,DEV=[/]devnum][,{SUSPEND|S}]}
{ [,RNL={CONVERSION|CON|C}] }
{ {ALL|A } }
{ {EXCLUSION|EXCL|E} }
{ {INCLUSION|INCL|I} }
{ }
{,{CONTENTION|C}[,ENQ] }
{ [,LATCH[,{JOBNAME|JOB}=jobname]][,HEX] }
{ }
{,LATCH{,{JOBNAME|JOB}=jobname[,CONTENTION|,C]}[,HEX] }
{ {,{CONTENTION|C} } }
[,L={a|cc|cca|name|name-a}]
Description:
Display global resource serialization (GRS) information.
SYSTEM Display system information such as system names and states or communication status of each system in the GRS
complex.
LINK Display CTC link information including the device number of each CTC link, its status, and the system name of the
system that last responded to the opposite end of the link.
ALL or A Display system information, CTC link information, resource contention information, the contents of all RNLs for the
current GRS, latch contention information, and ENQ contention information.
CONTENTION or C
Display resource contention information for the current GRS.
DELAY Display jobname, ASID, resources held or waiting, and job termination information.
DEV=[/]devnum
Display a list of non-converted RESERVE requests for the device with device number devnum.
ENQ Display resource contention information for ENQs and RESERVEs. If you specify ENQ, you must also specify
CONTENTION.
JOBNAME or JOB
Display latch information for a particular job. If you specify JOBNAME, you must also specify LATCH.
30 OS/390 V2R8.0 MVS System Commands Summary
DISPLAY Command
LATCH or L Display latch information. If you specify LATCH, you must also specify CONTENTION, JOBNAME or both.
SUSPEND or S
Display jobname, ASID and resources the job is waiting for.
RNL=CONVERSION, CON or C
Display the contents of the RESERVE conversion RNL.
RNL=ALL or A
Display the contents of all RNLs.
RNL=EXCLUSION, EXCL or E
Display the contents of the SYSTEMS exclusion RNL.
RNL=INCLUSION, INCL or I
Display the contents of the SYSTEM inclusion RNL.
RES=(qname,[rname])
Display a list of major names or resource information for the specified resource(s). The major name(qname) must
be included, but the minor name(rname) is optional. An asterisk at the end of a name tells the system to include all
names that match the portion of the name given before the asterisk. A single asterisk means to include all
resources. If either name contains hexadecimal values or a single quote specify the name in hexadecimal form as
Xqname or Xrname.
HEX Display resource information in hexadecimal as well as EBCDIC.
L=a, cc, cca, name, name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a), where the display will
appear.
DISPLAY or D IOS
D IOS,CONFIG[(EDT)|(HSA)|(ALL)]
[,L={a|cc|cca|name|name-a}]
Description:
Display IOS-related configuration information.
HSA Display the amount of HSA that is available to perform configuration changes.
ALL Display information about the I/O configuration and the amount of HSA that is available to perform configuration
changes.
L = a, cc, cca, name or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
MVS System Commands Syntax 31
DISPLAY Command
D IOS,MIH[,TIME={ALL|option} ]
[ ]
[,{DEV }={([/]devnum[,[/]devnum1]...) } ]
[ {DEVX } {([/]devnum-[/]devnum1[,[/]devnum2-[/]devnum3]...)} ]
[ {TDEV } ]
[ {TDEVX} ]
[,L={a|cc|cca|name|name-a}]
Description:
Display MIH time intervals.
TIME=ALL Display the MIH (missing interrupt handler) time intervals for all device classes.
TIME=option
Specify the device class.
DEV=[/]devnum
Display the MIH time interval for a device or a range of devices. The display is formatted.
DEVX=[/]devnum
Same as DEV=, except the display is unformatted.
TDEV=[/]devnum
Display the I/O timing limit for a device or a range of devices. The display is formatted.
TDEVX=[/]devnum
Same as TDEV=, except the display is unformatted.
L=a, cc, cca, name, or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
D IOS,STOP[,L={a|cc|cca|name|name-a}]
Description:
Display information about the devices affected by the IOACTION STOP command.
L = a, cc, cca, name or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
32 OS/390 V2R8.0 MVS System Commands Summary
DISPLAY Command
DISPLAY or D IPLINFO
D IPLINFO [,L={a|cc|cca|name|name-a}]
Description:
Display the following information about the initial program loading (IPL) of the system:
The date and time of the IPL
The release level of the system
The contents of parmlib members IEASYSxx and IEASYMxx
LOADxx information used for the IPL
L=a, cc, cca, name or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
DISPLAY or D JOBS
D {JOBS|J}[,{LIST|L},[USERID=userid]]
{A|TS } |,{ALL|A}
|,{jobname[.identifier]|(jobname)}
[,L={a|cc|cca|name|name-a}]
Description:
Display system activity information.
JOBS or J or TS or A
Display overview information about system activity, such as the number of active batch jobs or logged-on users.
The format of what is displayed is dependent on the workload management mode in effect on a system.
LIST or L Display detailed information for active jobs and started tasks (JOBS or J), logged-on time-sharing users(TS), or
both(A).
ALL or A Display more detailed information than that supplied by LIST.
jobname[.identifier] or (jobname)
Display detailed information for the item with the specified name. This could be the name of the job, started task,
time-sharing user, APPC/MVS transaction program, initiator, or system address space. Enclose the name in
parentheses if it is the same as a valid secondary operand. You may include an asterisk at the end of the name to
specify all names beginning with the given characters.
USERID=userid
A filter to show only the work running on behalf of userid.
L=a, cc, cca, name or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
MVS System Commands Syntax 33
DISPLAY Command
DISPLAY or D LOGGER
D LOGGER[,STatus ]
[,Connection[,LSName=logstreamname[[,Jobname=mvsjobname][,SUMM ]] ]]
[,Detail]
|,Jobname=mvsjobname[[,LSName=logstreamname][,SUMM ]]
[,Detail]
|,SYSPLEX[,LSName=logstreamname]
|,DASDONLY
[,Logstream[,LSName=logstreamname][,STRName=structurename] ]
|,DASDONLY
[,STRucture[,STRName=structurename] ]
Description:
Display the status of the system logger, individual log streams, or log streams from a sysplex view.
STATUS or ST
Display the current operational status of the system logger. STATUS is the default parameter.
CONNECTION or CONN or C
Display all log streams with one or more connections for the system(s) on which the command was issued.
LSNAME or LSN = logstreamname
This filter displays all actively connected log streams matching the specified log stream name.
JOBNAME or JOB or J = mvsjobname
This filter displays all log streams with one or more connections to which the specified jobname is
connected.
SUMM or S, or DETAIL or D
These two mutually exclusive parameters are valid only when preceded by the LSNAME or JOBNAME
parameter (or both). SUMM displays a condensed overview and is the default value. DETAIL displays a
more detailed report.
SYSPLEX This filter changes the view of the output from a system view to a sysplex view showing systems and
resources connected to a log stream.
DASDONLY
This filter requests a display of all log streams with a DASDONLY configuration.
LOGSTREAM or L
Display log stream sysplex information.
LSNAME or LSN = logstreamname
This filter displays all defined log streams matching the specified log stream name.
STRNAME or STRN = structurename
This filter displays all log streams on the sysplex that are defined to a structure that matches the specified
structure name.
DASDONLY
This filter displays all log streams matching other filters with a DASDONLY configuration.
STRUCTURE or STR
Display all log streams defined to a structure on a sysplex, sorted by structure name.
STRNAME or STRN = structurename
This filter displays all defined log streams (sorted by structure name) on the sysplex matching the
specified structure name.
34 OS/390 V2R8.0 MVS System Commands Summary
DISPLAY Command
DISPLAY or D LOGREC
D LOGREC[,{CURRENT|CURR}|{DATASET|DSN}|{ALL|A}]
[,L={a|cc|cca|name|name-a}]
Description:
Display logrec error and environmental record recording medium.
CURRENT or CURR
Display the current logrec medium.
DSN Display the logrec data set name and status.
ALL or A Display all, both current and alternate, logrec medium and data set names and status.
L=a,cc,cca,name or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will appear.
MVS System Commands Syntax 35
DISPLAY Command
DISPLAY or D M
D M[=CHP[(xx)|(xx-xx)|(list)]
|=CONFIG[(xx)]
|={CPUID|CPU}[(x)|(list)]
|={DEVICE|DEV}[([/]devnum)|([/]lowdevnum-[/]highdevnum)|(list)]
|=ESTOR[(ddddM-ddddM)|(list)|(E[=id])]
|=HIGH
|=HSA
|=SIDE[(id)]
|={STORAGE|STOR}[(ddddM-ddddM)|(list)|(E[=id])]
|=(parm[,parm]...)
[,L={a|cc|cca|name|name-a}]
Description:
Display system configuration information.
CHP Display the online/offline status of a single channel path(xx), a range of paths(xx-xx), or a combination thereof(list).
The identifiers have a range of 0-FF.
CONFIG[(xx)]
Display the differences between the current configuration and the configuration described in member CONFIGxx of
SYS1.PARMLIB. The default for xx is 00.
CPU or CPUID
Display the online/offline status of a single processor and Vector Facility(x) or a list with each processor separated
by a comma(list).
DEV or DEVICE
Display the number of online channel paths to a single device, devnum, a range of devices,
lowdevnum-highdevnum, or a list of devices and ranges in any combination.
ESTOR Display the number of megabytes of expanded storage assigned and available to the system, including online
expanded storage, expanded storage waiting to go offline, bad expanded storage, offline expanded storage,
expanded storage elements, and expanded storage that belongs to another configuration, for a
range(ddddM-ddddM) or list of ranges(list) of addresses of expanded storage. E=id displays the amount of storage
in the expanded storage element and identifies whether it is online or offline.
HIGH Display the highest possible central storage and expanded storage addresses in decimal M bytes (megabytes).
HSA Display the starting address and length of each portion of the hardware system area (HSA).
SIDE[(id)] Display the resources installed in side id.
STOR or STORAGE
Display the status of central storage for a range (ddddM-ddddM) or list of ranges (list) of addresses or a specific
storage element (E[=id]). *SHARED* indicates that the data is shared through the use of the IARVSERV macro.
(parm[,parm] ...)
Display the status of each resource you specify as parm. The list of parms you specify can include any
combination of CHP, CPU, DEV, HIGH, HSA, ESTOR, STOR(E[=id]), and STOR.
L=a, cc, cca, name, or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
36 OS/390 V2R8.0 MVS System Commands Summary
DISPLAY Command
DISPLAY or D MMS
D MMS[,L={a|cc|cca|name|name-a}]
Description:
Specify the status of MVS message service and a list of languages available.
L = a, cc, cca, name or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
DISPLAY or D MPF
D MPF[,{MSG|M} ]
|,{COLOR|C}
|,CMD
[,L={a|cc|cca|name|name-a}]
Description:
Display information about message processing and presentation.
MSG or M Display information on all messages that are defined in the current MPFLSTxx member or members.
COLOR or C Display the color, intensity, and highlighting options in effect.
CMD Display the status of the installation exit routines.
L=a, cc, cca, name or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
MVS System Commands Syntax 37
DISPLAY Command
DISPLAY or D OMVS
D OMVS[{,SUMMARY|S} ]
|,{ASID|A}=ALL
|,{ASID|A}=asid
|,U=userid
|,{PID}=processid
|,{FILE|F}
|,{VSERVER|V}
|,{CAPS|C}
|,{OPTIONS|O}
[,L={a|cc|cca|name|name-a}]
Description:
Display information about OpenMVS.
SUMMARY or S
Display the status of OpenMVS processes, file systems, and servers (for example, active or terminating) and the
BPXPRMxx parmlib member specified on the START OMVS command.
ASID=ALL or A=ALL
Display process information for all OpenMVS address spaces.
ASID=asid or A=asid
Display process information for the specified hexadecimal address space ID (ASID). If the specified ASID is not an
OpenMVS address space, an error message is issued.
U=userid Display process information for all processes associated with
FILE or F Display a list of HFS file systems that OpenMVS is currently using and the status of each HFS. the specified
TSO/E user ID.
VSERVER or V
Display process information for all processes that have been defined as server that use the virtual file system (VFS)
callable services API.
CAPS or C Display variable data containing lowercase letters in uppercase.
DISPLAY or D OPDATA
D {OPDATA|O}[,PREFIX][,L={a|cc|cca|name|name-a}]
Description:
OPDATA or O
Display information about message processing and presentation.
PREFIX Display command prefixes defined for subsystems in the prefixes defined.
L=a, cc, cca, name or name-a
The display area (a), console(cc), both (cca), console name (name), or both (name-a) where the display will
appear.
38 OS/390 V2R8.0 MVS System Commands Summary
DISPLAY Command
DISPLAY or D PARMLIB
D PARMLIB [,ERRORS|E]
[,L={a|cc|cca|name|name-a}]
Description:
Display the parmlib data sets and volume serial numbers that are defined in:
LOADxx
The MASTER JCL (when there are no LOADxx parmlib statements)
ERRORS or ET
Parmlib data sets and volume serial numbers that are defined in LOADxx PARMLIB statements but were not found
L=a, cc, cca, name or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
DISPLAY or D PFK
D PFK[,CN=cc ][,L={a|cc|cca|name|name-a}]
|,{TABLE|T}[=nnnnnnnn]
Description:
Display PFK definitions and tables.
TABLE or T Display PFK definitions in the PFK table nnnnnnnn. If you omit =nnnnnnnn, the system displays the list of PFK
tables available.
CN=cc Display the PFK definitions for the console with id cc.
L=a, cc, cca, name or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
MVS System Commands Syntax 39
DISPLAY Command
DISPLAY or D PROD
D PROD,{REGISTERED|REG}
{STATE }
{STATUS }
[,OWNER(o)][,NAME(n)][,FEATURENAME(fn)][,ID(id)][,ALL]
Description:
Display information about registered products or the product enablement policy.
REGISTERED | REG
Display information about any matching products that have registered as running on the system.
STATE Display information about the enablement state, defined in the enablement policy, for any matching products.
STATUS For the product entry that is the best match for the product you specify, display information about the enablement
policy entry that the system would use if the product attempted to register.
OWNER(n) Specify the owner of the displayed products.
NAME(n) Specify the name of the products to display.
FEATURENAME(fn)
Specify the feature name of the products to display.
ID(i) Specify the identifier for the products to display.
ALL Specify that all matching products, including those that registered with lfaedreg_Type_NoReport are to be
displayed.
DISPLAY or D PROG,APF
D PROG,APF[,ALL ]
|,DSNAME=libname
|,ENTRY=xxx
|,ENTRY=(xxx-yyy)
[,L={a|cc|cca|name|name-a}]
Description:
Display entries in the list of APF-authorized libraries.
PROG,APF Display libraries in the APF list.
ALL Display all libraries in the APF list.
DSNAME=libname
Display all entries for this library name.
ENTRY=xxx Display the entry for the specified decimal entry number.
ENTRY=(xxx-yyy)
Display all entries in the range specified.
L=a, cc, cca, name or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
40 OS/390 V2R8.0 MVS System Commands Summary
DISPLAY Command
DISPLAY or D PROG,EXIT
D PROG,EXIT,{{EXITNAME|EX|EN}=exitname}[,DIAG]
{{EXITNAME|EX|EN}=exitname }
{{EXITNAME|EX|EN}=exitname }
{{MODNAME|MOD}=modname }
{[ALL][,IMPLICIT|,IMP] }
[,L={a|cc|cca|name|name-a}]
Description:
Display dynamic exits.
PROG,EXIT Display the names of exits defined to the dynamic exits facility that have exit routines associated with them or have
had their attributes changed.
ALL Display the names of all exits that have been defined to the dynamic exits facility, have had exit routines associated
with them, or have had their attributes changed.
IMPLICIT or IMP
Display the names of exits that are implicitly defined to the dynamic exits facility.
EXITNAME= or EX= or EN=exitname
Display the names of all exit routines associated with the named exit, along with status information about the exit.
EXITNAME= or EX= or EN=exitname*
Display the names of exits that (1) have a name that matches exitname and (2) are defined or have had an exit
routine associated with them.
DIAG Display (in message CSV464I) diagnostic information for the exit specified by EXITNAME=exitname.
MODNAME= or MOD=name
Display the names of the exits with which the named exit routine is associated.
L=a, cc, cca, name or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
MVS System Commands Syntax 41
DISPLAY Command
DISPLAY or D PROG,LNKLST
D PROG,LNKLST[,NAME=[lnklstname|CURRENT] ]
[,NAMES ]
[,USERS,[CURRENT|NOTCURRENT|NAME=lnklstname]]
[,ASID=asid ]
[,JOBNAME=jobname ]
Description:
Display information about LNKLST sets for the LNKLST concatenation and associated jobs.
NAME=CURRENT or NAME=lnklstname
Display the data sets for the specified LNKLST set or concatenation.
NAMES Display the data sets for each LNKLST set defined to the system.
USERS,CURRENT Display a list of address spaces that use the current LNKLST set.
USERS,NOTCURRENT
Display a list of address spaces that use any LNKLST set other than the current LNKLST set.
USERS,NAME=lnklstname
Display a list of address spaces that use the LNKLST set specified by NAME=lnklstname.
ASID=asid Display the LNKLST set in use by the address space for the specified ASID.
JOBNAME=jobname Display the LNKLST set in use by the specified job.
DISPLAY or D PROG,LPA
D PROG,LPA{,MODNAME=modname}
{,CSAMIN }
[,L={a|cc|cca|name|name-a}]
Description:
Display the entry point, load point, and length information about modules dynamically added to the LPA, and display the minimum
amount of CSA and ECSA that must remain after adding a module to the LPA.
MODNAME=
Display the entry point, load point, and length information about the LPA module. You can use MOD and MODULE as
synonyms of MODNAME.
modname
is the 1-8 character LPA module name. If the last character of the modname is "*", it will be treated as X'CO'.
CSAMIN
Display the current CSA and ECSA minimum values.
L=a, cc, cca, name, or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will appear.
42 OS/390 V2R8.0 MVS System Commands Summary
DISPLAY Command
DISPLAY or D R
D R[,U ]
|
|,KEY[,SYS=sysname][,CN=(ALL)]
|
|[,I ][,msgformat][,MSG=msgid][,SYS=sysname][,KEY=keyname]
|[, ][,JOB=jobname]
|,E [,CN={xx|name|(ALL)}][,ROUT={ALL|(rrr[,sss]...) }
|,CE {(rrr-sss[,rrr-sss]...)}
|,R
|,M
|,{LIST|L}
|,{ALL|A}
|,
(See Note)
[,L={a|cc|cca|name|name-a}]
Description:
Display information about outstanding action messages (descriptor codes 1, 2, 3, and 11), WTORs, devices awaiting mount
requests to be fulfilled, and units requiring intervention.
U Display the device numbers of devices with unfulfilled mount requests and devices requiring operator intervention.
KEY Display an alphabetical list of keynames associated with outstanding messages along with the number of messages
for each keyname.
KEY=keyname
Request only those messages identified by keyname.
CN Display a set of messages and device numbers of devices awaiting mount requests to be fulfilled, and units
requiring intervention, or, if you specify KEY, a list of outstanding keynames of messages that appear at a specified
console(xx) or at all consoles(ALL).
MVS System Commands Syntax 43
DISPLAY Command
I Display the texts and identification numbers of all outstanding immediate action messages (descriptor code 1 or 2).
E Display the texts and identification numbers of all outstanding eventual action messages (descriptor code 3).
CE Display the texts and identification numbers of all outstanding critical eventual action messages (descriptor code
11).
R Display the texts and identification numbers of all messages awaiting replies.
M Display the texts and identification numbers of all immediate action, eventual action, and critical eventual action
messages, and messages awaiting replies.
LIST, L, ALL, A, or no operand
Display the texts and identification numbers of all immediate action, eventual action, and critical eventual action
messages and messages awaiting replies, along with the device numbers of devices with unfulfilled mount requests
and any units requiring operator intervention.
msgformat The format of messages sent to a console is to be displayed.
T Display the time the message was issued along with the job name or ID and system name of the issuer with
the message text.
S Display the system name and job name or ID of the issuer with the message text.
J Display the job name or ID of the issuer with the message text.
M Display only the message text.
MSG=msgid Display the text of any action message awaiting a reply if the message identifier begins with the one to ten
characters specified by msgid.
SYS=sysname
Display messages that have appeared at the system named sysname, or if you specify KEY, the keynames of
these messages.
ROUT Display only the outstanding action messages that have the specified routing codes.
L=a, cc, cca, name, or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
Note: If you supply all commas between DISPLAY R and operands that have equal signs, you get default values. Supply only
one comma before the L operand, if you omit preceding operands.
44 OS/390 V2R8.0 MVS System Commands Summary
DISPLAY Command
DISPLAY or D RTLS
D RTLS[,NAMES[,LIBRARY=lname[,VERSION=ver][,CURRENT|,SEQNUM=num|,ALL] ]
[ ]
[,PHYSICAL,LIBRARY=pname[,CURRENT|,SEQNUM=num|,ALL][,MODULE=mod|,LOGICAL]]
[ ]
[,LOGICAL{,LIBRARY=lname[,VERSION=ver][,CURRENT|,SEQNUM=num|,ALL] } ]
[ { [,MODULE=mod|,USERS] } ]
[ {,JOBNAME=jobname } ]
[ {,ASID=asid } ]

[,L={a|cc|cca|name|name-a}]
Description:
Displays the current status of the run-time library services (RTLS) environment. This command provides information about the
physical and logical libraries in use, the users of the logical libraries, and the cache use for a given library or for all libraries.
RTLS Displays information about the current RTLS environment.
NAMES Displays the RTLS common storage use and definitions, as well as the names of the physical and logical libraries.
LIBRARY=lname
Displays the common storage use and definitions, as well as the names of the physical and logical libraries that
match the specified name.
VERSION=ver
Displays information only for versions that match the specified version identifier.
CURRENT Displays information only for the current level.
SEQNUM=num
Displays information only for the level that matches the specified sequence number.
ALL Displays information for all levels.
PHYSICAL,LIBRARY=pname
Displays, for the specified library, the common storage use and definitions, as well as the names of the data sets
that make up the physical library.
MODULE=mname
Displays information about each module in the physical library with a name that matches the specified name.
LOGICAL Displays, for each matching library, statistics about the use of the library and the physical libraries of which the
logical library is a part.
LIBRARY=lname
Identifies a logical library.
USERS Displays users connected to the logical library.
JOBNAME=jobname
Displays the logical libraries to which the specified jobname is connected.
ASID=asid Displays the logical libraries to which the specified address space is connected.
L=a, cc, cca, name, or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
MVS System Commands Syntax 45
DISPLAY Command
DISPLAY or D SLIP
D SLIP[=xxxx][,L={a|cc|cca|name|name-a}]
Description:
Display detailed information about the SLIP trap identified by identifier xxxx. If xxxx is not specified, the system displays all traps
and tells whether each is enabled.
L=a, cc, cca, name, or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
DISPLAY or D SMF
D SMF[,S|,O][,L={a|cc|cca|name|name-a}]
Description:
Display the SMF data set names and their status (S) or display the current SMF options (O).
L=a, cc, cca, name, or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
46 OS/390 V2R8.0 MVS System Commands Summary
DISPLAY Command
DISPLAY or D SMS
D SMS[,{ACTIVE|A} ]
[ ]
[,CACHE ]
[ ]
[,CFCACHE(structurename|) ]
[ ]
[,CFLS ]
[ ]
[,CFVOL(volid) ]
[ ]
[,{DRIVE|DRI}(name|ALL)[,STATUS ] ]
[ |,DETAIL ]
[ ]
[,{LIBRARY|LIB}(name|ALL)[,STATUS[,LISTDRI]] ]
[ |,LISTDRI ]
[ |,DETAIL ]
[ ]
[,MONDS(specmask|) ]
[ ]
[,OAM ]
[ ]
[,OPTIONS ]
[ ]
[,OSMC[,TASK(name)] ]
[ ]
[,SHCDS ]
[ ]
[,SMSVSAM [,ALL] ]
[ ]
[,{STORGRP|SG}{(storgrp|ALL)}[,LISTVOL ] ]
[ |,DETAIL ]
[ ]
[,{TRACE|T} ]
[ ]
[,{VOLUME|VOL}(volume) ]
[,L={a|cc|cca|name|name-a}]
Description:
Display Storage Management Subsystem (SMS) information.
ACTIVE or A Display the three main SMS system data sets currently in use: the active control data set(ACDS), the
communications data set (COMMDS), and the source control data set (SCDS). This command also displays the
interval that SMS waits between reading device statistics for the 3990-3 control unit (DINTERVAL), the values that
were specified for the REVERIFY and ACSDEFAULTS parameters in the IGDSMSxx member of SYS1.PARMLIB,
and a list of the MVS systems in the complex.
MVS System Commands Syntax 47
DISPLAY Command
STORGRP or SG (storgrp)[,LISTVOL]
Display the status of one storage group for each MVS system that is connected to that storage group. If LISTVOL
is specified, all the volumes in the storage group and their SMS status are displayed.
STORGRP or SG (ALL) [,LISTVOL]
Display a list of all storage groups in the SMS configuration, indicating by symbol(. + - *) the status of each storage
group for each MVS system or system group. If you specify LISTVOL, the system displays a list of volumes in the
storage group, giving the status for each volume for each MVS system or system group in the complex.
VOLUME or VOL(volume)
Display status for the volume volume in the storage group with respect to the systems in the complex.
CACHE Display the following information for each 3990-3 control unit that has at least one SMS-managed volume attached
to it: SSID, SMSCNT, READ CONTROL, FAST WRITE CONTROL, READ HIT RATIO, and FAST WRITE RATE.
OPTIONS Display all of the SMS parameters and their status at the time the command is issued. The display indicates
whether each option is on or off, what data sets are being used, the size of regions, the time interval for recording
data, and all other parameter specifics.
TRACE or T Display the SMS trace options in effect at the time the command was issued, followed by the trace table size, and
an indication of whether each trace option is now on or off.
OAM The system displays the status of the tape or optical libraries, the tape or optical drives, the library optical drives,
the tape or optical volumes, and the number of read/write requests waiting.
OSMC The system displays the status of the OAM storage management component (OSMC).
TASK(name)
The system displays the OSMC status for a specific task.
DRIVE(name or ALL)
The system displays system connectivity and the online/offline status of the optical drives. When the drive name is
specified the status for that drive is shown in a single line display. When ALL is specified the status for all the
optical drives is shown. If ALL is the drive name it must be in double parenthesis, ((ALL)).
LIBRARY(name or ALL)
The system displays system connectivity and the online/offline status of the tape and optical libraries. When the
library name is specified the status for that library is shown in a single line display. When ALL is specified the
status for all the tape and optical libraries is shown. If ALL is the library name it must be in double parenthesis,
((ALL)).
STATUS Display online / offline status for tape and optical drives or libraries.
DETAIL Display detail status for tape and optical libraries, tape and optical storage groups and optical drives (in messages
CBR1110I, CBR1120I, and CBR1130I). See OS/390 MVS System Messages, Vol 2 (ASB-EZM) for more
information.
LISTDRI Display the offline/online status for all optical drives associated with specified libraries. Cannot specify with
DETAIL.
L=a, cc, cca, name or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
48 OS/390 V2R8.0 MVS System Commands Summary
DISPLAY Command
DISPLAY or D SSI
D SSI[,{LIST|L}|{ALL|A}][,{DYNAMIC|DYN|D}={YES|Y}|{NO|N}]
[ ]
[,{FUNC|F}=funclist ]
[ ]
[,{STATUS|STAT|ST}={ACTIVE|ACT}|{INACTIVE|INACT|I} ]
[ ]
[,{SUBSYS|SUB}=subsysname ]
[,L={a|cc|cca|name|name-a}]
Description:
Display information about all subsystems defined to MVS.
LIST or L Display the LIST output format. The LIST format is the default keyword.
ALL or A Display the ALL output format. This output is the same as the LIST format except that the system includes a
sublist after each list element. The sublist contains a list of function codes to which the subsystem responds.
DYNAMIC or DYN or D=YES or Y or NO or N
Indicator of whether the subsystem is dynamic.
FUNC or F=funclist
Display a list of function codes to which the subsystem responds. The funclist value can be either a number no
greater than 3-digits or a list of numbers no greater than 3-digits.
STATUS or STAT or ST=ACTIVE or ACT or INACTIVE or INACT or I
Displays the status of the subsystem.
SUBSYS or SUB=subsysname
Display the subsystem name.
L=a, cc, cca, name, or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
DISPLAY or D SYMBOLS
D SYMBOLS[,L={a|cc|cca|name|name-a}]
Description:
Display static system symbols and their associated substitution text.
DISPLAY or D T
D T
Description:
Display the local time of day and date and the Greenwich Mean Time (GMT).
MVS System Commands Syntax 49
DISPLAY Command
DISPLAY or D TRACE
D TRACE[,COMP=cname[,SUB=(subname)][,N=nnn][,SUBLEVEL] ]
[ ]
[,COMP={(cname[,cname]...)|ALL} ]
[ ]
[,WTR={(name[,name],...)|ALL} ]
[,L={a|cc|cca|name|name-a}]
Description:
Display component trace status.
TRACE Display status information about the system and the components defined to component trace.
COMP=ALL Display status, in long form, for all components.
COMP=(cname)
Display component status, in long form, for the component names requested.
SUB=(subname)
Display subordinate node status for the SUBs requested. If the sub level trace name contains any national
characters (@ # $ _) then the name must be enclosed in quotes. Otherwise, quotes are not required. In either
case, the alphabetic characters can be specified in upper or lower case.
N=nnn Display the subordinate node status and specified 'nnn' number of parallel or sublevel nodes of the requested
subordinate node.
SUBLEVEL Display sublevel trace status.
WTR=(name[,name],...) or ALL
Display information about one or more component trace external writers.
L=a, cc, cca, name or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a).
50 OS/390 V2R8.0 MVS System Commands Summary
DISPLAY Command
DISPLAY or D U
D {U[,devicetype][,ONLINE ][[,[/]devnum][,nnnnn]]}
{ [,OFFLINE ] }
{ [,ALLOC ] } (See Note)
{ [,AUTOSWITCH|AS] }
{U,IPLVOL }
{U,VOL=volser }
[,L={a|cc|cca|name|name-a}] }
Description:
Display device status and allocation.
devicetype The device type for which the system is to display unit status information.
ONLINE or OFFLINE
Display unit status information only for those devices online/offline depending on which you specify. If neither is
specified, both device types will be displayed.
ALLOC Display allocation information.
AUTOSWITCH or AS
Display information about tape devices defined as automatically switchable.
[/]devnum,nnnnn
Display unit status information about devices starting with the device number devnum for nnnnn number of devices.
The default for devnum is X'0000'. The default for nnnnn is 8 if ALLOC was specified, or 16 otherwise.
IPLVOL Display information about the volume from which the system was initially loaded (IPL'ed).
VOL=volser The volume serial of the device for which the system is to display unit status information in message IEE457I.
L=a, cc, cca, name, name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a), where the display will
appear.
Note: Supply all commas between DISPLAY U and a specified operand.
MVS System Commands Syntax 51
DISPLAY Command
DISPLAY or D WLM
D WLM[,SYSTEM=sysname|,SYSTEMS]
[,APPLENV=applenvname|]
[,SCHENV=schenvname[,SYSTEM=sysname|,SYSTEMS]]
[,RESOURCE=resourcename[,SYSTEM=sysname|,SYSTEMS]]
[,L={a|cc|cca|name|name-a}]
Description:
Display workload management service policy, service definition, mode, application environments, resources, and scheduling
environments.
WLM Display the name of the active service policy in effect on all systems in the sysplex and the time and date that the
service policy was activated. Also, provide information about the installed service definition.
SYSTEM=sysname
Display the status of the named system.
SYSTEMS Display the status of all systems in the sysplex.
APPLENV=applenvname | *
Display the status of the named application environment. Use * to display all application environments.
SCHENV=schenvname
Display status information for the named scheduling environment. You can display multiple scheduling
environments by using wildcard characters (* and ?).
RESOURCE=resourcename
Display status information for the named resource. You can display multiple resources by using wildcard
characters (* and ?).
52 OS/390 V2R8.0 MVS System Commands Summary
DISPLAY Command
DISPLAY or D XCF
D XCF[,{PATHIN|PI} ]
[ [,{DEVICE|DEV}={([/]indevnum[,[/]indevnum...])|ALL}] ]
[ [,{STRNAME|STRNM}={(strname[,strname]...)|ALL}] ]
[ [,{SYSNAME|SYSNM}=(sysname[,sysname]...)] ]
[ [,{STATUS|STAT}=([STARTING][,RESTARTING][,WORKING] ]
[ [,STOPPING][,STOPFAILED][,INOPERATIVE] ]
[ [,LINKING][,QUIESCING]) ] ]
[ ]
[ ]
[,{PATHOUT|PO} ]
[ [,{DEVICE|DEV={([/]outdevnum[,[/]outdevnum...])|ALL}] ]
[ [,{STRNAME|STRNM}={(strname[,strname]...)|ALL}] ]
[ [,CLASS={(classname[,classname]...)|ALL}] ]
[ [,{SYSNAME|SYSNM}=(sysname[,sysname]...)] ]
[ [,{STATUS|STAT}=([STARTING][,RESTARTING][,WORKING] ]
[ [,STOPPING][,STOPFAILED][,INOPERATIVE] ]
[ [,LINKING][,QUIESCING])] ]
[ [,REBUILDING][,QUIESCED])] ]
[ ]
[,{LOCALMSG|LM}[,CLASS={(classname[,classname]...)|ALL}] ]
[ ]
[,{GROUP|GRP},groupname[,membername|ALL] ]
[ ]
[,{SYSPLEX|S}[,systemname|ALL] ]
[ ]
[,{COUPLE|CPL}[,TYPE={(name[,name...])|ALL}] ]
[ ]
[,{CLASSDEF|CD} ]
[ [,CLASS={classname|(classname[,classname]...)|ALL}] ]
[ |,{GROUP|G}=groupname ]
[ ]
[,{STRUCTURE|STR} ]
[ [,{STRNAME|STRNM}={(strname[,strname]...)|ALL}] ]
[ [,{CONNAME|CONNM}={(conname[,conname]...)|ALL}] ]
[ [,{STATUS|STAT}=([ALLOCATED][,NOTALLOCATED] ]
[ [,POLICYCHANGE][,DEALLOCPENDING] ]
[ [,LARGERCFRMDS][,REBUILD][,STRDUMP] ]
[ [,ALTER][,FPCONN][,NOCONN])] ]
[ ]
[,{CF}[,{CFNAME|CFNM}={(cfname[,cfname]...)|ALL}] ]
[ ]
[,{POLICY|POL}[,TYPE={(name[,name]...)|ALL}] ]
[ ]
[,{PRSMPOLICY|PRSMPOL} ]
[ ]
[,{ARMSTATUS|ARMS} ]
[ [,{RESTARTGRP|RG}=rgname] ]
[ [,{ELEMENT|EL}=elname|{JOBNAME|JOB}=jobname] ]
[ [,INITSYS=initsys] ]
[ [,CURRSYS=currsys] ]
[ [,STATE=([{STARTING|START}][,{AVAILABLE|AVAIL}][,FAILED] ]
[ [,{RESTARTING|RESTART}][,{RECOVERING|RECOVER}])] ]
[ [,DETAIL] ]
[,L={a|cc|cca|name|name-a}]
MVS System Commands Syntax 53
DISPLAY Command
Description:
Display a summary of the current sysplex.
PATHIN or PI
Display the device number of inbound signalling paths XCF can use in the sysplex.
DEVICE={([/]indevnum[,[/]indevnum]..) or ALL}]
Display information about the devices requested (indevnum) or all of the inbound signalling paths currently defined
(ALL)
PATHOUT or PO
Display the device number of outbound signalling paths XCF can use in the sysplex.
DEVICE or DEV = {([/]outdevnum[,[/]outdevnum]..) or ALL}]
Display information about the devices requested (outdevnum) or all of the outbound signalling paths currently
defined to XCF (ALL).
LOCALMSG Display information about the signalling resources.
GROUP Display information about multisystem application groups.
SYSPLEX Provide a list of systems currently participating in the sysplex.
COUPLE Display the current XCF information specified in the COUPLExx parmlib member or on the COUPLE parameter of
the SETXCF command.
CLASSDEF Display the transport classes defined to XCF.
STRUCTURE
Display information about the coupling facility structures in the policy.
CF Display information about coupling facilities that are attached to the system.
POLICY Display information about the policies in use.
PRSMPOLICY
Display the name of the parmlib member in SYS1.PARMLIB that contains the current active XCF PR/SM policy.
ARMSTATUS
Display information about active batch jobs and started tasks that are registered as elements of the automatic
restart manager.
groupname Display members of specified group.
membername or ALL
Specify information about members of a particular group (membername) or all groups (ALL).
systemname or ALL
Provide system status and last recorded system status monitor time stamp for specified system (systemname) or all
systems in the sysplex (ALL).
CLASS={(classname[,classname]..) or ALL}]
Display information for a specified transport class (classname) or all transport classes (ALL).
L= a, cc, cca, name or name-a.
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
54 OS/390 V2R8.0 MVS System Commands Summary
DUMP Command
DUMP Command
DUMP
DUMP {COMM={(title)} [,PARMLIB=xx] }
{'title'} |[,PARMLIB=(xx[,xx]...)]
{"title"} [SYMDEF=(symdef[,symdef]...)]
{TITLE={(title)} }
{'title'}
{"title"}
Description:
Cause a system dump of virtual storage (SVC dump). The system responds by prompting you in message IEE094D for the dump
options. Specify these options by using the REPLY command, which is documented under REPLY or R. The title of the dump,
which you specify by enclosing 1-100 characters in parentheses or single or double quotes, becomes the first record in the dump
data set. COMM and TITLE are synonyms.
MVS System Commands Syntax 55
DUMPDS Command
DUMPDS Command (DD)
DUMPDS or DD
DD ADD,{DSN={nn } }
{ {(nn[,nn]...) } }
{ {nn-nn } }
{ {(nn-nn[,nn-nn]...) } }
{ {(nn[,nn]...,nn-nn[,nn-nn]...)} }
{ {ALL } }
{ {(ALL) } }
{ }
{SMS={class } }
{ {(class[,class]...)} }
{ }
{VOL={volser } }
{ {(volser[,volser]...)} }

Where class represents:

{storclas }
{([DATA|D=[dataclas]][,MGMT|M=[mgmtclas]][,STOR|S=[storclas]])}

Description:
Change the systems list of SYS1.DUMP data sets or clear full SYS1.DUMP data sets and make them available for dumps.
ADD,DSN= Add the specified direct access data sets to the list of SYS1.DUMP data sets.
nn The two-digit decimal identifier (00-99) of a direct access SYS1.DUMP data set you want to add to its list of
SYS1.DUMP data sets.
ALL Add cataloged direct access SYS1.DUMP data sets to systems list of SYS1.DUMP data sets.
ADD,SMS= The system is to add the specified SMS class(es) to the systems list of resources for automatic allocation of dump
data sets.
class The 1-8 character SMS storage class you want to add to the system's list of resources for automatic
allocation.
ALL Requests that all SMS storage classes be added to the system's list of resources available for
automatic dump data set allocation.
ADD,VOL= Add the specified direct access volume(s) to the systems list of resources for automatic allocation of dump data
sets.
volser The 1-6 character volume serial number of the direct access volume you want to add to the system's
list of resources for automatic allocation.
ALL Request that all DASD volumes be added to the system's list of resources available for automatic
allocation of dump data sets.
DD ALLOC={ACTIVE|INACTIVE}
ALLOC=ACTIVE
Dump data sets are automatically allocated when a dump is requested.
ALLOC=INACTIVE
Initial state of the system after IPL. Dump data sets are not automatically allocated when a dump is requested.
56 OS/390 V2R8.0 MVS System Commands Summary
DUMPDS Command
DD CLEAR,DSN={nn }
{(nn[,nn]...) }
{nn-nn }
{(nn-nn[,nn-nn]...) }
{(nn[,nn]...,nn-nn[,nn-nn]...)}
{ALL }
{(ALL) }
Description:
Empty the specified data set and mark it as available to receive a dump.
CLEAR,DSN=nn or ALL
Clear and mark as available for dumps the specified direct access dump data sets on the systems list of
SYS1.DUMP data sets. The system clears each full direct access dump data set by writing an end-of-file mark at
the beginning of the data set.
nn The two-digit decimal identifier (00-99) of a direct access SYS1.DUMP data set you want to clear and mark as
available for a dump.
ALL Clear and mark as available for a dump all direct access dump data sets in the systems list of SYS1.DUMP data
sets.
MVS System Commands Syntax 57
DUMPDS Command
DD DEL,{DSN={nn } }
{ {(nn[,nn]...) } }
{ {nn-nn } }
{ {(nn-nn[,nn-nn]...) } }
{ {(nn[,nn]...,nn-nn[,nn-nn]...)} }
{ {ALL } }
{ {(ALL) } }
{ }
{SMS={class } }
{ {(class[,class]...)} }
{ {ALL } }
{ {(ALL) } }
{ }
{VOL={volser } }
{ {(volser[,volser]...)} }
{ {ALL } }
{ {(ALL) } }

Where class represents:

{storclas }
{([DATA|D=[dataclas]][,MGMT|M=[mgmtclas]][,STOR|S=[storclas]])}

Description:
Remove from the systems list of dump data set resources specific SYS1.DUMP data sets, SMS classes, or DASD volumes.
DEL,DSN= The system is to remove the specified direct access dump data sets from its list of SYS1.DUMP data sets.
nn The two-digit decimal identifier (00-99) of a cataloged direct access SYS1.DUMP data set you want
to remove from its list of SYS1.DUMP data sets.
ALL The system is to remove all pre-allocated direct access dump data sets from its list of SYS1.DUMP
data sets.
DEL,SMS= The system is to remove the specified SMS class(es) from the systems list of resources for automatic allocation of
dump data sets.
class The 1-8 character SMS storage class you want to remove from the system's list of resources for
automatic allocation.
ALL Request that all SMS storage classes be removed from the system's list of resources available for
automatic dump data set allocation.
DEL,VOL= Remove the specified direct access volume(s) from the systems list of resources for automatic allocation of dump
data sets.
volser The 1-6 character volume serial number of the direct access volume you want to remove from the
system's list of resources for automatic allocation.
ALL Request that all DASD volumes be removed from the system's list of resources available for
automatic allocation of dump data sets.
DD NAME=name-pattern
Description:
Establish a name-pattern for automatically allocated dump data sets.
NAME=name-pattern
Automatically allocated dump data sets are named using the naming convention specified by the name-pattern.
The name-pattern can include both text and symbols for which the system will substitute text when it generates the
data set name.
58 OS/390 V2R8.0 MVS System Commands Summary
FORCE Command
FORCE Command
FORCE
FORCE {jobname }[,ARM][,A=asid][,ARMRESTART]
{U=userid }
{[jobname.]identifier}
Description:
End a named job, which can be a batch job, a started task, or an APPC/MVS transaction program.
WARNING:
BE SURE YOU ARE AWARE OF ALL THE CONSEQUENCES OF ISSUING A FORCE COMMAND.
Use the Force command only as a last resort after several CANCEL commands are unsuccessful. (If you do not attempt to
use the CANCEL command before entering a FORCE command, the system issues error message IEE838I.)
If you need a dump, issue a DUMP command before you issue a FORCE command. (Once you issue a FORCE command it
is usually not possible to get a dump of the failing address space.)
If the CANCEL command fails, then use the FORCE nnn,ARM command (for non-cancellable procedures).
If that fails, use the FORCE command without the ARM parameter.
jobname The name of the job to cancel.
U=userid Terminate the specified user ID or, if the user does not have a unique name yet, terminate the user ID logging on
at address asid, using the following command: CANCEL U=LOGON, A=asid where asid is the hexadecimal address
space identifier.
[jobname.]identifier
The identifier for the unit of work to cancel, optionally preceded by the job name.
You can use the following types of identifiers:
The identifier that was specified on the START command.
[/]devnum, the device number specified on the START or MOUNT command.
devicetype, the type of device specified on the START or MOUNT command.
ARM End the specified user, job, or started task if it is non-cancellable. The ARM operand invokes normal job
termination routines without causing address space destruction.
Note: This keyword is not related to the ARMRESTART parameter and the functions of the automatic restart
manager.
A=asid The hexadecimal address space identifier of the work unit to terminate.
ARMRESTART
Indicate that the batch job or started task should be automatically restarted, if it has registered as an element of the
automatic restart manager.
MVS System Commands Syntax 59
HALT Command
HALT Command (Z)
HALT or Z
Z EOD
Description:
Record statistics before stopping the operating system. Store the internal I/O device error counts in the logrec data set, empty the
SMF buffers on to the active SMF data set in SYS1.MANx, close the system log, and put it on the print queue.
60 OS/390 V2R8.0 MVS System Commands Summary
IOACTION Command
IOACTION Command (IO)
IOACTION or IO
IO {STOP,DEV=([/]devnum[,[/]devnum]...) }
{STOP,DEV=([/]lowdevnum-[/]highdevnum[,[/]lowdevnum-[/]highdevnum]...) }
{RESUME,DEV=([/]devnum[,[/]devnum]...)|ALL }
{RESUME,DEV=([/]lowdevnum-[/]highdevnum[,[/]lowdevnum-[/]highdevnum]...) }
Note: You can enter individual device numbers and ranges on the same command. For example:
IO RESUME,DEV=(/2233,/99-/112,16)
Description: Stop and resume I/O activity to DASD under certain conditions.
STOP,DEV Stop all I/O activity to the specified DASD.
RESUME,DEV
Resume normal activity to the specified DASD. When ALL is specified, I/O activity is resumed to any DASD device
that had been stopped by the IOACTION STOP command on that system.
[/]devnum or [/]lowdevnum-[/]highdevnum
The device number or the device numbers of the lower and upper bounds of a range of devices.
MVS System Commands Syntax 61
LIBRARY Command
LIBRARY Command (LI)
LIBRARY or LI
Description: Perform any of several tasks associated with tape drives and tape volumes, as described below.
LI {DISPCL|DC},devnum
devnum The device number of the tape drive.
LI {DISPDRV|D},{devnum[,#devices]}
{libname }
{devnum1-devnum2 }
[,L={a|cc|cca|name|name-a}]
devnum The MVS device number of a tape drive in a library.
libname Name of the library in which the tape drive resides. For a stand-alone tape drive (non-library resident drive), this
field contains --N/A--.
LI {EJECT|E},volser[,{KEEP|K }] [,{BULK|B}]
[,{LOCATION|L}]
[,{PURGE|P }]
EJECT or E Physically eject a volume from a library
volser The serial number of the volume to eject from the library.
KEEP or K Indicate, for system-managed tape libraries, that the system is to retain the volume record in the tape configuration
database upon completion of the eject operation.
LOCATION or L
Indicate that the operator wants to update the shelf location associated with the volume.
PURGE or P Indicate, for system-managed tape libraries, that the volume record in the tape configuration database is to be
deleted upon completion of the eject operation. When PURGE is specified, there is no prompt for shelf location.
BULK or B Directs that the system is to place the tape volume in the high-capacity output station of the IBM 3495 Tape Library
Dataserver. If you do not specify the BULK option, the system places the volume in the convenience output
station.
LI {RESET|R},{CBRUXCUA}
{CBRUXEJC}
{CBRUXENT}
{CBRUXVNL}
Indicate that the system is to reactivate the following installation exit:
CBRUXCUA Change use attribute.
CBRUXEJC Cartridge eject.
CBRUXENT Cartridge entry.
CBRUXVNL Volume not in library.
62 OS/390 V2R8.0 MVS System Commands Summary
LIBRARY Command
LI {SETCL|SC},{devnum|devrange},{MEDIA1|MEDIA2|NONE}
devnum The MVS device number of a tape drive within a library.
devrange The MVS device number range (xxxx-yyyy) of library resident tape drives.
MEDIA1 Indicate that the media type of scratch volumes to be loaded is Cartridge System Tape.
MEDIA2 Indicate that the media type of scratch volumes to be loaded is Enhanced Capacity Cartridge System Tape.
NONE Indicate that no scratch volumes are to be loaded.
MVS System Commands Syntax 63
LOG Command
LOG Command (L)
LOG or L
L 'text'
Description:
Make an entry into the system log (up to 122 characters). It goes to the master console if the log is temporarily inactive. Reenter
the command later.
64 OS/390 V2R8.0 MVS System Commands Summary
LOGOFF Command
LOGOFF Command
LOGOFF
LOGOFF
Description:
End your terminal session. You must issue LOGOFF when you leave your console and your installation requires operators to log
on before issuing commands or performing secured functions.
When LOGON is required at your installation, LOGOFF leaves the console in a secure state. The system does not accept
commands from this console until another LOGON command is completed. The console is in roll mode (MODE=R). When
LOGON is automatic at your installation, the system issues another MCS LOGON command to that MCS console.
MVS System Commands Syntax 65
LOGON Command
LOGON Command
LOGON
Description:
To remove the LOGON prompt from the screen, use the CLEAR key or the PA2 key. To restore the panel enter:
LOGON [userid]
The LOGON command will restore the logon panel display. The userid is an 8-character field where you enter your
operator userid. The userid parameter is optional; the system will prompt you for it.
IEE187I ENTER LOGON PARAMETERS
LOGON {userid} PASSWORD {password}
GROUP [racfgroup] SECLABEL [label]
Description:
Use the LOGON command to identify yourself to the system when your installation requires operators to log on to the system
before issuing commands. After the security product, such as RACF, has completed initialization, all MCS consoles will prompt for
a user id and password. The command allows you to tab from one field to another.
LOGON {userid}
The LOGON prompt is displayed in a protected field. The userid is an 8-character field where you enter your
operator userid. The userid parameter is required.
PASSWORD {password}
The PASSWORD prompt is displayed in a protected field. Your password can be up to 8 characters. The input to
this field is not displayed. The password field allows you to change your password by using the
old-password/new-password/new-password format. The password parameter is required.
GROUP [racfgroup]
The GROUP prompt is displayed in a protected field. The racfgroup is an 8-character field where you enter your
RACF group identifier. The racfgroup parameter is optional.
SECLABEL [label]
The SECLABEL prompt is displayed in a protected field. The label is an 8-character field where you enter your
RACF security label identifier. The label parameter is optional.
66 OS/390 V2R8.0 MVS System Commands Summary
MODE Command
MODE Command
MODE
MODE {PD}[,INTERVAL={nnnnn}][,RECORD[=nnn ][,CPU={x }]
{SD} {3 } |=ALL {ALL}
{IV} |=25
{TC} |=16
{PT} |=5
{CC}
{VS}
{PS}
{AD}
{SL}
{SC}
Description:
Control the recording of hard machine check interruptions.
PD Instruction-processing damage machine checks are to be monitored in the specified mode.
SD System damage machine checks are to be monitored in the specified mode.
IV Machine checks indicating invalid PSW or registers are to be monitored in the specified mode.
TC Machine checks indicating TOD clock damage are to be monitored in the specified mode.
PT Machine checks indicating processor timer damage are to be monitored in the specified mode.
CC Machine checks indicating clock comparator damage are to be monitored in the specified mode.
VS Machine checks indicating Vector Facility source are to be monitored in the specified mode.
PS Machine checks indicating primary clock synchronization are to be monitored in the specified mode.
AD Machine checks indicating ETR attachment are to be monitored in the specified mode.
SL Machine checks indicating switch to local synchronization are to be monitored in the specified mode.
SC Machine checks indicating ETR synchronization checks are to be monitored in the specified mode.
INTERVAL = nnnnn
Define the number of seconds used in counting hard machine check interrupts.
RECORD = nnn
After the specified number of hard machine checks of the specified type on the specified processor in the specified
interval, the system invokes alternate CPU recovery (ACR) to take the failing processor offline. The defaults are 16
for PD and 5 for all others. All interruptions are recorded on the logrec data set until ACR is invoked.
RECORD = ALL
All specified hard machine check interruptions are to be recorded on the logrec data set. The system no longer
monitors the frequency of hard machine check interruptions.
CPU=x or CPU=ALL
Specify the address (0, 1, 2, 3, ...) of a processor or ALL for all processors, to be monitored.
MVS System Commands Syntax 67
MODE Command
MODE {SR}[,QUIET ][,CPU={x|ALL}]
{DG} |,RECORD[=nnn ]
|=ALL[,REPORT=nnn]
|=5
|=1
Description:
Control the recording and reporting of system recovery and degradation machine check interruptions.
SR Place system recovery machine checks in the specified recording mode.
DG Place degradation machine checks in the specified recording mode.
QUIET No machine check interruptions of the specified type are to occur or be recorded for the specified processor.
RECORD=nnn
After nnn system recovery or degradation machine check interruptions occur on the specified processor, the
system will notify you and switch the recording mode to QUIET for that type of interruption on that processor. The
defaults are 1 for DG and 50 for SR.
RECORD=ALL
Record all system recovery or degradation machine check interruptions occurring on the specified processor in the
logrec data set. The default number of interruptions is 4 for DG and 50 for SR. Using the REPORT parameter can
change this default. You are notified each time the specified number of interruptions occurs, but the system does
not switch to QUIET mode.
CPU=x or CPU=ALL
Specify the address (0, 1, 2, 3, ...) of the processor or ALL for all processors.
MODE [STATUS]
Description:
Display the event counters and recording monitoring status associated with each type of machine check interruption.
68 OS/390 V2R8.0 MVS System Commands Summary
MODIFY Command
MODIFY Command (F)
MODIFY or F
F [jobname.]identifier,parameters
Description:
Change the job parameters as the programmer specifies.
jobname The name of the job, or for a started task, the assigned job name.
identifier The identifier assigned to the job or started task.
parameters Program parameters passed to the started program.
F [jobname.]identifier,TS=START[,member]
Description:
Start TSO/TCAM time-sharing once TCAM is active.
jobname The name of the job.
identifier The user-determined identifier used on the START command to identify TCAM.
TS=START Initiate TSO/TCAM time sharing.
member The SYS1.PARMLIB member containing TSO/TCAM time-sharing system parameters.
F [jobname.]identifier,TS=STOP
Description:
Stop TSO/TCAM time-sharing.
jobname The name of the job
identifier The user-determined identifier used on the START command to identify TCAM.
TS=STOP Stop TSO/TCAM time sharing.
F [jobname.]identifier,{USERMAX=nnnnn}
{USER={SIC } }
{ {FSTOP} }
Description:
Modify TSO/VTAM time-sharing.
jobname The name of the job. Many installations use TCAS as the name.
identifier The identifier specified on the START command that started TSO/VTAM time-sharing.
USERMAX=nnnnn
Set the maximum number of users that can be logged on to TSO/VTAM time-sharing at one time (0-32,767).
USER=SIC Cause the TCAS to cancel all TSO/VTAM terminal user address spaces normally. The terminal users receive any
queued messages.
USER=FSTOP
Cause the TCAS to cancel all TSO/VTAM terminal user address spaces immediately. The terminal users do not
receive any queued messages. Use FSTOP only after several unsuccessful tries with SIC.
MVS System Commands Syntax 69
MODIFY Command
F BPXOINIT,{TERM}=pid{.tid}
{FORCE}=pid{.tid}
{SHUTDOWN=FORKINIT}
{ {=FORKS}
{RESTART=FORKS}
{DUMP}=pid
Description:
Control OS/390 UNIX System Services, terminate an OS/390 UNIX process or thread, shut down the OS/390 UNIX initiators, or
request a SYSMDUMP for a process.
BPXOINIT The name of the job.
TERM= Allow the signal interface routine to receive control before the thread is terminated.
pid.tid
pid is the decimal form of the process id that is going to be terminated. tid is the hexadecimal form of the
thread id that is going to be terminated.
FORCE= Do not allow the signal interface routine to receive control before the thread is terminated.
pid.tid
pid is the decimal form of the process id that is going to be terminated. tid is the hexadecimal form of the
thread id that is going to be terminated.
SHUTDOWN=FORKINIT
Shut down the OS/390 UNIX initiators. Normally, these initiators shut themselves down in 30 minutes.
SHUTDOWN=FORKS
Shut down the fork() service by preventing future forks and non-local spawns. The kernel is prevented from
obtaining additional WLM fork initiators for fork and spawn, and attempts to terminate all WLM fork initiator address
spaces that are running processes created by fork or non-local spawn. All other services remain up, but any new
dub requests are suspended until the fork() service is restarted.
RESTART=FORKS
Enable the system to resume normal processing. Suspended dub requests are resumed.
DUMP=pid Request a SYSMDUMP. A SIGDUMP signal is sent to the specified process. pid is the decimal form of the process
id that is going to be terminated.
70 OS/390 V2R8.0 MVS System Commands Summary
MODIFY Command
F CATALOG,{ABEND{(id) } }
{ {(yyyyyyyy)} }
{ {(ALLOCATE)} }
{ {(ANALYSIS)} }
{ {(MODIFY) } }
{ALIASLEVEL(n) }
{ALLOCATE(nnnnnn...)[,NOISC] }
{ |,NOVLF }
{ALLOCATED[(vvvvvv)] }
{CATMAX(nn) }
{CLOSE(nnnnnn...) }
{DUMPON }
{DUMPOFF }
{ECSHR{(CONNECT) } }
{(DISCONNECT) } }
{(STATUS) } }
{(ADD,catname) } }
{(REMOVE,catname)} }
{(STATUS,catname)} }
{(AUTOADD) } }
{END(id)[,REDRIVE ] }
{ |,NOREDRIVE }
{ENTRY[(cname) ] }
{ |(mmmmmmmm) }
{ISC(nnnnnn...) }
{LIST[(id) ] }
{ |(yyyyyyyy) }
{LISTJ(jobname) }
{NOISC(nnnnnn...) }
{NOROTATE }
{NOVLF[(nnnnnn...)] }
{NOWARNING }
{OPEN[(vvvvvv)] }
{REPORT[,VLF[cname] ] }
{ |,PERFORMANCE }
{ |,DUMP }
{RESTART }
{ROTATE }
{SYS%ON }
{SYS%OFF }
{TASKMAX(nn) }
{UNALLOCATE[nnnnnn...] }
{VCLOSE(vvvvvv) }
{VLF[(nnn...)] }
{WARNING }
Description:
Communicate with the catalog address space. Use this command only at the direction of the system programmer.
MVS System Commands Syntax 71
MODIFY Command
ABEND(id) or ABEND(yyyyyyyy)
The catalog address space is to cause an abnormal termination of one service task with an abend code of 91A and
take an SVC dump. id is the task id and yyyyyyyy is the address of the TCB for the catalog address space
service task, in hexadecimal.
ABEND(ALLOCATE)
Cause the catalog address space allocation task to end and a new one to be attached.
ABEND(ANALYSIS)
Cause the catalog address space analysis task to end and a new one to be attached.
ABEND(MODIFY)
Cause the catalog address space modify task to end and a new one to be attached.
ALIASLEVEL(n)
Change the number of alias levels of qualification being used by multilevel alias logic in a catalog search.
ALLOCATE(nnnnnn...)[,NOISC]
Provide the ability for integrated catalog facility catalogs to be allocated to the catalog address space. NOISC
deactivates the in-storage catalog (ISC) for this catalog, and nnnnnn is the integrated catalog facility catalog name.
CATMAX(nn)
Close all open integrated catalog facility user catalogs and set a maximum number of such catalogs that can be
opened concurrently in the catalog address space.
CLOSE(nnnnnn...)
Close dynamically an integrated catalog facility named nnnnnn..., without affecting existing allocations.
DUMPON or DUMPOFF
Activate or deactivate dynamic dumping by the catalog address space.
ECSHR Activate or deactivate enhanced catalog sharing (ECS) or display status for the entire system or for an individual
catalog.
CONNECT
Connect the system to the ECS structure in the coupling facility.
DISCONNECT
Disconnect the system from the ECS structure in the coupling facility.
STATUS
Display (in message IEC380I) the status of the coupling facility connection and of each catalog referenced
since the last IPL.
ADD,catname
Add the named catalog to the ECS structure in the coupling facility if it has the ECSHARING attribute,
shareoptions (3 4), is on a shared volume, and the system is connected to the ECS structure.
REMOVE,catname
Remove the named catalog from the ECS structure in the coupling facility.
STATUS,catname
Display (in message IEC380I) the status of the coupling facility connection and the ECS status of the
named catalog.
AUTOADD
Automatically add ECS-eligible catalogs to the ECS structure in the coupling facility on the next reference.
72 OS/390 V2R8.0 MVS System Commands Summary
MODIFY Command
END(id),REDRIVE or END(id),NOREDRIVE
The catalog address space is to end the processing of the service task with name id. Specifying REDRIVE allows
the current catalog request to be processed by a different task, while NOREDRIVE does not.
ENTRY[(mmmmmmmm)]
Display the starting addresses, the FMIDS, and the PTF (APAR levels) of all the modules in catalog load modules
IGG0CLX0 (resident in the catalog address space) and IGG0CLHA (resident in the link pack area) of the CSECT
with name mmmmmmmm.
ISC(nnnnnn...)
Activate the in-storage catalog for the currently allocated integrated catalog facility named nnnnnn....
LIST(id) or LIST(yyyyyyyy) or LISTJ(jobname)
Display currently active catalog address space service tasks, their related jobnames, their elapsed times, and
unique ids. If you specify a task id [LIST(id)] or TCB address [LIST(yyyyyyyy)], the command lists a single service
task. If you specify LISTJ(jobname), the command lists all service tasks currently active for the specified jobname.
NOISC Deactivate the in-storage catalog option.
NOROTATE Deactivate rotation through the CRT table when assigning a CCX to process a catalog request.
OPEN[(vvvvvv)]
Display the name, volume serial number, current allocation count, and various status flags for every catalog
currently allocated on the system. The volser that can be used to limit the list to allocated catalogs on a specific
volume is specified by vvvvvv.
REPORT[,PERFORMANCE]
Display the performance of key events occurring in the catalog address space.
REPORT[,VLF[(nnnnnn...)]]
Display various catalog address space status fields.
RESTART Terminate the catalog address space with an abend code of 81A and an SVC dump. The system restarts the
catalog address space in a new a address space and honors outstanding requests.
ENTRY[(cname)]
The catalog address space is to display the entry point of the CSECT with the name cname and its maintenance
level.
ROTATE Reactivate rotation through the CRT table when assigning a CCX to process a catalog request.
NOVLF[(nnn...)]
Provide the ability to deactivate catalog data space cache for a currently allocated and integrated catalog facility
catalog.
SYS%ON or SYS%OFF
Activate or deactivate the conversion of SYS% to SYS1.
TASKMAX(nn)
Set the maximum number of catalog address space service tasks that will be attached to process catalog requests.
Once that number is reached, additional catalog requests will be deferred until a catalog address space service
task is available.
UNALLOCATE(nnnnnn...)
Cause the integrated catalog facility named nnnnnn to be unallocated from the catalog address space.
VCLOSE(vvvvv)
Close the VVDS identified by volume serial vvvvv without affecting any existing allocations.
VLF[(nnn...)] Provides the ability to activate catalog data space cache for a currently allocated and integrated catalog facility
catalog.
MVS System Commands Syntax 73
MODIFY Command
F DLF,MODE={DRAIN|D }
{QUIESCE|Q}
{NORMAL|N }
Description:
Change the processing mode for the data lookaside facility (DLF).
DLF,MODE Cause DLF to change its processing to the specified operation. This is the beginning of the shutdown process for
DLF.
DRAIN or D Set drain mode. In drain mode, DLF connects the user to existing DLF objects or disconnects the user from DLF
objects. No new DLF objects are created while in DRAIN mode.
QUIESCE or Q
In quiesce mode, DLF only disconnects the user from DLF objects. No new DLF objects are created while in
QUIESCE mode.
NORMAL or N
In normal mode DLF creates and connects the user to new DLF objects, connects the user to existing DLF objects,
and disconnects the user from DLF objects.
F DLF,NN=xx
Description:
Cause the data lookaside facility (DLF) to use the specified COFDLFxx member of SYS1.PARMLIB.
DLF,NN=xx Causes DLF to use the COFDLFxx member of SYS1.PARMLIB, where xx identifies the COFDLFxx member of
SYS1.PARMLIB.
F DLF[,{STATUS|ST|S}]
|,SM
|,SB
Description:
Display the limits from the COFDLFxx parmlib member currently in effect.
DLF,STATUS
Display the DLF limits set in the COFDLFxx parmlib member that is currently in effect.
SM The status is displayed in megabytes.
SB The status is displayed in 4K blocks.
F LLA,{REFRESH }
{UPDATE=xx}
Description:
Build and replace LLA (library lookaside) directories.
LLA,REFRESH
Cause LLA to build a new copy of the LLA directory.
LLA,UPDATE=xx
Cause LLA to build a specified part of the LLA directory. xx refers to the SYS1.PARMLIB member CSVLLAxx or to
the data set pointed to by the IEFPARM DD statement in the START LLA procedure.
74 OS/390 V2R8.0 MVS System Commands Summary
MODIFY Command
F [MVSNFS.|jobname.]identifier,
{FREEZE={ON|OFF} }
{LIST={MOUNTS|DSNAMES} }
{RELEASE=datasetname[(member)] }
{STATUS }
{STOP }
{UNMOUNT=name }
Description:
Operate with the network file system server.
MVSNFS The generic (IBM-supplied cataloged procedure) name assigned to the network file server.
jobname The name assigned to the network file server.
identifier The identifier, from the START command, assigned to the network file server.
FREEZE=ON
Suspend processing of user mount requests.
FREEZE=OFF
Resume processing of suspended user mount requests.
LIST=MOUNTS
Returns a list of all mount points that are currently active in the network file system server, and their associated
current use counts.
LIST=DSNAMES
Return a list of all data sets and PDS members that are either (1) in use by network file system server users or (2)
opened for accessing but have not been closed due to timeout.
RELEASE=datasetname[(member)]
Force the network file system server to release a data set or PDS member that is currently being used.
STATUS Display the status of the network file system server's active subtasks.
STOP Shut down the network file system server.
UNMOUNT=name
Unmount a currently active mount point.
F [MVSNFS.|jobname.]identifier,LOG={ERROR|WARN|INFO|MEMSTATS}
Description:
Diagnose problems for the network file system server.
MVSNFS The generic (IBM-supplied cataloged procedure) name assigned to the network file server.
jobname The name assigned to the network file server.
identifier The identifier, from the START command, assigned to the network file server.
LOG=ERROR or WARN or INFO
Collect messages issued by the network file system server.
LOG=MEMSTATS
Collect a snapshot of the memory use statistics for performance tuning or debugging.
MVS System Commands Syntax 75
MODIFY Command
F [OAM.|jobname.]identifier,
{{LABEL|L}[,9247 ] }
{ |,3995-133 }
{ |,3995WORM }
{ |,3995REWR }
{ }
{{START|S},{OSMC } }
{ {STORGRP,storgrpname } }
{ {LIBMGT,libraryname } }
{ {DASDSM,storgrpname } }
{ {RECOVERY,volser } }
{ {OBJRECV,collectionname,objectname} }
{ {MOVEVOL,volser } }
{ }
{{STOP|P},{OAM } }
{ {OSMC } }
{ {STORGRP,storgrpname} }
{ {MOVEVOL,volser } }
{ }
{{DISPLAY|D},{GROUP[,storgrpname]} }
{ {VOL,volser } }
Description:
OAM The generic (IBM-supplied cataloged procedure) name assigned to the object access method.
jobname The name assigned to the object access method.
identifier The identifier, from the START command, assigned to the object access method.
LABEL Specify a request to label the two volumes of an optical disk. Each invocation of the command labels one volume
on a stand-alone optical drive.
76 OS/390 V2R8.0 MVS System Commands Summary
MODIFY Command
START Use the MODIFY OAM,START command to start:
OSMC storage management cycle
OSMC storage management cycle for a particular storage group
OSMC library management cycle for a particular library
OSMC DASD space management cycle for a particular storage group
OSMC optical disk recovery utility
OSMC single object recovery utility
OSMC Start an OAM storage management component cycle
STORGRP,storgrpname
Start an OSMC storage management cycle for the specified storage group.
LIBMGT,libraryname
Start an OSMC library management cycle on the named library.
DASDSM,storgrpname
Start an OSMC DASD space management cycle for the specified storage group.
RECOVERY,volser
Start an OSMC optical disk recovery utility for the optical volume specified and its opposite side.
OBJRECV,objectname
Start an OSMC single object recovery utility for the named object.
STOP Use the MODIFY OAM,STOP command to stop OAM, OSMC, and OSMC processing for a particular storage
group.
OAM Stop OAM and OSMC if it is running. OAM will continue to process DISPLAY commands.
OSMC Complete all work currently in progress before stopping. OSMC will continue to process DISPLAY
commands.
STORGRP,storgrpname
Complete all work currently in progress for this storage group before stopping.
DISPLAY Use the OAM DISPLAY command to display the status of an object, an object backup storage group, or an optical
disk volume.
GROUP,storgrpname
Display the status of an OBJECT or OBJECT BACKUP storage group. If storgrpname is specified, it
displays the status of the requested storage group. If storgrpname is omitted, it displays the status
of all OBJECT and OBJECT BACKUP storage groups.
VOL,volser Display the status of the requested optical volume and the optical volume on the other side of the
optical disk.
MVS System Commands Syntax 77
MODIFY Command
F WLM,[MODE={GOAL|COMPAT}]
,[RESOURCE=resourcename,{ON|OFF|RESET}]
Description:
Switch workload management modes and change resource settings.
WLM,MODE=
GOAL Switch from workload management compatibility mode to workload management goal mode.
COMPAT Switch from workload management goal mode to workload management compatibility mode.
WLM,RESOURCE=
resourcename,ON
Change the resource setting to ON.
resourcename,OFF
Change the resource setting to OFF.
resourcename,RESET
Change the resource setting to RESET.
78 OS/390 V2R8.0 MVS System Commands Summary
MODIFY Command
F [XWTR.|jobname.]identifier,
{{CLASS|C}=[classes] }
{ }
{{DEST|D}=[LOCAL ]}
{ |remote-workstation-name }
{ }
{{FORMS|F}=[forms-name] }
{ }
{{JOBID|J}=[JOBnnnn ] }
{ |STCnnnn }
{ |TSUnnnn }
{ }
{{WRITER|W}=[STDWTR ] }
{ |user-writer-name }
Description:
Specify the criteria that an external writer is to use in selecting data sets for processing.
XWTR The generic (IBM-supplied cataloged procedure) name of the external writer.
jobname The name assigned to the external writer.
identifier The identifier, from the START command, assigned to the external writer.
The following types of identifiers can be used:
The identifier that was specified on the START command.
[/]devnum, the device number specified on the START or MOUNT command.
devicetype, the type of device specified on the START or MOUNT command.
CLASS= or C=[classes]
Select only data sets enqueued in the specific classes. You can specify up to 8 classes NOT separated by
commas.
JOBID= or J={JOBnnnn, STCnnnn, or TSUnnnn}
Select only data sets from the job with this subsystem-assigned JOBID.
WRITER= or W=
Select only data sets that are to be processed by the standard writer (STDWTR) or to a specified user writer
(user-writer-name).
FORMS= or F=[forms-name]
Select only data sets that specify this forms name.
DEST= or D=
Select only data sets destined for the central processor complex (LOCAL) or for the specified remote workstation.
MVS System Commands Syntax 79
MODIFY Command
F [XWTR.|jobname.]identifier,{PAUSE|P}={FORMS }
{DATASET}
Description:
Cause an external writer to pause.
XWTR The generic (IBM-supplied cataloged procedure) name of the external writer.
jobname The name assigned to the external writer.
identifier The identifier, from the START command, assigned to the external writer.
The following types of identifiers can be used:
The identifier that was specified on the START command.
[/]devnum, the device number specified on the START or MOUNT command.
devicetype, the type of device specified on the START or MOUNT command.
PAUSE= or P=FORMS
For unit record devices, the writer is to pause when a change of forms is necessary.
PAUSE= or P=DATASET
For unit record devices, the writer is to pause before starting to process each data set.
80 OS/390 V2R8.0 MVS System Commands Summary
MONITOR Command
MONITOR Command (MN)
MONITOR or MN
MN {JOBNAMES[,T][,L={a|cc|cca|name|name-a}] }
{DSNAME }
{SPACE }
{STATUS[,L={a|cc|cca|name|name-a}] }
{SESS[,T][,L={a|cc|cca|name|name-a}] }
Description:
Continually display jobnames, data set status, and time-sharing user sessions or add certain information to mount and demount
messages.
JOBNAMES Display the name of each job when the job starts and terminates and the unit record allocation when the step
starts. If a job terminates abnormally, the job name appears in a diagnostic message.
DSNAME Display, in mount messages, the name of the first nontemporary data set allocated on the volume to which the
messages refer. No data set name appears in messages for data sets with a disposition of DELETE.
SPACE Display, in demount messages, the available space on the direct access volume.
STATUS Display the data set names and volume serial numbers of data sets with dispositions of KEEP, CATLG, or
UNCATLG whenever they are freed.
SESS Display the user identifier for each TSO terminal when the session is terminated or initiated. If the session
terminates abnormally, the user identifier appears in the diagnostic message.
T Display the time along with the user identifier or job name information.
L=a, cc, cca, name, or, name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) where the display will
appear.
MVS System Commands Syntax 81
MOUNT Command
MOUNT Command (M)
MOUNT or M
M {[/]devnum },VOL=({NL},serial)[,USE={STORAGE}]
{devicetype } {SL} {PUBLIC }
{AL} {PRIVATE}
Description:
Allow allocation of an I/O device to all job steps that require a particular volume.
[/]devnum The device number of the I/O device to be mounted.
devicetype The device type of the I/O device to be mounted.
VOL=(NL,serial)
The specified volume does not have a standard label. The serial number is used for allocation references.
VOL=(SL,serial)
The specified volume has a standard label. The serial number is used for label verification and allocation
references.
VOL=(AL,serial)
The volume has an American National Standard label. The serial number is used for label verification and allocation
references.
USE={STORAGE, PUBLIC, or PRIVATE}
The USE attribute to be assigned to the specified volume.
82 OS/390 V2R8.0 MVS System Commands Summary
MSGRT Command
MSGRT Command (MR)
MSGRT or MR
MR {[D=(operand[,operand]...)][,L={a }] }
{ |TR=A {cc } }
{ |K {cca } }
{ |CF {name } }
{ |MN {name-a} }
{ }
{REF }
{ }
{NONE }
{ }
{CONTn }
Description:
Establish or change message routing instructions.
D=operand Route DISPLAY command output to the specified MCS console. Any display operand that produces a status
display is valid.
TR=A Route the TRACK A command display and the action of the STOPTR command to the specified MCS console.
K Subsequent CONTROL command action will affect the specified MCS console until the option is discontinued or
you IPL the system.
CF Route the reply to the CONFIG command to the specified MCS console.
L=a, cc, cca, name, or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) of the active MCS console
where the specified display will appear.
NONE Discontinue all current message routing instructions.
REF Display the current message routing instructions.
CONTn Continue the display response to a previous MR REF command with the nth line.
MN Route the displays produced by the MONITOR command and the action of the STOPMN command to the specified
MCS console.
Notes:
1. To stop message routing, issue the same command without the L= operand.
2. You can enter multiple command routings by enclosing the operands in parentheses and separating them with commas.
MVS System Commands Syntax 83
PAGEADD Command
PAGEADD Command (PA)
PAGEADD or PA
PA {[PAGE=]}{dsname[,dsname]...}
{SWAP= }
{NONVIO=}
Description:
Add auxiliary storage space to the system.
[PAGE=]dsname[,dsname] ...
The name of one or more page data sets to be added.
SWAP=dsname[,dsname] ...
The name of one or more swap data sets to be added.
NONVIO=dsname[,dsname] ...
The name of one or more page data sets to be added. The system is not to use these added page data sets to
receive VIO pages.
84 OS/390 V2R8.0 MVS System Commands Summary
PAGEDEL Command
PAGEDEL Command (PD)
PAGEDEL or PD
PD {DELETE,{PAGE|SWAP}={dsname[,dsname]...} }
{ }
{REPLACE,{PAGE|SWAP}={(dsname,rdsname)[,(dsname,rdsname)]...}}
{ }
{DRAIN,{PAGE|SWAP}={dsname[,dsname]...} }
Description:
Remove auxiliary storage space from the system by deleting, replacing, or draining (quiescing) local page data sets or swap data
sets.
WARNING:
Use this command only at the direction of the system programmer; if misused, it can cause an auxiliary storage shortage.
DELETE Remove one or more local page data sets or swap data sets from system use.
REPLACE Replace a local page data set or swap data set with a newly-opened data set of equal or greater size.
DRAIN Make one or more local page data sets or swap data sets read-only. (The system quiesces the data
setsdisallows any writing to them.) You can put these data sets back into use in read/write mode by issuing a
PAGEADD command.
PAGE=dsname[,dsname] ...
The name of one or more local page data sets.
SWAP=dsname[,dsname] ...
The name of one or more swap data sets.
(dsname,rdsname)[(dsname,rdsname)] ...
The name of one or more data sets to be replaced by the new data set names(s).
MVS System Commands Syntax 85
QUIESCE Command
QUIESCE Command
QUIESCE
QUIESCE
Description:
Put the system in a manual state without affecting job step timing. Terminate all jobs normally, if possible. Otherwise, suspend
current activity and enter a manual state or a wait state with a code of hex 0000CCC.
86 OS/390 V2R8.0 MVS System Commands Summary
REPLY Command
REPLY Command (R)
REPLY or R
R ,'[DATE=yyyy.ddd][,CLOCK=hh.mm.ss][,GMT]'
Description:
Set the time of day clock. If you specify GMT, the system assumes Greenwich Mean Time. Otherwise, it assumes local time.
R id[,ASID=(nnnn[,nnnn]...)]
[,JOBNAME=(name[,name]...)]
[,OPTIONS=(name[,name]...)]
[,WTR={membername|DISCONNECT}]
[,CONT|,END ]
NOTE: CONT or END, when specified, must be the last parameter on the input line.
Note: Specify the component trace operands by using the form of the REPLY command below in response to message ITT006A.
id The identification specified in the prompting message.
ASID A list of ASIDs, in hex, to be used as a filter for tracing.
JOBNAME A list of jobs to be used as a filter for tracing.
OPTIONS Selective and specific options for the component trace start/stop routine.
WTR=membername
The name of the member that contains the source JCL that the system uses to connect to a component trace
writer. The member can be a SYS1.PROCLIB cataloged procedure or a job.
WTR=DISCONNECT
The system is to disconnect the trace from the external writer.
CONT Continue the reply on another line.
END Specify the end of your reply.
[R] id[,]['text'|text]
id The identification number as specified in the message requesting a response.
text Response to the message. (Apostrophes are optional.)
R id,U
or
R id[,ASID=(n[,n]...)][,JOBNAME=(name[,name]...)][,TSONAME=(name[,name]...)]
[,DSPNAME=(dspname-entry[,dspname-entry]...)]
[,{PROBDESC|PROB|PD}=key-spec][,REMOTE=(request[,request]...)]
[,SDATA[=(option[,option]...)][,STOR=(beg,end[,beg,end]...)]
[,STRLIST=(s-option[,s-option]...)]
[,CONT|,END]
Notes:
1. CONT or END, when specified, must be the last parameter on the input line.
2. The CONT keyword does not work within a SYSP= list.
3. U, when specified, must be the first parameter following the identification number.
MVS System Commands Syntax 87
REPLY Command
Where request represents:
{GRPLIST={group(member) } }
{ {(group(member[,member]...)[,group(member[,member]...)]...) } }
{ }
{SYSLIST={sysinfo|(sysinfo[,sysinfo]...)} }
{ [,DSPNAME|,DSPNAME=(dspname-entry[,dspname-entry]...) ] }
{ [,SDATA|,SDATA=(option[,option]...) ] }
{ [,STOR|,STOR=(beg,end[,beg,end]...) ] }
Where s-option represents:
STRNAME=strname
[,CONNAME=conname ]
[ ]
[,ACCESSTIME={ENFORCE|NOLIMIT|NOLIM} ]
[ ]
[,LOCKENTRIES ]
[ ]
[,USERCNTLS ]
[ ]
[,EVENTQS ]
[ ]
[,(EMCONTROLS={ALL|(list))} ]
[ ]
[,({COCLASS|STGCLASS|LISTNUM}={ALL|(list)} ]
[ {[,ADJUNCT={CAPTURE|DIRECTIO}][,ENTRYDATA={UNSERIALIZE|SERIALIZE}]} ]
[ {[,SUMMARY] }) ]
Description:
Specify dump options in response to message IEE094D.
id The identification number specified in message IEE094D.
U Dump the master scheduler address space and include the storage areas defined by the SDATA options.
ASID=(n[,n] ...)
Specify the address space(s) that you want to dump.
JOBNAME=(name[,name]...)
Specify the jobname(s) whose address space you want to dump.
TSONAME=(name[,name]...)
Specify the name of any address space you want to dump, including the user identifier(s) of a TSO user.
DSPNAME=(dspname-entry[,dspname-entry]...)
Specify the data space to be dumped. The data space can be specified using the explicit hexadecimal address
space identifier or the jobname associated with the data space you want to dump.
PROBDESC=key-spec
Provides information describing the problem to an IEASDUMP.QUERY routine.
REMOTE=(request[,request] ...)
Specify dumps on other systems in a sysplex.
SDATA=(option[,option] ...)
Specify the specific storage areas you want to dump.
STOR=(beg,end[,beg,end] ...)
Specify the range of virtual storage you want to dump. You can specify the addresses with 4-byte hexadecimal
numbers or 7-digit decimals followed by a K.
STRLIST=(s-option[,s-option]...)
Specify, by name, the coupling facility structures you want to dump.
CONT Continue the reply on another line.
END Specify the end of your reply.
88 OS/390 V2R8.0 MVS System Commands Summary
REPLY Command
R id,{U }
{options}
Description: Respond to message IEE357A by specifying that you do not want to change the SMF values (U) or by specifying
the options separated by commas as provided by your system programmer.
R [|][,]['text'|text]
Description: During recovery processing, use these forms of the REPLY command to respond to system requests.
R [|],{U }
{ }
{{'parm=,' }[,CONT] }
{{'parm=,parm,' } }
{{'parm=value' } }
{{'parm=(value[,value]...[,L])' } }
{{'parm=(value[,value]...[,L]),parm=value'}}
Description: Specify system parameters in response to message IEA101A.
00 The identification number specified in the message requesting information.
U Do not change any parameters. The system uses the default list of system parameters in SYS1.PARMLIB.
parm=, or parm=,parm
Cancel the parameter(s), as specified in SYS1.PARMLIB, for this IPL. Any existing system defaults for these
parameters are used.
parm=value or parm=(value[,value]...[,L]) or parm=(value,value),parm=value
Override the corresponding parameters with the specified parameters. A blank or comma must separate multiple
parameters, and U is not a valid value. If the reply is longer than one line, follow the last parameter with a comma
or a blank and CONT. You will then be prompted for the remaining values.
L List the parameters as they are processed.
MVS System Commands Syntax 89
RESET Command
RESET Command (E)
RESET or E
E [CN(consname)]
Description:
Force a hung MCS console offline.
CN=(consid) Specify the hung MCS console the system is to force offline.
E jobname[,A=asid],{PERFORM=nnn }
{SRVCLASS=classname}
{QUIESCE|Q }
{RESUME }
Description:
Change the performance group or service class of an executing job, time-sharing user, or started task. In goal mode only,
quiesce a problem job or address space and resume a quiesced job or address space. Use this command only at the direction of
the system programmer.
jobname The name of the job whose performance group or service class is to be changed.
A=asid The hexadecimal address space identifier (ASID) of the job, time-sharing user, or started task you want to change.
PERFORM=nnn
Change the performance group (value=nnn) of a job currently in execution. Applies only in workload management
compatibility mode.
SRVCLASS=classname
The name of the service class to be assigned to the address space or job. Applies only in workload management
goal mode.
QUIESCE|Q A request to quiesce the target address space or job. Applies only in workload management goal mode.
RESUME A request to reclassify a work request. Applies only in workload management goal mode.
90 OS/390 V2R8.0 MVS System Commands Summary
ROUTE Command
ROUTE Command (RO)
ROUTE or RO
RO {sysname,text }
{ }
{[T=nnn,]{ALL }[,L={a }] }
{ {sysgrpname } {cc } }
{ {OTHER } {cca } }
{ {(sysname[,sysgrpname,sysname...])} {name } }
{ {name-a} }
Description:
Send messages to different systems in a sysplex and monitor the activity of the entire sysplex.
T Specify an optional timeout.
sysname The system name that will receive and process the command.
text The command being routed.
*ALL The command will be routed to all systems in the sysplex.
sysgrpname The command will be routed to a subset of systems in the sysplex.
L=a, cc, cca, name, or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) of the active MCS console
where the specified display will appear.
MVS System Commands Syntax 91
SEND Command
SEND Command (SE)
SEND or SE
SE msgno,DELETE
Description:
Delete the specified message from the broadcast data set.
SE [msgno,]LIST
Description:
List the requested message or all messages (if that operand is omitted) in the notices section of the broadcast data set.
SE {'message'},{BRDCST }
{msgno } {OPERATOR=routecode}
{CN=console }
Description:
Send messages to other operators at MCS consoles.
message or msgno
The message or number of a message in SYS1.BRODCAST to be sent.
BRDCST Send the message to all active consoles that have not specified the 'no broadcast option'.
OPERATOR=routecode
The installation area to receive the message (range of 0-15).
CN=console The console where the message is to be sent (range 0-99).
SE {'message'},{NOW|LOGON},{WAIT|NOWAIT},{ROUTE={ALL|systemname|groupname}}
{msgno }
Description:
Send a message to all terminal users currently logged on the system.
message or msgno
The message or number of a message in SYS1.BRODCAST to be sent.
NOW Specify that the message be sent immediately only to all currently logged-on users.
LOGON Logged-on users who are accepting messages will receive the message. For users not accepting messages, the
message will be stored in the mail section of the broadcast data set until the user requests it.
WAIT Specify that the message be held until system output buffers are available for the logged-on users.
NOWAIT Specify that the message NOT be held. When LOGON is specified the message is saved for any users whose
terminal are busy or who were not logged on.
ROUTE Send the message to all users logged onto the specified system(s).
*ALL
Send the message to all users logged onto all systems participating in the sysplex.
systemname
Send the message only to users logged onto systemname.
groupname
Send the message to all users logged onto the sysplex subset defined by groupname.
92 OS/390 V2R8.0 MVS System Commands Summary
SEND Command
SE {'message'},USER=(userid[,userid]...),{NOW|LOGON},{WAIT|NOWAIT}
{msgno }
Description:
Communicate with specific time-sharing users.
message or msgno
The message or number of a message in SYS1.BRODCAST to be sent.
USER=(userid[,userid] ...)
Send the message to these users.
NOW Specify that the message be sent immediately. If the recipient of the message is not logged on, the system deletes
the message and notifies you.
LOGON Logged on users who are accepting messages will receive the message. If they are not accepting messages or
are not logged on, the system stores the message in the mail section of the broadcast data set until the user
requests it.
WAIT Specify that the message be held until system output buffers are available for the specified logged-on users.
NOWAIT Specify that the message not be held. When USER is specified you are notified of any users who do not receive
the message.
SE {'message'},{USER=(userid[,userid]...)},SAVE
{ msgno } {ALL }
Description:
Store messages in the broadcast data set.
message or msgno
The message or message number to be sent.
USER=(userid[,userid] ...)
The identifications of those users to receive the message. The message will be stored in the mail sections of these
users.
ALL All terminal users will receive the message. It is placed in the notices section and given a number. This number is
printed when the message is stored and can be used as msgno in future SEND commands.
SAVE The system stores the message in the appropriate section of the broadcast data set until a user logs on or requests
messages. If ALL is specified the system places the message in the notices section until deleted explicitly.
MVS System Commands Syntax 93
SET Command
SET Command (T)
SET or T
T [[DATE=yyyy.ddd][,CLOCK=hh.mm.ss]][RESET]
[,IPS=xx][,OPT=xx][,ICS=xx][,SMF=xx][,DAE=xx]
[,MPF={(xx[,xx]...)|NO}]
[,SLIP=xx][,PFK=xx][,IOS=xx] [,EXS=xx][,SMS=xx][,MMS={xx|NO}][,PROG=xx]
[,DIAG=xx][,GRSRNL=(xx[,xx]...)]
[,APPC=(xx[,xx]...,L)][,ASCH=(xx[,xx]...,L)] [,SCH=(xx[,xx]...,L)]
[,CNGRP={(xx,[xx]...)}|NO ][,PROD=(xx[,xx]..)]
[,OMVS=(xx[,yy...,nn])
[,RTLS=(xx[,xx...])
Description:
Set the time and date.
DATE=yyyy.ddd
Set the year (1900-2042) and the day (001-366).
CLOCK=hh.mm.ss
Set the local time.
RESET Set the local date and time to the values that are in the CLOCKxx member of SYS1.PARMLIB.
The following parameters determine which members of SYS1.PARMLIB to use. Use these commands only on direction of the
system programmer.
IPS=xx The IEAIPSxx member of SYS1.PARMLIB that contains the new parameters SRM is to use. Not valid on systems
operating in workload management goal mode.
OPT=xx The IEAOPTxx member of SYS1.PARMLIB that contains the new parameters SRM is to use.
ICS=xx The IEAICSxx member of SYS1.PARMLIB that contains the new installation control specifications SRM is to use.
Not valid on systems operating in workload management goal mode.
SMF=xx The SMFPRMxx member of SYS1.PARMLIB that contains the parameters MVS is to use when it restarts SMF.
DAE=xx The ADYSETxx member of SYS1.PARMLIB that contains the new parameters that dump analysis and elimination
(DAE) is to use.
MPF={xx[,xx,...]} or MPF=NO
The MPFLSTxx member or members of SYS1.PARMLIB that contain the message suppression and presentation
specifications or NO to end MPF processing.
PROG=xx The PROGxx parmlib member that contains definitions to control (1) the format and contents of the list of
APF-authorized libraries. (2) the use of exits and exit routines, and (3) the addition of modules to and removal of
modules from the LPA after IPL.
DIAG=xx The DIAGxx member of SYS1.PARMLIB containing definitions that control:
Common service area (CSA), expanded CSA (ECSA), system queue area (SQA), and expanded SQA (ESQA)
tracking
GETMAIN/FREEMAIN/STORAGE (GFS) trace
94 OS/390 V2R8.0 MVS System Commands Summary
SET Command
SLIP=xx Indicate the IEASLPxx member of SYS1.PARMLIB that contains the commands SLIP processing is to use.
PFK=xx Indicate the PFKTABxx member of SYS1.PARMLIB that contains the PFK tables that are to be available to a
console.
SMS=xx Indicate the IGDSMSxx member of SYS1.PARMLIB that contains the parameters the system is to use when it
starts SMS.
IOS=xx Indicate the IECIOxx member of SYS1.PARMLIB that contains the parameters the system is to use to control MIH
and I/O timing.
APPC= The APPCMxx member of SYS1.PARMLIB that contains the desired APPC configuration.
ASCH= The ASCHPMxx member of SYS1.PARMLIB that contains the desired APPC configuration.
SCH= The SCHEDxx member of SYS1.PARMLIB that contains the desired PPT configuration.
CNGRP= The CNGRPxx member of SYS1.PARMLIB to be activated.
CNGRP=NO The system is to remove all active console group definitions from the sysplex.
EXS=xx Indicate the EXSPATxx member of SYS1.PARMLIB that contains the excessive spin recovery actions and loop
timeout interval.
MMS=xx Start the message translation service when MVS message service is not active. When active, the Set MMS=xx
changes the MMSLSTxx member.
MMS=NO End MMS processing and frees all allocated resources.
GRSRNL=(xx[,xx]...)
The two alphanumeric characters indicating the GRSRNLxx member(s) of SYS1.PARMLIB that contain the
specified GRS resource names list (GRSRNL) configuration.
RTLS=(xx[,xx...])
The two alphanumeric characters indicating the CSVRTLxx members of the logical parmlib that contain the desired
run-time library services specification.
MVS System Commands Syntax 95
SETDMN Command
SETDMN Command (SD)
SETDMN or SD
SD domainnum,{MIN=n1[,MAX=n2][,ASRV=(n,n9) ] }
{ |,DSRV=(n,n9) }
{ |,FIXCIDX=nnn }
{ }
{{ASRV=(n,n9)}[,MIN=n1][,MAX=n2] }
{{DSRV=(n,n9)} }
{{FIXCIDX=nnn } }
{ }
{MAX=n2[,ASRV=(n,n9) ][,MIN=n1] }
{ |,DSRV=(n,n9) }
{ |,FIXCIDX=nnn }
Description:
Change existing values of parameters in a single domain. Issue this command only on direction of the programmer. Not valid on
systems operating in workload management goal mode.
domainnum The domain table entry (1-128) to be modified.
MIN=n1 The minimum multiprogramming level (0-999).
MAX=n2 The maximum multiprogramming level (0-999).
ASRV=(n0,n9)
Average service per ready address space in the domain. The value range is 0-999999999.
DSRV=(n0,n9)
Total service rate for each domain. The value range is 0-999999999.
FIXCIDX=n Fixed contention index value for each domain. The value range is 0-655.
96 OS/390 V2R8.0 MVS System Commands Summary
SETETR Command
SETETR Command
SETETR
SETETR PORT=n
Description:
Enables external time reference (ETR) ports that have been disabled.
PORT = n The number of the ETR port to enable.
MVS System Commands Syntax 97
SETGRS Command
SETGRS Command
SETGRS
SETGRS {MODE=STAR }
{[RESMIL=nnnnn][,TOLINT=nnnnn][,SYNCHRES={YES|NO}]}
|RESMIL=OFF
Description:
Migrate currently active global resource serialization ring to a global resource serialization star or modify current RESMIL or
TOLINT values.
MODE = STAR
Indicate that the global resource serialization ring complex is to be converted to a star complex.
RESMIL=nnnnn
Specify, in milliseconds, the minimum RSA-message residency time. Use RESMIL=OFF to specify that global
resource serialization is not to tune the residency time.
TOLINT=nnnnn
Specify, in seconds, the maximum toleration time interval global resource serialization allows the RSA-message to
return to this system before it considers the RSA-message overdue.
SYNCHRES=YES|NO
Specify whether or not to activate synchronous reserve processing.
98 OS/390 V2R8.0 MVS System Commands Summary
SETIOS Command
SETIOS Command
SETIOS
SETIOS MIH[,class=mm:ss[,class=mm:ss]...]
[,MOUNTMSG={YES|NO}]
[,DEV={([/]devnum[,[/]devnum]...) },TIME=mm:ss,IOTIMING=mm:ss]
{([/]lowdevnum-[/]highdevnum) }
[,MSGONLY={YES|NO}]
Description:
Dynamically add, delete, modify, or replace any previously-specified MIH or I/O timing parameter.
class=mm:ss
Specify the MIH or I/O timing time interval for one or more classes.
MOUNTMSG={YES or NO}
Indicate whether or not the system is to display the mount pending messages (YES or NO).
DEV=([/]devnum[,[/]devnum]) or DEV=([/]devnum1-[/]devnum2)
Specify one or more device numbers or the device numbers of the lower and upper bounds of a range of devices.
TIME=mm:ss
Specify the time interval. If you specify TIME you must also specify DEV.
IOTIMING=mm:ss
Specify the I/O timing limit. If you specify IOTIMING you must also specify DEV.
MSGONLY={YES or NO}
Indicate whether to process an I/O timeout condition using message-only recovery (YES) or full I/O timing recovery
(NO).
MVS System Commands Syntax 99
SETLOAD Command
SETLOAD Command
SETLOAD
SETLOAD xx,PARMLIB[,{DSNAME|DSN}=dsn]
[,{VOLUME|VOL|VOLSER}=vol]
Description:
Dynamically switch from one parmlib concatenation (logical parmlib) to another without having to initiate an IPL.
xx Specify the one- or two-character suffix that identifies the LOADxx member to process.
PARMLIB Direct the system to process the PARMLIB statements in the LOADxx member according to the filter parameters
(HWNAME, LPARNAME, VMUSERID).
DSNAME or DSN =dsn
Specify the one- to forty-four-character name of the data set where the LOADxx member resides.
VOLUME or VOL or VOLSER =VOL
Specify the one- to six-character serial number identifier of the volume where the specified data set resides.
100 OS/390 V2R8.0 MVS System Commands Summary
SETLOGRC Command
SETLOGRC Command
SETLOGRC
SETLOGRC {LOGSTREAM|DATASET|IGNORE}
Description:
Dynamically change the logrec recording medium.
LOGSTREAM
The desired medium for recording logrec error and environmental records is a log stream.
DATASET The desired medium for recording logrec error and environmental records is a data set. Setting the medium to data
is only valid if the system had originally been initiated with a data set as the logrec recording medium.
IGNORE Disable the recording of logrec error and environmental records.
MVS System Commands Syntax 101
SETOMVS Command
SETOMVS Command
SETOMVS
SETOMVS [FORKCOPY=(COPY|COW)]
[,IPCSEMNIDS=ipcsemnids]
[,IPCSEMNOPS=ipcsemnops]
[,IPCSEMNSEMS=ipcsemnsems]
[,IPCMSGQBYTES=ipcmsgqbytes]
[,IPCMSGNIDS=ipcmsgnids]
[,IPCSHMMPAGES=ipcshmmpages]
[,IPCSHMNIDS=ipcshmnids]
[,IPCSHMNSEGS=ipcshmnsegs]
[,IPCSHMSPAGES=ipcshmspages]
[,IPCMSGQMNUM=ipcmsgqmnum]
[,MAXASSIZE=maxassize]
[,MAXCORESIZE=maxcoresize]
[,MAXCPUTIME=maxcputime]
[,MAXFILEPROC=maxfileproc]
[,MAXFILESIZE=(maxfilesize|NOLIMIT)]
[,MAXMMAPAREA=maxmmaparea]
[,MAXPROCSYS=maxprocsys]
[,MAXPROCUSER=maxprocuser]
[,MAXPTYS=maxptys]
[,MAXRTYS=maxrtys]
[,MAXSHAREPAGES=maxsharepages]
[,MAXTHREADS=maxthreads]
[,MAXTHREADTASKS=maxthreadtasks]
[,MAXUIDS=maxuids]
[,PRIORITYGOAL=(n) | NONE]
[,PRIORITYPG=(n) | NONE]
| [RESET=(xx)]
[,STEPLIBLIST='stepliblist']
[,SUPERUSER=superuser]
| [,SYSCALL_COUNTS=(YES|NO)]
[,TTYGROUP=ttygroup]
[,USERIDALIASTABLE='useridaliastable']
Description:
Dynamically change the options that OS/390 UNIX System Services uses. These options are originally set in the
BPXPRMxx member of SYS1.PARMLIB at the time of initially loading (IPL'ing) the system.
102 OS/390 V2R8.0 MVS System Commands Summary
SETPROG Command
SETPROG Command
SETPROG APF
SETPROG APF{,FORMAT={DYNAMIC|STATIC} }
{ }
{,{ADD|DELETE},DSNAME|LIBRARY=libname,{SMS|VOLUME=volume} }
Description
Update the authorized program facility (APF) list.
FORMAT=[DYNAMIC or STATIC]
Indicate that the format of the APF list is to change from static to dynamic, or vice versa.
ADD Add the library specified on the DSNAME parameter to the APF list.
DELETE Delete the library specified on the DSNAME parameter from the APF list.
DSNAME=libname
The 1-44 character name of the library that you want to add or delete.
VOLUME=volume
The volume identifier for the volume containing the library specified on the DSNAME parameter, which is either the
volume serial number, six asterisks (******) to indicate that the library resides on the current SYSRES volume, or
*MCAT* to indicate that the library resides on the volume that contains the master catalog.
SMS Indicate that the library specified on the DSNAME parameter is managed by the storage management subsystem
(SMS), and therefore no volume is associated with the library.
MVS System Commands Syntax 103
SETPROG Command
SETPROG EXIT
SETPROG EXIT,{ADD,EXITNAME=exitname,MODNAME=modname }
{ [,STATE={ACTIVE|INACTIVE}] }
{ [,DSNAME=dsname] }
{ [,JOBNAME={jobname|}] }
{ [,ABENDNUM=(n[,CONSEC])] }
{ [,FIRST|LAST] }
{ }
{ATTRIB,EXITNAME=exitname,KEEPRC=(compare,kk)}
{ }
{DELETE,EXITNAME=exitname,MODNAME=modname }
{ [,FORCE={YES|NO}] }
{ }
{MODIFY,EXITNAME=exitname,MODNAME=modname }
{ [,STATE={ACTIVE|INACTIVE}] }
{ [,JOBNAME={jobname|}] }
{ }
{UNDEFINE,EXITNAME=exitname }
Description
Update dynamic exits.
ADD Add an exit routine to an exit.
MODIFY Change the state of an exit routine.
DELETE Delete an exit routine from an exit.
UNDEFINE Undefine an implicitly defined exit.
ATTRIB Change the attributes of an exit.
EXITNAME= or EX= or EN=exitname
The 1-16 character name of the exit.
MODNAME= or MOD=modname
The 1-8 character name of the exit routine. If DSNAME is not specified, the system looks for the exit routine first in
the LPA, and then in the LNKLST concatenation.
DSNAME= or DSN= or LIBNAME= or LIB=dsname
The 1-44 character data set name of a load library in which the named exit routine resides. The data set must be
cataloged, but does not need to be APF-authorized.
JOBNAME={jobname or *}
The 1-8 character name of the particular job for which this exit routine is to be given control.
The default for the ADD parameter is *, which indicates that the exit routine is to be given control when any job is
in control. The default for the MODIFY parameter is to leave the jobname unchanged.
STATE Indicate the state of the exit routine. ACTIVE indicates that the exit routine is to be given control when the exit is
called. INACTIVE indicates that the exit routine is not to be given control when the exit is called. The default for
the ADD parameter is ACTIVE. The default for the MODIFY parameter is to leave the state unchanged.
104 OS/390 V2R8.0 MVS System Commands Summary
SETPROG Command
ABENDNUM=n[,CONSEC]
Indicate the abend characteristics for the exit routine, which are used to override the characteristics assigned by
default when the exit was defined. ABENDNUM=n indicates that the exit routine is not to be given control after the
n-th abend. CONSEC indicates that there must be n consecutive abends before the system stops giving control to
the exit routine. CONSEC is not supported if this exit has FASTPATH processing in effect, and either a PSW key 8
to 15 or ANYKEY processing in effect.
The default is to use the ABENDNUM characteristics that were specified or defaulted when the exit was defined.
The ABENDNUM value may not exceed 8 decimal digits.
FIRST Specify that the system is to call the exit routine before all other exit routines associated with this exit, unless
another exit routine, added after it, also specifies FIRST.
If neither the FIRST parameter nor the LAST parameter is specified, the system may call the exit routine in any
order relative to other routines associated with this exit.
LAST Specify that the system is to call the exit routine after all other exit routines associated with this exit, unless other
exit routines are added after it.
If neither the FIRST parameter nor the LAST parameter is specified, the system may call the exit routine in any
order relative to other routines associated with this exit.
FORCE=YES or NO
Indicate that the system is to delete the exit routine. The exit routine will no longer be given control. Specify
FORCE=YES for an exit with FASTPATH processing in effect, and either a PSW key 8 to 15 or ANYKEY
processing in effect.
KEEPRC=(compare,kk)
Specify a comparison and a return code which, if true, causes the information produced by this exit routine to be
returned to the exit caller. The valid choices for compare are EQ, NE, GT, LT, GE, and LE.
The default is to not perform KEEPRC processing. kk may not exceed 8 decimal digits.
If return codes from more than one exit routine match the conditions specified, the system returns information from
the exit routine that finishes first.
MVS System Commands Syntax 105
SETPROG Command
SETPROG LNKLST
SETPROG LNKLST,{DEFINE,NAME=lnklstname[,COPYFROM=lnklstname][,NOCHECK] }
{ADD,NAME=lnklstname, }
DSNAME=dsname[,VOLUME=volser][,ATBOTTOM ] }
[,ATTOP ] }
[,AFTER=dsname] }
[,CHECKCONCAT={YES|NO}] }
{DELETE,NAME=lnklstname,DSNAME=dsname }
{UNDEFINE,NAME=lnklstname }
{TEST,NAME=lnklstname,MODNAME=name }
{ACTIVATE,NAME=lnklstname }
{UPDATE,{JOB=jobname} }
{ASID=asid } }
{UNALLOCATE }
{ALLOCATE }
Description:
Update linklist concatenations by:
Defining a LNKLST set of data sets for the LNKLST concatenation.
Adding data sets to or delete data sets from the LNKLST set.
Removing the definition of a LNKLST set from the system.
Testing for the location of a specific module in the LNKLST concatenation.
Activating a LNKLST set as the LNKLST concatenation for the system.
Updating an address space for jobs to use a LNKLST set.
106 OS/390 V2R8.0 MVS System Commands Summary
SETPROG Command
SETPROG LPA
SETPROG LPA,{ADD,[MODNAME=(modname...,modname) | MASK=mask}
{ ,DSNAME=[dsname | LNKLST] }
{ [,FIXED] [,PAGEPROTPAGE] }
{ }
{DELETE,MODNAME=(modname...,modname) }
{ FORCE=YES [CURRENT | OLDEST] }
{ }
{CSAMIN=(below,above) }
Description:
Specify, any time after IPL:
Modules to add to the LPA.
Modules to delete from the LPA.
Threshold values for minimum amounts of CSA storage that must still be available after an ADD operation.
LPA Statement type indicating that an action may be performed on the LPA.
ADD Specify that one or more modules be added to the LPA.
Default Value: None
DELETE Directs that one or more modules be deleted from the LPA. Only modules added to LPA after an IPL are eligible
for dynamic deletion.
Default Value: None
CSAMIN The minimum amount of CSA and ECSA that must remain after a module is added to the LPA. If the requested
ADD operation would reduce the CSA or ECSA below the defined minimum, the system rejects the operation.
Default Value: (0,0)
below The minimum amount of below-16M CSA storage that must remain after the ADD operation. The value can be
expressed as n, nK, or nM.
above The minimum amount of above-16M CSA storage that must remain after the ADD operation. The value can be
expressed as n, nK, or nM.
MODNAME=(modname,...,modname)
modname is the 1-8 character LPA module name or alias. If the last character of the modname is an asterisk (*), it
will be treated as X'C0'. This lets you directly specify the name of a load module that ends with that nonprintable
character. The system does not support wildcard characters within modname. You can provide a maximum of 128
module names, and you can use MOD and MODULE as synonyms for MODNAME.
Default Value: None
MASK(mask)
mask is the 1-8 character mask to be applied to all members of the specified data set. It can contain wildcard
characters "*" and "?" and all members that match will be processed.
Default Value: None
MVS System Commands Syntax 107
SETPROG Command
DSNAME(dsname)
dsname is the 1-44 character data set name that contains the module(s) or alias(es). When MODNAME is
specified, you can specify DSNAME(LNKLST) if you want the system to use its normal search protocol (search LPA
then search the lnklst), instead of a particular data set. The data set must be cataloged.
The attribute of the CSA for each module is assigned as OWNER=SYSTEM. You can use DSN, LIB, and
LIBRARY as synonyms for DSNAME.
Default Value: None
FIXED Directs the system to place the modules in fixed storage.
Default Value: If you do not specify FIXED, the system places the modules in pageable storage.
PAGEPROTPAGE
Indicate whether or not to page protect entire modules. The default is to page protect entire modules.
Be aware that when that default is taken, storage use for the modules is somewhat larger than when specifying the
PAGEPROTPAGE parameter, because each module gets allocated a number of whole pages (which can be page
protected), rather than just the amount of storage that is truly necessary to load the modules. When you request
PAGEPROTPAGE, the system page protects only the whole pages within each load module. This keeps the
storage use to the minimum amount, but allows the possibility of a storage overlay of the beginning or end of the
load module.
You can use PPPAGE and PPP as synonyms for PAGEPROTPAGE.
Default Value: Page protect entire modules.
FORCE(YES)
Confirm that the delete requestor understands the ramifications of deleting a module from the LPA, when the
system can have no knowledge of whether any code is currently executing within the specified module.
Default Value: None. Required parameter.
CURRENT | OLDEST
CURRENT directs the system to delete the current copy. OLDEST specifies that the oldest copy be deleted. You
can use CUR as a synonym for CURRENT and OLD as a synonym for OLDEST.
Default Value: CURRENT
108 OS/390 V2R8.0 MVS System Commands Summary
SETRRS CANCEL Command
SETRRS CANCEL Command
SETRRS
SETRRS CANCEL[,DUMP|NODUMP]
Description:
Cancel (abnormally terminate) resource recovery services (RRS).
MVS System Commands Syntax 109
SETSMF Command
SETSMF Command (SS)
SETSMF or SS
SS parameter(value[,value]...)
Description:
Add a SUBPARM parameter or replace any previously-specified parameter in the active SMF member of SYS1.PARMLIB except
the ACTIVE, PROMPT, SID, or EXITS parameters.
110 OS/390 V2R8.0 MVS System Commands Summary
SETSMS Command
SETSMS Command
SETSMS
SETSMS parameter(value)[,parameter(value)]...
Description:
Change a subset of storage management subsystem (SMS) parameters from the console without changing the active IGDSMSxx
member of SYS1.PARMLIB.
MVS System Commands Syntax 111
SETSSI Command
SETSSI Command
SETSSI
SETSSI {ADD,{SUBNAME|SUB|S}=subname
[,{CONSNAME|C}=consname]
[,{INITRTN|I}=initrtn[,{INITPARM|P}=initparm]] }
{ }
{DEACTIVATE|DEACT},{SUBNAME|SUB|S}=subname }
{ }
{ACTIVATE|ACT},{SUBNAME|SUB|S}=subname }
Description:
Dynamically add, activate, or deactivate a subsystem.
ADD Dynamically adds a subsystem.
DEACTIVATE or DEACT
Specify that a subsystem be dynamically deactivated.
Note: You can only issue the DEACTIVATE command if the target subsystem is dynamic and permits the use of
the SETSSI command.
ACTIVATE or or ACT
Specify that a subsystem be dynamically activated.
Note: You can only issue the ACTIVATE command if the target subsystem is dynamic and permits the use of the
SETSSI command.
SUBNAME or SUB or S=subname
The subsystem name to be dynamically added, deactivated, or activated.
Note that the SUBNAME parameter applies to the ADD command, the DEACTIVATE command, and the
ACTIVATE command.
CONSNAME or C=consname
The name of the console to which messages that SSI issues are routed. CONSNAME, an optional parameter two
to eight bytes long, is passed to the routine named on the INITRTN keyword (if specified).
INITRTN or I=initrtn
The name of the subsystem initialization routine. INITRTN is an optional parameter, one to eight characters long.
Each character may be alphabetic, numeric, or national (#, @, or $) except the first, which must be non-numeric.
INITPARM or P=initparm
The input parameter the system passes to the subsystem initialization routine. INITPARM is an optional parameter.
It can be no more than sixty characters long.
112 OS/390 V2R8.0 MVS System Commands Summary
SETXCF Command
SETXCF Command
SETXCF
SETXCF COUPLE,{PSWITCH }
{ }
{ACOUPLE=(alternatedsname[,alternatevolume]) }
{ }
{INTERVAL=timeinterval }
{ }
{OPNOTIFY=timeinterval }
{ }
{CLEANUP=timeinterval }
{ }
{MAXMSG=defaultmaxmsgbuffers }
{ }
{RETRY=defaultretrylimit }
{ }
{CLASSLEN=defaultclasslength }
{ }
{TYPE=(name[,name]...), }
{ {PCOUPLE=(primarydsname[,primaryvolume]) } }
{ {ACOUPLE=(alternatedsname[,alternatevolume])} }
{ {PSWITCH } }
Description:
Switch the current alternate XCF couple data set to the primary XCF couple data set. Specify an alternate XCF couple data set.
Change options specified in the COUPLExx parmlib member.
PSWITCH Switch the current alternate XCF couple data set to the primary XCF couple data set.
ACOUPLE=(alternatedsname,alternatevolume)
Specify the data set to be used as alternate XCF couple data set.
INTERVAL=timeinterval
Specify the length of the failure detection interval for the system.
OPNOTIFY=timeinterval
Specify how long a system must appear to be inoperative before XCF notifies the operator.
CLEANUP=timeinterval
Specify the time interval that XCF waits for multisystem applications to complete cleanup functions.
MAXMSG=defaultmaxmsgbuffers
Specify the default value for the maximum amount of message buffers. The MAXMSG value must be a number
from 1 to 999999.
RETRY=defaultretrylimit
Specify the default value for the retry limit. The RETRY value must be a number from 3 to 255.
CLASSLEN=defaultclasslength
Specify the default message length for the transport classes.
TYPE=(name,[name]...)
Specify the type of data, other than sysplex data, stored in this couple data set.
PCOUPLE Specify the data set to use as the primary couple data set.
ACOUPLE Specify the data set to use as the alternate couple data set.
PSWITCH Specify that the current alternate couple data set becomes the primary couple data set.
MVS System Commands Syntax 113
SETXCF Command
SETXCF FORCE,
{STRUCTURE,STRNAME=(strname[,strname]...) }
{ }
{CONNECTION,STRNAME=strname,CONNAME={(conname[,conname]...)|ALL} }
{ }
{STRDUMP,STRNAME=strname[,STRDUMPID=strdumpid] }
{ }
{STRDUMPSERIAL,STRNAME=strname[,STRDUMPID=strdumpid] }
Description:
Clean up resources related to structures in a coupling facility. The resource can be either a structure actively in use in the
sysplex, or a dump associated with structures pending deallocation.
STRUCTURE,STRNAME=(strname[,strname]...)
Specify the name of one or more coupling facility structures of which the system is to force deletion.
CONNECTION
Specify that the system is to force the deletion of a failed-persistent connection.
STRNAME=strname
The name of the structure that contains the failed-persistent connection.
CONNAME={(conname[,conname]...)|ALL}
The name of one or more failed-persistent connections to delete from the named structure.
STRDUMP Specify that the system is to force the deletion of a structure dump.
STRNAME=strname
The name of the structure for which to delete the structure dump.
STRDUMPID=strdumpid
The unique identifier of the structure dump to delete.
STRDUMPSERIAL
Specify that the system is to release its dumping serialization for a coupling facility structure.
STRNAME=strname
The name of the structure whose dump serialization the system is to release.
STRDUMPID=strdumpid
The unique identifier of the structure dump associated with the structure for which the system is to
release dump serialization.
114 OS/390 V2R8.0 MVS System Commands Summary
SETXCF Command
SETXCF MODIFY,{PATHIN,{DEVICE=([/]indevnum[,[/]indevnum]...)} }
{ {STRNAME=(strname[,strname]...)} } }
{ [,MAXMSG=maxmsgbuffers] }
{ [,RETRY=retrylimit] }
{ }
{PATHOUT,{DEVICE=([/]outdevnum[,[/]outdevnum]...)} }
{ {STRNAME=(strname[,strname]...) } }
{ [,CLASS=classname] }
{ [,MAXMSG=maxmsgbuffers] }
{ [,RETRY=retrylimit] }
{ }
{LOCALMSG,MAXMSG=maxmsgbuffers }
{ [,CLASS=class-name] }
{ }
{CLASSDEF,CLASS=classname }
{ [,CLASSLEN=classlength] }
{ [,MAXMSG=defaultmaxmsgbuffers] }
{ [,ADDGROUP=(groupname[,groupname]...)] }
{ [,DELGROUP=(groupname[,groupname]...)] }
Description:
Change current XCF parameters.
PATHIN,DEVICE=([/]indevnum[,[/]indevnum]...) [,MAXMSG=maxmsgbuffers][,RETRY=retrylimit]
Specify the device numbers of inbound signalling paths. RETRY modifies the retry limit and MAXMSG modifies the
amount of the message buffer space. You must specify at least one of the MAXMSG and RETRY keywords. The
MAXMSG value must be a number from 1 to 999999. The RETRY value must be a number from 3 to 255.
PATHIN,STRNAME=(strname[,strname]...)
Specify the name of one or more coupling facility structures to be modified.
PATHOUT,DEVICE=([/]outdevnum[,[/]outdevnum]...) [CLASS=classname] [MAXMSG=maxmsgbuffer][RETRY=retrylimit]
Specify the device numbers of outbound signalling paths. RETRY modifies the retry limit, CLASS modifies the
transport class assignment, and MAXMSG modifies the amount of message buffer space. You must specify at
least one of the MAXMSG, CLASS, and RETRY keywords. The MAXMSG value must be a number from 1 to
999999.
PATHOUT,STRNAME=(strname[,strname]...)
Specify the name of one or more coupling facility structures to be modified.
LOCALMSG,MAXMSG=maxmsgbuffers[,CLASS=class-name]
Modify the amount of message buffer space made available for local message traffic. CLASS indicates the name
of the class affected.
CLASSDEF,CLASS=classname [,CLASSLEN=classlength [,MAXMSG=defaultmaxmsgbuffers]]
Specify the transport class to be modified. CLASSLEN modifies the message length, MAXMSG modifies the
message buffer space. You must specify at least one of the CLASSLEN, MAXMSG, ADDGROUP, and
DELGROUP keywords. The MAXMSG value must be a number from 1 to 999999.
ADDGROUP=(groupname[,groupname]...)
Specify groups to be added to the set of groups assigned to the transport class.
DELGROUP=(groupname[,groupname]...)
Groups to be deleted from the set of groups assigned to the transport class.
SETXCF PRSMPOLICY,{DEACTIVATE|ACTIVATE=memname}
Description:
Activate an XCF PR/SM policy or deactivate a current active XCF PR/SM policy.
ACTIVATE=memname
Specify the member name in SYS1.PARMLIB that contains the XCF PR/SM policy to be activated.
DEACTIVATE
Specify that all XCF PR/SM policy processing is to be stopped.
MVS System Commands Syntax 115
SETXCF Command
SETXCF START,{CLASSDEF,CLASS=classname }
{ [,CLASSLEN=classlength] }
{ [,MAXMSG=maxmsgbuffers] }
{ [,GROUP=(groupname[,groupname]...)] }
{ }
{PATHIN,{DEVICE=([/]indevnum[,[/]indevnum]...)} }
{ {STRNAME=(strname[,strname]...) } }
{ [,MAXMSG=maxmsgbuffers] }
{ [,RETRY=retrylimit] }
{ }
{PATHOUT,{DEVICE=([/]outdevnum[,[/]outdevnum]...)} }
{ {STRNAME=(strname[,strname]...) } }
{ [,MAXMSG=maxmsgbuffers] }
{ [,RETRY=retrylimit] }
{ [,CLASS=classname] }
{ }
{POLICY,TYPE=name,POLNAME=polname }
{ }
{REBUILD,{POPULATECF,CFNAME=cfname} }
{ {DUPLEX,} }
{ {STRNAME=(strname[,strname]...)} }
{ {CFNAME=(cfname[,cfname]...) } }
{ [,LOCATION={NORMAL|OTHER}] }
| { [,LESSCONN={TERMINATE|CONTINUE}] }
{ }
{ALTER,STRNAME=strname,SIZE=size }
Description:
Start signalling paths and define transport class definitions for use by XCF.
CLASS=classname
Specify the name of the transport class to which outbound signalling paths are assigned.
CLASSLEN=classlength
Specify the message length for the transport class.
GROUP=(groupname[,groupname]..)]
Assign one or more groups to the transport class.
PATHIN,DEVICE=([/]indevnum[,[/]indevnum]...)
Specify the device numbers of inbound signalling paths XCF can use.
PATHIN,STRNAME=(strname[,strname]...)
Specify the name of one or more coupling facility structures that XCF can use as inbound signaling paths.
PATHOUT,DEVICE=([/]outdevnum[,[/]outdevnum]...)
Specify the device numbers of outbound signalling paths XCF can use.
PATHOUT,STRNAME=(strname[,strname]...)
Specify the name of one or more coupling facility structures that XCF can use as outbound signaling paths.
CLASSDEF,CLASS=classname
Specify a definition for a new transport class.
POLICY,TYPE=name
Specify the name of the service that is using the couple data set for policy data.
POLICY,POLNAME=polname
Specify the name of the policy to be made active.
116 OS/390 V2R8.0 MVS System Commands Summary
SETXCF Command
REBUILD,POPULATECF
Specify the name of the coupling facility to populate.
REBUILD,DUPLEX
Specify the name of one or more coupling facility structures to duplex in another coupling facility.
REBUILD,STRNAME=(strname[,strname]...)
Specify the name of one or more coupling facility structures to rebuild in the same or another coupling facility.
REBUILD,CFNAME=(cfname[,cfname]...)
Specify the name of one or more coupling facilities for which all structures other than XCF signalling structures are
to be rebuilt.
LOCATION={NORMAL|OTHER}
Specify the location where the new structure can be rebuilt.
ALTER,STRNAME=strname
Specify the name of a coupling facility structure for which structure alter is to be initiated.
SIZE=size Specify the target size of the coupling facility structure to be altered.
MAXMSG=maxmsgbuffers
Specify (1) the maximum amount of message buffer space XCF can use to receive or send messages through the
signal paths; (2) the default amount of message buffer space allotted for user messages sent in transport class.
RETRY=retrylimit
Specify the retry limit for the inbound or outbound signalling paths. The RETRY value must be a number from 3 to
255.
MVS System Commands Syntax 117
SETXCF Command
SETXCF STOP,{PATHIN,{DEVICE=([/]indevnum[,[/]indevnum]...)} }
{ {STRNAME=(strname[,strname]...) } }
{ [,UNCOND=NO|YES] }
{ }
{PATHOUT,{DEVICE=([/]outdevnum[,[/]outdevnum]...)} }
{ {STRNAME=(strname[,strname]...) } }
{ [,UNCOND=NO|YES] }
{ }
{CLASSDEF,CLASS=classname }
{ }
{POLICY,TYPE=name }
{ }
{REBUILD,{POPULATECF,CFNAME=cfname} }
{ {DUPLEX,} }
{ {STRNAME=(strname[,strname]...)} }
{ {,KEEP=NEW|OLD} }
{ {CFNAME=(cfname[,cfname]...) } }
{ }
{ALTER,STRNAME=strname }
Description:
Remove XCF signalling paths and transport class definitions.
PATHIN,DEVICE=([/]indevnum[,[/]indevnum]...)
Specify the device numbers of inbound signalling paths XCF should no longer use.
PATHIN,STRNAME=(strname[,strname]...)
Specify the name of one or more coupling facility structures that XCF should no longer use.
PATHOUT,DEVICE=([/]outdevnum[[/]outdevnum]..)
Specify the device numbers of outbound signalling paths XCF should no longer use.
PATHOUT,STRNAME=(strname[,strname]...)
Specify the name of one or more coupling facility structures that XCF should no longer use.
CLASSDEF,CLASS=classname
Delete the definition for the specified transport class and free the space allocated for message buffers.
POLICY,TYPE=name
Specify the name of the service that is using the couple data set for policy data.
REBUILD,STRNAME=(strname[,strname]...)
Specify the name of one or more coupling facility structures for which rebuild processing is to stop.
REBUILD,CFNAME=(cfname[,cfname]...)
Specify the name of one or more coupling facilities for which rebuild processing is to stop.
ALTER,STRNAME=strname
Specify the name of the coupling facility structure for which structure alter processing is to stop.
UNCOND=NO or YES
Specify whether this is an unconditional request.
118 OS/390 V2R8.0 MVS System Commands Summary
SLIP Command
SLIP Command (SL)
SLIP or SL
SLIP SET[,options],END Command for an error event trap (non-PER)
SLIP SET,IF[,options],END Command for an instruction fetch PER trap
SLIP SET,SB1[,options],END
SLIP SET,SBT[,options],END
Commands for a successful branch PER trap
SLIP SET,SA[,options],END
SLIP SET,SAS[,options],END
Commands for a storage alteration PER trap
SLIP MOD[,options] Command to modify an existing trap
SLIP DEL[,options] Command to delete an existing trap
Note:
SET, MOD, or DEL must be specified and must immediately follow SLIP.
If specified, IF, SB1, SBT, SA, or SAS must immediately follow SET.
END must be specified at the end of all SLIP SET commands.
SLIP SET
SLIP SET
[,ADDRESS=(start[,end]) ]
|,LPAEP=(name[,start[,end]])
|,LPAMOD=(name[,start[,end]])
|,NUCEP=(name[,start[,end]])
|,NUCMOD=(name[,start[,end]])
|,PVTEP=(name[,start[,end]])
|,PVTMOD=(name[,start[,end]])
[,ASID=(asid[,asid]...)]
[,COMP=code[,REASON=code]]
[,DATA=(comparison[,comparison]...)]
[,ERRTYP=(type,[,type]...)]
[,JOBNAME={userid | jobname}]
[,JSPGM=name]
[,MODE= (mode[,mode]...[,ANY | EVERY])]
[,PSWASC=(mode[,mode]...)]
[,ACTION=[IGNORE[,option] ] ]
[(nodump[,nodump]...)[,option] ]
[NOSUP[,option] ]
[RECORD ]
[SVCD[,options] ]
[TRACE[,options] ]
[TRDUMP[,options] ]
[WAIT[,options] ]
MVS System Commands Syntax 119
SLIP Command
SLIP SET
[,ENABLE | ,DISABLE]
[,IDGROUP=idgroup]
[,MATCHLIM=m]
|,MATCHLIM=1 for ACTION=SVCD or ACTION=SYNCSVCD
[,DEBUG]
[,ID=trapid]
[,OK]
[,RBLEVEL={ERROR | NOTSVRB | PREVIOUS } ]
,END
SLIP SET,IF or SET,SB1 or SET,SBT
SLIP SET,{IF }
{SB1}
{SBT}
[,LPAEP=(name[,start[,end]]) ]
|,LPAMOD=(name[,start[,end]])
|,NUCEP=(name[,start[,end]])
|,NUCMOD=(name[,start[,end]
|,PVTEP=(name[,start[,end]])
|,PVTMOD=(name[,start[,end]])
|,RANGE=(start[,end])
[,ASID=(asid[,asid]...)]
[,DATA=(comparison[,comparison]...)]
[,JOBNAME={userid | jobname}]
[,JSPGM=name]
[,MODE= (mode[,mode]...[,ANY | EVERY])]
[,PSWASC=(mode[,mode]...)]
[,ACTION=[(IGNORE[,RECOVERY]) ]]
[(RECOVERY[,REFAFTER][,REFBEFOR][,TARGETID])[,options] ]
[(STDUMP[,REFAFTER][,REFBEFOR][,TARGETID])[,options] ]
[(STRACE[,REFAFTER][,REFBEFOR][,TARGETID])[,options] ]
[(SVCD[,RECOVERY][,REFAFTER][,REFBEFOR][,TARGETID])[,options] ]
[(SYNCSVCD[,REFAFTER][,REFBEFOR][,TARGETID])[,options] ]
[(TRACE[,RECOVERY][,REFAFTER][,REFBEFOR][,TARGETID])[,options] ]
[(TRDUMP[,RECOVERY][,REFAFTER][,REFBEFOR][,TARGETID])[,options]]
[(WAIT[,RECOVERY][,REFAFTER][,REFBEFOR][,TARGETID])[,options] ]
120 OS/390 V2R8.0 MVS System Commands Summary
SLIP Command
SLIP SET,IF or SET,SB1 or SET,SBT
[,ENABLE | ,DISABLE]
[,IDGROUP=idgroup]
[,MATCHLIM=m]
|,MATCHLIM=1 for ACTION=SVCD or ACTION=SYNCSVCD
|,MATCHLIM=5 for ACTION=STDUMP or ACTION=STRACE
[,PRCNTLIM=p | ,PRCNTLIM=1]
[,DEBUG]
[,ID=trapid]
[,OK]
,END
SLIP SET,SA or SET,SAS
SLIP SET,{SA }
{SAS}
| [,ADDRESS=(start[,end]) ]
|,LPAEP=(name[,start[,end]])
|,LPAMOD=(name[,start[,end]])
|,NUCEP=(name[,start[,end]])
|,NUCMOD=(name[,start[,end]])
|,PVTEP=(name[,start[,end]])
|,PVTMOD=(name[,start[,end]])
[,RANGE=(start[,end])]
[,ASID=(asid[,asid]...)]
[,ASIDSA=(asid | 'jobname'[,asid | ,'jobname']...)]
[,DATA=(comparison[,comparison]...)]
[,DSSA=(asid.name | 'jobname'.name[,asid.name | ,'jobname'.name]...)]
[,JOBNAME={userid | jobname}]
[,JSPGM=name]
[,MODE= (mode[,mode]...[,ANY | EVERY])]
[,PSWASC=(mode[,mode]...)]
[,ACTION=[(IGNORE[,RECOVERY]) ]]
[(RECOVERY[,REFAFTER][,REFBEFOR][,TARGETID])[,options] ]
[(STDUMP[,REFAFTER][,REFBEFOR][,TARGETID])[,options] ]
[(STRACE[,REFAFTER][,REFBEFOR][,TARGETID])[,options] ]
[(SVCD[,RECOVERY][,REFAFTER][,REFBEFOR][,TARGETID])[,options] ]
[(SYNCSVCD[,REFAFTER][,REFBEFOR][,TARGETID])[,options] ]
[(TRACE[,RECOVERY][,REFAFTER][,REFBEFOR][,TARGETID])[,options] ]
[(TRDUMP[,RECOVERY][,REFAFTER][,REFBEFOR][,TARGETID])[,options]]
[(WAIT[,RECOVERY][,REFAFTER][,REFBEFOR][,TARGETID])[,options] ]
MVS System Commands Syntax 121
SLIP Command
SLIP SET,SA or SET,SAS
[,ENABLE | ,DISABLE]
[,IDGROUP=idgroup]
[,MATCHLIM=m]
|,MATCHLIM=1 for ACTION=SVCD or ACTION=SYNCSVCD
|,MATCHLIM=5 for ACTION=STDUMP or ACTION=STRACE
[,PRCNTLIM=p | ,PRCNTLIM=1]
[,DEBUG]
[,ID=trapid]
[,OK]
,END
122 OS/390 V2R8.0 MVS System Commands Summary
SLIP Command
SLIP SET Parameters
ACTION=IGNORE
Resume normal processing when the event occurs. IGNORE is not valid for PER traps.
ACTION=(nodump[,nodump]...)
Suppress any SVC, SYSABEND, SYSUDUMP, or SYSMDUMP dumps or specific dump types. The values are
NODUMP, NOSVCD, NOSYSA, NOSYSM, or NOSYSU.
ACTION=NOSUP
Prevent suppression of dumps requested by the system or a user program, regardless of any existing dump
suppression specifications. NOSUP is not valid for PER traps.
ACTION=RECORD or RECORD
Force a logrec data set record for every recovery routine, regardless of what the recovery routine specifies.
ACTION=RECOVERY or RECOVERY
Force PER traps to initiate recovery processing for the interrupted process. RECOVERY is not valid for
non-PER traps.
ACTION=REFAFTER or REFAFTER
For a PER trap, specify that a refresh is to occur after any other specified action. The refresh is defined in a
REFAFTER=(triplet) parameter.
ACTION=REFBEFOR or REFBEFOR
For a PER trap, specify that a refresh is to occur before any other specified action. The refresh is defined in a
REFBEFOR=(triplet) parameter.
ACTION=STDUMP
Write a SLIP system trace record when the trap matches, and schedule an SVC dump when the trap is
disabled or deleted.
ACTION=STRACE
Write at least one SLIP system trace record when the trap matches.
ACTION=SVCD Schedule an SVC dump for the current or failing address space when the trap matches.
ACTION=SYNCSVCD
Schedule a synchronous SVC dump for the current or failing address space when the trap matches.
ACTION=TARGETID or TARGETID
For a non-IGNORE PER trap, specify that a new trap be activated when the previous trap has been
deactivated as a result of matching the limit in MATCHLIM. The new trap is identified in a TARGETID=(trapid)
parameter.
ACTION=TRACE Write at least one GTF SLIP trace record when the trap matches.
ACTION=TRDUMP
Write at least one GTF SLIP trace record when the trap matches, and schedule an SVC dump when the trap is
deleted or disabled.
ACTION=WAIT Stop the system and display trap information in message IEE837I.
MVS System Commands Syntax 123
SLIP Command
SLIP SET Parameters
ADDRESS or AD=(start[,end])
For an error detection trap, specify the address or range of addresses within which the error must occur. For
storage alteration PER traps, specify the address or range within which the instruction that causes the storage
alteration. For an enabled, unlocked, task mode error that is matched against a non-PER trap, the RBLEVEL
keyword controls the PSW address that is used to decide if ADDRESS matches.
ASID or AS=(asid[,asid]...)
The address space that must be in control when the error or PER interruption occurs.
ASIDLST or AL=(asid[,asid]...)
The hex address space identifiers of the address space(s) to dump.
ASIDSA or ASA=(asid[,asid]... or 'jobname'[,'jobname']...)
Specify the address space or the job associated with the address space containing the storage that is being
altered.
COMP=code Specify the system or user completion code associated with the error.
DATA=(comparison[,comparison]...)
Compare a target storage location or general purpose register using a given operator to a given value.
DEBUG For a non-working trap, indicate which conditions were not met.
DISABLE or D Indicate that the trap defined is to be initially inactive.
DSPNAME or DN =(asid.name[,asid.name]... or 'jobname'.name[,;jobname'.name]...)
Specify the data spaces to include in the dump.
DSSA=(asid.name[,asid.name].. or 'jobname'[,'jobname']...)
Specify the data space or the job associated with the data space containing the storage that is being altered.
ENABLE or EN Indicate that the trap defined is to be initially active.
END or E Mark the end of the SLIP SET command.
ERRTYP or ER=(type[,type]...)
Specify one or more error event types.
ID=trapid Specify an alphanumeric trap identifier.
IDGROUP=idgroup
Specify that the trap is in a group and give the name of the group.
IF Specify the event as an instruction fetch.
JOBLIST or JL=(jobname[,jobname]...)
Specify the jobs to include in the dump.
JOBNAME or J=userid or jobname
Specify the name of the time-sharing user or the name of the job or task that must be in control for the
JOBNAME match test to be satisfied.
JSPGM or JS=name
Specify the name of the job step program that must be in control to satisfy the JSPGM match test. On
non-PER traps, JSPGM cause a no-match if the error type being processed is MEMTERM.
124 OS/390 V2R8.0 MVS System Commands Summary
SLIP Command
SLIP SET Parameters
LIST or LS=(start,end[,start,end]...)
Specify the starting and ending hex addresses of one or more areas of storage to include in an SVC dump.
LPAEP=(name[,start[,end]])
Monitor modules in the link pack area, given name, the name of an entry point within the module. start and
end are offsets from the entry point, indicating the range to monitor.
LPAMOD or L=(name[,start[,end]])
Monitor modules in the link pack area, given name, the name of the module. start and end are offsets within
the module, indicating the range to monitor.
MATCHLIM or ML=m
Specify to disable the SLIP trap after m matches.
MODE or M=(mode[,mode]..., ANY or EVERY)
Specify the mode(s) that the system must be in for the trap to match. Specifying ANY indicates that any one of
them is sufficient to cause a match, while EVERY indicates that all of them are necessary.
NUCEP or NUCMOD or N=(name[,start[,end]])
Monitor modules in the nucleus, given name, the name that identifies the beginning of the area to be
monitored. start and end are offsets within the module indicating the range to be monitored.
OK Omit checking that could result in messages IEE604D and IEE831D.
PRCNTLIM or PL=p
Specify the maximum amount of time that can be spent processing PER interruptions.
PSWASC or PA=(mode[,mode]...)
Specify a PSW address space control (PSWASC) mode that the system must be for the trap to match.
PVTEP=(name[,start[,end]])
Monitor modules in the private area, given name, the name identifying the entry point within the module. start
and end are offsets from the entry point indicating the range to monitor.
PVTMOD or P=(name[,start[,end]])
Monitor modules in the private area, given name, the name identifying the beginning of the module. start and
end are offsets within the module indicating the range to monitor.
RANGE or RA=(start[,end])
For PER traps, specify the starting and ending hex addresses of the virtual storage area to monitor.
RBLEVEL or RB= ERROR or NOTSVRB or PREVIOUS
Indicate which RB contains the registers for use in resolving indirect addresses or the PSW for use by
LPAMOD, NUCMOD, PVTMOD, ADDRESS, and MODE.
REASON=code The reason code associated with the error.
REFAFTER=(triplet[,triplet]...)
Define the refresh to be taken after the action.
REFDEFOR=(triplet[,triplet]...)
Define the refresh to be taken before the action.
MVS System Commands Syntax 125
SLIP Command
SLIP SET Parameters
REMOTE=(UNCOND or COND,remote)
Specify actions to take within the sysplex, on systems other than the system on which the trap matches.
REMOTE specifies the system, action, and dump options, and is only valid when the specified ACTION on the
local system is SCVD, SYNCSVCD, or WAIT.
SA Specify the event as a storage alteration.
SAS Specify the event as a storage alteration caused by a STURA instruction.
SB1 Specify the event as a successful branch that matches on the first instruction in the specified range.
SBT Specify the event as a successful branch caused by a branch instruction into the specified range or a branch
within the specified range.
SDATA=(area[,area]...)
Specify the kind of system control information to dump.
STRLIST=(s-option[,s-option]...)
Specify, by name, the coupling facility structures you want to dump.
SUMLIST=(start,end[,start,end]...)
Specify the starting and ending addresses of one or more areas to include in a summary dump.
TARGETID=(trapid)
Identify the trap to activate when the current trap is deactivated as a result of MATCHLIM.
TRDATA=(STD[,REGS][,list])
Specify the type and content of the SLIP GTF trace record.
SLIP MOD
SLIP MOD{,ENABLE | ,DISABLE}
{,ALL | ,ID=trapid}
Description:
Modify a SLIP trap.
ENABLE or E
Activate the specified SLIP trap(s).
DISABLE or D
Deactivate the specified SLIP trap(s).
ALL Modify every SLIP trap present in the system.
CAUTION: Make SURE you are aware of all the consequences of the ALL operand.
ID=trapid Modify only the SLIP trap with identifier trapid.
SLIP DEL
SLIP DEL{,ALL | ,ID=trapid}
Description:
Delete one or all SLIP traps.
ALL Delete every SLIP trap present in the system.
CAUTION: Make SURE you are aware of all the consequences of the ALL operand.
ID=trapid Delete only the SLIP trap with identifier trapid.
126 OS/390 V2R8.0 MVS System Commands Summary
START Command
START Command (S)
START or S
S membername[.identifier][,devicetype|,[/]devnum][,volumeserial]
[,parameters][,JOBNAME=jobname][,JOBACCT=acct_info]
[,SUB=subsystemname][,keyword=option[,keyword=option]...]
Description:
Start a system task from the console.
membername
The name of the member that contains the source JCL that invokes the started task. The source JCL can be either
a cataloged procedure, residing in a procedure library, or a job. If it is a procedure, the subsystem that selects the
job determines which JCL procedure library is called, usually MSTR,JES2 or JES3.
identifier The user-determined name for the job to be started. If you do not specify an identifier and the started task does
not have an IEFRDER DD statement, the system uses the job name as the identifier. If you do not specify an
identifier and the started task has an IEFRDER DD statement, the device allocated to that started task becomes
the identifier name.
devicetype The device type of an output device where time-sharing parameters from SYS1.PARMLIB are listed.
[/]devnum The device number of an output device where time-sharing parameters from SYS1.PARMLIB are listed.
parameters Program parameters passed to the started program.
volumeserial
The volume serial number of the volume mounted on the device, if devicename or devnum is a tape or direct
access device.
JOBNAME=jobname
The job name that will be assigned to the job.
If the source JCL is a procedure and you omit the JOBNAME keyword, the member name will be assigned as
the jobname.
If the source JCL is a job and you omit the JOBNAME keyword, the system will use the job name assigned on
the JOB statement in the JCL.
If you specify the JOBNAME keyword, you cannot specify an identifier
SUB=subsystemname
The name of the subsystem that is to select the job for processing. If SUB= is not specified, the default subsystem
will select the task. When the task being started is a subsystem and you omit SUB=, it will be started under MSTR
unless the subsystem itself requests to start under the job entry subsystem.
keyword=option
Specify any appropriate keyword to override the corresponding parameter in the cataloged procedure.
Notes:
1. If you specify an option in apostrophes, use uppercase.
2. If you are overriding a data set name that is 44 characters long, use DSN=, not DSNAME=.
3. If overriding a symbolic parameter, do not use any DD keywords.
S APPC,SUB=MSTR[,APPC=(nn[,nn]...[,L])]
Description: Start the APPC address space.
APPC,SUB=MSTR
The system is to start the APPC address space from the master scheduler address space.
APPC=(nn,...)
The APPC is to use the APPCPMnn parmlib members. The default member is APPCPM00.
L The system displays parmlib statements to the console.
MVS System Commands Syntax 127
START Command
START or S
S ASCH,SUB=MSTR[,ASCH=(nn[,nn]...[,L])]
Description: Start the ASCH address space.
ASCH,SUB=MSTR
The system is to start the ASCH address space from the master scheduler address space.
ASCH=(nn,...)
The APPC is to use the ASCHPMnn parmlib members. The default member is ASCHPM00.
L The system displays parmlib statements to the console.
S {GTF|membername}[.identifier][,devicetype|,[/]devnum][,volumeserial]
[([,MODE={INT|DEFER|EXT}][,TIME=YES][,DEBUG=YES])]
[,BLOK={numpages|nnnK|nnM}][,MEMBER=xxxxxxxx][,REGION=nnnnK]
[,{SADMP|SA}={nnM|nnnk}][,{SDUMP|SD}={nnM|nnnk}]
[,{NOPROMPT|NP}][,{ABDUMP|AB}={nnM|nnnk}]
[,keyword=option[,keyword=option]...]
Description:
Start the generalized trace facility (GTF).
GTF The name of the IBM-supplied cataloged procedure that invokes GTF.
membername
The name of member that contains the source JCL that invokes GTF.
identifier The user-determined name identifying this specific GTF session.
devicetype The device type of the writer to be started.
[/]devnum The device number of the writer to be started.
volumeserial
The serial number of a magnetic tape or direct access volume to receive the trace data.
MODE=INT Maintain trace data in the GTF address space.
MODE=DEFER
Maintain trace data in GTF address space until operator enters STOP GTF. Then GTF will transfer data to the
output data set during end processing.
MODE=EXT Maintain trace data in an external set.
BLOK= Reserves common storage buffers to collect GTF data.
nnnk or nnM The decimal number for the amount of storage in kilobytes or megabytes.
numpages The decimal number for the amount of 4096-byte pages of storage.
SADMP Number of bytes of GTF data that will appear in a stand alone dump.
SDUMP Number of bytes of GTF data that will appear in an SVC dump.
128 OS/390 V2R8.0 MVS System Commands Summary
START Command
START or S
NOPROMPT If specified, indicates that the operator will not be prompted to specify trace options.
ABDUMP Number of GTF data that will appear in a SNAP or ABEND dump.
TIME=YES Time-stamp each logical trace record.
DEBUG=YES
GTF terminates whenever an error is encountered while a trace record is being created.
MEMBER=xxxxxxxx
The member of SYS1.PARMLIB to be accessed by this invocation of GTF.
REGION=nnnnK
The maximum size of the GTF address space in bytes.
keyword=option
Specify any appropriate keyword to override the corresponding keyword in the cataloged procedure.
Note: If you omit devicetype, devnum, or volumeserial, you must enter a comma for the omitted parameter. Do not enter any
commas, however, after the last parameter that you specify.
S LLA[,SUB=MSTR][,LLA=xx]
Description:
Start the library lookaside (LLA) address space.
LLA Invoke the LLA procedure and create the LLA address space.
LLA=xx Indicate which CSVLLAxx parmlib member LLA is to use.
SUB=MSTR Indicate that the system is to start the LLA address space from the master scheduler address space.
S {OAM[membername}[.identifier][,OAM=xx]
Description:
Start the object access method.
OAM The name of the IBM-supplied cataloged procedure that invokes OAM.
membername
The name of the member that contains the source JCL that invokes OAM.
identifier The user-determined name identifying the OAM address space.
S RRS|membername[,CTMEM=CTnRRSxx][,GNAME=lgrpname][,JOBNAME=jobname]
Description:
Start resource recovery services.
RRS | membername
The name of the IBM-supplied cataloged procedure or the member containing the source JCL that invokes RRS.
CTMEM=CTnRRSxx
The CTnRRSxx parmlib member containing the options RRS component trace is to use when RRS starts the trace.
GNAME=lgrpname
The log group name.
JOBNAME=jobname
The subsystem name defined in the IEFSSNxx member of SYS1.PARMLIB corresponding to RRS.
MVS System Commands Syntax 129
START Command
START or S
S membername[.identifier][,devicetype|,[/]devnum]
[,volumeserial][([,MEMBER={name|nn}][,USERMAX=nnnnn]
[,GNAME=[name | NONE])]
[,keyword=option[,keyword=option]...]
Description:
Start TSO/VTAM time-sharing.
membername
The name of the member that contains the source JCL that invokes TSO/VTAM time sharing. Many installations
use TCAS as the name.
identifier The user-determined name identifying the specific time-sharing session.
devicetype The device type of an output device where time-sharing parameters from SYS1.PARMLIB are listed.
[/]devnum The device number of an output device where time-sharing parameters from SYS1.PARMLIB are listed.
volumeserial
The volume serial number of the volume mounted on the device, if devicetype or devnum is a tape or direct access
device.
MEMBER=name
The name of a member of SYS1.PARMLIB that contains TSO/VTAM time-sharing parameters.
MEMBER=nn
A decimal that forms the name, of the form TSOKEYnn, of the member of SYS1.PARMLIB that contains the
TSO/VTAM time-sharing parameters.
USERMAX=nnnnn
The maximum number of TSO/VTAM users that can be logged on at one time.
keyword=option
Specify any appropriate keyword to override the corresponding keyword in the cataloged procedure.
Note: If you omit devicetype, devnum, or volumeserial, you must enter a comma for the omitted parameter. Do not enter any
commas, however, after the last parameter that you specify.
S {VLF|DLF},SUB=MSTR[,NN=xx]
Description:
Start the virtual lookaside facility (VLF) or the data lookaside facility (DLF).
VLF,SUB=MSTR
Invoke the VLF procedure that starts VLF.
NN=xx Start VLF using the COFVLFnn member of SYS1.PARMLIB.
DLF,SUB=MSTR
Invoke the DLF procedure that starts DLF.
NN=xx Start the DLF using the COFDLFnn PARMLIB member.
130 OS/390 V2R8.0 MVS System Commands Summary
START Command
START or S
S {XWTR|membername}[.identifier][,devicetype|,[/]devnum]
[,volumeserial][,classes][,keyword=option[,keyword=option]...]
Description:
Start an external writer.
XWTR The name of the IBM-supplied cataloged procedure that invokes the external writer.
membername
The name of the member that contains the source JCL that defines the external writer to start.
identifier The user-determined name identifying the job to start.
devicetype The device type to start.
[/]devnum The device number of the device to start.
volumeserial
The serial number of the magnetic tape or direct access volume the writer is to use.
classes The output classes, in priority sequence, the writer is to process. You may specify up to eight output classes. Do
NOT separate them by commas.
keyword=option
Specify any appropriate keyword to override the corresponding keyword in the cataloged procedure.
Note: If you omit devicetype, devnum, volumeserial, or classes, you must enter a comma for the omitted parameter. Do not
enter any commas, however, after the last parameter that you specify.
MVS System Commands Syntax 131
STOP Command
STOP Command (P)
STOP or P
P [jobname.]identifier[,A=asid]
Description:
Stop a started task.
jobname The name of the job.
identifier The identifier assigned to the job or started task.
A=asid The address space identifier, in hexadecimal, of the job, started task, writer, transaction program, or initiator
address space to stop.
P {ASCHINT,A=asid}
ASCHINT,A=asid
ASCHINT is the generic name for the ASCH initiator and A=asid is the address space identifier, in hexadecimal, of
the ASCH initiator to stop.
P DLF
DLF Stop the data lookaside facility (DLF) address space as soon as all DLF objects are disconnected for all users.
P LLA
LLA Stop the LLA address space.
P [OAM.|jobname.]identifier
OAM The generic job name of the object access method (OAM).
jobname The job name assigned to the object access method (OAM).
identifier The user-determined name identifying the OAM address space.
P VLF
VLF Stop VLF with message COF033I.
132 OS/390 V2R8.0 MVS System Commands Summary
STOPMN Command
STOPMN Command (PM)
STOPMN or PM
PM {JOBNAMES[,L={a|cc|cca|name|name-a}]}
{DSNAME }
{SPACE }
{STATUS[,L={a|cc|cca|name|name-a}] }
{SESS[,L={a|cc|cca|name|name-a}] }
Description:
Stop displays initiated in response to the MONITOR command or the MONITOR parameters on the CONSOLE and INIT
statements in the CONSOLxx member of SYS1.PARMLIB.
JOBNAMES Stop the jobname display specified in the MONITOR JOBNAMES command.
DSNAME Stop the display of nontemporary data sets specified in the MONITOR DSNAME command.
SPACE Stop the display of available space on direct access volumes specified in the MONITOR SPACE command.
STATUS Stop the display of data set names, volume serial numbers, and status specified in the MONITOR STATUS
command.
SESS Stop the display of time-sharing user identifiers.
L=a, cc, cca, name, or name-a
The console where the display appears.
MVS System Commands Syntax 133
STOPTR Command
STOPTR Command (PT)
STOPTR or PT
PT {TS }[,L={a }]
{JOBS} {cc }
{J } {cca }
{A } {name }
{name-a}
Description: Stop or reduce displays resulting from the TRACK command.
TS Stop the display of active time-sharing users.
JOBS or J Stop the display of active jobs, MOUNT commands in execution, and active tasks.
A Stop the display of active jobs, active time-sharing users, MOUNT commands in execution, and active tasks.
L=a, cc, cca, name, or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) of the active MCS console
where the display appears.
134 OS/390 V2R8.0 MVS System Commands Summary
SWAP Command
SWAP Command (G)
SWAP or G
G {OFF}
{ON }
G [/]devnum1,[/]devnum2
Description:
Initiate an operator request for dynamic device reconfiguration (DDR) or activate or deactivate system-initiated DDR.
Note: To swap between a UCB containing a 3-digit device number and a UCB containing a 4-digit device number, both must be
for DYNAMIC devices.
[/]devnum1,[/]devnum2
Move a volume from a device with device number devnum1 to a device with device number devnum2.
OFF or ON Activate (ON) or deactivate (OFF) system-initiated DDR.
MVS System Commands Syntax 135
SWITCH Command
SWITCH Command (I)
SWITCH or I
I {SMF }
{ }
{CN={(consname1) } }
{ {(consname1,consname2)} }
{ {(consname1,consname1)} }
Description:
Switch the recording of SMF data from one data set to another.
SMF The generic aggregate name of the data being collected. All SMF data in storage is written out before the transfer
is made.
CN=(consname1)
The console whose attributes the system is to switch.
CN=(consname1,consname2)
Indicate that the system is to append the attributes of the console specified for consname1 with the attributes of the
console specified for consname2.
CN=(consname1,consname1)
The console whose attributes the system is to remove from its alternate console.
136 OS/390 V2R8.0 MVS System Commands Summary
TRACE Command
TRACE Command
TRACE
TRACE [STATUS ]
[ST[,nnnK][,BR={ON|OFF}] ]
[ST[,OFF] ]
[MT[,nnnK|,OFF] ]
[CT{,WTRSTART=membername[,WRAP|NOWRAP] ]} ]
[CT{,WTRSTOP=jobname} ]
[CT{[,ON ],COMP=name[,SUB=(sub)][,PARM=mem]} ]
[ |,nnnnK ]
[ |,nnnnM ]
[ |,OFF ]
Description:
Start, stop, modify, or display status of a trace. Specify component trace operands by using the appropriate form of the REPLY
command, which is documented under REPLY or R.
STATUS Display the current status of system trace and master trace, including trace table sizes and on/off status of system
trace functions.
ST,nnnK Specify the amount of central storage set aside for each processor's system trace table entries.
ST,OFF Stop system trace and free the system trace table.
ST,BR=ON or OFF
Turn on or turn off the branch tracing function of system trace.
MT,nnnK or MT,OFF
Specify the master trace table size or stop master trace (OFF).
CT,ON,COMP=name or CT,OFF,COMP=name
Start (ON) or stop (OFF) tracing for the requested component. A HEAD level defined with HEADOPTS=NO cannot
be turned on.
CT,nnnK,COMP=name or CT,nnnnM,COMP=name
Start tracing for the requested component using the specified size of the component trace table.
CT,COMP=name
Alter tracing for a specific component, where name is the external name defined to component trace supplied by
the programmer.
CT,SUB Specify a single trace for a component that supports multiple traces. The (limit of one) subname is only supplied
by components that defined the COMP=name with the HEAD keyword in the CTRACE DEFINE processor.
PARM=mem Specify the member of SYS1.PARMLIB containing the options to use for tracing.
WTRSTART=membername
The name of the member containing the source JCL that invokes a component trace external writer. The member
can be a procedure in SYS1.PROCLIB or a job. When the data set becomes full, a specification or default of
WRAP directs the system to overwrite the data set from the beginning, while a specification of NOWRAP directs
the system to stop writing to the data set.
WTRSTOP=jobname
The writer that the system is to stop. If you specify or default NOFLUSH, the writer stops immediately. If you
specify FLUSH, the writer will stop when it has finished writing out its current buffers.
MVS System Commands Syntax 137
TRACK Command
TRACK Command (TR)
TRACK or TR
TR {TS|JOBS|J|A}[,LIST|,L][,USERID=userid][,L={a }]
{cc }
{cca }
{name }
{name-a}
Description:
Request a periodic display of job information on display consoles.
TS, JOBS, J, or A
For any of these operands, the number of active batch jobs, started tasks, and logged-on time-sharing users, and
the maximum number of time-sharing users allowed to be logged on under TSO/VTAM will be displayed
periodically.
LIST or L For TR JOBS or TR A, display detailed information for active jobs periodically. For TR TS or TR A, display detailed
information for each logged-on time-sharing user periodically.
USERID=userid
A filter to show only work running for the specified userid. This userid can be specified on the USER= keyword in
JCL or the user that requested this transaction.
L=a, cc, cca, name, or name-a
The display area (a), console (cc), both (cca), console name (name), or both (name-a) of the active MCS console
where the requested display is to appear.
138 OS/390 V2R8.0 MVS System Commands Summary
UNLOAD Command
UNLOAD Command (U)
UNLOAD or U
U [/]devnum
Description:
Unload mounted tape or DASD volumes, where devnum is the device number of the I/O device containing the volume to be
unloaded.
[/]devnum The device number of the device to unload.
MVS System Commands Syntax 139
VARY Command
VARY Command (V)
VARY or V
VARY CN(conspec1|),{ACTIVATE|ACT}
Description:
Place system console in problem determination mode.
CN(conspec1 or *)
Place a specified system console in problem determination mode.
conspec1 The console id or name of the console device.
* The console that you are currently issuing commands from.
ACTIVATE or ACT
The system is to activate problem determination mode for the specified console.
VARY CN(conspec1|),{DEACTIVATE|DEACT}
Description:
Remove the system console from problem determination mode.
CN(conspec1 or *)
Remove a specified system console in problem determination mode.
conspec1 The console id or name of the console device.
* The console that you are currently issuing commands from.
DEACTIVATE or DEACT
The system is to deactivate problem determination mode for the specified console.
140 OS/390 V2R8.0 MVS System Commands Summary
VARY Command
V CN{(|conspec1[,conspec1]... )}
[,ALTGRP={name|{NONE}]
[,AMSCOPE=([][,name[,name]...])]
[,AUTH={ALL|INFO|MASTER|([SYS][,IO][,CONS])}]
[,AROUT=(rtcode[,rtcode]...)]
[,DMSCOPE=([][,name[,name]...])]
[,DROUT=(rtcode[,rtcode]...)]
[,MSCOPE={(ALL)|{([][,name[,name]...])}]
[,OFFLINE|,ONLINE[,SYSTEM=sysname][,FORCE]]
[,ROUT={ALL|NONE|(rtcode[,rtcode]...)}]
[,UD={Y|N} ]
Description:
Assign and control MCS consoles
CN Change the indicated authority for the specified console id(s) or console name(s).
conspec1 The console id or name of the console device.
* The console from which you are currently issuing commands.
ALTGRP=name or *NONE*
Specify the name of an alternate console group.
AMSCOPE=* or (name,name...)
Allows the operator to add system names to the system names list for the message scope attribute of the specified
console.
AROUT=rtcode
The system is to add the specified routing code(s) or the routing codes in the specified range(s) to the routing
codes already defined for the console.
AUTH=MASTER,ALL,INFO or (SYS, IO, CONS)
The system command groups that the console is authorized to enter.
DMSCOPE= Allows the operator to delete system names from the system names list for the message scope attribute of the
specified console.
DROUT=rtcode
The system is to remove the specified routing code(s) or the routing codes in the specified range(s) from the
routing codes already defined for the console.
MSCOPE= Initialize the message scope attribute for the specified console.
OFFLINE Deactivate an MCS console and place the device in offline status.
ONLINE Activate a device defined in the CONSOLxx parmlib member as an MCS console.
SYSTEM=sysname
The system on which to activate the console.
FORCE Activate an MCS console even when it is being kept offline by a configuration manager.
ROUT=ALL, NONE, or rtcode
The routing codes of messages the console(s) can receive.
UD={Y or N} Whether the specified console can receive undelivered messages.
MVS System Commands Syntax 141
VARY Command
V (conspec[,conspec]...),{OFFLINE}
{ONLINE }
Description:
Place a secondary console online or offline.
conspec
[/]devnum The device number of the console.
O-[/]devnum The device number of the console preceded by the literal O- to designate a device with output-only
capability.
nnnnnnnn The name of the console device as specified in the CONSOLxx SYS1.PARMLIB member CONSOLE
statement.
O-nnnnnnnn The name of the console device as specified in the CONSOLxx SYS1.PARMLIB member CONSOLE
statement preceded by the literal O- and designates an output-only device.
[/]lowdevnum-[/]highdevnum
The device numbers that are the lower and upper bounds of a range of devices.
ONLINE The system is to bring the specified device(s) online.
OFFLINE The system is to take the specified device(s) offline.
V {conspec2|(conspec2[,conspec2]...)},CONSOLE
[,ALTCONS=conspec2]
[,AROUT=(rtcode[,rtcode]...)]
[,AUTH={ALL|MASTER|INFO|([SYS][,IO][,CONS])}]
[,DROUT=(rtcode[,rtcode]...)]
[,ROUT={ALL|NONE|(rtcode[,rtcode]...)}]
Description:
Assign and control MCS consoles.
conspec2 One of the following:
[/]devnum The device number of the device.
O-[/]devnum The device number preceded by the literal O- to designate a device with output-only capability.
nnnnnnnn The name of the console device.
O-nnnnnnnn
The name of the console device as specified in the preceded by the literal O- and designates an
output-only device.
CONSOLE The unit is to be an active console.
AUTH=MASTER, ALL, INFO or (SYS, IO, CONS)
The system command groups that the console is authorized to enter. Enter them in any order. The system
accepts this parameter only from the master console.
ROUT=ALL, NONE, or rtcode
The routing codes of messages the console(s) can receive.
AROUT=rtcode
The system is to add the specified routing code(s) or the routing codes in the specified range(s) to the routing
codes already defined for the console.
DROUT=rtcode
The system is to remove the specified routing code(s) or the routing codes in the specified range(s) from the
routing codes already defined for the console.
ALTCONS=conspec2
The device number or name of the alternate console.
142 OS/390 V2R8.0 MVS System Commands Summary
VARY Command
V {[/]devnum},MSTCONS
{conname }
Description:
Change the master console.
[/]devnum The device number of the device the system is to assign as the master console.
conname The name of the device the system is to assign as the master console.
MSTCONS The system is to switch the master console.
V [[/]devnum],HARDCPY[,CMDS|,NOCMDS|,STCMDS|,INCMDS]
|conname [,AROUT=(rtcode[,rtcode]...)]
|SYSLOG [,DROUT=(rtcode[,rtcode]...)]
|OPERLOG [,ROUT={ALL|NONE }]
{(rtcode[,rtcode]...)}
[,UD={Y|N} ]
[,OFF]
Description:
Control the hardcopy message set and the hardcopy medium.
[/]devnum The device number of the device the system is to assign as the master console.
conname The name of a printer console that is to become the hardcopy medium.
SYSLOG The system log is to become the hardcopy medium.
OPERLOG The operations log to activate or deactivate.
HARDCPY The system is to change the status of the hardcopy medium or the hardcopy message set, or both, depending on
the options specified.
NOCMDS The system is not to include operator commands or their responses in the hardcopy message set.
INCMDS The system is to include operator commands and their responses, excluding any status displays, in the hardcopy
message set.
STCMDS The system is to include operator commands and their responses, including static status displays, in the hardcopy
message set.
CMDS The system is to include all operator commands and their responses, including status displays (both static and
dynamic), in the hardcopy message set.
OFF The system is to stop the hardcopy medium; that is, the hardcopy medium no longer receives the hardcopy
message set. If you specify conname, devnum, or SYSLOG, you must specify the currently active hardcopy
medium. When OFF is specified, it must be the last parameter.
ROUT={ALL or NONE or rtcode or rtcode-rtcode}
The routing codes that the system is to use to select messages for the hardcopy message set.
AROUT={rtcode or rtcode-rtcode}
The system is to include messages with the specified routing code or codes in the hardcopy message set, in
addition to any messages included because of prior routing code specifications.
DROUT={rtcode or rtcode-rtcode}
The system is to stop including messages with the specified routing code or codes in the hardcopy message set.
UD={Y or N} Indicate whether UD messages (those with descriptor codes 1, 2, 3, 11, or 12, and WTORs) that are not received
by another console are to be delivered to the system console (for those processor models that support a system
console).
MVS System Commands Syntax 143
VARY Command
V {(devspec[,devspec]...)},{[AUTOSWITCH|AS][,ON|OFF]}
Description:
Turn on or off the AUTOSWITCH attribute of a tape device.
devspec One of the following:
[/]devnum The device number of a 3480 or 3490 tape drive.
[/]lowdevnum-[/]highdevnum
The device numbers of the lower and upper bounds of a range of devices.
AUTOSWITCH or AS
The system is to turn on or off the AUTOSWITCH attribute of the tape device or range of tape devices you
specified.
ON The system is to turn on the AUTOSWITCH attribute for the device or devices.
OFF The system is to turn off the AUTOSWITCH attribute for the device or devices.
V {(devspec[,devspec]...)},{ONLINE[,UNCOND][,FORCE]}
{devspec } { |,SHR }
{ |,RESET }
{ }
{OFFLINE[,FORCE] }
Description:
Place an I/O device or range of devices online or offline.
devspec One of the following:
[/]devnum The device number.
O-devnum The device number preceded by the literal O- to designate a device with output-only capability.
nnnnnnnn The name of the console device.
O-nnnnnnnn
The name of the console device as specified in the preceded by the literal O- to designate an
output-only device.
[/]lowdevnum-[/]highdevnum
The device numbers of the lower and upper bounds of a range of devices.
ONLINE,FORCE
The system is to put the specified device(s) or range(s) of devices online, even if they are being kept offline by a
configuration manager.
ONLINE,SHR
The system permits the 3480 you bring online to be shared among other processors.
ONLINE,RESET
The system is to bring online a device that is being kept offline because of a control-unit-initiated reconfiguration
(C.U.I.R.).
ONLINE,UNCOND
The system is to bring the specified device(s) or range(s) of devices online, even if there are no paths to the
devices or the devices are pending offline and boxed.
OFFLINE,FORCE
The system is to put the specified device(s) or range(s) of devices immediately in pending-offline status, even if
they are currently active, allocated, or reserved.
144 OS/390 V2R8.0 MVS System Commands Summary
VARY Command
V GRS{({sysname||ALL}),{RESTART|R}}
{ }
{({sysname|}),{QUIESCE|Q} }
{ }
{(sysname),{PURGE|P} }
Description:
Control a global resource serialization ring complex.
sysname The name of the system (specified on the SYSNAME system parameter).
* The name of the current system (the system on which you enter the command).
ALL You want to change the status of all systems in the global resource serialization ring.
RESTART or R
You want to restore a quiesced (or inactive) system to the global resource serialization ring or rebuild a global
resource serialization ring that has been disrupted (when rebuilding a disrupted ring, you can specify ALL with
RESTART).
QUIESCE or Q
You want to temporarily remove a system from the global resource serialization ring.
PURGE or P
You want to remove a quiesced system from the global resource serialization complex.
MVS System Commands Syntax 145
VARY Command
V PATH
{([/]devnum,chp[,[/]devnum,chp]...) }
{ }
{(([/]devnum[,[/]devnum]...),chp }
{ [,([/]devnum[,[/]devnum]...),chp]...) }
{ }
{(([/]lowdevnum-[/]highdevnum],[/]lowdevnum-[/]highdevnum]...),chp }
{ [,([/]lowdevnum-[/]highdevnum[),chp]...) }
{ }
{(cfname,chp[,cfname,chp]...) }
{ }
{((cfname[,cfname]...),chp }
{ [,(cfname[,cfname]...),chp]...) }
{,ONLINE[,FORCE] }
{,OFFLINE[,UNCOND]}
Description:
Place an I/O path or paths online or offline.
PATH The system is to move the specified path(s) online or offline.
[/]devnum The device number of a device associated with the path the system is to move online or offline.
cfname The name of a coupling facility associated with path(s) the system is to logically move online or
offline.
chp The channel path associated with the path(s) the system is to move online or offline.
ONLINE,FORCE
The system is to bring the path back online that had been taken offline by the control unit initiated reconfiguration
(C.U.I.R.) service.
OFFLINE,UNCOND
The system is to take the path offline. The system rejects the VARY PATH,OFFLINE,UNCOND command if the
specified path is the last available path to a device that is any one of the following:
Allocated
In use by the system
A console
Assigned to JES3
146 OS/390 V2R8.0 MVS System Commands Summary
VARY Command
V SMS,{CFCACHE(cachename),{ENABLE|E } }
{ {QUIESCE|Q} }
{CFVOL(volid),{ENABLE|E } }
{ {QUIESCE|Q} }
{MONDS(dsname[,dsname...]),{ON|OFF} }
{SHCDS(shcdsname),{NEW } }
{ {NEWSPARE} }
{ {DELETE } }
{SMSVSAM,{ACTIVE }
{ {SPHERE(spherename),{ENABLE|E}}
{ {FALLBACK }
{ {TERMINATESERVER }
{ {FORCEDELETELOCKSTRUCTURE }
Description:
Change the state of coupling facility cache structures and volumes over a sysplex wide scope.
SMS,CFCACHE
The name of the cache structure whose state you want to change.
CFVOL The id of the volume whose state you want to change.
MONDS The names of data sets eligible (ON) or ineligible (OFF) for coupling facility statistical monitoring.
SHCDS The name of a sharing control data set to add or delete.
SMSVSAM Actions to manage SMSVSAM data sets or the SMSVSAM server.
V SMS,{DRIVE|DRI|LIBRARY|LIB}(name),{ONLINE|ON }
{OFFLINE|OFF}
Description:
Place an optical drive or optical library online or offline.
DRIVE(name) or DRI(name)
The name of the optical drive to vary online or offline.
LIBRARY(name) or LIB(name)
The name of the optical library to vary online or offline.
ONLINE or ON
Specify that the drive or library be varied on.
OFFLINE or OFF
Specify that the drive or library be varied off.
MVS System Commands Syntax 147
VARY Command
V SMS,{LIBRARY}(name[,{systemid[,systemid]...}]),{ONLINE|ON }
{LIB } {ALL } {OFFLINE|OFF}
{ }
Description:
Place a system-managed tape library online or offline.
LIBRARY(name) or LIB(name)
The name of the system-managed tape library to place online or offline.
systemid Place online or offline the named system-managed tape library connected to each specified MVS system within the
SMS complex. If the library is not connected to a specified MVS system, it issues an error message.
ALL Place online or offline the named system-managed tape library connected to all MVS systems in the SMS complex.
To specify a system named ALL enclose the name in parentheses, as in (ALL).
* Place online or offline the system-managed tape library connected to the system from which the VARY SMS
command is issued.
ONLINE or ON
Specify that the system-managed tape library is to be brought online.
OFFLINE or OFF
Specify that the system-managed tape library is to be taken offline. When a library is taken offline, all devices in
that library that are not already offline are taken offline.
V SMS,{{STORGRP|SG}(storgrp,[|ALL|system[,system]...])},{QUIESCE|Q}[,NEW|,N]
{ } {ENABLE|E }
{{VOLUME|VOL}(volume,[|ALL|system[,system]...]) } {DISABLE|D}[,NEW|,N]
Description:
Change the SMS status of a storage group.
STORGRP or SG(storgrp[,system,...])
Identify the storage group and, optionally, the system or system group that the SMS status change is to affect. If
you omit system or specify an *, the command affects only the system on which you issue the command. If you
specify ALL, the command affects all systems or system groups in the complex.
VOLUME or VOL(volume[,system,...])
Identify the volume and, optionally, the system that the SMS status change is to affect. If you omit system or
specify an *, the command affects only the system on which you issue the command. If you specify ALL, the
command affects all systems in the complex.
ENABLE or E
SMS is to permit allocation of new and old data sets from the specified storage group or volume on the designated
system(s).
QUIESCE or Q[,NEW or N]
For QUIESCE, a JES3 system prevents the scheduling of jobs that create new data sets or accessing existing data
sets from the specified storage group or volume.
DISABLE or D[,NEW or N]
For DISABLE, SMS is not to allow allocation or accessing of existing data sets in the specified storage group or
volume for a new data set.
148 OS/390 V2R8.0 MVS System Commands Summary
VARY Command
V WLM,APPLENV=applenvname,{REFRESH}
{QUIESCE|Q}
{RESUME}
Description:
Control an application environment. This command has a sysplex scope.
WLM,APPLENV=applenvname
The 1 to 32 character name of the application environment.
REFRESH Terminate the server address spaces for an application environment and start new ones in their places.
QUIESCE|Q Terminate the server address spaces for an application environment. Queue, but do not select work requests for
the application environment.
RESUME Restart the server address spaces for an application environment. Queued work requests are eligible for selection.
V WLM,POLICY=policyname[,REFRESH]
Description:
Activate a workload management service policy for a sysplex.
WLM,POLICY=policyname
The 1 to 8 character name of the service policy to activate.
REFRESH Specify that WLM is to discard historical workload characterization data and then reset and activate the named
policy and start data collection anew.
Note: Use REFRESH only when directed to do so by IBM Level 2 personnel.
V XCF{,systemname},{OFFLINE|OFF}[,RETAIN={YES|NO}][,FORCE]
Description:
XCF,systemname,OFFLINE or OFF
The name of a system that XCF is to remove from the sysplex.
RETAIN={YES or NO}
Indicate whether or not XCF, on the remaining systems in the sysplex, is to retain the signalling path resources
used to communicate with the system that is removed.
FORCE Indicate that XCF will immediately remove the specified system from the sysplex.
MVS System Commands Syntax 149
WRITELOG Command
WRITELOG Command (W)
WRITELOG or W
W [class|CLOSE|START]
Description:
Control the system log.
class The output class to use when printing the contents of the system log.
CLOSE Close the system log and discontinue the log function. This command is rejected if the log is the hardcopy medium.
START Restart the system log.
150 OS/390 V2R8.0 MVS System Commands Summary

Appendix A. Notices
This information was developed for products and services offered in the U.S.A.
IBM may not offer the products, services, or features discussed in this document in
other countries. Consult your local IBM representative for information on the products
and services currently available in your area. Any reference to an IBM product,
program, or service is not intended to state or imply that only that IBM product,
program, or service may be used. Any functionally equivalent product, program, or
service that does not infringe any IBM intellectual property right may be used instead.
However, it is the user's responsibility to evaluate and verify the operation of any
non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter described
in this document. The furnishing of this document does not give you any license to
these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
USA
For license inquiries regarding double-byte (DBCS) information, contact the IBM
Intellectual Property Department in your country or send inquiries, in writing, to:
IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan
The following paragraph does not apply to the United Kingdom or any other
country where such provisions are inconsistent with local law: INTERNATIONAL
BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS"
WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING,
BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT,
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do
not allow disclaimer of express or implied warranties in certain transactions, therefore,
this statement may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes
are periodically made to the information herein; these changes will be incorporated in
new editions of the publication. IBM may make improvements and/or changes in the
product(s) and/or the program(s) described in this publication at any time without notice.
Any references in this information to non-IBM Web sites are provided for convenience
only and do not in any manner serve as an endorsement of those Web sites. The
Copyright IBM Corp. 1988, 1999 151
materials at those Web sites are not part of the materials for this IBM product and use
of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it believes
appropriate without incurring any obligation to you.
Licensees of this program who wish to have information about it for the purpose of
enabling: (i) the exchange of information between independently created programs and
other programs (including this one) and (ii) the mutual use of the information which has
been exchanged, should contact:
IBM Corporation
Mail Station P300
522 South Road
Poughkeepsie, NY 12601-5400
U.S.A
Such information may be available, subject to appropriate terms and conditions,
including in some cases, payment of a fee.
The licensed program described in this information and all licensed material available
for it are provided by IBM under terms of the IBM Customer Agreement, IBM
International Program License Agreement, or any equivalent agreement between us.
If you are viewing this information softcopy, the photographs and color illustrations may
not appear.
152 OS/390 V2R8.0 MVS System Commands Summary
Trademarks
The following terms are trademarks of the IBM Corporation in the United States and/or
other countries:
AnyNet
AD/Cycle
AFP
BatchPipeWorks
BookManager
BookMaster
C++/MVS
C/MVS
C/370
CBIPO
CICS
CICS OS/2
CICS/ESA
CICSPlex
DB2
DFS
DFSMS
DFSMS/MVS
DFSMSdfp
DFSMSdss
DFSMShsm
DFSMSrmm
DFSORT
Enterprise Systems Architecture/370
Extended Services
ESA/370
ESA/390
ESCON
FFST
FFST/MVS
GDDM
Hardware Configuration Definition
Hiperbatch
IBM
IBMLink
IMS
IMS/ESA
Language Environment
MVS/DFP
MVS/ESA
NetView
Open Class
OPC
OS/2
OS/390
OS/390 EZ Application Enabling Technology
Parallel Sysplex
PR/SM
PSF
Resource Measurement Facility
RACF
RETAIN
RMF
S/390
System/390
SystemView
SAA
SOM
SOMobjects
SP
VisualLift
VM/ESA
VSE/ESA
VTAM

UNIX is a registered trademark in the United States and other countries licensed
exclusively through X/Open Company Limited.
Other company, product, or service names may be trademarks or service marks of
others.
Appendix A. Notices 153
Communicating Your Comments to IBM
OS/390
MVS System Commands Summary
Publication No. GX22-0040-07
If you especially like or dislike anything about this book, please use one of the methods
listed below to send your comments to IBM. Whichever method you choose, make
sure you send your name, address, and telephone number if you would like a reply.
Feel free to comment on specific errors or omissions, accuracy, organization, subject
matter, or completeness of this book. However, the comments you send should pertain
to only the information in this manual and the way in which the information is
presented. To request additional publications, or to ask questions or make comments
about the functions of IBM products or systems, you should talk to your IBM
representative or to your IBM authorized remarketer.
When you send comments to IBM, you grant IBM a nonexclusive right to use or
distribute your comments in any way it believes appropriate without incurring any
obligation to you.
If you are mailing a reader's comment form (RCF) from a country other than the United
States, you can give the RCF to the local IBM branch office or IBM representative for
postage-paid mailing.
If you prefer to send comments by mail, use the RCF at the back of this book.
If you prefer to send comments by FAX, use this number:
FAX: (International Access Code)+1+914+432-9405
If you prefer to send comments electronically, use one of these network IDs:
IBM Mail Exchange: USIB6TC9 at IBMMAIL
Internet e-mail: mhvrcfs@us.ibm.com
World Wide Web: http://www.ibm.com/s390/os390/
Make sure to include the following in your note:
Title and publication number of this book
Page number or topic to which your comment applies
Optionally, if you include your telephone number, we will be able to respond to your
comments by phone.

Reader's Comments We'd Like to Hear from You
OS/390
MVS System Commands Summary
Publication No. GX22-0040-07
You may use this form to communicate your comments about this publication, its organization, or
subject matter, with the understanding that IBM may use or distribute whatever information you supply
in any way it believes appropriate without incurring any obligation to you. Your comments will be sent
to the author's department for whatever review and action, if any, are deemed appropriate.
Note: Copies of IBM publications are not stocked at the location to which this form is addressed.
Please direct any requests for copies of publications, or for assistance in using your IBM system, to
your IBM representative or to the IBM branch office serving your locality.
Today's date:
What is your occupation?
Newsletter number of latest Technical Newsletter (if any) concerning this publication:
How did you use this publication?
Is there anything you especially like or dislike about the organization, presentation, or writing in this
manual? Helpful comments include general usefulness of the book; possible additions, deletions, and
clarifications; specific errors and omissions.
Page Number: Comment:
Name Address
Company or Organization
Phone No.
[ ] As an introduction [ ] As a text (student)
[ ] As a reference manual [ ] As a text (instructor)
[ ] For another purpose (explain)


Cut or Fold
Along Line
Cut or Fold
Along Line
Reader's Comments We'd Like to Hear from You
GX22-0040-07
IBM
Fold and Tape Please do not staple Fold and Tape
NO POSTAGE
NECESSARY
IF MAILED IN THE
UNITED STATES
BUSINESS REPLY MAIL
FIRST-CLASS MAIL PERMIT NO. 40 ARMONK, NEW YORK
POSTAGE WILL BE PAID BY ADDRESSEE
IBM Corporation
Department 55JA, Mail Station P384
522 South Road
Poughkeepsie NY 12601-5400
Fold and Tape Please do not staple Fold and Tape
GX22-0040-07


IBM
Program Number: 5647-A01
Printed in the United States of America
on recycled paper containing 10%
recovered post-consumer fiber.
GX22-4-7