Table of Contents (exploded view)
Abstract for JES3 Initialization and Tuning Guide
Summary of changes for z/OS Version 2 Release 2 (V2R2) as updated December, 2015
Summary of changes
z/OS Version 2 Release 1 summary of changes
Introduction
Developing Your Installation Plan
Preparing for JES3
Installing JES3
Running the Hardware Configuration Definition Program
Initializing MVS
Initializing JES3
Modifying the JES3 cataloged start procedure
Modifying or Creating a JES3 Initialization Stream
Organizing the initialization stream
Using a segmented initialization stream
Testing Your Initialization Stream
How to Run Step 1
Using MVS Hardware Configuration Definition (HCD)
How to Run Step 2
Storage Requirements for the Initialization Stream Checker
Abnormal Termination of the Initialization Stream Checker
Starting JES3
Hot Start
Hot Start with Analysis
Hot Start with Refresh
Hot Start with Refresh and Analysis
Warm Start
Warm Start with Analysis
Warm Start to Replace a Spool Data Set
Warm Start with Analysis to Replace a Spool Data Set
Cold start
Local start
Tuning JES3
JES3 Monitoring
Using JMF to Measure JES3 Performance
Using JES3 Auxiliary Address Space (JES3AUX)
Maintaining JES3
JES3 Maintenance philosophy
General overview of JES3 service
JES3 restart information
Running JES2 and JES3 on the same image is not supported
Dynamically changing the JES3 configuration
Providing security for JES3
Planning for Security
Using RACF to provide security
How JES and RACF Work Together
Defining JES3 and the JES3AUX Address Space in the RACF Procedures Table
Forcing Batch Users to Identify Themselves to RACF
Defining and Grouping Operators
Understanding How to Provide Access to Resources
Universal Access Authority
Access Lists
Understanding Security Labels
Security Labels for JES Resources
JES3 Installation Exits that Affect RACF-Provided Security
Giving JES3 Access to Resources
JES User ID Early Verification
TSO/E logon
User ID Propagation When Jobs Are Submitted
Control of User ID Propagation
Where NJE jobs are verified
How SYSOUT requests are verified
Controlling Access to Data Sets JES Uses
Controlling Input to Your System
How RACF Validates Users
Propagation of Security Information
Propagating Security Information across a Network
Controlling the use of job names and job classes
Controlling Who Can Submit Jobs by Job Name
Controlling who can submit jobs by job class
Controlling Who Can Cancel Jobs by Job Name
Allowing a TSO/E User to CANCEL All Jobs Originating from Local Nodes
Surrogate job submission
Authorizing the Use of Input Sources
Authorizing Network Jobs and SYSOUT (NJE)
Authorizing Inbound Work
Understanding NODES Profiles
Setting up NODES profiles
RACSLUNK Seclabel
Understanding Mixed Security Environments
Authorizing jobs
Authorizing SYSOUT
Validating SYSOUT Based on the Submitter
Translating Security Information
Example: simple NJE user translation
Example: Simple NJE User Translation Using &SUSER
Example: trusted, semitrusted, and untrusted nodes
Understanding Default User IDs
How JES Sends Security Information
Defining Profiles in the NODES Class
Defining Nodes as Local Input Sources
Authorizing Outbound Work
Controlling Password Encryption for NJE Jobs
Using Security Labels to Control Writers
Making security definitions for a TCP/IP/NJE Netserv
Authorizing TCP/IP/NJE Secure Signon
Examples
Controlling Access to Data That Resides on Spool
Protecting SYSIN and SYSOUT
Defining Profiles for SYSIN and SYSOUT Data Sets
Allowing Users to Create Their Own JESSPOOL Profiles
Protecting JESNEWS
Protecting JESNEWS for JES3
How RACF Affects Jobs Dumped from and Restored to Spool (JES3 Only)
Dumping Jobs
Restoring Jobs
Authorizing Console Access
MCS Consoles
Remote Workstations (RJP/RJE Consoles)
Controlling Where Output Can Be Processed
Authorizing the Use of Your Installation's Printers
Using RACF to Authorize the Use of Operator Commands
Profile (Entity) Names for JES3 Commands
Who Authorizes Commands When RACF Is Active
Using JES3 to Provide Security
JES3 Initialization Statements that Affect Security
JES3 Installation Exits that Affect JES3-Provided Security
Using JES3 to Control Access to RJP Workstations
Controlling Passwords for SNA RJP Workstations
Controlling Passwords for BSC RJP Workstations
Using JES3 to Authorize the Use of Operator Commands
Using JES3 to Authorize Commands from RJP Consoles
Using JES3 to Authorize Commands from NJE
Using JES3 to Authorize Commands from TSO/E
Using JES3 to Authorize Commands from MCS Consoles
Using JES3 to Authorize Commands Entered in Job Streams
Controlling the use of job classes
JES3 job management
Input Service
Reader Phase
Control statement processing phase
Selecting a main for job execution
Modifying JCL and JES3 Control Statements
Preventing a Job from Dominating JSAM Buffers
Converter/Interpreter Service
Converter/Interpreter Phase
Prescan Phase
Postscan Phase
Cataloged Data Set Resolution
C/I Service Preparation for the Main Device Scheduler
JES3 Resource Allocation
MVS Allocation Compared with JES3 MDS Allocation
MVS Allocation
Main Device Scheduler (MDS) Allocation
Volume Fetch
System Select
Allocation
Volume Verification
System Verify
Breakdown
Types of Setup
Job Setup
High Watermark Setup
Explicit Setup
Initializing MDS
CLASS Initialization Statement
DEVICE Initialization Statement
GROUP Initialization Statement
SELECT Initialization Statement
SETACC Initialization Statement
SETNAME Initialization Statement
SETPARAM Initialization Statement
SETRES Initialization Statement
STANDARDS Initialization Statement
Operator Control of MDS
Job Selection and Scheduling
Comparison of JES3 and WLM initiator management
Classifying Jobs
Pre-execution delays
Defining service classes and performance goals
Recommendations For Defining Service Classes
Job Selection Algorithm for JES3-Managed Initiators
Job Selection Algorithm for WLM-Managed Initiators
Deadline Scheduling
Dependent Job Control
Early Dependent Job Control (DJC) JCL Scan
Initializing the DJC Job Network
Scheduling the DJC Job Network
Modifying the DJC Job Network
Terminating the DJC Job Network
DJC Completion Option
Nonstandard DJC Job Processing
Controlling Job Selection
Determining main eligibility
Determining Job Eligibility
Controlling the Job Mix on Each Processor
Defining the job selection environment
Default Job Selection
Starting and Stopping Initiators
Defining Logical Storage for Processors
Controlling Job Scheduling
Assigning a Job Selection Mode
Defining Job Selection Parameters
Defining JES3 Job Classes
Grouping JES3 Job Classes
Automatic Restart Management
Output Service
Queueing Output
Override sequences for output data set information
Override sequence with “Direct” OUTPUT JCL statements for WTR queue and hold queue
Override Sequence with Direct //*FORMAT JES3 Control Statements For WTR Queue
Override sequence with direct //*FORMAT JES3 control statements for HOLD queue SYSOUT
Override Sequence With Only Default OUTPUT JCL Statements for WTR Queue and HOLD Queue
Override Sequence With Only Default //*FORMAT JES3 Control Statements for WTR Q
Override sequence with only default //*FORMAT JES3 control statements for HOLD queue
Override Sequence with Default OUTPUT and //*FORMAT JES3 Control Statements for WTR Queue
Override sequence with only default OUTPUT and //*FORMAT statements for the HOLD queue
OSE Processing
Scheduling Output
Determining which output parameters apply
How device characteristics are set and changed
How output characteristics are associated with a data set
How data set characteristics are associated with a device
Examples
Writing Output
External Writers/SAPI Applications
Tuning SAPI Application
NJERDR
Internal Reader
Accessing Job Output Through TSO
Output Service Installation Exits
Purge
Defining and managing C/I service
Setting Up C/I Service
Advantages to Using C/I FSS Address Spaces
C/I FSS address space requirements
Storage management subsystem considerations
Avoiding common storage constraints
MVS performance considerations
Using multi-character CLASS names on the JOB card
Defining a C/I FSS address space
Defining the Maximum Number of CI and POSTSCAN DSPs
Specifying the Number of CI DSPs in the JES3 Global Address Space
Specifying the Number of CI DSPs in a C/I FSS Address Space
Avoiding Private Area Virtual Storage Constraint Within a C/I FSS Address Space
Specifying the Number of POSTSCAN DSPs
Controlling Jobs Through C/I Service
Controlling Job Flow with Installation Exits
Assigning jobs to the appropriate processor and address space for C/I service
Using system symbols in source JCL for demand select jobs
Defining a converter/interpreter options list
Managing the Scheduler Work Area
Creating SWA Space
Preventing a Job from Dominating the SWA
Selecting the Job JCL Statement Limit
Preventing Abnormal Termination of JES3 or a C/I FSS Address Space
Selecting the address space JCL statement limit
Monitoring and Modifying C/I Service
Determining the Status of C/I Service
Displaying the Status of Jobs
Displaying the Status of CI and POSTSCAN DSPs
Modifying C/I Service
Managing Procedure Libraries
Updating Procedure Libraries
Displaying the Status of Procedure Library Data Sets
Defining and Managing Spool Data Sets
Defining Spool Data Sets
Determining How Many Spool Data Sets You Should Allocate
Allocating Spool Data Sets
Formatting Spool Data Sets
Formatting During JES3 Initialization
Formatting with IEBDG
Reformatting a Spool Data Set
Using Spool Partitions
Advantages to Spool Partitioning
Isolating Different Spool Data Types
Defining Spool Partitions
Defining spool partition overflow
Specifying Spool Data Sets as Members of Spool Partitions
Specifying a Spool Partition for Spool Data
Determining the order of spool partition overrides
How the User Can Request a Spool Partition
Example of spool partitioning
Defining Spool Space Allocation Units
Defining a Track Group
Determining the Size of a Track Group
Relating track group sizes to physical tracks
Determining Track Group Allocation Sizes
Track Group Allocation Overrides
Managing Spool Space
Adding or deleting a spool data set
Replacing a spool data set
Replacing a spool data set dynamically
Replacing a spool data set using a warm start
Moving a spool data set to another DASD volume
Balancing the workload across spool partitions
Deleting Output Data Sets
Freeing Spool Space Using the Dump Job Facility
How to Use Performance Measurement Tools to Tune JES3 Spool
Defining Consoles and Message Routing
Defining Consoles
Defining MCS Consoles
Defining RJP Consoles
JES3 Console Management
Operator Communication
Input Processing
MCS Console Management
Entering commands
Defining the hardcopy log
Recording message traffic
Rules
Defining message routing
Where and How Messages Originate
The JES3 MESSAGE Macro
The MVS WTO and WTOR Macros
Where messages can go
Understanding the General Path of a Message
Path of message issued from a local processor
Path of a message issued from a global processor
JES3 Destination Classes and MVS Routing Codes
Two Types of Messages
Routing JES3 Messages to Consoles
Using MSGROUTE to Control Message Routing
Processing if SY1 Is either the Local or Global:
Coding Rules for the MSGROUTE Statement
Usage Notes for the MSGROUTE Statement
Message Routing Exceptions
Message Routing Specified by MPF Installation Exit
Action Messages that Must Be Displayed
Hardcopy Only Messages
Deleted Messages
No Routing Specified
Messages that Originate from Functional Subsystems
Broadcast Messages
Suppressed Messages
Messages that Specify Only an MVS Routing Function
Job Status Messages Without Routing Codes
Special Messages
Printer Setup Messages
Device-Related Messages
Job Termination Messages
Main Processor Messages
RJP Messages
Diagnosing Misrouted Message Traffic
Suppressing the Display of Messages
Specifying Messages for Display Suppression
Controlling Message Suppression
Examples of message suppression
Using MPF to Screen Messages for Automation
Automating message processing
How to reduce message traffic using MPF
Order of Command Execution
Defining and Managing JES3 Resources
JES3 Data Sets
Allocating JES3 Data Sets
Allocating the JES3 Checkpoint Data Sets
Determining the Size and Placement of the Checkpoint Data Sets
Replacing or moving the JES3 checkpoint
Defining the Maximum Number of Jobs for Your Complex
Controlling the Number of Jobs Allowed in a JES3 Complex:
Reasons for Increasing the Number of Jobs in Your Complex
Determining the size of the JCT data set
Using Performance Measurement Tools to Tune JCT Access
JCT Utility (IATUTJCT)
Introduction
Copying a JCT Data Set Using the IATUTJCT Utility
Running the IATUTJCT Utility
Setup and Initialization Considerations
Use Considerations
Testing IATUTJCT Processing
Migrating Using IATUTJCT
Identifying Resident Data Sets
Using system catalogs
I/O Devices
Defining I/O Devices to JES3
JES3 Devices
Execution devices
Shared Devices
Defining Process Modes
Using Process Mode Defaults
Running a Printer Under an Output Writer Functional Subsystem
Defining PSF FSSs and FSAs for Printers
Printer specifications
Defining an Output Writer Functional Subsystem
Determining the Maximum Number of Printers for an Output Writer FSS
Defining the 3800 Model 3 Printer as a Line Printer
Defining Channel Attached Printers Controlled by FSSs
Defining AFP1 Printers
Defining non-channel attached printers
Using the Infoprint Server for z/OS Printer Inventory
Defining a device configuration
Defining a range of devices
Defining a Device To All Processors Simultaneously
Maintaining a Device Configuration Using HCD
Adding Devices
Changing Devices
Deleting Devices
Allocating an I/O Device to JES3
Grouping I/O devices
Specifying Device Fencing
Dynamically Reconfiguring I/O Devices
Volumes
How Resource Definition Affects JES3 Resource Management
I/O device management
Data Set Access
Data Set Integrity
MVS Data Set Integrity: What It Does
JES3 Data Set Integrity: What It Does
Differences Between MVS and JES3 Integrity Checking
Bypassing JES3 integrity checking
Volume management
Dynamic Allocation
Defining and managing JES3 mains and storage
Defining mains
General considerations
Defining a JES3 XCF group
Running JES3 in a sysplex environment
Defining Storage
Defining Buffers
Defining the size of JES3 buffers
Defining the size of the JSAM buffer pool
Defining USAM Unprotected Buffers (UBUFs)
Defining the Number of USAM Protected Buffers (PBUFs)
Reducing the Amount of Common Service Area Used by JES3
Determining How Many Buffers to Allocate in the JES3 Auxiliary Address Space
Using the Writer Output Multitasking Facility
Restart Considerations
DSI Considerations
JES3 Remote Job Processing
Binary Synchronous Communication Remote Job Processing
Data Security Considerations
Data Compression
Operator Communications
Operator Commands Accepted from a BSC RJP Workstation
Debugging Facilities
BSC RJP Line Error Statistics
BSC RJP Line Snap Facility
BSC RJP Trace Facility
Initialization Statements that Affect BSC RJP
Systems Network Architecture Remote Job Processing
SNA RJP implementation of SNA concepts
Function Management Presentation Services (FMPS)
FM Inbound
FM Outbound
Presentation Service
Compression and Compaction
Conversion of Logical Records and RUs
Data Flow Control
Chaining RUs
JES3 to VTAM Interface
VTAM Considerations
Logon Mode Table
Initialization Statements that Affect SNA RJP
Maximum Record Lengths for SNA RJP Devices
Basic Exchange Support
Exchange Support
Exchange and Basic Exchange Initialization Considerations
JES3 Networking
Networking Protocols
Differences between Networking Protocols
BSC
SNA
TCP/IP
Converting Networking Protocols
Types of nodes
Converting A Node To TCP/IP
Defining the Home Node
Defining a Remote Node
Specifying a communications path for indirectly-connected nodes
Defining an Alias
Defining a Spool Partition
Defining TCP/IP/NJE
BSC Considerations
Defining the buffer size
Specifying passwords
Defining BSC Communication Lines
DEVICE Statement
NJERMT statement for BSC
Logical senders: How JES3 names them
DESTDEF Statement
SNA Considerations
Changing Node Definitions
How Restarts Affect Networking Jobs
JES3 Hot, Hot Start with Refresh, or Warm Start
JES3 cold start
MVS/BDT Hot or Warm Start
MVS/BDT Cold Start
TCP/IP Considerations
Changing Node Definitions
How Restarts Affect Networking Jobs
TCP/IP prerequisites
Rerouting Jobs and SYSOUT
Networking Job Numbers
Defining a Network Message Destination
Monitoring the job entry network with installation exits
Monitoring Files Sent through TSO/E TRANSMIT or CMS SENDFILE
Deleting Files from the Spool
General NJE Considerations
JES3 support for IBM tape libraries
JES3 support overview
Allocation for tape library data sets
JES3 initialization statements
SETNAME statement
HWSNAME statement
DEVICE Statement
Library configuration example
MVS UNITNAME Definitions
SETNAME statements
HWSNAME statements
DEVICE statements
Operational considerations
Unchanged functions
Modified functions
JES3 limitations
Mount failures
JES3
Tape verification processing (IATLVVR module)
Migration considerations
IBM 3590/3592 support for JES3
DTYPE for JUNIT
JES3 Dump Job Dynamic Support Program