z/OSVersion 2 Release 3

JES2 Commands

IBM

SA32-0990-30

Note

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

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

Last updated: 2019-02-16© Copyright International Business Machines Corporation 1997, 2017.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract withIBM Corp.

Contents

List of Figures....................................................................................................... xiList of Tables.......................................................................................................xiii

About this document............................................................................................xvWho should use this document..................................................................................................................xvWhere to find more information................................................................................................................. xvAdditional information................................................................................................................................xv

How to send your comments to IBM.................................................................... xviiIf you have a technical problem............................................................................................................... xvii

Summary of changes......................................................................................... xviiiSummary of changes for z/OS Version 2 Release 3 (V2R3)................................................................... xviiiSummary of changes for z/OS Version 2 Release 2 (V2R2) as updated December, 2015.......................xxSummary of changes for z/OS Version 2 Release 2 (V2R2)..................................................................... xxiz/OS Version 2 Release 1 summary of changes......................................................................................xxiii

Chapter 1. Controlling JES2................................................................................... 1Controlling the JES2 environment...............................................................................................................5

Specifying the Start Options...................................................................................................................6Displaying JES2 status......................................................................................................................... 11Restarting JES2.................................................................................................................................... 11Stopping JES2...................................................................................................................................... 14Withdrawing JES2 from the system.....................................................................................................14Specifying JES2 exit point characteristics...........................................................................................15Monitoring buffers................................................................................................................................ 15

Controlling your MAS environment............................................................................................................15Using independent–mode processing................................................................................................. 16Displaying MAS status and settings.....................................................................................................16Using JES2 and MVS commands together...........................................................................................16Changing MAS settings.........................................................................................................................17Making jobs eligible to restart..............................................................................................................18

Controlling automatic command processing............................................................................................ 19Controlling JES2 diagnostics..................................................................................................................... 19

Controlling JES2 tracing.......................................................................................................................19Recovering from errors.........................................................................................................................20Debugging errors.................................................................................................................................. 23Displaying module information............................................................................................................23

Controlling JES2 spooling..........................................................................................................................24Spool addressing modes......................................................................................................................24Considerations for draining a spool volume........................................................................................ 24Controlling spool partitioning...............................................................................................................24Spool volume states............................................................................................................................. 24

Migrating spool volumes............................................................................................................................26Spool migration terms..........................................................................................................................26Spool migration phases........................................................................................................................27MAS migration restrictions...................................................................................................................28Moving and merging spool volumes.....................................................................................................28Calculating tracks................................................................................................................................. 30Allocating tracks...................................................................................................................................31

Chapter 2. Controlling JES2 devices and functional subsystems............................33

iii

Device overview......................................................................................................................................... 41Controlling the device environment.....................................................................................................43

JES2 input processing............................................................................................................................... 43Controlling readers...............................................................................................................................43

JES2 output processing.............................................................................................................................44Controlling printers.............................................................................................................................. 45Controlling punches............................................................................................................................. 46

Remote job entry (RJE)..............................................................................................................................47Specifying JES2 teleprocessing characteristics..................................................................................47Remote entry restrictions.................................................................................................................... 48

Controlling spool offload and reload functions.........................................................................................55Controlling offload devices.................................................................................................................. 55Controlling offload transmitters and receivers....................................................................................56

Chapter 3. Controlling jobs and output................................................................. 59Controlling jobs.......................................................................................................................................... 65

Controlling the scope of commands.................................................................................................... 65Using the JOBCORR parameter........................................................................................................... 65Displaying job information................................................................................................................... 66

Controlling job execution...........................................................................................................................68Controlling JES2 initiators....................................................................................................................68Controlling WLM initiators....................................................................................................................70Specifying JES2 job characteristics..................................................................................................... 70JES2 job execution commands............................................................................................................71Holding and releasing jobs...................................................................................................................72Controlling jobs at another node..........................................................................................................72

Controlling job output................................................................................................................................ 73Specifying job output characteristics.................................................................................................. 73JES2 job output commands................................................................................................................. 77Controlling output groups and job output elements........................................................................... 78

Chapter 4. Controlling a network..........................................................................79Controlling the NJE environment.............................................................................................................. 83Specifying node characteristics.................................................................................................................84

Modifying transmission delays and excessive looping through a network.........................................84Modifying sign-on tolerance.................................................................................................................84Defining a symbolic destination name.................................................................................................84Deleting a symbolic destination name.................................................................................................84Displaying subnets and their paths across a network.........................................................................85Displaying node attributes................................................................................................................... 85Setting node attributes.........................................................................................................................85

Starting NJE communications................................................................................................................... 86Starting node communication on a BSC line....................................................................................... 86Starting node communication using SNA/VTAM................................................................................. 87Starting node communication using TCP/IP........................................................................................88Controlling the JES2/VTAM interface.................................................................................................. 88Controlling the JES2-TCP/IP interface.................................................................................................89Defining and changing applications..................................................................................................... 89

Controlling NJE lines..................................................................................................................................89Controlling NJE static connections........................................................................................................... 90Controlling JES2 transmitting and receiving devices............................................................................... 91Sending messages and commands through the network.........................................................................92

Displaying and controlling jobs at other nodes................................................................................... 92

Chapter 5. Command reference section................................................................ 93Command descriptions..............................................................................................................................93

Command syntax conventions.............................................................................................................93

iv

How to read syntax diagrams............................................................................................................ 111Keywords defined...............................................................................................................................113

