z/OS

JES2 CommandsVersion 2 Release 3

SA32-0990-30

IBM

NoteBefore using this information and the product it supports, read the information in Notices on page 1095.

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

Last updated: July 17, 2017

Copyright IBM Corporation 1997, 2017.US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

Contents

Figures . . . . . . . . . . . . . . . ix

Tables . . . . . . . . . . . . . . . xi

About this document . . . . . . . . xiiiWho should use this document . . . . . . . xiiiWhere to find more information . . . . . . . xiiiAdditional information . . . . . . . . . . xiii

How to send your comments to IBM . . xvIf you have a technical problem . . . . . . . xv

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

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

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

Controlling your MAS environment . . . . . . 15Using independentmode processing . . . . . 15Displaying 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 . . . . . . . . . 20

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

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

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

Chapter 2. Controlling JES2 devicesand functional subsystems . . . . . . 33Device overview. . . . . . . . . . . . . 40

Controlling the device environment . . . . . 41JES2 input processing . . . . . . . . . . . 42

Controlling readers . . . . . . . . . . . 42JES2 output processing . . . . . . . . . . 43

Controlling printers . . . . . . . . . . 44Controlling punches . . . . . . . . . . 46

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

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

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

Controlling the scope of commands . . . . . 64Using 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 . . . . . . 73

Controlling job output . . . . . . . . . . . 73Specifying job output characteristics . . . . . 74JES2 job output commands . . . . . . . . 78Controlling output groups and job outputelements . . . . . . . . . . . . . . 79

Chapter 4. Controlling a network . . . 81Controlling the NJE environment . . . . . . . 85Specifying node characteristics . . . . . . . . 85

Modifying transmission delays and excessivelooping through a network . . . . . . . . 86Modifying sign-on tolerance . . . . . . . . 86Defining a symbolic destination name . . . . 86Deleting a symbolic destination name . . . . 86Displaying subnets and their paths across anetwork . . . . . . . . . . . . . . 86Displaying node attributes . . . . . . . . 87Setting node attributes. . . . . . . . . . 87

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

Controlling NJE lines . . . . . . . . . . . 92Controlling NJE static connections . . . . . . . 94

Copyright IBM Corp. 1997, 2017 iii

Controlling JES2 transmitting and receiving devices 94Sending messages and commands through thenetwork . . . . . . . . . . . . . . . 95

Displaying and controlling jobs at other nodes . 96

Chapter 5. Command reference section 97Command descriptions . . . . . . . . . . 97

Command syntax conventions . . . . . . . 97How to read syntax diagrams . . . . . . . 116Keywords defined . . . . . . . . . . . 118

$A A - Release all jobs . . . . . . . . . . 119$A Group - Release job group . . . . . . . . 120$A Job - Release held jobs . . . . . . . . . 125$ACTIVATE - Activate a particular level of JES2function . . . . . . . . . . . . . . . 131$ADD APPL - Define a VTAM application to JES2 134$ADD CONNECT - Dynamically add networkconnections . . . . . . . . . . . . . . 136$ADD DESTID - Define a symbolic destination . . 139$ADD FSS - Define a functional subsystem . . . 143$ADD JOBCLASS(jobclass) - Define a new job class 144$ADD LINE(nnnn) - Add line . . . . . . . . 155$ADD LOADMOD - Load a new Installation LoadModule . . . . . . . . . . . . . . . 160$ADD LOGON(nn) - Add a logon . . . . . . 162$ADD NETSRV(nnn) - Add a network server. . . 164$ADD PROCLIB(xxxxxxxx) - Define a newdynamic PROCLIB concatenation. . . . . . . 166$ADD PRT(nnnnn) - Define a local printer . . . 169$ADD REDIRECT - Set redirection for commands 183$ADD RMT(nnnnn) - Add an RJE workstation . . 185$ADD SOCKET(xxxxxxxx) - Add a socket . . . . 195$ADD SRVCLASS(name) - Add a new permanentservice class element . . . . . . . . . . . 197$B PRT(nnnnn) and $B R(nnnnn).PR(m) - Logicallybackspace printer output . . . . . . . . . 198$B PUN(nn) and $B R(nnnnn).PU(m) - Logicallybackspace punch output. . . . . . . . . . 201$C A - Cancel automatic commands . . . . . . 202$C Group - Cancel a job group . . . . . . . 204$C Job - Cancel a job . . . . . . . . . . . 211$C Lnnnn.xxn - Cancel NJE device activity . . . 221$C O Group - Cancel output . . . . . . . . 222$C O Job - Cancel output . . . . . . . . . 229$C OFFn.JR - Cancel a spool offloadtransmitter/receiver . . . . . . . . . . . 239$C PRT(nnnnn) and $C R(nnnnn).PR(m) - Cancelprinter output . . . . . . . . . . . . . 240$C PUN(nn) and $C R(nnnnn).PU(m) - Cancelpunch output . . . . . . . . . . . . . 241$C RDR and $C Rnnnn.RDm - Cancel readeractivity . . . . . . . . . . . . . . . 242$D A - Display information about currently activejobs . . . . . . . . . . . . . . . . 243$D ACTIVATE - Display current JES2 checkpointlevel and MAS readiness for checkpoint activationto Z22 level . . . . . . . . . . . . . . 246$D ACTRMT - Display Active RJE Workstations ina MAS. . . . . . . . . . . . . . . . 249$D APPL - Display JES2 SNA NJE applications . . 251$D BUFDEF - Display JES2 buffer definitions. . . 254

$D CKPTDEF - Display the checkpoint definition 255$D CKPTSPACE - Display checkpoint spaces . . . 260$D CLASSGRP - Display class groups . . . . . 265$D COMPACT - Display JES2 compaction tables 266$D CONDEF - Display console communicationcharacteristics . . . . . . . . . . . . . 267$D CONNECT - Display network connections . . 269$D DEBUG - Display the JES2 DEBUG option . . 273$D DESTDEF - Display symbolic destinationsettings . . . . . . . . . . . . . . . 276$D DEStid - Display a JES2 symbolic destination 277$D DUPJOB - Display counts of duplicate jobs . . 280$D ESTBYTE - Display Number of Bytes Set forJobs and their Output . . . . . . . . . . 282$D ESTLNCT - Display number of lines for jobsand their output . . . . . . . . . . . . 283$D ESTPAGE - Display number of pages set forjobs and their output . . . . . . . . . . . 284$D ESTPUN - Display number of punch pages setfor jobs and their output . . . . . . . . . 285$D ESTIME - Display amount of time set for jobsand their output . . . . . . . . . . . . 286$D EXIT - Display current characteristics ofspecified JES2 exit points . . . . . . . . . 287$D F - Display the job output forms queue . . . 291$D FSS - Display the characteristics of the specifiedfunctional subsystems . . . . . . . . . . 294$D GROUP - Display information about specifiedgroups . . . . . . . . . . . . . . . 296$D GRPDEF - Display characteristics assigned tojob groups . . . . . . . . . . . . . . 314$D INITDEF - Display the number of logicalinitiators currently defined . . . . . . . . . 315$D INITINFO - Display initialization information 316$D INPUTDEF - Display options controlling JES2input processing . . . . . . . . . . . . 317$D I[nnmm] - Display initiator information . . . 318$D INTRDR - Display the current INTRDRinitialization statement characteristics . . . . . 323$D