$A A - Release all jobs............................................................................................................................. 114$A Group - Release job group................................................................................................................. 115$A Job - Release held jobs...................................................................................................................... 120$ACTIVATE - Activate a particular level of JES2 function...................................................................... 127$ADD APPL - Define a VTAM application to JES2................................................................................... 129$ADD CONNECT - Dynamically add network connections..................................................................... 131$ADD DESTID - Define a symbolic destination.......................................................................................134$ADD FSS - Define a functional subsystem............................................................................................ 138$ADD JOBCLASS(jobclass) - Define a new job class .............................................................................139$ADD LINE(nnnn) - Add line....................................................................................................................148$ADD LOADMOD - Load a new Installation Load Module.......................................................................153$ADD LOGON(nn) - Add a logon..............................................................................................................155$ADD NETSRV(nnn) - Add a network server...........................................................................................156$ADD PROCLIB(xxxxxxxx) - Define a new dynamic PROCLIB concatenation....................................... 159$ADD PRT(nnnnn) - Define a local printer.............................................................................................. 161$ADD REDIRECT - Set redirection for commands..................................................................................173$ADD RMT(nnnnn) - Add an RJE workstation.........................................................................................176$ADD SOCKET(xxxxxxxx) - Add a socket................................................................................................184$ADD SRVCLASS(name) - Add a new permanent service class element.............................................. 186$B PRT(nnnnn) and $B R(nnnnn).PR(m) - Logically backspace printer output..................................... 188$B PUN(nn) and $B R(nnnnn).PU(m) - Logically backspace punch output........................................... 190$C A - Cancel automatic commands.......................................................................................................191$C Group - Cancel a job group.................................................................................................................192$C Job - Cancel a job............................................................................................................................... 199$C Lnnnn.xxn - Cancel NJE device activity............................................................................................. 209$C O Group - Cancel output.................................................................................................................... 210$C O Job - Cancel output.........................................................................................................................215$C OFFn.JR - Cancel a spool offload transmitter/receiver.....................................................................223$C PRT(nnnnn) and $C R(nnnnn).PR(m) - Cancel printer output...........................................................224$C PUN(nn) and $C R(nnnnn).PU(m) - Cancel punch output................................................................. 225$C RDR and $C Rnnnn.RDm - Cancel reader activity............................................................................. 226$D A - Display information about currently active jobs..........................................................................227$D ACTIVATE - Display current JES2 checkpoint level and MAS readiness for checkpoint

activation to Z22 level........................................................................................................................ 230$D ACTRMT - Display Active RJE Workstations in a MAS.......................................................................232$D APPL - Display JES2 SNA NJE applications.......................................................................................234$D BUFDEF - Display JES2 buffer definitions.........................................................................................237$D CKPTDEF - Display the checkpoint definition................................................................................... 238$D CKPTSPACE - Display checkpoint spaces......................................................................................... 242$D CLASSGRP - Display class groups..................................................................................................... 247$D COMPACT - Display JES2 compaction tables....................................................................................248$D CONDEF - Display console communication characteristics............................................................. 249$D CONNECT - Display network connections ........................................................................................ 251$D DEBUG - Display the JES2 DEBUG option......................................................................................... 255$D DESTDEF - Display symbolic destination settings ............................................................................257$D DEStid - Display a JES2 symbolic destination...................................................................................258$D DUPJOB - Display counts of duplicate jobs.......................................................................................260$D ESTBYTE - Display Number of Bytes Set for Jobs and their Output.................................................262$D ESTLNCT - Display number of lines for jobs and their output.......................................................... 263$D ESTPAGE - Display number of pages set for jobs and their output.................................................. 264$D ESTPUN - Display number of punch pages set for jobs and their output.........................................265$D ESTIME - Display amount of time set for jobs and their output....................................................... 266$D EXIT - Display current characteristics of specified JES2 exit points................................................267$D F - Display the job output forms queue............................................................................................. 271$D FSS - Display the characteristics of the specified functional subsystems....................................... 274$D GROUP - Display information about specified groups...................................................................... 276

v

$D GRPDEF - Display characteristics assigned to job groups................................................................ 293$D INITDEF - Display the number of logical initiators currently defined.............................................. 294$D INITINFO - Display initialization information ...................................................................................295$D INPUTDEF - Display options controlling JES2 input processing...................................................... 296$D I[nnmm] - Display initiator information.............................................................................................297$D INTRDR - Display the current INTRDR initialization statement characteristics.............................. 301$D JECLDEF - Display options controlling processing of JECL statements........................................... 303$D JES2 - Display the current activity in the JES2 address space.........................................................305$D Job - Display information about specified jobs.................................................................................307$D JOBCLASS(n) - Display job class characteristics.............................................................................. 322$D JOBDEF - Display characteristics assigned to jobs...........................................................................331$D JOBPRTY - Display Current Job Priority Characteristics...................................................................334$D L(nnnn).JR(n) - Display line and job receiver status......................................................................... 335$D L(nnnn).JT(n) - Display the job transmitter status............................................................................ 338$D L(nnnn).SR(n) - Display SYSOUT receiver status...............................................................................340$D L(nnnn).ST(n) - Display SYSOUT transmitter status..........................................................................343$D LIMITS(nnnnn) - Display resource limits...........................................................................................345$D LINE(nnnnn) - Display a line.............................................................................................................. 352$D LOADmod(jxxxxxxx) - Display load module information.................................................................. 358$D LOGON(nnn) - Display the status of JES2/VTAM interface(s) and their characteristics.................. 363$D M - Send a message........................................................................................................................... 365$D MASDEF - Display the multi-access spool environment...................................................................369$D MEMBer - Display information about MAS members........................................................................373$D MODule(jxxxxxxx) - Display assembled module information...........................................................379$D N - Display job queue information..................................................................................................... 386$D NETACCT - Display networking account numbers............................................................................ 391$D NETSRV(nnnnn) - Display a network server...................................................................................... 393$D NETWORK - Display network activity................................................................................................ 397$D NJEDEF - Display the JES2 Network Environment........................................................................... 398$D NODE(jnnnnnnn) - Display the characteristics of a node................................................................. 400$D O Group - Display output characteristics.......................................................................................... 406$D O Job - Display output characteristics.............................................................................................. 413$D OFF(n).JR - Display offload job receiver............................................................................................424$D OFF(n).JT - Display offload job transmitter.......................................................................................428$D OFF(n).SR - Display offload SYSOUT receiver................................................................................... 432$D OFFn.ST - Display offload SYSOUT transmitter.................................................................................441$D OFFLOAD - Display offload devices................................................................................................... 447$D OPTsdef - Display start options processing definitions.................................................................... 451$D OUTCLASS(n) - Display output classes............................................................................................. 452$D OUTDEF - Display output definition options..................................................................................... 454$D OUTPRTY - Display job output priority.............................................................................................. 458$D PATH - Display paths from node to node...........................................................................................459$D PCE - Display status for JES2 processors .........................................................................................461$D PCEDEF - Display PCE definitions......................................................................................................469$D PRINTDEF - Display print environment characteristics....................................................................470$D PROCLIB(xxxxxxxx) - Display a PROCLIB concatenation................................................................. 472$D PRT(nnnnn) and $D R(nnnnn).PR(m) - Display printers....................................................................475$D PUNCHDEF - Display punch environment characteristics................................................................ 484$D PUN(nn) and $D R(nnnnn).PU(m) - Display a remote punch............................................................ 485$D Q - Display the number of jobs queued............................................................................................. 489$D R(nn).CON(mm) - Display the specified remote console.................................................................. 494$D RDI - Display the status of JES2-controlled internal reader............................................................ 496$D RDR(nn) and $D R(nn).RD(mm) - Display command authority for a reader.....................................499$D REBLD - Display rebuild queue information......................................................................................505$D RECVopts - Display current RECVOPTS settings...............................................................................506$D REDIRect - Redirect command responses........................................................................................507$D REQJOBID - Display attributes of JOBID address spaces................................................................510$D SMFDEF - Display status of SMF buffers........................................................................................... 511

vi

$D SOCKET (xxxxxxxx) - Display the characteristics of a socket...........................................................512$D SPOOL - Display the status of spool volumes................................................................................... 515$D SPOOLDEF - Display the JES2 spooling environment.......................................................................523$D SRVCLASS(name) - Display JES2 information for the specified service class................................. 527$D SSI(nnn) - Display subsystem interface function information..........................................................529$D SUBTDEF - Display subtask definitions.............................................................................................531$D SUBNET - Display subnet connections..............................................................................................531$D TPDEF - Display current teleprocessing characteristics...................................................................532$D TRace(nnn) - Display current status of trace IDs..............................................................................535$D TRACEDEF - Display current trace environment characteristics......................................................537$D U - Display the status of JES2-controlled devices............................................................................ 539$DEL CONNect - Delete network connections .......................................................................................544$DEL DEStid - Delete a symbolic destination......................................................................................... 546$DEL JOBCLASS(jobclass) - Delete a job class...................................................................................... 547$DEL LOADmod - Remove a load module from storage......................................................................... 548$DEL PROCLIB(xxxxxxxx) - Delete a dynamic PROCLIB concatenation................................................550$E CKPTLOCK - Reset the checkpoint lock.............................................................................................553$E Job - Restart a job.............................................................................................................................. 555$E Lnnnn.xxn - Restart NJE device activity............................................................................................ 561$E LINE(nnnnn) - Restart line activity.....................................................................................................562$E LOGON(nn) - Restart the JES2/VTAM interface.................................................................................564$E MEMBer - Perform cleanup for a failed MAS member...................................................................... 565$E NETSRV(nnn) - Restart a network server...........................................................................................568$E NETWORK - Reset current network devices......................................................................................570$E OFFn.xx - Restart a spool offload transmitter................................................................................... 570$E PRT(nnnnn) and $E R(nnnnn).PR(m) - Restart printer activity......................................................... 572$E PUN(nn) and $E R(nnnnn).PU(m) - Restart punch activity................................................................573$F PRT(nnnnn) and $F R(nnnnn).PR(m) - Logically advance printer output......................................... 574$F PUN(nn) and $F R(nnnnn).PU(m) - Logically advance punch output................................................576$G A - Release a job at another node......................................................................................................577$G C - Cancel a job at another node........................................................................................................579$G D - Display job information for a job at another node....................................................................... 581$G H - Hold a job at another node...........................................................................................................583$G R, OUT - Request another node to route job output......................................................................... 584$G R, XEQ - Request another node to route a job for execution............................................................ 587$H A - Hold all jobs.................................................................................................................................. 589$H Group - Hold job groups.....................................................................................................................590$H Job - Hold specific jobs......................................................................................................................595$I PRT(nnnnn) and $I R(nnnnn).PR(m) - Interrupt printer activity........................................................601$I PUN(nn) and $I R(nnnnn).PU(m) - Interrupt punch activity..............................................................603$JDDETAILS - Display details summary of jobs..................................................................................... 604$JDHISTORY - Display history of JES2 resource usage......................................................................... 606$JDJES - Display non-severe incident report......................................................................................... 610$JDMONITOR - Display current status of JES2 monitor subtasks.........................................................611$JDSTATUS - Display current status....................................................................................................... 612$JSTOP - Terminate monitor address space.......................................................................................... 614$L Job - List job output information........................................................................................................615$Mnn - Send commands to other MAS members...................................................................................619$MSPL - Migrate spool volumes..............................................................................................................620$Nnnnn - Send commands through the network................................................................................... 624$N PRT(nnnnn) and $N R(nnnnn).PR(m) - Repeat printer output..........................................................626$N PUN(nn) and $N R(nnnnn).PU(m) - Repeat punch output................................................................627$O Job - Release or cancel held output groups......................................................................................628$P Group - Purge a job group.................................................................................................................. 634$P - Stop JES2 processing...................................................................................................................... 640$P I[nnmm] - Stop an initiator.................................................................................................................641$P JES2 - Withdraw JES2 from the system............................................................................................ 644$P Job - Purge a job.................................................................................................................................647

vii

$P Lnnnn.xxn - Stop an NJE device.........................................................................................................656$P LINE(nnnnn) - Stop a line...................................................................................................................657$P LOGON(nnnnn) - Stop the JES2/VTAM interface...............................................................................658$P NETSRV(nnnnn) - Stop a network server...........................................................................................660$P O Group - Purge a job group's output................................................................................................ 662$P O Job - Purge a job's output...............................................................................................................668$P NETWORK - Purge current network devices......................................................................................676$P OFFn.xx - Stop an offload transmitter/receiver.................................................................................677$P OFFLOADn - Stop an offload device...................................................................................................678$P PRT(nnnnn) and $P R(nnnnn).PR(m) - Stop a printer....................................................................... 679$P PUN(nn) and $P R(nnnnn).PU(m) - Stop a punch..............................................................................680$P RDRnn and $P Rnnnn.RDm - Stop a reader.......................................................................................681$P RMT(nnnnn) - Terminate a remote terminal connection...................................................................682$P SPOOL - Drain a spool volume........................................................................................................... 683$P SRVCLASS(name) - Drain JES2 processing for a given service class............................................... 685$P TRace - Stop a trace ID...................................................................................................................... 686$P XEQ - Prevents JES2 and WLM-controlled initiators from selecting work....................................... 688$R - Route job output.............................................................................................................................. 689$R XEQ - Route specific jobs for execution.............................................................................................694$S - Start system activity.........................................................................................................................695$S A - Start automatic command processing......................................................................................... 696$S EDS - Request JES2 EDS to retry communication.............................................................................697$S I[vvvv] - Start an initiator....................................................................................................................698$S Job - Initiate a batch job into execution............................................................................................ 700$S Lnnnn.xxn - Start an NJE device........................................................................................................ 702$S LINE(nnnn) - Start a line.....................................................................................................................703$S LOGON - Start the JES2/VTAM interface........................................................................................... 705$S N - Start node communication on a BSC line.....................................................................................706$S N - Start node communication on an SNA line.................................................................................. 708$S N - Start node communication on a TCP/IP line................................................................................710$S NETSRV(nnn) - Start a network server ..............................................................................................711$S NETWORK - Start automatic device restart and NJE connection processing.................................. 713$S OFFn.xx - Start offload transmitters and receivers........................................................................... 713$S OFFLOADn - Start an offload device.................................................................................................. 715$S PRT(nnnnn) and $S R(nnnnn).PR(m) - Start a printer....................................................................... 716$S PUN(nn) and $S R(nnnnn).PU(m) - Start a punch..............................................................................717$S RDRnn and $Rnnnn.RDm - Start a reader......................................................................................... 718$S RMT(nnnnn) - Automatically connect a remote terminal..................................................................719$S SPOOL - Start a spool volume............................................................................................................ 720$S SRVCLASS - Start JES2 processing for a given service class............................................................ 724$S TRACE(nn) - Start a trace ID.............................................................................................................. 724$S XEQ - Allow JES2 and WLM-controlled initiators to select work...................................................... 726$T A - Display, specify, and modify automatic commands.....................................................................726$T APPL - Control JES2 applications...................................................................................................... 731$T BUFDEF - Control local buffers.......................................................................................................... 734$T CKPTDEF - Set the checkpoint definition.......................................................................................... 735$T CKPTSPACE - Set the checkpoint space............................................................................................ 744$T CONDEF - Set console communication characteristics.................................................................... 745$T CONNect - Change static network connections................................................................................ 748$T DEBUG - Set the JES2 DEBUG option................................................................................................ 750$T DESTDEF - Control JES2 symbolic destination displays................................................................... 753$T DEStid - Control a JES2 symbolic destination................................................................................... 754$T ESTBYTE - Control the default spool space utilization per job......................................................... 759$T ESTIME - Control the default execution time.................................................................................... 760$T ESTLNCT - Control the default print line count per job..................................................................... 761$T ESTPAGE - Control the default page count per job........................................................................... 762$T ESTPUN - Control the default punched card output per job............................................................. 764$T EXIT(nnn) - Control JES2 installation exit points.............................................................................. 765

viii

$T FSS - Control a functional subsystem................................................................................................ 768$T Group - Change the attributes of job groups..................................................................................... 770$T GRPDEF - Set job group processing characteristics..........................................................................777$T Init(nnmm) - Control initiators...........................................................................................................779$T INPUTDEF - Specify options controlling JES2 input processing.......................................................782$T INTRDR - Control internal readers.....................................................................................................783$T JECLDEF - Specify options controlling processing of JECL statements........................................... 788$T Job - Change a job's class, scheduling priority, or affinity................................................................ 790$T JOBCLASS - Set job class characteristics..........................................................................................800$T JOBDEF - Set job processing characteristics.................................................................................... 811$T JOBPRTY(n) - Set job scheduling characteristics..............................................................................817$T L(nn).JT(nn) - Specify network job transmitter characteristics........................................................ 818$T L(nnnn).ST(n) - Specify network SYSOUT transmitter characteristics............................................. 821$T LIMITS - Set the privilege support characteristics............................................................................825$T LINE(nnnnn) - Control a line.............................................................................................................. 827$T LOADmod - Refresh a load module from storage..............................................................................834$T LOGON(nnn) - Control the JES2/VTAM interface.............................................................................. 835$T MASDEF - Control the multi-access spool environment................................................................... 838$T MEMBer - Change a member's operational mode.............................................................................842$T NETSRV(nnnnn) - Modify the attributes of a network server............................................................ 846$T NJEDEF - Control JES2 network environment.................................................................................. 849$T NODE(jnnnnnnn) - Set the characteristics of a node........................................................................ 853$T NUM - Set the JES2 internal job numbers......................................................................................... 863$T O Group - Set output characteristics................................................................................................. 863$T O Job - Set output characteristics..................................................................................................... 871$T OFF(n).JR - Set offload job receiver characteristics..........................................................................882$T OFF(n).JT - Set offload job transmitter characteristics.....................................................................889$T OFF(n).SR - Set offload SYSOUT receiver characteristics................................................................. 898$T OFF(n).ST - Set offload SYSOUT transmitter characteristics............................................................ 905$T OFFLOAD(n) - Set offload device characteristics.............................................................................. 915$T OUTCLASS(n) - Set SYSOUT class characteristics.............................................................................919$T OUTDEF - Set job output characteristics........................................................................................... 922$T OUTPRTY(n) - Set output scheduling priorities................................................................................. 926$T PCE - Control JES2 processors.......................................................................................................... 928$T PRINTDEF - Control the JES2 print environment..............................................................................932$T PROCLIB(xxxxxxxx) - Modify an existing dynamic PROCLIB concatenation ................................... 935$T PRT(nnnnn) and $T R(nnnnn).PR(m) - Control a printer................................................................... 938$T PUN(nn) and $T R(nnnnn).PU(m) - Control a punch..........................................................................959$T RDI - Control an internal reader.........................................................................................................970$T RDRnn and $T Rnnnn.RDm - Control a reader.................................................................................. 973$T RECVopts - Set JES2 recovery options.............................................................................................. 980$T REDIRect - Redirect command responses........................................................................................ 982$T RMT(nnnnn) - Change an RJE workstation........................................................................................ 985$T REQJOBID - Set JOBID attributes..................................................................................................... 996$T SMFDEF - Control SMF buffers...........................................................................................................998$T SOCKET (xxxxxxxx) - Control a socket...............................................................................................999$T SPOOL - Modify a spool volume.......................................................................................................1002$T SPOOLDEF - Set the JES2 spooling environment........................................................................... 1005$T SRVCLASS(name) - Modify JES2 information for the specified service class................................ 1009$T SSI(nnn) - Control the subsystem interface definition....................................................................1011$T TPDEF - Set JES2 teleprocessing characteristics........................................................................... 1012$T TRACE(nn) - Modify a trace ID......................................................................................................... 1014$T TRACEDEF - Control the trace facility..............................................................................................1016$VS - Enter MVS system commands through JES2..............................................................................1018$Z A - Halt automatic command processing........................................................................................ 1019$ZAPJOB - Remove job structure from job queue............................................................................... 1020$Z I[vvvv] - Halt initiator activity...........................................................................................................1022$Z NETWORK - Halt automatic network connection and device processing and drain NJE devices. 1024

ix

$Z OFFLOADn - Halt offload activity..................................................................................................... 1024$Z PRT(nnnnn) and $Z R(nnnnn).PR(m) - Halt printer activity............................................................ 1025$Z PUN(nn) and $Z R(nnnnn).PU(m) - Halt punch activity...................................................................1026$Z RDRnn - Halt reader activity............................................................................................................ 1027$Z SPOOL - Halt a spool volume........................................................................................................... 1028

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

Notices............................................................................................................1035Terms and conditions for product documentation............................................................................... 1036IBM Online Privacy Statement.............................................................................................................. 1037Policy for unsupported hardware..........................................................................................................1037Minimum supported hardware..............................................................................................................1038Programming Interface Information.....................................................................................................1038Trademarks............................................................................................................................................1038

Index.............................................................................................................. 1039

x

List of Figures

1. Merge migration.......................................................................................................................................... 292. Track calculation......................................................................................................................................... 313. Track allocation........................................................................................................................................... 324. Specify Output Dispositions........................................................................................................................76

xi

xii

List of Tables

1. Controlling the JES2 Environment................................................................................................................ 12. Controlling Your Multi-access Spool (MAS) Environment............................................................................ 13. Controlling Automatic Command Processing............................................................................................... 34. Controlling JES2 Diagnostics........................................................................................................................ 35. Controlling JES2 Spooling............................................................................................................................. 46. JES2/MVS Commands...................................................................................................................................57. JES2 Start Options........................................................................................................................................ 78. Types of JES2 Warm Start...........................................................................................................................139. Limitations on move and merge migrations............................................................................................... 2910. Controlling the Device Environment......................................................................................................... 3311. Controlling Readers...................................................................................................................................3412. Controlling Printers................................................................................................................................... 3413. Controlling Punches.................................................................................................................................. 3614. Controlling the JES2/VTAM Interface.......................................................................................................3815. Controlling the JES2 TCP/IP interface......................................................................................................3816. Controlling RJE Lines................................................................................................................................ 3917. Controlling RJE Workstations................................................................................................................... 3918. Controlling Offload Devices...................................................................................................................... 4019. Remote Entry Restrictions ($A-$D).......................................................................................................... 4920. Remote Entry Restrictions ($E-$O).......................................................................................................... 5021. Remote Entry Restrictions ($P-$S)...........................................................................................................5222. Remote Entry Restrictions ($S-$T)...........................................................................................................5323. Remote Entry Restrictions ($T-$Z)...........................................................................................................5424. Displaying JES2 Job Information............................................................................................................. 5925. Specifying Job Execution Characteristics................................................................................................ 6026. Controlling Initiators................................................................................................................................. 6027. Controlling Job Execution......................................................................................................................... 6128. Holding and Releasing Jobs......................................................................................................................6229. Controlling Jobs at Another Node............................................................................................................ 6330. Specifying Job Output Characteristics..................................................................................................... 6331. Controlling Output.....................................................................................................................................6432. Changing Output Characteristics for SYSOUT Data................................................................................. 7433. Controlling the Network............................................................................................................................7934. Specifying Node Characteristics...............................................................................................................7935. Starting BSC Node Communications........................................................................................................ 8036. Starting SNA Node Communications........................................................................................................8037. Starting TCP/IP Node Communications................................................................................................... 8038. Controlling the JES2/VTAM Interface.......................................................................................................8139. Controlling the JES2-TCP/IP Interface.....................................................................................................81

xiii

40. Defining and Changing Applications.........................................................................................................8141. Defining and Changing TCP/IP sockets.................................................................................................... 8142. Controlling NJE Lines................................................................................................................................ 8243. Controlling NJE Static Connections..........................................................................................................8244. Controlling NJE Devices............................................................................................................................8245. Sending Messages and Commands Through the Network...................................................................... 8346. Command syntax character meanings..................................................................................................... 9347. Command Syntax Conventions.................................................................................................................9448. Coding Asterisks on Initialization Statements....................................................................................... 10249. Numeric Only (used for most devices, such as PRT, PUN, LINE, RMT)................................................. 10450. Symbolic Only (REDIRECT, APPL, JOBCLASS, OUTCLASS, SPOOL, SRVCLASS).................................. 10651. Numeric and Symbolic (NODE, MEMBER, INIT.)....................................................................................10752. JES2 Processing of Initiators..................................................................................................................10853. Syntax examples.....................................................................................................................................11254. Printer Work Selection Values................................................................................................................ 17155. JES2 BUFSIZE Defaults for RJE Workstations....................................................................................... 17856. $D U Messages........................................................................................................................................54257. Example for ROUtines parameter on $T EXIT(nnn)...............................................................................76758. Example for ROUtines and REFRESH parameters on $T EXIT(nnn)..................................................... 76759. JOBCLASS attribute for DSENQSHR.......................................................................................................80560. SYSOUT Transmitter Work Selection Criteria.........................................................................................82161. SYSOUT Transmitter Work Selection and Output Criteria..................................................................... 82462. Offload Job Transmitter Work Selection Criteria................................................................................... 89763. Offload SYSOUT Transmitter Work Selection Criteria............................................................................91364. Interaction of PRINTDEF and PRT(n) parameters that JES2 uses to calculate the output

checkpoint interval.................................................................................................................................. 93365. Printer Work Selection Criteria............................................................................................................... 95766. Punch Work Selection Criteria................................................................................................................96867. JES2 BUFSIZE Minimum Buffer Size Requirements for RJE Workstations...........................................989

xiv

About this document

This document describes the commands that operate the JES2 element of z/OS® (5650-ZOS). Use thisdocument with z/OS MVS System Commands, which provides basic MVS™ system information, in any JES2complex that runs z/OS.

Who should use this documentThis document is intended for use by a system console operator who controls JES2 on a system runningunder MVS.

Where to find more informationThis document references other publications for further details about specific topics. The following tablelists these publications, their titles used throughout this document and their order numbers.

Title Order Number

z/OS Communications Server: SNA Operation SC27-3673

z/OS Communications Server: New Function Summary GC27-3664

NJE with JES2 and Other Systems GG22-9339

Operator's Library: z/OS Remote Terminals (JES2) GC38-0228

z/OS SDSF Operation and Customization SA23-2274

Most licensed documents were declassified in OS/390® V2R4 and are now included on the z/OS OnlineLibrary Collection, SK2T-6700. The remaining licensed documents appear in unencrypteddocumentManager softcopy and PDF form on the z/OS Licensed Product Library, LK2T-2499.

Additional informationAdditional information about z/OS elements can be found in the following documents.

Title Order Number Description

z/OS Introduction and ReleaseGuide

GA32-0887 Describes the contents and benefits of z/OS as well asthe planned packaging and delivery of this newproduct.

z/OS Planning for Installation GA32-0890 Contains information that lets users:

• Understand the content of z/OS• Plan to get z/OS up and running• Install the code• Take the appropriate migration actions• Test the z/OS system

z/OS Information Roadmap SA23-2299 Describes the information associated with z/OSincluding z/OS documents and documents for theparticipating elements.

© Copyright IBM Corp. 1997, 2017 xv

Title Order Number Description

z/OS Summary of Message andInterface Changes

SA23-2300 Describes the changes to messages for individualelements of z/OS.

Note: This document is provided in softcopy only onthe message bookshelf of the z/OS collection kit.

xvi z/OS: JES2 Commands

How to send your comments to IBM

We invite you to submit comments about the z/OS product documentation. Your valuable feedback helpsto ensure accurate and high-quality information.

Important: If your comment regards a technical question or problem, see instead “If you have a technicalproblem” on page xvii.

Submit your feedback by using the appropriate method for your type of comment or question:Feedback on z/OS function

If your comment or question is about z/OS itself, submit a request through the IBM RFE Community(www.ibm.com/developerworks/rfe/).

Feedback on IBM® Knowledge Center functionIf your comment or question is about the IBM Knowledge Center functionality, for example searchcapabilities or how to arrange the browser view, send a detailed email to IBM Knowledge CenterSupport at ibmkc@us.ibm.com.

Feedback on the z/OS product documentation and contentIf your comment is about the information that is provided in the z/OS product documentation library,send a detailed email to mhvrcfs@us.ibm.com. We welcome any feedback that you have, includingcomments on the clarity, accuracy, or completeness of the information.

To help us better process your submission, include the following information:

• Your name, company/university/institution name, and email address• The following deliverable title and order number: z/OS JES2 Commands, SA32-0990-30• The section title of the specific information to which your comment relates• The text of your comment.

When you send comments to IBM, you grant IBM a nonexclusive right to use or distribute the commentsin any way appropriate without incurring any obligation to you.

IBM or any other organizations use the personal information that you supply to contact you only about theissues that you submit.

If you have a technical problemIf you have a technical problem or question, do not use the feedback methods that are provided forsending documentation comments. Instead, take one or more of the following actions:

• Go to the IBM Support Portal (support.ibm.com).• Contact your IBM service representative.• Call IBM technical support.

© Copyright IBM Corp. 1997, 2017 xvii

http://www.ibm.com/developerworks/rfe/http://www.ibm.com/developerworks/rfe/mailto:ibmkc@us.ibm.commailto:mhvrcfs@us.ibm.comhttp://support.ibm.com

Summary of changes

This information includes terminology, maintenance, and editorial changes. Technical changes oradditions to the text and illustrations for the current edition are indicated by a vertical line to the left ofthe change.

Summary of changes for z/OS Version 2 Release 3 (V2R3)The following changes are made for z/OS Version 2 Release 3 (V2R3).

New

• The CHECK option, PARM=, is added to Table 7 on page 7, JES2 Start Options.• New parameter, GDGBIAS, is added to: “$ADD JOBCLASS(jobclass) - Define a new job class ” on page

139, “$D JOBCLASS(n) - Display job class characteristics” on page 322 and “$T JOBCLASS - Set jobclass characteristics” on page 800.

• New optional keyword, BERTIES, is added to “$D CKPTSPACE - Display checkpoint spaces” on page242.

• New debug option, EDS, is added to “$D PCE - Display status for JES2 processors ” on page 461 and“$T DEBUG - Set the JES2 DEBUG option” on page 750 for email processing.

• Support for EDS, email processing, is added to “$D PCE - Display status for JES2 processors ” on page461, “$T DEBUG - Set the JES2 DEBUG option” on page 750, and “$T PCE - Control JES2 processors”on page 928.

• New parameters, SCH_BEFORE, SCH_AFTER, and DELAY=SCH_DEP, are added to “$D Job - Displayinformation about specified jobs” on page 307.

• New output fields, BERTNUM, JOEBERTS, and JOENUM, are added to “$D Job - Display informationabout specified jobs” on page 307 and “$D GROUP - Display information about specified groups” onpage 276.

• With APAR OA50457, “$D Job - Display information about specified jobs” on page 307 is updated toinclude the JOBGROUP keyword.

• New keywords, DJC, OPHOLD, NRCMP, ABCMP, ABNORMAL, NORMAL, and NHOLD, are added to “$DJob - Display information about specified jobs” on page 307.

• New parameter, NFY_SUBJECT, is added to “$D JOBDEF - Display characteristics assigned to jobs” onpage 331 and “$T JOBDEF - Set job processing characteristics” on page 811 for email processing.

• – With APAR OA52614, the XEQHours= keyword is added to:

- “$A Job - Release held jobs” on page 120- “$C Job - Cancel a job” on page 199- “$D Job - Display information about specified jobs” on page 307- “$E Job - Restart a job” on page 555- “$H Job - Hold specific jobs” on page 595- “$P Job - Purge a job” on page 647- “$T Job - Change a job's class, scheduling priority, or affinity” on page 790

– The VFYPATH= keyword is added to “$D NODE(jnnnnnnn) - Display the characteristics of a node” onpage 400.

– The IPADDR= and PORT= parameters are updated for “$D SOCKET (xxxxxxxx) - Display thecharacteristics of a socket” on page 512.

– New parameter, ONERROR, is added to “$P Job - Purge a job” on page 647.

xviii z/OS: JES2 Commands

– The PRECHECK= and VERIFY_SUBNET= keywords are added to “$T NJEDEF - Control JES2 networkenvironment” on page 849.

– The VFYPATH= keyword is added to “$T NODE(jnnnnnnn) - Set the characteristics of a node” on page853.

• New commands, $D LIMITS and $T LIMITS, are added to display limits and usage for information aboutresources, and to change the state of privilege support. See “$D LIMITS(nnnnn) - Display resourcelimits” on page 345 and “$T LIMITS - Set the privilege support characteristics” on page 825 for moreinformation.

• New output field, BERTNUM, is added to “$D O Job - Display output characteristics” on page 413.• With APAR OA48307, “$ADD NETSRV(nnn) - Add a network server” on page 156, “$D NETSRV(nnnnn) -

Display a network server” on page 393, and “$T NETSRV(nnnnn) - Modify the attributes of a networkserver” on page 846 are updated with the new SECURE= keyword.

• With APAR OA49165, the following commands are updated:

– The DUBIOUS= keyword is added to:

- “$C Job - Cancel a job” on page 199- “$D GROUP - Display information about specified groups” on page 276- “$D Job - Display information about specified jobs” on page 307

– The VFYPATH= keyword is added to “$D NODE(jnnnnnnn) - Display the characteristics of a node” onpage 400.

– The IPADDR= and PORT= parameters are updated for “$D SOCKET (xxxxxxxx) - Display thecharacteristics of a socket” on page 512.

– New parameter, ONERROR, is added to “$P Job - Purge a job” on page 647.– The PRECHECK= and VERIFY_SUBNET= keywords are added to “$T NJEDEF - Control JES2 network

environment” on page 849.– The VFYPATH= keyword is added to “$T NODE(jnnnnnnn) - Set the characteristics of a node” on page

853.• New keyword, NHOLD, is added to “$T Job - Change a job's class, scheduling priority, or affinity” on

page 790.• BUFNUM is added to “$T SMFDEF - Control SMF buffers” on page 998 to support the SMF buffer limit.

Changed

A URL for z/OS JES2 spool migration - $MSPOOL, $MSPL from “Migrating spool volumes” on page 26 isnow obsolete. The z/OS JES2 spool migration - $MSPOOL, $MSPL information is now included in“Migrating spool volumes” on page 26.

With APAR OA54837, “$D LIMITS(nnnnn) - Display resource limits” on page 345 and “$T LIMITS - Set theprivilege support characteristics” on page 825 are updated for enhancements for the small environment.

With APAR OA48956, the CC= keyword contains updates for the following commands:

• “$C Group - Cancel a job group” on page 192• “$D GROUP - Display information about specified groups” on page 276• “$P Group - Purge a job group” on page 634• “$T Group - Change the attributes of job groups” on page 770• “$A Job - Release held jobs” on page 120• “$C Job - Cancel a job” on page 199• “$C O Job - Cancel output” on page 215• “$D Job - Display information about specified jobs” on page 307• “$D O Job - Display output characteristics” on page 413• “$H Job - Hold specific jobs” on page 595

Summary of changes xix

• “$O Job - Release or cancel held output groups” on page 628• “$P Job - Purge a job” on page 647• “$P O Job - Purge a job's output” on page 668• “$T Job - Change a job's class, scheduling priority, or affinity” on page 790• “$T O Job - Set output characteristics” on page 871

With APAR OA50551, the following commands are updated to include how to compute the age of a job ora job group that use AGE, DAYS, or HOURS as a job selection filter:

• “$A Job - Release held jobs” on page 120• “$A Group - Release job group” on page 115• “$C Job - Cancel a job” on page 199• “$C Group - Cancel a job group” on page 192• “$D Job - Display information about specified jobs” on page 307• “$D GROUP - Display information about specified groups” on page 276• “$E Job - Restart a job” on page 555• “$H Job - Hold specific jobs” on page 595• “$H Group - Hold job groups” on page 590• “$P Job - Purge a job” on page 647• “$P Group - Purge a job group” on page 634• “$T Job - Change a job's class, scheduling priority, or affinity” on page 790• “$T Group - Change the attributes of job groups” on page 770

With APARs OA53450 and OA52887, the following commands are updated:

• “$S EDS - Request JES2 EDS to retry communication” on page 697• “$D LIMITS(nnnnn) - Display resource limits” on page 345• “$D RECVopts - Display current RECVOPTS settings” on page 506• “$T RECVopts - Set JES2 recovery options” on page 980

Summary of changes for z/OS Version 2 Release 2 (V2R2) as updatedDecember, 2015

The following changes are made for z/OS V2R2 as updated December, 2015.

New

“$C O Group - Cancel output” on page 210, “$D O Group - Display output characteristics” on page 406,“$P O Group - Purge a job group's output” on page 662, and “$T O Group - Set output characteristics” onpage 863 commands are added.

Changed

• Mode Z2 is changed to Z11 and Z11 is changed to Z22 for:

– “$D ACTIVATE - Display current JES2 checkpoint level and MAS readiness for checkpoint activationto Z22 level” on page 230.

– “$ACTIVATE - Activate a particular level of JES2 function” on page 127.– “$D JOBDEF - Display characteristics assigned to jobs” on page 331.

• Job groups do not support independent mode and the SYSAFF parameter description is changed for:

– “$D GROUP - Display information about specified groups” on page 276.

xx z/OS: JES2 Commands

– “$T Group - Change the attributes of job groups” on page 770.• Maximum limits for the following parameters are increased:

– For $T CKPTSPACE BERTNUM, “$T CKPTSPACE - Set the checkpoint space” on page 744.– For $T JOBDEF JOBNUM, “$T JOBDEF - Set job processing characteristics” on page 811.– For $T OUTDEF JOENUM, “$T OUTDEF - Set job output characteristics” on page 922.

• A new keyword, JOBGROUP, is added to these commands:

– “$A Job - Release held jobs” on page 120– “$C Job - Cancel a job” on page 199– “$C O Job - Cancel output” on page 215.– “$D Job - Display information about specified jobs” on page 307– “$D O Job - Display output characteristics” on page 413– “$H Job - Hold specific jobs” on page 595– “$O Job - Release or cancel held output groups” on page 628– “$P Job - Purge a job” on page 647– “$P O Job - Purge a job's output” on page 668– “$T Job - Change a job's class, scheduling priority, or affinity” on page 790– “$T O Job - Set output characteristics” on page 871

• These commands have new job completion code, FLUSHED, for the CC= parameter. They were added ina previous release.

– “$C Job - Cancel a job” on page 199– “$C O Job - Cancel output” on page 215.– “$D Job - Display information about specified jobs” on page 307– “$D O Job - Display output characteristics” on page 413– “$O Job - Release or cancel held output groups” on page 628– “$P Job - Purge a job” on page 647– “$P O Job - Purge a job's output” on page 668– “$T Job - Change a job's class, scheduling priority, or affinity” on page 790– “$T O Job - Set output characteristics” on page 871

Summary of changes for z/OS Version 2 Release 2 (V2R2)The following changes are made in z/OS Version 2 Release 2 (V2R2).

New

• The $A Group command was added to release a job group so that the associated jobs can be executed.See “$A Group - Release job group” on page 115.

• Added new level of z22 to $ACTIVATE. See “$ACTIVATE - Activate a particular level of JES2 function” onpage 127.

• The $C Group command was added to cancel a job group and its associated groups. See “$C Group -Cancel a job group” on page 192.

• With APAR OA43184, the TIMECLOCK parameter was added to the $D Debug and $T Debugcommands. See “$D DEBUG - Display the JES2 DEBUG option” on page 255 and “$T DEBUG - Set theJES2 DEBUG option” on page 750.

• The $D DUPJOB command was added. See “$D DUPJOB - Display counts of duplicate jobs” on page260.

Summary of changes xxi

• The $D Group command was added to display job group attributes. See “$D GROUP - Displayinformation about specified groups” on page 276.

• The $D GRPDEF command was added. See “$D GRPDEF - Display characteristics assigned to jobgroups” on page 293.

• The $D INPUTDEF command was added. See “$D INPUTDEF - Display options controlling JES2 inputprocessing” on page 296.

• The $D JECLDEF command was added. See “$D JECLDEF - Display options controlling processing ofJECL statements” on page 303.

• SUP_EVENTLOG_SMF was added to $D JOBDEF and $T JOBDEF commands. See “$D JOBDEF - Displaycharacteristics assigned to jobs” on page 331 and “$T JOBDEF - Set job processing characteristics” onpage 811.

• With APAR OA41698, the ENFSCOPE parameter was added to the $D MASDEF and $T MASDEFcommands. command. See “$D MASDEF - Display the multi-access spool environment” on page 369and “$T MASDEF - Control the multi-access spool environment” on page 838.

• Added COLD_START_MODE parameter to $D OPTSDEF command. See “$D OPTsdef - Display startoptions processing definitions” on page 451.

• The $H Group command was added to hold job groups. See “$H Group - Hold job groups” on page 590.• The $P Group command was added to purge jobs in completed job groups. See “$P Group - Purge a job

group” on page 634.• The $T Group command was added to modify the attributes of a job group. See “$T Group - Change the

attributes of job groups” on page 770.• The $T GRPDEF command was added. See “$T GRPDEF - Set job group processing characteristics” on

page 777.• The $T INPUTDEF command was added. See “$T INPUTDEF - Specify options controlling JES2 input

processing” on page 782.• The $T JECLDEF command was added. See “$T JECLDEF - Specify options controlling processing of

JECL statements” on page 788.• These commands have new job completion codes for the CC= parameter. They were added in a previous

release.

– “$C Job - Cancel a job” on page 199– “$C O Job - Cancel output” on page 215.– “$D Job - Display information about specified jobs” on page 307– “$D O Job - Display output characteristics” on page 413– “$O Job - Release or cancel held output groups” on page 628– “$P Job - Purge a job” on page 647– “$P O Job - Purge a job's output” on page 668– “$T Job - Change a job's class, scheduling priority, or affinity” on page 790– “$T O Job - Set output characteristics” on page 871

Changed

• Modified UNACT version levels. See “Starting using the console” on page 6.• Modified “Displaying JES2 status” on page 11.• Modified “Withdrawing JES2 from the system” on page 14.• Modified “Monitoring buffers” on page 15.• Modified “Specifying MAS definition parameters and initiating a checkpoint reconfiguration dialog” on

page 18.• Modified introduction of “Moving and merging spool volumes” on page 28 for clarification.

xxii z/OS: JES2 Commands

• Modified Chapter 3, “Controlling jobs and output,” on page 59.• Modified “Controlling jobs” on page 65.• Modified “Using parameters on job-related commands” on page 65.• Added "For jobs with duplicate names" to “Displaying job information” on page 66.• Modified “Controlling JES2 initiators” on page 68.• Modified SECURITY parameter of $D DEBUG for clarification. See “$D DEBUG - Display the JES2 DEBUG

option” on page 255.• Modified parameters of “$D Job - Display information about specified jobs” on page 307.• Added HOLDUNTL, STARTBY, and WITH to $D JOB command. See “$D Job - Display information aboutspecified jobs” on page 307.

• Added PROMO_RATE to $D JOBCLASS and $T JOBCLASS commands. See “$D JOBCLASS(n) - Displayjob class characteristics” on page 322 and “$T JOBCLASS - Set job class characteristics” on page 800.

• Added CYCLEMGT to $D MASDEF and $T MASDEF commands. See “$D MASDEF - Display the multi-access spool environment” on page 369 and “$T MASDEF - Control the multi-access spoolenvironment” on page 838.

• Added LDEV_OPT to $DOUTDEF and $TOUTDEF commands. See “$D OUTDEF - Display output definitionoptions” on page 454 and “$T OUTDEF - Set job output characteristics” on page 922.

• Modified WS_OPT of $DOUTDEF and $TOUTDEF. See “$D OUTDEF - Display output definition options”on page 454 and “$T OUTDEF - Set job output characteristics” on page 922.

• Modified Example. See “$D RECVopts - Display current RECVOPTS settings” on page 506.• Modified CYL_MANAGED parameter for $D SPOOLDEF. See “$D SPOOLDEF - Display the JES2 spooling

environment” on page 523.• Modified $T CKPTDEF. See “$T CKPTDEF - Set the checkpoint definition” on page 735.• With APAR OA44670, clarification was added to the CLASS= parameter of $D I[nnmm] and $T

Init(nnmm). See “$D I[nnmm] - Display initiator information” on page 297 and “$T Init(nnmm) - Controlinitiators” on page 779.

• Modified processing considerations of $H Job. See “$H Job - Hold specific jobs” on page 595.• Clarifications for the PRIMARY parameter was added to $ADD DESTID and $T DESTID. See “$ADD

DESTID - Define a symbolic destination” on page 134 and “$T DEStid - Control a JES2 symbolicdestination” on page 754.

• With APAR OA44967, clarification was added to the NAME= parameter of $T PROCLIB. See “$TPROCLIB(xxxxxxxx) - Modify an existing dynamic PROCLIB concatenation ” on page 935.

• Modified syntax of $T PRT(nnnnn) and $T R(nnnnn).PR(m) modification and selection limiting keywordFCBLOAD added in a previous release. See “$T PRT(nnnnn) and $T R(nnnnn).PR(m) - Control a printer”on page 938.

• Modified Parameters. See “$T RECVopts - Set JES2 recovery options” on page 980.• Modified CYL_MANAGED and WARN parameters for $T SPOOLDEF for clarification. See “$T SPOOLDEF -

Set the JES2 spooling environment” on page 1005.• Modified $ZAPJOB function. See “$ZAPJOB - Remove job structure from job queue” on page 1020.

Deleted

• Removed UNACTivate parameter from $D OPTSDEF command. See “$D OPTsdef - Display start optionsprocessing definitions” on page 451.

z/OS Version 2 Release 1 summary of changesSee the Version 2 Release 1 (V2R1) versions of the following publications for all enhancements related toz/OS V2R1:

Summary of changes xxiii

• z/OS Migration• z/OS Planning for Installation• z/OS Summary of Message and Interface Changes• z/OS Introduction and Release Guide

xxiv z/OS: JES2 Commands

Chapter 1. Controlling JES2

This chapter describes how to:

• Start, stop, and restart JES2• Control the JES2 processing environment independent of devices, jobs, and networks. (Chapters 2

through 4 discuss devices, jobs, and networks, respectively.)Devices, jobs, and networks are discussedrespectively later.

The following tables list the tasks discussed in this chapter and provide a cross reference to the detaileddescriptions of the corresponding commands.

Table 1: Controlling the JES2 Environment

Task Command Location

Start JES2 processing $S “$S - Startsystem activity”on page 695

Stop JES2 processi