AS/400e IBM

Work Management
Version 4

SC41-5306-03
AS/400e IBM

Work Management
Version 4

SC41-5306-03
 Note
Before using this information and the product it supports, be sure to read the information in “Appendix F. Notices” on
page 509.

Fourth Edition (May 1999)

This edition applies to version 4, release 4, modification 0 of the licensed program IBM Operating System/400
(Program 5769-SS1) and to all subsequent releases and modifications until otherwise indicated in new editions. This
edition applies only to reduced instruction set computer (RISC) systems.
This edition replaces SC41-5306-02.
© Copyright International Business Machines Corporation 1997, 1999. All rights reserved.
Note to U.S. Government Users — Documentation related to restricted rights — Use, duplication or disclosure is
subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp.
Contents
About Work Management (SC41–5306) . . . . . . . . . . . . . . . xvii
Who should read this book . . . . . . . . . . . . . . . . . . . . xvii
AS/400 Operations Navigator . . . . . . . . . . . . . . . . . . . xvii
Installing Operations Navigator. . . . . . . . . . . . . . . . . . xviii
Prerequisite and related information . . . . . . . . . . . . . . . . . xviii
How to send your comments . . . . . . . . . . . . . . . . . . . xviii

Summary of Changes to Work Management. . . . . . . . . . . . . xxi

Chapter 1. Work Management-Introduction . . . . . . . . . . . . . 1

Why Learn about Work Management? . . . . . . . . . . . . . . . . 1
A Simple System . . . . . . . . . . . . . . . . . . . . . . . . 1
A Complex System . . . . . . . . . . . . . . . . . . . . . . . 2
A System as a Business—Scenario . . . . . . . . . . . . . . . . . 2
Work Management Terms—Scenario . . . . . . . . . . . . . . . 2
Objects Quick Reference . . . . . . . . . . . . . . . . . . . . 4

Chapter 2. System Values . . . . . . . . . . . . . . . . . . . . 5

System Values–Benefits . . . . . . . . . . . . . . . . . . . . . 5
System Values—Overview . . . . . . . . . . . . . . . . . . . . 5
Date-and-Time System Values—Overview . . . . . . . . . . . . . 5
Editing System Values—Overview . . . . . . . . . . . . . . . . 6
System Control System Values—Overview . . . . . . . . . . . . . 6
Library List System Values—Overview . . . . . . . . . . . . . . . 10
Allocation System Values—Overview . . . . . . . . . . . . . . . 10
Message-and-Logging System Values—Overview . . . . . . . . . . . 11
Storage System Values—Overview . . . . . . . . . . . . . . . . 11
Security System Values—Overview . . . . . . . . . . . . . . . . 12
Work with System Value Display—Benefits . . . . . . . . . . . . . 13
Displaying a System Value . . . . . . . . . . . . . . . . . . . 14
Changing a System Value . . . . . . . . . . . . . . . . . . . 14
When Does a System Value Take Effect? . . . . . . . . . . . . . . 16
Retrieving a System Value . . . . . . . . . . . . . . . . . . . 16
Placing System Values in CL Variables. . . . . . . . . . . . . . . 16
Saving System Values . . . . . . . . . . . . . . . . . . . . . 16
System Values—Details . . . . . . . . . . . . . . . . . . . . . 16
QABNORMSW System Value . . . . . . . . . . . . . . . . . . 16
QACGLVL System Value . . . . . . . . . . . . . . . . . . . . 16
QACTJOB System Value . . . . . . . . . . . . . . . . . . . . 17
QADLACTJ System Value . . . . . . . . . . . . . . . . . . . 18
QADLTOTJ System Value . . . . . . . . . . . . . . . . . . . 18
QADLSPLA System Value . . . . . . . . . . . . . . . . . . . 18
QALWOBJRST System Value . . . . . . . . . . . . . . . . . . 18
QALWUSRDMN System Value. . . . . . . . . . . . . . . . . . 19
QASTLVL System Value . . . . . . . . . . . . . . . . . . . . 20
QATNPGM System Value . . . . . . . . . . . . . . . . . . . 20
QAUDCTL System Value . . . . . . . . . . . . . . . . . . . . 20
QAUDENDACN System Value . . . . . . . . . . . . . . . . . . 21
QAUDFRCLVL System Value . . . . . . . . . . . . . . . . . . 22
QAUDLVL System Value . . . . . . . . . . . . . . . . . . . . 22
QAUTOCFG System Value . . . . . . . . . . . . . . . . . . . 24
QAUTORMT System Value . . . . . . . . . . . . . . . . . . . 25
QAUTOSPRPT System Value . . . . . . . . . . . . . . . . . . 25

© Copyright IBM Corp. 1997, 1999 iii

 QAUTOVRT System Value . . . . . . . . . . . . . . . . . . . 26
QBASACTLVL System Value . . . . . . . . . . . . . . . . . . 26
QBASPOOL System Value . . . . . . . . . . . . . . . . . . . 27
QBOOKPATH System Value . . . . . . . . . . . . . . . . . . 27
QCCSID System Value . . . . . . . . . . . . . . . . . . . . 27
QCENTURY System Value . . . . . . . . . . . . . . . . . . . 28
QCFGMSGQ System Value . . . . . . . . . . . . . . . . . . . 28
QCHRID System Value . . . . . . . . . . . . . . . . . . . . 29
QCHRIDCTL System Value . . . . . . . . . . . . . . . . . . . 29
QCMNARB System Value . . . . . . . . . . . . . . . . . . . 30
QCMNRCYLMT System Value . . . . . . . . . . . . . . . . . . 30
QCNTRYID System Value . . . . . . . . . . . . . . . . . . . 31
QCONSOLE System Value . . . . . . . . . . . . . . . . . . . 31
QCRTAUT System Value . . . . . . . . . . . . . . . . . . . . 31
QCRTOBJAUD System Value . . . . . . . . . . . . . . . . . . 32
QCTLSBSD System Value . . . . . . . . . . . . . . . . . . . 33
QCURSYM System Value . . . . . . . . . . . . . . . . . . . 33
QDATE System Value . . . . . . . . . . . . . . . . . . . . . 34
QDATFMT System Value . . . . . . . . . . . . . . . . . . . . 34
QDATSEP System Value . . . . . . . . . . . . . . . . . . . . 34
QDAY System Value . . . . . . . . . . . . . . . . . . . . . 35
QDAYOFWEEK System Value . . . . . . . . . . . . . . . . . . 35
QDBRCVYWT System Value . . . . . . . . . . . . . . . . . . 35
QDECFMT System Value. . . . . . . . . . . . . . . . . . . . 36
QDEVNAMING System Value . . . . . . . . . . . . . . . . . . 36
QDEVRCYACN System Value . . . . . . . . . . . . . . . . . . 37
QDSCJOBITV System Value . . . . . . . . . . . . . . . . . . 38
QDSPSGNINF System Value . . . . . . . . . . . . . . . . . . 38
QDYNPTYADJ System Value . . . . . . . . . . . . . . . . . . 38
QDYNPTYSCD System Value . . . . . . . . . . . . . . . . . . 39
QFRCCVNRST System Value . . . . . . . . . . . . . . . . . . 39
QHOUR System Value. . . . . . . . . . . . . . . . . . . . . 40
QHSTLOGSIZ System Value . . . . . . . . . . . . . . . . . . 40
QIGC System Value . . . . . . . . . . . . . . . . . . . . . 40
QIGCCDEFNT System Value . . . . . . . . . . . . . . . . . . 40
QIGCFNTSIZ System Value. . . . . . . . . . . . . . . . . . . 41
QINACTITV System Value . . . . . . . . . . . . . . . . . . . 41
QINACTMSGQ System Value . . . . . . . . . . . . . . . . . . 42
QIPLDATTIM System Value . . . . . . . . . . . . . . . . . . . 43
QIPLSTS System Value . . . . . . . . . . . . . . . . . . . . 43
QIPLTYPE System Value . . . . . . . . . . . . . . . . . . . . 44
QJOBMSGQFL System Value . . . . . . . . . . . . . . . . . . 44
QJOBMSGQMX System Value. . . . . . . . . . . . . . . . . . 44
QJOBMSGQSZ System Value . . . . . . . . . . . . . . . . . . 45
QJOBMSGQTL System Value . . . . . . . . . . . . . . . . . . 45
QJOBSPLA System Value . . . . . . . . . . . . . . . . . . . 45
QKBDBUF System Value . . . . . . . . . . . . . . . . . . . . 45
QKBDTYPE System Value . . . . . . . . . . . . . . . . . . . 46
QLANGID System Value . . . . . . . . . . . . . . . . . . . . 46
QLEAPADJ System Value . . . . . . . . . . . . . . . . . . . 46
QLMTDEVSSN System Value . . . . . . . . . . . . . . . . . . 46
QLMTSECOFR System Value . . . . . . . . . . . . . . . . . . 47
QLOCALE System Value . . . . . . . . . . . . . . . . . . . . 47
QMAXACTLVL System Value . . . . . . . . . . . . . . . . . . 47
QMAXSGNACN System Value . . . . . . . . . . . . . . . . . . 48
QMAXSIGN System Value . . . . . . . . . . . . . . . . . . . 48

iv OS/400 Work Management V4R4

QMCHPOOL System Value . . . . . . . . . . . . . . . . . . . 49
QMINUTE System Value . . . . . . . . . . . . . . . . . . . . 50
QMLTTHDACN System Value . . . . . . . . . . . . . . . . . . 50
QMODEL System Value . . . . . . . . . . . . . . . . . . . . 50
QMONTH System Value . . . . . . . . . . . . . . . . . . . . 51
QPASTHRSVR System Value . . . . . . . . . . . . . . . . . . 51
QPFRADJ System Value . . . . . . . . . . . . . . . . . . . . 51
QPRBFTR System Value . . . . . . . . . . . . . . . . . . . . 52
QPRBHLDITV System Value . . . . . . . . . . . . . . . . . . 53
QPRCFEAT System Value . . . . . . . . . . . . . . . . . . . 53
QPRCMLTTSK System Value . . . . . . . . . . . . . . . . . . 53
QPRTDEV System Value . . . . . . . . . . . . . . . . . . . . 53
QPRTKEYFMT System Value . . . . . . . . . . . . . . . . . . 54
QPRTTXT System Value . . . . . . . . . . . . . . . . . . . . 54
QPWDEXPITV System Value . . . . . . . . . . . . . . . . . . 54
QPWDLMTAJC System Value . . . . . . . . . . . . . . . . . . 55
QPWDLMTCHR System Value. . . . . . . . . . . . . . . . . . 55
QPWDLMTREP System Value . . . . . . . . . . . . . . . . . . 56
QPWDMAXLEN System Value . . . . . . . . . . . . . . . . . . 56
QPWDMINLEN System Value . . . . . . . . . . . . . . . . . . 56
QPWDPOSDIF System Value . . . . . . . . . . . . . . . . . . 57
QPWDRQDDGT System Value . . . . . . . . . . . . . . . . . 57
QPWDRQDDIF System Value . . . . . . . . . . . . . . . . . . 58
QPWDVLDPGM System Value. . . . . . . . . . . . . . . . . . 58
QPWRDWNLMT System Value . . . . . . . . . . . . . . . . . 59
QPWRRSTIPL System Value . . . . . . . . . . . . . . . . . . 59
QQRYDEGREE System Value . . . . . . . . . . . . . . . . . . 60
QQRYTIMLMT System Value . . . . . . . . . . . . . . . . . . 60
QRCLSPLSTG System Value . . . . . . . . . . . . . . . . . . 61
QRETSVRSEC System Value . . . . . . . . . . . . . . . . . . 61
QRMTIPL System Value . . . . . . . . . . . . . . . . . . . . 61
QRMTSIGN System Value . . . . . . . . . . . . . . . . . . . 62
QRMTSRVATR System Value . . . . . . . . . . . . . . . . . . 62
QSCPFCONS System Value . . . . . . . . . . . . . . . . . . 63
QSECOND System Value . . . . . . . . . . . . . . . . . . . 63
QSECURITY System Value . . . . . . . . . . . . . . . . . . . 63
QSETJOBATR System Value . . . . . . . . . . . . . . . . . . 64
QSFWERRLOG System Value . . . . . . . . . . . . . . . . . . 64
QSPCENV System Value. . . . . . . . . . . . . . . . . . . . 65
QSRLNBR System Value . . . . . . . . . . . . . . . . . . . . 65
QSRTSEQ System Value. . . . . . . . . . . . . . . . . . . . 65
QSTGLOWACN System Value . . . . . . . . . . . . . . . . . . 66
QSTGLOWLMT System Value . . . . . . . . . . . . . . . . . . 66
QSTRPRTWTR System Value . . . . . . . . . . . . . . . . . . 67
QSTRUPPGM System Value . . . . . . . . . . . . . . . . . . 67
QSRVDMP System Value . . . . . . . . . . . . . . . . . . . 68
QSTSMSG System Value . . . . . . . . . . . . . . . . . . . 68
QSVRAUTITV System Value . . . . . . . . . . . . . . . . . . 68
QSYSLIBL System Value . . . . . . . . . . . . . . . . . . . . 68
QTIME System Value . . . . . . . . . . . . . . . . . . . . . 69
QTIMSEP System Value . . . . . . . . . . . . . . . . . . . . 70
QTOTJOB System Value . . . . . . . . . . . . . . . . . . . . 70
QTSEPOOL System Value . . . . . . . . . . . . . . . . . . . 71
QUPSDLYTIM System Value . . . . . . . . . . . . . . . . . . 71
QUPSMSGQ System Value . . . . . . . . . . . . . . . . . . . 73
QUSEADPAUT System Value . . . . . . . . . . . . . . . . . . 74

Contents v
 QUSRLIBL System Value. . . . . . . . . . . . . . . . . . . . 75
QUTCOFFSET System Value . . . . . . . . . . . . . . . . . . 75
QYEAR System Value . . . . . . . . . . . . . . . . . . . . . 76

Chapter 3. Network Attributes —Introduction . . . . . . . . . . . . 77

Shipped Network Attributes . . . . . . . . . . . . . . . . . . . . 77
Displaying Network Attributes . . . . . . . . . . . . . . . . . . . 78
Changing Network Attributes . . . . . . . . . . . . . . . . . . . 78
Retrieving Network Attributes . . . . . . . . . . . . . . . . . . . 79

Chapter 4. Subsystems . . . . . . . . . . . . . . . . . . . . . 81
Subsystem Introduction . . . . . . . . . . . . . . . . . . . . . 81
Restoring Customization Information During an Installation . . . . . . . 81
Subsystem Descriptions . . . . . . . . . . . . . . . . . . . . 81
Subsystem Description–Overview. . . . . . . . . . . . . . . . . 82
Creating a Subsystem Description . . . . . . . . . . . . . . . . 83
Starting a Subsystem . . . . . . . . . . . . . . . . . . . . . 83
How a Subsystem Starts . . . . . . . . . . . . . . . . . . . . 83
Subsystem Monitor Job . . . . . . . . . . . . . . . . . . . . 84
Ending a Subsystem . . . . . . . . . . . . . . . . . . . . . 84
Deleting a Subsystem Description . . . . . . . . . . . . . . . . 85
Active and Inactive Subsystems . . . . . . . . . . . . . . . . . 85
Changing the Sign-On Display File . . . . . . . . . . . . . . . . 85
Storage Pools . . . . . . . . . . . . . . . . . . . . . . . . . 87
Shared Storage Pools . . . . . . . . . . . . . . . . . . . . . 87
Private Storage Pools . . . . . . . . . . . . . . . . . . . . . 87
Storage Pools—Benefits . . . . . . . . . . . . . . . . . . . . 88
Changing the Size of a Storage Pool . . . . . . . . . . . . . . . 88
How Data Is Handled in Storage Pools. . . . . . . . . . . . . . . 89
Subsystem Monitor Storage Pools . . . . . . . . . . . . . . . . 89
Pool Allocation. . . . . . . . . . . . . . . . . . . . . . . . 90
Pool Numbering Schemes . . . . . . . . . . . . . . . . . . . 90
How to Number Pools . . . . . . . . . . . . . . . . . . . . . 91
Activity Levels of Storage Pools . . . . . . . . . . . . . . . . . . 92
How Activity Levels Work . . . . . . . . . . . . . . . . . . . . 93
Controlling Levels of System Activity . . . . . . . . . . . . . . . . 93
What Is Considered an Active Job? . . . . . . . . . . . . . . . . 94
Activity Control Examples . . . . . . . . . . . . . . . . . . . 94
Work Entries . . . . . . . . . . . . . . . . . . . . . . . . . 95
Autostart Job Entry . . . . . . . . . . . . . . . . . . . . . . 95
Adding Autostart Job Entries . . . . . . . . . . . . . . . . . . 95
Changing Autostart Job Entries . . . . . . . . . . . . . . . . . 96
Removing Autostart Job Entries . . . . . . . . . . . . . . . . . 96
Workstation Entry . . . . . . . . . . . . . . . . . . . . . . 96
Adding Workstation Entries . . . . . . . . . . . . . . . . . . . 96
Changing Workstation Entries . . . . . . . . . . . . . . . . . . 96
Removing Workstation Entries . . . . . . . . . . . . . . . . . . 96
Job Queue Entry . . . . . . . . . . . . . . . . . . . . . . . 98
Adding Job Queue Entries . . . . . . . . . . . . . . . . . . . 98
Changing Job Queue Entries . . . . . . . . . . . . . . . . . . 98
Removing Job Queue Entries . . . . . . . . . . . . . . . . . . 98
Adding Communications Entries . . . . . . . . . . . . . . . . . 98
Changing Communications Entries . . . . . . . . . . . . . . . . 99
Removing Communications Entries . . . . . . . . . . . . . . . . 99
Prestart Job Entry . . . . . . . . . . . . . . . . . . . . . . 99
Adding Prestart Job Entries . . . . . . . . . . . . . . . . . . . 100

vi OS/400 Work Management V4R4

 Changing a Prestart Job Entry . . . . . . . . . . . . . . . . . . 100
Removing a Prestart Job Entry . . . . . . . . . . . . . . . . . 100
Routing Entries . . . . . . . . . . . . . . . . . . . . . . . . 100
Adding Routing Entries . . . . . . . . . . . . . . . . . . . . 100
Changing Routing Entries . . . . . . . . . . . . . . . . . . . 100
Removing Routing Entries . . . . . . . . . . . . . . . . . . . 100
Routing Entry Values . . . . . . . . . . . . . . . . . . . . . 101
Workstation Device Allocation . . . . . . . . . . . . . . . . . . . 103
When the subsystem starts . . . . . . . . . . . . . . . . . . . 103
More than one subsystem . . . . . . . . . . . . . . . . . . . 103
After a user has signed on . . . . . . . . . . . . . . . . . . . 103
Job Queue Allocation . . . . . . . . . . . . . . . . . . . . . . 105
Relationship between Job Queues and Subsystems . . . . . . . . . . 106
Placing a Job on the Job Queue . . . . . . . . . . . . . . . . . 106
Moving a Job to a Different Job Queue . . . . . . . . . . . . . . 107
Specifying Attributes of a Batch Job . . . . . . . . . . . . . . . . 107
Adding a Second Job Queue . . . . . . . . . . . . . . . . . . 107
Communications Devices and Mode Allocation . . . . . . . . . . . . . 108
Rules for Device/Mode Allocation . . . . . . . . . . . . . . . . . 108
Deallocation of a Communications Device . . . . . . . . . . . . . 108
Causing a Subsystem to Deallocate a Communications Device . . . . . . 109
The Controlling Subsystem . . . . . . . . . . . . . . . . . . . . 109
The Restricted Condition . . . . . . . . . . . . . . . . . . . . 109
Creating Another Subsystem Description for the Controlling Subsystem. . . 110
Retrieving the Sign-On Information in an Application Program . . . . . . 111
Changing the Number of Jobs Allowed in a Subsystem. . . . . . . . . 111
Allowing More Batch Jobs to Run. . . . . . . . . . . . . . . . . 112
User Sign-Ons. . . . . . . . . . . . . . . . . . . . . . . . 112
Controlling the Initial Workstation Display . . . . . . . . . . . . . . 112
Preventing Request End or Sign-Off. . . . . . . . . . . . . . . . 114
Preventing Sign-On Display from QINTER Subsystem . . . . . . . . . 114
Controlling a Group of Workstations Separately . . . . . . . . . . . 115
Considerations for Using Multiple Subsystems . . . . . . . . . . . . 115
Controlling Initial Program Load (IPL) . . . . . . . . . . . . . . . 115
Mixing Double-Byte and Alphanumeric Display Stations . . . . . . . . 118
Interactive Subsystem Example . . . . . . . . . . . . . . . . . 119

Chapter 5. Jobs . . . . . . . . . . . . . . . . . . . . . . . . 121

Types of Jobs—Overview . . . . . . . . . . . . . . . . . . . . 121
Job Names . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Job Name Syntax . . . . . . . . . . . . . . . . . . . . . . 122
Job User Identity . . . . . . . . . . . . . . . . . . . . . . . 123
Job Commands . . . . . . . . . . . . . . . . . . . . . . . . 124
Changing Job Attributes . . . . . . . . . . . . . . . . . . . . 124
Changing Priority and Time Slice . . . . . . . . . . . . . . . . . 124
Finding a Job . . . . . . . . . . . . . . . . . . . . . . . . 125
Determining Status of a Job. . . . . . . . . . . . . . . . . . . 125
Displaying Messages . . . . . . . . . . . . . . . . . . . . . 125
Notification Messages for Jobs. . . . . . . . . . . . . . . . . . 126
Viewing a Job’s Output . . . . . . . . . . . . . . . . . . . . 126
Ending a Job . . . . . . . . . . . . . . . . . . . . . . . . 126
Job Tables . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Job Table Entries. . . . . . . . . . . . . . . . . . . . . . . 128
Displaying Job Tables . . . . . . . . . . . . . . . . . . . . . 128
Job Starting and Routing . . . . . . . . . . . . . . . . . . . . . 128
Routing Steps . . . . . . . . . . . . . . . . . . . . . . . . 129

Contents vii
 Sources of Routing Data . . . . . . . . . . . . . . . . . . . . 129
Specifying Routing Data . . . . . . . . . . . . . . . . . . . . 130
Routing Program . . . . . . . . . . . . . . . . . . . . . . . 130
Job Attributes (Job Description Object) . . . . . . . . . . . . . . . . 130
How Job Attributes Are Controlled . . . . . . . . . . . . . . . . 131
Controlling Job Attributes . . . . . . . . . . . . . . . . . . . . 131
Job Attributes—Benefits . . . . . . . . . . . . . . . . . . . . 131
Job Description . . . . . . . . . . . . . . . . . . . . . . . . 132
Creating a Job Description . . . . . . . . . . . . . . . . . . . 132
Changing Job Descriptions . . . . . . . . . . . . . . . . . . . 132
Job Description Uses . . . . . . . . . . . . . . . . . . . . . 132
Job Description Commands . . . . . . . . . . . . . . . . . . . 133
Job Descriptions and Security . . . . . . . . . . . . . . . . . . 133
Class Object . . . . . . . . . . . . . . . . . . . . . . . . . 134
Creating a Class . . . . . . . . . . . . . . . . . . . . . . . 134
Changing a Class . . . . . . . . . . . . . . . . . . . . . . 134
Run-Time Attributes . . . . . . . . . . . . . . . . . . . . . . 134
Priority for Jobs—Tips . . . . . . . . . . . . . . . . . . . . . 135
Relationships Among Job, Class, and Subsystem Descriptions . . . . . . . 136
Job Rerouting and Transferring . . . . . . . . . . . . . . . . . . 137
Job Rerouting—Benefits . . . . . . . . . . . . . . . . . . . . 137
When Interactive Jobs Reroute . . . . . . . . . . . . . . . . . 137
Transferring Jobs. . . . . . . . . . . . . . . . . . . . . . . 137
Job Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
Controlling Information in a Job Log . . . . . . . . . . . . . . . . 139
Message Filtering . . . . . . . . . . . . . . . . . . . . . . 139
Job Log Heading . . . . . . . . . . . . . . . . . . . . . . . 142
Job Log—Example . . . . . . . . . . . . . . . . . . . . . . 143
Displaying the Job Log . . . . . . . . . . . . . . . . . . . . 143
Job Log Display Characteristics . . . . . . . . . . . . . . . . . 144
Job Log Display Uses . . . . . . . . . . . . . . . . . . . . . 144
Changing the Output Queue for All Jobs . . . . . . . . . . . . . . 145
Specifying the Output Queue for a Job Log . . . . . . . . . . . . . 145
Holding Job Logs . . . . . . . . . . . . . . . . . . . . . . 145
Deleting a Job Log . . . . . . . . . . . . . . . . . . . . . . 145
Job Log—Tips . . . . . . . . . . . . . . . . . . . . . . . . 145
Interactive Job Logs . . . . . . . . . . . . . . . . . . . . . 146
Batch Job Logs . . . . . . . . . . . . . . . . . . . . . . . 147
QHST History Log . . . . . . . . . . . . . . . . . . . . . . 147
Accessing Message Data. . . . . . . . . . . . . . . . . . . . 151
No Job Log? Message CPF1164 . . . . . . . . . . . . . . . . . 152
Getting Job Logs in One Output Queue . . . . . . . . . . . . . . 153
Changing Logging Level for a Job . . . . . . . . . . . . . . . . 153
Preventing the Production of Job Logs . . . . . . . . . . . . . . . 154
Deleting Log Files . . . . . . . . . . . . . . . . . . . . . . 154
Delete Log (DLTLOG)—Example . . . . . . . . . . . . . . . . . 155
DLTLOGC CL Program Source Statements—Example . . . . . . . . . 155

Chapter 6. Interactive Jobs . . . . . . . . . . . . . . . . . . . 157

Initiating An Interactive Job . . . . . . . . . . . . . . . . . . . . 157
Interactive Job Initiation . . . . . . . . . . . . . . . . . . . . 158
How an Interactive Job Starts . . . . . . . . . . . . . . . . . . 158
Interactive Jobs and Routing Step . . . . . . . . . . . . . . . . . 159
Subsystem Activity . . . . . . . . . . . . . . . . . . . . . . 159
Interactive Job Approaches . . . . . . . . . . . . . . . . . . . 161
Which Program Should Control the Routing Step? . . . . . . . . . . 165

viii OS/400 Work Management V4R4

 Should Routing Be Workstation- or User-Based? . . . . . . . . . . . 166
Initial Program Uses . . . . . . . . . . . . . . . . . . . . . 166
Ending Interactive Jobs . . . . . . . . . . . . . . . . . . . . 167
Jobs Ending at the Same Time . . . . . . . . . . . . . . . . . 168
Automatically Ending Inactive Interactive Jobs . . . . . . . . . . . . 168
Controlling Inactive Jobs . . . . . . . . . . . . . . . . . . . . 169
Inactive Workstation . . . . . . . . . . . . . . . . . . . . . 169
Transaction . . . . . . . . . . . . . . . . . . . . . . . . . 169
Handling Inactive Jobs. . . . . . . . . . . . . . . . . . . . . 169
Avoiding a Long-Running Function from a Workstation . . . . . . . . . 170

Chapter 7. Group Jobs . . . . . . . . . . . . . . . . . . . . . 171

Group Jobs Starting from a Workstation . . . . . . . . . . . . . . . 171
Group Job—Benefits . . . . . . . . . . . . . . . . . . . . . . 171
Group Job Concepts . . . . . . . . . . . . . . . . . . . . . . 172
Changing to and from a Group Job . . . . . . . . . . . . . . . . . 172
Creating a New Group Job . . . . . . . . . . . . . . . . . . . . 172
Transferring from One Group Job to Another . . . . . . . . . . . . . 172
Transferring Control from One Group Job to Another . . . . . . . . . . 172
Transferring to Another Group Job without Seeing a Menu . . . . . . . 173
Ending a Group Job . . . . . . . . . . . . . . . . . . . . . . 173
Ensuring a Normal Group Job End . . . . . . . . . . . . . . . . 173
Group Job Theory . . . . . . . . . . . . . . . . . . . . . . . 174
Allowing Group Jobs to Communicate . . . . . . . . . . . . . . . . 174
Calling a Group Job. . . . . . . . . . . . . . . . . . . . . . . 174
Group Jobs and a Secondary Interactive Job . . . . . . . . . . . . . 174
Group Job and System Request Function. . . . . . . . . . . . . . . 175
Group Jobs Application Scenario . . . . . . . . . . . . . . . . . . 176
Group Job Approach . . . . . . . . . . . . . . . . . . . . . 177
Attention-Key-Handling Program . . . . . . . . . . . . . . . . . . 180
Identifying a Program as Attention-Key-Handling . . . . . . . . . . . 180
Effect of Call Level on Attention Key Status . . . . . . . . . . . . . 180
SETATNPGM at Different Call Levels—Scenario . . . . . . . . . . . 180
When to Use the Attention Key . . . . . . . . . . . . . . . . . 181
When Not to Use the Attention Key . . . . . . . . . . . . . . . . 182
Attention Key and BASIC Session . . . . . . . . . . . . . . . . 182
Attention-Key-Handling Programs—Coding Tips . . . . . . . . . . . 182
Group Job Performance Tips . . . . . . . . . . . . . . . . . . . 183
Designing an Attention-Key-Handling Program . . . . . . . . . . . . . 184
Fixed Menu Approach . . . . . . . . . . . . . . . . . . . . . 184
Dynamic Menu Approach . . . . . . . . . . . . . . . . . . . . 188
Combination (Fixed and Dynamic) Menu Approach . . . . . . . . . . 189

Chapter 8. Batch Jobs . . . . . . . . . . . . . . . . . . . . . 195

Submitting a Batch Job . . . . . . . . . . . . . . . . . . . . . 195
Submit a Batch Job—Example. . . . . . . . . . . . . . . . . . . 195
How a Batch Job Starts . . . . . . . . . . . . . . . . . . . . . 196
Specifying Attributes of a Batch Job . . . . . . . . . . . . . . . . . 197
Input and Output Spooling . . . . . . . . . . . . . . . . . . . . 197
Input Spooling . . . . . . . . . . . . . . . . . . . . . . . . 197
Output Spooling . . . . . . . . . . . . . . . . . . . . . . . 197
Batch Job Routing Approaches . . . . . . . . . . . . . . . . . . 206
Control Routing Step for Batch Jobs Using SBMJOB Command . . . . . 207
Batch Jobs Submitted Using QCMD/QSYS . . . . . . . . . . . . . 207

Chapter 9. Autostart Jobs . . . . . . . . . . . . . . . . . . . . 211

Contents ix
 Autostart Job—Benefits . . . . . . . . . . . . . . . . . . . . . 211
Security and Autostart Job Entries . . . . . . . . . . . . . . . . . 211
Autostart Job Initiation . . . . . . . . . . . . . . . . . . . . . . 211

Chapter 10. Communications Jobs . . . . . . . . . . . . . . . . 213

Communications Job Initiation . . . . . . . . . . . . . . . . . . . 213
Routing Data for Communications Jobs . . . . . . . . . . . . . . 213
Communications Jobs and Security . . . . . . . . . . . . . . . . . 213
Job Description for Communications Jobs . . . . . . . . . . . . . 213
Communications Batch Job Routing . . . . . . . . . . . . . . . . 215

Chapter 11. Prestart Jobs . . . . . . . . . . . . . . . . . . . . 217

Prestart Job—Benefits . . . . . . . . . . . . . . . . . . . . . . 217
Prestart Job Initiation . . . . . . . . . . . . . . . . . . . . . . 217
Number of Prestart Jobs . . . . . . . . . . . . . . . . . . . . 218
Starting a Prestart Job . . . . . . . . . . . . . . . . . . . . . 218
Queuing or Rejecting Program Start Requests . . . . . . . . . . . . 219
Excessive Prestart Jobs . . . . . . . . . . . . . . . . . . . . 219
Program Start Request Received . . . . . . . . . . . . . . . . . 219
Security and Prestart Jobs . . . . . . . . . . . . . . . . . . . 220
Prestart Job Object Authorization . . . . . . . . . . . . . . . . . 220
Performance Tips for Prestart Jobs . . . . . . . . . . . . . . . . . 220
Prestart Job Attributes . . . . . . . . . . . . . . . . . . . . . 221
Job Accounting and Prestart Jobs . . . . . . . . . . . . . . . . 221
Prestart Job Name . . . . . . . . . . . . . . . . . . . . . . 221
Ending a Prestart Job . . . . . . . . . . . . . . . . . . . . . 222

Chapter 12. Job Scheduling . . . . . . . . . . . . . . . . . . . 223

Scheduling a Job. . . . . . . . . . . . . . . . . . . . . . . . 223
Printing a List of Scheduled Jobs . . . . . . . . . . . . . . . . . . 223
Why Schedule Jobs? . . . . . . . . . . . . . . . . . . . . . . 223
SBMJOB Command to Schedule Jobs—Benefits . . . . . . . . . . . 224
Job Schedule Entry—Benefits . . . . . . . . . . . . . . . . . . 224
System Availability and Job Scheduling . . . . . . . . . . . . . . . 224
SBMJOB Scheduled Jobs . . . . . . . . . . . . . . . . . . . . 225
How Jobs Are Scheduled Using SBMJOB . . . . . . . . . . . . . 225
Scheduled Jobs and a Cleared Job Queue . . . . . . . . . . . . . 225
Job Schedule Entry . . . . . . . . . . . . . . . . . . . . . . . 225
Adding a Job Schedule Entry . . . . . . . . . . . . . . . . . . 226
Changing a Job Schedule Entry . . . . . . . . . . . . . . . . . 226
Holding, Releasing, or Removing a Job Schedule Entry . . . . . . . . 227
Working with a Job Schedule Entry . . . . . . . . . . . . . . . . 227
Job Schedule Entry Commands . . . . . . . . . . . . . . . . . 227
Job Schedule Object . . . . . . . . . . . . . . . . . . . . . 228
Saving and Restoring Job Schedule Objects . . . . . . . . . . . . 228
Non-Default Values Used with a Job Schedule Entry . . . . . . . . . 228
Different Calendars on Different Systems—Tips . . . . . . . . . . . 229
Job Schedule Entry Examples . . . . . . . . . . . . . . . . . . . 230
Schedule a Job Monthly—Example . . . . . . . . . . . . . . . . 230
Schedule a Job Daily—Example . . . . . . . . . . . . . . . . . 230
Schedule a Job Weekly—Example . . . . . . . . . . . . . . . . 230
Schedule a Job Every Third Monday and Wednesday—Example . . . . . 230
Schedule a Job Every First and Third Monday—Example . . . . . . . . 230
Schedule a Job Every Weekday—Example . . . . . . . . . . . . . 231
Save a Job Schedule Entry—Example . . . . . . . . . . . . . . . 231
Job Schedule Entry Messages . . . . . . . . . . . . . . . . . . . 231

x OS/400 Work Management V4R4

 Adding a Job Schedule Entry . . . . . . . . . . . . . . . . . . 231
Successfully Submitting a Job from a Job Schedule Entry. . . . . . . . 231
Failing to Submit a Job from a Job Schedule Entry . . . . . . . . . . 231
Removing a Job Schedule Entry . . . . . . . . . . . . . . . . . 231
Changes to QDATE and QTIME and Job Schedule Entries . . . . . . . . 233
Moving the date or time backward . . . . . . . . . . . . . . . . 234
Moving the date or time forward . . . . . . . . . . . . . . . . . 234

Chapter 13. System Jobs . . . . . . . . . . . . . . . . . . . . 235

Start-Control-Program-Function (SCPF) System Job . . . . . . . . . . . 235
System Arbiter System Job . . . . . . . . . . . . . . . . . . . . 235
Logical Unit Services (QLUS) System Job . . . . . . . . . . . . . . 236
Work Control Block Table Cleanup (QWCBTCLNUP) System Job . . . . . . 236
Performance Adjustment (QPFRADJ) System Job . . . . . . . . . . . 236
Database Server (QDBSRV01..N) System Jobs . . . . . . . . . . . . 236
Decompress System Object (QDCPOBJ1..N) System Jobs . . . . . . . . 236
Job Schedule (QJOBSCD) System Job . . . . . . . . . . . . . . . 236
System Spool Maintenance (QSPLMAINT) System Job . . . . . . . . . 237
Alert Manager (QALERT) System Job . . . . . . . . . . . . . . . . 237
LU 6.2 Resynchronization (QLUR) System Job. . . . . . . . . . . . . 237
File System (QFILESYS1) System Job. . . . . . . . . . . . . . . . 237
Database Cross-Reference (QDBSRVXR and QDBSRVXR2) System Job . . . 237
Database Parallelism (QQQTEMP1 and QQQTEMP2) System Job . . . . . 238
System Communications (QSYSCOMM1) System Job . . . . . . . . . . 238
Remote File System Communication (Q400FILSVR) System Job . . . . . . 238
Communications Arbiters (QCMNARB01.....N) . . . . . . . . . . . . . 238
Displaying Information about System Jobs . . . . . . . . . . . . . . 238

Chapter 14. Performance Tuning . . . . . . . . . . . . . . . . . 239

Setting Performance Values Automatically . . . . . . . . . . . . . . 239
Setting Up the System to Adjust Storage Pools and Activity Levels . . . . 239
Dynamic Performance Adjustment . . . . . . . . . . . . . . . . 239
Performance Adjustment at Initial Program Load . . . . . . . . . . . . 240
Setting Up the System to Dynamically Adjust a Storage Pool for an Object
(Expert Cache). . . . . . . . . . . . . . . . . . . . . . . . 240
Using the CHGSHRPOOL Command to Adjust Storage Pool Paging . . . . 241
Setting Performance Values Manually . . . . . . . . . . . . . . . . 242
Setting Initial Tuning Values . . . . . . . . . . . . . . . . . . . . 242
Determining Initial Machine Pool Size . . . . . . . . . . . . . . . 242
Setting Machine Pool Size . . . . . . . . . . . . . . . . . . . 244
Determining Initial User Pool Size . . . . . . . . . . . . . . . . 244
Observing System Performance . . . . . . . . . . . . . . . . . . 245
Reviewing Performance . . . . . . . . . . . . . . . . . . . . 246
How to Determine What to Tune . . . . . . . . . . . . . . . . . 246
Job Transition Data . . . . . . . . . . . . . . . . . . . . . . 251
Using the WRKDSKSTS Display to Observe Disk Performance. . . . . . 251
Using the WRKACTJOB Display to Observe System Performance . . . . 252
Advanced Tuning. . . . . . . . . . . . . . . . . . . . . . . 253
Batch Job Storage Guidelines . . . . . . . . . . . . . . . . . . 254
Specifying PURGE(*NO) for Interactive Jobs . . . . . . . . . . . . 254
Separating Batch Work from *BASE . . . . . . . . . . . . . . . . 254
Setting Up Multiple Pools for Interactive Jobs . . . . . . . . . . . . 256
Setting Up a Separate Pool for Casual Users . . . . . . . . . . . . 256
Setting Up Multiple Pools for Batch Jobs . . . . . . . . . . . . . . 257
Controlling Storage Pools and Object Selection . . . . . . . . . . . 257
*BASE in QTSEPOOL . . . . . . . . . . . . . . . . . . . . . 258

Contents xi
 Understanding the Impact of Faulting on Performance . . . . . . . . . 261
Performance Tuning Concepts . . . . . . . . . . . . . . . . . . 261
Thread States . . . . . . . . . . . . . . . . . . . . . . . . 261
Thread State Transitions . . . . . . . . . . . . . . . . . . . . 263
Activity Levels and Ineligible Queues . . . . . . . . . . . . . . . 263
Objects Used by Jobs . . . . . . . . . . . . . . . . . . . . . 264
Process Access Groups . . . . . . . . . . . . . . . . . . . . 264
Time Slice Parameter and Tuning. . . . . . . . . . . . . . . . . 265
PURGE Parameter Affects PAGs . . . . . . . . . . . . . . . . . 265

Chapter 15. Job Accounting . . . . . . . . . . . . . . . . . . . 269

Journal Entries for Job Accounting . . . . . . . . . . . . . . . . . 269
Resource Accounting . . . . . . . . . . . . . . . . . . . . . . 269
Printer File Accounting . . . . . . . . . . . . . . . . . . . . . . 270
Job Accounting Overview. . . . . . . . . . . . . . . . . . . . . 271
How the System Manages Job and Run Priorities. . . . . . . . . . . . 272
Deciding Whether to Use Job Accounting . . . . . . . . . . . . . . . 272
Use Job Accounting Function If... . . . . . . . . . . . . . . . . . 273
Use QHST Messages If... . . . . . . . . . . . . . . . . . . . 273
Accounting Code . . . . . . . . . . . . . . . . . . . . . . . . 273
Resource Accounting Data . . . . . . . . . . . . . . . . . . . . 274
General Accounting Journal Information . . . . . . . . . . . . . . . 274
JB Accounting Journal Information . . . . . . . . . . . . . . . . 275
DP and SP Printer File Accounting Data . . . . . . . . . . . . . . . 277
DP Accounting Journal Information . . . . . . . . . . . . . . . . 277
SP Accounting Journal Information . . . . . . . . . . . . . . . . 277
Batch Processing and Job Accounting . . . . . . . . . . . . . . . . 278
Interactive Processing and Job Accounting . . . . . . . . . . . . . . 279
System Job Processing for Job Accounting . . . . . . . . . . . . . . 279
Setting Up Job Accounting . . . . . . . . . . . . . . . . . . . . 279
Accounting Journal Processing . . . . . . . . . . . . . . . . . . 281
Job Accounting Entries . . . . . . . . . . . . . . . . . . . . 281
Additional Ways to Analyze Job Accounting Data . . . . . . . . . . . . 281
Security and Job Accounting . . . . . . . . . . . . . . . . . . . 282
Authority to Assign Job Accounting Codes . . . . . . . . . . . . . 282
Authority to CHGACGCDE Command . . . . . . . . . . . . . . . 282
Recovery and Job Accounting . . . . . . . . . . . . . . . . . . . 283
Exception . . . . . . . . . . . . . . . . . . . . . . . . . 283
Damaged Job Accounting Journal or Journal Receiver . . . . . . . . . 284
Accessing CPF1303 Message . . . . . . . . . . . . . . . . . . 284

Appendix A. Performance Data . . . . . . . . . . . . . . . . . . 289

Why Collect Performance Data? . . . . . . . . . . . . . . . . . . 289
Introducing Collection Services . . . . . . . . . . . . . . . . . . 289
Why Should I Use Collection Services? . . . . . . . . . . . . . . 291
Where Can I Learn More About Collection Services? . . . . . . . . . 291
Performance Monitor . . . . . . . . . . . . . . . . . . . . . . 292
Preparing to Collect Performance Data. . . . . . . . . . . . . . . . 292
Types of Performance Data to Collect . . . . . . . . . . . . . . . 292
Using Performance Monitor to Collect Performance Data . . . . . . . . . 292
Collecting System Data Only . . . . . . . . . . . . . . . . . . 292
Collecting System and Communications Data . . . . . . . . . . . . 293
Collecting Database Query Data . . . . . . . . . . . . . . . . . 293
Collecting Data on Active Jobs, Tasks, and Threads . . . . . . . . . . 293
How Performance Monitor Collects Data . . . . . . . . . . . . . . 293
Ending Performance Data Collection . . . . . . . . . . . . . . . 293

xii OS/400 Work Management V4R4

Trace Data . . . . . . . . . . . . . . . . . . . . . . . . . . 294
Collecting Trace Data—STRPFRMON . . . . . . . . . . . . . . . 294
Collecting Trace Data—Collection Services . . . . . . . . . . . . . 294
How Tracing Occurs . . . . . . . . . . . . . . . . . . . . . 294
Dumping Trace Data . . . . . . . . . . . . . . . . . . . . . 295
Dumping Trace Data—STRPFRMON . . . . . . . . . . . . . . . 295
Dumping Trace Data—Collection Services . . . . . . . . . . . . . 295
When Trace Data Is Dumped . . . . . . . . . . . . . . . . . . 295
Automatic Performance Data Collection–Performance Monitor . . . . . . . 296
Establishing Automatic Weekly Collection . . . . . . . . . . . . . . 296
Adding or Changing Performance Data Collection. . . . . . . . . . . 296
QPFRCOL Batch Job . . . . . . . . . . . . . . . . . . . . . 296
Using Automatic Data Collection for the First Time . . . . . . . . . . 296
What Does the Performance Monitor Do?. . . . . . . . . . . . . . 297
Performance Monitor Ends . . . . . . . . . . . . . . . . . . . 297
Data Collection Intervals–Performance Monitor . . . . . . . . . . . . . 297
Internal Data Collection Intervals . . . . . . . . . . . . . . . . . 297
Database and Internal Collection Intervals . . . . . . . . . . . . . 298
Performance Monitor During Data Collection . . . . . . . . . . . . 298
Notification of Performance Monitor Status . . . . . . . . . . . . . 298
Database Files and Performance Monitor . . . . . . . . . . . . . . 299
Data Collection Intervals–Collection Services . . . . . . . . . . . . . 299
Estimating Database Storage Requirements for Performance Data . . . . . 299
Collecting System Data Only . . . . . . . . . . . . . . . . . . 300
Collecting System and Communications Data . . . . . . . . . . . . 300
Performance Data Files . . . . . . . . . . . . . . . . . . . . . 301
Collection Services System Category and File Relationships . . . . . . . 301
Performance Data Files Overview . . . . . . . . . . . . . . . . 302
Field Data for Performance Data Files . . . . . . . . . . . . . . . 305

Appendix B. Performance Data—Performance Explorer . . . . . . . . 427

Do I Need Performance Explorer? . . . . . . . . . . . . . . . . . 427
Who Needs Performance Explorer . . . . . . . . . . . . . . . . 427
When You Need Performance Explorer . . . . . . . . . . . . . . 427
Comparison of Explorer to Other Performance Tools . . . . . . . . . . . 428
Performance Explorer and Advisor Functions . . . . . . . . . . . . 428
Performance Explorer and Performance Monitor . . . . . . . . . . . 428
Benefits of Performance Explorer . . . . . . . . . . . . . . . . . . 428
How Performance Explorer Works . . . . . . . . . . . . . . . . . 429
Performance Explorer Definitions . . . . . . . . . . . . . . . . . . 430
General Flow of the Performance Explorer . . . . . . . . . . . . . 431
Creating a Performance Explorer Definition . . . . . . . . . . . . . . 432
Starting the Performance Explorer . . . . . . . . . . . . . . . . . 433
Ending the Performance Explorer. . . . . . . . . . . . . . . . . . 433
Deleting Performance Explorer Data. . . . . . . . . . . . . . . . . 434
Creating and Printing Performance Explorer Reports . . . . . . . . . . 434
Finding Your Performance Explorer Definitions . . . . . . . . . . . . . 434
Performance Data Files . . . . . . . . . . . . . . . . . . . . . 434
Performance Data File Abbreviations . . . . . . . . . . . . . . . 436
File Name–QAYPEREF . . . . . . . . . . . . . . . . . . . . 436
File Name–QAYPERUNI . . . . . . . . . . . . . . . . . . . . 437
File Name–QAYPECOCFG . . . . . . . . . . . . . . . . . . . 439
File Name–QAYPEHWCFG . . . . . . . . . . . . . . . . . . . 439
File Name–QAYPEFQCFG . . . . . . . . . . . . . . . . . . . 440
File Name–QAYPECICFG . . . . . . . . . . . . . . . . . . . 440
File Name–QAYPESTCFG . . . . . . . . . . . . . . . . . . . 440

Contents xiii
 File Name–QAYPETRCFG . . . . . . . . . . . . . . . . . . . 441
File Name–QAYPELCPLX . . . . . . . . . . . . . . . . . . . 441
File Name–QAYPELJOB . . . . . . . . . . . . . . . . . . . . 441
File Name–QAYPELMET . . . . . . . . . . . . . . . . . . . . 441
File Name–QAYPELMI. . . . . . . . . . . . . . . . . . . . . 442
File Name–QAYPELLIC . . . . . . . . . . . . . . . . . . . . 442
File Name–QAYPELNAMT . . . . . . . . . . . . . . . . . . . 442
File Name–QAYPELNUMT . . . . . . . . . . . . . . . . . . . 442
File Name–QAYPEMICPX . . . . . . . . . . . . . . . . . . . 443
File Name–QAYPEEVENT . . . . . . . . . . . . . . . . . . . 443
File Name–QAYPEHWMAP . . . . . . . . . . . . . . . . . . . 443
File Name–QAYPELICI . . . . . . . . . . . . . . . . . . . . 443
File Name–QAYPEMII . . . . . . . . . . . . . . . . . . . . . 444
File Name–QAYPESEGI . . . . . . . . . . . . . . . . . . . . 444
File Name–QAYPETASKI. . . . . . . . . . . . . . . . . . . . 445
File Name–QAYPENMI . . . . . . . . . . . . . . . . . . . . 446
File Name–QAYPENLIC . . . . . . . . . . . . . . . . . . . . 446
File Name–QAYPETIDX . . . . . . . . . . . . . . . . . . . . 447
File Name–QAYPEASM . . . . . . . . . . . . . . . . . . . . 447
File Name–QAYPEBASE . . . . . . . . . . . . . . . . . . . . 448
File Name–QAYPEDASD . . . . . . . . . . . . . . . . . . . . 449
File Name–QAYPEDSRV . . . . . . . . . . . . . . . . . . . . 450
File Name–QAYPEPGFLT . . . . . . . . . . . . . . . . . . . 450
File Name–QAYPERMPM . . . . . . . . . . . . . . . . . . . 450
File Name–QAYPERMSL . . . . . . . . . . . . . . . . . . . . 451
File Name–QAYPES36 . . . . . . . . . . . . . . . . . . . . 451
File Name–QAYPESAR . . . . . . . . . . . . . . . . . . . . 451
File Name–QAYPEUNKWN . . . . . . . . . . . . . . . . . . . 452
File Name–QAYPESTATS . . . . . . . . . . . . . . . . . . . 452
File Name–QAYPEPSUM . . . . . . . . . . . . . . . . . . . 455
File Name–QAYPEPWDW . . . . . . . . . . . . . . . . . . . 456
File Name–QAYPEPPANE . . . . . . . . . . . . . . . . . . . 456
File Name–QAYPELBRKT . . . . . . . . . . . . . . . . . . . 457
File Name–QAYPEMIUSR . . . . . . . . . . . . . . . . . . . 457
File Name–QAYPEMBRKT . . . . . . . . . . . . . . . . . . . 458
File Name–QAYPEMIPTR . . . . . . . . . . . . . . . . . . . 458
File Name–QAYPEUSRDF . . . . . . . . . . . . . . . . . . . 458
File Name–QAYPEHMON . . . . . . . . . . . . . . . . . . . 458
File Name–QAYPEHTOT . . . . . . . . . . . . . . . . . . . . 459
File Name–QAYPERLS . . . . . . . . . . . . . . . . . . . . 459
File Name–QAYPEJVA . . . . . . . . . . . . . . . . . . . . 460
File Name–QAYPEJVCI . . . . . . . . . . . . . . . . . . . . 461
File Name–QAYPEJVMI . . . . . . . . . . . . . . . . . . . . 461
File Name–QAYPEJVNI . . . . . . . . . . . . . . . . . . . . 461

Appendix C. IBM-Supplied Object Contents . . . . . . . . . . . . . 463

IBM-Supplied Classes . . . . . . . . . . . . . . . . . . . . . . 463
IBM-Supplied Job Descriptions. . . . . . . . . . . . . . . . . . . 466
IBM-Supplied Job Queues . . . . . . . . . . . . . . . . . . . . 472
IBM-Supplied Subsystem Descriptions . . . . . . . . . . . . . . . . 473
Restore Customized Information for IBM-Supplied Job Descriptions . . . . . 496
Restore Customized Information for Subsystem Descriptions . . . . . . . 496
Source for CL Start-up Program . . . . . . . . . . . . . . . . . . 498

Appendix D. Characteristics of the Shipped System . . . . . . . . . 499

Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . 499

xiv OS/400 Work Management V4R4

User Profiles . . . . . . . . . . . . . . . . . . . . . . . . . 499
IBM-Supplied Program QSYS/QCMD . . . . . . . . . . . . . . . . 499
The Controlling Subsystem as Shipped by IBM. . . . . . . . . . . . . 499
QSYSWRK Subsystem Monitor . . . . . . . . . . . . . . . . . . 500
QECS Job . . . . . . . . . . . . . . . . . . . . . . . . . 500
The IBM-Supplied QBASE and QCMN Subsystem Descriptions . . . . . . 500
Important System Values Shipped by IBM . . . . . . . . . . . . . . 500
QAUTOCFG . . . . . . . . . . . . . . . . . . . . . . . . 501
QCTLSBSD. . . . . . . . . . . . . . . . . . . . . . . . . 501
QDEVNAMING . . . . . . . . . . . . . . . . . . . . . . . 501
QIPLTYPE . . . . . . . . . . . . . . . . . . . . . . . . . 501
QSECURITY . . . . . . . . . . . . . . . . . . . . . . . . 501
QSPCENV . . . . . . . . . . . . . . . . . . . . . . . . . 502
Subsystem Configurations Shipped by IBM . . . . . . . . . . . . . . 502

Appendix E. Work Management APIs and Exit Programs . . . . . . . . 505

Appendix F. Notices . . . . . . . . . . . . . . . . . . . . . . 509

Programming Interface Information . . . . . . . . . . . . . . . . . 511
Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . 512
513
Programming Books . . . . . . . . . . . . . . . . . . . . . . 513
Communications Books . . . . . . . . . . . . . . . . . . . . . 513

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515

Readers’ Comments — We’d Like to Hear from You. . . . . . . . . . 545

Contents xv
xvi OS/400 Work Management V4R4
About Work Management (SC41–5306)
This book provides programmers with information about how to effectively manage
their system workload by changing work management objects to meet their needs.
This publication also provides guidelines for performance tuning, description of
system values, information on collecting performance data, gathering system use
data, using work entries, and scheduling batch jobs.

Who should read this book

Work Management is for the programmer or application programmer. You should be
familiar with general programming concepts and terminology, and have a general
understanding of the AS/400 system and the OS/400 licensed program. You should
be familiar with the display stations and printers you are using.

AS/400 Operations Navigator

AS/400 Operations Navigator is a powerful graphical interface for Windows clients.
With AS/400 Operations Navigator, you can manage and administer your AS/400
systems from your Windows desktop.

You can use Operations Navigator to manage communications, printing, database,

security, and other system operations. Operations Navigator includes Management
Central for managing multiple AS/400 systems centrally.

Figure 1 shows an example of the Operations Navigator display:

Figure 1. AS/400 Operations Navigator Display

This new interface has been designed to make you more productive and is the only
user interface to new, advanced features of OS/400. Therefore, IBM recommends
that you use AS/400 Operations Navigator, which has online help to guide you.
While this interface is being developed, you may still need to use a traditional
emulator such as PC5250 to do some of your tasks.

© Copyright IBM Corp. 1997, 1999 xvii

Installing Operations Navigator
To use AS/400 Operations Navigator, you must have Client Access installed on your
Windows PC. For help in connecting your Windows PC to your AS/400 system,
consult Client Access Express for Windows - Setup, SC41-5507-00.

AS/400 Operations Navigator is a separately installable component of Client Access

that contains many subcomponents. If you are installing for the first time and you
use the Typical installation option, the following options are installed by default:
v Operations Navigator base support
v Basic operations (messages, printer output, and printers)

To select the subcomponents that you want to install, select the Custom installation
option. (After Operations Navigator has been installed, you can add subcomponents
by using Client Access Selective Setup.)
1. Display the list of currently installed subcomponents in the Component
Selection window of Custom installation or Selective Setup.
2. Select AS/400 Operations Navigator.
3. Select any additional subcomponents that you want to install and continue with
Custom installation or Selective Setup.

After you install Client Access, double-click the AS400 Operations Navigator icon
on your desktop to access Operations Navigator and create an AS/400 connection.

Prerequisite and related information

Use the AS/400 Information Center as your starting point for looking up AS/400
technical information. You can access the Information Center from the AS/400e
Information Center CD-ROM (English version: SK3T-2027) or from one of these
Web sites:
http://www.as400.ibm.com/infocenter
http://publib.boulder.ibm.com/pubs/html/as400/infocenter.htm

The AS/400 Information Center contains important topics such as logical

partitioning, clustering, Java, TCP/IP, Web serving, and secured networks. It also
contains Internet links to Web sites such as the AS/400 Online Library and the
AS/400 Technical Studio. Included in the Information Center is a link that describes
at a high level the differences in information between the Information Center and
the Online Library.

For a list of related publications, see the “Programming Books” on page 513.

How to send your comments

Your feedback is important in helping to provide the most accurate and high-quality
information. If you have any comments about this book or any other AS/400
documentation, fill out the readers’ comment form at the back of this book.
v If you prefer to send comments by mail, use the readers’ comment form with the
address that is printed on the back. If you are mailing a readers’ comment form
from a country other than the United States, you can give the form to the local
IBM branch office or IBM representative for postage-paid mailing.
v If you prefer to send comments by FAX, use either of the following numbers:

xviii OS/400 Work Management V4R4

 – United States and Canada: 1-800-937-3430
– Other countries: 1-507-253-5192
v If you prefer to send comments electronically, use one of these e-mail addresses:
– Comments on books:
RCHCLERK@us.ibm.com
IBMMAIL, to IBMMAIL(USIB56RZ)
– Comments on the AS/400 Information Center:
RCHINFOC@us.ibm.com
Be sure to include the following:
v The name of the book.
v The publication number of the book.
v The page number or topic to which your comment applies.

About Work Management (SC41–5306) xix

xx OS/400 Work Management V4R4
Summary of Changes to Work Management
Summary of Changes to Work Management.

New:
v “QCFGMSGQ System Value” on page 28
This system value allows you to specify the default message queue the system
will use when sending messages for lines, controllers, and devices.
v “QMLTTHDACN System Value” on page 50
This system value controls the action to be taken when a function that may not
be threadsafe is invoked in a job that is running multiple threads
v ALWADDCLU
Allow add to cluster network attribute added to Chapter 3.
v MDMCNTRYID
Modem country identifier network attribute added to Chapter 3.
v QUSRNOMAX
Added QUSRNOMAX to Appendix C, IBM-Supplied Job Queues.
v QUSRWRK
Added QUSRWRK to Appendix C, IBM-Supplied Subsystem Descriptions.

Changed:
v Chapter 2
Updated several system values. Added notes to system values that affect logical
partitions.
v Chapter 3
Modified files to accommodate logical partitions.
v Chapters 4, 5, and 6
Look in “Chapter 4. Subsystems” on page 81, “Chapter 5. Jobs” on page 121,
“Chapter 6. Interactive Jobs” on page 157 for various changes relating to job
management.
v Chapter 14
Modified field sizes.
v Appendix A
Added files and changes related to Collection Services, the new way to gather
performance data.
v Appendix B
Added new performance data files to Performance Data Files. Modified fields to
allow additional task count information.
v Appendix C
Source for QSTRUP modified.
Added information to several IBM-supplied job descriptions

Reminder:
v YEAR 2000

© Copyright IBM Corp. 1997, 1999 xxi

| The QAPMCONF performance data file is the only performance data file that
| contains a century indicator. Data collection is dependent on the start date in
| this file; therefore, you must use this date. See “Year 2000 Considerations” on
| page 294 for details.

xxii OS/400 Work Management V4R4

Chapter 1. Work Management-Introduction
The AS/400 contains many system objects, and the way they interrelate helps
determine the efficiency of your system. Work management functions control the
work done on the system. When the Operating System/400 (OS/400) licensed
program is installed, it includes a work management environment that supports all
interactive and batch work.

Work management supports the commands and internal functions necessary to

control system operation and the daily workload on the system. In addition, work
management contains the functions you need to distribute resources for your
applications so that your system can handle your applications.

Why Learn about Work Management?

AS/400 work management allows you to control the way work is managed on your
system. The OS/400 licensed program allows you to tailor this support or to create
your own work management environment. To do this, you need to understand the
work management concepts.

Because IBM ships all AS/400 systems with everything necessary to run typical
operations, you are not required to learn about work management to use your
system. However, to change the way your system manages work to better meet
your needs, affect the order your jobs are run, solve a problem, improve the
system’s performance, or simply look at jobs on the system, you need an
understanding of work management. In other words, if you understand work
management, you know what affects the various pieces of the system, and how to
change them so they operate most efficiently.

Because of the system’s complexity, learning about work management in stages

could be helpful. You could begin by deciding what work you need the system to do
and how you want that work done.

By keeping it simple from the start, you can avoid becoming frustrated by the
flexibility in the system. As you become comfortable with the concept of work
management, and begin to understand how each of the pieces interrelate, you will
be on your way to getting the most from your AS/400 system.

A Simple System
The purpose of the system is to perform work. Work enters, work is processed, and
work leaves the system. If you think of work management in these three terms,
work management will be easier to understand. Work management describes where
work enters the system, where and with what resources work is processed, and
where output from work goes.

Figure 2 on page 2 shows the concept of a simple system.

© Copyright IBM Corp. 1997, 1999 1

 ┌────────┐ ┌─────────────┐ ┌─────────┐
│ │ │ │ │ │
│ Input │───Ê│ Processing │───Ê│ Output │
│ │ │ │ │ │
└────────┘ └─────────────┘ └─────────┘
Work Work is Work
Enters processed leaves

Figure 2. Simple System

A Complex System
A complex system is many simple systems operating together. Using this definition,
the simple systems within the AS/400 system are the subsystems.

A System as a Business—Scenario
An example of a simple system is a small business. Assume there is a small store
in the business of building hand-crafted wood furniture. Work enters, such as orders
for small tables, chairs, and bookshelves. Work is processed, the carpenter calls
the customers to confirm the order, and they are consulted on design points
including style, size, and color. The carpenter designs each piece of furniture,
gathers the necessary materials, and then builds the furniture. After the furniture is
completed, it is delivered: work leaves.

Since a complex system is a combination of many simple systems, a comparable

example of a complex system is a shopping mall, many small and large businesses
in one area. Maybe the carpenter has a business in the Northwest corner of the
mall and a baker has a business along the East strip. The baker and the carpenter
have different input and different output, that is, their orders and their products are
very different. In addition, the time it takes each business to process their work is
quite different, and their users know and understand that.

Work Management Terms—Scenario

But how is this related to the AS/400 system? A complex system (shopping mall) is
a compilation of many simple systems (stores). On the AS/400 system, these
simple systems are called subsystems.

Any piece of work within the business is considered a job. An example of a piece of
work might be a customer letter, a phone call, an order, or nightly cleanup. The
same is true about the system. On the AS/400 system, each job has a unique
name. A job description describes the work coming into the subsystem. Job
descriptions contain pieces of information such as user IDs, job queues, and routing
data. On the AS/400 system, information in the job description might compare to
descriptions of jobs in a small business.
Table 1. Job Description Analogy
AS/400 System Objects Small Business
User ID Who is the customer?

2 OS/400 Work Management V4R4

Table 1. Job Description Analogy (continued)
AS/400 System Objects Small Business
Job Queue In which mailbox did that arrive?
Job queue priority Is that letter important?
Hold on job queue Can that letter be handled later?
Output queue How will the product be packaged?
Routing data What product will suit this customer’s needs?
Accounting code Does the customer have a credit card?

What does the business look like? Every store has blueprints or store plans. These
plans are really just descriptions, in varying detail, of the physical makeup of the
business. Maybe the business has a store with:
v 2 floors
v 5 doors
v 3 mailboxes
v 2 phones
On the AS/400 system, a subsystem description contains all the information about
the subsystem.

Where does the work come from?

For the carpenter, the work comes from customer calls, from references, and from
people that stop in. On the AS/400 system, the work can come from many places.
Examples include job queues, workstations, communications, autostart jobs, and
prestart jobs.

Where do they find the space?

Within the mall, each business (subsystem) has a certain amount of floor space. On
the AS/400 system, pools allow you to control the main storage (or floor space)
each subsystem (business) gets to do its work. The more floor space a store
(subsystem) has, the more customers, or jobs, can fit in the store.

How does the work come in?

Customers that cannot find the store they need may find an information booth to
help send them in the right direction. The same is true on the AS/400 system.
Routing entries are similar to store directories or an information booth. So after the
routing entry is found, it guides the job to its proper place. The routing entry needs
to be found first, however. That is done through routing data. Routing data is what
the job uses to find the right routing entry.

How is the work treated?

Obviously, the carpenter needs to place a priority on each job. The chair due at the
end of the week should be done before the bookshelf due at the end of the month.
On the AS/400 system, class provides information about how the job is handled
while in the subsystem. This information includes:
v Priority while running
v Maximum storage
v Maximum CPU time

Chapter 1. Work Management-Introduction 3

 v Time slice
v Purge
Each of these attributes contribute to how and when a job is processed.

Just as there are rules that affect all the stores in the mall, there are rules that
affect all the subsystems on the AS/400 system. An example of these rules is a
system value. System values are pieces of information that apply to the whole
system. Information such as:
v Date and time
v Configuration information
v Sign-on information
v System security
v Storage handling

Customers in a mall each have information specific to them. The carpenter decided
to call each customer to discuss the design specs for each piece of furniture. On
the AS/400 system, the user profile holds information specific to a particular user.
Similar to a customer’s credit card, a user profile gives that user specific authorities
and assigns the user attributes for his jobs. These job attributes answer:
v What job description?
v What output queue or printer device?
v What message queue?
v What accounting code?
v What scheduling priority?

Objects Quick Reference

Table 2 shows examples of work management objects and system values and their
related commands. Use this table as a quick reference.
Table 2. Objects and Values Examples and Command Summary
Objects and Values Example Command
System Values QSECURITY WRKSYSVAL
Subsystem Descriptions QSYS/QBASE QSYS/QINTER WRKSBSD
QSYS/QBATCH
Job queues QGPL/QBATCH WRKJOBQ
Job descriptions QGPL/QDFTJOBD QGPL/QBATCH WRKJOBD
Classes QGPL/QINTER QGPL/QBATCH WRKCLS
Jobs 010457/QSECOFR/DSP01 WRKACTJOB
WRKUSRJOB
WRKSBSJOB
SBMJOB
WRKSBMJOB
WRKJOB
User profiles QSECOFR QSYSOPR WRKUSRPRF
Output queues QGPL/QPRINT WRKOUTQ

4 OS/400 Work Management V4R4

Chapter 2. System Values
System values are pieces of information that affect the operating environment in the
entire system. A system value contains control information for the operation of
certain parts of the system. A user can change the system to define the working
environment. System date and library list are examples of system values. System
values are not objects and cannot be passed as parameter values like CL variables.

System Values–Benefits
System values contain specifications that allow you to control or change the overall
operation of your system. For example, you can use the QDATFMT system value to
specify the date format, such as YMD, MDY, DMY, or JUL (JULIAN format).

System Values—Overview
All available system values are arranged by the types, or categories, that appear on
the Work with System Values display:
v Date-and-Time
v Editing
v System Control
v Library List
v Allocation
v Message-and-Logging
v Storage
v Security
A summary table for each category lists each system value, its initial value shipped
with the system, and a reference to a detailed description.

Date-and-Time System Values—Overview

The date-and-time system values allow you to control the date and time on your
system. Date-and-time system values must always be enclosed in apostrophes.

Table 3 shows these values.

Table 3. Date-and-Time System Values
Name Shipped Value Description See Details Type Length
QDATE System date 34 Character 51 or 6
QCENTURY Century 28 Character 1
QYEAR Year 76 Character 2
QMONTH Month of the year 51 Character 2
QDAY Day of the month (or year1) 35 Character 2 or 31
QDAYOFWEEK Day of the week 35 Character 4
QLEAPADJ ’0’ Leap year adjustment 46 Decimal (5 0)
QTIME Time of day 69 Character 6, 7, 8, or
92
QHOUR Hour of the day 40 Character 2
QMINUTE Minute of the hour 50 Character 2
QSECOND Second of the minute 63 Character 2

© Copyright IBM Corp. 1997, 1999 5

Table 3. Date-and-Time System Values (continued)
Name Shipped Value Description See Details Type Length
QUTCOFFSET ’+0000’ Coordinated universal time 75 Character 5
offset. The number of hours
and minutes current system
time is offset from coordinated
universal time.
1
For Julian dates
2
For seconds, tenths, hundredths, and thousandths of a second

Editing System Values—Overview

The editing system values allow you to control the format used for displaying
currency symbols, dates, and decimal values on your system.

Changes to Editing System Values

All changes to the editing system values take effect immediately for new jobs. For
the system value, QCURSYM, the changes also affect active jobs.
Table 4. Editing System Values
Name Shipped Value1 Description See Details Type Length
QCURSYM ’$’ Currency symbol 33 Character 1
QDATFMT ’MDY’ Date format 34 Character 3
QDATSEP ’/’ Date separator 34 Character 1
QDECFMT ’’ Decimal format 36 Character 1
QTIMSEP ’:’ Time separator 70 Character 1
1
The shipped value may be different in different countries.

System Control System Values—Overview

The system control system values allow you to control or display information
specific to your system. Table 5 shows these values.
Table 5. System Control System Values
Name Shipped Value Description See Details Type Length
QABNORMSW ’0’ Previous end of 16 Character 1
system indicator.
QASTLVL ’*BASIC’ Assistance level. Character 10
Specifies the level of
system displays
available.
QATNPGM ’*ASSIST’ Attention program. 20 Character 20
QAUTOCFG ’1’ Automatic 24 Character 1
configuration
indicator.
QAUTORMT ’1’ Automatic 25 Character 1
configuration of
remote controllers.
QAUTOSPRPT ’0’ Automatic problem 25 Character 1
reporting.

6 OS/400 Work Management V4R4

 Table 5. System Control System Values (continued)
Name Shipped Value Description See Details Type Length
QAUTOVRT 0 Number of virtual 26 Decimal (5 0)
devices to be
automatically
configured.
QBOOKPATH ’/QDLS/QBKBOOKS/BOOKS’ Book and bookshelf 27 Character 315
search. Allows a
system book or
bookpath search to
be defined.

QCCSID ’65535’ Coded character set 27 Decimal (10 0)

identifier.
QCHRID ’697 037’1 Default graphic 29 Character 20
character set and
code page used for
displaying or printing
data.
QCHRIDCTL ’*DEVD’ Controls the type of 29 Character 10
conversion that
occurs for display
files, printer files, and
panel groups.
| QCMNARB *CALC Communications 30 Character 10
| arbiters that are
| available to process
| work for
| communications.
QCMNRCYLMT ’0 0’ Provides recovery 30 Character 20
limits for system
communications
recovery.
QCNTRYID US1 Country identifier. 31 Character 2
QCONSOLE ’QCONSOLE’ Console name. 31 Character 10
Cannot be changed.
QCTLSBSD ’QBASE QSYS’ Controlling subsystem 33 Character 20
name.
QDBRCVYWT ’0’ Database recovery 35 Character 1
indicator.
QDEVNAMING ’*NORMAL’ Indicates the device 36 Character 10
naming convention.
QDEVRCYACN ’*DSCMSG’ Specifies what action 37 Character 20
to take when an I/O
error occurs for the
job’s requesting
program device.
QDSCJOBITV ’240’ Time interval, in 38 Character 10
minutes, that a job
can be disconnected
before it ends.
QDYNPTYADJ ’1’ Dynamically adjusts 38 Character 1
the priority of
interactive jobs to
maintain high
performance of batch
job processing.

Chapter 2. System Values 7

 Table 5. System Control System Values (continued)
Name Shipped Value Description See Details Type Length
QDYNPTYSCD ’1’ Allows you to turn on 39 Character 1
and off the dynamic
priority scheduler.
QFRCCVNRST ’0’ Specifies whether or 39 Character 1
not to convert
program objects
during the restore
operation.
QIGC Indicates whether the 40 Character 1
DBCS version of the
system is installed.
QIGCCDEFNT ’*NONE’ Specifies the value of 40 Character 20
the DBCS font name
that should be used
when transforming
SCS DBCS data into
advanced function
printing data stream
(AFPDS) data and
when creating an
AFPDS spooled file
with shift in/shift out
(SI/SO) characters
present in the data.
QIGCFNTSIZ ’*NONE’ Specifies the point 41 Decimal (4 1)
size of the
double-byte character
set (DBCS) coded
font.
QIPLDATTIM ’*NONE’ Date and time to 43 Character 20
automatically IPL the
system.
QIPLSTS ’0’ IPL status indicator. 43 Character 1
Cannot be changed.
QIPLTYPE ’0’ Indicates type of IPL 44 Character 1
to perform.
QKBDBUF ’*TYPEAHEAD’ Specifies the 45 Character 10
keyboard buffering
value to be used
when a job is
initialized.
QKBDTYPE ’USB’1, 2 Specifies a language 46 Character 3
character set for the
keyboard.
QLANGID ’ENU’1 Language identifier. 46 Character 3
QLOCALE ’*NONE’ Locale path name. 47 Character 1024
| QMLTTHDACN 2 Controls the action to 50 Character 1
| be taken when a
| function that may not
| be threadsafe is
| invoked in a job that
| is running multiple
| threads.
QMODEL System model 50 Character 4
number. Cannot be
changed.

8 OS/400 Work Management V4R4

Table 5. System Control System Values (continued)
Name Shipped Value Description See Details Type Length
QPASTHRSVR *CALC Number of target 51 Character 10
display station
pass-through server
jobs.
QPFRADJ ’2’ Performance 51 Character 1
adjustment. Specifies
whether the system
should adjust values
during IPL and at
regular intervals for
system pool sizes
and activity levels.
QPRCFEAT Processor feature. 53 Character 4
Specifies the
processor feature
code level of the
system.
QPRCMLTTSK ’1’ Processor 53 Character 1
multi-tasking. Allows
you to turn on and
turn off processor
multi-tasking
capability.
QPRTDEV ’PRT01’ Default printer device 53 Character 10
description.
QPRTKEYFMT ’*PRTHDR’ Print key format. 54 Character 10
Specifies whether
border and header
information is
provided when the
print key is pressed.
QPWRDWNLMT 600 Maximum amount of 59 Decimal (5 0)
time (in seconds)
allowed for
PWRDWNSYS
*IMMED.
QPWRRSTIPL ’0’ Auto-IPL after power 59 Character 1
restored allowed.
QQRYDEGREE ’*NONE’ Parallel processing 60 Character 10
degree.
QQRYTIMLMT ’*NOMAX’ Query processing 60 Character 10
time limit.
QRMTIPL ’0’ Remote power on 61 Character 1
and IPL indicator.
QRMTSRVATR ’0’ Controls the remote 62 Character 1
system service
problem analysis
ability.
QSCPFCONS ’1’ IPL console indicator. 63 Character 1
QSETJOBATR ’*NONE’ Set job attributes. 64 Character 160
QSPCENV ’*NONE’ Indicates default 65 Character 10
special environment.
QSRLNBR System serial 65 Character 8
number. Cannot be
changed.

Chapter 2. System Values 9

Table 5. System Control System Values (continued)
Name Shipped Value Description See Details Type Length
QSRTSEQ ’*HEX’ Default sort sequence 65 Character 20
to be used by the
system.
QSTRPRTWTR ’1’ Indicates if printer 67 Character 1
writers should be
started. Cannot be
changed.
QSTRUPPGM ’QSTRUP QSYS’ Startup program 67 Character 20
name called from
autostart job in the
controlling subsystem.
QSVRAUTITV 2880 Specifies the time 68 Decimal (6 0)
interval of the server
authentication in
minutes.
QUPSDLYTIM ’*CALC’ Uninterruptible power 71 Character 20
supply delay time.
QUPSMSGQ ’QSYSOPR QSYS’ Message queue for 73 Character 20
uninterruptible power
supply messages.
1
The shipped value may be different in different countries.
2
For United States and Canada (see “QKBDTYPE System Value” on page 46 for other countries).

Library List System Values—Overview

The library list system values allow you to control or display the system and user
parts of the library list. Table 6 shows these values.
Table 6. Library List System Values
Name Shipped Value Description See Details Type Length
QSYSLIBL ’QSYS QSYS2 System part of the library list. 68 Character 150
QHLPSYS
QUSRSYS’
QUSRLIBL ’QGPL QTEMP’ User part of the library list. 75 Character 250

Allocation System Values—Overview

The allocation system values allow you to control the number of jobs and storage
sizes on your system. Table 7 shows these values.
Table 7. Allocation System Values
Name Shipped Value Description See Details Type Length
QACTJOB 20 Initial number of active jobs for 17 Decimal (5 0)
which to allocate storage.
QADLACTJ 10 Additional number of active 18 Decimal (5 0)
jobs for which to allocate
storage.
QADLSPLA 2048 This system value no longer 18 Decimal (5 0)
affects the operating system.
QADLTOTJ 10 Additional total number of jobs 18 Decimal (5 0)
for which to allocate storage.

10 OS/400 Work Management V4R4

 Table 7. Allocation System Values (continued)
Name Shipped Value Description See Details Type Length
QJOBMSGQFL ’*NOWRAP’ Action the system takes when 44 Character 10
the value specified for
QJOBMSGQMX is reached.
QJOBMSGQMX 16 The maximum size to which a 44 Decimal (5 0)
job message queue can grow
(MB).
QJOBMSGQSZ 16 This system value no longer 45 Decimal (5 0)
affects the operating system.
QJOBMSGQTL 24 This system value no longer 45 Decimal (5 0)
affects the operating system.
QJOBSPLA 3516 Initial size of spooling control 45 Decimal (5 0)
block for a job (bytes).
QRCLSPLSTG ’8’ Reclaim spool storage. 61 Character 10
QTOTJOB 30 Initial total number of jobs for 70 Decimal (5 0)
which to allocate storage.

Message-and-Logging System Values—Overview

The message-and-logging system values allow you to control messages and how
they are logged on your system. Table 8 shows these values.
Table 8. Message-and-Logging System Values
Name Shipped Value Description See Details Type Length
QACGLVL ’*NONE’ Accounting level. 16 Character 80
| QCFGMSGQ ’QSYSOPR Configuration message queue 28 Character 20
| QSYS’
QHSTLOGSIZ 5000 Maximum number of records 40 Decimal (5 0)
for each version of the history
log.
QPRBFTR ’*NONE’ Problem filter. 52 Character 20
QPRBHLDITV 30 The minimum retention period 53 Decimal (5 0)
for problems in the problem
log.
QPRTTXT ’*BLANK’ Up to 30 characters of text 54 Character 30
that can be printed at the
bottom of the form.
QSFWERRLOG ’*LOG’ Software error log. 64 Character 10
QSRVDMP ’*DMPUSRJOB’ Control for requesting dumps: 68 Character 10
no jobs, system jobs, user
jobs, or all jobs.
QSTSMSG ’*NORMAL’ Allows user to suppress status 68 Character 10
messages.

Storage System Values—Overview

The storage system values allow you to control storage size and activity levels on
your system. Table 9 shows these values.
Table 9. Storage System Values
See
Name Shipped Value Description Details Type Length
QBASACTLVL 6 Activity level of base storage 26 Decimal (5 0)
pool.
QBASPOOL 2000 Minimum size of base storage 27 Decimal (10 0)
pool (KB).

Chapter 2. System Values 11

Table 9. Storage System Values (continued)
See
Name Shipped Value Description Details Type Length
QMAXACTLVL ’*NOMAX’ Maximum activity level of the 47 Decimal (5 0)
system.
QMCHPOOL 20 000 Machine storage pool size 49 Decimal (10 0)
(KB).
QSTGLOWACN *MSG Auxiliary storage lower limit 66 Character 10
action
QSTGLOWLMT 5.0 Auxiliary storage lower limit 66 Decimal (7 4)
QTSEPOOL ’*NONE’ Time slice end pool. 71 Character 10

Security System Values—Overview

The security system values allow you to control security measures on your system.
Table 10 shows these values.

Changes to Security System Values

To change these system values the user must have *ALLOBJ and *SECADM
special authority, which can be from a user profile or a group profile. It can also be
adopted by a program. To change auditing system values, the user must have
*AUDIT special authority.
Table 10. Security System Values
Name Shipped Value Description See Details Type Length
QALWOBJRST ’*ALL’ Specifies whether or not 18 Character 150
security-sensitive objects can
be restored.
QALWUSRDMN ’*ALL’ Determines which libraries on 19 Character 500
the system may contain
*USRSPC, *USRIDX, and
*USRQ objects.
QAUDCTL ’*NONE’ Controls when auditing is 20 Character 50
active.
QAUDENDACN ’*NOTIFY’ Defines the system’s action 21 Character 10
when the audit records cannot
be sent to the journal because
of errors.
QAUDFRCLVL ’*SYS’ Controls the number of journal 22 Decimal (5 0)
entries written to the security
auditing journal before data is
forced into auxiliary storage.
QAUDLVL ’*NONE’ Controls what actions are 22 Character 160
audited on the system.
QCRTAUT *CHANGE Create authority. Specifies the 31 Character 10
default public authority for
create (CRTxxx) commands
that can be set system-wide.
QCRTOBJAUD ’*NONE’ Specifies the default auditing 32 Character 10
value used when objects are
created in a library.
QDSPSGNINF ’0’ Controls the display of sign-on 38 Character 1
information.
QINACTITV ’*NONE’ Inactive job time-out in 41 Character 10
minutes.

12 OS/400 Work Management V4R4

Table 10. Security System Values (continued)
Name Shipped Value Description See Details Type Length
QINACTMSGQ ’*ENDJOB’ Message queue to receive job 42 Character 20
inactive messages.
QLMTDEVSSN ’0’ Controls the ability to limit 46 Character 1
concurrent device sessions.
QLMTSECOFR ’1’ Controls the ability to limit 47 Character 1
access to workstations for
users with *ALLOBJ or
*SERVICE special authority.
QMAXSGNACN ’3’ Maximum sign-on attempts 48 Character 1
action.
QMAXSIGN ’3’ Maximum number of incorrect 48 Character 6
sign-on attempts allowed.
QPWDEXPITV ’*NOMAX’ Controls the number of days a 54 Character 6
password is valid.
QPWDLMTAJC ’0’ Limits the use of adjacent 55 Character 1
numeric digits in a password.
(’0’ means adjacent digits are
allowed; ’1’ means adjacent
digits are not allowed.)
QPWDLMTCHR ’*NONE’ Limits the use of certain 55 Character 10
characters in a password.
QPWDLMTREP ’0’ Limits the use of repeating 56 Character 1
characters in a password.
QPWDMAXLEN 8 Controls the maximum number 56 Decimal (5 0)
of characters in a password.
QPWDMINLEN 6 Controls the minimum number 56 Decimal (5 0)
of characters in a password.
QPWDPOSDIF ’0’ Controls the position of 57 Character 1
characters in a new password.
This prevents the position of
the characters from being the
same as in previous
passwords.
QPWDRQDDGT ’0’ Controls whether a numeric 57 Character 1
digit is required in a new
password.
QPWDRQDDIF ’0’ Controls whether a password 58 Character 1
must be different than any of
the previous passwords.
QPWDVLDPGM ’*NONE’ Specifies the name of a 58 Character 20
password validation program
supplied by the installation.
QRETSVRSEC ’0’ Retain server security data 61 Character 1
QRMTSIGN ’*FRCSIGNON’ Remote sign-on control. 62 Character 20
QSECURITY ’40’ Indicates security level. 63 Character 2
QUSEADPAUT ’*NONE’ Use adopted authority. 74 Character 10

Work with System Value Display—Benefits

The Work with System Values display makes common tasks like displaying and
changing easy. Using the Work with System Value (WRKSYSVAL) command gives
you the list of all system values, or allows you to subset that list, so you can select
the system value you want to display or change. The WRKSYSVAL command is an
alternative to using either the Display System Value (DSPSYSVAL) or Change
System Value (CHGSYSVAL) command, and you can use it when you are unsure
of the name of the system value you want to affect, or if you want to see the

Chapter 2. System Values 13

 current value before making a change. If a system value is currently being changed,
the system may prevent you from displaying, retrieving, or extracting that specific
system value.

Selecting a List of System Values

To select a list of system values to display:
1. Enter the WRKSYSVAL command.
2. From the Work with System Values display, you can either request a list of all
the system values, or you can get a subset of that list.
v To list all system values, type *ALL in the Subset by Type field.
v To list a subset of system values, enter a type in the Subset by Type field
(press F4 for a list of types).

Displaying a System Value

If you know the name of the system value you want to display, use the Display
System Value (DSPSYSVAL) command.

If you do not know the name of the system value you want to display, use the Work
with System Value (WRKSYSVAL) command to see a list of system values.

Changing a System Value

If you know the name of the system value you want to change, use the Change
System Value (CHGSYSVAL) command.

Note: You can use the CHGSYSVAL command to change system values within CL
programs.

If you do not know the name of the system value you want to change, use the Work
with System Value (WRKSYSVAL) command to see a list of system values. You can
change the system value using option 2 from the Work with System Value display.

Change a System Value—Example

The following CHGSYSVAL command changes the value of the system value
QUSRLIBL:
CHGSYSVAL SYSVAL(QUSRLIBL)
VALUE('DSTPRODLB QGPL QTEMP')

This system value defines the system default for the user part of the initial library
list. The initial library list for new jobs is redefined and DSTPRODLB is placed
before QGPL and QTEMP. The change takes effect immediately for jobs started
after the CHGSYSVAL command is run (but not for jobs that are already active).

CHGSYSVAL Command and Apostrophes

If you are using the CHGSYSVAL command, the values must be enclosed in
apostrophes if:
v The system value specified is a character string with embedded blanks
v Numeric values or special characters are specified for character type system
values
v The system value is a date or time value

14 OS/400 Work Management V4R4

 Specifying System Values in Lists
The system values QACGLVL, QALWUSRDMN, QAUDCTL, QAUDLVL, QCHRID,
QCMNRCYLMT, QSYSLIBL, QUPSDLYTIM, QUSRLIBL, QIPLDATTIM,
QBOOKPATH, and QALWOBJRST may be lists. To separate items in the list, use
blanks and enclose the entire list in apostrophes. If there is only one item in the list,
you do not need apostrophes. The QUPSDLYTIM system value is a list of two items
but only the first item is used when a Change System Value (CHGSYSVAL)
command is run. The second item, if specified, is ignored.

Specifying System Values Qualified with a Library Name

| You can qualify the following system values with a library name: QATNPGM,
| QCFGMSGQ, QCTLSBSD, QIGCCDEFNT, QINACTMSGQ, QPRBFTR,
| QPWDVLDPGM, QRMTSIGN, QSRTSEQ, QSTRUPPGM, and QUPSMSGQ. If the
| system values are qualified, use blanks to separate the name and library. Enclose
| the value in apostrophes (for example, ’SBSD LIB’) and specify the object first,
| followed by the library (’object library’). Apostrophes are necessary only when you
| specify the library name or *LIBL with the object name. If you do not specify the
| library name or if the specified library list is *LIBL, the system uses the library list to
| locate the object. In this case, the library where the object is found is stored in the
| system value.

Object Names Specified For System Values: When object names are specified
for system values, the lowercase letters in the names are always changed to
uppercase even when they are in apostrophes. This means that you should not use
lowercase letters in the names of objects or libraries that you may want to specify
on any of the system values.

System Values—Tips
v How the value is entered on the VALUE parameter depends on whether the
system value is character or numeric. The following rules for specifying the
VALUE parameter apply to system values:
– If a character string contains characters other than alphanumeric characters, a
period, or a comma, it must be enclosed in apostrophes.
– If a list of values is specified as the new value, the list must be enclosed in
apostrophes and separated by blanks.
– If a numeric value or special character is specified for a character type system
value, it must be enclosed in apostrophes.
– Date-and-time values must be enclosed in apostrophes and cannot contain
separators.
– All qualified names in system values should be specified as ’object library’.
v All numeric type system values, except QSTGLOWLMT, must be specified as
whole numbers greater than or equal to 0 and not exceeding 32767.
v If a numeric system value is specified by using a CL variable, the variable must
be decimal.
v A numeric value is not enclosed in apostrophes unless it is specified for a
character type system value.
v Each system value has its own set of limitations on values.
v If a CL variable is used to specify the value for a character type system value,
the CL variable must be character type and may be of any length.
v Values are padded with blanks or truncated, as necessary.

Chapter 2. System Values 15

When Does a System Value Take Effect?
When the system value takes effect depends on which system value it is. Not all
system value changes are used by the system immediately when a system value is
changed. For some values, such as QCTLSBSD, the change takes effect the next
time an IPL is done. To find out when a specific system value takes effect, see
“System Values—Details” for that particular system value.

Retrieving a System Value

To retrieve a system value, use the Retrieve System Value (RTVSYSVAL)
command or the Retrieve System Value (QWCRSVAL) API.

Placing System Values in CL Variables

A system value can be placed in a CL variable for use in a CL program using the
Retrieve System Value (RTVSYSVAL) command. (The CL Programming book
contains more information on using CL variables in programs.)

Saving System Values

You can also save system values using the Save System (SAVSYS) command.
Refer to the Backup and Recovery book for information about saving system
values.

System Values—Details

QABNORMSW System Value

QABNORMSW is the previous end of system indicator. This value indicates if the
previous end of system was normal or abnormal. If the QABNORMSW system
value is set to ABNORMAL, check the following message ids in QHST for the
explanation:
CPI09ID
CPI0990
You cannot change QABNORMSW; it is set by the system. QABNORMSW can be:
v ’0’: Previous end of system was normal.
v ’1’: Previous end of system was abnormal.
You can refer to this value in user-written recovery programs.

Type Length Shipped Value

Character 1 ’0’

QACGLVL System Value

QACGLVL is the accounting level. The possible accounting level options are:

Accounting Option Accounting Information

*NONE No accounting information is written to a journal.
*JOB Job resource use is written to a journal.

16 OS/400 Work Management V4R4

 Accounting Option Accounting Information
*PRINT Spooled and nonspooled print file resource use is written to a
journal.
Note: Both *JOB and *PRINT can be used at the same time. However, *NONE cannot be
used with the other options.

When the QACGLVL system value is changed to options other than *NONE, the
system accounting journal QSYS/QACGJRN must exist; if not, the change is
rejected. The QACGLVL system value cannot be changed on the IBM-supplied
configuration menu during IPL. A change to the QACGLVL system value does not
affect jobs already on the system, but does affect new jobs that enter the system
after the change. For more information on job accounting, see “Setting Up Job
Accounting” on page 279.

The value for QACGLVL is an 80-character list of accounting options. Apostrophes

are necessary only when more than one option is specified and each option must
be separated by blanks.

Note: If you specify Yes to save job accounting information about completed printer
output using the Operational Assistant* user interface, the QACGLVL system
value is changed to *PRINT or *JOB *PRINT if job accounting is already on.
If you change the system value later to turn job accounting off, the
completed printer output option on the Operational Assistant menu will not be
available.

Note: You must have *ALLOBJ and *SECADM special authority to change the
QACGLVL system value.

Type Length Shipped Value

Character 80 ’*NONE’

QACTJOB System Value

QACTJOB is the initial number of active jobs for which auxiliary storage is to be
allocated during IPL. An active job is a job that has started running but not ended.
This storage is in addition to the storage allocated using the system value
QTOTJOB.

You must determine a value to assign to QACTJOB. This value should be the
estimated number of jobs that are active on a typical heavy-use day. You can
determine this number by viewing the Active jobs field on the active jobs display
(WRKACTJOB command). Both user and system jobs are included in the count on
this display, but only user jobs need to be considered when assigning a value to
QACTJOB.

A change to this value takes effect at the next IPL unless the change is made on
the IBM-supplied configuration menu, in which case it is used for the current IPL.
QACTJOB may be changed to a smaller value during IPL if the combination of
allocation system values requires more auxiliary storage than is available to start
the system. If this happens, you are notified.

Type Length Shipped Value

Decimal (5 0) 20

Chapter 2. System Values 17

QADLACTJ System Value
QADLACTJ specifies the additional number of active jobs for which auxiliary
storage is to be allocated when the initial number of active jobs (the system value
QACTJOB) is reached. An active job is a job that has started running but has not
ended. This auxiliary storage is allocated whenever the number of active jobs
exceeds the storage which has already been allocated.

The IBM-supplied value of 10 is recommended for QADLACTJ. Setting the number

close to 1 can cause frequent interruptions when many additional jobs are needed.
The number should not be set too high because the time required to add additional
storage should be minimized.

A change to this value takes effect immediately. QADLACTJ may be changed to a

smaller value during IPL if the combination of allocation system values requires
more auxiliary storage than is available to start the system. If this happens, you are
notified.

Type Length Shipped Value

Decimal (5 0) 10

QADLTOTJ System Value

QADLTOTJ specifies the additional number of jobs for which auxiliary storage is to
be allocated when the initial number of jobs (the system value QTOTJOB) is
reached. This auxiliary storage is allocated whenever the number of jobs exceeds
that for which storage has already been allocated.

The IBM-supplied value of 10 is recommended for QADLTOTJ. Setting the number

close to 1 will cause excessive interruption when many additional jobs are needed.
The number should not usually be set too high because the time required to add
additional storage should be minimized.

A change made to this value takes effect immediately. QADLTOTJ may be changed
to a smaller value during IPL if the combination of allocation system values requires
more auxiliary storage than is available to start the system. If this happens, you are
notified.

Type Length Shipped Value

Decimal (5 0) 10

QADLSPLA System Value

This system value no longer affects the operating system. When additional storage
is needed, the spooling control block is increased by 25% or a minimum of 2048
bytes.

QALWOBJRST System Value

QALWOBJRST specifies whether or not security-sensitive objects can be restored.
Such objects include system state objects or objects that adopt authority. The
system checks QALWOBJRST before restoring any object with security-sensitive
attributes. These checks also occur during the installation of program temporary
fixes (PTFs) and licensed programs. However, the system does not make these

18 OS/400 Work Management V4R4

 checks during the installation of the operating system, no matter what this value is.
This gives your system additional integrity protection.

The allowed values are:

v *ALL: Allows all objects to be restored whether or not they have security-sensitive
attributes.
v *NONE: Does not allow objects with security-sensitive attributes to be restored.
v *ALWSYSSTT: Allows programs with the system state attribute to be restored.
v *ALWPGMADP: Allows programs with the adopt attribute to be restored.
| v *ALWPTF: Allows security-sensitive objects to be restored only when the restore
| is part of the PTF operation.

Note: It is important to set the QALWOBJRST value to *ALL before performing

system activities, such as:
v Installing a new release of OS/400 and the other licensed programs
v Installing new licensed programs
v Recovering your system
These activities may fail if the QALWOBJRST value is not *ALL. To ensure
system security, return the QALWOBJRST value to your normal setting after
completing the system activity.

A change to this system value takes effect at the start of the next restore operation.

Note: You must have *ALLOBJ and *SECADM special authority to change the
QALWOBJRST system value.

Type Length Shipped Value

Character 150 ’*ALL’

QALWUSRDMN System Value

QALWUSRDMN allows you to specify which libraries on the system may contain
user domain *USRSPC (user space), *USRIDX (user index), and *USRQ (user
queue) user objects.

The values allowed are:

v *ALL: All libraries on the system may contain user domain version of *USRxxx
objects. Specifying *ALL also includes *DIR.
v *DIR: Directories may contain user domain objects. If *DIR is specified, library
QTEMP must be listed.
v libraries: Indicates specific libraries that may contain user domain version of user
(*USRxxx) objects. You may list up to 50 libraries; library QTEMP must be
included in this list.

A change to this system value takes effect immediately.

Note: You must have *ALLOBJ and *SECADM special authority to change the
QALWUSRDMN system value.

Type Length Shipped Value

Character 500 ’*ALL’

Chapter 2. System Values 19

QASTLVL System Value
QASTLVL is the assistance level system value. The value specifies the level of
assistance available to users of the system.

This system value is used to tailor the level of displays available for users of the
system. Displays intended for less experienced users provide a higher level of
assistance than do displays intended for expert users.
v ’*BASIC’: Operational Assistant level of system displays is available.
v ’*INTERMED’: Intermediate level of system displays is available.
v ’*ADVANCED’: Advanced level of system displays is available.

A change to this system value takes effect the next time a user signs on.

Type Length Shipped Value

Character 10 ’*BASIC’

QATNPGM System Value

QATNPGM is the attention program system value. The value specifies whether the
Attention key calls the Operational Assistant main menu.
v ’*ASSIST’: The Operational Assistant main menu appears when the Attention key
is pressed.
v ’*NONE’: No Attention program is called when the Attention key is pressed.
v ’PGM LIB’: The name and library of the program to be called when the Attention
key is pressed.

A change to this system value takes effect the next time a user signs on.
Notes:
1. The value *ASSIST has the same effect as specifying ’QEZMAIN QSYS’. If the
value is *ASSIST, the Retrieve System Value (RTVSYSVAL) command retrieves
’QEZMAIN QSYS’, even though the value is displayed as *ASSIST through the
Work with System Value (WRKSYSVAL) command and the Display System
Value (DSPSYSVAL) command.
2. You must have *ALLOBJ and *SECADM special authority to change the
QATNPGM system value.

Type Length Shipped Value

Character 20 ’*ASSIST’

QAUDCTL System Value

QAUDCTL specifies when object- and user-level auditing is active. This system
value activates auditing on the system that is selected by the Change Object Audit
(CHGOBJAUD) and Change User Audit (CHGUSRAUD) commands, as well as the
QAUDLVL system value. When the QAUDCTL system value is changed to a value
other than *NONE, a journal entry is sent to the QAUDJRN security journal to test
the auditing journal. If sending this journal entry fails, the change to QAUDCTL is
not allowed.

In order to change this system value to a value other than *NONE, the journal
QAUDJRN must exist in library QSYS. The journal QAUDJRN cannot be deleted or

20 OS/400 Work Management V4R4

 moved from the QSYS library until the system value is changed to *NONE. A
change to this system value takes effect immediately.

When QAUDCTL is changed to a value other than *NONE, a *SHRUPD lock is

applied to journal QAUDJRN in library QSYS.

One or more of the following values may be specified. If you specify *NONE, it must
be the only specified value:
v *NONE: No auditing of objects (Change Object Audit (CHGOBJAUD) command)
or of user actions (Change User Audit (CHGUSRAUD) command, using the
AUDLVL keyword) is done on the system. In addition, no auditing controlled by
the QAUDLVL system value is done.
v *NOQTEMP: Auditing for most objects in QTEMP is not done. You must specify
*NOQTEMP with either *OBJAUD or *AUDLVL.
v *OBJAUD: Objects that have been selected for audit using the CHGOBJAUD
command are audited.
v *AUDLVL: Auditing changes controlled by the QAUDLVL system value and
CHGUSRAUD command using the AUDLVL keyword are done.

Note: You must have *AUDIT special authority to change the QAUDCTL system
value.

Type Length Shipped Value

Character 50 Note1

1
Note: If you are skipping over a previous release and QAUDLVL is set to
something other than *NONE, QAUDCTL will be set to *AUDLVL.

QAUDENDACN System Value

QAUDENDACN specifies the system’s action when audit records cannot be sent to
the auditing journal because of errors that occur when the journal entry is sent.

The following are the possible values for the QAUDENDACN system value:
v *NOTIFY: Notification of failure to send the journal entry to the security auditing
journal is sent to the QSYSOPR message queue and QSYSMSG message
queue (if it exists). The action that caused the audit attempt continues. The
system value QAUDCTL is set to *NONE to turn auditing off. After the system
auditing code turns the QAUDCTL system value off, an hourly notification is sent
to the QSYSOPR message queue and QSYSMSG message queue (if it exists)
indicating that the system has turned off auditing. The hourly notification stops
once auditing is turned on again. The message ID is CPI2283.
v *PWRDWNSYS: The system ends if the attempt to send the audit data to the
security audit journal fails. It ends with a B900 3D10 system reference code.
When the system is powered-on again, it comes up in the restricted state.
Therefore, this IPL requires an attached console. The system value QAUDCTL is
set to *NONE to turn auditing off. On the IPL that follows the power down of the
system, a user with at least *AUDIT and *ALLOBJ special authority is required to
sign on to the system.

The system value QAUDENDACN only applies to auditing entries sent by the
operating system.

A change to this system value takes effect immediately.

Chapter 2. System Values 21

 Note: You must have *AUDIT special authority to change the QAUDENDACN
system value.

Type Length Shipped Value

Character 10 ’*NOTIFY’

QAUDFRCLVL System Value

QAUDFRCLVL specifies the number of journal entries written to the security
auditing journal before the journal entry data moves to auxiliary storage. This
system value also indicates the amount of auditing data that could be lost if the
system ends abnormally.

If auditing entries are moved to auxiliary storage frequently, system performance

can decrease. This system value is used to modify the QAUDJRN journal to
indicate how often the auditing data is moved to auxiliary storage.

The following are the possible values for the QAUDFRCLVL system value:
v *SYS: The system writes the journal entries to auxiliary storage only when the
system, based on internal processing, determines the journal entries should be
written. Using this option provides the best auditing performance, but it could also
cause the most auditing data loss if the system ends abnormally.
v 1-100: The number of auditing journal entries written to the security auditing
journal before the auditing data is written to auxiliary storage. Small values
decrease system performance.

If a journal entry is written to the security auditing journal for reasons other than an
object auditing entry (such as the Send Journal Entry (SNDJRNE) command) and
the force journal entry option is taken, all auditing data is written to auxiliary storage
along with this journal entry.

A change to this system value takes effect immediately.

Note: You must have *AUDIT special authority to change the QAUDFRCLVL
system value.

Type Length Shipped Value

Decimal (5 0) ’*SYS’

QAUDLVL System Value

QAUDLVL is the security auditing level. This system value specifies the actions that
are audited on the system. If *NONE is specified, it must be the only value
specified. A change to this system value takes effect immediately for all jobs
running on the system. Any of the other values may be used alone or in
combinations. The values allowed are:
v *NONE: No auditing occurs on the system.
v *AUTFAIL: Authorization failures are audited.
– All access (sign-on) failures
– Incorrect password or user ID entered from a device
v *CREATE: The creation of objects is audited.
– New objects
– Objects created to replace existing objects

22 OS/400 Work Management V4R4

 – Objects created in the QTEMP library are not audited
v *DELETE: All object deletions are audited.
– All delete operations of external objects on the system
– Objects deleted from QTEMP are not audited
v *JOBDTA: The following actions that affect a job are audited:
– Job start and job stop data
– Hold, release, change, disconnect, end, end abnormally, PSR (program start
request) attached to prestart job entries, change to another user profile
v *NETCMN: Violation that is detected by APPN filtering support is audited.
– Auditing of End point filter violations
– Auditing of Directory search filter violations
v *OBJMGT: Function of generic objects is audited.
– Moves of objects
– Renames of objects
v *OFCSRV: The following OfficeVision* tasks are audited:
– Changing the system distribution directory
– Opening a mail log for a different user
v *OPTICAL: The following optical functions are audited:
– Add or remove optical cartridge
– Change the authorization list used to secure an optical volume
– Open optical file or directory
– Create or delete optical directory
– Change or retrieve optical directory attributes
– Copy, move, or rename optical file
– Copy optical directory
– Back up optical volume
– Initialize or rename optical volume
– Convert backup optical volume to a primary volume
– Save or release held optical file
– Absolute read of an optical volume

Note: Deleted optical files are audited.

v *PGMADP: Adopting authority from a program owner is audited.
v *PGMFAIL: Integrity violations (blocked instruction, validation value failure,
domain violation) are audited.
v *PRTDTA: The following printing functions are audited:
– Printing a spooled file.
– Printing with parameter SPOOL(*NO).
v *SAVRST: Save and restore information is audited.
– When an object is restored
– When programs that adopt their owner’s user profile are restored
– When job descriptions that contain user names are restored
– When ownership and authority information changes for objects that are
restored
– When restore of authority for user profiles is done
v *SECURITY: All security-related functions are audited.

Chapter 2. System Values 23

 – Changes to object authority
– Create/change/delete/restore operations of user profiles
– Changes to object ownership
– Changes to programs (CHGPGM) that will now adopt the owner’s profile
– Changes to system values and network attributes
– Changes to subsystem routing
– When the QSECOFR password is reset to the shipped value by DST
– When the DST security officer password is requested to be defaulted
v *SERVICE: Use of the system service tools. The following commands are
audited:
– Dump Object (DMPOBJ), Dump System Object (DMPSYSOBJ), and Dump
Document Library Object (DMPDLO)
– Start Copy Screen (STRCPYSCN)
– Start, End, Print, and Delete Communications Trace (STRCMNTRC,
ENDCMNTRC, PRTCMNTRC, DLTCMNTRC)
– Print Error Log (PRTERRLOG)
– Print Internal Data (PRTINTDTA)
– Start Service Job (STRSRVJOB)
– Start System Service Tools (STRSST)
– Trace Internal (TRCINT)
v *SPLFDTA: The following spooled file functions are audited:
– Create a spooled file
– Delete a spooled file
– Display a spooled file
– Copy a spooled file
– Get data from a spooled file (QSPGETSP)
– Hold a spooled file
– Release a spooled file
– Change spooled file attributes (CHGSPLFA)
v *SYSMGT: The following system management tasks are audited:
– Changes for Operational Assistant functions
– Operations with network files
– Changes to the system reply list
– Changes to HFS registration
– Changes to the DRDA* relational database directory

Note: You must have *AUDIT special authority to change the QAUDLVL system
value.

Type Length Shipped Value

Character 160 ’*NONE’

QAUTOCFG System Value

QAUTOCFG system value automatically configures locally attached devices. The
value specifies whether devices that are added to the system are configured
automatically.

24 OS/400 Work Management V4R4

 The system value QDEVNAMING controls the names the system uses when
configuring automatically.
v ’0’: Automatic configuration is off. You must configure manually any new local
controllers or devices that you add to your system.
v ’1’: Automatic configuration is on. The system automatically configures any new
local controllers or devices that you add to your system. The operator receives a
message that indicates the changes to the system’s configuration.

A change to this system value takes effect immediately.

Type Length Shipped Value

Character 1 ’1’

For information on configuring devices for SNA Primary LU 2 support, see the
Remote Work Station Support book.

QAUTORMT System Value

QAUTORMT system value automatically configures remote controllers. Possible
values are:
v 0: Automatic configuration is set off. You have to configure manually any new
remote controllers or devices that you add to your system.
v 1: Automatic configuration is set on. The system automatically configures any
new remote controllers or devices that you add to your system. The operator
receives a message that indicates the changes to the system’s configuration.
A change to this system value takes effect immediately.

Note: You must have *ALLOBJ and *SECADM special authority to change the
QAUTORMT system value.

Type Length Shipped Value

Character 1 ’1’

QAUTOSPRPT System Value

QAUTOSPRPT system value allows the system to automatically report a problem.
Possible values are:
v ’0’: Automatic system disabled reporting is off.
v ’1’: Automatic system disabled reporting is on.

A change to this system value takes effect immediately.

Note: You must have *ALLOBJ and *SECADM special authority to change the
QAUTOSPRPT system value.

Type Length Shipped Value

Character 1 ’0’

For information on configuring devices for SNA Primary LU 2 support, see the
Remote Work Station Support book.

Chapter 2. System Values 25

 QAUTOVRT System Value
QAUTOVRT is the system value for automatic configuration of virtual devices. This
is a decimal system value with which the user specifies a number in the range of 0
through 32500, which is the number of virtual devices that the user wants to have
automatically configured.

| If the user does not want the system to automatically configure any devices, the
| value should be 0. Deleting a virtual device takes place only if the virtual device is
| damaged or if the device is recreated to change its type. Devices are not
| automatically deleted to bring the total number down to the QAUTOVRT limit. When
| the user changes from a higher value to a lower value, the system does not delete
| virtual resources. Therefore, the lower value does not represent the real maximum
| number of virtual devices.

Possible values are:

| v ’0’: Automatic configuration of virtual devices is off.
v ’1’ — ’32500’: The number of virtual devices that the user wants to have
automatically configured.
v *NOMAX: There is no maximum value for virtual devices that are configured
automatically.
Notes:
1. Be aware of the following security considerations with this system value: The
number of sign-on attempts allowed at remote devices increases when
QAUTOVRT is greater than 0. The number of attempts allowed through
pass-through or TELNET is QAUTOVRT multiplied by the maximum number of
sign-on attempts (the system value QMAXSIGN).
2. If the value is *NOMAX, the Retrieve System Value (RTVSYSVAL) command
retrieves 32767 even though the value is displayed as *NOMAX through the
Work with System Value (WRKSYSVAL) and the Display System Value
(DSPSYSVAL) commands.
3. You must have *ALLOBJ and *SECADM special authority to change the
QAUTOVRT system value.

Type Length Shipped Value

Decimal (5 0) 0

QBASACTLVL System Value

QBASACTLVL is the base storage pool activity level. This value indicates how
many system and user threads can compete at the same time for storage in the
base storage pool. This pool is specified in the subsystem descriptions as *BASE.
On the Work with System Status (WRKSYSSTS) panel, this is system pool 2.
QBASACTLVL depends on the types of jobs being run in this storage pool. The
lower limit for QBASACTLVL is 1.

This value may be changed by the IPL performance adjust support or the dynamic
tuning support when the system value QPFRADJ is set to 1, 2, or 3. Refer to
“QPFRADJ System Value” on page 51 for more information.

26 OS/400 Work Management V4R4

 A change to this value takes effect immediately.

Type Length Shipped Value

Decimal (5 0) Different for each machine

QBASPOOL System Value

QBASPOOL is the minimum size of the base storage pool. The base pool contains
all main storage not allocated by other pools. This pool is specified in the
subsystem description as *BASE. On the Work with System Status (WRKSYSSTS)
panel, this is system pool 2.

A change to this value takes effect immediately. In some circumstances, a machine

function may be using storage allocated to the base pool. If this is so, and if the
change to this system value would reduce the allocation to less than 256KB plus
the amount needed by the machine, the system value is changed immediately (but
the actual base pool change is done by the OS/400 licensed program only after the
storage in use is released by the machine). Use the Work with System Status
(WRKSYSSTS) command to determine the amount of storage reserved for machine
functions. QBASPOOL is numeric, must be specified in KB, and cannot be set to
less than 256KB.

Type Length Shipped Value

Decimal (10 0) 2000KB

QBOOKPATH System Value

QBOOKPATH is the system value that indicates the books and bookshelves
included in an information search. This system value indicates both the directories
included in the search and the sequence in which the directories are searched.

This system value has space for five entries, each with a length of 63 characters.

A change to the QBOOKPATH system value takes effect immediately.

Type Length Shipped Value

Character 315 ’/QDLS/QBKBOOKS/BOOKS’

QCCSID System Value

QCCSID is the system value for coded character set identifiers, which identify:
v A specific set of encoding scheme identifiers
v Character set identifiers
v Code page identifiers
v Additional coding-related information that uniquely identifies the coded graphic
character representation to be used by the system
QCCSID should be set based on the language installed on the system. On a
system capable of using double-byte character sets (DBCS), QCCSID must be set
to a mixed CCSID (a CCSID that represents both single- and double-byte character
set and code page). On a system that is not capable of using DBCS, QCCSID must
be set to a single-byte character set (SBCS) CCSID. The QIGC system value tells if
a system is capable of using DBCS.

Chapter 2. System Values 27

 A change to the QCCSID system value may automatically change the QCHRID
system value to maintain compatibility between the two system values. The National
Language Support book contains more information on coded character set
identifiers.

Type Length Shipped Value

Decimal (10 0) ’65535’

QCENTURY System Value

QCENTURY is the system value for the century. QCENTURY and QDATE
determine the specific date currently used by the system. The possible values are:
v ’0’: The years from 1928 to 1999.
v ’1’: The years from 2000 to 2053.

A change to this system value takes effect immediately.

Type Length Shipped Value

Character 1 Different for each machine1
1
Based on the value of QYEAR, this value is set for each system at the time of the
first IPL.

| QCFGMSGQ System Value

| QCFGMSGQ is the system value that specifies the message queue the system
| uses when sending messages for lines, controllers, and devices.

| For the best overall system behavior, create the message queue that is specified for
| this system value with the following attributes:
| v Force (FORCE): *NO
| v Allow Alerts (ALWALR): *NO
| v Size (SIZE): (8, 32, *NOMAX)
| v Message queue full action (MSGQFULL): *WRAP
| The system provides a message queue, QSYS/QCFGMSGQ, with the above
| characteristics. Changing the QCFGMSGQ system value to use
| QSYS/QCFGMSGQ can move messages out of QSYSOPR and into the specified
| message queue.

| A change to this system value takes effect when you vary on the line, controller, or
| device description. Therefore, if you change this system value after a line,
| controller, or device description has been varied on, you must vary off, then vary on
| the configuration object to use the new value.

| For more information about this system value, see Communications Management,
| SC41-5406-02.

| Note: You must have *IOSYSCFG authority to change the QCFGMSGQ system
| value.
|| Type Length Shipped Value
| Character 20 QSYSOPR QSYS
|

28 OS/400 Work Management V4R4

| QCHRID System Value
QCHRID is the default character set and code page. This system value specifies
the character set and code page to be used when CHRID(*SYSVAL) is specified for
the CL commands that create, change, or override display files, display device
descriptions, and printer files. The value you specify should be one of the values
shown for the CHRID parameter on the CRTDSPF, CRTDEVD, or CRTPRTF
command. Specify a value that reflects the language used at most of the devices
attached to your system. The Data Management book contains more information in
the sections on using alternative graphic character sets and code pages.

If the QCCSID system value is something other than 65535, a change to QCHRID
must be compatible with the value of QCCSID. If the value specified for QCHRID is
not compatible with QCCSID, the change is not allowed. See the National
Language Support book for more information.

QCHRID is a single system value with two parts:

v Character set identifier: This part identifies the character set to use. This identifier
must be in the range of 1 through 32767.
v Code page identifier: This part identifies the code page to use. This identifier
must be in the range of 1 through 32767.

| The QCHRID system value is retrieved as a single character value; the first 10
| characters contain the character set identifier, right-adjusted. For example, a
| character set identifier of 101 is retrieved as 0000000101. The last 10 characters
| contain the code page identifier, right-adjusted. For example, a code page identifier
| of 37 is retrieved as 0000000037. The QCHRID system value is displayed in the
| same format as other list type system values.

Changes take effect immediately for newly created display files, display device
descriptions, and printer files.

Type Length Shipped Value

Character 20 May be different for different
countries.

QCHRIDCTL System Value

QCHRIDCTL is the character identifier control attribute. This system value controls
the type of coded character set identifier (CCSID) conversion that occurs for display
files, printer files, and panel groups. You must specify the *CHRIDCTL special value
on the CHRID command parameter on the create, change, or override command for
display files, printer files, and panel groups before this attribute is used. A change to
this system value takes effect for display files, display device descriptions, and
printer files that are created, changed, or overridden after the change. Specify a
value that reflects the language used on the majority of devices that are attached to
your system.

The possible values are:

v ’*DEVD’: The *DEVD special value performs the same function as on the CHRID
command parameter for display files, printer files, and panel groups.
v ’*JOBCCSID’: The *JOBCCSID special value performs the same function as on
the CHRID command parameter for display files, printer files, and panel groups.

Chapter 2. System Values 29

 Type Length Shipped Value
Character 10 ’*DEVD’

QCMNARB System Value

| QCMNARB is the system value for communications arbiters. This system value
| specifies the number of communications arbiter system jobs that are available to
| process work for communications. Possible values are:
| v ’0’: No communications arbiter jobs. The QSYSARB and QLUS system jobs
| perform the work that the communications arbiter jobs normally do. Setting this
| system value to 0 is not recommended.
| v ’1’—’99’: The number of communication arbiter system jobs that are started.
| v *CALC: The system computes the number of communication arbiter jobs.

| A change to this system value takes effect on the next IPL. The shipped value is
*CALC.

| Note: You must have *JOBCTL special authority to change the QCMNARB system
| value.
| Type Length Shipped Value
Character 10 *CALC

QCMNRCYLMT System Value

QCMNRCYLMT is the system value for communications recovery limits.
QCMNRCYLMT is a single system value with two parts:
| v Count limit: The number of recovery attempts (0 through 99) to make before
| sending an inquiry message. The messages go to the configured message
| queue, which may be the system operator message queue or some other
| message queue. See theCommunications Management, SC41-5406-02 book for
| more information on the configured message queue.
| v Time interval: The time period (0 through 120 minutes) before the system will
| send an inquiry message. The messages go to the configured message queue,
| which may be the system operator message queue or some other message
| queue. See theCommunications Management book for more information on the
| configured message queue.

Count Limit Time Interval Action

0 0 No recovery
0 1 through 120 No recovery
1 through 99 0 Infinite recovery
1 through 99 1 through 120 Count and time recovery

If your AS/400 system is attached to a ROLM** CBX, the recovery attempts value
should never be 0. Recovery attempts are necessary for the AS/400 system to
establish a connection using the ROLM CBX’s inbound modem pool.

| The QCMNRCYLMT system value has a 20-character value; the first 10 characters
| contain the count limit, right adjusted. For example, a count limit of 7 is retrieved as
| ’0000000007’. The last 10 characters contain the time interval, right adjusted. For
| example, a time interval of 117 is retrieved as ’0000000117’.

30 OS/400 Work Management V4R4

| Both parts of the system value are integer values. You must specify them in a
| quoted string when changing the QCMNRCYLMT system value. A blank must
| separate the count limit from the time interval. The QCMNRCYLMT value displays
| in the same format as other list-type system values.

| A change to this system value does not affect a varied on communications

| configuration object. The change will be in effect the next time a communications
| configuration object is varied on. The Communications Management book contains
| more information on communications recovery.

Type Length Shipped Value

Character 20 ’0 0’ (0 count limit and 0 time
interval, which means that no
recovery attempts will be made).

QCNTRYID System Value

QCNTRYID is the system value for the country identifier. This value specifies the
country identifier to be used as the default on the system. For more information,
see the National Language Support book.

Type Length Shipped Value

Character 2 May be different for different countries

QCONSOLE System Value

QCONSOLE is the console name. This value specifies the name of the display
device that is the console. You cannot change this system value. The system
changes this value when the console is varied on.

Type Length Shipped Value

Character 10 ’QCONSOLE’

QCRTAUT System Value

QCRTAUT is the create authority system value. This value allows the default public
authority for create (CRTxxx) commands to be set system-wide. When the
*LIBCRTAUT value of the AUT parameter of a create object command is used to
set public authority for an object, the CRTAUT value for the library where the object
is created determines what public authority is used for the object. If the CRTAUT
value of the library is set to *SYSVAL, the value specified in the QCRTAUT system
value is used to set the public authority for the object being created.

Changing the QCRTAUT from the shipped value, *CHANGE, to a more restrictive
value of *USE or *EXCLUDE limits access to newly-created objects. The owner of
the objects, or the security officer, may need to grant additional authority before the
object can be used. An example of this is signing on a newly-created device. When
the device is created by the CRTDEVDSP command or automatic configuration, the
public authority is set to *USE or *EXCLUDE. Because *CHANGE authority to the
device description is required to sign on to the device, the sign-on is not allowed.

Changing the QCRTAUT system value to *ALL allows all users of the system,
except those given an authority less than *ALL, to completely control the
newly-created objects. The users are able to read, change, delete, and manage the
security of these objects.

Chapter 2. System Values 31

 The values allowed are:
v *CHANGE: Allows you to change the contents of an object.
v *ALL: Allows you to read, change, delete, and manage the security of an object.
v *USE: Allows you to create an object, to display the contents of an object, or to
refer to the contents of an attached object when a command being requested
must access attached objects and their contents.
v *EXCLUDE: Allows no access to an object.

A change to this system value takes effect immediately for newly-created objects.
Existing objects are not affected.

Note: You must have *ALLOBJ and *SECADM special authority to change the
QCRTAUT system value.

Type Length Shipped Value

Character 10 ’*CHANGE’

QCRTOBJAUD System Value

QCRTOBJAUD specifies the default auditing value used when objects are created
into a library. If the CRTOBJAUD value of the library is set to *SYSVAL, the value
specified in QCRTOBJAUD system value is used to set the object auditing value for
the object being created.

The object auditing value of an object determines if an auditing entry is sent to the
system auditing journal QAUDJRN in library QSYS when the object is used or
changed. The auditing entry is sent to the auditing journal only if auditing is
currently active on the system. To start auditing, system value QAUDCTL must be
set to a value other than *NONE.

A change to this system value takes effect immediately. One of the following values
is set for objects created into a library.
v *NONE: This value indicates that no auditing entries are sent for an object when
it is used or changed.
v *USRPRF: This value indicates that auditing entries are sent for an object when
it is used or changed by a user who is currently being audited. If the user who
uses or changes this object is not being audited, no auditing entries are sent. To
audit a user, you must use the Change User Auditing (CHGUSRAUD) command
to change the user profile of the user to be audited.
v *CHANGE: This value indicates that auditing entries are sent for an object when
it is changed.
v *ALL: This value indicates that auditing entries are sent for an object when it is
used or changed.

Note: You must have *AUDIT special authority to change the QCRTOBJAUD
system value.

Type Length Shipped Value

Character 10 ’*NONE’

32 OS/400 Work Management V4R4

 QCTLSBSD System Value
QCTLSBSD is the controlling subsystem description. The controlling subsystem is
the first subsystem to start after an initial program load (IPL). One subsystem must
be active while the system is running. This is the controlling subsystem. Other
subsystems can be started and stopped.

The subsystem you sign on to is displayed in the upper right corner of the sign-on
prompt. During an IPL, if the QCTLSBSD system value is changed by selecting
Define or Change System on the IPL options display, the user is signed on a
different subsystem than the one that was displayed on the sign-on display. This is
because the change takes effect immediately.

A change to this value takes effect at the next IPL unless the change is made on
the IPL options display during an IPL. If that is the case, a change to this value
takes effect immediately. If this subsystem description cannot be used (for example,
it is damaged), the backup subsystem description QSYSSBSD in the library QSYS
can be used. A subsystem description specified as the controlling subsystem cannot
be deleted or renamed once the system is fully operational. IBM ships three
controlling subsystem descriptions that can be used. See “Appendix D.
Characteristics of the Shipped System” on page 499 for more information about the
shipped subsystem descriptions. See “Creating Another Subsystem Description for
the Controlling Subsystem” on page 110 or “Changing the Number of Jobs Allowed
in a Subsystem” on page 111 for other items to consider before changing the value
of QCTLSBSD.

Type Length Shipped Value

Character 20 ’QBASE QSYS’

The value of QCTLSBSD is a 20-character list of up to two 10-character values in

which the first is the subsystem description name and the second is the library
name. The list must be specified as a quoted string separating the subsystem
description name and the library name by a blank if the library is specified.
Apostrophes are necessary only when the library name or *LIBL is specified with
the subsystem name. If the library name is not specified or *LIBL is specified for the
library, the library list is used to locate the subsystem description, and the library
where the subsystem description is found is stored in the system value. If *LIBL is
specified for the library name for a change made from selecting Define or Change
System at IPL Menu on the IPL options display, during an IPL, QSYS is the only
library in the library list (*LIBL).

QCURSYM System Value

| QCURSYM is the system value for the currency symbol. The system uses this
| system value when validating the currency symbols that are specified in the DDS
| keywords EDTWRD and EDTCDE. QCURSYM can be any character except blank,
| -, &, *, or 0.

A change to this system value takes effect immediately and affects active jobs.

Type Length Shipped Value

Character 1 May be different for different
countries.

Chapter 2. System Values 33

QDATE System Value
QDATE is the system date. This system value support dates that are in the range of
24 August 1928 to 6 July 2053. QDATE is composed of the following system
values: QYEAR, QMONTH, and QDAY. The format of the date is as specified in the
system value QDATFMT. The date formats that can be specified are YMD, MDY,
DMY, (Y = year, M = month, D = day) or JUL (Julian format). Its value can be set
from the IPL options display and is updated when the system value QTIME reaches
midnight (000000). A change that is made to this value may also change
QCENTURY, QYEAR, QMONTH, and QDAY.

A change to this system value takes effect immediately.

See also “Changes to QDATE and QTIME and Job Schedule Entries” on page 233.

Type Length Shipped Value

Character 5 (Julian) or 6 No shipped value

QDATFMT System Value

QDATFMT is the system date format. This system value can be YMD, MDY, DMY,
or JUL (Julian format). (Y = year; M = month; D = day.) This system value is used
for the following:
v The default value for the DATFMT job attribute
v To determine the format in which a date can be specified on the IPL options
prompt

A change to this system value takes effect for new jobs that enter the system after
the change.

Type Length Shipped Value

Character 3 May be different for different
countries.

QDATSEP System Value

QDATSEP is the character separator for dates. This system value is used as the
date separator for the default value of the DATSEP job attribute or in the date that
you can specify on the IPL options prompt.

QDATSEP can be ’/’, ’-’, ’.’ (period), ’,’ (comma), or ’ ’ (blank). The Work with
System Values (WRKSYSVAL) and Display System Values (DSPSYSVAL)
commands use numbers to represent each of the values for QDATSEP:
1 = ’/’
2 = ’-’
3 = ’.’
4 = ’,’
5 = blank
The Change System Value (CHGSYSVAL) and Retrieve System Value
(RTVSYSVAL) commands use the actual values for QDATSEP.

A change to this system value takes effect for new jobs that enter the system after
the change.

34 OS/400 Work Management V4R4

 Type Length Shipped Value
Character 1 May be different for different
countries.

QDAY System Value

QDAY is the system value for the day of the month. It must be a valid day of the
specified month or year (if the date format is Julian). For Julian dates only, QDAY is
a 3-character value (’001’ through ’366’). A change to this system value takes effect
immediately. Changing this system value also changes the system value QDATE.

Type Length Shipped Value

Character 2 or 3 (Julian) No shipped value

QDAYOFWEEK System Value

QDAYOFWEEK is the system value for the day of the week. This value cannot be
changed. The system sets this value. The value of QDATE determines the value of
QDAYOFWEEK. This value may not be set correctly if your system is not using the
Gregorian calendar. The possible values are:
v *SUN: Sunday
v *MON: Monday
v *TUE: Tuesday
v *WED: Wednesday
v *THU: Thursday
v *FRI: Friday
v *SAT: Saturday

Type Length Shipped Value

Character 4 No shipped value

QDBRCVYWT System Value

QDBRCVYWT is the database recovery wait indicator. This system value controls
when the recovery of database files created with the RECOVER(*AFTIPL) option is
performed during an unattended IPL. QDBRCVYWT can be:
v ’0’: Do not wait for database recovery to complete before completing the IPL. The
database recovery after an abnormal end of system (QABNORMSW system
value) can take awhile to complete. If you do not want to wait for it to complete
before the system becomes available, choose this value.
v ’1’: Wait for database recovery to complete before completing the IPL. Files that
were created with the RECOVER(*AFTIPL) option are treated as if they were
created with the RECOVER(*IPL) option. This value does not affect recovery of
files that were created with RECOVER(*IPL) or RECOVER(*NO).

A change to this value takes effect during the next IPL in unattended mode.
QDBRCVYWT has no effect during an attended IPL. This value is related to the
RECOVER parameter on the Create Physical File (CRTPF) and Create Logical File
(CRTLF) commands.

Type Length Shipped Value

Character 1 ’0’

Chapter 2. System Values 35

QDECFMT System Value
QDECFMT is the decimal format. This system value is used for the following:
v To determine the type of zero suppression and decimal point character used by
DDS edit codes 1 through 4 and A through M
v To determine the decimal point character for decimal input fields on displays

QDECFMT must be one of the following characters:

v ’ ’ (blank): Use a period for a decimal point, use a comma for a three-digit
grouping character, and zero-suppress to the left of the decimal point. For
example,
1,000.04 .04
v J: Use a comma for a decimal point, and use a period for a three-digit grouping
character. The zero-suppression character is in the second position (rather than
the first) to the left of the decimal notation. Balances with zero values to the left
of the comma are written with one leading zero (0,04). The J entry also overrides
any edit codes that might suppress the leading zero. For example,
1.000,04 0,04
v I: Use a comma for a decimal point, use a period for a three-digit grouping
character, and zero-suppress to the left of the decimal point. For example,
1.000,04 ,04

The Work with System Value (WRKSYSVAL) and Display System Value
(DSPSYSVAL) commands use numbers to represent each of the values for
QDECFMT:
1 = blank
2=J
3=I
The Change System Value (CHGSYSVAL) and Retrieve System Value
(RTVSYSVAL) commands use the actual values for QDECFMT: blank, J, or I.

A change to this system value takes effect immediately for any job that is started
after the change. This does not include jobs that are active at the time of the
change.

Type Length Shipped Value

Character 1 May be different for different
countries.

QDEVNAMING System Value

QDEVNAMING is the naming convention for locally attached devices. This value
specifies what naming convention is used when the system automatically creates
device descriptions. You can change, display, and retrieve this value.
QDEVNAMING must be one of the following values:
v ’*NORMAL’: Naming conventions should follow AS/400 standards.
v ’*S36’: Naming conventions should follow System/36 standards.
v ’*DEVADR’: Derive device name from the device address.

36 OS/400 Work Management V4R4

 The following shows an example of the naming conventions:

Device Normal S36 DEVADR

Display Stations DSP01, DSP02 W1, W2 DSP010403
Printer PRT01, PRT02 P1, P2 PRT010302
Diskette Drive DKT01 I1 DKT01
Tape Device TAP01 T1 TAP01

For more information on the device naming conventions, see the Local Device
Configuration book. For information on device naming for SNA LU 2 support, 5394
or 5494 attached devices, or 3270 remote devices, see the Remote Work Station
Support book.

Note: You must have *ALLOBJ and *SECADM special authority to change the
QDEVNAMING system value.

Type Length Shipped Value

Character 10 ’*NORMAL’

QDEVRCYACN System Value

QDEVRCYACN specifies what action to take when an I/O error occurs for an
interactive job’s workstation.

The values for QDEVRCYACN are:

v *DSCMSG: Disconnects the job. When signing-on again, an error message is
sent to the user’s application program.
v *MSG: Signals the I/O error message to the user’s application program. The
application program performs error recovery.
v *DSCENDRQS: Disconnects the job. When signing-on again, a cancel request
function is performed to return control of the job back to the last request level.
v *ENDJOB: Ends the job. A job log is produced for the job. A message indicating
that the job ended because of the device error is sent to the job log and the
QHST log. To minimize the performance impact of the ending job, the job’s
priority is lowered by 10, the time slice is set to 100 milliseconds and the purge
attribute is set to yes.
v *ENDJOBNOLIST: Ends the job. A job log is not produced for the job. A message
is sent to the QHST log indicating that the job ended because of the device error.

When a value of *MSG or *DSCMSG is specified, the device recovery action is not
performed until the next I/O operation is performed by the job. In a LAN/WAN
environment, this may allow one device to disconnect and another to connect, using
the same device description, before the next I/O operation for the job occurs. The
job may recover from the I/O error message and continue running to the second
device. To avoid this, a device recovery action of *DSCENDRQS, *ENDJOB, or
*ENDJOBNOLIST should be specified. These device recovery actions are
performed immediately when an I/O error, such as a power-off operation, occurs.

Information on jobs ending at the same time can be found on page 168.

Type Length Shipped Value

Character 20 ’*DSCMSG’

Chapter 2. System Values 37

 QDSCJOBITV System Value
| QDSCJOBITV indicates the length of time in minutes that an interactive job can be
| disconnected before it ends. A job can be disconnected using the DSCJOB
| command or when an I/O error occurs at the interactive job’s workstation (the
| system value QDEVRCYACN). A job can also be disconnected when the interval
| set in the QINACTITV system value expires and the QINACTMSGQ system value
| has an action of *DSCJOB. If the time interval is exceeded, the disconnected job
| ends.

Disconnected jobs end abnormally at IPL.

The values for QDSCJOBITV are:

v ’5’ through ’1440’: The range of the disconnect interval.
v *NONE: There is no disconnect interval.

A change to this system value takes effect immediately.

Type Length Shipped Value

Character 10 ’240’

QDSPSGNINF System Value

QDSPSGNINF is the system value for display sign-on information. This logical
system value controls whether the user sees an informational display at sign-on that
contains the date and time last signed on and the number of not valid sign-on
attempts since the last sign-on. The possible values are:
v ’0’: The sign-on information is not displayed.
v ’1’: The sign-on information is displayed.

A change to this system value takes effect immediately.

Note: You must have *ALLOBJ and *SECADM special authority to change the
QDSPSGNINF system value.

Type Length Shipped Value

Character 1 ’0’

QDYNPTYADJ System Value

QDYNPTYADJ controls whether the priority of interactive jobs is dynamically
adjusted to maintain high performance of batch job processing on AS/400e servers.
This adjustment capability is only effective on systems that are rated for both
interactive and non-interactive throughput and have Dynamic Priority Scheduling
enabled (see QDYNPTYSCD).

The values for QDYNPTYADJ are:

v ’0’: The dynamic priority adjustment support is turned off. Interactive jobs retain
their priority.
v ’1’: The dynamic priority adjustment support is turned on. Interactive jobs may
have their priority reduced when there is a high non-interactive demand.

A change to this system value takes effect at the next IPL.

38 OS/400 Work Management V4R4

 Notes:
1. If QDYNPTYADJ is enabled, and the performance of specific interactive jobs is
not satisfactory, you can improve their performance by changing the job priority
to be in the 10 - 16 band. The QDYNPTYADJ system value does not control
jobs in this priority.
| 2. You must have *ALLOBJ and *SECADM special authority to change the
| QDYNPTYADJ system value.

Type Length Shipped Value

Decimal 1 ’1’

QDYNPTYSCD System Value

QDYNPTYSCD is the system value that allows you to turn on and turn off the
dynamic priority scheduler. The task scheduler uses this system value to determine
the algorithm for scheduling jobs for the processor. When enabled, the dynamic
priority scheduler will adjust job priorities within priority bands, depending on their
resource usage. This typically allows greater throughput on the system, but may
slightly alter the priority relationship between jobs within a band. For example,
10-16 is Band 1, 17-22 is Band 2, 23-35 is Band 3, 36-46 is Band 4, 47-51 is Band
5, and 52-89 is Band 6.

Regardless of the value assigned to QDYNPTYSCD, any jobs that are given a
priority of 0 through 9 are put in a high–priority band 0. This band is always
checked first by the task dispatcher before any other dynamic priority bands are
checked. If a job in this band becomes central processing unit (CPU) bound (by
looping), the job can lock the system.

The possible values are:

v ’0’: The dynamic priority scheduler is turned off.
v ’1’: The dynamic priority scheduler is turned on.

A change to this system value takes effect at the next IPL. The shipped value is 1.

Note: You must have *ALLOBJ and *SECADM special authority to change the
QDYNPTYSCD system value.

Type Length Shipped Value

Character 1 ’1’

QFRCCVNRST System Value

QFRCCVNRST is the system value that allows you to specify whether or not to
convert program objects during the restore operation. The default on the restore
commands uses the value of the system value. By doing this, you can turn on and
turn off conversion for the entire system value. However, on any restore you may
override the system value and explicitly specify whether or not to do the conversion.
The possible values are:
v ’0’: The force conversion on restore is turned off.
v ’1’: The force conversion on restore is turned on.

A change to this system value takes effect immediately. The shipped value is 0.

Chapter 2. System Values 39

 Note: You must have *ALLOBJ and *SECADM special authority to change the
QFRCCVNRST system value.

Type Length Shipped Value

Character 1 ’0’

QHOUR System Value

QHOUR is the system value for the hour of the day. Hours are based on a 24-hour
clock. For example, 1:00 p.m. is 13. A change to this system value takes effect
immediately and affects the QTIME system value.

Note: If you are changing the time for Daylight Savings Time, you should also
update the QUTCOFFSET system value.

Type Length Shipped Value

Character 2 No shipped value

QHSTLOGSIZ System Value

QHSTLOGSIZ is the maximum number of records for each version of the history
log. When a version is full (the maximum has been reached), a new version is
created. You can save the full (old) version and then delete it. QHSTLOGSIZ is
numeric. The lower limit for QHSTLOGSIZ is 1. (See the CL Programming book for
more information about QHST.)

A change to this system value takes effect when a new history log version is
created. Although 1 is the lower limit for QHSTLOGSIZ, using a small number
affects system performance because it causes many history versions to be created.

Type Length Shipped Value

Decimal (5 0) 5000

QIGC System Value

QIGC is the DBCS version indicator. This value specifies if the DBCS version of the
system is installed. You cannot change QIGC; it is set by the system. You can refer
to this system value in an application program. QIGC can be:
v ’0’: A DBCS version is not installed.
v ’1’: A DBCS version is installed.

Type Length Shipped Value

Character 1 No shipped value

QIGCCDEFNT System Value

QIGCCDEFNT is the system value for the double-byte coded font name. It is used
when transforming SNA character string (SCS) data into an advanced function
printing data stream (AFPDS) spooled file with shift in/shift out (SI/SO) characters
present in the data.

QIGCCDEFNT is a 20-character list of up to two values in which the first 10

characters contain the coded font name and the last 10 characters contain the
library name. The possible values for the DBCS coded font name are:
v ’*NONE’: No coded font is identified to the system.

40 OS/400 Work Management V4R4

 v ’coded font name’: The name of the DBCS coded font.
The possible values for the library are:
v ’*LIBL’: The library list is used to locate the coded font.
v ’*CURLIB’: The current library is used to locate the coded font. If no library is
specified, library QGPL is used.
v ’library name’: The library containing the coded font.

Note: The coded font name can be only 8 characters.

Type Length Shipped Value

Character 20 May be different for different
countries.

QIGCFNTSIZ System Value

QIGCFNTSIZ is the system value for the double-byte coded font point size. It is
used with the system value, QIGCCDEFNT, double byte coded font. The system
values will be used when transforming a SNA character string (SCS) into an
Advanced Function Printing data stream (AFPDS). They are also used when
creating an AFPDS spooled file with shift in/shift out (SI/SO) characters present in
the data.

The possible values for the double-byte character set (DBCS) coded font point size
are:
v ’*NONE’: No font point size is identified to the system.
v ’000.1 - 999.9’: The point size for the double byte coded font.

A change to this system value takes effect immediately.

Type Length Shipped Value

Decimal (4 1) *NONE

QINACTITV System Value

| QINACTITV specifies the inactive job time-out interval in minutes. It specifies when
| the system takes action on inactive interactive jobs. The system value
| QINACTMSGQ determines the action the system takes. Excluded are local jobs
| that are currently signed-on to a remote system. For example, a workstation is
| directly attached to System A, and System A has the QINACTITV system value set
| on. If you use pass-through or TELNET to sign on to System B, the time-out value
| set on System A does not affect this workstation.

To cause TELNET sessions to time out with QINACTITV, you must be using
user-specified device descriptions.

| QINACTITV must be one of the following values:

| v ’*NONE’: The system does not check for inactive interactive jobs.
| v ’5-300’: The number of minutes a job can be inactive before action is taken.

| A change to this system value takes place immediately.

Note: You must have *ALLOBJ and *SECADM special authority to change the
QINACTITV system value.

Chapter 2. System Values 41

 Type Length Shipped Value
Character 10 ’*NONE’

QINACTMSGQ System Value

QINACTMSGQ is the system value for the inactive message queue. It specifies the
action the system takes when an interactive job has been inactive for an interval of
time (the time interval is specified by system value QINACTITV). The interactive job
can be ended, disconnected, or a message can be sent to the message queue you
specify.

| QINACTMSGQ is a 20-character list of up to two 10-character values. When you

| specify two values, the first is the message queue name and the second is the
| library name.
| v *DSCJOB: the interactive job is disconnected, as is any secondary or group jobs
| associated with it. If *DSCJOB is specified, and if the job cannot be
| disconnected, *ENDJOB will be used.
v *ENDJOB: the interactive job is ended, along with any secondary job and any
group jobs associated with it. If there are many inactive jobs in a subsystem that
are to be ended at once, the interactive response time of that subsystem may be
slowed. To minimize this impact, the system modifies several job attributes for
each job to be ended. The job priority is lowered by 10, the time slice is set to
100 milliseconds, and the purge attribute is set to yes.
| v ’inactive-message-queue library’: name and library of a message queue that
| receives CPI1126, indicating that the job is inactive. If the specified message
| queue does not exist or is damaged, the messages are sent to the QSYSOPR
| message queue.

| Note: All messages in the message queue specified by the QINACTMSGQ

| system value are cleared during an IPL. If you assign a user’s message
| queue to QINACTMSGQ, the user loses all messages in the user’s
| message queue during each IPL.

| Possible library values are:

| – *LIBL: The library list for the job is used by the system when locating the
| inactive message queue.
| – *CURLIB: The current library for the job is used by the system to locate the
| inactive message queue. If no library was specified as the current library for
| the job, the system uses QGPL..
| – ’library name’: The name of the library where the inactive message queue is
| located.

| A change to this system value takes effect immediately.

Note: You must have *ALLOBJ and *SECADM special authority to change the
QINACTMSGQ system value.

Type Length Shipped Value

Character 20 ’*ENDJOB’

42 OS/400 Work Management V4R4

 QIPLDATTIM System Value
QIPLDATTIM is the system value for the date and time to automatically IPL the
system. It specifies a date and time when an automatic IPL should occur. The
default value *NONE indicates that no timed automatic IPL is desired.

| You can set this system value independently in each partition. If the primary
| partition is powered down at the time an automatic IPL should occur in a secondary
| partition, the IPL will not occur. When the primary partition does IPL, the secondary
| partition is IPLed if its IPL date and time is past due. The secondary partition will
| not IPL if it was configured with an IPL action of hold.

QIPLDATTIM is a single system value with two parts:

v Date: The date an IPL automatically occurs on the system. The date cannot be
more than 11 months after the current date. The date is in QDATFMT format with
no date separators.
v Time: The time an IPL automatically occurs on the system. The seconds portion
of the time value must be specified, but it is ignored. The time is specified with
no separators and must be at least 5 minutes past the current time.

Note: If the date and time have already occurred when the system is powered
down or the system is running when the date and time occur, no IPL is
performed. After the date/time IPL occurs, the value of QIPLDATTIM is
changed to *NONE. It is not changed to *NONE unless the IPL occurs.

The following example shows how to change the IPL date and time to September
10, 1990 (QDATFMT is MDY) at 9:00 a.m..
CHGSYSVAL SYSVAL(QIPLDATTIM) VALUE('091090 090000')

Note: You must have *ALLOBJ and *SECADM special authority to change the
QIPLDATTIM system value.

Type Length Shipped Value

Character 20 ’*NONE’

QIPLSTS System Value

QIPLSTS is the IPL status indicator. This value indicates what form of IPL has
occurred. Each form of IPL has an indicator value. You can refer to this value in
your recovery programs, but you cannot change it.
| v ’0’: Operator panel IPL. IPL occurred when requested from the operator panel or
| from Dedicated Service Tools (DST) for a secondary partition.
v ’1’: Automatic IPL after power restored. IPL occurred automatically when power
was restored after a power failure. This is enabled by the QPWRRSTIPL system
value.
v ’2’: Restart IPL. IPL occurred when the Power Down System (PWRDWNSYS)
command with RESTART(*YES) was issued.
v ’3’: Time-of-day IPL. IPL occurred automatically on the date and time set on the
QIPLDATTIM system value.
v ’4’: Remote IPL. Remote IPL occurred. This is enabled by the QRMTIPL system
value.

| QIPLSTS indicates the same value in the primary partition and secondary partitions
| when an IPL of the primary partition causes an IPL of secondary partitions.

Chapter 2. System Values 43

 Type Length Shipped Value
Character 1 ’0’

QIPLTYPE System Value

QIPLTYPE indicates the type of IPL to perform. This value specifies the type of IPL
performed when the system is powered on manually with the key in the normal
position. This value is used only when the key is in normal position. QIPLTYPE can
be:
v ’0’: Unattended. No displays are shown during an IPL. The normal sign-on
display is shown when the IPL is complete.
v ’1’: Attended with dedicated service tools. All dedicated service tools functions
are available along with the full set of IPL displays. If the system is in manual
mode, ’0’ changes to ’1’.
v ’2’: Attended with console in debug mode. This leaves the controller QCTL and
device QCONSOLE varied on after an IPL. You should only use this for problem
analysis, as it prevents other devices on the workstation controller from being
used.

Note: You must have *ALLOBJ and *SECADM special authority to change the
QIPLTYPE system value.

Type Length Shipped Value

Character 1 ’0’

QJOBMSGQFL System Value

QJOBMSGQFL specifies how the system should handle the job message queue
when it is considered full. The system value QJOBMSGQMX indicates when a job
message queue is considered full.

A change to this system value affects any jobs started after the change is made.

The allowed values are:

v *NOWRAP: Do not wrap the job message queue. If you specify *NOWRAP and
the value specified in QJOBMSGQMX is reached, the job ends.
v *WRAP: Wrap the job message queue.
v *PRTWRAP: Wrap the job message queue and print the messages that are
being overlaid because of wrapping.

Type Length Shipped Value

Character 10 *NOWRAP

QJOBMSGQMX System Value

QJOBMSGQMX specifies the maximum size of a message queue in megabytes.
When this maximum size is reached for any job message queue, that job message
queue is considered full and the action specified by QJOBMSGQFL is taken to
control the full message job queue.

This system value can have a value between 8 and 64 megabytes.

44 OS/400 Work Management V4R4

 A change to this system value affects any jobs started after the change is made.

Type Length Shipped Value

Decimal (5 0) 16MB

QJOBMSGQSZ System Value

This system value no longer affects the operating system.

QJOBMSGQTL System Value

This system value no longer affects the operating system.

QJOBSPLA System Value

QJOBSPLA specifies the initial size of the spooling control block for a job. (There is
one spooling control block for each job in the system.) The spooling control block
records information about inline spooled files and output spooled files. This value
primarily affects auxiliary storage requirements and has little effect on processing
performance. The auxiliary storage is retained for every job known to the system.

The allocated area is made up of standard control information plus a separate set
of control information for each spooled file. The default is 3516 bytes, which allows
for about 2 output spooled files per job. If your typical job uses more than the 2
output files and you are not concerned with an additional 6KB allocation per job, a
good choice would be 9600 bytes. This allows for approximately 8 spooled output
files per job.

Note: For compatibility, the lower limit is 1024 bytes. However, if anything below
3516 is specified, the system uses 3516.

A change to this value takes effect when a cold start is requested during the
installing of the OS/400 licensed program. A cold start clears the job and output
queues. If the system requires new job structures, the value is also used for the
new job structures (the system value QADLTOTJ).

Type Length Shipped Value

Decimal (5 0) 3516

QKBDBUF System Value

QKBDBUF specifies whether the type-ahead feature and buffer Attention key option
should be used.
v ’*TYPEAHEAD’: The type-ahead feature is turned on and the Attention key
buffering option is turned off.
v ’*NO’: The type-ahead feature and the Attention key buffering option are turned
off.
v ’*YES’: The type-ahead feature and the Attention key buffering option are turned
on.

A change to this system value takes effect the next time the user signs on.

Note: You must have *ALLOBJ and *SECADM special authority to change the
QKBDBUF system value.

Chapter 2. System Values 45

 Type Length Shipped Value
Character 10 ’*TYPEAHEAD’

QKBDTYPE System Value

QKBDTYPE specifies the language character set for the keyboard. Based on the
language value specified at install time, the OS/400 licensed program will put the
appropriate keyboard value into the system value. See the National Language
Support book for possible values.

QLANGID System Value

QLANGID is the system value for the language identifier. This system value
specifies the language identifier to be used as the default for the system. If you
specify *LANGIDSHR or *LANGIDUNQ for the SRTSEQ parameter, the sort
sequence table used is the unique weight sort table or shared weight sort table
associated with QLANGID system value.

For more information, see the National Language Support book.

Type Length Shipped Value

Character 3 May be different for different
countries

QLEAPADJ System Value

QLEAPADJ is the system value for leap year adjustment. It is used to adjust the
system calendar algorithm for the leap year in different calendar systems. If your
calendar year agrees with what is used in the Gregorian calendar system, then this
system value should be zero. If your calendar year differs from the Gregorian, you
may need to adjust the system calendar algorithm to account for the leap year of
that calendar year you are using. To make the adjustment, divide the leap year in
your calendar system by 4; then set QLEAPADJ to the value of the remainder.

Example: The Gregorian calendar year of 1988 was the year 77 in the Republic of
China calendar. Because 77 was a leap year for the Republic of China, you need to
divide 77 by 4; this leaves a remainder of 1. Therefore, to adjust the system
calendar algorithm for the Republic of China, specify a 1 for the QLEAPADJ system
value.

Changing the QLEAPADJ system value does not change the system clock and job
dates of active jobs, but it may change the QDATE system value.

Type Length Shipped Value

Decimal (5 0) May be different for different
countries

QLMTDEVSSN System Value

QLMTDEVSSN is the system value for limiting device sessions. It controls whether
a user can sign-on at more than one workstation. This does not prevent the user
from using group jobs or making a system request (pressing the System Request
key) at the same workstation. The possible values are:
v ’0’: A user can sign on at more than one device.
v ’1’: A user cannot sign on at more than one device.

46 OS/400 Work Management V4R4

 Note: You must have *ALLOBJ and *SECADM special authority to change the
QLMTDEVSSN system value.

Type Length Shipped Value

Character 1 ’0’

QLMTSECOFR System Value

QLMTSECOFR is the system value for limiting QSECOFR device access. It
controls whether users with *ALLOBJ or *SERVICE special authority need explicit
authority to specific workstations. The possible values are:
v ’0’: A user with *ALLOBJ or *SERVICE special authority can sign-on any device.
v ’1’: A user with *ALLOBJ or *SERVICE special authority can sign-on only at a
device to which they have explicit authority.

A change to this system value takes effect immediately.

Note: You must have *ALLOBJ and *SECADM special authority to change the
QLMTSECOFR system value.

Type Length Shipped Value

Character 1 ’1’

QLOCALE System Value

QLOCALE is the system value that sets the locale for the system. The locale path
name must be a path name that specifies a locale. A locale is made up of the
language, territory, and code set combination used to identify a set of language
conventions. The maximum path length allowed for the locale path name on the
Change System Value (CHGSYSVAL) command is 1024 bytes.

The allowed values are:

v *NONE: Indicates there is no locale for the QLOCALE system value.
v *C: Indicates the C locale is to be used.
v *POSIX: Indicates the *POSIX locale is to be used. The *POSIX locale is
equivalent to the C locale.

A change to this system value takes effect immediately. However, this change will
not affect any jobs that are currently running.

For more information, see the National Language Support book.

Type Length Shipped Value

Character 1024 May be different for different
countries

QMAXACTLVL System Value

QMAXACTLVL is the maximum activity level of the system. This is the number of
threads that can compete at the same time for main storage and processor
resources. For all active subsystems, the sum of all threads running in all storage
pools cannot exceed QMAXACTLVL. If a thread cannot be processed because the
activity level has been reached, the thread is held until another thread reaches a
time slice or a long wait.

Chapter 2. System Values 47

 QMAXACTLVL is numeric. The lower limit for QMAXACTLVL is 2. A change to this
value takes effect immediately. This value should be set to *NOMAX and the activity
level should be controlled on a pool basis.

Note: The value *NOMAX has the same effect as specifying 32767. If the value is
*NOMAX, the Retrieve System Value (RTVSYSVAL) command retrieves
32767 even though the value is displayed as *NOMAX through the Work
with System Value (WRKSYSVAL) and the Display System Value
(DSPSYSVAL) commands.

Type Length Shipped Value

Decimal (5 0) ’*NOMAX’

QMAXSGNACN System Value

QMAXSGNACN specifies the maximum sign-on attempts action or how the system
reacts when the maximum number of consecutive incorrect sign-on attempts (the
system value QMAXSIGN) is reached.

A change to this system value takes effect the next time someone attempts to sign
on to the system. The possible values are:
v ’1’: Vary off device if limit is reached.
v ’2’: Disable user profile if limit is reached.
v ’3’: Vary off device and disable user profile if limit is reached.

Note: You must have *ALLOBJ and *SECADM special authority to change the
QMAXSGNACN system value.

Type Length Shipped Value

Character 1 ’3’

QMAXSIGN System Value

QMAXSIGN specifies the maximum number of incorrect sign-on attempts allowed.
Incorrect sign-on attempts arise from any of the following circumstances:
v A user ID that is not valid.
v A password that is not valid.
v The user profile does not have authority to the device from which the user ID
was entered.

Note: A sign-on attempt is not counted as an incorrect attempt if passwords are

required and the user profile has a password of *NONE specified. The user
receives a message saying that no password is associated with the user
profile. It also is not counted as an incorrect attempt if the program or menu
names are not valid or if the user ID is not a valid name on an unsecured
system, or if the current library specified is not found.

If the QMAXSIGN value maximum is reached, the action specified by the

QMAXSGNACN system value is performed. The device is varied off, the profile is
disabled, or both actions are performed. A message is sent to the QSYSMSG
message queue if it exists; otherwise, it is sent to QSYSOPR. If a profile is
disabled, it must be enabled again before a user can sign on. If a device is varied
off, it must be varied on again before a user can sign on. If the controlling
subsystem is in the restricted state (so that only one device in it can be used) and

48 OS/400 Work Management V4R4

 the device is varied off, the system is ended and control panel lights on the control
panel turn on to indicate that you must perform an IPL. The possible values are:
v 1-25: Maximum number of sign-on attempts allowed.
v *NOMAX: No maximum number of sign-on attempts.

When the number of incorrect sign-on attempts is one less than QMAXSIGN, a
message is sent to the display to warn the user that if another incorrect attempt is
made, the action specified by the QMAXSGNACN system value is performed. If the
QMAXSGNACN value is ’2’, the message is CPF1392: Next not valid sign-on
disables user profile. If the QMAXSGNACN value is ’1’ or ’3’, the message is
CPF1116: Next not valid sign-on attempt varies off device. In some environments, it
is not desirable to have this message appear. You cannot prevent this message
from being sent, but you can change the message text (by using the CHGMSGD
command) to the same text as CPF1107: Password not valid for system. Refer to
CPF1107 for the values entered for the MSG and SECLVL parameters. A change to
this system value takes effect the next time someone attempts to sign-on the
system.

Note: You must have *ALLOBJ and *SECADM special authority to change the
QMAXSIGN system value.

Type Length Shipped Value

Character 6 ’3’

QMCHPOOL System Value

QMCHPOOL is the size of the machine storage pool. The machine storage pool
contains highly shared machine and OS/400 licensed programs. You must be
careful when changing the size for this storage pool because system performance
may be impaired if the storage pool is too small. QMCHPOOL is specified in KB,
and cannot be set to less than 256KB.

This minimum value of 256KB, which is enforced by the Change System Value
(CHGSYSVAL) command, does not reflect the machine-enforced minimum value.
The machine-enforced minimum value varies depending on the main storage size of
the machine. The system automatically increases the actual size of the machine
storage pool to the machine-enforced minimum value if the QMCHPOOL system
value contains a smaller value.

If the system has increased the actual size of the machine storage pool, you can
use the Work with System Status (WRKSYSSTS) command to determine the actual
machine-enforced minimum value for the machine storage pool (pool 1).

“Chapter 14. Performance Tuning” on page 239 contains a formula for determining
the size of the machine storage pool for your system. You should use the result of
this calculation, rather than the machine-enforced minimum value, to set the
QMCHPOOL system value when you tune the performance of your system.

This value may be changed by the IPL performance adjust support or the dynamic
performance adjust support when the system value QPFRADJ is set to 1, 2, or 3.
Refer to “QPFRADJ System Value” on page 51 for more information.

Chapter 2. System Values 49

 A change to this value takes effect immediately.

Type Length Shipped Value

Decimal (10 0) 20 000

QMINUTE System Value

QMINUTE is the system value for the minute of the hour. Its value can range from
’00’ through ’59’. A change to this system value takes effect immediately, and
changes the system value QTIME.

Note: If you are changing the time for Daylight Savings Time, you should also
update the QUTCOFFSET system value.

Type Length Shipped Value

Character 2 No shipped value

| QMLTTHDACN System Value

| QMLTTHDACN is multithreaded job action. This system value controls the action to
| be taken when a function that may not be threadsafe is invoked in a job that is
| running with multiple threads. Examples of functions that support this system value
| are CL commands and exit points that run user exit programs that are registered
| through the exit program registration facility. Possible values are:
| v ’1’: Perform the function that is not threadsafe without sending a message.
| You should not use this value on systems that are running multithreaded jobs in
| production mode or on any system for which data integrity is important.
| v ’2’: Perform the function that is not threadsafe and send an informational
| message. This is the default value.
| This value may be used for investigating thread safety of applications. You
| should not use this value on systems that are running multithreaded jobs in
| production mode or on any system for which data integrity is important.
| v ’3’: Do not perform the function that is not threadsafe.
| This value should be used on systems that are running multithreaded jobs in
| production mode or on any system for which data integrity is important.

| A change to this system value takes effect immediately.

| Note: You must have *ALLOBJ and *SECADM special authority to change the
| QMLTTHDACN system value.
|| Type Length Shipped Value
| Character 1 2

| QMODEL System Value

| QMODEL is the system model number. You cannot change QMODEL, but you can
| display or retrieve the four-character value in user-written programs. The QMODEL
| system value is the same in each partition on a system. Examples of values you
| may see are: 400, 530, 620, 640.

Type Length Shipped Value

Character 4 No shipped value

50 OS/400 Work Management V4R4

 QMONTH System Value
QMONTH is the system value for the month of the year. It cannot be displayed or
changed if the date format specified in system value QDATFMT is Julian (JUL). Its
value can range from ’1’ through ’12’. A change to this system value takes effect
immediately. Changing this value also changes the system value QDATE.

Type Length Shipped Value

Character 2 No shipped value

QPASTHRSVR System Value

This system value specifies the number of target display station pass-through
server jobs that are available to process AS/400 display station pass-through,
AS/400 Client Access workstation function (WSF), and other 5250 emulation
programs on programmable workstations.

The server jobs are not needed for TELNET and VTM. Therefore, if you use only
TELNET and VTM, you may want to decrease the value specified for the number of
target display station pass-through server jobs.

A change to this system value takes affect immediately. The shipped value is
*CALC. See the Remote Work Station Support book for information on how the
*CALC value is calculated and information about altering the QPASTHRSVR system
value. The possible values are:
v ’*CALC’: The operating system calculates the correct number of target display
station pass-through server jobs.
v ’0’-’100’: Specifies the number of target display station pass-through server jobs
that are available to process AS/400 display station pass-through, AS/400 Client
Access work station function (WSF), and other 5250 emulation programs on
programmable workstations.

| Note: You must have *JOBCTL special authority to change the QPASTHRSVR
| system value.
| Type Length Shipped Value
Character 10 ’*CALC’

QPFRADJ System Value

QPFRADJ is the performance adjustment. This value indicates whether the system
should adjust values during IPL and dynamically for system pool sizes and activity
levels.
v ’0’: No performance adjustment. The existing values for system pool sizes and
activity levels are used.
v ’1’: Performance adjustment at IPL. The values for system pool sizes and activity
levels are calculated and changed during IPL. The following values are changed:
– QMCHPOOL system value
– QBASACTLVL system value (if QSYS/QBASE, QSYS/QCTL, QGPL/QBASE,
or QGPL/QCTL is the controlling subsystem)
– Pool 2 of QGPL/QSPL subsystem description
– Pool 2 of QSYS/QBASE subsystem description (if QSYS/QBASE is controlling
subsystem)

Chapter 2. System Values 51

 – Pool 2 of QGPL/QBASE subsystem description (if QGPL/QBASE is controlling
subsystem)
– Pool 2 of QGPL/QINTER subsystem description (if QSYS/QCTL or
QGPL/QCTL is controlling subsystem)
v ’2’: Performance adjustment at IPL and dynamically. The values for system pool
sizes and activity levels are calculated and changed during IPL and at regular
intervals thereafter. The following values are changed:
– QMCHPOOL system value
– QBASACTLVL system value
– Pool 2 of QGPL/QSPL subsystem description
– Pool 2 of QSYS/QBASE subsystem description (if QSYS/QBASE is controlling
subsystem)
– Pool 2 of QGPL/QBASE subsystem description (if QGPL/QBASE is controlling
subsystem)
– Pool 2 of QGPL/QINTER subsystem description (if QSYS/QCTL or
QGPL/QCTL is controlling subsystem)
| – *INTERACT, *BASE, *SPOOL, *SHRPOOL1–*SHRPOOL60 pool sizes and
| activity levels
v ’3’: Dynamic performance adjustment. The values for system pool sizes and
activity levels are calculated and changed at regular intervals. The following
values are changed:
– QMCHPOOL system value
– QBASACTLVL system value
| – *INTERACT, *BASE, *SPOOL, *SHRPOOL1–*SHRPOOL60 pool sizes and
| activity levels

Note: If you choose to manually tune your system, the value for QPFRADJ should
be set to ’0’.

Changes to this system value take effect immediately.

Type Length Shipped Value

Character 1 ’2’

QPRBFTR System Value

QPRBFTR is the system value for the problem filter name. This system value
specifies the name of the filter object used by the service activity manager when
processing problems. QPRBFTR is a 20-character list of up to two 10-character
values in which the first value is the problem filter name and the second is the
library name. The possible values for the problem filter name are:
v ’*NONE’: No problem filter is in use.
v ’problem filter name’: The name of the problem filter to be used.
The possible values for the library name are:
v ’*LIBL’: Use the library list when locating the filter object.
v ’*CURLIB’: Use the current library when locating the filter object.
v ’library name’: The name of the library where the problem filter is located.

Type Length Shipped Value

Character 20 ’*NONE’

52 OS/400 Work Management V4R4

 QPRBHLDITV System Value
QPRBHLDITV is the problem log entry hold interval. This system value allows you
to specify the minimum number of days a problem is kept in the problem log. After
this time interval, the problem can be deleted using the Delete Problem (DLTPRB)
command. The time interval starts as soon as it is put into the log. The range for
this system value is 0 through 999 days.

A change to this system value takes effect immediately.

Type Length Shipped Value

Decimal (5 0) 30

QPRCFEAT System Value

| QPRCFEAT is the processor feature code. This is the processor feature code level
| of the system. You cannot change QPRCFEAT, but you can display or retrieve the
| 4-character value in user-written programs. The processor feature system value is
| the same in each partition on a system.

| For more information about the AS/400e 7xx servers Processor feature and
| Interactive feature values that correspond to the value contained in this system
| value, refer to the AS/400e System Handbook, GA19-5486-18.

Type Length Shipped Value

Character 4 No shipped value

QPRCMLTTSK System Value

QPRCMLTTSK is processor multi-tasking. This system value allows you to turn on
and turn off the processor multi-tasking capability. If enabled, more than one set of
task data will be resident in each CPU. Some work load may experience increased
performance due to caching implications. The possible values for processor
multi-tasking are:
v ’0’: Processor multi-tasking is turned off.
v ’1’: Processor multi-tasking is turned on.

| On a partitioned system, change this system value from the primary partition only.

| A change to this system value takes effect at the next IPL.

| Note: You must have *ALLOBJ and *SECADM special authority to change the
| QPRMLTTSK system value.
| Type Length Shipped Value
Character 1 1

QPRTDEV System Value

QPRTDEV is the default printer device description. This value specifies the default
printer for the system, and takes effect when a spooled file is opened. If the
specified device description exists, it must be a printer device description.

A change to this system value takes effect for new jobs started in the system.

Chapter 2. System Values 53

 Note: You must have *ALLOBJ and *SECADM special authority to change the
QPRTDEV system value.

Type Length Shipped Value

Character 10 ’PRT01’

QPRTKEYFMT System Value

QPRTKEYFMT is the print key format. This value specifies whether border and
header information is provided when the Print key is pressed.

A change to this system value takes effect for new jobs started on the system.

QPRTKEYFMT can be:

v *NONE: The border and header information is not included with output from the
Print key.
v *PRTBDR: The border information is included with output from the Print key.
v *PRTHDR: The header information is included with output from the Print key.
v *PRTALL: The border and header information is included with output from the
Print key.

Type Length Shipped Value

Character 10 ’*PRTHDR’

QPRTTXT System Value

QPRTTXT is print text. This system value is used to print up to 30 characters of text
on the bottom of listings and separator pages. For the text to be centered at the
bottom of the list, it must be centered in the QPRTTXT value field. The QPRTTXT
system value is used for system and subsystem monitor jobs and is the
system-wide default print text for all other jobs. If *BLANK is entered, QPRTTXT is
set to all banks.

A change to this system value takes effect for jobs that start after it is changed.

Type Length Shipped Value

Character 30 ’*BLANK’

QPWDEXPITV System Value

QPWDEXPITV is the system value for the password expiration interval. It controls
the number of days passwords are valid by keeping track of the number of days
since you changed your password or created a user profile. For example, if the last
date your user profile changed was 60 days ago and you change this value to ’2,’
you will need to change your password the next time you sign on the system. This
provides password security by requiring users to change their passwords after a
specified number of days. If the password is not changed within the specified
number of days, the user cannot sign on until the password is changed. Seven
days before the password ends, you are warned at sign-on time, even if you are not
displaying sign-on information (the system value QDSPSGNINF). The possible
values are:
v ’*NOMAX’: A password can be used an unlimited number of days.
v ’1’-’366’: The number of days before the password cannot be used.

54 OS/400 Work Management V4R4

 A change to this system value takes effect immediately.

Note: You must have *ALLOBJ and *SECADM special authority to change the
QPWDEXPITV system value.

Type Length Shipped Value

Character 6 ’*NOMAX’

QPWDLMTAJC System Value

QPWDLMTAJC limits adjacent digits in a password. It specifies whether adjacent
digits are allowed in passwords. This makes it difficult to guess passwords by
preventing use of dates or social security numbers as passwords. The possible
values are:
v ’0’: Adjacent digits are allowed in passwords.
v ’1’: Adjacent digits are not allowed in passwords.

A change to this system value takes effect the next time a password is changed.
Notes:
1. The password composition system values apply only to password changes
made using the CHGPWD command. The CRTUSRPRF and CHGUSRPRF
commands ignore password composition system values.
2. You must have *ALLOBJ and *SECADM special authority to change the
QPWDLMTAJC system value.

Type Length Shipped Value

Character 1 ’0’

QPWDLMTCHR System Value

QPWDLMTCHR limits the use of certain characters in a password. This value
provides password security by preventing certain characters (vowels, for example)
from being used in a password. This makes it difficult to guess passwords by
preventing use of common words or names as passwords. The possible values are:
v *NONE: There are no restricted characters.
v restricted-characters: Up to 10 restricted characters can be specified. Valid
characters are A through Z, 0 through 9, and special characters such as #, $, _,
or @. The specified characters must be enclosed in apostrophes. For example,
‘0123456789’ or ‘A_G5$@LU#’.

Note: ’0123456789’ cannot be specified if numbers are required in a password

(see the system value QPWDRQDDGT).

A change to this system value takes effect the next time a password is changed.
Notes:
1. The password composition system values apply only to password changes
made using the CHGPWD command. The CRTUSRPRF and CHGUSRPRF
commands ignore password composition system values.
2. You must have *ALLOBJ and *SECADM special authority to change the
QPWDLMTCHR system value.

Type Length Shipped Value

Character 10 ’*NONE’

Chapter 2. System Values 55

QPWDLMTREP System Value
QPWDLMTREP limits the use of repeating characters in a password. The possible
values are:
v ’0’: Characters can be used more than once.
v ’1’: Characters cannot be used more than once. For example, ’BARB’ is not
allowed.
v ’2’: Characters cannot be used consecutively. For example, ’JEFF’ is not allowed,
but ’BARB’ is allowed.

A change to this system value takes effect the next time a password is changed.
Notes:
1. The password composition system values apply only to password changes
made using the CHGPWD command. The CRTUSRPRF and CHGUSRPRF
commands ignore password composition system values.
2. You must have *ALLOBJ and *SECADM special authority to change the
QPWDLMTREP system value.

Type Length Shipped Value

Character 1 ’0’

QPWDMAXLEN System Value

QPWDMAXLEN specifies the maximum length of a password. It controls the
maximum number of characters in a password.

Note: The maximum password size can not be smaller than the minimum
password size specified in the QPWDMINLEN system value. The possible
values are:
v 1-10: The maximum number of characters that can be specified for a password.

A change to this system value takes effect the next time a password is changed.
Notes:
1. The password composition system values apply only to password changes
made using the CHGPWD command. The CRTUSRPRF and CHGUSRPRF
commands ignore password composition system values.
2. You must have *ALLOBJ and *SECADM special authority to change the
QPWDMAXLEN system value.

Type Length Shipped Value

Decimal (5 0) 8

QPWDMINLEN System Value

QPWDMINLEN specifies the minimum length of a password. It controls the
minimum number of characters in a password.

Note: The minimum password size can not be larger than the maximum password
size specified in the QPWDMAXLEN system value. The possible values are:
v 1-10: The minimum number of characters that can be specified for a password.

56 OS/400 Work Management V4R4

 Notes:
1. The password composition system values apply only to password changes
made using the CHGPWD command. The CRTUSRPRF and CHGUSRPRF
commands ignore password composition system values.
2. You must have *ALLOBJ and *SECADM special authority to change the
QPWDMINLEN system value.

Type Length Shipped Value

Decimal (5 0) 6

QPWDPOSDIF System Value

QPWDPOSDIF limits password character positions. It controls the position of
characters in a new password. This prevents the user from specifying the same
character in a password corresponding to the same position in the previous
password. For example, new password ALB2 could not be used if the previous
password was ALB1 (the A, L, and B are in the same positions). The possible
values are:
v ’0’: The same characters can be used in a position corresponding to the same
position in the previous password.
v ’1’: The same characters cannot be used in a position corresponding to the same
position in the previous password.
Notes:
1. The password composition system values apply only to password changes
made using the CHGPWD command. The CRTUSRPRF and CHGUSRPRF
commands ignore password composition system values.
2. You must have *ALLOBJ and *SECADM special authority to change the
QPWDPOSDIF system value.

Type Length Shipped Value

Character 1 ’0’

QPWDRQDDGT System Value

QPWDRQDDGT specifies whether a digit is required in a new password. This
prevents the user from only using alphabetic characters. The possible values are:
v ’0’: A numeric digit is not required in new passwords.
v ’1’: A numeric digit is required in new passwords.

Note: ’0123456789’ cannot be specified for the system value QPWDLMTCHR if

numbers are required in a password.

A change to this system value takes effect the next time a password is changed.
Notes:
1. The password composition system values apply only to password changes
made using the CHGPWD command. The CRTUSRPRF and CHGUSRPRF
commands ignore password composition system values.
2. You must have *ALLOBJ and *SECADM special authority to change the
QPWDRQDDGT system value.

Type Length Shipped Value

Character 1 ’0’

Chapter 2. System Values 57

QPWDRQDDIF System Value
QPWDRQDDIF controls duplicate passwords and limits how often a user can
repeat the use of a password. The possible values are:
’0’ A password can be the same as any previously used password (except the
immediately preceding password).
’1’ A password must be different from the previous 32 passwords.
’2’ A password must be different from the previous 24 passwords.
’3’ A password must be different from the previous 18 passwords.
’4’ A password must be different from the previous 12 passwords.
’5’ A password must be different from the previous 10 passwords.
’6’ A password must be different from the previous 8 passwords.
’7’ A password must be different from the previous 6 passwords.
’8’ A password must be different from the previous 4 passwords.

A change to this system value takes effect the next time a password is changed.
Notes:
1. The password composition system values apply only to password changes
made using the CHGPWD command. The CRTUSRPRF and CHGUSRPRF
commands ignore password composition system values.
2. You must have *ALLOBJ and *SECADM special authority to change the
QPWDRQDDIF system value.

Type Length Shipped Value

Character 1 ’0’

QPWDVLDPGM System Value

QPWDVLDPGM is the password validation program. It provides the ability for a
user-written program to do additional validation on passwords. The possible values
are:
v ’*NONE’: No validation program is used.
v ’program library’: Specify the name of the validation program and the library (if
known) containing the program. For example, ’VALIDPGM’ or ’VALIDPGM
PGMLIB’.

A change to this system value takes effect the next time a password is changed.
Notes:
1. The password composition system values apply only to password changes
made using the CHGPWD command. The CRTUSRPRF and CHGUSRPRF
commands ignore password composition system values.
2. You must have *ALLOBJ and *SECADM special authority to change the
QPWDVLDPGM system value.

Type Length Shipped Value

Character 20 ’*NONE’

58 OS/400 Work Management V4R4

 QPWRDWNLMT System Value
QPWRDWNLMT is the maximum amount of time an immediate power down can
take before processing is ended (abnormal end). This is the time used to wait for
power down to complete normally after either of the following happens:
v A Power Down System (PWRDWNSYS) command with the OPTION(*IMMED)
parameter is entered.
v A PWRDWNSYS command with the OPTION(*CNTRLD) parameter entered and
the time specified on the DELAY parameter has ended.

| The QPWRDWNLMT value is ignored when entering either of these commands

| after a power failure has occurred on a system with an uninterruptible power supply.
| (See the Backup and Recovery book for more details.)

A change to this value takes effect when a PWRDWNSYS command is entered.

QPWRDWNLMT is numeric. The lower limit for QPWRDWNLMT is 0. If the value is
set to 0 and a PWRDWNSYS command with OPTION(*IMMED) is entered,
processing is ended immediately (abnormal end).

If you specify the TIMOUTOPT(*MSD) parameter on the PWRDWNSYS command,

the system will dump the main storage after the amount of time specified by
QPWRDWNLMT has passed. If the dump manager is configured correctly, the
system will restart. Otherwise, the B900 3F10 system reference code will be
displayed and the system will halt.

Note: If the value is set to 0 (or a very small value), a power-down time-out
condition occurs, and the system does not finish the power-down operation
even though the system processing has ended.

Type Length Shipped Value

Decimal (5 0) 600 seconds

QPWRRSTIPL System Value

| QPWRRSTIPL is the system value for an automatic IPL after restoring power. The
| value specifies whether the system should automatically IPL when utility power
| returns after a power failure. A change to this system value takes effect
| immediately. On a partitioned system, change this system value from the primary
| partition only. The QPWRRSTIPL system value controls only the primary partition.
| QPWRRSTIPL can be:
| v ’0’: Automatic IPL is not allowed
| v ’1’: Automatic IPL is allowed

| The IPL action configuration value for the secondary partition determines whether a
| secondary partition will IPL at the same time as the primary partition. For details on
| configuring logical partitions on your AS/400 system, go to Planning For and Setting
| Up under the Logical Partitions topic in the AS/400 Information Center. You can
| access the Information Center from the AS/400e Information Center CD-ROM
| (English version: SK3T-2027) or from one of these Web sites:
| http://www.as400.ibm.com/infocenter
| http://publib.boulder.ibm.com/pubs/html/as400/infocenter.htm

| Note: You must have *ALLOBJ and *SECADM special authority to change the
QPWRRSTIPL system value.

Chapter 2. System Values 59

 Type Length Shipped Value
Character 1 ’0’

QQRYDEGREE System Value

QQRYDEGREE specifies the parallel processing option. QQRYDEGREE also
determines whether the type of parallel processing is Input/Output (IO) parallel
processing or Symmetric Multiprocessing (SMP). For I/O parallel processing, the
database manager can use multiple tasks for each query. Processing for the central
processing unit (CPU) is still done serially. For Symmetric Multiprocessing, the CPU
and I/O processing are assigned to tasks that run the query in parallel. Actual CPU
parallelism requires a system with multiple processors. SMP parallelism is used
only if the system feature DB2 Symmetric Multiprocessing for OS/400 is installed.
The values allowed are:
v *NONE: No parallel processing is allowed for database query processing.
v *IO: Any number of tasks may be used when the database query optimizer
chooses to use I/O parallel processing for queries. SMP parallel processing is not
allowed.
v *OPTIMIZE: The query optimizer can use any number of tasks for either I/O or
SMP parallel processing for queries. Use of parallel processing and the number
of tasks used is determined by the following:
– The number of processors available in the system.
– The job’s share of the amount of active memory available in the pool in which
the job is run.
– The expected elapsed time for the query is limited by CPU processing or I/O
resources.
v *MAX: The query optimizer can choose to use either I/O or SMP parallel
processing to process the query. The choices made by the query optimizer are
similar to the choices for the value *OPTIMIZE. However, the optimizer assumes
that all active memory in the pool can be used to process the query.

| Note: You must have *ALLOBJ and *SECADM special authority to change the
| QQRYDEGREE system value.
| Type Length Shipped Value
Character 10 ’*NONE’

QQRYTIMLMT System Value

QQRYTIMLMT is the query processing time limit system value. This value specifies
the time limit that is compared to the estimated number of elapsed seconds that a
query must run. The time limit determines if the database query can start. The
allowed values are:
v *NOMAX: There is no maximum number of estimated elapsed seconds.
v 0–2147352578: This specifies the number of seconds that are compared to the
estimated number of elapsed seconds that are required to run a query. If the
estimated elapsed seconds is greater than this value, the query is not started.

| Note: You must have *ALLOBJ and *SECADM special authority to change the
| QQRYTIMLMT system value.
| Type Length Shipped Value
Character 10 ’*NOMAX’

60 OS/400 Work Management V4R4

 QRCLSPLSTG System Value
QRCLSPLSTG is reclaim spool storage system value. It allows for the automatic
removal of empty spool database members. The values allowed are:
v *NOMAX: The maximum retention interval. All empty members are kept. You
must use the Reclaim Spooled Storage (RCLSPLSTG) command to delete empty
spooled members from the system.
v *NONE: No retention interval. All empty members are deleted.

Note: Specifying a value of *NONE results in additional system overhead when

creating spooled files. Serious degradation of system performance may
result.
v ’1’ through ’366’: Number of days empty spool database members are kept for
new spooled file use. If the members are still empty after the specified number of
days, they are deleted by the system.

Type Length Shipped Value

Character 10 ’8’

QRETSVRSEC System Value

QRETSVRSEC is the retain server security data system value. The value
determines whether the security data needed by a server to authenticate a user on
a target system through client/server interfaces can be retained on the host system.
The values allowed are:
v ’0’: Retain server security data is off.
v ’1’: Retain server security data is on.

A change to this system value takes effect immediately.

Note: You must have *ALLOBJ and *SECADM special authority to change the
QRETSVRSEC system value.

Type Length Shipped Value

Character 1 ’0’

QRMTIPL System Value

| QRMTIPL is the remote power on and IPL indicator. This value specifies if remote
| power on and IPL can be started over a telephone line.

| On a partitioned system, change this system value from the primary partition only.
| The IPL action configuration value for the secondary partition determines whether a
| secondary partition will IPL at the same time as the primary partition. For details on
| configuring logical partitions on your AS/400 system, go to Planning For and Setting
| Up under the Logical Partitions topic in the AS/400 Information Center. You can
| access the Information Center from the AS/400e Information Center CD-ROM
| (English version: SK3T-2027) or from one of these Web sites:
| http://www.as400.ibm.com/infocenter
| http://publib.boulder.ibm.com/pubs/html/as400/infocenter.htm

| The values for QRMTIPL can be:

v ’0’: Remote power on and IPL are not allowed.
v ’1’: Remote power on and IPL are allowed.

Chapter 2. System Values 61

 Notes:
1. Any telephone call causes the system to IPL.
2. You must have *ALLOBJ and *SECADM special authority to change the
QRMTIPL system value.

Type Length Shipped Value

Character 1 ’0’

QRMTSIGN System Value

QRMTSIGN is the system value for remote sign-on control. It specifies how the
system handles remote sign-on requests. QRMTSIGN can have the following
values:
v ’*FRCSIGNON’: All remote sign-on sessions are required to go through normal
sign-on processing.
| v ’*SAMEPRF’: For 5250 display station pass-through or workstation function,
| when the source and target user profile names are the same, the sign-on may be
| bypassed for remote sign-on attempts. When using TELNET, the sign-on may be
| bypassed.
v ’*VERIFY’: After verifying that the user has access to the system, the system
allows the user to bypass the sign-on.
| v ’*REJECT’: Allows no remote sign-on for 5250 display station pass-through or
| work station function. When QRMTSIGN is set to *REJECT, the user can still
| sign on to the system by using TELNET. These sessions will go through normal
| processing. If you want to reject all TELNET requests to the system, end the
| TELNET servers.
v ’program library’: The user can specify a program and library (or *LIBL) to decide
which remote sessions are allowed and which user profiles can be automatically
| signed on from which locations. This option is only valid for pass-through.

| Note: If you are using a program, TELNET will behave as if *FRCSIGNON was
| coded. If you wish to have a program that is run for TELNET session
| initialization and termination, use the TELNET exit points. See the TCP/IP
| Configuration and Reference, SC41-5420-03 for more information on the
| TELNET exit points.

| A change to this system value takes effect immediately.

Note: You must have *ALLOBJ and *SECADM special authority to change the
QRMTSIGN system value.

Type Length Shipped Value

Character 20 ’*FRCSIGNON’

Note: The display station pass-through chapter in the Remote Work Station
Support book describes QRMTSIGN in greater detail.

QRMTSRVATR System Value

QRMTSRVATR controls the remote system service problem analysis ability. The
value allows the system to be analyzed remotely. The values allowed are:
v ’0’: Remote service attribute is off.
v ’1’: Remote service attribute is on.

62 OS/400 Work Management V4R4

 A change to this system value takes effect immediately.

Note: You must have *ALLOBJ and *SECADM special authority to change the
QRMTSRVATR system value.

Type Length Shipped Value

Character 1 ’0’

QSCPFCONS System Value

QSCPFCONS is the IPL action with console problem indicator. This value specifies
whether the IPL is to continue unattended or ends when the console is not
operational when performing an attended IPL. QSCPFCONS must have been set
before the current IPL. QSCPFCONS can be:
v ’0’: End system. QSCPFCONS should be 0 if workstations other than the console
are not on the system or if the controlling subsystem supports only the console
and does not start other subsystems that support other workstations.
v ’1’: Continue the IPL unattended.

Type Length Shipped Value

Character 1 ’1’

QSECOND System Value

QSECOND is the system value for the second of the minute. Its value can range
from ’00’ through ’59’. A change to this system value takes effect immediately, and
changes the system value QTIME.

Type Length Shipped Value

Character 2 No shipped value

QSECURITY System Value

QSECURITY is the system security level indicator.

For unattended IPL, previously requested changes to the security level are made
during the IPL.

QSECURITY can be:

v ’10’: The system does not require a password to sign-on. The user has access to
all system resources. Special authorities can be added or removed from a user
profile by using the CRTUSRPRF or CHGUSRPRF command.

Note: This security level is no longer supported.

v ’20’: The system requires a password to sign-on. The user has access to all
system resources.
v ’30’: The system requires a password to sign-on and users must have authority
to access objects and system resources.
v ’40’: The system requires a password to sign-on and users must have authority
to access objects and system resources. Programs that try to access objects
through interfaces that are not supported will fail.
v ’50’: The system requires a password to sign on, and users must have
authorization to access objects and system resources. The security and integrity

Chapter 2. System Values 63

 of the QTEMP library is enforced. Programs fail if they try to pass unsupported
parameter values to supported interfaces, or if they try to access objects through
interfaces that are not supported.
For more information on security level 50, see the Security - Reference.
All user profiles will have special authorities granted or revoked based on their user
class when changing from a security level 10 or 20 system to security level 30 or
higher.

The QSECURITY system value can be changed at any time but the change to the
security level does not take effect until the next IPL as follows:

For attended IPL, the security level required to sign on for the IPL will stay the
same as what was in effect before an IPL was performed on the system. Changes
are made during the IPL but after the sign on for the IPL.

Note: During an attended IPL, you can also change the QSECURITY system value
by selecting ’Define or Change System’ on the IPL Options display and the
change will take effect when the IPL is done. This change would override
any change that was requested before the IPL.

Note: You must have *ALLOBJ and *SECADM special authority to change the
QSECURITY system value.

Type Length Shipped Value

Character 2 ’40’

QSETJOBATR System Value

QSETJOBATR is the system value to set certain job attributes using the value in a
locale.

The allowed values are:

v *NONE: No job attributes are set.
v A combination of the following values can be used:
– *CCSID: Coded Character Set ID
– *DATFMT: Date format
– *DATSEP: Date separator
– *SRTSEQ: Sort sequence
– *TIMSEP: Time separator
– *DECFMT: Decimal format

A change to this system value takes effect immediately. However, this change will
not affect any jobs that are currently running. The shipped value is *NONE.

Type Length Shipped Value

Character 160 ’*NONE’

QSFWERRLOG System Value

QSFWERRLOG is the system value for the software error log. This system value
specifies whether software errors should be logged by the system. A change to this
system value takes effect immediately. The allowed values are:

64 OS/400 Work Management V4R4

 v *LOG: Software errors are logged in the error log, a problem alert record (PAR)
message is sent to the QSYSOPR message queue, and an entry is created in
the Problem Log in READY status.
v *NOLOG: No logging occurs.

Type Length Shipped Value

Character 10 ’*LOG’

QSPCENV System Value

QSPCENV is the special environment indicator. This value specifies the system
environment used as the default for all users. QSPCENV can be:
v ’*NONE’: You enter the AS/400 system environment when you sign on.
v ’*S36’: You enter the System/36 environment when you sign on.

A change to this system value takes effect the next time a user signs on.

Note: You must have *ALLOBJ and *SECADM special authority to change the
QSPCENV system value.

Type Length Shipped Value

Character 10 ’*NONE’

QSRLNBR System Value

| QSRLNBR is the system serial number. You cannot change QSRLNBR; the system
| retrieves it from the data fields when installing the OS/400 licensed program. You
| can display QSRLNBR, or you can retrieve this value in user-written programs. The
| system serial number system value is the same in each partition on a system. An
| example of a serial number is 1001003.

Type Length Shipped Value

Character 8 No shipped value

QSRTSEQ System Value

QSRTSEQ specifies the default sort sequence to be used by the system. The
following are possible values:
v *HEX: No sort sequence table is used. The hexadecimal values of the characters
are used to determine the sort sequence.
v *LANGIDSHR: The sort sequence table used can contain the same weight for
multiple characters. It is the shared weight sort table associated with the
language specified in the LANGID parameter.
v *LANGIDUNQ: The sort sequence table used must contain a unique weight for
each character in the code page. It is the unique weight sort table associated
with the language specified in the LANGID parameter.
v Qualified sort sequence table name: The name and library of the sort sequence
table to be used.

Type Length Shipped Value

Character 20 ’*HEX’

Chapter 2. System Values 65

 QSTGLOWACN System Value
QSTGLOWACN specifies the action to take when the available storage in the
system auxiliary storage pool (ASP) is below the lower limit for auxiliary storage.
The values for QSTGLOWACN are:
v *MSG: Message CPI099C is sent to QSYSMSG and QSYSOPR message
queues. This message is also sent for the other actions.
v *CRITMSG: Message CPI099B is sent to the users specified in the service
attribute to receive critical messages. Only users who are signed on at a work
station are notified. The Change Service Attribute (CHGSRVA) command is used
to change which users are notified.
v *REGFAC: A job is submitted to call exit programs registered for the
QIBM_QWC_QSTGLOWACN exit point. The Add Exit Program (ADDEXITPGM)
command is used to register an exit program.
v *ENDSYS: The system is ended to the restricted state.
v *PWRDWNSYS: The system is powered down immediately and restarted.

If the available storage is below the limit during IPL and the action is not *MSG, the
system will come up in the restricted state.

When the following conditions exist:

v The available storage is below the limit.
v The action is *REGFAC, *ENDSYS, or *PWRDWNSYS.
v The system is in the restricted state.
you cannot start a subsystem until:
v The available storage is reduced.
v The action is changed to *MSG or *CRITMSG.

No action is taken if the following occurs:

v Available storage drops below the limit
v The system is in the restricted state
v The action is *REGFAC, *ENDSYS, or *PWRDWNSYS

The action is repeated in one-half hour if the available storage is still below the
lower limit.

Changes to this system value take effect when the available storage goes below
the lower limit. If the available storage is already below the limit, the action is taken
| at the next allocation of storage from the system ASP.

| Note: You must have *ALLOBJ and *SECADM special authority to change the
| QSTGLOWACN system value.
| Type Length Shipped Value
Character 10 ’*MSG’

QSTGLOWLMT System Value

QSTGLOWLMT specifies the percent of the available storage remaining in the
system ASP when the auxiliary storage lower limit is reached. The QSTGLOWACN

66 OS/400 Work Management V4R4

 system value specifies the action associated with this limit. The percent of storage
currently used in the system ASP is viewed with the Work with System Status
(WRKSYSSTS) command.

The shipped value may be adjusted during the installation if the DST threshold for
the system ASP is over 95%.

| A change to this system value takes effect immediately. The shipped value is 5.

| Note: You must have *ALLOBJ and *SECADM special authority to change the
| QSTGLOWLMT system value
| Type Length Shipped Value
Decimal (7 4) 5.0

QSTRPRTWTR System Value

QSTRPRTWTR specifies whether printer writers are started at IPL. This system
value is either set by the system at IPL time or by the user on the IPL Options
display. The IBM-supplied startup program QSTRUP uses this system value to
determine whether to start printer writers. QSTRPRTWTR can be:
v ’0’: Do not start printer writers.
v ’1’: Start printer writers.

This value can only be displayed or retrieved.

Type Length Shipped Value

Character 1 ’1’

QSTRUPPGM System Value

QSTRUPPGM is the start-up program. This value specifies the name of the
program called from an autostart job when the controlling subsystem is started. This
program performs setup functions, such as starting subsystems and printers. This
system value can only be changed by the security officer or by someone with
security officer authority. A change to this system value takes effect the next time an
IPL is performed. QSTRUPPGM can have the values:
v ’QSTRUP QSYS’: The program specified is run as a result of a transfer of control
to it from the autostart job in the controlling subsystem.
v ’*NONE’: The autostart job ends normally without calling a program.

The default startup program QSYS/QSTRUP does the following:

v Starts the QSPL subsystem for spooled work.
v Releases the QS36MRT and QS36EVOKE job queues if they were held (these
are used by the System/36 environment).
v Starts Operational Assistant cleanup, if allowed.
v Starts all print writers unless user specified not to on the IPL Options display.
| v Starts the QSERVER and QUSRWRK subsystems.
v If the controlling subsystem is QCTL, it starts the QINTER, QBATCH, and QCMN
subsystems.

Type Length Shipped Value

Character 20 ’QSTRUP QSYS’

Chapter 2. System Values 67

 QSRVDMP System Value
QSRVDMP specifies whether service dumps for unmonitored escape messages are
created. The values that are allowed are:
v *DMPUSRJOB: Service dumps are only created for user jobs, not system jobs.
System jobs include the system arbiter, subsystem monitors, LU services
process, spool readers and writers, and the SCPF job.
v *DMPSYSJOB: Service dumps will only be created for system jobs, not user
jobs.
v *DMPALLJOB: Service dumps will be created for all jobs.
v *NONE: Do not request dumps in any jobs.

Note: The ability to control the creation of service dumps with this system value
may have an effect on IBM’s ability to respond to some system failures. The
value *DMPALLJOB can be used to ensure that a service dump is created
whenever a failing function requests one. The shipped value
(*DMPUSRJOB) provides that service dumps are created only for user jobs.

Type Length Shipped Value

Character 10 ’*DMPUSRJOB’

QSTSMSG System Value

QSTSMSG is the system value for status messages. This system value specifies
whether or not the status message is displayed. A change to this system value
takes effect the next time someone signs-on the system. Active interactive jobs are
not changed. The values allowed are:
v *NORMAL: Status messages are displayed.
v *NONE: Suppresses status messages from being displayed.

Type Length Shipped Value

Character 10 ’*NORMAL’

QSVRAUTITV System Value

| QSVRAUTITV specifies the time interval for server authentication in minutes. This
| system value refers to the interval during which the user may access an object. The
| values allowed are:
| v 1-108000: The authentication will expire at the end that is specified.

| A change to this value takes effect immediately. The shipped value is 2880 minutes
(48 hours).

Note: You must have *ALLOBJ and *SECADM special authority to change the
QSVRAUTITV system value.

Type Length Shipped Value

Decimal (6 0) 2880

QSYSLIBL System Value

| QSYSLIBL is the system part of the library list. The list can contain as many as 15
| names. When searching for an object in the library list, the libraries in the system

68 OS/400 Work Management V4R4

| part are searched before any libraries in the user part are searched. A library
| specified as part of the library list cannot be deleted or renamed once the system is
| fully operational.

The QSYSLIBL value is a 150-character list, enclosed in apostrophes, of up to 15

library names. Each name must not exceed 10 characters in length. A blank must
separate each library name when changing this system value by using the
CHGSYSVAL command. Apostrophes are necessary only when more than one
library name is specified (for example, 'SYSLIB1 SYSLIB2').

To change the QSYSLIBL system value, QSYS must be one of the libraries
specified. A change to this value takes effect when the next job starts.

Note: To change the QSYSLIBL system value, you must have *ALLOBJ and
*SECADM special authority, which can be from a user profile, a group
profile, or it can be adopted by a program.

Type Length Shipped Value

Character 150 ’QSYS QSYS2 QHLPSYS
QUSRSYS’

QTIME System Value

QTIME is the system value for the time of day. QTIME is composed of the following
system values: QHOUR, QMINUTE, and QSECOND. Its value can be set from the
IPL options display. QTIME has the format hhmmss, where hh = hours, mm =
minutes, and ss = seconds. A change made to this value takes effect immediately,
and may affect the system values QHOUR, QMINUTE, and QSECOND.

Note: When you change the QTIME system value, (for example, daylight savings
time), you should also consider changing the QUTCOFFSET (coordinated
universal time offset) system value.

Type Length Shipped Value

Character 6, 7, 8, or 9 No shipped value

QTIME is a 6- to 9-character value depending on the resolution required. A length

of 6 characters provides 2 characters each for hours, minutes, and seconds. As the
length increases, the time resolution becomes more precise (tenths of a second in
position 7, hundredths of a second in position 8, and thousandths of a second in
position 9).

The Retrieve System Value (RTVSYSVAL) command allows the CL variable to be

greater than or equal to 6 characters. If the CL variable is larger than 9 characters,
then the first 9 characters contains hours, minutes, seconds, and milliseconds and
the others are padded with blanks. The Change System Value (CHGSYSVAL)
command sets milliseconds to zero on a change to QTIME, QHOUR, QMINUTE, or
QSECOND. Milliseconds cannot be specified on any system value change. The
Display System Value (DSPSYSVAL) command does not display milliseconds.

The following table shows the various values provided by the CL character variable.

Length of CL Character
Variable Meaning
<6 Not valid.
6 Hours, minutes, and seconds.

Chapter 2. System Values 69

 Length of CL Character
Variable Meaning
7 Hours, minutes, seconds, and tenths of a second.
8 Hours, minutes, seconds, tenths of a second, and
hundredths of a second.
9 Hours, minutes, seconds, tenths of a second, hundredths
of a second, and thousandths of a second.
>9 Hours, minutes, seconds, tenths of a second, hundredths
of a second, thousandths of a second, and padded with
blanks.

See also “Changes to QDATE and QTIME and Job Schedule Entries” on page 233.

QTIMSEP System Value

QTIMSEP is the character separator for time. This system value is used as the time
separator for the default value of the TIMSEP job attribute or in the time you can
specify on the IPL options prompt.

QTIMSEP must be one of the following values: ’:’(colon), ’.’ (period), ’,’ (comma), or
’ ’ (blank).

The Work with System Value (WRKSYSVAL) and Display System Value
(DSPSYSVAL) commands use numbers to represent each of the values for
QTIMSEP:
1 = ’:’
2 = ’.’
3 = ’,’
4 = blank
The Change System Value (CHGSYSVAL) and Retrieve System Value
(RTVSYSVAL) commands use the actual values for QTIMSEP.

A change to this system value takes effect for new jobs that enter the system after
the change.

Type Length Shipped Value

Character 1 May be different for different
countries.

QTOTJOB System Value

QTOTJOB represents the minimum number of jobs for which storage is allocated.
The number of jobs is the number supported by the system at any one time, which
includes the jobs on job queues, active jobs (including system jobs), and jobs
having output on output queues.
Notes:
1. The system value QJOBSPLA is measured in bytes.
2. Additional space is not allocated for spool jobs that are on the system during an
IPL.

70 OS/400 Work Management V4R4

 If QTOTJOB is set so that the amount of storage required exceeds the amount
currently available, additional storage is allocated. If QTOTJOB is set so that the
amount of storage required is less than the amount currently available, no action is
taken.

To find the number of total jobs in the system, view the jobs in the system field of
the system status display (using the WRKSYSSTS command). This number should
usually be kept within reason as it is a factor in the time to perform IPL and some
internal searches. This may require periodic removal of jobs that have only job logs.
The CL Programming book has a discussion of job logs and how to remove them
for jobs that complete normally. As long as a job has one or more spooled output
files known to the system, knowledge of the job remains in the system and counts
toward the display system status value.

Note: You should set this value high enough so it will not normally be exceeded by
the total number of jobs.

A change to this value takes effect at the next IPL unless the change is made on
the IBM-supplied configuration menu, in which case, it is used for the current IPL.
QTOTJOB may be changed to a smaller value during IPL if the combination of
allocation system values requires more auxiliary storage than is available to start
the system. If this happens, you are notified.

Type Length Shipped Value

Decimal (5 0) 30

QTSEPOOL System Value

QTSEPOOL is the time slice end pool. This value specifies whether interactive jobs
should be moved to another main storage pool when they reach time slice end. The
job is moved back to the pool it was originally running in when a long wait occurs.
This may help minimize the effect on interactive response time of other interactive
jobs when one interactive job is performing a long running function. The values
allowed are:
v *NONE: Jobs are not moved to the base storage pool when time slice end is
reached.
v *BASE: Jobs are moved to the base pool when time slice end is reached.

If you allowed the IPL performance adjustment to tune the system, then you should
set this value to *BASE.

A change to this value takes effect when a job is started. Active jobs are not
changed.

Type Length Shipped Value

Character 10 ’*NONE’

QUPSDLYTIM System Value

QUPSDLYTIM is the uninterruptible power supply delay time. The QUPSDLYTIM
system value indicates the amount of time that should elapse before the system
automatically powers down following a power failure. When a change in power
activates the uninterruptible power supply, messages are sent to the uninterruptible
power supply message queue (the system value QUPSMSGQ).

Chapter 2. System Values 71

| On a partitioned system, change this system value from the primary partition only.

This system value is only meaningful if your system has the battery power unit or
has an uninterruptible power supply attached. The allowed values are:

Value Description
’*BASIC’ Powers only the PRC, IOP cards, and load source storage. The
appropriate wait time, in seconds, is calculated. (This should only be
used if you have the battery power unit or an uninterruptible power
supply without every rack being connected.)
Notes:
1. All other values indicate an uninterruptible power supply on all racks.
2. This value should not be used for a 9402 or 9404 system.
3. The calculated value may have to be adjusted by the user if there
has been a series of power outages, or if the batteries are not fully
charged.
| ’*CALC’ The appropriate wait time (in seconds) is calculated. This value should
| only be used if you have a 9402 or 9404 system with a battery power
| unit. *CALC will not be displayed or retrieved on a secondary partition.
| Instead, the calculated value will display.
Notes:
1. The calculated value is appropriate for the 9402 and 9404 user
(although there is no restriction on its use by a 9406 user).
2. The calculated value is based on the amount of devices and the
number of changed pages in main storage.
3. The calculated value may have to be adjusted by the user if there
has been a series of power outages, or if the batteries are not fully
charged.
’*NOMAX’ The system does not start any action on its own.
Note: If you use ’*NOMAX’ you must also meet the requirements of
QUPSMSGQ (see page 73 for these requirements).
’0’ Automatic system power down when system utility power fails.
’1’-’99999’ Delay time specified in seconds before the system powers down.

The QUPSDLYTIM system value is in the form of a two-item list. The first item is
the value the user specified on the CHGSYSVAL command. The second item is the
delay time, which is either what the user specified or, if *CALC or *BASIC is
specified, is the calculated delay time.

You specify only the first item in the list. The second item, if specified, will be
ignored. If you want to retrieve the QUPSDLYTIM system value, you would retrieve
it into a CHAR 20 variable. The first 10 characters would be what you specified.
The second 10 characters would be the delay time value (specified by you or
calculated by the machine) you would use in your program.

10 Characters 10 Characters
0000000340 0000000340
*NOMAX *NOMAX
*CALC 0000000120
*BASIC 0000000150

The following examples show what the user could enter and how the value would
be displayed:

Example 1 ’*CALC’

72 OS/400 Work Management V4R4

 User types:
CHGSYSVAL QUPSDLYTIM *CALC

Using DSPSYSVAL, display shows:

Delay Time . . . . . .: *CALC
Delay value in seconds: 60

| Using DSPSYSVAL on a secondary partition, display shows:

| Delay Time . . . . . .: 60
| Delay value in seconds: 60

| Example 2 ’*NOMAX’

User types:
CHGSYSVAL QUPSDLYTIM *NOMAX

Display shows:
Delay Time . . . . . .: *NOMAX
Delay value in seconds: *NOMAX

Example 3 ’*BASIC’

User enters:
CHGSYSVAL QUPSDLYTIM *BASIC
Display shows:
Delay Time . . . . . .: *BASIC
Delay value in seconds: 150

A change to this system value takes effect the next time there is a power failure.
For more information on the uninterruptible power supply feature, see the Backup
and Recovery book.

Type Length Shipped Value

Character 20 ’*CALC’

QUPSMSGQ System Value

Name of a message queue that is to receive uninterruptible power supply
messages. If the message queue is not the system operator message queue
(QSYSOPR QSYS), then all uninterruptible power supply messages are also sent to
the QSYSOPR message queue. This system value is meaningful only if your
system has the battery power unit feature and has an uninterruptible power supply
attached.

When a change in power activates the uninterruptible power supply, this message
queue receives the uninterruptible power supply activated message (CPF1816). If
the QUPSDLYTIM is ’*NOMAX’, the following conditions must be met or the system
begins an immediate power down.
v The message queue specified in the QUPSMSGQ system value must exist.
v If the message queue is a workstation message queue (or QSYSOPR), it must
be in break or notify mode.
v If the message queue is not a workstation message queue, it must be allocated
by a job.

Chapter 2. System Values 73

 For all other uninterruptible power supply messages, the message queue does not
have to be allocated, or in break or notify mode. If the system value QUPSMSGQ
does not contain the name of a valid message queue, a message is be sent to
QSYSOPR indicating the notification failure, and the system continues processing.

Note: All messages in QUPSMSGQ are cleared during an IPL. If you assign
QUPSMSGQ as the user’s message queue, the user loses all messages in
the user’s message queue during each IPL.

For more information on the uninterruptible power supply feature, see the Backup
and Recovery book.

A change to this system value takes effect the next time there is a power failure.

Type Length Shipped Value

Character 20 ’QSYSOPR QSYS’

QUSEADPAUT System Value

QUSEADPAUT is the system value that defines which users can create programs
with the use adopted authority (*USEADPAUT(*YES)) attribute. The system value
defaults to *NONE. All users can create, change, or update programs and service
programs to use adopted authority. However, the user must have the necessary
authority to the program or service program.

The system value can also contain the name of an authorization list. The user’s
authority is checked against this authorization list. If the user has at least *USE
authority to the named authorization list, the user can create, change, or update
programs or service programs with the USEADPAUT(*YES) attribute. This authority
cannot come from adopted authority.

If an authorization list is in the system value and the authorization list is missing,
the function being attempted will not complete. This is indicated with a message. If
the command or API requests more than one function, and the authorization list is
missing, the function is not performed. You will receive a function check if you are
using one of the following commands when the authorization list cannot be found:
v Create Pascal Program (CRTPASPGM)
v Create Basic Program (CRTBASPGM)

The following values are allowed:

v ’authorization-list name’: If an authorization list is specified and the user does not
have authority to the authorization list and there are no other errors when the
program or service program is created, a diagnostic message is signaled to
indicate the program is created with USEADPAUT(*NO). If the user has authority
to the authorization list, the program or service program is created with
USEADPAUT(*YES).
v ’*NONE’: All users can create, change, and update programs and service
programs to use adopted authority. However, the user must have necessary
authority to the program or service program.

| A change to this system value takes effect when the user’s programs are created.

| Note: You must have *ALLOBJ and *SECADM special authority to change the
| QUSEADPAUT system value.

74 OS/400 Work Management V4R4

| Type Length Shipped Value
Character 10 ’*NONE’

QUSRLIBL System Value

QUSRLIBL is the default for the user part of the library list. The list can contain as
many as 25 names. The libraries in this part are searched for an object after the
libraries in the system part and also after the product library and current library
entries. A library specified as part of the library list cannot be deleted or renamed
once the system is fully operational.

A change to this value takes effect when the next job starts.

Type Length Shipped Value

Character 250 ’QGPL QTEMP’

Its value is a 250-character list, enclosed within apostrophes, of library names with
each name up to 10 characters in length. When changing this system value using
the CHGSYSVAL command, each name must be separated by a blank.
Apostrophes are necessary only when more than one library name is specified. For
example, ’USERLIB1 USERLIB2’.

QUTCOFFSET System Value

QUTCOFFSET is the system value indicating difference in hours and minutes
between Universal Time Coordinated (UTC), also known as Greenwich mean time
(GMT), and the current system (local) time.

This is the number of hours and minutes you need to subtract from local time to
obtain the UTC. This value is 5 characters long. The first character is a plus (+) or
minus (−) sign. The next 2 characters specify hours ranging from 00 through 24.
The last 2 characters specify minutes ranging from 00 through 59 (if it is less than
24 hours).

QUTCOFFSET is used by the system when processing alerts that are sent to other
systems in a network. Systems in a network may be set up to signal alerts to one
main system within the network when a problem arises. If these systems span
across time zones, the time sent with the alert will be different than the time of the
main system. To correct this, the QUTCOFFSET value is sent in the alert.

The WRKALR command does not display the offset, but customer applications that
parse alerts can make use of the UTC offset, since it has the Systems Network
Architecture (SNA) format. This offset can also be used by other customer
applications if they need to know how the time on the system differs from another
system across a time zone.

Suppose you have multiple systems in a network: the main system in Richmond,
Indiana (Eastern time zone); one in Rochester, Minnesota (Central); and one in Los
Angeles, California (Pacific). QUTCOFFSET would be set to ’-0500’ on the
Richmond system, ’-0600’ on the Rochester system, and ’-0800’ on the Los Angeles
system. Each system could use its local time for the system time. You could use
QUTCOFFSET to calculate a common time among all the systems.

Chapter 2. System Values 75

 A change to this value takes effect immediately.

Type Length Shipped Value

Character 5 +0000

QYEAR System Value

QYEAR is the system value that specifies the last two digits for the year. Its value
can range from ’0’ through ’99’. When you specify the date in CL commands, you
can specify only 2 digits for the year in the date format.

The system assigns the first 2 digits for the year based on the current setting for
the QCENTURY system value. If the calculated year falls outside the range
supported by the system (1928-2053), the QCENTURY system value is changed so
the calculated year is within the supported range.

A change to this system value takes effect immediately. Changing this value also
affects the system value QDATE.

Type Length Shipped Value

Character 2 No shipped value

76 OS/400 Work Management V4R4

Chapter 3. Network Attributes —Introduction
A network attribute is control information about the communications environment.
Network attributes contain specifications that can be used for networking and
communications. Network attributes are not objects and cannot be passed as
parameter values like CL variables.

The system is shipped with certain network attributes. Most of these are important
only if your system is part of a communications network. The system name appears
on many OS/400 displays, including the sign-on display.

Shipped Network Attributes

Table 11. Network Attributes Shipped with the System
Description Shipped Value For More Information
System name SYSNAME(based on machine See the APPC Programming book.
serial number)
Local network ID to be assigned LCLNETID(APPN) See the APPC Programming book.
to the system.
Local control point name for the LCLCPNAME(based on machine See the APPC Programming book.
system serial number)
Default local location name for LCLLOCNAME(based on machine See the APPC Programming book.
the system serial number)
Default mode name for the DFTMODE(BLANK) See the APPC Programming book.
system
APPN node type NODETYPE(*ENDNODE) See the APPC Programming book.
Data compression DTACPR(*NONE) See the APPC Programming book.
Intermediate data compression DTACPRINM(*NONE) See the APPC Programming book.
Maximum number of intermediate MAXINTSSN(200) See the APPC Programming book.
sessions
APPN route addition resistance RAR(128) See the APPC Programming book.
APPN network node servers NETSERVER(*NONE) See the APPC Programming book.
Alert status ALRSTS(*OFF) See the Alerts Support book.
Specifies which alerts are logged ALRLOGSTS(*NONE) See the Alerts Support book.
Specifies if the system is an alert ALRPRIFP(*NO) See the Alerts Support book.
primary focal point
Specifies if the system is an alert ALRDFTFP(*NO) See the Alerts Support book.
default focal point
Identifies the system that ALRBCKFP(*NONE) See the Alerts Support book.
provides backup alert focal point
services
Identifies the system that you ALRRQSFP(*NONE) See the Alerts Support book.
requested as the alert focal point
Name of the controller through ALRCTLD(*NONE) See the Alerts Support book.
which alerts are sent on the
SSCP-PU session
Number of alerts that are ALRHLDCNT(0) See the Alerts Support book.
accumulated before they are sent

© Copyright IBM Corp. 1997, 1999 77

 Table 11. Network Attributes Shipped with the System (continued)
Description Shipped Value For More Information
The filter object used by the alert ALRFTR(*NONE) See the Alerts Support book.
manager when processing alerts
Default message queue used in MSGQ(QSYS/QSYSOPR) See the SNA Distribution Services book.
object distribution
Default output queue used in OUTQ(QGPL/QPRINT) See the SNA Distribution Services book.
object distribution
Default action taken for job JOBACN(*FILE) See the SNA Distribution Services book.
streams received by the system
(used in object distribution)
Maximum number of systems a MAXHOP(16) See the SNA Distribution Services book.
distribution can pass through on
its path to a destination on a
SNADS network
The action to be taken for DDM DDMACC(*OBJAUT) See the Distributed Data Management book.
requests from other systems
Specifies how PC Support PCSACC(*OBJAUT) See the Client Access/400 for DOS and OS/2
requests are handled Technical Reference book.
ISDN network type DFTNETTYPE(blank) See the APPC Programming book.
ISDN connection list DFTCNNLST(QDCCNNLANY) See the APPC Programming book.
Allow AnyNet support ALWANYNET(*NO) See the “Retrieve Network Attributes
(QWCRNETA) API” in theSystem API
Reference..
Network server domain NWSDOMAIN(*SYSNAME) See the OS/2 Warp Server for AS/400
Administration book.
Allow virtual APPN support ALWVRTAPN See the OS/2 Warp Server for AS/400
Administration book.
Allow HPR Tower support ALWHPRTWR See the Communications Configuration book.
APPC autocreate device limit VRTAUTODEV See the Communications Configuration book.
HPR path switch timers HPRPTHTMR See the Communications Configuration book.
| Allow add to cluster ALWADDCLU(*NONE) See Securing your clusters under Planning in
| the Clustering topic online in the AS/400
| Information Center.
| Modem country identifier MDMCNTRYID(blank) See the ISDN on the AS/400 topic online in
| the AS/400 Information Center.

Displaying Network Attributes

To display a network attribute, use the Display Network Attributes (DSPNETA)
command.

Changing Network Attributes

To change a network attribute, use the Change Network Attribute (CHGNETA)
command.

78 OS/400 Work Management V4R4

Retrieving Network Attributes
To retrieve a network attribute, use the Retrieve Network Attributes (RTVNETA)
command. The Retrieve Network Attributes (QWCRNETA) API is also available. For
details, see the RTVNETA command description in the CL Reference (Abridged) or
“Retrieve Network Attributes (QWCRNETA) API” in the System API Reference .

Chapter 3. Network Attributes —Introduction 79

80 OS/400 Work Management V4R4
Chapter 4. Subsystems
Subsystem Introduction
A subsystem is a single, predefined operating environment through which the
system coordinates the work flow and resource use. The system can contain
several subsystems, all operating independently of each other. Subsystems manage
resources. The run-time characteristics of a subsystem are defined in an object
called a subsystem description.

Each subsystem can run unique operations. For instance, you can set up one
subsystem to handle only interactive jobs, while another subsystem handles only
batch jobs. Subsystems can also be designed to handle many types of work. The
system allows you to decide the number of subsystems and what types of work
each subsystem will handle.

The system relies on subsystem descriptions when starting subsystems. Therefore,

if you want to change the amount of work (number of jobs) coming from a job
queue, for example, you only need to change the job queue entry in the subsystem
description.

See “Subsystem Descriptions” for details on subsystem descriptions.

Restoring Customization Information During an Installation

During an installation of the OS/400 Operating System or upgrade to a new release
of the operating system, the Keep Customization restores customized information
from specific IBM-supplied system job descriptions or subsystem descriptions. The
customization information for JOBD and SBSD objects that exist on your system
prior to the installation are merged with the information from the JOBD and SBSD
from the installation.

The IBM-supplied subsystem descriptions are provided as examples and as

backups for user-created subsystem descriptions. Therefore, we do not recommend
modifying the subsystem descriptions in libraries QSYS and QGPL. You should
make copies of the subsystem descriptions from these libraries and make changes
to the copies.

For information about the SBSDs and the JOBDs from which you can restore
customized information, see Table 133 on page 496 and Table 134 on page 496.

Subsystem Descriptions
A subsystem description is a system object that contains information defining the
characteristics of an operating environment controlled by the system. The
system-recognized identifier for the object type is *SBSD.

A subsystem description defines how, where, and how much work enters a
subsystem, and which resources the subsystem uses to perform the work. An active
subsystem takes on the simple name of the subsystem description.

Like a set of detailed blueprints, each subsystem description is unique, containing

the specific characteristics describing the subsystem. The description includes

© Copyright IBM Corp. 1997, 1999 81

 where work can enter the subsystem, how much work the subsystem can handle,
how much main storage (memory) will be used, and how quickly jobs in the
subsystem can run. You can use a subsystem description supplied with your system
(with or without making changes to it), or you can create your own.

A subsystem description consists of three parts:

v Subsystem attributes (overall subsystem characteristics)
v Work entries (sources of work)
v Routing entries

Double-Byte Character Set Considerations

IBM-supplied subsystem descriptions are changed for controlling double-byte
character set devices. You do not need to change any subsystem descriptions.

Subsystem Description–Overview
Table 12. What’s in the Subsystem Description?
Description See Also
Subsystem Attributes Overall system characteristics: “Storage Pools” on page 87 or
“Changing the Sign-On Display File”
v Operational attributes such as the
on page 85
number of jobs that can be active in the
subsystem at the same time, and the
sign-on display
v Storage pools used by the subsystem
v Authority to the subsystem description
v Text description of the subsystem
description
Work Entries The work entry in a subsystem description “Work Entries” on page 95
specifies the source from which jobs can
be accepted for processing in the
subsystem. In other words, the location
where work can enter the subsystem.
Autostart Job Entry Identifies the autostart jobs to start as soon “Chapter 9. Autostart Jobs” on
as the subsystem starts. page 211
Communications Job Entry Identifies the communications device that “Chapter 10. Communications Jobs”
another system uses to submit work. on page 213
Job Queue Entry Identifies the job queue from which to take “Chapter 8. Batch Jobs” on page 195
work and determine how much work to
accept.
Prestart Job Entry Reduces the amount of time required to “Chapter 11. Prestart Jobs” on
perform a program start request received page 217
through a communications entry. A prestart
job starts before a program start request is
sent by another system, thus decreasing
the initial processing time for a
communications job.
Workstation Entry Identifies the workstation from which to “Chapter 6. Interactive Jobs” on
take work. page 157
Routing Entries Identify the main storage subsystem pool “Routing Entries” on page 100
to use, the controlling program to run, and
run-time information.

82 OS/400 Work Management V4R4

Creating a Subsystem Description
You can create a subsystem description in two ways. You can copy an existing
subsystem description and change it, or you can create an entirely new description.
The following are two approaches you can use:
v Copying an existing subsystem description
1. Create a duplicate object, CRTDUPOBJ, of an existing subsystem
description. (You can also use the WRKOBJ or WRKOBJPDM commands.)
2. Change the copy of the subsystem description.

See Appendix C. IBM-Supplied Object Contents, for examples.

v Creating an entirely new subsystem description
1. Create a subsystem description (CRTSBSD).
2. Create a job description (CRTJOBD).
3. Add work entries to the subsystem description.
a. ADDWSE (Add workstation entry)
b. ADDJOBQE (Add job queue entry)
c. ADDCMNE (Add communications entry)
d. ADDAJE (Add autostart job entry)
e. ADDPJE (Add prestart job entry)
4. Create a class (CRTCLS).
5. Add routing entries to the subsystem description (ADDRTGE).

Starting a Subsystem
To start a subsystem, use the Start Subsystem (STRSBS) command or the Work
with Subsystem Description (WRKSBSD) command. To use the STRSBS
command, specify the following:
STRSBS SBSD (SBSD=library/subsystem
description name)

For example
STRSBS MYLIB/MYSTORE

How a Subsystem Starts

When a subsystem starts, the system allocates several items and starts autostart
and prestart jobs before it is ready for work.
1. After the Start Subsystem (STRSBS) command is issued, the system allocates
the following items, finding the information in the subsystem description:
v Pools of main storage
v Display stations
v Communications devices
v Job queues
2. Next, the autostart jobs and prestart jobs are started and the subsystem is
ready for work. Figure 3 shows what occurs when a subsystem starts.

Chapter 4. Subsystems 83
 1. Subsystem Starts Start Subsystem(STRSBS) command
Subsystem Description
2. Storage pools are allocated Pool Ids
3. Display Stations are allocated (sign-on Workstations Entries
displays are up).
4. Communications devices are allocated. Communications Entries
5. Job Queues are allocated. Job Queue Entries
6. Prestart jobs are started. Prestart Job Entries
7. Autostart jobs are started. Autostart Job Entries
8. Work environment is ready.

Figure 3. How A Subsystem Starts

Subsystem Monitor Job

The subsystem monitor job provides control over an active subsystem. It provides
functions such as initiating, controlling, and ending jobs. Several subsystem monitor
jobs may run on a system at any given time.

Subsystem monitor jobs are identified by type SBS on the Work with Active Jobs
display. You can see this by using the Work with Active Jobs (WRKACTJOB)
| command.

| Note: IBM supplies two complete controlling subsystem configurations: QBASE

| (the default controlling subsystem), and QCTL. Only one controlling
| subsystem can be active on the system at one time. The Controlling
| Subsystem Description (QCTLSBSD) system value determines the
| controlling subsystem.

| See also:
v “System Values—Details” on page 16
v “QSYSWRK Subsystem Monitor” on page 500

Ending a Subsystem
To end a subsystem:
1. Use the End Subsystem (ENDSBS) command
ENDSBS SBS OPTION (SBS=the active subsystem
name)

For example
ENDSBS MYSTORE *IMMED
2. Specify, using an option, when you want the subsystem to end.
*IMMED
End the subsystem immediately. Use this option if there are no users on
the system and no batch jobs running.
*CNTRLD
Allow active jobs to end themselves (if they are checking to see if the

84 OS/400 Work Management V4R4

 job is being ended). Use this option when users or batch jobs are
running in the subsystems to ensure the jobs finish before the
subsystem ends.
3. Use the End Subsystem Option (ENDSBSOPT) command to improve the
performance for ending a subsystem. If you specify
ENDSBSOPT(*NOJOBLOG), the subsystem will end, but a joblog will not be
produced for every job that was in the subsystem.

Note: If a problem occurs in a job, but you specified *NOJOBLOG, problem

diagnosis may be difficult or impossible because the problem is not
recorded in the joblog.

If you specify ENDSBSOPT(*CHGPTY *CHGTSL), the run priority and timeslice

will change for all jobs that end in this subsystem. The jobs will compete less
aggressively for processor cycles and will end with less of an impact on jobs
that are still running in other subsystems.

You can specify all three options (*NOJOBLOG, *CHGPTY, and *CHGTSL) on
the ENDSBSOPT command. For example:
ENDSBSOPT(*NOJOBLOG *CHGPTY *CHGTSL)

Note: If you specify *ALL for the subsystem name and have any jobs running
under QSYSWRK, you should use *CNTRLD to prevent a subsystem from
ending abnormally.

Deleting a Subsystem Description

To delete a subsystem description, use the Delete Subsystem Description
(DLTSBSD) command. To use the DLTSBSD command, the subsystem cannot be
active.

Active and Inactive Subsystems

An active subsystem is one that has been started, for example, with the Start
Subsystem (STRSBS) command. An inactive subsystem is one that has been
ended, for example, with the End Subsystem (ENDSBS) command or has not been
started. You cannot remove pools from an active subsystem.

Changing the Sign-On Display File

To change the format of the Sign-on display:
1. Create a changed sign-on display file.
A hidden field in the display file named UBUFFER can be changed to manage
smaller fields. UBUFFER is 128 bytes long and is stated as the last field in the
display file. This field can be changed to function as an input/output buffer so
the data specified in this field of the display will be available to application
programs when the interactive job is started.
You can change the UBUFFER field to contain as many smaller fields as you
need if the following requirements are met:
v The new fields must follow all other fields in the display file. The location of
the fields on the display does not matter as long as the order in which they
are put in the data description specifications (DDS) meets this requirement.

Chapter 4. Subsystems 85
 v The length must total 128. If the length of the fields is more than 128, some
of the data will not be passed.
v All fields must be input/output fields (type B in DDS source) or hidden fields
(type H in DDS source).

For additional information about the sign-on information from the UBUFFER
field, see “Retrieving the Sign-On Information in an Application Program” on
page 111.
Notes:
a. The order in which the fields in the sign-on display file are declared must not
be changed. The position in which they are displayed on the display can be
changed.
b. Do not change the total size of the input or output buffers. Serious problems
can occur if the order or size of the buffers are changed.
c. Do not use the data descriptions specifications (DDS) help function in the
sign-on display file.
2. Change a subsystem description to use the changed display file instead of the
system default of QSYS/QDSIGNON.
You can change the subsystem descriptions for subsystems that you want to
use the new display.
To change the subsystem description:
a. Use the Change Subsystem Description (CHGSBSD) command.
b. Specify the new display file on the SGNDSPF parameter
c. Use a test version of a subsystem to verify that the display is valid before
attempting to change the controlling subsystem.
3. Test the change.
4. Change other subsystem descriptions.
Notes:
1. The buffer length for the display file must be 318. If it is less than 318, the
subsystem uses the default sign-on display, QDSIGNON in library QSYS.
2. The copyright line cannot be deleted.

Display File Source

The source for the sign-on display file is shipped as a member (QDSIGNON) in the
QGPL/QDDSSRC physical file.

Sign-On Display File Tips

The following suggestions apply to display files for sign-on displays:
v When creating the sign-on display file with the Create Display File (CRTDSPF)
command, you must always specify 256 on the MAXDEV parameter.
v The MENUBAR and PULLDOWN keywords can not be specified in a sign-on
display file description.
v Help text must not be defined for sign-on displays.

86 OS/400 Work Management V4R4

Storage Pools
A pool is a division of main or auxiliary storage. On the AS/400 system, all main
storage can be divided into logical allocations called storage pools. The two types
of pools in a system are shared pools and private pools.

Shared Storage Pools

A shared storage pool is a pool in which multiple subsystems can run jobs. You
can specify 63 of the 64 shared storage pools that are defined on the system for
use when creating subsystem descriptions (the machine pool is reserved for system
use).

Shared pools are either special or general; the machine pool and base pool are
considered special shared pools, all other shared pools are considered general.

Special Shared Pools (*MACHINE and *BASE)

*MACHINE: *MACHINE is the machine storage pool that is used for highly shared
machine and OS/400 licensed programs. The machine pool provides storage for
jobs the system must run that do not require your attention. The size for this
storage pool is specified in the system value QMCHPOOL. No user jobs run in this
storage pool. On the Work with System Status display (WRKSYSSTS), the machine
storage pool appears as system pool identifier 1.

See also:
v “Determining Initial Machine Pool Size” on page 242
v “Minimum Machine Storage Size” on page 243
v “Setting Machine Pool Size” on page 244

*BASE: *BASE is the base storage pool that contains all unassigned main storage
on the system; that is, all storage that is not required by the machine storage pool
or by another pool. The base pool contains storage that can be shared by many
subsystems. The system value QBASPOOL specifies the minimum size of the base
storage pool. The activity level for this storage pool is specified in the system value
QBASACTLVL. The base storage pool is used for batch work and miscellaneous
system functions. (On the Work with System Status display (WRKSYSSTS), the
base storage pool appears as system pool identifier 2.)

General Shared Pools

General shared pools are pools of main storage that multiple subsystems can use
at the same time.
v *INTERACT is the interactive storage pool used for interactive jobs.
v *SPOOL is the storage pool used for spool writers.
v *SHRPOOL1 through *SHRPOOL60 are storage pools that you can use for your
own use.

Private Storage Pools

A private storage pool is a pool in which a single subsystem can run jobs. Private
pools are pools of main storage that cannot be shared by multiple subsystems. A
private pool, often simply referred to as a pool, contains a specified amount of

Chapter 4. Subsystems 87
 storage to be used by only one subsystem. You can have as many as 62 private
pools allocated for use in active subsystems. A private pool does not have to be
large enough to contain your programs. The machine manages the transfer of data
(and programs) into the private storage pool if necessary.

Storage Pools—Benefits
You can control how much work can be done in a subsystem by controlling the
number and size of the pools. The greater the size of the pools in a subsystem, the
more work can be done in the subsystem.

| Using shared storage pools allows the system to distribute jobs for interactive users
| across multiple subsystems, still allowing their jobs to run in the same storage pool.

Multiple Pools—Benefits
Multiple pools in a subsystem help you control the jobs’ competition for system
resources. The advantages of having multiple pools in a subsystem are that you
can separate the amount of work done and the response time for these jobs. For
example, during the day you may want interactive jobs running with good response
time. For better efficiency, you can make the interactive pool larger. At night you
may be running many batch jobs, so you make the batch pool larger.

Note: It is possible to divide the work too much, giving you more to tune and
manage on the system.

Changing the Size of a Storage Pool

One of the tasks you can perform when you do performance tuning is to change the
size and activity level of the storage pools.

Machine Pool
To change the size of the machine pool, use the CHGSYSVAL command or the
WRKSYSSTS command. You can use the following for machine pools:
CHGSYSVAL QMCHPOOL 'new-size-in-KB'

This corresponds to pool 1 on the WRKSYSSTS display.

Base Pool
To change the minimum size of the base pool, use the CHGSYSVAL command. You
can use the following for base pools:
CHGSYSVAL QBASPOOL 'new-minimum-size-in-KB'

This corresponds to pool 2 on the Work with System Status (WRKSYSSTS) display.

Note: The QBASPOOL system value only controls the minimum size of the base
pool. The base pool contains all storage not allocated to other pools.

Other Storage Pools

To change the size of a storage pool:
1. Determine what the new size will be

88 OS/400 Work Management V4R4

 2. Use the Work with System Status (WRKSYSSTS) command to change the size
of the pool

See “Using Dynamic Tuning Support to Determine the Minimum Storage Pool Size”
on page 259 for information on why and when you should consider adjusting pool
sizes.

Changing Size or Activity Level of Shared Pools

To change the size or activity level of shared pools, use the Change Shared
Storage Pool (CHGSHRPOOL) command. On the Work with System Status
(WRKSYSSTS) display, you cannot change the activity level of the *MACHINE pool
or the size of the *BASE pool.

Changes to shared pools take effect immediately if the shared pool is active and
sufficient storage is available.

You can use the CHGSBSD command to change the storage pool size and storage
pool activity level for subsystem descriptions (or use the WRKSYSSTS command
for active subsystems).

How Data Is Handled in Storage Pools

If data is already in main storage, it can be referred to independently of the storage
pool it is in. However, if needed data does not exist in any storage pool, it is
brought into the same storage pool for the job that referred to it (this is known as a
page fault). As data is transferred into a storage pool, other data is displaced and, if
changed, is automatically recorded in auxiliary storage (this is called paging). The
storage pool size should be large enough to keep data transfers (paging) at a
reasonable level as the rate affects performance.

For more information, see “Setting Up the System to Dynamically Adjust a Storage
Pool for an Object (Expert Cache)” on page 240.

Subsystem Monitor Storage Pools

Storage for the subsystem monitor system job comes from pool 1 of the subsystem,
but does not count toward an activity level.

The shipped default causes the storage for the subsystem monitor to come from the
base storage pool. If you want storage for the subsystem monitor to come from a
separate pool, specify the CRTSBSD or CHGSBSD command with a specific pool
size and activity level such as:
POOLS((1 300 2))

See “Subsystem Monitor Job” on page 84 for more information about the subsystem
monitor.

User-Defined Storage Pools

In addition to the machine storage pool and the base storage pool, you can create
user-defined storage pools. User-defined storage pools can be used by
IBM-supplied subsystems or user-defined subsystems.

Chapter 4. Subsystems 89
 Creating User-Defined Storage Pools
To create a user-defined storage pool, use the POOLS parameter on the Create
Subsystem Description (CRTSBSD) or Change Subsystem Description (CHGSBSD)
commands.

Pool Allocation
When you start a subsystem, the system attempts to allocate the user-defined
storage pools defined in the subsystem description of the started subsystem.

Command entered: │───Ê Subsystem description USERLIB/PAY

│
STRSBS SBSD(PAY) ────┘
┌──────────────────────────────────┐
┌──┤ POOLS((1 300 1) (3 *SHRPOOL2)) │
│ │ ─────────────────────────────── │
│ │ MAXJOBS(*NOMAX) │
│ │ ─────────────────────────────── │
│ │ AUT(*CHANGE) │
│ │ ─────────────────────────────── │
│ │ TEXT('Payroll subsystem') │
│ └──────────────────────────────────┘
Pools allocated:Í──────┘

Figure 4. How the System Allocates Pools

Table 13. Pool Allocation

Pool ID Specified in SBSD 1 3
Storage Requested 300K *SHRPOOL2
System Pool ID 4 3
Storage Allocated 300K
Activity Level 1
Pool Type Private Shared

If the system cannot allocate all the requested storage, it allocates as much storage
as is available and allocates all the other as storage becomes available. For
example, look again at Table 13. If 700KB is available, and if *SHRPOOL2 is
defined to 500KB, then 300KB is allocated to the first storage pool and 400KB is
allocated to the second storage pool.

The storage pools that you define decrease the size of the base storage pool. The
system does not allocate storage to a user pool if the amount of storage available
to the base storage pool would be less than the minimum base pool size specified
by the system value QBASPOOL.

Pool Numbering Schemes

Pools have two sets of numbering schemes: one is used within a subsystem and
one is system-wide. The subsystem uses a set of numbers that refer to the pools
they use. So, when you create or change a subsystem description, you can define
one or more pools and they are labeled 1, 2, 3, and so on. These are the
designations of the subsystem pools, and they do not correspond to the pool
numbers shown on the Work with System Status display.

90 OS/400 Work Management V4R4

 A different set of numbers is used to keep track of all pools. The Work with
Subsystems display relates the subsystem pool identifiers and the column headings
to the system pool identifiers.
| Work with Subsystems
| System: XXXXXXXX
| Type options, press Enter.
| 4=End subsystem 5=Display subsystem description
| 8=Work with subsystem jobs
|
| Total -----------Subsystem Pools------------
| Opt Subsystem Storage (M) 1 2 3 4 5 6 7 8 9 10
| _ NYSBS .48 2 4 5
| _ PASBS .97 2 6 4
| _ QINTER 11.71 2 3
|
|
|
|
|
|
|
|
| Bottom
| Parameters or command
| ===>
| F3=Exit F5=Refresh F11=Display system data F12=Cancel
| F14=Work with system status

Note that the subsystem names are listed alphabetically in this display. Also, the
numbers under the Total Storage column indicate the total storage allocated to the
subsystem private pools. Storage from shared pools is not included in this total.

| How to Number Pools illustrates how pools are numbered.

How to Number Pools

| Table 14. Pool Numbering
| Subsystems

| CRTSBSD QINTER CRTSBSD NYSBS CRTSBSD PASBS

|
| Pools (1 *BASE) Pools (1 *BASE) Pools (1 *BASE)
| (2 12000 25) (2 500 3) (2 1000 3)
| (3 *SHRPOOL2) (3 *SHRPOOL2)
|
| (System pools 2,3) (System pools 2,4,5) (System pools 2,4,6)
|

| After QINTER starts, the following pools are allocated:

Table 15. Pools Allocated After Subsystem QINTER Starts
System Pool Number Description QINTER
1 *Machine pool
2 *BASE pool 1
3 QINTER private pool 2

Chapter 4. Subsystems 91
 After NYSBS starts, the following pools are allocated:
Table 16. Pools Allocated After NYSBS Starts
System Pool
Number Description QINTER NYSBS
1 *MACHINE pool
2 *BASE pool 1 1
3 QINTER private pool 2
4 *SHRPOOL2 shared pool 3
5 NYSBS private pool 2

After PASBS starts, the following pools are allocated:

Table 17. Pools Allocated after PASBS Starts
System Pool
Number Description QINTER NYSBS PASBS
1 *Machine pool
2 *BASE pool 1 1 1
QINTER private
3 pool 2
*SHRPOOL2 shared
4 pool 3 3
5 NYSBS private pool 2
6 PASBS private pool 2

Activity Levels of Storage Pools

Note: Please note that the term ‘thread’ has replaced the term ‘job’ in many
situations. See Chapter 5 for information that describes threads and the
difference between the use of threads and jobs for system activity.

Storage pool activity levels allow for efficient use of system resource by allowing
more than one thread to be active at the same time.

The activity level of a storage pool is the number of threads that can be active at
same time in a storage pool. The system manages the control of this level. Threads
have an activity level when they are active in a storage pool. Often during
processing in a thread, a program waits for a system resource or a response from a
workstation user. During such waits, a thread gives up its use of the storage pool in
order that another thread that is ready to be processed can take its place.

When more threads are started than can run at the same time because of the
activity level controls, the excess threads have to wait to use the processing unit
(normally this wait is very short). The storage pool activity level lets you limit the
amount of main storage contention in the various storage pools in your subsystems.

For the storage pool activity level, the number of threads running (or active threads)
refers to the number of threads that have an activity level; that is, the threads are
actually running or they may be waiting for a disk I/O operation. In this sense,
active threads do not refer to threads that are waiting for input, for a message, for a

92 OS/400 Work Management V4R4

 device to be allocated, or for a file to be opened. Active threads do not refer to
threads that are ineligible (threads that are ready to run but the storage pool activity
level is at its maximum).

See Chapter 14. Performance Tuning relation to the storage pool activity level.

How Activity Levels Work

More than one thread can be active at the same time in a storage pool because the
processing for a thread can be briefly interrupted while needed data is retrieved
from auxiliary storage. During this delay, which is usually short, another thread can
run. Using the activity level, the machine can process a large number of threads in
a storage pool and, at the same time, hold the level of contention to the limit you
specify.

Maximum Activity Level

Once the maximum activity level for a storage pool has been reached, additional
threads needing the storage pool are automatically put in a queue to wait for
available main storage (placed in an ineligible state, that is shown on the Work with
Active Jobs Display). As soon as a thread gives up its use of the storage pool, the
threads in the queue become eligible to run by their priority. For example, if a
running thread is waiting for a response from a workstation, it gives up its activity
level and the activity level is no longer at its maximum.

Where Jobs Get Storage

The storage pool from which user jobs get their storage is always the same pool
that limits their activity level. System jobs (such as SCPF, QSYSARB, and QLUS)
get their storage from the base pool, but use the machine pool activity level.
Subsystem monitors get their storage from the first subsystem description pool but
not the activity level. This allows a subsystem monitor to always be able to run
regardless of the activity level setting.

Defining Storage Pools and Activity Levels

Defining storage pools and activity levels correctly is generally dependent on the
number of threads a subsystem must support at the same time and the
characteristics and use of the programs that perform functions in those threads.
See Chapter 14. Performance Tuning, for a more detailed description of how to set
appropriate activity levels.

Controlling Levels of System Activity

You can control how much activity is on the system by controlling how many jobs
can be active at the same time in a subsystem or by controlling the use of the
processing unit by jobs that have already been started.

Chapter 4. Subsystems 93
Table 18. Control Levels of System Activity
What can I use to
What can I control? control? How do I do it?
Number of active Subsystem Description Use the MAXJOBS parameter on the CRTSBSD and CHGSBSD
jobs commands to specify how many jobs can be active at the same time
in a subsystem. For an active subsystem, the sum of all jobs that
are active at the same time started through work entries in the
subsystem cannot exceed the MAXJOBS parameter value. This
excludes autostart jobs, which may temporarily cause the limit to be
exceeded when the subsystem is started.
Job Queue Entry Use the MAXACT parameter on the ADDJOBQE and CHGJOBQE
commands to specify how many batch jobs from a job queue can be
active at the same time in the subsystem. (A MAXACT of 1 for a job
queue forces jobs to be selected serially by job priority from a job
queue.) The MAXPTYn parameter is used to specify how many jobs
can be active for a specified job priority.
Workstation Entry If the WRKSTNTYPE parameter is specified, use the MAXACT
parameter on the ADDWSE and CHGWSE commands to specify
how many interactive jobs can be active at the same time in the
subsystem for that entry.
Communications Entry Use the MAXACT parameter on the ADDCMNE and CHGCMNE
commands to specify how many communications batch jobs can be
active at the same time for that entry.
Routing Entry Use the MAXACT parameter on the ADDRTGE and CHGRTGE
commands to specify how many jobs can be active at the same time
using a given routing entry.
Prestart job entry Use the MAXJOBS parameter on the ADDPJE and CHGPJE
commands to specify how many prestart jobs can be active at the
same time for that entry.
System The system value QMAXACTLVL (see Chapter 2. System Values) is
used to specify how many threads can share main storage and
processor resources at the same time. All active jobs (including
system jobs) in all storage pools are controlled by QMAXACTLVL.
Use of processing Base storage pool The system value QBASACTLVL (see Chapter 2. System Values) is
unit and main used to specify how many threads can share the base storage pool
storage at the same time and to limit main storage contention.
Shared pools Use the Work with Shared Pools (WRKSHRPOOL) command to
specify the activity level for shared pools.
Private storage pools Use the POOLS parameter on the CRTSBSD and CHGSBSD
commands to specify the activity level for user-defined main storage
pools.

What Is Considered an Active Job?

For the MAXJOBS and MAXACT parameters, active jobs refer to jobs that have
started running but have not completed running. Active jobs do not include jobs that
are on a job queue waiting to be started, or jobs that have completed processing
but are waiting for a spooled file to be printed.

Activity Control Examples

The following examples show the relationship of some of the activity controls. The
system activity level is assumed to be 100. Also, the jobs are assumed to be
single-threaded.

94 OS/400 Work Management V4R4

 Base Storage Pool Example
Two subsystems, SBSA and SBSB, use the base storage pool to run jobs. SBSA
currently has two jobs running in this storage pool and SBSB has one. A job queue
entry in the subsystem description for SBSB specifies that any number of jobs can
be started. The activity level of the base storage pool is 3. Therefore, only three
jobs in the base storage pool can compete for the processing unit at a time.
However, all the jobs are started.

Four Jobs in A Subsystem Example

One autostart job, two workstation jobs, and one batch job–four jobs in all–are in
subsystem SBSC. The MAXACT for SBSC is specified as 4. No matter what is
specified for the MAXACT of the work entries, no other jobs can be started until at
least one job completes running.

Batch Subsystem MAXACT(1) Example

Subsystem SBSE is a batch subsystem for which 1 is specified for MAXACT.
Although the job queue entry does not specify MAXACT, the limit is one job
because 1 is specified for MAXACT for the subsystem. Therefore, jobs are
processed in job priority one at a time off the job queue.

Work Entries
Work entries identify the sources where jobs can enter a subsystem. Specific types
of work entries are used for different types of jobs. For example, an autostart job
uses an autostart job entry.

Autostart Job Entry

An autostart job is automatically started each time the subsystem is started. You
can specify the following items in an autostart job entry. Parameter names are given
in parentheses.
v Job name (JOB)
v Job description name (JOBD)

To specify which program or command to run, use the request data (RQSDTA)
parameter on the job description. See also:
v “Adding Autostart Job Entries”
v “Changing Autostart Job Entries” on page 96
v “Removing Autostart Job Entries” on page 96

Adding Autostart Job Entries

To add an autostart job entry to a subsystem description, use the Add Autostart Job
Entry (ADDAJE) command. The following is an example of adding an autostart job
entry:
ADDAJE SBSD(USERLIB/ABC) JOB(START)
JOBD(USERLIB/STARTJD)

Note: For changes to take effect, the subsystem must be ended and started again.

Chapter 4. Subsystems 95
Changing Autostart Job Entries
To specify a different job description for a previously defined autostart job entry, use
the Change Autostart Job Entry (CHGAJE) command. The following is an example
of changing an autostart job entry:
CHGAJE SBSD(USERLIB/ABC) JOB(START)
JOBD(USERLIB/NEWJD)

Note: For changes to take effect, the subsystem must be ended and started again.

Removing Autostart Job Entries

To remove an autostart job entry from a subsystem description, use the Remove
Autostart Job Entry (RMVAJE) command. The following is an example of removing
an autostart job entry:
RMVAJE SBSD(USERLIB/ABC) JOB(START)

Note: For changes to take effect, the subsystem must be ended and started again.

Workstation Entry
The job is started when a workstation user signs on or when a workstation user
transfers an interactive job from another subsystem. You can specify the following
items in a workstation entry. Parameter names are given in parentheses.
v Workstation name or type (WRKSTN or WRKSTNTYPE)
v Job description name (JOBD) or job description name in the user profile
v Maximum number of jobs that can be active at the same time through the entry
(MAXACT)
v When the workstations are to be allocated, either when the subsystem is started
or when an interactive job enters the subsystem through the Transfer Job
(TFRJOB) command (AT)

Adding Workstation Entries

To add a workstation entry to a subsystem description, use the Add Work Station
Entry (ADDWSE) command. The following is an example of adding a workstation
entry:
ADDWSE SBSD(USERLIB/ABC) WRKSTN(DSP12)
JOBD(USERLIB/WSE)

Changing Workstation Entries

To specify a different job description for a previously defined workstation entry, use
the Change Work Station Entry (CHGWSE) command. The following is an example
of changing a workstation entry:
CHGWSE SBSD(USERLIB/ABC) WRKSTN(DSP12)
JOBD(USERLIB/NEWJD)

Removing Workstation Entries

To remove a workstation entry from a subsystem description, use the Remove Work
Station Entry (RMVWSE) command. The following is an example of removing a
workstation entry:

96 OS/400 Work Management V4R4

RMVWSE SBSD(USERLIB/ABC) WRKSTN(DSP12)

Generic Workstation Names and Types

You can use generic names for workstation name entries on the work station entry
commands, such as Add Work Station Entry (ADDWSE), Change Work Station
Entry (CHGWSE), and Remove Work Station Entry (RMVWSE). In addition, special
values are allowed for workstation-type entries. These entries allow:
v More control over the allocation of devices to a specific subsystem
v Easier addition of workstations to an already active subsystem
v All of the displays on the system to come up under one subsystem without
adding all of the possible device types to the subsystem

Generic Workstation Names and Types Support

The support for generic workstation names and types on the workstation entry
commands include the following:
v Generic capability for the workstation name function
WRKSTN(anyname)

WRKSTN(LOCAL10)

WRKSTN(LOCAL*)
v Special values for the workstation type function
|- type number---|
WRKSTNTYPE ( | | )
|- *ALL ---------|
|- *NONASCII-----|
|- *ASCII--------|

Workstation Entry Processing

The order in which workstation entries are processed (allocated) for an individual
subsystem is as follows:
1. Specific workstation name
2. Generic workstation name
3. Special workstation type (*CONS)
4. Specific workstation type (5250, 3279, ...)
5. Special workstation type (*ASCII and *NONASCII)
6. Special workstation type (*ALL)

When a subsystem contains generic entries which match the device name, the
more specific generic name does not have priority.
SBSD1 SBSD2
WRKSTN(DSP*) WRKSTN(D*)

See also “Workstation Device Allocation” on page 103.

Generic Function Uses

The following are examples of how the generic function may be used:
v Local and remote workstations may be divided into separate subsystems by
giving them standard names, such as LOCAL10, LOCAL20, RMT10, RMT20, and

Chapter 4. Subsystems 97
 so on. Generic workstation entries, such as LOCAL* and RMT*, may then be
added to different subsystem descriptions to separate the local and remote
workstations.
v All workstations meeting the generic qualification are dynamically allocated by the
subsystem when they are created.
v The *ALL workstation type allows the subsystem to allocate all of the valid
workstations on the system.

Job Queue Entry

Jobs to be processed are taken from the specified job queue. You can specify the
following items in a job queue entry. Parameter names are given in parentheses.
v Job queue name (JOBQ)
v Maximum number of jobs that can be active at the same time from the job queue
(MAXACT)
v Order in which the subsystem selects job queues from which jobs can be started
(SEQNBR)
v Maximum number of jobs that can be active at the same time for a specified job
queue priority (MAXPTYn)

Adding Job Queue Entries

To add a job queue entry to a subsystem description, use the Add Job Queue Entry
(ADDJOBQE) command. The following is an example of adding a job queue entry:
ADDJOBQE SBSD(USERLIB/ABC)
JOBQ(USERLIB/NAME)
MAXACT(*NOMAX)

Changing Job Queue Entries

To specify a different job queue entry for a previously defined job queue entry, use
the Change Job Queue Entry (CHGJOBQE) command. The following is an example
of changing a job queue entry:
CHGJOBQE SBSD(USERLIB/ABC)
JOBQ(USERLIB/NAME)
MAXACT(12)

Removing Job Queue Entries

To remove a job queue entry from a subsystem description, use the Remove Job
Queue Entry (RMVJOBQE) command. The following is an example of removing a
workstation entry:
RMVJOBQE SBSD(USERLIB/ABC)
JOBQ(USERLIB/NAME)

Adding Communications Entries

To add a communications entry in a subsystem description, use the Add
Communications Entry (ADDCMNE) command. The following is an example of
adding a communications entry:
ADDCMNE SBSD(COMMLIB/COMMSBS) DEV(*APPC)
MAXACT(*NOMAX)

98 OS/400 Work Management V4R4

 Note: You must specify either the DEV parameter or the RMTLOCNAME
parameter, but not both.

Changing Communications Entries

To change a communications entry in a subsystem description, use the Change
Communications Entry (CHGCMNE) command. The following is an example of
changing a communications entry:
CHGCMNE SBSD(COMMLIB/COMMSBS) DEV(*APPC)
MAXACT(12)

Removing Communications Entries

To remove a communications entry from a subsystem description, use the Remove
Communications Entry (RMVCMNE) command. The following is an example of
removing a communications entry:
RMVCMNE SBSD(COMMLIB/COMMSBS) RMTLOCNAME(NYC)

The following example removes only the entry with DEV(*ALL). It does not remove
all the communications entries in the subsystem. For example,
RMVCMNE SBSD(COMMLIB/COMMSBS) DEV(*ALL)

Prestart Job Entry

A prestart job entry does not affect the device allocation or program start request
assignment. The prestart jobs are started before any other types of jobs in a
subsystem. Prestart jobs are started on a local system before a remote system
sends a program start request. You can specify the following items in a prestart job
entry. Parameter names are given in parentheses.
v Qualified name of the subsystem description to which the prestart job is added
(SBSD)
v Qualified name of the program that the prestart job runs (PGM)
v User profile (USER)
v Simple name of the prestart job (JOB)
v Qualified name of the job description used for the prestart job (JOBD)
v Whether the prestart jobs start at subsystem startup (STRJOBS)
v Initial number of prestart jobs (INLJOBS)
v When additional prestart jobs should start (THRESHOLD)
v Additional number of prestart jobs that should start when the number of prestart
jobs drops below the THRESHOLD parameter (ADLJOBS)
v Maximum number of prestart jobs that can be active at the same time
(MAXJOBS)
v Maximum number of program start requests that can be handled by each prestart
job in the pool before the job is ended (MAXUSE)
v Whether program start requests wait for a prestart job to become available or are
rejected if a prestart job is not immediately available when the program start
request is received (WAIT)
v Subsystem pool identifier (POOLID)
v Qualified names of the classes and how many prestart jobs run using each class
(CLS)

Chapter 4. Subsystems 99
 See also “Chapter 11. Prestart Jobs” on page 217.

Adding Prestart Job Entries

To add a prestart job entry to a subsystem description, use the Add Prestart Job
Entry (ADDPJE) command. The following is an example of adding a prestart job
entry:
ADDPJE SBSD(USERLIB/ABC) PGM(START)
JOBD(USERLIB/STARTPJ)

Changing a Prestart Job Entry

To change a prestart job entry in a subsystem description, use the Change Prestart
Job Entry (CHGPJE) command. The following is an example of changing a prestart
job entry:
CHGPJE SBSD(USERLIB/ABC) PGM(START)
JOBD(USERLIB/NEWPJ)

Removing a Prestart Job Entry

| To remove a prestart job entry from a subsystem description, use the Remove
| Prestart Job Entry (RMVPJE) command. The following is an example of removing a
| prestart job entry:
| RMVPJE SBSD(USERLIB/ABC) PGM(START)
|
Routing Entries
The routing entry identifies the main storage subsystem pool to use, the controlling
program to run (typically the system-supplied program QCMD), and additional
run-time information (stored in the class object). Routing entries are stored in the
subsystem description.

Adding Routing Entries

To add a routing entry to the subsystem description, use the Add Routing Entry
(ADDRTGE) command. The following is an example of adding a routing entry:
ADDRTGE SBSD(USERLIB/ABC) SEQNBR(1)
PGM(NAME) CMPVAL(*ANY)

Changing Routing Entries

To specify a different routing entry for a previously defined routing entry, use the
Change Routing Entry (CHGRTGE) command. The following is an example of
changing a routing entry:
CHGRTGE SBSD(USERLIB/ABC) SEQNBR(1)
CMPVAL(ACCOUNTING)

Removing Routing Entries

To remove a routing entry from the subsystem description, use the Remove Routing
Entry (RMVRTGE) command. The following is an example of removing a routing
entry:
RMVRTGE SBSD(USERLIB/ABC) SEQNBR(1)

100 OS/400 Work Management V4R4

 Relationship of Routing Entry, Routing Data, and Routing Step
Routing entries in a subsystem description specify the program to be called to
control a routing step for a job running in the subsystem, which pool the job will
use, and from which class to get the run-time attributes. Routing data identifies a
routing entry for the job to use. Together, routing entries and routing data provide
information on starting a job in a subsystem.

See also “Job Starting and Routing” on page 128.

Routing Entry Values

A routing entry in a subsystem description specifies the program that is called to
control a routing step that runs in the subsystem. A routing entry contains values
that control which routing entry starts the routing step. It also contains values that
define the running environment for the routing step.

Routing Entry to Start Routing Step

The following values determine which routing entry starts the routing step
(parameter names are given in parentheses):
v A routing entry sequence number (SEQNBR)
v A routing data comparison value and starting position for the comparison
(CMPVAL)

Running Environment for the Routing Step

The following values define the running environment for the routing step (parameter
names are given in parentheses):
v The name of the program called (PGM) or *RTGDTA, which indicates that the
program name is to be taken from the routing data
v The name of the class used for the routing step (CLS)
v The maximum number of routing steps that can be active at the same time for
the entry (MAXACT)
v The identifier of the subsystem storage pool in which the job is to run (POOLID)

Note: For a prestart job, the class name and storage pool identifier are specified
on the prestart job entry.

Sequence Numbers and Comparison Values

The sequence number contained in a routing entry defines the order in which the
routing entries are scanned and can be used as the identifier of the routing entry.
The comparison value specifies data that is compared with routing data to
determine which routing entry to use. (The routing entry also specifies the starting
position for the comparison.) The routing data is compared with the comparison
value of each routing entry in sequence number order until a match is found.

When a routing entry is found with a comparison value that matches the routing
data, a routing step is started and the program specified in the routing entry is
called. The run-time attributes in the class associated with the routing entry are
used for the routing step, and the routing step runs in the storage pool specified in
the routing entry.

Chapter 4. Subsystems 101

 For communications considerations for jobs started by program start requests, see
the ICF Programming book.

Assigning Sequence Numbers to Routing Entries

When you add a routing entry to a subsystem description, you assign a sequence
number to the entry. This sequence number tells the subsystem the order in which
routing entries are to be searched for a routing data match. For example, you have
a subsystem description containing the following five routing entries:

Sequence Comparison
Number Value
10 ’ABC’
20 ’AB’
30 ’A’
40 ’E’
50 ’D’

The routing entries are searched in sequence number order. If the routing data is
’A’, the search ends with routing entry 30. If the routing data is ’AB’, the search
ends with routing entry 20. If the routing data is ’ABC’, the search ends with routing
entry 10. Because routing data can be longer than the comparison value of the
routing entry, the comparison (which is done in left-to-right order) stops when it
reaches the end of the comparison value. Therefore, if the routing data is ’ABCD’,
the search ends with routing entry 10.

When you define routing entries, they must be ordered from the most specific to the
most general. The following example shows a correct and incorrect way to define
routing entries:

Correct Incorrect
Sequence Number Comparison Value Sequence Number Comparison Value
10 ’ABC’ 10 ’ABC’
20 ’AB’ 20 ’ABCD’
30 ’A’
40 ’E’
9999 *ANY

In the incorrect example, it is no longer possible to match routing entry 20 because

any routing data that matches the comparison value for routing entry 20 matches
the routing entry 10 first. When a routing entry is changed or added to a subsystem
description with a comparison value that causes this situation, the system sends a
diagnostic message identifying the situation.

When you add routing entries to a subsystem description, you should order them so
that the entries likely to be compared most often are first. This reduces the search
time.

You can specify a comparison value of *ANY on the highest numbered routing
entry. *ANY means that a match is forced regardless of the routing data. Only one
routing entry can contain the comparison value of *ANY, and it must be the last
(highest sequence number) entry in the subsystem description. See Appendix C.
IBM-Supplied Object Contents, for an example.

The program named in the routing entry is given control when the routing step for
the job is started. Parameters to control the run-time environment (priority, time

102 OS/400 Work Management V4R4

 slice, and so on) of the routing step for the job are taken from the class specified in
the routing entry. (See “Class Object” on page 134.)

Workstation Device Allocation

When the subsystem starts

When a subsystem is started, it attempts to allocate all workstation devices in its
subsystem description. The following situations may occur during the time the
subsystem starts:
v If the device is not varied on, the subsystem cannot allocate it. The system
arbiter (QSYSARB) and the QCMNARBxx jobs hold locks on all varied-off
devices.
v If the device is varied on and has not been allocated by any other subsystem,
the subsystem can allocate it and display the Sign-On display.
v If the device is varied on and has been allocated by another subsystem and is at
the Sign-On display (the Sign-On display was displayed before the second
subsystem was started), a second subsystem can allocate the device from the
first subsystem and display the Sign-On display.

More than one subsystem

If more than one subsystem tries to allocate the same workstation (as specified in
the workstation entries) and the workstation is varied off, the subsystem that gets
the workstation when it is varied on cannot be predicted. Similarly, if a workstation
entry specifies a workstation type instead of a workstation name, a subsystem may
get all, some, or none of the workstations of that type. To avoid such a situation,
you can set up the workstation entries for the subsystems so multiple subsystems
are not using the same workstations.

After a user has signed on

When a user signs on to a workstation, his job runs in the subsystem that had the
sign-on display shown on the workstation (the subsystem is identified in the
IBM-supplied sign-on display). The following situations may occur after the user has
signed on:
v If a second subsystem is started and it tries to allocate the workstation on which
the user signed on, the second subsystem cannot allocate it. The user’s job
continues to run in the first subsystem.
v If the user selects option 1 (Display sign-on for alternative job) on the System
Request menu or issues the Transfer to Secondary Job (TFRSECJOB)
command, the new job runs in the same subsystem as the original job.
v When the user signs off, the workstation remains allocated to the subsystem
used when the user signed on, unless the user transferred into the subsystem
using the Transfer Job (TFRJOB) command, and specified AT(*ENTER) for the
workstation entry for this workstation. A sign-on display is shown, and any
subsequent jobs from that workstation continue to run in that subsystem, (unless
another subsystem is started up that allocates the workstation while it is at the
sign-on display).
v If the user signs off and the subsystem in which his job was running is ended,
the device is deallocated. A second subsystem can then allocate the device and
display the Sign-On display.

Chapter 4. Subsystems 103

 Figure 5 shows the subsystem activity required before the Sign-On display can
appear.

Subsystem Activity for Sign-On Display

Subsystem QBASE Subsystem Description QSYS/QBASE

Work Station Entry

WRKSTNTYPE =
*ALL

MAXACT =
*NOMAX
DSP01
AT =
Sign-On Display *SIGNON

Information concerning
devices attached to the
Subsystem is started. system (one for each
device).
Work station entries are used
to identify which work station
device descriptions to allocate. Device Description DSP01

If the work station entry says

allocate AT = *SIGNON, the
sign-on display identified in TYPE = 5251
the subsystem description is
displayed.

RV3W003-0

Figure 5. Subsystem Activity Leading to a Sign-On Display

Workstation Allocation—Scenario
In this scenario, subsystem A and subsystem B have workstations DSP01 and
DSP02 in their subsystem descriptions (the workstation entries specify
AT(*SIGNON)).

Allocated
Device Name to:
DSP01 Subsystem A
DSP02 Subsystem A

Assume that both workstations are varied on when subsystem A is started.

Subsystem A allocates both workstations and shows the Sign-On display on both.
Even though subsystem A has the Sign-On display shown on the workstations, they
can be allocated by another subsystem or job; the workstation would then no longer
be available to subsystem A.

104 OS/400 Work Management V4R4

 Allocated
Device Name to:
DSP01 USER1
DSP02 Subsystem A

When a user (USER1) signs on to workstation DSP01, the device is allocated to

USER1’s job, which is running in subsystem A. Workstation DSP02 is still at the
Sign-On display. Thus it can be allocated by another subsystem or job. It is then no
longer available to subsystem A.

Allocated
Device Name to:
DSP01 USER1
DSP02 Subsystem B

Subsystem B is started. Because USER1 has signed on to workstation DSP01,

subsystem B cannot allocate the device. Subsystem B requests allocation of the
device when it becomes available. DSP02 is allocated to subsystem B because no
one had signed on to it in subsystem A. Any jobs started on DSP02 will run in
subsystem B.

Allocated
Device Name to:
DSP01 Subsystem A
DSP02 Subsystem B

USER1 signs off. Because the user job was running in subsystem A, that
subsystem displays the Sign-On display so that another user can sign on the
workstation and run in subsystem A. If subsystem A is ended, workstation DSP01 is
allocated by subsystem B (because it has an outstanding request to allocate the
device.)

The name of the subsystem that currently has a workstation allocated appears in
the upper right corner of the IBM-supplied Sign-On display.

Job Queue Allocation

Job queues are allocated by subsystems.

The primary difference between the interactive support on the AS/400 system and
the support for batch jobs is that the batch functions are processed as a result of
entries placed on a job queue.

A job queue entry in the subsystem description QSYS/QBASE specifies that jobs
can be started using the job queue QGPL/QBATCH. Jobs can be placed on a job
queue even if the subsystem has not been started. When the subsystem QBASE
(or QBATCH, if using QCTL as the controlling subsystem) is started, it processes
the jobs on the queue. A subsystem description can specify the maximum number
of jobs (batch or interactive) that can be processed at the same time. For the job
queue entry QBATCH in the subsystem QSYS/QBASE, only one batch job can be
processed at any one time. (You can use the Change Job Queue Entry
(CHGJOBQE) command to change this at any time.) The number of jobs that can
be active from any job queue is specified in the job queue entry.

Figure 6 on page 106 shows how the subsystem QBASE, which is started using the
IBM-supplied subsystem description QSYS/QBASE, operates for batch jobs.

Chapter 4. Subsystems 105

 See also “Job Queue Entry” on page 98.

Job queue QGPL/QBATCH allocated by subsystem QBASE.

Job Queue Subsystem Description

QBPL/QBATCH QSYS/QBASE
┌──────────────────────────┐
┌─────────┐ │ │
│ │ │ │
│ Í ─────┐ │ ┌──────────────────┐ │
│ │ │ │ │ │ │
└─────────┘ │ │ │ MAXJOBS=*NOMAX │ │
└───── │ └──────────────────┘ │
Subsystem │ ┌──────────────────┐ │
QBASE ─────────────Ê │ │ │
│ │ ├────┤
│ │ JOBQ=QGPL/QBATCH│ │
┌─────────┐ │ │ MAXACT=1 │ │ Note that only
│ │ │ └──────────────────┘ │ one job from the
│ │ │ Job Queue Entry │ job queue can be
└─────────┘ │ │ active at once.
└──────────────────────────┘

Figure 6. How the Job Queue Is Identified to the QBASE Subsystem

Relationship between Job Queues and Subsystems

Note that not all jobs on a job queue are necessarily available for processing when
the subsystem is started; jobs can be held on a queue until the system operator
releases them. If the subsystem is ended before all the jobs are processed, the jobs
remain on the queue until the subsystem is started again or until another subsystem
allocates the same job queue. More than one subsystem description can refer to
the same job queue, but only one active subsystem at a time can use the job
queue as a source of batch jobs. Therefore, if a subsystem ends and jobs are still
on the job queue, another subsystem referring to that job queue can be started to
process the jobs. If another subsystem is already started and is waiting for the
same job queue, the subsystem automatically allocates the job queue when it
becomes available.

Placing a Job on the Job Queue

Jobs can be placed on the job queue QGPL/QBATCH (or any job queue) in more
than one way:
v To submit a job to a user-specified job queue, use the SBMJOB command. The
default of the command is to submit the job to run with the current user’s user
profile and some of the same job attributes. All other defaults are taken from a
named job description or the currently active job (the job issuing the SBMJOB
command). If no job description is specified, the job description specified in your
user profile is used.
v To place active jobs on the queue, specify the TFRJOB or the TFRBCHJOB
command in the active job.

106 OS/400 Work Management V4R4

 v To submit a job (from diskette to the job queue QGPL/QBATCH, for example),
use the SBMDBJOB or SBMDKTJOB command. For each job in the input
stream, an entry is placed on a job queue. Jobs are delimited by BCHJOB and
ENDBCHJOB commands.
v To read input from a device or database file, use the Start Database Reader
(STRDBRDR) or Start Diskette Reader (STRDKTRDR) command. For each job
in the input stream, an entry is placed on a job queue. For example, the
STRDBRDR command starts a reader to read records from a database member
and places the job on the job queue QGPL/QBATCH. Jobs are delimited by
BCHJOB and ENDBCHJOB commands.
v To place jobs on the job queue from a job schedule entry, use the Add Job
Schedule Entry (ADDJOBSCDE) command.

Moving a Job to a Different Job Queue

To move a batch job on any job queue to a different queue, use the CHGJOB
command. For example, to move a job to the QBATCH job queue, type:
CHGJOB JOB(xxxxx) JOBQ(QBATCH)

When a job queue name is not specified on a Start Reader (STRxxxRDR)

command or a Submit Jobs (SBMxxxJOB) command, the job is placed on the job
queue QGPL/QBATCH. When a job queue name is not specified on a SBMJOB
command, the job is placed on the job queue named in the job description specified
by the SBMJOB command. Jobs submitted with the SBMDBJOB, SBMDKTJOB, or
SBMJOB command can be displayed by using the Work with Submitted Job
(WRKSBMJOB) command, unless DSPSBMJOB(*NO) was specified when the job
was submitted.

Specifying Attributes of a Batch Job

To specify attributes of the batch job you are submitting, do one of the following:
v Use a specified job description without overriding any of the attributes.
v Use a specified job description but override some of the attributes (using the
BCHJOB or SBMJOB command) for the job.

The job description QGPL/QBATCH is the default for the BCHJOB command. The
default user profile for the BCHJOB command is QPGMR because it is specified in
the job description QGPL/QBATCH. The default user profile for the SBMJOB
command is *CURRENT; the submitted job uses the same profile as the job that
submitted it.

See also “Chapter 8. Batch Jobs” on page 195.

Adding a Second Job Queue

Assume, for this example, that the system has already been changed to use the
QBATCH subsystem for batch work.

The QBATCH subsystem is shipped with a single job queue for submitting batch
jobs: QBATCH. A second job queue can be created and added to the subsystem.

To create the job queue, enter the following command:

CRTJOBQ JOBQ(QGPL/QBATCH2)
TEXT('Second job queue for QBATCH')

Chapter 4. Subsystems 107

 To add the job queue to the QBATCH subsystem, enter the following command:
ADDJOBQE SBSD(QGPL/QBATCH)
JOBQ(QGPL/QBATCH2)
SEQNBR(20)

Communications Devices and Mode Allocation

When subsystems start, they request allocation of all communications devices in
the communications entries in the subsystem description. The requests are sent to
the QLUS (LU services) system job which handles device allocation for all
communications devices.

QLUS gets notified when a communications device is available for program start
request processing. This notification occurs when the connection between the local
and remote system is established for that device. When QLUS receives this
notification, it attempts to allocate the communications device to a subsystem based
on communications entry definitions. If there is no subsystem active that wants to
use the device, QLUS maintains allocation of the device until the device is varied
off, or a subsystem starts that wants to use the device.

See also “Logical Unit Services (QLUS) System Job” on page 236.

Rules for Device/Mode Allocation

When more than one subsystem contains a communications entry for a
communications device, QLUS uses the following rules to determine which
subsystem will use the device (when the device is available):
v Communications entries with the highest level of detail for the device will be
processed first. The order (from highest to lowest) of detail is: device name entry,
remote location name entry, device type entry.
v Mode names are used only for advanced program-to-program communications
(APPC)/advanced peer-to-peer networking (APPN) devices. Each mode on each
device is allocated to a subsystem. A specific mode name will take priority over
the generic *ANY mode name.
v When two or more subsystems have the same level of detail for the device and
mode, the subsystem that first requested the device gets to use the device.

Deallocation of a Communications Device

Once a communications device is allocated to a subsystem it remains in that
subsystem until the subsystem deallocates the device. When a subsystem
deallocates a device (and deallocation is not due to a device error or varying off the
device), QLUS attempts to allocate the device to another subsystem.

If a subsystem has a communications device allocated and you start a second

subsystem that should really have the device (based on the device allocation rules),
you can force the original subsystem to deallocate the device. This deallocation
causes QLUS to go through the device allocation algorithm again, which will
eventually cause the device to be allocated by the second subsystem.

108 OS/400 Work Management V4R4

Causing a Subsystem to Deallocate a Communications Device
To cause a subsystem to deallocate a communications device, you have several
options:
v Varying the device off and then on again causes QLUS to attempt to allocate the
device to a subsystem.
v Issuing the Allocate Object (ALCOBJ) command against the device works for
some communications types (request a *EXCLRD lock). Issuing the Deallocate
Object (DLCOBJ) command causes QLUS to attempt to allocate the device to a
subsystem.
v Ending the subsystem (ENDSBS command) causes QLUS to automatically
attempt to allocate the device to a subsystem.
v Removing the communications entry from the subsystem description.

The Controlling Subsystem

The controlling subsystem is the interactive subsystem that starts automatically
when the system starts, and it is the subsystem through which the system operator
controls the system. It is identified in the system value QCTLSBSD. IBM supplies
two complete controlling subsystem descriptions: QBASE (the default controlling
subsystem) and QCTL. Only one controlling subsystem can be active on the system
at any time.

The Restricted Condition

If the controlling subsystem is ended, it goes into a restricted condition. If all the
subsystems, including the controlling subsystem, are ended, the system goes into a
restricted condition. The controlling subsystem can be placed in a restricted
condition by specifying its name on the ENDSBS command or by placing the
system in the restricted condition. The system can be placed in a restricted
condition by specifying *ALL on the ENDSBS command or by using the ENDSYS
command. The ENDSBS or ENDSYS command should be issued from an
interactive job in the controlling subsystem, and only from a workstation whose
entry in the controlling subsystem description specifies AT(*SIGNON). The
interactive job from which the command was issued remains active when the
controlling subsystem goes into a restricted condition. If the job issuing the
command is one of two jobs that are active at the workstation (using the System
Request key or the TFRSECJOB command), neither of the jobs is forced to end.
However, the controlling subsystem does not end for the restricted condition until
you end one of the jobs. Suspending group jobs also prevents the controlling
subsystem from ending (until the group jobs are ended).

When the system is in the restricted condition, most of the activity on the system
has ended, and only one workstation is active. The system must be in this condition
for commands such as Save System (SAVSYS) or Reclaim Storage (RCLSTG) to
run. Some programs for diagnosing equipment problems also require the system to
be in a restricted condition. To end this condition, you must start the controlling
subsystem again.

Chapter 4. Subsystems 109

Creating Another Subsystem Description for the Controlling
Subsystem
You may want to create another subsystem description for the controlling
subsystem with attributes different from those in the shipped controlling subsystem
description QSYS/QBASE. IBM also ships a QSYS/QCTL controlling subsystem. If
you want to use it instead of QBASE, you just change the QCTLSBSD system
value. See “Subsystem Configurations Shipped by IBM” on page 502 for more
information about the two subsystem configurations supplied by IBM.

IBM ships the QSYSSBSD subsystem in QSYS, which you cannot change. The
subsystem can be used if your controlling subsystem becomes damaged or not
usable.

If you create your own controlling subsystem description, you must change the
system value QCTLSBSD. (QCTLSBSD contains the qualified name of the
subsystem description for the controlling subsystem.) A change to this value takes
effect at the next IPL unless the change is made by selecting “Define or change
system at IPL menu” on the IPL options display during the IPL. In that case, the
change takes effect during the current IPL.

You can use the subsystem description for the IBM-supplied controlling subsystem
QBASE or QCTL as a model for creating your own controlling subsystem. For more
information on the subsystem description for QBASE and QCTL, see Appendix C.
IBM-Supplied Object Contents.

The subsystem description for the controlling subsystem should contain a routing
entry containing either *ANY or QCMDI as routing data, QSYS/QCMD as the
program to be called, and class QSYS/QCTL or a user-defined class. This is
because a user, usually the system operator, must be able to enter commands to
do such things as free up storage if the auxiliary storage threshold has been
reached.

The subsystem description for the controlling subsystem must contain a workstation
entry for the console, and that entry must be of type *SIGNON. (*SIGNON is a
value for the AT parameter, specified on the Add Work Station Entry (ADDWSE)
command.) The *SIGNON value indicates that the sign-on display is displayed at
the workstation when the subsystem is started. This requirement ensures that the
subsystem has an interactive device for entry of system and subsystem level
commands. The End System (ENDSYS) command ends the OS/400 licensed
program to a single session (or sign-on display) at the console in the controlling
subsystem. A subsystem description that does not contain a workstation entry for
the console cannot be started as a controlling subsystem.

To have an alternative source of controlling input, the subsystem description for the
controlling subsystem should have an entry for another workstation. If a console
problem is detected during an attended IPL and the system value QSCPFCONS is
set to ’1’, the IPL will continue in unattended mode. Then, if the subsystem
description for the controlling subsystem contains a workstation entry for another
workstation, that workstation can be used.

The subsystem description for the controlling subsystem should have a routing
entry containing 525XTEST as routing data, QSYS/QARDRIVE as the program to
be called, and QSYS/QCTL as the class. All workstations that are not allocated by
subsystems or jobs have test requests processed by the controlling subsystem.

110 OS/400 Work Management V4R4

 After you have created the controlling subsystem, change the system value
QCTLSBSD as follows (assuming the subsystem description is named
QGPL/QCTLA):
CHGSYSVAL SYSVAL(QCTLSBSD) VALUE('QCTLA QGPL')

The change becomes effective at the next IPL.

If you create your own controlling subsystem, you should use a name other than
QBASE or QCTL.

Retrieving the Sign-On Information in an Application Program

The data specified on the user portion of the Sign-On display is sent as
replacement data in the CPF1124 message for interactive jobs. This data starts in
byte 133 of the replacement text. The following program will retrieve the data:
PGM
DCL VAR(&MSGDTA) TYPE(*CHAR) LEN(260) /*RECEIVES THE MESSAGE DATA */
DCL VAR(&MSGID) TYPE(*CHAR) LEN(7) /*RECEIVES THE MESSAGE ID */
DCL VAR(&USERDTA) TYPE(*CHAR) LEN(128) /*RECEIVES THE USER DATA */
/* Receive the CPF1124 message to obtain the user portion of the */
/* Sign-On display. Note that the message is not removed so that */
/* it will be available to the job log. The message ID is also */
/* retrieved to ensure that the message is CPF1124. */
RCVMSG PGMQ(*EXT) RMV(*NO) MSGDTA(&MSGDTA)
MSGID(&MSGID)
IF COND(&MSGID *EQ 'CPF1124') THEN(CHGVAR VAR(&USERDTA) +
VALUE(%SST(&MSGDTA 133 128)))
ENDPGM

Using Retrieved Data

After the retrieve program has run, the data that the user specified will be located in
bytes 133 through 260 in the variable &MSGDTA. The CHGVAR command in the
sample program moves the data to &USERDTA. The portions of the 128-byte buffer
that were not used will appear as blanks in the variable &USERDTA.

Changing the Number of Jobs Allowed in a Subsystem

You can change the maximum number of jobs allowed in a subsystem by using the
commands and their parameters:
Command Parameter
CHGSBSD MAXJOBS
CHGJOBQE MAXACT
CHGWSE MAXACT
CHGCMNE MAXACT
CHGRTGE MAXACT
CHGPJE MAXJOBS

Chapter 4. Subsystems 111

Allowing More Batch Jobs to Run
To allow more batch jobs a job queue to run at the same time, use the Change Job
Queue Entry (CHGJOBQE) command. The QBASE subsystem is shipped with a job
queue entry for the QBATCH job queue that only allows one batch job at a time to
run.

The following command allows two batch jobs from the QBATCH job queue to run
at the same time in the QBASE subsystem. You can issue this command at any
time and takes effect immediately.
CHGJOBQE SBSD(QSYS/QBASE) JOBQ(QGPL/QBATCH)
MAXACT(2)

User Sign-Ons
When a workstation user signs on, the following actions occur:
v The routing table is searched for a match for the routing data, which comes from
the job description.
v If QSYS/QCMD is the program specified in the routing entry that matched the
routing data, the user profile is checked for an initial program. If an initial
program is specified, that program is called. If control returns from the initial
program, a check is made for an initial menu. If one is specified in the user
profile, it is displayed.
v If QSYS/QCMD is not the program specified in the routing entry, the program that
is specified is called.

Controlling the Initial Workstation Display

Since the system searches for a match to the routing data, you can control what is
displayed when a workstation user signs on by:
v Creating an initial program or initial menu that is specified in a particular user
profile and specifying QSYS/QCMD in the routing entry. Whenever the user signs
on with this user profile, the same information is displayed regardless of which
workstation he uses.
v Specifying an initial program or an initial menu on the Sign-On display if your
user profile allows this.
v Changing the workstation entry to specify a job description that has routing data
to route to a particular routing entry and call a specific program so the routing
operates the same regardless of which user signs on at the workstation.
v Using request data in a job description to call a program. In this case, if the
workstation user has an initial program associated with his user profile, that initial
program is called. However, if there is no initial program associated with the user
profile, the request data is processed and the specified program is called.

Using an Initial Program in a User Profile

To specify an initial program in a user profile, you use the Create User Profile
(CRTUSRPRF) command:
CRTUSRPRF USRPRF(WSUSERS) INLPGM(USRMNUPGM)
INLMNU(*SIGNOFF)

QSYS/QCMD should also be specified in the routing entry. The initial menu and
initial program are called only when QSYS/QCMD is specified in the routing entry. If

112 OS/400 Work Management V4R4

you route to a different program, the system does not call them. (You can call them
with your own program. Use the RTVUSRPRF command to determine what they
are.) Whenever someone signs on as WSUSERS, the user profile is checked for an
initial program, and the program USRMNUPGM is called unless overridden on the
sign-on display. This program can display a menu that allows workstation users to
select the application they want to run. By specifying the *SIGNOFF value on the
initial menu (INLMNU) parameter, the system signs off the user when the initial
program ends.

If you do not end the initial program, the program continues to run until the
subsystem is ended or the job is ended.

Using an Initial Menu in a User Profile

To specify an initial menu in a user profile, you use the Create User Profile
(CRTUSRPRF) command:
CRTUSRPRF USRPRF(WSUSERS) INLMNU(MAIN)
INLPGM(SETUP)

QSYS/QCMD should also be specified in the routing entry. The initial menu and
initial program are called only when QSYS/QCMD is specified in the routing entry. If
you route to a different program, the system does not call them. (You can call them
with your own program. Use the RTVUSRPRF command to determine what they
are.) Whenever someone signs on as WSUSERS, the user profile is checked for an
initial program, and the program SETUP is called unless overridden on the sign-on
display when the program setup is done. The initial menu MAIN is displayed (unless
overridden on the sign-on display). The initial menu continues to be displayed until
you sign off.

Using Routing Data

When you use routing data to determine a routing program for a workstation, you
need to create a job description that specifies the routing data and a job description
in the user profile, and add a routing entry to the subsystem description. (To change
the subsystem description, the subsystem must be inactive.)
CRTJOBD JOBD(DSP02JOBD) USER(*RQD)
RTGDTA('DSP02')
ADDWSE SBSD(QINTER) WRKSTN(DSP02)
JOBD(DSP02JOBD)
ADDRTGE SBSD(QINTER) SEQNBR(100)
CMPVAL('DSP02')
PGM(DSP02MNU) POOLID(2)

Whenever anyone signs on at workstation DSP02, the system retrieves the routing
data from the associated job description (DSP02JOBD) and compares it with the
compare values specified in the routing entries. Because the routing data matches
the compare value in the routing entry that was added to the subsystem description
for QINTER, the program DSP02MNU is called.

Using Request Data

When you use request data to determine a controlling program for a workstation,
you need to create a job description that specifies the request data, add a
workstation entry to the subsystem description specifying this job description, and
create a user profile that specifies the password to be used.

Chapter 4. Subsystems 113

 CRTJOBD JOBD(DSP03JOB) USER(*RQD)
RQSDTA('CALL DSP03MENU')
RTGDTA(QCMDI)
ADDWSE SBSD(QINTER) WRKSTN(DSP03)
JOBD(DSP03JOBD)
CRTUSRPRF USRPRF(DSP03USER)

If someone signs on at workstation DSP03 with user name DSP03USER, the

program DSP03MENU is called. If DSP03USER is used to sign on at another
workstation that does not have a special workstation entry set up, the initial menu
MAIN is displayed. (This is because MAIN is the default for INLMNU on the
CRTUSRPRF command).

Using Double-Byte Request Data

You can use double-byte data as part of the request data entered with the following
commands:
v Reroute Job (RRTJOB)
v Transfer Job (TFRJOB)
v Transfer Batch Job (TFRBCHJOB)

The number of double-byte characters that you can include in request data,
including shift control characters, is half the allowed number of alphanumeric
characters.

Note: Do not use double-byte data as request data (RQSDTA) or routing data
(RTGDTA) parameters on the Batch Job (BCHJOB) and Submit Job
(SBMJOB) commands because the system might not properly process the
data.

Preventing Request End or Sign-Off

Normally, a workstation user can end a request or sign off by requesting the System
Request menu and selecting the appropriate option. This could cause a problem if
the workstation user ended a request or signed off in the middle of a multiple
operation transaction.

You can prevent access to the System Request menu (the Security - Reference
book contains information on how to do this). You can also allow access to the
System Request menu, but prevent the use of certain commands. For example, the
security officer can revoke public authority to the End Request (ENDRQS) and
SIGNOFF commands and give it only to those users that are not running sensitive
applications. For the workstation user to sign off, the user must call a CL program
that issues the SIGNOFF command. This program must be owned by someone with
authority to the command and must be created with the value USRPRF(*OWNER)
specified on the Create CL Program (CRTCLPGM) command.

If the workstation user’s authority to the ENDRQS and SIGNOFF commands is

revoked and the user attempts to select these options from the System Request
menu, a message is received. The message says that the user does not have
authority to the commands.

Preventing Sign-On Display from QINTER Subsystem

This example assumes that the system uses the QINTER subsystem for interactive
work.

114 OS/400 Work Management V4R4

 If you do not want the sign-on display shown at some workstations when you start
the QINTER subsystem, you can do the following:

Add the workstation entries in the QSYS/QINTER subsystem description to specify

AT(*ENTER) in the workstation name (WRKSTN) entry for workstations where you
do not want the sign-on display to appear. This allows interactive jobs to be
transferred to the QSYS/QINTER subsystem. You should not change the
WRKSTNTYPE(*ALL) entry.

Controlling a Group of Workstations Separately

You may want to control a group of workstations separately. For example, if you
have a group of workstation users who are using the same application, you may
want that group of users to sign off to perform some special application function or
to send them a message. You can:
v Create a separate subsystem for the group of workstation users. A separate
subsystem allows a convenient start and shutdown, but it does not simplify the
job of sending messages to the group.
v Create a command or a CL program that can be used to send a message to a
group of workstations. This approach does not assist in controlling sign-on or
sign-off. See the CL Programming book for an example of a CL program that can
be used to send a message to a group of workstations.

Considerations for Using Multiple Subsystems

Subsystem monitor jobs provide function for initiating and ending jobs. In addition,
subsystems perform device recovery when a job is ended for some reason. There
are various reasons why device recovery may be needed. Some reasons are:
powering off a display, ending an emulator connection from the client, or a network
failure. Device recovery is done on one device at a time and is a synchronous
operation.

Subsystems that are starting or ending many jobs, or that have many devices to
recover at one point in time may become very busy. This may cause a negative
impact on other work running in that subsystem. For example, users may not be
able to sign-on to the system if the interactive subsystem in which they run is busy.

To maintain good system performance, limit the number of devices allocated to an

interactive or communications subsystem to between 200 and 300. Spreading the
work across multiple subsystems provides multiple process to handle the work. This
provides better error isolation. In addition, multiple processes can lead to greater
parallelism on multi-processor systems.

For more information on this topic, see Communications Management,

SC41-5406-02.

Controlling Initial Program Load (IPL)

You can control the IPL by changing the IPL start-up program, calling a special IPL
recovery program, setting up an unattended environment, or setting up an
unattended nighttime environment.

Chapter 4. Subsystems 115

 Changing the IPL Start-Up Program
The autostart job in the controlling subsystem transfers control to the program
specified in the system value QSTRUPPGM. You can tailor this program.

You can create your own program and change the QSTRUPPGM system value to
that program name. Or, you can use the shipped program QSTRUP in QSYS as a
base to create your own program. To do this, you would:
1. Retrieve the source of the shipped program using the RTVCLSRC command
(for example, RTVCLSRC PGM(QSYS/QSTRUP) SRCFILE(YOURLIB/YOURFILE)).
2. Change the program.
3. Create the program using the CRTCLPGM command, putting it into your own
library.
4. Test the program to ensure that it works.
5. Change the system value QSTRUPPGM to the program name and library you
specified on the CRTCLPGM command.

Calling a Special IPL Recovery Program

To call a special recovery program if the IPL senses that the previous system
ending was abnormal, you can add an autostart job entry to the subsystem
description for the controlling subsystem. This program checks the system value
QABNORMSW. For a normal system ending, the value of QABNORMSW is ’0’, and
for an abnormal system ending the value of QABNORMSW is ’1’. See the example
program in Figure 7.

An alternative is to drop the messages and start up other subsystems when your
recovery function is complete.

Special IPL Recovery Program—Example

SEQNBR *... ... 1 ... ... 2 ... ... 3 ... ... 4 ... ... 5 ... ... 6 ... ... 7
1.00 /* SPCRECOV - Autostart program to call special recovery program */
2.00 PGM
3.00 DCL &QABNORMSW *CHAR LEN(1)
4.00 RTVSYSVAL SYSVAL(QABNORMSW) RTNVAR(&QABNORMSW)
5.00 IF (&QABNORMSW *EQ '1') DO /* Recover */
6.00 SNDPGMMSG MSG('Recovery program in operation-do not +
7.00 start subsystems until notified') +
8.00 TOMSGQ(QSYSOPR)
9.00 CALL RECOVERY
10.00 SNDPGMMSG MSG('Recovery complete-jobs may be started') +
11.00 TOMSGQ(QSYSOPR)
12.00 ENDDO /* Recover */
13.00 ENDPGM

Figure 7. Special IPL Recovery Program

Setting Up an Unattended Environment

To set up an unattended environment and prevent unauthorized users from using
the console while the system is unattended, have the system operator change the
QSYSOPR message queue to default delivery and sign off. Signing-off prevents
unauthorized users from using the console. The following command changes the
QSYSOPR message queue:
CHGMSGQ MSGQ(QSYSOPR) DLVRY(*DFT)

116 OS/400 Work Management V4R4

Setting Up an Unattended Nighttime Environment
You may have jobs in your installation that can be run in an unattended nighttime
environment. These jobs could be submitted throughout the day to be processed at
night. To set up this environment, you could create a special subsystem for the
nighttime work. The subsystem description and job queue could be defined with the
following commands:
CRTSBSD SBSD(QGPL/NIGHTQ) POOLS((1 *BASE))
TEXT('Nighttime jobs')
CRTJOBQ JOBQ(QGPL/NIGHTQ) TEXT('Nighttime
job queue')
ADDJOBQE SBSD(QGPL/NIGHTQ) JOBQ(QGPL/NIGHTQ)
MAXACT(1)
ADDRTGE SBSD(QGPL/NIGHTQ) SEQNBR(10)
CMPVAL(*ANY) PGM(QSYS/QCMD)
CLS(QGPL/QBATCH)

You then create a job description using the Create Job Description (CRTJOBD)
command that specifies the job queue QGPL/NIGHTQ on the JOBQ parameter.

Starting the NIGHTQ Subsystem

When ready to start the NIGHTQ subsystem, the system operator:
1. Ends all active subsystems except the controlling subsystem using the End
Subsystem (ENDSBS) command.
2. Starts the NIGHTQ subsystem with the Start Subsystem (STRSBS) command.
3. Changes the QSYS/QSYSOPR message queue to place it in default mode so
any messages requiring a response receive a default reply.
4. Submits a job with request data of a Power Down System (PWRDWNSYS)
command and a job priority of 9 to the NIGHTQ job queue. This priority places
the job at the end of the job queue so the system will be powered down when
all the jobs in the job queue have been processed.
5. Signs off.

Program to Start NIGHTQ Subsystem—Example

The STRSBS command, the Change Message Queue (CHGMSGQ) command, and
the PWRDWNSYS command could be placed in a CL program to simplify the
operator’s job. The CL program could be:

PGM
CHGMSGQ QSYSOPR DLVRY(*DFT)
STRSBS NIGHTQ
SBMJOB JOBD(QBATCH) JOBQ(QGPL/NIGHTQ)
JOBPTY(9)
CMD(PWRDWNSYS *IMMED)
SNDPGMMSG MSG('NIGHTQ subsystem started and
power down job submitted')
ENDPGM

This solution assumes that only one job is run at a time from the NIGHTQ job
queue and that no other jobs are running while the nighttime subsystem is running.
If this is not desirable, the procedure should be changed as in the following
example so that two jobs run at once and when they are completed, the system
powers down.

Chapter 4. Subsystems 117

 Program to Start NIGHTQ Subsystem with Two Batch
Jobs—Example
The following CL program could be used to start the NIGHTQ subsystem with two
batch jobs running and to ensure that all jobs have finished before the system is
powered down. The job queue entry shown in the previous example should be
changed to meet your requirements.
PGM
CHGMSGQ QSYSOPR DLVRY(*DFT)
CHGSBSD QGPL/NIGHTQ MAXJOBS(2) /* Reset to 2 */
STRSBS NIGHTQ
SBMJOB JOBD(QBATCH) JOBQ(QGPL/NIGHTQ) JOBPTY(9)
CMD(CHGSBSD QGPL/NIGHTQ MAXJOBS(1))
JOB(CHGMAXJOBS)
SBMJOB JOBD(QBATCH) JOBQ(QGPL/NIGHTQ) JOBPTY(9)
CMD(PWRDWNSYS *IMMED) JOB(POWERDOWN)
SNDPGMMSG MSG('NIGHTQ subsystem started and
power down job submitted')
ENDPGM

When the subsystem is started, the MAXJOBS value is set to 2. The first job
submitted (CHGMAXJOBS) then sets the MAXJOBS value to 1 just before the
power down job is run. Because the priority of both the CHGMAXJOBS and
POWERDOWN jobs is 9, neither job runs until all higher priority jobs in the queue
(1 being the highest priority) are run.

Mixing Double-Byte and Alphanumeric Display Stations

If you use both double-byte and alphanumeric devices with your system, you can
create an initial program to have double-byte versions of user-written alphanumeric
messages and user-designed displays shown at double-byte workstations.

Showing Double-Byte Versions of Messages

To show the double-byte versions of messages and displays at double-byte
workstations:
1. Create a library for storing the double-byte versions of messages and display
files. For example, to create a library named DBCSLIB, enter the following
command:
CRTLIB LIB(DBCSLIB) TEXT('Double-byte
version of objects')
2. Put a copy of the messages and display files into the library you just created.
3. Translate the information in the copied file from alphanumeric information to
double-byte information. For example, change message text from alphanumeric
to double-byte.
Do not change the file name.
4. Create a job description to be used for the double-byte devices. This job
description should be similar to that used for alphanumeric workstations.
However, the job description has different routing data. For example, to create
the job description DBCSJOBD, enter the following command:
CRTJOBD JOBD(DBCSJOBD) RTGDTA(DBCSWS)
LOG(4 0 *SECLVL) TEXT('Double-byte
workstation job description')
5. Create a copy of the subsystem description. This description is changed for use
as a subsystem description for DBCS workstations. For example, to create a

118 OS/400 Work Management V4R4

 copy of the subsystem description named QINTER as the subsystem
description DBCSSBSD, enter the following command:
CRTDUPOBJ OBJ(QINTER) FROMLIB(QSYS)
OBJTYPE(*SBSD) NEWOBJ(DBCSSBSD)

6. Change the subsystem description so that DBCSLIB is added ahead of the

other libraries in the system library list. For example:
CHGSBSD SBSD(DBCSLIB) SYSLIBL(DBCSLIB)
7. Change the workstation entry for the 5555 Display to specify the job description
you just created. For example, to specify a job description named DBCSJOBD,
enter the following command:
CHGWSE SBSD(DBCSSBSD) WRKSTNTYPE(5555)
JOBD(DBCSJOBD)
8. Add a routing entry that matches the routing data of the double-byte job
description. For example:
ADDRTGE SBSD(DBCSSBSD) SEQNBR(15)
CMPVAL(DBCSWS) PGM(DBCSPGM)
9. Create a CL program named DBCSPGM, similar to the one shown below that
overrides the default printer file so that the file is double-byte. When the default
printer file is double-byte, the system properly prints double-byte output printed
as a result of pressing the Print key.
PGM
OVRPRTF FILE(QSYS/QSYSPRT) IGCDTA(*YES)
TFRCTL QSYS/QCMD
ENDPGM

When you use the subsystem description DBCSSBSD, the double-byte versions of
user-written messages and user-designed displays that are stored in the library
DBCSLIB are shown at double-byte workstations. The alphanumeric versions of
these messages and displays continue to be shown at alphanumeric workstations in
the QINTER subsystem.

Interactive Subsystem Example

In the following example, objects are created for a subsystem in which interactive
work is to be processed. The subsystem automatically allocates two workstations
DSP01 and DSP02 when it is started. When a workstation user signs on, program
ORDLIB/ORDERPGM is called. Class QGPL/ORDCLS contains the running
parameters for the routing step, and the job attributes are contained in the job
description specified in the user profile.

The subsystem description ORDER is created and placed in library QGPL. When
the subsystem ORDER is started, one storage pool with a size of 500KB is
allocated. The pool’s activity level is 2. The subsystem monitor programs called to
handle the jobs in the subsystem ORDER use storage from pool 1, which is the
shared base storage pool, but use machine pool activity level. The following
CRTSBSD command creates the subsystem description ORDER:
CRTSBSD SBSD(QGPL/ORDER)
POOLS((1 *BASE) (2 500 2))
TEXT('Order entry jobs')

For an example of an autostart job in a controlling subsystem, see the example on

“Calling a Special IPL Recovery Program” on page 116, or the QBASE and QCTL
subsystem descriptions in “Appendix C. IBM-Supplied Object Contents” on
page 463.

Chapter 4. Subsystems 119

 The following command creates the class ORDCLS and places it in QGPL:
CRTCLS CLS(QGPL/ORDCLS) RUNPTY(45)
TEXT('Class for order entry')

The following commands add two workstation entries to the subsystem description
QGPL/ORDER. When the subsystem ORDER is started, DSP01 and DSP02 are
allocated to ORDER.
ADDWSE SBSD(QGPL/ORDER) WRKSTN(DSP01)
ADDWSE SBSD(QGPL/ORDER) WRKSTN(DSP02)

The following command adds a routing entry to the subsystem description

QGPL/ORDER. The interactive jobs started from DSP01 and DSP02 are
automatically routed to a routing step in which program ORDLIB/ORDERPGM is
first called.
ADDRTGE SBSD(QGPL/ORDER) SEQNBR(010)
CMPVAL(QCMDI) PGM(ORDLIB/ORDERPGM)
CLS(QGPL/ORDCLS) POOLID(2)

The following command should be specified for any subsystem that has workstation
entries. Without it, you cannot use the Test Request key on the 5250 workstations
allocated to the subsystem. (The Test Request key is used to start verification tests
for a workstation.)
ADDRTGE SBSD(QGPL/ORDER) SEQNBR(900)
CMPVAL(525XTEST) PGM(QSYS/QARDRIVE)
CLS(QSYS/QCTL)

Note: Because the POOLID parameter was not specified, a test request job runs in
pool 1 of the subsystem ORDER. This pool is defined as the base storage
pool.

120 OS/400 Work Management V4R4

Chapter 5. Jobs
Each piece of work on the system is performed in a job; each job has a unique
name within the system. All jobs, with the exception of system jobs, run within
subsystems. A job can enter the subsystem from any of the work entries, such as, a
job queue entry, workstation entry, communications entry, autostart job entry, or
prestart job entry.

A job, however, is a collection of one or more threads. Each job has at least one
thread, which is identified as the initial thread. The initial thread is created when the
job starts. The job may also have additional threads, identified as secondary
threads, depending on the applications that are used by a job.

The thread is an independent unit of dispatchable work. Each thread has its own
execution environment, such as a call stack, but the thread shares many of the
resources that are assigned to the job. The identifier for the thread is unique in the
job to which the thread belongs.

Controlling work in the system is performed mainly at the job level. Most commands
and application programming interfaces (APIs) operate against the entire job.

Resources can be owned at the thread level or the job level. The job serves as an
owner for resources that are shared with all threads within the same job. Similarly,
some attributes that determine how work is processed are defined at the thread
level and some are defined at the job level. Individual attributes and interfaces need
to be reviewed to determine the scope of the attribute.

Information about how work is processed is described throughout this guide. When
the information about the work is referred to as a job, the information applies to all
threads as a single unit within the job. When the information about the work applies
to an individual thread within a job, the information refers to only the thread.

An example of a topic that refers to threads rather than jobs is the information
about maximum activity levels. Because each thread is an independent unit of work,
the activity level of a storage pool applies to threads rather than jobs. The
maximum active counts associated with a subsystem and the subsystem work
entries, however, apply to jobs. Therefore, thread is used in information about
storage pool activity levels; job is used in information about subsystem maximum
active counts.

Types of Jobs—Overview
Table 19. Types of Jobs
Type of Job Description See Also
Interactive An interactive job starts when you sign on to the system from a display “Chapter 6. Interactive
station, transfer to a secondary or group job, or press the Test Request Jobs” on page 157
key. The interactive job ends when you sign off. Working from a display
station, you interact with the system by issuing commands, using
function keys, and running programs and applications. This job type does
not support multi-threaded applications.
Group A group job is one of up to 16 interactive jobs that are associated in a “Chapter 7. Group
group with the same workstation device and user. This job type supports Jobs” on page 171
multi-threaded applications.

© Copyright IBM Corp. 1997, 1999 121

Table 19. Types of Jobs (continued)
Type of Job Description See Also
Batch A batch job needs little or no interaction from you in order to run. Batch “Chapter 8. Batch
jobs occur when a user submits a job to a job queue, issues a Jobs” on page 195
communications program start request, starts the subsystem with an
autostart job entry, or starts the subsystem with a prestart job entry. For
example, you can submit a job to run as a batch job while you continue
to work from a display station. Compiling programs and reports are
commonly run in batch. This job type supports multi-threaded
applications.
Autostart An autostart job is a batch job doing repetitive work or one-time “Chapter 9. Autostart
initialization work that is associated with a particular subsystem. The Jobs” on page 211
autostart jobs associated with a subsystem are automatically started
each time the subsystem is started. This job type supports
multi-threaded applications.
Communications A batch job that is started by a program start request from a remote “Chapter 10.
system. This job type does not support multi-threaded applications. Communications Jobs”
on page 213
Prestart A batch job that starts running before the remote program sends a “Chapter 11. Prestart
program start request. This job type supports multi-threaded applications. Jobs” on page 217
System A batch job created by the OS/400 program to control system resources “Chapter 13. System
and to schedule jobs. This job type supports multi-threaded applications. Jobs” on page 235

Job Names
To make it easier to control and identify jobs on the system, each job has a unique
qualified job name. The qualified job name consists of three parts: the job name
(or simple job name), the user name, and the job number.
v For interactive jobs, the job name is the same as the name of the workstation
you signed on to. For batch jobs you can specify your own job name. The job
name can be up to 10 characters long.
v The user name is the name of the user profile under which the job is started.
For interactive jobs, the user name is the name you entered in the user field on
the sign-on display. For batch jobs you can specify the user profile under which
the batch job is to run. The user name can be up to 10 characters long.
v The job number is a unique number assigned by the system so you can identify
jobs, even if more than one has the same job name and user name. The job
number is always 6 numeric digits.

Job Name Syntax

The syntax for qualified job names is similar to qualified names for objects. For
example, if the job name is DSP01, the user is QPGMR, and the job number is
000578, the qualified job name is entered on the Work with Job (WRKJOB)
command as follows:
WRKJOB JOB(000578/QPGMR/DSP01)

Another similarity to object names is that you do not need to specify all of the
qualifiers. For example you could specify the following:
WRKJOB JOB(QPGMR/DSP01)

or

122 OS/400 Work Management V4R4

 WRKJOB JOB(DSP01)

This works the same as entering the entire qualified job name. If several (more than
one) jobs on the system match the portion of the job name you entered, the Select
Job display appears. This display allows you to select which job you want from a
list of duplicate job names.

Job User Identity

The job user identity (JUID) is the name of the user profile by which this job is
known to other jobs. This name is used for authorization checks when other jobs
attempt to operate against this job. Some examples of functions that operate
against another job include the Start Service Job (STRSRVJOB) command, the
Retrieve Job Information API, the Change Job API, all job control commands, and
functions that send signals from one job to another.

The JUID is not used to make authorization checks from within a job. Authorization
to perform a function is always based on the current user profile of the thread in
which the function is called.

When a job is on a job queue or output queue, the JUID is always the same as the
user name of the job and cannot be changed.

When a job starts, and at the start of any subsequent routing steps, the JUID is the
same as the name of the current user profile of the job. While a job is active, the
JUID can be changed in the following ways:
v The JUID can be explicitly set by an application using the Set Job User Identity
(QWTSJUID) application program interface (API) or the QwtSetJuid() function.
The JUID is set with the name of the user profile that the thread that called the
API or function is running under.
v The JUID can be explicitly cleared by an application using the QWTSJUID API or
the QwtClearJuid() function. The job must be running as a single threaded job at
the time. When cleared, the JUID is implicitly set by the system to the name of
the user profile that the single thread of the job is running under at that point.
v If the job is running as a single threaded job, and the JUID has not been
explicitly set by an application, then each time the job uses the Set Profile
(QWTSETP) API to run under a different user profile, the JUID is implicitly set by
the system to the name of the user profile that was set by QWTSETP.
v When a single threaded job initiates a secondary thread and the JUID has not
been explicitly set by an application, then the system will implicitly set the JUID
with the name of the user profile that the single thread of the job was running
under at the point that it initiated the secondary thread.
When the job returns to a single thread, the system implicitly sets the JUID to the
name of the user profile that the single thread of the job is running under at that
point.

Job User Identity Examples

The following examples show how the JUID is assigned in different situations:
v A job runs under a user profile called USERA. The JUID is USERA. If the job
uses the QWTSETP API to switch to USERB, the JUID changes to USERB.
v A single-threaded job runs under user profile USERX. The JUID is USERX. If the
job initiates secondary threads, the JUID remains as USERX. If all the threads
then swap to USERY, the JUID is still USERX.

Chapter 5. Jobs 123

 v If a server running under a user profile called SERVER calls the QWTSJUID API,
the JUID will be set to SERVER. If the server then calls the Set Profile
(QWTSETP) API to set its current user profile to CLIENT while processing work
on behalf of that client, the JUID remains as SERVER. Likewise, if the server
initiates secondary threads that each call QWTSETP to run under various user
profiles, the JUID remains as SERVER.

Job Commands
You can use many AS/400 commands to work with jobs. For a list, type GO CMDJOB
on any command line.

Changing Job Attributes

To change the attributes of a job:
v Temporarily for an interactive job
CHGJOB LOG(4 0 *SECLVL) OUTQ(mylib/myoutq)
v For a single batch job
SBMJOB CMD(xxxxxxxx) LOG(4 0 *SECLVL)
v Permanently
CHGJOBD JOBD(library/jobd) LOG(4 0 *SECLVL)

The default job description used by user profiles is QGPL/QDFTJOBD. The default
for submitting jobs is to use the job description from the user profile submitting the
job.

Note: The following restrictions apply to multi-threaded jobs:

v The maximum threads attribute for a job cannot be changed once the job
starts.
v A job’s JUID cannot be cleared while the job has more than one thread
active.
v A job’s accounting code cannot be changed while the job has more than
one thread active.
| v While the job has more than one thread active, you cannot change a
| small number of other job attributes. For more information, see the
| Change Job (QWTCHGJB) API in the System API Reference or the
| Change Job (CHGJOB) command in the CL Reference (Abridged).

Changing Priority and Time Slice

You can create a program to change your priority and time slice for the duration of
the command running and then reset the two values to what they were previously.
For example, it may be desirable to have a special program that can be used in an
emergency situation where the response time of command running is critical.

To do this, you would enter the following program to improve the performance of the
WRKACTJOB command:
PGM
DCL &RUNPTY *DEC LEN(2 0)
DCL &TIMESLICE *DEC LEN(7 0)
RTVJOBA RUNPTY(&RUNPTY) TIMESLICE(&TIMESLICE)

124 OS/400 Work Management V4R4

 CHGJOB RUNPTY(1) TIMESLICE(20000)
WRKACTJOB
CHGJOB RUNPTY(&RUNPTY) TIMESLICE(&TIMESLICE)
ENDPGM
Notes:
1. You may want to create a command for this function to allow a simple means of
running this program.
2. The CHGJOB command in this example changes the job run priority, which is
the highest priority for which any thread in the job may run. A thread may be run
at a lower priority by using the Change Job (QWTCHGJB) API.
3. Time slice (TIMESLICE) is a job attribute, but it is enforced at the thread level.
In this example, each thread in the job will receive a timeslice of 20000.

If the WRKACTJOB command is being used to determine an immediate

performance situation on the system, you should consider specifying the command
as:
WRKACTJOB CPUPCTLMT(2) RESET(*YES)

When the display first appears, no active jobs are meeting the requirements
because the active job statistics have been reset. If the Refresh key is pressed, the
display shows all jobs that are using more than 2% of the processing unit resource
since the command was run.

Finding a Job
To find a job on the system, use either the Work with Active Job (WRKACTJOB),
Work with User Job (WRKUSRJOB), or Work with Submitted Job (WRKSBMJOB)
command. After entering one of these commands, one of the Work with displays
appears, showing you a list of jobs.

Determining Status of a Job

To determine the status of a job on the system, use either the Work with Active Job
(WRKACTJOB) command or the Work with User Job (WRKUSRJOB) command.
Use the WRKACTJOB command to determine the specific status of the job when
the job is active, such as a message waiting. Use the WRKUSRJOB command to
determine if the job is still on the job queue, is active in a subsystem, or is finished
but with output still waiting to print. After entering one of these commands, one of
the Work with displays appears, showing you a list of jobs. The status of these jobs
is listed in the far right column.

Displaying Messages
To display the message for which a job is waiting, use one of the following
commands:
v Work with User Jobs (WRKUSRJOB)
v Work with Subsystem Jobs (WRKSBSJOB)
v Work with Active Jobs (WRKACTJOB)
v Work with Submitted Jobs (WRKSBMJOB)
After you press the Enter key, one of the Work with displays appears, showing you
a list of jobs. If the job is waiting for a message, the status MSGW (message wait)
is listed in the status column. Select option 7 (Display message) to display the
message for which the job is waiting.

Chapter 5. Jobs 125

 See also “Displaying Detailed Messages” on page 145.

Notification Messages for Jobs

The operating system can log notification messages to data queues when jobs go
through the following transitions:
v A job is placed on a job queue
v A job starts
v A job ends
You must create the data queues and properly register the data queues with the
Registration Facility. To register the exit point, use the Register Exit Point API.
These functions may cause a slight degradation of system performance. For
detailed information about the job notification exit point (QIBM_QWT_JOBNOTIFY),
see the System API Reference, SC41-5801-03.

Viewing a Job’s Output

To view the output from a job:
1. Use either the Work with Active Job (WRKACTJOB) command, Work with User
Job (WRKUSRJOB) command, Work with Submitted Job (WRKSBMJOB)
command, or Work with Subsystem Job (WRKSBSJOB) to display a list of jobs.
2. Select option 8 (Work with spooled files) to display the spooled files for that job.

You can also use the Work with Jobs (WRKJOB) command with the value *SPLF
specified for the Option parameter.

Ending a Job
If you know the name of the job you want to end, use the End Job (ENDJOB)
command.

Otherwise you can:

| 1. Use either the Work with Active Jobs (WRKACTJOB) command, Work with User
| Jobs (WRKUSRJOB) command, Work with Submitted Jobs (WRKSBMJOB)
| command, or Work with Subsystem Jobs (WRKSBSJOB) command to display a
| list of jobs.
2. Select option 4 (End) to end the job.

To end all of the jobs in a subsystem, use the End Subsystem (ENDSBS)
command. To end most jobs on the system use the End System (ENDSYS)
command. To end all of the jobs on the system and power down the system, use
the Power Down System (PWRDWNSYS) command.

A job may be ended either immediately or in a controlled manner, as indicated by

the OPTION parameter on the ENDJOB, ENDSBS, ENDSYS, and PWRDWNSYS
commands. It is recommended that you always attempt to end a job in a controlled
manner, which is the system default.

Ending a Job Immediately

The job ends immediately and the system performs end-of-job cleanup. System
cleanup can complete quickly or take up to several minutes.

126 OS/400 Work Management V4R4

An option of immediate is only recommended if an option of controlled has been
unsuccessful. When a job ends immediately, you can get undesirable results, for
example, application data that has been partially updated.

Ending a Job in a Controlled Manner

Ending a job in a controlled manner allows programs running in the job to perform
their end-of-job cleanup. A delay time may be specified by the DELAY parameter on
the ENDJOB, ENDSBS, ENDSYS, and PWRDWNSYS commands. This delay time
is the maximum amount of time that is allowed for the job to end in a controlled
manner. If the delay time ends before the job ends, the job is ended immediately.

You may want to increase the delay time if the job being ended has multiple
threads. There are several methods to determine if a job has multiple threads:
v Use the Work with Active Jobs (WRKACTJOB) command and use one of the
following methods:
– Select Option 12, Work with threads, for the job that is to be ended to view
the list of threads in that job.
– Select F11 until the Threads column is shown and check the number of
threads for the job to be ended.
v Use the Work with Job (WRKJOB) command and select Option 20, Work with
threads, if active, to view the list of threads in the job to be ended.
v Use the Display Job (DSPJOB) command and select Option 20, Display threads,
if active, to view the list of threads in the job to be ended.

Any application that needs to perform end-of-job cleanup should detect when the
job is ending in a controlled manner. There are three ways an application may
detect this:
v Synchronously retrieve End Status
v Synchronously check major and minor return codes after an I/O operation
v Handle the asynchronous signal SIGTERM

Synchronous Retrieve of End Status: At certain points, an application may

synchronously check the End Status of the job in which it is running. The job’s End
Status may be retrieved by calling the Retrieve Current Attributes (QWCRTVCA)
API, the Retrieve Job Information (QUSRJOBI) API, the List Job (QUSLJOB) API,
or by issuing the Retrieve Job Attributes (RTVJOBA) CL command.

Major and Minor Return Codes: For both display I/O and ICF communications
I/O, a major return code of 02, or a major return code of 03 with a minor return
code of 09 indicates the job is ending in a controlled manner. For more information,
see Appendix E of the Application Display Programming, SC41-5715-00 book or
Appendix B of the ICF Programming, SC41-5442-00 book.

Asynchronous Signal SIGTERM: Some applications use a signal handling

program to improve the cleanup of the application when the job is ended. Refer to
the System API Reference for more information on POSIX APIs that enable a job to
process signals. The system generates the asynchronous signal SIGTERM for the
job being ended, when the job is ending controlled and all of the following
conditions are met:
v The job is enabled for signals.
v The job has a signal handling program that is established for the SIGTERM
signal.
v The job is currently running in the problem phase.

Chapter 5. Jobs 127

 If any of the above conditions are not met, the SIGTERM signal is not generated for
the job being ended. The SIGTERM signal is not generated when a job is ended
immediately.

When a job being ended in a controlled manner has a signal handling procedure for
the asynchronous signal SIGTERM, the SIGTERM signal is generated for that job.
When the signal handling procedure for the SIGTERM signal is given control, the
procedure can take the appropriate actions to allow the application to be ended in a
controller manner.

Job Tables
The operating system uses internal job tables to track all jobs on the system. Each
entry in the job table contains information about one job.

Job Table Entries

When a new job enters the system, an entry must be available for the new job. If
there are no entries available in the table for the new job, the table is extended.
Your system will experience a performance degradation when job tables are
extended. Too many available entries will lower your system performance during the
IPL steps that process the table and during runtime functions that work with jobs. If
the number of available entries is large, you can use the Change IPL Attributes
(CHGIPLA) command to change the option to compress the jobs tables. For more
information about the CHGIPLA command, see the CL Reference (Abridged)

Displaying Job Tables

To view information about the job table and the entries that are in the job tables,
use the Display Job Tables (DSPJOBTBL) command. The DSPJOBTBL display
contains the following information about the job table and the table entries:
v The number of the job table.
v The size, in bytes, of the job table.
v The total number of entries contained in the job table.
v The number of entries that are available for the use of new jobs.
v The number of entries currently being used by jobs that are on a job queue, jobs
that are active, or jobs that have completed but still have spooled output on an
output queue.
v The number of entries that are not available and that are not currently in use by
jobs that are active, or jobs that have completed that are active but still have
spooled output on an output queue.

Job Starting and Routing

When a job (other than a prestart job) is started, the subsystem that is starting the
job must determine what the first program is that the job will run. This is called
routing the job. Routing the job is done by attempting to match up the routing data
for the job with a routing entry in the subsystem description.

See also “Routing Entries” on page 100.

128 OS/400 Work Management V4R4

Routing Steps
Each time that a job causes a subsystem to search the routing table (for any
reason), it adds a routing step. A routing step is the processing that results from
running a program specified in a routing entry. Most jobs have only one routing
step, but it is possible for some jobs to have many routing steps. A job can have
one or more routing steps, but all of the routing steps belong to that job.

Each routing step in a started job operates under the control of the program called
at the start of the routing step. The routing data received by the system determines
the routing entry in which the program name can be found.

Causes of Additional Routing Steps

The following list identifies all of the possible ways to cause the job to have another
routing step:
v Reroute Job (RRTJOB). This causes the job to reroute in the subsystem in which
the job was started.
v Pressing F3 from the highest level of the command entry display (only valid for
interactive jobs).
v Return (RETURN) command from the highest program in the job’s program stack
(only for interactive jobs—if a batch job issues the Return command, the batch
job will end).
v TFRJOB and TFRBCHJOB commands. This actually causes the job to be placed
on a job queue and then rerouted in the subsystem that has the job queue
allocated.

Errors during Job Starting and Routing

If an error is detected during routing step starting, the routing step is started only to
produce a job log and perform clean-up functions. The routing step started
message is still sent and gives the user the name of the subsystem in which the
routing step failure occurred.

Sources of Routing Data

Table 20. Sources of Routing Data
Type of Job Routing Data Source
Batch jobs Job description or routing data (RTGDTA)
parameter on the SBMJOB or BCHJOB
command
Interactive jobs Job description
Transferred or rerouted jobs TFRJOB, TFRBCHJOB, or RRTJOB
command
Communications job Created by subsystem based on information
received in the program start request
Prestart job Routing data is not used. The name of the
program to be started is specified on the
prestart job entry.

See also “Routing Data for Communications Jobs” on page 213 for information on
routing data for communications jobs.

Chapter 5. Jobs 129

 Specifying Routing Data
To specify routing data, use the RTGDTA parameter. This parameter is available
with several commands.

Specify routing data in one of the following ways:

v In the job description for the job (RTGDTA parameter in CRTJOBD command), or
RQSDTA parameter, if *RQSDTA is specified for the RTGDTA parameter.
v In the RTGDTA parameter specified in a BCHJOB or SBMJOB command
(overrides the routing data in the job description) or RQSDTA parameter, if
*RQSDTA is specified for the RTGDTA parameter.
v In the RTGDTA parameter specified on a Reroute Job (RRTJOB), Transfer Job
(TFRJOB), or Transfer Batch Job (TFRBCHJOB) command (instead of the
routing data in the job description) or RQSDTA parameter, if *RQSDTA is
specified for the RTGDTA parameter. The RRTJOB, TFRJOB, and TFRBCHJOB
commands can be run in a job after the job was initially routed using one of the
previously described ways of specifying routing data.
Notes:
1. A prestart job runs the program that is specified on the prestart job entry.
Prestart jobs do not use routing data or routing entries when they are started.
Prestart jobs also cannot be rerouted (RRTJOB) or transferred (TFRJOB).
2. The IBM-supplied routing program QCMD runs the initial program and menu for
interactive users. If you define your own routing programs, you should consider
running a user’s initial program and/or menu.
See also “Sources of Routing Data” on page 129.

Routing Program
The routing program is often used only once per job. If it calls another program and
that program eventually does a return to the routing program, the following occurs:
v If QCMD is the routing program, the initial program is called (if any), and the
initial menu is shown unless *SIGNOFF is specified in the INLMNU keyword of
the user profile.
v If a call is from a user-written routing program, the return occurs as normal to the
next instruction.
v If a user-written routing program does a TFRCTL, when the return occurs the
routing program is called again.

Job Attributes (Job Description Object)

| Job attributes determine how the system runs each job. The job description
| contains job attributes. The following is a partial list of job attributes:
| v User ID
| v Job queue (JOBQ)
| v JOBQ priority
| v Job date
| v Job date format
| v Hold on JOBQ
| v Print device

130 OS/400 Work Management V4R4

| v Output queue
| v Output priority
| v Routing data
| v Accounting code
| See the Create Job Description (CRTJOBD) command.

How Job Attributes Are Controlled

The subsystem knows where and when to get job attributes from a job description,
user profile, system value, or the currently active job based on how you specify
their attributes.

Controlling Job Attributes

To control job attributes, that is, tell the subsystem where and when to get job
attributes from different system objects, specify attributes from the job description,
user profile, or system value by using the following:
*JOBD
Tells the job to get its attributes from the job description.
*USRPRF
Tells the job to get its attributes from the user’s user profile.
*SYSVAL
Tells the job to get its attributes from a system value.
*CURRENT
Tells the job to get its attributes from the job issuing the submit job
(SBMJOB) command.
*WRKSTN
Tells the job to get its attributes from the workstation with the job
(interactive jobs only).

Job Attributes—Benefits
Controlling job attributes gives you the flexibility to control jobs at the job level, user
level, or system level. You may have your system set up to go all the way to the
system value to get job attributes (which is the system default). Then, if you want to
change a value for everyone on the system all you need to do is change the
system value and everyone’s jobs are affected. If you specify *USRPRF, you can
control or affect only the users you want to change. By specifying a value in a job
description you can affect all the types of jobs that use that job description. For
example, all batch jobs use the same job description. Changing the job description
for the batch jobs would affect all of your batch jobs and leave all other jobs
unaffected.

Note: Be aware that specifying *USRPRF and *SBSD can sometimes mean that
the system should use the name of the object not that the system should get
job attributes from those objects.

See also “Changing Job Attributes” on page 124.

Chapter 5. Jobs 131

 Job Description
A job description collects a specific set of job-related attributes. The same job
description can be used by multiple jobs. Thus, if you use a job description, you do
not need to specify the same parameters repeatedly for each job. You can create
job descriptions to describe batch jobs or interactive jobs. You can create unique
descriptions for each user of the system.

| See the Create Job Description (CRTJOBD) command.

Creating a Job Description

To create a job description, use the Create Job Description (CRTJOBD) command.
The following example and table show how you can create one job description and
use it so you do not have to specify several parameters in a lot of commands:
CRTJOBD JOBD(BATCH4) USER(*RQD) JOBPTY(4)
OUTPTY(4) RTGDTA(QCMDI)

Value from JOBD on

Command Parameter CRTJOBD Command
ADDAJE JOBD BATCH4
ADDCMNE JOBD BATCH4
BCHJOB JOBD BATCH4
CRTUSRPRF JOBD BATCH4
SBMJOB JOBD BATCH4

Changing Job Descriptions

To change a job description:
1. Use the Work with Job Description (WRKJOBD) command to find the job
description you want to change.
2. Select Option 2 to make the change.

If you know the name of the job description you want to change:
1. Use the Change Job Description (CHGJOBD) command.
2. Press F4 (Prompt).

Job Description Uses

When you define a job, you can use the job description in one of two ways:
v Use a specified job description without overriding any of its attributes. For
example:
SBMJOB JOB(OEDAILY) JOBD(QBATCH)
v Use a specified job description but override some of the attributes (using the
BCHJOB or SBMJOB command). For example, to override the message logging
in the job description QBATCH, you specify:
SBMJOB JOB(OEDAILY) JOBD(QBATCH)
LOG(2 20 *SECLVL)

Note: You cannot override any job description attributes for autostart jobs,
workstation jobs, or communications jobs.

132 OS/400 Work Management V4R4

Job Description Commands
The following commands can also be used with job descriptions:
v Change Job Description (CHGJOBD). Changes the contents of a job description.
v Delete Job Description (DLTJOBD). Deletes a job description.
v Display Job Description (DSPJOBD). Displays the contents of a job description.
v Work with Job Descriptions (WRKJOBD). Allows you to change, copy, create,
delete, or display a job description.

Job Descriptions and Security

Every job in the system uses a job description during job initiation. This controls the
various attributes of a job. The USER parameter controls the name of the user
profile assigned to the job.

A job description that has a user profile name (USER) specified should be
authorized only to specific individuals. If not, other users will have access to that job
description when running their jobs.

For example, consider:

CRTJOBD JOBD(XX) USER(JONES) . . . AUT(*USE)

This example has security risks because any user can submit a job using the XX
job description, and be authorized to whatever JONES is authorized to. If this type
of job description is used on a workstation entry, it allows anyone to sign on as that
user just by pressing the Enter key. To avoid any security exposure, do not
authorize this type of job description to *PUBLIC.

For communications jobs, see “Job Description for Communications Jobs” on

page 213 .

USER Parameter and Interactive Jobs

The job description to be used is defined on the ADDWSE (Add Work Station Entry)
command. The default is to use the job description specified in the user profile. If
USER (*RQD) is specified in the job description, the user must enter a user name.
If USER(xxxx) is specified (where xxxx is a specific user profile name), the user is
allowed to press the Enter key on the sign-on display and operate under the xxxx
user profile name, unless the security level is 40 or higher.

USER Parameter and Batch Jobs

The job description used for batch jobs is specified on the Submit Job (SBMJOB) or
Batch Job (BCHJOB) command.

If an input stream is entered that contains the BCHJOB command, the user entering
the STRxxxRDR or SBMxxxJOB command must have object operational authority
to the job description specified. When an input stream is used, jobs always operate
under the user profile of the job description and not of the user who is placing the
jobs on the job queue. If USER(*RQD) is specified in the job description, it is invalid
to use the job description on a BCHJOB command.

If a SBMJOB command is used, the command defaults so that the batch job
operates under the user profile name of the submitter. However, if USER(*JOBD) is

Chapter 5. Jobs 133

 specified on the SBMJOB command, the job operates under the name in the job
description. The submitter can specify USER(*JOBD) only if they have *CHANGE
authority to the job description. (No authority is needed to the actual user profile,
unless the security level is 40 or higher.)

Frequently, a specific name in the job description is required to let users submit
work for a specific user profile. For example, the QBATCH job description is
shipped with USER(QPGMR) to allow this. This job description is created normally
(the public is given *CHANGE authority). This means that any user on the system
who has authority to the SBMJOB, STRxxxRDR, or SBMxxxJOB command can
submit work under the QPGMR user profile.

Note: You may want to change the QBATCH job description depending on your
security needs.

Class Object
A class object contains the run attributes that control the run-time environment of a
job. IBM-supplied class objects, or classes, meet the needs of both typical
interactive and batch applications.

Creating a Class
You can also create your own classes. For example, you can create new classes to
give you a wider range of machine running priorities.

To create a class, use the Create Class (CRTCLS) command.

Changing a Class
To change a class:
1. Use the Work with Classes (WRKCLS) command to find the class.
2. Select option 2 to change the class.

If you know the name of the class you want to change, you can also use the
Change Class (CHGCLS) command.

Run-Time Attributes
Some of the run attributes, or parameters, that are important to work management
are:
v Machine run priority (RUNPTY)
v Purge (PURGE)
v Time slice (TIMESLICE)
v Default maximum wait time (DFTWAIT)
v Maximum processing time (CPUTIME)
v Maximum temporary storage (MAXTMPSTG)
v Maximum threads

134 OS/400 Work Management V4R4

 Note: Maximum processing unit time and maximum temporary storage limits can
help prevent an erroneous program from impairing system performance.
However, a sufficient amount of processing time and temporary storage must
be given to allow the job to complete.

See Chapter 14. Performance Tuning, for more information about the TIMESLICE
and PURGE parameters.

Priority for Jobs—Tips

The priorities for jobs that run in batch environments should normally be lower than
priorities for jobs in interactive environments. Also, the time slice should be small
enough so that a looping program does not dominate processor time and an activity
level.

Note: You can use the QDYNPTYADJ system value to maintain high performance
of batch jobs processing on AS/400e servers. For more details for this
system value, see “QDYNPTYADJ System Value” on page 38.

Setting a Higher Priority for System Operator Jobs

You may want the priority for the system operator’s jobs to be higher than priorities
of other jobs so that the system operator can effectively respond to system needs.

If you use QCTL as the controlling subsystem, the operator is automatically running
at a higher priority after signing on at the console. This is because QCTL routes the
console job using the QCTL class, which specifies a higher priority.

Another way you could set up your system so that the operator would run at a
higher priority would be to do the following:
1. Add a routing entry to the subsystem with unique routing data and specify the
QSYS/QCTL class.
2. Create a new job description for the operator, specifying the same unique
routing data that you used on the routing entry.
3. Change the operator’s user profile to specify the new job description.
4. Now when the operator signs on to that subsystem, the job will route using the
QCTL class, which specifies a higher priority than the class used by normal
interactive jobs.

The job run priority is the highest priority at which any thread in the job may run.
Each thread may have it’s own thread priority that is lower than the job priority. The
Change Job (CHGJOB) command will change only the job priority. The Change Job
(QWTCHGJB) API can be used to change either the job priority or a thread priority.

Chapter 5. Jobs 135

Relationships Among Job, Class, and Subsystem Descriptions

┌───────────────────────────────────┐ ┌────────────────────────────────────┐ ┌──────────────────────┐

│ │ │ │ │ │
│ Job Description 1. │ │ Subsystem Description │ │ Class 2. │
├───────────────────────────────────┤ ├────────────────────────────────────┤ ├──────────────────────┤
│ User Name │ │ ┌───────────────────────────────┐ │ │ Run priority │
│ Job queue │ │ │ Subsystem Attributes │ │ │ Time slice │
│ Job priority │ │ ├───────────────────────────────┤ │ │ Purge │
│ Output priority │ │ │ Maximum number of jobs │ │ │ Default wait time │
│ Print text │ │ │ Storage pools │ │ │ Maximum CPU time │
│ Accounting code │ │ │ Pool identifier │ │ │ Maximum tempStg │
│ Routing data │ │ │ Storage size │ │ │ Maximum threads │
│ Request data │ │ │ Activity level │ │ └──────────────────────┘
│ Syntax checking │ │ │ System display file │ │
│ Initial library list │ │ │ System library list entry│ │
│ End severity │ │ └───────────────────────────────┘ │
│ Logging level │ │ ┌───────────────────────────────┐ │
│ Log CL Program │ │ │ Work Entries │ │
│ Inquiry message reply │ │ ├───────────────────────────────┤ │
│ Printer device │ │ │ Autostart job entries │ │
│ Output │ │ │ Job name │ │
│ │ │ │1. Job description name │ │
│ Hold │ │ │ │ │
│ Date │ │ │ Work station entries │ │
│ Job switches │ │ │ Work station name/type │ │
│ Device recovery action │ │ │1. Job description name │ │
│ Time slice end pool │ │ │ Maximum activity level │ │
│ Job message queue full action │ │ │ At *SIGNON or *ENTER │ │
│ Job message queue maximum size│ │ │ │ │
└───────────────────────────────────┘ │ │ Job Queue entries │ │
│ │ Job queue name │ │
│ │ Maximum activity level │ │
│ │ Sequence number │ │
│ │ Maximum active by pty │ │
│ │ │ │
│ │ Communications entries │ │
│ │ Device description name │ │
│ │ or device type │ │
│ │ Remote location name │ │
│ │1. Job description name │ │
│ │ Default user profile │ │
│ │ Maximum activity level │ │
│ │ Mode name │ │
│ │ │ │
│ │ Prestart job entries │ │
│ │ Program │ │
│ │ User profile │ │
│ │ Prestart job name │ │
│ │ Job description name │ │
│ │ Subsystem startup │ │
│ │ Initial number of │ │
│ │ prestart jobs │ │
│ │ Threshold │ │
│ │ Additional number of │ │
│ │ prestart jobs │ │
│ │ Maximum number of │ │
│ │ prestart jobs │ │
│ │ Maximum number of │ │
│ │ program start request │ │
│ │ Wait │ │
│ │ Subsystem pool identifier│ │
│ │2. Class name │ │
│ └───────────────────────────────┘ │
│ ┌───────────────────────────────┐ │
│ │ Routing entries │ │
│ ├───────────────────────────────┤ │
│ │ Sequence number │ │
│ │ Compare value and │ │
│ │ starting position │ │
│ │ Program name │ │
│ │2. Class name │ │
│ │ Maximum activity level │ │
│ │ Pool identifier │ │
│ └───────────────────────────────┘ │
└────────────────────────────────────┘

Figure 8. Relationship Between Job Description, Subsystem Description, and Class

136 OS/400 Work Management V4R4

Job Rerouting and Transferring
Rerouting a job (RRTJOB command) starts a new routing step in the same
subsystem; transferring a job (TFRJOB or TFRBCHJOB commands) starts a new
routing step in the same or another subsystem. In both cases, file overrides are
removed, allocated objects except the workstation and job message queue are
deallocated, and files are closed. The library list stays the same because it is
specified at the job level. The temporary library (QTEMP) and all objects in it
remain the same, and all job attributes remain the same. Prestart jobs cannot be
rerouted or transferred.

Job Rerouting—Benefits
Rerouting a job can be used to change the processing attributes of a job. By
rerouting a job, you can use a different routing entry to process the next routing
step. For example, if the next part of a job needs to run in a different storage pool,
you reroute the job so that it runs in a different storage pool.

When Interactive Jobs Reroute

An interactive job is rerouted when either of the following occurs:
v The workstation user presses the Exit key or enters the RETURN command from
the only program in the program stack of a job. If QCMD is the only program on
the program stack, a window is displayed with choices Y (=Yes) or N (=No) for
exiting the command entry display.
If the user responds with Y, the job is rerouted. If the user responds with N, the
user can return to the command entry display.
v The workstation user enters either the RRTJOB command or the TFRJOB
command.

Transferring Jobs
To transfer an interactive or batch job, use the Transfer Job (TFRJOB) or Transfer
Batch Job (TFRBCHJOB) command.

Either an interactive job or a batch job can be transferred to another subsystem.

However, to transfer a job, the user profile for the job must have *READ authority
for the job queue and *USE authority for the subsystem description of the
subsystem being transferred to.

How Interactive Jobs Transfer

A transferring interactive job enters the new subsystem through the job queue. To
transfer an interactive job, the job queue being transferred to (representing the
subsystem being transferred to) must belong to an active subsystem and there
must be a workstation entry for the workstation in the subsystem description of the
subsystem being transferred to. (The workstation entry must be AT(*ENTER) and
not AT(*SIGNON).)

When an interactive job is placed on a job queue, it is given the highest job queue
priority to minimize any delay. However, if the job queue is being held or if the
maximum number of active jobs is already met for the subsystem, the transferring
job must wait until the queue is released or until an active job ends. If the new
subsystem is ended by the End Subsystem (ENDSBS), End System (ENDSYS), or

Chapter 5. Jobs 137

 Power Down System (PWRDWNSYS) command while a transferring interactive job
is on a job queue, the job is ended as part of the subsystem ending.

How Batch Jobs Transfer

A batch job can transfer itself to another job queue. In this case, the job queue
need not be associated with an active subsystem, and it is placed on the job queue
with its current job priority.

Note: If a batch job is on a job queue, it can be moved to a different job queue by
specifying the JOBQ parameter on the CHGJOB command.

Spooled inline files can be accessed only during the first routing step of a batch job.
If a batch job contains a Transfer Job (TFRJOB), Reroute Job (RRTJOB), or
Transfer Batch Job (TFRBCHJOB) command the spooled inline files cannot be
accessed in the new routing step.

Because a PWRDWNSYS command prevents new jobs or routing steps from being
started by any subsystem, a batch job that has been placed on a job queue by a
TFRJOB command may not complete before the system is powered down. The
temporary objects associated with a transferring job (such as the library list and the
QTEMP library and all objects in it) are cleared during a power down; therefore,
during the initial program load (IPL), the system is unable to restore the job to its
previous state. During the IPL, the system removes the job from the job queue and
produces its job log.

However, if a batch job has been placed on a job queue by the Transfer Batch Job
(TFRBCHJOB) command, the system saves the information that is necessary to
start the batch job again if it is on the job queue during an IPL. This includes having
the same job name and a single job log made for the job. The temporary library
(QTEMP) is cleared by the TFRBCHJOB command at each routing step.

See also “Routing Steps” on page 129 and “Routing Program” on page 130.

Job Logs
A job log contains information related to requests entered for a job, such as
commands in the job, commands in a CL program, and messages. A special type of
log, a history log (QHST), contains system data, such as a history of job activity on
your system.

Each job has an associated job log that can contain the following for the job:
v The commands in the job
v The commands in a CL program if the CL program was created with the
LOG(*YES) option or with the LOG(*JOB) option and a Change Job (CHGJOB)
command was run with the LOGCLPGM(*YES) option
v All messages (the message and help text for the message) sent to the requester
and not removed from the program message queues
At the end of the job, the job log can be written to the spooled file QPJOBLOG so
that it can be printed. After the job log is written to the spooled file, the job log is
deleted. You can prevent a job log from being written for successfully completing
jobs.

138 OS/400 Work Management V4R4

 See “Preventing the Production of Job Logs” on page 154.

Controlling Information in a Job Log

To control what information is written in the job log, specify the LOG parameter on
the Create Job Description (CRTJOBD) command. You can change these levels
using the Change Job (CHGJOB) command or the Change Job Description
(CHGJOBD) command. The LOG parameter has three values: message level,
message severity, and message text.

Note: Setting the log level (message text level) to 0 0 *NOLIST in a lengthy batch
job can waste system resource. This can occur when filtering only occurs at
the end of the job and if 0 0 *NOLIST was specified for the logging level. In
this case, every message will be removed.

Message Filtering
Filtering is the process of removing messages from the job log based on the
message logging level of the job. If you run a CL program as an interactive or batch
job, filtering runs once after the program ends. If you run a request processing
program, filtering occurs before each new request is received.

Details on request processing programs can be found in the CL Programming book.

Message Filtering Scenario

The following scenario demonstrates:
v That filtering occurs after each command is run interactively.
v How the logging level affects the information that is stored in the job message
queue and, therefore, written to the job log, if one is requested.

First step: The CHGJOB command specifies a logging level of 2 and a message
severity of 50, and that only messages are to be written to the job log (*MSG).
Command Entry SYSTEM1
Request level: 1
Previous commands and messages:

> CHGJOB LOG(2 50 *MSG)

Second step: PGMA sends three informational messages with severity codes of
20, 50, and 60 to its own program message queue and to the program message
queue of the program called before the specified call (*PRV). The messages that
PGMA sends to its own program message queue are called detailed messages.
These messages are sent to the program message queue of the lower level
program call.

PGMB sends two informational messages with severity codes of 40 and 50 to its
own program message queue. These are detailed messages. PGMB also sends
one informational message with a severity code of 10 to *PRV.

Chapter 5. Jobs 139

 Note that the CHGJOB command no longer appears on the display. According to
logging level 2, only requests for which a message has been issued with a severity
equal to or greater than that specified are saved for the job log, and no messages
were issued for this request. If such a message had been issued, any detailed
messages that had been issued would also appear.
Command Entry SYSTEM1
Request level: 1
Previous commands and messages:

> CALL PGMA

Message sev 20 - PGMA
Message sev 50 - PGMA
Message sev 60 - PGMA
> CALL PGMB
Message sev 10 - PGMB

Bottom
Type command, press Enter.
===> _________________________________________________________________________
______________________________________________________________________________
______________________________________________________________________________
______________________________________________________________________________
F3=Exit F4=Prompt F9=Retrieve F10=Include detailed messages
F11=Display full F12=Cancel F13=Information Assistant F24=More keys

Third step: When F10=Include detailed messages is pressed from the Command
Entry display, all the messages are displayed.
Command Entry SYSTEM1
Request level: 1
Previous commands and messages:

> CALL PGMA

Detailed message sev 20 - PGMA
Detailed message sev 50 - PGMA
Detailed message sev 60 - PGMA
Message sev 20 - PGMA
Message sev 50 - PGMA
Message sev 60 - PGMA
> CALL PGMB
Detailed message sev 40 - PGMB
Detailed message sev 50 - PGMB
Message sev 10 - PGMB
Bottom
Type command, press Enter.
===> _________________________________________________________________________
______________________________________________________________________________
______________________________________________________________________________
______________________________________________________________________________
F3=Exit F4=Prompt F9=Retrieve F10=Include detailed messages
F11=Display full F12=Cancel F13=Information Assistant F24=More keys

Fourth step: When another command is entered (in this example, CHGJOB), the
CALL PGMB command and all messages (including detailed messages) are removed
because the severity code for the message associated with this request was not
equal to or greater than the severity code specified in the CHGJOB command. The
CALL PGMA command and its associated messages remain because at least one of
the messages issued for that request has a severity code equal to or greater than
that specified.

140 OS/400 Work Management V4R4

The CHGJOB command specifies a logging level of 3, a message severity of 40,
and that both the first- and second-level text of a message are to be written to the
job log. When another command is entered, the CHGJOB command remains on the
display because logging level 3 logs all requests.

PGMC sends two messages with severity codes of 30 and 40 to the program
message queue of the program called before the specified call (*PRV).

PGMD sends a message with a severity of 10 to *PRV.

Command Entry SYSTEM1
Request level: 1
Previous commands and messages:

> CALL PGMA

Message sev 20 - PGMA
Message sev 50 - PGMA
Message sev 60 - PGMA
> CHGJOB LOG(3 40 *SECLVL)
> CALL PGMC
Message sev 30 - PGMC
Message sev 40 - PGMC
> CALL PGMD
Message sev 10 - PGMD

Bottom
Type command, press Enter.
===> _________________________________________________________________________
______________________________________________________________________________
______________________________________________________________________________
______________________________________________________________________________
F3=Exit F4=Prompt F9=Retrieve F10=Include detailed messages
F11=Display full F12=Cancel F13=Information Assistant F24=More keys

When another command is entered after the CALL PGMD command was entered, the
CALL PGMD command remains on the display, but its associated message is deleted.
The message is deleted because its severity code is not equal to or greater than
the severity code specified on the LOG parameter of the CHGJOB command.

The command SIGNOFF *LIST is entered to print the job log.

Chapter 5. Jobs 141

 Command Entry SYSTEM1
Request level: 1
Previous commands and messages:

> CHGJOB LOG(3 40 *SECLVL)

> CALL PGMC
Message sev 30 - PGMC
Message sev 40 - PGMC
> CALL PGMD
> CALL PGME
> SIGNOFF *LIST

Bottom
Type command, press Enter.
===> _________________________________________________________________________
______________________________________________________________________________
______________________________________________________________________________
______________________________________________________________________________
F3=Exit F4=Prompt F9=Retrieve F10=Include detailed messages
F11=Display full F12=Cancel F13=Information Assistant F24=More keys

The job log contains all the requests and all the messages that have remained on
the Command Entry display and on the detailed messages display. The job log also
contains the second-level message text associated with each message, as specified
by the CHGJOB command. Notice that the job log contains the second-level
message text of any message issued during the job, not just for the messages
issued since the second CHGJOB command was entered.

Job Log Heading

Figure 9 on page 143 shows a job log. The headings at the top of each page of the
printed job log identify the job to which the job log applies and the characteristics of
each entry:
v The fully qualified name of the job (job name, user name, and job number).
v The name of the job description used to start the job.
v The date and time the job started.
v The message identifier.
v The message type.
v The message severity.
v The date and time each message was sent.
v The message. If the logging level specifies that second-level text is to be
included, the second-level text appears on subsequent lines below the message.
v The program from which the message or request was sent.
v The machine interface instruction number or the offset into the program from
which the message was sent.
v The program to which the message or request was sent.
v The machine interface instruction number or the offset into the program to which
the message was sent.

Note: The machine interface instruction numbers appear only for escape, notify,
and diagnostic messages. For all other message types, the machine
interface instruction number is set to zero.

142 OS/400 Work Management V4R4

 The logging levels affect a batch job log in the same way as shown in the example
in Figure 9.

If the job uses APPC, the heading contains a line showing the unit of work identifier
for APPC. See the APPC Programming book for more information on APPC.

Job Log—Example
5763SS1 V4R2M0 970829 Job Log RCHGEN5C 08/18/97 14:36:33 Page 1
Job name . . . . . . . . . . : QPADEV0019 User . . . . . . : TIMR Number . . . . . . . . . . . : 062213
Job description . . . . . . : QDFTJOBD Library . . . . . : QGPL
MSGID TYPE SEV DATE TIME FROM PGM LIBRARY INST TO PGM LIBRARY INST
CPF1124 Information 00 08/18/97 14:34:06 QWTPIIPP QSYS 05CE *EXT *N
Message . . . . : Job 062213/TIMR/QPADEV0019 started on 08/18/97 at 14:34:06
in subsystem QINTER in QSYS. Job entered system on 08/18/97 at 14:34:06.
*NONE Request 08/18/97 14:34:09 QMHGSD QSYS 055B QCMD QSYS 00EA
Message . . . . : -crtlib timr
CPC2102 Completion 00 08/18/97 14:34:12 QLICRLIB QSYS 047F QCMD QSYS 0116
Message . . . . : Library TIMR created.
*NONE Request 08/18/97 14:34:19 QMHGSD QSYS 055B QCMD QSYS 00EA
Message . . . . : -crtsrcpf timr/qclsrc
CPC7301 Completion 00 08/18/97 14:34:20 QDDCPF QSYS 03A6 QCMD QSYS 0116
Message . . . . : File QCLSRC created in library TIMR.
*NONE Request 08/18/97 14:34:23 QMHGSD QSYS 055B QCMD QSYS 00EA
Message . . . . : -strpdm
EDT0232 Completion 00 08/18/97 14:35:02 QSUEXIT QPDA 12DE QUOCMD QSYS 0182
Message . . . . : Member CLPGM added to file TIMR/QCLSRC.
Cause . . . . . : Member requested for editing did not exist. Member has
been added to the file.
EDT0229 Completion 00 08/18/97 14:35:02 QSUEXIT QPDA 12DE QUOCMD QSYS 0182
Message . . . . : Member CLPGM in file TIMR/QCLSRC changed with 3 records.
Cause . . . . . : Member has been changed.
*NONE Request 08/18/97 14:35:11 QPTCHECK *N QCMD QSYS 00EA
Message . . . . : -CRTCLPGM PGM(TIMR/CLPGM) SRCFILE(TIMR/QCLSRC)
CPC0815 Completion 00 08/18/97 14:35:24 QCLENTR QSYS 0282 QCMD QSYS 0116
Message . . . . : Program CLPGM created in library TIMR.
Cause . . . . . : See the compiler printout for a list of any messages.
Recovery . . . : If necessary, correct the errors.
*NONE Request 08/18/97 14:35:34 QMHGSD QSYS 055B QCMD QSYS 00EA
Message . . . . : -call timr/clpgm
*NONE Request 08/18/97 14:35:40 QMHGSD QSYS 055B QCMD QSYS 00EA
Message . . . . : -wrkactjob
*NONE Request 08/18/97 14:35:53 QMHGSD QSYS 055B QCMD QSYS 00EA
Message . . . . : -wrkcfgsts *dev
*NONE Request 08/18/97 14:36:10 QMHGSD QSYS 055B QCMD QSYS 00EA
Message . . . . : -dspjob
*NONE Request 08/18/97 14:36:15 QMHGSD QSYS 055B QCMD QSYS 00EA
Message . . . . : -wrksbs
*NONE Request 08/18/97 14:36:33 QMHGSD QSYS 055B QCMD QSYS 00EA
Message . . . . : -signoff *list
CPF1164 Completion 00 08/18/97 14:36:33 QWTMCEOJ QSYS 0205 *EXT *N
Message . . . . : Job 062213/TIMR/QPADEV0019 ended on 08/18/97 at 14:36:33;
2 seconds used; end code 0 .
Cause . . . . . : Job 062213/TIMR/QPADEV0019 completed on 08/18/97 at
14:36:33 after it used 2 seconds processing unit time. The job had ending
code 0. The job ended after 1 routing steps with a secondary ending code of
0. The job ending codes and their meanings are as follows: 0 - The job
completed normally. 10 - The job completed normally during controlled ending
or controlled subsystem ending. 20 - The job exceeded end severity (ENDSEV
job attribute). 30 - The job ended abnormally. 40 - The job ended before
becoming active. 50 - The job ended while the job was active. 60 - The
subsystem ended abnormally while the job was active. 70 - The system ended
abnormally while the job was active. 80 - The job ended (ENDJOBABN command).
90 - The job was forced to end after the time limit ended (ENDJOBABN
command). Recovery . . . : For more information, see the Work Management
book, SC41-5306.

Figure 9. Job Log

Displaying the Job Log

The way to display a job log depends on the status of the job.
v If the job has ended and the job log is not yet printed, find the job using the Work
with User Job (WRKUSRJOB) command, then:
1. Select option 8 (Display spooled file)
2. Find the spooled file named QPJOBLOG

Chapter 5. Jobs 143

 3. Select option 5 (Display job log)
v If the job is still active (batch or interactive jobs) or is on a job queue and has not
yet started, use the Work with User Job (WRKUSRJOB) command or the Work
with Active Job (WRKACTJOB) command to display the job log as follows:
1. Select option 5 (Work with job)
2. Select option 10 (Display job log)

Displaying Job Log of Interactive Job

To display the job log of your own interactive job, do one of the following:
v Enter the following command:
DSPJOBLOG
v Enter the WRKJOB command and select option 10 (Display job log) from the
Work with Job display.
v Press F10 (Display detailed messages) from the Command Entry display (this
key displays the messages that are shown in the job log).
v If the input inhibited light on your display station is on and remains on, do the
following:
1. Press the System Request key, then press the Enter key.
2. On the System Request menu, select option 3 (Display current job).
3. On the Display Job menu, select option 10 (Display Job log, if active or on
job queue).
4. On the Job Log display, press F10 (Display detailed messages).
5. On the Display All Messages display, press the Roll Down key to see
messages that were received before you pressed the System Request key.
v Sign off the workstation, specifying LOG(*LIST) on the SIGNOFF command.

Job Log Display Characteristics

When you use the Display Job Log (DSPJOBLOG) command, you see the Job Log
display. This display shows program names with special symbols, as follows:
>> The running command or the next command to be run. For example, if a CL
or high-level language program was called, the call to the program is
shown.
> The command has completed processing.
. . The command has not yet been processed.
? Reply message. This symbol marks both those messages needing a reply
and those that have been answered.

Job Log Display Uses

On the Job Log display, you can do the following:
v Use the Page down (or Roll up) key to get to the end of the job log. To get to the
end of the job log quickly, press F18 (Bottom). After pressing F18, you might
need to roll down to see the command that is running.
v Use the Page up (or Roll down) key to get to the top of the job log. To get to the
top of the job log quickly, press F17 (Top).

144 OS/400 Work Management V4R4

 Displaying Detailed Messages
To display detailed messages from the Display Job Log display, press F10. This
display shows the commands or operations that were run within a high-level
language program or within a CL program for which LOGCLPGM is activated.

Changing the Output Queue for All Jobs

To change the output queue for all jobs on the system, use the OUTQ or DEV
parameter on the Change Printer File (CHGPRTF) command to change the file
QSYS/QPJOBLOG. The following are two examples using each of the parameters:
CHGPRTF FILE(QSYS/QPJOBLOG) DEV(USRPRT)

and

CHGPRTF FILE(QSYS/QPJOBLOG) OUTQ(USROUTQ)

Specifying the Output Queue for a Job Log

To specify the output queue to which a job’s job log is written, make sure that file
QPJOBLOG has OUTQ(*JOB) specified. You can then use the OUTQ parameter on
any of the following commands: BCHJOB, CRTJOBD, CHGJOBD, or CHGJOB. The
following is an example:
CHGJOB OUTQ(USROUTQ)

If the output queue for a job cannot be found, no job log is produced.

Holding Job Logs

To hold all job logs, specify HOLD(*YES) on the CHGPRTF command for the file
QSYS/QPJOBLOG. The job logs are then released to the writer when the Release
Spooled File (RLSSPLF) command is run. The following is an example:
CHGPRTF FILE(QSYS/QPJOBLOG) HOLD(*YES)

Deleting a Job Log

To delete a job log, use the Delete Spooled File (DLTSPLF) command or the Delete
option on the output queue display.

Job Log—Tips
v If the output queue for a job cannot be found, no job log is produced.
v If the system abnormally ends, the start prompt allows the system operator to
specify whether the job logs are to be printed for any jobs that were active at the
time of the abnormal end.
v If you use the USRDTA parameter on the Change Print File (CHGPRTF)
command to change the user data value for the QSYS/QPJOBLOG file, the value
specified is not shown on the Work with Output Queue or Work with All Spooled
Files displays. The value shown in the user data column is the job name of the
job whose job log has printed.

Chapter 5. Jobs 145

Interactive Job Logs
The IBM-supplied job descriptions QCTL, QINTER, and QPGMR all have a log level
of LOG(4 0 *NOLIST); therefore, all messages help text are written to the job log.
However, the job logs are not printed if the job ends normally unless you specify
*LIST on the SIGNOFF command.

How Interactive Messages Are Logged

If a display station user uses an IBM-supplied menu or the command entry display,
all error messages are displayed. If the display station user uses a user-written
initial program, any unmonitored message causes the initial program to end and a
job log to be produced. However, if the initial program monitors for messages, it
receives control when a message is received. In this case, it may be important to
ensure that the job log is produced so you can determine the specific error that
occurred. For example, assume that the initial program displays a menu that
includes a sign-off option, which defaults to *NOLIST. The initial program monitors
for all exceptions and includes a Change Variable (CHGVAR) command that
changes the sign-off option to *LIST if an exception occurs:
PGM
DCLF MENU
DCL &SIGNOFFOPT TYPE(*CHAR) LEN(7)
VALUE(*NOLIST)
.
.
.
MONMSG MSG(CPF0000) EXEC(GOTO ERROR)
PROMPT: SNDRCVF RCDFMT(PROMPT)
CHGVAR &IN41 '0'
.
.
.
IF (&OPTION *EQ '90') SIGNOFF
LOG(&SIGNOFFOPT);
.
.
.
GOTO PROMPT
ERROR: CHGVAR &SIGNOFFOPT '*LIST'
CHGVAR &IN41 '1'
GOTO PROMPT
ENDPGM

If an exception occurs, the CHGVAR command changes the option on the

SIGNOFF command to *LIST and sets on an indicator. This indicator could be used
to condition a constant that displays a message explaining that an unexpected error
occurred and telling the display station user what to do.

CL Commands Logged for Interactive Jobs

If the interactive job is running a CL program, the CL program commands are
logged only if the log level is 3 or 4 and one of the following is true:
v LOGCLPGM(*YES) was specified on the Create Control Language Program
(CRTCLPGM) command.
v LOGCLPGM(*JOB) was specified on the Create Control Language Program
(CRTCLPGM) command and (*YES) is the current LOGCLPGM job attribute.

146 OS/400 Work Management V4R4

 Setting and Changing the LOGCLPGM Attribute
The LOGCLPGM job attribute can be set and changed by using the LOGCLPGM
parameter on the SBMJOB, CRTJOBD, and CHGJOBD commands.

Batch Job Logs

For your batch applications, you may want to change the amount of information
logged. The log level (LOG(4 0 *NOLIST)) specified in the job description for the
IBM-supplied subsystem QBATCH supplies a complete log if the job abnormally
ends. If the job completes normally, no job log is produced.

To change the amount of information logged, change the log level from (LOG(4 0
*NOLIST)). For information on how to do this, see “Changing Logging Level for a
Job” on page 153.

Printing the Job Log in all Cases

If you want to print the job log in all cases, use the Change Job Description
(CHGJOBD) command to change the job description, or specify a different LOG
value on the BCHJOB or SBMJOB command.

CL Commands Logged for Batch Jobs

If the batch job is running a CL program, the CL program commands are logged
only if LOGCLPGM(*YES) is specified on the Create Control Language Program
(CRTCLPGM) command or the Change Program (CHGPGM) command.

QHST History Log

The history (QHST) log consists of a message queue and a physical file known as
a log-version. Messages sent to the log message queue are written by the system
to the current log-version physical file.

The history log (QHST) contains a high-level trace of system activities such as
system, subsystem, and job information, device status, and system operator
messages. Its message queue is QHST.

Log-Version
Each log-version is a physical file that is named in the following way:
Qxxxyydddn

where:
xxx Is a 3-character description of the log type (HST)
yyddd Is the Julian date on which the log-version was created
n Is a sequence number within the Julian date (0 through 9 or A through Z)

When a log-version is full, a new version of the log is automatically created.

Note: The number of records in the log-version of the history log is specified in the
system value QHSTLOGSIZ.

Chapter 5. Jobs 147

 Processing History Log Records
You can also write a program to process history log records. Because several
versions of each log may be available, you must select the log-version to be
processed.

Determining Available Log-Versions

To determine the available log-versions, use the Display Object Description
(DSPOBJD) command. For example, the following DSPOBJD command displays
what versions of the history log are available:
DSPOBJD OBJ(QSYS/QHST*) OBJTYPE(*FILE)

Deleting Log-Versions
To delete logs on your system, use the delete option from the display presented on
the Work with Objects (WRKOBJ) command.

Displaying or Printing the History Log

To display or print the information in a log, use the Display Log (DSPLOG)
command. You can select the information you want displayed or printed by
specifying any combination of the following:
v Period of time
v Name of job that sent the log entry
v Message identifiers of entries
The following DSPLOG command displays all the available entries for the job
OEDAILY in the current day:
DSPLOG JOB(OEDAILY)

Time and Date in Log-Version

If you have reset the system date or time to an earlier setting, a system log-version
can contain entries that are not in chronological order and, therefore, when you try
to display the log-version, some entries may be missed. For example, if the
log-version contains entries dated 1988 followed by entries dated 1987, and you
want to display those 1987 entries, you specify the 1987 dates on the PERIOD
parameter on the DSPLOG command but the expected entries are not displayed.
You should always use the system date (QDATE) and the system time (QTIME), or
you should specify the PERIOD parameter as follows:
PERIOD((start-time start-date) (*AVAIL *END))

The system writes the messages sent to a system log message queue to the
current version physical file when the message queue is full or when the DSPLOG
command was used.

Ensuring Log-Version Is Current

To ensure the current version is up to date, specify a fictitious message identifier,
such as ###0000, on the DSPLOG command. No messages are displayed, but the
log-version physical file is made current.

148 OS/400 Work Management V4R4

Format of the History Log
A database file is used to store the messages sent to a system log. Because all
records in a physical file have the same length and messages sent to a log have
different lengths, the messages can span more than one record. Each record for a
message has three fields:
v System date and time (a character field of length 8). This is an internal field. The
converted date and time also are in the message.
v Record number (a 2-byte field). For example, the field contains hex 0001 for the
first record, hex 0002 for the second record, and so on.
v Data (a character field of length 132).

Format for Third Field (Data): Table 21 shows the format for the third field (data)
of the first record.
Table 21. Format for Third Field of the First Record
Contents Type Length Positions in Record
Job name Character 26 11-36
Converted date and Character 13 37-49
time1
Message ID Character 7 50-56
Message file name Character 10 57-66
Library name Character 10 67-76
2
Message type Character 2 77-78
Severity code Character 2 79-80
Sending program Character 12 81-92
name
Sending program Character 4 93-96
instruction number
Receiving program Character 10 97-106
name
Receiving program Character 4 107-110
instruction number
Message text length Binary 2 111-112
Message data length Binary 2 113-114
Reserved Character 28 115-142

1
The format is: cyymmddhhmmss where:
c Is the century digit (c=0 if yy ≥40, c=1 if yy <40)
yymmdd Is the year, month, and day that the message is sent
hhmmss Is the hour, minute, and second that the message is sent
2
This has the same value as the RTNTYPE parameter on the Receive Message
(RCVMSG) command.

Table 22 on page 150 shows the format of the third field (data) of the remaining
records.

Chapter 5. Jobs 149

 Table 22. Format of Remaining Records
Contents Type Length
Message Character Variable1
Message data Character Variable2

1
This length is specified in the first record (positions 111 and 112) and cannot
exceed 132.
2
This length is specified in the first record (positions 113 and 114).

A message is never split when a new version of a log is started. The first and last
records of a message are always in the same QHST version.

QHST File Processing

If you use a high-level language program to process the QHST file, keep in mind
that the message data begins at a variable location for each use of the same
message. The reason for this is that the message includes replaceable variables,
so the actual length of the message varies.

However, for message CPF1124 (job start) and message CPF1164 (job completion),
the message data always begins in position 11 of the third record.

Performance Information and QHST

Performance information is not displayed as text on message CPF1164. Because
the message is in the QHST log, users can write application programs to retrieve
this data. The format of this performance information is as follows.

The performance information is passed as a variable length replacement text value.

This means that the data is in a structure with the first entry being the length of the
data. The size of the length field is not included in the length.

Time and Date: The first data fields in the structure are the times and dates that
the job entered the system and when the first routing step for the job was started.
The times are in the format 'hh:mm:ss'. The time separators in this example are
colons. This separator is determined by the value specified in the QTIMSEP system
value. The dates are in the format defined in the system value QDATFMT and the
separators are in the system value QDATSEP. The time and date the job entered
the system precede the job start time and date in the structure. The time and date
the job entered the system are when the system becomes aware of a job to be
initiated (a job structure is set aside for the job). For an interactive job, the job entry
time is the time the password is recognized by the system. For a batch job, it is the
time the BCHJOB or SBMJOB command is processed. For a monitor job, reader or
writer, it is the time the corresponding start command is processed, and for
autostart jobs it is during the start of the subsystem.

Total Response Time and Number of Transactions: Following the times and
dates are the total response time and the number of transactions. The total
response time is in seconds and contains the accumulated value of all the intervals
the job was processing between pressing the Enter key at the workstation and
when the next display is shown. This information is similar to that shown on the
WRKACTJOB display. This field is only meaningful for interactive jobs.

150 OS/400 Work Management V4R4

 It is also possible in the case of a system failure or abnormal job end that the last
transaction will not be included in the total. The job end code in this case would be
a 40 or greater. The transaction count is also only meaningful for interactive jobs
other than the console job and is the number of response time intervals counted by
the system during the job.

Number of Synchronous Auxiliary I/O Operations: The number of synchronous

auxiliary I/O operations follows the number of transactions. For a job with multiple
threads, this value includes only synchronous auxiliary I/O operations from the initial
thread. This is the same as the AUXIO field that appears on the WRKACTJOB
display except for the following difference:
v The WRKACTJOB display shows the value for the initial thread of the current
routing step.
v The QHST message contains the cumulative total for the initial thread of each
routing step in the job.
If the job ends with a end code of 70, this value may not contain the count for the
final routing step. Additionally, if a job exists across an IPL (using a TFRBCHJOB
command) it is ended before becoming active following an IPL, the value is 0.

Job Type
The final field in the performance statistics is the job type. Values for this field are:
A Autostarted job
B Batch job
I Interactive job
M Subsystem monitor
R Spooling reader
S System job
W Spooling writer
X Start CPF job

Accessing Message Data

To access the message data for messages in which the message data begins in a
variable position:
1. Determine the length of the variables in the message. For example, assume
that a message uses the following five variables:
Job name *CHAR 10
User name *CHAR 10
Job number *CHAR 6
Time *CHAR 8
Date *CHAR 8

These variables are fixed in the first 42 positions of the message data.
2. Find the location of the message data. Consider that:
v The message always begins in position 11 of the second record.
v The length of the message is stored in a 2-position field beginning at position
111 of the first record. This length is stored in a binary value so if the
message length is 60, the field contains hex 003C.

Chapter 5. Jobs 151

 3. Determine the location of the message data using the length of the message
and the start position of the message.

No Job Log? Message CPF1164

If no job log is produced for a job, you can use the following reason codes for
CPF1164 to locate information in the QHST file that more precisely describes why a
job ended. Table 23 lists and describes the reason codes.
Table 23. Reason Codes for CPF1164
Reason Codes Description
0 No special reason for job ending.
100 The disconnect time interval was exceeded.
101 The session device was deleted and created again for a disconnected
job.
102 Errors occurred trying to start a job that was disconnected.
300 Job encountered a device error and DEVRCYACN was set to *ENDJOB.
301 Job ended due to looping on device errors.

QHST File Processing Scenario

The following RPG program processes the QHST file for the job completion
message CPF1164. The QHST file in the program must be overridden to one of the
actual QHST files. The program reads each record from the file into an array. A data
structure is defined to match the message data for CPF1164. You can determine
the structure of the message data for a message by using the Display Message
Description (DSPMSGD) command.

For message CPF1164, there are always three records and the message data
always begins in position 11 of the third record. The program checks for the first
record of a message (RCDNBR = 1) and then checks for CPF1164 in positions 50
through 56. If the message is CPF1164, the program sets on indicator 22 so that
when the third record is read, the message data can be moved to the data
structure. Once the message data is in the data structure, the fields can be printed,
as in this example, or written to a database file. Note that the RTGSTP field
contains the number of routing steps used by the job. Some of the information in
the message data is not in the text for CPF1164. This includes:
v Number of routing steps
v Time and date the job was entered (this is the submitted time for batch jobs; for
interactive jobs, it is the same as the time and date started)
v Time and date started
v Total response time (*)
v Number of transactions (*) (number of display station interactions)
v Number of auxiliary storage I/O operations (*)
v Job type

Note: The fields marked with an asterisk (*) are the same as those on the
WRKACTJOB display.

QHST File Processing—Example

Figure 10 on page 153 is a programming example for processing the QHST file.

152 OS/400 Work Management V4R4

SEQNBR *... ... 1 ... ... 2 ... ... 3 ... ... 4 ... ... 5 ... ... 6 ... ... 7 ..

01.00 FQHST IP F 142 DISK

02.00 FQPRINT O F 132 OF PRINTER
03.00 E ARR 132 1 INPUT ARRAY
04.00 IQHST AA 01
05.00 I B 9 100RCDNBR
06.00 I 11 142 ARR
07.00 I 50 56 MSGNBR
08.00 IMSG DS
09.00 I 1 10 JOB
10.00 I 11 20 USER
11.00 I 21 26 JOBNBR
12.00 I 27 34 JOBTIM
13.00 I 35 42 JOBDAT
14.00 I B 43 460CPUTIM
15.00 I B 47 480RTGSTP
16.00 I B 49 500CMPCOD
17.00 I 73 80 TIMENT
18.00 I 81 88 DATENT
19.00 I 89 96 STRTIM
20.00 I 97 104 STRDAT
21.00 I B 105 1080TOTRSP
22.00 I B 109 1120NBRTRN
23.00 I B 113 1160NBRAUX
24.00 I 117 117 JOBTYP
25.00 C 1 COMP RCDNBR 20
26.00 C 20 'CPF1164' COMP MSGNBR 22
27.00 C 20 GOTO END
28.00 C 3 CABNERCDNBR END 12
29.00 C N22 GOTO END
30.00 C MOVEAARR MSG
31.00 C EXCPTDETAIL
32.00 C END TAG
33.00 OQPRINT E 1 DETAIL
34.00 O JOB
35.00 O USER
36.00 O JOBNBR
37.00 O JOBTIM + 1
38.00 O JOBDAT + 1
39.00 O CPUTIM + 1
40.00 O RTGSTP + 1
41.00 O CMPCOD + 1
42.00 O TIMENT + 1
43.00 O DATENT + 1
44.00 O STRTIM + 1
45.00 O STRDAT + 1
46.00 O TOTRSP + 1
47.00 O NBRTRN + 1
48.00 O NBRAUX + 1
49.00 O JOBTYP + 1

Figure 10. QHST File Processing Example

Getting Job Logs in One Output Queue

To get the job logs in one output queue, change the job log print file. The default
output queue for job logs is the output queue the job is using. Therefore, job logs
for different jobs go to different output queues. Since the system looks at the print
file first to determine which output queue to use, you can specify that all job logs go
to one output queue by changing the job log print file output queue parameter to a
specific output queue.

To change the job log print file so that all job logs go to a specified output queue:
CHGPRTF FILE(QSYS/QPJOBLOG)
OUTQ(library/outq)

Changing Logging Level for a Job

You can control the level of information that is put in the job log. To change the
logging level:
v Temporarily for an interactive job

Chapter 5. Jobs 153

 CHGJOB LOG(4 0 *SECLVL)
v For a single batch job
SBMJOB CMD(xxxxxxxx) LOG(4 0 *SECLVL)
v Permanently
CHGJOBD JOBD(library/jobd)
LOG(4 0 *SECLVL)

The default job description used by user profiles is QGPL/QDFTJOBD. The default
for submitting jobs is to use the job description from the user profile submitting the
job.

Help text for these commands describes the different logging levels.

Note: The examples above set the logging level to the highest logging level
possible.

Preventing the Production of Job Logs

To prevent a job log from being produced at the completion of a batch job, you can
specify *NOLIST for the message level text of the LOG parameter on the Batch Job
(BCHJOB), Submit Job (SBMJOB), Change Job (CHGJOB), Create Job Description
(CRTJOBD), or Change Job Description (CHGJOBD) command. If you specify
*NOLIST for the message text value of the LOG parameter, the job log is not
produced at the end of a job unless the job end code is 20 or greater. If the job end
is 20 or greater, the job log is produced.

For an interactive job, the value specified for the LOG parameter on the SIGNOFF
command takes precedence over the LOG parameter value specified for the job.

Deleting Log Files

Log-version physical files accumulate on a system. Old logs that are not needed
should be deleted periodically. Only the security officer is authorized to delete
log-version files.

To delete a log-version:
1. Use the Delete File (DLTF) command.
2. Specify the object name or generic name to be deleted.

Delete Log Sample Command and Program

An alternative to manually deleting old log-version physical files is to make your
own command and program. This simplifies the process of deleting logs on your
system. The sample Delete Log (DLTLOG) command that follows specifies the log
and the number of days to keep logs. The default log is QHST, and the default
number of days is five. For example, if you keep the defaults, all QHST files that
are older than five days from the current date are deleted. The last date in which a
message was sent to the log is used for the comparison, not the creation date of
the log.

Because the security officer is the only user who can delete the log files, you may
want to create the program with USRPRF(*OWNER) and authorize the command
and program to specific users.

154 OS/400 Work Management V4R4

 This function is dependent on the accurate entry of the system date during IPL. You
may want to add this command to other standard processing functions of QHST
and include them as an autostart job.

The command accepts the name of the log to be deleted and the number of days
that the logs are to be kept. The current date is retrieved and converted to Julian
format. The program subtracts the number of days entered on the command from
the last date in which a message was sent to the log, and that number is used. The
text description of each log file contains the date that the last message was sent to
it. The program also tests for year-end. The names of the log files are put into an
output file in library QTEMP by the DSPOBJD command. The number of files
deleted and kept is counted and placed in the completion message.

Creating a Sample DLTLOG Command and Program

To make the sample DLTLOG command and program:
1. Enter the command definition statements as shown in Figure 11.
2. Create the DLTLOG command with the parameter PGM(DLTLOGC) specified.
3. Enter the CL program source statements as shown in Figure 12 on page 156.
4. Create the DLTLOGC program.

Delete Log (DLTLOG)—Example

SEQNBR *... ... 1 ... ... 2 ... ... 3 ... ... 4 ... ... 5 ... ... 6 ... ... 7 ..

01.00 CMD PROMPT('Delete Log') /* CPP IS DLTLOGC */

02.00 PARM LOG *CHAR LEN(4) DFT(QHST) RSTD(*YES) +
03.00 VALUES('QHST') +
04.00 PROMPT('Log (QHST):')
05.00 PARM DAYS *DEC LEN(2 0) DFT(5) +
06.00 RANGE(1 50) +
07.00 PROMPT('Nbr of days to keep log')

Figure 11. DLTLOG Example

DLTLOGC CL Program Source Statements—Example

Note: You could change this program to include the following functions:
v Copy the QHST file to another file.
v Save the QHST file.
v Produce standard reports on the file.

Chapter 5. Jobs 155

SEQNBR *... ... 1 ... ... 2 ... ... 3 ... ... 4 ... ... 5 ... ... 6 ... ... 7 ..

01.00 PGM PARM(&LOG &DAYS);

02.00 DCLF QSYS/QADSPOBJ /* IBM file to be overridden */
03.00 DCL &LOG *CHAR LEN(4)
04.00 DCL &DAYS *DEC LEN(2 0)
05.00 DCL &WRKDAT *CHAR LEN(6)
06.00 DCL &JULIANA *CHAR LEN(5)
07.00 DCL &YRD *DEC LEN(2 0)
08.00 DCL &DAYSD *DEC LEN(3 0)
09.00 DCL &NUM3 *DEC LEN(3 0)
00.00 DCL &QHSTLAST *CHAR LEN(6)
11.00 DCL &QHSTLASTJ *CHAR LEN(5)
12.00 DCL &DLTCNT *DEC LEN(5 0)
13.00 DCL &DLTCNTA *CHAR LEN(5)
14.00 DCL &RMNCNT *DEC LEN(5 0)
15.00 DCL &RMNCNTA *CHAR LEN(5)
16.00 DCL &MSGID *CHAR LEN(7)
17.00 DCL &MSGDTA *CHAR LEN(100)
18.00 MONMSG MSGID(CPF0000) EXEC(GOTO ERROR)
19.00 /* Subtract nbr of days from the current date */
20.00 RTVJOBA DATE(&WRKDAT) /* Rtv current date */
21.00 CVTDAT DATE(&WRKDAT) TOVAR(&JULIANA) TOFMT(*JUL) +
22.00 TOSEP(*NONE) /* Convert to Julian */
23.00 CHGVAR &YRD %SST(&JULIANA 1 2)
24.00 CHGVAR &DAYSD %SST(&JULIANA 3 3)
25.00 CHGVAR &NUM3 (&DAYSD - &DAYS) /* Sub for cmd days */
26.00 IF (&NUM3 *LE 0) DO /* Went passed Jan 1 */
27.00 CHGVAR &YRD (&YRD - 1)
28.00 CHGVAR &DAYSD (365 + &NUM3) /* Assume 365 per year */
29.00 ENDDO
30.00 ELSE CHGVAR &DAYSD &NUM3 /* Same year */
31.00 CHGVAR %SST(&JULIANA 1 2) &YRD /* Cnvt to Julian */
32.00 CHGVAR %SST(&JULIANA 3 3) &DAYSD /* Cnvt to Julian */
33.00 /* Create OUTFILE of log descriptions */
34.00 DSPOBJD OBJ(QSYS/(&LOG *CAT '*')) OBJTYPE(*FILE) +
35.00 OUTPUT(*OUTFILE) OUTFILE(QTEMP/DSPOUTP)
36.00 /* Delete log loop */
37.00 OVRDBF QADSPOBJ TOFILE(QTEMP/DSPOUTP)
38.00 LOOP: RCVF RCDFMT(QLIDOBJD) /* DSPOBJD format */
39.00 MONMSG MSGID(CPF0864) EXEC(GOTO END)
40.00 /* Extract the date of the last msg sent */
41.00 /* to the log file. This is written */
42.00 /* as part of the text description of */
43.00 /* the object beginning in position 15 */
44.00 CHGVAR &QHSTLAST %SST(&ODOBTX 15 6)
45.00 CVTDAT DATE(&QHSTLAST) TOVAR(&QHSTLASTJ) +
46.00 FROMFMT(*YMD) TOFMT(*JUL) +
47.00 TOSEP(*NONE) /* Convert to Julian */
48.00 IF (&QHSTLASTJ *LE &JULIANA) DO /* Comp dates */
49.00 DLTF QSYS/&ODOBNM /* Delete the log file */
50.00 CHGVAR &DLTCNT (&DLTCNT + 1) /* Count decisions */
51.00 ENDDO
52.00 ELSE +
53.00 CHGVAR &RMNCNT (&RMNCNT + 1) /* Count remaining */
54.00 GOTO LOOP
55.00 /* Send completion message */
56.00 END: CHGVAR &DLTCNTA &DLTCNT /* Convert to alpha */
57.00 CHGVAR &RMNCNTA &RMNCNT /* Convert to alpha */
58.00 SNDPGMMSG MSG('Number of files deleted-' *CAT +
59.00 &DLTCNTA *CAT +
60.00 ' Number remaining-' *CAT +
61.00 &RMNDNTA)
62.00 DLTF QTEMP/DSPOUTP
63.00 RETURN
64.00 ERROR: RCVMSG MSGID(&MSGID) MSGDTA(&MSGDTA) MSGTYPE(*EXCP)
65.00 SNDPGMMSG MSGID(&MSGID) MSGDTA(&MSGDTA) +
66.00 MSGF(QCPFMSG) MSGTYPE(*ESCAPE)
67.00 ENDPGM

Figure 12. DLTLOGC CL Program Source Statements

156 OS/400 Work Management V4R4

Chapter 6. Interactive Jobs
An interactive job is a job that starts when a user signs on to a display station and
ends when the user signs off. For the job to run, the subsystem searches for the
job description, which may be specified in the workstation entry or the user profile.

Initiating An Interactive Job

To initiate an interactive job, sign on the system.

The Sign On display is an example of what the workstation user sees at the
workstation. The use of the shipped objects by the OS/400 licensed program is not
obvious to the workstation user. For this procedure, assume the OS/400 licensed
program and the subsystem QBASE have been started. Assume also that the
workstation user has an initial main menu and no initial program is called that
displays a menu.
Sign On
System . . . . . : XXXXXXXX
Subsystem . . . . : QBASE
Display . . . . . : DSP01

User . . . . . . . . . . . . . . __________
Password . . . . . . . . . . . . __________
Program/procedure . . . . . . . . __________
Menu . . . . . . . . . . . . . . __________
Current library . . . . . . . . . __________

1. Enter your user name and password, then press the Enter key. The AS/400
Main Menu is shown.
2.
MAIN AS/400 Main Menu
System XXXXXXXX
Select one of the following:

1. User tasks
2. Office tasks
3. General system tasks
4. Files, libraries, and folders
5. Programming
6. Communications
7. Define or change the system
8. Problem handling
9. Display a menu
10. User support and education
11. PC Support tasks

90. Sign off

3. Select options from this menu. When you select option 90 (Sign off), the
interactive job ends and the new sign-on display is shown.

You can change the QSECURITY system value to require the user to enter a valid
password when signing on. See Chapter 2. System Values, or the Security -
Reference book for more information on requiring passwords.

© Copyright IBM Corp. 1997, 1999 157

Interactive Job Initiation

┌──────────┐
│ Sign-On │ User signs on with user
│ Display │ password and user name.
└──────────┘
│
ø
┌──────────┐
│ INLPGM │ Initial program (if any) in
└──────────┘ user profile is called.
│
ø
┌──────────┐
│ INLMNU │ Initial menu in user
└──────────┘ profile is called.
│ Default is main menu.
│
ø
Sign Off

Figure 13. User Signs On to the AS/400 System

How an Interactive Job Starts

When a user signs on the system, the subsystem gathers information from several
system objects before the interactive job is ready.
1. The subsystem looks in the workstation entry for the job description in order to
get the attributes for the interactive job. If the workstation entry specifies
*USRPRF for the job description, the job will use the information from the user
profile.

Note: This flexibility allows you to specify whether the job’s attributes are tied to
the workstation or to the individual user.
2. Once the subsystem knows which job description to use, it may not find all the
job attributes in the job description. Some attributes may be in the user profile. If
the user profile does not have the information, the subsystem looks at the
system value.

Note: The user profile contains job attributes that allow you to tailor certain
things specifically for that user.
3. After the subsystem gathers all of the job’s attributes, it checks the job
description for the routing data. The subsystem uses the routing data to find a
routing entry in the subsystem description. The routing entry provides
information about which pool the job will use, which routing program will be
used, and from which class the job will get its run-time attributes.
4. When all of these pieces are obtained, the routing program runs. IBM supplies a
routing program called QCMD, which you can use for all types of work. QCMD
knows if the job is an interactive job and checks the user profile for an initial
program to run. If the initial program finishes running, QCMD displays the initial
menu.

158 OS/400 Work Management V4R4

 What Occurs When an Interactive Job Where the System Gets Its Information
Starts
Sign on at a display.
↓
Get the job description for this interactive job. Subsystem workstation entry
User profile
↓
Get job attributes. Job description
User profile
Workstation device description
System values
↓
Get routing data and entry. Job description
v Get program to run. Subsystem routing entry class
v Get class (run time information).
v Get pool number.
↓
Run the routing program from the routing Subsystem routing entry
entry.
↓
Call initial program, display initial menu, or User profile or sign-on display
both.
↓
Interactive job ready.

Figure 14. How an Interactive Job Starts

Interactive Jobs and Routing Step

Several steps occur within the subsystem before the initial menu is called.
1. The routing data is compared with the routing entries in the subsystem
description.
2. When a match is made, the program specified in the routing entry is called and
the routing step is started.

Note: For the subsystem QBASE, the program QSYS/QCMD is called to process
the commands in the job. QSYS/QCMD supports both interactive and batch
jobs.

Subsystem Activity
Figure 15 on page 160 shows the subsequent activity leading up to starting a
routing step and displaying the initial menu for a user profile specifying an initial
program.

Chapter 6. Interactive Jobs 159

User Profile SMITH Job 000901/SMITH/DSP01

INLPGM = Authority
PROGR

Job Attributes
Job Description QGPL/QDFTJOBD

Routing data defined in the

job description is compared
RTGDTA = with the routing entries
QCMDI within the subsystem
Subsystem QBASE
description.

Subsystem Description QSYS/QBASE

Routing
Entry

CMPVAL = Class QGPL/QINTER Routing Step

QCMDI
Processing
CLS = Attributes
QGPL/QINTER

PGM =
QSYS/QCMD

Program QSYS/QCMD

Initial Program PROGR

DSP01
Subsystem finds a match for the routing data.
Initial Menu
Routing step is started.

Routing program starts running.

Initial program PROGR is called by routing program QCMD.

Initial menu is called by routing program QCMD.

RSLS881-2

Figure 15. Subsystem Activity

This figure shows the subsequent activity leading up to starting a routing step and
displaying the initial menu for a user profile specifying an initial program.

160 OS/400 Work Management V4R4

Interactive Job Approaches
You can handle interactive jobs in various ways, and these approaches are
dependent upon how you control the routing step. You should determine the
following:
v Which program will control the routing step: QSYS/QCMD or a user program?
v Will the routing be user-based or workstation-based?
See “Which Program Should Control the Routing Step?” on page 165 and “Should
Routing Be Workstation- or User-Based?” on page 166 for the advantages and
comparisons.

The scenarios “Routing Step Controlled Using QSYS/QCMD—Scenario” and

“Routing Step Controlled by User Program (Interactive)” on page 162 show different
techniques for building an environment in which a sample program
USERLIB/ORDERS1 is called. In these scenarios, USERLIB/ORDERS1 could be
an order entry program, an inquiry program, or a menu program.

Routing Step Controlled Using QSYS/QCMD—Scenario

Figure 16 on page 162 shows how the IBM-supplied program QSYS/QCMD can be
used to control the routing step.

Chapter 6. Interactive Jobs 161

 DSP01 Job Description USERLIB/JOBD1 A user signs on at work station DSP01.
Any Valid
Sign-on The work station entry for DSP01
Sign-On Information USER = *RQD contains the name of the job description
Display from which routing information is to be
obtained.
RTGDTA = CMDS
The routing data CMDS matches the
comparison value in the routing entry
Subsystem Description specifying program QSYS/QCMD.
QGPL/SBS1

Work Station Entry

WRKSTN JOBD

USERLIB/
DSP01
JOBD1

Routing Entry

SEQNBR CMPVAL PGM CLS MAXACT POOLID

QSYS/ QGPL/
10 CMDS QCMD QINTER *NOMAX 1

Routing Step User Profile QSYS/QCMD is called for the routing

Checks step and checks the user profile
for Initial for an initial program.
Program INLPGM =
QSYS/QCMD
Runs *NONE

Initial Menu QSYS/QCMD displays the initial menu

(no initial program specified).
First Display
after Sign-on
CALL
ORDERS1

RV3W000-0

Figure 16. Interactive Jobs, Routing to QSYS/QCMD

Routing Step Controlled by User Program (Interactive)

This scenario shows a technique for building a library in which a sample program is
called. In this example, user program USERLIB/ORDERS1 is used to control the
routing step. Figure 17 on page 163 shows using a user program to control the
routing step.

162 OS/400 Work Management V4R4

 DSP01 Job Description USERLIB/JOBD1 Jones signs on at work station DSP01.
Sign-on
Information The work station entry for DSP01
Sign-On for JONES USER = *RQD contains the name of the job description
Display from which routing information is to be
obtained.
RTGDTA = CMDS
The routing data CMDS matches the
comparison value in the routing
Subsystem Description specifying program QSYS/QCMD.
QGPL/SBS1

Work Station Entry

WRKSTN JOBD

DSP01 USERLIB/
JOBD1

Routing Entry

SEQNBR CMPVAL PGM CLS MAXACT POOLID

QSYS/ QGPL/
10 CMDS QCMD QINTER *NOMAX 1

Routing Step User Profile JONES QSYS/QCMD is called for the routing
Checks step and checks the user profile
for Initial for an initial program.
Program
QSYS/QCMD INLPGM =
Runs USERLIB/ORDERS1

QSYS/QCMD calls the initial program

(USERLIB/ORDERS1).

USERLIB/ORDERS1
Runs

The display is presented by

USERLIB/ORDERS1.
First Display
after Sign-on
Option 1
ORDERS1

If ORDERS1 ends, the initial menu will

be displayed. This can be prevented
(if the user is only supposed to use
Initial ORDERS1) by specifying *SIGNOFF for
Menu INLMNU in the user’s profile.

RSLS862-3

Figure 17. Interactive Jobs, Calling User Program

Chapter 6. Interactive Jobs 163

 Route Based on User for Interactive Jobs
Figure 18 shows routing based on the user. In this example, the user library
USERLIB/ORDER1 is called.

DSP01 Job Description USERLIB/JOBD1 Smith signs on at work station DSP01.

Sign-on
Information The work station specifies *USRPRF for
Sign-On for SMITH USER = *RQD the job description. The job description
Display specified in user profile Smith has ORDS
for routing data.
RTGDTA = ORDS
The routing data ORDS matches the
comparison value in the routing entry
Subsystem Description specifying program USERLIB/ORDERS1.
QGPL/SBS1

Work Station Entry

User Profile Smith

WRKSTN JOBD
JOBD =
DSP01 *USRPRF USERLIB/JOBD1

Routing Entry

SEQNBR CMPVAL PGM CLS MAXACT POOLID

USERLIB/ QGPL/
10 ORDS *NOMAX 1
ORDERS1 QINTER

Routing Step USERLIB/ORDERS1 is called for the

USERLIB/ORDERS1 routing step.
Called Automatically
for User SMITH
USERLIB/ORDERS1
Runs

Initial USERLIB/ORDERS1 Display USERLIB/ORDERS1 displays its initial

First Display display.
after Sign-on

RSLS882-2

Figure 18. Interactive Jobs, Direct Routing to USERLIB/ORDERS1

Route Based on Workstation:

Figure 19 on page 165 shows routing based on the workstation. This scenario
shows how the workstation entry is used to specify a job description for routing
data. In this example, the user library USERLIB/ORDER1 is called.

164 OS/400 Work Management V4R4

 DSP01 Job Description USERLIB/JOBD2 A user signs on at work station DSP01.
Any Vaild
Sign-on The work station entry for DSP01
Information USER = *RQD contains the name of the job description
Sign-On
Display from which routing information is to be
obtained.
RTGDTA = ORD
The routing data ORD matches the
comparison value in the routing entry
Subsystem Description specifying program USERLIB/ORDERS1.
QGPL/SBS1

Work Station Entry

WRKSTN JOBD

DSP01 USERLIB/
JOBD2

Routing Entry

SEQNBR CMPVAL PGM CLS MAXACT POOLID

USERLIB/ QGPL/
30 ORD ORDERS1 QINTER *NOMAX 1

Routing Step USERLIB/ORDERS1 is called for the

USERLIB/ORDERS1 routing step.
Called Automatically
for Users of DSP01
USERLIB/ORDERS1
Runs

Initial USERLIB/ORDERS1 Display USERLIB/ORDERS1 displays its initial

display.
First Display
after Sign-on

RSLS863-1

Figure 19. Interactive Jobs, Direct Routing to USERLIB/ORDERS1

Which Program Should Control the Routing Step?

To determine the best approach for a particular job, you must first determine which
program should control the routing step.

Using QSYS/CMD for Interactive Jobs—Benefits

The IBM-supplied command processor QSYS/QCMD gives the greatest flexibility in
terms of making functions available to work station users. Using QCMD to control
the routing step gives you the following benefits:
v The attention program is activated if specified in the user profile.
v The initial program specified in the user profile is called.

Chapter 6. Interactive Jobs 165

 v The initial menu specified in the user profile is called.
v The user is placed in System/36 environment if specified in the user profile.

In addition, the default using QCMD brings you to the Main Menu where you can
enter commands directly, including the CALL command to call user-written
functions. Menu options with online help are provided to give easy access to
system functions. Also provided are command selection menus, quick access to
index search, and, if desired, the command entry function (called by CALL QCMD).
The command entry functions are intended primarily for programmers and operators
who require the full range of functions available through the direct use of
commands.

Calling a User Program Directly for Interactive Jobs—Benefits

Your programs can be directly called to control the routing steps for interactive jobs.
These programs can be designed to give a more specialized access to functions
needed by your workstation users than the IBM-supplied programs give. In addition,
because your programs are tailored for specific functions, they should typically
require even less system resource to support their running than the IBM-supplied
programs. You may want to provide functions such as an initial program and initial
menu also.

Should Routing Be Workstation- or User-Based?

After you have determined which program controls the routing step, you must
determine if routing is to be based on the workstation from which the job was
started, or on the user (user profile) who signed on. Routing based on the
workstation is accomplished using the routing data specified in the job description
associated with the workstation entry or profile for the device. Routing based on a
user can be done using the initial program specified in the user profile or the job
description in the user profile mapping to a routing entry other than QCMD.

Initial Program Uses

Initial programs may interact with workstations to get input values from a
workstation user. When an initial program is called, it cannot receive parameter
values.

An initial program can be used in one of two ways:

v To establish an initial environment for the user entering commands. For example,
the library list can be changed or print files and message files can be overridden.
When an initial program completes its function and returns to QSYS/QCMD, the
initial menu is displayed.
v As the controlling program for the job. If the initial program does not return to
QSYS/QCMD, it becomes the controlling program for the routing step. The initial
menu is not displayed. The user can only request those functions available
through the initial program.
For example, a menu could be displayed with specific application options. The
end user could only perform the functions on the menu. One of the options would
normally be sign off. If the SIGNOFF command is run, the job ends and the
system Main Menu is never displayed. If you use this approach, consider using
the user profile option INLMNU to ensure no menu is displayed.

An initial program can be written so that when a return is issued, it either does or
does not return to QSYS/QCMD. If the initial program returns to QSYS/QCMD, the

166 OS/400 Work Management V4R4

 initial menu is displayed. To avoid having QSYS/QCMD display the initial menu, the
value *SIGNOFF can be specified for the initial menu in the user profile.

Ending Interactive Jobs

You can end an interactive job in two ways:
v To end an interactive job immediately, use the Sign Off (SIGNOFF) command at
the workstation.
To end the connection through the network, use the end connection parameter
(ENDCNN) on the SIGNOFF command.
v To disconnect all jobs from a device, use the Disconnect Job (DSCJOB)
command.

Job Disconnecting
When the DSCJOB command is called, the job is disconnected and the sign-on
display is shown again. To connect with the job again, sign on to the same device
from which you disconnected. Another interactive job may be started on the device
under a different user name.
v An option on the System Request menu allows you to disconnect an interactive
job, causing the sign-on display to appear. The option calls the DSCJOB
command.
v When connecting with a job again, the values specified on the sign-on display for
program, menu, and current library are ignored.
v A job which has PC organizer or PC text assist function active cannot be
disconnected.
v A TCP/IP TELNET job can be disconnected if the session is using a named
device description. You can create a named device description using one of the
following ways:
– Using Network Stations with the DISPLAY NAME parameter
– Using Client Access support with the workstation ID function
– Using the TCP/IP TELNET Device Initialization exit point to specify a
workstation name.
v All jobs will be disconnected for group jobs. When they are connected again, you
return to the place where the disconnect was issued. If the last active group job
ends before you connect again, you return to the next group job.
v If the job cannot be disconnected for any reason, the job will be ended instead.
v All disconnected jobs in the subsystem end when the subsystem ends. If a
subsystem is ending, the DSCJOB command cannot be issued in any of the jobs
in the subsystem.
v The Disconnect Job Interval (QDSCJOBITV) system value can be used to
indicate a time interval for which a job can be disconnected. If the time interval is
reached, the disconnected job ends.
v Disconnected jobs that have not exceeded the QDSCJOBITV value end when
the subsystem is ended or when an IPL occurs.

I/O Error For Job’s Requester Device

The Device Recovery Action (DEVRCYACN) job attribute specifies what action to
take when an I/O error occurs for a job’s requester device. The DEVRCYACN
attribute has the following options:

Chapter 6. Interactive Jobs 167

 *SYSVAL
Default, points to the system value QDEVRCYACN. The system value will
support all of the values that the job attribute supports (except *SYSVAL).
*MSG Default for the system value. Signals the I/O error message and lets the
application program perform an error recovery.
*DSCMSG
Disconnect the job. Upon connecting again, a new error message signals
the user’s application program indicating the device was lost and recovered
since the I/O, and the contents of the display need to be shown again.
*DSCENDRQS
Disconnect the job. Upon connecting again, an end request function is
performed to return control of the job to the last request level (similar to
System/36 returning to the command processor).
*ENDJOB
End the job. A job log is produced for the job. A message is sent to the job
log and to the QHST log indicating the job ended because of the device
error.
*ENDJOBNOLIST
End the job. No job log is produced. A message is sent to the QHST log
indicating the job ended because of the device error.

Note: If *DSCENDRQS, *ENDJOB, or *ENDJOBNOLIST is specified for

DEVRCYACN, the recovery action takes effect when the error occurs on the
device. If one of the other values is specified, the recovery action takes
place at the next I/O to the device with the error.

Jobs Ending at the Same Time

When a job ends at the same time as another job, several less predictable actions
occur.

Sometimes, jobs end at the same time. For example, a remote line drops and the
job attributes for the jobs attached to that line are set to *ENDJOB or
*ENDJOBNOLIST. In addition to the job ending, the following actions occur.
v The job’s priority is lowered. This occurs so the job is no longer at the same
priority as other locally attached interactive jobs.
v The job’s time slice is set to 100 milliseconds. This occurs to give higher priority
jobs a better chance of getting processing resources.
v The job’s purge attribute is set to *YES to free up as much main storage as
possible for other jobs.

Automatically Ending Inactive Interactive Jobs

To end all of the interactive jobs associated with the workstation, or all jobs
associated with the group (if the job is a group job), use the ADLINTJOBS
parameter on the ENDJOB command. You can request the subsystem to send a
message to a message queue when an interactive job has been inactive for a
specified period of time. You, or a program monitoring that message queue, can
then end or disconnect the job if desired.

168 OS/400 Work Management V4R4

 Controlling Inactive Jobs
You can control the amount of time the workstation can remain inactive before the
subsystem sends a message (called time-out) by specifying a time interval in the
QINACTITV system value. At the end of the specified time interval, the subsystem
checks the interactive jobs running in it to determine whether any of the
workstations have been inactive for the entire interval. See “QINACTITV System
Value” on page 41 for a complete description of the system value QINACTITV.

Inactive Job Control—Benefits

Controlling inactive jobs provides security so that users do not leave signed-on
display stations inactive.

Inactive Workstation
A subsystem determines that a workstation is inactive if all of the following are true:
v The job has not processed any additional transactions during the time interval.
v The job status is display wait.
v The job is not disconnected.
v The job status has not changed.
v The subsystem in which the job is running is not in the restricted state.

Transaction
A transaction is defined as any operator interaction, like scrolling, pressing enter,
pressing function keys, and so on. Typing at the workstation without pressing enter
is not considered a transaction. If a job at the workstation, either secondary and/or
group job, does not meet the inactive criteria, the job is considered active.

Handling Inactive Jobs

To handle an inactive job found on the system, set the system value QINACTMSGQ
to determine the processing options. Choose from the following processing options:
v Set the system value QINACTMSGQ to a message queue name. If you specify a
message queue name for QINACTMSGQ, a user or program can monitor the
message queue and take whatever action is necessary, such as ending the job.
| v Set the system value QINACTMSGQ to *DSCJOB. If you specify *DSCJOB for
| QINACTMSGQ, the system disconnects all jobs at the workstation (both group
| and secondary jobs). The system sends a message that indicates that all jobs at
| the workstation have ended to QSYSOPR or the configured message queue. If
| the interactive job does not support disconnecting the job (for example, TELNET
| sessions that use QPADEVxxxx device descriptions), the job ends instead.
| If a workstation with a secondary job pair is inactive, the system sends two
| messages (one for each of the secondary job pairs) to the message queue. The
| user or program can then use either the ENDJOB command against one or both
| secondary jobs, or the DSCJOB command against the active job at the display.
| If an inactive job has one or more group jobs, the system sends a single
| message to each of the message queues. (The message queue indicates
| whether or not the job is a group job.)
| A message continues to be sent for each interval that the job is inactive.

Chapter 6. Interactive Jobs 169

| v Set the system value QINACTMSGQ to *ENDJOB. If you specify *ENDJOB for
| QINACTMSGQ, the system ends all of the jobs at the workstation (both group
| and secondary jobs). The system sends a message that indicates that all jobs at
| the workstation have ended to QSYSOPR or the configured message queue.

Note: Source pass-through jobs, client VTM (virtual terminal manager) jobs, and
3270 device emulation jobs are excluded from the time-out because they
always appear inactive. System/36 environment MRT jobs are also excluded
since they appear as batch jobs.

Avoiding a Long-Running Function from a Workstation

To avoid a long-running function (such as save/restore) from a workstation without
tying it up, the system operator can submit the job to a job queue.

The controlling subsystem description QSYS/QBATCH or QSYS/QBASE, which is

supplied by IBM, has a job queue QSYS/QBATCH that can be used for this
purpose. If you created your own controlling subsystem, you should refer to the job
queue for that subsystem. The system operator can submit the commands from the
system operator menu.

Submitting a Long-Running Command—Example

The following is an example of submitting a long-running command:
| SBMJOB JOB(SAVELIBX) JOBD(QBATCH) JOBQ(QSYS/QBATCH)
| CMD(SAVLIB LIBX DEV(DKT01))

170 OS/400 Work Management V4R4

Chapter 7. Group Jobs
Group job support allows a user to start up to 32 interactive jobs at one workstation.
At any one time, only one group job can be active; the others are suspended. The
group jobs are similar to secondary interactive jobs requested by pressing the
System Request key; however, up to 16 group jobs can be started for each sign on
at a workstation (32 total when there is a secondary interactive job) and the
application program can handle interruptions more easily.

Group Jobs Starting from a Workstation

Group jobs can be started from a workstation. Figure 20 illustrates this.

Group Job 16

Group Job ...

Group Job 2

CHGGRPA Group Job 1

Nongroup Command
Interactive
Job

Display
Station

RV2W253-1

Figure 20. Group Jobs Starting from a Workstation

Group Job—Benefits
The major benefits of group jobs are the following:
v The workstation user can press the Attention key to interrupt work in one
interactive group job, change to any of several other interactive group jobs, and
return to the original group job quickly.
The Attention key is made valid by the Set Attention Program (SETATNPGM)
command and can be used independently of group jobs.
v Group jobs can give a significant performance advantage over alternative
methods. If an Attention-key-handling menu is used to handle normal
interruptions, the environment for processing these interruptions can be built on
first use and then suspended. When a request is repeated, the function can be
called with all files open and the proper display shown. This allows the process
access group (PAG) for each function to be a minimum size, and the workstation
user does not have to exit a function to get to a menu from which to select
another function.
v Using group jobs with display station pass-through provides a convenient and
fast way to change among many interactive jobs on many different systems in a
network. See the Remote Work Station Support book for more information on
display station pass-through.

© Copyright IBM Corp. 1997, 1999 171

Group Job Concepts
v Group jobs apply only to interactive jobs.
v Up to 16 group jobs can exist in one group (16 more are available if the user
transfers to a secondary interactive job).
v Group jobs are unique to a user (they are not shared by multiple users).
v Only one group job at a time is active (the others are suspended).
v Each group job is independent and has its own job log, spooled files, library
QTEMP, and so forth.
v A group job is called by the Transfer to Group Job (TFRGRPJOB) command.
This command is typically run from a user-written menu program, which is called
by pressing the Attention key (the SETATNPGM command must have been
previously run).
v A 512-byte group data area can be used to pass data between one group job
and another. This group data area is implicitly created by the Change Group
Attributes (CHGGRPA) command. The CL Programming book contains more
information on group data areas.

Changing to and from a Group Job

To change a nongroup job to a group job and to change a group job back to a
nongroup job (if it is the only job in the group), use the Change Group Attributes
(CHGGRPA) command.

Creating a New Group Job

To create a new group job, use the Transfer Group Job (TFRGRPJOB) command.

Note: After each use of the TFRGRPJOB command, the SETATNPGM command
must be used to set the Attention key on, if desired.

Transferring from One Group Job to Another

To transfer from one group job to another group job in the same group, use the
Transfer Group Job (TFRGRPJOB) command.
Notes:
1. After each use of the TFRGRPJOB command, the SETATNPGM command
must be used to set the Attention key on, if desired.
2. If you are in an update operation, use the Check Record Lock (CHKRCDLCK)
command to check if the job has any record locks before transferring to another
group job.

Transferring Control from One Group Job to Another

You can easily transfer control from one group job to another if you have an
Attention-key handling program. When the Attention key is pressed, an
Attention-key-handling program can either present a menu (from which the user
chooses a group job) or immediately transfer the user to another group job.
Attention-key-handling support makes it easy to transfer control from one group job
to another quickly, without ending one job to go to the other.

172 OS/400 Work Management V4R4

Transferring to Another Group Job without Seeing a Menu
You can use the Attention key to transfer directly to another job without seeing a
menu. For example, the Attention-key-handling program for group job A could
transfer to group job B. The Attention-key-handling program for group job B could
transfer back to group job A. This allows a single keystroke to be used to switch
between functions.

For more information, see “Attention-Key-Handling Programs—Coding Tips” on

page 182.

Ending a Group Job

v To end one group job in a group, use the End Group Job (ENDGRPJOB)
command.
v To end all group jobs in the group, use the SIGNOFF command.

Note: The ENDJOB command supports the parameter ADLINTJOBS. If *GRPJOB

is specified and the job specified on the JOB parameter is a group job, all
jobs associated with the group end.

Ensuring a Normal Group Job End

In some environments it may be desirable to force the end user to correctly end
certain group jobs rather than issuing the ENDGRPJOB command. For example,
assume that the user may have a group job where there is a complex update
involved and you want to be sure the job is ended normally. Another example is
where the user may be in the middle of a SEU session and should complete the
function normally.

It is possible to achieve this with the support given by the system. For example, you
could do the following:
1. Set a switch in the group data area that could be tested by each of the group
jobs to function as the shutdown switch. That is, when the switch is set on, the
group jobs function should be ended.
2. Access the active group job names by using the RTVGRPA command and the
GRPJOBL return variable.
3. Compare each name accessed (start with the second group job) against a
predetermined list of the group job names that should be correctly ended.
4. If the group job name is not in the list, it can be ended immediately by the
ENDGRPJOB command.
5. If the job must be correctly ended, transfer to the group job using the
TFRGRPJOB command.
The Attention-key-handling program for all group jobs would have to be sensitive to
the shutdown switch and would prevent transferring to another group job if the
switch is set on.

If you have a controlling program for each of the group jobs that controls what
happens when the user ends the function of the group job (for example, the update
program), it could also test the shutdown switch and do a return. This ends the
group job and returns control to the previous active group job.

Chapter 7. Group Jobs 173

 The Attention-key-handling program can use the CHKRCDLCK command to
determine if the workstation user pressed the Attention key when the application
had a record locked for update. In this case, the attention program may send a
message instructing the user to complete the operation before using the Attention
key.

Group Job Theory

The CHGGRPA command identifies the current job as a group job and gives it a
group job name to uniquely identify it in the group. (At this point the group has only
one group job.) Each group job is unique for a user. Two different users do not
share the same group job. When a job is designated as a group job, it then has the
capability to call a new group job. There are also restrictions on group jobs (such as
RRTJOB, TFRJOB may not be used). When there is only one active job in the
group, that job can become a nongroup job.

Allowing Group Jobs to Communicate

To allow group jobs to communicate with each other, a special 512-byte data area
called a group data area is automatically created when a job becomes a group job.
The group data area can only be accessed by jobs in the group by using the
special value *GDA in the DTAARA parameter of the data area command.

Calling a Group Job

The use of group jobs does not require an Attention-key-menu approach as
described in this section. A group job can be called from any application program or
by the GRPJOB(*SELECT) parameter on the TFRGRPJOB command.

Group Jobs and a Secondary Interactive Job

Figure 21 on page 175 shows the relationship of group jobs to a secondary
interactive job.

In this case, the CHGGRPA command is run twice, once for each interactive job.

174 OS/400 Work Management V4R4

 System Request Option 1
or TFRSECJOB Command

Group Job 16 Group Job 16

Group Job ... Group Job ...

Group Job 2 Group Job 2

Group Job 1 Group Job 1

Display
Station

RV2W254-1

Figure 21. Group Jobs and a Secondary Interactive Job

Group Job and System Request Function

The Group Job function is similar to the System Request function in that there is
only one job active at a time while the others are suspended. Group jobs differ from
system request in the following ways:
v Starting a group job does not require signing on. The same user profile and
environment are used.
v Up to 16 group jobs can exist at any one time. The user must select which group
job to transfer to, whereas using system request permits the user to transfer
between only two jobs. Normally in group jobs, a menu reached by pressing the
Attention key allows the user to select which group job to transfer to. It is
possible to use group jobs together with system request for a total of 32 group
jobs available for a single user. However, these 32 jobs are in two separate
groups, each group having its own group data area and other group attributes.
v The System Request function allows the workstation user to suspend a job while
the keyboard is locked and application functions are in progress. This can
interrupt a logical sequence of events. For example, records may be left locked.
In contrast, the Attention key is active only when the keyboard is unlocked for
input. Also, the application can control when the Attention key is active, and
prevent its use at inappropriate times. The System Request function is always
available if the workstation user has authority to it.

Note: The Presystem Request Program exit program is called when the user
presses the System Request Key. The operating system calls the
user-written exit program through the registration facility when the user
presses the System Request key. One parameter is used for input and
output. After the exit programs from the registration facility are called, the
System Request menu is called based on the value that is returned in the
System Request menu display flag. For additional information, see the
System API Reference.

Chapter 7. Group Jobs 175

Group Jobs Application Scenario
To understand the group job concept, consider this scenario. Assume a workstation
user is shown a Main Menu with the following options:
MAIN MENU

1. Post cash
2. Inquire into customer master file
3. Inquire into accounts receivable file

Option: __

F12=Cancel

The workstation user selects option 1 (Post cash) to start entering payments into
the file. While the workstation user is entering data, he receives a telephone call
requesting information that can be answered using option 2 (Inquire into customer
master file).

Such an interruption can be handled in several ways:

v Have the workstation user end the Post cash function, return to the Main Menu,
and select the Inquiry function. When done with the inquiry, the workstation user
returns to the Main Menu, selects the Post cash function and continues. This
requires system interactions each time the workstation user selects a different
function and may require additional system resources for opening and closing
files.
v Code the inquiry function as part of the Post cash function. This method is
usually done by specifying that a command function key be enabled to request
the inquiry. This can be awkward if the same Inquiry function must be accessed
from multiple programs.
v Press the System Request key and start a secondary interactive job. This can be
a good solution if the workstation user uses only one function during an
interruption. However, if several functions are used, this solution can become
awkward.
v Use the group job approach as shown in Figure 22 on page 179.

Inquire Master Customer File

If the workstation user wants to inquire into the customer master file again, the user
would again press the Attention key and receive the attention handling menu.
Because the group job would already be active, the system would resume the job
where it was suspended (that is, at the instruction following the TFRGRPJOB
command in step 14). This return causes a return to the CUSINQ program where it
was interrupted when the workstation user pressed the Attention key in step 12.

176 OS/400 Work Management V4R4

 Inquire Accounts Receivable File

If the workstation user wants to inquire into the accounts receivable file, the same
set of steps occurs. However, the workstation user does not have to return to the
post cash function first. The attention handling menu allows him to select any of the
functions in any sequence. Note that the workstation user cannot start two group
jobs with the same group job name. If the job specified a group job name that is
already active, control is passed to that job (no new group job is started) and the
initial group program parameter is ignored. It is also possible to have several group
jobs (having unique names) all doing the same function.

Group Job Approach

The following steps illustrate how the sample application works:
„1… The Change Group Attributes (CHGGRPA) command changes the current
nongroup interactive job to a group job named CASH.
„2… The Set Attention Program (SETATNPGM) command specifies that the
system should recognize the Attention key and call the ATTNPGM program
when the Attention key is pressed.
„3… The SNDRCVF command displays a menu from which the workstation user
selects functions to work on. In this case, the workstation user selects
option 1 (Post cash).
„4… The main program calls the POSTCASH program, and the workstation user
starts posting cash transactions.

Note: The main program runs a CALL command to the post cash program
and a TFRGRPJOB command to the other functions. This allows the
main job to always be known as CASH, but other techniques can be
used. If the workstation user chooses to end one of the group jobs
other than CASH (instead of pressing the Attention key to suspend
it), the system automatically returns to the previously active group
job.
„5… To change from posting cash, the workstation user presses the Attention
key. The system saves the current contents of the display and calls the
Attention-key-handling program (ATTNPGM).
„6… The Attention-key-handling program (ATTNPGM) is written to be used by
any of the jobs in this group. The program retrieves the current group job
name using the Retrieve Group Attributes (RTVGRPA) command.
„7… The Attention-key-handling program displays a menu from which the
workstation user can select a function. The menu can contain any options,
but in this example, the options are the same as those shown on the Main
Menu. The workstation user selects option 2 (Inquire into customer master
file).
„8… If the option is for the current group job (for option 2 this is CUSINQ), the
program returns to the current group job. For example, assume the operator
posting cash pressed the Attention key, then decided not to change group
jobs and continue posting cash. Instead of transferring to a group job, only
the RETURN command is needed.
„9… If the option is for a different group job, the program runs a TFRGRPJOB
command to suspend the current job and activate a new group job and

Chapter 7. Group Jobs 177

 program. For option 2, the TFRGRPJOB command specifies the name of
the group job to be started (in this example, CUSINQ), and which program
to call (CUSINQC program).
„10… The group job CUSINQ is activated and the initial group program
(CUSINQC) is called. The job has already been identified as a group job by
the TFRGRPJOB command; therefore the CHGGRPA command is not
needed. This group job also uses the SETATNPGM command to allow for
an interruption. The same program (ATTNPGM) is used, but it runs in a
different group job.
„11… The workstation user inquires into the customer master file and is now
ready to return to the post cash function.
„12… The workstation user again presses the Attention key. The system saves
the current contents of the display and calls the Attention-key-handling
program (ATTNPGM). The user sees the same Attention Handling menu,
but is in a different group job.
„13… The workstation user selects option 1 (Post cash).
„14… Because the name of the current group job is CUSINQ (not CASH), the
TFRGRPJOB command is run to transfer to the CASH group job.
„15… In this instance, the group job is already active but suspended; therefore
the system resumes the suspended group job. The ATTNPGM program is
continued at the next instruction following the TFRGRPJOB command that
was run in step 9. This causes a return to the POSTCASH program.
„16… The previous display (which the system saved when the workstation user
pressed the Attention key in step 5) is restored, and the workstation user
continues posting cash transactions where he left off.

For a graphic of the preceding process description, see Figure 22 on page 179.

178 OS/400 Work Management V4R4

 Main Program

CHGGRPA GRPJOB(CASH)
SETATNPGM PGM(ATTNPGM) 1. Post Cash
2. Inq Cust
SNDRCVF
3. Inq A/R
Option 1
IF (&OPTION *EQ 1)
CALL POSTCASH
.
.
POSTCASH Program
IF (&OPTION *EQ 3)
TFRGRPJOB Post
GRPJOB(ARINQ) Cash
INLGRPPGM(ARINQC)
Attention
Key

ATTNPGM Program

RTVGRPA GRPJOB(&GRP)
1. Post Cash
SNDRCVF
2. Inq Cust
. 3. Inq A/R
. Option 2
IF (&OPTION *EQ 2) DO
IF (&GRP *EQ ’CUSINQ’)
RETURN
ELSE TFRGRPJOB
GRPJOB(CUSINQ)
INLGRPPGM(CUSINQC)
RETURN
ENDDO
Group Job CASH

Group Job CUSINQ CUSINQC Program

SETATNPGM PGM(ATTNPGM)
CALL CUSINQ

CUSINQ Program

Customer
Master
Inquiry
Attention
ATTNPGM Program Key

RTVGRPA GRPNAM(&GRP)
SNDRCVF
1. Post Cash
2. Inq Cust
Option 1 3. Inq A/R
IF (&OPTION *EQ 1) DO
IF (&GRP *EQ ’CASH’)
RETURN
ELSE TFRGRPJOB
GRPJOB(CASH)
RETURN
ENDDO
RV2W255-0

Figure 22. Group Job Approach

Chapter 7. Group Jobs 179

Attention-Key-Handling Program
You can identify a program as the Attention-key-handling program at a particular call
level. The Attention-key-handling program runs in the same job and has the same
job attributes, overrides, and group authorities as the program that issued the
SETATNPGM command. However, program-adopted authority does not originate
from the program that was interrupted. You may also specify an
Attention-key-handling program in the user profile.

The Security - Reference book contains information on this.

Identifying a Program as Attention-Key-Handling

To identify a program as the Attention-key-handling program, use the Set Attention
Program (SETATNPGM) command with SET(*ON) specified. This command
identifies this program at that call level in the job running the command. When the
Attention key is pressed, the running job is interrupted, the display is saved, and the
Attention-key-handling program is called. No parameters are passed to the
Attention-key-handling program when it is called.

Note: The Preattention Program exit program is called when the user presses the
System Attention key. The operating system calls the user-written exit
program through the registration facility when the user presses the System
Attention key. There are no input or output parameters. After the exit
programs from the registration facility are called, the system attention
program is called. For detailed information, see theSystem API Reference .

Effect of Call Level on Attention Key Status

The SETATNPGM command is call-oriented. That is, a SETATNPGM command
issued at one call level causes the Attention-key-handling program to be in effect at
the current call level as well as lower call levels, until another SETATNPGM
command is run to change the Attention-key-handling program or Attention key
status. Whenever a program that issued a SETATNPGM command returns, the
display is restored and the Attention-key-handling program and Attention key status
are reset to what they were before the current call. If a Transfer Control (TRFCTL)
command is used instead of a RETURN command, the status is not reset until the
program that was transferred to returns.

SETATNPGM at Different Call Levels—Scenario

Assume three programs (PGM1, PGM2, and PGM3). The Set Attention Key
Program (SETATNPGM) command works at different call levels.
„1… PGM1 issues a SETATNPGM command which causes program A to
become the Attention-key-handling program.
„2… PGM1 then calls PGM2. Program A continues to be the
Attention-key-handling program until step 3.
„3… Another SETATNPGM command causes program B to become the current
Attention-key-handling program.
„4… After returning from PGM2, program A again becomes the
Attention-key-handling program.
„5… PGM1 calls PGM3.

180 OS/400 Work Management V4R4

 „6… The first SETATNPGM command issued in PGM3 changes the
Attention-key-handling program from program A to program C.
„7… The second SETATNPGM command issued in PGM3 changes the
Attention-key-handling program to program D.
„8… Specifying SETATNPGM PGM(*CURRENT) SET(*OFF) causes no program
to be called when the Attention key is pressed. This allows the program to
complete a series of interactions with the workstation user without being
interrupted by the Attention key.
„9… Specifying SETATNPGM PGM(*CURRENT) SET(*ON) causes program D to
be called when the Attention key is pressed.
„10… The Attention-key-handling program that was in effect at the previous
recursion level goes into effect. That is, program A becomes the
Attention-key-handling program again and the Attention key is set to *ON.
„11… When PGM3 returns, program A continues to be the Attention-key-handling
program.

For a graphic presentation of the preceding process, see Figure 23.

┌───────────────────┐
│ PGM1 │
1. │ SETATNPGM PGM(A) │ ┌──────────────────────────┐
2. │ CALLPGM2 ───────────────────────Ê │PGM2 │
│ . Í──────────────┐ 3. │SETATNPGM PGM(B) │
│ . │ │ │. │
│ . │ │ │. │
│ . │ │ │. │
│ │ │ │. │
5. │ CALLPGM3 ────────┼────┐ │ 4. . │. │
│ . │ │ │ │ │
│ . Í───────┼───┐│ └───────────┤RETURN │
│ . │ ││ └──────────────────────────┘
│ . │ ││
└───────────────────┘ ││ ┌──────────────────────────┐
│└────────────Ê│PGM3 │
│ 6. │SETATNPGM PGM(C) │
│ │. │
│ │. │
│ 7. │SETATNPGM PGM(D) │
│ │. │
│ │. │
│ 8. │SETATNPGM PGM(*CURRENT)+ │
│ │ SET(OFF) │
│ │. │
│ │. │
│ 9. │SETATNPGM PGM(*CURRENT)+ │
│ │ SET(*ON) │
│ │. │
│ │. │
│ 10. │SETATNPGM PGM(*PRVINVLVL) │
│ │. │
│ 11. │. │
└───────────── │RETURN │
└──────────────────────────┘

Figure 23. SETATNPGM at Different Call Levels

When to Use the Attention Key

Use the Attention key to call an Attention-key-handling program.

In normal workstation use, the Attention key can be pressed only when the
keyboard is unlocked; that is, the program is ready for input. This occurs when a

Chapter 7. Group Jobs 181

 read or write-read operation is issued or the UNLOCK DDS keyword is used in a
write operation. The use of the Attention key differs from that of the System
Request key in that the application program has control over when it can be
interrupted.

Exception
An exception to this occurs with application programs performing a get-no-wait
operation on multiple device files. Pressing the Attention key causes these
programs to be interrupted at any point by the Attention-key-handling program.
(Even though the input inhibited light may be on, the keyboard is unlocked during a
get-no-wait operation.) Application programs performing sensitive functions
(especially during a get-no-wait operation) should therefore be protected by running
SETATNPGM PGM(*CURRENT) SET(*OFF) before and SETATNPGM
PGM(*CURRENT) SET(*ON) after sensitive code.

Note: A high-level language program can use the SETATNPGM command by

calling QCMDEXC.

When Not to Use the Attention Key

The Attention key cannot be used to call an Attention-key-handling program when
the following conditions exist:
v The keyboard is locked. (Note the exception described earlier for get-no-wait
operations.)
v The System Request menu or any of its options is being used.
v The display message display is shown.
v The OS/400 licensed program is already calling the Attention-key-handling
program that makes it already active; however, if the program issues another
SETATNPGM, the Attention key is enabled.
v A BASIC session is in progress, or a BASIC program is called.

Attention Key and BASIC Session

In a BASIC session, the Attention key is handled by BASIC, as appropriate. For
example, if a BASIC program is called after a SETATNPGM command has set the
Attention key on, the Attention key is handled by BASIC. After the BASIC program
ends, your Attention-key-handling program takes effect again.

Attention-Key-Handling Programs—Coding Tips

Caution is necessary when defining an Attention-key-handling program because the
Attention-key-handling program runs in the same job as the program that is in
progress when the Attention key is pressed. Therefore, the interrupted program is
not protected by any locks it held. If the interrupted program has an exclusive lock
on an object, the Attention key program, because it runs in the same job, is part of
the job that has the exclusive lock.

The following guidelines are recommended for defining Attention-key-handling

programs:
v Use simple functions such as menus that allow the workstation user to transfer to
another group job or to a secondary interactive job.

182 OS/400 Work Management V4R4

 v Avoid referring to objects or functions that may be in use when the Attention key
is pressed.
v Avoid calling nonrecursive functions when the Attention key is pressed.
Nonrecursive functions are functions that cannot be interrupted, then called
again. Many functions, such as high-level language programs and utilities like
DFU, are nonrecursive.
v Avoid giving an option that allows the workstation user to display the command
entry display as part of the current job. For users who are programmers, it is
meaningful to display a menu that includes an option for the command entry
display. The command entry display should be specified as a separate group job
(for example, by specifying INLGRPPGM(QCMD) on the TFRGRPJOB
command). This avoids re-using objects already in use.
v Attention-key-handling programs do not have the authority adopted by the
program that was in progress before the Attention key was pressed.
v Attention-key-handling programs do not have their own data area (*LDA). Since
there is only one local data area per job, and the Attention-key-handling program
runs in the same job as the interrupted program, both programs share the same
local data area.
v Be aware that a read-from-invited devices operation could time-out during the
time that the Attention-key-handling program is running. Therefore, if a time-out
were to complete in the program in progress while the Attention-key-handling
program is running, whatever action taken as a result of that time-out occurs on
return to the program in progress.
For example, if the following conditions are met the program will exit on return
from the Attention key handler:
– The WAITRCD value in the file is set to 60 seconds.
– The program is set to exit if a key is not pressed in one minute.
– The Attention key program is called and runs longer than that minute.

However, caution should be used, since a check for available data is made
before checking that the time-out has completed. If a key is pressed immediately
after leaving the Attention key handler, data could be available that could
complete the read-from-invited devices and the time-out would not be checked.
This could cause unexpected results.

Group Job Performance Tips

v Using process access groups (PAGs) with group jobs has performance
advantages. Each group job (active or suspended) requires approximately 1KB of
dedicated main storage in the machine pool. Thus, the number of group jobs that
are allowed to be active is a consideration. However, if main storage is not
limited, this may be a good way to gain the benefits of separate process access
groups (PAGs). This also allows you to avoid the overhead caused by repetitive
opening of files and reestablishing environments, and to avoid excessive
interactions to access common functions.
See also “Process Access Groups” on page 264.
v The effect on the system for a large number of suspended jobs is normally small
if the dedicated main storage requirement is not a factor.
v When a TFRGRPJOB command runs and a new job must be started, the
overhead involved is roughly the same as signing on to the system. When the
command is run and the group job is already started, the overhead required is
roughly the same as using the transfer to a secondary job option on the System
Request menu when the secondary job is already active.

Chapter 7. Group Jobs 183

 v If a group job is to be run with any frequency, it is desirable to prevent it from
ending. That is, do not end the program, but issue a TFRGRPJOB command to
prevent job starting each time the group job function is needed.
v The SETATNPGM command causes the current display to be saved when the
Attention key is pressed, and to be restored when the Attention
key-handling-program ends. This is roughly the same as using of the System
Request menu and has a more noticeable effect on remote workstations.
v The controls on the number of jobs active in the system (the MAXJOBS
parameter on the CRTSBSD command) are not affected by the number of group
jobs active at any time.
v All system values that control the creation of job structures (QACTJOB and
QADLACTJ, and QTOTJOB and QADLTOTJ) are affected; these values may
need to be increased to allow for the addition of group jobs.

Designing an Attention-Key-Handling Program

You can use three approaches to designing an Attention-key-handling menu:
v See “Fixed Menu Approach”. The Attention-key-handling program allows only a
fixed set of options.
v See “Dynamic Menu Approach” on page 188. The workstation user determines
the options.
v See “Combination (Fixed and Dynamic) Menu Approach” on page 189. The
workstation user selects from a fixed set of options and can dynamically select
additional group jobs.

Note: The use of group jobs does not require an Attention-key-menu approach as
described in this section. A group job can be called from any application
program or by the GRPJOB(*SELECT) parameter on the TFRGRPJOB
command.

Fixed Menu Approach

In the fixed menu approach to designing an Attention-key-handling program, the
user can only select from the options on the menu.

Displaying a Menu—Coding Example

A menu is displayed to the workstation user with the following options:

184 OS/400 Work Management V4R4

 MAIN MENU

1. Post cash
2. Inquire into customer master file
3. Inquire into accounts receivable file

Option: __

F12=Cancel

The program that displays the menu is coded as follows:

PGM /* First program */

DCLF MAIND
CHGGRPA GRPJOB(CASH) TEXT('Post cash')
SETATNPGM PGM(ATTNPGM)
LOOP: SNDRCVF
IF (&IN91 *EQ '1') RETURN /* F12 */
IF (&OPTION *EQ 1) CALL POSTCASH
IF (&OPTION *EQ 2)
TFRGRPJOB GRPJOB(CUSINQ) +
INLGRPPGM(CUSINQC) +
TEXT('Customer inquiry')
IF (&OPTION *EQ 3) TFRGRPJOB GRPJOB(ACRINQ) +
INLGRPPGM(ACRINQC) +
TEXT('Accounts Receivable inquiry')
GOTO LOOP
ENDPGM

Figure 24. Display a Menu

In the example in Figure 24, the CHGGRPA command changes the current job into
a group job. The SETATNPGM command specifies that the Attention key is allowed,
and it specifies the Attention-key-handling program to be called (ATTNPGM).
Because this program displays a menu, it is called an Attention-key-menu program.
If the workstation user selects option 1 (Post cash), the program POSTCASH is
called.

If another option is specified, a TFRGRPJOB command, which names the group

job, is used. The system determines if the group job already exists. If it does not,
the group job is started and the initial group program is used. If the group job
already exists, the system transfers to that group job at the point where it was
previously suspended. That is, it transfers to the next instruction following the
TFRGRPJOB command that caused a transfer back to the CASH group job. The
program loops back to the SNDRCVF command to redisplay the menu if control is
ever transferred back to CASH.

Chapter 7. Group Jobs 185

 Attention-Key-Menu Program and Examples
When the workstation user presses the Attention key, the Attention-key-menu
program (ATTNPGM) is called. The display may differ from the initial menu, but in
this example, the displays have the same options. Only the title differs to help the
user identify the functions being used.
ATTENTION KEY MENU

1. Post cash
2. Inquire into customer master file
3. Inquire into accounts receivable file

__ Option

F12=Cancel

Figure 25 on page 187 shows how the Attention-key-menu program (ATTNPGM) is

coded.

186 OS/400 Work Management V4R4

PGM /* Attention-key-menu program */
DCLF ATTNMNUD
DCL &GRP *CHAR LEN(10)
CHKRCDLCK
MONMSG MSGID(CPF321F) EXEC(DO)
SNDPGMMSG MSG('Attention not allowed. +
Complete transaction')
RETURN
ENDDO
RTVGRPA GRPJOB(&GRP); /* Retrieve +
group name */
SNDRCVF
IF (&IN91 *EQ '1') RETURN /* F12 */
IF (&OPTION *EQ 1) DO /* Post cash */
IF (&GRP *EQ 'CASH') RETURN
ELSE TFRGRPJOB GRPJOB(CASH)
ENDDO
IF (&OPTION *EQ 2) DO /* Cust inquiry */
IF (&GRP *EQ 'CUSINQ') RETURN
ELSE TFRGRPJOB GRPJOB(CUSINQ) +
INLGRPPGM(CUSINQC) +
TEXT('Customer inquiry')
ENDDO
IF (&OPTION *EQ 3) DO /* Acct rec inquiry */
IF (&GRP *EQ 'ACRINQ') RETURN
ELSE TFRGRPJOB GRPJOB(ACRINQ) +
INLGRPPGM(ACRINQC) +
TEXT('Accounts Receivable inquiry')
ENDDO
ENDPGM

Figure 25. Attention-Key-Menu Program

The Attention-key-menu program may differ for any group job, but in this case the
same program is used for all group jobs. Because the workstation user may press
the Attention key, and then request the same function that was interrupted, the
program retrieves the current group job name and compares it to the group job
name for the option that was selected. If they are the same, a RETURN command
is issued. This means that the workstation user was in a function, pressed the
Attention key, then decided to continue the function. If the names differ, the
workstation user is requesting a different group job and the TFRGRPJOB command
is used. The system determines if the group job is already active; if it is not, the
system starts the group job and calls the initial program. If the group job is already
active, the system transfers to where it left off. Note that the CASH group job was
originally made active and therefore the INLGRPPGM parameter is not needed.

When a group job is started, the system automatically establishes much of the
environment by using the attributes from the transferring group job. Thus functions
such as the library list and the logging level need not be set if the same values are
desired. If however, the new group job also requires the use of the Attention key, it
must be specified on a SETATNPGM command. For example, the initial program for
the CUSINQ group job is CUSINQC as shown in Figure 26.

PGM /* CUSINQC program */

SETATNPGM PGM(ATTNPGM)
CALL CUSINQ
ENDPGM

Figure 26. CUSINQC Example Program

Chapter 7. Group Jobs 187

 In the previous example, the same Attention-key-menu program is specified and
then the processing program (CUSINQ) is called. If the workstation user ends the
CUSINQ program, the CUSINQC program also ends, and the system automatically
ends the group job and transfers back to the group job that was previously active. It
would be possible to issue a TFRGRPJOB GRPJOB(*PRV) after the CALL and
then a GOTO to repeat the CALL command. This will keep the group job in a
suspended state. This decreases the time necessary to transfer to this job on the
next call of the CUSINQ option.

Dynamic Menu Approach

In this case the Attention-key-menu program runs the TFRGRPJOB command with
GRPJOB(*SELECT) specified. This provides a display of the current group jobs and
allows the workstation user to transfer to any group job. Thus the workstation user
can decide what functions are needed. This approach can be useful for
programmers because it allows them to call several group jobs and to specify what
command should be run.

For example, assume that the workstation user specifies the following commands or
runs them as part of a standard setup program:
CHGGRPA GRPJOB(NORMAL) TEXT('Normal job')
SETATNPGM PGM(MENU1)

Program MENU1 would be coded as:

PGM
TFRGRPJOB GRPJOB(*SELECT)
ENDPGM

Assume the workstation user is working in the CASH group job, with two other
group jobs suspended. If the workstation user presses the Attention key, the
Transfer to Group Job display appears as follows:
Transfer to Group Job
System: XXXXXXXX
Active group job . . . . : CASH
Text . . . . . . . . . . : Post cash

Type option, press Enter.

1=Transfer group job

------------------Suspended Group Jobs-------------------------

Opt Group Job Text
_ ACRINQ Accounts receivable inquiry
_ CUSINQ Customer inquiry

Bottom
F3=Exit F5=Refresh F6=Start a new group job F12=Cancel

The workstation user could then press the F6 key to enter a TFRGRPJOB
command with prompting. When the TFRGRPJOB prompt is displayed, the
workstation user could specify a GRPJOB parameter value and either of the
following for the INLGRPPGM parameter:

188 OS/400 Work Management V4R4

 v QCMD, that would display the initial menu.
v A standard program that would build the environment the workstation user wants
and specify the same Attention-key-handling program. For example, assume the
workstation user specified the command:
TFRGRPJOB GRPJOB(PGMMNU) INLGRPPGM(PGMMNUC)
TEXT('Programmer Menu')

The PGMMNUC program could be coded as follows:

SETATNPGM PGM(MENU1)
STRPGMMNU .....

The workstation user can now use the programmer menu. If the Attention key is
pressed again, the display would show:
Transfer to Group Job
System: XXXXXXXX
Active group job . . . . : PGMMNU
Text . . . . . . . . . . : Programmer menu

Type option, press Enter.

1=Transfer group job

------------------Suspended Group Jobs-------------------------

Opt Group Job Text
_ CASH Post cash
_ ACRINQ Accounts receivable inquiry
_ CUSINQ Customer inquiry

F3=Exit F5=Refresh F6=Start a new group job F12=Cancel

On this display, the jobs are shown in the order they were called.

Thus each group job that is already started can be easily called again, and the
workstation user can continue to add group jobs as required.

Combination (Fixed and Dynamic) Menu Approach

This approach allows the following variations:
v The workstation user can select from a fixed set of menu options. One option
allows the workstation user to prompt for the TFRGRPJOB command. The user
could then specify the group job required or could specify GRPJOB(*SELECT) to
receive a display of the currently active group jobs. If a user-written menu is
displayed, an input field on the menu for the group job name could also be
considered. A modification of this is for the Attention-key-menu program to extract
the active group jobs using RTVGRPA command and dynamically build the menu
choices (including the standard choices).
v The workstation user can select a menu option to activate a standard set of
group jobs. Then, when the user presses the Attention key, the Attention key
program runs the TFRGRPJOB command with GRPJOB(*SELECT) specified.
This would display all the standard programs and allow the user to add group
jobs.

Chapter 7. Group Jobs 189

 The following section illustrates the second variation.

Group Job Approach for Programmers

You may want to set up several standard group jobs that are activated at sign-on.
You can add additional group jobs if necessary. In Table 24, you have the following
standard group jobs.
Table 24. Standard Group Jobs
Description Group Job Name
Main group job MAIN
Second programmer menu PGMMNU2
Command entry CMDENT1
SAA* OfficeVision* word processing function STRWP1

In this approach, each programmer has a unique initial program. Figure 27 shows
an initial program for a programmer named SMITH.

PGM
„1…
CHGLIBL LIBL(SMITH QGPL QPDA QTEMP QIDU)
CHGGRPA GRPJOB(MAIN) TEXT('Main group job')
„2…
CHGDTAARA DTAARA(*GDA) VALUE('STRPGMMNU SRCLIB(SMITH) +
OBJLIB(SMITH) JOBD(SMITH)')
TFRGRPJOB GRPJOB(PGMMNU2) INLGRPPGM(STDGRPC) +
TEXT('Programmer Menu # 2')
CHGDTAARA DTAARA(*GDA) VALUE('CALL QCMD')
TFRGRPJOB GRPJOB(CMDDENT1) INLGRPPGM(STDGRPC) +
TEXT('Command entry # 1')
CHGDTAARA DTAARA(*GDA) VALUE('STRWP')
TFRGRPJOB GRPJOB(STRWP1) INLGRPPGM(STDGRPC) +
TEXT('Word Processing # 1')
„3…
SETATNPGM PGM(ATTNPGM)
LOOP:
STRPGMMNU OBJLIB(SMITH) SRCLIB(SMITH) +
JOBD(SMITH)
MONMSG MSGID(CPF2320) /* F3 from +
Pgmrs Menu */
GOTO LOOP
ENDPGM

Figure 27. Initial Program for SMITH

This program does the following:

„1… Establishes the environment (for example, library list).
„2… Calls the standard group jobs (three group jobs plus the main group job are
shown here). The group job data area is used to pass the command to be
run. For each group job except the initial one, the same initial program
(STDGRPC) is used.
„3… The SETATNPGM command sets the Attention key on and establishes the
ATTNPGM program as the standard Attention-key-handling program. When
the Attention key is pressed, the TFRGRPJOB command with
GRPJOB(*SELECT) specified displays the group job selection display. From
this display, the programmer can change and add additional group jobs.

190 OS/400 Work Management V4R4

Note: To add another standard group job requires only two additional commands
be added to the initial program and no changes to the other programs. With
this approach, the group jobs would be started at sign-on and would not be
ended unless the user signed off or entered the ENDGRPJOB command.

The initial program (STDGRPC) for the group jobs other than the main group job is
shown in Figure 28.

PGM
DCL VAR(&CMD); TYPE(*CHAR) LEN(512)
„1…
RTVDTAARA DTAARA(*GDA) RTNVAR(&CMD)
TFRGRPJOB GRPJOB(*PRV)
„2…
SETATNPGM PGM(ATTNPGM)
„3…
LOOP:
CALL QCMDEXC (&CMD 512)
MONMSG MSGID(CPF2320) /* F3 from +
Pgmrs Menu */
TFRGRPJOB GRPJOB(*PRV)
GOTO LOOP
ENDPGM

Figure 28. Initial Program for Group Jobs

When the group job is started, it does the following:

„1… Retrieves the group data area, which contains the command to be run. The
command is not run immediately, but is stored in a variable in the program.
The program returns to the previous group job. The user does not see any
displays, but would notice the overhead to build the group job. Assume at a
later point the user selects the group job STRWP1 from the Group Jobs
Selection menu. The user transfers to the STRWP1 group job. Because it is
already active, it continues with the instruction following the TFRGRPJOB
command.
„2… The SETATNPGM command sets the Attention key on and establishes the
ATTNPGM program as the Attention-key-handling program.
„3… The program calls the QCMDEXC program and passes variable &CMD,
which contains the STRWP command (see the initial program shown
earlier). To exit the OfficeVision word processing function, the programmer
can do either of the following:
v Press the Attention key and receive the Group Jobs Selection menu. This allows
the programmer to transfer to an existing group job or start a new group job.
v Press the Exit key from the OfficeVision word processing function primary menu.
This returns to program STDGRPC, which transfers back to the previous group
job.

Note: Pressing the Exit key does not end the STRWP1 group job. If the
STRWP1 group job is again activated, the program returns to the next
instruction, which loops back and runs the STRWP command again by
calling QCMDEXC.

The Attention-key-handling program (ATTNPGM) would be coded as shown in

Figure 29 on page 192.

Chapter 7. Group Jobs 191

 PGM
TFRGRPJOB GRPJOB(*SELECT)
MONMSG MSGID(CPF1310) EXEC(DO)
/* No group jobs */
SNDUSRMSG MSG('An attention program
is active, but no +
group jobs exist') MSGTYPE(*INFO)
ENDDO /* No group jobs */
ENDPGM

Figure 29. Attention-Key-Handling Program Coding Example

If you press the Attention key, and then press F6 to start a new group job (one that
is not in your standard list), you must enter the SETATNPGM command in the new
group job for the Attention key to be active.

If you want to end all group jobs, you can do so by calling the program shown in
Figure 30.

PGM
DCL &GRPJOBL *CHAR LEN(1056)
DCL &X *DEC LEN(5 0) VALUE(67)
/* 2nd group job */
RTVGRPA GRPJOBL(&GRPJOBL)
MONMSG MSGID(CPF1311) EXEC(DO)
/* Not a group job */
SNDPGMMSG MSG('The current job is not a
group job')
RETURN
ENDDO /* Not a group job */
LOOP: IF (&X *NE 1057) DO /* Less
than 16 group jobs */
IF (%SST(&GRPJOBL &X 10) *NE ' ')
DO /* Job */

ENDGRPJOB GRPJOB(%SST(&GRPJOBL &X 10))

ENDDO /* Job */
CHGVAR &X (&X + 66)
GOTO LOOP
ENDDO /* Less than 16 group jobs */
CHGGRPA GRPJOB(*NONE)
SNDPGMMSG MSG('All group jobs ended and the +
current job is no longer a group job')

ENDPGM

Figure 30. End All Group Jobs Example Program

The program retrieves the current group job list, which can be made up of 16
entries where each entry is 66 bytes long containing:

Group job name 10 characters

Job number 6 characters
Group job text 50 characters

The active group job is the first one in the list. The program starts by trying to
access the name of the second group job (starts in position 67) and if it is not
blank, it ended the group job. When all other group jobs are ended, the current job
is changed into a nongroup job.

192 OS/400 Work Management V4R4

Returning to the Group Job Main Program
Instead of allowing the user to do any function from any other function (as do the
examples Figure 30 on page 192, Figure 29 on page 192, and Figure 28 on
page 191), a program could have the workstation user always return to the main
program. This could be done using the previous example program and removing
the SETATNPGM command, as follows:
PGM
OVRDBF . . . SHARE(*YES)
OPNDBF . . .
LOOP: CALL CUSINQ
TFRGRPJOB GRPJOB(*PRV)
GOTO LOOP
ENDPGM

The workstation user cannot use the Attention key. Ending the function (exiting from
the CUSINQ program) returns the workstation user to the main program.

As in the previous alternative, the only way to end this group job is to use the
ENDGRPJOB command, use the ENDJOB command, or to sign off.

Note: Using the OVRDBF and OPNDBF commands to specify a shared open,
allows a faster open each time a group job is called.

Chapter 7. Group Jobs 193

194 OS/400 Work Management V4R4
Chapter 8. Batch Jobs
A batch job is a predefined group of processing actions submitted to the system to
be performed with little or no interaction between the user and the system. Jobs
that do not require user interaction to run can be processed as batch jobs. A batch
job typically is a low priority job and can require a special system environment in
which to run. Batch jobs can be started when a user:
v Causes a job to be placed in a job queue
v Issues a communication program start request
v Starts a subsystem with an autostart job entry
v Starts a subsystem with a prestart job

Submitting a Batch Job

To submit a batch job to a batch queue, use one of the submit job commands:
Submit Job (SBMJOB), Submit Database Job (SBMDBJOB), or Submit Diskette Job
(SBMDKTJOB).

The difference in these commands is the source of the job:

v The SBMJOB command can be used to submit a job to a batch job queue by
specifying a job description and by specifying a CL command or request data, or
specifying routing data to run a program.
v If you want to run a single CL command in the batch job, the simplest way is to
use the CMD parameter on SBMJOB, which does syntax checking and allows
prompting.
v The SBMDBJOB and SBMDKTJOB commands can be used to submit a job to a
batch job queue from a database file or a diskette device respectively. For these
jobs, the job description comes from the BCHJOB statement in the input stream.

For a detailed description of these commands, see the CL Reference (Abridged)

book.

See also “Scheduling a Job” on page 223.

Submit a Batch Job—Example

In the following example, the SBMJOB command submits a job named WSYS,
using the job description QBATCH, to the job queue QBATCH. The CMD parameter
gives the CL command that will run in the job.
SBMJOB JOBD(QBATCH) JOB(WSYS) JOBQ(QBATCH)
CMD(WRKSYSSTS)

Note: If you get a message that the job was not submitted, you can display the job
log spooled file to find errors. Use the WRKJOB command. Specify the job
that was not scheduled, select option 4 for spooled files. Display the job log
spooled file to find the errors.

© Copyright IBM Corp. 1997, 1999 195

How a Batch Job Starts
When a user submits a batch job, the job gathers information from several system
objects before it is placed on a job queue.
1. A user submits a job.
2. The job searches for job attributes. If the job attributes are not found on the
Submit Job (SBMJOB) command, the job looks in the job description (specified
on the SBMJOB command), the current user’s user profile, and the currently
active job (the job issuing the SBMJOB command).

Note: Similar to interactive job initiation, you can specify in the job description
to use the user profile. The user profile can specify to use a system
value to find certain job attributes.
3. Once the job has all its attributes, it resides on the job queue.
4. When the subsystem is ready to handle a job, it looks for jobs in the job queues
(those that the subsystem has allocated).
5. Then, like interactive job processing, the subsystem checks the job description
for the routing data.
6. The subsystem uses the routing data to find a routing entry. The routing entry
provides information about which pool the job will use, which routing program
will be used, and in which class the job will run.
7. After this information is obtained, the routing program is run. If you use QCMD,
QCMD will carry out the SBMJOB command.
Table 25. How a Batch Job Starts
What Occurs When Starting Batch Jobs Where the System Gets Its Information
Job is submitted. Command
↓
Get job attributes. If not changed by the v Submit Job (SBMJOB) command
parameters on the Submit Job command,
v Job description
information from the job description, the
current user’s profile, and the currently active v User profile
job (the job issuing the SBMJOB command) v System value,
will be used. v Current system’s attributes
↓
Job placed on job queue Job queue
Get the job from the job queue SBS Job Queue entry Job Queue
↓
Get routing data and entry. Subsystem routing entry Class
v Get program to run
v Get class (run time information)
v Get pool number
↓
Run the routing program from the routing SBS routing entry
entry.
↓
Call program Command
↓

196 OS/400 Work Management V4R4

 Table 25. How a Batch Job Starts (continued)
What Occurs When Starting Batch Jobs Where the System Gets Its Information
Job is running.

Specifying Attributes of a Batch Job

To specify attributes of the batch job you are submitting, do one of the following:
v Use a specified job description without overriding any of the attributes.
v Use a specified job description but override some of the attributes (using the
BCHJOB or SBMJOB command) for the job.

The job description QGPL/QBATCH is the default for the BCHJOB command. The
default user profile for the BCHJOB command is QPGMR because it is specified in
the job description QGPL/QBATCH. The default user profile for the SBMJOB
command is *CURRENT; the submitted job uses the same profile as the job that
submitted it.

Input and Output Spooling

Spooling support enables the system to store data until a device can use the data.

Often when jobs are processed by a subsystem, the rate that data can be handled
by an input or output device is different than the rate that the system can handle it.
This is obvious on a printer for example. It takes more time for a printer to print the
data than for the system to get the data from a database file. Also, when a system
has several users doing similar jobs, each user would like to use the system as if it
were dedicated to his or her job. The system uses spooling to help in both of these
situations.

Spooling allows the system to store data in an object called a spooled file. The
spooled file collects data from a device until a program or device is available to
process the data. A program uses a spooled file as if it were reading from or writing
to an actual device. This is input and output spooling.

Input Spooling
Input spooling is done by the system for database and diskette files. An
IBM-supplied program, called a reader, is started in the spooling subsystem, reads
the batch job streams from the device, and places the jobs on a job queue.

Output Spooling
Output spooling is done for printers. An IBM-supplied program, called a printer
writer, is started in the spooling subsystem, selects spooled files from its output
queue, and writes the records in the spooled output file to the printer.

Spooling Support and Queues

Spooling support is available for two types of queues:
v Job queues. Entries for jobs are placed on job queues by readers, by the Submit
Database Jobs (SBMDBJOB) command, by the Submit Diskette Jobs
(SBMDKTJOB) command, by the Submit Job (SBMJOB) command, or by

Chapter 8. Batch Jobs 197

 transferring to a subsystem using the Transfer Job (TFRJOB) or Transfer Batch
Job (TFRBCHJOB) command. A subsystem selects jobs from a job queue for
running.
v Output queues. Entries for the spooled output files made by jobs are placed on
an output queue. A writer selects the output from the queue for writing to an
output device.

Both the job queue name and the default output queue name for a job are specified
in the job description for the job. Both can be overridden using parameters on the
BCHJOB and SBMJOB commands. In addition, the output queue specified for a job
already on a job queue or active in the system can be changed for files not yet
opened by the job by using the Change Job (CHGJOB) command. Job queue
entries in a subsystem description specify from which job queues a subsystem is to
receive jobs.

Job and Output Queues for Spooling

Spooling is supported in a manner similar to batch jobs. QSPL is started from the
shipped subsystem description QSYS/QSPL. QSPL supports the processing of
spooling readers and writers that transfer data to and from devices independently of
the application processing. Figure 31 shows how the spooling subsystem QSPL
operates.

Job Queue Subsystem Description

QBPL/QSPL QSYS/QSPL
┌──────────────────────────┐
┌─────────┐ │ │
│ │ │ │
│ │ Í─────┐ │ ┌──────────────────┐ │
│ │ │ │ │ │ │
└─────────┘ │ │ │ MAXJOBS=*NOMAX │ │
└───── │ └──────────────────┘ │
Subsystem │ ┌──────────────────┐ │
QSPL ─────────────Ê │ │ │ │
│ │ ├────┤
│ │ JOBQ=QGPL/QSPL │ │
┌─────────┐ │ │ │ │
│ │ │ │ │ │
│ │ │ └──────────────────┘ │
│ │ │ Job Queue Entry │
└─────────┘ │ │
└──────────────────────────┘

Figure 31. QSPL Spooling Subsystem Operation

When the subsystem QSPL is started, it processes the jobs on the queue
QGPL/QSPL until it is empty or the subsystem is ended.

Because a separate job description is used for each type of reader or writer, you
can set up your system to uniquely handle different types of spooling processing.

See “Appendix C. IBM-Supplied Object Contents” on page 463.

Job Queues
You can think of a job queue as a list of batch jobs waiting to be processed.
Actually, a job queue is an index of status and work-related information associated
with a specific kind of work to be performed by the system. This work, referred to
as a job on the AS/400 system, waits on a queue until the queue is allocated to an
active subsystem. Once allocated, work information is retrieved from the queue one
job at a time and used to start each job in the subsystem.

198 OS/400 Work Management V4R4

Job Queue Allocated to Subsystem: A job queue can be associated with several
subsystems but it can only be allocated to one subsystem at a time. Job queues
are allocated to a subsystem in one of two ways.

Job Queue Created before the Subsystem Started: When the subsystem is
started, the subsystem monitor tries to allocate each job queue defined in the
subsystem job queue entries. If a job queue was allocated by another subsystem
already, the first subsystem must end and deallocate the job queue before the
second subsystem can allocate it. After it is started, this second subsystem
allocates job queues assigned to it as they become available.

Job Queue Created after the Subsystem Started: If a job queue does not exist
when the subsystem is started, the job queue is allocated to the subsystem when:
v The job queue is created.
v A job queue is renamed with the name defined to the subsystem.
v A job queue is moved to another library and the resulting qualified name matches
the name in the subsystem description.
v The library containing the job queue is renamed and the resulting qualified name
matches the name in the subsystem description.
See also “Job Queue Entry” on page 98.

How Jobs Are Taken from Multiple Job Queues: A subsystem processes jobs
from a job queue based on sequence number. A subsystem can have more than
one job queue entry and can therefore allocate more than one job queue. The
subsystem processes jobs from the job queue with the lowest sequence number
first. When all jobs on that job queue have been processed, or when the maximum
number of jobs from the queue is reached, the subsystem processes jobs from the
queue with the next higher sequence number. The maximum number of jobs from a
queue is specified by the MAXACT parameter on the Add Job Queue Entry
(ADDJOBQE) or the Change Job Queue Entry (CHGJOBQE) commands.

The sequence continues until the subsystem has processed all available job queue
entries or until the subsystem has reached its limit of jobs that can be running or
waiting in the subsystem. The number of jobs that can be running or waiting is
determined by the Maximum Jobs (MAXACT) parameter in the subsystem
description. In some cases the sequence is interrupted as jobs end or are
transferred. Creating, holding, and releasing job queues can also change the
sequence of job queues processed.

Specifying the Order for Job Queues: To specify the order in which the job
queues are processed by the subsystem, use the sequence number (SEQNBR)
parameter of the Add Job Queue Entry (ADDJOBQE) command.

Jobs on Several Job Queues—Scenario: The following is a scenario of how a

subsystem handles jobs on several job queues:

Job Queue A (SEQNBR = 10)

Job 1
Job 2
Job 3
Job Queue B (SEQNBR = 20)
Job 4
Job 5
Job 6
Job Queue C (SEQNBR = 30)

Chapter 8. Batch Jobs 199

 Job 7
Job 8
Job 9

Each job queue entry in this scenario is specified as MAXACT(*NOMAX). The

subsystem first selects jobs from job queue A because the job queue entry has the
lowest sequence number. If the maximum number of jobs in the subsystem is 3
(MAXJOBS(3) parameter on the CRTSBSD command), it can select all the jobs
from job queue A to be active at the same time. When any of the three jobs is
completed, the activity level is no longer at the maximum; therefore a new job is
selected from job queue B because it has the next lowest sequence number
(assuming no new jobs have been added to job queue A).

Because each job queue entry specifies MAXACT(*NOMAX), an unlimited number

of jobs can be started. Had each job queue entry specified MAXACT(1), then jobs
1, 4, and 7 would have been started. Had job queue entry A been specified as
MAXACT(2), then jobs 1, 2, and 4 would have been started.

Sending Completion Messages for Each Batch Job: To send completion

messages, use the MSGQ parameter on the Batch Job (BCHJOB) or Submit Job
(SBMJOB) command. Use these commands to specify the name of the message
queue to which a completion message is to be sent when the job has completed
(message CPF1241 indicates a normal completion and CPF1240 indicates an
abnormal completion).

For example, to send a completion message to the QSYSOPR message queue,

you could use the following BCHJOB command:
//BCHJOB JOB(PAYROLL) JOBD(PAYROLL) MSGQ(QSYSOPR)

Completion Message—Tips: Instead of sending the completion messages for all

jobs to the QSYSOPR message queue, you may want to send the completion
messages for some jobs to the message queue of the submitting workstation and
for other jobs to a message queue that is periodically displayed or printed.

Another alternative is to send all the completion messages to a user message

queue. You can then use a program to receive the messages from this queue and
to resend them if necessary. For example, if a job failed for a user who is not a
programmer or the system operator, the program could resend the message to both
the workstation user and the system operator.

Comparison of SBMXXXJOB Commands and Readers: The Submit Database

Job (SBMDBJOB) and Submit Diskette Job (SBMDKTJOB) commands and readers
all interpret input streams from a database file or diskette and place jobs on job
queues.

In general, you may prefer to use the SBMXXXJOB commands unless the input
stream is large or unless you want to use the syntax checking function done by a
reader.
Table 26. Comparing SBMXXXJOB Commands to Readers
SBMDBJOB and SBMDKTJOB Readers
Run in the same job as the requester of the Run in its own job. (Once the command has
command. (The workstation is locked until been specified, you can continue with other
the submit jobs command has completed work.)
running.)

200 OS/400 Work Management V4R4

Table 26. Comparing SBMXXXJOB Commands to Readers (continued)
SBMDBJOB and SBMDKTJOB Readers
Does not perform any syntax checking of the Perform syntax checking on any job in the
jobs in the input stream. input stream in which syntax checking is
specified on the BCHJOB command or in the
job description.
Require fewer resources than a reader Require more system resources than the
because a separate job is not started. submit jobs commands because a separate
job is created.
Process the input stream sooner. Process the input stream later.

Submitting a Job from Another Subsystem: To submit a batch job from another
subsystem, use parameters from a display file.

“Display File SBMJOBSMPD—Example” is an example of a CL program that

prompts for input from a workstation user and passes the input received as
parameters to a batch job. A display file is used to prompt the user.

Display File SBMJOBSMPD—Example: The following is the display file

(SBMJOBSMPD), which is used to prompt the user for the parameters to be
passed:

SEQNBR *... ... 1 ... ... 2 ... ... 3 ... ... 4 ... ... 5 ... ... 6 ... ... 7
1.00 A* SBMJOBSMPD - Submit data from display - used by SBMJOBSMPC
2.00 A R PROMPT
3.00 A CF03(93 'RETURN')
4.00 A 1 2'Prompt for SMBJOB'
5.00 A 3 2'Name'
6.00 A NAME 10 I +2
7.00 A 5 2'Department'
8.00 A DEPT 3 I +2
9.00 A 7 2'Days'
10.00 A DAYS 3 0I +2
11.00 A 9 2'Amount'
12.00 A AMOUNT 7 2I +2

Figure 32. Display File SBMJOBSMPD Example

Display File SBMJOBSMPC Example: The following is the CL program

(SBMJOBSMPC), which is used to display the SBMJOBSMPD file and submit the
job:

Chapter 8. Batch Jobs 201

 SEQNBR *... ... 1 ... ... 2 ... ... 3 ... ... 4 ... ... 5 ... ... 6 ... ... 7
1.00 /* SBMJOBSMPC - Submit job to batch with parameters */
2.00 PGM
3.00 DCLF FILE(SBMJOBSMPD)
4.00 DCL &DAYSA *CHAR LEN(3)
5.00 DCL &AMOUNTA *CHAR LEN(8)
6.00 SNDRCVF
7.00 IF (&IN93 *EQ '1') RETURN
8.00 CHGVAR &DAYSA &DAYS
9.00 CHGVAR &AMOUNTA &AMOUNT
10.00 SBMJOB JOB(JOBA) JOBD(JOBA) RQSDTA('CALL SBMJOBSMP +
11.00 PARM(' *CAT &NAME *BCAT ''' *CAT +
12.00 &DEPT *BCAT ''' *BCAT &DAYSA *BCAT +
13.00 &AMOUNTA *CAT ')') SWS('00000001')
14.00 ENDPGM

Figure 33. Display File SBMJOBSMPC Example

Rules for Special Display File Processing: The program prompts for the
parameters and receives data from the display file. The data is concatenated
together to form the CMD parameter on the SBMJOB command.

The data from the display requires special processing because of the following
rules:
v When you concatenate CL variables to make a parameter value, the CL variables
must be character variables. You must also specify blanks, apostrophes, and
parentheses that are to be included in the parameter to be passed.
v If you specify a parameter value starting with a digit (such as 43T) on a CALL
statement, the system interprets the parameter as a numeric parameter.
v When a parameter is specified within apostrophes, and you want to specify
another apostrophe within it, you must specify two apostrophes.

Display File Processing Examples: If the following information was specified on the
prompt:
NAME JONES
DEPT 57A
DAYS 5
AMOUNT 5000

the command submitted to the batch job queue would be:

CALL SBMJOBSMP PARM(JONES '57A' 5 5000)

If the following information was specified on the prompt:

NAME JONES
DEPT 43T
DAYS 2
AMOUNT 931

the request data sent to the batch job queue would be:
CALL SBMJOBSMP PARM(JONES '43T' 002 009.31)

Fields Receiving Display Data: Data is received from the display in the following
fields:
v NAME: The workstation user should key in all alphabetic data (no leading digits)
for this field. It is received as a character variable in the CL program, and no
special processing is required for the data.

202 OS/400 Work Management V4R4

v DEPT: The workstation user could start with a digit when typing in the DEPT field
(for example, 43T). If 43T is passed to the system on a parameter in a
command, the system would treat the parameter as a numeric variable. This is
the wrong data type; the DEPT parameter must be character data.
To prevent this error, you must enclose the department number in apostrophes
(such as ’43T’). However, in the CL program, you must specify four apostrophes.
When the CL program is compiled, the four apostrophes are processed by the
system and become two apostrophes. When the CL program is run, the two
remaining apostrophes are processed by the system again, and become one
apostrophe.
v DAYS and AMOUNT: These numeric fields must be converted to character data
so they can be concatenated into the RQSDTA parameter on the SBMJOB
command. The program declares two character variables (DAYSA and
AMOUNTA), then changes their value to the value of the numeric variables
(DAYS and AMOUNT) as received from the display file. The program uses the
character variables for the concatenation.

Note: The AMOUNT field contains a decimal point because it was changed from
the numeric field AMOUNT to a character field by the CHGVAR command.
The character variable must be long enough to contain this data.

SBMJOBSMP Program—CL Coding Example: An example of coding the

SBMJOBSMP program to receive the parameters in batch (if it were a CL program)
is shown:

SEQNBR *... ... 1 ... ... 2 ... ... 3 ... ... 4 ... ... 5 ... ... 6 ... ... 7 ..

1.00 PGM PARM(&NAME &DEPT &DAYS &AMOUNT)

2.00 DCL &NAME *CHAR LEN(10)
3.00 DCL &DEPT *CHAR LEN(3)
4.00 DCL &DAYS *DEC LEN(15 5)
5.00 DCL &AMOUNT *DEC LEN(15 5)
6.00 DCL &DAYSD *DEC LEN(3 0)
7.00 DCL &AMOUNTD *DEC LEN(7 2)
8.00 CHGVAR &DAYSD &DAYS
9.00 CHGVAR &AMOUNTD &AMOUNT
10.00 .
11.00 .

Figure 34. SBMJOBSMP CL Program

The CL program receives the character parameters with the desired definition. The
numeric parameters must be received with a definition of LEN(15 5). (All numeric
variables passed in from a processing program are passed as 15 5.) The data is
then moved to the desired length fields by the CHGVAR command. If both
parameters of the CHGVAR command are decimal variables, decimal alignment is
performed.

SBMJOBSMP Program—RPG Coding Example: An example of coding the

SBMJOBSMP program to receive the parameters in batch (if it were an RPG
program) is shown in this example:

Chapter 8. Batch Jobs 203

 SEQNBR *... ... 1 ... ... 2 ... ... 3 ... ... 4 ... ... 5 ... ... 6 ... ... 7 ..

1.00 C *ENTRY PLIST

2.00 C PARM NAME 10
3.00 C PARM DEPT 3
4.00 C PARM DAYS 155
5.00 C PARM AMOUNT 155
6.00 C Z-ADDDAYS DAYSD 30
7.00 C Z-ADDAMOUNT AMTD 72
8.00 .
9.00 .

Figure 35. Example of SBMJOBSMP RPG Program

The RPG program uses the same type of definition as the CL program to receive
the parameters. The Z-ADD operation is used to convert the numeric data to the
desired field definitions because it performs decimal alignment.

Creating a Job Queue:

To create a job queue, use the Create Job Queue (CRTJOBQ) command. The
parameters on the CRTJOBQ command specify:
v Whether a user with job control special authority (OPRCTL) can control the job
queue and its contents. For example, you can specify whether a job can be
ended by someone other than the user who submitted the job.
v Authority (AUT)
v Text description (TEXT)
If these are not included, you, as owner of the job queue, can control the use of the
job queue. Also, those with access to the library can use the job queue.

After you create a job queue, it must be assigned to a subsystem before any jobs
can be run. To assign a job queue to a subsystem, add a job queue entry to the
subsystem description.

See “Adding Job Queue Entries” on page 98.

Create a Job Queue—Example: The following example creates a job queue

called JOBQA in the LIBA library:
CRTJOBQ JOBQ(LIBA/JOBQA) TEXT('test job queue')

Placing Jobs on a Job Queue: To place a job on a job queue, enter any one of
the following commands:
v Submit Database Jobs (SBMDBJOB): Read input from a single-record physical
or logical file.
v Submit Diskette Jobs (SBMDKTJOB): Read an input stream from a diskette
device.
v Submit Job (SBMJOB): Use one job to place another job on a job queue.
v Start Database Reader (STRDBRDR): Read a batch input stream from a
database and place one or more jobs on job queues.
v Start Diskette Reader (STRDKTRDR): Start a spooling reader to a diskette unit,
read an input stream, and place it on a job queue.
v Transfer Job (TFRJOB): Move this job to another job queue in an active
subsystem.
v Transfer Batch Job (TFRBCHJOB): Move this job to another job queue.

204 OS/400 Work Management V4R4

v Add Job Schedule Entry (ADDJOBSCDE): Automatically the system submits a
job to the job queue at the time and date specified in the job schedule entry.

Allocating Job Queues: To assign a job queue to subsystem, add a job queue
entry to a subsystem description using the Add Job Queue Entry (ADDJOBQE)
command. The parameters on this command specify:
v Number of jobs that can be active at the same time on this job queue (MAXACT)
v In what order the subsystem handles work from this job queue (SEQNBR)
v How many jobs can be active at one time for each of nine levels of priority
(MAXPTYn) (n=1 through 9)

Allocate a Job Queue—Example: The following example adds a job queue entry
for the JOBQA job queue in the TEST subsystem description. There is no maximum
number of jobs that can be active on this job queue and the work is processed with
a sequence number of five.
ADDJOBQE SBSD(TEST) JOBQ(LIBA/JOBQA)
MAXACT(*NOMAX) SEQNBR(5)

Finding a Job in a Job Queue: To find a job in a job queue, use the Work with
Job Queues (WRKJOBQ) command.

To see a list of all jobs on the JOBQA job queue, enter the following command:
WRKJOBQ JOBQ(LIBA/JOBQA)

If you do not know the name of the job queue:

1. Enter the command without the JOBQ parameter. The Work with All Job
Queues display appears with a list of all job queues to which you are
authorized.
2. Scan this list until you see the name of a job queue that may contain the job
you are trying to find.

Looking at Jobs in a Job Queue: Once you have found a job in a job queue
(see “Finding a Job in a Job Queue”), you can look at that job by entering the work
with option for the job you want to see. The Work with Job display appears. This
display provides several options for viewing all information available for the job you
selected.

How Many Jobs on a Job Queue: There is no set limit to the number of jobs that
can be on a job queue. It is limited only by how much work the system can handle.

Changing the Number of Jobs Running from a Job Queue: To change the
number of jobs running from a job queue, use the Change Job Queue Entry
(CHGJOBQE) command. The QBASE subsystem is shipped with a job queue entry
for the QBATCH job queue that only allows one batch job to be running at a time. If
you want more batch jobs from that job queue to be running at the same time you
need to change the job queue entry.

Change Number of Jobs on the Queue—Example: The following command

would allow two batch jobs from the QBATCH job queue to be running at the same
time in the QBASE subsystem. (This command can be issued at any time and
takes effect immediately.)
CHGJOBQE SBSD(QBASE) JOBQ(QBATCH) MAXACT(2)

Chapter 8. Batch Jobs 205

 Determining Which Subsystem Has a Job Queue Allocated: You may not be
able to submit a job to a job queue because it is allocated to another subsystem. To
determine which subsystem has the job queue allocated (JOBQA),
1. Enter the following command:
WRKJOBQ JOBQ(LIBA/JOBQA)

The Work with Job Queue display appears. The subsystem description function
key appears in the function key area of the display when the job queue is
allocated to a subsystem.
2. Press the subsystem description function key and the Work with Subsystem
Descriptions display appears showing the subsystem to which the job queue is
allocated.

Determining Which Job Queues are Allocated to a Subsystem: You may want
to see if there are any jobs waiting to be processed by a subsystem. To see this
you must see if there are any job queues allocated to that subsystem.

Enter the WRKJOBQ command and the Work with All Job Queues display appears
with all the job queues you are authorized to on the system. This display also
shows the subsystem running on the system that have allocated the job queues
listed and the number of jobs in each job queue.

Seeing Which Job Queues are Associated with a Subsystem: To see which
job queues are associated with a subsystem,
1. Use the Display Subsystem Description (DSPSBSD) command. For example:
DSPSBSD SBSD(QBASE)

The Display Subsystem Description menu appears.

2. Select the Job Queue Entries option. The Display Job Queue Entries display
appears with a list of all job queues associated with the QBASE subsystem.

Moving a Job from One Job Queue to Another: To move a job to which you are
authorized from one job queue to another using the Change Job (CHGJOB)
command.

Moving a Job from One Job Queue—Example: The following example moves
JOBA to JOBQB:
CHGJOB JOB(JOBA) JOBQ(LIBA/JOBQB)

Batch Job Routing Approaches

To route a batch job, select one of the following ways to control the routing step of
that job:
| v Use a user program to control the routing step.
| v Use the IBM-supplied program QSYS/QCMD to control the routing step.

Note: If no library is specified on the program start request, the subsystem library
list is used to find the program.

206 OS/400 Work Management V4R4

Control Routing Step for Batch Jobs Using SBMJOB Command
Figure 36 shows a batch job submitted through the SBMJOB command. For this
illustration, assume the user program USERLIB/BILLING is called.

An entry for JOBX has been placed on

the QGPL/QBATCH job queue by using a
SBMJOB SBMJOB command. (The SBMJOB
JOB(JOBX) command can be entered interactively as
RTGDTA shown or can be in an input stream.)
(BILLING)
JOBD(QBATCH)
Job Description QGPL/QBATCH The routing data in the job description
QGPL/QBATCH is overridden by the
RTGDTA parameter specified on the
Job Queue QGPL/QBATCH
RTGDTA = SBMJOB command . (All other
QCMDB
parameters on the SBMJOB command
are not specified and default to the
JOBX values in the job description
QGPL/QBATCH or use values from the
Overridden by job that is running at the same time.)
RTGDTA
Parameter on The routing data specified (BILLING)
SBMJOB matches the comparison value in the
Subsystem Description Command routing entry specifying program
QSYS/QBASE USERLIB/BILLING.

Job Queue Entry

JOBQ

QGPL/
QBATCH

Routing Entry

SEQNBR CMPVAL PGM CLS MAXACT POOLID

USERLIB/ QGPL/
15 BILLING BILLING QBATCH *NOMAX 1

Routing Step USERLIB/BILLING is called for the

routing step.

USERLIB/BILLING
Runs

RSLS866-4

Figure 36. Batch Jobs Submitted Using the SBMJOB Command

Batch Jobs Submitted Using QCMD/QSYS

Figure 37 on page 208 shows a batch job submitted through a spooling reader and
using QCMD/QSYS. Assume the user program USERLIB/BILLING is called.

Chapter 8. Batch Jobs 207

 Job Queue QGPL/QBATCH
The request data (commands) submitted
From Spooling for JOBC has been read by a spooling
Reader reader and placed on the job message
JOBC queue for JOBC (CALL BILLING).

An entry for JOBC has been placed on

the QGPL/QBATCH job queue by a
Job Description QGPL/QBATCH spooling reader.

The JOB command for JOBC specified

RTGDTA = the job description QGPL/QBATCH.
QCMDB
The routing data in the job description
matches the comparison value in the
routing entry specifying program
QSYS/QCMD.
Subsystem Description
QSYS/QBASE

Job Queue
Entry

JOBQ

QGPL/
QBATCH

Routing Entry

SEQNBR CMPVAL PGM CLS MAXACT POOLID

QSYS/ QGPL/
10 QCMDB QCMD QBATCH *NOMAX 1

Routing Step QSYS/QCMD is called for the routing

step and processes the request
(commands) on the job message queue.
QSYS/QCMD does not check the user
QSYS/QCMD profile for an initial program because
Runs an initial program is used only for
interactive jobs.

Job Message Queue for JOBC The program USERLIB/BILLING is

called when QSYS/QCMD processes
From Spooling the CALL BILLING command.
Reader
CALL BILLING
(request data)

RSLS865-3

Figure 37. Batch Jobs Submitted Using QCMD/QSYS

Job Queue Entry for JOBC

An entry for JOBC was placed on the job queue QGPL/QBATCH by a reader. The
entry on the job queue contains a description of the job and scheduling information.
The request data and any inline data are not included in the job queue entry. The
reader might have read the job from diskettes or a database file. This particular job

208 OS/400 Work Management V4R4

contains only request data consisting of commands. If the job had contained any
inline data files, the reader would have spooled them so they could be used during
job running. The input stream in the database file was:
//BCHJOB JOB(JOBC) JOBD(QBATCH) JOBQ(QBATCH)
CALL BILLING
//ENDBCHJOB

Source of Request Data

The source for the request data is determined from the RQSDTA parameter on the
Batch Job (BCHJOB) command. The RQSDTA parameter can specify any one of
the following:
v The actual request data (a character string for the parameter value)
v That the request data is in the job description (parameter value of *JOBD)
v That the request data follows the BCHJOB command (parameter value of *)

In Figure 36 on page 207, the RQSDTA parameter is not specified; it defaults to *,

which means that the request data follows the BCHJOB command.

All other parameters on the BCHJOB command are not specified and default to the
values in the job description QGPL/QBATCH.

Advantages of Calling a Program Directly in Batch

Running your application program as the routing step program minimizes the
amount of interpretive command processing. This is not normally significant, but
may be worth considering if jobs are started very frequently and performance is
critical.

Advantages of Using QSYS/QCMD to Route Batch Jobs

v Running QSYS/QCMD to process a stream of commands gives both the
functional capabilities of CL and the flexibility of dynamically changing the CL
source before submitting the job.
v Running QSYS/QCMD as the routing step program allows processing of a single
command, for example, issuing the CALL command to call an application
program. The called program may contain commands (including other CALL
commands) to do the functions of an application. In most environments where
changes are minimal, this approach offers the greatest flexibility with minimal
system resource.

Chapter 8. Batch Jobs 209

210 OS/400 Work Management V4R4
Chapter 9. Autostart Jobs
An autostart job is a batch job doing repetitive work or one-time initialization work
that is associated with a particular subsystem. The autostart jobs associated with a
subsystem are automatically started each time the subsystem is started.

Autostart Job—Benefits
Using autostart jobs, you can automatically start jobs that perform repetitive work,
initialize functions for an application, or provide centralized service functions for
other jobs in the same subsystem. An autostart job in the controlling subsystem can
be used to bring up other subsystems (as does the IBM-supplied controlling
subsystem).

Security and Autostart Job Entries

The job description used for an autostart job is specified using the ADDAJE
command. When the subsystem is started, the job operates under the user profile
name in the specified job description. You may not specify the job description
USER(*RQD). Because the job description is located by qualified name at the time
the subsystem starts, you may want to control access to the job description.

Autostart Job Initiation

Autostart jobs are associated with a particular subsystem and each time the
subsystem is started, the autostart jobs associated with it are started. An autostart
job entry in a subsystem description specifies a job that is to be automatically
started when a subsystem is started.

Figure 38 on page 212 illustrates autostart job initiation.

See also:
v “Autostart Job Entry” on page 95
v “Adding Autostart Job Entries” on page 95
v “Changing Autostart Job Entries” on page 96
v “Removing Autostart Job Entries” on page 96

© Copyright IBM Corp. 1997, 1999 211

Figure 38. Autostart Job Initiation

Note: If more than one autostart job is specified for a subsystem, all autostart jobs
are started immediately, not one followed by another. If the maximum
number of jobs of the subsystem is exceeded, no other jobs can be started
in the subsystem until enough autostart jobs have completed so that the
number of jobs running is below the maximum activity level.

212 OS/400 Work Management V4R4

Chapter 10. Communications Jobs
A communications job is a batch job that is started by a program start request from
a remote system. Job processing involves a communication request and
appropriate specifications.

Communications Job Initiation

For a communications batch job to run on an AS/400 system, a subsystem
description containing a work entry for communications jobs must exist on the
system. The communications work entry identifies to the subsystem the sources for
the communications job it will process. The job processing begins when the
subsystem receives a communications program start request from a remote system
and an appropriate routing entry is found for the request.

Routing Data for Communications Jobs

Job routing of communications jobs is determined by the program start request that
is received from the remote system. When a program start request is processed on
the target system, a fixed-length data stream that is used as routing data is created.
Position 29 of the routing data will always contain PGMEVOKE for communications
requests. Subsystem routing entries that specify a compare value of PGMEVOKE in
position 29 typically have *RTGDTA as the program name. This means that the
program name specified in the routing data (from the remote system’s program start
request) is the program to run.

If a special processing environment is required for certain communications jobs, you

can add an additional routing entry to the subsystem description, specifying a
compare value whose starting position is 37. This compare value should contain the
program name for the program start request. The routing entry must have a
sequence number lower than the routing entry that uses PGMEVOKE as the
compare value. This method allows certain communications jobs to run with a
different class and/or pool specification. Figure 39 on page 215 shows an example
of a program start request and the associated routing entry for such a job.

Communications Jobs and Security

The security on the AS/400 system controls who can use communications devices
as well as who can access the commands used with the associated device
descriptions. You should consider additional security measures when writing and
running application programs on both remote and target systems.

Job Description for Communications Jobs

The job description used for communications jobs is specified on the Add
Communications Entry (ADDCMNE) command. The user specified on this job
description is ignored. The system gets the user name for communications jobs
from the program start request. If the program start request does not specify a user
name, the system uses the default user value from the communications entry. To
ensure a greater degree of system security, include user information on the
program start request rather than specifying a default user in the communications
work entry.

© Copyright IBM Corp. 1997, 1999 213

 In the following diagram, the current library is not supported for communication jobs.
Also, if the library is not specified on the program start request, the subsystem
library list is used to find the program.

214 OS/400 Work Management V4R4

Communications Batch Job Routing

Communications Batch Job Routing

A program start request is

received from the remote system.

Program Start
Request
Routing data is created on the
Remote Device target system based on the
program start request information.

To Target System
Positional compare value (29)
matches routing entry with
CMNJOBS Subsystem sequence number of 50. The
routing entry specifies to
Communications Entry run the program named in
the program start request
COMM TYPE, (*RTGDTA) with a class of
DEV, NAME, or QBATCH in pool 1.
RMTLOCNAME JOBD DFTUSR MODE MAXACT

*ASYNC CMNJOBD *NONE *ANY 1

A Positional compare value (37) matches
NYC CEOJOBD *NONE LU0 1 routing entry with sequence
number of 40. The routing entry
specifies to run the program
named in the program start request
Routing Entry (*RTGDTA) with a class of SPECIAL
in pool 2. (This method is used
SEQNBR CMPVAL Position PGM Class POOLID for communications jobs that require
unique environments for processing.
40 COMMFAST 37 *RTGDTA SPECIAL 2 The routing entry must preceed that
which used PGMEVOKE as a compare
50 PGMEVOKE 29 *RTGDTA QBATCH 1 value.)

Routing Data

1 9 19 29 37 47 57
Mode Device Userid PGMEVOKE Program Library
Name Name Name Name

*ANY RDEV01 QPGMR PGMEVOKE COMMPGM1 COMMLIB

LU0 RDEV02 CEO PGMEVOKE COMMFAST COMMLIB A

Routing Step

Program specified
in program start
request (*RTGDTA)
runs.

RV3W002-2

Figure 39. Communications Batch Job Routing

Chapter 10. Communications Jobs 215

216 OS/400 Work Management V4R4
Chapter 11. Prestart Jobs
A prestart job is a batch job that starts running before a program on a remote
system sends a program start request. Prestart jobs are different from other jobs
because they use prestart job entries to determine which program, class, and
storage pool to use when they are started. Within a prestart job entry, you must
specify attributes that the subsystem uses to create and manage a pool of prestart
jobs.

Prestart Job—Benefits
Use prestart jobs to reduce the amount of time required to handle a program start
request.

Prestart Job Initiation

1. When a subsystem is started, or when the Start Prestart Job (STRPJ) command
is entered, prestart jobs are started based on the information contained in the
prestart job entries.
2. When a program start request is received on the target system, it is sent to the
subsystem that has the required communications device allocated.
3. The program start request attaches to a prestart job that is already running if
the subsystem finds either of the following:
v A prestart job entry with a program name that matches the program name of
a program start request
v A routing entry that matches the routing data of the program start request
and the routing program on the found routing entry matches the program
name on a prestart job entry
4. If the prestart job entry is not active, the program start request is rejected. If a
match is not found, the program start request causes a communications batch
job to start if the routing data matches the routing entry. Otherwise, the program
start request is rejected.
See also:
v “Prestart Job Entry” on page 99.
v “Adding Prestart Job Entries” on page 100.
v “Changing a Prestart Job Entry” on page 100.
v “Removing a Prestart Job Entry” on page 100.

Figure 40 on page 218 shows prestart job initiation.

© Copyright IBM Corp. 1997, 1999 217

 CMNJOBS Subsystem

Because the prestart job entry

specifies START(*YES), prestart
jobs are started when the
subsystem is started. Four jobs
Prestart Job Entry are started initially INLJOBS(4)
and run under the user profile
specified in the prestart job
Program User Job Jobd Start
INLJOBS =4 entry.
THRESHOLD =3
ORDERPGM CMNUSE PJOB PJOBD *YES
ADLJOBS =2 A program start request is received
MAXJOBS =10 from a device that has been allocated
by the CMNJOBS subsystem. Because
Communications Entry the program name in the request matches
Type, Dev the program name in the prestart job entry,
or the program start request attaches to one
of the prestart jobs. The security attributes
RMTLOCNAME JOBD DFTUSER MODE MAXACT from the CLERK5 user profile are used for
the job.
*APPC CMNJOBD *NONE LU6.2 *NOMAX

A second program start request is

received from another device allocated
to the CMNJOBS subsystem. Its program
Job Job Job Job name also matches the name in the
1 2 3 4 prestart job entry. The program start
request attaches to another of the
prestart jobs. The security attributes
from the CLERK16 user profile are
Job Job used for the job.
5 6

The attachment of the second program

start request causes the number of
available prestart jobs to fall below
the threshold value of 3. This causes
Mode . . . . . LU6.2 Mode . . . . . LU6.2 2 more (ADLJOB=2) prestart jobs to be
Dev . . . . . . . RDEV01 Dev . . . . . . . RDEV08 started in the subsystem.
User . . . . . . CLERK5 User . . . . . . CLERK16
Program . . . ORDERPGM Program . . .ORDERPGM
Lib . . . . . . . STORELIB Lib . . . . . . . STORELIB RV3W004-1

Figure 40. Prestart Job Initiation

Number of Prestart Jobs

When the subsystem starts, the INLJOBS attribute on the prestart job entry
determines the number of prestart jobs that initially start for a program. If more jobs
need to be created, the ADLJOBS value is used. The THRESHOLD value is the
least number of jobs that can be available before new jobs are started. There are
some restrictions for the values of these parameters.
v INLJOBS must be > or = to THRESHOLD
v INLJOBS must be < or = to MAXJOBS
v ADLJOBS must be < MAXJOBS

Starting a Prestart Job

To start a prestart job, use the Start Prestart Job (STRPJ) command. Prestart jobs
can also start at the same time the subsystem is started.

If you specify *NO on the STRJOBS attribute, no prestart job starts for the prestart
job entry when the subsystem starts. However, running the STRPJ command does
not cause the value of the STRJOBS parameter to change.

218 OS/400 Work Management V4R4

 The number of prestart jobs that can be active at the same time is limited by the
MAXJOBS attribute on the prestart job entry and by the MAXJOBS attribute for the
subsystem. The MAXACT attribute on the communications entry controls the
number of program start requests that can be serviced through the communications
entry at the same time.

The STRPJ command should not be used until the startup of the related subsystem
is complete. To make sure that the necessary prestart job successfully starts, code
a delay loop with a retry if the STRPJ command fails. Prestart jobs can also start at
the same time the subsystem is started.

Queuing or Rejecting Program Start Requests

If a program start request arrives when the current number of prestart jobs is less
than the number specified in the MAXJOBS attribute on the prestart job entry, and
none of the prestart jobs are available to handle program start request, you have
the option to have this new request rejected or queued.

To reject or queue the program start request, use the WAIT attribute on the prestart
job entry.

WAIT (*NO) means the following:

v If no prestart job is available immediately, the program start request is rejected.

WAIT (*YES) means the following:

v If no prestart job is available immediately and no prestart job can be started due
to MAXJOBS to service the program start request, the program start request is
rejected.
v If no prestart job is available immediately, but additional prestart jobs can be or
have been started, the program start request is queued.

Excessive Prestart Jobs

If an active prestart job entry is in the subsystem, the subsystem periodically checks
the number of prestart jobs in a pool that are ready to service program start
requests to determine if there are excessive available prestart jobs. Excessive
available prestart jobs are ended by the subsystem gradually. However, the
subsystem always leaves at least the number of prestart jobs specified in the
INLJOBS attribute in a pool.

Program Start Request Received

Each time a program start request is received:
1. The subsystem checks the number of prestart jobs in the pool that are not
attached to a program start request.
2. If the number drops below the minimum THRESHOLD value, the subsystem
starts the number of prestart jobs specified in the ADLJOBS attribute.

Note: The subsystem does not start more than the number specified in the
MAXJOBS attribute on the prestart job entry or the number specified in the
MAXJOBS attribute for the subsystem.

Chapter 11. Prestart Jobs 219

 If a prestart job goes to the end of the job either normally or abnormally (except if it
is ended by the ENDJOB command) before one program start request attaches to
the prestart job, the prestart job program is considered to be in error and the
subsystem ends the prestart job entry.

If a prestart job goes to the end of the job after at least one program start request
has been attached to it, the subsystem starts one prestart job to replace it (as long
as the MAXJOBS value has not been reached).

Security and Prestart Jobs

When a prestart job starts, it runs under the prestart job user profile. When a
program start request attaches to a prestart job, the prestart job user profile is
replaced by the program start request user profile. When the prestart job is finished
handling a program start request, the program start request user profile is replaced
by the prestart job user profile. If there is a group profile associated with the user
profile, the group profile is also exchanged. The exchange of the user profile is for
authority checking only. None of the other attributes associated with the user profile
are exchanged. Libraries on the library list to which the prestart job entry user
profile is authorized continue to be authorized to the prestart job when the program
start request user profile replaces the prestart job entry user profile. However, the
library list can be changed by the Change Library List (CHGLIBL) command.

Prestart Job Object Authorization

When a prestart job starts, authority checking against the prestart job entry user
profile is performed on every object that is needed for starting a job. Before a
program start request is allowed to attach to a prestart job, only the program start
request user profile/password and its authority to the communications device and
library/program is checked. To avoid occurrences where the program start request
user profile is not authorized to objects that the prestart job entry user profile is
authorized to, you must ensure that the program start request user profile is
authorized to at least as many objects as the prestart job entry user profile. To
accomplish this, the prestart job program can be created by the prestart job entry
user with USRPRF(*OWNER) specified on the CRTxxxPGM (where xxx is the
program language) command. The program owner authority will automatically be
transferred to any programs called by the prestart job program. Otherwise, you may
choose to explicitly check object authorization (CHKOBJ) before referring to any
objects.

Files and objects that the prestart job user profile is not authorized to should be
closed and deallocated before end of transaction is performed on the requestor
device. If database files are left open in the prestart job, the prestart job program
must check the program start request user profile authority to the open files, in
order to guarantee the database security.

Performance Tips for Prestart Jobs

The prestart job should do as much work as possible before it attempts to acquire
an ICF program device or accept a CPI Communications conversation. The more
work it does initially (allocating objects, opening database files, and so on), the less
it will have to do when a program start request is received, therefore giving the
transaction faster response time.

220 OS/400 Work Management V4R4

 You should only deallocate resources specific to the transaction you want
performed. Any resource that is commonly used for other transactions performed by
the prestart job program should remain allocated while the job is waiting for its next
request. You should leave files open and objects allocated to save time when the
next request is received.

Note: Database files that are left open in the prestart job generally require the
same considerations as database files that are shared in the same job. For
information on sharing database files between jobs and sharing database
files in the same job, see the DB2 UDB for AS/400 Database Programming
book.

Since the same QTEMP library is used for the entire life of a prestart job, objects
that are no longer needed should be deleted.

Since the same Local Data Area (LDA) is used for the entire life of a prestart job,
information can be kept and passed to the next transaction.

Since each prestart job can handle many program start requests, and has only one
job log, you may want your application to send messages to the job log identifying
the activity of the prestart job.

Prestart Job Attributes

The job attributes of a prestart job are not changed by the subsystem when a
program start request attaches to a prestart job. The Change Prestart Job (CHGPJ)
command allows the prestart job to change some of the job attributes to those of
the job description (specified in the job description associated with the user profile
of the program start request or in the job description specified in the prestart job
entry).

Job Accounting and Prestart Jobs

If your system uses job accounting, the prestart job program should run the CHGPJ
command with the program start request value for the accounting code parameter
(CHGPJ ACGCDE(*PGMSTRRQS)) immediately after the program start request
attaches to the prestart job. This action changes the accounting code to the value
specified in the user profile associated with the program start request. Immediately
before the program finishes handling the program start request, the program should
run the Change Prestart Job command with the Prestart Job Entry value for the
accounting code parameter (CHGPJ ACGCDE(*PJE)). This changes the accounting
code back to the value specified in the job description of the prestart job entry.

Prestart Job Name

The three-part name of the prestart job never changes once a prestart job is
started. The middle name of the three-part job name always contains the user
profile under which the prestart job is started.

Spooled File and Prestart Job Entry

If a spool file is opened before a prestart job handles any program start request, the
spool file is associated with the prestart job entry user profile; otherwise it is
associated with the current program start request user profile.

Chapter 11. Prestart Jobs 221

 If the prestart job entry profile and the current program start request user profile are
different, spooled files are spooled under a job with the first part of the three-part
job name being QPRTJOB and the second part being the name of the user profile.

Class (CLS) and Prestart Job Entry

The class (CLS) parameter on the prestart job entry provides a way to control the
performance characteristics of two classes of prestart jobs per prestart job entry.
For example, the first class may specify attribute PURGE(*NO) and the second
class may specify PURGE(*YES). This allows the class 1 jobs to attempt to stay in
main storage when waiting for a program start request.

See also “Prestart Job Entry” on page 99.

See the ICF Programming book for more information about setting up prestart job
programs that use ICF. See the APPC Programming book for more information
about setting up prestart job programs that use Common Programming Interface
(CPI) Communications.

Ending a Prestart Job

To end all jobs for a prestart job entry in an active subsystem, use the End Prestart
Job (ENDPJ) command.

222 OS/400 Work Management V4R4

Chapter 12. Job Scheduling
The job schedule function allows for time-dependent scheduling of AS/400 batch
jobs. You can schedule jobs to be released from the job queue at a particular time,
or you can use a job schedule entry to submit your job to the job queue
automatically at the time you specify.

Job scheduling allows you to control the date and time a batch job is submitted to
or becomes eligible to start from a job queue. This flexibility can help you as you
balance the work load on your system.

Scheduling a Job
To schedule a batch job, define a job schedule entry or use the Submit Job
(SBMJOB) command. The characteristics of each job make one of the scheduling
methods more effective for that job.
v To control the time a job is submitted to the job queue, define a job schedule
entry using the Add Job Schedule Entry (ADDJOBSCDE) command. The system
automatically submits a job to the job queue at the specified date and time. See
“Adding a Job Schedule Entry” on page 226.
v To control the time a job is released in the job queue, use the Submit Job
(SBMJOB) command and specify values other than the defaults for SCDDATE
and SCDTIME parameters. See “Job Schedule Entry—Benefits” on page 224 and
“SBMJOB Command to Schedule Jobs—Benefits” on page 224.

Printing a List of Scheduled Jobs

To print a list of job schedule entries, use the Work with Job Schedule Entries
(WRKJOBSCDE) command:
v For a list of jobs:
WRKJOBSCDE OUTPUT(*PRINT)
v For detailed information on each job schedule entry:
WRKJOBSCDE OUTPUT(*PRINT) PRTFMT(*FULL)
To print a list of jobs that were scheduled on the Submit Job (SBMJOB) command:
WRKSBSJOB SBS(*JOBQ) OUTPUT(*PRINT)
This command gives you a list of all the jobs on job queues; it does not
separate those that are scheduled from those that are not.

Why Schedule Jobs?

If you are tired of repeatedly submitting meeting notices, payroll, or weekly and
monthly reports, job scheduling lets you delegate the tedious jobs from your
schedule to the system’s schedule. Scheduling jobs lets you make full use of your
system—you can run jobs around the clock!
„?… What will job scheduling do for me?
Essentially, it makes your job easier because you don’t have to keep submitting
jobs. Also, it keeps you in better control of what jobs are running and when.
„?… Will I lose jobs if they are scheduled and the system goes down?

© Copyright IBM Corp. 1997, 1999 223

 Don’t worry. When you schedule your jobs, not only are they saved if the system
goes down, you can determine how the system should handle jobs that miss
their submit date and time.
„?… How can I get started?
Just use the Work with Job Schedule Entries command WRKJOBSCDE to work with
job schedule entries or type GO CMDSCDE to find a menu of all the commands
used for job scheduling.

SBMJOB Command to Schedule Jobs—Benefits

The Submit Job (SBMJOB) command is an easy way to schedule a job that only
needs to run once. It also allows you to use many of the job attributes defined for
your current job. However, since the SBMJOB command places the job on the job
queue immediately, you will lose your scheduled job if the job queue is cleared
before the scheduled date and time.

Job Schedule Entry—Benefits

Using a job schedule entry, you can schedule jobs to recur or to run only once. You
may want to schedule a job to recur if it is a repetitious task, such as calculating
payroll, filling out timecards, or sending out meeting notices. Since job schedule
entries are entries in a permanent object, they do not stay on the job queue like the
scheduled jobs, and therefore they are not lost when the job queue is cleared. You
can also save and restore the job schedule object, providing a method of backing
up your job scheduling information.

System Availability and Job Scheduling

If the system is powered down or in restricted state when scheduled times are
reached, jobs cannot be submitted from job schedule entries and the status of
scheduled jobs cannot be changed. However, the system handles this situation after
the system IPL or after it comes out of restricted state.

Using job schedule entries, you can control how each entry is handled by the value
you specify for the recovery action of the entry. You can specify that a job still be
submitted using the entry, that a job be submitted and held on the job queue, or
that a job should not be submitted. If you request that a job be submitted, only one
job is submitted from each entry, no matter how many submissions were missed
while the system was not available.

Using scheduled jobs, the system checks to determine if any scheduled times have
passed while the system was not available. If a scheduled job with a passed time is
found, the job’s status is updated.

Note: The job schedule entries and the scheduled jobs are processed in the order
that the missed occurrences would have been handled normally. However,
this is not required to complete before the system becomes available again.
Therefore, work from other sources may enter the system while missed job
schedule entries and scheduled jobs are being processed.

224 OS/400 Work Management V4R4

SBMJOB Scheduled Jobs

How Jobs Are Scheduled Using SBMJOB

A job scheduled using the SBMJOB command is released from the job queue at the
scheduled time.
1. A user issues the SBMJOB command with the SCDDATE and SCDTIME
parameters specified.
2. The job remains on the job queue in a scheduled state (SCD status) until the
date and time indicated by the parameters.
3. At the scheduled time, the job is released from the job queue. The job’s status
changes from scheduled (SCD) to released (RLS), unless the job is held (SCD
HLD), in which case it changes from scheduled to held (HLD).
4. The job is then processed like any other job on the job queue.
5. The job starts if the normal conditions (such as a job queue allocated to an
active subsystem and maximum jobs not already active) exist.

Scheduled jobs (*SCD) do not necessarily start in the order they appear on the job
queue when they are all scheduled to run at the same time. To make sure they start
in a specific order, vary the scheduled starting time of each job by a minute.

Note: No message is issued to indicate the job’s status has changed.

Scheduled Jobs and a Cleared Job Queue

When a job queue with a scheduled job is cleared, the scheduled job is handled
similarly to any other job on the job queue. The job is removed from the job queue
and a message indicating that the job ended abnormally is issued to the message
queue specified on the SBMJOB command. If the deleted job needs to remain
scheduled, the program that submitted the job should monitor this message queue
and resubmit the job if it receives the message.

Job Schedule Entry

The job schedule entry contains all the information necessary to submit a job and
the scheduling information. Each entry in the object is uniquely identified by the job
name you supply and a 6-digit entry number assigned by the system. No two
entries have the same job name and entry number combination.

The job schedule entry also contains information used by the system to manage the
entry in certain situations. The information that defines the job is similar to the
parameters specified on a Submit Job (SBMJOB) command, including job name,
command, job description, job queue, user profile, and message queue. The local
data area (LDA) of the job submitted from the job schedule entry is blank when the
job starts.

Chapter 12. Job Scheduling 225

 User
ADDJOBSCDE
JOB(ABC)
CMD(CALL XYZ)
FRQ(*WEEKLY) QJOBSCD
... System Job
11 12 1
10 2
9 3 SBMJOB
8 4 JOB(ABC)
7 6 5 CMD(CALL . . .)
Adds Entry Starts Timer Specified Time JOBD(. . .)
to Job is Reached JOBQ(. . .)
Schedule .
.
.
Job Schedule Entry

Entry
Job Number Command Frequency ... Builds Job
from Entry
ABC 000123 CALL XYZ. . . *WEEKLY ...
QGPL/QBATCH QGPL/QDFTJOBD QUSER ...
Job Queue Job Description User ...
Updates Entry’s
Job Schedule QDFTJOBSCD in Library QUSRSYS Next Submission
and Submission Submits
History Job to
Job Queue

Job Queue

JOB X
JOB Y
JOB ABC

RV2W262-2

Figure 41. How Jobs Are Scheduled Using A Job Schedule Entry

Adding a Job Schedule Entry

To schedule a job by adding a job schedule entry, use the Add Job Schedule Entry
(ADDJOBSCDE) command. This command adds an entry to the job schedule
object.

Authority to Add a Job Schedule Entry

To add a job schedule entry, you must have *CHANGE authority to the job schedule
object and *USE authority to the user profile. In addition, you and the user profile
must have the following authorities to the objects referenced on the Add Job
Schedule Entry command:
v *USE authority to the job description
v *READ authority to the job queue
v *USE and *ADD authority to the message queue
v *EXECUTE authority to all the libraries associated with all these objects

Changing a Job Schedule Entry

To change a job schedule entry, use the Change Job Schedule Entry
(CHGJOBSCDE) command.

226 OS/400 Work Management V4R4

 Authority to Change a Job Schedule Entry
To change a job schedule entry, you must have the same authorities that are
required to add an entry. However, the authorities to the individual objects are
checked only if you are changing that parameter for the entry. In addition, if you do
not have *JOBCTL special authority, you can change only the entries that your user
profile added to the job schedule object.

Holding, Releasing, or Removing a Job Schedule Entry

v To hold a job schedule entry, use the HLDJOBSCDE command.
v To release a job schedule entry, use the RLSJOBSCDE command.
v To remove a job schedule entry, use the RMVJOBSCDE command.

Authority to Hold, Release, and Remove a Job Schedule Entry

When holding, releasing, or removing a job schedule entry, you must have
*CHANGE authority to the job schedule object. If you do not have *JOBCTL special
authority, you can hold, release, or remove only the entries that your user profile
added to the job schedule object.

Working with a Job Schedule Entry

To work with job schedule entries, use the WRKJOBSCDE command.

Authority to Work with Job Schedule Entries

To work with the job schedule entries, you must have *USE authority to the job
schedule object. In addition, if you want to display the details of an entry, either with
option 5=Display details or the *FULL print format (PRTFMT parameter), you must
have *JOBCTL special authority. Otherwise, you can display the details for only the
entries that your user profile added to the job schedule object.

Job Schedule Entry Commands

You can add, change, hold, release, and remove a job schedule entry using these
commands:
Table 27. Job Schedule Entry Commands
Command Description
ADDJOBSCDE Add a job schedule entry to the job schedule.
CHGJOBSCDE Change a job schedule entry. This command changes the
entry in the job schedule, but it does not affect any jobs
already submitted using this entry.
HLDJOBSCDE Hold a job schedule entry. If an entry is held, no job is
submitted at the scheduled time due to the held status.
RLSJOBSCDE Release a job schedule entry. If the scheduled time has not
yet been reached, the status is changed to scheduled
(SCD). If the scheduled time passed while the entry was
held, no jobs are submitted, and a warning message is sent
to indicate that a job or jobs were missed.
RMVJOBSCDE Remove a job schedule entry from the job schedule.

Chapter 12. Job Scheduling 227

Job Schedule Object
The job schedule object contains entries that set up a schedule of jobs. You can
schedule jobs by adding a job schedule entry to the job schedule object. The job
schedule object, QDFTJOBSCD, is in the QUSRSYS library and has an object type
of *JOBSCD. You cannot create, delete, rename, or duplicate the job schedule
object, and you cannot move it to any other library.

This job schedule object is shipped with public authority of *CHANGE. This is the
minimum authority necessary to add, change, hold, release, and remove job
schedule entries.

Saving and Restoring Job Schedule Objects

The job schedule object can be saved with the Save Library (SAVLIB), Save Object
(SAVOBJ), or Save Changed Objects (SAVCHGOBJ) command and then restored
with the Restore Library (RSTLIB) or Restore Object (RSTOBJ) command.
Restoring the job schedule object causes the next submission date to be updated
for each entry. You can restore the job schedule object to the system from which it
was saved or to a different system, but you cannot restore it to a library other than
QUSRSYS. If you restore the job schedule object to a different system, the job
submission history is cleared in each entry.

Damaged Job Schedule Object

If an attempt to access a damaged job schedule is made, the object is deleted and
an empty job schedule is created. If the job schedule object is damaged, you can
restore the job schedule object during normal system operations. The restore
operation does not require that the system be taken to restricted state. When the
object is restored, the next occurrence for each job schedule entry is calculated and
normal job scheduling starts again.

Non-Default Values Used with a Job Schedule Entry

The following parameter values are used when the job is submitted on a job
schedule entry. These values are not default values (of the SBMJOB) and you do
not specify them in the job schedule entry:
Print device
*JOBD
Output queue
*JOBD
Print text
*JOBD
Routing entry
*JOBD
Initial library list
*JOBD
System library list
*SYSVAL
Current library
*USRPRF

228 OS/400 Work Management V4R4

 Coded character set ID
*USRPRF
Language ID
*USRPRF
Country ID
*USRPRF
Sort sequence
*USRPRF

If option 10 is used to submit a job immediately from the Work Job Schedule Entry
display, the displayed values should be reviewed for appropriateness and changed
as needed.

Different Calendars on Different Systems—Tips

If you have a calendar that is not Gregorian, take note of the following:

Restoring the job schedule object

Use extreme caution when restoring the job schedule object to a system that has a
different calendar. You must properly change each entry to ensure that the
scheduling information is correct for the current calendar. Failing to update the
entries may cause unpredictable job scheduling.

Other Considerations
v Supporting days of the week
The support for days of the week (Monday through Sunday) may not work
correctly if the system is using a non-Gregorian calendar. Use of these values on
a non-Gregorian calendar is not prohibited, but the scheduling occurs according
to the Gregorian calendar for those entries.
v Changing the QLEAPADJ system value
Changing the QLEAPADJ system value may cause unpredictable job scheduling
unless you update the entries to ensure that the scheduling information is correct
or you restore the job schedule object.
v Using dates that are not valid
When you use a date that does not exist (such as 2/29 in a year that is not a
leap year), you receive a message instructing you to correct that entry. Jobs are
not submitted from an entry if the date is not valid.

List Job Schedule Entries (QWCLSCDE) API

To use the SCDL0100 format of the List Job Schedule Entries API, you must have
*USE authority to the job schedule object. To use the SCDL0200 format, you must
have *JOBCTL special authority in addition to *USE authority to the job schedule
object. If you do not have *JOBCTL special authority, you cannot see all the
information available for the job schedule entries.

For more information on the QWCLSCDE API, see the System API Reference .

Chapter 12. Job Scheduling 229

Job Schedule Entry Examples

Schedule a Job Monthly—Example

This example shows how to submit a job to run program INVENTORY at 11:30 p.m.
on the last day of every month except on New Year’s Eve.
ADDJOBSCDE JOB(MONTHEND)
CMD(CALL INVENTORY)
SCDDATE(*MONTHEND)
SCDTIME('23:30:00')
FRQ(*MONTHLY)
OMITDATE('12/31/93')

Schedule a Job Daily—Example

This example shows how to submit a job to run program DAILYCLEAN every day at
6:00 p.m. The job runs under the user profile SOMEPGMR. This job is not
submitted if the system is down or is in restricted state at that time.
ADDJOBSCDE JOB(*JOBD)
CMD(CALL DAILYCLEAN)
SCDDAY(*ALL) SCDTIME('18:00:00')
SCDDATE(*NONE)
USER(SOMEPGMR)
FRQ(*WEEKLY) RCYACN(*NOSBM)

Schedule a Job Weekly—Example

This example shows how to submit a job to run program PGM1 every week starting
on 12/17/93 at the current time. Because 12/17/93 is a Friday, the job is submitted
every Friday, and it runs under the user profile PGMR1.
ADDJOBSCDE JOB(*JOBD)
CMD(CALL PGM1)
SCDDATE('12/17/93') FRQ(*WEEKLY)
USER(PGMR1)

Schedule a Job Every Third Monday and Wednesday—Example

This example shows how to submit a job to run program PGM2 on the third
Monday and the third Wednesday at 11:30 p.m. This job will be submitted on the
next third Monday or third Wednesday at 11:30 p.m., depending on whether those
days have passed already this month. If yesterday was the third Monday, today is
the third Tuesday, and tomorrow is the third Wednesday, it will be submitted
tomorrow, and then not again until next month.
ADDJOBSCDE JOB(*JOBD)
CMD(CALL PGM2)
SCDDAY(*MON *WED) FRQ(*MONTHLY)
SCDDATE(*NONE)
RELDAYMON(3) SCDTIME('23:30:00')

Schedule a Job Every First and Third Monday—Example

This example shows how to submit a job to run program PAYROLL on the first and
third Monday of every month at 9:00 a.m. The job runs under user profile
PAYROLLMGR.

230 OS/400 Work Management V4R4

 ADDJOBSCDE JOB(PAYROLL)
CMD(CALL PAYROLL)
SCDDAY(*MON) FRQ(*MONTHLY)
SCDDATE(*NONE)
RELDAYMON(1 3) SCDTIME('09:00:00')
USER(PAYROLLMGR)

Schedule a Job Every Weekday—Example

This example shows how to submit a job to run PGM4 every weekday at 7:00 p.m.
ADDJOBSCDE JOB(*JOBD)
CMD(CALL PGM4)
SCDDAY(*MON *TUE *WED *THU *FRI)
SCDDATE(*NONE)
SCDTIME('19:00:00') FRQ(*WEEKLY)

Save a Job Schedule Entry—Example

This example shows how to submit a job once and save the entry.
ADDJOBSCDE JOB(*JOBD)
CMD(CALL SAVED)
FRQ(*ONCE)
SAVE(*YES)

Job Schedule Entry Messages

You can use system messages to retrieve an entry number, monitor entry removal,
or to generally monitor the status of your job scheduling.

Adding a Job Schedule Entry

When an entry is added, either CPC1238 or CPC1244 (added with warnings) is
returned. The entry number assigned to the entry can be retrieved from this
message.

Successfully Submitting a Job from a Job Schedule Entry

When the job schedule system job submits a job, either CPC1236 or CPC1242
(submitted with warnings) is sent to the message queue specified for the entry and
to the QHST log to record the job submission. If the job schedule entry does not
specify a message queue, CPC1243 is sent to the QSYSOPR message queue only.

Failing to Submit a Job from a Job Schedule Entry

When the system fails to submit a job, either CPI1119, CPI1120, or CPI1141 is sent
to the message queue specified in the entry and to the QSYSOPR message queue
in library QSYS to notify you of the failed job submission. If the job schedule entry
does not specify a message queue, CPI1142 is sent to the QSYSOPR message
queue only.

Removing a Job Schedule Entry

When the system job removes a single-submission entry or when an entry is
removed by the Remove Job Schedule Entry (RMVJOBSCDE) command, CPC1239
is sent to the message queue specified in the entry. If a single-submission entry

Chapter 12. Job Scheduling 231

 was held when its scheduled time was reached and the entry specified *NO for its
save attribute, the entry is removed when it is released with the Release Job
Schedule Entry command. In this case, CPC1245 is sent to the message queue
specified in the entry.

Job Scheduling Entry Messages—Coding Example

The following example program retrieves the entry number from the message
automatically and then uses it to change the entry.

232 OS/400 Work Management V4R4

PGM

/* Declare program variables */

DCL VAR(&ENTRYID) TYPE(*CHAR) LEN(6)
DCL VAR(&MSGDATA) TYPE(*CHAR) LEN(50)
DCL VAR(&MSGDLEN) TYPE(*DEC) LEN(5 0) VALUE(50)
DCL VAR(&MSGID) TYPE(*CHAR) LEN(7)

/* Issue Add Job Schedule Entry command */

ADDJOBSCDE JOB(EXAMPLE) CMD(WRKDSKSTS +
OUTPUT(*PRINT)) FRQ(*WEEKLY) +
SCDDATE(*NONE) SCDDAY(*FRI) +
SCDTIME('18:00:00')

/* Check for function check */

MONMSG MSGID(CPF0000) EXEC(GOTO CMDLBL(ADDFAIL))

/* Receive last message */

RCVMSG MSGTYPE(*LAST) RMV(*NO) MSGDTA(&MSGDATA) +
MSGDTALEN(&MSGDLEN) MSGID(&MSGID)

/* Check for correct completion message */

IF COND(&MSGID *NE 'CPC1238') +
THEN(GOTO CMDLBL(ADDFAIL))

/* Retrieve entry number from message data */

CHGVAR VAR(&ENTRYID) +
VALUE(%SUBSTRING(&MSGDATA 31 6))

/* Issue Change Job Schedule Entry command */

CHGJOBSCDE JOB(EXAMPLE) ENTRYNBR(&ENTRYID) +
SCDDAY(*MON *WED *FRI)

/* Check for function check */

MONMSG MSGID(CPF0000) +
EXEC(GOTO CMDLBL(CHGFAIL))

/* Branch to end of program */

GOTO CMDLBL(ENDOFPGM)

ADDFAIL:
/* Branch point for failure on ADDJOBSCDE command */
SNDPGMMSG MSG('Add Job Schedule Entry Failed')
GOTO CMDLBL(ENDOFPGM)

CHGFAIL:
/* Branch point for failure on CHGJOBSCDE command */
SNDPGMMSG MSG('Change Job Schedule Entry Failed')

ENDOFPGM:
/* End of program */
ENDPGM

Figure 42. Job Scheduling Entry Messages

Changes to QDATE and QTIME and Job Schedule Entries

Changes to the QDATE and QTIME system values affect job scheduling.

Chapter 12. Job Scheduling 233

Moving the date or time backward
If you move the date or time backward, the scheduled date and time of the job
schedule entries are not calculated again. If you want the submission dates and
times for the job schedule entries calculated after you move the date and time
backward, you must restore the job schedule object.

Moving the date or time forward

If you move the date or time forward while the system is not in restricted state, the
job schedule entries with scheduled times falling within the time change are
submitted immediately and only once. The next submit times for the entries are
calculated based on the current time.

If you move the date or time forward while the system is in restricted state, the job
schedule entries with scheduled times falling within the time change are treated as
if they had expired in restricted state. When the system comes out of restricted
state, the recovery action is applied to the entries and the next submit time for the
entries is calculated based on the current time.

If you do not want the jobs submitted when a date or time is moved forward, the
entries should be held. Then, when the time is moved forward, you receive
messages for the missed occurrences, and the next submit time for the entries is
calculated based on the current time. You only need to release all the held entries
for normal processing to resume.

234 OS/400 Work Management V4R4

Chapter 13. System Jobs
A system job is a job created by the OS/400 operating system. Work such as
controlling system resources and scheduling jobs is performed by system jobs.
System jobs can be divided into the following categories:
v Start-control-program-function (SCPF)
v System arbiter
– QSYSARB
– QSYSARB2
– QSYSARB3
– QSYSARB4
– QSYSARB5
v Logical unit services (QLUS)
v Work control block table cleanup (QWCBTCLNUP)
v Performance adjustment (QPFRADJ)
v Database server (QDBSRV01..N)
v Decompress system object (QDCPOBJ1..N)
v Job schedule (QJOBSCD)
v System spool maintenance (QSPLMAINT)
v Alert manager (QALERT)
v LU 6.2 resync (QLUR)
v File System (QFILESYS1)
v Database cross-reference system job (QDBSRVXR and QDBSRVXR2)
v Database parallelism (QQQTEMP1 and QQQTEMP2)
v Communications system jobs (QSYSCOMM1)
v Remote file system communications (Q400FILSVR)
v Communications arbiters (QCMNARB01.....N)

Start-Control-Program-Function (SCPF) System Job

The SCPF system job provides the environment and directs the functions necessary
to start the OS/400 licensed program during an initial program load (IPL). Elements
of the SCPF function call several module and non-module interfaces that perform
functions such as checking for and displaying deferred program change prompts,
displaying the SCPF sign-on prompt, and initiating the system arbiter process.

The SCPF job remains active (at a priority equal to batch jobs) after the operating
system is started, providing an environment for the running of low-priority and
possibly long-running system functions. The SCPF job also ends the machine
processing after the arbiter ends.

System Arbiter System Job

The system arbiters (QSYSARB and QSYSARB2 through QSYSARB5), started by
an SCPF system job, provide the environment for the running of high-priority
functions. They allow subsystems to start and end and keep track of the state of the
system (for example, a restricted state).

© Copyright IBM Corp. 1997, 1999 235

 The system arbiters, identified by the job name QSYSARB and QSYSARB2 through
QSYSARB5, are the central and highest priority jobs within the operating system.
Each system arbiter responds to system-wide events that must be handled
immediately and those that can be handled more efficiently by a single job than
multiple jobs.

The system arbiter (QSYSARB) is also responsible for starting the Logical Unit
Services (QLUS) job during an IPL. The system arbiter remains active until the
system is ended.

Logical Unit Services (QLUS) System Job

The logical unit services, identified by the job name QLUS, supports
communications devices. It is started by the system arbiter, even if there are no
communications devices on the system. QLUS handles the event handling for
logical unit devices (communications devices) and also acts as the manager of
communications devices.

Work Control Block Table Cleanup (QWCBTCLNUP) System Job

The work control block table (WCBT) cleanup system job is used during the initial
program load (IPL) for WCBT cleanup. This system job ends when it completes
processing. It usually completes processing before the end of the IPL, but it can run
after the IPL.

Performance Adjustment (QPFRADJ) System Job

The performance adjustment system job manages changes to the storage pool
sizes and activity levels. All requests to change storage pools are processed by this
job. In addition, if system value QPFRADJ is set to ’2’ or ’3’, this job will
dynamically change the sizes and activity levels of storage pools to improve the
performance of the system.

Database Server (QDBSRV01..N) System Jobs

The database server system jobs perform database access path recovery during
the IPL and normal system operation. These system jobs are started on every IPL
and are active until the system is ended. These system jobs are started for
system-managed access path protection.

Decompress System Object (QDCPOBJ1..N) System Jobs

The decompress system object system jobs decompress compressed system
objects when they are needed. These system jobs are started on every IPL.

Job Schedule (QJOBSCD) System Job

The job schedule (QJOBSCD) system job controls the job scheduling functions of
the system. This job monitors the timers for job schedule entries and scheduled
jobs. This system job starts during IPL and remains active until the system is
powered down.

236 OS/400 Work Management V4R4

System Spool Maintenance (QSPLMAINT) System Job
The system spool maintenance (QSPLMAINT) system job performs system spool
functions. The job starts during the IPL and performs the following functions:
v If the status of the job is DLTSPLF, the system job clears the data from a spool
database member after the user has specified to delete a spooled file.
v If the status of the job is RCLSPLSTG, the system job deletes spool database
members in the QSPL library that have been unused and empty. Use system
value QRCLSPLSTG to adjust the number of days to hold empty spool database
files.
v If the status of the job is SPLCLNUP, the system job performs the spool cleanup
operation.
After an abnormal IPL:
– Jobs are moved from destroyed job queues to QSPRCLJOBQ in QRCL.
– Spooled files are moved from destroyed output queues to QSPRCLOUTQ in
library QRCL.
– Spooled files on destroyed device output queues are moved to the recreated
device output queues.
When a damaged spooled database file is encountered, spooled files with data
are deleted.

Alert Manager (QALERT) System Job

The alert manager (QALERT) system job performs the tasks necessary to process
alerts. This includes such activities as processing alerts received from other
systems, processing locally created alerts, and maintaining the sphere of control.
The alert manager job remains active until the system is ended.

LU 6.2 Resynchronization (QLUR) System Job

QLUR handles the 2-phase commit resynchronization processing. The QLUR
system job is started at IPL time and remains active until the system ends.

File System (QFILESYS1) System Job

The file system (QFILESYS1) system job supports the background processing of
the file system. It makes sure that changes to files are written to main storage. It
also does several general file system cleanup activities. This system job starts
during IPL and remains active until the system is ended.

Database Cross-Reference (QDBSRVXR and QDBSRVXR2) System Job

The database cross-reference system job maintains the system-wide information
about database cross-references, SQL packages, and relational database
directories. This system job starts during the IPL and remains active until the
system is ended.

Chapter 13. System Jobs 237

 Database Parallelism (QQQTEMP1 and QQQTEMP2) System Job
The database parallelism system jobs perform asynchronous database processing
for the DB2 Multisystem. If users query distributed files, the jobs are used to speed
up the queries by doing certain tasks in parallel. This system job starts during the
IPL and remains active until the system is ended.

System Communications (QSYSCOMM1) System Job

The system communications job handles some communications activity and some
I/O system activity. This system job starts during the IPL and remains active until
the system is ended.

Remote File System Communication (Q400FILSVR) System Job

The remote file system communication system job performs the Common
Programming Interface Communications (APPN or APPC) for the Remote File
System. This system job is started with every IPL.

Communications Arbiters (QCMNARB01.....N)

| The communications arbiter system jobs process work for communications. This
| work includes communications connect, disconnect, and error recovery processing.
| The system starts these jobs during every IPL. The QCMNARB system value
| setting determines the number of communication arbiters jobs that are started.

Displaying Information about System Jobs

To display information about system jobs, use the Work with Active Jobs
(WRKACTJOB) command.
1. Enter the WRKACTJOB command; the Work with Active Jobs display appears.
2. Type a 5 in the option field next to the system job you want to display; the Work
with Job display appears.
3. Select an option from the Work with Job display to display information about the
job.

See also “Job Logs” on page 138.

238 OS/400 Work Management V4R4

 Chapter 14. Performance Tuning
| Performance tuning is a way to adjust the performance of the system either
| manually or automatically. There are many options for tuning your system. The
| concepts presented here provide you with some general guidelines.

Each system environment is unique, requiring you to observe performance and

make adjustments that are best for your environment. You can make performance
adjustments to your system in two ways:
v Automatic performance adjustments.
Most users should set up the system to make performance adjustment
automatically. When new systems are shipped, they are configured to adjust
automatically.
v Manual performance adjustments.
| Some users have much more experience and knowledge about AS/400 work
| management function and specific applications. The experienced user may want
| to perform additional tuning by manually setting specific values, such as, pool
| size, activity level, and the specific object to load into main storage.

Note: A job may consist of multiple threads, where a thread is the independent unit
of dispatchable work. For more information, see “Chapter 5. Jobs” on
page 121.

Setting Performance Values Automatically

The system can set performance values automatically to provide efficient use of
system resources. You can set up the system to tune system performance
automatically by:
v Adjusting storage pool sizes and activity levels
v Adjusting storage pool paging

Setting Up the System to Adjust Storage Pools and Activity Levels

| Use the QPFRADJ system value to control automatic tuning of storage pools and
| activity levels. This value indicates whether the system should adjust values at
| Initial Program Load (IPL) or adjust values dynamically.

You can set up the system to adjust performance at IPL, dynamically, or both.
v To set up the system to only tune at the initial program load (IPL), set system
value QPFRADJ to 1.
v To set up the system to make storage pool adjustments at IPL and to make
storage pool adjustments dynamically, set system value QPFRADJ to 2.
v To set up the system to make storage pool adjustments dynamically and not
during an IPL, set the system value QPFRADJ to 3.
The storage pool values are not reset at IPL to the initial values.

Dynamic Performance Adjustment

The dynamic tuning support provided by the system automatically adjusts pool sizes
and activity levels for shared pools to improve the performance of the system. This

© Copyright IBM Corp. 1997, 1999 239

 tuning works by moving storage from storage pools that have minimal use to pools
that would benefit from more storage. This tuning also sets activity levels to balance
the number of threads in the pool with the storage allocated for the pool. To adjust
the system, the tuner uses a guideline that is calculated based on the number of
threads.

Dynamic tuning changes the following performance values:

v *MACHINE pool size (QMCHPOOL system value)
v *BASE pool activity level (QBASACTLVL system value)
v Pool size and activity level for shared pool *INTERACT
v Pool size and activity level for shared pool *SPOOL
| v Pool sizes and activity levels for shared pools *SHRPOOL1-60

When dynamic adjustment is in effect (QPFRADJ set to 2 or 3), job QPFRADJ that
runs under profile QSYS is seen as active on the system.

Performance Adjustment at Initial Program Load

When you perform an IPL, the system examines the machine configuration and the
controlling subsystem value (QCTLSBSD). If QPFRADJ is set to 1 or 2, the system
uses the configuration information to set the initial pool sizes and activity levels. If
the controlling subsystem is QBASE or QCTL, the system sets up separate pools
for spool and interactive jobs.

The IPL performance adjustments result in changes to the following values:

v Machine pool size (QMCHPOOL system value)
v Base pool activity level (QBASACTLVL system value) if the controlling subsystem
is QSYS/QBASE, QSYS/QCTL, QGPL/QBASE, or QGPL/QCTL
v Pool number 2 in subsystem QGPL/QSPL to use shared pool *SPOOL
v Pool size and activity level for shared pool *SPOOL
v Pool number 2 in subsystems QSYS/QBASE and QGPL/QBASE to using shared
pool *INTERACT if controlling subsystem is QSYS/QBASE, QSYS/QCTL,
QGPL/QBASE, or QGPL/QCTL
v Pool number 2 in subsystems QSYS/QINTER and QGPL/QINTER to using
shared pool *INTERACT if controlling subsystem is QSYS/QBASE, QSYS/QCTL,
QGPL/QBASE, or QGPL/QCTL
v Pool size and activity level for shared pool *INTERACT
These performance values are set to the values defined in “Setting Initial Tuning
Values” on page 242.

Note: At the first IPL after the 2617 Ethernet or 2619 token-ring card is added,
dynamic tuning does not adjust machine pool storage for the Ethernet or
token-ring networks. Machine pool storage is adjusted at the second IPL to
consider these cards.

Setting Up the System to Dynamically Adjust a Storage Pool for an

Object (Expert Cache)
To control automatic performance tuning by adjusting storage pool paging, you can:

240 OS/400 Work Management V4R4

 v Use the Change Shared Pool (CHGSHRPOOL) command (see “Using the
CHGSHRPOOL Command to Adjust Storage Pool Paging”.)
v Use the Change Pool Attributes (QUSCHGPA) API (see the System API
Reference, SC41-5801-03.)
v Use the Change Pool Tuning Information (QWCCHGTN) API (see the System
API Reference, SC41-5801-03.)

Using the CHGSHRPOOL Command to Adjust Storage Pool Paging

The paging parameter has two settings for shared storage pools: fixed paging
(*FIXED) and dynamic paging (*CALC). If performance tuning is new to you, set this
attribute to *CALC.

*FIXED
The system limits the amount of memory used by threads that are running in the
storage pool. The system transfers data from auxiliary storage and frequently writes
changed data back to auxiliary storage. Auxiliary storage is all addressable disk
storage. Main storage is all addressable storage where programs are run.

When *FIXED is specified for a pool during a performance monitor data collection,
the Storage Pool ActivityPerformance Tools/400 Component Report shows the
following:

″Expert Cache........: 0″ shown for storage pool

*CALC
The system automatically determines the best approach for handling data in the
storage pool.
v If many threads are running in a small storage pool, the system limits the amount
of memory used by each thread.
v If the storage pool for those threads has enough memory, the system determines
(object by object) how much data to bring into the storage pool.
v If objects are referred to sequentially, the system brings larger blocks of data into
memory and delays writing changes of the data. This reduces the number of I/O
operations issued by the job and reduces the contention for disk drives, which, in
turn, reduces the time that jobs wait on I/O requests.
When *CALC is specified for a pool during a performance monitor data collection,
the Storage Pool ActivityPerformance Tools/400 Component Report shows the
following:

″Expert Cache........: 3″ shown for storage pool

v If objects are referred to randomly, the system does not bring in large blocks of
data because that does not reduce the number of I/O operations.

One advantage for using Expert Cache (*CALC) is that the system dynamically
determines which objects should have larger blocks of data brought into main
storage. This is based on how frequently the object is accessed. If the object is no
longer accessed heavily, the system automatically makes the storage available for
other objects that are accessed. If the newly accessed objects then become heavily
accessed, the objects have larger blocks of data placed in main storage.

Chapter 14. Performance Tuning 241

 In some cases, the object access performance is improved when the user manually
defines (names a specific object) which object is placed into main storage. For
additional information , see “Moving an Object into a Main Storage Pool” on
page 257

If you tune using *CALC and the system ends abnormally, the recovery time could
be longer than the recovery time would be with fixed paging.

See also:
v DB2 UDB for AS/400 Database Programming, SC41-5701-02
v QWCCHGTN API in the System API Reference, SC41-5801-03
v QUSCHGPA API in theSystem API Reference

Setting Performance Values Manually

Manual tuning, unlike automatic tuning, requires that you, rather than the system,
monitor and adjust the performance of your system. After you set initial tuning
values, review system performance, and adjust accordingly, you continue to monitor
and adjust the performance of your system on an ongoing basis. When applying
these tuning techniques, change the value of QPFRADJ to 0. Otherwise, the system
changes the settings of the performance values that you have set.

Setting Initial Tuning Values

Setting initial tuning values includes the steps you can take to initially configure the
system pool sizes and activity levels to tune your system efficiently. The initial
values are based on estimates; therefore, the estimates may require further tuning
while the system is active. The following are the steps to set the initial tuning:
v Determining initial machine pool size
v Determining initial user pool sizes

Note: You may choose to let the system automatically tune performance values.
For more information, see “Setting Performance Values Automatically” on
page 239.

Determining Initial Machine Pool Size

Maintaining low page fault rates in the machine pool helps the system perform
better. You can set the pool sizes to keep the page fault rate low.

To determine the initial machine pool size, use the following formula as a guideline:
S = M + J + L + F + D

where:
S Initial machine pool size
M Minimum machine pool size (see “Minimum Machine Storage Size” on
page 243)
J Job space (see “Job Space” on page 243)
L Communications space (see “Communications Space” on page 243)
F Functional space (see Table 28 on page 243)

242 OS/400 Work Management V4R4

 D Disk space

Minimum Machine Storage Size

| To determine the value for the minimum machine pool size, multiply the main
| storage size for your system by .04, then add 12288K (12MB). The following is an
| example for a 256MB (262144KB) system:

| 262144 × .04 + 12288 = 22774K

| 22774K (22.24MB) is the minimum machine pool size.

| Job Space
Job space is set aside in the machine pool for each active job in the system. For
each job on the system, add 4K. For example, if 100 jobs are active on the system,
add 400K to the machine pool.

Communications Space
For each line, protocol, line type, and controller, the machine pool must include
some additional main storage. To estimate the additional main storage needed for
communications space, complete the following steps:
1. Add 125KB for each line.
2. Add 100KB for each protocol (BSC, SDLC, asynchronous, and so on).
3. Add 25KB for each remote workstation controller.

Note: If you have a 2617 Ethernet or a 2619 token ring card, add 1.5MB for
each card. You can ignore adding 125KB for each line associated with
each card.
4. Add 1.5MB for each 2618, 2665, or 2666 communications card. You can ignore
adding 125KB for each line associated with each card.
5. Add 1 MB for each 2662 communications card. You can ignore adding 125KB
for each line associated with each card.
6. Add 3600KB for each File Server I/O Processor with one local area network
(LAN) adapter. Add 5400KB for each File Server I/O Processor with 2 LAN
adapters.

Functional Space
Certain system functions, when active, require additional space in the machine pool.

If you plan to use any of the functions shown in Table 28, locate each and add the
| appropriate amount of main storage to the machine pool.
| Table 28. Functional Space
| Function Addition to Machine Pool
| 3270 emulation or remote attachment 50KB
| Save or restore 68KB1
| Double-byte character set 50KB
| X.25 48KB
| Token-ring local area network2 250KB
| OfficeVision 600KB

Chapter 14. Performance Tuning 243

| Table 28. Functional Space (continued)
| Function Addition to Machine Pool
| Notes:
1
| For each Save or Restore operation occurring at the same time.
2
| See “Communications Space” on page 243 for additional allocation amounts.
|

| Disk Space
Several tasks and data areas are needed to support disk drives. For each of the
first 64 drives, use 64KB. For each drive beyond 64, use 20KB. For example, if you
have 80 drives, the disk space is:

64 × 64 + 16 × 20 = 4416

Setting Machine Pool Size

To set the machine pool size, use the Change System Value (CHGSYSVAL)
command to change the QMCHPOOL system value or use the Change Shared
Pool (CHGSHRPOOL) command.

Determining Initial User Pool Size

After you have set the machine pool size, you need to decide what to do with the
remaining storage. Your choices include:
v Create no additional pools
v Create a separate pool for interactive jobs, for example the *INTERACT shared
pool in the QINTER subsystem
v Create a separate pool for spool jobs, for example the *SPOOL shared pool in
the QSPL subsystem

Creating Separate Pools

To create separate pools for QINTER and QSPL:
1. Determine the initial values for the size and activity levels for the spool pools by
adding the values from Table 29 and Table 30.
2. Use the following equation to calculate the size of QINTER:
(main storage − machine pool− QSPL) × .7

You can set the activity level to a value equal to one fourth of the estimated
number of active jobs in QINTER. Usually, only a small number of users in
QINTER are actively using the processor; most of the jobs are in a long wait
state. Therefore, one fourth was selected as an estimate for active jobs. The
activity level should not, however, be less than 5.
3. For each secondary (or additional thread) thread, 4K of storage will be reserved
for the user pool in which the thread was initialized.
4. The remaining storage is left in the *BASE pool. Set the activity level to a value
that is between 5 and 30, depending on the size of your system. For small
systems with ≤56M of main storage, use a value of 5. For large systems with
≥1.5GB of main storage, use a value of 30.

Table 29 on page 245 shows the QSPL pool sizes and activity levels for advanced
function printers.

244 OS/400 Work Management V4R4

 If you have more than 3 writers, add 200K per job and increase the activity level by
1 for each writer.
Table 29. QSPL Pool Sizes and Activity Levels for Advanced Function Printers
Number of Active Writers Size (KB) Activity Level
1 1500 1
2 1700 2
3 1900 3
>3 Add 2000K per job Increase activity level by 1

Table 30 on page 245 shows the QSPL pool sizes and activity levels for
non-advanced function printers.

If you have more than 3 writers, add 80K per job and increase the activity level by 1
for each writer.
Table 30. QSPL Pool Sizes and Activity Levels for Non-Advanced Function Printers
Number of Active Writers Size (KB) Activity Level
1 256 1
2 256 2
3 256 3
>3 Add 80K per job Increase activity level by 1

Observing System Performance

To observe system performance, use the Work with System Status (WRKSYSSTS),
Work with Disk Status (WRKDSKSTS), and Work with Active Jobs (WRKACTJOB)
commands.

After you have set initial pool sizes and activity levels, you should begin to observe
system performance. With each observation period, you should examine and
evaluate the measures of system performance against your performance goals.
1. Remove any irregular system activity. Interactive program compiles,
communications error recovery procedures (ERP), open query file (OPNQRYF),
application errors, and sign-off activity are examples of irregular activities that
may cause severe performance degradation.
2. Use the WRKSYSSTS, WRKDSKSTS, WRKACTJOB, and commands to display
performance data. You can also use the Performance Tools command, Work
with System Activity (WRKSYSACT) to display performance data.
3. Allow the system to collect data for a minimum of 5 minutes.
4. Evaluate the measures of performance against your performance goals. Typical
measurements include:
v Interactive throughput and response time, available from the WRKACTJOB
display.
v Batch throughput. Observe the AuxIO and CPU% values for active batch jobs.
v Spool throughput. Observe the AuxIO and CPU% values for active writers.
5. If you observe performance data that does not meet your expectations, tune
your system based on the new data. Be sure to:
v Measure and compare all key performance measures.
v Make and evaluate adjustments one at a time.

Chapter 14. Performance Tuning 245

Reviewing Performance
Once you have set good tuning values, you should periodically review them to
ensure your system continues to do well.

Ongoing tuning consists of observing aspects of system performance and adjusting

to recommended guidelines.

To gather meaningful statistics, you should observe system performance during

typical levels of activity. For example, statistics gathered while no jobs are running
on the system are of little value in assessing system performance. If performance is
not satisfactory in spite of your best efforts, you should evaluate the capabilities of
your configuration. To meet your objectives, consider the following:
v Processor upgrades
v Additional storage devices and controllers
v Additional main storage
v Application modification

By applying one or more of these approaches, you should achieve your objectives.
If, after a reasonable effort, you are still unable to meet your objectives, you should
determine whether your objectives are realistic for the type of work you are doing.

How to Determine What to Tune

Where to Look
If your system requires tuning changes, you should investigate the following:
v Processor Load
Use the following commands to determine if there are too many jobs on the
system or if some jobs are using a large percentage of processor time:
– Work with Active Jobs (WRKACTJOB)
– Work with System Activity (WRKSYSACT), which is a Performance Tools
command.
v Main Storage
Use the Work with System Status (WRKSYSSTS) command to investigate
faulting and the wait—to—ineligible transitions.
v Disk
Use the Work with Disk Status (WRKDSKSTS) command to determine if there
are either too few arms or if the arms are too slow.
v Communications
Use the following Performance Tools to find slow lines, errors on the line, or too
many users for the line:
– Performance Tools/400 Advisor
– Performance Tools/400 Component Report
– Communications Trace
v IOPs
Use the following Performance Tools to determine if any IOPs are not balanced
or if there are not enough IOPs.
– Performance Tools/400 Advisor
– Performance Tools/400 Component Report

246 OS/400 Work Management V4R4

v Software
Use the Performance Tools or the Work with Object Locks (WRKOBJLCK)
command to investigate locks and mutual exclusion (mutexes).

Using the WRKSYSACT Command to Find Processor Load

Problems
The Performance Tools command, WRKSYSACT, provides a list of active jobs that
are using CPU in the last few seconds. You can determine the specific time by
measuring the time interval between uses of the refresh key, F10. The list is sorted
by the amount of CPU seconds used. A high priority job (identified by a low
number) may use too much CPU (>50%) for an extended period of time. This may
cause poor response time for the entire system.

The following information about jobs and CPU utilization provides additional tips to
improve performance:
v If a job or small set of jobs is using a large percentage of the CPU, check the job
priority (PTY). If the priority of the job that is using too much CPU is a lower
number (better priority) than the jobs with poor performance, you may want to
specify a larger RUNPTY. Use option 5 (work with job), then option 40 (change
job) to specify a larger RUNPTY for the job or jobs that are using too much CPU.
v If the job that is using too much CPU is an interactive job that is running a batch
function (such as compiles or testcases), the user can submit work to batch or
change the priority to 50.
v If the CPU utilization is high (>80%), but all jobs seem to have an equal CPU%,
the system may have too many active jobs.

Note:

You can also use the Work Active Job (WRKACTJOB) command to change
priorities. After the WRKACTJOB screen is displayed, do the following:
1. Press F10, wait 1 minute, then press F10 again. (This ensures that you
have a good sample of data for the time period during which you are
experiencing decreased performance.)
2. Move the cursor to the CPU% column, then press F16 to sort the list so
those with the highest CPU use are at the top.
3. Press F11 to see the job priority.
4. Enter option 2, then enter RUNPTY(xx) on the command line to change
the priority for a job. The xx is the new priority.

Using the WRKSYSSTS Command to Find Problems with Main

Storage Performance
The Work with System Status (WRKSYSSTS) command provides a list of page
faulting and wait-to-ineligible transitions for each main storage pool. The assistance
level should be intermediate or advanced. Use the following steps to determine
acceptable levels of faulting and W->I transitions.
1. The machine pool (pool 1) should have fewer than 10 faults per second (sum of
db and ndb faults). Increase the pool by 10% until the faults per second are
satisfactory.
2. If your machine pool is experiencing very low— page fault rates (<0.4), you
should decrease the size of the machine pool. If the page fault rate is this low,
you may be affecting work in some other pools.

Chapter 14. Performance Tuning 247

 3. If only system jobs and subsystem programs are running *BASE, the fault rate
for that pool should be less than 30 faults per second. You will need to
decrease another pool to be able to increase *BASE.
4. For interactive pools, the W->I should be small (less than 10% of A->W). If you
see any W->I, increase the MAXACT by 5–10 until the W->I is 0. After you
increase the MAXACT value, press F10 to reset the statistics; do not use F5 to
refresh. You should wait at least 1 minute between refreshes.
5. For user pools, the fault rate alone is not necessarily a measure of good or poor
performance. Response time and throughput are the actual measures of
performance. Therefore, you should tune your pools by moving storage from
pools with better performance to pools with poor performance. Continue to
move the storage to the pool with poor performance until performance improves.
Do not decrease a pool by more than 10% at one time.
For more information about faulting, see “Understanding the Impact of Faulting
on Performance” on page 261.

For information about changing pool sizes, see “Changing the Size of a Storage
Pool” on page 88. For information about how you determine faulting guidelines that
are based on response time and throughput, see the following:
v “Using QPFRADJ Faulting Guidelines to Tune User Pools”
v “Using Faults Divided by Active->Wait to Tune Interactive Pools” on page 249
v “Using QPFRDATA to Tune User Pools” on page 249

Using QPFRADJ Faulting Guidelines to Tune User Pools

QPFRADJ calculates an acceptable level of faulting based on the number of active
threads in a pool. Even if you have QPFRADJ = ’0’ (no tuning), you can use the
same calculation to determine acceptable levels of faulting in your storage pools.
QPFRADJ uses the following table:
Table 31. QPFRADJ Faulting Levels
Pool Minimum Faults Faults Per Thread Maximum Faults
*MACHINE 10.00 .00 10.00
*BASE 10.00 2.00 100
Interactive 5.00 .50 200
Spool 5.00 1.00 100
Batch 10.00 2.00 100

QPFRADJ assumes the following:

v *INTERACT has only interactive jobs.
v *SPOOL has only spool jobs.
| v *SHRPOOL1–60 has only batch jobs.
For example, in an interactive pool, if there are 40 active threads, an acceptable
faulting rate would be:

5 + (40 × .50) = 25 faults per second

If there are 20 batch threads active in a pool, an acceptable faulting rate would be:

10 + (20 × 2.00) = 50 faults per second

248 OS/400 Work Management V4R4

If the calculation is greater than ’Maximum Faults’, then use the ’Maximum Faults’
value.

The interactive guideline of 0.50 is based on the assumption that the user enters a
transaction every 20 seconds and 10 faults per transaction is acceptable level. (10
faults per transaction per thread ÷ 20 seconds per transaction = 0.5 faults per
thread.)

The batch guideline is based on the assumption that a page fault takes .010
seconds. For 1 job, the acceptable level is 12 faults per second. Therefore, the
batch thread would spend 12% of its time page faulting (.010 × 12 × 100%). This
should be an acceptable level for most systems.

Using Faults Divided by Active->Wait to Tune Interactive Pools

For interactive pools, you can calculate the approximate number of page faults per
transaction to determine if faulting is a problem in that pool. Use the following
formula to calculate the approximate number of page faults per transaction:

((db faults + ndb faults) ÷ active —> wait) × 60

If the result of the calculation is greater than 20, and the number increases as more
users sign-on to the system, you may need to increase storage.
Notes:
1. Multiply this number by your disk response time to determine how much time
each transaction spends faulting.
2. If you have batch jobs that are running in *INTERACT, the calculation may be
misleading. In this case, move the batch jobs to a separate pool.
3. If you have a significant number of jobs that transition to a wait state. If the wait
state is not a display station wait (DSPW), the number you calculate may be
estimated accurately. To determine if your system has non-display station waits,
enter the following command and look at the STATUS field:

WRKACTJOB SBS(QINTER)

All wait states end with the letter W. Refresh the screen every 10 seconds to
view the current wait states.

Using QPFRDATA to Tune User Pools

There is a more precise method to determine a reasonable level of page faulting in
user pools. This method is to determine the effect of paging on interactive response
time or batch throughput. This method compares the following:
v The percentage of time that is spent for page faulting
v The response time that is used for the interactive job or the elapsed time used
for the batch job.
Page faulting, itself, is not a measure of performance; response time and
throughput are measures of performance.

Enter the following command to collect the necessary data for a two-hour time
period:

STRPFRMON DATA(*SYS) MBR(xxx)

Chapter 14. Performance Tuning 249

 After 2 hours (or the time you selected to use with the command), enter the
following command:

PRTSYSRPT MBR(xxx)

The PRTSYSRPT output contains the information you will use to analyze the page
faulting rate of the interactive and batch pools.

Interactive Pools: To calculate the percentage of response time for interactive

pools that is due to page faulting, use the following formula:

((diskRt × flts ÷ tp) ÷ rt) × 100%

Where:
v flts = sum of the database and the non-database faults per second during a
meaningful sample interval for the interactive pool.
v rt = interactive response time for that interval.
v diskRt = average disk response time for that interval.
v tp = interactive throughput for that interval in transactions per second.
(transactions per hour ÷ 3600 seconds per hour)

The formula for interactive pools assumes that interactive jobs are running in their
own pool.

If flt% is less than 10% of the total response time, there is little benefit from adding
storage to the interactive pool. If the flt% is 25% or more of the total response time,
more storage may be beneficial. For more details, see Note on page 251.

Batch Pools: To calculate the percentage of time that is spent page faulting in the
batch pool, use the following formula:

flt% = flt × diskRt × 100

Where:
v flts = sum of database faults and non-database faults per second during a
meaningful sample interval for the batch pool.
v diskRt = average disk response time for that interval.

The formula for batch pools assumes that batch jobs are running in their own pool.

If multiple batch jobs are running concurrently, you will need to divide flt% by the
number of concurrently running batch jobs. The QPFRADJ journal logs the number
of jobs that currently active. For additional information, see “Setting Up the
Performance Journal” on page 259.

Higher priority jobs (other than the batch jobs in the pool you are analyzing) may
consume a high percentage of processor time. In this case, the flt% will always be
low. Adding storage to change the flt% will not help because most of the batch time
is spent waiting for the processor. To eliminate this cause, divide flt% by the sum of
flt% and batchcpu% with the following formula:

newflt% = flt% ÷ (flt% + batchcpu%)

Where:

250 OS/400 Work Management V4R4

 batchcpu% = batch CPU utilization for the
sample interval

You must again evaluate the benefit of adding storage to the pool. If flt% (or
newflt%) is less than 10%, the potential benefit is low. If flt% (or newflt%) is greater
than 25%, the potential benefit is also greater and warrants moving main storage
into this batch pool.

If flt% is low and newflt% is high, more storage and more processor time are both
needed. You can gain more processor time by either using a faster processor or
improving the priority of these batch jobs.

Notes:
v The level of improvement that will be gained by adding storage to a pool
is difficult to predict, even if the potential benefit calculated with the
formula is high. In some cases, performance will not improve by adding
storage because of the application design. In this situation, you may
need to change the application rather than adding storage to a pool.
v If expert cache is in use, the value of the calculations is also limited.
Expert cache can reduce I/Os if sufficient main storage is made
available. However, the I/Os may or may not be page faults. Therefore,
the potential flt% for the pools may be understated. In this case, the
actual performance improvement that is gained by adding main storage
could be higher than the flt% indicates.

Job Transition Data

When observing job transitions, it is usually advisable to complete a transaction
during a single time slice. This reduces the number of times the job enters and
leaves main storage. Therefore, the active-to-ineligible transitions should be 0.
However, long running transactions should not occupy activity levels for the entire
transaction. You should establish a time slice value that allows 90% of the
transactions in your environment to finish in a single time slice. An example of a
time slice value is: 3 × the average CPU per transaction. For more information
about job transition data, see “Thread State Transitions” on page 263.

Using the WRKDSKSTS Display to Observe Disk Performance

The Work with Disk Status (WRKDSKSTS) command shows you your system’s disk
activity and helps you determine the performance capabilities of your system’s
disks. Type the WRKDSKSTS command on the command line and press the Enter
key. The Work with Disk Status display appears:

Chapter 14. Performance Tuning 251

 Work with Disk Status SYS01
02/23/90 11:04:19
Elapsed time: 00:01:55

Size % I/O Request Read Write Read Write %

Unit Type (M) Used Rqs Size (K) Rqs Rqs (K) (K) Busy
1 9332 200 98.9 .4 1.2 .0 .3 1.9 1.0 1
2 9332 200 60.1 .6 1.0 .4 .2 1.0 1.0 2
3 9332 200 61.8 .5 1.6 .2 .2 1.4 1.7 2
4 9332 200 61.5 .6 .9 .3 .3 .9 .8 2
5 9332 200 61.7 .7 1.9 .3 .4 2.5 1.4 2
6 9332 200 60.5 .3 1.2 .1 .2 2.0 .7 1
7 9332 200 63.2 .9 1.2 .3 .5 1.8 .9 3
8 9332 200 56.3 .8 5.8 .4 .4 3.0 9.1 3
9 9332 200 56.1 .6 4.2 .2 .3 1.3 6.4 2

Bottom
Command
===>
F3=Exit F5=Refresh F12=Cancel F24=More keys

Note: This display may vary up to 20% from actual values. The CL Reference
(Abridged) contains a description of the WRKDSKSTS command and
formatting information.

Before observing disk status, tune your system. When viewing the Work with Disk
Status display, observe the percent busy data. Each unit (actuator) should be less
than 50% busy. If each unit is between 50% and 70% busy, you may experience
variable response times. If each unit is more than 70% busy, you do not have
enough actuators to provide good performance. The actuator is the device within
an auxiliary storage device that moves the read and write heads. If you have a
well-tuned system with actuators that exceed 50% busy, you should increase the
number of disk actuators.

| It is possible to experience inadequate performance even if only one actuator

| exceeds the 50% busy guideline. This may be caused by the placement of
| frequently used data on a single actuator. If this occurs on your system, use the
| ASP balance commands (STRASPBAL, TRCASPBAL). See the CL Reference
| (Abridged), SC41-5722-03 for information about the ASP balance commands.

An actuator may exceed the 50% guideline for a short period of time. This condition
may be caused by a batch job that is accessing data. If the data is not concentrated
on a particular actuator, the high level of use should migrate from actuator to
actuator while the batch job is running. Also, an actuator in an auxiliary storage pool
(ASP) may be used heavily. But typically this is not considered to exceed the
guidelines. If you observe this activity, do not change the disk configuration.

Using the WRKACTJOB Display to Observe System Performance

The WRKACTJOB command measures system performance by measuring aspects
such as CPU usage and response time.

To view the Work with Active Jobs display, type WRKACTJOB on any command
line, and press the Enter key. To start (or end) an automatic refresh of information
on the display that you are viewing, press F19. The information is updated

252 OS/400 Work Management V4R4

 automatically at time intervals that are specified on the INTERVAL parameter value.
See the CL Reference (Abridged), SC41-5722-03 for details about the
WRKACTJOB command.

The following examples show the WRKACTJOB displays.

Work with Active Jobs SYS01
02/23/90 11:04:44
CPU %: .0 Elapsed time: 00:00:00 Active jobs: 67

Type options, press Enter.

2=Change 3=Hold 4=End 5=Work with 6=Release 7=Display message
8=Work with spooled files 13=Disconnect ...

Opt Subsystem/Job User Type CPU % Function Status

QBASE QSYS SBS .0 DEQW
USER1 USER1 EVK .0 ICFW
USER1 USER1 EVK .0 * -PASSTHRU EVTW
USER1 USER1 EVK .0 * -PASSTHRU EVTW
USER1 USER1 EVK .0 * -PASSTHRU EVTW
USER2 USER2 EVK .0 * -PASSTHRU EVTW
USER2 USER2 EVK .0 * -PASSTHRU EVTW
USER3 USER3 EVK .0 * -PASSTHRU EVTW
DSP020000 PGRENGS INT .0 MNU-PROGRAM DSPW
More...
Parameters or command
===>
F3=Exit F5=Refresh F7=Find F10=Restart statistics
F11=Display elapsed data F12=Cancel F23=More options F24=More keys

To display information about elapsed data, press F11 to obtain the following display:
Work with Active Jobs SYS01
02/23/90 11:04:44
CPU %: .0 Elapsed time: 00:00:00 Active jobs: 67

Type options, press Enter.

2=Change 3=Hold 4=End 5=Work with 6=Release 7=Display message
8=Work with spooled files 13=Disconnect ...
--------Elapsed---------
Opt Subsystem/Job Type Pool Pty CPU Int Rsp AuxIO CPU %
QBASE SBS 2 0 813.8 0 .0
USER1 EVK 2 20 2.1 0 .0
USER1 EVK 2 50 .4 0 .0
USER1 EVK 2 50 .2 0 .0
USER1 EVK 2 50 .2 0 .0
USER2 EVK 2 50 .1 0 .0
USER3 EVK 2 50 .2 0 .0
USER4 EVK 2 50 .2 0 .0
DSP020000 INT 3 20 15.7 0 .0 0 .0
More...
Parameters or command
===>
F3=Exit F5=Refresh F7=Find F10=Restart statistics
F11=Display thread data F12=Cancel F23=More options F24=More keys

While using the WRKACTJOB command, if you position the cursor on a column
and press F16, the items displayed are sorted according to the entries in that
column.

Advanced Tuning
After you have had some time to observe your system’s performance, you may
want to consider more specialized tuning for your environment. Some
considerations are:

Chapter 14. Performance Tuning 253

 v Using PURGE(*NO) for interactive jobs
v Separating batch work from *BASE
v Using multiple pools for interactive jobs
v Using multiple pools for batch jobs
Because the system does authority checking on an object each time it is accessed,
the best performance can be achieved by using the public authority for the object
and granting no private authorities.

Batch Job Storage Guidelines

Table 32. Batch Job Storage Guidelines
Batch Job Type Initial Storage Comments
Short-Running Production 1250KB May run in 800KB; may
require as much as 1750KB
Long-Running Production 2500KB May run in 1250KB; runs
better in 3500KB
Compiles 16000KB May run in 12000KB; runs
better in 24000KB
Reformat (Sort) 2000KB Smaller sorts may run in
1500KB; larger sorts may
use 2000 to 3000KB
Queries 2000KB Smaller queries run in
1500KB; larger queries may
use up to 4000KB
Save/Restore 2000KB Some SAVE operations run
in 1000KB; others may need
3000KB

Specifying PURGE(*NO) for Interactive Jobs

The characteristics of interactive jobs are different when PURGE(*NO) is specified
on the job class rather than PURGE(*YES). In environments with sufficient main
storage, you may want to specify PURGE(*NO).

Environments that will benefit from running PURGE(*NO) are environments with:
v A lot of main storage
v A high volume of transactions

Jobs with more than one active thread are never purged, regardless of how you
specify the PURGE attribute.

To determine the pool size when PURGE(*NO) is running, you can multiply the
number of threads running in the pool by 750KB. If the result of your multiplication
is approximately equal to your pool size, set the PURGE attribute to *NO. See
“PURGE Parameter Affects PAGs” on page 265 for additional information.

Separating Batch Work from *BASE

Performance for batch work may improve if the jobs are moved to a separate pool.
Batch work includes traditional batch jobs and other non-interactive functions, such
as Internet server jobs, and database server jobs. Batch jobs share *BASE storage

254 OS/400 Work Management V4R4

with system jobs (for example, SCPF, QSYSARB, and subsystem monitors) and
system transients (for example, file OPEN and CLOSE). As a result, batch jobs
compete for space in the *BASE pool.

To move batch jobs out of the *BASE pool:

1. Calculate the size of the pool for each job running at the same time. Use the
sizes shown in Table 32 on page 254 as an initial estimate for each job.
2. Set the activity level to be equal to the number of jobs running at the same
time.
3. In addition to the pool MAXACT value, you will need to set the maximum
number of active jobs for QBATCH job queue. This value determines how many
jobs run concurrently in the QBATCH subsystem. The default of 1 may be too
restrictive. If you have large systems, you may need to increase the number
until the CPU utilization approaches 100%. The following example shows how to
change the maximum number of active jobs to 3 with the Change Job Queue
Entry (CHGJOBQE) command:

CHGJOBQE SBSD(QBATCH)
JOBQ(QBATCH) MAXACT(3)

Batch Performance Example

A pool has three batch jobs running. One job is a compiler, one is a short-running
production job, and the third is a long-running production job. In this case the pool
size would be 19750KB (16000KB + 1250KB + 2500KB) and the activity level would
be 3.

If batch is not active, the storage allocated to a private batch pool is not used. This
does not make efficient use of main storage. However, if you use a shared pool and
choose one of the dynamic tuning options (QPFRADJ set to ’2’ or ’3’), storage not
being used by batch jobs will be allocated to pools with active jobs.

Change Routing Entry Example

To run jobs in separate pools rather than the default of *BASE, you must change
the routing entry or the prestart job entry in the subsystem description. The
following examples show how to run a different pool for either a different subsystem
or the same subsystem:
v Different subsystem
– Define a new subsystem and define at least one storage pool that is different
than *BASE.
CRTSBSD SBSD(QGPL/TEST) POOLS((1 19750 3))
TEXT('Separate subsystem')
– Create a new job queue and add the job queue to the new subsystem.
CRTJOBQ JOBQ(QGPL/TESTJOBQ)
TEXT('For subsystem TEST')
ADDJOBQE SBSD(QGPL/TEST) JOBQ(TESTJOBQ)
MAXACT(4)
– Add at least one routing entry that assigns the job to a storage pool within the
subsystem.
ADDRTGE SBSD(QGPL/TEST) SEQNBR(9999)
CMPVAL(*ANY) PGM(*RTGDTA)
CLS(QSYS/WPFSERVER) POOLID(1)
– Submit the job to the new job queue.

Chapter 14. Performance Tuning 255

 SBMJOB CMD(DSPLIND LIND(ITSCTRN)
OUTPUT(*PRINT))
JOB(DSPLIND) JOBQ(QGPL/TESTJOBQ)

v Same subsystem
– Add at least one storage pool in addition to *BASE that is also different
CHGSBSD QSERVER POOLS((2 10000 10))
– Change or add a routing entry compare value for the programs you want to
run in a specific storage pool within the subsystem.
CHGRTGE SBSD(QSERVER) SEQNBR(400) POOLID(2)
v For prestart jobs, add or change the existing prestart job entry to specify the
storage pool:
CHGPJE SBSD(QSERVER) PGM(QIWS/QZDASOINIT)
POOLID(2)
Notes:
1. Jobs or programs QZDAINIT (APPC communications) and QZDASOINIT
(TCP/IP communications) are the database serving jobs provided under OS/400
Host Servers option under install license program. Their functions include Open
Data Base Connectivity (ODBC) functions requested from client personal
computers
| 2. The pool ids used in these examples are user pools. They could be a shared
| pool, such as *SHRPOOL2.

Setting Up Multiple Pools for Interactive Jobs

There are instances where distinct sets of interactive users should be isolated.
Some examples are:
v Programmers
v Users performing office-type functions exclusively
v Data entry personnel

For programmers and users performing office-type functions exclusively, you are
attempting to isolate users who are performing the same functions. Often, the
functions performed by these users are different from the functions used by all other
users. Also, some of these users may be classified as casual users, and isolating
them helps protect their objects. For data entry personnel, you are isolating
extremely active users to give the best possible response time for their activity. If
you are considering this approach, you need to determine how many users are to
be put in each pool. Then, after setting the necessary routing entries in the
subsystem description, you need to calculate a pool size, activity level, and PURGE
attribute for each pool.

Setting Up a Separate Pool for Casual Users

To set up a separate pool for casual users:
1. Set the PURGE attribute to *YES.
2. Calculate the activity level by dividing by four the number of workstations to be
routed to the pool.
3. Multiply the activity level by 600KB to set the pool size.

256 OS/400 Work Management V4R4

 Each pool should be tuned to the optimal pool size and activity level. After you have
separated work into private pools, jobs can use only the storage of the pool in
which they are running. If you have used shared pools, the dynamic tuner will
attempt to balance storage.

Setting Up Multiple Pools for Batch Jobs

Each batch job may use objects that are different from the objects used by other
batch jobs in the same pool. For example:
v Production batch jobs and program compiles do not use the same objects.
v Long-running jobs may not perform well if they share a pool with short-running
jobs.
v System/36 environment evokes may disrupt the performance of the other batch
jobs.

If you have some of these situations, you may want to set up multiple batch pools.

To separate the pools, set up a pool for each batch job type and use Table 32 on
page 254 to find the approximate size of the jobs in the pool.

Each pool should have an activity level of one and only one active job. If you have
used private pools and no work is being performed in these pools, the main storage
is not used by the system to support jobs in other pools. If you have used shared
pools, the dynamic tuner will assign storage from an inactive pool to one that is
active. For additional information , see “Storage Pools—Benefits” on page 88.

Controlling Storage Pools and Object Selection

Note: This is an advanced performance tuning function.

If you want to reduce the disk accesses needed to perform a task, controlling
individual objects and the main storage pool that contains those objects may help
you.

Moving an Object into a Main Storage Pool

To move an object into a specific main storage pool, use the Set Object Access
(SETOBJACC) command. This command moves the object more efficiently than
other functions that run on the object.

Limiting Objects in Main Storage

To limit the objects in main storage to only the ones you want:
1. Define a pool in a subsystem (with no jobs running in that pool).
2. Clear the pool using the Clear Pool (CLRPOOL) command.
3. Use the SETOBJACC command to add an object to the pool; use the same
command with the *PURGE option when you no longer need the object.

The only objects that remain in the pool will be those you select using the
SETOBJACC command.

SETOBJACC Command
In addition to bringing objects into a storage pool, the SETOBJACC command:

Chapter 14. Performance Tuning 257

 v Clears the object from all main storage pools before reading it into the specified
pool. This allows you more control over which pools provide storage for the
object.
v Transfers only those parts that existed at the time the command was issued.
Additions to an object that use space that is already allocated (in a file) or cause
additional disk space allocations are stored in the job’s pool.
v Reports the current amount of storage used within the pool. This information is
necessary to determine what objects fit in a particular storage pool.
Notes:
1. The SETOBJACC command does not affect the performance of write
operations.
2. If dynamic performance tuning is active, it is recommended that you use only
private pools with this command.

*BASE in QTSEPOOL
If you specify *BASE in the system value QTSEPOOL, the system attempts to
reduce the impact of a long-running transaction on other users in the pool. To do
this, the system runs the remainder of the transaction in the *BASE pool rather than
allowing it to complete in the interactive pool.

At the completion of the long-running transaction, the system returns the job to the
interactive pool. This action assumes that batch is running in *BASE and that the
time slice for the interactive jobs is exceeded by only a small percentage of
transactions. Usually the transactions that exceed the default time slice value of two
seconds for an interactive job are transactions that are indicative of batch-type
activity.

In general, these actions have a positive impact on system performance and *BASE
should be specified for this system value. However, the following situations may
cause a negative impact on system performance:
v *BASE is very small.
If the pool is too small, there is not enough storage to contain the work being
moved to the pool. When this occurs, the system begins to perform a large
number of disk operations. As a result, jobs are unable to perform productive disk
requests and performance is poor. If this situation occurs in your environment,
add storage to the *BASE pool.
v The activity level in *BASE is not set properly.
If the activity level is too large, either add storage to the *BASE pool or reduce
the activity level. If the activity level is too small, increase the activity level and
increase the main storage in *BASE. Jobs running in *BASE should have about
500KB per activity level to perform efficiently.

Handling Long-Running Interactive Transactions

By properly sizing *BASE and choosing an appropriate activity level, moving
long-running transactions from the interactive pool to *BASE should provide better
system performance. If system performance is not better after several tries, set
QTSEPOOL to *NONE and reset the system pool sizes and activity levels to their
original values.

258 OS/400 Work Management V4R4

 Using Dynamic Tuning Support to Determine the Minimum
Storage Pool Size
When the dynamic tuning support is making changes to storage pool sizes, the
dynamic tuning support ensures that the pools are not reduced beyond a minimum
size. Table 33 shows the minimum pool sizes for pools that are having some page
faults occur.
Table 33. Minimum Pool Size
Share Pool Minimum Pool Size
*MACHINE Minimum size determined by Licensed
Internal Code (VLIC)
*BASE Minimum size is value of QBASPOOL system
value
| *INTERACT Use the value that is larger: 600KB or 10% of
| the total main storage.
| *SPOOL Use the value that is larger: 256KB or 10% of
| the total main storage.
| *SHRPOOL 1–60 Use the value that is larger: 300KB or 10% of
| the total main storage.

Changing Minimum Pool Size: You can use the Work with System Value
(WRKSYSVAL) command to change the minimum size of the *BASE pool. You can
change the minimum pool size used by the dynamic tuning support for pools other
than *BASE with the following commands or API:
v WRKSHRPOOL command
v CHGSHRPOOL command
v QUSCHGPA API

| If no page faults occur in a pool, dynamic tuning support may reduce the size of the
| *BASE, *INTERACT, *SPOOL, or *SHRPOOL1 through 60 pools to 256KB. This
| allows other pools to use the unused storage.

Tracking Tuning Adjustments—Benefits

You can track, or journal, the system so you can see which changes have been
made to the system. An entry is made in the journal only if a change is made to a
pool size or if pool faults occur in a pool. The changes are recorded in journal
QSYS/QPFRADJ. You should know how to perform journal management
operations, such as saving a journal receiver, changing journal receivers, and
deleting old journal receivers. For more information about journal management, see
the Backup and Recovery book.

Setting Up the Performance Journal

To set up the performance adjustment journal, do the following:
1. Create a journal receiver of your choice by using the Create Journal Receiver
(CRTJRNRCV) command:
CRTJRNRCV JRNRCV(QSYS/QPFRADJ1)
2. Name the journal receiver QPFRADJ1, or select a similar name you can use to
create a naming convention such as QPFRADJ2 or QPFRADJ3, for future
journal receivers.

Chapter 14. Performance Tuning 259

 Copying Performance Changes to a File
After you create the first receiver, you can use the CHGJRN JRNRCV(*GEN)
command to create additional receivers and attach them to the QSYS/QPFRADJ
journal automatically with the correct naming convention.

Create the journal QSYS/QPFRADJ by using the Create Journal (CRTJRN)

command:
CRTJRN JRN(QSYS/QPFRADJ) JRNRCV(QSYS/QPFRADJ1)

You must use the name QSYS/QPFRADJ, and you must have authority to add
objects to QSYS. Specify the name of the journal receiver you created in the
previous step and any other options on the command.

Note: If dynamic tuning is active (system value QPFRADJ is 2 or 3), there is a

slight delay in logging entries to the journal. If you need to start logging
immediately, change the system value QPFRADJ to 1, and then change it
back to 2 or 3. This will stop and restart the dynamic tuning support.

After you create the performance journal, use the following steps to copy the
performance changes to a file:
1. Create a file of your choice by using the Create Duplicate Object
(CRTDUPOBJ) command:
CRTDUPOBJ OBJ(QAWCTPJE) FROMLIB(QSYS)
OBJTYPE(*FILE) TOLIB(MYLIB)
NEWOBJ(MYFILE)

The newly created file is formatted to match the format of the journal entries.
2. Copy the journal entries to the file by using the Display Journal (DSPJRN)
command:
DSPJRN JRN(QSYS/QPFRADJ) ENTTYP(TP)
OUTPUT(*OUTFILE) OUTFILE(MYLIB/MYFILE)

Table 34 lists the various fields (found in file QSYS/QAWCTPJE) in the performance
tuning (TP) journal entry:
Table 34. Journal Entry Formats
Field Name Description Field Attributes
TPPNAM Name of shared pool Character(10)
TPFLG1 Pool changed flag Character(1)
| TPCSIZ Current pool size Packed decimal(12,0)
| TPCRES Pool reserve size Packed decimal(12,0)
TPCACT Current activity level Packed decimal(6,0)
TPDFLT Database page faults per Packed decimal(6,2)
second
TPNFLT Nondatabase page faults per Packed decimal(6,2)
second
| TPWI Job transitions from wait to Packed decimal(12,0)
| ineligible
| TPAW Job transitions from active to Packed decimal(12,0)
| wait
TPCJOB Current number of jobs Packed decimal(6,0)
running in pool
TPAJOB Average number of jobs Packed decimal(6,0)
running in pool
| TPNSIZ New pool size Packed decimal(12,0)

260 OS/400 Work Management V4R4

 Table 34. Journal Entry Formats (continued)
Field Name Description Field Attributes
TPNACT New activity level Packed decimal(6,0)
TPVMIN VLIC minimum Packed decimal(8,0)
| TPAI Active to ineligible Packed decimal(12,0)
TPMINFLT Minimum fault rate Packed decimal(6,0)
TPJOBFLT Faults per job Packed decimal(6,0)
TPMAXFLT Maximum fault rate Packed decimal(6,0)
TPPRTY Pool priority Packed decimal(6,0)
TPMINSZ Minimum size percent Packed decimal(6,0)
TPMAXSZ Maximum size percent Packed decimal(6,0)
TPGRADE Pool grade Packed decimal(6,0)

Understanding the Impact of Faulting on Performance

You can use the faulting guidelines to determine the effects that faulting has on
performance. The following examples may help you to understand the faulting
guidelines:
v Any faults that occur for that transaction affect the response time of an interactive
transaction. Each fault adds approximately 10 to 30 milliseconds to your end-user
response time (the time that is required to read required information from disk
into main main storage). For example, if your disk response time is 20
milliseconds, and your transaction has 5 faults per transaction, then the faults will
add approximately 0.10 seconds to your end user response time (.020 × 5= .10).
v As the number of transactions increase, a given volume of faults affect a smaller
percentage of transactions. For example, if you have 10 faults per second and 10
transactions per second, you average 1 fault per transaction. However, if you
have 10 faults per second and 100 transactions per second, on average a fault
will occur for only 10% of your transactions.
Batch job duration is similarly affected by faulting.
v Each fault uses some of the cycles available in your main processor. As more
faults occur, the processor uses more cycles. Due to increased complexity, the
amount of processing cycles increases as the volume of work that is handled by
your system increases.
If you add storage to reduce your faulting rate, you also lower the utilization of
the AS/400 processor. This leaves more processing cycles available to handle
more transactions.
v As your faults increase, the amount of disk I/O increases. If you have very few
disk arms, these faults can cause your disk utilizations to increase more rapidly
than if you have many disk arms. As your disk arm utilization increases, the time
required to process disk I/Os increases.

Performance Tuning Concepts

Achieving efficient system performance requires a proper balance among system
resources. Overusing any resource affects performance. You can make the best
use of each resource by using proper settings for the work management
parameters.

Thread States
Threads running on the system can be in any of the following states:
v Active

Chapter 14. Performance Tuning 261

 v Wait
v Ineligible

Active State
An active thread exists in main storage and processes work requested by the
application. A thread in the wait state needs a resource that is not available. An
ineligible thread has work to do, but the system is unable to accept more work at
that time.

Wait State
When a thread is waiting for a resource, it may wait in main storage or it may be
removed from main storage until the resource is available. The terms short wait,
short wait extended, and long wait are used to describe a thread waiting for system
resource.

Short Wait: A thread in short wait holds an available activity level while waiting
for an activity to occur. A thread can remain in short wait for a maximum of 2
seconds. Some typical actions that cause short waits are:
v Sending a WRITE instruction to a display when *NO is specified on the Defer
Write (DFRWRT) parameter
v Sending break messages to workstations
v Specifying *YES on the Restore Display (RSTDSP) parameter on display files
v Sending STATUS messages to workstations

When using remote lines, avoid actions that cause short waits because they cause
the wait time in main storage to be much longer for a thread than if the thread was
waiting for resources at a local workstation.

Short Wait Extended: A thread is in short wait extended if it has been in short
wait for the maximum 2 seconds. After it has been in short wait for 2 seconds and
activity has not occurred, the system cancels the short wait, takes the thread out of
the activity level, and puts the thread into a long wait. In the performance reports,
this thread state transition is called a short wait extended.

Long Wait: A thread that immediately leaves the activity level is in what is called
long wait.

A specialized form of long wait, called key/think wait, occurs outside the activity
level when a thread completes a work assignment and returns to request more
work. This is the amount of time it usually takes the user to decide what data
should be entered and to type the data. When the thread receives a new
assignment, it attempts to run again. If no activity level space is available, the
thread becomes ineligible.

Other examples of long waits are:

v Record lock conflicts (when two or more threads attempt to lock the same record
of a file)
v Distributed Data Management data requests
v Data queue requests
v Tape read
v Diskette read

262 OS/400 Work Management V4R4

Thread State Transitions
The transition from one thread state to another is shown in Figure 43.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Active State(1) ┌──────┐ -
- │ ø -
- ┌─────────────────────┐ ┌───────────────────────┐ -
- │ Short wait │────────────────Ê│ Active │ -
- │ (up to 2 seconds) │ │ Threads │ -
- │ │Í────────────────│ │ -
- │ │ │ │ -
- └─────────────────────┘ └───┬──õ──┬──õ──────õ──┬┘ -
- │ │ │ │ │ │ -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
│ │ │ │ │ │
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - │ │
- - │ │
- Wait State │ │ │ │ - │ │
- │ │ │ │ - │ │
- │ │ │ │ - │ │
- ┌───────────────────────────────────────┘ │ │ │ - │ │
- │ ┌───────────────────────────────┘ │ │ - │ │
- │ │ ┌─────────────────┘ │ - │ │
- │ │ │ ┌───────────┘ - │ │
- │ │ │ │ - │ │
- │ │ │ │ - │ │
- │ │ │ │ - │ │
- ┌───ø──────────┴───────┐ ┌─────ø────────┴───────┐ - │ │
- │ │ │ │ - │ │
- │ Long Wait │ │ Key/Think Wait │ - │ │
- │ │ │ │ - │ │
- │ │ │ │ - │ │
- └──────────┬───────────┘ └──────┬───────────────┘ - │ │
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ - - - - - - - - - - - - - - --
│ │ - Ineligible State │ │ -
│ │ - ┌──────────────────┴──ø┐ -
│ └────-──Ê │ -
└──────────────────────────-──Ê Ineligible │ -
- │ │ -
- │ │ -
- └──────────────────────┘ -
- - - - - - - - - - - - - - --

(1) A thread in the active state occupies an activity level;

threads in the wait state or ineligible state do not.

Figure 43. Thread State Transitions

Activity Levels and Ineligible Queues

For interactive environments, typically there are more threads running than there is
space for them to run. When a thread attempts to run, there must be space for the
thread in main storage. Activity levels are set for each pool in the system, which
restricts the number of threads in main storage at one time. Before a thread can
become active, an activity level must be available.

If an activity level is available, the thread becomes active and begins processing in
main storage. If no activity level is available, the thread becomes ineligible. When a
thread becomes ineligible, it is placed in the ineligible queue until an activity level is
available.

By correctly managing the ineligible queue, the system may avoid unnecessary job
transitions and disk operations. As a result, proper tuning keeps the number of
threads on the queue down. Throughput and response time are more consistent.

Chapter 14. Performance Tuning 263

 Ineligible Queue and Job Priority
Sometimes threads gain priority if they are held by locks. Normally, if a thread
enters the long wait state by other than a lock conflict, it is placed behind all other
threads of equal priority already on the ineligible queue. This is called a first-in,
first-out priority queue.

However, if a thread becomes ineligible after a short wait extended or a long wait
caused by a lock conflict, it is placed in front of threads of equal priority already on
the ineligible queue. The most common reasons for this change to normal queue
placement are:
v The thread entered a long wait as a result of a lock conflict because it was active
(referring to objects in main storage) before the conflict occurred. If the wait was
short (and many are), you may be able to get the thread back into an activity
level before all of the objects the thread was using are removed from main
storage.
v When the thread has been granted the lock, it leaves the wait state. If other
threads on the ineligible queue are to use the same object, they must wait until
the object is once again available. Therefore, you want threads holding locks on
objects to use them and make them available for other threads to use. To
accomplish this, the thread moves ahead of any potential requesters.

Note: Locks may be either thread scoped or job scoped. Locks that are job scoped
are shared by all of the threads that are in that job.

Objects Used by Jobs

Each job running in the system is assigned to a storage pool. When a job is active,
it resides in its assigned storage pool. Active jobs use many different system
objects. When jobs use these objects, the objects must be in main storage. If they
are not in main storage, they must be read into main storage from their locations on
disk (auxiliary) storage. For example, some of the objects used by jobs are:
v Data areas
v File override information
v Device files
v Open file information
v Queues
v Logical files
v Subfile work areas
v Physical files

Process Access Groups

A process access group (PAG) is a group of job-related objects that can be paged
out of storage in a single operation when a job (process) enters or leaves a long
wait. Although many different object types are found in main storage, they fall into
two main categories: objects that are shared by jobs and objects that are unique to
a specific job.

When an object is shared, only one copy of the object exists. For example,
application code used by 20 jobs resides in main storage in only one place but is
used by all the jobs. However, the variables and data in the application do not have

264 OS/400 Work Management V4R4

 the same values for all jobs using the application. These portions of the application
and other unique objects are packaged as an object called a process access group
(PAG).

Whenever a job is active, the pages of the PAG that are actually used must be in
main storage. After the PAG has been written to auxiliary storage, the main storage
space is available for other jobs.

Time Slice Parameter and Tuning

Time slice is a performance tuning parameter. The time slice value is specified in
the job’s class. The value represents the amount of processing unit time each
thread in a job is allowed to use while processing a transaction. It does not
represent the elapsed time of a transaction.

If a thread fails to complete a transaction in the specified time slice, one of the
following occurs:
v If no threads of equal or higher priority are on the ineligible queue, the thread is
given another time slice, remains in main storage, and continues the transaction.
v If threads of equal or higher priority are on the ineligible queue, the thread
currently running is removed from main storage and placed on the ineligible
queue. A thread from the ineligible queue is moved into main storage and
processing continues.
v If the job is interactive and a time slice end pool is specified for the job, the
thread is moved to the time slice end pool.

PURGE Parameter Affects PAGs

PURGE is a performance tuning parameter that affects the process access group.
When transferring a job’s PAG from main storage, the system refers to the value
specified on the PURGE parameter in the job class, which is resolved when the job
first enters the system. The value for the PURGE parameter is either *YES or *NO.

Regardless of the value chosen for the PURGE parameter, the PAG will be
transferred to main storage in the same manner. There will be no automatic reading
of the PAG. All PAG pages will be transferred only when a referenced page is not in
main storage (page fault).

PURGE(*YES) in Performance Tuning

The following list describes the characteristics of the PURGE parameter when *YES
is specified:
v Adapts to work load and storage size and operates as
– *YES in limited storage
– *NO in adequate storage
– *NO when the job is running with more than one thread.
v In systems with a small amount of main storage, selecting *YES instead of *NO
results in better performance.
See also:
v “PURGE(*YES) in Performance Tuning—Benefits” on page 266.
v “PURGE(*No) in Performance Tuning” on page 266.

Chapter 14. Performance Tuning 265

 Figure 44. PURGE Parameter When Specifying *YES

PURGE(*YES) in Performance Tuning—Benefits

Specifying *YES for the PURGE parameter while you are performing performance
tuning relieves you of deciding which value to use. PURGE(*YES) is the proper
choice for most environments. Figure 44 illustrates the manner of transfer when the
job class is set to PURGE (*YES).

If your system has enough main storage for the PAGs that are used, the system
evaluates the efficiency of automatically writing the PAG. When the job leaves an
activity level, the job’s PAG is not automatically written to auxiliary storage. This
process is called dynamic PURGE and is specified by PURGE (*YES).

PURGE(*No) in Performance Tuning

When the job class is set to PURGE (*NO), the system does not read any portion
of the PAG until the job requires a part of the PAG that is not in main storage.
When this occurs, a small portion of the PAG, starting with the requested data, is
read into main storage. When the job leaves an activity level, none of the job’s PAG
is written to auxiliary storage. The job’s PAG remains in main storage until some job

266 OS/400 Work Management V4R4

currently in an activity level requires more main storage. The system assigns main
storage to the job that is currently active. At this point, a small portion of the inactive
job’s PAG is written to auxiliary storage.

The following list describes the characteristics of the PURGE parameter when *NO
is specified:
v May cause fewer WRITE operations per transaction
v May reduce disk use
v May use less processing unit time per transaction
v Requires more main storage

Figure 45 shows the manner of transfer when the job class indicates PURGE (*NO).

Job Enters an Activity Level Auxiliary Storage

Main Storage

F a u lt PAG

Job requests a part of the PAG

that is not in main storage.

Job Leaves an Activity Level Auxiliary Storage

Main Storage

W r it e PAG

System needs some main

storage that is occupied
by PAG data of a job that
is not in an activity level.
RV2W787-0

Figure 45. PURGE Parameter When Specifying *NO

Chapter 14. Performance Tuning 267

268 OS/400 Work Management V4R4
Chapter 15. Job Accounting
The job accounting function gathers data so that you can determine who is using
your system and what system resources they are using. It also assists you in
evaluating the overall use of your system.

You may request the system to gather job resource accounting, printer file
accounting data, or both.

Typical job accounting data details the jobs running in your system and the
resources they are using such as the use of the processing unit, printer, display
stations, database and communications functions.

Job accounting statistics are kept by using the journal entries made in the system
accounting journal QSYS/QACGJRN. You should know how to perform journal
management operations, such as saving a journal receiver, changing journal
receivers, and deleting old journal receivers. For more information about journal
management, see the Backup and Recovery book.

When you want to analyze the job accounting data, it must be extracted from the
QACGJRN journal by use of the DSPJRN command. With this command you can
write the entries into a database file. You must write application programs or use a
utility such as the query utility to analyze the data.

Job accounting is optional. You must take specific steps (described later in the
section “Setting Up Job Accounting” on page 279) to set up job accounting. You
may also assign accounting codes to user profiles or specific jobs.

See also “Job Accounting and Prestart Jobs” on page 221.

Journal Entries for Job Accounting

The system provides different journal entries for the different types of data that can
be gathered:
v Job resource accounting: The job (JB) journal entry contains data summarizing
the resources used for a job or for different accounting codes used in a job.
v Printer file accounting:
– Direct print (DP) journal entry: Contains data about printer files produced on
print devices (nonspooled).
– Spooled print (SP) journal entry: Contains data about printer files made by a
print writer (spooled).

Resource Accounting
Resource accounting data is summarized in the JB journal entry at the completion
of a job. In addition, the system creates a JB journal entry summarizing the
resources used each time a Change Accounting Code (CHGACGCDE) command
occurs. The JB journal entry includes:
v Fully qualified job name
v Accounting code for the accounting segment just ended
v Processing unit time

© Copyright IBM Corp. 1997, 1999 269

 v Number of routing steps
v Date and time the job entered the system
v Date and time the job started
v Total transaction time (includes service time, ineligible time, and active time)
v Number of transactions for all interactive jobs
v Auxiliary I/O operations
v Job type
v Job completion code
v Number of printer lines, pages, and files created if spooled or printed directly
v Number of database file reads, writes, updates, and deletes
v Number of ICF file read and write operations

Some of the job accounting information can also be accessed using the CPF1124
and CPF1164 messages located in the QHST log. Job accounting data available
through the QHST messages is a subset of the method described here. For more
information on QHST messages, see the CL Programming book. See “Deciding
Whether to Use Job Accounting” on page 272 to determine the method to use.

Printer File Accounting

There are two types of journal entries for printer file accounting:
v DP for nonspooled printer files
v SP for spooled printer files

These two types of journal entries share a common journal entry format although
some of the information is only available in the SP entry. The DP and SP journal
entries include information such as:
v Fully qualified job name.
v Accounting code.
v Device file name and library.
v Device name.
v Device type and model.
v Total number of pages and lines printed. If multiple copies occurred, this is the
sum of all copies.
v Spooled file name (only in the SP entry).
v Spooled file number (only in the SP entry).
v Output priority (only in the SP entry).
v Form type (only in the SP entry).
v Total number of bytes of control information and print data sent to the printer
device. If multiple copies occurred, this is the sum of all copies. (This only
applies to the SP entry.)

The DP and SP journal entries occur when the file is printed. If a spooled file is
never printed, no SP journal entry will appear.

270 OS/400 Work Management V4R4

Job Accounting Overview
Figure 46 shows an overview of job accounting as provided on the system.

Job 3 Spooled
Output Writer file
Job 2 queue job printer
Job 1

Directly
Print attached
file printer

Resource
Direct print Spooled print
accounting
(DP) (SP)
(JB)
entry entry
entry

QSYS/QACGJRN
journal

Close of an
Accounting Period

DSPJRN
command

Database

User-
supplied
program
RSLS879-2

Figure 46. Job Accounting Overview

„1… When job 1 is completed, the system summarizes the resources used and
writes the JB journal entry to the QACGJRN journal. If the accounting code
was changed during the job, a JB journal entry would be written for each
time the accounting code was changed and at the end of the job. Job 1

Chapter 15. Job Accounting 271

 does not make any printer output, and no job log is made. Therefore, no DP
or SP journal entries are made for job 1.
„2… Job 2 is printing a file directly to a printer. When the file is completed, a DP
journal entry is written summarizing the printed data. When job 2 is
completed, the system summarizes the resources used and writes the JB
journal entry. Job 2 does not make any spooled printer output and no job
log is made. Therefore, no SP journal entry is made for job 2.
„3… Job 3 is printing to a file that is spooled. The SP journal entry is not written
unless a print writer prints the file. When job 3 is completed, the system
summarizes the resources used and writes the JB journal entry. If a job log
is made at the completion of the job, it is a normal spooled file and an SP
journal entry is created if the file is printed.
„4… A print writer is started to print the files made by one or more jobs. When
the writer finishes a file, it makes an SP journal entry. The SP journal entry
is not made if the file is canceled before printing starts.
„5… At the close of an accounting period (or whenever desired), the DSPJRN
command can be used to write the accumulated journal entries into a
database file.
„6… User-written programs or the query utility can be used to analyze the
accounting data. Reports such as resources used would compile data by a
specific:
v Accounting code
v User
v Job type

How the System Manages Job and Run Priorities

The AS/400 system attempts to allocate main storage as efficiently as possible. A
job may not use the same amount of resources each time it is run. For example, if
there are several active jobs on your system, a job spends more time reestablishing
the resources needed for running than if a dedicated system environment is used.
The system uses the job and run priorities assigned to different jobs to assist in
managing main storage. Therefore, high priority jobs use less system resource than
low priority jobs.

Because of these system operating characteristics, you may want to apply your own
interpretation or algorithm to the job accounting data collected. If you are charging
for the use of your system, you may want to charge more for:
v High priority jobs
v Work done during peak system time
v Use of critical resources

Deciding Whether to Use Job Accounting

Should I use the job accounting function in QHST messages since message
numbers CPF1124 and CPF1164 are always available in the QHST log? Use the
following guidelines to decide which method will work best for you.

Job accounting has all the information supplied by CPF1164 plus:

v Accounting code

272 OS/400 Work Management V4R4

 v Number of print files, lines, and pages created by programs
v Number of database read, write, and update operations
v Number of communications read and write operations
v Actual lines and pages printed
v Time the job was active and suspended
v Actual number of bytes of control information and print data sent to the printer

Use Job Accounting Function If...

The job accounting function is more effective for gathering job accounting statistics
if:
v The resource information regarding database, printer, and communications use is
important.
v Accounting codes are assigned to users or jobs.
v The information for printed output is important.
v Job accounting must be done on an accounting segment basis in a job rather
than on a complete job basis.
v The active and suspended time information is needed.

Use QHST Messages If...

The QHST messages are more effective for gathering job accounting statistics if:
v You do not want to manage the additional objects included in journaling.
v You do not need any resource information other than that provided in the
CPF1124 and CPF1164 messages, which are sent automatically to the QHST
log.
v You do not need print accounting information.

Some statistics recorded in the CPF1164 message and the JB journal entries will
not match exactly. This is due mainly to two factors: CPF1164 statistics are
recorded slightly before the JB journal statistics; and each time an accounting code
is changed, rounding occurs for some fields, while rounding occurs only once for
CPF1164 messages.

Accounting Code
The initial accounting code (up to 15 characters in length) for a job parameter is
determined by the value of the ACGCDE (accounting code) parameter in the job
description and user profile for the job. When a job is started, a job description is
assigned to the job. The job description object contains a value for the ACGCDE
parameter. If the default of *USRPRF is used, the accounting code in the job’s user
profile is used. Note, however, that when a job is started using the Submit Job
(SBMJOB) command, its accounting code is the same as that of the submitter’s job.
You can change the accounting code after the job has entered the system by using
the Change Accounting Code (CHGACGCDE) command.

The CRTUSRPRF and CHGUSRPRF commands support the ACGCDE parameter.

The default is *BLANK. If all work for a particular user is to be recorded under one
accounting code, only user profiles need to be changed. You can change the
accounting codes for specific job descriptions by specifying the desired accounting
code for the ACGCDE parameter on the CRTJOBD and CHGJOBD commands. The

Chapter 15. Job Accounting 273

 CHGACGCDE command also allows different accounting codes in a single job. You
can develop a method of verifying the assignment of accounting codes as described
in “Validity Checking of Accounting Codes” on page 287.

The Retrieve Job Attributes (RTVJOBA) command and the APIs that retrieve jobs
allow you to access the current accounting code in a CL program.

Resource Accounting Data

A JB journal entry is written at the end of every job and any time the job accounting
code is changed by the CHGACGCDE command. A JB journal entry is written even
if the accounting code is changed while the job is on the job queue although no
resources have been used. Each resource accounting journal entry contains
information about the resources used while the previous accounting code was in
effect.

For example, Figure 47 illustrates a job with two accounting segments.

Start of Point A End of

Job │ Job
│ │ │
│ │ │
│ │ │
│ │ │
│ 1st Accounting │ 2nd Accounting │
│ Í────── Segment ────────Ê │ Í─────── Segment ──────Ê │
│ │ │
ø │ ø
│
────────────────────────────┼────────────────────────────
│
Journal Journal
Entry Entry
Written Written

Figure 47. Job with Two Accounting Segments

At point A, the CHGACGCDE command was issued. The accounting code is

changed and the JB journal entry is sent to the journal. The JB journal entry
contains data for the first accounting segment. When the job ends, a second JB
entry is made for the job containing data for the second accounting segment.

If the job accounting code was not changed during the existence of the job, the
single JB entry summarizes the total resources used by the job. If the job
accounting code was changed during the existence of the job, then you must add
up the fields in the multiple JB entries in order to determine the total resources
used by the job. The creation of a job log does not count toward the processing unit
use for a job or its printed output in the JB accounting entries. However, if you are
using print file accounting, the job log printed is included in the printer file journal
entries.

General Accounting Journal Information

Each journal entry contains the standard prefix fields for any journal entry (for
example, date, time, journal sequence number). See the Backup and Recovery
book for a discussion of these fields.

274 OS/400 Work Management V4R4

JB Accounting Journal Information
For information about the fields in the JB journal entry, see Table 35 on page 275.
Information about the various fields is found in the field reference files
QSYS/QAJBACG and QSYS/QAJBACG4.
Table 35. Fields Found in JB Journal Entry
Field Name Description Field Attributes Comments
Character (14)
JAJOB Job name Character (10)
JAUSER Job user Character (10)
JANBR Job number Zoned (6,0)
JACDE Accounting code Character (15)
JACPU Processing unit time used (in Packed decimal (11,0) See Note 1 on
milliseconds) page 276
JARTGS Number of routing steps Packed decimal (5,0)
Job entered the system
JAEDTE –Job entry date (mmddyy format) Character (6)
JAETIM –Job entry time (hhmmss format) Character (6)
Job start date and time See Note 2 on
page 276
JASDTE –Job start date (mmddyy format) Character (6)
JASTIM –Job start time (hhmmss format) Character (6)
JATRNT Total transaction time (in seconds) Packed decimal (11,0) See Note 3 on
page 276
JATRNS Number of transactions Packed decimal (11,0) See Note 4 on
page 276
JAAUX Synchronous auxiliary I/O operations Packed decimal (11,0)
and database operations (including
page faults for any reason)
JATYPE Job type Character (1) See Note 5 on
page 276
JCCDE Completion code Packed decimal (3,0) See Note 6 on
page 276
JALINE Number of print lines Packed decimal (11,0) See Note 7 on
page 276
JAPAGE Number of printed pages Packed decimal (11,0)
JAPRTF Number of print files Packed decimal (11,0)
JADBPT Number of database write operations Packed decimal (11,0) See Note 8 on
page 276
JADBGT Number of database read operations Packed decimal (11,0) See Note 8 on
page 276
JADBUP Number of database update, delete, Packed decimal (11,0) See Note 8 on
FEOD, release, commit, and rollback page 276
operations
JACMPT Number of communications write Packed decimal (11,0) See Note 9 on
operations page 277
JACMGT Number of communications read Packed decimal (11,0) See Note 9 on
operations page 277
JAACT Time job was active (in milliseconds) Packed decimal (11,0)
JASPN Time job was suspended (in Packed decimal (11,0)
milliseconds)
JAEDTL Timestamp job entered system Character (14)
(mmddyyyyhhmmss)
JAESTL Timestamp job started
(mmddyyyyhhmmss)
JAAIO Asynchronous I/O for database and Packed decimal (11,0)
non-database operations.
Chapter 15. Job Accounting 275
 Notes:
1. The processing unit time does not include processing unit use and printer
statistics for the creation of job logs.
2. For job completion date and time from journal entries, use the JODATE and
JOTIME fields that are part of the standard journal entry prefix information. (See
the Backup and Recovery book for more information on these fields.) After an
abnormal system ending, these fields contain the current date and time and not
(as with CPF1164 messages) the actual time of the system ending.
3. The total transaction time is set to -1 when:
v Time is set backward.
v An overflow occurred in a file on a computation.
v The system went down while the job was active.
4. The last transaction (SIGNOFF) is not counted.
5. The job types recorded are the following:
A Autostart job
B Batch job (includes communications and MRT)
I Interactive job
M Subsystem monitor
R Spooling reader
W Spooling writer

Note: These are the same as those used in message CPF1164, except that
message CPF1164 includes some system job information not included in
the journal entries.
6. The completion codes, which are similar to those used for message CPF1164,
are:
000 Normal completion
010 Normal completion during controlled end or controlled subsystem end
020 Job exceeded end severity
030 Job ended abnormally
040 Job ended before becoming active
050 Job ended while active
060 Subsystem ended abnormally while job was active
070 System ended abnormally while job was active
080 Job completed in the time limit
090 Job forced to complete after the time limit has ended
099 Accounting entry caused by CHGACGCDE command
7. The number of print lines does not reflect what is actually printed. Spooled files
can be canceled or printed with multiple copies. The information in the JB
journal entry reflects only what was written by the program. This excludes any
lines written for the job log. See the discussion on DP and SP printer file
accounting data later in this chapter.
8. The numbers recorded for database I/O operations do not include I/O
operations to readers and writers, or I/O operations caused by the CL

276 OS/400 Work Management V4R4

 commands CPYSPLF, DSPSPLF, or WRKSPLF. If SEQONLY(*YES) is in effect,
these numbers show each block of records read, not the number of individual
records read.
9. The numbers recorded for communications I/O operations do not include remote
workstation activity. When the I/O is for a communications device, the numbers
include only activity related to ICF files.

DP and SP Printer File Accounting Data

The accounting code used for the DP or SP journal entries is the accounting code
of the job at the time the file is closed. Sometimes a DP or SP entry is created
before the file is closed (such as when a writer which is creating a
SCHEDULE(*IMMED) file is ended). When this happens the current accounting
code of the job is used.

A DP or an SP journal entry is created for each file printed. If the job log is spooled
and then printed, an SP entry is created for it. Also, an SP entry is written for
diskette spooled files redirected to a printer by the print writer.

DP Accounting Journal Information

Table 36 lists the various fields (found in file QSYS/QAPTACG) in the DP journal
entry.
Table 36. Fields Found in the DP Journal Entry
Field Name Description Field Attributes
JAJOB Job name Character (10)
JAUSER Job user Character (10)
JANBR Job number Zoned (6,0)
JACDE Accounting code Character (15)
JADFN Device file name Character (10)
Library in which device file is
JADFNL stored Character (10)
JADEVN Device name Character (10)
JADEVT Device type Character (4)
JADEVM Device model Character (4)
Total number of print pages
JATPAG produced Packed decimal (11,0)
Total number of print lines
JATLIN produced Packed decimal (11,0)
JASPFN Always blank Character (10)
JASPNB Always blank Character (4)
JAOPTY Always blank Character (1)
JAFMTP Always blank Character (10)
JABYTE Always zero Packed decimal (15,0)
JAUSRD User data Character (10)

SP Accounting Journal Information

The information provided is similar to that provided in the DP accounting journal
data except that the spooled file name, spooled file number, output priority, form
type, and total number of bytes of control information and print data sent to the
printer are included.

Chapter 15. Job Accounting 277

 An SP journal entry is not written if a spooled file is deleted before a writer starts
writing the file to the device.

Table 37 on page 278 lists the fields (found in file QSYS/QAPTACG) in the SP
journal entry.
Table 37. Fields Found in SP Journal Entry
Field Name Description Field Attributes
JAJOB Job name Character (10)
JAUSER Job user Character (10)
JANBR Job number Zoned (6,0)
JACDE Accounting code Character (15)
JADFN Device file name Character (10)
JADFNL Library in which device file is Character (10)
stored
JADEVN Device name Character (10)
JADEVT Device type Character (4)
JADEVM Device model Character (4)
JATPAG Total number of print pages Packed decimal (11,0)
produced
JATLIN Total number of print lines Packed decimal (11,0)
produced
JASPFN Spooled file name Character (10)
JASPNB Spooled file number Character (4)
JAOPTY Output priority Character (1)
JAFMTP Form type Character (10)
JABYTE Total number of bytes sent to the Packed decimal (15,0)
printer
JAUSRD User Data Character (10)
Notes:
1. The system attempts to record the actual number of pages, lines, and bytes printed, but
when a writer is canceled *IMMED or recovers from a device error (such as end of
forms), it is not possible to determine the exact number of pages, lines, and bytes
printed.
2. Extra pages and lines produced with the alignment line are not included in the page,
line, and byte counts.
3. If a spooled file goes into WTR status (but is set to MSGW) or if the file is deleted while
in MSGW status, an SP journal entry will appear in the DP accounting journal indicating
that there are 0 pages and 0 lines printed.
4. While using a printer configured AFP(*YES), if you delete or hold a file immediately after
it has printed pages, the SP entry for that file may indicate 0 pages and 0 lines printed
although some pages were printed.
5. The page, line, and byte counts for the job and file separators are included with the
counts for the file they are associated with.
6. When an IPDS file contains graphics or bar codes and is sent to an IPDS printer that
does not support graphics or bar codes, the page, line, and byte counts include the
unprinted graphics and bar codes.
7. If printer configuration is AFP(*YES), the field for total number of print lines produced is
zero. The total number of pages produced field is correct.

Batch Processing and Job Accounting

Any batch job submitted during the running of a job using the SBMJOB command
automatically uses the same accounting code as the job that submitted the batch
job. When the SBMJOB command is used, the accounting codes cannot be
overridden regardless of how the job description entry is coded. If you want the

278 OS/400 Work Management V4R4

 batch job to operate under an accounting code other than that of the submitting
jobs, a CHGACGCDE command should be issued either:
v Before and after the SBMJOB command is issued
v Immediately by the batch job

Batch jobs submitted using a reader or a SBMDBJOB or SBMDKTJOB command

use the accounting code specified in the job description for the batch job. If the job
description specifies ACGCDE(*USRPRF), the accounting code is taken from the
user profile used for the job.

Interactive Processing and Job Accounting

If an interactive job has a fixed set of options for a user and each option has an
assigned accounting code, it may be desirable to automatically assign a new code
when the user requests to work on a new function. A typical approach would be for
a menu option to request a new functional area. The CHGACGCDE command
would then be issued within a CL program and the job values used for the previous
accounting code would be summarized in the JB accounting journal entry.

If a user has several assignments for which only he knows the accounting codes to
be used, you can:
v Give authority to the user to enter the CHGACGCDE command.
v Write a program to prompt the user for the accounting code.

Note: For source pass-through jobs, the job accounting information does not
include the target pass-through job. For target pass-through jobs, the job
accounting information does not include the associated communications
batch job.

System Job Processing for Job Accounting

System jobs that you control (for example, readers and writers) are assigned an
accounting code of *SYS. Other system jobs that you do not control (for example,
QSYSARB, QLUS, SCPF) do not receive a journal entry.

Note: You cannot use the CHGACGCDE command to change the accounting code
of the subsystem monitor or a reader or writer. You can, however, change
the accounting code of a reader or writer by changing the appropriate
IBM-supplied job descriptions and user profiles and then starting them again.
When a job is submitted with the Submit Job (SBMJOB) command, the entry
in the account journal contains the code for the submitter. The entry for the
system job is blank. However, for system jobs that the user does not control
(such as, QALERT, QLUS, or QSYSARB), the user can manually assign an
accounting code.

Setting Up Job Accounting

To set up resource or printer file accounting, perform the following:
1. Create a journal receiver in a library of your choice by using the Create Journal
Receiver (CRTJRNRCV) command:
CRTJRNRCV JRNRCV(USERLIB/ACGJRN1)

Chapter 15. Job Accounting 279

 You should name the journal receiver ACGJRN1 or a similar name that can be
used to create a naming convention such as ACGJRN2, ACGJRN3, for future
journal receivers.

After you create the first receiver, you can create additional receivers and attach
them to the QSYS/QACGJRN journal automatically with the correct naming
convention by using the CHGJRN JRNRCV(*GEN) command. You will probably
want to place the journal receiver in one of your libraries that is saved regularly.

You can specify options on the CRTJRNRCV command to assist in your

operational aspects. If you want to use dual journal receivers, you must create a
second journal receiver.
2. Create the journal QSYS/QACGJRN by using the Create Journal (CRTJRN)
command. The name QSYS/QACGJRN must be used, and you must have
authority to add objects to QSYS. You need to specify the name of the journal
receiver(s) you created in the previous step and any other options on the
command.
You should also consider who you want to have authority to this journal. It is
recommended that you change the authority parameter to AUT(*EXCLUDE).

Note: The following restrictions apply to both journals and journal receivers:
v You must restore journals and journal receivers to the same library from
which they were saved.
v You cannot rename, move, or copy journals or journal receivers.
v You cannot rename a library that contains a journal or journal receiver.
3. As the security officer, change the accounting level system value QACGLVL
using the Work with System Value (WRKSYSVAL) command or the Change
System Value (CHGSYSVAL) command. When the system value is changed,
any new jobs started on the system will automatically produce a job accounting
journal entry when the jobs are completed.
The VALUE parameter on the CHGSYSVAL command determines when job
accounting journal entries are produced: symbol=ue text=’*jobx*printxxxxx’>
VALUE Parameter
Description
*NONE
The system does not produce any entries in the job accounting journal.
*JOB The system produces a JB journal entry for each accounting segment of
a job.
*PRINT
The system produces a DP or an SP journal entry for each file printed
(either a nonspooled file or a spooled file written by a print writer).
*JOB *PRINT
The system produces both types of journal entries.

The system requires that the QSYS/QACGJRN journal be created before this
system value is changed to request job accounting.

Note: If you specify Yes to save job accounting information about completed
printer output using the Operational Assistant user interface, the
QACGLVL system value is changed to *PRINT or *JOB *PRINT if job
accounting is already on. A journal receiver and a journal are also
automatically created, eliminating the need to manually create them. If

280 OS/400 Work Management V4R4

 you change the system value later to turn job accounting off, the
completed printer output option on the Operational Assistant menu will
not be available.

For information on processing the accounting journal entries, see the section
“Converting Job Accounting Journal Entries” on page 285.

Note: If you need to record files in a journal that users have received and printed,
you must first delete all the QPRTJOB system jobs for those users. End the
QPRTJOB system job using the End Job (ENDJOB) command and option
SPLFILE(*YES). This deletes all spooled files sent to this user using the
Send Network Spooled Files (SNDNETSPLF) command and ends the user’s
QPRTJOB system job. The system value QACGLVL should be changed to
*PRINT or *PRINT *JOB. The next time a file is sent to a user, a QPRTJOB
job is created for that user and the job accounting level is correct for any
files sent to that user.

Accounting Journal Processing

The accounting journal QSYS/QACGJRN is processed as any other journal. Files
can also be recorded in this journal although for simplicity it is recommended that
you keep it solely for accounting information. You can use the SNDJRNE command
to send other entries to this journal. While there are additional operational
considerations involved in using several journals, there are advantages to not
allowing any file entries in the QACGJRN journal. It is usually easier to control the
QACGJRN journal separately so that all job accounting entries for a particular
accounting period are in a minimal number of journal receivers and that a new
journal receiver is started at the beginning of an accounting period. System entries
also appear in the journal QACGJRN. These are the entries with a journal code of
J, which relate to IPL and general operations performed on journal receivers (for
example, a save of the receiver).

For information on restrictions that apply to journals and journal receivers, see
“Setting Up Job Accounting” on page 279.

Job Accounting Entries

Job accounting entries are placed in the journal receiver starting with the next job
that enters the system after the CHGSYSVAL command takes effect. The
accounting level of a job is determined when it enters the system. If the QACGLVL
system value is changed after the job is started, it has no effect on the type of
accounting being performed for that job. The DP and SP print entries occur if the
job that created the file is operating under accounting and the system value is set
for *PRINT. If spooled files are printed after the accounting level has been set to
*PRINT or if the job that created the file was started before the accounting level
was changed, no journaling is done for those spooled files.

Additional Ways to Analyze Job Accounting Data

While the most obvious use for the accounting data is to charge users for system
resources, you may want to analyze the data in other ways. Some methods of
analyzing the job accounting information would be sequencing by the following
fields or combinations of fields:

Chapter 15. Job Accounting 281

 v Accounting code
v User
v Job type (for example, batch or interactive)
v Time of day

Each of these sequences could be processed by a separate logical file.

A typical statistical analysis of a job would be a summary which reports on the:

v Type of job run with a count of occurrences and totals on processing unit time
used
v Interactions
v Average response time
v Auxiliary I/O and file counts by type of file

Other items you may want to analyze are:

v Job termination code
v User profile name
v All jobs that exceed a certain amount of processing unit time

Security and Job Accounting

Only the security officer (or a program adopting his authority) or a user with
*ALLOBJ or *SECADM authority can change the system value QACGLVL. The
change takes effect when a new job enters the system. This restriction ensures that
if job accounting is in effect and the security officer performs system IPL, an
accounting entry is written for the security officer’s job.

Refer to the Backup and Recovery book for a discussion of the journal security
considerations.

Authority to Assign Job Accounting Codes

You can assign job accounting codes only if you have the authority to use the
CRTUSRPRF, CHGUSRPRF or CHGACGCDE command. This restricts the use of
accounting codes and provides a basis for validity checking any changes.

Only a user with the *SECADM special authority is allowed to use the CRTUSRPRF
and CHGUSRPRF commands. However, the security officer can delegate this
authority by creating a CL program, which allows another user to adopt the security
officer’s profile and change the ACGCDE parameter in the user profile. The CL
program could then have authority to one or more individuals.

The ACGCDE parameter also exists in job description objects, but the user must
have the authority to use the CHGACGCDE command to enter a value other than
the default of *USRPRF. This command is supplied with *CHANGE authority.

Authority to CHGACGCDE Command

If you allow a user to use the Change Accounting Code (CHGACGCDE) command,
that user can:
v Create or change the ACGCDE parameter in job descriptions. (Authority to create
or change job descriptions is also required.)

282 OS/400 Work Management V4R4

 v Change the accounting code in his current job.
v Change the accounting code of a job other than his own if he also has the
*JOBCTL special authority.

You can provide additional security by using the CHGACGCDE command in a CL

program, which adopts the program owner’s authority. This allows the user who is
running an external function to perform a security-sensitive function without having
direct authorization to the CHGACGCDE command.

The accounting journal and its receivers are treated as any other journal objects
from a security viewpoint. You must decide what authorization should exist for the
accounting journal and journal receiver.

Recovery and Job Accounting

If a job ends abnormally, the final accounting entry is written and all previously
written accounting entries appear in the journal.

If an abnormal system ending occurs, the following accounting data is lost to the
last routing step or last end-of-accounting segment, whichever occurred most
recently.
v Information on the number of lines and pages printed
v Number of files created
v Database put, get, and update operations
v Communications read and write operations
v Auxiliary I/O operations
v Transaction time
v Number of transaction fields
v Time active
v Time suspended

After an abnormal system ending, the job completion time in the journal will not be
the same as that in the CPF1164 message. The message uses the time nearest to
that of the system ending, but the job accounting journal entries are sent to the
journal during IPL, and the job completion time is the current system time, which is
later than the time when the abnormal system ending occurred.

If the system ends abnormally, some journal entries can be lost. These are the
entries that are written to the journal but not forced to disk (this is equal to
FORCE(*NO) on the SNDJRNE command). They include the following:
v JB entries caused by a CHGACGCDE command
v DP and SP entries

Whenever a job completes, the last accounting code entry is forced to disk (as if
FORCE(*YES) were specified on the SNDJRNE command). Whenever an
accounting entry is forced to disk, all earlier entries in the journal, regardless of
which job produced them, are forced to disk.

Exception
If only *PRINT accounting is specified on the system, there will not be any job
ending FORCE(*YES) journal entries done. Therefore, if a critical accounting entry

Chapter 15. Job Accounting 283

 is written by a CHGACGCDE command and you want to ensure it will not be lost in
case of an abnormal system ending, you could issue a SNDJRNE command and
specify the FORCE(*YES) option. If files are also to be journaled to the accounting
journal, any database changes are always forced to the journal, and this causes all
earlier accounting entries to also be forced.

If an abnormal system ending occurs or you change an accounting code of a job

other than your own, the qualified job name in the first 30 bytes of the JARES field
in the journal entry describe the system job that wrote the JB entry at the next IPL
and not the job that used the resources. The JAJOB, JAUSER, and JANBR fields
should be used for analysis purposes.

Damaged Job Accounting Journal or Journal Receiver

If damage occurs to the journal or to its current receiver so that the accounting
entries cannot be journaled, a CPF1302 message is sent to the QSYSOPR
message queue, and the accounting data is written to the QHST log in the
CPF1303 message. The job trying to send the journal entry continues normally.
Recovery from a damaged journal or journal receiver is the same as for other
journals. See the Backup and Recovery book for recovery considerations.

The journal QACGJRN should not be allocated by another job. If the journal is
allocated by another job, the journal entry is changed to message text and sent to
the QHST log as message CPF1303.

You can use the OUTFILE parameter on the Display Journal (DSPJRN) command
to write the accounting journal entries to a database file that you can process.

You can also use the RCVJRNE command on the QACGJRN journal to receive the
entries as they are written to the QACGJRN journal. If the job accounting journal or
journal receivers become damaged, the system continues to operate and to record
accounting data in the history log. To recover from the journal or journal receiver
damage, use the Work with Journal (WRKJRN) command. Refer to the Backup and
Recovery book for more information about the use of this command. After
recovering the damaged journal or journal receiver, change the system value
QACGLVL to a value appropriate for your installation. (Unless you change the
QACGLVL system value, the system does not record accounting information in the
new journal receiver.)

Accessing CPF1303 Message

To access information from the CPF1303 message, create a high-level language
program. To define records that match the CPF1303 message, include the following
fields:
System Time
Char (8)
Message Record Number
Bin (4)
Qualified Job Name
Char (26)
Entry Type (JB, DP, or SP)
Char (2)

284 OS/400 Work Management V4R4

Length of Data
Bin (2)

Followed by fields:

JAJOB through JASPN for JB entries

JAJOB through JABYTE for SP and DP entries

(These fields are described earlier in this chapter.)

For an example program, refer to the section in the CL Programming book that
discusses processing the QHST file for the job completion message.

The CPF1164 message always consists of three records and the CPF1303
message always consists of four records.

The information contained in the standard journal prefix fields is not included in this
message. All that is needed is information pertaining to the job end, date, and time;
this information can be found in record 1 of the CPF1303 message.

Converting Job Accounting Journal Entries

You can use the OUTFILE parameter on the DSPJRN command to write the job
accounting journal entries into a database file that you can process. The OUTFILE
parameter allows you to name a file or member. If the member exists, it is cleared
before the records are written. If the member does not exist, it is added. If the file
does not exist, a file is created using the record format QJORDJE. This format
defines the standard heading fields for each journal entry, but the job accounting
data is defined as a single large field.

To avoid having to process the accounting data as a single large field, two field
reference files are supplied to help you in processing the job accounting journal
entries. The file QSYS/QAJBACG contains the record format QWTJAJBE and is
used for JB entries. File QSYS/QAPTACG contains record format QSPJAPTE and
is used for DP or SP entries. The same format is used for all printer file entries
regardless of if the output is SP (spooled) or DP (nonspooled). The DP entry for
directly printed files contains some fields that are not used; these fields contain
blanks.

The following are some approaches you might use:

v The basic JB entries and DP or SP entries can be processed by creating two
output files using the supplied field reference file formats and running the
DSPJRN command once for JB and once for DP or SP. This allows you to define
a logical file over the two physical files and use an high-level language program
to process the externally described file. This solution is recommended and
described later in this section.
v You can process only the JB entries by creating a file using one of the supplied
field reference files (QSYS/QAJBACG) to create an externally described file. This
file can then be processed by the query utility or an high-level language program.
v You can convert both types of journal entries using the default DSPJRN format of
QJORDJE. You would then use a program-described file to process the journal
entries in a high-level language program.

Chapter 15. Job Accounting 285

 The following DDS defines a physical file for the JB journal entries using the
QAJBACG field reference file in QSYS. You would normally create the file (using
the CRTPF command) with the same name (QAJBACG) as the model file.
R QWTJAJBE FORMAT(QSYS/QAJBACG)

The following DDS defines a physical file for the DP or SP journal entries using the
QAPTACG field reference file in QSYS. You would normally create the file (using
the CRTPF command) with the same name (QAPTACG) as the model file.
R QSPJAPTE FORMAT(QSYS/QAPTACG)

You can specify a key field in either physical file; however, in this example, a logical
file is used for sequencing.

If you create two physical files (one for JB and one for DP or SP) with the members
of the same name, you would issue the following DSPJRN commands to convert
the entries. Assume that you have created the physical files with the same names
as the model files in your library YYYY.
DSPJRN JRN(QACGJRN) JRNCDE(A) ENTTYP(JB)
OUTPUT(*OUTFILE) OUTFILE(YYYY/QAJBACG)
DSPJRN JRN(QACGJRN) JRNCDE(A) ENTTYP(SP DP)
OUTPUT(*OUTFILE) OUTFILE(YYYY/QAPTACG)

You can control the use and selection criteria of the DSPJRN command so that you
do not convert the same entries several times. For example, you can select all
entries in a specific range of dates. You could convert all of the entries at a cutoff
point for your job accounting analysis, for example, monthly. One or more journal
receivers may have been used during the month. Note that each use of the
DSPJRN command to the same member causes the member to be cleared before
any new entries are added. Do not use the JOB parameter of the DSPJRN
command as some entries are made for a job by a system job and will therefore not
appear as you may expect them to.

Allowing the Processing of Both Physical Files: Enter the following DDS to
create a logical file to allow processing of both physical files. This allows you to
read a single file in accounting code order and print a report using a high-level
language program:
R QWTJAJBE PFILE(YYYY/QAJBACG)
K JACDE
R QSPJAPTE PFILE(YYYY/QAPTACG)
K JACDE

Processing Basic Job Accounting Record: If you want to use a logical file to
process only the basic job accounting record in accounting code order by a user
name, you would enter the following DDS for a logical file:
R QWTJAJBE PFILE(YYYY/QAJBACG)
K JACDE
K JAUSER

This logical file can be processed by the query utility or by a high-level language
program.

If an abnormal system ending occurs, the qualified job name in the first 30 bytes of
the JARES field in the journal entry describe the system job that wrote the entry at
the next IPL and not the job that used the resources. For this reason, any analysis
done on the JB entries should use the JAJOB, JAUSER, and JANBR fields.

286 OS/400 Work Management V4R4

Job Accounting Approaches
The following approaches may be useful to you in the setting up and managing
your job accounting function.

Validity Checking of Accounting Codes: An important aspect of any data

processing application is ensuring that the correct control fields are specified. For
job accounting codes, this can require a complex validity-checking function which
not only checks for the existence of authentic codes, but also checks which users
are allowed to use specific codes.

Accounting codes can be assigned in the following areas:

v User profile
v Job description
v In a job (CHGACGCDE command)

Controlling the Assignment of Accounting Codes in User Profiles: If it is

important to control the assignment of accounting codes, you may want to consider
the following approach. Before an accounting code is placed in a user profile, you
may want to ensure that the code is valid and that it is valid for a particular user.

You could control the changing of accounting codes on the CHGJOBD command by
giving only the security officer authority to the CHGACGCDE command, and
therefore, another user could not create or change a job description with a specific
accounting code.

The CHGACGCDE command could be used directly to allow users to change the
job accounting code of their own or another job. To change another job, the user
must also have the special authorization of *JOBCTL.

In many installations, it would not be valid to allow the change of an accounting

code for a job on the job queue or for one job to change the accounting code of
another job. Controlling this and ensuring validity checking of the new accounting
code could be done with a CL program and command.

For example, the CHGACGCDE command would be privately authorized and

included in a CL program where it only changed the current job (for example,
JOB(*) is specified). The command would be authorized appropriately.

Chapter 15. Job Accounting 287

288 OS/400 Work Management V4R4
 Appendix A. Performance Data
Performance data is a set of information about the operation of a system (or
network of systems) that can be used to understand response time and throughput.
You can use performance data to make adjustments to programs, system attributes,
and operations. These adjustments can improve response times and throughputs
and help to predict the effects of certain changes to the system, operation, or
program.

| There are two ways you can collect performance data:

| v Use Collection Services from within AS/400 Operations Navigator
| v Use Performance Monitor

| Note: As the AS/400 Operations Navigator and Collection Services evolve, future
| support for performance data collection may focus on Collection Services.
| Users are encouraged to begin using this new tool.
|
Why Collect Performance Data?
You may choose to collect performance data for any of the following reasons:
v To do analysis with the Performance Tools licensed program
v To gather input for an analysis application that reduces the data into meaningful
reports
v To do analysis on another system that has the Performance Tools licensed
program installed
|
| Introducing Collection Services
| Collection Services allows you to gather performance data with little or no
| observable impact on system performance. You can use Operations Navigator to
| configure Collection Services to collect the data you want as frequently as you want
| to gather it. A collection object, *MGTCOL, serves as an efficient storage medium to
| hold large quantities of performance data. Once you have configured and started
| Collection Services, performance data is continuously collected. When you need to
| work with performance data, you can copy the data you need into a set of
| performance database files.
|

© Copyright IBM Corp. 1997, 1999 289

 Figure 48. Overview of Collection Services

| Figure 48 above provides an overview of the following Collection Services elements:

| General properties General properties define how a collection should
| be accomplished and they control automatic
| collection attributes.
| Data categories Data categories identify the types of data to collect.
| You can configure categories independently to
| control what data is collected and how often the
| data is collected.
| Collection Profiles Collection profiles provide a means to save and
| activate a particular category configuration.
| Performance Collector The performance collector uses the general
| properties and category information to control the
| collection of performance data. You can start and
| stop the performance collector, or configure it to run
| automatically.
| Collection Object The collection object, *MGTCOL, serves as an
| efficient storage medium for large quantities of
| performance data.
| Create Performance Data (CRTPRFDTA) Command
| The CRTPFRDTA processes data that is stored in
| the management collection object and generates
| the performance database files.
| API Interfaces An application program interface (API)
| accomplishes basic configuration and collector
| control. Read about APIs for use with Collection
| Services in OS/400 APIs in the Programming topic
| in the AS/400 Information Center. You can access

290 OS/400 Work Management V4R4

| the Information Center from the AS/400e
| Information Center CD-ROM (English version:
| SK3T-2027) or from one of these Web sites:
| http://www.as400.ibm.com/infocenter
| http://publib.boulder.ibm.com/pubs/html/as400/infocenter.htm

| Why Should I Use Collection Services?

| Collection Services collects data that identifies the relative amount of system
| resource used by different areas of your system. When you collect and analyze this
| information on a regular basis, you help balance your resources better. This
| process gets you the best performance from your system. You can create database
| files and use them with the Performance Tools for AS/400 licensed program or other
| applications to produce performance reports.

| With Collection Services, you will have much greater control and flexibility over data
| collection and database generation. Future enhancements or additions to
| performance data collection will take place within Collection Services.

| The advantages of using Collection Services are:

| v Low data collection overhead. Data can be collected at all times with little or no
| observable impact.
| v You will not have to start the monitor and wait for or recreate problems while the
| monitor is active so you can analyze and address them. When you need
| performance data, it is available.
| v You can defer data processing and database file generation to run in batch mode
| when the system is not busy with business-critical applications.
| v You can select which categories you are interested and for which time periods
| when generating database files. The performance data is there, but you only
| incur the processing cost for the data you want to see.
| v The management collection object is easier to manage or move between
| systems than the 30 or more database files that are used by the traditional
| monitor. You can generate the database files on any system. You can collect data
| on an application system and move the data to a management system for
| database generation and analysis.
| v Collections objects are release independent, allowing you to move data between
| releases and process it without data conversion.
| v Data collection is more reliable.
| v You have more control over what data is collected and the level of detail in that
| collection.

| Where Can I Learn More About Collection Services?

| You can read more about using Collection Services. See Management Central
| under the Operations Navigator topic in the AS/400 Information Center. You can
| access the Information Center from the AS/400e Information Center CD-ROM
| (English version: SK3T-2027) or from one of these Web sites:
| http://www.as400.ibm.com/infocenter
| http://publib.boulder.ibm.com/pubs/html/as400/infocenter.htm

| For assistance with configuring and using Collection Services, install Operations
| Navigator and read the online help under Management Central.

Appendix A. Performance Data 291

 Performance Monitor
| You can also collect performance data using the Start Performance Monitor
| (STRPFRMON) command. The performance data collected allows you to assess
| the relative amount of system resource that is used by different areas of your
| system. This information, once regularly collected and analyzed, can help you
| balance your resources better so you get the best performance from your system.

Preparing to Collect Performance Data

Before starting data collection, consider what type of data to collect and how often
to collect it.

| Collecting data may slightly degrade performance of the system because of the
| time involved in collecting the performance data. The amount of degradation when
| using performance monitor relates to the amount of data that is collected. Using
| Collection Services to perform a typical data collection can reduce the impact on
| system response.

Types of Performance Data to Collect

Types of data that can be collected are:
| v Sampled data—a snapshot in time
| – System data. This data consists of performance data that relates to the
| following: all jobs on the system, devices that are attached to the system,
| storage pools, communications I/O processors, disk I/O processors, local
| workstation I/O processors, and workstation response times.
| – Communications data. This data includes all of the previously listed system
| data and statistics for the following protocols:binary synchronous
| communications, asynchronous communications, X.25, Ethernet, integrated
| services digital network (ISDN), token-ring network, synchronous data link
| control (SDLC), distributed data interface (DDI), and frame relay.
| v Trace data—event-driven collection
| – Database Query data. This data consists of performance data that is related
| to executable statements.
| – Trace data. This data includes internal system trace data. This type of data
| should not be collected unless you are going to analyze it using the
| Performance Tools licensed program.
|
Using Performance Monitor to Collect Performance Data
To collect performance data, use the Start Performance Monitor (STRPFRMON)
command. This command starts performance data collection. The performance data
will collect data until the time you specify as the end time. If you want to end the
monitor before that time, use the ENDPFRMON command.

Collecting System Data Only

To collect only system data, specify *SYS for the DATA parameter on the
STRPFRMON command.

292 OS/400 Work Management V4R4

 Collecting System and Communications Data
To collect communications data and IOP extended data, specify *ALL for the DATA
parameter on the STRPFRMON command.

Note: Communications data is collected in addition to system data, not instead of

it.

Collecting Database Query Data

To collect database query data, specify *YES for the STRDBMON parameter on the
STRPFRMON command.

Collecting Data on Active Jobs, Tasks, and Threads

To collect performance data for only those jobs, tasks, and threads that use CPU
within the interval, specify *ACTIVE for the SLTJOB parameter on the
STRPFRMON command. Use of this option has the potential, depending on the
characteristics of the system, to substantially reduce the system overhead
associated with running the performance monitor.

To collect performance data for all jobs, tasks, and threads whether or not they use
CPU within the interval, specify *ALL. The default for SLTJOB is also *ALL.

How Performance Monitor Collects Data

Issuing the Start Performance Monitor (STRPFRMON) command submits a batch
job to a job queue. When the performance monitor batch job is started from the job
queue, data collection begins. The job continues to collect data until one of the
following occurs:
v The time limit specified for data collection is reached.
v The End Performance Monitor (ENDPFRMON) command is issued.
v The performance monitor job is ended abnormally (End Job (ENDJOB), End
Subsystem (ENDSBS), or End System (ENDSYS) command).

| While the performance monitor job is active, the monitor periodically collects data
| and puts it in the performance database files. For more information on the Start
| Performance Monitor (STRPFRMON) command, see CL Reference (Abridged) .

Ending Performance Data Collection

To end performance data collection before the time you specified, use the
ENDPFRMON command. This command should be used instead of the ENDJOB,
ENDSBS, and ENDSYS commands if you want the final data collected. Only the
ENDPFRMON command causes the final data to be collected. Issuing the
command causes the performance monitor batch job to make a final collection of
performance data and then end itself.

For more information on the ENDPFRMON command, see the CL Reference

(Abridged) .

Appendix A. Performance Data 293

 Year 2000 Considerations
Data collection is dependent on the start date that is found in the QAPMCONF data
file. This is the only data file that contains a century indicator; therefore, you must
use the date in the QAPMCONF configuration file. The date in all other
performance files is relative to the date in the QAPMCONF file.

Trace Data

Collecting Trace Data—STRPFRMON

To collect trace data, you must specify a value other than *NONE for the TRACE
| parameter on the STRPFRMON command.

| Collecting Trace Data—Collection Services

| If you are using Collection Services from Management Central and want to collect
| trace data, you should use the following Trace Internal command to start the
| collection: TRCINT SET(*ON) TRCTYPE(*TTPERF *MPL *TNS). To end the collection,
| type TRCINT SET(*HOLD). This command will hold the collection of trace data until
| you specify where to place it or until you start another trace.

| For more information about using the TRCINT command, see CL Reference:
| RQSxxx through WRKxxx Commands, SC41-5726-01.

How Tracing Occurs

Specifying a value other than *NONE for the TRACE parameter on the
STRPFRMON command causes the performance monitor to start the trace (using
the Trace Internal (TRCINT) command). Turning on the trace causes the system to
log various activities into an internal trace table. Eventually, the trace data is
dumped from the internal trace table into a database file (QAPMDMPT).

After the performance monitor starts the trace, the system continues to log trace
data until either the trace table fills up or the performance monitor ends. If the trace
table fills up while the performance monitor is running (and the performance monitor
started the system trace), a message is sent to the system operator’s message
queue and a user’s message queue (if one was specified on the MSGQ parameter
of the STRPFRMON command) at which time the performance monitor then
automatically turns off the trace. At that point, three options are available:
v Immediately dump the trace table to a database file (by using the DMPTRC
command). Using this option ensures that the trace data is not written over if
other traces are turned on. However, this approach may degrade performance on
heavily loaded systems.
v Wait until the performance monitor ends and have the performance monitor dump
the trace at that time (this is the default). If another trace is started before the
performance monitor ends, the data in the internal trace table is written over,
losing the trace information that the performance monitor produced.
v Do not dump the trace when the performance monitor ends. Instead, dump the
trace at a convenient time with the DMPTRC command.
v If another trace is started before the trace data is dumped, the data in the
internal trace table is written over, losing the trace information that the

294 OS/400 Work Management V4R4

 performance monitor produced. Because of this, it is important to dump the trace
data before starting any process (including running the performance monitor
again) that collects trace data.

Dumping Trace Data

| Deciding when to dump trace data is a significant decision because the dump
| affects system performance. It is not good to dump during peak activity on a loaded
| system. You can delay a trace data dump, but you want to dump the data before
| you forget that it exists. If the trace table becomes cleared for any reason, the trace
| data is lost. However, delaying the dump slightly and then using the Dump Trace
| (DMPTRC) command may preserve performance for the users.

Dumping Trace Data—STRPFRMON

To dump trace data:
v Specify DMPTRC on the STRPFRMON command if you want the trace data
dumped when the performance monitor ends.
v Specify DMPTRC on the ENDPFRMON command to override the value on the
STRPFRMON command.
v Use the Dump Trace (DMPTRC) command if you want to delay the dump to limit
the users affected by the performance.

| Dumping Trace Data—Collection Services

| To dump trace data, use the Dump Trace (DMPTRC) command, as follows: DMPTRC
| MBR(member-name) LIB(library-name). Specify a member name and a library name
| in which to store the data.

| Note: When using Collection Services to collect performance data concurrently with
| collecting trace data, consider using the same member name and library
| name used above to Create Performance Data (CRTPRFDTA).

| When Trace Data Is Dumped

The Dump Trace command puts information from an internal trace table into a
database file. When the data is dumped, it degrades system performance. If the
trace is not dumped when the performance monitor ends, the traced data remains
in the internal system trace table until it is dumped or until the trace table is cleared.

Internal Trace Table

Before starting any traces, the performance monitor sets the trace table size limit to
a default value of 16MB, 32MB, 64MB or 128MB depending on the processor group
of the machine it is running on. Before setting the trace table size, the performance
monitor checks the current size of the trace table. If it is equal to or larger than the
default size, the size is not changed. This allows users to set the trace table size
larger than the default if they want to collect trace data for an extended period of
time. This is not recommended because of the impact on system resources. If the
trace option is not selected, the size of the trace table is not changed.

Appendix A. Performance Data 295

 Automatic Performance Data Collection–Performance Monitor
| You can choose to have your system use the performance monitor to automatically
| collect performance data on a weekly schedule. You can specify particular days of
| the week you want data to be collected.

Establishing Automatic Weekly Collection

To establish the automatic weekly collection of performance data:
1. Use the Work with Performance Collection (WRKPFRCOL) command. The Work
with Performance Collection display is shown.
2. Provide a name for the performance collection, the day of the week and time
you want the collection to occur, and a description of the collection for your
reference.
3. Make any optional changes to the parameters that are used for the Start
Performance Monitor (STRPFRMON) command.

Note: The Work with Performance Collection display also allows you to add,
change, remove, hold, release, or display a collection of performance data.

Adding or Changing Performance Data Collection

To add a performance collection, use the Add Performance Collection
(ADDPFRCOL) command. To change a performance collection, use the Change
Performance Collection (CHGPFRCOL) command.

QPFRCOL Batch Job

Automatic performance collection requires a batch job (QPFRCOL) that queries the
schedule created by the ADDPFRCOL command and submits the STRPFRMON
command at the appropriate times.

This job exists as an autostart job entry in the IBM-supplied subsystems QBASE
and QCTL. If you are using the latest release of one of these controlling
subsystems, then as long as you have performance collections defined, the batch
job is started for you after each IPL.

If you are not using the latest release of QBASE or QCTL, you can add an autostart
job entry for the performance collection to one of the subsystems.

See “Autostart Job Entry” on page 95 for more information about autostart job
entries.

Using Automatic Data Collection for the First Time

To use automatic performance collection for the first time:
1. Issue the Add Performance Collection (ADDPFRCOL) command.
2. Start the QPFRCOL batch job by issuing the Start Performance Collector
(STRPRFCOL) command.

296 OS/400 Work Management V4R4

What Does the Performance Monitor Do?
Although the performance monitor is a batch job, it runs at a higher priority than
interactive jobs, but lower than system-level jobs.
1. After the performance monitor job is started, it opens the data collection
database files and performs other initialization functions.
2. After initialization, the performance monitor job waits for a data collection
interval to occur.
3. As the performance monitor collects data, it retrieves performance counters
from the hardware devices attached to the system.
4. The counters that are stored in the database file for an interval indicate the
amount of resources used for just that interval (not a summary of the total use
since the performance monitor started).
5. The performance monitor job collects data for the amount of time specified on
the STRPFRMON command.
6. When the time limit is reached, the performance monitor puts the final
performance counters into the database file (regardless of whether a complete
interval occurred) and then ends itself.

Performance Monitor Ends

The ending time for the performance monitor is accurate within 5 minutes of the
time you specify. For example, if you started the performance monitor at 1:00 and
specified it should end itself in two hours, the performance monitor will end between
2:55 and 3:00.

If the performance monitor was started and you want to end it before the time limit
is reached, you can use the ENDPFRMON command. The ENDPFRMON
command puts the final performance counters into the database files, and ends the
performance monitor batch job (and, if specified, dumps the performance trace into
a database file).

Data Collection Intervals–Performance Monitor

A data collection interval is the amount of time during which the performance
monitor job is active to retrieve data from the system.

Internal Data Collection Intervals

This means that if you specified a 60-minute interval and a 2-1/2 hour time limit, the
database files contain entries placed in the files at 1 hour, 2 hours, and 2-1/2 hours.

Although you can specify that data is to be placed in the database files at intervals
ranging from 5 to 60 minutes (the default is 15 minutes), counter limitations require
the performance monitor to retrieve performance data from the system every 5
minutes. Some devices have counters that can wrap (when the counter reaches its
maximum value, it is reset to zero). The performance monitor can handle one wrap
when calculating the counts for the interval, but if the counter wraps twice before
the performance monitor retrieves the counter, the data is lost for one wrap (there is
no indication that the counter wrapped twice). The maximum amount of time the
performance monitor can run before risking a double wrap is 5 minutes. Therefore,
the performance monitor must retrieve the data every 5 minutes to ensure that
there is no loss of data.

Appendix A. Performance Data 297

Database and Internal Collection Intervals
Regardless of the value specified for the collection interval, the performance
monitor must collect counters from the devices attached to the system every five
minutes. Any of these five-minute intervals that do not coincide with the user
specified collection interval are called an internal interval. Any of the five-minute
intervals that coincide with the user-specified collection intervals are called
database intervals, because the performance monitor writes the counters collected
for each user-specified interval to the performance database files.

During internal intervals, the only data that is collected is from the devices attached
to the system. This data is saved in internal tables until a database interval occurs,
when it is written to the database files.

During database intervals, all of the data specified for collection is retrieved from
the devices and the system, the values for the database interval are calculated
(remember each interval shows the amount of use for just that interval), and the
counters are written to the performance database files.

The example in Figure 49 shows the difference between an internal interval and a
database interval (assume that 15 minutes was specified for the INTERVAL
parameter for the STRPFRMON command).

Performance Monitor During Data Collection

It is also possible for the performance monitor to become active between intervals.
Certain events on the system cause the performance monitor to be notified when
they occur. When one of these events occurs, the performance monitor momentarily
becomes active (usually just long enough to store information about the event in an
internal table), and then waits for the next collection interval to occur. The
occurrence of certain events, such as job termination or line vary off, can also
cause a record to be written to the database.

Database Interval Database Interval

│ │ │
│ │ │
│ Internal Interval │ Internal Interval │
│ │ │ │ │
│ Internal Interval │ │ Internal Interval │ │
Time in │ │ │ │ │
Minutes 0 5 10 15 20 25 30
| │
Í─────────────────────────── Collection Period ────────────────────────────Ê

Figure 49. Database and Internal Collection Intervals

Notification of Performance Monitor Status

While the performance monitor is active, it sends information messages to the
system operator’s message queue. These messages notify the system operator
when the status of the performance monitor changes or an error occurs. Typical
messages sent indicate that:
v The performance monitor was started (from the job queue).
v The performance monitor encountered an unexpected error.
v Another user issued the End Performance Monitor (ENDPFRMON) command.
v The performance monitor has ended.

298 OS/400 Work Management V4R4

 Specifying the MSGQ parameter on the STRPFRMON command causes the
performance monitor to send messages to the user’s message queue whenever it
sends messages to the system operator’s message queue.

Database Files and Performance Monitor

The performance monitor uses many different database files while collecting
performance data, but the performance monitor places the data into the same
member for all the files it uses. If the member specified on the STRPFRMON
command does not exist when the performance monitor starts, it adds a member by
that name to all the files it uses.

Because the default for the member name (MBR) parameter for the STRPFRMON
command is *GEN (create the member name), it is possible to quickly add many
members to the performance monitor database files. When using the default, you
should periodically delete members in the performance database files when they
are no longer used.

An alternative to deleting members is to delete the files themselves. If the

performance monitor does not find a file in the specified library, it creates the file in
that library and adds the specified member to the file.

Another alternative is to specify several member names over and over (if running
| every day of the week, name the members after the days of the week).
|
| Data Collection Intervals–Collection Services
| Collection Services collects performance data into a management collection object
| (*MGTCOL) for selected categories at intervals of 15, 30, 60, 300, 900, 1800, and
| 3600 seconds. Data collection is synchronized to the system clock time. Thus, for a
| collection that starts at 12:00:00 with an interval of 30 seconds, data is collected at
| approximately 12:00:00, 12:00:30, 12:01:00, and so on. You can compare
| performance data from multiple systems if the clocks on those systems are
| synchronized. You can set the collection interval for a particular category
| independently from other categories. This allows data collection for those categories
| at different intervals.

| The Create Performance Data (CRTPFRDTA) command processes data from

| *MGTCOL and stores the result into performance database files. The time interval
| specified on the CRTPFRDTA command indicates the time between successive
| entries in the database files. This time interval is synchronized to the clock time and
| has the same possible values as the collection intervals for the categories. When
| CRTPFRDTA reaches the end of its interval, it will write database records for a
| category if data was collected for that category at that time. Thus, if performance
| data for a category is collected every 30 seconds and the CRTPFRDTA interval is
| specified as 300 seconds, database records are written every 300 seconds for that
| category. If a category is collected every 900 seconds, and the CRTPFRDTA
| interval is 300 seconds, the system writes the database records every 900 seconds.
| This results in two missed intervals for every interval written.

Estimating Database Storage Requirements for Performance Data

This section shows how to estimate the storage requirements needed to collect
system data and to collect system and communications data.

Appendix A. Performance Data 299

 To calculate the size of a performance collection precisely, you would need to
consider the following:
v Size of the library object
v Base size of each file
v Empty size of each member of each file
v Number of intervals in the collection
v Number of records written to each file each interval
v record length of each file

The estimates provided here are intended to provide a simple guideline as to how
much storage will be required for a performance collection (adding a new collection
to an existing database). The outcome is by no means precise. We have taken
some liberties in estimating the average numbers of certain resources and rounding
record lengths.

These estimates are for sample data only and do not include collecting trace data
or response time data for either local or remote workstations.

Collecting System Data Only

To estimate the amount of disk space for collecting only system data using the
STRPFRMON command and specifying DATA(*SYS), add the following:

384 000 plus the product of the number of intervals times the sum of:
8600 Base data per interval
150 Times the average number of twinaxial workstation controllers active in the
interval
250 Times the average number of communications controllers active in the
interval
550 Times the average number of storage device controllers active in the
interval
300 Times the average number of multi-function IOPs (MFIOPs) active in the
interval
350 Times the number of disk actuators
850 Times the average number of jobs, threads, or tasks active in the interval

For example,
Disk space = 348000 + {#intervals x [(8600) +
(850 x avg #jobs) + (350 x #disk arms) +
(250 x #com ctl) + (550 x #dasd ctl) +
(150 x #wsc) + (300 × #MFIOPs)]}

Collecting System and Communications Data

To estimate the amount of disk space for collecting both system and
communications data using the STRPFRMON command by specifying DATA(*ALL),
calculate the size for a *SYS collection and add the following:

262 000 plus the product of the number of intervals times the sum of:
300 Times the average number of communication lines

300 OS/400 Work Management V4R4

 200 Times the average number of stations for all communication lines (ECL,
ETH, FRLY, and DDI lines)
100 Times the average number of SAPs for all communication lines (ECL, ETH,
FRLY, and DDI lines)
1450 Times the number of File Server I/O processors.

Performance Data Files

| Collection Services System Category and File Relationships

| Each category contains or provides data that is externalized using one or more of
| the performance database files, new or existing. Table 38 below identifies the
| category-to-file relationships. There are three types of relationships:
| Primary Files Primary files are related to and generated from the category.
| Compatibility Files
| Compatibility files are logical files that join primary files to provide
| performance database compatibility with the previous file structure.
| If the system generates all participating files (primary categories),
| compatibility files are also generated.
| Secondary Files
| Secondary files are related to and contain some data that is derived
| from data contained in the category or in the primary file. However,
| they are not controlled by that category.
| Notes:
| 1. The CRTPFRDTA command generates a database file only when that file is a
| primary file for a selected category.
| 2. If a primary file is listed for multiple categories, you must select each of those
| categories in order to generate the file.
| 3. If a primary file for one category is listed as a secondary file for another
| category, you must select the second category to ensure complete information
| in your generated database file. For example, from Table 38 below, to generate
| a complete database file for QAPMECL, you must select both *CMNBASE and
| *CMNSTN.
| 4. The system generates compatibility files only when it generates all associated
| primary files.
| Table 38. System Category and File Relationships.
| Category Primary Files Compatibility Files Secondary Files
| *SYSBUS QAPMBUS
| *POOL QAPMPOOLB QAPMPOOLL
| *POOLTUNE QAPMPOOLT QAPMPOOLL
| *HDWCFG QAPMHDWR
| *SUBSYSTEM QAPMSBSD
| *SYSCPU QAPMSYSCPU QAPMSYSL
| *SYSLVL QAPMSYSTEM QAPMSYSL
| *JOBMI QAPMJOBMI QAPMJOBL QAPMSYSTEM
| QAPMJSUM QAPMSYSL

Appendix A. Performance Data 301

| Table 38. System Category and File Relationships (continued).
| Category Primary Files Compatibility Files Secondary Files
| *JOBOS QAPMJOBOS QAPMJOBL QAPMSYSTEM
| QAPMJSUM QAPMSYSL
| *QSNADS QAPMSNADS
| *DISK QAPMDISK QAPMSYSTEM
| *IOP QAPLIOP
| QAPMDIOP
| QAPMCIOP
| QAPMMIOP
| *IPCS QAPMIOPD
| QAPMTSK
| *CMNBASE QAPMASYN
| QAPMBSC
| QAPMDDI
| QAPMECL
| QAPMETH
| QAPMFRLY
| QAPMHDLC
| QAPMIDLC
| QAPMLAPD
| QAPMX25
| *CMNSTN QAPMSNTD QAPMDDI
| QAPMSTNE QAPMETH
| QAPMSTNL QAPMECL
| QAPMSTNY QAPMFRLY
| none QAPMX25
| *CMNSAP QAPMSAP
| *LCLRSP QAPMRESP
| *APPN QAPMAPPN
| *SNA QAPMSNA
| *EACACHE none QAPMDISK

| Performance Data Files Overview

| The following are performance data files that the system supports when using data
| collection commands or Collection Services. Included in this overview are file
| names, brief descriptions, and references to field data detail (when provided).

| Additional field information such as number of bytes and buffer position is available
| by using the Display File Field Description (DSPFFD) command available on the
| system. For example:
| DSPFFD file(QSYS/QAPMCONF)

| Note: Any new fields are supported only by Collection Services.

| Where to Find Configuration Data (collected once per session):

File Name Where to Find Description

QAPMCONF 305 System configuration data
QAPMSBSD No field and byte data Subsystem data

302 OS/400 Work Management V4R4

 File Name Where to Find Description
| QAPMHDWR No field and byte data System hardware configuration
| Note: On a system with logical partitions,
| this file contains the system configuration.

Where to Find Performance Data (collected each interval):

File Name Where to Find Description

1
| QAPMSYS and 308 System performance data
| QAPMSYSL2
| QAPMSYSCPU2 327 System CPU usage data
2
| QAPMSYSTEM 327 System level performance data
1
| QAPMJOBS and 330 Job data (one record per job, task, or
| QAPMJOBL2 thread)
| QAPMJOBMI2 338 MI Job data (one record per job, task, or
| thread)
| QAPMJOBOS2 341 Job operating system data (one record per
| job)
| QAPMJSUM2 345 Job summary data by job group (one record
| per group)
QAPMDISK 348 Disk storage data (one per read/write head)
1
| QAPMPOOL 353 Main storage data (one per system storage
| and pool)
| QAPMPOOLL2
| QAPMPOOLT2 355 Storage pool tuning data
2
| QAPMPOOLB 357 Storage pool data.
QAPMHDLC 358 HDLC statistics (one per link)
QAPMASYN 359 Asynchronous statistics (one per link)
QAPMBSC 360 Binary synchronous statistics (one per link)
QAPMX25 362 X.25 statistics (one per link)
QAPMECL 364 Token-ring local area network statistics (one
per link)
QAPMSTNL 367 Token-ring station file entries
QAPMETH 368 Ethernet statistics (one per link)
QAPMSTNE 371 Ethernet file station entries
QAPMDDI 373 Distributed Digital Interface (DDI) data
QAPMSTND 374 DDI Station Data
QAPMFRLY 376 Frame relay data
QAPMSTNY 377 Frame relay station file entries
QAPMBUS 383 Bus counters (one per bus)
QAPMCIOP 383 Communications IOP (one per IOP)
QAPMDIOP 388 Storage device IOP data (one per IOP)
QAPMLIOP 391 Twinaxial workstation controller data (one
per physical controller)
QAPMMIOP 385 Multifunction IOP (one per IOP)
QAPMRESP 393 Local workstation response time (one per
workstation)

Appendix A. Performance Data 303

 File Name Where to Find Description
QAPMAPPN 405 APPN data
QAPMSNA 394 SNA data
1
QAPMRWS 393 Remote workstation response time
QAPMSNADS 404 SNADS data
QAPMSAP “TRLAN, Ethernet, DDI, TRLAN, Ethernet, DDI, and Frame Relay
and Frame Relay SAP SAP file entries
File Entries” on page 378
QAPMLAPD “Integrated Services Integrated services digital network LAPD file
Digital Network LAPD File entries
Entries” on page 379
QAPMIDLC 381 Integrated services digital network data link
control file entries
QAPMIOPD 417 Extended IOP data (additional data for
special IOPs)
| Note:
| 1. used by Performance Monitor only
| 2. used by Collection Services only
| All files contain data for the partition in which the data was collected unless otherwise
| indicated.

Trace Data:

File Name Where to Find Description

1
QAPMDBMON No field and byte data Database performance statistics
1
| QAPMDMPT System trace data (general description—no
| field and byte detail)
| Note: This information can be collected
| using the TRACE parameter on the
| STRPFRMON command. If you are using
| Collection Services and would like to gather
| trace data, see “Collecting Trace
| Data—Collection Services” on page 294.
QAPMTSK Internal transaction data (general
description—no field and byte detail)
Note:
1. This file is used by Performance Monitor only.
All files contain data for the partition in which the data was collected unless otherwise
indicated.

All of the data except for QAPMCONF, QAPMSBSD, QAPMHDWR and

QAPMDBMON are collected for each sample. QAPMCONF contains system
configuration information that is reported only at the beginning of the performance
monitor data collection job. QAPMSBSD contains subsystem data that is reported
only at the end of the performance monitor data collection job. QAPMHDWR
contains hardware data that is only reported at the beginning of the Performance
Monitor collection job. QAPMDBMON contains database performance data that is
collected during the performance run, however; the data is only written to the file at
the end of a performance collection.

304 OS/400 Work Management V4R4

 Performance Data File Abbreviations
The performance data files use abbreviations in the field and byte data tables.
These abbreviations include:

C = character in the Attributes column.

PD = packed decimal in the Attributes column.

Z = zoned decimal in the Attributes column.

IOP = input/output processor or I/O processor. The processors that control the
activity between the host system and other devices, such as disks, display stations,
and communications lines.

DCE = data circuit-terminating equipment.

MAC = medium-access control. An entity in the communications IOP.

LLC = logical link control. An entity in the communications IOP.

Beacon frame = a frame that is sent when the ring is inoperable.

Type II frame = a connection oriented frame (information frame) used by Systems

Network Architecture (SNA).

I-frame = an information frame.

Field Data for Performance Data Files

File Name: QAPMCONF
System Configuration File Entries: Table 39 lists the various fields in the
configuration file entries.
Table 39. System Configuration Data
Field Name Description Attributes
GRES Reserved C (4)
GKEY See Note 1. C (2)
GDES See Note 1. C (10)

Notes:
1. Unless otherwise noted, all system values pertain to the partition for which the
data was collected.

GKEY GDES
1 Performance monitor or data start date (yy/mm/dd/c).
2 Performance monitor or data start time (hh:mm:ss).
3 Model number (character 4 followed by 4 character
system type).
4 Main storage size in KB (zoned (10,0)).
| 5 Communications data collected: will be set to Y only if
| any communication files were created.
6 Machine serial number (character 10).

Appendix A. Performance Data 305

 GKEY GDES
7 First response time boundary (zoned (10,0)) in
milliseconds. The first response time monitor bracket is
from 0 up to and including the first response time
boundary.
8 Second response time boundary (zoned (10,0)) in
milliseconds. The second response time monitor bracket
is from the first response time boundary up to and
including the second response time boundary.
9 Third response time boundary (zoned (10,0)) in
milliseconds. The third response time monitor bracket is
from the second response time boundary up to and
including the third response time boundary.
10 Fourth response time boundary (zoned (10,0)) in
milliseconds. The fourth response time monitor bracket is
from the third response time boundary up to and
including the fourth response time boundary. Responses
greater than the fourth response time boundary fall under
the fifth response time monitor bracket.
11 System ASP capacity in KB (zone (10,0)). Total number
of bytes of auxiliary storage allocated to the system ASP
for the storage of data.
12 Checksum protection on (Y/N).
13 Number of configured CPUs (PD (3,0)).
14 First remote response time boundary (zoned (10,0)) in
milliseconds. The first response time monitor bracket is
from 0 up to and including the first response time
boundary.
15 Second remote response time boundary (zoned (10,0)) in
milliseconds. The second response time monitor bracket
is from the first response time boundary up to and
including the second response time boundary.
16 Third remote response time boundary (zoned (10,0)) in
milliseconds. The third response time monitor bracket is
from the second response time boundary up to and
including the third response time boundary.
17 Fourth remote response time boundary (zoned (10,0)) in
milliseconds. The fourth response time monitor bracket is
from the third response time boundary up to and
including the fourth response time boundary. Responses
greater than the fourth response time boundary fall under
the fifth response time monitor bracket.
| CD Collection data–This record is provided by Collection
| Services only. Possible values are:
| v 0–This collection is consistent with files created by the
| traditional monitor *SYS collection.
| v 1–Collection data is not *SYS. The database files
| generated from the collection may not be sufficient for
| applications (such as Performance Tools Reports,
| Best/1, PM/400) that depend on traditional
| Performance Monitor data.
CI Collect Internal Data (Y/N).

306 OS/400 Work Management V4R4

 GKEY GDES
| DB Database consistency–This record is provided by
| Collection Services only. Possible values are:
| v 0–No problem detected in database files.
| v 1–Due to interval size selected or to inconsistent
| collection intervals, the database files generated may
| contain missing intervals or other inconsistencies that
| might cause problems for applications that depend on
| traditional Performance Monitor data.
| F File level (PD(2,0)). Specifies the level of the
| performance database files. The value in this field is ’16’,
| and will be changed each time the format of any of the
| performance database files changes.
| FC Processor Feature Code (character 4).
| FI Interactive Feature (character 4).
| FP Processor Feature (character 4).
| I Interval (PD(2,0)). The time interval (in minutes) between
| each collection of system performance data.
| IS Interval seconds(PD(4,0)). This record is provided by
| Collection Services only. The time interval (in seconds)
| between each collection of system performance data.
| OS Output file system (character 8). This record is provided
| by Collection Services only. This value represents the
| system where the database files are generated.
| PC Partition count (zoned (2, 0)). This record is provided by
| Collection Services only.
| PN Partition identifier (character 1). This record is provided
| by Collection Services only.
| PP Primary partition (character 1). This record is provided by
| Collection Services only.
R Version number (PD(2,0)), followed by release number
(PD(3,1)).
S System name (character 8).
| SJ The Select Job (SLTJOB) parameter value (character 10).
| This value may be *ALL or *ACTIVE. This parameter
| applies to the traditional monitor. Collection Services does
| not use the SJ parameter.
S1 Value (character 1) of the QPFRADJ system value.
S2 Value (character 1) of the QDYNPTYSCD system value.
| S3 Value (character 1) of the QDYNPTYADJ system value.
| T Trace type (character 5). Specifies the type of internal
| trace that was started with the Start Performance Monitor
| command (*ALL or *NONE).

File Name: QAPMDBMON

Start Database Monitor File Entries: This format of the output file is the same as
that of the physical file model, QAQQDBMN, and its associated record format
model QQQDBMN.

When performance monitor starts, it will issue the STRDBMON command with the
following parameters:
STRDBMON JOB(*ALL)
OUTFILE('performance_lib'/QAPMDBMON)
UTMBR('performance_mbr' *REPLACE)

The database monitor function will be started only when requested by the
STRDBMON parameter on the STRPFRMON command. The performance monitor

Appendix A. Performance Data 307

 runs regardless of any failures in starting or running the database monitor. If the
database monitor was started successfully by the performance monitor, it ends
when the monitor ends by the ENDPFRMON command function.

File Name: QAPMHDWR

System Configuration File Entries: This file is an outfile that is produced by the
Display Hardware Resources (DSPHDWRSC) command. The format of the output
file is the same as that of the physical file model, QARZALLF, and its associated
record format model, QRZALL.

When performance monitor starts, it will issue the DSPHDWRSC command with the
following parameters:
DSPHDWRSC TYPE(*AHW) OUTPUT(*OUTFILE)
OUTFILE("performance_lib"/QAPMHDWR)
OUTMBR("performance_mbr" *REPLACE)
OUTFILFMT(*TYPE2)

Note: It replaces some of the configuration information previously found in

QAPMCONF.

File Name: QAPMSYS and QAPMSYSL

System Interval File Entries: The following terms are used in Table 40, and are
repeated for each group of jobs.
v Number of database read operations. Total number of physical read operations
for database functions.
v Number of nondatabase read operations. Total number of physical read
operations for nondatabase functions.
v Number of write operations. Total number of physical write operations.
v Number of print lines. Number of lines written by the program. This number does
not reflect what is actually printed. Spooled files can be ended, or printed with
multiple copies.
v Number of database writes/reads (logical). Number of times the database module
was called. This number does not include I/O operations to readers/writers, or I/O
operations caused by the Copy Spooled File (CPYSPLF) or Display Spooled File
(DSPSPLF) command. If SEQONLY(*YES) is in effect, these numbers show each
block of records read, not the number of individual records read.
v Number of communications writes/reads (logical). These do not include remote
workstation activity. They include only activity related to OS/400-ICF files when
the I/O is for a communications device.

Note: Blocked I/O is considered one database transaction.

Table 40 on page 308 shows which system performance data is collected.

Table 40. System Performance Data (Collected for Each Interval)
Field Name Description Attributes
INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
the sample interval.
INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
sample interval.

308 OS/400 Work Management V4R4

 Table 40. System Performance Data (Collected for Each Interval) (continued)
Field Name Description Attributes
SYDPGF Directory page faults: Number of times a page of the auxiliary PD (11,0)
storage directory was transferred to main storage for a look-up or an
allocation operation.
SYAPGF Access group member page faults: Number of times a page of an PD (11,0)
object contained in an access group was transferred to main storage
independently of the access group. This transfer occurs when the
containing access group was purged, or because portions of the
containing access group are displaced from main storage.
SYMPGF Microcode page faults: Number of times a page of microcode was PD (11,0)
transferred to main storage.
SYMCTR Microtask read operations: Number of transfers of one or more PD (11,0)
pages of data from auxiliary storage because of a microtask rather
than a process.
SYMCTW Microtask write operations: Number of transfers of one or more PD (11,0)
pages of data from main storage to auxiliary storage because of a
microtask rather than a process.
SYSASP System auxiliary storage pools space available: Number of bytes of PD (15,0)
space on auxiliary storage available for allocation in the system ASP
that is not currently assigned to machine interface (MI) objects or
internal machine functions.
| SYPRMW Number of requests for permanent data transferred from main PD (11,0)
| storage to the system ASP in auxiliary storage since the last
| sample.
SYXSRW Reserved PD (11,0)
SYEAOT Reserved PD (11,0)
SYEAOL Reserved PD (11,0)
SYBSYC Reserved PD (11,0)
SYSIZC Size count: Total number of size exceptions. PD (11,0)
SYDECD Decimal data count: Total number of decimal data exceptions. PD (11,0)
SYSEZC Seize count: Total number of seize wait exceptions. PD (11,0)
SYSZWT Seize/Wait time in milliseconds. PD (11,0)
SYSYNL Synchronous lock conflict count. PD (11,0)
SYASYL Asynchronous lock conflict count. PD (11,0)
SYVFYC Verify count. PD (11,0)
SYAUTH Authority look-up count. PD (11,0)
SYCHNB Reserved PD (11,0)
SYEXPN Total number of exceptions. PD (11,0)
SYLRT1 Transactions in first response time monitor bracket: Total number of PD (9,0)
local workstation transactions with response time less than the value
of boundary 1 specified on the STRPFRMON command.
SYLRT2 Transactions in second response time monitor bracket: Total number PD (9,0)
of local workstation transactions with response time less than the
value of boundary 2 and greater than the value of boundary 1
specified on the STRPFRMON command.

Appendix A. Performance Data 309

Table 40. System Performance Data (Collected for Each Interval) (continued)
Field Name Description Attributes
SYLRT3 Transactions in third response time monitor bracket: Total number of PD (9,0)
local workstation transactions with response time less than the value
of boundary 3 and greater than the value of boundary 2 specified on
the STRPFRMON command.
SYLRT4 Transactions in fourth response time monitor bracket: Total number PD (9,0)
of local workstation transactions with response time less than the
value of boundary 4 and greater than the value of boundary 3
specified on the STRPFRMON command.
SYLRT5 Transactions in fifth response time monitor bracket: Total number of PD (9,0)
local workstation transactions with response time greater than the
value of boundary 5 specified on STRPFRMON command.
SDCPU Total processing unit time used (in milliseconds) by target PD (11,0)
Distributed Data Management (DDM) job.
SDRES1 Reserved. PD (15,3)
SDRES2 Reserved. PD (11,0)
SDPRTL Total number of print lines of all target DDM jobs. PD (11,0)
SDPRTP Total number of print pages of all target DDM jobs. PD (11,0)
SDSPD Total count of suspended time of target DDM jobs. PD (11,0)
SDRRT Total count of time a target DDM job waited during rerouting. PD (11,0)
SDNEW Number of new target DDM job. PD (11,0)
SDTERM Number of ended target DDM jobs. PD (11,0)
SDJBCT Number of DDM jobs. PD (11,0)
SDPDBR Total number of physical synchronous database reads by target PD (11,0)
DDM jobs.
SDPNDB Total number of physical synchronous nondatabase reads by target PD (11,0)
DDM jobs.
SDPWRT Total number of physical synchronous database and nondatabase PD (11,0)
writes by target DDM jobs.
SDLDBR Total number of logical database reads by target DDM jobs. PD (11,0)
SDLDBW Total number of logical database writes by target DDM jobs. PD (11,0)
SDLDBU Total number of miscellaneous database operations by target DDM PD (11,0)
jobs.
SDCMPT Total number of communications writes by target DDM jobs. PD (11,0)
SDCMGT Total number of communications reads by target DDM jobs. PD (11,0)
SDBRG Reserved PD (11,0)
SDPRG Reserved PD (11,0)
SDNDW Number of synchronous nondatabase writes: Total number of PD (11,0)
synchronous physical nondatabase write operations for nondatabase
functions by target DDM jobs.
SDDBW Number of synchronous database writes: Total number of PD (11,0)
synchronous physical database write operations for database
functions by target DDM jobs.
SDANDW Number of asynchronous nondatabase writes: Total number of PD (11,0)
asynchronous physical nondatabase write operations for
nondatabase functions by target DDM jobs.

310 OS/400 Work Management V4R4

Table 40. System Performance Data (Collected for Each Interval) (continued)
Field Name Description Attributes
SDADBW Number of asynchronous database writes: Total number of PD (11,0)
asynchronous physical database write operations for database
functions by target DDM jobs.
SDANDR Number of asynchronous nondatabase reads: Total number of PD (11,0)
asynchronous physical nondatabase read operations for
nondatabase functions by target DDM jobs.
SDADBR Number of asynchronous database reads: Total number of PD (11,0)
asynchronous physical database read operations for database
functions by target DDM jobs.
SDPW Number of permanent writes by target DDM jobs. PD (11,0)
SDCS Reserved PD (11,0)
SDPAGF Number of PAG faults. Total number of times the program access PD (11,0)
group (PAG) was referred to by target DDM jobs, but was not in
main storage.
SDEAO Reserved PD (11,0)
SDOBIN Number of binary overflows by target DDM jobs. PD (11,0)
SDODEC Number of decimal overflows by target DDM jobs. PD (11,0)
SDOFLP Number of floating point overflows by target DDM jobs. PD (11,0)
SDIPF Number of times a target distributed data management (DDM) job PD (11,0)
had a page fault on an address that was currently part of an
auxiliary storage I/O operation.
SDWIO Number of times a target distributed data management (DDM) job PD (11,0)
explicitly waited for outstanding asynchronous I/O operations to
complete.
SDSKSC DDM number of socket sends. PD (11,0)
SDSKBS DDM number of socket bytes sent. PD (11,0)
SDSKRC DDM number of socket receives. PD (11,0)
SDSKBR DDM number of socket bytes received. PD (11,0)
SDXRFR DDM stream file reads. PD (11,0)
SDXRFW DDM stream file writes. PD (11,0)
SDXSLR DDM file system symbolic link reads. PD (11,0)
SDXDYR DDM file system directory reads. PD (11,0)
SDDLCH DDM file system lookup cache hits. PD (11,0)
SDDLCM DDM file system lookup cache misses. PD (11,0)
SDSZWT DDM seize/wait time in milliseconds. PD (11,0)
SWCPU Total processing unit time (in milliseconds) used by Client Access PD (11,0)
applications.
SWRES1 Reserved. PD (15,3)
SWRES2 Reserved. PD (11,0)
SWPRTL Total number of print lines of all Client Access application jobs. PD (11,0)
SWPRTP Total number of print pages of all Client Access application jobs. PD (11,0)
SWSPD Total time Client Access application jobs were suspended. PD (11,0)
SWRRT Total time a Client Access applications job waited during rerouting. PD (11,0)
SWNEW Number of startedClient Access application jobs. PD (11,0)

Appendix A. Performance Data 311

Table 40. System Performance Data (Collected for Each Interval) (continued)
Field Name Description Attributes
SWTERM Number of ended Client Access application jobs. PD (11,0)
SWJBCT Number of Client Access jobs. PD (11,0)
SWPDBR Total number of physical synchronous database reads by Client PD (11,0)
Access application jobs.
SWPNDB Total number of physical synchronous nondatabase reads by Client PD (11,0)
Access application jobs.
SWPWRT Total number of physical synchronous database and nondatabase PD (11,0)
writes byClient Access application jobs.
SWLDBR Total number of logical database reads by Client Access application PD (11,0)
jobs.
SWLDBW Total number of logical database writes by Client Access application PD (11,0)
jobs.
SWLDBU Total number of miscellaneous database operations by Client PD (11,0)
Access application jobs.
SWCMPT Total number of communications writes by Client Access application PD (11,0)
jobs.
SWCMGT Total number of communications reads by Client Access application PD (11,0)
jobs.
SWBRG Reserved PD (11,0)
SWPRG Reserved PD (11,0)
SWNDW Number of synchronous nondatabase writes: Total number of PD (11,0)
synchronous physical nondatabase write operations for nondatabase
functions by Client Access applications.
SWDBW Number of synchronous database writes: Total number of PD (11,0)
synchronous physical database write operations for database
functions by Client Access applications.
SWANDW Number of asynchronous nondatabase writes: Total number of PD (11,0)
asynchronous physical nondatabase write operations for
nondatabase functions byClient Access applications.
SWADBW Number of asynchronous database writes: Total number of PD (11,0)
asynchronous physical database write operations for database
functions by Client Access applications.
SWANDR Number of asynchronous nondatabase reads: Total number of PD (11,0)
asynchronous physical nondatabase read operations for
nondatabase functions by Client Access applications.
SWADBR Number of asynchronous database reads: Total number of PD (11,0)
asynchronous physical database read operations for database
functions by Client Access applications.
SWPW Number of permanent writes by Client Access applications. PD (11,0)
SWCS Reserved PD (11,0)
SWPAGF Number of PAG faults. Total number of times the program access PD (11,0)
group (PAG) was referred to by Client Access applications, but was
not in main storage.
SWEAO Reserved PD (11,0)
SWOBIN Number of binary overflows by Client Access applications. PD (11,0)
SWODEC Number of decimal overflows byClient Access applications. PD (11,0)
SWOFLP Number of floating point overflows by Client Access applications. PD (11,0)

312 OS/400 Work Management V4R4

Table 40. System Performance Data (Collected for Each Interval) (continued)
Field Name Description Attributes
SWIPF Number of times a Client Access application job had a page fault on PD (11,0)
an address that was currently part of an auxiliary storage I/O
operation.
SWWIO Number of times a Client Access application job explicitly waited for PD (11,0)
outstanding asynchronous I/O operations to complete.
SWSKSC Client Access number of socket sends. PD (11,0)
SWSKBS Client Access number of socket bytes sent. PD (11,0)
SWSKRC Client Access number of socket receives. PD (11,0)
SWSKBR Client Access number of socket bytes received. PD (11,0)
SWXRFR Client Access stream file reads. PD (11,0)
SWXRFW Client Access stream file writes. PD (11,0)
SWXSLR Client Access file system symbolic link reads. PD (11,0)
SWXDYR Client Access file system directory reads. PD (11,0)
SWDLCH Client Access file system lookup cache hits. PD (11,0)
SWDLCM Client Access file system lookup cache misses. PD (11,0)
SWSZWT Client Access seize/wait time in milliseconds. PD (11,0)
SPCPU Total processing unit time (in milliseconds) used by pass-through PD (11,0)
target jobs.
SPRES1 Total transaction time by pass-through target jobs. PD (15,3)
SPRES2 Total number of transactions by pass-through target jobs. PD (11,0)
SPPRTL Total number of print lines of all pass-through target jobs. PD (11,0)
SPPRTP Total number of print pages of all pass-through target jobs. PD (11,0)
SPSPD Total count of suspended time of pass-through target jobs. PD (11,0)
SPRRT Total count of time a pass-through target job waited during rerouting. PD (11,0)
SPNEW Number of started pass-through target jobs. PD (11,0)
SPTERM Number of ended pass-through target jobs. PD (11,0)
SPJBCT Number of pass-through jobs. PD (11,0)
SPPDBR Total number of physical synchronous database reads by PD (11,0)
pass-through target jobs.
SPPNDB Total number of physical synchronous nondatabase reads by PD (11,0)
pass-through target jobs.
SPPWRT Total number of physical synchronous database and nondatabase PD (11,0)
writes by pass-through target jobs.
SPLDBR Total number of logical database reads by pass-through target jobs. PD (11,0)
SPLDBW Total number of logical database writes by pass-through target jobs. PD (11,0)
SPLDBU Total number of miscellaneous database operations by pass-through PD (11,0)
target jobs.
SPCMPT Total number of communications writes by pass-through target jobs. PD (11,0)
SPCMGT Total number of communications reads by pass-through target jobs. PD (11,0)
SPBRG Reserved PD (11,0)
SPPRG Reserved PD (11,0)

Appendix A. Performance Data 313

Table 40. System Performance Data (Collected for Each Interval) (continued)
Field Name Description Attributes
SPNDW Number of synchronous nondatabase writes: Total number of PD (11,0)
synchronous physical nondatabase write operations for nondatabase
functions by pass-through target jobs.
SPDBW Number of synchronous database writes: Total number of PD (11,0)
synchronous physical database write operations for database
functions by pass-through target jobs.
SPANDW Number of asynchronous nondatabase writes: Total number of PD (11,0)
asynchronous physical nondatabase write operations for
nondatabase functions by pass-through target jobs.
SPADBW Number of asynchronous database writes: Total number of PD (11,0)
asynchronous physical database write operations for database
functions by pass-through target jobs.
SPANDR Number of asynchronous nondatabase reads: Total number of PD (11,0)
asynchronous physical nondatabase read operations for
nondatabase functions by pass-through target jobs.
SPADBR Number of asynchronous database reads: Total number of PD (11,0)
asynchronous physical database read operations for database
functions by pass-through target jobs.
SPPW Number of permanent writes by pass-through target jobs. PD (11,0)
SPCS Reserved PD (11,0)
SPPAGF Number of PAG faults: Total number of times the program access PD (11,0)
group (PAG) was referred to by pass-through target jobs, but was
not in main storage.
SPEAO Reserved PD (11,0)
SPOBIN Number of binary overflows by pass-through target jobs. PD (11,0)
SPODEC Number of decimal overflows by pass-through target jobs. PD (11,0)
SPOFLP Number of floating point overflows by pass-through target jobs. PD (11,0)
SPIPF Number of times a pass-through target job had a page fault on an PD (11,0)
address that was currently part of an auxiliary storage I/O operation.
SPWIO Number of times a pass-through target job explicitly waited for PD (11,0)
outstanding asynchronous I/O operations to complete.
SPSKSC Passthrough number of socket sends. PD (11,0)
SPSKBS Passthrough number of socket bytes sent. PD (11,0)
SPSKRC Passthrough number of socket receives. PD (11,0)
SPSKBR Passthrough number of socket bytes received. PD (11,0)
SPXRFR Passthrough stream file reads. PD (11,0)
SPXRFW Passthrough stream file writes. PD (11,0)
SPXSLR Passthrough file system symbolic link reads. PD (11,0)
SPXDYR Passthrough file system directory reads. PD (11,0)
SPDLCH Passthrough file system lookup cache hits. PD (11,0)
SPDLCM Passthrough file system lookup cache misses. PD (11,0)
SPSZWT Passthrough seize/wait time in milliseconds. PD (11,0)
SMCPU Total processing unit time (in milliseconds) used by multiple PD (11,0)
requester terminal (MRT) jobs (System/36 environment only).
SMRES1 Reserved. PD (15,3)

314 OS/400 Work Management V4R4

Table 40. System Performance Data (Collected for Each Interval) (continued)
Field Name Description Attributes
SMRES2 Reserved. PD (11,0)
SMPRTL Total number of print lines of all MRT jobs (System/36 environment PD (11,0)
only).
SMPRTP Total number of print pages of all MRT jobs (System/36 environment PD (11,0)
only).
SMSPD Total time MRT jobs (System/36 environment only) were suspended. PD (11,0)
SMRRT Total time a MRT job (System/36 environment only) waited during PD (11,0)
rerouting.
SMNEW Number of started MRT jobs (System/36 environment only). PD (11,0)
SMTERM Number of ended MRT jobs (System/36 environment only). PD (11,0)
SMJBCT Number of MRT jobs (System/36 environment only). PD (11,0)
SMPDBR Total number of physical synchronous database reads by MRT jobs PD (11,0)
(System/36 environment only).
SMPNDB Total number of physical synchronous nondatabase reads by MRT PD (11,0)
jobs (System/36 environment only).
SMPWRT Total number of physical synchronous database and nondatabase PD (11,0)
writes by MRT jobs (System/36 environment only).
SMLDBR Total number of logical database reads by MRT jobs (System/36 PD (11,0)
environment only).
SMLDBW Total number of logical database writes by MRT jobs (System/36 PD (11,0)
environment only).
SMLDBU Total number of miscellaneous database operations by MRT jobs PD (11,0)
(System/36 environment only).
SMCMPT Total number of communications writes by MRT jobs (System/36 PD (11,0)
environment only).
SMCMGT Total number of communications reads by MRT jobs (System/36 PD (11,0)
environment only).
SMBRG Reserved PD (11,0)
SMPRG Reserved PD (11,0)
SMNDW Number of synchronous nondatabase writes: Total number of PD (11,0)
synchronous physical nondatabase write operations for nondatabase
functions by MRT jobs (System/36 environment only).
SMDBW Number of synchronous database writes: Total number of PD (11,0)
synchronous physical database write operations for database
functions by MRT jobs (System/36 environment only).
SMANDW Number of asynchronous nondatabase writes: Total number of PD (11,0)
asynchronous physical nondatabase write operations for
nondatabase functions by MRT jobs (System/36 environment only).
SMADBW Number of asynchronous database writes: Total number of PD (11,0)
asynchronous physical database write operations for database
functions by MRT jobs (System/36 environment only).
SMANDR Number of asynchronous nondatabase reads: Total number of PD (11,0)
asynchronous physical nondatabase read operations for
nondatabase functions by MRT jobs (System/36 environment only).
SMADBR Number of asynchronous database reads: Total number of PD (11,0)
asynchronous physical database read operations for database
functions by MRT jobs (System/36 environment only).

Appendix A. Performance Data 315

Table 40. System Performance Data (Collected for Each Interval) (continued)
Field Name Description Attributes
SMPW Number of permanent writes by MRT jobs (System/36 environment PD (11,0)
only).
SMCS Reserved PD (11,0)
SMPAGF Number of PAG faults: Total number of times the program access PD (11,0)
group (PAG) was referred to by MRT jobs (System/36 environment
only), but was not in main storage.
SMEAO Reserved PD (11,0)
SMOBIN Number of binary overflows by MRT jobs (System/36 environment PD (11,0)
only).
SMODEC Number of decimal overflows by MRT jobs (System/36 environment PD (11,0)
only).
SMOFLP Number of floating point overflows by MRT jobs (System/36 PD (11,0)
environment only).
SMIPF Number of times a MRT job (System/36 environment only) had a PD (11,0)
page fault on an address that was currently part of an auxiliary
storage I/O operation.
SMWIO Number of times a MRT job (System/36 environment only) explicitly PD (11,0)
waited for outstanding asynchronous I/O operations to complete.
SMSKSC MRTS Number of socket sends. PD (11,0)
SMSKBS MRTS Number of socket bytes sent. PD (11,0)
SMSKRC MRTS Number of socket receives. PD (11,0)
SMSKBR MRTS Number of socket bytes received. PD (11,0)
SMXRFR MRTS stream file reads. PD (11,0)
SMXRFW MRTS stream file writes. PD (11,0)
SMXSLR MRTS file system symbolic link reads. PD (11,0)
SMXDYR MRTS file system directory reads. PD (11,0)
SMDLCH MRTS file system lookup cache hits. PD (11,0)
SMDLCM MRTS file system lookup cache misses. PD (11,0)
SMSZWT MRTS seize/wait time in milliseconds. PD (11,0)
S6CPU Total processing unit time (in milliseconds) used by System/36 PD (11,0)
environment jobs.
S6TRNT Total response time. PD (15,3)
S6TRNS Number of transactions. PD (11,0)
S6PRTL Total number of print lines of all System/36 environment jobs. PD (11,0)
S6PRTP Total number of print pages of all System/36 environment jobs. PD (11,0)
S6SPD Total time System/36 environment jobs were suspended. PD (11,0)
S6RRT Total time a System/36 environment job waited during rerouting. PD (11,0)
S6NEW Number of started System/36 environment jobs. PD (11,0)
S6TERM Number of ended System/36 environment jobs. PD (11,0)
S6JBCT Number of System/36 environment jobs. PD (11,0)
S6PDBR Total number of physical synchronous database reads by System/36 PD (11,0)
environment jobs.

316 OS/400 Work Management V4R4

Table 40. System Performance Data (Collected for Each Interval) (continued)
Field Name Description Attributes
S6PNDB Total number of physical synchronous nondatabase reads by PD (11,0)
System/36 environment jobs.
S6PWRT Total number of physical synchronous database and nondatabase PD (11,0)
writes by System/36 environment jobs.
S6LDBR Total number of logical database reads by System/36 environment PD (11,0)
jobs.
S6LDBW Total number of logical database writes by System/36 environment PD (11,0)
jobs.
S6LDBU Total number of miscellaneous database operations by System/36 PD (11,0)
environment jobs.
S6CMPT Total number of communications writes by System/36 environment PD (11,0)
jobs.
S6CMGT Total number of communications reads by System/36 environment PD (11,0)
jobs.
S6BRG Reserved PD (11,0)
S6PRG Reserved PD (11,0)
S6NDW Number of synchronous nondatabase writes: Total number of PD (11,0)
synchronous physical nondatabase write operations for nondatabase
functions by System/36 environment jobs.
S6DBW Number of synchronous database writes: Total number of PD (11,0)
synchronous physical database write operations for database
functions by System/36 environment jobs.
S6ANDW Number of asynchronous nondatabase writes: Total number of PD (11,0)
asynchronous physical nondatabase write operations for
nondatabase functions by System/36 environment jobs.
S6ADBW Number of asynchronous database writes: Total number of PD (11,0)
asynchronous physical database write operations for database
functions by System/36 environment jobs.
S6ANDR Number of asynchronous nondatabase reads: Total number of PD (11,0)
asynchronous physical nondatabase read operations for
nondatabase functions by System/36 environment jobs.
S6ADBR Number of asynchronous database reads: Total number of PD (11,0)
asynchronous physical database read operations for database
functions by System/36 environment jobs.
S6PW Number of permanent writes by System/36 environment jobs. PD (11,0)
S6CS Reserved PD (11,0)
S6PAGF Number of PAG faults: Total number of times the program access PD (11,0)
group (PAG) was referred to by System/36 environment jobs, but
was not in main storage.
S6EAO Reserved PD (11,0)
S6OBIN Number of binary overflows by System/36 environment jobs. PD (11,0)
S6ODEC Number of decimal overflows by System/36 environment jobs. PD (11,0)
S6OFLP Number of floating point overflows by System/36 environment jobs. PD (11,0)
S6IPF Number of times a System/36 environment job had a page fault on PD (11,0)
an address that was currently part of an auxiliary storage I/O
operation.

Appendix A. Performance Data 317

Table 40. System Performance Data (Collected for Each Interval) (continued)
Field Name Description Attributes
S6WIO Number of times a System/36 environment job explicitly waited for PD (11,0)
outstanding asynchronous I/O operations to complete.
S6SKSC S36E number of socket sends. PD (11,0)
S6SKBS S36E number of socket bytes sent. PD (11,0)
S6SKRC S36E number of socket receives. PD (11,0)
S6SKBR S36E number of socket bytes received. PD (11,0)
S6XRFR S36E file system directory reads. PD (11,0)
S6XRFW S36E file system directory writes. PD (11,0)
S6XSLR S36E file system symbolic link reads. PD (11,0)
S6XDYR S36E directory stream file reads. PD (11,0)
S6DLCH S36E file system lookup cache hits. PD (11,0)
S6DLCM S36E file system lookup cache misses. PD (11,0)
S6SZWT S36E seize/wait time in milliseconds. PD (11,0)
SECPU Total processing unit time (in milliseconds) used by communications PD (11,0)
batch jobs.
SERES1 Reserved. PD (15,3)
SERES2 Reserved. PD (11,0)
SEPRTL Total number of print lines of all communications batch jobs. PD (11,0)
SEPRTP Total number of print pages of all communications batch jobs. PD (11,0)
SESPD Total time communications batch jobs were suspended. PD (11,0)
SERRT Total time a communications batch job waited during rerouting. PD (11,0)
SENEW Number of started communications batch jobs. PD (11,0)
SETERM Number of ended communications batch jobs. PD (11,0)
SEJBCT Number of communications batch jobs. PD (11,0)
SEPDBR Total number of physical synchronous database reads by PD (11,0)
communications batch jobs.
SEPNDB Total number of physical synchronous nondatabase reads by PD (11,0)
communications batch jobs.
SEPWRT Total number of physical synchronous database and nondatabase PD (11,0)
writes by communications batch jobs.
SELDBR Total number of logical database reads by communications batch PD (11,0)
jobs.
SELDBW Total number of logical database writes by communications batch PD (11,0)
jobs.
SELDBU Total number of miscellaneous database operations by PD (11,0)
communications batch jobs.
SECMPT Total number of communications writes by communications batch PD (11,0)
jobs.
SECMGT Total number of communications reads by communications batch PD (11,0)
jobs.
SEBRG Reserved PD (11,0)
SEPRG Reserved PD (11,0)

318 OS/400 Work Management V4R4

Table 40. System Performance Data (Collected for Each Interval) (continued)
Field Name Description Attributes
SENDW Number of synchronous nondatabase writes: Total number of PD (11,0)
synchronous physical nondatabase write operations for nondatabase
functions by communications batch jobs.
SEDBW Number of synchronous database writes: Total number of PD (11,0)
synchronous physical database write operations for database
functions by communications batch jobs.
SEANDW Number of asynchronous nondatabase writes: Total number of PD (11,0)
asynchronous physical nondatabase write operations for
nondatabase functions by communications batch jobs.
SEADBW Number of asynchronous database writes: Total number of PD (11,0)
asynchronous physical database write operations for database
functions by communications batch jobs.
SEANDR Number of asynchronous nondatabase reads: Total number of PD (11,0)
asynchronous physical nondatabase read operations for
nondatabase functions by communications batch jobs.
SEADBR Number of asynchronous database reads: Total number of PD (11,0)
asynchronous physical database read operations for database
functions by communications batch jobs.
SEPW Number of permanent writes by communications batch jobs. PD (11,0)
SECS Reserved PD (11,0)
SEPAGF Number of PAG faults: Total number of times the program access PD (11,0)
group (PAG) was referred to by communications batch jobs, but was
not in main storage.
SEEAO Reserved PD (11,0)
SEOBIN Number of binary overflows by communications batch jobs. PD (11,0)
SEODEC Number of decimal overflows by communications batch jobs. PD (11,0)
SEOFLP Number of floating point overflows by communications batch jobs. PD (11,0)
SEIPF Number of times a communications batch job had a page fault on PD (11,0)
an address that was currently part of an auxiliary storage I/O
operation.
SEWIO Number of times a communications batch job explicitly waited for PD (11,0)
outstanding asynchronous I/O operations to complete.
SESKSC Evoke number of socket sends. PD (11,0)
SESKBS Evoke number of socket bytes sent. PD (11,0)
SESKRC Evoke number of socket receives. PD (11,0)
SESKBR Evoke number of socket bytes received. PD (11,0)
SEXRFR Evoke file system directory reads. PD (11,0)
SEXRFW Evoke file system stream file writes. PD (11,0)
SEXSLR Evoke file system symbolic link reads. PD (11,0)
SEXDYR Evoke stream file reads. PD (11,0)
SEDLCH Evoke file system lookup cache hits. PD (11,0)
SEDLCM Evoke file system lookup cache misses. PD (11,0)
SESZWT Evoke seize/wait time in milliseconds. PD (11,0)
SACPU Total processing unit time (in milliseconds) used by autostart jobs. PD (11,0)
SARES1 Reserved. PD (15,3)

Appendix A. Performance Data 319

Table 40. System Performance Data (Collected for Each Interval) (continued)
Field Name Description Attributes
SARES2 Reserved. PD (11,0)
SAPRTL Total number of print lines of all autostart jobs. PD (11,0)
SAPRTP Total number of print pages of all autostart jobs. PD (11,0)
SASPD Total time autostart jobs were suspended. PD (11,0)
SARRT Total time an autostart job waited during rerouting. PD (11,0)
SANEW Number of started autostart jobs. PD (11,0)
SATERM Number of ended autostart jobs. PD (11,0)
SAJBCT Number of autostart jobs. PD (11,0)
SAPDBR Total number of physical synchronous database reads by autostart PD (11,0)
jobs.
SAPNDB Total number of physical synchronous nondatabase reads by PD (11,0)
autostart jobs.
SAPWRT Total number of physical synchronous database and nondatabase PD (11,0)
writes by autostart jobs.
SALDBR Total number of logical database reads by autostart jobs. PD (11,0)
SALDBW Total number of logical database writes by autostart jobs. PD (11,0)
SALDBU Total number of miscellaneous database operations by autostart PD (11,0)
jobs.
SACMPT Total number of communications writes by autostart jobs. PD (11,0)
SACMGT Total number of communications reads by autostart jobs. PD (11,0)
SABRG Reserved PD (11,0)
SAPRG Reserved PD (11,0)
SANDW Number of synchronous nondatabase writes: Total number of PD (11,0)
synchronous physical nondatabase write operations for nondatabase
functions by communications batch jobs.
SADBW Number of synchronous database writes: Total number of PD (11,0)
synchronous physical database write operations for database
functions by autostart jobs.
SAANDW Number of asynchronous nondatabase writes: Total number of PD (11,0)
asynchronous physical nondatabase write operations for
nondatabase functions by autostart jobs.
SAADBW Number of asynchronous database writes: Total number of PD (11,0)
asynchronous physical database write operations for database
functions by autostart jobs.
SAANDR Number of asynchronous nondatabase reads: Total number of PD (11,0)
asynchronous physical nondatabase read operations for
nondatabase functions by autostart jobs.
SAADBR Number of asynchronous database reads: Total number of PD (11,0)
asynchronous physical database read operations for database
functions by autostart jobs.
SAPW Number of permanent writes by autostart jobs. PD (11,0)
SACS Reserved PD (11,0)
SAPAGF Number of PAG faults: Total number of times the program access PD (11,0)
group (PAG) was referred to by autostart jobs, but was not in main
storage.

320 OS/400 Work Management V4R4

Table 40. System Performance Data (Collected for Each Interval) (continued)
Field Name Description Attributes
SAEAO Reserved PD (11,0)
SAOBIN Number of binary overflows by autostart jobs. PD (11,0)
SAODEC Number of decimal overflows by autostart jobs. PD (11,0)
SAOFLP Number of floating point overflows by autostart jobs. PD (11,0)
SAIPF Number of times an autostart job had a page fault on an address PD (11,0)
that was currently part of an auxiliary storage I/O operation.
SAWIO Number of times an autostart job explicitly waited for outstanding PD (11,0)
asynchronous I/O operations to complete.
SASKSC Autostart number of socket sends. PD (11,0)
SASKBS Autostart number of socket bytes sent. PD (11,0)
SASKRC Autostart number of socket receives. PD (11,0)
SASKBR Autostart number of socket bytes received. PD (11,0)
SAXRFR Autostart stream file reads. PD (11,0)
SAXRFW Autostart stream file writes. PD (11,0)
SAXSLR Autostart file system symbolic link reads. PD (11,0)
SAXDYR Autostart file system directory reads. PD (11,0)
SADLCH Autostart file system lookup cache hits. PD (11,0)
SADLCM Autostart file system lookup cache misses. PD (11,0)
SASZWT Autostart seize/wait time in milliseconds. PD (11,0)
SBCPU Total processing unit time (in milliseconds) used by batch jobs. PD (11,0)
SBRES1 Reserved. PD (15,3)
SBRES2 Reserved. PD (11,0)
SBPRTL Total number of print lines of all batch jobs. PD (11,0)
SBPRTP Total number of print pages of all batch jobs. PD (11,0)
SBSPD Total time batch jobs were suspended. PD (11,0)
SBRRT Total time a batch job waited during rerouting. PD (11,0)
SBNEW Number of started batch jobs. PD (11,0)
SBTERM Number of ended batch jobs. PD (11,0)
SBJBCT Number of batch jobs. PD (11,0)
SBPDBR Total number of physical synchronous database reads by batch jobs. PD (11,0)
SBPNDB Total number of physical synchronous nondatabase reads by batch PD (11,0)
jobs.
SBPWRT Total number of physical synchronous database and nondatabase PD (11,0)
writes by batch jobs.
SBLDBR Total number of logical database reads by batch jobs. PD (11,0)
SBLDBW Total number of logical database writes by batch jobs. PD (11,0)
SBLDBU Total number of miscellaneous database operations by batch jobs. PD (11,0)
SBCMPT Total number of communications writes by batch jobs. PD (11,0)
SBCMGT Total number of communications reads by batch jobs. PD (11,0)
SBBRG Reserved PD (11,0)
SBPRG Reserved PD (11,0)

Appendix A. Performance Data 321

Table 40. System Performance Data (Collected for Each Interval) (continued)
Field Name Description Attributes
SBNDW Number of synchronous nondatabase writes: Total number of PD (11,0)
synchronous physical nondatabase write operations for nondatabase
functions by batch jobs.
SBDBW Number of synchronous database writes: Total number of PD (11,0)
synchronous physical database write operations for database
functions by batch jobs.
SBANDW Number of asynchronous nondatabase writes: Total number of PD (11,0)
asynchronous physical nondatabase write operations for
nondatabase functions by batch jobs.
SBADBW Number of asynchronous database writes: Total number of PD (11,0)
asynchronous physical database write operations for database
functions by batch jobs.
SBANDR Number of asynchronous nondatabase reads: Total number of PD (11,0)
asynchronous physical nondatabase read operations for database
functions by batch jobs.
SBADBR Number of asynchronous database reads: Total number of PD (11,0)
asynchronous physical database read operations for database
functions by batch jobs.
SBPW Number of permanent writes by batch jobs. PD (11,0)
SBCS Reserved PD (11,0)
SBPAGF Number of PAG faults: Total number of times the program access PD (11,0)
group (PAG) was referred to by batch jobs, but was not in main
storage.
SBEAO Reserved PD (11,0)
SBOBIN Number of binary overflows by batch jobs. PD (11,0)
SBODEC Number of decimal overflows by batch jobs. PD (11,0)
SBOFLP Number of floating point overflows by batch jobs. PD (11,0)
SBIPF Number of times a batch job had a page fault on an address that PD (11,0)
was currently part of an auxiliary storage I/O operation.
SBWIO Number of times a batch job explicitly waited for outstanding PD (11,0)
asynchronous I/O operations to complete.
SBSKSC Batch number of socket sends. PD (11,0)
SBSKBS Batch number of socket bytes received. PD (11,0)
SBSKRC Batch number of socket receives. PD (11,0)
SBSKBR Batch number of socket bytes received. PD (11,0)
SBXRFR Batch stream file reads. PD (11,0)
SBXRFW Batch stream file writes. PD (11,0)
SBXSLR Batch file system symbolic link reads. PD (11,0)
SBXDYR Batch file system directory reads. PD (11,0)
SBDLCH Batch file system lookup cache hits. PD (11,0)
SBDLCM Batch file system lookup cache misses. PD (11,0)
SBSZWT Batch seize/wait time in milliseconds. PD (11,0)
SICPU Total processing unit time (in milliseconds) used by interactive jobs. PD (11,0)
SITRNT Total transaction time by interactive jobs. PD (15,3)
SITRNS Total number of transactions by interactive jobs. PD (11,0)

322 OS/400 Work Management V4R4

Table 40. System Performance Data (Collected for Each Interval) (continued)
Field Name Description Attributes
SIPRTL Total number of print lines of all interactive jobs. PD (11,0)
SIPRTP Total number of print pages of all interactive jobs. PD (11,0)
SISPD Total time interactive jobs were suspended. PD (11,0)
SIRRT Total time an interactive job waited during rerouting. PD (11,0)
SINEW Number of started interactive jobs. PD (11,0)
SITERM Number of ended interactive jobs. PD (11,0)
SIJBCT Number of ended interactive jobs. PD (11,0)
SIPDBR Total number of physical synchronous database reads by interactive PD (11,0)
jobs.
SIPNDB Total number of physical synchronous nondatabase reads by PD (11,0)
interactive jobs.
SIPWRT Total number of physical synchronous database and nondatabase PD (11,0)
writes by interactive jobs.
SILDBR Total number of logical database reads by interactive jobs. PD (11,0)
SILDBW Total number of logical database writes by interactive jobs. PD (11,0)
SILDBU Total number of miscellaneous database operations by interactive PD (11,0)
jobs.
SICMPT Total number of communications writes by interactive jobs. PD (11,0)
SICMGT Total number of communications reads by interactive jobs. PD (11,0)
SIBRG Reserved PD (11,0)
SIPRG Reserved PD (11,0)
SINDW Number of synchronous nondatabase writes: Total number of PD (11,0)
synchronous physical nondatabase write operations for nondatabase
functions by interactive jobs.
SIDBW Number of synchronous database writes: Total number of PD (11,0)
synchronous physical database write operations for database
functions by interactive jobs.
SIANDW Number of asynchronous nondatabase writes: Total number of PD (11,0)
asynchronous physical nondatabase write operations for
nondatabase functions by interactive jobs.
SIADBW Number of asynchronous database writes: Total number of PD (11,0)
asynchronous physical database write operations for database
functions by interactive jobs.
SIANDR Number of asynchronous nondatabase reads: Total number of PD (11,0)
asynchronous physical nondatabase read operations for
nondatabase functions by interactive jobs.
SIADBR Number of asynchronous database reads: Total number of PD (11,0)
asynchronous physical database read operations for database
functions by interactive jobs.
SIPW Number of permanent writes by interactive jobs. PD (11,0)
SICS Reserved PD (11,0)
SIPAGF Number of PAG faults: Total number of times the program access PD (11,0)
group (PAG) was referred to by interactive jobs but was not in main
storage.
SIEAO Reserved PD (11,0)

Appendix A. Performance Data 323

Table 40. System Performance Data (Collected for Each Interval) (continued)
Field Name Description Attributes
SIOBIN Number of binary overflows by interactive jobs. PD (11,0)
SIODEC Number of decimal overflows interactive jobs. PD (11,0)
SIOFLP Number of floating point overflows by interactive jobs. PD (11,0)
SIIPF Number of times an interactive job had a page fault on an address PD (11,0)
that was currently part of an auxiliary storage I/O operation.
SIWIO Number of times an interactive job explicitly waited for outstanding PD (11,0)
asynchronous I/O operations to complete.
SISKSC Interactive number of socket sends. PD (11,0)
SISKBS Interactive number of socket bytes sent. PD (11,0)
SISKRC Interactive number of socket receives. PD (11,0)
SISKBR Interactive number of socket bytes received. PD (11,0)
SIXRFR Interactive stream file reads. PD (11,0)
SIXRFW Interactive stream file writes. PD (11,0)
SIXSLR Interactive file system symbolic link reads. PD (11,0)
SIXDYR Interactive file system directory reads. PD (11,0)
SIDLCH Interactive file lookup cache hits. PD (11,0)
SIDLCM Interactive file lookup cache misses. PD (11,0)
SISZWT Interactive seize/wait time in milliseconds. PD (11,0)
SXCPU Total processing unit time (in milliseconds) used by start CPF PD (11,0)
(SCPF) jobs/spool reader/spool writer.
SXRES1 Reserved. PD (15,3)
SXRES2 Reserved. PD (11,0)
SXPRTL Total number of print lines of all SCPF jobs/spool reader/spool PD (11,0)
writer.
SXPRTP Total number of print pages of all SCPF jobs/spool reader/spool PD (11,0)
writer.
SXSPD Total time SCPF jobs/spool reader/spool writer were suspended. PD (11,0)
SXRRT Total time SCPF jobs or spool reader/writer waited during rerouting. PD (11,0)
SXNEW Number of started SCPF jobs or spool reader/writer. PD (11,0)
SXTERM Number of ended SCPF jobs or spool reader/writer. PD (11,0)
SXJBCT Number of SCPF jobs or spool reader/writer. PD (11,0)
SXPDBR Total number of physical synchronous database reads by SCPF PD (11,0)
jobs/spool reader/spool writer.
SXPNDB Total number of physical synchronous nondatabase reads by SCPF PD (11,0)
jobs/spool reader/spool writer.
SXPWRT Total number of physical synchronous database and nondatabase PD (11,0)
writes by SCPF jobs/spool reader/spool writer.
SXLDBR Total number of logical database reads by SCPF jobs/spool PD (11,0)
reader/spool writer.
SXLDBW Total number of logical database writes by SCPF jobs/spool PD (11,0)
reader/spool writer.
SXLDBU Total number of miscellaneous database operations by SCPF PD (11,0)
jobs/spool reader/spool writer.

324 OS/400 Work Management V4R4

Table 40. System Performance Data (Collected for Each Interval) (continued)
Field Name Description Attributes
SXCMPT Total number of communications writes by SCPF jobs/spool PD (11,0)
reader/spool writer.
SXCMGT Total number of communications reads by SCPF jobs/spool PD (11,0)
reader/spool writer.
SXBRG Reserved PD (11,0)
SXPRG Reserved PD (11,0)
SXNDW Number of synchronous nondatabase writes: Total number of PD (11,0)
synchronous physical nondatabase write operations for nondatabase
functions by SCPF jobs/spool reader/spool writer.
SXDBW Number of synchronous database writes: Total number of PD (11,0)
synchronous physical database write operations for database
functions by SCPF jobs/spool reader/spool writer.
SXANDW Number of asynchronous nondatabase writes: Total number of PD (11,0)
asynchronous physical nondatabase write operations for database
functions by SCPF jobs/spool reader/spool writer.
SXADBW Number of asynchronous database writes: Total number of PD (11,0)
asynchronous physical database write operations for database
functions by SCPF jobs/spool reader/spool writer.
SXANDR Number of asynchronous nondatabase reads: Total number of PD (11,0)
asynchronous physical nondatabase read operations for
nondatabase functions by SCPF jobs/spool reader/spool writer.
SXADBR Number of asynchronous database reads: Total number of PD (11,0)
asynchronous physical database read operations for database
functions by SCPF jobs/spool reader/spool writer.
SXPW Number of permanent writes by SCPF jobs/spool reader/spool PD (11,0)
writer.
SXCS Reserved PD (11,0)
SXPAGF Number of PAG faults: Total number of times the program access PD (11,0)
group (PAG) was referred to by SCPF jobs/spool reader/spool writer,
but was not in main storage
SXEAO Reserved PD (11,0)
SXOBIN Number of binary overflows by SCPF jobs/spool reader/spool writer. PD (11,0)
SXODEC Number of decimal overflows by SCPF jobs/spool reader/spool PD (11,0)
writer.
SXOFLP Number of floating point overflows by SCPF jobs/spool reader/spool PD (11,0)
writer.
SXIPF Number of times a SCPF job or spool reader or spool writer job had PD (11,0)
a page fault on an address that was currently part of an auxiliary
storage I/O operation.
SXWIO Number of times a SCPF job or spool reader or spool writer job PD (11,0)
explicitly waited for outstanding asynchronous I/O operations to
complete.
SXSKSC Spool number of socket sends. PD (11,0)
SXSKBS Spool number of socket bytes sent. PD (11,0)
SXSKRC Spool number of socket receives. PD (11,0)
SXSKBR Spool number of socket bytes received. PD (11,0)
SXXRFR Spool stream file reads. PD (11,0)

Appendix A. Performance Data 325

Table 40. System Performance Data (Collected for Each Interval) (continued)
Field Name Description Attributes
SXXRFW Spool stream file writes. PD (11,0)
SXXSLR Spool file system symbolic link reads. PD (11,0)
SXXDYR Spool file system directory reads. PD (11,0)
SXXDLCH Spool file system lookup cache hits. PD (11,0)
SXXDLCM Spool file system lookup cache misses. PD (11,0)
SXSZWT Spool seize/wait time in milliseconds. PD (11,0)
SHCPU Total processing unit time (in milliseconds) used by PD (11,0)
microcode/system jobs.
SMPLP Machine pool paging: Number of pages transferred in and out of PD (11,0)
machine pool.
SMUPL Highest user pool paging: Number of pages transferred in and out of PD (11,0)
user pool.
SUPLI Pool with highest paging: Pool number with highest number of C (2)
pages transferred in and out.
SMXDU Maximum disk utilization. PD (11,0)
SMXDUI Actuator with maximum utilization. C (4)
SMMMT Time (in seconds) spent at MRTMAX by all MRT requests. PD (11,0)
SMME Number of requesters that routed to a MRT. PD (11,0)
SYFOPN Number of full opens system wide. PD (11,0)
SYIXRB Number of index rebuilds system wide. PD (11,0)
SYJOXR Start journal operations initiated by user. PD (11,0)
SYJOXP Stop journal operations initiated by user. PD (11,0)
SYJOIR Start journal operations initiated by system. PD (11,0)
SYJOIP Stop journal operations initiated by system. PD (11,0)
SYJOXD Journal deposits resulting from user-journaled objects. PD (11,0)
SYJOID Journal deposits resulting from system-journaled objects—total. PD (11,0)
SYJOJP Journal deposits resulting from system-journaled objects to PD (11,0)
user-created journals.
SYJOBJ Bundle writes to user-created journals. PD (11,0)
SYJOBD Bundle writes to internal system journals. PD (11,0)
SYJOJY Exposed access paths currently being journaled by the system. PD (11,0)
SYJOJN Exposed access paths currently not being journaled. PD (11,0)
SYJOSE System-estimated access path recovery time exposure in PD (11,0)
milliseconds.
SYJORT System-managed access path tuning adjustments. PD (11,0)
SYJOND System-estimated access path recovery time exposure in PD (11,0)
milliseconds if no access paths were being journaled by the system.
SYSCPU Total processing time (in milliseconds) used by the first (or only) PD (9,0)
processing unit.
SYCPU2....32 Total processing time (in milliseconds) used by the PD (9,0)
second....thirty-second processing unit. This value is zero if there is
only one processing unit.

326 OS/400 Work Management V4R4

 Table 40. System Performance Data (Collected for Each Interval) (continued)
Field Name Description Attributes
| SYHEAO Number of tolerated crossings of a 16 Mb boundary within any PD (11,0)
| teraspace. Also called teraspace EAO exceptions.
| SYHFTS Number of space address computations (not addressing teraspace) PD (11,0)
| that required extra processing. This may occur when a subtraction
| or addition of a signed value causes a result that is within the first
| page of a space object or associated space for which the machine
| did not choose alignment. Also called false traps.
| SYHFTH Number of teraspace address computations that required extra PD (11,0)
| processing. This occurs when a subtraction or addition of a signed
| value causes a result that is within the first page after any 16 MB
| boundary in teraspace. Also called false traps.

| File Name: QAPMSYSCPU

| System CPU Interval File Entries: Table 41 contains system CPU values that are
| collected via the System CPU category.

| Table 41 on page 327 shows which system performance data is collected.

| Table 41. System Performance Data (Collected for Each Interval)
| Field Name Description Attributes
| INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
| performance monitor job.
| DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
| the sample interval.
| INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
| sample interval.
| DTECEN Century digit. C (1)
| SCTNUM Total number of system CPUs available. Zoned (3,0)
| SCBGN CPU number of the first CPU reported in this record. Zoned (3,0)
| SCPU01 Total processing time (in milliseconds) used by the first CPU
| reported in this record.
| Note: The number of CPU utilization fields is increased from 2 to
| 32. Therefore, in addition to SCPU01, fields exist for
| SCPU02..SCPU32.

| File Name: QAPMSYSTEM

| System Interval File Entries: Table 42 contains system-wide data that is obtained
| via the System category.

| Table 42 on page 327 shows which system performance data is collected.

| Table 42. System Performance Data (Collected for Each System Level)
| Field Name Description Attributes
| INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
| performance monitor job.
| DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
| the sample interval.

Appendix A. Performance Data 327

| Table 42. System Performance Data (Collected for Each System Level) (continued)
| Field Name Description Attributes
| INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
| sample interval.
| DTESEN Century digit. C (1)
| SYDPGF Directory page faults: Number of times a page of the auxiliary PD (11,0)
| storage directory was transferred to main storage for a look-up or an
| allocation operation.
| SYAPGF Access group member page faults: Number of times a page of an PD (11,0)
| object contained in an access group was transferred to main storage
| independently of the access group. This transfer occurs when the
| containing access group was purged, or because portions of the
| containing access group are displaced from main storage.
| SYMPGF Microcode page faults: Number of times a page of microcode was PD (11,0)
| transferred to main storage.
| SYMCTR Microtask read operations: Number of transfers of one or more PD (11,0)
| pages of data from auxiliary storage because of a microtask rather
| than a process.
| SYMCTW Microtask write operations: Number of transfers of one or more PD (11,0)
| pages of data from main storage to auxiliary storage because of a
| microtask rather than a process.
| SYSASP System auxiliary storage pools space available: Number of bytes of PD (15,0)
| space on auxiliary storage available for allocation in the system ASP
| that is not currently assigned to machine interface (MI) objects or
| internal machine functions.
| SYPRMW Permanent data transferred from main storage: Number of 512-byte PD (11,0)
| blocks of permanent data transferred from main storage to the
| system ASP in auxiliary storage since the last sample.
| SYSIZC Size count: Total number of size exceptions. PD (11,0)
| SYDECD Decimal data count: Total number of decimal data exceptions. PD (11,0)
| SYSEZC Seize count: Total number of seize wait exceptions. PD (11,0)
| SYSZWT Seize/Wait time in milliseconds. PD (11,0)
| SYSYNL Synchronous lock conflict count. PD (11,0)
| SYASYL Asynchronous lock conflict count. PD (11,0)
| SYVFYC Verify count. PD (11,0)
| SYAUTH Authority look-up count. PD (11,0)
| SYEXPN Total number of exceptions. PD (11,0)
| SYLRT1 Transactions in first response time monitor bracket: Total number of PD (9,0)
| local workstation transactions with response time less than the value
| of boundary 1 specified on the STRPFRMON command.
| SYLRT2 Transactions in second response time monitor bracket: Total number PD (9,0)
| of local workstation transactions with response time less than the
| value of boundary 2 and greater than the value of boundary 1
| specified on the STRPFRMON command.
| SYLRT3 Transactions in third response time monitor bracket: Total number of PD (9,0)
| local workstation transactions with response time less than the value
| of boundary 3 and greater than the value of boundary 2 specified on
| the STRPFRMON command.

328 OS/400 Work Management V4R4

| Table 42. System Performance Data (Collected for Each System Level) (continued)
| Field Name Description Attributes
| SYLRT4 Transactions in fourth response time monitor bracket: Total number PD (9,0)
| of local workstation transactions with response time less than the
| value of boundary 4 and greater than the value of boundary 3
| specified on the STRPFRMON command.
| SYLRT5 Transactions in fifth response time monitor bracket: Total number of PD (9,0)
| local workstation transactions with response time greater than the
| value of boundary 5 specified on STRPFRMON command.
| SHCPU Total processing unit time (in milliseconds) used by PD (11,0)
| microcode/system jobs.
| SMPLP Machine pool paging: Number of pages transferred in and out of PD (11,0)
| machine pool.
| SMUPL Highest user pool paging: Number of pages transferred in and out of PD (11,0)
| user pool.
| SUPLI Pool with highest paging: Pool number with highest number of C (2)
| pages transferred in and out.
| SMXDU Maximum disk utilization. PD (11,0)
| SMXDUI Actuator with maximum utilization. C (4)
| SMMMT Time (in seconds) spent at MRTMAX by all MRT requests. PD (11,0)
| SMME Number of requesters that routed to an MRT. PD (11,0)
| SYFOPN Number of full opens system wide. PD (11,0)
| SYIXRB Number of index rebuilds system wide. PD (11,0)
| SYJOXR Start journal operations initiated by user. PD (11,0)
| SYJOXP Stop journal operations initiated by user. PD (11,0)
| SYJOIR Start journal operations initiated by system. PD (11,0)
| SYJOIP Stop journal operations initiated by system. PD (11,0)
| SYJOXD Journal deposits resulting from user-journaled objects. PD (11,0)
| SYJOID Journal deposits resulting from system-journaled objects—total. PD (11,0)
| SYJOJP Journal deposits resulting from system-journaled objects to PD (11,0)
| user-created journals.
| SYJOBJ Bundle writes to user-created journals. PD (11,0)
| SYJOBD Bundle writes to internal system journals. PD (11,0)
| SYJOJY Exposed access paths currently being journaled by the system. PD (11,0)
| SYJOJN Exposed access paths currently not being journaled. PD (11,0)
| SYJOSE System-estimated access path recovery time exposure in PD (11,0)
| milliseconds.
| SYJORT System-managed access path tuning adjustments. PD (11,0)
| SYJOND System-estimated access path recovery time exposure in PD (11,0)
| milliseconds if no access paths were being journaled by the system.
| SYSCPU Total processing time (in milliseconds) used by the first (or only) PD (9,0)
| processing unit.
| SYHEAO Number of tolerated crossings of a 16 Mb boundary within any PD (11,0)
| teraspace. Also called teraspace EAO exceptions.

Appendix A. Performance Data 329

| Table 42. System Performance Data (Collected for Each System Level) (continued)
| Field Name Description Attributes
| SYHFTS Number of space address computations (not addressing teraspace) PD (11,0)
| that required extra processing. This may occur when a subtraction
| or addition of a signed value causes a result that is within the first
| page of a space object or associated space for which the machine
| did not choose alignment. Also called false traps.
| SYFTH Number of teraspace address computations that required extra PD (11,0)
| processing. This occurs when a subtraction or addition of a signed
| value causes a result that is within the first page after any 16 MB
| boundary in teraspace. Also called false traps.
| SYJDDM Reserved. C (3)
| SYJCA4 Reserved. C (3)
| SYJPAS Reserved. C (3)
| SYJMRT Reserved. C (3)
| SYJS6E Reserved. C (3)
| SYJCME Reserved. C (3)
| SYJAUT Reserved. C (3)
| SYJBCH Reserved. C (3)
| SYJINT Reserved. C (3)
| SYJSPL Reserved. C (3)

| File Name: QAPMJOBS and QAPMJOBL

Database File Entries: Table 43 files contain data for each job or task on the
system.
Notes:
1. In Table 43, job means job, task, or thread.
2. Collection Services provides data only for jobs that consume CPU during an
interval.
Table 43. Job Data (One Entry for Each Job in the System, Collected for Each Interval)
Field Name Description Attributes
INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) for job interval entry and job completion C (12)
date, and time (hh:mm:ss) for job completion entry.
INTSEC Elapsed interval seconds. PD (7,0)
JBSSYS Name of the subsystem the job is running in. C (10)
JBSLIB Name of the library the subsystem is in. C (10)
JBNAME Job name/workstation name. C (10)
JBUSER Job user. C (10)
JBNBR Job number. C (6)
JBACCO Job accounting code. Field cannot be displayed. C (15)
JBTYPE Job type (A,B,I,M,R,S,V,W,X) (see Note 1 on page 337.) C (1)
JBSTYP Job subtype (see Note 2 on page 337.) C (1)
JBTTYP Task type (see Note 4 on page 337 and 5 on page 337) C (2)

330 OS/400 Work Management V4R4

Table 43. Job Data (One Entry for Each Job in the System, Collected for Each Interval) (continued)
Field Name Description Attributes
JBTTYE Task type extender (see Note 5 on page 337 C (2)
JBFLAG Job flag (see Note 3 on page 337.) Field cannot be displayed. C (2)
JBS36E Is job running in System/36 environment? (Y/N) C (1)
JBPOOL Job pool. C (2)
JBPRTY Job priority. C (3)
JBCPU Processing unit time (in milliseconds) used. (See Note 7 on PD (11,0)
page 337.)
JBRSP Total transaction time (in seconds.) (See Note 6 on page 337 and PD (15,3)
Note 8 on page 337.)
JBSLC Time-slice value (in milliseconds.) PD (11,0)
JBNTR Number of transactions. (See Note 6 on page 337 and Note 8 on PD (11,0)
page 337.)
JBDBR Number of synchronous database reads: Total number of physical PD (11,0)
synchronous database read operations for database functions. (See
Note 7 on page 337.)
JBNDB Number of synchronous nondatabase reads: Total number of PD (11,0)
physical synchronous nondatabase read operations for nondatabase
functions. (See Note 7 on page 337.)
JBWRT Number of writes: Total number of physical database and PD (11,0)
nondatabase write operations. (See Note 7 on page 337.)
JBAW Total number of transitions from active state to wait state for this job. PD (11,0)
(See Note 7 on page 337.)
JBWI Total number of transitions from wait state to ineligible state for this PD (11,0)
job. (See Note 7 on page 337.)
JBAI Total number of transitions from active state to ineligible state for PD (11,0)
this job. (See Note 7 on page 337.)
JBPLN Number of print lines: Number of lines written by the program. This PD (11,0)
does not reflect what is actually printed. Spooled files can be ended,
or printed with multiple copies. (See Note 8 on page 337.)
JBPPG Number of print pages. (See Note 8 on page 337.) PD (11,0)
JBPFL Number of print files. (See Note 8 on page 337.) PD (11,0)
JBLWT Number of database writes (logical): Number of times the internal PD (11,0)
database write function was called. This does not include I/O
operations to readers/writers, or I/O operations caused by the
CPYSPLF or DSPSPLF command. If SEQONLY(*YES) is specified,
these numbers show each block of records read, not the number of
individual records read. (See Note 8 on page 337.)
JBLRD Number of database reads (logical): Number of times the database PD (11,0)
module was called. This does not include I/O operations to
readers/writers, or I/O operations caused by the CPYSPLF or
DSPSPLF command. If SEQONLY(*YES) is specified, these
numbers show each block of records read, not the number of
individual records read. (See Note 8 on page 337.)
JBDBU Number of miscellaneous database operations: Updates, deletes, PD (11,0)
force-end-of-data, and releases (logical.) (See Note 8 on page 337.)

Appendix A. Performance Data 331

Table 43. Job Data (One Entry for Each Job in the System, Collected for Each Interval) (continued)
Field Name Description Attributes
JBCPT Number of communications writes: These do not include remote PD (11,0)
workstation activity. They include only activity related to OS/400-ICF
files when the I/O is for an OS/400-ICF device. (See Note 8 on
page 337.)
JBCGT Number of communications reads (logical): These do not include PD (11,0)
remote workstation activity. They include only activity related to
OS/400-ICF files when the I/O is for an OS/400-ICF device. (See
Note 8 on page 337.)
JBSPD Total suspended time (in milliseconds.) (See Note 8 on page 337.) PD (11,0)
JBRRT Total time job waited during reroutes (in milliseconds.) (See Note 8 PD (11,0)
on page 337.)
JBLND Line description: Name of the communications line this workstation C (10)
and its controller is attached to. This is only available for remote
workstations. (See Note 8 on page 337.)
JBCUD Controller description: Name of the controller this workstation is C (10)
attached to. (See Note 8 on page 337.)
JB2LND Secondary line description (pass-through and emulation only.) (See C (10)
Note 8 on page 337.)
JB2CUD Secondary controller description (pass-through and emulation only.) C (10)
(See Note 8 on page 337.)
JBBRG Reserved PD (9,0)
JBPRG Reserved PD (9,0)
JBNDW Number of synchronous nondatabase writes: Total number of PD (11,0)
synchronous physical nondatabase write operations for nondatabase
functions. (See Note 7 on page 337.)
JBDBW Number of synchronous database writes: Total number of PD (11,0)
synchronous physical database write operations for database
functions. (See Note 7 on page 337.)
JBANDW Number of asynchronous nondatabase writes: Total number of PD (11,0)
asynchronous physical nondatabase write operations for
nondatabase functions. (See Note 7 on page 337.)
JBADBW Number of asynchronous database writes: Total number of PD (11,0)
asynchronous physical database write operations for database
functions.
JBANDR Number of asynchronous nondatabase reads: Total number of PD (11,0)
asynchronous physical nondatabase read operations for
nondatabase functions. (See Note 7 on page 337.)
JBADBR Number of asynchronous database reads: Total number of PD (11,0)
asynchronous physical database read operations for database
functions. (See Note 7 on page 337.)
JBPW Number of synchronous permanent writes. (See Note 7 on PD (11,0)
page 337.)
JBCS Reserved PD (11,0)
JBPAGF Number of PAG faults. Total number of times the program access PD (11,0)
group (PAG) was referred to, but was not in main storage. (See
Note 7 on page 337.)
JBEAO Reserved PD (11,0)
JBOBIN Number of binary overflows. (See Note 7 on page 337.) PD (11,0)

332 OS/400 Work Management V4R4

Table 43. Job Data (One Entry for Each Job in the System, Collected for Each Interval) (continued)
Field Name Description Attributes
JBODEC Number of decimal overflows. (See Note 7 on page 337.) PD (11,0)
JBOFLP Number of floating point overflows. (See Note 7 on page 337.) PD (11,0)
JBIPF Number of times a page fault occurred on an address that was PD (11,0)
currently part of an auxiliary storage I/O operation. (See Note 7 on
page 337.)
JBWIO Number of times the process explicitly waited for outstanding PD (11,0)
asynchronous I/O operations to complete. (See Note 7 on
page 337.)
JBIRN IOP resource name. (See Note 8 on page 337.) C (10)
JBDRN Device resource name. (See Note 8 on page 337.) C (10)
JIOPB Reserved PD(3,0)
JIOPA Reserved PD(3,0)
JBPORT Workstation port number. (See Note 8 on page 337.) PD (3,0)
JBSTN Workstation number. (See Note 8 on page 337.) PD (3,0)
JBPTSF Pass-through source flag. PD (1,0)
JBPTTF Pass-through target flag. PD (1,0)
JBEAF Emulation active flag. PD (1,0)
JBPCSF Client Access application flag. PD (1,0)
JBDDMF Target DDM job flag. PD (1,0)
JBMRTF MRT flag. PD (1,0)
JBROUT The routing entry index for the subsystem this job is in. PD (5,0)
JBAPT Reserved. PD (11,0)
JBNSW Reserved. PD (11,0)
JBSST Reserved. PD (11,0)
JBQT2 Reserved. PD (11,0)
JBCDR Reserved. PD (11,0)
JBCDS Reserved. PD (11,0)
JBAIQT Total application queuing time (in hundredths of seconds.) (See Note PD (11,0)
8 on page 337.)
JBNAIQ Number of application queuing transactions. (See Note 8 on PD (11,0)
page 337.)
JBRUT Total resource usage time (in seconds.) (See Note 8 on page 337.) PD (11,0)
JBNRU Number of resource usage transactions. (See Note 8 on page 337.) PD (11,0)
JBQT Total queuing time to enter the MRT (in hundredths of seconds.) PD (11,0)
(See Note 8 on page 337.)
JBMMT Total time spent at MRTMAX (in seconds.) (See Note 8 on PD (11,0)
page 337.)
JBNETQ Total number of entries into the MRT. (See Note 8 on page 337.) PD (11,0)
JBPUTN The number of times ACPUT was called to send user or control PD (11,0)
data. Calls that result in no data being sent are not counted. (See
Note 8 on page 337.)

Appendix A. Performance Data 333

Table 43. Job Data (One Entry for Each Job in the System, Collected for Each Interval) (continued)
Field Name Description Attributes
JBPUTA The total amount of user and control data that was sent by the PD (11,0)
user’s program. This value does not include the LLID, MAPNAME,
or FMH-7 data lengths. (See Note 8 on page 337.)
JBGETN The number of times ACGET was called to receive user or control PD (11,0)
data. Calls that result in no data being given to the user application
will not be counted. (See Note 8 on page 337.)
JBGETA The total amount of user and control data that was received by the PD (11,0)
user’s program. This value does not include the LLID, MAPNAME,
or FMH-7 data lengths. (See Note 8 on page 337.)
JBPGIN The number of intervals that begin at the first put of a chain and end PD (11,0)
when CD is returned to the user. (See Note 8 on page 337.)
JBPGIL The amount of time (in milliseconds) spent in intervals that begin at PD (11,0)
the first put of a chain and end when CD is returned to the user.
(See Note 8 on page 337.)
JBGGIL The amount of time (in milliseconds) spent in intervals that begin PD (11,0)
when the first get of a get chain completes and ends when the first
get of a new chain is issued. (See Note 8 on page 337.)
JBRTI This is the number of request I/O commands (REQIOs) issued to PD (11,0)
transmit data of any kind (including FMH-7s.) (See Note 8 on
page 337.)
JBRRI This is the number of REQIOs issued to receive data of any kind PD (11,0)
(including FMH-7s.) (See Note 8 on page 337.)
JBSZWT Total seize wait time in milliseconds. (See Note 7 on page 337.) PD (11,0)
JBSKSC Number of socket sends. (See Note 8 on page 337.) PD (11,0)
JBSKBS Number of socket bytes sent. (See Note 8 on page 337.) PD (11,0)
JBSKRC Number of socket receives. (See Note 8 on page 337.) PD (11,0)
JBSKBR Number of socket bytes received. (See Note 8 on page 337.) PD (11,0)
JBXRFR Stream file reads. (See Note 7 on page 337.) PD (11,0)
JBXRFW Stream file writes. (See Note 7 on page 337.) PD (11,0)
JBXSLR File system symbolic link reads. (See Note 8 on page 337.) PD (11,0)
JBXDYR File system directory reads. (See Note 8 on page 337.) PD (11,0)
JBDLCH File system directory lookup cache hits. (See Note 8 on page 337.) PD (11,0)
JBDLCM File system lookup cache misses. File system directory lookup PD (11,0)
cache hits.
JBSJNM Submitter’s job name. (See Note 8 on page 337.) C (10)
JBSJUS Submitter’s job user. File system directory lookup cache hits. (See C (10)
Note 8 on page 337.)
JBSJNB Submitter’s job number. (See Note 8 on page 337.) C (6)
JBSJFG Submitted job flag. This flag is used to identify the origin of the C (1)
information for the submitter’s job (name, user, and job number.) If
the field is blank, this indicates the job was submitted from a local
system or there was no data provided. If the field is not blank, the
value of the field indicates the job was submitted from a local
system. (See Note 8 on page 337.)
JBRSYS Reserved. C (10)
JBDEVN Reserved. C (10)

334 OS/400 Work Management V4R4

Table 43. Job Data (One Entry for Each Job in the System, Collected for Each Interval) (continued)
Field Name Description Attributes
JBRLNM Reserved. C (8)
JBLLNM Reserved. C (8)
JBMODE Reserved. C (8)
JBRMNT Reserved. C (8)
JBINSX Reserved. PD (11,0)
JBBUP Reserved. PD (11,0)
JBBDL Reserved. PD (11,0)
JBBFE Reserved. PD (11,0)
JBBCO Reserved. PD (11,0)
JBBRO Reserved. PD (11,0)
JBLBO Reserved. PD (11,0)
JBLBC Reserved. PD (11,0)
JBLBI Reserved. PD (11,0)
JBLBS Reserved. PD (11,0)
JBDQS Reserved. PD (11,0)
JBDQR Reserved. PD (11,0)
JBNDA Reserved. PD (11,0)
JBNUS Reserved. PD (11,0)
JBSIT1 Reserved. PD (11,0)
JBSIT2 Reserved. PD (11,0)
JBSIT3 Reserved. PD (11,0)
JBTCPU Total job CPU in milliseconds. Total CPU used by all threads of a PD (11,0)
multi-threaded job.
Note: This is not the sum of JBCPU for all job threads due to timing
differences in the collection and reporting of these values. (See Note
8 on page 337.)
JBTHDF Secondary thread flag. Identifies secondary threads of a PD (1,0)
multi-threaded job. The values are:
v 0 — tasks and primary threads
v 1 — secondary threads
JBTHID Thread Identifier. A 4 byte displayable thread identifier. A hex string C (8)
that is unique for threads within a process. It will be blank for tasks
and prior release data.
JBTHAC Active threads. Current number of active threads in the process PD (11,0)
when the data was sampled. An active thread may be either actively
running, suspended, or waiting on a resource. Includes the primary
thread. (See Note 8 on page 337.)
JBTHCT Thread created. Number of threads initiated within this job. Includes PD (11,0)
both active and terminated threads. (See Note 8 on page 337.)
JBMTXT Mutex wait time in milliseconds. Cumulative time the thread waited PD (11,0)
for a mutex. (See Note 7 on page 337.)
JBIBM1 Reserved PD (11,0)

Appendix A. Performance Data 335

 Table 43. Job Data (One Entry for Each Job in the System, Collected for Each Interval) (continued)
Field Name Description Attributes
JBSTSF Status flag: indicates job status relative to this interval. The values PD (1,0)
are:
0 — normal interval collection
1 — job started in interval
2 — job ended in interval
3 — job started and ended

Note: Jobs that are rerouted or transferred will result in a

termination record (JBSTSF = 2) and a new job record (JBSTSF =
1.)
| JBSVIF Server interactive flag. Set to ’I’ if the machine is counting the C (1)
| resource consumed by this function against the interactive workload.
| JBTFLT Total page faults. PD (11,0)

336 OS/400 Work Management V4R4

Table 43. Job Data (One Entry for Each Job in the System, Collected for Each Interval) (continued)
Field Name Description Attributes
Notes:
1. Job Types:
B = Batch
I = Interactive
A = Autostart
R = Spool reader
W = Spool writer
M = Subsystem monitor
S = System
X = SCPF job
V = VMC microcode task
2. Job Subtypes:
T = MRT (System/36 environment only)
E = Evoke (communications batch)
P = Print driver job
J = Prestart job
F = M36 (Advanced 36 server job)
D = Batch immediate job
U = Alternate spool user
3. Job Flags:
Bit
0 Pass-through source
1 Pass-through target
2 Emulation active
3 Client Access application
4 Target DDM job
5 MRT
6-15 Not used
4. Task Types:
01 = Resident task
02 = Supervisor task
03 = MI process task
04 = S36 emulation task
5. For detailed information about a task type extender, see AS/400 Licensed Internal Code Diagnostic Aids - Volume
1.
6. Certain OS/400 functions support the concept of a transaction. The definition of transaction and the
characteristics of a transaction are different depending on the type of job or the specific function of the job. For
interactive jobs, display I/O transactions are counted. The transaction starts on detection of enter from the
workstation; the transaction ends when the keyboard is enabled. For SNADS jobs, a transaction is the processing
of a distribution.
7. These fields are provided on an individual task or thread basis. For multi-threaded jobs, they are not summarized
across threads.
8. These fields are provided for primary threads only. If the field is a numeric counter, it is a cumulative total for all
threads of a multi-threaded job.

Appendix A. Performance Data 337

| File Name: QAPMJOBMI
| Database File Entries: Table 44 files contain task, primary, and secondary thread
| data that are collected via the JOB MI category.
| Notes:
| 1. In Table 44, job means job, task, or thread.
| 2. Collection Services provides data only for jobs that consume CPU during an
| interval.
| Table 44. Job Data (One Entry for Each Job in the System, Collected for Each Interval)
| Field Name Description Attributes
| INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
| performance monitor job.
| DTETIM Interval date (yy/mm/dd) for job interval entry and job completion C (12)
| date, and time (hh:mm:ss) for job completion entry.
| INTSEC Elapsed interval seconds. PD (7,0)
| DTECEN Century digit. C (1)
| JBNAME Job name/workstation name. C (16)
| JBUSER Job user. C (10)
| JBNBR Job number. C (6)
| JBTYPE Job type (A,B,I,M,R,S,V,W,X) (see Note 1 on page 341.) C (1)
| JBSTYP Job subtype (see Note 2 on page 341.) C (1)
| JBSTSF Status flag: indicates job status relative to this interval. The values PD (1,0)
| are:
| 0 — normal interval collection
| 1 — job started in interval
| 2 — job ended in interval
| 3 — job started and ended
|
| Note: Jobs that are rerouted or transferred will result in a
| termination record (JBSTSF = 2) and a new job record (JBSTSF =
| 1.)
| JBTTYP Task type (see Note 3 on page 341 and 4 on page 341) C (2)
| JBTTYE Task type extender (see Note 4 on page 341 C (2)
| JBPOOL Job pool. C (2)
| JBPRTY Job priority. C (3)
| JBCPU Processing unit time (in milliseconds) used.) PD (15,3)
| JBRSP Total transaction time (in seconds.) PD (15,3)
| JBSLC Time-slice value (in milliseconds.) PD (11,0)
| JBNTR Number of transactions. PD (11,0)
| JBDBR Number of synchronous database reads: Total number of physical PD (11,0)
| synchronous database read operations for database functions.
| JBNDB Number of synchronous nondatabase reads: Total number of PD (11,0)
| physical synchronous nondatabase read operations for nondatabase
| functions.
| JBWRT Number of writes: Total number of physical database and PD (11,0)
| nondatabase write operations.
| JBAW Total number of transitions from active state to wait state for this job. PD (11,0)

338 OS/400 Work Management V4R4

| Table 44. Job Data (One Entry for Each Job in the System, Collected for Each Interval) (continued)
| Field Name Description Attributes
| JBWI Total number of transitions from wait state to ineligible state for this PD (11,0)
| job.
| JBAI Total number of transitions from active state to ineligible state for PD (11,0)
| this job.
| JBNDW Number of synchronous nondatabase writes: Total number of PD (11,0)
| synchronous physical nondatabase write operations for nondatabase
| functions.
| JBDBW Number of synchronous database writes: Total number of PD (11,0)
| synchronous physical database write operations for database
| functions.
| JBANDW Number of asynchronous nondatabase writes: Total number of PD (11,0)
| asynchronous physical nondatabase write operations for
| nondatabase functions.
| JBADBW Number of asynchronous database writes: Total number of PD (11,0)
| asynchronous physical database write operations for database
| functions.
| JBANDR Number of asynchronous nondatabase reads: Total number of PD (11,0)
| asynchronous physical nondatabase read operations for
| nondatabase functions.
| JBADBR Number of asynchronous database reads: Total number of PD (11,0)
| asynchronous physical database read operations for database
| functions.
| JBPW Number of synchronous permanent writes. PD (11,0)
| JBPAGF Number of PAG faults. Total number of times the program access PD (11,0)
| group (PAG) was referred to, but was not in main storage.
| JBOBIN Number of binary overflows. PD (11,0)
| JBODEC Number of decimal overflows. PD (11,0)
| JBOFLP Number of floating point overflows. PD (11,0)
| JBIPF Number of times a page fault occurred on an address that was PD (11,0)
| currently part of an auxiliary storage I/O operation.
| JBWIO Number of times the process explicitly waited for outstanding PD (11,0)
| asynchronous I/O operations to complete.
| JBSZWT Total seize wait time in milliseconds. PD (11,0)
| JBSKSC Number of socket sends. PD (11,0)
| JBSKBS Number of socket bytes sent. PD (11,0)
| JBSKRC Number of socket receives. PD (11,0)
| JBSKBR Number of socket bytes received. PD (11,0)
| JBXRFR Stream file reads. PD (11,0)
| JBXRFW Stream file writes. PD (11,0)
| JBTCPU Total job CPU in milliseconds. Total CPU used by all threads of a PD (15,3)
| multi-threaded job.
| Note: This is not the sum of JBCPU for all job threads due to timing
| differences in the collection and reporting of these values.

Appendix A. Performance Data 339

| Table 44. Job Data (One Entry for Each Job in the System, Collected for Each Interval) (continued)
| Field Name Description Attributes
| JBTHDF Secondary thread flag. Identifies secondary threads of a PD (1,0)
| multi-threaded job. The values are:
| v 0 — tasks and primary threads
| v 1 — secondary threads
| JBTHID Thread Identifier. A 4 byte displayable thread identifier. A hex string C (8)
| that is unique for threads within a process. It will be blank for tasks
| and prior release data.
| JBTHAC Active threads. Current number of active threads in the process PD (11,0)
| when the data was sampled. An active thread may be either actively
| running, suspended, or waiting on a resource. Includes the primary
| thread.
| JBTHCT Thread created. Number of threads initiated within this job. Includes PD (11,0)
| both active and terminated threads.
| JBMTXT Mutex wait time in milliseconds. Cumulative time the thread waited PD (15,3)
| for a mutex.
| JBIBM1 Reserved PD (11,0)
| JBINSX Reserved. PD (11,0)
| JBSVIF Server interactive flag. Set to ’I’ if the machine is counting the C (1)
| resource consumed by this function against the interactive workload.
| JBTFLT Total page faults. PD (11,0)
| JBTDE System task identifier. C (8)
| JBPTDE Primary thread identifier. C (8)
| JBLDUM Reserved. PD (1,0)

340 OS/400 Work Management V4R4

| Table 44. Job Data (One Entry for Each Job in the System, Collected for Each Interval) (continued)
| Field Name Description Attributes
| Notes:
| 1. Job Types:
| B = Batch
| I = Interactive
| A = Autostart
| R = Spool reader
| W = Spool writer
| M = Subsystem monitor
| S = System
| X = SCPF job
| V = VMC microcode task
| 2. Job Subtypes:
| T = MRT (System/36 environment only)
| E = Evoke (communications batch)
| P = Print driver job
| J = Prestart job
| F = M36 (Advanced 36 server job)
| D = Batch immediate job
| U = Alternate spool user
| 3. Task Types:
| 01 = Resident task
| 02 = Supervisor task
| 03 = MI process task
| 04 = S36 emulation task
| 4. For detailed information about a task type extender, see AS/400 Licensed Internal Code Diagnostic Aids - Volume
| 1.

| File Name: QAPMJOBOS

| Database File Entries: Table 45 files contain data specific to OS/400 jobs
| collected.
| Table 45. OS/400 Job Data (One Entry for Each Job in the System, Collected for Each Interval)
| Field Name Description Attributes
| INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
| performance monitor job.
| DTETIM Interval date (yy/mm/dd) for job interval entry and job completion C (12)
| date, and time (hh:mm:ss) for job completion entry.
| INTSEC Elapsed interval seconds. PD (7,0)
| DTCEN Century digit. C (1)
| JBNAME Job name/workstation name. C (10)
| JBUSER Job user. C (10)
| JBNBR Job number. C (6)
| JBTYPE Job type (A,B,I,M,R,S,V,W,X) (see Note 1 on page 345.) C (1)
| JBSTYP Job subtype (see Note 2 on page 337.) C (1)

Appendix A. Performance Data 341

| Table 45. OS/400 Job Data (One Entry for Each Job in the System, Collected for Each Interval) (continued)
| Field Name Description Attributes
| JBSTSF Status flag: indicates job status relative to this interval. The values PD (1,0)
| are:
| 0 — normal interval collection
| 1 — job started in interval
| 2 — job ended in interval
| 3 — job started and ended
|
| Note: Jobs that are rerouted or transferred will result in a
| termination record (JBSTSF = 2) and a new job record (JBSTSF =
| 1.)
| JBSSYS Name of the subsystem the job is running in. C (10)
| JBSLIB Name of the library the subsystem is in. C (10)
| JBROUT The routing entry index for the subsystem this job is in. PD (5,0)
| JBACCO Job accounting code. Field cannot be displayed. C (15)
| JBRSP Total transaction time (in seconds.) (See Note 4 on page 345.) PD (15,3)
| JBNTR Number of transactions. (See Note 4 on page 345.) PD (11,0)
| JBAIQT Total application queuing time (in hundredths of seconds.) PD (11,0)
| JBNAIQ Number of application queuing transactions. PD (11,0)
| JBRUT Total resource usage time (in seconds.) PD (11,0)
| JBNRU Number of resource usage transactions. PD (11,0)
| JBPLN Number of print lines: Number of lines written by the program. This PD (11,0)
| does not reflect what is actually printed. Spooled files can be ended,
| or printed with multiple copies.
| JBPPG Number of print pages. PD (11,0)
| JBPFL Number of print files. PD (11,0)
| JBLWT Number of database writes (logical): Number of times the internal PD (11,0)
| database write function was called. This does not include I/O
| operations to readers/writers, or I/O operations caused by the
| CPYSPLF or DSPSPLF command. If SEQONLY(*YES) is specified,
| these numbers show each block of records read, not the number of
| individual records read.
| JBLRD Number of database reads (logical): Number of times the database PD (11,0)
| module was called. This does not include I/O operations to
| readers/writers, or I/O operations caused by the CPYSPLF or
| DSPSPLF command. If SEQONLY(*YES) is specified, these
| numbers show each block of records read, not the number of
| individual records read
| JBDBU Number of miscellaneous database operations: Updates, deletes, PD (11,0)
| force-end-of-data, and releases (logical.)
| JBCPT Number of communications writes: These do not include remote PD (11,0)
| workstation activity. They include only activity related to OS/400-ICF
| files when the I/O is for an OS/400-ICF device.
| JBCGT Number of communications reads (logical): These do not include PD (11,0)
| remote workstation activity. They include only activity related to
| OS/400-ICF files when the I/O is for an OS/400-ICF device.
| JBSPD Total suspended time (in milliseconds.) PD (11,0)
| JBRRT Total time job waited during reroutes (in milliseconds.) PD (11,0)

342 OS/400 Work Management V4R4

| Table 45. OS/400 Job Data (One Entry for Each Job in the System, Collected for Each Interval) (continued)
| Field Name Description Attributes
| JBLND Line description: Name of the communications line this workstation C (10)
| and its controller is attached to. This is only available for remote
| workstations.
| JBCUD Controller description: Name of the controller this workstation is C (10)
| attached to.
| JB2LND Secondary line description (pass-through and emulation only.) C (10)
| JB2CUD Secondary controller description (pass-through and emulation only.) C (10)
| JBIRN IOP resource name. C (10)
| JBDRN Device resource name. C (10)
| JBPORT Workstation port number. PD (3,0)
| JBSTN Workstation number. PD (3,0)
| JBPTSF Pass-through source flag. PD (1,0)
| JBPTTF Pass-through target flag. PD (1,0)
| JBEAF Emulation active flag. PD (1,0)
| JBPCSF Client Access application flag. PD (1,0)
| JBDDMF Target DDM job flag. PD (1,0)
| JBMRTF MRT flag. PD (1,0)
| JBS36E Is job running in System/36 environment? (Y/N) C (1)
| JBQT Total queuing time to enter the MRT (in hundredths of seconds.) PD (11,0)
| JBMMT Total time spent at MRTMAX (in seconds.) PD (11,0)
| JBNETQ Total number of entries into the MRT. PD (11,0)
| JBPUTN The number of times ACPUT was called to send user or control PD (11,0)
| data. Calls that result in no data being sent are not counted.
| JBPUTA The total amount of user and control data that was sent by the PD (11,0)
| user’s program. This value does not include the LLID, MAPNAME,
| or FMH-7 data lengths.
| JBGETN The number of times ACGET was called to receive user or control PD (11,0)
| data. Calls that result in no data being given to the user application
| will not be counted.
| JBGETA The total amount of user and control data that was received by the PD (11,0)
| user’s program. This value does not include the LLID, MAPNAME,
| or FMH-7 data lengths.
| JBPGIN The number of intervals that begin at the first put of a chain and end PD (11,0)
| when CD is returned to the user.
| JBPGIL The amount of time (in milliseconds) spent in intervals that begin at PD (11,0)
| the first put of a chain and end when CD is returned to the user.
| JBGGIL The amount of time (in milliseconds) spent in intervals that begin PD (11,0)
| when the first get of a get chain completes and ends when the first
| get of a new chain is issued.
| JBRTI This is the number of request I/O commands (REQIOs) issued to PD (11,0)
| transmit data of any kind (including FMH-7s.)
| JBRRI This is the number of REQIOs issued to receive data of any kind PD (11,0)
| (including FMH-7s.)
| JBXSLR File system symbolic link reads. PD (11,0)
| JBXDYR File system directory reads. PD (11,0)

Appendix A. Performance Data 343

| Table 45. OS/400 Job Data (One Entry for Each Job in the System, Collected for Each Interval) (continued)
| Field Name Description Attributes
| JBDLCH File system directory lookup cache hits. PD (11,0)
| JBDLCM File system lookup cache misses. File system directory lookup PD (11,0)
| cache hits.
| JBSJNM Submitter’s job name. C (10)
| JBSJUS Submitter’s job user. File system directory lookup cache hits. C (10)
| JBSJNB Submitter’s job number. C (6)
| JBSJFG Submitted job flag. This flag is used to identify the origin of the C (1)
| information for the submitter’s job (name, user, and job number.) If
| the field is blank, this indicates the job was submitted from a local
| system or there was no data provided. If the field is not blank, the
| value of the field indicates the job was submitted from a local
| system.
| JBRSYS Reserved. C (10)
| JBDEVN Reserved. C (10)
| JBRLNM Reserved. C (8)
| JBLLNM Reserved. C (8)
| JBMODE Reserved. C (8)
| JBRMNT Reserved. C (8)
| JBBUP Reserved. PD (11,0)
| JBBDL Reserved. PD (11,0)
| JBBFE Reserved. PD (11,0)
| JBBCO Reserved. PD (11,0)
| JBBRO Reserved. PD (11,0)
| JBLBO Reserved. PD (11,0)
| JBLBC Reserved. PD (11,0)
| JBLBI Reserved. PD (11,0)
| JBLBS Reserved. PD (11,0)
| JBDQS Reserved. PD (11,0)
| JBDQR Reserved. PD (11,0)
| JBNDA Reserved. PD (11,0)
| JBNUS Reserved. PD (11,0)
| JBSIT1 Reserved. PD (11,0)
| JBSIT2 Reserved. PD (11,0)
| JBSIT3 Reserved. PD (11,0)
| JBGRUP Job group. C (3)
| JBTDE System task identifier. C (3)
| JBFLAG Job flag (see Note 3 on page 345.) Field cannot be displayed. C (2)

344 OS/400 Work Management V4R4

| Table 45. OS/400 Job Data (One Entry for Each Job in the System, Collected for Each Interval) (continued)
| Field Name Description Attributes
| Notes:
| 1. Job Types:
| B = Batch
| I = Interactive
| A = Autostart
| R = Spool reader
| W = Spool writer
| M = Subsystem monitor
| S = System
| X = SCPF job
| V = VMC microcode task
| 2. Job Subtypes:
| T = MRT (System/36 environment only)
| E = Evoke (communications batch)
| P = Print driver job
| J = Prestart job
| F = M36 (Advanced 36 server job)
| D = Batch immediate job
| U = Alternate spool user
| 3. Job Flags:
| Bit
| 0 Pass-through source
| 1 Pass-through target
| 2 Emulation active
| 3 Client Access application
| 4 Target DDM job
| 5 MRT
| 6-15 Not used
| 4. Certain OS/400 functions support the concept of a transaction. The definition of transaction and the
| characteristics of a transaction are different depending on the type of job or the specific function of the job. For
| interactive jobs, display I/O transactions are counted. The transaction starts on detection of enter from the
| workstation; the transaction ends when the keyboard is enabled. For SNADS jobs, a transaction is the processing
| of a distribution.

| File Name: QAPMJSUM

| Database File Entries: Table 46 files contain job summary information.
| Table 46. Job Summary Data (One Entry for Each Job in the System, Collected for Each Interval)
| Field Name Description Attributes
| INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
| performance monitor job.
| DTETIM Interval date (yy/mm/dd) for job interval entry and job completion C (12)
| date, and time (hh:mm:ss) for job completion entry.
| INTSEC Elapsed interval seconds. PD (7,0)
| DTECEN C (1)

Appendix A. Performance Data 345

| Table 46. Job Summary Data (One Entry for Each Job in the System, Collected for Each Interval) (continued)
| Field Name Description Attributes
| JSCBKT Job group: Identifies the type of jobs for which data is being C (3)
| reported within this record. Values supported are:
| DDM = Distributed data management
| CA4 = Client Access/400
| PAS = Pass-through
| MRT = Multiple requestor terminal
| S6E = System/36 environment
| CME = Communications batch
| AUT = Autostart batch
| BCH = Batch jobs (not included within other groups)
| INT = Interactive
| SPL = Spool jobs and Start CPF jobs
| JSCPU Processing unit time (in milliseconds) used. PD (11,0)
| JSTRNT Total transaction time (in seconds.) PD (15,3)
| JSNTRS Number of transactions. PD (11,0)
| JSPRTL Number of print lines: Number of lines written by the program. This PD (11,0)
| does not reflect what is actually printed. Spooled files can be ended,
| or printed with multiple copies.
| JSPRP Number of print pages. PD (11,0)
| JSSPD Total suspended time (in milliseconds.) PD (11,0)
| JSRRT Total time job waited during reroutes (in milliseconds.) PD (11,0)
| JSNEW New jobs. PD (11,0)
| JSTERM Terminated jobs. PD (11,0)
| JSJBCT Number of jobs. PD (11,0)
| JSPDBR Number of synchronous database reads: Total number of physical PD (11,0)
| synchronous database read operations for database functions.
| JSPNDB Number of synchronous nondatabase reads: Total number of PD (11,0)
| physical synchronous nondatabase read operations for nondatabase
| functions.
| JSPWRT Number of writes: Total number of physical database and PD (11,0)
| nondatabase write operations.
| JSLDBR Number of database reads (logical): Number of times the database PD (11,0)
| module was called. This does not include I/O operations to
| readers/writers, or I/O operations caused by the CPYSPLF or
| DSPSPLF command. If SEQONLY(*YES) is specified, these
| numbers show each block of records read, not the number of
| individual records read.
| JSLDBW Number of database writes (logical): Number of times the internal PD (11,0)
| database write function was called. This does not include I/O
| operations to readers/writers, or I/O operations caused by the
| CPYSPLF or DSPSPLF command. If SEQONLY(*YES) is specified,
| these numbers show each block of records read, not the number of
| individual records read.
| JSLDBU Number of miscellaneous database operations: Updates, deletes, PD (11,0)
| force-end-of-data, and releases (logical.)

346 OS/400 Work Management V4R4

| Table 46. Job Summary Data (One Entry for Each Job in the System, Collected for Each Interval) (continued)
| Field Name Description Attributes
| JSCMPT Number of communications writes: These do not include remote PD (11,0)
| workstation activity. They include only activity related to OS/400-ICF
| files when the I/O is for an OS/400-ICF device.
| JSCMGT Number of communications reads (logical): These do not include PD (11,0)
| remote workstation activity. They include only activity related to
| OS/400-ICF files when the I/O is for an OS/400-ICF device.
| JSBRG Reserved PD (11,0)
| JSPRG Reserved PD (11,0)
| JSNDW Number of synchronous nondatabase writes: Total number of PD (11,0)
| synchronous physical nondatabase write operations for nondatabase
| functions.
| JSDBW Number of synchronous database writes: Total number of PD (11,0)
| synchronous physical database write operations for database
| functions.
| JSANDW Number of asynchronous nondatabase writes: Total number of PD (11,0)
| asynchronous physical nondatabase write operations for
| nondatabase functions.
| JSADBW Number of asynchronous database writes: Total number of PD (11,0)
| asynchronous physical database write operations for database
| functions.
| JSANDR Number of asynchronous nondatabase reads: Total number of PD (11,0)
| asynchronous physical nondatabase read operations for
| nondatabase functions.
| JSADBR Number of asynchronous database reads: Total number of PD (11,0)
| asynchronous physical database read operations for database
| functions.
| JSPW Number of synchronous permanent writes. PD (11,0)
| JSCS Reserved PD (11,0)
| JSPAGF Number of PAG faults. Total number of times the program access PD (11,0)
| group (PAG) was referred to, but was not in main storage.
| JSEAO Reserved PD (11,0)
| JSOBIN Number of binary overflows. PD (11,0)
| JSODEC Number of decimal overflows. PD (11,0)
| JSOFLP Number of floating point overflows. PD (11,0)
| JSIPF Number of times a page fault occurred on an address that was PD (11,0)
| currently part of an auxiliary storage I/O operation.
| JSWIO Number of times the process explicitly waited for outstanding PD (11,0)
| asynchronous I/O operations to complete.
| JSSKSC Number of socket sends. PD (11,0)
| JSSKBS Number of socket bytes sent. PD (11,0)
| JSSKRC Number of socket receives. PD (11,0)
| JSSKBR Number of socket bytes received. PD (11,0)
| JSXRFR Stream file reads. PD (11,0)
| JSXRFW Stream file writes. PD (11,0)
| JSXSLR File system symbolic link reads. PD (11,0)
| JSXDYR File system directory reads. PD (11,0)

Appendix A. Performance Data 347

| Table 46. Job Summary Data (One Entry for Each Job in the System, Collected for Each Interval) (continued)
| Field Name Description Attributes
| JSDLCH File system directory lookup cache hits. PD (11,0)
| JSDLCM File system lookup cache misses. File system directory lookup PD (11,0)
| cache hits.
| JSSZWT Total seize wait time in milliseconds. PD (11,0)

| File Name: QAPMDISK

Disk File Entries: In Table 47 files contains one record for each actuator (disk
arm.)

Table 47 lists the fields in the disk data file.

Table 47. Disk Storage Data (One for Each Actuator)
Field Name Description Attributes
INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
the sample interval.
INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
sample interval.
IOPRN IOP resource name C (10)
DIOPID Reserved C (1)
DSARM Disk arm number: Specifies the unique identifier of the unit. Each C (4)
actuator arm on the disk drives available to the machine represents
a unit of auxiliary storage. The value of the unit number is assigned
by the system when the unit is allocated to an ASP.
DSTYPE Disk drive type such as 9332, 9335, or 6100. C (4)
DSDRN Device resource name C (10)
DSSCAN Number of search string commands: This count is always zero, PD (5,0)
because search string commands are not supported for the 9332,
9335, or 6100.
DSBLKR Number of blocks read: The block length is 520 bytes, which PD (11,0)
includes 8 bytes of system control information.
DSBLKW Number of blocks written: The block length is 520 bytes, which PD (11,0)
includes 8 bytes of system control information.
DSIDLC Processor idle loop counter: The number of times the disk controller PD (11,0)
passed through the idle loop. This count is increased differently for
the 9332 and the 9335. For the 9332, this counter is increased only
if the disk controller is totally idle (for example, no I/O operations are
active.) For the 9335, even though the disk controller may be idle
and the counter gets increased, an I/O operation can be active (for
example, seek is being performed.) This field is non-zero for drive
types that support a dedicated disk processor and zero for other
drive types.
DSIDLT Processor idle loop time : The time (in hundredths of microseconds) PD (11,0)
to make one pass through the idle loop. This field is non-zero for
drive types that support a dedicated disk processor and zero for
other drive types
DSSK1 Number of seeks > 2/3: The number of times the arm traveled more PD (11,0)
than 2/3 of the disk on a seek.

348 OS/400 Work Management V4R4

Table 47. Disk Storage Data (One for Each Actuator) (continued)
Field Name Description Attributes
DSSK2 Number of seeks > 1/3 and < 2/3: The number of times the arm PD (11,0)
traveled more than 1/3 but less than 2/3 of the disk on a seek.
DSSK3 Number of seeks > 1/6 and < 1/3: The number of times the arm PD (11,0)
traveled more than 1/6 but less than 1/3 of the disk on a seek.
DSSK4 Number of seeks > 1/12 and < 1/6: The number of times the arm PD (11,0)
traveled more than 1/12 but less than 1/6 of the disk on a seek.
DSSK5 Number of seeks < 1/12: The number of times the arm traveled from PD (11,0)
its current position but less than 1/12 of the disk on a seek.
DSSK6 Number of zero seeks: The number of times the access arm did not PD (11,0)
physically move on a seek request. The operation may have
resulted in a head switch. This field is 0 for disk drive type 6100.
The number of zero seeks will be accumulated in DSSK5.
DSQUEL Total queue elements: The number of I/O operations waiting service PD (11,0)
at sample time. This number includes the I/O operation that is in
progress. Divide this by DSSMPL to get the average queue length.
DSNBSY Number of times arm not busy: The number of times there were no PD (11,0)
outstanding I/O operations active at sample time.
DSSMPL Number of samples taken at two per second: The number of PD (11,0)
samples taken at approximately two per second for the DSQUEL
and DSNBSY fields.
DSCAP Drive capacity (in bytes): Total number of bytes of auxiliary storage PD (11,0)
provided on the unit for the storage of objects and internal machine
functions when the ASP containing it is not under checksum
protection. The unit reserved system space value is subtracted from
the unit capacity to calculate this capacity.
DSAVL Drive available space (in bytes): Total number of bytes of auxiliary PD (11,0)
storage space that is not currently assigned to objects or internal
machine functions, and therefore is available on the unit.
DSASP ASP number: Specifies the ASP to which this unit is currently C (2)
allocated. A value of 1 specifies the system ASP. A value from 2
through 16 specifies a user ASP. A value of 0 indicates that this unit
is currently not allocated.
DSCSS Reserved C (2)
DSPCAP Reserved PD (11,0)
DSPAVL Reserved PD (11,0)
DMFLAG ‘ ’ means this arm is not mirrored. ‘A’ means this is the designated C (1)
first arm of a mirrored pair. ‘B’ means this is the designated second
arm of a mirrored pair.
DMSTS File mirroring status. 1 = active, 2 = resuming, 3 = suspended PD (1,0)
DMIRN Mirrored IOP resource name C (10)
DMDRN Mirrored device resource name C (10)
DSRDS Number of read data commands. PD (11,0)
DSWRTS Number of write data commands. PD (11,0)

Appendix A. Performance Data 349

Table 47. Disk Storage Data (One for Each Actuator) (continued)
Field Name Description Attributes
DSBUFO Number of buffer overruns: The number of times that data was PD (11,0)
available to be read into the disk controller buffer from the disk, but
the disk controller buffer still contained valid data that was not
retrieved by the storage device controller. Consequently, the disk
had to take an additional revolution until the buffer was available to
accept data. This field is 0 for disk drive type 6100.
DSBUFU Number of buffer underruns: The number of times that the disk PD (11,0)
controller was ready to transfer data to the disk on a write, but the
disk controller buffer was empty. The data was not transferred in
time by the disk IOP to the disk controller buffer. The disk was
forced to take an extra revolution awaiting the data. This field is 0
for disk drive type 6100.
DSMDLN Model Number: The model number of the disk drive. C (4)
DSDCRH Device cache read hits: The number of times that all of the data PD (11,0)
requested by the read operation was obtained from the device read
or write cache.
DSDCPH Device cache partial read hits: The number of times that a portion, PD (11,0)
but not all, of the data requested by the read operation was
obtained by the device read or write cache. A physical operation to
the device media was required to obtain the remaining data.
DSDCWH Device cache write hits: The number of times that the data PD (11,0)
associated with a write operation replaces, or is combined with,
existing data in the device write cache, thereby eliminating a write
operation.
DSDCFW Device cache fast writes: The number of times that space was PD (11,0)
available in the device write cache for the data associated with a
write operation and a response was returned immediately.
DSDROP Device read operations: The number of read operations issued to PD (11,0)
the device by the controller. This includes operations generated for
redundant system data areas. It does not include operations
generated for diagnostics or access to the controller reserved area
that occur during this idle time.
DSDWOP Device write operations: The number of write operations issued to PD (11,0)
the device by the controller. This includes operations generated for
redundant system data areas. It does not include operations
generated for diagnostics or access to the controller reserved area
that occur during this idle time.
DSCCRH Controller cache read hits: The number of times that all of the data PD (11,0)
requested by the read operation was obtained from the controller
read or write cache.
DSPCPH Controller cache partial read hits: The number of times that a portion PD (11,0)
of the data requested by the read operation was obtained from the
controller read and write cache. An operation to the device was
required to obtain the remaining data.
DSCCWH Controller cache writes hits: The number of times that the data PD (11,0)
associated with the write operation replaces or is combined with
existing data in the controller write cache. This eliminates a write
operation.
DSCCFW Controller cache fast writes: The number of times that space was PD (11,0)
available in the controller write cache for the data associated with a
write operation and a response was returned immediately.

350 OS/400 Work Management V4R4

Table 47. Disk Storage Data (One for Each Actuator) (continued)
Field Name Description Attributes
DSCOMP Compressed Unit indicator. ’0’ if disk data is not compressed and ’1’ C (1)
if disk data is compressed.
DSPBU Physical blocks used. For compressed units, this field contains the PD (11,0)
total number of physical blocks used (written) in the device user
data area. For non-compressed units, this field contains 0.
DSPBA Physical blocks allocated. For compressed units, this field contains PD (11,0)
the total number of physical blocks committed (reserved) in the
device user data area for DASD extents. This value includes all of
the Physical Blocks Used. For non-compressed units, this field
contains 0.
DSLBW Logical blocks written. For compressed units, this field contains the PD (11,0)
total number of logical blocks written in the device user data area.
This value represents the total amount of data written to allocated
extents. For non-compressed units, this field contains 0.
DSLBA Logical blocks allocated. For compressed units, this field contains PD (11,0)
the total number of logical blocks contained in allocated
compression groups. This value represents the total sum of all
allocated compression groups in the device user data area. For
non-compressed units, this field contains 0.
DSPBCO Physical blocks for compression overhead. For compressed units, PD (11,0)
this field contains the total number of physical blocks that are used
for compression directory structures and reserved areas that are
unavailable for storing user data. For non-compressed units, this
field contains 0.
DSFGDR Foreground directory reads. For compressed units, this field is the PD (11,0)
number of device read operations that have been performed to read
directory structures required to complete host system commands.
For non-compressed units, this field contains 0.
DSFGDW Foreground directory writes. For compressed units this is the PD (11,0)
number of device write operations that have been performed to write
directory structures required to complete host system commands.
For non-compressed units, this field contains 0.
DSBGDR Background directory reads. For compressed units, this is the PD (11,0)
number of device read operations that have been performed in the
management of compression directory structures, but were not
immediately required to complete host system commands. For
non-compressed units, this field contains 0.
DSBGDW Background directory writes. For compressed units, this is the PD (11,0)
number of device write operations. For non-compressed units, this
field contains 0.
DSFGRE Foreground Read exceptions. For compressed units, this is the PD (11,0)
number of times an additional device read opetation was issued to
read data that had been stored in the exception area on a
compressed device (this count applies only to multi-page
operations). This count reflects only those operations immediately
required to complete host system commands.
DSFGWE Foreground Write exceptions. For compressed units, this field is the PD (11,0)
number of times an additional device write operation was issued to
write data into the exception area on a compressed device (this
count applies only to multi-page operations). This count reflects only
those operations immediately required to complete host system
commands. For non-compressed units, this field contains 0.

Appendix A. Performance Data 351

 Table 47. Disk Storage Data (One for Each Actuator) (continued)
Field Name Description Attributes
DSFGS Foreground Sweeps. For compressed units, a sweep is the process PD (11,0)
used to store a 1 MByte compression group in the correct number of
sectors so there are no unused areas in the data region and no
used areas in the exception region of the compression group. The
number of foreground sweeps is the number of times an entire 1
MByte compression group was required to be swept to complete
host system commands. The sweep is needed because the data for
a host system write operation does not fit into the physical space
reserved (the new data does not compress as well as the data that
was previously in the space). For non-compressed units, this field
contains 0.
DSBGS Background Sweeps. For compressed units, a sweep is the process PD (11,0)
used to store a 1 MBYTE compression group in the correct number
of sectors so there are no unused areas in the data region and no
used areas in the exception region of the compression group. The
number of background sweeps is the number of times an entire 1
MBYTE compression group was swept to maintain the compressed
data storage efficiency. This count reflects only those sweeps that
were not immediately required to complete host system commands.
Background sweeps are intended to increase performance or
increase usable capacity of drive. For non-compressed units, this
field contains 0.
| DSCERC Controller simulated read cache hits: The number of times that all of PD (11,0)
| the data requested by the read operation could have been, but was
| not, obtained from a controller read cache (NOT the controller write
| cache). This field is updated only when extended adaptive cache
| simulator is enabled.

352 OS/400 Work Management V4R4

Table 47. Disk Storage Data (One for Each Actuator) (continued)
Field Name Description Attributes
Notes:
1. 9332/9335 inconsistencies:
v 9335 updates the idle count only when the processing unit (A) is not busy. Disk operations such as seek could
be in progress. 9332 updates the idle count when there is no activity in any of its processors.
v If there is no movement and no head switch, the 9332 does not count this operation as a zero seek, the 9335
does.
v If an operation causes a head switch (starts a read or write on one track and end up on another track), the
9332 counts this as a zero seek, the 9335 does not.
2. 9335: > 2/3 9332: >= 2/3 > 1/3 and <= 2/3 >= 1/3 and < 2/3 > 1/6 and <= 1/3 >= 1/6 and < 1/3 > 1/12
and <= 1/6 >= 1/12 and < 1/6 <= 1/12 <1/12
3. DSIDLC and DSIDLT are duplicated across all arms for the same disk controller.
4. The idle loop count and time are used to calculate the storage device controller utilization as follows:
Convert the product of the idle loop count times the idle loop time from hundredths of microseconds to seconds.
Subtract this from the interval time, and divide the result by the interval time. For example:
Disk processor utilization = (INTSEC - (DSIDLC x DSIDLT)/10**8)/ INTSEC
5. The following formulas describe how several of the fields in the previous table can be used to calculate utilization
and service time for each arm.
Arm utilization (DSUTL): That part of the total interval that the arm was being used for I/O operations.
DSUTL = Arm Busy = (DSSMPL - DSNBSY)/DSSMPL

Arm accesses per second (DSAS): The number of reads and writes per second for this arm during the interval.
DSAS = (DSRDS + DSWRTS)/INTSEC

Service time (DSSRVCT): The average time for an arm I/O operation. This includes disk controller time.
DSSRVCT = DSUTL/DSAS

At low IOP Utilizations (less than 5%) the service time should be ignored. This is a calculated value based on
statistical sampling. When the number of samples is very low, the calculated value may not be accurate.

File Name: QAPMPOOL and QAPMPOOLL

Main Storage Pool File Entries: Table 48 lists the fields in the storage pool file.
Table 48. Main Storage Data (One for Each Storage Pool)
Field Name Description Attributes
INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
the sample interval.
INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
sample interval.
PONBR Pool number: Specifies the unique identifier of this pool. The value C (2)
is from 1 to 64.
POACTL Pool activity level setting: The maximum number of processes that PD (5,0)
can be active in the machine at the same time.
POSIZ Pool size (in KB): The amount of main storage assigned to the pool. PD (9,0)
PORES Pool reserved size (in KB): Specifies the amount of storage from the PD (7,0)
pool that is dedicated to machine functions.

Appendix A. Performance Data 353

Table 48. Main Storage Data (One for Each Storage Pool) (continued)
Field Name Description Attributes
PODBF Pool database faults: Total number of interruptions to processes (not PD (11,0)
necessarily assigned to this pool) that were required to transfer data
into the pool to permit the MI instruction to process the database
function.
PONDBF Pool nondatabase faults: Total number of interruptions to processes PD (11,0)
(not necessarily assigned to this pool) that were required to transfer
data into the pool to permit the MI instruction to process
nondatabase functions.
PODBPG Pool database pages read: Total number of pages of database data PD (11,0)
transferred from auxiliary storage to the pool to permit the instruction
to run as a consequence of set access state, implicit access group
movement, and internal machine actions.
PONDPG Pool nondatabase pages read: Total number of pages of database PD (11,0)
data transferred from auxiliary storage to the pool to permit the
instruction to run as a consequence of set access state, implicit
access group movement, and internal machine actions.
POAW Number of active to wait transitions: Total number of transitions by PD (11,0)
processes assigned to this pool from active state to wait state.
POWI Number of wait to ineligible: Total number of transitions by PD (11,0)
processes assigned to this pool from wait state to ineligible state.
POAI Number of active to ineligible: Total number of transitions by PD (11,0)
processes assigned to this pool from active state to ineligible state.
PTTYPE Type of tuning: The method used by the system to tune the storage C (1)
pool:

0 No tuning

1 Static tuning

2 Dynamic tuning of transfers into main storage

3 Dynamic tuning of transfers into main storage and to auxiliary

storage
PTPAGE Change page handling. The method used by the system to C (1)
determine when to write changed pages to auxiliary storage:

0 Use the system default

1 Periodically transfer changed pages to auxiliary storage

PTNDBF Non-database blocking factor. The amount of data (in KB) that Packed (3)
should be brought into main storage when a request is made to
read non-database objects from auxiliary storage.
PTDBF1 Database blocking factor (class 1.) The amount of data (in KB) that Packed (3)
should be brought into main storage when a request is made to
read database objects from auxiliary storage.

354 OS/400 Work Management V4R4

 Table 48. Main Storage Data (One for Each Storage Pool) (continued)
Field Name Description Attributes
PTDEX1 Database exchange operation type (class 1.) The exchange C (1)
operation used to reduce the working set size.

0 Use the system default

1 Allow exchange operations

2 Disable exchange operations

3 Disable exchange operations. The data that already exists in main

storage should be a good candidate to be replaced when additional
storage is needed in the storage pool.
PTDTS1 Database type of transfer to auxiliary storage (class 1.) The method C (1)
the system uses to process a request to write an object to auxiliary
storage.

0 Use the system default

1 Purge objects from main storage

2 Write objects to auxiliary storage

3 Indicate object are good candidates for replacement.

4 Use the system page replacement algorithm.

PTDBF2 Database blocking factor (class 2.) See PTDBF1. Packed (3)
PTDEX2 Database allow exchange operations (class 2.) See PTDEX1. C (1)
PTDTS2 Database type of transfer to auxiliary storage (class 2.) See C (1)
PTDEX1.
PTDBF3 Database blocking factor (class 3.) See PTDBF1. Packed (3)
PTDEX3 Database allow exchange operations (class 3.) See PTDEX1. C (1)
PTDTS3 Database type of transfer to auxiliary storage (class 3.) See C (1)
PTDEX1.
PTDBF4 Database blocking factor (class 4.) See PTDBF1. Packed (3)
PTDEX4 Database allow exchange operations (class 4.) See PTDEX1. C (1)
PTDTS4 Database type of transfer to auxiliary storage (class 4.) See C (1)
PTDEX1.
Note:
1. For more information on pool tuning, see “Setting Up the System to Dynamically Adjust a Storage Pool for an
Object (Expert Cache)” on page 240.

| File Name: QAPMPOOLT

| Main Storage Pool File Entries: Table 49 lists the tuning information for in the
| storage pools.
| Table 49. Main Storage Data (One for Each Storage Pool)
| Field Name Description Attributes
| INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
| performance monitor job.
| DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
| the sample interval.

Appendix A. Performance Data 355

| Table 49. Main Storage Data (One for Each Storage Pool) (continued)
| Field Name Description Attributes
| INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
| sample interval.
| DTECEN Century digit. C (1)
| PONBR Pool number: Specifies the unique identifier of this pool. The value C (3)
| is from 1 to 64.
| PTTYPE Type of tuning: The method used by the system to tune the storage C (1)
| pool:

| 0 No tuning

| 1 Static tuning

| 2 Dynamic tuning of transfers into main storage

| 3 Dynamic tuning of transfers into main storage and to auxiliary

| storage
| PTPAGE Change page handling. The method used by the system to C (1)
| determine when to write changed pages to auxiliary storage:

| 0 Use the system default

| 1 Periodically transfer changed pages to auxiliary storage

| PTNDBF Non-database blocking factor. The amount of data (in KB) that Packed (3)
| should be brought into main storage when a request is made to
| read non-database objects from auxiliary storage.
| PTDBF1 Database blocking factor (class 1.) The amount of data (in KB) that Packed (3)
| should be brought into main storage when a request is made to
| read database objects from auxiliary storage.
| PTDEX1 Database exchange operation type (class 1.) The exchange C (1)
| operation used to reduce the working set size.

| 0 Use the system default

| 1 Allow exchange operations

| 2 Disable exchange operations

| 3 Disable exchange operations. The data that already exists in main

| storage should be a good candidate to be replaced when additional
| storage is needed in the storage pool.
| PTDTS1 Database type of transfer to auxiliary storage (class 1.) The method C (1)
| the system uses to process a request to write an object to auxiliary
| storage.

| 0 Use the system default

| 1 Purge objects from main storage

| 2 Write objects to auxiliary storage

| 3 Indicate object are good candidates for replacement.

| 4 Use the system page replacement algorithm.

| PTDBF2 Database blocking factor (class 2.) See PTDBF1. Packed (3)
| PTDEX2 Database allow exchange operations (class 2.) See PTDEX1. C (1)

356 OS/400 Work Management V4R4

| Table 49. Main Storage Data (One for Each Storage Pool) (continued)
| Field Name Description Attributes
| PTDTS2 Database type of transfer to auxiliary storage (class 2.) See C (1)
| PTDEX1.
| PTDBF3 Database blocking factor (class 3.) See PTDBF1. Packed (3)
| PTDEX3 Database allow exchange operations (class 3.) See PTDEX1. C (1)
| PTDTS3 Database type of transfer to auxiliary storage (class 3.) See C (1)
| PTDEX1.
| PTDBF4 Database blocking factor (class 4.) See PTDBF1. Packed (3)
| PTDEX4 Database allow exchange operations (class 4.) See PTDEX1. C (1)
| PTDTS4 Database type of transfer to auxiliary storage (class 4.) See C (1)
| PTDEX1.
| Note:
| 1. For more information on pool tuning, see “Setting Up the System to Dynamically Adjust a Storage Pool for an
| Object (Expert Cache)” on page 240.

| File Name: QAPMPOOLB

| Main Storage Pool File Entries: Table 50 lists the counters for system storage
| pools..
| Table 50. Main Storage Data (One for Each Storage Pool)
| Field Name Description Attributes
| INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
| performance monitor job.
| DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
| the sample interval.
| INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
| sample interval.
| DTECEN Century digit. C (1)
| PONBR Pool number: Specifies the unique identifier of this pool. The value C (3)
| is from 1 to 64.
| POACTL Pool activity level setting: The maximum number of processes that PD (5,0)
| can be active in the machine at the same time.
| POSIZ Pool size (in KB): The amount of main storage assigned to the pool. PD (9,0)
| PORES Pool reserved size (in KB): Specifies the amount of storage from the PD (9,0)
| pool that is dedicated to machine functions.
| PODBF Pool database faults: Total number of interruptions to processes (not PD (11,0)
| necessarily assigned to this pool) that were required to transfer data
| into the pool to permit the MI instruction to process the database
| function.
| PONDBF Pool nondatabase faults: Total number of interruptions to processes PD (11,0)
| (not necessarily assigned to this pool) that were required to transfer
| data into the pool to permit the MI instruction to process
| nondatabase functions.
| PODBPG Pool database pages read: Total number of pages of database data PD (11,0)
| transferred from auxiliary storage to the pool to permit the instruction
| to run as a consequence of set access state, implicit access group
| movement, and internal machine actions.

Appendix A. Performance Data 357

| Table 50. Main Storage Data (One for Each Storage Pool) (continued)
| Field Name Description Attributes
| PONDPG Pool nondatabase pages read: Total number of pages of database PD (11,0)
| data transferred from auxiliary storage to the pool to permit the
| instruction to run as a consequence of set access state, implicit
| access group movement, and internal machine actions.
| POAW Number of active to wait transitions: Total number of transitions by PD (11,0)
| processes assigned to this pool from active state to wait state.
| POWI Number of wait to ineligible: Total number of transitions by PD (11,0)
| processes assigned to this pool from wait state to ineligible state.
| POAI Number of active to ineligible: Total number of transitions by PD (11,0)
| processes assigned to this pool from active state to ineligible state.
| Note:
| 1. For more information on pool tuning, see “Setting Up the System to Dynamically Adjust a Storage Pool for an
| Object (Expert Cache)” on page 240.

| File Name: QAPMHDLC

HDLC File Entries: In Table 51, statistics are kept on a line basis for the fields in
the high-level data link control (HDLC) file.
Table 51. SDLC/HDLC Statistics
Field Name Description Attributes
INTNUM Interval number: the nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
the sample interval.
INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
sample interval.
IOPRN IOP resource name. C (10)
SHIOP Reserved C (1)
SHTYPE The resource type of the IOP or adapter represented by this record. C (4)
SHLND Line description: The name of the description for this line. C (10)
SHLSP Line speed: The speed of the line in bits per second (bps.) PD (11,0)
SHBTRN Bytes transmitted: The number of bytes transmitted including bytes PD (11,0)
transmitted again.
SHBRCV Bytes received: The number of bytes received including all bytes in PD (11,0)
frames that had any kind of error.
SHPRCL Protocol type: S for SDLC. C (1)
SHFTRN Number of frames transmitted (I, supervisory, and frames not PD (11,0)
numbered) excluding frames transmitted again.
SHIFTR Number of I-frames transmitted excluding I-frames transmitted PD (11,0)
again.
SHIFRT Number of I-frames transmitted again. PD (11,0)
SHFRT Number of I, supervisory, and frames not numbered transmitted PD (11,0)
again.
SHEFFR Error-free frames received: The number of I, supervisory, and PD (11,0)
frames not numbered received without error (whether or not they
were transmitted again from the remote side.)

358 OS/400 Work Management V4R4

Table 51. SDLC/HDLC Statistics (continued)
Field Name Description Attributes
SHEFIR Error-free I-frames received: The number of I-frames received PD (11,0)
without error (whether or not they were transmitted again from the
remote side.)
SHFRIE Frames received in error: The number of I, supervisory, and frames PD (11,0)
not numbered received in error. There are three error possibilities:
(1) a supervisory or I-frame was received with an Nr count that is
requesting retransmission of a frame, (2) an I-frame was received
with an Ns count that indicates that frames were missed, (3) a frame
is received with one of the following errors–a frame check sequence
error, an abnormal end, a receive overrun, or a frame truncated
error.
SHIFR Frames received that are not valid: The number of not valid frames PD (11,0)
received. These are frames received with either: (1) short frame
error–frame is less than 32 bits or (2) residue error–frame is not on
a byte boundary.
SHRRFT Number of receive ready supervisory frames transmitted. PD (11,0)
SHRRFR Number of receive ready supervisory frames received. PD (11,0)
SHRNRT Number of receive not ready supervisory frames transmitted. PD (11,0)
SHRNRR Number of receive not ready supervisory frames received. PD (11,0)
SHLNKR Data link resets: The number of times a set normal response mode PD (11,0)
(SNRM) was received when the station was already in normal
response mode.
SHCPT The length of time (in tenths of seconds) that the system waits for PD (3,0)
the response to a poll while in normal disconnect mode before
polling the next station.

File Name: QAPMASYN

Asynchronous File Entries: Table 52 lists the fields in the asynchronous file.
Table 52. Asynchronous Statistics (One Per Line)
Field Name Description Attributes
INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
the sample interval.
INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
sample interval.
IOPRN IOP resource name. C (10)
AIOPID Reserved C (1)
ASTYPE The resource type of the IOP or adapter represented by this record. C (4)
ASLND Line description: The name of the description for this line. C (10)
ASLSP Line speed: The speed of this line in bits per second (bps.) PD (11,0)
ASBTRN Number of bytes transmitted (data and control characters) including PD (11,0)
bytes transmitted again because of errors.
ASBRCV Number of bytes received (data and control characters), including PD (11,0)
characters received in error.
ASPRCL Protocol type: A for asynchronous. C (1)

Appendix A. Performance Data 359

Table 52. Asynchronous Statistics (One Per Line) (continued)
Field Name Description Attributes
ASPDUR The total number of protocol data units received. PD (11,0)
ASPDUE The total number of protocol data units received with parity and stop PD (11,0)
bit errors.
ASPDUT The total number of protocol data units successfully transmitted and PD (11,0)
the data-circuit ending equipment (DCE) acknowledged.

File Name: QAPMBSC

Binary Synchronous File Entries: Table 53 lists the fields in the binary
synchronous file.
Table 53. BSC Statistics (One Per Link/Station)
Field Name Description Attributes
INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
the sample interval.
INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
sample interval.
IOPRN IOP resource name. C(10)
BIOPID Reserved C (1)
BSTYPE The resource type of the IOP or adapter represented by this record. C (4)
BSLND Line description: The name of the description for this line. C (10)
BSLSP Line speed: The speed of the line in bits per second (bps). PD (11,0)
BSBTRN Bytes transmitted: The number of bytes (data and control PD (11,0)
characters) transmitted, including bytes transmitted again.
BSBRCV Bytes received: The number of bytes (data and control characters) PD (11,0)
received including bytes received in error.
BSPRCL Protocol type: B for binary synchronous. C (1)
BSDCRV Data characters received: The number of data characters received PD (11,0)
successfully (excluding synchronous characters) while in data
mode. For feature types 2507 and 6150, this value is equal to field
BSBRCV.
BSDCRE Data characters received in error: The number of data characters PD (11,0)
received with a block-check character error while in data mode. For
feature types 2507 and 6150, this value is equal to field BSCRER.
BSDCTR Data characters transmitted: The number of data characters PD (11,0)
transmitted successfully while in data mode. For feature types 2507
and 6150, this value is equal to field BSBTRN.
BSCRER Characters received in error: The number of characters received PD (11,0)
with a block-check character error.
BSLNK Negative acknowledgment character received to text sent (see PD (11,0)
Note). The number of times the remote station or device did not
understand the command sent from the host system.
BSLWA Wrong acknowledgment character to text sent (see Note). The host PD (11,0)
system received an acknowledgment from the remote device that
was not expected. For example, the system expected an ACK0 and
received an ACK1.

360 OS/400 Work Management V4R4

Table 53. BSC Statistics (One Per Link/Station) (continued)
Field Name Description Attributes
BSLQTS Enqueue to text sent (see Note): Text was sent by a station and an PD (11,0)
ENQ character was returned. The receiving station expected some
form of acknowledgment, such as an ACK0, ACK1, or NAK.
BSLINV Invalid (unrecognized format): One of the delimiter characters that PD (11,0)
encloses the data in brackets being sent/received is not valid (see
Note).
BSLQAK Enqueue to acknowledged character: The remote station returned PD (11,0)
an acknowledgment (for example, ACK0) and the host system sent
an ENQ character. This indicates that the host station did not
recognize the acknowledgment as a valid acknowledgment (see
Note).
BSLTNK Negative acknowledgment character received to text sent (total): PD (11,0)
The number of times the remote station did not understand the
command sent from the host system (see Note).
BSLTWA Wrong acknowledgment character to text sent (total): The host PD (11,0)
system received an acknowledgment from the remote device that
was not expected. For example, the host system expected an ACK0
and received an ACK1 (see Note).
BSLTQT Enqueue to text sent (total): Text was sent by a station and an ENQ PD (11,0)
character was returned. The receiving station expected some form
of acknowledgment such as an ACK0, ACK1, or NAK (see Note).
BSLTIV Invalid (unrecognized format) (total): One of the delimiter characters PD (11,0)
that enclose the data in brackets being sent/received is not valid
(see Note).
BSLTQA Enqueue to acknowledged character (total): The remote station PD (11,0)
returned an acknowledgment (for example, ACK0) and the host
station sent an ENQ character. This indicates that the host station
did not recognize the acknowledgment as a valid acknowledgment
(see Note).
BSLDRA Disconnect received: The remote station issued a disconnect with PD (11,0)
abnormal end. This could occur when error recovery did not
succeed or the binary synchronous job was ended.
BSLEAB End of transmission (EOT) received (abnormal end): Similar to a PD (11,0)
disconnect.
BSLDFA Disconnect received (forward abnormal end): The host station PD (11,0)
issued a disconnect with abnormal end. This could occur when the
error recovery did not succeed, or the binary synchronous job was
ended.
BSLEFA EOT received (forward abnormal end): Similar to a disconnect. PD (11,0)
BSLDBT Number of data blocks transmitted. PD (11,0)
BSLDBR Number of data blocks received. PD (11,0)
BSLBKR Number of data blocks transmitted again. PD (11,0)
BSLBKE Number of data blocks received in error. PD (11,0)
BSLTRT Total number of characters transmitted again, including control PD (11,0)
characters.
BSLDRT Total number of data characters transmitted again. PD (11,0)

Appendix A. Performance Data 361

Table 53. BSC Statistics (One Per Link/Station) (continued)
Field Name Description Attributes
Note:
v The counters BSLNK through BSLQAK are error recovery counters, and are increased the first time the error is
detected. The counters BSLTNK to BSLTQA are error recovery counters, and are increased every time the error
occurs. The same errors are being counted in each set of counters, so the first set indicates how many times an
error was detected, and the second set indicates how many retries it took to recover from the errors.
v The performance monitor supports a maximum of 66 bisync lines throughout the entire measurement.

File Name: QAPMX25

X.25 File Entries: Table 54 lists the fields in the X.25 file.

In Table 54, the XH prefix in the label refers to HDLC counters, XL refers to X.25
logical link control (LLC) counters, and XP refers to packet level control (PLC)
counters.
Table 54. X.25 Statistics
Field Name Description Attributes
INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
the sample interval.
INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
sample interval.
IOPRN IOP resource name. C(10)
XIOPID Reserved. C(1)
XITYPE The resource type of the IOP or adapter represented by this record. C (4)
XLLND Line description: The name of the description for this line. C (10)
Reserved. C (10)
XLLSP Line speed: The speed of this line in bits per second (bps). PD (11,0)
XHBTRN Bytes transmitted: The number of bytes transmitted, including bytes PD (11,0)
transmitted again.
XHBRCV Bytes received: The number of bytes received, including all bytes in PD (11,0)
frames that had any kind of error.
XHPRCL Protocol type: X for X.25. C (1)
XHFTRN Frames transmitted: The number of frames transmitted (I, PD (11,0)
supervisory, and frames not numbered), excluding frames
transmitted again.
XHIFTR I-frames transmitted: The number of I-frames transmitted, excluding PD (11,0)
I-frames transmitted again.
XHIFRT I-frames transmitted again: The number of I-frames transmitted PD (11,0)
again.
XHFRT Frames transmitted again: The number of I, supervisory, and frames PD (11,0)
not numbered transmitted again.
XHEFFR Error-free frames received: The number of I, supervisory, and PD (11,0)
frames not numbered received without error (whether or not they
were transmitted again from the remote side).

362 OS/400 Work Management V4R4

Table 54. X.25 Statistics (continued)
Field Name Description Attributes
XHEFIR Error-free I-frames received: The number of I-frames received PD (11,0)
without error (whether or not they were transmitted again from the
remote side).
XHFRIE Frames received in error: The number of I, supervisory, and frames PD (11,0)
not numbered received in error. There are three error possibilities:
(1) a supervisory or I-frame was received with an Nr count that is
requesting retransmission of a frame, (2) an I-frame was received
with an Ns count that indicates that frames were missed, (3) a frame
was received with one of the following errors–a frame check
sequence error, an abnormal end, a receive overrun or a frame
truncated error.
XHIFR Frames received that are not valid: The number of not valid frames PD (11,0)
received. These are frames received with either: (1) a short frame
error–frame is less than 32 bits, or (2) a residue error–frame is not
on a byte boundary.
XHRRFT Number of receive ready supervisory frames transmitted. PD (11,0)
XHRRFR Number of receive ready supervisory frames received. PD (11,0)
XHRNRT Number of receive-not-ready supervisory frames transmitted. PD (11,0)
XHRNRR Number of receive-not-ready supervisory frames received. PD (11,0)
XHLNKR Link resets: The number of times when a set normal response mode PD (11,0)
(SNRM) was received when the station was already in normal
response mode.
XLITR Interface protocol data units transmitted (LLC level). PD (11,0)
XLIRC Interface protocol data units received. PD (11,0)
XLIRT Interface protocol data units transmitted again. PD (11,0)
XLIRE Interface protocol data units received in error (checksum). PD (11,0)
XLLXTR Number of XIDS transmitted. PD (11,0)
XLXRC Number of XIDS received. PD (11,0)
XLTT Number of tests transmitted. PD (11,0)
XLTR Number of tests received. PD (11,0)
XLLJT Number of LLC rejects transmitted. PD (11,0)
XLLJR Number of LLC rejects received. PD (11,0)
XLRLD Number of received LLC protocol data units discarded. PD (11,0)
XLTO Number of time-outs. PD (11,0)
XLCED Checksum errors detected. PD (11,0)
XLSRA Successful recovery attempts. PD (11,0)
XLRA Recovery attempts. PD (11,0)
XLRSI Number of reset indications from packet-link control. PD (11,0)
XLCLS Number of close station indications from packet-link control. PD (11,0)
XLRNR LLC receive-not-ready frames received. PD (11,0)
XPTPT Total packets transmitted. PD (11,0)
XPTPR Total packets received. PD (11,0)
XPDPT Data packets transmitted. PD (11,0)
XPDPR Data packets received. PD (11,0)

Appendix A. Performance Data 363

Table 54. X.25 Statistics (continued)
Field Name Description Attributes
XPRPT Reset packets transmitted. PD (11,0)
XPROR Reset packets received. PD (11,0)
XPRNR Receive-not-ready packets received. PD (11,0)

File Name: QAPMECL

Token-Ring Network File Entries: Table 55 lists the fields in the token-ring local
area network (LAN) file.

Token-ring LAN protocol statistics are reported for active token–ring line
descriptions that are associated with token-ring ports and with ATM ports that
support token-ring LAN emulation.
Table 55. Token-Ring Network Counter
Field Name Description Attributes
INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
the sample interval.
INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
sample interval.
IOPRN IOP resource name. C(10)
EIOPI Reserved C (1)
ELITYPE The resource type of the IOP or adapter represented by this record. C (4)
ELLND Line description: The name of the description for this line. C (10)
ELLSP Line speed: The line speed expressed in bits per second (bps). PD (11,0)
ELTFT Total number of Type II frames transmitted. PD (11,0)
ELTFR Total number of Type II frames received. PD (11,0)
ELIFT Total number of I-frames transmitted. PD (11,0)
ELIFR Total number of I-frames received. PD (11,0)
ELICT Total number of characters transmitted in all I-frames. PD (11,0)
ELICR Total number of characters received in all I-frames. PD (11,0)
ELPRCL Protocol type: E for token-ring network. C (1)
ELRFT Number of receive-not-ready frames transmitted. PD (5,0)
ELRFR Number of receive-not-ready frames received. PD (5,0)
ELFFT Number of frame-reject frames transmitted. PD (5,0)
ELFFR Number of frame-reject frames received. PD (5,0)
ELRJFR Number of reject frames received. PD (5,0)
ELRJFT Number of reject frames transmitted. PD (5,0)
ELSFT Number of set asynchronous balanced mode extended frames PD (5,0)
transmitted.
ELSFR Number of set asynchronous balanced mode extended frames PD (5,0)
received.
ELDFT Number of disconnect frames transmitted. PD (5,0)

364 OS/400 Work Management V4R4

Table 55. Token-Ring Network Counter (continued)
Field Name Description Attributes
ELDFR Number of disconnect frames received. PD (5,0)
ELDMT Number of disconnect mode frames transmitted. PD (5,0)
ELDMR Number of disconnect mode frames received. PD (5,0)
ELN2R N2 retries end count: This count is updated when the host has PD (5,0)
attempted to contact a station n times and n times the T1 timer
ended before the station responded.
ELT1T T1 timer end count: Number of times the T1 timer ended. This PD (5,0)
count is updated when the host has attempted to contact a station
n times and n times the T1 timer ended before the station
responded.
EMFTR Total frames transmitted: Total number of frames (LLC and MAC) PD (11,0)
transmitted. This field does not apply to LAN emulation over ATM.
EMFRV Total frames received: Total number of frames (LLC and MAC) PD (11,0)
received. This field does not apply to LAN emulation over ATM.
EMMFT MAC frames transmitted: Total number of MAC frames transmitted. PD (11,0)
This field does not apply to LAN emulation over ATM.
EMMFR MAC frames received: Total number of MAC frames received. This PD (11,0)
field does not apply to LAN emulation over ATM.
EMRIT Routing information frames transmitted: Total number of frames PD (11,0)
(LLC and MAC) with a routing-information field transmitted. This
field does not apply to LAN emulation over ATM.
EMRIR Routing information frames received: Total number of frames (LLC PD (11,0)
and MAC) with a routing-information field received. This field does
not apply to LAN emulation over ATM.
EMLNE Line error: Code violation of frame-check sequence error. This field PD (5,0)
does not apply to LAN emulation over ATM.
EMINE Internal error: Adapter internal error. This field does not apply to PD (5,0)
LAN emulation over ATM.
EMBRE Burst error: Burst of same polarity is detected by the physical unit PD (5,0)
after the starting delimiter of a frame or token. This field does not
apply to LAN emulation over ATM.
EMAFE Address-recognized indicator or frame-copied indicator error: PD (5,0)
Physical control field-extension field error. This field does not apply
to LAN emulation over ATM.
EMABT Abnormal ending delimiter: Abnormal ending delimiter transmitted PD (5,0)
because of internal error. This field does not apply to LAN
emulation over ATM.
EMLST Lost frame: Physical trailer timer ended while IOA is in transmit PD (5,0)
stripping state. This field does not apply to LAN emulation over
ATM.
EMRXC Receive congestion: Frame not copied because no buffer was PD (5,0)
available for the IOA to receive. This field does not apply to LAN
emulation over ATM.
EMFCE Frame-copied error: The frame with a specific destination address PD (5,0)
was copied by another adapter. This field does not apply to LAN
emulation over ATM.
EMFQE Frequency error on the adapter. This field does not apply to LAN PD (5,0)
emulation over ATM.

Appendix A. Performance Data 365

Table 55. Token-Ring Network Counter (continued)
Field Name Description Attributes
EMTKE Token error: The adapter any token timer ended without detecting PD (5,0)
any frame or token. This field does not apply to LAN emulation over
ATM.
EMDBE Direct memory access bus error: IOP/IOA bus DMA error. This field PD (5,0)
does not apply to LAN emulation over ATM.
EMDPE Direct memory access parity error: IOP/IOA DMA parity error. This PD (5,0)
field does not apply to LAN emulation over ATM.
EMANR Total number of frames with address not recognized error. This field PD (5,0)
does not apply to LAN emulation over ATM.
EMFNC Total number of frames with frame not copied error. This field does PD (5,0)
not apply to LAN emulation over ATM.
EMTSE Total number of adapter frame transmit or frame strip process PD (5,0)
errors. This field does not apply to LAN emulation over ATM.
EMUAP Unauthorized access priority: The access priority requested is not PD (5,0)
authorized. This field does not apply to LAN emulation over ATM.
EMUMF Unauthorized MAC frame: The adapter is not authorized to send a PD (5,0)
MAC frame with the source class specified, or the MAC frame has
a source class of zero, or the MAC frame physical control field
attention field is > 1. This field does not apply to LAN emulation
over ATM.
EMSFT Soft error: Total number of soft errors as reported by the adapter. PD (5,0)
This field does not apply to LAN emulation over ATM.
EMTBC Total number of beacon frames transmitted. This field does not PD (5,0)
apply to LAN emulation over ATM.
EMIOA IOA status overrun: Adapter interrupt status queue overrun, earliest PD (5,0)
status discarded. This field does not apply to LAN emulation over
ATM.
EMFDC Total number of frames discarded. This field does not apply to LAN PD (11,0)
emulation over ATM.
EMSIN Total number of interrupts that MAC could not decode. This field PD (11,0)
does not apply to LAN emulation over ATM.
EMBRV Total MAC bytes received ok: This contains a count of bytes in PD(11,0)
frames that are successfully received. It includes bytes from
received multicast and broadcast frames. This number includes
everything starting from destination address up to but excluding
FCS. Source address, destination address, length or type, and pad
are included.
EMBTR Total MAC bytes transmitted ok: Total number of bytes transmitted PD(11,0)
successfully. This number includes everything starting from
destination address up to but excluding FCS. Source address,
destination address, length or type, and pad are included.
EMFNTR Total frames not transmitted: This contains a count of frames that PD(11,0)
could not be transmitted due to the hardware not signaling
transmission completion for an excessive period of time. This field
does not apply to LAN emulation over ATM.
EMRGUC Ring use count. This field does not apply to LAN emulation over PD(11,0)
ATM.
Percentage LAN utilization = EMRGUC / EMRFSC

366 OS/400 Work Management V4R4

Table 55. Token-Ring Network Counter (continued)
Field Name Description Attributes
EMRGSC Ring sample count. This field does not apply to LAN emulation over PD(11,0)
ATM.
Percentage LAN utilization = EMRGUC / EMRFSC
EMCVRF FCS or code violations detected in repeated frames: This counter is PD(5,0)
incremented for every repeated frame that has a code violation or
fails the frame check sequence (FCS) cyclic redundancy check.
This field does not apply to LAN emulation over ATM.
EMFNR Frames transmitted that failed to return: This counter is incremented PD(5,0)
when a transmitted frame fails to return from around the ring due to
time out or the reception of another frame. This field does not apply
to LAN emulation over ATM.
EMUNDR Number of underruns: This counter is incremented each time a PD(5,0)
DMA underrun is detected. This field does not apply to LAN
emulation over ATM.
EMDUP The duplex state of the line. For some lines, this value might C (1)
change over time. This field can have the following values:
blank The duplex state is not known.
F Full duplex: The line can simultaneously transmit and
receive data.
H Half duplex: The line can either transmit data or receive
data, but the line cannot simultaneously transmit and
receive data.

File Name: QAPMSTNL

Token-Ring Station File Entries: Table 55 lists the fields in the token-ring local
area network (LAN) station file.

Token-ring LAN station statistics are reported for active token-ring line descriptions
that are associated with token-ring ports and with ATM ports that support token-ring
LAN emulation.
Table 56. Token-Ring Station Counter
Field Name Description Attributes
INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
the sample interval.
INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
sample interval.
IOPRN IOP resource name. C(10)
SLIOPI Reserved C (1)
SLTYPE The resource type of the IOP or adapter represented by this record. C (4)
SLPCEP The provider connection end point (PCEP) ID. C (8)
SLLND Line description: The name of the description for this line. C (10)
SLSTNN Station name: The name of the station on this line. C (10)
SLLSPD Line speed: The line speed expressed in bits per second (bps). PD (11,0)

Appendix A. Performance Data 367

Table 56. Token-Ring Station Counter (continued)
Field Name Description Attributes
SLTXMT Total number of Type II frames transmitted. PD (11,0)
SLTRCV Total number of Type II frames received. PD (11,0)
SLBXMT Total number of bytes transmitted in all I-frames. PD (11,0)
SLBRCV Total number of bytes received in all I-frames. PD (11,0)
SLIXMT Total number of I-frames transmitted. PD (11,0)
SLIRCV Total number of I-frames received. PD (11,0)
SLIREX Number of I-frames retransmitted. PD (11,0)
SLBREX Number of bytes retransmitted in I-frames. PD (11,0)
SLRNRX Number of receive-not-ready frames transmitted. PD (5,0)
SLRNRR Number of receive-not-ready frames received. PD (5,0)
SLFRMX Number of frame-reject frames transmitted. PD (5,0)
SLFRMR Number of frame-reject frames received. PD (5,0)
SLREJR Number of reject frames received. PD (5,0)
SLREJX Number of reject frames transmitted. PD (5,0)
SLSABX Number of set asynchronous balanced mode extended frames PD (5,0)
transmitted.
SLSABR Number of set asynchronous balanced mode extended frames PD (5,0)
received.
SLDISX Number of disconnect frames transmitted. PD (5,0)
SLDISR Number of disconnect frames received. PD (5,0)
SLDMFX Number of disconnect mode frames transmitted. PD (5,0)
SLDMFR Number of disconnect mode frames received. PD (5,0)
SLN2RE N2 retries end count: This count is updated when the host has PD (5,0)
attempted to contact a station n times and n times the T1 timer
ended before the station responded.
SLT1TE T1 timer end count: Number of times the T1 timer ended. This count PD (5,0)
is updated when the host has attempted to contact a station n times
and n times the T1 timer ended before the station responded.
SLTITE Ti timer end count: Number of times the Ti timer (inactivity timer) PD (5,0)
ended.
SLLBCT Local busy count: Number of times station entered local busy PD (5,0)
substate.
SLPRCL Protocol type: E for token-ring network. C (1)

File Name: QAPMETH

Ethernet File Entries: Table 57 lists the fields in the Ethernet file.

Ethernet LAN protocol statistics are reported for active Ethernet line descriptions
that are associated with Ethernet ports and with ATM ports that support Ethernet
LAN emulation.

368 OS/400 Work Management V4R4

Table 57. Ethernet Counter
Field Name Description Attributes
INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
the sample interval.
INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
sample interval.
IOPRN IOP resource name. C(10)
ETIOPI Reserved C (1)
ETTYPE The resource type of the IOP or adapter represented by this record. C (4)
ETLLND Line description: The name of the description for this line. C (10)
ETLLSP Line speed: The line speed expressed in bits per second (bps). For PD (11,0)
some lines, this value might change as time progresses.
ETLTFT Total number of Type II frames transmitted. PD (11,0)
ETLTFR Total number of Type II frames received. PD (11,0)
ETLIFT Total number of I-frames transmitted. PD (11,0)
ETLIFR Total number of I-frames received. PD (11,0)
ETLICT Total number of characters transmitted in all I-frames. PD (11,0)
ETLICR Total number of characters received in all I-frames. PD (11,0)
ETLPRCL Protocol type: T for Ethernet. C (1)
ETLRFT Number of receive-not-ready frames transmitted. PD (5,0)
ETLRFR Number of receive-not-ready frames received. PD (5,0)
ETLFFT Number of frame-reject frames transmitted. PD (5,0)
ETLFFR Number of frame-reject frames received. PD (5,0)
ETLRJR Number of reject frames received. PD (5,0)
ETLRJT Number of reject frames transmitted. PD (5,0)
ETLSFT Number of set asynchronous balanced mode extended frames PD (5,0)
transmitted.
ETLSFR Number of set asynchronous balanced mode extended frames PD (5,0)
received.
ETLDFT Number of disconnect frames transmitted. PD (5,0)
ETLDFR Number of disconnect frames received. PD (5,0)
ETLDMT Number of disconnect mode frames transmitted. PD (5,0)
ETLDMR Number of disconnect mode frames received. PD (5,0)
ETLN2R N2 retries end count: This count is updated when the host has PD (5,0)
attempted to contact a station n times and n times the T1 timer
ended before the station responded.
ETLT1T T1 timer end count: Number of times the T1 timer ended. This count PD (5,0)
is updated when the host has attempted to contact a station n times
and n times the T1 timer ended before the station responded.
ETLTIT Number of times the TI timer (Inactivity Timer) expired. This count is PD (5,0)
updated when the host has attempted to contact a station n times
and n times the T1 timer ended before the station responded.
ETLFRT Number of times I-frame retransmission occurred. PD (11,0)

Appendix A. Performance Data 369

Table 57. Ethernet Counter (continued)
Field Name Description Attributes
ETLBRT I frame bytes transmitted again. PD (11,0)
ETLLBC Local busy count: Number of times station entered local busy PD (5,0)
substate.
ETMFTG Frames transmitted without error. This field does not apply to LAN PD (11,0)
emulation over ATM.
ETMFRG Frames received without error. This field does not apply to LAN PD (11,0)
emulation over ATM.
ETMIFM Inbound frames missed: A receiver buffer error or a missed frame PD (5,0)
was detected by the IOA. This field does not apply to LAN emulation
over ATM.
ETMCRE CRC error: Checksum errors detected by the receiver. This field PD (5,0)
does not apply to LAN emulation over ATM.
ETMEXR More than 16 retries: Frame unsuccessfully transmitted due to PD (5,0)
excessive retries. This field does not apply to LAN emulation over
ATM.
ETMOWC Out of window collisions: Collision occurred after slot time of PD (5,0)
channel elapsed. This field does not apply to LAN emulation over
ATM.
ETMALE Alignment error: Inbound frame contained non-integer number of PD (5,0)
bytes and a CRC error. This field does not apply to LAN emulation
over ATM.
ETMCRL Carrier loss: Carrier input to the chipset on the IO adapters is false PD (5,0)
during transmission. This field does not apply to LAN emulation over
ATM.
ETMTDR Time-domain reflectometry: Counter used to approximate distance to PD (5,0)
a cable fault. This value is associated with the last occurrence of
more than 16 retries. This field does not apply to LAN emulation
over ATM.
ETMRBE Receive buffer errors: A silo overflow occurred upon receiving a PD (5,0)
frame. This field does not apply to LAN emulation over ATM.
ETMSPI Spurious interrupts: An interrupt was received but could not be PD (5,0)
decoded into a recognizable interrupt. This field does not apply to
LAN emulation over ATM.
ETMDIF Discarded inbound frames: Receiver discarded frame due to lack of PD (5,0)
AIF entries. This field does not apply to LAN emulation over ATM.
ETMROV Receive overruns: Receiver has lost all or part of an incoming frame PD (5,0)
due to buffer shortage. This field does not apply to LAN emulation
over ATM.
ETMMEE Memory error: The chipset on the IO adapters is the bus master and PD (5,0)
did not receive ready signal within 25.6 usecs of asserting the
address on the DAL** lines. This field does not apply to LAN
emulation over ATM.
ETMIOV Interrupt overrun: Interrupt not processed due to lack of status PD (5,0)
queue entries. This field does not apply to LAN emulation over ATM.
ETMTUN Transmit underflow: Transmitter has truncated a message due to PD (5,0)
data late from memory. This field does not apply to LAN emulation
over ATM.
ETMBBE Babble errors: Transmitter exceeded maximum allowable time on PD (5,0)
channel. This field does not apply to LAN emulation over ATM.

370 OS/400 Work Management V4R4

Table 57. Ethernet Counter (continued)
Field Name Description Attributes
ETMSQE Signal quality error: Signal indicating the transmit is successfully PD (5,0)
complete did not arrive within 2 usecs of successful transmission.
This field does not apply to LAN emulation over ATM.
ETMM1R More than 1 retry to transmit: Frame required more than one retry PD (5,0)
for successful transmission. This field does not apply to LAN
emulation over ATM.
ETM1R Exactly one retry to transmit: Frame required 1 retry for successful PD (5,0)
transmission. This field does not apply to LAN emulation over ATM.
ETMDCN Deferred conditions: The chipset on the IO adapters deferred PD (5,0)
transmission due to busy channel. This field does not apply to LAN
emulation over ATM.
ETMBRV Total MAC bytes received ok: This contains a count of bytes in PD(11,0)
frames that are successfully received. It includes bytes from
received multicast and broadcast frames. This number includes
everything starting from destination address up to but excluding
FCS. Source address, destination address, length or type, and pad
are included.
ETMBTR Total MAC bytes transmitted ok: Total number of bytes transmitted PD(11,0)
successfully. This number includes everything starting from
destination address up to but excluding FCS. Source address,
destination address, length or type, and pad are included.
ETMFNT Total frames not transmitted: This contains a count of frames that PD(11,0)
could not be transmitted due to the hardware not signaling
transmission completion for an excessive period of time. This field
does not apply to LAN emulation over ATM.
ETMMFD Total mail frames discarded. This field does not apply to LAN PD(5,0)
emulation over ATM.
ETMTFD Total frames discarded. This field does not apply to LAN emulation PD(5,0)
over ATM.
ETMDUP The duplex state of the line. For some lines, this value might change C (1)
over time. This field can have the following values:
blank The duplex state is not known.
F Full duplex: The line can simultaneously transmit and
receive data.
H Half duplex: The line can either transmit data or receive
data, but the line cannot simultaneously transmit and
receive data.

File Name: QAPMSTNE

Ethernet Station File Entries: Table 58 lists the fields in the Ethernet station file.

Ethernet LAN station statistics are reported for active Ethernet line descriptions that
are associated with Ethernet ports and with ATM ports that support Ethernet LAN
emulation.

Appendix A. Performance Data 371

Table 58. Ethernet Station Counter
Field Name Description Attributes
INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
the sample interval.
INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
sample interval.
IOPRN IOP resource name. C(10)
STIOPI Reserved C (1)
STTYPE The resource type of the IOP or adapter represented by this record. C (4)
STPCEP The provider connection end point (PCEP) ID. C (8)
STLND Line description: The name of the description for this line. C (10)
STSTNN Station Name: The name of the station on this line. C (10)
STLSPD Line speed: The line speed expressed in bits per second (bps). For PD (11,0)
some lines, this value might change as time progresses.
STTXMT Total number of Type II frames transmitted. PD (11,0)
STTRCV Total number of Type II frames received. PD (11,0)
STBXMT Total number of bytes transmitted in all I-frames. PD (11,0)
STBRCV Total number of bytes received in all I-frames. PD (11,0)
STIXMT Total number of I-frames transmitted. PD (11,0)
STIRCV Total number of I-frames received. PD (11,0)
STIREX Number of I-frames retransmitted. PD (11,0)
STBREX Number of bytes retransmitted in I-frames. PD (11,0)
STRNRX Number of receive-not-ready frames transmitted. PD (5,0)
STRNRR Number of receive-not-ready frames received. PD (5,0)
STFRMX Number of frame-reject frames transmitted. PD (5,0)
STFRMR Number of frame-reject frames received. PD (5,0)
STREJR Number of reject frames received. PD (5,0)
STREJX Number of reject frames transmitted. PD (5,0)
STSABX Number of set asynchronous balanced mode extended frames PD (5,0)
transmitted.
STSABR Number of set asynchronous balanced mode extended frames PD (5,0)
received.
STDISX Number of disconnect frames transmitted. PD (5,0)
STDISR Number of disconnect frames received. PD (5,0)
STDMFX Number of disconnect mode frames transmitted. PD (5,0)
STDMFR Number of disconnect mode frames received. PD (5,0)
STN2RE N2 retries end count: This count is updated when the host has PD (5,0)
attempted to contact a station n times and n times the T1 timer
ended before the station responded.
STT1TE T1 timer end count: Number of times the T1 timer ended. This count PD (5,0)
is updated when the host has attempted to contact a station n times
and n times the T1 timer ended before the station responded.

372 OS/400 Work Management V4R4

Table 58. Ethernet Station Counter (continued)
Field Name Description Attributes
STTITE Ti timer end count: Number of times the Ti timer (inactivity timer) PD (5,0)
ended.
STLBCT Local busy count: Number of times station entered local busy PD (5,0)
substate.
STPRCL Protocol type: T for Ethernet network. C (1)

File Name: QAPMDDI

QAPMDDI is a database file for distributed data interface (DDI) counter.
Table 59. DDI Counter
Field Name Description Attributes
INTNUM Interval number: The Nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) for the job interval entry and job completion C (12)
date, and time (hh:mm:ss) for the job completion entry.
INTSEC Elapsed interval seconds. PD (7,0)
IOPRN IOP resource name. C(10)
DDIOPI Reserved C (1)
DITYPE The resource type of the IOP or adapter represented by this record. C (4)
DDLND Line description: The name of the description for this line. C (10)
DDLSP Line speed: The line speed expressed in bits per second (bps). PD (11,0)
DLTFT Total number of Type II frames transmitted. P (11,0)
DLTFR Total number of Type II frames received. P (11,0)
DLIFT Total number of I-frames transmitted. P (11,0)
DLIFR Total number of I-frames received. P (11,0)
DLICT Total number of I-frame character transmitted. (11,0)
DLICR Total number of I-frame characters received. (11,0)
DLPRCL Protocol type: C for DDI C (1)
DLRFT Total number of receive-not-ready frames transmitted. PD (11,0)
DLRFR Total number of receive-not-ready frames received. PD (11,0)
DLFFT Total number of frame-reject (FRMR) frames transmitted. PD (11,0)
DLFFR Total number of frame-reject (FRMR) frames received. PD (11,0)
DLRJFR Number of reject frames received. PD (11,0)
DLRJFT Number of reject frames transmitted. PD (11,0)
DLSFT Number of set asynchronous balanced mode extended frames PD (11,0)
transmitted.
DLSFR Number of set asynchronous balanced mode extended frames PD (11,0)
received.
DLDFT Number of disconnect (DISC) frames transmitted. PD (11,0)
DLDFR Number of disconnect (DISC) frames received. PD (11,0)
DLDMT Number of disconnect mode (DM) frames transmitted. PD (11,0)
DLDMR Number of disconnect mode (DM) frames received. PD (11,0)

Appendix A. Performance Data 373

Table 59. DDI Counter (continued)
Field Name Description Attributes
DLN2R N2 retries end count: This count is updated when host has PD (11,0)
attempted to contact a station n times, and the T1 timer ended n
times before the station responded.
DLT1T T1 timer end count: Number of times the T1 ended. This count is PD (11,0)
updated when the host has attempted to contact a station n times,
and the T1 timer ended n times before the station responded.
DMFRV Number of MAC frames received. PD (11,0)
DMFCC Number of MAC frames copied. PD (11,0)
DMFTR Number of MAC frames transmitted. PD (11,0)
DMTKN Number of MAC tokens received. PD (11,0)
DMERR MAC error count. PD (11,0)
DMLFC Lost frame count. PD (11,0)
DMTVX TVX expiration count. PD (11,0)
DMNCC Not copied count. PD (11,0)
DMLAT MAC late count. PD (11,0)
DLROP Ring operation count. PD (11,0)
DMABE PortA elasticity buffer (EB) errors. PD (11,0)
DMATF PortA LCT count: count of consecutive times the confidence test PD (11,0)
(LCT) has failed.
DMALR PortA reject count. PD (11,0)
DMAEC PortA link error monitor (LEM) count. PD (11,0)
DMBBE PortB elasticity buffer (EB) errors. PD (11,0)
DMBTF PortB LCT count: count of consecutive times the confidence test PD (11,0)
(LCT) has failed.
DMBLR PortB reject count. PD (11,0)
DMBEC PortB link error monitor (LEM) count. PD (11,0)
DMANR Address not recognized. PD (11,0)
DMFNC Frame not copied. PD (11,0)
DMTKE Reserved PD (11,0)
DMDUP Duplicate address count. PD (11,0)
DMDFR Discarded frame count. PD (11,0)
DMTXU Transmit underruns. PD (11,0)
DMRER Recoverable errors. PD (11,0)
DMNER Nonrecoverable errors. PD (11,0)
DMSIN Spurious interruptions. PD (11,0)

File Name: QAPMSTND

FDDI Station File Entries: This is the station counter file for distributed data
interface (DDI) information. Table 60 lists the fields in the DDI station counter. file.

374 OS/400 Work Management V4R4

Table 60. DDI Station Counter
Field Name Description Attributes
INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
the sample interval.
INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
sample interval.
IOPRN IOP resource name. C(10)
SDIOPI Reserved C (1)
SDTYPE The resource type of the IOP or adapter represented by this record. C (4)
SDPCEP The provider connection end point (PCEP) ID. C (8)
SDLND Line description: The name of the description for this line. C (10)
SDSTNN Station name: The name of the station on this line. C (10)
SDLSPD Line speed: The line speed expressed in bits per second (bps). PD (11,0)
SDTXMT Total number of Type II frames transmitted. PD (11,0)
SDTRCV Total number of Type II frames received. PD (11,0)
SDBXMT Total number of bytes transmitted in all I-frames. PD (11,0)
SDBRCV Total number of bytes received in all I-frames. PD (11,0)
SDIXMT Total number of I-frames transmitted. PD (11,0)
SDIRCV Total number of I-frames received. PD (11,0)
SDIREX Number of I-frames retransmitted. PD (11,0)
SDBREX Number of bytes retransmitted in I-frames. PD (11,0)
SDRNRX Number of receive-not-ready frames transmitted. PD (5,0)
SDRNRR Number of receive-not-ready frames received. PD (5,0)
SDFRMX Number of frame-reject frames transmitted. PD (5,0)
SDFRMR Number of frame-reject frames received. PD (5,0)
SDREJR Number of reject frames received. PD (5,0)
SDREJX Number of reject frames transmitted. PD (5,0)
SDSABX Number of set asynchronous balanced mode extended frames PD (5,0)
transmitted.
SDSABR Number of set asynchronous balanced mode extended frames PD (5,0)
received.
SDDISX Number of disconnect frames transmitted. PD (5,0)
SDDISR Number of disconnect frames received. PD (5,0)
SDDMFX Number of disconnect mode frames transmitted. PD (5,0)
SDDMFR Number of disconnect mode frames received. PD (5,0)
SDN2RE N2 retries end count: This count is updated when the host has PD (5,0)
attempted to contact a station n times, and the T1 timer ended n
times before the station responded.
SDT1TE T1 timer end count: Number of times the T1 timer ended. This count PD (5,0)
is updated when the host has attempted to contact a station n times,
and the T1 timer ended n times before the station responded.
SDTITE Ti timer end count: Number of times the Ti timer (inactivity timer) PD (5,0)
ended.

Appendix A. Performance Data 375

Table 60. DDI Station Counter (continued)
Field Name Description Attributes
SDLBCT Local busy count: Number of times station entered local busy PD (5,0)
substate.
SDPRCL Protocol type: C for DDI. C (1)

File Name: QAPMFRLY

Frame relay counter entries: QAPMFRLY is a database file for frame relay
counter.
Table 61. Frame Relay Counter
Field Name Description Attributes
INTNUM Interval number: The Nth sample interval since the start of the PD (5 0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) for the job interval entry and job completion C (12)
date, and time (hh:mm:ss) for the job completion entry.
INTSEC Elapsed interval seconds. PD (7 0)
IOPRN IOP resource name. C(10)
YIOPI Reserved C (1)
YITYPE The resource type of the IOP or adapter represented by this record. C (4)
YLND Network interface (NWI) description: The name of the description for C (10)
this line.
YLSP Line speed: The line speed expressed in bits per second (bps). PD (11,0)
YLTFT Total number of frames transmitted. PD (11,0)
YLTFR Total number of frames received. PD (11,0)
YLIFT Total number of I-frames transmitted. PD (11,0)
YLIFR Total number of I-frames received. PD (11,0)
YLICT Total number of I-frames characters transmitted. PD (11,0)
YLICR Total number of I-frames characters received. PD (11,0)
YLPRCL Protocol type: Y for frame relay. C (1)
YLRFT Number of receive-not-ready (RNR) frames transmitted. PD (11,0)
YLRFR Number of receive-not-ready (RNR) frames received. PD (11,0)
YLFFT Number of frame-reject frames transmitted. PD (11,0)
YLFFR Total number of frame-reject frames received. PD (11,0)
YLRJFR Number of reject frames received. PD (11,0)
YLRJFT Number of reject frames transmitted. PD (11,0)
YLSFT Number of set asynchronous balanced mode extended (SABME) PD (11,0)
frames transmitted.
YLSFR Number of set asynchronous balanced mode extended (SABME) PD (11,0)
frames received.
YLDFT Number of disconnect (DISC) frames transmitted. PD (11,0)
YLDFR Number of disconnect (DISC) frames received. PD (11,0)
YLDMT Number of disconnect mode (DM) frames transmitted. PD (11,0)
YLDMR Number of disconnect mode (DM) frames received. PD (11,0)

376 OS/400 Work Management V4R4

 Table 61. Frame Relay Counter (continued)
Field Name Description Attributes
YLN2R N2 retries end count: This count is updated when the host has PD (11,0)
attempted has attempted to contact a station n times, and the T1
timer ended n times before the station responded.
YLT1T T1 timer end count: Number of times the T1 timer ended. This count PD (11,0)
is updated when the host has attempted to contact a station n times,
and the T1 timer ended n times before the station responded.
| YMLTI Local management interface (LMI) timeouts. PD (11,0)
YMLSE Local management interface (LMI) sequence errors. PD (11,0)
YMLPE Local management interface (LMI) protocol errors. PD (11,0)
YMPDE Port monitor data set ready (DSR) errors. PD (11,0)
YMPCE Port monitor clear to send (CTS) errors. PD (11,0)
| YMMER MAC errors. PD (11,0)

File Name: QAPMSTNY

Frame Relay Station File Entries: Table 62 lists the fields in the frame relay
station counter.
Table 62. Frame Relay Station Counter
Field Name Description Attributes
INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
the sample interval.
INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
sample interval.
IOPRN IOP resource name. C(10)
SYIOPI Reserved C (1)
SYTYPE The resource type of the IOP or adapter represented by this record. C (4)
SYPCEP The provider connection end point (PCEP) ID. C (8)
SYLND Network interface (NWI) description: The name of the description for C (10)
this line.
SYSTNN Station name: The name of the station on this line. C (10)
SYLSPD Line speed: The line speed expressed in bits per second (bps). PD (11,0)
SYTXMT Total number of Type II frames transmitted. PD (11,0)
SYTRCV Total number of Type II frames received. PD (11,0)
SYBXMT Total number of bytes transmitted in all I-frames. PD (11,0)
SYBRCV Total number of bytes received in all I-frames. PD (11,0)
SYIXMT Total number of I-frames transmitted. PD (11,0)
SYIRCV Total number of I-frames received. PD (11,0)
SYIREX Number of I-frames retransmitted. PD (11,0)
SYBREX Number of bytes retransmitted in I-frames. PD (11,0)
SYRNRX Number of receive-not-ready frames transmitted. PD (5,0)
SYRNRR Number of receive-not-ready frames received. PD (5,0)

Appendix A. Performance Data 377

Table 62. Frame Relay Station Counter (continued)
Field Name Description Attributes
SYFRMX Number of frame-reject frames transmitted. PD (5,0)
SYFRMR Number of frame-reject frames received. PD (5,0)
SYREJR Number of reject frames received. PD (5,0)
SYREJX Number of reject frames transmitted. PD (5,0)
SYSABX Number of set asynchronous balanced mode extended frames PD (5,0)
transmitted.
SYSABR Number of set asynchronous balanced mode extended frames PD (5,0)
received.
SYDISX Number of disconnect frames transmitted. PD (5,0)
SYDISR Number of disconnect frames received. PD (5,0)
SYDMFX Number of disconnect mode frames transmitted. PD (5,0)
SYDMFR Number of disconnect mode frames received. PD (5,0)
SYN2RE N2 retries end count: This count is updated when the host has PD (5,0)
attempted to contact a station n times and n times the T1 timer
ended before the station responded.
SYT1TE T1 timer end count: Number of times the T1 timer ended. This count PD (5,0)
is updated when the host has attempted to contact a station n times
and n times the T1 timer ended before the station responded.
SYTITE Ti timer end count: Number of times the Ti timer (inactivity timer) PD (5,0)
ended.
SYLBCT Local busy count: Number of times station entered local busy PD (5,0)
substate.
SYPRCL Protocol type: Y for frame relay. C (1)

File Name: QAPMSAP

TRLAN, Ethernet, DDI, and Frame Relay SAP File Entries: Table 63 lists the
fields in the Service Access Point (SAP) file.

SAP statistics are reported for active TRLAN, Ethernet, DDI, and frame relay line
descriptions associated with TRLAN, Ethernet, DDI and Frame Relay ports,
respectively. SAP statistics are also reported for ATM ports that support token-ring
and Ethernet LAN emulation.
Table 63. SAP Statistics (One Per SAP Per Line)
Field Name Description Attributes
INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
the sample interval.
INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
sample interval.
IOPRN IOP resource name. C(10)
SCIOPI Reserved C (1)
SCTYPE The resource type of the IOP or adapter represented by this record. C (4)
SCSSAP SSAP ID: The Source SAP (SSAP) ID. C (2)

378 OS/400 Work Management V4R4

 Table 63. SAP Statistics (One Per SAP Per Line) (continued)
Field Name Description Attributes
SCLND Line description: The name of the description for the line containing C (10)
the SAP listed above. For frame relay, this is network interface
(NWI) description.
SCLSPD Line speed: The speed of the line in bits per second (bps). For PD (11,0)
some lines, this value might change as time progresses.
SCIRCV UI frames received: Total number of UI frames received at this PD (11,0)
SSAP.
SCIXMT UI frames transmitted: Total number of UI frames transmitted PD (11,0)
through this SSAP.
SCBRCV UI bytes received: Total number of bytes received at this SSAP PD (11,0)
contained within a UI frame.
SCBXMT UI bytes transmitted: Total number of bytes transmitted through this PD (11,0)
SSAP contained within a UI frame.
SCIDSC Number of UI frames received and discarded by this SSAP. PD (11,0)
SCPRCL Protocol types: C (1)
E for Token-Ring
F for DDI
T for Ethernet
Y for Frame Relay

File Name: QAPMLAPD

Integrated Services Digital Network LAPD File Entries: Table 64 lists the fields
in the LAPD file.
Table 64. ISDN LAPD Counter
Field Name Description Attributes
INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
the sample interval.
INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
sample interval.
IOPRN IOP resource name. C(10)
LDIOP Reserved. C(1)
LDTYPE The resource type of the IOP or adapter represented by this record. C (4)
LDNWI Network interface: The name of the network interface description. C (10)
LDLSP Link speed: The speed of this channel in bits per second. PD (11,0)
LDPRCL Protocol type: D for LAPD. C (1)
LPLOFA Loss of frame alignment: Total number of times when a time period PD (11,0)
equivalent to two 48-bit frames has elapsed without having detected
valid pairs of line code violations.
| LPLECV Reserved. PD (11,0)
| LPDTSI Reserved. PD (11,0)
| LPDTSO Reserved. PD (11,0)
| LPFECV Reserved. PD (11,0)

Appendix A. Performance Data 379

 Table 64. ISDN LAPD Counter (continued)
Field Name Description Attributes
| LPES Errored seconds: Total number of seconds that had one or more PD (5,0)
| path coding violations, one or more out of frame defects, one or
| more controlled slip events, or a detected alarm indication signal
| defect.
| LPSES Severely errored seconds: Total number of seconds that had 320 or PD (5,0)
| more path coding violation error events, one or more out of frame
| defects, or a detected alarm indication signal event.
| v For ESF signals, the number of seconds that had 320 or more
| path coding violation error events, one or more out of frame
| defects, or a detected alarm indication signal defect.
| v For E1–CRC signals, the number of seconds that had 832 or
| more path coding violation error events or one or more out of
| frame defects.
| v For E1–noCRC signals, the number of seconds that had 2048 or
| more line coding violations.
| v For D4 signals, the number of seconds that had framing error
| events, an out of frame defect, or 1544 or more line coding
| violations.
LPCOL Collision detect: The number of times the TE detected that its PD (11,0)
transmitted frame had been corrupted by another TE attempting to
use the same bus.
LLCRCE Receive CRC errors: The number of received frames that contain a PD (11,0)
CRC (cycle redundancy check) error.
LLSFE Short frame errors: The number of short frames received. A short PD (11,0)
frame is a frame that has fewer octets between its start flag and end
flag than is permitted.
LLORUN Receive overrun: The number of times the ISDN subsystem could PD (11,0)
not keep pace with incoming data because of local controller
overload.
LLURUN Transmit underrun: The number of times the ISDN subsystem could PD (11,0)
not keep pace with outgoing data because of local controller
overload.
LLABRT Aborts received: The number of frames received that contained PD (11,0)
HDLC abort indicators.
LLFRIE Frames received in error: The sum of receive cycle redundancy PD (11,0)
check (CRC) errors, short frame errors, receive overrun, transmit
underrun, aborts received, and frame sequence errors (LLCRCE,
LLSFE, LLORUN, LLURUN, LLABRT, LSSEQE).
LSFRT Retransmitted frames. PD (11,0)
LSSEQE Sequence errors: The number of received frames that contained PD (11,0)
sequence numbers indicating frames were lost.
LSFTRN Total number of frames transmitted: This includes information (I), PD (11,0)
unnumbered information (UI), and supervisory (S) frames sent to a
remote link station. This includes frames retransmitted and frames
sent on transmissions stopped by transmit underrun, in addition to
successful transmissions.
LSFRCV Total number of frames received: This includes information (I), PD (11,0)
unnumbered information (UI), and supervisory (S) frames received
from the remote link station. This includes no errors.

380 OS/400 Work Management V4R4

 Table 64. ISDN LAPD Counter (continued)
Field Name Description Attributes
LSBTRN Total bytes transmitted: The total number of bytes transmitted to a PD (11,0)
remote link station. This includes bytes retransmitted and bytes sent
on transmissions stopped by a transmit underrun, in addition to
successful transmissions.
LSBRCV Total bytes received: The total number of bytes received from the PD (11,0)
remote link station. This includes no errors.
LQTOC Total outgoing calls: The number of outgoing call attempts. For X.31 PD (11,0)
this includes outgoing SETUP messages requesting a packet
switched connection. For Q.932, outgoing REGISTER messages are
not included in this count.
LQROC Retry for outgoing calls: The number of outgoing calls that were PD (11,0)
rejected by the network. For X.31 this includes retry for outgoing
SETUP messages requesting a packet switched connection. For
Q.932, retry for outgoing REGISTER messages are not included in
this count.
LQTIC Total incoming calls: The number of incoming call attempts. For X.31 PD (11,0)
this includes incoming SETUP messages requesting a packet
switched connection. For Q.932, incoming REGISTER messages
are not included in this count.
LQRIC Rejected incoming calls: The number of incoming calls that are PD (11,0)
rejected by the TE. For passive bus, the call may be intended for
another TE that shares the same passive bus. This includes calls
rejected both directly by the IOP and by the IOM. For X.31 this
includes rejected incoming SETUP messages requesting a packet
switched connection. For Q.932, rejected incoming REGISTER
messages are not included in this count.
LDCHLS1 S1 maintenance channel: Set to one if the S1 maintenance channel PD (1,0)
was active.
| LPLES Line errored seconds: The number of seconds that had one or more PD (5,0)
| line coding violations.
| LPCSS Controlled slip seconds: The number of seconds that had one or PD (5,0)
| more controlled slip events.
| LPBES Bursty errored seconds (error second type B): The number of PD (5,0)
| seconds that had greater than one but fewer than 320 path coding
| violation error events, no severely errored frame defects, and no
| detected incoming alarm indication signal defects.
| LPSEFS Severely errored framing seconds: The number of seconds that had PD (5,0)
| one or more out of frame defects or a detected alarm indication
| signal defect.
| LPDM Degraded minutes: The number of minutes during which the PD (5,0)
| estimated error rate exceeds 1E-6 but does not exceed 1E-3.
| LPUS Unavailable seconds: The number of seconds during which the PD (5,0)
| interface is unavailable.

File Name: QAPMIDLC

Integrated Services Digital Network (ISDN) Data Link Control File Entries:
Table 65 lists the fields in the ISDN Data Link Control (IDLC) file.

Appendix A. Performance Data 381

Table 65. ISDN IDLC Counter
Field Name Description Attributes
INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
the sample interval.
INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
sample interval.
IOPRN IOP resource name. C(10)
ISIOP Reserved C (1)
ISTYPE The resource type of the IOP or adapter represented by this record. C (4)
ISLND Line description: The name of the line description. C (10)
ISNWI Network interface description: The name of the network interface C (10)
description.
ISLSP Link speed: The speed of this channel in bits per second. PD (11,0)
ISPRCL Protocol type: I for IDLC. C (1)
ILCRCE Receive CRC errors: The number of received frames that contain a PD (11,0)
cycle redundancy check (CRC) error.
ILSFE Short frame errors: The number of short frames received. A short PD (11,0)
frame is a frame that has fewer octets between its start flag and end
flag than is permitted.
ILORUN Receive overrun: The number of times the ISDN subsystem could PD (11,0)
not keep pace with incoming data because of local controller
overload.
ILURUN Transmit underrun: The number of times the ISDN subsystem could PD (11,0)
not keep pace with outgoing data because of local controller
overload.
ILABRT Aborts received: The number of frames received that contained PD (11,0)
HDLC abort indicators.
ILFRIE Frames received in error: The sum of receive CRC errors, short PD (11,0)
frame errors, receive overrun, transmit underrun, aborts received,
and frame sequence errors (ILCRCE, ILSFE, ILORUN, ILURUN,
ILABRT, ISSEQE).
ISFRT Retransmitted frames: PD (11,0)
ISSEQE Sequence errors: The number of received frames that contained PD (11,0)
sequence numbers indicating frames were lost.
ISFTRN Total number of frames transmitted: This includes information (I), PD (11,0)
unnumbered information (UI), and supervisory (S) frames sent to a
remote link station. This includes frames retransmitted and frames
sent on transmissions stopped by transmit underruns, in addition to
successful transmissions.
ISFRCV Total number of frames received: This includes information (I), PD (11,0)
unnumbered information (UI), and supervisory (S) frames received
from the remote link station. This includes no errors.
ISBTRN Total bytes transmitted: The total number of bytes transmitted to a PD (11,0)
remote link station. This includes bytes retransmitted and bytes sent
on transmissions stopped by a transmit underrun, in addition to
successful transmissions.
ISBRCV Total bytes received: The total number of bytes received from the PD (11,0)
remote link station. This includes no errors.

382 OS/400 Work Management V4R4

 Table 65. ISDN IDLC Counter (continued)
Field Name Description Attributes
ISB1 B1 channel: Set to one if the B1 channel was used. PD (1,0)
ISB2 B2 channel: Set to one if the B2 channel was used. PD (1,0)
| ISCHAN B channel used: The B channel used is associated with a bit in this C (4)
| field being set to 1. Bit 0 (most significant bit) and 31 (least
| significant bit) are reserved. Bits 1 to 30 are associated with B
| channels 30 to 1, respectively.

File Name: QAPMBUS

Licensed Internal Code bus counters: Table 66 lists the fields in the bus
counters file.
Table 66. Bus Counter
Field Name Description Attributes
INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
the sample interval.
INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
sample interval.
BUIOPB IOP bus number. PD (3,0)
BUOPSR Number of OPSTARTs received: RRCB in server storage. PD (11,0)
BUSGLR Signals received. PD (11,0)
BUOPSS Number of OPSTARTs sent. PD (11,0)
BUSGLS Signals sent. PD (11,0)
BURSTQ Restart queues sent. PD (11,0)
BUBNAR Occurrences of BNA received. PD (11,0)
BUTPKT Total packets (sent or received). PD (11,0)
BUKBYO Reserved PD (11,0)
BUKBYI Reserved PD (11,0)
BUNOSR Normal flow opstarts received PD (11,0)
BUNRDR Not readys received PD (11,0)
BUORQS Op requests sent PD (11,0)
BUTIMO Bus time outs PD (11,0)
BUBNAS BNAs sent PD (11,0)
BUQSAS Queue space available sent PD (11,0)

File Name: QAPMCIOP

Communications Controller File Entries: Table 67 lists the fields in the
communications controller file.
Table 67. Communications Controller IOP Data (One for Each Communications Controller)
Field Name Description Attributes
INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
performance monitor job.

Appendix A. Performance Data 383

Table 67. Communications Controller IOP Data (One for Each Communications Controller) (continued)
Field Name Description Attributes
DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
the sample interval.
INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
sample interval.
IOPRN IOP resource name C (10)
CIIOP Reserved C (1)
CITYPE The type of IOP described by this record. C (4)
CTIPKT Total packets transferred. PD (11,0)
CIKBYO Total KB transmitted from an IOP to the system across the bus. PD (11,0)
CIKBYI Total KB transmitted to the IOP from the system across the bus. PD (11,0)
CIOPSR OPSTART bus unit message received from another bus unit using PD (11,0)
normal flow.
CIOPSS OPSTART bus unit message received from another bus unit using PD (11,0)
reverse flow method 2 (always 0).
CISGLR Signals received. PD (11,0)
CIOPST OPSTARTS sent. PD (11,0)
CISLGS Signals sent. PD (11,0)
CIRSTQ Restart queues sent. PD (11,0)
CIRQDO DMA requests sent for output of data: The number of requests the PD (11,0)
IOP sends to the system for data to be sent from the IOP to the
system across the bus.
CIRQDI DMA requests sent for input of data: The number of requests the PD (11,0)
IOP sends to the system for data to be sent to the IOP from the
system across the bus.
CIBNAR Occurrences of BNA received. PD (11,0)
CIPRCU Processor utilization: The number of fixed-time intervals that this PD (11,0)
communications IOP spent in the idle state.
CIIDLC Idle loop count (see note): The number of times the communications PD (11,0)
IOP ran an idle loop. This is done when the IOP has no work to
perform. This count is used with the idle loop time to calculate the
primary IOP processor utilization in seconds.
CIIDLT Idle loop time (see note): The time (in hundredths of microseconds) PD (11,0)
for the primary IOP processor to run the idle loop once.
CIRAMU Available local storage (in bytes): The number of bytes of free local PD (11,0)
storage in the IOP. The free local storage will probably be
non-contiguous because of fragmentation.
CISYSF The total time (in milliseconds) used by the IOP for basic system PD (11,0)
function that is running in the primary IOP processor.
CICOMM Combined processing time (in milliseconds) accounted for by all of PD (11,0)
the communication protocol tasks that are running in the primary
IOP processor.
CISDLC Processing time (in milliseconds) used by SDLC communications PD (11,0)
tasks that are running in the primary IOP processor.
CIASYN Processing time (in milliseconds) used by ASYNC communications PD (11,0)
tasks that are running in the primary IOP processor.

384 OS/400 Work Management V4R4

 Table 67. Communications Controller IOP Data (One for Each Communications Controller) (continued)
Field Name Description Attributes
CIBSC Processing time (in milliseconds) used for bisynchronous protocol PD (11,0)
tasks that are running in the primary IOP processor.
CIX25L Processing time (in milliseconds) used by X.25 LLC tasks that are PD (11,0)
running in the primary IOP processor.
CIX25P Processing time (in milliseconds) used by X.25 PLC tasks that are PD (11,0)
running in the primary IOP processor.
CIX25D Time (in milliseconds) accounted for by X.25 DLC tasks that are PD (11,0)
running in the primary IOP processor.
CILAN LAN communications time: Total processing unit time (in PD (11,0)
milliseconds) used by token-ring network, Ethernet, frame relay, and
fiber distributed data interface (FDDI) communications tasks that are
running in the primary IOP processor.
CILAP Processing time (in milliseconds) used by ISDN LAPD, LAPE, and PD (11,0)
PMI tasks that are running in the primary IOP processor.
CIQ931 Processing time (in milliseconds) used by ISDN Q.931 tasks that are PD (11,0)
running in the primary IOP processor.
CIF1ID Subfunction 1 ID: The identifier for addition functions that may be C (2)
running in the primary IOP processor.
CIF1TM Subfunction 1 time: The total processing unit time (in milliseconds) PD (11,0)
used by the IOP function that is running in the primary IOP
processor.
| CICPU2 Processor time in milliseconds for the second IO processor, which PD (11,0)
| handles specialized functions. This field applies to Integrated PC
| Servers (excluding I/O adapter versions) and wireless IOPs. This
| field is zero for other IOPs. Collection Services will not report values
| for Integrated PC Servers.
Notes:

The idle loop count and time are used to calculate the communications IOP utilization as follows:
1. Convert the product of the idle loop count times the idle loop time from hundredths of microseconds to seconds.
Subtract this from the interval time, and divide the result by the interval time. For example:
IOP utilization = (INTSEC - (CIIDLC * CIIDLT)/10**8)/ INTSEC
2. The performance monitor reports I/O processor (IOP) statistics differently beginning with Version 3 Release 7.
Therefore, performance statistics for IOPs introduced in Version 3 Release 7 or later releases, are reported in the
QAPMMIOP file. Performance statistics are reported in the QAPMMIOP file even if the IOP supports only one of
the three IOP functions (communications, disk, or local workstation). Performance statistics for IOPs that were
introduced before Version 3 Release 7 will continue to be reported in the appropriate IOP file (QAPMCIOP,
QAPMDIOP, QAPMLIOP, or QAPMMIOP).
3. The function 1 identifier is for additional functions that may be running in the primary IOP processor. Each
function identifier has an associated function time value. The values are:
v ‘00‘–No time value supplied
v ‘11‘–Integrated PC Server pipe task (Integrated PC Server is also known as file server I/O processor and
FSIOP.)
v ‘42‘–Localtalk task
v ‘43‘–Wireless task

File Name: QAPMMIOP

Multifunction Controller File Entries: Table 68 lists the fields in the multifunction
controller file.

Appendix A. Performance Data 385

Table 68. Multifunction Controller IOP Data (One for Each Multifunction Controller)
Field Name Description Attributes
INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
the sample interval.
INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
sample interval.
IOPRN IOP resource name. C(10)
MIIOP Reserved C (1)
MITYPE IOP type. C (4)
MIPRCU Processor utilization: The number of fixed-time intervals that this PD (11,0)
multifunction IOP spent in the idle state.
MIRAMU Available local storage (in bytes): The number of bytes of free local PD (11,0)
storage in the IOP. The free local storage will probably be
non-contiguous because of fragmentation.
MITPKT Total packets transferred. PD (11,0)
MIKBYO Total KB transmitted from an IOP to the system across the bus. PD (11,0)
MIKBYI Total KB transmitted to the IOP from the system across the bus. PD (11,0)
MIOPSR OPSTART bus unit message received from another bus unit using PD (11,0)
normal flow.
MIOPSS OPSTART bus unit message received from another bus unit using PD (11,0)
reverse flow method 2 (always 0).
MISGLR Signals received. PD (11,0)
MIOPST OPSTARTS sent. PD (11,0)
MISLGS Signals sent. PD (11,0)
MIRSTQ Restart queues sent. PD (11,0)
MIRQDO DMA requests sent for output of data: The number of requests the PD (11,0)
IOP sends to the system for data to be sent from the IOP to the
system across the bus.
MIRQDI DMA requests sent for input of data: The number of requests the PD (11,0)
IOP sends to the system for data to be sent to the IOP from the
system across the bus.
MIBNAR Occurrences of BNA received. PD (11,0)
MIIDLC Idle loop count (see note): The number of times the primary IOP PD (11,0)
processor ran an idle loop. This is done when the IOP has no work
to perform. This count is used with the idle loop time to calculate
the primary IOP processor utilization in seconds.
MIIDLT Idle loop time (see note): The time (in hundredths of microseconds) PD (11,0)
for the primary IOP processor to run the idle loop once.
MISYSF IOP system function time: Total processing unit time (in PD (11,0)
milliseconds) used by the IOP for basic system function that is
running in the primary IOP processor.
MIDISK Disk time: Total processing unit time (in milliseconds) used by disk PD (11,0)
tasks that are running in the primary IOP processor.
MICOMM Total communications time: Total processing unit time (in PD (11,0)
milliseconds) used by all the communications protocol tasks that
are running in the primary IOP processor.

386 OS/400 Work Management V4R4

Table 68. Multifunction Controller IOP Data (One for Each Multifunction Controller) (continued)
Field Name Description Attributes
MISDLC SDLC communications time: Total processing unit time (in PD (11,0)
milliseconds) used by SDLC communications tasks that are running
in the primary IOP processor.
MIASYN ASYNC communications time: Total processing unit time (in PD (11,0)
milliseconds) used by asynchronous communications tasks that are
running in the primary IOP processor.
MIBSC BSC communications time: Total processing unit time (in PD (11,0)
milliseconds) used by BSC communications tasks that are running
in the primary IOP processor.
MIX25L X.25 LLC communications time: Total processing unit time (in PD (11,0)
milliseconds) used by X.25 LLC communications tasks that are
running in the primary IOP processor.
MIX25P X.25 PLC communications time: Total processing unit time (in PD (11,0)
milliseconds) used by X.25 packet layer communications (PLC)
tasks that are running in the primary IOP processor.
MIX25D X.25 DLC communications time: Total processing unit time (in PD (11,0)
milliseconds) used by X.25 data link control (DLC) communications
tasks that are running in the primary IOP processor.
MILAN LAN communications time: Total processing unit time (in PD (11,0)
milliseconds) used by token-ring network, Ethernet, frame relay, and
fiber distributed data interface (FDDI) communications tasks. This
includes processing time due to token-ring and Ethernet LAN
emulation.
MISDLD SDLC communications time: Total processing unit time (in PD (11,0)
milliseconds) used by SDLC communications tasks that are running
in the primary IOP processor.
MIRV02 ISDN communications time: Total processing unit time (in PD (11,0)
milliseconds) used by ISDN LAPD, LAPE, and PMI communications
tasks that are running in the primary IOP processor.
MIRV03 ISDN communications time: Total processing unit time (in PD (11,0)
milliseconds) used by ISDN Q.931 communications tasks that are
running in the primary IOP processor.
MISP Service processor time: Total processing unit time (in milliseconds) PD (11,0)
used by the service processor function that is running in the
primary IOP processor.
MIF1ID Subfunction 1 ID: The identifier for additional functions that may be C (2)
running in the primary IOP processor.
MIF1TM Subfunction 1 time: Total processing unit time (in milliseconds) used PD (11,0)
by the IOP function that is running in the primary IOP processor
MIF2ID Subfunction 2 ID: The identifier for additional functions that may be C (2)
running in the primary IOP processor.
MIF2TM Subfunction 2 time: Total processing unit time (in milliseconds) used PD (11,0)
by the IOP function that is running in the primary IOP processor
MIF3ID Subfunction 3 ID: The identifier for additional functions that may be C (2)
running in the primary IOP processor.
MIF3TM Subfunction 3 time: Total processing unit time (in milliseconds) used PD (11,0)
by the IOP function that is running in the primary IOP processor.
MIF4ID Subfunction 4 ID: The identifier for additional functions that may be C(2)
running in the primary IOP processor.

Appendix A. Performance Data 387

 Table 68. Multifunction Controller IOP Data (One for Each Multifunction Controller) (continued)
Field Name Description Attributes
MIF4TM Subfunction 4 time: Total processing unit time (in milliseconds) used PD (11,0)
by the IOP function that is running in the primary IOP processor.
MIF5ID Subfunction 5 ID: The identifier for additional functions that are C(2)
running in the primary IOP processor.
MIF5TM Subfunction 5 time in milliseconds used by the IOP function that is PD (11,0)
running in the primary IOP processor.
MITWNX Total processing unit time (in milliseconds) used by workstation and PD (11,0)
local twinaxial tasks that are running in the primary IOP processor.
| MICPU2 Processor 2 utilization: The utilization (in milliseconds) of the PD (11,0)
| second IOP processor that handles specialized function. This field
| applies to Integrated PC Servers (excluding I/O adapter versions)
| and is zero for other IOPs. Collection Services will not report values
| for Integrated PC Servers.
MIADP Reserved. PD (11,0)
Notes:

The idle loop count and time are used to calculate the multifunction IOP utilization as follows:
1. Convert the product of the idle loop count times the idle loop time from hundredths of microseconds to seconds.
Subtract this from the interval time, and divide the results by the interval time. For example:
IOP utilization = (INTSEC - (MIIDLC * MIIDLT)/10**8)/ INTSEC
2. The performance monitor reports I/O processor (IOP) statistics differently beginning with Version 3 Release 7.
Therefore, performance statistics for IOPs introduced in Version 3 Release 7 or later releases, are reported in the
QAPMMIOP file. Performance statistics are reported in the QAPMMIOP file even if the IOP supports only one of
the three IOP functions (communications, disk, or local workstation). Performance statistics for IOPs that were
introduced before Version 3 Release 7 will continue to be reported in the appropriate IOP file (QAPMCIOP,
QAPMDIOP, QAPMLIOP, or QAPMMIOP).
3. The function 1 – 5 identifiers are for additional functions that may be running in the primary IOP processor. Each
function identifier has an associated function time value. Function identifier may have the following values:
v ‘00–No time value supplied
v §11–Integrated PC Server pipe task (Integrated PC Server is also known as file server I/O processor and
FSIOP.)
v ‘22‘–Tape task
v ‘23‘–Diskette task
v ‘24‘–Optical task
v ‘42‘–Localtalk task
v ‘43‘–Wireless task
| v ‘60‘–Cryptography task

File Name: QAPMDIOP

Storage Device Controller File Entries: Table 69 lists the fields in the storage
device controller file.

Consider the following information when using this table:

v Device means disk.
v The idle loop count and time are used to calculate the storage device controller
IOP utilization as follows:

388 OS/400 Work Management V4R4

 Convert the product of the idle loop count times the idle loop time from
hundredths of microseconds to seconds. Subtract this from the interval time, and
divide the result by the interval time. For example:
IOP utilization =
(INTSEC - (DIIDLC * DIIDLT)/10**8)/
INTSEC

Table 69. Storage Device Controller IOP Data (One for Each Controller)
Field Name Description Attributes
INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
the sample interval.
INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
sample interval.
IOPRN IOP resource name. C (10)
DIIOP Reserved C (1)
DITYPE IOP type. C (4)
DIIDLC Idle loop count: The number of times the disk controller IOP ran an PD (11,0)
idle loop. This is done when the IOP has no work to perform. This
count is used with the idle loop time.
DIIDLT Idle loop time: The time (in hundredths of microseconds) to run the PD (11,0)
idle loop once.
DITPDK Total packets transferred. PD (11,0)
DIKBYO Total KB transmitted from the IOP to the system across the bus. PD (11,0)
DIKBYI Total KB transmitted to the IOP from the system across the bus. PD (11,0)
DIOPSR OPSTART bus unit message received from another bus unit using PD (11,0)
normal flow.
DIOPSS OPSTART bus unit message received from another bus unit using PD (11,0)
reverse flow method 2 (always 0).
DISGLR Signals received. PD (11,0)
DIOPST OPSTARTS sent. PD (11,0)
DISGLS Signals sent. PD (11,0)
DIRSTQ Restart queues sent. PD (11,0)
DIRQDO DMA requests sent for output of data: The number of requests the PD (11,0)
IOP sends to the system for data to be sent from the IOP to the
system across the bus.
DIRQDI DMA requests sent for input of data: The number of requests the PD (11,0)
IOP sends to the system for data to be sent to the IOP from the
system across the bus.
DIBNAR Occurrences of BNA received. PD (11,0)
DIRID0 Reserved C (8)
DISMP0 Reserved PD (11,0)
DIQLN0 Reserved PD (11,0)
DINRQ0 Reserved PD (11,0)
DIRID1 Reserved C (8)
DISMP1 Reserved PD (11,0)
DIQLN1 Reserved PD (11,0)

Appendix A. Performance Data 389

Table 69. Storage Device Controller IOP Data (One for Each Controller) (continued)
Field Name Description Attributes
DINRQ1 Reserved PD (11,0)
DIRID2 Reserved C (8)
DISMP2 Reserved PD (11,0)
DIQLN2 Reserved PD (11,0)
DINRQ2 Reserved PD (11,0)
DIRID3 Reserved C (8)
DISMP3 Reserved PD (11,0)
DIQLN3 Reserved PD (11,0)
DINRQ3 Reserved PD (11,0)
DIRID4 Reserved C (8)
DISMP4 Reserved PD (11,0)
DIQLN4 Reserved PD (11,0)
DINRQ4 Reserved PD (11,0)
DIRID5 Reserved C (8)
DISMP5 Reserved PD (11,0)
DIQLN5 Reserved PD (11,0)
DINRQ5 Reserved PD (11,0)
DIRID6 Reserved C (8)
DISMP6 Reserved PD (11,0)
DIQLN6 Reserved PD (11,0)
DINRQ6 Reserved PD (11,0)
DIRID7 Reserved C (8)
DISMP7 Reserved PD (11,0)
DIQLN7 Reserved PD (11,0)
DINRQ7 Reserved PD (11,0)
DIRID8 Reserved C (8)
DISMP8 Reserved PD (11,0)
DIQLN8 Reserved PD (11,0)
DINRQ8 Reserved PD (11,0)
DIRID9 Reserved C (8)
DISMP9 Reserved PD (11,0)
DIQLN9 Reserved PD (11,0)
DINRQ9 Reserved PD (11,0)
DIRIDA Reserved C (8)
DISMPA Reserved PD (11,0)
DIQLNA Reserved PD (11,0)
DINRQA Reserved PD (11,0)
DIRIDB Reserved C (8)
DISMPB Reserved PD (11,0)
DIQLNB Reserved PD (11,0)

390 OS/400 Work Management V4R4

Table 69. Storage Device Controller IOP Data (One for Each Controller) (continued)
Field Name Description Attributes
DINRQB Reserved PD (11,0)
DIRIDC Reserved C (8)
DISMPC Reserved PD (11,0)
DIQLNC Reserved PD (11,0)
DINRQC Reserved PD (11,0)
DIRIDD Reserved C (8)
DISMPD Reserved PD (11,0)
DIQLND Reserved PD (11,0)
DINRQD Reserved PD (11,0)
DIRIDE Reserved C (8)
DISMPE Reserved PD (11,0)
DIQLNE Reserved PD (11,0)
DINRQE Reserved PD (11,0)
DIRIDF Reserved C (8)
DISMPF Reserved PD (11,0)
DIQLNF Reserved PD (11,0)
DINRQF Reserved PD (11,0)
Note:

The performance monitor reports I/O processor (IOP) statistics differently beginning with Version 3 Release 7.
Therefore, performance statistics for IOPs introduced in Version 3 Release 7 or later releases, are reported in the
QAPMMIOP file. Performance statistics are reported in the QAPMMIOP file even if the IOP supports only one of the
three IOP functions (communications, disk, or local workstation). Performance statistics for IOPs that were introduced
before Version 3 Release 7 will continue to be reported in the appropriate IOP file (QAPMCIOP, QAPMDIOP,
QAPMLIOP, or QAPMMIOP).

File Name: QAPMLIOP

Twinaxial IOP Data File Entries: Table 70 lists the fields in the twinaxial IOP data
file.
Table 70. Twinaxial IOP Data (One for Each Workstation Controller)
Field Name Description Attributes
INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
the sample interval.
INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
sample interval.
IOPRN IOP resource name. C(10)
LIIOP Reserved C (1)
LITYPE IOP type. C (4)
LIRIDC Resource ID of controller: Field cannot be displayed. C (8)
LITPKT Total packets transferred. PD (11,0)
LIKBYO Total KB transmitted from the IOP to the system across the bus. PD (11,0)

Appendix A. Performance Data 391

Table 70. Twinaxial IOP Data (One for Each Workstation Controller) (continued)
Field Name Description Attributes
LIKBYI Total KB transmitted to the IOP from the system across the bus. PD (11,0)
LIOPSR OPSTART bus unit message received from another bus unit using PD (11,0)
normal flow.
LIOPSS OPSTART bus unit message received from another bus unit using PD (11,0)
reverse flow method 2.
LISGLR Signal bus unit message received from another bus unit. PD (11,0)
LIOPST OPSTARTS sent to another bus unit using reverse flow method 2. PD (11,0)
LISGLS Signals sent to another bus unit. PD (11,0)
LIRSTQ Restart queues bus unit message sent to another bus unit. PD (11,0)
LIRQDO DMA requests sent for output of data: The number of requests the PD (11,0)
IOP sends to the system for data to be sent from the IOP to the
system across the bus.
LIRQDI DMA requests sent for input of data: The number of requests the PD (11,0)
IOP sends to the system for data to be sent to the IOP from the
system across the bus.
LIBNAR Occurrences of BNA received. PD (11,0)
LIIOQC Wait-on-I/O queue count: The number of I/O requests on the PD (11,0)
wait-on-I/O queue at sample time. The wait-on-I/O queue holds I/O
requests that are being processed or waiting to be processed.
LISQC Suspend queue count: The number of elements on the suspend PD (11,0)
queue at sample time.
LIAQC Active queue count: The number of elements on the active queue at PD (11,0)
sample time. The active queue holds I/O requests that were sent
from the host system and were not yet sent to the wait-on-I/O
queue.
LITWIU Twinaxial use count: The number of times when the wait-on-I/O PD (5,0)
queue was sampled and the count was not zero (I/O in progress). If
this value is divided by the sample count, the result (times 100) is
the percentage of time when I/O is occurring.
LISMPL Sample count: The number of times during the snapshot interval PD (5,0)
that the various IOP queues were sampled.
LIIDLC Idle counts (see Note): The number of times the workstation IOP ran PD (11,0)
an idle loop. This is done when the IOP has no work to perform.
This count is used with the idle loop time.
LIIDLT Idle loop time (times 0.01 microsecond): The time (in hundredths of PD (11,0)
microseconds) to run the idle loop once (see Note).
Notes:

The idle loop count and time are used to calculate the workstation IOP utilization as follows:
1. Convert the product of the idle loop count times the idle loop time from hundredths of microseconds to seconds.
Subtract this from the interval time, and divide the result by the interval time. For example:
IOP utilization = (INTSEC - (LIIDLC * LIIDLT)/10**8)/ INTSEC
2. The performance monitor reports I/O processor (IOP) statistics differently beginning with Version 3 Release 7.
Therefore, performance statistics for IOPs introduced in Version 3 Release 7 or later releases, are reported in the
QAPMMIOP file. Performance statistics are reported in the QAPMMIOP file even if the IOP supports only one of
the three IOP functions (communications, disk, or local workstation). Performance statistics for IOPs that were
introduced before Version 3 Release 7 will continue to be reported in the appropriate IOP file (QAPMCIOP,
QAPMDIOP, QAPMLIOP, or QAPMMIOP).

392 OS/400 Work Management V4R4

 File Name: QAPMRESP
Local Workstation Response Time File Entries: Table 71 contains transaction
information based on data collected within the local WS controller.
Table 71. Local Workstation Response Time (One for Each Station)
Field Name Description Attributes
INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
the sample interval.
INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
sample interval.
IOPRN IOP resource name C(10)
LRIOP Reserved C (1)
LRBKT1 Transactions in first response time monitor bracket: The number of PD (7,0)
transactions from 0 up to and including n seconds for this
workstation during the snapshot interval. The n value is the
response time monitor 1 bracket upper limit, and is specified when
the performance monitor is started by the STRPFRMON command.
A transaction is defined as the time from when the keyboard locked
because the Enter key or a function key was pressed to the time
when the keyboard unlocked because the display was refreshed.
LRBKT2 Transactions in second response time monitor bracket: The number PD (7,0)
of transactions greater than the response time monitor 1 and up to
and including response time monitor 2 limits.
LRBKT3 Transactions in third response time monitor bracket: The number of PD (7,0)
transactions greater than the response time monitor 2 and up to and
including response time monitor 3 limits.
LRBKT4 Transactions in fourth response time monitor bracket: The number of PD (7,0)
transactions greater than the response time monitor 3 and up to and
including response time monitor 4 limits.
LRBKT5 Transactions in fifth response time monitor bracket: The number of PD (7,0)
transactions above (longer) than the response time monitor 4 limit.
LRPORT Workstation port number. PD (3,0)
LRSTN Workstation number. PD (3,0)
LRTRNS The total of all the individual times for all exchanges measured and PD (7,0)
reported by this record including overflows (LRBKT5). The total time
in seconds for all transactions.
LRCUD Controller Description name. C (10)

File Name: QAPMRWS

Remote Workstation Response Time File Entries: Table 72 contains transaction
information based on data collected within the remote workstation controller.
Table 72. Remote Workstation Response Time (One for Each Station)
Field Name Description Attributes
INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
the sample interval.

Appendix A. Performance Data 393

Table 72. Remote Workstation Response Time (One for Each Station) (continued)
Field Name Description Attributes
INTSEC Elapsed interval seconds: The number of seconds during which PD (7,0)
these transactions occurred.
IOPRN IOP resource name. C (10)
RWIOP Reserved C (1)
RWBKT1 Transactions in first response time monitor bracket: The number of PD (7,0)
transactions greater than 0 up to and including n seconds for this
workstation during the snapshot interval. The n value is the upper
limit for the first response time monitor bracket, and is specified
when the performance monitor is started by the STRPFRMON
command. A transaction is defined as the time from when the
keyboard locked because the Enter key or a function key was
pressed to the time the keyboard is unlocked because the display
was refreshed.
RWBKT2 Transactions in second response time monitor bracket: The number PD (7,0)
of transactions greater than the response time monitor 1 and up to
and including response time monitor 2 limits.
RWBKT3 Transactions in third response time monitor bracket: The number of PD (7,0)
transactions greater than the response time monitor 2 and up to and
including the response time monitor 3 limits.
RWBKT4 Transactions in fourth response time monitor bracket: The number of PD (7,0)
transactions greater than the response time monitor 3 and up to and
including the response time monitor 4 limits.
RWBKT5 Transactions in fifth response time monitor bracket: The number of PD (7,0)
transactions longer than the limit for the response time monitor 4.
RWTRNS The total of all the individual times for all exchanges measured and PD (7,0)
reported by this record including overflows (RWBKT5). The total
time in seconds for all transactions.
RWPORT Workstation port number. PD (3,0)
RWSTN Workstation number for this port. PD (3,0)
RWCUD Controller description: The name of the controller this workstation is C (10)
attached to.
RWLND Line description: Name of the communications line this workstation C (10)
and its controller are attached to.

File Name: QAPMSNA

SNA data: Table 73 lists the fields in the systems network architecture (SNA) file.
Table 73. SNA Data (One for Each Active T2 Task)
Field Name Description Attributes
INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
the sample interval.
INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
sample interval.
SCTLNM Controller description name. C (10)
SLINNM Line description name. C (10)
STSKNM T2 station I/O manager (SIOM) task name. C (6)

394 OS/400 Work Management V4R4

Table 73. SNA Data (One for Each Active T2 Task) (continued)
Field Name Description Attributes
SLIOMT Line I/O manager task name. C (6)
SACPNM Adjacent control point (CP) name. C (8)
SANWID Adjacent network ID. C (8)
SAPPN APPN-capable (Y=yes, N=no). C (1)
SCTYP Controller type (A=APPC, H=Host). C (1)
SSMFS Send maximum frame size. PD (11,0)
SRMFS Receive maximum frame size. PD (11,0)
STLLBU Date (yy/mm/dd) and time(hh:mm:ss) when most recent connection C (12)
was established with the adjacent system.
SNLBU Number of times a connection has been established with the remote PD (11,0)
system.
STACVO Cumulative elapsed time for automatically created and/or varied-on PD (11,0)
devices.
SNACVO Number of automatically created and/or varied-on devices. PD (11,0)
SNADD Number of automatically deleted devices. PD (11,0)
SNWAIN Number of work activities coming in from other T2 SIOM tasks (for PD (11,0)
example, messages received).
SNWAOU Number of work activities sent out to other T2 SIOM tasks (for PD (11,0)
example, messages received).
The following fields refer to end point sessions attributes.
ENNSS Number of network priority sessions started. PD (11,0)
ENNSE Number of network priority sessions ended. PD (11,0)
ENNBB Number of request units with begin bracket sent and received for all PD (11,0)
network priority sessions.
ENNEB Number of request units with end bracket sent and received for all PD (11,0)
network priority sessions.
ENSPWT The cumulative wait time for all network priority sessions (in PD (11,0)
milliseconds) caused by session-level send messages. This wait
time measures the amount of time application data was blocked
(could not be sent) waiting for a pacing response to be received
from the adjacent system.
ENSPNW Number of waits occurring for all network priority sessions for PD (11,0)
session-level send pacing. That is, the number of times application
data was blocked (could not be sent) waiting for a pacing response
to be received from the adjacent system.
ENSPPW Number of potential waits occurring for all network priority sessions PD (11,0)
for session-level send pacing. This is the worst case that would
occur if the sending of application data was delayed waiting for
every pacing response sent by the adjacent system.
ENSPWS The cumulative window size for all network priority sessions for PD (11,0)
session-level send pacing. Each time a pacing response is received
from the adjacent system on a network priority session, this count is
increased by window size specified by the pacing response.
ENIPWT The cumulative wait time for all network priority sessions (in PD (11,0)
milliseconds) for internal session-level pacing. That is, the number of
times application data was blocked (could not be sent) waiting for
data to be delivered to the adjacent system.

Appendix A. Performance Data 395

Table 73. SNA Data (One for Each Active T2 Task) (continued)
Field Name Description Attributes
ENIPNW Number of waits occurring for all network priority sessions for PD (11,0)
internal session-level pacing. That is, the number of times
application data was blocked (could not be sent) waiting for data to
be delivered to the adjacent system.
ENQNRE Number of network priority request/response units entering the PD (11,0)
transmission priority queue.
ENQLRE Length of network priority request/response units entering the PD (11,0)
transmission priority queue.
ENQNRL Number of network priority request/response units leaving the PD (11,0)
transmission priority queue.
ENQLRL Length of network priority request/response units leaving the PD (11,0)
transmission priority queue.
ENQTRR Cumulative wait time in network transmission priority queue. PD (11,0)
ENNRUD Number of network priority request/response units delivered to the PD (11,0)
adjacent system.
ENLRUD Length of network priority request/response units delivered to the PD (11,0)
adjacent system.
ENTRUD Cumulative service time to deliver a network priority PD (11,0)
request/response unit to the adjacent system.
ENNRUR Number of network priority request/response units received from the PD (11,0)
adjacent system.
ENLRUR Length of network priority request/response units received from the PD (11,0)
adjacent system.
EHNSS Number of high priority sessions started PD (11,0)
EHNSE Number of high priority sessions ended PD (11,0)
EHNBB Number of request units with begin bracket sent and received for all PD (11,0)
high priority sessions
EHNEB Number of request units with end bracket sent and received for all PD (11,0)
high priority sessions
EHSPWT The cumulative wait time for all high priority sessions (in PD (11,0)
milliseconds) caused by session-level send messages. This wait
time measures the amount of time application data was blocked
(could not be sent) waiting for a pacing response to be received
from the adjacent system.
EHSPNW Number of waits occurring for all high priority sessions for PD (11,0)
session-level send pacing. That is, the number of times application
data was blocked (could not be sent) waiting for a pacing response
to be received from the adjacent system.
EHSPPW Number of potential waits occurring for all high priority sessions for PD (11,0)
session-level send pacing. This is the worst case that would occur if
the sending of application data was delayed waiting for every pacing
response sent by the adjacent system.
EHSPWS The cumulative window size for all high priority sessions for PD (11,0)
session-level send pacing. Each time a pacing response is received
from the adjacent system on a network priority session, this count is
increased by window size specified by the pacing response.

396 OS/400 Work Management V4R4

Table 73. SNA Data (One for Each Active T2 Task) (continued)
Field Name Description Attributes
EHIPWT The cumulative wait time for all high priority sessions (in PD (11,0)
milliseconds) for internal session-level pacing. That is, the number of
times application data was blocked (could not be sent) waiting for
data to be delivered to the adjacent system.
EHIPNW Number of waits occurring for all high priority sessions for internal PD (11,0)
session-level pacing. That is, the number of times application data
was blocked (could not be sent) waiting for data to be delivered to
the adjacent system.
EHQNRE Number of high priority request/response units entering the PD (11,0)
transmission priority queue.
EHQLRE Length of high priority request/response units entering the PD (11,0)
transmission priority queue.
EHQNRL Number of high priority request/response units leaving the PD (11,0)
transmission priority queue.
EHQLRL Length of high priority request/response units leaving the PD (11,0)
transmission priority queue.
EHQTRR Cumulative wait time in high transmission priority queue. PD (11,0)
EHNRUD Number of high priority request/response units delivered to the PD (11,0)
adjacent system.
EHLRUD Length of high priority request/response units delivered to the PD (11,0)
adjacent system.
EHTRUD Cumulative service time to deliver a high priority request/response PD (11,0)
unit to the adjacent system.
EHNRUR Number of high priority request/response units received from the PD (11,0)
adjacent system.
EHLRUR Length of high priority request/response units received from the PD (11,0)
adjacent system.
EMNSS Number of medium priority sessions started PD (11,0)
EMNSE Number of medium priority sessions ended PD (11,0)
EMNBB Number of request units with begin bracket sent and received for all PD (11,0)
medium priority sessions
EMNEB Number of request units with end bracket sent and received for all PD (11,0)
medium priority sessions
EMSPWT The cumulative wait time for all medium priority sessions (in PD (11,0)
milliseconds) caused by session-level send messages. This wait
time measures the amount of time application data was blocked
(could not be sent) waiting for a pacing response to be received
from the adjacent system
EMSPNW Number of waits occurring for all medium priority sessions for PD (11,0)
session-level send pacing. That is, the number of times application
data was blocked (could not be sent) waiting for a pacing response
to be received from the adjacent system
EMSPPW Number of potential waits occurring for all medium priority sessions PD (11,0)
for session-level send pacing. This is the worst case that would
occur if the sending of application data was delayed waiting for
every pacing response sent by the adjacent system.

Appendix A. Performance Data 397

Table 73. SNA Data (One for Each Active T2 Task) (continued)
Field Name Description Attributes
EMSPWS The cumulative window size for all medium priority sessions for PD (11,0)
session-level send pacing. Each time a pacing response is received
from the adjacent system on a network priority session, this count is
increased by window size specified by the pacing response
EMIPWT The cumulative wait time for all medium priority sessions (in PD (11,0)
milliseconds) for internal session-level pacing. That is, the number of
times application data was blocked (could not be sent) waiting for
data to be delivered to the adjacent system.
EMIPNW Number of waits occurring for all medium priority sessions for PD (11,0)
internal session-level pacing. That is, the number of times
application data was blocked (could not be sent) waiting for data to
be delivered to the adjacent system.
EMQNRE Number of medium priority request/response units entering the PD (11,0)
transmission priority queue.
EMQLRE Length of medium priority request/response units entering the PD (11,0)
transmission priority queue.
EMQNRL Number of medium priority request/response units leaving the PD (11,0)
transmission priority queue.
EMQLRL Length of medium priority request/response units leaving the PD (11,0)
transmission priority queue.
EMQTRR Cumulative wait time in medium transmission priority queue. PD (11,0)
EMNRUD Number of medium priority request/response units delivered to the PD (11,0)
adjacent system.
EMLRUD Length of medium priority request/response units delivered to the PD (11,0)
adjacent system.
EMTRUD Cumulative service time to deliver a medium priority PD (11,0)
request/response unit to the adjacent system.
EMNRUR Number of medium priority request/response units received from the PD (11,0)
adjacent system.
EMLRUR Length of medium priority request/response units received from the PD (11,0)
adjacent system.
ELNSS Number of low priority sessions started PD (11,0)
ELNSE Number of low priority sessions ended PD (11,0)
ELNBB Number of request units with begin bracket sent and received for all PD (11,0)
low priority sessions
ELNEB Number of request units with end bracket sent and received for all PD (11,0)
low priority sessions
ELSPWT The cumulative wait time for all low priority sessions (in PD (11,0)
milliseconds) caused by session-level send messages. This wait
time measures the amount of time application data was blocked
(could not be sent) waiting for a pacing response to be received
from the adjacent system
ELSPNW Number of waits occurring for all low priority sessions for PD (11,0)
session-level send pacing. That is, the number of times application
data was blocked (could not be sent) waiting for a pacing response
to be received from the adjacent system

398 OS/400 Work Management V4R4

Table 73. SNA Data (One for Each Active T2 Task) (continued)
Field Name Description Attributes
ELSPPW Number of potential waits occurring for all low priority sessions for PD (11,0)
session-level send pacing. This is the worst case that would occur if
the sending of application data was delayed waiting for every pacing
response sent by the adjacent system.
ELSPWS The cumulative window size for all low priority sessions for PD (11,0)
session-level send pacing. Each time a pacing response is received
from the adjacent system on a network priority session, this count is
increased by window size specified by the pacing response
ELIPWT The cumulative wait time for all low priority sessions (in PD (11,0)
milliseconds) for internal session-level pacing. That is, the number of
times application data was blocked (could not be sent) waiting for
data to be delivered to the adjacent system.
ELIPNW Number of waits occurring for all low priority sessions for internal PD (11,0)
session-level pacing. That is, the number of times application data
was blocked (could not be sent) waiting for data to be delivered to
the adjacent system.
ELQNRE Number of low priority request/response units entering the PD (11,0)
transmission priority queue.
ELQLRE Length of low priority request/response units entering the PD (11,0)
transmission priority queue.
ELQNRL Number of low priority request/response units leaving the PD (11,0)
transmission priority queue.
ELQLRL Length of low priority request/response units leaving the PD (11,0)
transmission priority queue.
ELQTRR Cumulative wait time in low transmission priority queue. PD (11,0)
ELNRUD Number of low priority request/response units delivered to the PD (11,0)
adjacent system.
ELLRUD Length of low priority request/response units delivered to the PD (11,0)
adjacent system.
ELTRUD Cumulative service time to deliver a low priority request/response PD (11,0)
unit to the adjacent system.
ELNRUR Number of low priority request/response units received from the PD (11,0)
adjacent system.
ELLRUR Length of low priority request/response units received from the PD (11,0)
adjacent system.
The following fields refer to intermediate sessions.
INNSS Number of network priority sessions started PD (11,0)
INNSE Number of network priority sessions ended PD (11,0)
INNBB Number of request units with begin bracket sent and received for all PD (11,0)
network priority sessions
INNEB Number of request units with end bracket sent and received for all PD (11,0)
network priority sessions
INSPWT The cumulative wait time for all network priority sessions (in PD (11,0)
milliseconds) caused by session-level send messages. This wait
time measures the amount of time application data was blocked
(could not be sent) waiting for a pacing response to be received
from the adjacent system

Appendix A. Performance Data 399

Table 73. SNA Data (One for Each Active T2 Task) (continued)
Field Name Description Attributes
INSPNW Number of waits occurring for all network priority sessions for PD (11,0)
session-level send pacing. That is, the number of times application
data was blocked (could not be sent) waiting for a pacing response
to be received from the adjacent system
INSPPW Number of potential waits occurring for all network priority sessions PD (11,0)
for session-level send pacing. This is the worst case that would
occur if the sending of application data was delayed waiting for
every pacing response sent by the adjacent system.
INSPWS The cumulative window size for all network priority sessions for PD (11,0)
session-level send pacing. Each time a pacing response is received
from the adjacent system on a network priority session, this count is
increased by window size specified by the pacing response.
INIPWT The cumulative wait time for all network priority sessions (in PD (11,0)
milliseconds) for internal session-level pacing. That is, the number of
times application data was blocked (could not be sent) waiting for
data to be delivered to the adjacent system.
INIPNW Number of waits occurring for all network priority sessions for PD (11,0)
internal session-level pacing. That is, the number of times
application data was blocked (could not be sent) waiting for data to
be delivered to the adjacent system.
INQNRE Number of network priority request/response units entering the PD (11,0)
transmission priority queue.
INQLRE Length of network priority request/response units entering the PD (11,0)
transmission priority queue.
INQNRL Number of network priority request/response units leaving the PD (11,0)
transmission priority queue.
INQLRL Length of network priority request/response units leaving the PD (11,0)
transmission priority queue.
INQTRR Cumulative wait time in network transmission priority queue. PD (11,0)
INNRUD Number of network priority request/response units delivered to the PD (11,0)
adjacent system.
INLRUD Length of network priority request/response units delivered to the PD (11,0)
adjacent system.
INTRUD Cumulative service time to deliver a network priority PD (11,0)
request/response unit to the adjacent system.
INNRUR Number of network priority request/response units received from the PD (11,0)
adjacent system.
INLRUR Length of network priority request/response units received from the PD (11,0)
adjacent system.
IHNSS Number of high priority sessions started. PD (11,0)
IHNSE Number of high priority sessions ended. PD (11,0)
IHNBB Number of request units with begin bracket sent and received for all PD (11,0)
high priority sessions.
IHNEB Number of request units with end bracket sent and received for all PD (11,0)
high priority sessions.

400 OS/400 Work Management V4R4

Table 73. SNA Data (One for Each Active T2 Task) (continued)
Field Name Description Attributes
IHSPWT The cumulative wait time for all high priority sessions (in PD (11,0)
milliseconds) caused by session-level send messages. This wait
time measures the amount of time application data was blocked
(could not be sent) waiting for a pacing response to be received
from the adjacent system.
IHSPNW Number of waits occurring for all high priority sessions for PD (11,0)
session-level send pacing. That is, the number of times application
data was blocked (could not be sent) waiting for a pacing response
to be received from the adjacent system.
IHSPPW Number of potential waits occurring for all high priority sessions for PD (11,0)
session-level send pacing. This is the worst case that would occur if
the sending of application data was delayed waiting for every pacing
response sent by the adjacent system.
IHSPWS The cumulative window size for all high priority sessions for PD (11,0)
session-level send pacing. Each time a pacing response is received
from the adjacent system on a network priority session, this count is
increased by window size specified by the pacing response.
IHIPWT The cumulative wait time for all high priority sessions (in PD (11,0)
milliseconds) for internal session-level pacing. That is, the number of
times application data was blocked (could not be sent) waiting for
data to be delivered to the adjacent system.
IHIPNW Number of waits occurring for all high priority sessions for internal PD (11,0)
session-level pacing. That is, the number of times application data
was blocked (could not be sent) waiting for data to be delivered to
the adjacent system.
IHQNRE Number of high priority request/response units entering the PD (11,0)
transmission priority queue.
IHQLRE Length of high priority request/response units entering the PD (11,0)
transmission priority queue.
IHQNRL Number of high priority request/response units leaving the PD (11,0)
transmission priority queue.
IHQLRL Length of high priority request/response units leaving the PD (11,0)
transmission priority queue.
IHQTRR Cumulative wait time in high transmission priority queue. PD (11,0)
IHNRUD Number of high priority request/response units delivered to the PD (11,0)
adjacent system.
IHLRUD Length of high priority request/response units delivered to the PD (11,0)
adjacent system.
IHTRUD Cumulative service time to deliver a high priority request/response PD (11,0)
unit to the adjacent system.
IHNRUR Number of high priority request/response units received from the PD (11,0)
adjacent system.
IHLRUR Length of high priority request/response units received from the PD (11,0)
adjacent system.
IMNSS Number of medium priority sessions started. PD (11,0)
IMNSE Number of medium priority sessions ended. PD (11,0)
IMNBB Number of request units with begin bracket sent and received for all PD (11,0)
medium priority sessions.

Appendix A. Performance Data 401

Table 73. SNA Data (One for Each Active T2 Task) (continued)
Field Name Description Attributes
IMNEB Number of request units with end bracket sent and received for all PD (11,0)
medium priority sessions.
IMSPWT The cumulative wait time for all medium priority sessions (in PD (11,0)
milliseconds) caused by session-level send messages. This wait
time measures the amount of time application data was blocked
(could not be sent) waiting for a pacing response to be received
from the adjacent system.
IMSPNW Number of waits occurring for all medium priority sessions for PD (11,0)
session-level send pacing. That is, the number of times application
data was blocked (could not be sent) waiting for a pacing response
to be received from the adjacent system.
IMSPPW Number of potential waits occurring for all medium priority sessions PD (11,0)
for session-level send pacing. This is the worst case that would
occur if the sending of application data was delayed waiting for
every pacing response sent by the adjacent system.
IMSPWS The cumulative window size for all medium priority sessions for PD (11,0)
session-level send pacing. Each time a pacing response is received
from the adjacent system on a network priority session, this count is
increased by window size specified by the pacing response.
IMIPWT The cumulative wait time for all medium priority sessions (in PD (11,0)
milliseconds) for internal session-level pacing. That is, the number of
times application data was blocked (could not be sent) waiting for
data to be delivered to the adjacent system.
IMIPNW Number of waits occurring for all medium priority sessions for PD (11,0)
internal session-level pacing. That is, the number of times
application data was blocked (could not be sent) waiting for data to
be delivered to the adjacent system.
IMQNRE Number of medium priority request/response units entering the PD (11,0)
transmission priority queue.
IMQLRE Length of medium priority request/response units entering the PD (11,0)
transmission priority queue.
IMQNRL Number of medium priority request/response units leaving the PD (11,0)
transmission priority queue.
IMQLRL Length of medium priority request/response units leaving the PD (11,0)
transmission priority queue.
IMQTRR Cumulative wait time in medium transmission priority queue. PD (11,0)
IMNRUD Number of medium priority request/response units delivered to the PD (11,0)
adjacent system.
IMLRUD Length of medium priority request/response units delivered to the PD (11,0)
adjacent system.
IMTRUD Cumulative service time to deliver a medium priority PD (11,0)
request/response unit to the adjacent system.
IMNRUR Number of medium priority request/response units received from the PD (11,0)
adjacent system.
IMLRUR Length of medium priority request/response units received from the PD (11,0)
adjacent system.
ILNSS Number of low priority sessions started. PD (11,0)
ILNSE Number of low priority sessions ended. PD (11,0)

402 OS/400 Work Management V4R4

Table 73. SNA Data (One for Each Active T2 Task) (continued)
Field Name Description Attributes
ILNBB Number of request units with begin bracket sent and received for all PD (11,0)
low priority sessions.
ILNEB Number of request units with end bracket sent and received for all PD (11,0)
low priority sessions.
ILSPWT The cumulative wait time for all low priority sessions (in PD (11,0)
milliseconds) caused by session-level send messages. This wait
time measures the amount of time application data was blocked
(could not be sent) waiting for a pacing response to be received
from the adjacent system.
ILSPNW Number of waits occurring for all low priority sessions for PD (11,0)
session-level send pacing. That is, the number of times application
data was blocked (could not be sent) waiting for a pacing response
to be received from the adjacent system.
ILSPPW Number of potential waits occurring for all low priority sessions for PD (11,0)
session-level send pacing. This is the worst case that would occur if
the sending of application data was delayed waiting for every pacing
response sent by the adjacent system.
ILSPWS The cumulative window size for all low priority sessions for PD (11,0)
session-level send pacing. Each time a pacing response is received
from the adjacent system on a network priority session, this count is
increased by window size specified by the pacing response.
ILIPWT The cumulative wait time for all low priority sessions (in PD (11,0)
milliseconds) for internal session-level pacing. That is, the number of
times application data was blocked (could not be sent) waiting for
data to be delivered to the adjacent system.
ILIPNW Number of waits occurring for all low priority sessions for internal PD (11,0)
session-level pacing. That is, the number of times application data
was blocked (could not be sent) waiting for data to be delivered to
the adjacent system.
ILQNRE Number of low priority request/response units entering the PD (11,0)
transmission priority queue.
ILQLRE Length of low priority request/response units entering the PD (11,0)
transmission priority queue.
ILQNRL Number of low priority request/response units leaving the PD (11,0)
transmission priority queue.
ILQLRL Length of low priority request/response units leaving the PD (11,0)
transmission priority queue.
ILQTRR Cumulative wait time in low transmission priority queue. PD (11,0)
ILNRUD Number of low priority request/response units delivered to the
adjacent system. PD (11,0)
ILLRUD Length of low priority request/response units delivered to the PD (11,0)
adjacent system.
ILTRUD Cumulative service time to deliver a low priority request/response PD (11,0)
unit to the adjacent system.
ILNRUR Number of low priority request/response units received from the PD (11,0)
adjacent system.
ILLRUR Length of low priority request/response units received from the PD (11,0)
adjacent system.

Appendix A. Performance Data 403

 File Name: QAPMSNADS
SNADS Data: Table 74 lists the fields in the SNA distribution services (SNADS)
file.
Table 74. SNADS Data (One Entry Per SNADS Job)
Field Name Description Attributes
INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
the sample interval.
INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
sample interval.
SNJNAM SNADS job name. C(10)
SNJUSR SNADS job user. C(10)
SNJNBR SNADS job number. C(6)
SNFTYP This is a SNADS function type indicating which SNADS function this PD(3,0)
job is running (see note 1).
SNNTR Transaction count. PD(11,0)
SNTRT Transaction time: The time from a distribution being put on the PD(11,0)
queue to the time processing that distribution within this job is
completed.
SNRUT Resource usage time: The total time that distributions are PD(11,0)
processed, not including time that they are waiting on the queue.
SNATN Active transitions: The number of transitions between waiting for PD(11,0)
conditions to be satisfied (a distribution to process) and starting to
process a distribution.
SNERR Error count: Number of transactions that ended in error. PD(11,0)
SNNRC Number of recipients: The number of recipients identified in the PD(11,0)
distribution.
SNFSO File server object (FSO) count: The number of transactions that PD(11,0)
required a data object or document to be processed.
SNFSOB FSO byte count: The size of the FSOs (data objects and PD (11,0)
documents) processed by transactions.
SNFOC Fan-out count: The accumulated value of the number of distribution PD (11,0)
queues that received a copy of a distribution during routing. For a
single distribution processed by the router, this value is the number
of sender transactions (paths) the distribution will take leaving the
system. This is the number of distribution copies that leave the
system. (This field is only supported by the router job.)
SNLDC Set to ’1’ when a local delivery queue received a copy of the PD(11,0)
distribution during routing. This indicates that the local system was a
destination for the distribution. (This field is only supported by the
router job.)

404 OS/400 Work Management V4R4

Table 74. SNADS Data (One Entry Per SNADS Job) (continued)
Field Name Description Attributes
Note:

The SNFTYP field is used to determine the type of activity that this SNADS job conducts.
SNFTYP = 1 for SNADS router
SNFTYP = 2 for SNADS receiver
SNFTYP = 3 for SNADS sender
SNFTYP = 8 for SNADS DLS Gate (Document Library Services)
SNFTYP = 9 for SNADS RPDS Gate (VM/MVS bridge, SMTP, X.400)

File Name: QAPMAPPN

T2 task data: Table 75 lists the fields in the Advanced Peer-to-Peer Network
(APPN) data file.
Table 75. APPN Data (One Entry per Interval)
Field Name Description Attributes
INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): The date and time of C (12)
the sample interval.
INTSEC Elapsed interval seconds: The number of seconds since the last PD (7,0)
sample interval.
ANTGU Total number of transmission group (TG) updates processed PD(11,0)
ATTGU Cumulative time (in milliseconds) to process the TG updates PD(11,0)
ANTGUM Number of TG updates that require one or more resources to be PD(11,0)
added to the topology database update (TDU) buffer
ANRATG Number of resources added to TDU buffers due to TG update PD(11,0)
processing
ANTSTG Number of TDUs sent as a result of initially creating a TDU buffer on PD(11,0)
behalf of TG updates
ANNTTG Number of network nodes that had TDUs sent to them due to TDUs PD(11,0)
being created for TG update processing
ANNCTC Total number of node congestion transition changes processed PD(11,0)
ATNCTC Cumulative elapsed time for processing congestion transition PD(11,0)
changes
ATRSNC Number of times that topology routing services (TRS) entered into PD (11,0)
non-congested state
ATRSC Number of times that TRS entered into congested state PD (11,0)
ATNCS Cumulative elapsed time (in milliseconds) that the system was in PD(11,0)
non-congested state
ATCS Cumulative elapsed time (in milliseconds) that the system was in PD (11,0)
congested state
ATSCP Number of TDUs sent as a result of initially creating a TDU buffer on PD (11,0)
behalf of node congestion processing
ANTSCP Number of network nodes that had TDUs sent to them due to TDUs PD (11,0)
being created for node congestion processing
ANTDUP Total number of received TDUs processed by this node PD (11,0)
ATTDUP Cumulative elapsed time for processing the received TDUs PD (11,0)

Appendix A. Performance Data 405

Table 75. APPN Data (One Entry per Interval) (continued)
Field Name Description Attributes
ANNRTD Number of new resources received in TDUs that cause resources to PD (11,0)
be added to the TDU buffer
ANORTN Number of old resources received in TDUs that do not require a PD (11,0)
resource to be added to the TDU buffer
ANORTA Number of old resources received in TDUs that do require resources PD (11,0)
to be added to the TDU buffer
ANTSRT Number of TDUs sent as a result of initially creating a TDU buffer on PD (11,0)
behalf of processing a received TDU
ANNTST Number of network nodes that had TDUs sent to them due to TDUs PD (11,0)
being created for processing received TDUs
ACNTID Network ID of the node that received the most TDUs within the C (8)
interval
ACCPNM Control point (CP) name of the node that received the most TDUs C (8)
within the interval
ANTRFN Number of TDUs received this interval by the node that received the PD (11,0)
most TDUs in the interval
ANITEP Total number of initial topology exchanges processed by this node PD (11,0)
ATPIE Cumulative elapsed time for processing the initial exchange PD (11,0)
ANTECT Number of times the initial topology exchange caused the complete PD (11,0)
network node topology to be sent
ANTDE Total number of entries in the entire topology database (this value is PD (11,0)
not a delta)
ANTERS Number of resources (nodes and TGs) added to the TDU buffer due PD (11,0)
to initial topology exchange
ANTETS Number of TDUs sent as a result of initial topology exchange PD (11,0)
ANGCP Number of times that obsolete topology entries were removed PD (11,0)
ATGCP Cumulative elapsed time for removing the obsolete topology entries PD (11,0)
ANTEDG Number of topology entries that were deleted PD (11,0)
ANTGC Number of TDUs that were sent when obsolete topology entries PD (11,0)
were deleted
ANNTGC Number of network nodes that had TDUs sent to them when PD (11,0)
obsolete topology entries were removed
ANRRP Total number of registration requests processed PD (11,0)
ANNLRR Total number of locations processed via the registration requests PD (11,0)
ATPRR Cumulative elapsed time to process registration requests PD (11,0)
ANDRP Total number of deletion requests processed PD (11,0)
ANLDDR Total number of locations deleted via the deletion requests PD (11,0)
ATPDR Cumulative elapsed time to process the deletion requests PD (11,0)
ANCNAP Total number of requests to change network attributes processed PD (11,0)
ATCNA Cumulative elapsed time to process the requests to change network PD (11,0)
attributes
ANDDRC Number of times the directory database was deleted and re-created PD (11,0)
due to processing the requests to change network attributes
ANLRSC Number of location registration requests sent due to processing the PD (11,0)
requests to change network attributes

406 OS/400 Work Management V4R4

Table 75. APPN Data (One Entry per Interval) (continued)
Field Name Description Attributes
ANLDSC Number of location deletion requests sent due to processing the PD (11,0)
requests to change network attributes
ANTDRC Number of times the topology database was deleted and re-created PD (11,0)
due to processing the requests to change network attributes
ANCART Number of time the requests to change network attributes caused a PD (11,0)
node entry resource to be added to the TDU buffer
ANTSTC Number of TDUs sent as a result of initially creating a TDU buffer on PD (11,0)
behalf of requests to change network attributes
ANNTSC Number of network nodes that had TDUs sent to them due to TDUs PD (11,0)
being created for processing requests to change network attributes
ANDAII Number of times APPN information was displayed (DSPAPPNINF PD (11,0)
command)
ANLLUP Total number of local location list updates processed PD (11,0)
ATLLUP Cumulative elapsed time to process the local location list updates PD (11,0)
ANLRSL Number of location registration requests sent due to local location PD (11,0)
list updates
ANLDLL Number of location deletion requests sent due to local location list PD (11,0)
updates
ANRLUP Total number of remote location list updates processed PD (11,0)
ATRLUP Cumulative elapsed time to process the remote location list updates PD (11,0)
ANMDUP Total number of mode description updates processed by APPN PD (11,0)
ATMDUP Cumulative elapsed time to process the mode description updates PD (11,0)
ANCSUP Total number of class-of-service updates processed by APPN PD (11,0)
ATCSUT Cumulative elapsed time to process the class-of-service (COS) PD (11,0)
update by TRS
ATCSUC Cumulative elapsed time to process the COS update by the CPMGR PD (11,0)
task
ANCSSA Number of contention CP-CP session setups attempted PD (11,0)
ANCSSS Number of contention CP-CP session setups successful PD (11,0)
ANRRS Total number of registration requests sent PD (11,0)
ANLRRR Total number of locations registered via the registration requests PD (11,0)
ATSRR Cumulative elapsed time to send the registration requests PD (11,0)
ANSTC Number of single-hop route requests made to TRS for contention PD (11,0)
CP session setup
ANSTCS Number of single-hop route requests made to topology routing PD (11,0)
services (TRS) for contention CP session setup that were successful
ATSTCS Cumulative elapsed time for processing single-hop route requests PD (11,0)
on behalf of contention CP session setups
ANARMC Number of activate-route requests made to MSCP for contention CP PD (11,0)
session setups
ANSARM Number of successful activate-route requests processed by MSCP PD (11,0)
for contention CP session setups
ATARMC Cumulative elapsed time for activate-route requests on behalf of PD (11,0)
contention CP session setups

Appendix A. Performance Data 407

Table 75. APPN Data (One Entry per Interval) (continued)
Field Name Description Attributes
ANTDSC Number of requests made to the T2 SIOM to perform device PD (11,0)
selection on behalf of contention CP session setups
ATTDSC Cumulative elapsed time for device selection processing to complete PD (11,0)
on behalf of contention CP session setups
ANDSS Number of device selection requests that were successful on behalf PD (11,0)
of contention CP session setups
ATCCSA Cumulative elapsed time for processing contention CP session PD (11,0)
activation requests
ANLSAP Number of contention CP session activations processed PD (11,0)
ANCST Number of contention CP-CP session ends PD (11,0)
ATCST Cumulative elapsed time for processing contention CP-CP session PD (11,0)
ends
ANLST Number of contention CP-CP session ends PD (11,0)
ATLST Cumulative elapsed time for processing contention CP-CP session PD (11,0)
ends
ANCWSA Number of contention CP-CP sessions currently active (this is not a PD (11,0)
delta)
ANCLSA Number of contention CP-CP sessions currently active (this is not a PD (11,0)
delta)
ANCDRR Number of data-received requests processed (CP capabilities) PD (11,0)
ANCBDR Number of bytes of data received (CP capabilities) PD (11,0)
ATCDRR Cumulative elapsed time for processing the data-received requests PD (11,0)
(CP capabilities)
ANCSDR Number of send-data requests processed (CP capabilities) PD (11,0)
ANCBDS Number of bytes of data sent through the send-data requests (CP PD (11,0)
capabilities)
ATCSDR Cumulative elapsed time for processing the send-data requests (CP PD (11,0)
capabilities)
ANTDRR Number of data-received requests processed (topology database PD (11,0)
update)
ANTBDR Number of bytes of data received (topology database update) PD (11,0)
ATTDRR Cumulative elapsed time for processing the data-received requests PD (11,0)
(topology database update)
ANTSDR Number of send-data requests processed (topology database PD (11,0)
update)
ANTBDS Number of bytes of data sent through the send-data requests PD (11,0)
(topology database update)
ATTSDR Cumulative elapsed time for processing the send-data requests PD (11,0)
(topology database update)
ANDDRR Number of data-received requests processed (directory search) PD (11,0)
ANDBDR Number of bytes of data received (directory search) PD (11,0)
ATDDRR Cumulative elapsed time for processing the data-received requests PD (11,0)
(directory search)
ANDSDR Number of send-data requests processed (directory search) PD (11,0)

408 OS/400 Work Management V4R4

Table 75. APPN Data (One Entry per Interval) (continued)
Field Name Description Attributes
ANDBDS Number of bytes of data sent by the send-data requests (directory PD (11,0)
search)
ATDSDR Cumulative elapsed time for processing the send-data requests PD (11,0)
(directory search)
ANRDRR Number of data-received requests processed (registration/deletion) PD (11,0)
ANRBDR Number of bytes of data received (registration/deletion) PD (11,0)
ATRDRR Cumulative elapsed time for processing the data-received requests PD (11,0)
(registration/deletion)
ANRSDR Number of send-data requests processed (registration/deletion) PD (11,0)
ANRBDS Number of bytes of data sent through the send-data requests PD (11,0)
(registration/deletion)
ATRSDR Cumulative elapsed time for processing the send-data requests PD (11,0)
(registration/deletion)
Local system initiated sessions
ANWAP1 Total number of work activities of this type processed PD (11,0)
ATWAP1 Cumulative elapsed time to complete work activities of this type PD (11,0)
ATWAS1 Total number of work activities of this type that yielded a successful PD (11,0)
result
ASSSA1 Number of session setup attempts satisfied through an existing PD (11,0)
APPN session
AASNA1 Number of APPC session requests satisfied by using non-APPN PD (11,0)
device descriptions
ASPAC1 Number of session setup requests that require APPN control point PD (11,0)
services for directory, route selection, and device selection
processing
ASPSP1 Number of session setup requests that get pended due to another PD (11,0)
session setup being in progress for the same local location, remote
location, and mode
ASLNS1 Number of searches that the local end node satisfied locally (that is, PD (11,0)
without sending a search to its network node (NN) server)
AS1HS1 Number of one-hop search requests sent by the end node (EN) PD (11,0)
A1HSS1 Number of searches satisfied by the end node by sending one-hop PD (11,0)
search requests
ASSBN1 Number of searches satisfied by sending a bind directly to an PD (11,0)
attached network node server (because the end node has no
CP-CP session to a server)
ASFNS1 Number of searches that failed because of no network services PD (11,0)
being available for the local end node
ATILP1 Cumulative elapsed time required for the locate phase initiated by PD (11,0)
the end node to complete
ANSSL1 Number of searches satisfied locally (using the topology database or PD (11,0)
the directory services (DS) database and finding an entry for an end
node that does not support CP sessions)
ANIHS1 Number of one-hop search requests sent by the network node PD (11,0)
ANSS11 Number of searches satisfied by the network node by sending PD (11,0)
one-hop search requests

Appendix A. Performance Data 409

Table 75. APPN Data (One Entry per Interval) (continued)
Field Name Description Attributes
ANDSS1 Number of directed searches sent PD (11,0)
ASSDS1 Number of searches that were satisfied by sending directed PD (11,0)
searches
ATDSR1 Cumulative elapsed time for directed search responses to be PD (11,0)
received
ANDBE1 Number of domain broadcasts that have been run PD (11,0)
ANNDB1 Number of nodes that these domain broadcasts have been sent to PD (11,0)
ATRDB1 Cumulative elapsed time for the first positive response to be PD (11,0)
returned on domain broadcasts
ATLRD1 Cumulative elapsed time for the last response to be returned on PD (11,0)
domain broadcasts
ASSDB1 Number of searches that were satisfied by sending a domain PD (11,0)
broadcast
ANBSE1 Number of broadcast searches that have been run PD (11,0)
ANNBS1 Number of adjacent nodes that these broadcast searches have been PD (11,0)
sent to
ATRBS1 Cumulative elapsed time for the first positive response to be PD (11,0)
returned on broadcast searches
ATLRB1 Cumulative elapsed time for the last response to be returned on PD (11,0)
broadcast searches
ANSBS1 Number of searches that were satisfied by sending a broadcast PD (11,0)
search
ATSPR1 Cumulative elapsed time from the start of search processing on the PD (11,0)
local node until a positive response has been returned to the local
user
ATSPC1 Cumulative elapsed time from the start of search processing until PD (11,0)
the local directory services task has completed all processing for the
request. This measurement takes into account the time required to
process domain broadcast or broadcast search responses even
though a positive response has already been sent back to the local
user
AN1HT1 Number of single-hop route requests made to topology routing PD (11,0)
services (TRS)
AS1HT1 Number of single-hop route requests made to TRS that were PD (11,0)
successful
AT1HC1 Cumulative elapsed time for processing single-hop route requests PD (11,0)
ANRRT1 Number of request-route requests made to TRS PD (11,0)
ASRRT1 Number of request-route requests made to TRS that were PD (11,0)
successful
ATRRT1 Cumulative elapsed time for processing request-route requests PD (11,0)
AARRM1 Number of activate-route requests made to machine services control PD (11,0)
point (MSCP)
AARCV1 Number of activate-route requests that require a controller PD (11,0)
description to be automatically created and/or varied on by the
system
ATRCV1 Cumulative elapsed time for automatic creation and/or vary on of the PD (11,0)
controller to be processed

410 OS/400 Work Management V4R4

Table 75. APPN Data (One Entry per Interval) (continued)
Field Name Description Attributes
ASARR1 Number of successful activate-route requests processed by MSCP PD (11,0)
ATARP1 Cumulative elapsed time for processing activate-route requests by PD (11,0)
MSCP
ARDS1 Number of requests made to the T2 SIOM to perform device PD (11,0)
selection
ATDS1 Cumulative elapsed time for device selection processing to complete PD (11,0)
ADSS1 Number of device selection requests that were successful PD (11,0)
Receiver of search requests as an end node
ANWAP2 Total number of work activities of this type processed PD (11,0)
ATWAP2 Cumulative elapsed time to complete work activities of this type PD (11,0)
ATWAS2 Total number of work activities of this type that yielded a successful PD (11,0)
result
Network node performing search requests on behalf of an end node
ANWAP3 Total number of work activities of this type processed PD (11,0)
ATWAP3 Cumulative elapsed time to complete work activities of this type PD (11,0)
ATWAS3 Total number of work activities of this type that yielded a successful PD (11,0)
result
ANSSL3 Number of searches satisfied locally (by referring to the topology PD (11,0)
database or by using the directory services database and finding an
entry for an end node that does not support control point sessions)
ANIHS3 Number of one-hop search requests sent by the network node PD (11,0)
ANSS13 Number of searches satisfied by the network node by sending PD (11,0)
one-hop search requests
ANDSS3 Number of directed searches sent PD (11,0)
ASSDS3 Number of searches that were satisfied by sending directed PD (11,0)
searches
ATDSR3 Cumulative elapsed time for directed search responses to be PD (11,0)
received
ANDBE3 Number of domain broadcasts that have been run PD (11,0)
ANNDB3 Number of nodes that these domain broadcasts have been sent to PD (11,0)
ATRDB3 Cumulative elapsed time for the first positive response to be PD (11,0)
returned on domain broadcasts
ATLRD3 Cumulative elapsed time for the last response to be returned on PD (11,0)
domain broadcasts
ASSDB3 Number of searches that were satisfied by sending a domain PD (11,0)
broadcast
ANBSE3 Number of broadcast searches that have been run PD (11,0)
ANNBS3 Number of adjacent nodes that these broadcast searches have been PD (11,0)
sent to
ATRBS3 Cumulative elapsed time for the first positive response to be PD (11,0)
returned on broadcast searches
ATLRB3 Cumulative elapsed time for the last response to be returned on PD (11,0)
broadcast searches
ANSBS3 Number of searches that were satisfied by sending a broadcast PD (11,0)
search

Appendix A. Performance Data 411

Table 75. APPN Data (One Entry per Interval) (continued)
Field Name Description Attributes
ATSPR3 Cumulative elapsed time from the start of search processing on the PD (11,0)
local node until a response has been returned to the local user or
remote system that initiated the search process on the local system
ATSPC3 Cumulative elapsed time from the start of search processing until PD (11,0)
the local directory services task has completed all processing for the
request. This measurement takes into account the time required to
process domain broadcast or broadcast search responses even
though a positive response has already been sent back to the local
user or remote system that initiated a search
ANRRT3 Number of request-route requests made to TRS PD (11,0)
ASRRT3 Number of request-route requests made to TRS that were PD (11,0)
successful
ATRRT3 Cumulative elapsed time for processing request-route requests PD (11,0)
Intermediate node on a directed search request
ANWAP4 Total number of work activities of this type processed PD (11,0)
ATWAP4 Cumulative elapsed time to complete work activities of this type PD (11,0)
ATWAS4 Total number of work activities of this type that yielded a successful PD (11,0)
result
Network node that is the destination node of a directed search
request
ANWAP5 Total number of work activities of this type processed PD (11,0)
ATWAP5 Cumulative elapsed time to complete work activities of this type PD (11,0)
ATWAS5 Total number of work activities of this type that yielded a successful PD (11,0)
result
ANSSL5 Number of searches satisfied locally (by referring to the topology PD (11,0)
database or by using the directory services database and finding an
entry for an end node that does not support control point sessions)
ANIHS5 Number of one-hop search requests sent by the network node PD (11,0)
ANSS15 Number of searches satisfied by the network node by sending PD (11,0)
one-hop search requests
ANDBE5 Number of domain broadcasts that have been run PD (11,0)
ANNDB5 Number of nodes that these domain broadcasts have been sent to PD (11,0)
ATRDB5 Cumulative elapsed time for the first positive response to be PD (11,0)
returned on domain broadcasts
ATLRD5 Cumulative elapsed time for the last response to be returned on PD (11,0)
domain broadcasts
ASSDB5 Number of searches that were satisfied by sending a domain PD (11,0)
broadcast
Network node processing a received-broadcast-search request
ANWAP6 Total number of work activities of this type processed PD (11,0)
ATWAP6 Cumulative elapsed time to complete work activities of this type PD (11,0)
ATWAS6 Total number of work activities of this type that yielded a successful PD (11,0)
result
ANSSL6 Number of searches satisfied locally (by referring to the topology PD (11,0)
database or by using the directory services database and finding an
entry for an end node that does not support control point sessions)

412 OS/400 Work Management V4R4

Table 75. APPN Data (One Entry per Interval) (continued)
Field Name Description Attributes
ANIHS6 Number of one-hop search requests sent by the network node PD (11,0)
ANSS16 Number of searches satisfied by the network node by sending PD (11,0)
one-hop search requests
ANDBE6 Number of domain broadcasts that have been run PD (11,0)
ANNDB6 Number of nodes that these domain broadcasts have been sent to PD (11,0)
ATRDB6 Cumulative elapsed time for the first positive response to be PD (11,0)
returned on domain broadcasts
ATLRD6 Cumulative elapsed time for the last response to be returned on PD (11,0)
domain broadcasts
ASSDB6 Number of searches that were satisfied by sending a domain PD (11,0)
broadcast
Network node processing a received-search request from a node in
a non-AS/400 network
ANWAP7 Total number of work activities of this type processed PD (11,0)
ATWAP7 Cumulative elapsed time to complete work activities of this type PD (11,0)
ATWAS7 Total number of work activities of this type that yielded a successful PD (11,0)
result
ANSSL7 Number of searches satisfied locally (by referring to the topology PD (11,0)
database or by using the directory services database and finding an
entry for an end node that does not support control point sessions)
ANIHS7 Number of one-hop search requests sent by the network node PD (11,0)
ANSS17 Number of searches satisfied by the network node by sending PD (11,0)
one-hop search requests
ANDSS7 Number of directed searches sent PD (11,0)
ASSDS7 Number of searches that were satisfied by sending directed PD (11,0)
searches
ATDSR7 Cumulative elapsed time for directed search responses to be used PD (11,0)
ANDBE7 Number of domain broadcasts that have been run PD (11,0)
ANNDB7 Number of nodes that these domain broadcasts have been sent to PD (11,0)
ATRDB7 Cumulative elapsed time for the first positive response to be PD (11,0)
returned on domain broadcasts
ATLRD7 Cumulative elapsed time for the last response to be returned on PD (11,0)
domain broadcasts
ASSDB7 Number of searches that were satisfied by sending a domain PD (11,0)
broadcast
ANBSE7 Number of broadcast searches that have been run PD (11,0)
ANNBS7 Number of adjacent nodes that these broadcast searches have been PD (11,0)
sent to
ATRBS7 Cumulative elapsed time for the first positive response to be PD (11,0)
returned on broadcast searches
ATLRB7 Cumulative elapsed time for the last response to be returned on PD (11,0)
broadcast searches
ANSBS7 Number of searches that were satisfied by sending a broadcast PD (11,0)
search

Appendix A. Performance Data 413

Table 75. APPN Data (One Entry per Interval) (continued)
Field Name Description Attributes
ATSPR7 Cumulative elapsed time from the start of search processing on the PD (11,0)
local node until a response has been returned to the remote system
that initiated the search process on the local system
ATSPC7 Cumulative elapsed time from the start of search processing until PD (11,0)
the local directory services task has completed all processing for the
request. This measurement takes into account the time required to
process domain broadcast or broadcast search responses even
though a positive response has already been sent back to the
remote system that initiated a search
ANRRT7 Number of request-route requests made to topology routing services PD (11,0)
(TRS)
ASRRT7 Number of request-route requests made to topology routing services PD (11,0)
(TRS) that were successful
ATRRT7 Cumulative elapsed time for processing request-route requests PD (11,0)
Network node processing a received-bind request from a node in
the AS/400 network without routing information
ANWAP8 Total number of work activities of this type processed PD (11,0)
ATWAP8 Cumulative elapsed time to complete work activities of this type PD (11,0)
ATWAS8 Total number of work activities of this type that yielded a successful PD (11,0)
result
ASPSP8 Number of session setup requests that are placed in pending status PD (11,0)
due to another session setup being in progress for the same local
location, remote location, and mode
ANSSL8 Number of searches satisfied locally (by referring to the topology PD (11,0)
database or by using the directory services database and finding an
entry for an end node that does not support control point sessions)
ANIHS8 Number of one-hop search requests sent by the network node PD (11,0)
ANSS18 Number of searches satisfied by the network node by sending PD (11,0)
one-hop search requests
ANDSS8 Number of directed searches sent PD (11,0)
ASSDS8 Number of searches that were satisfied by sending directed PD (11,0)
searches
ATDSR8 Cumulative elapsed time for directed search responses to be used PD (11,0)
ANDBE8 Number of domain broadcasts that have been run PD (11,0)
ANNDB8 Number of nodes that these domain broadcasts have been sent to PD (11,0)
ATRDB8 Cumulative elapsed time for the first positive response to be PD (11,0)
returned on domain broadcasts
ATLRD8 Cumulative elapsed time for the last response to be returned on PD (11,0)
domain broadcasts
ASSDB8 Number of searches that were satisfied by sending a domain PD (11,0)
broadcast
ANBSE8 Number of broadcast searches that have been run PD (11,0)
ANNBS8 Number of adjacent nodes that these broadcast searches have been PD (11,0)
sent to
ATRBS8 Cumulative elapsed time for the first positive response to be PD (11,0)
returned on broadcast searches

414 OS/400 Work Management V4R4

Table 75. APPN Data (One Entry per Interval) (continued)
Field Name Description Attributes
ATLRB8 Cumulative elapsed time for the last response to be returned on PD (11,0)
broadcast searches
ANSBS8 Number of searches that were satisfied by sending a broadcast PD (11,0)
search
ATSPR8 Cumulative elapsed time from the start of search processing on the PD (11,0)
local node until a response has been returned to the local system to
allow the bind processing to continue
ATSPC8 Cumulative elapsed time from the start of search processing until PD (11,0)
the local directory services task has completed all processing for the
request. This measurement takes into account the time required to
process domain broadcast or broadcast search responses even
though a positive response has already been sent back to the local
system to allow the bind processing to continue
ANRRT8 Number of request-route requests made to topology routing services PD (11,0)
(TRS)
ASRRT8 Number of request-route requests made to TRS that were PD (11,0)
successful
ATRRT8 Cumulative elapsed time for processing request-route requests PD (11,0)
AARRM8 Number of activate-route requests made to machine services control PD (11,0)
point (MSCP)
AARCV8 Number of activate-route requests that require a controller PD (11,0)
description to be automatically created and/or varied on by the
system
ATRCV8 Cumulative elapsed time for automatic creation and/or vary on of the PD (11,0)
controller to be processed
ASARR8 Number of successful activate-route requests processed by MSCP PD (11,0)
ATARP8 Cumulative elapsed time for processing activate-route requests by PD (11,0)
MSCP
Network node processing a received-bind request from a node in a
non-AS/400 network without routing information
ANWAP9 Total number of work activities of this type processed PD (11,0)
ATWAP9 Cumulative elapsed time to complete work activities of this type PD (11,0)
ATWAS9 Total number of work activities of this type that yielded a successful PD (11,0)
result
ASPSP9 Number of session setup requests that are placed in pending status PD (11,0)
due to another session setup being in progress for the same local
location, remote location, and mode
ANSSL9 Number of searches satisfied locally (by referring to the topology PD (11,0)
database or by using the directory services database and finding an
entry for an end node that does not support control point sessions)
ANIHS9 Number of one-hop search requests sent by the network node PD (11,0)
ANSS19 Number of searches satisfied by the network node by sending PD (11,0)
one-hop search requests
ANDSS9 Number of directed searches sent PD (11,0)
ASSDS9 Number of searches that were satisfied by sending directed PD (11,0)
searches
ATDSR9 Cumulative elapsed time for directed search responses to be PD (11,0)
received

Appendix A. Performance Data 415

Table 75. APPN Data (One Entry per Interval) (continued)
Field Name Description Attributes
ANDBE9 Number of domain broadcasts that have been run PD (11,0)
ANNDB9 Number of nodes that these domain broadcasts have been sent to PD (11,0)
ATRDB9 Cumulative elapsed time for the first positive response to be PD (11,0)
returned on domain broadcasts
ATLRD9 Cumulative elapsed time for the last response to be returned on PD (11,0)
domain broadcasts
ASSDB9 Number of searches that were satisfied by sending a domain PD (11,0)
broadcast
ANBSE9 Number of broadcast searches that have been run PD (11,0)
ANNBS9 Number of adjacent nodes that these broadcast searches have been PD (11,0)
sent to
ATRBS9 Cumulative elapsed time for the first positive response to be PD (11,0)
returned on broadcast searches
ATLRB9 Cumulative elapsed time for the last response to be returned on PD (11,0)
broadcast searches
ANSBS9 Number of searches that were satisfied by sending a broadcast PD (11,0)
search
ATSPR9 Cumulative elapsed time from the start of search processing on the PD (11,0)
local node until a response has been returned to the local system to
allow bind processing to continue
ATSPC9 Cumulative elapsed time from the start of search processing until PD (11,0)
the local directory services task has completed all processing for the
request. This measurement takes into account the time required to
process domain broadcast or broadcast search responses even
though a positive response has already been sent back to the local
system to allow bind processing to continue
ANRRT9 Number of request-route requests made to topology routing services PD (11,0)
(TRS)
ASRRT9 Number of request-route requests made to TRS that were PD (11,0)
successful
ATRRT9 Cumulative elapsed time for processing request-route requests PD (11,0)
AARRM9 Number of activate-route requests made to machine services control PD (11,0)
point (MSCP)
AARCV9 Number of activate-route requests that require a controller PD (11,0)
description to be automatically created and/or varied on by the
system
ATRCV9 Cumulative elapsed time for automatic creation and/or vary on of the PD (11,0)
controller to be processed
ASARR9 Number of successful activate-route requests processed by MSCP PD (11,0)
ATARP9 Cumulative elapsed time for processing activate-route requests by PD (11,0)
MSCP
Network node processing a received-bind request from a node in
the AS/400 network with routing information
ANWAPA Total number of work activities of this type processed PD (11,0)
ATWAPA Cumulative elapsed time to complete work activities of this type PD (11,0)
ATWASA Total number of work activities of this type that yielded a successful PD (11,0)
result

416 OS/400 Work Management V4R4

Table 75. APPN Data (One Entry per Interval) (continued)
Field Name Description Attributes
ASPSPA Number of session setup requests that are placed in pending status PD (11,0)
due to another session setup being in progress for the same local
location, remote location, and mode triplet
AARRMA Number of activate-route requests made to machine services control PD (11,0)
point (MSCP)
AARCVA Number of activate-route requests that require a controller PD (11,0)
description to be automatically created and/or varied on by the
system
ATRCVA Cumulative elapsed time for automatic creation and/or vary on of the PD (11,0)
controller to be processed
ASARRA Number of successful activate-route requests processed by MSCP PD (11,0)
ATARPA Cumulative elapsed time for processing activate-route requests by PD (11,0)
MSCP
Network node processing a received-bind request from a node in a
non-AS/400 network with routing information
ANWAPB Total number of work activities of this type processed PD (11,0)
ATWAPB Cumulative elapsed time to complete work activities of this type PD (11,0)
ATWASB Total number of work activities of this type that yielded a successful PD (11,0)
result
ASPSPB Number of session setup requests that are pended by another PD (11,0)
session setup in progress for the same local location, remote
location, and mode
AARRMB Number of activate-route requests made to machine services control PD (11,0)
point (MSCP)
AARCVB Number of activate-route requests that require a controller PD (11,0)
description to be automatically created and/or varied on by the
system
ATRCVB Cumulative elapsed time for automatic creation and/or vary on of the PD (11,0)
controller to be processed
ASARRB Number of successful activate-route requests processed by MSCP PD (11,0)
ATARPB Cumulative elapsed time for processing activate-route requests by PD (11,0)
MSCP

File Name: QAPMIOPD

IOP Extended Data: Table 76 lists the fields in the IOP extended data file. Data is
reported for the Integrated PC Servers.
Table 76. IOP Extended Data
Field Name Description Attributes
INTNUM Interval number: The nth sample interval since the start of the PD (5,0)
performance monitor job.
DTETIM Interval date (yy/mm/dd) and time (hh:mm:ss): the date and time of C (12)
the sample interval.
INTSEC Elapsed interval second: the number of seconds since the last PD (7,0)
sample interval.
IOPRN IOP resource name. C(10)
XIIOP Reserved C (1)

Appendix A. Performance Data 417

Table 76. IOP Extended Data (continued)
Field Name Description Attributes
XITYPE The type of IOP represented by this record. C (4)
XIDTYP Data type: C (1)
v ’1’ — Reserved
v ’2’ — OS/2 or other operating system
v ’3’ — HPF386
v ’4’ — LAN Server
XIDTA1 Data field 1 C (1)
XIDTA2 Data field 2 C (12)
XICT01 Counter 1 PD (11)
XICT02 Counter 2 PD (11)
XICT03 Counter 3 PD (11)
XICT04 Counter 4 PD (11)
XICT05 Counter 5 PD (11)
XICT06 Counter 6 PD (11)
XICT07 Counter 7 PD (11)
XICT08 Counter 8 PD (11)
XICT09 Counter 9 PD (11)
XICT10 Counter 10 PD (11)
XICT11 Counter 11 PD (11)
XICT12 Counter 12 PD (11)
XICT13 Counter 13 PD (11)
XICT14 Counter 14 PD (11)
XICT15 Counter 15 PD (11)
XICT16 Counter 16 PD (11)
XICT17 Counter 17 PD (11)
XICT18 Counter 18 PD (11)
XICT19 Counter 19 PD (11)
XICT20 Counter 20 PD (11)
XICT21 Counter 21 PD (11)
XICT22 Counter 22 PD (11)
XICT23 Counter 23 PD (11)
XICT24 Counter 24 PD (11)
XICT25 Counter 25 PD (11)
XICT26 Counter 26 PD (11)
XICT27 Counter 27 PD (11)
XICT28 Counter 28 PD (11)
XICT29 Counter 29 PD (11)
XICT30 Counter 30 PD (11)
XICT31 Counter 31 PD (11)
XICT32 Counter 32 PD (11)

418 OS/400 Work Management V4R4

Table 76. IOP Extended Data (continued)
Field Name Description Attributes
XICT33 Counter 33 PD (11)
XICT34 Counter 34 PD (11)
XICT35 Counter 35 PD (11)
XICT36 Counter 36 PD (11)
XICT37 Counter 37 PD (11)
XICT38 Counter 38 PD (11)
XICT39 Counter 39 PD (11)
XICT40 Counter 40 PD (11)
XICT41 Counter 41 PD (11)
XICT42 Counter 42 PD (11)
XICT43 Counter 43 PD (11)
XICT44 Counter 44 PD (11)
XICT45 Counter 45 PD (11)
XICT46 Counter 46 PD (11)
XICT47 Counter 47 PD (11)
XICT48 Counter 48 PD (11)
XICT49 Counter 49 PD (11)
XICT50 Counter 50 PD (11)
XIADRN Adapter resource name: If the resource reported is an adapter, then C (10)
this field will contain the resource name of that adapter. If the
resource reported is an IOP, then this field will contain the resource
name of that IOP.

Note: The following chart shows the types of counters used. w symbol=dlt text=’D
(Delta counter)xx’>
D (Delta counter)
Number of occurrences in the interval (what most Performance
counters are).
S (State counter)
The value at the time of collection or the maximum value during the
interval.

XIDTYP = ’1’ (Reserved)

XIDTYP = ’2’ (OS/2) or other operating system
(CT01) D:
CPU time (milliseconds)
(CT02) D:
Number of times threads scheduled
(CT03) D:
Number of interrupts
(CT04) D:
CPU time servicing interrupts (milliseconds)

Appendix A. Performance Data 419

 (CT05) D:
Number of page faults
(CT06) D:
Number of pages swapped in
(CT07) D:
Number of pages demand-loaded
(CT08) D:
Number of pages swapped out
(CT09) D:
Number of pages discarded
(CT10) D:
Number of idle pages recovered
(CT11) D:
Number of pages idled
(CT12) D:
Number of idle pages reassigned
(CT13) S:
Number of elements in free queue
(CT14) S:
Length of time elements in free queue (milliseconds)
(CT15) S:
Number of elements in used queue
(CT16) S:
Length of time elements in used queue (milliseconds)

XIDTYP = ’3’ (HPFS386)

(CT01) D:
Read requests from cache
(CT02) D:
Read requests from disk
(CT03) D:
Write requests from disk
(CT04) D:
Write requests lazy written
(CT05) D:
Cache flushes (force lazy)
(CT06) D:
Cache blocks
(CT07) S:
Heap size
(CT08) S:
Max heap size
(CT09) D:
Heap request failures
(CT10) D:
Files opened

420 OS/400 Work Management V4R4

(CT11) D:
Files closed
(CT12) I:
Files currently being written
(CT13) D:
File closed only read
(CT14) D:
File closed read sequential
(CT15) D:
Read-ahead blocks
(CT16) D:
Read-ahead buffer hits
(CT17) D:
Read-ahead block overwritten
(CT18) D:
Whole file read ahead
(CT19) D:
Transactions processed
(CT20) D:
File opens (client)
(CT21) D:
File closes (client)
(CT22) D:
Files opened oplock (opportunistic locking)
(CT23) D:
Oplock breaks
(CT24) D:
Reads (Small)
(CT25) D:
Read time (Small) (milliseconds)
(CT26) D:
Bytes read (Small)
(CT27) D:
Reads (MPX)
(CT28) D:
Read time (MPX) (milliseconds)
(CT29) D:
Bytes read (MPX)
(CT30) D:
Reads (Raw)
(CT31) D:
Read time (Raw) (milliseconds)
(CT32) D:
Bytes read (Raw)

Appendix A. Performance Data 421

 (CT33) D:
Read cache bypasses
(CT34) D:
Writes (Small)
(CT35) D:
Write time (Small) (milliseconds)
(CT36) D:
Bytes Written (Small)
(CT37) D:
Writes (MPX)
(CT38) D:
Write time (MPX) (milliseconds)
(CT39) D:
Bytes Written (MPX)
(CT40) D:
Writes (Raw)
(CT41) D:
Write time (Raw) (milliseconds)
(CT42) D:
Bytes Written (Raw)
(CT43) D:
Write cache bypasses
(CT44) S:
Open finds
(CT45) S:
Number of open searches
(CT46) S:
Big buffers allocated
(CT47) D:
Big buffer failures

XIDTYP = ’4’ (Lan Server)

(DTA2) I:
Counter reset date or time
(CT01) D:
Number of files open
(CT02) D:
Number of devices open
(CT03) D:
Number of print jobs spooled
(CT04) D:
Number of sessions accepted
(CT05) D:
Number of timed-out sessions
(CT06) D:
Number of errored-out sessions

422 OS/400 Work Management V4R4

 (CT07) D:
Number of password violations
(CT08) D:
Number of permission violations
(CT09) D:
Number of system errors
(CT10) D:
Number of kilobytes sent
(CT11) D:
Number of kilobytes received
(CT12) I:
Average server response time
(CT13) D:
Number of request buffer allocation failures
(CT14) D:
Number of big buffer allocation failures

Task Type Extender

A task type extender identifies the area of functional support provided by the task.

The third and fourth byte of the TDE contains the task type extender field. This
field is used to logically group together tasks that perform similar operations. A
primary use of this field is for performance monitoring. The table below lists the
task type extender as two EBCDIC characters followed by the task type
extender class description.
Table 77. Task Type Extenders
—Performance Tasks (’A ’ through ’A9’
| AP Performance Collection Services Probe

—Bus Transport Tasks (’B ’ through ’B9’)

BB Transport Bus
BC Transport cluster
BI Transport SPD IOBU
BL Transport Log
BM Transport SPD Maintenance Data
BR Transport Remote Storage
BT Transport Twin Optical

—Client Service Tasks (’C ’ through ’C9’)

CS Shared Folder

Appendix A. Performance Data 423

 Table 77. Task Type Extenders (continued)
—Device Driver Tasks (’D ’ through ’D9’)
DA Work Station IOM
DB PU2 Station IOM
DC Open Station IOM
DD Ethernet LAN IOM
DE Bisync 3270 IOM
DF 5294 Station IOM
DG X25 Station IOM
DI FDDI IOM
DJ ISDN IOM
DK Diskette IOM
DL IDLC IOM
DO Optical IOM
DP PPP Data Link Driver
DS DASD IOM
DV Virtual Terminal LUD IOM
DW Wireless Line IOM
DX Fax Line IOM
DY Frame Relay IOM
DZ ILAN Line IOM
D0 Service Processor IOM
D1 Asynchronous Station IOM
D2 Asynchronous Line IOM
D3 Token Ring IOM
D4 Tape IOM
D5 Ws Station IOM
D6 Twinax IOM
D7 SDLC Line IOM
D8 Bisync IOM
D9 MTAM IOM

—Other Tasks (’E ’ through ’E9’)

EL Error Log

—FSIOP I/O Management Tasks (’F ’ through ’F9’)

FO FSIOP IOM
FS FSIOP Storage Management

424 OS/400 Work Management V4R4

Table 77. Task Type Extenders (continued)
—IPCF Tasks (’I ’ through ’I9’)
IR IPCF Router
IS IPCF Server

—Streams Kernel Tasks (’K ’ through ’K9’)

K0 Streams Server

—Save/Restore, Load/Dump Tasks (’L ’ through ’L9’)

LM Main Load/Dump
LP Load/Dump Pipeline

—MSCP Tasks (’M ’ through ’M9’)

M0 MSCP
M1 Answer Manager
M2 SNAP

—Pass Through Tasks (’P ’ through ’P9’)

PS Source Display Pass Through
PT Target Display Pass Through

—Resource Management Task (’R ’ through ’R9’)

RM Resource Management Service
RP Process

—Storage Management I/O Tasks (’S ’ through ’S9’)

SA Storage Management Asynchronous
SD Storage Management DASD Server
SP Page Out
SW Save While Active
SX Expert Cache

—Service Function Task (’V ’ through ’V9’)

VF Service Function

—Server Message Block Tasks (’W’ through ’W9’)

WB NetBIOS on TCP/IP
WS Server Message Block

—Other Tasks (’Z ’ through ’Z9’)

ZF Byte Stream File Asynchronous
ZI Interrupt task class
ZR Recovery

Appendix A. Performance Data 425

 Table 77. Task Type Extenders (continued)
—Advanced 36 Tasks (’3 ’ through ’39’)
3A Advanced/36 Disk
3C Advanced/36 Wkstn Controller
3I Advanced/36 Diskette
3L Advanced/36 Communications Line
3T Advanced/36 Tape
3W Advanced/36 Workstation/printer
36 Advanced/36 Emulator main task

426 OS/400 Work Management V4R4

Appendix B. Performance Data—Performance Explorer
Performance explorer is a data collection tool that helps the user identify the causes
of performance problems that cannot be identified by collecting data using the
performance monitor or by doing general trend analysis. Two reasons to use
performance explorer include:
v Isolating performance problems
v Modeling the performance of applications

The collection functions and related commands of performance explorer are part of
the OS/400 operating system. The reporting function and its associated commands
are part of the Performance Tools for AS/400 licensed product, the Manager
feature. The AS/400 Performance Explorer Tips and Techniques, SG24-4781,
provides additional examples of the performance explorer functions and examples
of the enhanced performance explorer trace support.

Do I Need Performance Explorer?

Performance explorer is a tool that helps find the causes of performance problems
that cannot be identified by using tools that do general performance monitoring. As
your computer environment grows both in size and in complexity, it is reasonable
for your performance analysis to gain in complexity as well. The performance
explorer addresses this growth in complexity by gathering data on complex
performance problems.

This tool is designed for application developers who are interested in understanding
or improving the performance of their programs. It is also useful for users
knowledgeable in performance management to help identify and isolate complex
performance problems.

Note: If you are familiar with the Sampled Address Monitor (SAM) function or the
TPST PRPQ, your transition to the performance explorer should be smooth.

Who Needs Performance Explorer

The user that wants to use the performance explorer for application and program
analysis does not need to be an expert in the area of performance to make use of
the performance explorer. The same level of expertise that was required when
using SAM in V3R1 and earlier versions is what is needed with the performance
explorer.

To use the performance explorer to isolate a performance problem, you should have
a good understanding of the performance issue. Using the performance explorer
requires more performance specialized knowledge. You should also have an idea of
where the problem might be on the system. You need to set up performance
explorer to collect data in specific areas of your system, and you will have to
interpret the data.

When You Need Performance Explorer

When you find that performance advisor is not telling you enough, you should
consider the performance explorer. In short, performance explorer is the tool you

© Copyright IBM Corp. 1997, 1999 427

 need to use after you have tried the other tools. It gathers specific forms of data
that can more easily isolate the factors involved in a performance problem.

Comparison of Explorer to Other Performance Tools

A good way to understand performance explorer is to see it compared and
contrasted to other tools in the Performance Tools licensed program or in the
OS/400 operating system.

Performance Explorer and Advisor Functions

The performance advisor and the performance explorer are quite different functions.
The explorer’s main purpose is collecting specific data. To do this, it has its own
collecting facility. The advisor’s role is assessing data collected by the performance
monitor. It produces, after its analysis, a list of conclusions and recommendations
on ways you can improve your performance. The explorer does not do any analysis
for you.

If you are using the advisor, you are probably doing routine performance
maintenance. If you are using the explorer, you know that you have a performance
problem, and you are having a hard time identifying its cause.

Performance Explorer and Performance Monitor

In a sense, the performance explorer is much like the performance monitor because
they both collect data. The main difference is that performance explorer provides a
much greater level of detail. Also, unlike the performance monitor, the performance
explorer allows you to specify particular areas of interest, and it allows you to focus
the collection. The performance explorer collection can be tuned to include very
specific data. It is the ability to tune, or specify, the data to be collected that makes
the performance explorer effective in helping isolate performance problems.

Note: You can run both collections of data at the same time. However, you should
keep this to a minimum because the system is significantly affected when
both collections are active.

This detail is good because many times the factors that contribute to performance
problems are not isolated. Often, there are several contributing factors to the
problem. Since many factors are contributing to the problem, it is difficult to identify
individual causes using tools that assess the whole system. You need a tool that
provides the details.

Performance explorer can be used to isolate the factors behind a problem that you
have identified. This tool pulls the symptoms together. For example, a sluggish
system could be caused by DASD reads and writes, or CPU, or a combination of
two or more. With performance explorer, you can find the cause.

Benefits of Performance Explorer

Performance explorer has advantages for people who need detailed performance
analysis on an AS/400 system. Using performance explorer you can:
v Do a detailed analysis on one job without affecting the performance of other
operations on the system.

428 OS/400 Work Management V4R4

 v Analyze data on a system other than the one on which it was collected. For
example, if you collect data on a managed system in your network, you can send
it to the central site system for analysis.
v Map performance information to code
Using performance explorer, you can map performance information back to
source lines of code to correlate the performance data generated with the code
that caused the data to be generated.
v Collect performance information on user-developed software.
To collect performance information on user-developed software, performance
collection must be enabled when the program is created. In general, all
user-developed software is created with performance collection enabled.
For more information on how to enable or disable performance collection, refer to
the specific compiler documentation and refer to the Enable performance
collection (ENBPFRCOL) parameter on the Create Bound C Program
(CRTBNDC) command.
Programs can also be enabled or disabled using the ENBPFRCOL parameter on
the Change Program (CHGPGM) command.

Note: The default for all ILE languages is to have the pre-defined trace points at
the program-level enabled. However, some languages provide a compiler
option (ENBPFRCOL parameter) that allows you to turn the enabling off.
Those languages that do not provide the option will have the pre-defined
collection points enabled.

The significance of the collection mechanism is that:

– It is controlled by pre-defined collection points that are compiler generated.
– The pre-defined collection points are scalable.
– The system and all IBM code are shipped with these pre-defined trace points.
– The default for all compilers is to have these pre-defined collection points
enabled.

How Performance Explorer Works

1. You set up a performance explorer data collection using a definition.
2. You start performance explorer and it collects the data based on the definition.
3. You can create reports from the databases.
4. You can print those reports, if you want to.

You can access the commands associated with the performance explorer tool using
one of the following:
v The command interface. Type the commands from the command line. All the
commands are part of the OS/400 operating system, except the PRTPEXRPT
command.
v The Performance Tools menu options. Select option 5 (Performance utilities) from
the IBM Performance Tools menu, then option 2 (Work with Performance
Explorer).

Appendix B. Performance Data—Performance Explorer 429

 Work with Performance Explorer

Select one of the following:

1. Add Performance Explorer Definition (ADDPEXDFN)

2. Change Performance Explorer Definition (CHGPEXDFN)
3. Remove Performance Explorer Definition (RMVPEXDFN)
4. Start the Performance Explorer (STRPEX)
5. End the Performance Explorer (ENDPEX)
6. Print Performance Explorer Reports (PRTPEXRPT)
7. Delete Performance Explorer Data (DLTPEXDTA)

Selection or command
===>

F3=Exit F4=Prompt F9=Retrieve F12=Cancel

Performance Explorer Definitions

The performance explorer definitions are how you describe to the performance
explorer the type of data that you want to collect. The definition is then used to
define the information that should be collected when the performance explorer is
started. When you create a performance explorer definition, you are really just
describing what you want collected. To help you understand how performance
explorer works, scenarios are provided to help you understand the concepts of
performance explorer. See “Creating a Performance Explorer Definition” on
page 432.

The performance explorer provides the following types of data collection:

v Statistical
v Profile
v Trace

Each type gathers data in a different way and organizes it in a unique fashion.

Statistical type identifies applications and IBM programs or modules that consume
excessive CPU use or that perform a high number of disk I/O operations. Typically,
you use the statistical type to identify programs that should be investigated further
as potential performance bottlenecks.

You use the statistical type to find the high resource consuming programs and
modules that run during the performance collection. The objective is to determine if
there are specific programs or modules consuming most of the resource. If you
suspect that using a particular application is causing poor performance, use the
*STATS collection. The *STATS collection can determine which programs should be
examined based on the CPU statistics, disk statistics, and the number of times the
program was called.

For example, you may find that the highest CPU utilization program or module is
called only once during the collection period. You can have another program or
module that uses a moderately high level of CPU utilization but is called hundreds

430 OS/400 Work Management V4R4

 of times. You need to decide which program or module should be analyzed: the one
called only once or the one called hundreds of times.

The statistics can be structured in either a hierarchical or flattened manner.

v A hierarchical structure organizes the statistics into a call tree form in which each
node in the tree represents a program procedure run by the job or task.
v A flattened structure organizes the statistics into a simple list of programs or
procedures, each with its own set of statistics.

Profile type identifies high-level language (HLL) programs that consume excessive
CPU utilization based on source program statement numbers.

You can also identify a program that is constantly branching between the start of
the program and subroutines at the end of the program. If the program is large
enough, this constant jumping back and forth can cause excessive page fault rates
on a system with limited main storage.

When a trace, statistics, or profile mode is selected, a number of options are

provided to limit the scope of the collected performance data. You can collect on
specific jobs, tasks, OS/400 programs, modules, and procedures.

Trace type gathers a historical trace of performance activity generated by one or

more jobs on the system. The trace type gathers very specific information about
when and in what order events occurred. The trace type collects detailed program,
Licensed Internal Code (LIC) task, OS/400 job, and object reference information.

General Flow of the Performance Explorer

The following sections should help you become familiar with the natural path
through the performance explorer. Figure 50 shows a basic work cycle.

ADDPEXDFN QPEXDATA
Command Database

Database PRTPEXRPT
Command

Runs
STRPEX Collections ENDPEX
Command Command
RV3S161-0

Figure 50. Performance Explorer Basic Flow Pattern

The work cycle is made up of these activities:

v The first task in this cycle is to create a session definition that informs the AS/400
system about what processes you want to collect performance data. On the Add
Performance Explorer Definition (ADDPEXDFN) command, specify the collection
type and a name for the definition. This definition is stored as a database
member by that name in the QAPEXDFN file in library QUSRSYS. The name
that you specify is used on the STRPEX command.

Appendix B. Performance Data—Performance Explorer 431

 v The second task is to start collecting data (STRPEX command), which in turn
creates a data file containing the specified performance data.
v The third task is to stop collecting the data and save it to database files for
analysis. Use the End Performance Explorer (ENDPEX) command to stop the
collection.
v The fourth task is to analyze the performance data. The PRTPEXRPT command
provides unique reports for each type of data (statistical, profile, or trace).
The other option for analysis is to write your own queries over the set of
database files.

Creating a Performance Explorer Definition

The first task is to define what data is to be collected using the Add Performance
Explorer Definition (ADDPEXDFN) command. After the definition is completed and
saved, you are ready to continue to the second task in the cycle of work.

Before creating a new definition, consider what kinds of information you want and
the amount of detail you need. In general, the three main types of collections have
the following characteristics:
v Statistics type definitions
– Using this definition results in collecting the same basic information as the
TPST tool.
– Good for first order analysis of OS/400 original program model (OPM)
programs, procedures, and MI complex instructions.
- Gives number of invocations
- Gives both inline and cumulative CPU usage in microseconds
- Gives both inline and cumulative number of synchronous and asynchronous
I/O
- Gives number of calls made
– Works well for short or long runs
– Size of the collected data is fairly small and constant for all runs
– Run time collection overhead of ILE procedures may be a problem due to the
frequency of calls. Although run time is degraded, performance explorer
removes most of the collection overhead from the data.
– Uses combined or separated data areas. The MRGJOB parameter on the Add
Performance Explorer Definition (ADDPEXDFN) command specifies whether
all program statistics are accumulated in one data area, or kept separate (for
example, one data area for each job).
v Profile type definitions
– Gives detailed breakdown of where you are spending time within a program or
procedure
– Size of collection is fairly small and constant regardless of length of run
– Can narrow the scope of data collected to just a few programs of interest
– Limit of 16 MI programs means that you should use this as a second order
analysis tool.
– Can vary overhead by changing sample interval. An interval of 2 milliseconds
seems a good first choice for benchmarks.
– No restrictions on pane size due to the number of programs specified or the
size of the programs specified.
v Trace type definitions

432 OS/400 Work Management V4R4

 – Storage management and flow trace definitions
– Good for watching storage management activity on the system. Also shows MI
complex instructions.
– Longer runs collect more data

Starting the Performance Explorer

To start the performance explorer, use the Start Performance Explorer (STRPEX)
command. You can specify to start a new performance explorer session or resume
an already active session.

Note: You are allowed to have only one active session at a time. Multiple sessions
are not allowed.

Ending the Performance Explorer

To end the performance explorer session, use the End Performance Explorer
(ENDPEX) command. The ENDPEX command performs the following actions on
the collected data:
v Places the collected data in files QAYPExxx in the library that you specify.
Use OPTION(*END) and DTAOPT(*LIB) to do this. The database member name
for all the QAYPExxx files uses the session name as the default unless you
specify a name for the DTAMBR parameter.
You can specify RPLDTA(*NO) to erase data that was collected using this
session name or RPLDTA(*YES) to add the collected data to the existing data.
Unless you are a very sophisticated user, use RPLDTA(*NO).
v Places the collected data into a single IBM-defined file.
Use OPTION(*END) and DTAOPT(*FILE) to do this. Typically, you would use
*FILE only under the direction of an IBM service representative. Specifying the
*FILE value on the DTAOPT parameter saves the collection information into a
binary file. The binary file option should be used only if the data is going to be
shipped to IBM. The performance tools can analyze only the database files.
v Discards the collected data.
Use OPTION(*END) and DTAOPT(*DLT) to delete any collected data. You do this
when you determine the collected data cannot be used. For example, one of the
suspected jobs did not start as expected. If you choose the *DLT option, the
collected performance data for the session is never saved.
v Saves the collected data.
Use OPTION(*END) and DTAOPT(*LIB) to save the collection into a database
file. Use these values if you are sending data to a manager site.
v Suspends the collection session but does not end it.
Use OPTION(*SUSPEND) to do this. You can later start the data collection again
by issuing the STRPEX command with OPTION(*RESUME) for the specific
session ID.

Note: If you forget the active collection session name, you cannot end the
collection without powering off the system. To find the active session
name, use the ENDPEX SSNID(*SELECT) command.

Appendix B. Performance Data—Performance Explorer 433

Deleting Performance Explorer Data
To delete performance explorer data, use the Delete Performance Explorer Data
(DLTPEXDTA) command. The DLTPEXDTA command discards performance data
from a set of database files.

For details on the DLTPEXDTA command, see the Performance Tools for AS/400
book.

Creating and Printing Performance Explorer Reports

You create and print performance explorer reports by using the Print Performance
Explorer Report (PRTPEXRPT) command.

Use the OUTFILE parameter when you want to customize your Trace Report. The
performance explorer stores its collected data in the QAVPETRCI file, which is
located in the QPFR library. Type the following command to view the contents for a
single record:
DSPFFD FILE(QPFR/QAVPETRCI)

For more information about performance explorer reports, see the Performance
Tools for AS/400 book.

Finding Your Performance Explorer Definitions

The SELECT parameter on the ENDPEX command provides a list of all active
performance explorer sessions on the system. This parameter shows the Select
Performance Explorer Session display.
Select Performance Explorer Session

Type option, press Enter.

1=Select

Event
Option Session User Type State Count

(No objects to display.)

Performance Data Files

The following are performance data files collected by the system when using data
collection commands. The following files are for the Performance Explorer:

File Name Where to Find Description

QAYPEREF 436 Reference information
QAYPERUNI 437 General information
QAYPECOCFG 439 Configuration object information
QAYPEHWCFG 439 Hardware mode specific configuration information
QAYPEFQCFG 440 PMC selection
QAYPECICFG 440 Basic configuration information

434 OS/400 Work Management V4R4

File Name Where to Find Description
QAYPESTCFG 440 Statistical mode specific configuration information
QAYPETRCFG 441 Trace mode specific configuration information
QAYPELCPLX 441 MI complex instructions collected on
QAYPELJOB 441 Jobs collected on
QAYPELMET 441 Metrics to collect data on
QAYPELMI 442 MI program, module, or procedures collected on
QAYPELLIC 442 LIC modules to collect data on
QAYPELNAMT 442 Task names to collect data on
QAYPELNUMT 442 Task number to collect data on
QAYPEMICPX 443 MI complex instructions mapping
QAYPEEVENT 443 Event type and subtype mapping
QAYPEHWMAP 443 Hardware mapping data
QAYPELICI 443 LIC address resolution mapping
QAYPEMII 444 MI program address resolution mapping
QAYPESEGI 444 Segment address resolution mapping
QAYPETASKI 445 Process and task resolution mapping
QAYPENMI 446 List of MI programs that data was collected on
QAYPENLIC 446 List of LIC modules that data was collected on
QAYPETIDX 447 Common trace data for all events
QAYPEASM 447 Auxiliary storage management event data
QAYPEBASE 448 Base event data
QAYPEDASD 449 DASD event data
QAYPEDSRV 450 DASD server event data
QAYPEPGFLT 450 Page fault event data
QAYPERMPM 450 Resource management process event data
QAYPERMSL 451 Resource management seize lock event data
QAYPES36 451 Advanced 36 event data
QAYPESAR 451 Segment address range (SAR) data
QAYPEUNKWN 452 UNKNOWN event data
QAYPESTATS 452 Basic statistics data
QAYPEPSUM 455 Statistic profiling summary data
QAYPEPWDW 456 Statistics profiling window data
QAYPEPPANE 456 Statistics profiling pane data
QAYPELBRKT 457 Licensed internal code (LIC) bracketing data
QAYPEMIUSR 457 Machine interface (MI) user event data
QAYPEMBRKT 458 Machine interface (MI) program bracketing data
QAYPEMIPTR 458 Addresses of MI pointer
QAYPEUSRDF 458 User-defined bracketing hook data
QAYPEHMON 458 Hardware monitor data
QAYPEHTOT 459 Hardware monitor total data
QRLVRM 459 Release, version, modification level

Appendix B. Performance Data—Performance Explorer 435

 File Name Where to Find Description
QRLLVL 459 PEX level indicator
QAYPEJVA 460 PEX Java event data
QAYPEJVCI 461 PEX Java class info data
QAYPEJVMI 461 PEX Java method info data
QAYPEJVNI 461 PEX Java name info data

Performance Data File Abbreviations

The performance data files use abbreviations in the field and byte data tables.
These abbreviations include:
CHAR Character in the Data Types column.
PD Packed decimal in the Data Types column.
HEX Hexadecimal in the Data Types column.

File Name–QAYPEREF
Referenced fields information
Contains field definitions that are referenced throughout the database. This file will
not contain any data.
Table 78. File QAYPEREF
Field Name Data Type Field Length Description
QRECNB BINARY 9 Number used to uniquely identify
records in some of the data files.
QINT4 BINARY 9 A generic 4-byte signed integer
fields.
QINT2 BINARY 4 A generic 2-byte signed integer
fields.
QHEXAD HEX 16 Hex field used to hold a 16-byte
address.
QSEGAD HEX 16 Hex field used to hold a 16-byte
segment address.
QSEGOF HEX 6 Hex field to hold a 6-byte segment
offset address.
QREGST HEX 16 Hex field to hold a 16-byte register
address.
QBYTE CHAR 1 A generic 1-byte character field.
QDFTNM CHAR 10 Default name size.
QHWMNM CHAR 15 Hardware mode option names.
QTSKNM CHAR 16 Task name.
QJOBNB CHAR 6 Job number.
QSHRNM CHAR 40 Short name stored in the database.
QLRUNM CHAR 8 LIC module ID.
QMPCNM CHAR 256 MI procedure name.
QLMDNM CHAR 256 LIC module name.

436 OS/400 Work Management V4R4

 Table 78. File QAYPEREF (continued)
Field Name Data Type Field Length Description
QLPCNM CHAR 4096 LIC procedure name.
QPINT2 PD (5,0) Holds a 2-byte integer (signed or
unsigned).
QPINT4 PD (10,0) Hold a 4-byte integer (signed or
unsigned).
QPINT8 PD (20,0) Hold a 8-byte integer (signed or
unsigned).

File Name–QAYPERUNI
Contains general information about a collection.
Table 79. File QAYPERUNI
Field Name Data Type Field Length Description
QRNID BINARY 9 Collection ID.
QRNNM CHAR 10 Collection name.
QRNDSC CHAR 72 Collection description.
QRNVER BINARY 4 Performance data collector
version.
QRNMOD BINARY 4 Collection mode entered from DST
(Dedicated Service Tools):
1 Trace
2 StatsFlat
3 StatsHier
4 Hardware
QRNTCR CHAR 26 Collection creation time in
timestamp form
yyyy-mm-dd-hh.mm.ss.uuuuuu
QRNTSR CHAR 26 Start collection.
QRNTSD CHAR 26 Start collection complete.
QRNTEN CHAR 26 Stop collection.
QRNTED CHAR 26 Stop collection complete.
QRNTSS CHAR 26 Time at which collection was
suspended.
QRNTRZ CHAR 26 Time at which collection was
resumed from a suspend.
QRNTTS PD (20,0) Total time (microseconds) spent in
a suspended state.
QRNTRS CHAR 26 Time at which collection was reset.
QRNEVT BINARY 9 Total number of events collected
on.
QRNWRP BINARY 9 Total number of times a trace
collection wrapped the buffer.
QRNDSZ PD (10,0) Total data size of collection in
bytes.
QRNPCR CHAR 30 Process creating the collection.

Appendix B. Performance Data—Performance Explorer 437

 Table 79. File QAYPERUNI (continued)
Field Name Data Type Field Length Description
| QRNTSC BINARY 9 Task count of the task creating the
| collection — low order 4 bytes.
QRNTNM CHAR 16 Task name creating the collection.
QRNUSR CHAR 8 User ID of person issuing
collection.
QRNTSY CHAR 8 Host system collection was made
on.
QRNSER CHAR 8 Host system serial number.
QRNTYP CHAR 4 Host system type (for example,
9402, 9404, etc.).
QRNMDL CHAR 4 Host system model number.
QRNSSY CHAR 8 System collection was started from
native or RS6000.
QRNCNV BINARY 4 Conversion factor used by report
program.
QRNPGS PD (20,0) Total pages of memory on system
collection was made on.
QRNLIC CHAR 3 Licensed internal code level.
QRNXPF CHAR 3 XPF code level.
QRNSVR CHAR 6 System VRM (Version Release
Modification) level.
QRNDIP BINARY 9 Number of IPLs to DST.
QRNXIP BINARY 9 Number of IPLs to XPF.
QRNASP BINARY 9 Number of configured Auxiliary
Storage Pools (ASP) (DASD).
QRNLDS BINARY 9 Number of configured logical
DASD.
QRNDAR BINARY 9 Number of data areas for trace
and statistic data.
QRNTEX BINARY 9 Number of task or processes
examined by the collector.
QRNTNO BINARY 9 Number of task or processes not
added because they existed in
another collection.
QRNNOI BINARY 9 ID of collection containing tasks or
processes that were not added to
the current collection.
QRNTAD BINARY 9 Number of tasks or processes
added at collection start.
QRNPAD BINARY 9 Number of processes added at
collection start.
QRNTCT BINARY 9 Number of task or processes in
the collection.
QRNPCT BINARY 9 Number of processes in the
collection.

438 OS/400 Work Management V4R4

 Table 79. File QAYPERUNI (continued)
Field Name Data Type Field Length Description
QRNTHC PD (10,0) Number of threads in the
collection.
QRNLIT PD (10,0) Number of Licensed Internal Code
tasks in the collection.
QRNPFC HEX 8 Number of feature code.
QRNMEC PD (10,0) Missed event count.
QRNTCS PD (20,0) Total collector size.
QRNNOP BINARY 2 Number of processors.
| QRNHTC HEX 16 Task count (UNIQUE).

File Name–QAYPECOCFG
Contains configuration object information about a collection common to all modes.
These fields correspond to some of the parameters specified on the ADDPEXDFN
command (or when creating a configuration).
Table 80. File QAYPECOCFG
Field Name Data Type Field Length Description
QCOJOB CHAR 10 Job parameter value or list file
name.
QCOTNM CHAR 16 Task name parameter value or list
file name.
QCOTNB CHAR 10 Task number parameter value or
list file name.
QCOCLD CHAR 1 Collect on children (Y or N).
QCOLBK CHAR 1 Enable LIC bracketing during MI
complex instructions.
QCOMI CHAR 10 MI program list file name.
QCOLIC CHAR 10 LIC module list file name.
QCOCPX CHAR 10 MI complex instruction parameter
value on list file name.
QCOMET CHAR 10 Metric list file name.

File Name–QAYPEHWCFG
Contains configuration object information about a hardware mode collection. These
fields correspond to some of the parameters specified on the ADDPEXDFN
command (or when creating a configuration).
Table 81. File QAYPEHWCFG
Field Name Data Type Field Length Description
QHWOPT CHAR 15 Hardware mode option.
QHWTSO CHAR 15 Timeslice option.
QHWFET BINARY 4 First hardware event table entry
(index).
QHWLET BINARY 4 Last hardware event table entry
(index).

Appendix B. Performance Data—Performance Explorer 439

 Table 81. File QAYPEHWCFG (continued)
Field Name Data Type Field Length Description
QHWFIT BINARY 4 First instruction count table entry
(index).
QHWLIT BINARY 4 Last instruction count table entry
(index).
QHWITS BINARY 9 Interval time slice.

File Name–QAYPEFQCFG
Contains configuration object information for a collection’s hardware PMC selection
and pop frequency for each of the PMCs. These fields correspond to some of the
parameters specified on the ADDPEXDFN command (or when creating a
configuration).
Table 82. File QAYPEFQCFG
Field Name Data Type Field Length Description
QFQTE BINARY 9 Hardware table entry number.
QFQCNT BINARY 9 Hardware counter (PMC number).
QFQFRQ BINARY 9 Hardware frequency in
milliseconds.

File Name–QAYPECICFG
Contains configuration object information for a collection. This file contains basic
information regarding the configuration used for a collection. These fields
correspond to some of the parameters specified on the ADDPEXDFN command (or
when creating a configuration).
Table 83. File QAYPECICFG
Field Name Data Type Field Length Description
QCINM CHAR 10 Configuration object name.
QCIDSC CHAR 72 Configuration object description.
QCIMOD CHAR 10 Collection mode:
STATS
TRACE
HDW
QCIUSR CHAR 8 User who created the configuration.
QCISYS CHAR 8 Target system configured for.

File Name–QAYPESTCFG
Contains configuration object information about a statistical mode collection. These
fields correspond to some of the parameters specified on the ADDPEXDFN
command (or when creating a configuration).
Table 84. File QAYPESTCFG
Field Name Data Type Field Length Description
QSTORG CHAR 10 Organization of statistical
collection (flat or hierarchical).

440 OS/400 Work Management V4R4

 Table 84. File QAYPESTCFG (continued)
Field Name Data Type Field Length Description
QSTCMB CHAR 1 Combine data by task (Y or N).
QSTIOC CHAR 1 Include or exclude task I/O
counters.

File Name–QAYPETRCFG
Contains configuration object information about a trace mode collection. These
fields correspond to some of the parameters specified on the ADDPEXDFN
command (or when creating a configuration).
Table 85. File QAYPETRCFG
Field Name Data Type Field Length Description
QTRSZ BINARY 9 Maximum trace size in KB.
QTRWRP CHAR 1 Wrap trace data buffer (Y or N).

File Name–QAYPELCPLX
Contains a list of MI complex instructions to collect data on that were specified as
part of the configuration object.
Table 86. File QAYPELCPLX
Field Name Data Type Field Length Description
QLXINM CHAR 10 MI complex instruction.

File Name–QAYPELJOB
Contains a list of jobs to collect data on that were specified as part of the
configuration object.
Table 87. File QAYPELJOB
Field Name Data Type Field Length Description
QLJNM CHAR 10 Job name.
QLJUSR CHAR 10 Job user.
QLJNB CHAR 6 Job number.

File Name–QAYPELMET
Contains a list of metrics to collect data on that were specified as part of the
configuration object.
Table 88. File QAYPELMET
Field Name Data Type Field Length Description
QLMCTR BINARY 4 Metric counter (bucket) number.
QLMCAT CHAR 20 Metric category.
QLMTYP CHAR 20 Metric

Appendix B. Performance Data—Performance Explorer 441

File Name–QAYPELMI
Contains a list of MI program, module, or procedures to collect data on that were
specified as part of the configuration object.
Table 89. File QAYPELMI
Field Name Data Type Field Length Description
QLMTYP CHAR 10 MI program type.
QLMNM CHAR 10 MI program.
QLMLIB CHAR 10 MI program library.
QLMMNM CHAR 10 MI module.
QLMPNM CHAR 256 MI procedure.
QLMPSZ BINARY 9 Pane size.

File Name–QAYPELLIC
Contains a list of LIC modules to collect data on that were specified as part of the
configuration object.
Table 90. File QAYPELLIC
Field Name Data Type Field Length Description
QLLSEL BINARY 9 Selection method:
1 – Module ID
2 – Start/end address range
QLLMID CHAR 8 LIC module ID (selection method
1).
QLLSAD HEX 16 Start address of range (selection
method 2).
QLLEAD HEX 16 End address of range (selection
method 2).
QLLPSZ BINARY 9 Pane size.

File Name–QAYPELNAMT
Contains a list of task names to collect data on that were specified as part of the
configuration object.
Table 91. File QAYPELNAMT
Field Name Data Type Field Length Description
QLTTNM CHAR 16 Task name.

File Name–QAYPELNUMT
Contains a list of task numbers to collect data on that were specified as part of the
configuration object.
Table 92. File QAYPELNUMT
Field Name Data Type Field Length Description
QLTTNB CHAR 8 Task number.

442 OS/400 Work Management V4R4

File Name–QAYPEMICPX
Contains short and long descriptions for each MI complex instruction collected on.
Table 93. File QAYPEMICPX
Field Name Data Type Field Length Description
QCPIDX BINARY 4 Index of MI complex instructions.
QCPSNM CHAR 20 Short description.
QCPLNM CHAR 50 Long description.

File Name–QAYPEEVENT
Contains short and long descriptions for each event type and subtype.
Table 94. File QAYPEEVENT
Field Name Data Type Field Length Description
QEVTY BINARY 4 Event type (category).
QEVSTY BINARY 4 Event subtype (metric).
QEVSN CHAR 20 Short type description.
QEVSSN CHAR 20 Short subtype description.
QEVLN CHAR 50 Long type description.
QEVSLN CHAR 50 Long subtype description.

File Name–QAYPEHWMAP
Contains the hardware mapping data. It is generated for statistics and trace modes
and maps PMC table entries to their corresponding description.
Table 95. File QAYPEHWMAP
Field Name Data Type Field Length Description
QHWTE BINARY 9 Table entry (time slice slot) number.
QHWPMC BINARY 4 PMC number.
QHWNM CHAR 20 Event or instruction name.

File Name–QAYPELICI
Contains the licensed internal code (LIC) address resolution mapping information
for a collection.
Table 96. File QAYPELICI
Field Name Data Type Field Length Description
QLITBT HEX 16 Trace back table entry address for
the procedure.
QLIPNM CHAR 12 LIC procedure (shortened name).
QLIMNM CHAR 12 LIC module (shortened name).
QLIPID BINARY 9 Procedure name ID.
QLIMID BINARY 9 Module name ID.
QLISAD HEX 16 Procedure code start address.

Appendix B. Performance Data—Performance Explorer 443

 Table 96. File QAYPELICI (continued)
Field Name Data Type Field Length Description
QLIEAD HEX 16 Procedure code end address (key
field).
QLICSZ PD (20,0) Procedure code size.
QLILNG PD (20,0) Language type.
QLIMTM CHAR 16 Module creation timestamp.
QLIMSA HEX 16 LIC module start address.
QLIRUN CHAR 8 LIC module RU nickname.

File Name–QAYPEMII
Contains machine interface (MI) program address resolution mapping information
for a collection.
Table 97. File QAYPEMII
Field Name Data Type Field Length Description
QMITBT HEX 16 Trace back table entry address for
the procedure.
QMIMNM CHAR 30 MI module name.
QMIMQL CHAR 30 MI module name qualifier.
QMIPNM CHAR 30 MI program name.
QMIPQL CHAR 30 MI program name qualifier.
QMIPLN BINARY 9 Procedure name length.
QMIPID BINARY 9 Procedure name ID.
QMICST HEX 16 Procedure code start address.
QMICEN HEX 16 Procedure code end address (key
field).
QMIPSZ PD (20,0) Procedure code size.
QMILNG PD (20,0) Language type.
QMITIM CHAR 16 Module timestamp.

File Name–QAYPESEGI
Contains field definitions that are used for segment address resolution mapping.
Table 98. File QAYPESEGI
Field Name Data Type Field Length Description
QSGSAD HEX 16 Segment start address.
QSGEAD HEX 16 Segment end address (key field).
QSGTYP HEX 4 Segment type.
QSGSZ PD (5,0) Segment size in pages.
QSGNFL HEX 2 Segment new flags.
QSGFLG HEX 2 Segment flag.
QSGASP BINARY 4 Segment ASP number.
QSGXSZ BINARY 4 Segment block transfer size.

444 OS/400 Work Management V4R4

 Table 98. File QAYPESEGI (continued)
Field Name Data Type Field Length Description
QSGBL CHAR 1 Flag indicating a big or little
segment.
QSGPT CHAR 1 Flag indicating permanent or
temporary segment.
| QSGHLY CHAR 1 Flag indicating a fragmented
| segment.
QSGRES CHAR 1 Flag indicating a resident segment.
QSGIRG CHAR 1 Flag indicating segment in resident
address range.
QSGPRE CHAR 1 Flag indicating a preassigned
segment.
QSGAG CHAR 1 Flag indicating an access group
segment.
QSGMSD CHAR 1 Flag indicating a main store dump
segment.
QSGDIR CHAR 1 Flag indicating a directory
segment.
QSGCRI CHAR 1 Flag indicating a critical segment.
QSGMAP CHAR 1 Flag indicating a SID map
segment.
QSGIPL CHAR 1 Flag indicating the segment was
created in this IPL.
QSGOVR CHAR 1 Flag indicating segment
overflowed.
QSGREL CHAR 1 Flag indicating segment is real.
QSGDES CHAR 1 Flag indicating segment was
destroyed.
QSGBSA HEX 16 Base segment start address.
QSGBSZ PD (5,0) Base segment size.
QSGTY HEX 2 Segment object type.
QSGSTY HEX 2 Segment object subtype.
QSGONM CHAR 30 Segment object name.
QSGOCX CHAR 30 Segment object context name.
QSGOSZ PD (10,0) Base segment object size.
QSGDB CHAR 1 Flag indicating segment is
database.

File Name–QAYPETASKI
Contains field definitions that are used for process or task resolution mapping.
Table 99. File QAYPETASKI
Field Name Data Type Field Length Description
| QTSCNT BINARY 9 Task count low order 4 bytes.
QTSADR HEX 16 Task address.

Appendix B. Performance Data—Performance Explorer 445

 Table 99. File QAYPETASKI (continued)
Field Name Data Type Field Length Description
QTSNM CHAR 16 Task name.
QTSID CHAR 4 Task ID.
QTSPL BINARY 4 Pool number task is running in.
QTSRES CHAR 1 Task resident flag.
QTSMI CHAR 1 MI task flag.
QTSPRI BINARY 4 Initial task priority.
QTSTSL PD (20,0) Task time slice.
QTSAST PD (20,0) Task active time at start of
collection.
QTSASP PD (20,0) Task active time at stop of
collection.
QTSRST PD (20,0) Task running time at start of
collection.
QTSRSP PD (20, 0) Task running time at stop of
collection.
QTSXST CHAR 1 Task existed at start of collection.
QTSXSP CHAR 1 Task existed at stop of collection.
QTSJNM CHAR 10 Job name.
QTSJUS CHAR 10 Job user.
QTSNB CHAR 6 Job number.
QTSPID BINARY 4 Partition ID.
| QTSCIT PD (10,0) Task count of initial thread — low
| order 4 bytes.
QTSITF CHAR 1 Initial thread flag.
QTSTHI HEX 16 Thread identifier.
QTSAP1 PD (20,0) Accumulated PMC 1
QTSAP3 PD (20,0) Accumulated PMC 4
| QTSTCT PD (20,0) Task count (UNIQUE).
| QTSFTC PD (20,0) Task count of initial thread — full 8
| bytes.

File Name–QAYPENMI
Contains a list of MI program, module, and procedures that data was collected on.
This list is determined through address resolution mapping.
Table 100. File QAYPENMI
Field Name Data Type Field Length Description
QNMOFF BINARY 9 Offset key into name list.
QNMLNM CHAR 256 MI long name.

File Name–QAYPENLIC
Contains a list of LIC module and procedures that data was collected on. This list is
determined through address resolution mapping.

446 OS/400 Work Management V4R4

 Table 101. File QAYPENLIC
Field Name Data Type Field Length Description
QNLOFF BINARY 9 Offset key into name list.
QNLLNM CHAR 256 LIC long name.

File Name–QAYPETIDX
Contains common trace data for all events. This serves as an index file. Use this as
an index into the actual event files.
Table 102. File QAYPETIDX
Field Name Data Type Field Length Description
QRECN BINARY 9 Record number of trace event
(unique).
QTITY BINARY 4 Resource event type.
QTISTY BINARY 4 Resource event subtype.
QTIPRN BINARY 4 Processor number.
QTITIM PD (20,0) Offset (microseconds) from a base
timestamp value.
QTIESZ BINARY 4 Trace entry size in bytes.
QTIMIS BINARY 4 Number of missed entries due to
unpinned data area buffer.
QTIBSY BINARY 4 Number of missed entries due to
an already active entry.
| QTITCT BINARY 9 Task count — low order 4 bytes.
QTIH01 PD (10,0) PMC (hardware counter) number
1.
QTIH02 PD (10,0) PMC (hardware counter) number
2.
QTIH03 PD (10,0) PMC (hardware counter) number
3.
QTIH04 PD (10,0) PMC (hardware counter) number
4.
QTIPRI BINARY 4 Process and task priority.
QTITSP TIMESTAMP Time of Day timestamp of event.
| QTIFTC PD (20,0) Task count full 8 bytes.

File Name–QAYPEASM
Contains Auxiliary Storage Management (ASM) data.
Table 103. File QAYPEASM
Field Name Data Type Field Length Description
QRECN BINARY 9 Record number of trace event
(unique).
QAMSPA HEX 16 MI suspend point address.
QAMNIA HEX 16 Next instruction address.
QAMSAD HEX 16 Starting address of segment.

Appendix B. Performance Data—Performance Explorer 447

 Table 103. File QAYPEASM (continued)
Field Name Data Type Field Length Description
QAMSOF HEX 6 Offset from the start of the
segment.
QAMPGS PD (20,0) Number of pages in the segment.
QAMSTS BINARY 4 Status flag.
QAMNAC BINARY 4 ASM pages outside the access
group.
QAMASP BINARY 4 ASP number.

File Name–QAYPEBASE
Contains base event data.
Table 104. File QAYPEBASE
Field Name Data Type Field Length Description
QRECN BINARY 9 Record number of trace event
(unique).
QBSTBT HEX 16 Trace back table address.
QBSTAD HEX 16 Task address.
QBSIAD HEX 16 Instruction address.
QBSMIN BINARY 4 Minor system reference code
(SRC).
QBSIPL CHAR 24 IPL phase text.
QBSR03 PD (20,0) General purpose register number 3.
QBSR04 PD (20,0) General purpose register number 4.
QBSR05 PD (20,0) General purpose register number 5.
QBSR06 PD (20,0) General purpose register number 6.
QBSR07 PD (20,0) General purpose register number 7.
QBSR08 PD (20,0) General purpose register number 8.
QBSR09 PD (20,0) General purpose register number 9.
QBSR10 PD (20,0) General purpose register number
10.
QBSEXI HEX 4 Exception ID.
QBSIXI HEX 4 IMPI exception ID.
QBSETY BINARY 4 Exception type.
QBSFAD HEX 16 Faulting address.
QBSEPA HEX 16 Address of program causing
exception.
QBSPIO BINARY 9 Offset of program instruction.
QBSIIN PD (20, 0) Interrupt information.
QBSPAD HEX 16 Program address.
QBSAGM PD (20, 0) Activation group mark.
QBSCAD HEX 16 Caller instruction address.
QBSCTB HEX 16 Caller trace back table address.

448 OS/400 Work Management V4R4

 Table 104. File QAYPEBASE (continued)
Field Name Data Type Field Length Description
QBSWOA HEX 16 Wait object address.
QBSWOD BINARY 9 Wait object description.
QBSWOR PD(5,0) Wait object reason code.
QBSPTY PD(5,0) Apparent task priority.
QBSTWC PD(10,0) Task wait cycles.
QBSTSC PD(10,0) Task wait cycles.
QBSCTC PD(10,0) Current task count — low order 4
bytes.
QQBSR11 PD(20,0) General purpose register 11
QQBSR12 PD(20,0) General purpose register 12
| QBSFTC PD (20,0) Task count — full 8 bytes.

File Name–QAYPEDASD
Contains DASD event data.
Table 105. File QAYPEDASD
Field Name Data Type Field Length Description
QRECN BINARY 9 Record number of trace event
(unique).
QDDVAD HEX 16 Virtual segment and object
address.
QDDPGS PD (20,0) Number of pages referenced.
QDDUNB BINARY 4 DASD unit number.
QDDASP BINARY 4 ASP number.
QDDMSU BINARY 4 Mirror subunit.
QDDADR PD (10,0) DASD address.
QDDARE PD (5,0) DASD area.
QDDSKP CHAR 1 Skip or no skip operation.
QDDLRC BINARY 4 DASD logical return code.
QDDBLK BINARY 4 DASD block size.
QDDPID BINARY 4 Main storage pool ID.
| QDDATC BINARY 9 Async I/O task count — low order
| 4 bytes.
QDDECT BINARY 9 Disk I/O event count.
QDDEIO CHAR 1 Flag indicating if this was an
exchange I/O operation.
QDDSPN PD(5,0) Span length of skip operation.
| QDDFTC PD (20,0) Asynch I/O task count — full 8
| bytes.

Appendix B. Performance Data—Performance Explorer 449

 File Name–QAYPEDSRV
Contains DASD server event data.
Table 106. File QAYPEDSRV
Field Name Data Type Field Length Description
QRECN BINARY 9 Record number of trace event
(unique).
QDSPRM CHAR 96 Server parameters.
QDSEXT CHAR 24 Server external data.
QDSMSG HEX 16 Address of work message area.
QDSOBJ HEX 16 Server object address.
QDSTSK CHAR 2 Server task ID.
QDSCDE BINARY 4 Termination code.

File Name–QAYPEPGFLT
Contains page fault event data.
Table 107. File QAYPEPGFLT
Field Name Data Type Field Length Description
QRECN BINARY 9 Record number of trace event
(unique).
QPGNIA HEX 16 Next instruction address.
QPGVAD HEX 16 Faulting page’s virtual address.
QPGTYP BINARY 4 Page fault type.
QPGEXC BINARY 4 Exception ID.
QPGMSP HEX 16 MI suspend point.
| QPGRTC PD(10,0) Task count of task processing the
| request — low order 4 bytes.
| QPGFTC PD (20,0) Task count of task processing the
| request — full 8 bytes.

File Name–QAYPERMPM
Contains the resource management and process management event data.
Table 108. File QAYPERMPM
Field Name Data Type Field Length Description
QRECN BINARY 9 Record number of trace event
(unique).
QRPMSP BINARY 4 Main storage pool ID.
QRPSP BINARY 4 Storage pool ID.
QRPCCI PD (5,0) Cost curve index.
QRPLWR PD (20,0) Long wait reason.
QRPITY BINARY 4 Interrupt type.
QRPOBL BINARY 4 Old main storage pool ID.
QRPCPU PD (20,0) CPU time used.

450 OS/400 Work Management V4R4

 Table 108. File QAYPERMPM (continued)
Field Name Data Type Field Length Description
QRPTIO PD (10,0) Total I/O count.
QRPMTS CHAR 1 MI time slice ended.

File Name–QAYPERMSL
Contains the resource management seize lock event data.
Table 109. File QAYPERMSL
Field Name Data Type Field Length Description
QRECN BINARY 9 Record number of trace event
(unique).
QSLETM PD (20,0) Time elapsed.
QSLSEG HEX 16 Last object segment address.
QSLOFF HEX 6 Offset from segment address of
last object.
QSLNSZ PD (10,0) Number of seizes.
QSLRET PD (10,0) Number of retries.
QSLHLD BINARY 4 Hold type.
QSLCFL BINARY 4 Last conflicting hold type.

File Name–QAYPES36
Contains the Advanced 36 event data.
Table 110. File QAYPES36
Field Name Data Type Field Length Description
QRECN BINARY 9 Record number of trace event
(unique).
Q36TSA HEX 16 Task address.
Q36ACT PD (20,0) Action ID.
Q36STA CHAR 1 State.

File Name–QAYPESAR
Contains the segment address range (SAR) data.
Table 111. File QAYPESAR
Field Name Data Type Field Length Description
QRECN BINARY 9 Record number of trace event
(unique).
QSRSPT HEX 16 MI suspend point address.
QSRNIA HEX 16 Next instruction address.
QSRSAD HEX 16 Range starting segment address.
QSRSOF HEX 6 Offset from range starting segment.
QSRPGS PD (20,0) Pages in the range.
QSRBYT PD (10,0) Bytes in the range.

Appendix B. Performance Data—Performance Explorer 451

 Table 111. File QAYPESAR (continued)
Field Name Data Type Field Length Description
QSRMPL BINARY 4 Main storage pool ID.
QSRERS HEX 16 Exchange range start segment
address.
QSRERO HEX 6 Offset from exchange range
starting segment.
QSREBY PD (10,0) Number of bytes in the exchange.
QSRBSZ PD (5,0) Block size in bytes.
QSRPLR CHAR 1 Main store buffer page list request.
QSRPNA PD (5,0) Pin Action.
QSRSTL PD (5,0) Steal status.
QSRDEN PD (5,0) Change data density.
QSRVAD HEX 16 Virtual address of page in which
error was detected.
QSRIOC PD (10,0) I/O count for operation.
QSRREQ BINARY 4 Request type.
QSRERR BINARY 4 Error action type.
QSREXI BINARY 4 Detected exception ID.
QSROPT BINARY 4 Operation type.
| QSRATC BINARY 9 ASYNCH I/O task count — low
| order 4 bytes.
QSRRET BINARY 9 If ASYNCH I/O, entry count of
event related to I/O request
| QSRFTC PD (20,0) ASYNCH I/O task count — full 8
| bytes.

File Name–QAYPEUNKWN
Contains data that is not recognized by the Performance Explorer.
Table 112. File QAYPEUNKWN
Field Name Data Type Field Length Description
QRECN BINARY 9 Record number of trace event
(unique).
QUNLEN BINARY 4 Length of data.
QUNDTA CHAR 500 Generic data field.

File Name–QAYPESTATS
Contains the basic statistics data for a collection.
Table 113. File QAYPESTATS
Field Name Data Type Field Length Description
QSTCNT BINARY 4 Starts counter and index entry
QSTTBT HEX 16 Trace back table entry address for
the procedure.

452 OS/400 Work Management V4R4

Table 113. File QAYPESTATS (continued)
Field Name Data Type Field Length Description
QSTCMI BINARY 4 Complex MI instruction index
value.
QSTNDE BINARY 9 Parent or child node entry ID.
QSTESZ BINARY 9 Total data size.
QSTPAR BINARY 9 Parent node ID.
QSTCLV BINARY 9 Procedure call level.
QSTPTY CHAR 1 Procedure type (MI or LIC).
QSTPSP HEX 16 Parent suspend point address.
QSTINV PD (20,0) Procedure invocation count
(number of times it was called).
QSTCCT PD (20,0) Procedure call count (number of
procedure called from this
procedure).
QSTXCT PD (20,0) Number of MI complex instructions
called.
QHWI01 PD (20,0) Inline PMC (hardware counter)
number 1.
QHWI02 PD (20,0) Inline PMC (hardware counter)
number 2.
QHWI03 PD (20,0) Inline PMC (hardware counter)
number 3.
QHWI04 PD (20,0) Inline PMC (hardware counter)
number 4.
QSTICP PD (20,0) Inline CPU time in microseconds
(software counter).
QSWI01 PD (20,0) Inline counter number 1 data
(software counter).
QSWI02 PD (20,0) Inline counter number 2 data
(software counter).
QSWI03 PD (20,0) Inline counter number 3 data
(software counter).
QSWI04 PD (20,0) Inline counter number 4 data
(software counter).
QSWI05 PD (20,0) Inline counter number 5 data
(software counter).
QSWI06 PD (20,0) Inline counter number 6 data
(software counter).
QSWI07 PD (20,0) Inline counter number 7 data
(software counter).
QSWI08 PD (20,0) Inline counter number 8 data
(software counter).
QSWI09 PD (20,0) Inline counter number 9 data
(software counter).
QSWI10 PD (20,0) Inline counter number 10 data
(software counter).

Appendix B. Performance Data—Performance Explorer 453

 Table 113. File QAYPESTATS (continued)
Field Name Data Type Field Length Description
QHWC01 PD (20,0) Cumulative PMC (hardware
counter) number 1.
QHWC02 PD (20,0) Cumulative PMC (hardware
counter) number 2.
QHWC03 PD (20,0) Cumulative PMC (hardware
counter) number 3.
QHWC04 PD (20,0) Cumulative PMC (hardware
counter) number 4.
QSTCCP PD (20,0) Cumulative CPU time in
microseconds.
QSWC01 PD (20,0) Cumulative counter number 1 data
(software counter).
QSWC02 PD (20,0) Cumulative counter number 2 data
(software counter).
QSWC03 PD (20,0) Cumulative counter number 3 data
(software counter).
QSWC04 PD (20,0) Cumulative counter number 4 data
(software counter).
QSWC05 PD (20,0) Cumulative counter number 5 data
(software counter).
QSWC06 PD (20,0) Cumulative counter number 6 data
(software counter).
QSWC07 PD (20,0) Cumulative counter number 7 data
(software counter).
QSWC08 PD (20,0) Cumulative counter number 8 data
(software counter).
QSWC09 PD (20,0) Cumulative counter number 9 data
(software counter).
QSWC10 PD (20,0) Cumulative counter number 10
data (software counter).
QSTPID BINARY 4 Partition ID.
QIITAO BINARY 9 Inline tracked asynchronous I/O
out.
QIIAO BINARY 9 Inline asynchronous I/O out.
QIIWRT BINARY 9 Inline writes.
QIIPWR BINARY 9 Inline permanent writes.
QIISDR BINARY 9 Inline synchronous database
reads.
QIISNR BINARY 9 Inline synchronous non-database
reads.
QIISDW BINARY 9 Inline synchronous database
writes.
QIISNW BINARY 9 Inline synchronous non-database
writes.
QIIADR BINARY 9 Inline synchronous database
reads.

454 OS/400 Work Management V4R4

 Table 113. File QAYPESTATS (continued)
Field Name Data Type Field Length Description
QIIANR BINARY 9 Inline synchronous non-database
reads.
QIIADW BINARY 9 Inline synchronous database
writes.
QIIANW BINARY 9 Inline synchronous non-database
writes.
QIIAGF BINARY 9 Inline access group faults.
QIIPWA BINARY 9 Inline I/O pending waits.
QIISWA BINARY 9 Inline synchronous I/O waits.
QCITAO BINARY 9 Cumulative tracked asynchronous
I/O out.
QCIAO BINARY 9 Cumulative asynchronous I/O out.
QCIWRT BINARY 9 Cumulative write.
QCIPWR BINARY 9 Cumulative permanent writes.
QCISDR BINARY 9 Cumulative synchronous database
reads.
QCISNR BINARY 9 Cumulative synchronous
non-database reads.
QCISDW BINARY 9 Cumulative synchronous database
writes.
QCISNW BINARY 9 Cumulative synchronous
non-database writes.
QCIADR BINARY 9 Cumulative asynchronous
database reads.
QCIANR BINARY 9 Cumulative asynchronous
non-database reads.
QCIADW BINARY 9 Cumulative asynchronous
database writes.
QCIANW BINARY 9 Cumulative asynchronous
non-database writes.
QCIAGF BINARY 9 Cumulative access group faults.
QCIPWA BINARY 9 Cumulative I/O pending waits.
QCISWA BINARY 9 Cumulative synchronous I/O waits.

File Name–QAYPEPSUM
Contains statistic profiling summary data. Statistics profiling is analogous to
SAM-like profiling. SAM (Sample Address Monitor) is a performance tool.
Table 114. File QAYPEPSUM
Field Name Data Type Field Length Description
QPFPID BINARY 4 Partition ID associated with the
window summary data.
QPFWDW BINARY 9 Number of windows in the partition.

Appendix B. Performance Data—Performance Explorer 455

 Table 114. File QAYPEPSUM (continued)
Field Name Data Type Field Length Description
QPFWCT PD (20,0) Number of PMC samples that
occurred during collection on tasks
in a window.
QPFTCT PD (20,0) Number of PMC samples that
occurred during the collection on
tasks in or outside a profile window.

File Name–QAYPEPWDW
Contains statistic profiling window data for a collection.
Table 115. File QAYPEPWDW
Field Name Data Type Field Length Description
QPFPID BINARY 4 Partition ID associated with the
window.
QPFWID BINARY 9 Window ID in the partition.
QPFSAD HEX 16 Address of the first instruction in
the window.
QPFEAD HEX 16 Address of the last instruction in
the window.
QPFNPN BINARY 9 Number of panes in the window.
QPFDPN BINARY 9 Number of window panes with
data.
QPFPNB BINARY 9 Number of bytes that span a pane.
QPFWNB BINARY 9 Number of bytes that span a
window.
QPFWCT PD (20,0) Number of PMC samples that
occurred during collection on tasks
in the window.

File Name–QAYPEPPANE
Contains statistic profiling pane data for a collection.
Table 116. File QAYPEPPANE
Field Name Data Type Field Length Description
QPNPID BINARY 4 Partition ID associated with the
pane.
QPNWID BINARY 9 Window ID in the partition.
QPNID BINARY 9 Pane ID in the window.
QPNTBT HEX 16 Trace back table entry address for
the procedure containing the first
instruction in the pane.
QPNSAD HEX 16 Address of the first instruction in
the pane.
QPNCNT PD (10,0) Number of PMC samples that
occurred during collection on tasks
in the pane.

456 OS/400 Work Management V4R4

 Table 116. File QAYPEPPANE (continued)
Field Name Data Type Field Length Description
QPNSTM BINARY 9 MI statement number associated
with the instruction address. This
will be 0 if the procedure is not a
MI procedure.
QPNSTF HEX 8 MI statements mapping state to
instructions for procedures in the
pane: 235xx2xxxx’>
00000000
Pane spans a single HLL
statement, 1 instruction to
1 HLL statement.
80000000
Pane instruction range
spans more that one
procedure.
40000000
Pane instruction multiple
HLL statements.
20000000
Multiple HLL statements
map to first instruction in
pane or any combination
of these.

File Name–QAYPELBRKT
Contains Licensed Internal Code (LIC) bracketing data.
Table 117. File QAYPELBRKT
Field Name Data Type Field Length Description
QRECN BINARY 9 Record number of trace events
(unique).
QLBTBT HEX 16 Trace back table entry address for
the procedure.
QLBIAD HEX 16 Instruction address.
QLBR03 HEX 16 Value in general purpose register
3.
QLBCIA HEX 16 Caller instruction address.
QLBCTB HEX 16 Caller trace back table address for
procedure.

File Name–QAYPEMIUSR
Contains Machine Interface (MI) user event data.
Table 118. File QAYPEMIUSR
Field Name Data Type Field Length Description
QRECN BINARY 9 Record number of trace events
(unique).

Appendix B. Performance Data—Performance Explorer 457

 Table 118. File QAYPEMIUSR (continued)
Field Name Data Type Field Length Description
QMUCDE BINARY 9 User specified code.
QMUPTR BINARY 4 Number of MI pointers.
QMUDTA CHAR 240 User data.

File Name–QAYPEMBRKT
Contains Machine Interface (MI) program bracketing data.
Table 119. File QAYPEMBRKT
Field Name Data Type Field Length Description
QRECN BINARY 9 Record number of trace events
(unique).
QMBTBT HEX 16 Trace back table entry address for
the procedure.
QMBIAD HEX 16 Instruction address.
QMBIDX BINARY 4 Instruction index.
QMBHLL BINARY 9 High level language statement
number.
QMBCIA HEX 16 Calling program’s instruction
address.
QMBCTB HEX 16 Calling program’s trace back table
address.

File Name–QAYPEMIPTR
Contains the addresses of the MI pointers referenced in QAYPEMIUSR.
Table 120. File QAYPEMIPTR
Field Name Data Type Field Length Description
QRECN BINARY 9 Record number of trace events
(unique).
QMIPTR HEX 16 MI pointer address.

File Name–QAYPEUSRDF
Contains user-defined bracketing hook data.
Table 121. File QAYPEUSRDF
Field Name Data Type Field Length Description
QRECN BINARY 9 Record number of trace events
(unique).
QUSDTA CHAR 500 Generic data field (variable length).

File Name–QAYPEHMON
Contains the hardware monitor data. It is generated when the hardware monitor
mode (*HDW) is used to collect the data.

458 OS/400 Work Management V4R4

 Table 122. File QAYPEHMON
Field Name Data Type Field Length Description
QRECN BINARY 9 Record number of trace events
(unique).
QHMPRC BINARY 4 Processor number.
QHMNM CHAR 20 Event or instruction name.
QHMCNT PD (20,0) PMC (performance measurement
counter) accumulated count
provides a count of events as
selected by MMRC0.
QHMMCR HEX 16 MMCR0 (monitor mode control
register) selects events count by
PMCs (constant value when option
is instruction counts).
QHMIMR HEX 16 IMR (instruction match register)
selects instructions to be counted
by PMCs.
QHMMTE BINARY 9 Table entry (time slice slot)
number.
QHMPMC BINARY 4 PMC number (0 when option is
instruction counts).

File Name–QAYPEHTOT
Contains hardware monitor totals data. It is generated when the hardware monitor
mode (*HDW) is used to collect the data. The number depict totals for the entire
collection. This is only available with the instruction counts option.
Table 123. File QAYPEHTOT
Field Name Data Type Field Length Description
QHTPRC BINARY 4 Processor number.
QHTINS PD (20,0) Total number of instructions.
QHTCYC PD (20,0) Total number of cycles.
QHTRNC PD (20,0) Total number of run cycles.

File Name–QAYPERLS
Contains the version of the PEX database repository. This is used to determine if an
attempt is made to save data into an incompatible database repository.
Table 124. File QAYPERLS
Field Name Data Type Field Length Description
QRLVRM CHAR 6 Release, version, and modification
level of the system when the DBs
were created.
QRLLVL BIN 4 PEX level indicator that the
database repository can support.
QHTCYC PD (20,0) Total number of cycles.
QHTRNC PD (20,0) Total number of run cycles.

Appendix B. Performance Data—Performance Explorer 459

 File Name–QAYPEJVA
Contains the Java event data.
Table 125. File QAYPEJVA
Field Name Data Type Field Length Description
QRECN BINARY 9 Record number (UNIQUE).
QJVPCA HEX 16 Java permanent class address.
QJVOBN PD (20,0) Java object number.
QJVEID PD (20,0) Garbage collection event ID.
QJVOBA HEX 16 Garbage collection object address.
QJVTHA HEX 16 Java thread address.
QJVGCD PD (20,0) Java garbage collection event
data.
QJVGST CHAR 26 Java garbage collection sweep
start timestamp.
QJVOAC PD (20,0) Java garbage sweep object alive
count.
QJVODC PD (20,0) Java garbage sweep object dead
count.
QJVOFC PD (20,0) Java garbage sweep object final
count.
QJVBAL PD (20,0) Java bytes allocated since last
garbage sweep.
QJVBAT PD (20,0) Java total bytes allocated.
QJVNOP PD (20,0) Java new operations count.
QJVDOP PD (20,0) Java delete operations count.
QJVTHI HEX 16 Java thread ID.
QJVTHH PD (10,0) Java thread handle.
QJVTHF PD (10,0) Java thread flags.
QJVTHP PD (10,0) Java thread priority.
| QJVTHC BINARY 9 Java thread task count — low
| order 4 bytes.
QJVTID PD (10,0) Java transition ID.
QJVTCS PD (10,0) Java transition cause.
QJVRTC PD (10,0) Java transition requesting task
count.
QJVTIA HEX 16 Java transition instruction address.
QJVTD1 PD (20,0) Java transition data 1.
QJVTD2 PD (20,0) Java transition data 2.
QJVLOI PD (10,0) Java library operation ID.
QJVLNM CHAR 32 Java library name.
QJVTSI PD (10,0) Java transform step ID.
QJVREI PD (10,0) Java relative event ID.
| QJVHTT PD (20,0) Java thread task count — full 8
| bytes.

460 OS/400 Work Management V4R4

File Name–QAYPEJVCI
Contains PEX Java class information.
Table 126. File QAYPEJVCI
Field Name Data Type Field Length Description
QJVCKY PD (20,0) Java class key.
QJVCNI BINARY 9 Java class name ID.
QJVOIS PD (20,0) Java object instance size.

File Name–QAYPEJVMI
Contains PEX Java method information.
Table 127. File QAYPEJVMI
Field Name Data Type Field Length Description
QJVMKY PD (20,0) Java method key.
QJVMNI BINARY 9 Java method name ID.
QJVMSI BINARY 9 Java method signature.
QJVMCP HEX 16 Java method class ptr.

File Name–QAYPEJVNI
Contains PEX Java name information.
Table 128. File QAYPEJVNI
Field Name Data Type Field Length Description
QJVNMO BINARY 9 Offset into name list.
QJVNAM GRAPHIC 4096 Java long name.
Variable length field
Allocated length: 256
CCSID: 13488

Appendix B. Performance Data—Performance Explorer 461

462 OS/400 Work Management V4R4
Appendix C. IBM-Supplied Object Contents
This appendix contains the contents of most of the IBM-supplied objects with the
object types of Class (CLS), Job Description (JOBD), Job Queue (JOBQ), and
Subsystem Description (SBSD). For each object, this figure provides:
v Object name
v Object description
v Command used to create the object
v Object parameters other than the default parameters

The objects are grouped by object type.

Note: The IBM-supplied subsystem descriptions have been provided as examples

and as a backup for user-created subsystem descriptions. Therefore, we
recommend that you not modify the subsystem descriptions in libraries
QSYS and QGPL. You should make copies of the subsystem descriptions
from these libraries and make changes to the copies.

IBM-Supplied Classes
Table 129. Contents of IBM-Supplied Class Objects (CLS)–CRTCLS
Object Description Parameters Other Than Default
QARBCLS System arbiter class CLS(QSYS/QARBCLS)
RUNPTY(0)
TIMESLICE(1000)
PURGE(*YES)
DFTWAIT(4)
CPUTIME(*NOMAX)
MAXTMPSTG(*NOMAX)
AUT(*EXCLUDE)
TEXT(’SYSTEM ARBITER CLASS’)
QBATCH Default batch job class CLS(QGPL/QBATCH)
TIMESLICE(5000)
PURGE(*NO)
DFTWAIT(120)
TEXT(’Batch Subsystem Class’)
QCTL Controlling subsystem class CLS(QSYS/QCTL)
RUNPTY(10)
TIMESLICE(2000)
DFTWAIT(30)
AUT(*CHANGE)
TEXT(’Controlling Subsystem Class’)
QCASERVR Client Access/400 Server CLS(QGPL/QCASERVR)
class RUNPTY(20)
TIMESLICE(500)
DFTWAIT(30)
AUT(*USE)
TEXT(’Client Access Server Class’)
QDIALOCAL Class for QDIALOCAL job CLS(QGPL/QDIALOCAL)
owned by QPGMR RUNPTY(20)
TIMESLICE(2000)
DFTWAIT(30)
TEXT(’Class for QDIALOCAL Job’)

© Copyright IBM Corp. 1997, 1999 463

Table 129. Contents of IBM-Supplied Class Objects (CLS)–CRTCLS (continued)
Object Description Parameters Other Than Default
QDSNX DSNX class CLS(QGPL/QDSNX)
RUNPTY(50)
DFTWAIT(300)
AUT(*EXCLUDE)
TEXT(’DSNX Subsystem Class’)
QFNC Finance subsystem class CLS(QGPL/QFNC)
RUNPTY(20)
TIMESLICE(2000)
DFTWAIT(30)
TEXT(’Finance Subsystem Class’)
QINDUSR Indirect user job class CLS(QGPL/QINDUSR)
RUNPTY(50)
TIMESLICE(5000)
DFTWAIT(300)
PURGE(*NO)
TEXT(’Class for Indirect User Job’)
QINTER Interactive subsystem class CLS(QGPL/QINTER)
RUNPTY(20)
TIMESLICE(2000)
DFTWAIT(30)
TEXT(’Interactive Subsystem Class’)
QLPINSTALL Licensed program CLS(QSYS/QLPINSTALL)
installation class PURGE(*NO)
DFTWAIT(120)
AUT(*EXCLUDE)
TEXT(’Class for LP Install’)
QMAILP Host mail printing class CLS(QGPL/QMAILP)
TIMESLICE(5000)
PURGE(*NO)
DFTWAIT(120)
TEXT(’Host Mail Printing Class’)
QMONCLS Monitor subsystem class CLS(QSYS/QMONCLS)
RUNPTY(0)
TIMESLICE(1000)
PURGE(*YES)
DFTWAIT(4)
CPUTIME(*NOMAX)
MAXTMPSTG(*NOMAX)
AUT(*EXCLUDE)
TEXT(’SUBSYSTEM MONITOR CLASS’)
QPGMR Programmer subsystem CLS(QGPL/QPGMR)
class RUNPTY(30)
TIMESLICE(5000)
DFTWAIT(30)
TEXT(’Programmer Subsystem Class’)
QSNADS SNADS class CLS(QGPL/QSNADS)
RUNPTY(40)
TIMESLICE(5000)
DFTWAIT(30)
TEXT(’SNADS Subsystem Class’)

464 OS/400 Work Management V4R4

Table 129. Contents of IBM-Supplied Class Objects (CLS)–CRTCLS (continued)
Object Description Parameters Other Than Default
QSPCICLS Interactive subprocess class CLS(QSYS/QSPCICLS)
RUNPTY(60)
TIMESLICE(1000)
PURGE(*YES)
DFTWAIT(120)
CPUTIME(*NOMAX)
MAXTMPSTG(20000)
AUT(*CHANGE)
TEXT(’INTERACTIVE SUBPROCESS CLASS’)
QSPL Spooling subsystem class CLS(QGPL/QSPL)
RUNPTY(15)
PURGE(*YES)
DFTWAIT(30)
TEXT(’Spooling Subsystem Class’)
QSPL2 Spooling subsystem class CLS(QGPL/QSPL2)
RUNPTY(40)
DFTWAIT(30)
TEXT(’Spooling Subsystem Class’)
QSPL3 Spooling subsystem class CLS(QGPL/QSPL3)
RUNPTY(30)
DFTWAIT(30)
TEXT(’Spooling Subsystem Class’)
QSPL4 CLS(QGPL/QSPL4)
RUNPTY(50)
PURGE(*YES)
DFTWAIT(30)
TEXT(’Spooling Subsystem Class for Remote Writers’)
QSYSCLS Backup subsystem class CLS(QSYS/QSYSCLS)
RUNPTY(10)
TIMESLICE(2000)
DFTWAIT(30)
TEXT(’Backup Subsystem Class’)
QSYSCLS07 System subsystem class CLS(QSYS/QSYSCLS07)
RUNPTY(7)
TIMESLICE(2000)
PURGE(*YES)
DFTWAIT(30)
CPUTIME(*NOMAX)
MAXTMPSTG(*NOMAX)
AUT(*USE)
TEXT(’System subsystem class with run priority 7’)
QSYSCLS10 System subsystem class CLS(QSYS/QSYSCLS10)
RUNPTY(10)
TIMESLICE(2000)
PURGE(*YES)
DFTWAIT(30)
CPUTIME(*NOMAX)
MAXTMPSTG(*NOMAX)
AUT(*USE)
TEXT(’System subsystem class with run priority 10’)

Appendix C. IBM-Supplied Object Contents 465

Table 129. Contents of IBM-Supplied Class Objects (CLS)–CRTCLS (continued)
Object Description Parameters Other Than Default
QSYSCLS20 System subsystem class CLS(QSYS/QSYSCLS20)
RUNPTY(20)
TIMESLICE(2000)
PURGE(*YES)
DFTWAIT(30)
CPUTIME(*NOMAX)
MAXTMPSTG(*NOMAX)
AUT(*USE)
TEXT(’System subsystem class with run priority 20’)
QSYSCLS25 System subsystem class CLS(QSYS/QSYSCLS25)
RUNPTY(25)
TIMESLICE(2000)
PURGE(*YES)
DFTWAIT(30)
CPUTIME(*NOMAX)
MAXTMPSTG(*NOMAX)
AUT(*USE)
TEXT(’System subsystem class with run priority 25’)
QSYSCLS35 System subsystem class CLS(QSYS/QSYSCLS35)
RUNPTY(35)
TIMESLICE(2000)
PURGE(*YES)
DFTWAIT(30)
CPUTIME(*NOMAX)
MAXTMPSTG(*NOMAX)
AUT(*USE)
TEXT(’System subsystem class with run priority 35’)
QSYSCLS50 System subsystem class CLS(QSYS/QSYSCLS50)
RUNPTY(50)
TIMESLICE(2000)
PURGE(*YES)
DFTWAIT(30)
CPUTIME(*NOMAX)
MAXTMPSTG(*NOMAX)
AUT(*USE)
TEXT(’System subsystem class with run priority 50’)
QWCPCSUP Client Access class CLS(QGPL/QWCPCSUP)
RUNPTY(20)
TIMESLICE(500)
DFTWAIT(30)
TEXT(’Client Access Class’)

IBM-Supplied Job Descriptions

Table 130. IBM-Supplied Job Descriptions (JOBD)—CRTJOBD
Object Description Parameters Other Than Default
Q1PJBOD PM/400 Job description used JOBD(QSYS/Q1PJOBD)
by QSYSWRK OUTPTY(5)
PRTDEV(*USRPRF) OUTQ(*USRPRF)
TEXT(’PM/400 JOB DESCRIPTION USED BY QSYSWRK’)

466 OS/400 Work Management V4R4

Table 130. IBM-Supplied Job Descriptions (JOBD)—CRTJOBD (continued)
Object Description Parameters Other Than Default
QBATCH Batch subsystem job JOBD(QGPL/QBATCH)
description USER(QPGMR)
LOG(4 0 *NOLIST)
RTGDTA(QCMDB)
AUT(*EXCLUDE)
TEXT(’Batch Subsystem Job Description’)
QCTL Controlling subsystem job JOBD(QSYS/QCTL)
description USER(*RQD)
LOG(4 0 *NOLIST)
TEXT(’Controlling Subsystem Job Description’)
QCTLIJBD Controlling subsystem IGC JOBD(QSYS/QCTLIJBD)
job description USER(*RQD)
RTGDTA(QIGC)
LOG(4 0 *NOLIST)
TEXT(’Controlling Subsystem IGC JOBD’)
QDFTJOBD Default job description JOBD(QGPL/QDFTJOBD)
USER(*RQD)
RTGDTA(QCMDI)
AUT(*USE)
LOG(4 0 *NOLIST)
TEXT(’Default Job Description’)
QDIA Document interchange JOBD(QGPL/QDIA)
transaction program job USER(QSNADS)
description JOBQ(QGPL/QSNADS)
RTGDTA(’QDIATP’)
LOG(4 0 *NOLIST)
AUT(*EXCLUDE)
TEXT(’DIA Transaction Program’)
QDSNX DSNX job description JOBD(QGPL/QDSNX)
USER(QDSNX)
LOG(2 0 *MSG)
RTGDTA(QDSNX)
AUT(*EXCLUDE)
TEXT(’DSNX Subsystem Job Description’)
QESAUTON Automatic problem JOBD(QSYS/QESAUTON)
notification job description USER(QSRV)
JOBQ(QSYS/QESAUTON)
RTGDTA(’RUNPTY50’)
AUT(*EXCLUDE)
TEXT(’Job Description for Automatic Problem Notification’)
QFSIOPWK File Server I/O Processor job JOBD(QSYS QFSIOPWK)
description USER(QPGMR)
LOG(4 10 *SECLVL)
RQSDTA(CALL QSYS/QFPAACTV)
AUT(*EXCLUDE)
TEXT(’File Server I/O Processor job description’)
QFNC Finance subsystem job JOBD(QGPL/QFNC)
description USER(QFNC)
JOBQ(QGPL/QFNC)
RTGDTA(QFNC)
LOG(4 0 *NOLIST)
AUT(*EXCLUDE)
TEXT(’Finance Subsystem Job Description’)

Appendix C. IBM-Supplied Object Contents 467

 Table 130. IBM-Supplied Job Descriptions (JOBD)—CRTJOBD (continued)
Object Description Parameters Other Than Default
QHOSTPRT Host printer job description JOBD(QGPL/QHOSTPRT)
USER(QPGMR)
LOG(4 0 *NOLIST)
AUT(*EXCLUDE)
TEXT(’Host Printer Job Description’)
QINTIJBD Interactive subsystem IGC JOBD(QGPL/QINTIJBD)
job description RTGDTA(QIGC)
LOG(4 0 *NOLIST)
TEXT(’Interactive Subsystem IGC JOBD’)
QINTER Interactive subsystem job JOBD(QGPL/QINTER)
description RTGDTA(QCMDI)
LOG(4 0 *NOLIST)
TEXT(’Interactive Subsystem Job Description’)
QLPINSTALL Licensed program installation JOBD(QSYS/QLPINSTALL)
job description USER(QLPINSTALL)
JOBQ(QSYS/QLPINSTALL)
RTGDTA(INIT)
LOG(4 20 *NOLIST)
AUT(*EXCLUDE)
TEXT(’Job description for LP Install’)
QMSF Job description used by JOBD(QSYS/QMSF)
QPGMF job JOBQ(QSYS/QSYSNOMAX)
USER(*RQD)
RTGDTA(’ZMFMSF’)
LOG(4 0 *NOLIST)
AUT(*USE)
TEXT(’Job description for QMSF’)
QNFTP Transaction program job JOBD(QGPL/QNFTP)
description USER(QSNADS)
JOBQ(QGPL/QSNADS)
RTGDTA(’QNFTP’)
LOG(4 0 *NOLIST)
AUT(*EXCLUDE)
TEXT(’Transaction Program JOBD’)
QPDAUTOPAR Job description used for JOBD(QSYS/QPDAUTOPAR)
automatic problem analysis USER(QSRV)
JOBQ(QSYS/QPDAUTOPAR)
RTGDTA(’RUNPTY10’)
AUT(*EXCLUDE)
TEXT(’Job Description for Automatic Problem Analysis’)
| QPGMR Job description used by JOBD(QGPL/QPGMR)
| QPGMR subsystem USER(QPGMR)
LOG(4 0 *NOLIST)
AUT(*EXCLUDE)
RTGDTA(QCMDI)
TEXT(’Programmer Job Description’)
QPGMIJBD Programmer subsystem IGC JOBD(QGPL/QPGMIJBD)
job description USER(QPGMR)
LOG(4 0 *NOLIST)
AUT(*EXCLUDE)
RTGDTA(QIGC)
TEXT(’Programmer Subsystem IGC JOBD’)

468 OS/400 Work Management V4R4

Table 130. IBM-Supplied Job Descriptions (JOBD)—CRTJOBD (continued)
Object Description Parameters Other Than Default
QQQTEMPS DB2/400 Job Description JOBD(QSYS/QQQTEMPS)
used by QSYSWRK OUTPTY(5)
JOBQ(QSYS/QSYSNOMAX)
PRTDEV(*USRPRF)
OUTQ(*USRPRF)
TEXT(’DB2/400 JOB DESCRIPTION USED BY QSYSWRK’)
QSNADS QSNADS subsystem job JOBD(QGPL/QSNADS)
description USER(QSNADS)
RTGDTA(QSTARTUP)
LOG(4 0 *NOLIST)
JOBQ(QGPL/QSNADS)
AUT(*EXCLUDE)
TEXT(’QSNADS Subsystem Job Description’)
QSPLAFPW Advanced function print writer JOBD(QGPL/QSPLAFPW)
job description USER(QSPLJOB)
JOBQ(QGPL/QSPL)
RTGDTA(QAFPWT)
LOG(4 0 *NOLIST)
INQMSGRPY(*SYSRPYL)
TEXT(’Advanced Function Print Writer’)
QSPLDBR Database spooling reader job JOBD(QGPL/QSPLDBR)
description USER(QSPLJOB)
JOBQ(QGPL/QSPL)
RTGDTA(QRDRDB)
LOG(4 0 *NOLIST)
INQMSGRPY(*SYSRPYL)
TEXT(’Database Spooling Reader’)
QSPLDKTR Diskette spooling reader job JOBD(QGPL/QSPLDKTR)
description USER(QSPLJOB)
JOBQ(QGPL/QSPL)
RTGDTA(QRDRDK)
LOG(4 0 *NOLIST)
INQMSGRPY(*SYSRPYL)
TEXT(’Diskette Spooling Reader’)
QSPLDKTW Diskette spooling writer job JOBD(QGPL/QSPLDKTW)
description USER(QSPLJOB)
JOBQ(QGPL/QSPL)
RTGDTA(QWTRDK)
LOG(4 0 *NOLIST)
INQMSGRPY(*SYSRPYL)
TEXT(’Diskette Spooling Writer’)
QSPLERROR Spooling error job description JOBD(QSYS/QSPLERROR)
USER(QSPLJOB
JOBQ(QGPL/QBATCH)
LOG(1 0 *SECLVL)
TEXT(’Error Job Use’)
QSPLPRTW Printer spooling writer job JOBD(QGPL/QSPLPRTW)
description USER(QSPLJOB)
JOBQ(QGPL/QSPL)
RTGDTA(QWTRPT)
LOG(4 0 *NOLIST)
INQMSGRPY(*SYSRPYL)
TEXT(’Printer Spooling Writer’)

Appendix C. IBM-Supplied Object Contents 469

 Table 130. IBM-Supplied Job Descriptions (JOBD)—CRTJOBD (continued)
Object Description Parameters Other Than Default
QSPLRMTW Remote spooling writer job JOBD(QGPL/QSPLRMTW)
description USER(QSPLJOB)
JOBQ(QGPL/QSPL)
RTGDTA(QRMTWT)
LOG(4 0 *NOLIST)
INQMSGRPY(*SYSRPYL)
AUT(*USE)
TEXT(’Remote Spooling Writer’)
QSPLSTRWTR Autostart remote spooling JOBD(QGPL/QSPLSTRWTR)
writers USER(QSPLJOB)
JOBQ(QGPL/QSPL)
RTGDTA(QRMTWT)
LOG(4 0 *NOLIST)
INQMSGRPY(*SYSRPYL)
RQSTDTA(’STRRMTWTR *ALL’)
AUT(*USE)
TEXT(’Autostart Remote Spooling Writers’)
QSTRUPJD Autostart job description JOBD(QSYS/QSTRUPJD)
USER(QPGMR)
LOG(4 10 *SECLVL)
AUT(*EXCLUDE)
RQSDTA(’CALL QSYS/QWDAJPGM’)
TEXT(’Autostart Job JOBD’)
QSYSJOBD Backup job description JOBD(QSYS/QSYSJOBD)
USER(*RQD)
RTGDTA(QCMDI)
LOG(4 0 *NOLIST)
AUT(*USE)
TEXT(’Backup Job Description’)
QSYSWRK System subsystem job JOBD(QSYS/QSYSWRK)
description USER(QPGMR)
LOG(4 10 *SECLVL)
RQSDTA(’CALL QSYS/QWDSYWRK’)
AUT(*EXCLUDE)
TEXT(’System subsystem JOBD’)
QS36MRT Multiple requestor terminal JOBD(QGPL/QS36MRT)
job description USER(QPGMR)
LOG(4 0 *NOLIST)
AUT(*EXCLUDE)
TEXT(’MRT Job Description’)
QTMSNMP SNMP job description JOBD(QSYS/QTMSNMP)
JOBQ(QSYS/QSYSNOMAX)
USER(*RQD)
RTGDTA(’RUNPTY35’)
RQSDTA(’CALL QSYS/QATOSMAIN’)
LOG(4 0 *NOLIST)
AUT(*USE)
TEXT(’Job Description Used by SNMP Jobs’)
| QTOCETCT QTCPEND job for ENDTCP JOBQ(QSYS/QSYSNOMAX)
| *CNTRLD INLLIBL(*NONE)
| RTGDTA(’TCPEND’)
| LOG(4 0 *SECLVL)
| TEXT(’QTCPEND job for ENDTCP *CNTRLD ’)

470 OS/400 Work Management V4R4

 Table 130. IBM-Supplied Job Descriptions (JOBD)—CRTJOBD (continued)
Object Description Parameters Other Than Default
| QTOCPPJOBD TCP Point-to-Point Session JOBQ(QSYS/QSYSNOMAX)
| Manager job description RTGDTA(’RUNPTY35’)
| LOG(4 0 *SECLVL)
| INLLIBL(*NONE)
| TEXT(’TCP Point-to-Point Session Mgr job description’)
| QTOCSTRTCP Job description that can be JOBQ(QSYS/QSYSNOMAX)
| used ot add an autostart job USER(*QPGMR)
| entry to subsystem RTGDTA(’RUNPTY25’)
| QSYSWRK to start TCP/IP RQSDTA(’CALL QSYS/QSTRTCP’)
| whenever QSYSWRK starts LOG(2 0 *SECLVL)
| (for example, at IPL). TEXT(’ADDAJE QSYSWRK to start TCP/IP at IPL ’)
| QTOCTCPIP Job description for QTCPIP JOBQ(QSYS/QSYSNOMAX)
| asynchronous process RTGDTA(’TCPIP’)
| daemon RQSDTA(’CALL QSYS/QATOSMAIN’)
| LOG(4 20 *SECLVL)
| TEXT(’QTCPIP asynchronous process daemon’)
| QTODBTPJ Job description for BOOTP JOBQ(QSYS/QSYSNOMAX)
| server INQMSGRPY(*DFT)
| LOG(4 0 *SECLVL)
| AUT(*USE)
| QTODDJDR Job description for JOBQ(QSYS/QSYSNOMAX)
| BOOTP/DHCP relay RTGDTA(’RUNPTY25’)
| RQSDTA(’CALL QSYS/QTODDRLY’)
| LOG(4 0 *SECLVL)
| AUT(*USE)
| QTODDJS Job description for DHCP JOBQ(QSYS/QSYSNOMAX)
| server RTGDTA(’RUNPTY25’)
| RQSDTA(’CALL QSYS/QTODDSVR’)
| INQMSGRPY(*DFT)
| LOG(4 0 *SECLVL)
| AUT(*USE)
| QTDTFTP Job description for TFPT JOBQ(QSYS/QSYSNOMAX)
| server RTGDTA(’TFTPSERV’)
| INQMSGRPY(*DFT)
| JOBMSGQFL(*WRAP)
| JOBSMGQMX(2)
| AUT(*USE)
| TEXT(’Job description for TFTP Server’)
| QTOINETD Job description used by JOBQ(QSYS/QSYSNOMAX)
| INETD RTGDTA(’RUNPTY50’)
| RQSDTA(’CALL QSYS/QTOGINTD’)
| INLLIBL(*NONE)
| LOG(4 0 *SECLVL)
| JOBMSGQFL(*WRAP)
| TEXT(’Job description used by INETD’)
| QTOKMAN Job description for ISAKMP JOBQ(QSYS/QSYSNOMAX)
| server RTGDTA(’ISASERV’)
| INLLIBL(*NONE)
| AUT(*USE)
| JOBSMGQFL(*WRAP)

Appendix C. IBM-Supplied Object Contents 471

 Table 130. IBM-Supplied Job Descriptions (JOBD)—CRTJOBD (continued)
Object Description Parameters Other Than Default
| QTOROUTED Job description used by JOBQ(QSYS/QSYSNOMAX)
| RouteD RTGDTA(’RUNPTY50’)
| RQSDTA(’CALL QSYS/QATOSRVR’)
| INLLIBL(*NONE)
| LOG(4 0 *SECLVL)
| TEXT(’Job description used by RouteD’)
| QTOVMAN Job description for VPN JOBQ(QSYS/QSYSNOMAX)
| manager RTGDTA(’VPNCNMGR’)
| INLLIBL(*NONE)
| JOBMSGQFL(*WRAP)
| AUT(*EXCLUDE)
| TEXT(’Job Description for VPN Manager ’)
| QXDAJOBD EDRSQL sockets server job JOBD(QSYS/QXDAJOBD)
| description USER(*RQD)
| LOG(4 0 *NOLIST)
| AUT(*USE)
| TEXT(’EDRSQL Sockets Server job description’)
| QZBSJOBD Client Access Host Server JOBQ(QSYS/QSYSNOMAX)
| job description AUT(*USE)
| TEXT(’Client Access Host Server Description’)
QZMFEJBD Job description for JOBD(QSYS/QZMEFJBD)
QSYSWRK autostart job USER(QMSF)
entry LOG(4 10 *SECLVL)
RQSTDTA(’STRMSF MSGOPT(*RESUME)
NBRMSF JOB(1)’)
AUT(*EXCLUDE)
TEXT(’Job Description for QSYSWRK Autostart Entry’)

IBM-Supplied Job Queues

Table 131. IBM-Supplied Job Queues (JOBQ)–CRTJOBQ
CRTJOBQ
QBASE QBASE subsystem job queue JOBQ(QGPL/QBASE)
TEXT(’QBASE Subsystem Job Queue’)
QBATCH Batch subsystem job queue JOBQ(QGPL/QBATCH)
TEXT(Batch Subsystem Job Queue’)
QCTL Controlling subsystem job queue JOBQ(QSYS/QCTL)
TEXT(’Controlling Subsystem Job Queue’)
QESAUTON Automatic problem notification JOBQ (QSYS/QESAUTON)
job queue OPCRTL(*YES)
AUT(*EXCLUDE)
TEXT(’Job Queue for Automatic Problem Notification’)
QFNC Finance subsystem job queue JOBQ(QGPL/QFNC)
TEXT(’Finance Subsystem Job Queue’)
QINTER Interactive subsystem job queue JOBQ(QGPL/QINTER)
TEXT(’Interactive Subsystem Job Queue’)
QLPINSTALL Licensed program installation job JOBQ(QSYS/QLPINSTALL)
queue AUT(*EXCLUDE)
TEXT(’Job Queue for LP Install’)

472 OS/400 Work Management V4R4

 Table 131. IBM-Supplied Job Queues (JOBQ)–CRTJOBQ (continued)
CRTJOBQ
QPDAUTOPAR Automatic problem analysis job JOBQ(QSYSAUTOPAR)
queue OPRCTL(*YES)
AUT(*EXCLUDE)
TEXT(’Job Queue for Automatic Problem Analysis’)
QPGMR Programmer subsystem job JOBQ(QGPL/QPGMR)
queue TEXT(’Programmer Subsystem Job Queue’)
QSNADS QSNADS subsystem job queue JOBQ(QGPL/QSNADS)
TEXT(’QSNADS Subsystem Job Queue’)
QSPL Spooling subsystem job queue JOBQ(QGPL/QSPL)
TEXT(’Spooling Subsystem Job Queue’)
QNMSVQ SystemView server job queue JOBQ(QSYS/QNMSVQ) OPRCTL(*YES)
AUT(*EXCLUDE)
TEXT(’Job Queue for SystemView Server Jobs’)
QSYSNOMAX QSYSNOMAX system JOBQ(QSYS/QSYSNOMAX)
subsystem job queue OPRCTL(*YES)
AUT(*EXCLUDE)
TEXT(’System Subsystem Job Queue’)
QSYSSBSD QSYSSBSD subsystem job JOBQ(QSYS/QSYSSBSD)
queue TEXT(’QSYSSBSD Subsystem Job Queue’)
QS36EVOKE QS36EVOKE job queue OBQ(QGPL/QS36EVOKE)
TEXT(’QS36EVOKE Job Queue’)
QS36MRT QS36 job queue JOBQ(QGPL/QS36MRT)
EXT(’QS36MRT Job Queue’)
QTXTSRCH Text Search Services job queue JOBQ(QGPL/QTXTSRCH)
TEXT(’Text Search Services Job Queue’)
| QUSRNOMAX QUSRNOMAX Subsystem Job JOBQ(QSYS/QUSRNOMAX)
| Queue OPRCTL(*YES)
| TEXT(’User subsystem job queue’)

IBM-Supplied Subsystem Descriptions

Table 132. IBM-Supplied Subsystem Descriptions (SBSD)
QBASE Basic controlling CRTSBSD SBSD(QSYS/QBASE
subsystem POOLS((1 *BASE)(2 *INTERACT))
description AUT(*USE)
TEXT(’Basic Controlling Subsystem’)
ADDJOBQE SBSD(QSYS/QBASE)
OBQ(QGPL/QBATCH)
SEQNBR(10)
ADDJOBQE SBSD(QSYS/QBAS)
JOBQ(QGPL/QINTER)
MAXACT(*NOMAX)
SEQNBR(50)
ADDJOBQE SBSD(QSYS/QBASE)
JOBQ(QSYS/QCTL)
MAXACT(*NOMAX)
SEQNBR(100)

Appendix C. IBM-Supplied Object Contents 473

 Table 132. IBM-Supplied Subsystem Descriptions (SBSD) (continued)
ADDJOBQE SBSD(QSYS/QBASE)
JOBQ(QGPL/QS36MRT)
MAXACT(*NOMAX)
SEQNBR(150)
ADDJOBQE SBSD(QSYS/QBASE)
JOBQ(QGPL/QS36EVOKE)
MAXACT(*NOMAX)
SEQNBR(200)
ADDJOBQE SBSD(QSYS/QBASE)
JOBQ(QGPL/QBASE)
MAXACT(*NOMAX)
SEQNBR(250)
| ADDWSE SBSD(QSYS/QBASE)
| WRKSTNTYPE(*CONS) AT (*ENTER)
ADDWSE SBSD(QSYS/QBASE)
WRKSTNTYPE(*ALL)
Used for: IGC ADDWSE SBSD(QSYS/QBASE)
ONLY WRKSTNTYPE(5555)
Used for: BATCH ADDRTGE SBSD(QSYS/QBASE)
SEQNBR(10)
CMPVAL(QCMDB)
PGM(QSYS/QCMD)
CLS(QSYS/QBATCH)
Used for: ADDRTGE SBSD(QSYS/QBASE)
INTERACTIVE SEQNBR(50)
CMPVAL(QCMDI)
PGM(QSYS/QCMD)
CLS(QGPL/QINTER)
POOLID(2)
Used for: APING ADDRTGE SBSD(QSYS/QBASE)
Support for SNA SEQNBR(70)
Networks CMPVAL(QNMAPINGD 37)
PGM(*RTGDTA)
CLS(QSYS/QSYSCLS25)
MAXACT(*NOMAX)
POOLID(1)
Used for: ADDRTGE SBSD(QSYS/QBASE)
RUNRMTCMD SEQNBR(80)
Support for SNA CMPVAL(AREXECD 37)
Networks PGM(QSYS/QNMAREXECD)
CLS(QSYS/QSYSCLS25)
MAXACT(*NOMAX)
POOLID(1)
Used for: ADDRTGE SBSD(QSYS/QBASE)
S36EVOKE SEQNBR(100)
CMPVAL(QS36EVOKE)
PGM(QSYS/QCMD)
CLS(QSYS/QBATCH)
Used for: S36MRT ADDRTGE SBSD(QSYS/QBASE)
SEQNBR(150)
CMPVAL(QS36MRT)
PGM(QSYS/QCMD)
CLS(QGPL/QINTER)
POOLID(2)

474 OS/400 Work Management V4R4

Table 132. IBM-Supplied Subsystem Descriptions (SBSD) (continued)
Used for: IGC only ADDRTGE SBSD(QSYS/QBASE)
SEQNBR(200)
CMPVAL(QIGC)
PGM(QSYS/QCMD)
CLS(QGPL/QINTER)
POOLID(2)
Used for: Calendar ADDRTGE SBSD(QSYS/QBASE) /* BEFORE */
Transaction SEQNBR(260) /* PGMEVOKE */
Processing CMPVAL(’QOCEVOKE’ 37)
PGM(*RTGDTA)
CLS(QGPL/QINTER)
MAXACT(*NOMAX)
POOLID(2)
ADDRTGE SBSD(QSYS/QBASE)
SEQNBR(300)
CMPVAL(525XTEST)
PGM(QSYS/QARDRIVE)
CLS(QGPL/QINTER)
POOLID(2)
Used for: PWS-I ADDRTGE SBSD(QSYS/QBASE) /* BEFORE */
server SEQNBR(310) /* PGMEVOKE *
CMPVAL(QZSCSRVR 37)
PGM(*RTGDTA)
CLS(QGPL/QCASERVR)
MAXACT(*NOMAX)
POOLID(2)
Used for: PWS-I ADDRTGE SBSD(QSYS/QBASE) /* BEFORE */
Server SEQNBR(320) /*PGMEVOKE */
CMPVAL(QZRCSRVR 37
PGM(*RTGDTA)
CLS(QGPL/QCASERVR)
MAXACT(*NOMAX)
POOLID(2)
Used for: PWS-I ADDRTGE SBSD(QSYS/QBASE) /* BEFORE */
Server SEQNBR(330) /* PGMEVOKE *
CMPVAL(QZHQTRG 37
PGM(*RTGDTA)
CLS(QGPL/QCASERVR)
MAXACT(*NOMAX)
POOLID(2)
Used for: PC ADDRTGE SBSD(QSYS/QBASE) /* BEFORE */
Support Virtual SEQNBR(350) /* PGMEVOKE */
Print CMPVAL(QVPPRINT 37)
PGM(*RTGDTA)
CLS(QGPL/QWCPCSUP)
Used for: Network ADDRTGE SBSD(QSYS/QBASE) /* BEFORE */
Print Server SEQNBR(360) /* PGMEVOKE */
CMPVAL(QNPSERVR 37)
PGM(*RTGDTA)
CLS(QGPL/QCASERVR)
MAXACT(*NOMAX)
POOLID(1)

Appendix C. IBM-Supplied Object Contents 475

Table 132. IBM-Supplied Subsystem Descriptions (SBSD) (continued)
Used for: PC ADDRTGE SBSD(QSYS/QBASE) /* BEFORE */
Support SEQNBR(400) /* PGMEVOKE */
CMPVAL(QTFDWNLD 37)
PGM(*RTGDTA)
CLS(QGPL/QWCPCSUP)
Used for: PC ADDRTGE SBSD(QSYS/QBASE) /* BEFORE */
Support SEQNBR(450) /* PGMEVOKE *
CMPVAL(QMFRCVR 37)
PGM(*RTGDTA)
CLS(QGPL/QWCPCSUP)
Used for: PC ADDRTGE SBSD(QSYS/QBASE) /* BEFORE */
Support SEQNBR(500) /* PGMEVOKE */
CMPVAL(QMFSNDR 37)
PGM(*RTGDTA)
CLS(QGPL/QWCPCSUP)
Used for: PC ADDRTGE SBSD(QSYS/QBASE) /* BEFORE */
Support SEQNBR(510) /* PGMEVOKE */
CMPVAL(QHQTRGT 37)
PGM(*RTGDTA)
CLS(QGPL/QWCPCSUP)
Used for: PC ADDRTGE SBSD(QSYS/QBASE) /* BEFORE */
Support SEQNBR(520) /* PGMEVOKE */
CMPVAL(QRQSRV 37)
PGM(*RTGDTA)
CLS(QGPL/QWCPCSUP)
Used for: PC ADDRTGE SBSD(QSYS/QBASE) /* BEFORE */
Support/400 SEQNBR(540) /* PGMEVOKE */
License Manager CMPVAL(QLZPSERV 37
Server PGM(*RTGDTA)
CLS(QGPL/QWCPCSUP)
Used for: PC ADDRTGE SBSD(QSYS/QBASE) /* BEFORE */
Support SEQNBR(550) /* PGMEVOKE */
CMPVAL(QCNPCSUP 37)
PGM(*RTGDTA)
CLS(QGPL/QWCPCSUP)
Used for: PC ADDRTGE SBSD(QSYS/QBASE) /* BEFORE */
Support SEQNBR(590) /* PGMEVOKE */
CMPVAL(QPCSUPP 1)
PGM(*RTGDTA)
CLS(QPGL/QWCPCSUP)
Used for: Client ADDRTGE SBSD(QSYS/QBASE) /* BEFORE */
Access Server SEQNBR(595) /* PGMEVOKE */
CMPVAL(QCASERVR 1)
PGM(*RTGDTA)
CLS(QPGL/QCASERVR)
ADDRTGE SBSD(QSYS/QBASE)
SEQNBR(599)
CMPVAL(#INTER)
PGM(*RTGDTA)
CLS(QPGL/QINTER)

476 OS/400 Work Management V4R4

Table 132. IBM-Supplied Subsystem Descriptions (SBSD) (continued)
Used for: Program ADDRTGE SBSD(QSYS/QBASE)
Evoke SEQNBR(600)
CMPVAL(PGMEVOKE 29)
PGM(*RTGDTA)
CLS(QSYS/QBATCH)
ADDRTGE SBSD(QSYS/QBASE)
SEQNBR(650)
CMPVAL(QCMD38)
PGM(QSYS/QCL)
CLS(QGPL/QINTER)
POOLID(2)
ADDRTGE SBSD(QSYS/QBASE)
SEQNBR(9999)
CMPVAL(*ANY)
PGM(QSYS/QCMD)
CLS(QSYS/QBATCH)
ADDCMNE SBSD(QSYS/QBASE)
DFTUSR(*SYS)
DEV(*ALL)
ADDCMNE SBSD(QSYS/QBASE)
DFTUSR(*SYS)
MODE(QPCSUPP)
DEV(*ALL)
ADDCMNE SBSD(QSYS/QBASE)
DFTUSR(*NONE)
MODE(QCASERVR)
DEV(*ALL)
ADDAJE SBSD(QSYS/QBASE)
JOB(QSTRUPJD)
JOBD(QSYS/QSTRUPJD)
ADDAJE SBSD(QSYS/QBASE)
JOB(QPFRCOL)
JOBD(QGPL/QPFRCOL)
ADDPJE SBSD(QSYS/QBASE)
PGM(QSYS/QOQSESRV)
STRJOBS(*NO)
INLJOBS(10)
THRESHOLD(3)
ADLJOBS(3)
MAXJOBS(*NOMAX)
JOB(QOQSESRV)
JOBD(*USRPRF)
MAXUSE(200)
WAIT(*YES)
POOLID(1)
CLS(QGPL/QWCPCSUP *CALC *NONE 0)

Appendix C. IBM-Supplied Object Contents 477

 Table 132. IBM-Supplied Subsystem Descriptions (SBSD) (continued)
ADDPJE SBSD(QSYS/QBASE)
PGM(QSYS/QNMAPINGD)
USER(QUSER)
STRJOBS(*YES)
INLJOBS(1)
THRESHOLD(1)
ADLJOBS(0)
JOB(*PGM)
JOBD(*USRPRF)
MAXUSE(*NOMAX)
WAIT(*YES)
POOLID(1)
CLS(QSYS/QSYSCLS25)
ADDPJE SBSD(QSYS/QBASE)
PGM(QSYS/QNMAREXECD)
USER(QUSER)
STRJOBS(*YES)
INLJOBS(1)
THRESHOLD(1)
ADLJOBS(1)
JOB(*PGM)
JOBD(*USRPRF)
MAXUSE(200)
WAIT(*YES)
POOLID(1)
CLS(QSYS/QSYSCLS25)
| Used for: APPC ADDPJE SBSD(QSYS/QBASE)
| sign-on for Client PGM(QSYS/QACSOTP)
| Access/400 STRJOBS(*YES)
INLJOBS(1)
THRESHOLD(1)
ADLJOBS(3)
MAXJOBS(*NOMAX)
JOB(*PGM)
JOBD(*USRPRF)
MAXUSE(200)
WAIT(*YES)
POOLID(1)
CLS(QGPL/QWCPCSUP *CALC *NONE 0)
QBATCH Batch subsystem CRTSBSD SBSD(QSYS/QBATCH
description POOLS((1 *BASE))
MAXJOBS(*NOMAX)
AUT(*USE)
TEXT(’Batch Subsystem’)
ADDJOBQE SBSD(QSYS/QBATCH)
JOBQ(QGPL/QBATCH)
MAXACT(1)
ADDJOBQE SBSD(QSYS/QBATCH)
JOBQ(QGPL/QS36EVOKE)
SEQNBR(20)
MAXACT(*NOMAX)
ADDJOBQE SBSD(QSYS/QBATCH)
JOBQ(QGPL/QTXTSRCH)
SEQNBR(50)
MAXACT(*NOMAX)

478 OS/400 Work Management V4R4

Table 132. IBM-Supplied Subsystem Descriptions (SBSD) (continued)
Used for: IGC ADDRTGE SBSD(QSYS/QBATCH)
ONLY SEQNBR(15)
CMPVAL(QIGC)
CLS(QGPL/QBATCH)
PGM(QSYS/QCMD)
ADDRTGE SBSD(QSYS/QBATCH)
SEQNBR(300)
CMPVAL(QS36EVOKE)
CLS(QSYS/QBATCH)
PGM(QSYS/QCMD)
ADDRTGE SBSD(QSYS/QBATCH)
SEQNBR(700)
CMPVAL(QCMD38)
PGM(QSYS/QCL)
CLS(QSYS/QBATCH)
ADDRTGE SBSD(QSYS/QBATCH)
SEQNBR(9999)
CMPVAL(*ANY)
PGM(QSYS/QCMD)
CLS(QSYS/QBATCH)
CHGOBJOWN OBJ(QSYS/QBATCH)
OBJTYPE(*SBSD)
NEWOWN(QPGMR)
QCMN Communications CRTSBSD SBSD(QSYS/QCMN)
subsystem POOLS((1 *BASE))
description MAXJOBS(*NOMAX)
AUT(*USE)
TEXT(’Communications Subsystem’)
Used for: PWS-I ADDRTGE SBSD(QSYS/QCMN) /* BEFORE *
Server
SEQNBR(10) /* PGMEVOKE */
CMPVAL(QZSCSRVR 37
PGM(*RTGDTA)
CLS(QGPL/QCASERVR)
MAXACT(*NOMAX)
POOLID(1)
Used for: PWS-I ADDRTGE SBSD(QSYS/QCMN) /* BEFORE */
Server SEQNBR(20) /* PGMRVOKE */
CMPVAL(QZRCSRVR 37)
PGM(*RTGDTA)
CLS(QGPL/QCASERVR)
MAXACT(*NOMAX)
POOLID(1)
Used for: PWS-I ADDRTGE SBSD(QSYS/QCMN) /* BEFORE */
Server SEQNBR(30) /* PGMEVOKE */
CMPVAL(QZHQTRG 37)
PGM(*RTGDTA)
CLS(QGPL/QCASERVR)
MAXACT(*NOMAX)
POOLID(1)
Used for: PC ADDRTGE SBSD(QSYS/QCMN) /* BEFORE */
Support Virtual SEQNBR(50) /* PGMEVOKE */
Print CMPVAL(QVPPRINT 37)
PGM(*RTGDTA)
CLS(QGPL/QWCPCSUP)

Appendix C. IBM-Supplied Object Contents 479

Table 132. IBM-Supplied Subsystem Descriptions (SBSD) (continued)
Used for: Network ADDRTGE SBSD(QSYS/QCMN) /* BEFORE */
Print Server SEQNBR(60) /* PGMEVOKE */
CMPVAL(QNPSERVR 37)
PGM(*RTGDTA)
CLS(QGPL/QCASERVR)
MAXACT(*NOMAX)
POOLID(1)
Used for: APING ADDRTGE SBSD(QSYS/QCMN) /* BEFORE */
Support for SNA SEQNBR(70) /* PGMEVOKE */
Networks CMPVAL(QNMAPINGD 37)
PGM(*RTGDTA)
CLS(QSYS/QSYSCLS25)
MAXACT(*NOMAX)
POOLID(1)
Used for: ADDRTGE SBSD(QSYS/QCMN) /* BEFORE */
RUNRMTCMD SEQNBR(80) /* PGMEVOKE *
Support for SNA CMPVAL(AREXECD 37)
Networks PGM(QSYS/QNMAREXECD)
CLS(QSYS/QSYSCLS25)
MAXACT(*NOMAX)
POOLID(1)
Used for: PC ADDRTGE SBSD(QSYS/QCMN) /* BEFORE */
Support SEQNBR(100) /* PGMEVOKE */
CMPVAL(QTFDWNLD 37)
PGM(*RTGDTA)
CLS(QGPL/QWCPCSUP)
Used for: PC ADDRTGE SBSD(QSYS/QCMN) /* BEFORE */
Support SEQNBR(150) /* PGMEVOKE */
CMPVAL(QMFRCVR 37)
PGM(*RTGDTA)
CLS(QGPL/QWCPCSUP)
Used for: PC ADDRTGE SBSD(QSYS/QCMN) /* BEFORE */
Support SEQNBR(200) /* PGMEVOKE */
CMPVAL(QMFSNDR 37)
PGM(*RTGDTA)
CLS(QGPL/QWCPCSUP)
Used for: PC ADDRTGE SBSD(QSYS/QCMN) /* BEFORE */
Support SEQNBR(210) /* PGMEVOKE */
CMPVAL(QHQTRGT 37)
PGM(*RTGDTA)
CLS(QGPL/QWCPCSUP)
Used for: PC ADDRTGE SBSD(QSYS/QCMN) /* BEFORE */
Support SEQNBR(220) /* PGMEVOKE */
CMPVAL(QRQSRV 37)
PGM(*RTGDTA)
CLS(QGPL/QWCPCSUP)
Used for: PC ADDRTGE SBSD(QSYS/QCMN) /* BEFORE */
Support Licence SEQNBR(240) /* PGMEVOKE */
Manager Server CMPVAL(QLZPSERV 37)
PGM(*RTGDTA)
CLS(QGPL/QWCPCSUP)

480 OS/400 Work Management V4R4

Table 132. IBM-Supplied Subsystem Descriptions (SBSD) (continued)
Used for: PC ADDRTGE SBSD(QSYS/QCMN) /* BEFORE */
Support SEQNBR(250) /* PGMEVOKE */
CMPVAL(QCNPCSUP 37)
PGM(*RTGDTA)
CLS(QGPL/QWCPCSUP)
Used for: Calendar ADDRTGE SBSD(QSYS/QCMN) /* BEFORE */
Transaction SEQNBR(260) /* PGMEVOKE */
Processing CMPVAL(’QOCEVOKE’ 37)
PGM(*RTGDTA)
CLS(QGPL/QINTER)
MAXACT(*NOMAX)
POOLID(1)
Used for: PC ADDRTGE SBSD(QSYS/QCMN)
Support SEQNBR(290)
CMPVAL(QPCSUPP 1)
PGM(*RTGDTA)
CLS(QGPL/QWCPCSUP)
Used for: Client ADDRTGE SBSD(QSYS/QCMN)
Access Server SEQNBR(295)
CMPVAL(QCASERVR 1)
PGM(*RTGDTA)
CLS(QGPL/QCASERVR)
ADDRTGE SBSD(QSYS/QCMN)
SEQNBR(299)
CMPVAL(#INTER)
PGM(*RTGDTA)
CLS(QGPL/QINTER)
Used for: Program ADDRTGE SBSD(QSYS/QCMN)
Evoke SEQNBR(300)
CMPVAL(PGMEVOKE 29)
PGM(*RTGDTA)
CLS(QSYS/QBATCH)
ADDCMNE SBSD(QSYS/QCMN)
DFTUSR(*SYS)
DEV(*ALL)
ADDCMNE SBSD(QSYS/QCMN)
DFTUSR(*SYS)
MODE(QPCSUPP)
DEV(*ALL)
Used for: Client ADDCMNE SBSD(QSYS/QCMN)
Access Server DEV(*ALL)
JOBD(*USRPRF)
DFTUSR(*NONE)
MODE(QCASERVR)
MAXACT(*NOMAX)

Appendix C. IBM-Supplied Object Contents 481

Table 132. IBM-Supplied Subsystem Descriptions (SBSD) (continued)
Used for: PC ADDPJE SBSD(QSYS/QCMN)
Support PGM(QSYS/QOQSESRV)
STRJOBS(*NO)
INLJOBS(10)
THRESHOLD(3)
ADLJOBS(3)
MAXJOBS(*NOMAX)
JOB(QOQSESRV)
JOBD(*USRPRF)
MAXUSE(200)
WAIT(*YES)
POOLID(1)
CLS(QGPL/QWCPCSUP *CALC *NONE 0)
Used for: Client ADDPJE SBSD(QSYS/QCMN)
Access Server PGM(QSYS/QNPSERVR)
USER(QUSER)
STRJOBS(*NO)
INLJOBS(3)
THRESHOLD(2)
ADLJOBS(2)
MAXJOBS(*NOMAX)
JOB(*PGM)
JOBD(*USRPRF)
MAXUSE(5)
WAIT(*YES)
POOLID(1)
CLS(QGPL/QCASERVR *CALC *NONE *CALC)
Used for: APING ADDPJE SBSD(QSYS/QCMN)
Support for SNA PGM(QSYS/QNMAPINGD)
Networks USER(QUSER)
STRJOBS(*YES)
INLJOBS(1)
THRESHOLD(1)
ADLJOBS(0)
JOB(*PGM)
JOBD(*USRPRF)
MAXUSE(*NOMAX)
WAIT(*YES)
POOLID(1)
CLS(QGPL/QSYSCLS25)
Used for: ADDPJE SBSD(QSYS/QCMN)
RUNRMTCMD PGM(QSYS/QNMAREXECS)
Support for SNA USER(QUSER)
Networks STRJOBS(*YES)
INLJOBS(1)
THRESHOLD(1)
ADLJOBS(1)
JOB(*PGM)
JOBD(*USRPRF)
MAXUSE(200)
WAIT(*YES)
POOLID(1)
CLS(QGPL/QSYSCLS25)

482 OS/400 Work Management V4R4

 Table 132. IBM-Supplied Subsystem Descriptions (SBSD) (continued)
| Used for: APPC ADDPJE SBSD(QSYS/QCMN)
| Sign-on for Client PGM(QSYS/QACSOTP)
| Access/400 STRJOBS(*YES)
INLJOBS(1)
THRESHOLD(1)
ADLJOBS(3)
MAXJOBS(*NOMAX)
JOB(*PGM)
JOBD(*USRPRF)
MAXUSE(200)
WAIT(*YES)
POOLID(1)
CLS(QGPL/QWCPCSUP *CALC *NONE 0)
QCTL Controlling CRTSBSD SBSD(QSYS/QCTL)
subsystem POOLS((1 *BASE))
description AUT(*USE)
TEXT(’Controlling Subsystem’)
ADDJOBQE SBSD(QSYS/QCTL)
JOBQ(QSYS/QCTL)
MAXACT(*NOMAX)
ADDWSE SBSD(QSYS/QCTL)
WRKSTNTYPE(*CONS)
ADDWSE SBSD(QSYS/QCTL)
WRKSTNTYPE(*ALL)
AT(*ENTER)
Used for: IGC ADDWSE SBSD(QSYS/QCTL)
ONLY WRKSTNTYPE(5555)
AT(*ENTER)
ADDRTGE SBSD(QSYS/QCTL)
SEQNBR(10)
CMPVAL(525XTEST)
PGM(QSYS/QARDRIVE)
CLS(QSYS/QCTL)
Used for: IGC ADDRTGE SBSD(QSYS/QCTL)
ONLY SEQNBR(15)
CMPVAL(QIGC)
PGM(QSYS/QCMD)
CLS(QSYS/QCTL)
ADDRTGE SBSD(QSYS/QCTL)
SEQNBR(700)
CMPVAL(QCMD38)
PGM(QSYS/QCL)
CLS(QSYS/QCTL)
ADDRTGE SBSD(QSYS/QCTL)
SEQNBR(9999)
CMPVAL(*ANY)
PGM(QSYS/QCMD)
CLS(QSYS/QCTL)
ADDAJE SBSD(QSYS/QCTL)
JOB(QSTRUPJD)
JOBD(QSYS/QSTRUPJD)
ADDAJE SBSD(QSYS/QCTL)
JOB(QPFRCOL
JOBD(QGPL/QPFRCOL)

Appendix C. IBM-Supplied Object Contents 483

Table 132. IBM-Supplied Subsystem Descriptions (SBSD) (continued)
QDSNX DSNX subsystem CRTSBSD SBSD(QGPL/QDSNX)
description POOLS((1 *BASE))
AUT(*EXCLUDE)
TEXT(’DSNX Subsystem Description’)
ADDRTGE SBSD(QGPL/QDSNX)
SEQNBR(10)
CMPVAL(QDSNX)
PGM(QSYS/QDXDDOER)
CLS(QGPL/QDSNX)
ADDAJE SBSD(QGPL/QDSNX)
JOB(QDSNX)
JOBD(QGPL/QDSNX)
QFNC Finance CRTSBSD SBSD(QGPL/QFNC)
subsystem POOLS((1 *BASE))
description MAXJOBS(*NOMAX)
TEXT(’Finance Subsystem’)
ADDJOBQE SBSD(QGPL/QFNC)
JOBQ(QGPL/QFNC)
SEQNBR(10)
MAXACT(*NOMAX)
ADDRTGE SBSD(QGPL/QFNC)
SEQNBR(10)
CMPVAL(QFNC)
PGM(QSYS/QCMD)
CLS(QGPL/QFNC)
POOLID(1)
ADDRTGE SBSD(QGPL/QFNC)
SEQNBR(20)
CMPVAL(QCMD38)
PGM(QSYS/QCL)
CLS(QGPL/QFNC)
POOLID(1)
QINTER Interactive CRTSBSD> SBSD(QSYS/QINTER)
subsystem POOLS((1 *BASE
description (2 *INTERACT))
AUT(*USE)
TEXT(’Interactive Subsystem’)
ADDJOBQE SBSD(QSYS/QINTER)
JOBQ(QGPL/QINTER)
MAXACT(*NOMAX)
ADDJOBQE SBSD(QSYS/QINTER)
JOBQ(QGPL/QS36MRT)
SEQNBR(20)
MAXACT(*NOMAX)
ADDWSE SBSD(QSYS/QINTER)
WRKSTNTYPE(*ALL)
ADDWSE SBSD(QSYS/QINTER)
WRKSTNTYPE(*CONS)
AT(*ENTER)
Used for: IGC ADDWSE SBSD(QSYS/QINTER)
ONLY WRKSTNTYPE(5555)

484 OS/400 Work Management V4R4

Table 132. IBM-Supplied Subsystem Descriptions (SBSD) (continued)
ADDRTGE SBSD(QSYS/QINTER)
SEQNBR(10)
CMPVAL(QCMDI)
PGM(QSYS/QCMD)
POOLID(2)
CLS(QGPL/QINTER)
Used for: IGC ADDRTGE SBSD(QSYS/QINTER)
ONLY SEQNBR(15)
CMPVAL(QIGC)
PGM(QSYS/QCMD)
POOLID(2)
CLS(QGPL/QINTER)
ADDRTGE SBSD(QSYS/QINTER)
SEQNBR(20)
CMPVAL(QS36MRT)
PGM(QSYS/QCMD)
POOLID(2)
CLS(QGPL/QINTER)
ADDRTGE SBSD(QSYS/QINTER)
SEQNBR(40)
CMPVAL(525XTEST)
PGM(QSYS/QARDRIVE)
POOLID(2)
CLS(QGPL/QINTER)
ADDRTGE SBSD(QSYS/QINTER)
SEQNBR(700)
CMPVAL(QCMD38)
PGM(QSYS/QCL)
POOLID(2)
CLS(QGPL/QINTER)
ADDRTGE SBSD(QGPL/QINTER)
SEQNBR(9999)
CMPVAL(*ANY)
PGM(QSYS/QCMD)
POOLID(2)
CLS(QGPL/QINTER)
QLPINSTALL Licensed program CRTSBSD SBSD(QSYS/QLPINSTALL)
installation POOLS((1 *BASE))
AUT(*EXCLUDE)
TEXT(’Subsystem for LP Install’)
ADDJOBQE SBSD(QSYS/QLPINSTALL)
JOBQ(QSYS/QLPINSTALL)
MAXACT(*NOMAX)
ADDRTGE SBSD(QSYS/QLPINSTALL)
SEQNBR(10) CMPVAL(INIT)
PGM(QSYS/QLPCTLIN)
CLS(QSYS/QLPINSTALL)
ADDRTGE SBSD(QSYS/QLPINSTALL)
SEQNBR(20)
CMPVAL(BATCH)
PGM(QSYS/QCMD)
CLS(QSYS/QLPINSTALL)

Appendix C. IBM-Supplied Object Contents 485

Table 132. IBM-Supplied Subsystem Descriptions (SBSD) (continued)
ADDAJE SBSD(QSYS/QLPINSTALL)
JOB(QLPINSTALL)
JOBD(QSYS/QLPINSTALL)
QPGMR Programmer CRTSBSD SBSD(QSYS/QPGMR)
subsystem POOLS((1 *BASE) (2 *BASE))
description AUT(*USE)
TEXT(’Programmer Subsystem’)
ADDJOBQE SBSD(QSYS/QPGMR) JOBQ(QGPL/QPGMR)
ADDWSE SBSD(QSYS/QPGMR) WRKSTNTYPE(*ALL) AT(*ENTER)
Used for: IGC ADDWSE SBSD(QSYS/QPGMR)
ONLY WRKSTNTYPE(5555)
AT(*ENTER)
ADDRTGE SBSD(QSYS/QPGMR)
SEQNBR(10)
CMPVAL(525XTEST)
PGM(QSYS/QARDRIVE)
CLS(QGPL/QPGMR)
Used for: IGC ADDRTGE SBSD(QSYS/QPGMR)
ONLY SEQNBR(15)
CMPVAL(QIGC)
PGM(QSYS/QCMD)
CLS(QGPL/QPGMR)
ADDRTGE SBSD(QSYS/QPGMR)
SEQNBR(20)
CMPVAL(QCMDB)
PGM(QSYS/QCMD)
CLS(QSYS/QBATCH)
ADDRTGE SBSD(QSYS/QPGMR)
SEQNBR(700)
CMPVAL(QCMD38)
PGM(QSYS/QCL)
CLS(QSYS/QBATCH)
ADDRTGE SBSD(QSYS/QPGMR)
SEQNBR(9999)
CMPVAL(*ANY)
PGM(QSYS/QCMD)
CLS(QGPL/QPGMR)
POOLID(2)
QSNADS SNA distribution CRTSBSD SBSD(QSYS/QSNADS)
subsystem POOLS((1 *BASE))
description MAXJOBS(*NOMAX)
AUT(*USE)
TEXT(’SNA Distributions Subsystem’)
ADDAJE SBSD(QSYS/QSNADS)
JOB(QZDSTART)
JOBD(QGPL/QSNADS)
ADDJOBQE SBSD(QSYS/QSNADS)
JOBQ(QGPL/QSNADS)
MAXACT(*NOMAX)

486 OS/400 Work Management V4R4

Table 132. IBM-Supplied Subsystem Descriptions (SBSD) (continued)
ADDRTGE SBSD(QSYS/QSNADS)
SEQNBR(100)
CMPVAL(QSTARTUP)
CLS(QGPL/QSNADS)
PGM(QSYS/QZDSTRUP)
MAXACT(1)
ADDRTGE SBSD(QSYS/QSNADS)
SEQNBR(200)
CMPVAL(QROUTER)
CLS(QGPL/QSNADS)
PGM(QSYS/QZDROUTER)
MAXACT(1)
ADDRTGE SBSD(QSYS/QSNADS)
SEQNBR(275)
CMPVAL(#INTER)
PGM(*RTGDTA)
CLS(QGPL/QINTER)
ADDRTGE SBSD(QSYS/QSNADS)
SEQNBR(300)
CMPVAL(QSENDER)
CLS(QGPL/QSNADS)
PGM(QSYS/QZDSTSND)
MAXACT(*NOMAX)
ADDRTGE SBSD(QSYS/QSNADS)
SEQNBR(350)
CMPVAL(QSVDSSND)
CLS(QGPL/QSNADS)
PGM(QS2STSND)
ADDRTGE SBSD(QSYS/QSNADS)
SEQNBR(500)
CMPVAL(PGMEVOKE 29)
PGM(*RTGDTA)
CLS(QGPL/QSNADS)
MAXACT(*NOMAX)
ADDRTGE SBSD(QSYS/QSNADS)
SEQNBR(600)
CMPVAL(QDIATP)
GM(QSYS/QOSDIATP)
CLS(QGPL/QSNADS)
MAXACT(1)
ADDRTGE SBSD(QSYS/QSNADS)
SEQNBR(650)
CMPVAL(QDIALOCAL)
PGM(QSYS/QOSASYNC)
CLS(QGPL/QDIALOCAL)
MAXACT(2)
ADDRTGE SBSD(QSYS/QSNADS)
SEQNBR(660)
CMPVAL(QDIAINDUSR)
PGM(QSYS/QOSMLFMT)
CLS(QGPL/QINDUSR)
MAXACT(2)

Appendix C. IBM-Supplied Object Contents 487

Table 132. IBM-Supplied Subsystem Descriptions (SBSD) (continued)
ADDRTGE SBSD(QSYS/QSNADS)
SEQNBR(700)
CMPVAL(QNFTP)
PGM(QSYS/QNFTPDTA)
CLS(QGPL/QSNADS)
MAXACT(2)
ADDRTGE SBSD(QSYS/QSNADS)
SEQNBR(800)
MPVAL(QGATEWAY)
PGM(QSYS/QZDSTGAT)
CLS(QGPL/QSNADS)
MAXACT(*NOMAX)
ADDRTGE SBSD(QSYS/QSNADS)
SEQNBR(900)
CMPVAL(RPDSLINE)
PGM(QRJE/QGTPUTCL)
CLS(QGPL/QSNADS)
MAXACT(*NOMAX)
ADDRTGE SBSD(QSYS/QSNADS)
SEQNBR(1000)
CMPVAL(RPDSRCVR)
PGM(QRJE/QGTISNAD)
CLS(QGPL/QSNADS)
MAXACT(*NOMAX)
ADDRTGE SBSD(QSYS/QSNADS)
SEQNBR(1100)
CMPVAL(QDIAHSTPRT)
PGM(QSYS/QOHMAILP)
CLS(QGPL/QMAILP)
MAXACT(1)
ADDRTGE SBSD(QSYS/QSNADS)
SEQNBR(1200)
CMPVAL(QDIANOTIFY)
PGM(QSYS/QOHSTSL)
CLS(QSYS/QBATCH)
MAXACT(1)
ADDRTGE SBSD(QSYS/QSNADS)
SEQNBR(1300)
CMPVAL(QESTP)
PGM(QSYS/QESFXRCV)
CLS(QGPL/QSNADS)
MAXACT(1)
ADDRTGE SBSD(QSYS/QSNADS)
SEQNBR(1400)
CMPVAL(’QX4SNMTA’ 1)
PGM(QX400/QX4SNMTA)
CLS(QGPL/QSNADS)
MAXACT(1)
POOLID(1)
QSPL Spooling CRTSBSD SBSD(QSYS/QSPL)
subsystem POOLS((1 *BASE) (2 *SPOOL))
description MAXJOBS(*NOMAX)
AUT(*USE)
TEXT(’Spooling Subsystem’)

488 OS/400 Work Management V4R4

Table 132. IBM-Supplied Subsystem Descriptions (SBSD) (continued)
ADDAJE SBSD(QSYS/QSPL)
JOB(QSTRRMTWTR)
JOBD(QGPL/QSPLSTRWTR)
ADDJOBQE SBSD(QSYS/QSPL)
JOBQ(QGPL/QSPL)
MAXACT(*NOMAX)
ADDRTGE SBSD(QSYS/QSPL)
SEQNBR(10)
CMPVAL(QWTRPT)
PGM(QSYS/QCMD)
CLS(QGPL/QSPL)
POOLID(2)
ADDRTGE SBSD(QSYS/QSPL)
SEQNBR(50)
CMPVAL(QAFPWT)
PGM(QSYS/QCMD)
CLS(QGPL/QSPL3)
POOLID(2)
ADDRTGE SBSD(QSYS/QSPL)
SEQNBR(60)
CMPVAL(QRMTWT)
PGM(QSYS/QCMD)
CLS(QGPL/QSPL4)
POOLID(2)
ADDRTGE SBSD(QSYS/QSPL)
SEQNBR(9999)
CMPVAL(*ANY)
PGM(QSYS/QCMD)
CLS(QGPL/QSPL2)
QSYSSBSD Backup controlling CRTSBSD SBSD(QSYS/QSYSSBSD)
subsystem POOLS((1 *BASE))
description AUT(*USE)
TEXT(’Backup Controlling Subsystem’)
ADDJOBQE SBSD(QSYS/QSYSSBSD)
JOBQ(QSYS/QSYSSBSD)
MAXACT(*NOMAX)
SEQNBR(10)
ADDWSE SBSD(QSYS/QSYSSBSD)
WRKSTNTYPE(*CONS)
JOBD(QSYS/QSYSJOBD)
ADDRTGE SBSD(QSYS/QSYSSBSD)
SEQNBR(400)
CMPVAL(525XTEST)
PGM(QARDRIVE)
CLS(QSYS/QSYSCLS)
ADDRTGE SBSD(QSYS/QSYSSBSD)
SEQNBR(500)
CMPVAL(QCMD38)
PGM(QSYS/QCL)
CLS(QSYS/QSYSCLS)

Appendix C. IBM-Supplied Object Contents 489

Table 132. IBM-Supplied Subsystem Descriptions (SBSD) (continued)
ADDRTGE SBSD(QSYS/QSYSSBSD)
SEQNBR(9999)
CMPVAL(*ANY)
PGM(QSYS/QCMD)
CLS(QSYS/QSYSCLS)
QSYSWRK System subsystem CRTSBSD SBSD(QSYS/QSYSWRK)
description POOLS((1 *BASE))
MAXJOBS(*NOMAX)
SGNDSPF(*QDSIGNON)
TEXT(’System subsystem’)
ADDAJE SBSD(QSYS/QSYSWRK)
JOB(QSYSWRKJOB)
JOBD(QSYS/QSYSWRK)
Used for: FSIOP ADDAJE SBSD(QSYS/QSYSWRK)
JOB(QFSIOPJOB
JOBD(QSYS/QFSIOPWK)
Used for: ADDAJE SBSD(QSYS/QSYSWRK)
DataBase JOB(QDB2MULTI)
JOBD(QSYS/QQQTEMP)
Used for: Object ADDAJE SBSD(QSYS/QSYSWRK)
Translation JOB(QXOTJOB)
Services JOBD(QSYS/QXOTJOB)
Used for: ADDAJE SBSD(QSYS/QSYSWRK)
Passthrough JOB(QPASVRP)
Servers JOBD(QSYS/QPASVR)
ADDAJE SBSD(QSYS/QSYSWRK)
JOB(QNEOSOEM)
JOBD(QSYS/QNEOJOBD)
ADDAJE SBSD(QSYS/QSYSWRK)
JOB(QZBSEVTM)
JOBD(QSYS/QZBSEJBD)
Used for: Run ADDRTGE SBSD(QSYS/QSYSWRK)
Priority 7 SEQNBR(10)
CMPVAL(RUNPTY07)
PGM(QSYS/QCMD)
CLS(QSYS/QSYSCLS07)
MAXACT(*NOMAX)
POOLID(1)
Used for: Run ADDRTGE SBSD(QSYS/QSYSWRK)
Priority 10 SEQNBR(20)
CMPVAL(RUNPTY10)
PGM(QSYS/QCMD)
CLS(QSYS/QSYSCLS10)
MAXACT(*NOMAX)
POOLID(1)
Used for: Run ADDRTGE SBSD(QSYS/QSYSWRK)
Priority 20 SEQNBR(30)
CMPVAL(RUNPTY20)
PGM(QSYS/QCMD)
CLS(QSYS/QSYSCLS20)
MAXACT(*NOMAX)
POOLID(1)

490 OS/400 Work Management V4R4

 Table 132. IBM-Supplied Subsystem Descriptions (SBSD) (continued)
Used for: Run ADDRTGE SBSD(QSYS/QSYSWRK)
Priority 25 SEQNBR(40)
CMPVAL(RUNPTY25)
PGM(QSYS/QCMD)
CLS(QSYS/QSYSCLS25)
MAXACT(*NOMAX)
POOLID(1)
Used for: Run ADDRTGE SBSD(QSYS/QSYSWRK)
Priority 35 SEQNBR(50)
CMPVAL(RUNPTY35)
PGM(QSYS/QCMD)
CLS(QSYS/QSYSCLS35)
MAXACT(*NOMAX)
POOLID(1)
Used for: Run ADDRTGE SBSD(QSYS/QSYSWRK)
Priority 50 SEQNBR(60)
CMPVAL(RUNPTY50)
PGM(QSYS/QCMD)
CLS(QSYS/QSYSCLS50)
MAXACT(*NOMAX) POOLID(1)
Used for: IPX** ADDRTGE SBSD(QSYS/QSYSWRK)
Server Jobs SEQNBR(70)
CMPVAL(QIPX)
PGM(QSYS/QZSPIPX)
CLS(QSYS/QSYSCLS20)
MAXACT(*NOMAX)
POOLID(1)
| Used for: IPX ADDRTGE SBSD(QSYS/QSYSWRK
Server Jobs SEQNBR(80)
CMPVAL(APPCIPX)
PGM(QSYS/QZSPMJOB)
CLS(QSYS/QSYSCLS20)
MAXACT(*NOMAX)
POOLID(1)
Used for: Network ADDRTGE SBSD(QSYS/QSYSWRK)
File System Jobs SEQNBR(2120)
CMPVAL(’QNFSNFSD’)
PGM(QSYS/QZNFNFSD)
CLS(QSYS/QP0LNFSD)
MAXACT(*NOMAX)
POOLID(1)
Used for: Network ADDRTGE SBSD(QSYS/QSYSWRK)
File System Jobs SEQNBR(2121)
CMPVAL(’QNFSBIOD’)
PGM(QSYS/QZNFBIOD)
CLS(QSYS/QP0LBIOD)
MAXACT(*NOMAX)
POOLID(1)
Used for: Network ADDRTGE SBSD(QSYS/QSYSWRK
File System Jobs SEQNBR(2122)
CMPVAL(’QNFSMNTD’)
PGM(QSYS/QZNFMNTD)
CLS(QSYS/QP0LMNTD)
MAXACT(*NOMAX)
POOLID(1)

Appendix C. IBM-Supplied Object Contents 491

 Table 132. IBM-Supplied Subsystem Descriptions (SBSD) (continued)
Used for: Network ADDRTGE SBSD(QSYS/QSYSWRK)
File System Jobs SEQNBR(2123)
CMPVAL(’QNFSRPCD’)
PGM(QSYS/QZNFRPCD)
CLS(QSYS/QP0LRPCD)
MAXACT(*NOMAX)
POOLID(1)
Used for: Network ADDRTGE SBSD(QSYS/QSYSWRK) +
File System Jobs SEQNBR(2124) +
CMPVAL(’QNFSNLMD’) +
PGM(QSYS/QZNFNLMD) +
LS(QSYS/QP0LLCKD) +
MAXACT(*NOMAX) +
POOLID(1)
Used for: Network ADDRTGE SBSD(QSYS/QSYSWRK)
File System Jobs SEQNBR(2125)
CMPVAL(’QNFSNSMD’)
PGM(QSYS/QZNFNSMD)
CLS(QSYS/QP0LSTATD)
MAXACT(*NOMAX)
POOLID(1)
Used for: PTFs ADDRTGE SBSD(QSYSWRK)
over the Internet SEQNBR(2401)
CMPVAL(’QESISRV’)
PGM(QSYS/QESISRV)
CLS(QSYS/QSYSCLS20)
MAXACT(1)
POOLID(1)
| Used for: TCP/IP ADDRTGE SBSD(QSYS/QSYSWRK)
| SEQNBR(2505)
| CMPVAL(TCPIP)
| PGM(QSYS/QTOCTCPIP)
| CLS(QSYS/QSYSCLS20)
| MAXACT(*NOMAX)
| POOLID(1)
| Used for: TCP/IP ADDRTGE SBSD(QSYS/QSYSWRK)
| SEQNBR(2515)
| CMPVAL(ISASERV)
| PGM(QSYS/QTOKMAN)
| CLS(QSYS/QSYSCLS25)
| MAXACT(*NOMAX)
| POOLID(1)
| Used for: TCP/IP ADDRTGE SBSD(QSYS/QSYSWRK)
| SEQNBR(2516)
| CMPVAL(VPNCNMGR)
| PGM(QSYS/QTOVMAN)
| CLS(QSYS/QSYSCLS25)
| MAXACT(*NOMAX)
| POOLID(1)
Used for: TCP/IP ADDRTGE SBSD(QSYS/QSYSWRK)
SEQNBR(2506)
CMPVAL(TCPEND)
PGM(QSYS/QTOCETCT)
CLS(QSYS/QSYSCLS20)
MAXACT(*NOMAX)
POOLID(1)

492 OS/400 Work Management V4R4

 Table 132. IBM-Supplied Subsystem Descriptions (SBSD) (continued)
Used for: TCP/IP ADDRTGE SBSD(QSYS/QSYSWRK)
SEQNBR(2520)
CMPVAL(TFTPSERV)
PGM(QSYS/QTODTFTP)
CLS(QSYS/QSYSCLS25)
MAXACT(*NOMAX)
POOLID(1)
Used for: Mail ADDRTGE SBSD(QSYS/QSYSWRK)
Server Framework SEQNBR(2525)
CMPVAL(ZMFMSF)
PGM(QSYS/QZMFBIGE)
CLS(QSYS/QSYSCLS35)
MAXACT(*NOMAX)
POOLID(1)
Used for: AS/400 ADDRTGE SBSD(QSYS/QSYSWRK)
Advanced 36 SEQNBR(2526)
Server Jobs CMPVAL(QM36MEDIUM)
PGM(QSYS/QCMD)
CLS(QSYS/QSYSCLS20)
MAXACT(*NOMAX)
POOLID(1)
Used for: AS/400 ADDRTGE SBSD(QSYS/QSYSWRK)
Advanced 36 SEQNBR(2527)
Server Jobs CMPVAL(QM36LOW)
PGM(QSYS/QCMD)
CLS(QSYS/QSYSCLS50)
MAXACT(*NOMAX)
POOLID(1)
Used for: AS/400 ADDRTGE SBSD(QSYS/QSYSWRK)
Advanced 36 SEQNBR(2528)
Server Jobs CMPVAL(QM36HIGH)
PGM(QSYS/QCMD)
CLS(QSYS/QSYSCLS10)
MAXACT(*NOMAX)
POOLID(1)
| Used for: DRDA ADDRTGE SBSD(QSYS/QSYSWRK)
| over TCP/IP SEQNBR(2566)
CMPVAL(QRWTLSTN)
PGM(QSYS/QRWTLSTN)
CLS(QSYS/QSYSCLS20)
MAXACT(*NOMAX)
POOLID(1)
| Used for: TCP/IP ADDRTGE SBSD(QSYS/QSYSWRK)
| SEQNBR(2571)
| CMPVAL(QZDFMSVR)
| PGM(QSYS/QZDFMSVR)
| CLS(QSYS/QSYSCLS25)
| MAXACT(*NOMAX)
| POOLID(1)
ADDRTGE SBSD(QSYS/QSYSWRK)
SEQNBR(9999)
CMPVAL(*ANY)
PGM(QSYS/QCMD)
CLS(QSYS/QSYSCLS50)
MAXACT(*NOMAX)
POOLID(1)

Appendix C. IBM-Supplied Object Contents 493

 Table 132. IBM-Supplied Subsystem Descriptions (SBSD) (continued)
Used for: System ADDJOBQE SBSD(QSYS/QSYSWRK)
Subsystem Job JOBQ(QSYS/QSYSNOMAX)
Queue MAXACT(*NOMAX)
SEQNBR(10)
Used for: ADDJOBQE SBSD(QSYS/QSYSWRK)
Automatic Problem JOBQ(QSYS/QPDAUTOPAR)
Analysis MAXACT(5)
SEQNBR(20)
Used for: Auto ADDJOBQE SBSD(QSYS/QSYSWRK)
Problem JOBQ(QSYS/QESAUTON)
Notification MAXACT(5)
SEQNBR(30)
Used for: MSS/400 ADDJOBQE SBSD(QSYS/QSYSWRK)
SystemView JOBQ(QSYS/QNMSVQ)
Server MAXACT(5)
SEQNBR(40)
Used for: C++ ADDPJE SBSD(QSYS/QSYSWRK)
Cooperative PGM(QSYS/Q5BWHSRV)
Debugger TRJOBS(*NO)
INLJOBS(1)
THRESHOLD(1)
CL(QSYS/QSYSCLS20)
Used for: Restore ADDPJE SBSD(QSYS/QSYSWRK)
Authorities PGM(QSYS/QSRRATBL)
STRJOBS(*NO)
CLS(QGPL/QINTER)
MAXJOBS(5)
Used for: DRDA ADDPJE SBSD(QSYS/QSYSWRK)
jobs PGM(QSYS/QRWTSRVR)
STRJOBS(*NO)
INLJOBS(1)
THRESHOLD(1)
CLS(QSYS/QSYSCLS20)

Used for: ADSM ADDPJE SBSD(QSYS/QSYSWRK)

jobs PGM(QSYS/QANEAGNT)
STRJOBS(*NO)
INLJOBS(3)
THRESHOLD(2)
CLS(QSYS/QSYSCLS20)

Used for: SQL jobs ADDPJE SBSD(QSYS/QSYSWRK)

PGM(QSYS/QSQSRVR)
STRJOBS(*NO)
INLJOBS(5)
THRESHOLD(2)
CLS(QSYS/QSYSCLS20)

| QUSRWRK User Subsystem CRTSBSD SBSD(QSYS/QUSRWRK)

| Description POOLS((1 *BASE))
| MAXJOBS(*NOMAX)
| SGNDSPF(*QDSIGNON)
| TEXT(’User subsystem’)
|

494 OS/400 Work Management V4R4

 Table 132. IBM-Supplied Subsystem Descriptions (SBSD) (continued)
| Used for: Run ADDRTGE SBSD(QSYS/QUSRWRK)
| Priority 7 SEQNBR(10)
| CMPVAL(RUNPTY07)
| PGM(QSYS/QCMD)
| CLS(QSYS/QSYSCLS07)
| MAXACT(*NOMAX)
| POOLID(1)
|
| Used for: Run ADDRTGE SBSD(QSYS/QUSRWRK)
| Priority 10 SEQNBR(20)
| CMPVAL(RUNPTY10)
| PGM(QSYS/QCMD)
| CLS(QSYS/QSYSCLS10)
| MAXACT(*NOMAX)
| POOLID(1)
|
| Used for: Run ADDRTGE SBSD(QSYS/QUSRWRK)
| Priority 20 SEQNBR(30)
| CMPVAL(RUNPTY20)
| PGM(QSYS/QCMD)
| CLS(QSYS/QSYSCLS20)
| MAXACT(*NOMAX)
| POOLID(1)
|
| Used for: Run ADDRTGE SBSD(QSYS/QUSRWRK)
| Priority 25 SEQNBR(40)
| CMPVAL(RUNPTY25)
| PGM(QSYS/QCMD)
| CLS(QSYS/QSYSCLS25)
| MAXACT(*NOMAX)
| POOLID(1)
|
| Used for: Run ADDRTGE SBSD(QSYS/QUSRWRK)
| Priority 35 SEQNBR(50)
| CMPVAL(RUNPTY35)
| PGM(QSYS/QCMD)
| CLS(QSYS/QSYSCLS35)
| MAXACT(*NOMAX)
| POOLID(1)
|
| Used for: Run ADDRTGE SBSD(QSYS/QUSRWRK)
| Priority 50 SEQNBR(60)
| CMPVAL(RUNPTY50)
| PGM(QSYS/QCMD)
| CLS(QSYS/QSYSCLS50)
| MAXACT(*NOMAX)
| POOLID(1)
|
| ADDRTGE SBSD(QSYS/QUSRWRK)
| SEQNBR(9999)
| CMPVAL(*ANY)
| PGM(QSYS/QCMD)
| CLS(QSYS/QSYSCLS50)
| MAXACT(*NOMAX)
| POOLID(1)
|

Appendix C. IBM-Supplied Object Contents 495

 Table 132. IBM-Supplied Subsystem Descriptions (SBSD) (continued)
| ADDJOBQE SBSD(QSYS/QUSRWRK)
| JOBQ(QSYS/QUSRNOMAX)
| MAXACT(*NOMAX)
| SEQNBR(10)

Restore Customized Information for IBM-Supplied Job Descriptions

During an installation of the OS/400 Operating System or upgrade to a new release
of the operating system, the Keep Customization option restores customized
information from specific IBM supplied system job descriptions or subsystem
descriptions. The customization information for JOBD and SBSD objects that exist
on your system prior to the installation are merged with the information from the
JOBD and SBSD from the installation.

Table 133 and Table 134 contain the SBSDs and the JOBDs from which you can
restore customized information.
Table 133. Keep Customized Information for IBM-Supplied Job Descriptons
Object Description
QCTL Controlling subsystem
QCTLIJBD Controlling subsystem IGC
QESAUTON Automatic problem notification
QFSIOPWK File Server I/O Processor
QMSF Job description used by QPGMF job
QPDAUTOPAR Job description used for automatic problem
analysis
QQQTEMPS DBS/400 JOBD used by QSYSWRK
QSPLERROR Spooling error
QSTRUPDJ Autostart
| QSYSWRK System subsystem job description
QTMSNMP SNMP job description
QZMFEJBD Job description for QSYSWRK autostart job
entry

Restore Customized Information for Subsystem Descriptions

Table 134. Keep Customized Information for Subsystem Descriptions
Object Description
QBASE Basic controlling
QBATCH Batch
QCMN Communications
QCTL Controlling
QINTER Interactive
QPGMR Programmer
QSNADS SNA distribution

496 OS/400 Work Management V4R4

 Table 134. Keep Customized Information for Subsystem Descriptions (continued)
Object Description
QSPL Spooling Subsystem
QSYSWRK System
| QUSRWRK User subsystem

Appendix C. IBM-Supplied Object Contents 497

 Source for CL Start-up Program
| Table 135. Source for CL Start-up Program
| Object Command CL Program Source
| QSTRUP CRTCLPGM PGM
| DCL VAR(&STRWTRS) TYPE(*CHAR) LEN(1)
| DCL VAR(&CTLSBSD) TYPE(*CHAR) LEN(20)
| DCL VAR(&CPYR) TYPE(*CHAR) LEN(90) VALUE(’+
| 5769-SS1 (C) COPYRIGHT IBM CORP 1980, 1999. +
| LICENSED MATERIAL - PROGRAM PROPERTY OF IBM’)
|
| QSYS/STRSBS SBSD(QSPL)
| MONMSG MSGID(CPF0000)
|
| QSYS/STRSBS SBSD(QSERVER)
| MONMSG MSGID(CPF0000)
|
| QSYS/STRSBS SBSD(QUSRWRK)
| MONMSG MSGID(CPF0000)
|
| QSYS/RLSJOBQ JOBQ(QGPL/QS36MRT)
| MONMSG MSGID(CPF0000)
|
| QSYS/RLSJOBQ JOBQ(QGPL/QS36EVOKE)
| MONMSG MSGID(CPF0000)
|
| QSYS/STRCLNUP
| MONMSG MSGID(CPF0000)
|
| QSYS/RTVSYSVAL SYSVAL(QCTLSBSD) RTNVAR(&CTLSBSD)
| IF ((&CTLSBSD *NE ’QCTL QSYS ’) +
| *AND (&CTLSBSD *NE ’QCTL QGPL ’)) GOTO DONE
|
| QSYS/STRSBS SBSD(QINTER)
| MONMSG MSGID(CPF0000)
|
| QSYS/STRSBS SBSD(QBATCH)
| MONMSG MSGID(CPF0000)
|
| QSYS/STRSBS SBSD(QCMN)
| MONMSG MSGID(CPF0000)
| DONE:
|
| QSYS/RTVSYSVAL SYSVAL(QSTRPRTWTR) RTNVAR(&STRWTRS)
| IF (&
| STRWTRS = ’0’) GOTO NOWTRS
|
| CALL PGM(QSYS/QWCSWTRS)
| MONMSG MSGID(CPF0000)
|
| NOWTRS:
|
| RETURN
| CHGVAR VAR(&CPYR) VALUE(&CPYR)
| /* Needed to include CPYR variable in program. */
| ENDPGM

498 OS/400 Work Management V4R4

|
Appendix D. Characteristics of the Shipped System
Objects
The system is shipped with a predefined set of work management objects that can
be used immediately for processing. You can continue to use these objects or you
can create your own. Refer to Appendix C. IBM-Supplied Object Contents, for a
detailed description of these objects.

User Profiles
The user profiles shipped with the system are designed for the various types of
system users. For example, normal programmer functions are authorized to the
QPGMR user profile; security officer functions are authorized to the QSECOFR user
profile; and system operator functions are authorized to the QSYSOPR user profile.
The user profile associated with a job determines what system functions can be
done by that job.

These user profiles and subsystem descriptions are set up so any of several
IBM-supplied programs, such as QSYS/QCMD, are called to support interactive
jobs.

IBM-Supplied Program QSYS/QCMD

The program QSYS/QCMD processes CL commands specified interactively or in
batch jobs. It is called during the running of most jobs that run on the system as it
is shipped. An initial program can be specified in a user profile. If a job is routed to
QSYS/QCMD and the user profile under which the job is running has an initial
program, QSYS/QCMD calls the initial program. If no initial program is specified,
QSYS/QCMD displays the initial menu.

Similarly, the system menu is displayed for the QSYSOPR user profile as the initial
menu system.

Note: Threadsafe conditional requirement: QCMD may be called from the initial
thread of a job. QCMD may also be called while secondary threads are
active; however, it must not be called from a secondary thread.

The Controlling Subsystem as Shipped by IBM

The controlling subsystem is the subsystem description name specified in the
system value QCTLSBSD. When your system is shipped, QSYS/QBASE is
specified in QCTLSBSD as the controlling subsystem. QSYS/QBASE specifies that
all workstations are available for sign-on. The console is the only workstation that
can be used during an attended IPL. Therefore, if you assign another subsystem as
the controlling subsystem, you must have a workstation entry for the console in that
subsystem description. This workstation entry should specify that the subsystem
display the Sign On display (specify WRKSTNTYPE(*CONS) AT(*SIGNON) on the
Add Workstation Entry (ADDWSE) command).

© Copyright IBM Corp. 1997, 1999 499

QSYSWRK Subsystem Monitor
The system work (QSYSWRK) subsystem contains jobs that support system
functions started automatically at IPL and when the system comes out of restricted
state. It is possible to start and end this subsystem or use job commands, such as
the Change Job (CHGJOB) command, to change the jobs in this subsystem.
However, changing these jobs affects the operation system functions. Use caution
changing these jobs.

QECS Job
An example of a job running in QSYSWRK subsystem is QECS. QECS is a job that
provides communications sessions between AS/400 systems when one of the
systems is the service provider for others. (A system is a service provider when it
has SystemView System Manager/400 installed and configured on the system. The
other system or systems are called service requesters.) These communications
sessions use SNA MS/Transport support.

The QECS job starts whenever the Start SystemView System Manager
(STRSYSMGR) command runs. The STRSVSMGR command is part of the
SystemView System Manager/400 program. QECS is active only on the service
provider system. Thus, at every system IPL, the QECS job starts. The QECS job
must be active on both AS/400 systems for the information about PTFs, service
requests, and problem analysis to move between them.

The IBM-Supplied QBASE and QCMN Subsystem Descriptions

Before program start requests are accepted by the system, a subsystem that
supports communications must be started. There are two IBM-supplied subsystems,
QBASE and QCMN, that accept program start requests for all communications
types. QBASE is the default controlling subsystem and QCMN is the
communications subsystem. Having either of these subsystems active allows
program start requests to be accepted for all communications types.

The QCMN and QBASE subsystems have device type entries of *ALL and *ANY.
Both subsystems have the appropriate routing entries (with CMPVAL(PGMEVOKE
29)) so all program start requests received by the system are accepted. If you have
either of these subsystems and then start your own communications subsystem, or
other subsystems such as DSNX(QDSNX) or SNADS(QSNADS), read the following
section, “Communications Devices and Mode Allocation” on page 108. Both
subsystems will be attempting to allocate the same communications devices.

Important System Values Shipped by IBM

The system is shipped with many system values that control different aspects of
system operation. The following are some of the most significant ones (see
Chapter 2. System Values, for a full description of all system values).

500 OS/400 Work Management V4R4

QAUTOCFG
Controls whether the system should create device descriptions automatically for
devices such as workstations that you attach locally to your system. The default is
to perform automatic configuration. If you do not want the system to do this for you,
enter the following command:
CHGSYSVAL SYSVAL(QAUTOCFG) VALUE('0')

QCTLSBSD
Specifies the name of the controlling subsystem description. This is used to
automatically start the controlling subsystem during every IPL. The default is to use
the QBASE shipped subsystem description. You can change this to specify a
different subsystem description, and it will be used on the next IPL. For example, if
you want to use the QCTL shipped subsystem description for the controlling
subsystem, enter the following command (see the next section for more information
about the shipped subsystem descriptions):
CHGSYSVAL SYSVAL(QCTLSBSD) VALUE('QCTL QSYS')

QDEVNAMING
Specifies what device names are to be assigned whenever the system
automatically creates device descriptions for locally attached systems. This is
primarily for automatic configuration, but also applies to the device description
created for the console. The default is to use names like DSP01 for workstations
and PRT01 for printers. If you want to have names like W1 for workstations and P1
for printers, enter the following command:
CHGSYSVAL SYSVAL(QDEVNAMING) VALUE(*S36)

QIPLTYPE
Specifies how IPL is to occur. The default is that the IPL will be unattended,
meaning that once you start the IPL and the key is not in the MANUAL position, all
the system activity will be started without any operator intervention. If you want the
operator to have a chance to select any special functions during the IPL or change
certain system characteristics, set the Keylock switch to Manual or enter the
following command:
CHGSYSVAL SYSVAL(QIPLTYPE) VALUE('1')

This causes the IPL to be attended, meaning that the normal system activity is not
started until after the operator has responded to a series of displays. If the Keylock
switch is set to Manual, the IPL will be attended regardless of this system value.

QSECURITY
Specifies the type of security enforced by the system. The default is to require
passwords and to do authority checking.

Appendix D. Characteristics of the Shipped System 501

 QSPCENV
Specifies whether users by default are to run in a special environment. The default
is to not run in a special environment. This can be overridden in each user profile. If
you want all users by default to be running in the System/36 environment, enter the
following command:
CHGSYSVAL SYSVAL(QSPCENV) VALUE('*S36')

Subsystem Configurations Shipped by IBM

Two complete subsystem configurations are supplied by IBM and can be used
without changing. The one the system uses when you IPL is controlled by the
controlling subsystem description system value (QCTLSBSD) which defaults to
’QBASE QSYS’. This default configuration consists of the following subsystem
descriptions:
v QBASE: This is the controlling subsystem. It supports interactive, batch, and
communications jobs. It has an autostart job which automatically starts the QSPL
subsystem.
| v QSYSWRK: This is the system monitor subsystem. It contains jobs that support
| system functions that are started automatically at IPL and when the system
| comes out of restricted state.
| v QUSRWRK: This is the user work subsystem. It contains jobs that are started by
| servers to do work on behalf of a user.
| v QSERVER: This is the file server subsystem.

The other configuration, which is supplied by IBM, consists of the following

subsystem descriptions:
v QCTL: This is the controlling subsystem. It only supports signing on at the
console. It has an autostart job which automatically starts the QINTER, QBATCH,
QCMN, and QSPL subsystems.
v QINTER: This supports all interactive jobs (except at the console).
v QBATCH: This supports all batch jobs.
v QCMN: This supports all communications jobs.
v QSPL: This is the spool subsystem. It supports reader and writer jobs.
v QSNADS: This is the SNADS subsystem. It supports jobs controlling the
functions of the SNADS network, and IBM-supplied transaction programs, such
as document interchange and object distribution.
| v QSYSWRK: This is the system monitor subsystem. It contains jobs that support
| system functions that are started automatically at IPL and when the system
| comes out of restricted state.
| v QUSRWRK: This is the user work subsystem. It contains jobs that are started by
| servers to do work on behalf of a user.
| v QSERVER: This is the file server subsystem.

The QBASE configuration gives the ability to run all the same functions that you
can run with the QCTL configuration and is easier to manage because it consists of
fewer subsystems.

The QCTL default configuration allows for more granular control over your system
operations by dividing the system activity into different subsystems based on the
type of activity. For example, if you want to run batch jobs over the weekend or
overnight but do not want anyone to be able to sign on (except at the console), you

502 OS/400 Work Management V4R4

can easily do that with the QCTL configuration by simply ending the QINTER
subsystem. Another reason you might want to end one subsystem without affecting
others would be to change some of the subsystem description attributes without an
IPL. Many of these cannot be changed while the subsystem is active. If you need to
change one of these attributes and are using the QBASE configuration, you would
need to make a copy of QBASE with your changes, change the QCTLSBSD system
value, and then IPL the system.

If you are considering creating your own subsystem configuration, you may also find
that it is easier to use the QCTL configuration as a starting point than the QBASE
configuration.

If you want to use the IBM-supplied QCTL subsystem configuration, enter the
following command, which will take effect on the next IPL:
CHGSYSVAL SYSVAL(QCTLSBSD) VALUE('QCTL QSYS')

Appendix D. Characteristics of the Shipped System 503

504 OS/400 Work Management V4R4
 Appendix E. Work Management APIs and Exit Programs
The work management APIs (application programming interfaces) are:
Change Current Job (QWCCCJOB)
Changes information for the current job.
Change Job(QWTCHGJB)
Changes some of the attributes of the job or the thread.
Change Pool Attributes (QUSCHGPA)
Changes the size, activity level, and page option of system storage pools.
Change Pool Tuning Information (QWCCHGTN)
Changes information about tuning being performed on the system for the
different storage pools.
Change Subsystem Entry (QWDCSBSE)
Changes a subsystem entry in the specified subsystem description.
Control Trace (QWTCTLTR)
Turns the trace function on and off.
Create Job Structure(QWTCTJBS)
Creates the number of temporary job structures that are passed on the call.
| Delete Job Structure(QWTDTJBS)
| Allows deletion of excess temporary job structures. This makes the storage
| used by temporary job structures available without reloading the system.
Dump Flight Recorder (QWTDMPFR)
Dumps the contents of the flight recorders for jobs that have them.
Dump Lock Flight Recorder (QWTDMPLF)
Dumps the contents of the lock flight recorder for the device that is
specified in the parameter that is passed to the program.
List Active Subsystems (QWCLASBS)
Retrieves a list of active subsystems.
List Job (QUSLJOB)
Lists some or all jobs on the system.
List Job Schedule Entries (QWCLSCDE)
Lists the entries in the job schedule QDFTJOBSCD.
List Object Locks (QWCLOBJL)
Generates a list of lock information about a specific object or database file
member and places the list into the specified user space. If the object exists
in the integrated file system, the list will include the object path name
instead of the object name and library.
List Subsystem Entries (QWDLSBSE)
Lists some of the entries in the subsystem description and replaces any
data that already exists in the user space.
List Subsystem Job Queues (QWDLSJBQ)
Lists the job queues for a subsystem.
Move Job (QSPMOVJB)
Moves a job to another queue.

© Copyright IBM Corp. 1997, 1999 505

 Open List of Activation Attributes (QWVOLACT)
Generates a list of all the activation attributes that are associated with an
activation group in a given job.
Open List of Activation Group Attributes (QWVOLAGP)
Generates a list of all the activation groups that are associated with a given
job and their attributes.
Open List of Jobs (QGYOLJOB)
Generates a list of jobs on the sytem.
Retrieve Class Information (QWCRCLSI)
Returns the attributes of a class object. A class contains parameters that
control a routing step.
Retrieve Current Attributes (QWCRTVCA)
Retrieves specific attributes for the current thread.
Retrieve Data Area (QWCRDTAA)
Retrieves the contents of a data area.
Retrieve IPL Attributes (QWCRIPLA)
Returns the settings of options that are used during the IPL.
Retrieve Job Description Information (QWDRJOBD)
Retrieves information from a job description object.
Retrieve Job Information (QUSRJOBI)
Retrieves information, such as job attributes and performance data about a
specific job.
Retrieve Job Queue Information (QSPRJOBQ)
Retrieves information associated with a specified job queue.
Retrieve Job Status (QWCRJBST)
Retrieves the status of a job.
Retrieve Network Attributes (QWCRNETA)
Retrieves network attributes.
Retrieve Profile Exit Programs (QWTRTVPX)
Retrieves the profile exit flags, based on the format, that have been
designated to be called for specified user ID.
Retrieve Subsystem Information (QWDRSBSD)
QWDRSBSD retrieves information about a specific subsystem.
Retrieve System Status (QWCRSSTS)
Retrieves a group of statistics that represent the current status of the
system.
Retrieve System Values (QWCRSVAL)
Retrieves system values.
Set Job User Identity (QWTSJUID)
The Set Job User Identity (QWTSJUID) API has two operations that can be
used to explicitly set the job user identity of the current job. The two
operations are set and clear. The set operation explicitly sets the job user
identity to the name of the current user profile of the thread in which the
API is called. The clear operation clears any job user identity that was
previously set by the QWTSJUID API or the QwtSetJuid() function, and the
default job user identity will then take effect.

506 OS/400 Work Management V4R4

Set Lock Flight Recorder (QWTSETLF)
Turns the lock flight recorder on and off.
Set Profile (QWTSETP)
Validates the profile handle, locks the users profile, and changes the job to
run under the user and group profile represented by the profile handle.
Set Profile Exit Programs (QWTSETPX)
Sets for the specified user ID the profile exit programs to call based on the
format value.
Set Trace (QWTSETTR)
Starts the Trace Job (TRCJOB) command for the job passed on the job and
user name parameter at the earliest point while the job is starting.

The work management exit programs are:

Auxiliary-Storage Lower-Limit
This exit program is called when the available storage in the system
auxiliary storage pool (ASP) goes below the lower limit.
Exit Program for Trace Job
The Trace Job (TRCJOB) command prints trace records. If specified, the
TRCJOB command calls a user-written program before printing the trace
record. TRCJOB passes the trace record to the user-written program. If the
user-written program changes the first two characters of the trace record to
blanks or binary zeros, TRCJOB will not print the record.
Job Notification
This exit program logs notification messages to data queues when an
OS/400 job starts, ends, or is placed on a job queue.
Power Down System
This exit program is called when the Power Down System(PWRDWNSYS)
command or the End System (ENDSYS) command is used.
PreAttention program
This exit program is called when you press the System Attention key.
Presystem request program
This exit program is called when you press the System Request key.

For more details on work management APIs and exit programs, see the System API
Reference.

Appendix E. Work Management APIs and Exit Programs 507

508 OS/400 Work Management V4R4
Appendix F. Notices
This information was developed for products and services offered in the U.S.A. IBM
may not offer the products, services, or features discussed in this document in other
countries. Consult your local IBM representative for information on the products and
services currently available in your area. Any reference to an IBM product, program,
or service is not intended to state or imply that only that IBM product, program, or
service may be used. Any functionally equivalent product, program, or service that
does not infringe any IBM intellectual property right may be used instead. However,
it is the user’s responsibility to evaluate and verify the operation of any non-IBM
product, program, or service.

IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not give you any
license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBM
Intellectual Property Department in your country or send inquiries, in writing, to:
IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan

The following paragraph does not apply to the United Kingdom or any other
country where such provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS
PUBLICATION “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A
PARTICULAR PURPOSE. Some states do not allow disclaimer of express or
implied warranties in certain transactions, therefore, this statement may not apply to
you.

This information could include technical inaccuracies or typographical errors.

Changes are periodically made to the information herein; these changes will be
incorporated in new editions of the publication. IBM may make improvements and/or
changes in the product(s) and/or the program(s) described in this publication at any
time without notice.

Any references in this information to non-IBM Web sites are provided for
convenience only and do not in any manner serve as an endorsement of those
Web sites. The materials at those Web sites are not part of the materials for this
IBM product and use of those Web sites is at your own risk.

Licensees of this program who wish to have information about it for the purpose of
enabling: (i) the exchange of information between independently created programs
and other programs (including this one) and (ii) the mutual use of the information
which has been exchanged, should contact:
IBM Corporation

© Copyright IBM Corp. 1997, 1999 509

 Software Interoperability Coordinator
3605 Highway 52 N
Rochester, MN 55901-7829
U.S.A.

Such information may be available, subject to appropriate terms and conditions,

including in some cases, payment of a fee.

The licensed program described in this information and all licensed material
available for it are provided by IBM under terms of the IBM Customer Agreement,
IBM International Program License Agreement, or any equivalent agreement
between us.

Any performance data contained herein was determined in a controlled

environment. Therefore, the results obtained in other operating environments may
vary significantly. Some measurements may have been made on development-level
systems and there is no guarantee that these measurements will be the same on
generally available systems. Furthermore, some measurement may have been
estimated through extrapolation. Actual results may vary. Users of this document
should verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers of those
products, their published announcements or other publicly available sources. IBM
has not tested those products and cannot confirm the accuracy of performance,
compatibility or any other claims related to non-IBM products. Questions on the
capabilities of non-IBM products should be addressed to the suppliers of those
products.

All statements regarding IBM’s future direction or intent are subject to change or
withdrawal without notice, and represent goals and objectives only.

This information contains examples of data and reports used in daily business
operations. To illustrate them as completely as possible, the examples include the
names of individuals, companies, brands, and products. All of these names are
fictitious and any similarity to the names and addresses used by an actual business
enterprise is entirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, which

illustrates programming techniques on various operating platforms. You may copy,
modify, and distribute these sample programs in any form without payment to IBM,
for the purposes of developing, using, marketing or distributing application programs
conforming to the application programming interface for the operating platform for
which the sample programs are written. These examples have not been thoroughly
tested under all conditions. IBM, therefore, cannot guarantee or imply reliability,
serviceability, or function of these programs. You may copy, modify, and distribute
these sample programs in any form without payment to IBM for the purposes of
developing, using, marketing, or distributing application programs conforming to
IBM’s application programming interfaces.

Each copy or any portion of these sample programs or any derivative work, must
include a copyright notice as follows:

© (your company name) (year). Portions of this code are derived from IBM Corp.
Sample Programs. © Copyright IBM Corp. 1997 1999. All rights reserved.

510 OS/400 Work Management V4R4

 If you are viewing this information softcopy, the photographs and color illustrations
may not appear.

Programming Interface Information

This publication is intended to help you to (INSERT TASK THAT CUSTOMER IS TO
DO FROM BOOK). This publication documents General-Use Programming Interface
and Associated Guidance Information provided by (INSERT PRODUCT NAME
HERE).

General-Use programming interfaces allow the customer to write programs that

obtain the services of (INSERT PRODUCT NAME HERE).

This publication is intended to help you to (INSERT TASK THAT CUSTOMER IS TO

DO FROM THIS BOOK). This publication documents Product-Sensitive
Programming Interface and Associated Guidance Information provided by (INSERT
PRODUCT NAME HERE).

Product-Sensitive programming interfaces allow the customer installation to perform

tasks such as diagnosing, modifying, monitoring, repairing, tailoring, or tuning of this
IBM software product. Use of such interfaces creates dependencies on the detailed
design or implementation of the IBM software product. Product-Sensitive
programming interfaces should be used only for these specialized purposes.
Because of their dependencies on detailed design and implementation, it is to be
expected that programs written to such interfaces may need to be changed in order
to run with new product releases or versions, or as a result of service.

This publication is intended to help you to (INSERT TASK HERE). This publication
primarily documents General-Use Programming Interface and Associated Guidance
Information provided by (INSERT PRODUCT NAME HERE).

General-Use programming interfaces allow the customer to write programs that

obtain the services of (INSERT PRODUCT NAME HERE).

However, this publication also documents Product-Sensitive Programming Interface

and Associated Guidance Information.

Product-Sensitive programming interfaces allow the customer installation to perform

tasks such as diagnosing, modifying, monitoring, repairing, tailoring, or tuning of this
IBM software product. Use of such interfaces creates dependencies on the detailed
design or implementation of the IBM software product. Product-Sensitive
programming interfaces should be used only for these specialized purposes.
Because of their dependencies on detailed design and implementation, it is to be
expected that programs written to such interfaces may need to be changed in order
to run with new product releases or versions, or as a result of service.

Programming Interface and Associated Guidance Information is identified where it

occurs, either by an introductory statement to a chapter or section or by the
following: Product-Sensitive Programming Interface:

This publication is intended to help you to (INSERT TASK HERE).

This publication also documents General-Use Programming Interface and

Associated Guidance Information.

Appendix F. Notices 511

 General-Use programming interfaces allow the customer to write programs that
obtain the services of (INSERT PRODUCT NAME HERE).

General-Use Programming Interface and Associated Guidance Information is

identified where it occurs, either by an introductory statement to a chapter or
section or by the following: General-Use Programming Interface:

Trademarks
The following terms are trademarks of International Business Machines Corporation
in the United States, or other countries, or both:

Advanced Peer-to-Peer Networking

AFP
AnyNet
APPN
Application System/400
AS/400
AS/400e
C/400
DRDA
IBM
Information Assistant
IDPS
Office Vision/400
Operating System/400
Operational Assistant
OS/400
OS/2
RPG
SAA
System View
System/36
400

C-bus is a trademark of Corollary, Inc. in the United States and/or other countries.

Java and all Java-based trademarks and logos are trademarks or registered
trademarks of Sun Microsystems, Inc. in the United States and/or other countries.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks of
Microsoft Corporation in the United States and/or other countries.

PC Direct is a trademark of Ziff Communications Company in the United States

and/or other countries and is used by IBM Corporation under license.

ActionMedia, LANDesk, MMX, Pentium, and ProShare are trademarks of Intel

Corporation in the United States and/or other countries.

UNIX is a registered trademark in the United States and/or other countries licensed
exclusively through X/Open Company Limited.

Other company, product, and service names may be the trademarks or service
marks of others.

512 OS/400 Work Management V4R4

The following AS/400 books contain information performance and how to do system
you may need. The books are listed with their title performance measurement, reporting, capacity
and base order number. planning, and application analysis.
v OS/2 Warp Server for AS/400 Administration,
Programming Books SC41-5423-00, describes using LAN Server
and the file server I/O processor for file serving
v Backup and Recovery, SC41-5304-03, provides on the AS/400 system. You can use the file
the programmer with information about the server I/O processor to consolidate servers
different media available to save and protect within your network, simplify administration of a
system data as well as a description of how to network, centralize the management of the
record changes made to database files and network, and improve security within the
how that information can be used for system client/server environment.
recovery and activity report information.
v Client Access/400 for DOS and OS/2 Technical
v Data Management, SC41-5710-00, describes Reference, SC41-3563-01, contains technical
the characteristics and programming uses of information for advanced configuration and
database files and spooled files. It also provides tailoring of Client Access with the DOS or OS/2
information about applications with access to operating system.
input and output file data that is external to the
application. v Security - Reference, SC41-5302-03, provides
the programmer (or someone who is assigned
v DB2 UDB for AS/400 Database Programming, the responsibilities of a security officer) with
SC41-5701-02, provides a detailed discussion information about general security concepts and
of the AS/400 database organization, including planning for security on the system. It also
information on how to create, describe, and includes information for all users about resource
update database files on the system. security.
v CL Programming, SC41-5721-02, provides the v System API Reference, SC41-5801-03,
application programmer or programmer with a provides information on how to create, use, and
wide-ranging discussion of the AS/400 delete objects that help manage system
programming topics, including a general performance, use spooling, and maintain
discussion of objects and libraries, control database files efficiently. This manual also
language (CL) programming, controlling flow includes information on creating and
and communicating between programs, working maintaining the programs for system objects
with objects in CL programs, and creating CL and retrieving OS/400 information by working
programs. with objects, database files, jobs, and spooling.
v CL Reference (Abridged), SC41-5722-03,
provides the application programmer or
programmer with a description of the AS/400
Communications Books
control language (CL). Each command is v APPC Programming, SC41-5443-00, is
defined, including its syntax diagram, intended for the programmer responsible for
parameters, default values, and keywords. writing application programs that use advanced
v National Language Support, SC41-5101-01, program-to-program communications (APPC).
describes the concepts of national language v Alerts Support, SC41-5413-00, provides the
support on the AS/400 system. This support system operator, programmer, or system
provides a means of operating in a multilingual administrator with information for configuring the
environment. AS/400 system to use the remote management
v Performance Tools for AS/400, SC41-5340-00, support (distributed host command facility), the
provides the programmer with information about change management support (distributed
what performance management is, gives an systems node executive), and the problem
overview of the tools, and describes how the management support (alerts).
tools can be used to help manage system v SNA Distribution Services, SC41-5410-01,
performance. The manual gives instructions on provides the system operator or system
how to approach the analysis of system administrator with information about

© Copyright IBM Corp. 1997, 1999 513

 administering data communications applications
on the AS/400 system. This guide may also be
useful to a programmer who works with data
communications functions on the AS/400
system.
v ICF Programming, SC41-5442-00, provides the
application programmer with the information
needed to write application programs that use
the AS/400 communications and the
OS/400-ICF file. It also contains examples of
communications programs and describes return
codes.
v Remote Work Station Support, SC41-5402-00,
provides the system administrator or end user
with concepts, examples, and information on
preparation and configuration for using the
display station pass-through function. This
guide also contains information about using
3270 remote attachment, the Distributed Host
Command Facility (DHCF) network, and the
X.21 short hold mode (SHM) network.
v TCP/IP Configuration and Reference,
SC41-5420-03, provides information for
configuring and using AS/400 TCP/IP support.
The applications included are Network Status
(NETSTAT), Packet InterNet Groper (PING),
TELNET, File Transfer Protocol (FTP), Simple
Mail Transfer Protocol (SMTP), Post Office
Protocol (POP) Server, line printer requester
(LPR), line printer daemon (LPD), Bootstrap
Protocol (BOOTP), Trivial File Transfer Protocol
(TFTP), Route Daemon (RouteD), Remote
Execution (REXEC), and Workstation Gateway.
This book also contains CL commands for
AS/400 TCP/IP.

514 OS/400 Work Management V4R4

Index
Special Characters activity level (continued)
of storage pools
*BASE (base storage pool) 87
active threads 92
*INTERACT storage pool 87
performance 263
*MACHINE (machine pool) 87
QBASACTLVL system value 26
*NOMAX
QMAXACTLVL system value 47
QRCLSPLSTG system value 61
QSPL 244
*SPOOL storage pool 87
routing entry 93
storage pool 93
A subsystem 89, 93
abnormal end system 93
job accounting 283 using to tune system automatically 239
preventing lost journal entry 284 workstation entry 93
accessing actuator
message data 151 definition 252
accounting add job schedule entry
job 269 authority 226
journal entry 269 Add Job Schedule Entry (ADDJOBSCDE)
journal information command 226, 227
DP 277 Add Performance Explorer Definition (ADDPEXDFN)
JB 275 command 432
SP 277 Add Routing Entry (ADDRTGE) command 119
printer file 270 adding
resource 269 a second job queue 107
segment, illustration 274 autostart job entry 95
accounting code communications entry 98
authority to assign 282 job queue entry 98
changing 274, 282 job schedule entry 226
controlling assignment in user profile 287 performance explorer definition 432
definition 274 prestart job entry 100
security 282 routing entry 100, 119
accounting data sequence numbers in routing entries 102
DP and SP printer file 277 workstation entry 96
accounting journal adding routing entries to subsystem description 102
damaged 284 additional active jobs (QADLACTJ) system value 10,
processing 281 18
accounting level (QACGLVL) system value 11, 16 additional storage (QADLSPLA) system value 10, 18
accumulated alerts (ALRHLDCNT) network attribute 77 additional total jobs (QADLTOTJ) system value 10, 18
active job ADDJOBSCDE (Add Job Schedule Entry)
definition 262 command 226, 227
description 94 ADDPEXDFN (Add Performance Explorer Definition)
state 261 command 432
active jobs (QACTJOB) system value 10, 17 ADDRTGE (Add Routing Entry) command 119
active thread 262 adjusting performance
active threads initial program load (IPL) 240
activity levels adjustment
in storage pool 92 CHGSHRPOOL command 241
activity level expert cache 240
*BASE 245 pool size 242
adjusting 245 storage pool paging 240
changing shared pool 89 Advanced Peer-to-Peer Networking (APPN)
controlling 93 network attributes 77
defining 93 alert controller (ALRCTLD) network attribute 77
definition 92 alert controller description 77
description 93 alert default focal point (ALRDFTFP) network
how they work 93 attribute 77
job queue entry 93 alert log status (ALRLOGSTS) network attribute 77
maximum 93 alert manager (QALERT) system job 237

© Copyright IBM Corp. 1997, 1999 515

alert network attribute 77 attention key
alert primary focal point (ALRPRIFP) network BASIC session 182
attribute 77 call level 180
alert status (ALRSTS) network attribute 77 setting 180
allocating status 180
job queues 105, 205 when to not use 182
allocation when to use 181
communications device attention-key-handling program
usage guidelines 115 approach for programmers 190
communications devices and modes 108 coding example 191
pool 90 Attention-key-handling program
workstation device scenario 104 description 171
workstation devices 103 designing 184
allocation system values combination approach 189
overview 10 dynamic menu approach 188
allow object restore (QALWOBJRST) system value 12, fixed menu approach 184
18 attention-key-handling program
allow user domain (QALWUSRDMN) system value 12, effect of call level 180
19 Attention-key-handling program
allowing guidelines for coding 182
group job to communicate 174
attention-key-handling program
more batch jobs to run 112
identifying a program as 180
ALRBCKFP (alert backup focal point) network
setting 180
attribute 77
Attention-key-handling program
ALRCTLD (alert controller) network attribute 77
used with commands 171
ALRDFTFP (alert default focal point) network
attribute 77 attention key program
ALRFTR (alert filter) network attribute 77 coding example 186
ALRHLDCNT (accumulated alerts) network attribute 77 attention program (QATNPGM) system value 6, 20
ALRLOGSTS (alert log status) network attribute 77 ATTN (Attention) key
ALRPRIFP (alert primary focal point) network BASIC session 182
attribute 77 call level 180
ALRRQSFP (alert request focal point) network programming for 171
attribute 77 setting 180
ALRSTS (alert status) network attribute 77 status 180
ALWADDCLU (allow add to cluster) network when to not use 182
attribute 77 when to use 181
API (application programming interface) attributes
work management 505 prestart job 221
apostrophes, system values enclosed 14 specifying for batch jobs 107, 197
application programming interface (API) auditing control (QAUDCTL) system value 12, 20
work management 505 auditing end action (QAUDENDACN) system value 12,
APPN (Advanced Peer-to-Peer Networking) 21
network attributes 77 auditing force level (QAUDFRCLVL) system value 12,
APPN node type (NODETYPE) network attribute 77 22
APPN route addition (RAR) network attribute 77 auditing level (QAUDLVL) system value 12, 22
assigning a job queue to a subsystem 205 authority
assigning sequence numbers to routing entries 102 assign job accounting codes 282
assistance level (QASTLVL) system value 6, 20 prestart job 220
Asynchronous Signal SIGTERM 127 authority checking
AT parameter performance 254
controlling subsystem 110 automatic
prevent Sign-On prompt 115 data collection for the first time 296
Attention (ATTN) key performance data collection 296
BASIC session 182 automatic configuration device (QAUTOVRT) system
call level 180 value 6, 26
programming for 171 automatic configuration indicator (QAUTOCFG) system
setting 180 value 6, 24
status 180 example 500
when to not use 182 automatic configuration remote controller (QAUTORMT)
when to use 181 system value 6, 25

516 OS/400 Work Management V4R4

automatic IPL date and time (QIPLDATTIM) system batch processing
value 6, 43 job accounting 278
automatic system disabled (QAUTOSPRPT) system batch subsystem
value 6, 25 for nighttime jobs, example 117
automatic system tuning 239 job queue 105
adjustments to storage pools and activity levels 239 scenario with MAXACT(1) 95
dynamic performance adjustments 239 book path search (QBOOKPATH) system value 6, 27
performance adjustment at IPL 240
storage pool paging 240
autostart job 211
C
calendar
benefits 211
job schedule entry tips 229
initiation 211
call level
job description 211
Set Attention Program (SETATNPGM)
autostart job entry
command 180
adding 95
call stack
changing 96
thread23 121
removing 96
calling
security 211
special recovery program 116
auxiliary storage
calling program directly
definition 241
benefits for interactive jobs 166
auxiliary storage lower limit (QSTGLOWLMT) system
calling program in batch
value 66
advantage 209
auxiliary storage lower limit action (QSTGLOWACN)
causing subsystem to deallocate a communications
system value 66
device 109
century (QCENTURY) system value 5, 28
B Change Accounting Code (CHGACGCDE)
base activity level (QBASACTLVL) system value 11, command 282
26 change current job (QWCCCJOB) API 505
base pool (QBASPOOL) system value 11, 27 Change Group Attributes (CHGGRPA) command 172
base storage pool Change IPL Attributes (CHGIPLA)
scenario with subsystems 95 compressing job tables 128
base storage pool (*BASE) Change Job (CHGJOB) command
definition 87 move from one job queue 206
performance tuning 258 change job (QWTCHGJB) API
pool size 245 (QWTCHGJB) change job API 505
BASIC session Change Job Description (CHGJOBD) command 133
attention key 182 Change Job Schedule Entry (CHGJOBSCDE)
batch job 206 command 226, 227
allowing more to run 112 Change Network Attributes (CHGNETA) command 77,
approaches 206 78
CL command logged for 147 change pool attributes (QUSCHGPA) API 505
control routing step using QCMD/QSYS 207, 208 change pool tuning (QWCCHGTN) API 505
definition 121, 195 Change Program (CHGPGM) command 429
description 206 Change Subsystem Description (CHGSBSD)
how it starts 196 command 86, 89
how to schedule 223 change subsystem entry (QWDCSBSE) API 505
job attribute 196 Change System Value (CHGSYSVAL) command
job description, user parameter 133 example 14
job queue 198 used with CL program 14
log 147 changing
multiple pools 257 accounting code 282
overview 196 activity level of shared pool 89
QPFRCOL 296 amount of information stored 153
rerouting 137 autostart job entry 96
sending completion messages for 200 classes 134
specifying attributes 107, 197 communications entry 99
starting 166 group attribute 172
submitting 195 job 206
submitting, example 195 job attribute 124
transferring 137, 138 job description 132, 133
use of shipped work management objects 105 job queue entry 98

Index 517
changing (continued) clearing
job schedule entry 282 pool 257
LOGCLPGM attribute 147 CLRPOOL (Clear Pool) command 257
logging level 153 coded character set identifier (QCCSID) system
network attributes 77 value 6, 27
nongroup job to and from group job 172 collecting 289
number of jobs allowed in subsystem 111 system and communications data 300
number of jobs on job queue, example 205 system data only 300
number of jobs running from job queue 205 collecting performance data
output queue for all jobs 145 automatic weekly 296
prestart job entry 100 automatically 296
priority 124 automatically for the first time 296
program 429 communications and system data 293
routing entry 100 data on all tasks, jobs, and threads 293
Sign-On display 85 database query data 293
size of a storage pool 88 estimating file size 299
size of shared pool 89 system data only 292
size of storage pools (not machine or base) 88 trace data 294
subsystem attribute 89 collection interval
subsystem description 86, 89 database compared to internal 298
system value 14 collection points 429
time slice 124 Collection Services 289
workstation entry 96 introduction 289
character identifier control (QCHRIDCTL) system reasons for using 291
value 6, 29 combination approach
character set and code page (QCHRID) system
attention-key-handling 189
value 6, 29
command, CL
Check Record Locks (CHKRCDLCK) command 173
Add Job Schedule Entry (ADDJOBSCDE) 226, 227
checking
Add Performance Explorer Definition
record lock 173
(ADDPEXDFN) 432
CHGACGCDE (Change Accounting Code)
Add Routing Entry (ADDRTGE) 119
command 282
ADDJOBSCDE (Add Job Schedule Entry) 226, 227
CHGGRPA (Change Group Attributes) command 172
ADDPEXDFN (Add Performance Explorer
CHGJOB (Change Job) command
Definition) 432
move from one job queue 206
ADDRTGE (Add Routing Entry) 119
CHGJOBD (Change Job Description) command 133
Change Accounting Code (CHGACGCDE) 282
CHGJOBSCDE (Change Job Schedule Entry)
Change Group Attributes (CHGGRPA) 172
command 226, 227
Change Job (CHGJOB) 206
CHGNETA (Change Network Attributes) command 77,
Change Job Description (CHGJOBD) 133
78
Change Job Schedule Entry (CHGJOBSCDE) 226,
CHGPGM (Change Program) command 429
227
CHGSBSD (Change Subsystem Description)
Change Network Attributes (CHGNETA) 77
command 86, 89
Change Program (CHGPGM) 429
CHGSYSVAL (Change System Value) command Change Subsystem Description (CHGSBSD) 86, 89
example 14 Change System Value (CHGSYSVAL) 14
used with CL program 14 Check Record Locks (CHKRCDLCK) 173
CHKRCDLCK (Check Record Locks) command 173 CHGACGCDE (Change Accounting Code) 282
CL command 146 CHGGRPA (Change Group Attributes) 172
interactive job 146 CHGJOB (Change Job) 206
logged CHGJOBD (Change Job Description) 133
batch job 147 CHGJOBSCDE (Change Job Schedule Entry) 226,
interactive job 146 227
CL variables CHGNETA (Change Network Attributes) 77, 78
placing system values in 16 CHGPGM (Change Program) 429
class CHGSBSD (Change Subsystem Description) 86, 89
changing 134 CHGSYSVAL (Change System Value) 14
contents 134 CHKRCDLCK (Check Record Locks) 173
creating 134 Clear Pool (CLRPOOL) 257
object 134 CLRPOOL (Clear Pool) 257
relationship to job and subsystem description 136 Create Bound C Program (CRTBNDC) 429
Clear Pool (CLRPOOL) command 257 Create Job Description (CRTJOBD) 132

518 OS/400 Work Management V4R4

command, CL (continued) command, CL (continued)
Create Job Queue (CRTJOBQ) 226, 204 Set Object Access (SETOBJACC) 226
Create Subsystem Description (CRTSBSD) 83, 89, SETATNPGM (Set Attention Program) 180
110, 119 SETOBJACC (Set Object Access) 257
CRTBNDC (Create Bound C Program) 429 Start Performance Explorer (STRPEX) 433
CRTCLS (Create Class) 134 Start Performance Monitor (STRPFRMON) 292
CRTJOBD (Create Job Description) 132 STRPEX (Start Performance Explorer) 433
CRTJOBQ (Create Job Queue) 117, 204 STRPFRMON (Start Performance Monitor) 292
CRTSBSD (Create Subsystem Description) 83, 89, Submit Database Jobs (SBMDBJOB) 106
110, 119 Submit Diskette Jobs (SBMDKTJOB) 106
Delete Job Description (DLTJOBD) 133 Submit Job (SBMJOB) 106, 197
Delete Subsystem Description (DLTSBSD) 85 TFRGRPJOB (Transfer to Group Job) 172
Disconnect Job (DSCJOB) 167 TFRJOB (Transfer Job) 129, 137
Display File Field Description (DSPFFD) 434 Transfer Job (TFRJOB) 129, 137
Display Job Description (DSPJOBD) 133 Transfer to Group Job (TFRGRPJOB) 172
Display Log (DSPLOG) 148 Work with Active Jobs (WRKACTJOB) 238, 252
Display Network Attributes (DSPLNETA) 78 Work with Disk Status (WRKDSKSTS) 251
Display Object Description (DSPOBJD) 147 Work with Job Descriptions (WRKJOBD) 133
Display Subsystem Description (DSPSBSD) 206 Work with Job Schedule Entries
Display System Value (DSPSYSVAL) 14 (WRKJOBSCDE) 227
DLTJOBD (Delete Job Description) 133 Work with System Values (WRKSYSVAL) 13
DLTSBSD (Delete Subsystem Description) 85 WRKACTJOB (Work with Active Jobs) 238, 252
DMPTRC (Dump Trace) 295 WRKDSKSTS (Work with Disk Status) 251
DSCJOB (Disconnect Job) 167 WRKJOBD (Work with Job Descriptions) 133
DSPFFD (Display File Field Description) 434 WRKJOBSCDE (Work with Job Schedule
DSPJOBD (Display Job Description) 133 Entries) 227
DSPLOG (Display Log) 148 WRKSYSVAL (Work with System Values) 13
DSPNETA (Display Network Attributes) 78 communications (QSYSCOM1) system job 238
DSPOBJD (Display Object Description) 147 communications arbiters (QCMNARB) system value 30
DSPSBSD (Display Subsystem Description) 206 communications controller
DSPSYSVAL (Display System Value) 14 file entry 383
Dump Trace (DMPTRC) 295 communications data
End Group Job (ENDGRPJOB) 173 collecting 293
End Job (ENDJOB) 167 definition 292
End Performance Explorer (ENDPEX) 433 system 292
End Performance Monitor (ENDPFRMON) 293 trace 292
ENDGRPJOB (End Group Job) 173 communications device
ENDJOB (End Job) 167 allocation
ENDPEX (End Performance Explorer) 433 usage guidelines 115
ENDPFRMON (End Performance Monitor) 293 deallocation 108
HLDJOBSCDE (Hold Job Schedule Entry) 227 communications device allocation 108
Hold Job Schedule Entry (HLDJOBSCDE) 227 communications entry
Print Performance Explorer Report activity level 93
(PRTPEXRPT) 434 adding 98
PRTPEXRPT (Print Performance Explorer changing 99
Report) 434 removing 99
Release Job Schedule Entry (RLSJOBSCDE) 227 communications job
Remove Job Schedule Entry (RMVJOBSCDE) 227 illustration 214
Retrieve Group Attributes (RTVGRPA) 176 initiation 213
Retrieve Network Attributes (RTVNETA) 79 job description 213
Retrieve System Value (RTVSYSVAL) 16 routing data for 129, 213
RLSJOBSCDE (Release Job Schedule Entry) 227 security considerations 213
RMVJOBSCDE (Remove Job Schedule Entry) 227 communications mode allocation 108
RRTJOB (Reroute Job) 137 communications recovery limit (QCMNRCYLMT) system
RTVGRPA (Retrieve Group Attributes) 176 value 6, 30
RTVNETA (Retrieve Network Attributes) 79
comparison values and sequence numbers 101
RTVSYSVAL (Retrieve System Value) 16
completion message
SBMDBJOB (Submit Database Jobs) 106, 197
sending 200
SBMDKTJOB (Submit Diskette Jobs) 106, 197
tips for sending 200
SBMJOB (Submit Job) 106, 132, 197
configuration message queue (QCFGMSGQ) system
Set Attention Program (SETATNPGM) 180
value 11, 28

Index 519
Considerations for Using Multiple Subsystems 115 creating (continued)
console name (QCONSOLE) system value 6, 31 user-defined storage pools 110
control trace (QWTCTLTR) API 505 CRTBNDC (Create Bound C Program) command 429
controller file entry CRTCLS (Create Class) command 134
communications 383 CRTJOB (Create Job Description) command 132
multifunction 385 CRTJOBQ (Create Job Queue) command 117, 204
controlling CRTSBSD (Create Subsystem Description) command
group of workstations separately 115 creating new subsystem description 83
how many messages are logged 153 defining another 110
inactive job 169 example 119
information in job log 139 user defined storage pools 89
initial program load (IPL) 115 currency symbol (QCURSYM) system value 6, 33
initial workstation display 112 Customization, Keep 81
level of information in job log 153
routing step 161
controlling subsystem
D
daily job
as shipped by IBM 499
example of scheduling 230
configuration 502
damaged
creating 110
journal 284
creating another 110
data
description 109, 499
collection interval, Collection Services 299
restricted condition 109
collection interval, internal 297
controlling subsystem (QCTLSBSD) system value 6,
communications 292
33
performance 292
controls on levels of activity 93
trace 292
coordinated universal time offset (QUTCOFFSET)
data collection
system value 5, 75
interval 297
country identifier (QCNTRYID) system value 6, 31
performance monitor 298
CPC1236 message 231
Year 2000 294
CPC1238 message 231
data compression (DTACPR) network attribute 77
CPC1239 message 231
data file
CPC1242 message 231
QAPMAPPN 405
CPC1243 message 231
QAPMASYN 359
CPC1244 message 231
QAPMBSC 360
CPC1245 message 231
QAPMBUS 383
CPF1164 message 152, 283
QAPMCIOP 383
CPF1303 message 284
QAPMCONF 305
CPI1119 message 231
QAPMDBMON 307
CPI1120 message 231
QAPMDDI 373
CPI1141 message 231
QAPMDIOP 388
create authority (QCRTAUT) system value 12, 31
QAPMDISK 348
Create Bound C Program (CRTBNDC) command 429
QAPMECL 364
Create Class (CRTCLS) command 134
QAPMETH 368
Create Job Description (CRTJOBD) command 132 QAPMFRLY 376
Create Job Queue (CRTJOBQ) command 117, 204 QAPMHDLC 358
create job structure (QWTCTJBS) API QAPMHDWR 308
(QWTCTJBS) create job structure API 505 QAPMIDLC 381
create object audit (QCRTOBJAUD) system value 12, QAPMJOBL 330
32 QAPMJOBMI 338
Create Subsystem Description (CRTSBSD) command QAPMJOBOS 341
creating new subsystem description 83 QAPMJOBS 330
defining another 110 QAPMJSUM 345
example 119 QAPMLAPD 379
user defined storage pools 89 QAPMLIOP 391
creating QAPMMIOP 385
controlling subsystem 110 QAPMPOOL 353
group jobs 172 QAPMPOOLB 357
ILE C/400 module 429 QAPMPOOLL 353
job queue 117, 204 QAPMPOOLT 355
sample DLTLOG command and program 155 QAPMRESP 393
subsystem description 83, 89 QAPMRWS 393

520 OS/400 Work Management V4R4

data file (continued) data file (continued)
QAPMSAP 405 QAYPEUNKWN 405
QAPMSNA 394 QAYPEUSRDF 458
QAPMSNADS 404 database cross-reference (QBDSRVXR) system
QAPMSTND 374 job 237
QAPMSTNE 371 database cross-reference (QBDSRVXR2) system
QAPMSTNL 367 job 237
QAPMSTNY 377 database file
QAPMSYS 308 performance monitor 299
QAPMSYSCPU 327 QAVPETRCI (collected performance explorer
QAPMSYSTEM 327 data) 434
QAPMX25 362 database interval
QAYPEASM 447 performance data collection 298
QAYPEBASE 448 database job
QAYPECICFG 440 submitting 106
QAYPECOCFG 439 database parallelism (QQQTEMP1) system job 237
QAYPEDASD 449 database parallelism (QQQTEMP2) system job 237
QAYPEDSRV 450 database query data
QAYPEEVENT 443 definition 292
QAYPEFQCFG 440 database recovery (QDBRCVYWT) system value 6, 35
QAYPEHCFG 439 database server (QDBSRV01..N) system job 236
QAYPEHMON 458 date
QAYPEHTOT 459 ensuring log-version is up-to-date 148
QAYPEHWMAP 443 log-version 148
QAYPEJVA 460 date-and-time system values
QAYPEJVCI 461 overview 5
QAYPEJVMI 461 date constant
QAYPEJVNI 461 QDATE system value 34
QAYPELBRKT 457 date format (QDATFMT) system value 6, 34
QAYPELCPLX 441 date separator (QDATSEP) system value 6, 34
QAYPELICI 443 day (QDAY) system value 5, 35
QAYPELJOB 441 day (QDAYOFWEEK) system value 5, 35
QAYPELLIC 442 days password valid (QPWDEXPITV) system
QAYPELMET 441 value 12, 54
QAYPELMI 442 DBCS-installed (QIGC) system value 6, 40
QAYPELNAMT 442 DDM action (DDMACC) network attribute 77
QAYPELNUMT 442 DDMACC (DDM action) network attribute 77
QAYPEMBRKT 458 deallocation
QAYPEMICPX 443 communications device 109
QAYPEMII 444 of communications device 108
QAYPEMIPTR 458 decimal format (QDECFMT) system value 6, 36
QAYPEMIUSR 457 decompress system object system job
QAYPENLIC 446 (QDCPOBJ..N) 236
QAYPENMI 446 defining
QAYPEPGFLT 450 storage pools and activity levels 93
QAYPEPPANE 456 degree (QQRYDEGREE) system value 60
QAYPEPSUM 455 delete
QAYPEPWDW 456 log sample command and program 154
QAYPEREF 436 Delete Job Description (DLTJOBD) command 133
QAYPERLS 459 delete job structure (QWTDTJBS) API
QAYPERMPM 450 (QWTDTJBS) delete job structure API 505
QAYPERMSL 451 delete log (DLTLOG)
QAYPERUNI 437 example program 155
QAYPES36 451
Delete Subsystem Description (DLTSBSD)
QAYPESAR 451
command 85
QAYPESEGI 444
deleting
QAYPESTATS 452
job description 133
QAYPESTCFG 440
job log 145
QAYPETASKI 445
log-version 148
QAYPETIDX 447
subsystem description 85
QAYPETRCFG 441
description 6

Index 521
detailed message DMPTRC (Dump Trace) command 295
definition 139 double-byte coded font name (QIGCCDEFNT) system
device allocation, communications 108 value 6, 40
device/mode allocation, rules for 108 double-byte coded font point size (QIGCFNTSIZ)
device naming convention (QDEVNAMING) system system value 41
value 6, 36, 501 double-byte request data
device recovery action (QDEVRCYACN) system using 114
value 6, 37 double-byte versions of messages 118
DFTMODE (default mode) network attribute 77 DP and SP printer file accounting data 277
Disconnect Job (DSCJOB) command 167 DSCJOB (Disconnect Job) command 167
disconnect job interval (QDSCJOBITV) system DSPFFD (Display File Field Description)
value 6, 38 command 434
disconnecting DSPJOBD (Display Job Description) command 133
job 167 DSPJOBLOG (Display Job Log) command 144
diskette job DSPLOG (Display Log) command 148
submitting 106 DSPNETA (Display Network Attributes) command 78
display data 202 DSPOBJD (Display Object Description) command 147
display file DSPSBSD (Display Subsystem Description)
processing example 202 command 206
rules for special processing 202 DSPSYSVAL (Display System Value) command 14
SBMJOBSMPC example 201 DTACPR (data compression) network attribute 77
SBMJOBSMPD example 201 DTACPRINM (intermediate data compression) network
sign-on tips 86 attribute 77
source 86 dump flight recorder (QWTDMPFR) API 505
Display File Field Description (DSPFFD) dump lock recorder (QWTDMPLF) API 505
command 434 Dump Trace (DMPTRC) command 295
Display Job Description (DSPJOBD) command 133 dumping
Display Job Log (DSPJOBLOG) command 144 trace 295
display job tables dumping, trace data 295
job table entries 128 duplicate password (QPWDRQDDIF) system value 12,
Display Job Tables (DSPJOBTBL) command 58
DSPJOBTBL (Display Job Tables) 128 dynamic menu
Display Log (DSPLOG) command 148 approach 188
Display Network Attributes (DSPNETA) command 78 dynamic performance adjustments 239
Display Object Description (DSPOBJD) command 147 IPL (initial program load) 239
display station journaling 259
mixing double-byte and alphanumeric 118 storage pool paging 241
Display Subsystem Description (DSPSBSD) dynamic priority adjustment (QDYNPTYADJ) system
command 206 value 38
Display System Value (DSPSYSVAL) command 14 dynamic priority scheduler (QDYNPTYSCD) system
displaying value 10, 39
database file contents 434 dynamic storage pool paging 241
history (QHST) log 148
information about system jobs 238 E
job description 133 editing system values
job log 143 changes to 6
job log for interactive job 144 overview 6
log 148 Enable performance collection (ENBPFRCOL)
menu, coding example 184 parameter 429
network attribute 78 ENBPFRCOL (Enable performance collection)
object description 147 parameter 429
subsystem description 206 end group job
system value 14 coding example 192
DLTJOBD (Delete Job Description) command 133 End Group Job (ENDGRPJOB) command 173
DLTLOG (Delete Log) command End Job (ENDJOB) command 167
creating sample command and program 155 End Performance Explorer (ENDPEX) command 433
DLTLOGC CL program End Performance Monitor (ENDPFRMON)
changes to 155 command 293
source statements 155 ENDGRPJOB (End Group Job) command 173
DLTSBSD (Delete Subsystem Description) ending
command 85 batch job 124

522 OS/400 Work Management V4R4

ending (continued) functional space table
group job 124 machine pool 243
inactive interactive jobs 168 functions from workstation, long-running 170
job 126, 167
controlled 127 G
immediately 126 generic function
performance explorer 433 examples of how to use 97
performance monitor 293 generic workstation names and types 97
subsystem 84 graphic character set 29
ENDJOB (End Job) command 167 group attribute
ENDPEX (End Performance Explorer) command 433 changing 172
ENDPFRMON (End Performance Monitor) retrieving 176
command 293 group job
entry allowing to communicate 174
job accounting 281 approach for programmers 190
job schedule 225 Attention-key-handling menu, fixed 184
work Attention-key-handling programs 182
autostart job 211 benefits 171
job queue 98 calling 174
prestart job 99 changing to and from 172
workstation 96 concepts 171, 172
error creating new 172
job starting and routing 129 description 171
estimating communications space 243 ending 173, 184
estimating file size example approach to 177
performance data collection 299 handling 184
every weekday job initiation 172
example of scheduling 231 main storage 183
exit program performance tip 183
auxiliary-storage lower-limit 507 relationship to secondary interactive job 174
job notification 507 returning to group job main program 193
power down system 507 sample application 176
preattention program 507 starting 184
Presystem Request Program 175 starting from workstation 171
presystem request program 507 system request function 175
TRCJOB (Trace Job) 507 theory 174
work management 505 transferring control from one to another 172
expert cache 240 transferring from one to another 172
extender transferring to another group job 173
task type 423 when to use the attention key 181
guidelines
performance tuning 239
F
field data
performance data file 305 H
fields receiving handling inactive jobs 169
display data 202 history (QHST) log 147
FIFO (first-in, first-out) priority queue definition 138, 147
definition 264 displaying or printing 148
file processing format 149
rules for special display file 202 message queue 147
filtering messages 139 messages, contrasted with job accounting 272
finding processing records 148
performance explorer definitions 434 processing the file 150
first-in, first-out priority queue history (QHST) log file
definition 264 processing, coding example 152
fixed menu 184 history (QHST) log versions
force conversion on restore (QFRCCVNRST) system logging in history log 147
value 6, 39 history log size (QHSTLOGSIZ) system value 11, 40
format HLDJOBSCDE (Hold Job Schedule Entry)
history (QHST) log 149 command 227

Index 523
Hold Job Schedule Entry (HLDJOBSCDE) interactive job 121 (continued)
command 227 definition 161, 157
holding disconnecting 167
job log 145 ending 167
job schedule entry 227 ending automatically 168
hour (QHOUR) system value 5, 40 how it starts 158
how they transfer 137
I illustration 161
initiating 157
I/O (input/output) error
job description, USER parameter 133
job’s requester device 167
job log 146
IBM-supplied job descriptions
job logs and messages 146
keep customized information 496
multiple pools for 256
IBM-supplied object
overview of starting 158
contents 463
rerouting 137
IDLC (ISDN data link control) file entry 381
routing 159
ILE C/400 module
secondary, relationship to a group job 174
creating 429
signing off 167
inactive 169
starting and routing illustrations 206
workstation 169
direct routing to user program based on
inactive job
user 164
benefits of controlling 169
routing based on communications program start
handling 169
request 206
inactive job time-out (QINACTITV) system value 12,
routing to QCL based on workstation 161
41
transferring 137
inactive message queue (QINACTMSGQ) system
user-based routing 164
value 12, 42
using initial programs 166
inactive workstation
when it is rerouted 137
definition 169
workstation-based routing 164
ineligible job queue 263
interactive processing
ineligible thread
job accounting 279
definition 262
interactive storage pool (*INTERACT) 87
initial
intermediate data compression (DTACPRINM) network
thread 121
attribute 77
initial machine pool size
internal interval
determining 242
performance data collection 298
initial menu
internal performance data interval 297
using 113
interval
initial program
performance data collection 297
not routing to QCMD 166
IPL (initial program load)
QOPRMENU for QSYSOPR 499
controlling 115
routing to QCMD 166
performance adjustment 240
uses of 166
IPL console (QSCPFCONS) system value 6, 63
using 112
IPL recovery program
initial program load (IPL)
calling 116
controlling 115
example 116
performance adjustment 240
IPL start-up program
initial program uses 166
changing 116
initial spooling size (QJOBSPLA) system value 10, 45
IPL status (QIPLSTS) system value 6, 43
initial workstation display
IPL type (QIPLTYPE) system value 6, 44, 501
controlling 112
ISDN data link control (IDLC) file entry 381
initiating
an interactive job 157
input spooling J
definition 197 job
interactive job 167 allowing more to run in batch 112
approaches 161 attribute 130
automatically ending 168 autostart 211
avoid a long-running function 170 batch 124
benefits of calling programs directly 166 batch, definition 121
benefits of using QSYS/CMD 165 benefits of controlling inactive 169
CL command logged 146 change logging level 153

524 OS/400 Work Management V4R4

job (continued) job accounting 285 (continued)
change number on job queue, example 112 converting job accounting journal entries 283
change number running from job queue 205 CPF1164 comparison 272
changing 206 creating journal receiver 279
changing number allowed in subsystem 111 damaged journal 284
changing output queue 145 DP and SP printer file data 277
class object 134 DP journal information 277
command 124 DSPJRN command 285
communications job 213 entry 281
controlling job attributes 131 interactive processing 279
data used by 264 JB accounting journal information 275
definition 121 job description 273
description object 132 job priority 272
determining status of 125 overview 271
disconnecting 167 prestart jobs 221
ending 126, 167 QACGLVL value, changing 284
controlled 127 QHST messages, comparison 272
immediately 126 recovery 283
ending same time as another job 168 security 282
finding 125 segments 274
finding on job queue 205 setting up 279
get on job queue 204 SP journal information 277
group 171 steps to start 279
how batch jobs transfer 138 system job processing 279
how taken from multiple job queues 199 job action (JOBACN) network attribute 77
interactive 157 job attribute
interactive, definition 121 benefits of controlling 131
interactive job, automatically ending 168 changing 124
job log 138 controlling batch 131
looking on job queue 205 definition 130
moving to different job queue 107 how subsystem controls 131
name 122 job command 124
overview of starting 158 job data
placing on a job queue 198 merging areas 432
placing on job queue 106 separating areas 432
prestart 217 job description
priority 124 autostart job 211
queue for spooling 198 changing 132, 133
relationship to class and subsystem description 136 communications job 213
rerouting 137 contents 132
routing 128, 129, 130 contents of IBM-supplied 466
run-time attribute 134 creating 132
scheduled 223 definition 132
starting 128 deleting 133
state 261 displaying 133
states 261 security 133
submitting 106 USER parameter 133
time slice 124 ways to use 132
transferring 129, 137 working with 133
type, definition 151 job description object 132
user identity 123 job illustration
job accounting 221 autostart 212
abnormal end 283 batch 206
abnormal end of job 283 job initiation
accounting code, length 273 under workstation user profile 157
accounting journal 281 job log
ACGCDE parameter 273 changing logging level 153
analyzing data 281 consideration for batch 147
authority to assign code 282 controlling information 139
batch processing 278 controlling level of information contained 153
change system value QACGLVL 279 deleting 145

Index 525
job log (continued) job queue 199 (continued)
deleting log file 153 subsystem handles jobs on several 107
display characteristics 144 job queue entry
displaying 143 activity level 93
displaying for interactive job 144 adding 98
example 143 changing 98
heading 142 contents 98
holding 145 definition 98
interactive jobs 146 entry 98, 199
logging messages 138 removing 98
not produced, message CPF1164 152 job rerouting
printing 147 benefits 137
tips 145 job schedule 223
job message queue full (QJOBMSGQFL) system job schedule (QJOBSCD) system job 236
value 10, 44 job schedule entry
job message queue maximum (QJOBMSGQMX) system adding 226
value 10, 44 authority to change 226
job message queue size (QJOBMSGQSZ) system authority to hold, remove, or release 227
value 10, 45 authority to work with 227
job message queue total (QJOBMSGQTL) system benefits of using to schedule jobs 224
value 10, 45 changing 226
job name definition 225
definition 122 holding 227
syntax 122 message ID numbers 232
job number messages 231
definition 122 messages, examples of using 232
job output releasing 227
viewing 126 removing 227
job priority saving, example 231
tips 135 tips 229
job queue 107 working with 227
adding a second 107 job schedule object
allocated to subsystem 199 damaged 228
allocating 105, 205 damaged job schedule object 228
allocating example 205 definition 228
associated with a subsystem 206 non-Gregorian calendars 229
batch 198 saving and restoring 228
change number of jobs running 205 tips on restoring 229
changing the number of jobs, example 205 job scheduling
changing the number of jobs running 205 advantages 223
cleared with scheduled job 225 benefits 223
content of IBM-supplied 472 benefits of 224
creating 117, 204 daily example 230
definition 198 every weekday example 231
determining which are allocated to a introduction 223
subsystem 206 monthly example 230
determining which subsystem 206 on particular days example 230
determining which subsystem has a job queue QDATE and QTIME changes 233
allocated 206 system availability 224
finding job 205 weekly example 230
get jobs on 204 job space 243
how jobs are taken from multiple 199 job starting and routing
identified to batch subsystem 105 description 128
identified to spooling subsystem 198 error 129
ineligible 263 interactive job illustrations 161
looking at 205 rerouting job 137
looking at job in 205 summary of activity level controls 93
moving job from one to another 206 transferring jobs 137
placing job on 106 job state
relationship with subsystem 106 active 261
specifying the order 199 ineligible 261

526 OS/400 Work Management V4R4

job state (continued) lock
wait 261 conflict 264
job table entries log
no available entries considerations for batch job 147
too many entries 128 displaying system 147
job tables files, deleting 154
tracking jobs 128 history 147
job type job 138
definition 151 messages 138
job user identity QHST (history) 147
definition 123 log file
JOBACN (job action) network attribute 77 deleting 154
JOBD, SBSD log sample command and program
restoring customized information 81, 496 delete 154
journal log-version
damaged 284 definition 147
DP accounting information 277 deleting 148
restrictions 280 determining available 148
SP accounting information 277 ensuring is current 148
journal entry 269 time and date 148
journal receiver LOGCLPGM attribute
restrictions 280 setting and changing 147
logging level
changing 153
K logical unit services (QLUS) system job 236
Keep Customization 81 long-running command
keep customized information example of submitting 170
IBM-supplied job descriptions 496 long-running functions from workstation
subsystem descriptions 496 avoiding 170
key/think wait long wait
definition 262 definition 262
keyboard buffer (QKBDBUF) system value 6, 45 key/think 262
keyboard type (QKBDTYPE) system value 6, 46 long wait definition 262
long wait extended
L thread 262
language identifier (QLANGID) system value 6, 46
LCLCPNAME (local control point) network attribute 77
LCLLOCNAME (local location) network attribute 77
M
LCLNETID (local network ID) network attribute 77 machine pool
leap year adjust (QLEAPADJ) system value 5, 46 Communications space 243
library list system value definition 87
overview 10 functional space in 243
limit adjacent digits (QPWDLMTAJC) system value 12, job space in 243
55 program in base pool 87
limit characters (QPWDLMTCHR) system value 12, 55 setting initial size 242
limit device session (QLMTDEVSSN) system value 12, machine pool (*MACHINE) 87
46 machine pool (QMCHPOOL) system value 11, 49
limit repeat characters (QPWDLMTREP) system machine running priority
value 12, 56 description 134
limit security officer (QLMTSECOFR) system value 12, main storage
47 definition 241
list active subsystems (QWCLASBS) API 505 main storage requirements
list job (QUSLJOB) API 505 group job 183
list job schedule entries (QWCLSCDE) API 505 Major return codes 127
List Object Locks (QWCLOBJL) API 505 manual system tuning
list subsystem entries (QWDLSBSE) API 505 definition 242
list subsystem job queues (QWDLSJBQ) API 505 MAXACT(1) example, batch subsystem 95
local control point (LCLCPNAME) network attribute 77 MAXHOP (maximum systems) network attribute 77
local location (LCLLOCNAME) network attribute 77 maximum activity level
local network ID (LCLNETID) network attribute 77 for a storage pool
locale path name (QLOCALE) system value 6, 47 threads in a storage pool 93

Index 527
maximum activity level (QMAXACTLVL) system minimum problem retention (QPRBHLDITV) system
value 11, 47 value 11, 53
maximum characters (QPWDMAXLEN) system Minor return codes 127
value 12, 56 minute (QMINUTE) system value 5, 50
maximum intermediate sessions (MAXINTSSN) network mode allocation 108
attribute 77 month (QMONTH) system value 5, 51
maximum not valid sign-on (QMAXSIGN) system monthly job
value 12, 48 example of scheduling 230
maximum sign-on action (QMAXSGNACN) system move job (QSPMOVJB) API 505
value 12, 48 moving
maximum systems (MAXHOP) network attribute 77 jobs to different job queues 107
MAXINTSSN (maximum intermediate sessions) network moving date or time backward
attribute 77 effects on job scheduling 234
MDMCNTRYID (modem country identifier) network moving date or time forward
attribute 77 effects on job scheduling 234
menu moving jobs to a different one 107
attention-key-handling 184 MRGJOB (Merge job data) parameter 432
dynamic 188 MSGQ (message queue) network attribute 77
fixed 184 multifunction controller file entry 385
program call 157 multiple pools
Merge job data (MRGJOB) parameter 432 benefits of having 88
merging Multiple Subsystems, Considerations for Using 115
job data 432 multiple thread action (QMLTTHACN) system value 6
message multithreaded action (QMLTTHDACN) system value 50
accessing data when message begins in variable
position 151
CPF1164 283
N
NETSERVER (network node servers) network
displaying 125
attribute 77
filtering 139
network attribute
system log message queue 147
alert backup focal point (ALRBCKFP) 77
message-and-logging size system values 16, 44
alert controller (ALRCTLD) 77
message-and-logging system values alert default focal point (ALRDFTFP) 77
overview 11 alert filter (ALRFTR) 77
message filtering alert primary focal point (ALRPRIFP) 77
definition 139 alert request focal point (ALRRQSFP) 77
scenario 139 alert status (ALRSTS) 77
message queue alerts accumulated (ALRHLDCNT) 77
default for object distribution 77 ALRBCKFP (alert backup focal point) 77
messages 231 ALRCTLD (alert controller) 77
CPC1236 231 ALRDFTFP (alert default focal point) 77
CPC1238 231 ALRFTR (alert filter) 77
CPC1239 231 ALRHLDCNT (alerts accumulated) 77
CPC1242 231 ALRLOGSTS (logged alerts) 77
CPC1243 231 ALRPRIFP (alert primary focal point) 77
CPC1244 231 ALRRQSFP (alert request focal point) 77
CPC1245 231 ALRSTS (alert status) 77
CPF1303 284 ALWADDCLU (allow add to cluster) 77
CPI1119 231 APPN network node servers (NETSERVER) 77
CPI1120 231 APPN node type (NODETYPE) 77
CPI1141 231 APPN route addition resistance (RAR) 77
job failed to be submitted from job schedule changing 77, 78
entry 231 data compression (DTACPR) 77
job is removed from job schedule entry 231 DDM action (DDMACC) 77
job logs for interactive jobs 146 DDMACC (DDM action) 77
job schedule entry 231 default location (LCLLOCNAME) 77
job schedule entry, examples of using 232 default mode (DFTMODE) 77
job schedule entry is added 231 description 77
job successfully submitted from job schedule DFTMODE (default mode) 77
entry 231 displaying 78
minimum characters (QPWDMINLEN) system intermediate data compression (DTACPRINM) 77
value 12, 56 job action (JOBACN) 77

528 OS/400 Work Management V4R4

network attribute (continued) output spooling
JOBACN (job action) 77 definition 197
LCLCPNAME (local control point) 77 OUTQ (output queue) network attribute 77
LCLLOCNAME (default location) 77
LCLNETID (local network ID) 77
local control point (LCLCPNAME) 77
P
PAG (process access group)
local network ID (LCLNETID) 77
definition 264
logged alerts (ALRLOGSTS) 77
purge parameter 265
MAXHOP (maximum systems) 77
paging, storage pool 240, 241
maximum intermediate sessions (MAXINTSSN) 77
parameter
maximum systems (MAXHOP) 77
performance tuning 265
MAXINTSSN (maximum intermediate sessions) 77
purge 265
MDMCNTRYID (modem country identifier) 77
pass-through servers (QPASTHRSVR) system
message queue (MSGQ) 77
value 51
MSGQ (message queue) 77
password validation program (QPWDVLDPGM) system
NETSERVER (APPN network node servers) 77
value 12, 58
NODETYPE (APPN node type) 77
PC Support requests (PCSACC) network attribute 77
output queue (OUTQ) 77
PCSACC (PC Support requests) network attribute 77
OUTQ (output queue) 77
performance
PC Support requests (PCSACC) 77
activity level 263
PCSACC (PC Support requests) 77
adjusting
RAR (APPN route addition resistance) 77
activity level 245
retrieving 79
pool size 245
shipped values 77
adjustment
SYSNAME (system name) 77
initial program load (IPL) 240
network node servers (NETSERVER) network
authority checking 254
attribute 77
automatic system tuning 239
nighttime jobs
basic tuning 242
subsystem description 117
dynamic performance adjustments 239
NODETYPE (APPN node type) network attribute 77
group job 183
notification messages
guidelines 239
QUSRJOBI 126
history log 150
numbering of pools 90
information, QHST file 150
IPL performance adjustments 240
O machine pool size, setting 242
object monitor 292
job description 132 overview 261
job schedule 228 performance adjustment at IPL 239
setting access 257 pool configuration, choosing 244
used by jobs 264 time slice 265
object authority tuning 239
prestart job 220 specialized 253
object name performance adjustment (QPFRADJ) system job 236
specified for system values 15 performance adjustment (QPFRADJ) system value 6,
open list of activation attributes (QWVOLACT) 51
(QWVOLACT) open list of activation attributes 506 performance collection
open list of activation group attributes (QWVOLAGP) ENBPFRCOL (Enable performance collection) 429
API pre-defined collection points 429
(QSVOLAGP) open list of activation attributes performance data
API 506 collecting 289
open list of jobs (QGYOLJOB) API Collection Services 289
(QGYOLJOB) open list of jobs API 506 communications 292
ordering routing entries in a subsystem description 102 file, content of 302, 434
output how collected 293
viewing job 126 introduction 289
output queue preparing to collect 292
changing for all jobs 145 QAPMAPPN file 405
default for object distribution 77 QAPMASYN file 359
getting job logs into one 153 QAPMBSC file 360
specifying for job log 145 QAPMBUS file 383
output queue (OUTQ) network attribute 77 QAPMCIOP file 383

Index 529
performance data (continued) performance data (continued)
QAPMCONF file 289 QAYPELNUMT file 289
QAPMDBMON file 307 QAYPEMBRKT file 458
QAPMDDI file 373 QAYPEMICPX file 443
QAPMDIOP file 388 QAYPEMII file 444
QAPMDISK file 348 QAYPEMIPTR file 458
QAPMECL file 364 QAYPEMIUSR file 457
QAPMETH file 368 QAYPENLIC file 446
QAPMFRLY file 376 QAYPENMI file 446
QAPMHDLC file 358 QAYPEPGFLT file 450
QAPMHDWR file 308 QAYPEPPANE file 456
QAPMIDLC file 381 QAYPEPSUM file 455
QAPMJOBL file 330 QAYPEPWDW file 456
QAPMJOBMI file 338 QAYPEREF file 436
QAPMJOBOS file 341 QAYPERLS file 459
QAPMJOBS file 330 QAYPERMPM file 450
QAPMJSUM file 345 QAYPERMSL file 451
QAPMLAPD 379 QAYPERUNI file 437
QAPMLIOP file 391 QAYPES36 file 451
QAPMMIOP file 385 QAYPESAR file 451
QAPMPOOL file 353 QAYPESEGI file 444
QAPMPOOLB file 357 QAYPESTATS file 452
QAPMPOOLL file 353 QAYPESTCFG file 440
QAPMPOOLT file 355 QAYPETASKI file 445
QAPMRESP file 393 QAYPETIDX file 447
QAPMRWS file 393 QAYPETRCFG file 441
QAPMSAP file 378 QAYPEUNKWN file 452
QAPMSNA file 394 QAYPEUSRDF file 458
QAPMSNADS file 404 reasons to collect 289
QAPMSTND file 374 system 292
QAPMSTNE file 371 trace 292
QAPMSTNL file 367 performance data collection
QAPMSTNY file 377 automatic 296
QAPMSYS file 308 performance data file
QAPMSYSCPU file 327 field data 305
QAPMSYSTEM file 327 overview 302, 434
QAPMX25 file 362 performance explorer
QAYPEASM file 447 adding
QAYPEBASE file 448 definition 432
QAYPECICFG file 440 database file
QAYPECOCFG file 439 QAVPETRCI 434
QAYPEDASD file 449 definition
QAYPEDSRV file 450 finding 434
QAYPEEVENT file 443 ending 433
QAYPEFQCFG file 440 finding
QAYPEHMON file 458 definition 434
QAYPEHTOT file 459 reports
QAYPEHWCFG file 439 printing 434
QAYPEHWMAP file 443 starting 433
QAYPEJVA file 460 performance monitor
QAYPEJVCI file 461 database file 299
QAYPEJVMI file 461 during data collection 298
QAYPEJVNI file 461 ending 293
QAYPELBRKT file 457 ends 297
QAYPELCPLX file 441 starting 292
QAYPELICI file 443 status notification 298
QAYPELJOB file 441 what does it do? 297
QAYPELLIC file 442
performance reviewing 246
QAYPELMET file 441
performance tip
QAYPELMI file 442
prestart jobs 220
QAYPELNAMT file 442
Performance Tools licensed program 289

530 OS/400 Work Management V4R4

performance tuning prestart job entry (continued)
concepts 261 removing 100
definition 239 Presystem Request Program
time slice parameter 265 exit program 175
placing preventing
job on job queue 204 job log 154
jobs on a job queue 106 request end or sign off 114
system values in CL variables 16 print key format (QPRTKEYFMT) system value 6, 54
pool Print Performance Explorer Report (PRTPEXRPT)
allocation 90 command 434
benefits 88 print text (QPRTTXT) system value 11, 54
changing machine size 88 printer device (QPRTDEV) system value 6, 53
clearing 257
printer file
machine 242
DP and SP accounting data 277
minimum size 259
printer file accounting 270
multiple 257
printing
numbers assigned to 90
private 87 history (QHST) log 148
QTSEPOOL system value 71 job log 147
shared 87 list of scheduled jobs 223
shared storage 87 performance explorer report 434
size 244 priority
size, adjusting 245 changing 124, 135
storage 87 job 124
storage, size 88 priority
pool size changing 124
adjustment 242 running 124
pools priority queue
benefits of multiple 88 first-in, first-out 264
position characters (QPWDPOSDIF) system value 12, private storage pool
57 definition 87
power down limit (QPWRDWNLMT) system value 6, problem filter (QPRBFTR) system value 11, 52
59 process access group (PAG)
power restore IPL (QPWRRSTIPL) system value 6, 59 definition 264
powering off system purge parameter 265
in unattended environment 117 processing
pre-defined collection points 429 accounting journal 281
prestart job 221 history log records 148
attributes 221 QHST (history log) file 150
benefits 217 processing time of jobs
description 217 tips 135
ending 222 processor feature (QPRCFEAT) system value 6, 53
entry 99 processor multi-tasking (QPRCMLTTSK) system
changing 100 value 6, 53
removing 100 program
excessive 219 changing 429
how it starts 217 program a display menu
initiation 217 coding example 184
name 221 program start request
number of 218 information 129
object authorization 220 queuing 219
performance tip 220
program start request received 219
program start request 219
program to control routing step 165
queuing program start request 219
security consideration 220 programming example
size control pool 219 submitting job from display file 201
starting 218 PRTPEXRPT (Print Performance Explorer Report)
user profile 220 command 434
prestart job entry PURGE parameter 254
adding 100 putting
changing 100 job on job queue 106, 204

Index 531
Q QAUTOCFG (automatic configuration indicator) system
value (continued)
QABNORMSW (system control) system value 6, 16
example 6
QACGLVL (accounting level) system value 11, 16
QAUTORMT (automatic configuration remote controller)
QACTJOB (active jobs) system value 10, 17
system value 6, 25
QADLACTJ (additional active jobs) system value 10,
QAUTOSPRPT (automatic system disabled) system
18
value
QADLSPLA (additional storage) system value 10, 18
description 6, 25
QADLTOTJ (additional total jobs) system value 10, 18
QAUTOVRT (automatic configuration device) system
QALERT (alert manager) system job 237
value 6, 26
QALWOBJRST (allow object restore) system value 12,
QAVPETRCI database file 434
18
QBASACTLVL (base activity level) system value 11,
QALWUSRDMN (allow user domain) system value 12,
26
19
QBASE subsystem
QAPMAPPN data file 405
as shipped by IBM 499
QAPMASYN data file 359
configuration 502
QAPMBSC data file 360
description 499
QAPMBUS data file 383
QBASPOOL (base pool) system value 11, 27
QAPMCIOP data file 383
QBATCH subsystem
QAPMCONF
shipped configuration 502
Year 2000 294
use of shipped objects for batch jobs 105
QAPMCONF data file 305
QBOOKPATH (book path search) system value 6, 27
QAPMDBMON data file 307
QCCSID (coded character set identifier) system
QAPMDDI data file 373
value 6, 27
QAPMDIOP data file 388
QCENTURY (century) system value 5, 28
QAPMDISK data file 348
QCFGMSGQ (configuration message queue) system
QAPMECL data file 364
value 11, 28
QAPMETH data file 368
QCHRID (character set and code page) system
QAPMFRLY data file 376
value 6, 29
QAPMHDLC data file 358
QCHRIDCTL (character identifier control) system
QAPMHDWR data file 308
value 6, 29
QAPMIDLC data file 381
QCMD (command entry)
QAPMJOBL data file 330
description 499
QAPMJOBMI data file 338
routing to, based on workstation 161
QAPMJOBOS data file 341
using to control routing step for batch job 207
QAPMJOBS data file 330
QCMN subsystem 502
QAPMJSUM data file 345
QCMNARB (communications arbiters) system value 30
QAPMLAPD data file 379
QCMNRCYLMT (communications recovery limit) system
QAPMLIOP data file 391
value 6, 30
QAPMMIOP data file 385
QCNTRYID (country identifier) system value 6, 31
QAPMPOOL data file 353
QCONSOLE (console name) system value 6, 31
QAPMPOOLB data file 357
QCRTAUT (create authority) system value 12, 31
QAPMPOOLL data file 353
QCRTOBJAUD (create object audit) system value 12,
QAPMPOOLT data file 355
32
QAPMRESP data file 393
QCTL subsystem 502
QAPMRWS data file 393
QCTLSBSD (controlling subsystem) system value
QAPMSAP data file 378
description 33, 501
QAPMSNA data file 394
QCURSYM (currency symbol) system value 6, 33
QAPMSNADS data file 404
QDATE
QAPMSTND data file 374
QAPMSTNY data file 377 changes affecting job scheduling 233
QASTLVL (assistance level) system value 6, 20 QDATE (system date) system value 5, 34
QATNPGM (attention program) system value 6, 20 QDATFMT (date format) system value 6, 34
QAUDCTL (auditing control) system value 12, 20 QDATSEP (date separator) system value 6, 34
QAUDENDACN (auditing end action) system value 12, QDAY (day) system value 5, 35
21 QDAYOFWEEK (day) system value 5, 35
QAUDFRCLVL (auditing force level) system value 12, QDBRCVYWT (database recovery) system value 6, 35
22 QDBSRV01..N (database server) system job 236
QAUDLVL (auditing level) system value 12, 22 QDBSRVXR (database cross-reference) system
QAUTOCFG (automatic configuration indicator) system job 237
value QDBSRVXR2 (database cross-reference) system
description 6, 24 job 237

532 OS/400 Work Management V4R4

QDCPOBJ..N (decompress system object) system QLEAPADJ (leap year adjust) system value 5, 46
job 236 QLMTDEVSSN (limit device session) system value 12,
QDECFMT (decimal format) system value 6, 36 46
QDEVNAMING (device naming convention) system QLMTSECOFR (limit security officer) system value 12,
value 6, 36, 501 47
QDEVRCYACN (device recovery action) system QLOCALE (locale path name) system value 6, 47
value 6, 37 QLUS (logical unit services) system job 108, 236
QDSCJOBITV (disconnect job interval) system QMAXACTLVL (maximum activity level) system
value 6, 38 value 47
QDSPSGNINF (sign-on information) system value 12, QMAXSGNACN (maximum sign-on action) system
38 value 12, 48
QDYNPTYADJ (dynamic priority adjustment) system QMAXSIGN (maximum not valid sign-on) system
value 38 value 12, 48
QDYNPTYSCD (dynamic priority scheduler) system QMCHPOOL (machine pool) system value 11, 49
value 10, 39 QMINUTE (minute) system value 5, 50
QECS job QMLTTHACN (multiple thread action) system value 6
example of job running in QSYSWRK QMLTTHDACN (multithreaded action) system value 50
subsystem 500 QMODEL (system model) system value 6, 50
QFRCCVNRST (force conversion on restore) system QMONTH (month) system value 5, 51
value 6, 39 QPASTHRSVR (pass-through servers)
QHOUR (hour) system value 5, 40 pass-through servers (QPASTHRSVR) 51
QHST (history) log 147 QPASTHRSVR (QPASTHRSVR) system value 51
definition 138 QPFRADJ (performance adjustment) system job 236
file processing scenario 152 QPFRADJ (performance adjustment) system value 6,
format 149 51
message queue 147 QPFRCOL batch job 296
messages, contrasted with job accounting 272 QPRBFTR (problem filter) system value 11, 52
performance information 150 QPRBHLDITV (minimum problem retention) system
processing for job completion message 152 value 11, 53
processing the file 150 QPRCFEAT (processor feature) system value 6, 53
QHSTLOGSIZ (history log size) system value 11, 40 QPRCMLTTSK (processor multi-tasking) system
QIGC (DBCS-installed) system value 6, 40 value 6, 53
QIGCCDEFNT (double-byte coded font name) system QPRTDEV (printer device) system value 6, 53
value 6, 40 QPRTKEYFMT (print key format) system value 6, 54
QIGCFNTSIZ (double-byte coded font point size) QPRTTXT (print text) system value 11, 54
system value 41 QPWDEXPITV (days password valid) system
QINACTITV (inactive job time-out) system value 12, value 12, 54
41 QPWDLMTAJC (limit adjacent digits) system value 12,
QINACTMSGQ (inactive message queue) system 55
value 12, 42 QPWDLMTCHR (limit characters) system value 12, 55
QINTER subsystem QPWDLMTREP (limit repeat characters) system
prevent sign-on prompt from being displayed 115 value 12, 56
security officer sign-on 158 QPWDMAXLEN (maximum characters) system
shipped configuration 502 value 12, 56
QIPLDATTIM (automatic IPL date and time) system QPWDMINLEN (minimum characters) system
value 6, 43 value 12, 56
QIPLSTS (IPL status) system value 6, 43 QPWDPOSDIF (position characters) system value 12,
QIPLTYPE (IPL type) system value 6, 44, 501 57
QJOBMSGQFL (job message queue full) system QPWDRQDDGT (required password digits) system
value 10, 44 value 12, 57
QJOBMSGQMX (job message queue maximum) system QPWDRQDDIF (duplicate password) system value 12,
value 10, 44 58
QJOBMSGQSZ (job message queue size) system QPWDVLDPGM (password validation program) system
value 10, 45 value 12, 58
QJOBMSGQTL (job message queue total) system QPWRDWNLMT (power down limit) system value 6,
value 10, 45 59
QJOBSCD (job schedule) system job 236 QPWRRSTIPL (power restore IPL) system value 6, 59
QJOBSPLA (initial spooling size) system value 10, 45 QQQTEMP1 (database parallelism) system job 237
QKBDBUF (keyboard buffer) system value 6, 45 QQQTEMP2 (database parallelism) system job 237
QKBDTYPE (keyboard type) system value 6, 46 QQRYDEGREE (degree) system value 60
QLANGID (language identifier) system value 6, 46 QQRYDEGREE (query degree) system value 6

Index 533
QQRYTIMLMT (query time limit) system value 6, 60 query time limit (QQRYTIMLMT) system value 6, 60
QRCLSPLSTG (reclaim spool storage) system queue
value 10, 61 ineligible 263
QRETSVRSEC (retain server security) system spooling support 197
value 12, 61 queuing
QRMTIPL (remote IPL) system value 6, 61 program start requests 219
QRMTSIGN (remote sign-on) system value 12, 62 QUPSDLYTIM (uninterruptible power supply (UPS)
QRMTSRVATR (remote service attribute) system delay time) system value 6, 71
value 6, 62 QUPSMSGQ (uninterruptible power supply (UPS)
QSCPFCONS (IPL console) system value 6, 63 message queue) system value 6, 73
QSECOND (second) system value 5, 63 QUSCHGPA (change pool attributes) API 505
QSECURITY (security level) system value 12, 63, 501 QUSEADPAUT (use adopted authority) system
QSERVER (file server) subsystem value 12, 74
shipped configuration 502 QUSLJOB (list job) API 505
QSETJOBATR (set job attribute) system value 6, 64 QUSRJOBI (retrieve job information) API 506
QSFWERRLOG (software error log) system value 11, QUSRLIBL (user library list) system value 10, 75
64 QUSRWRK (user) subsystem 473
QSNADS subsystem 502 shipped configuration 502
QSPCENV (special environment) system value 6, 65, QUTCOFFSET (coordinated universal time offset)
501 system value 5, 75
QSPL (spool) subsystem 502 QWCBTCLNUP (work control block table cleanup)
pool size 244 system job 236
shipped configuration 502 QWCCCJOB (change current job) API 505
use of shipped objects for spooling jobs 198 QWCCHGTN (change pool tuning) API 505
QSPLMAINT (system spool) system job 237 QWCLASBS (list active subsystems) API 505
QSPMOVJB (move job) API 505 QWCLOBJL (List Object Locks) API 505
QSPRJOBQ (retrieve job queue information) API 506 QWCLSCDE (list job schedule entries) API 505
QSRLNBR (serial number) system value 6, 65 QWCRDTAA (retrieve data area) API 506
QSRTSEQ (sort sequence) system value 6, 65 QWCRJBST (Retrieve Job Status) API 506
QSRVDMP (service dump) system value 11, 68 QWCRNETA (retrieve network attributes) API 506
QSTGLOWACN(auxiliary storage lower limit action) QWCRSSTS (retrieve system status) API 506
system value 66 QWCRSVAL (retrieve system value) API 506
QSTGLOWLMT(auxiliary storage lower limit ) system QWDCSBSE (change subsystem entry) API 505
value 66 QWDLSBSE (list sybsystem entries) API 505
QSTRPRTWTR (start printer writer) system value 6, QWDLSJBQ (list subsystem job queues) API 505
67 QWDRJOBD (retrieve job description information)
QSTRUP start-up program 116 API 506
QSTRUPPGM (start-up program name) system QWDRSBSD (retrieve subsystem information) API 506
value 6, 67 QWTCTLTR (control trace) API 505
QSTSMSG (status messages) system value 11, 68 QWTDMPFR (dump flight recorder) API 505
QSVRAUTITV (server authentication interval) system QWTDMPLF (dump lock recorder) API 505
value 6, 68 QWTRTVPX (Retrieve Profile Exit Programs) API 506
QSYS/CMD QWTSETLF (set lock flight recorder) API 507
benefits for interactive jobs 165 QWTSETP (Set Profile) API 507
QSYSARB (system arbiter) system job 103, 235 QWTSETPX (Set Profile Exit Programs) API 507
QSYSCOMM1 (communications) system job 238 QWTSETTR (set trace) API 507
QSYSLIBL (system library list) system value 10, 68 QWTSJUID (set job user identity) API 506
QSYSWRK (system) subsystem QYEAR (year) system value 5, 76
shipped configuration 502
QSYSWRK (system work) subsystem R
description 500 RAR (APPN route addition) network attribute 77
QECS job, example of job running 500 reader 197
QTIME (time) system value compared to SBMXXXJOB command 200
changes affecting job scheduling 233 reason code
time of day system value 5, 69 CPF1164 152
QTIMSEP (time separator) system value 6, 70 reclaim spool storage (QRCLSPLSTG) system
QTOTJOB (total jobs) system value 10, 70 value 10, 61
QTSEPOOL (time slice end pool) system value 11, 71 record lock
qualified job name checking 173
definition 122 recovery program
query degree (QQRYDEGREE) system value 6 calling for IPL 116

534 OS/400 Work Management V4R4

Release Job Schedule Entry (RLSJOBSCDE) Retrieve Job Status (QWCRJBST) API 506
command 227 retrieve network attributes (QWCRNETA) API 506
releasing Retrieve Network Attributes (RTVNETA) command 79
job schedule entry 227 Retrieve Profile Exit Programs (QWTRTVPX) API 506
remote IPL (QRMTIPL) system value 6, 61 retrieve subsystem information (QWDRSBSD) API 506
remote service attribute (QRMTSRVATR) system retrieve system status (QWCRSSTS) API 506
value 6, 62 retrieve system value (QWCRSVAL) API 506
remote sign-on (QRMTSIGN) system value 12, 62 Retrieve System Value (RTVSYSVAL) command 16
Remove Job Schedule Entry (RMVJOBSCDE) retrieving
command 227 group attribute 176
removing job schedule entry message ID numbers 232
autostart job entry 96 network attribute 79
communications entry 99 sign-on information in application program 111
job queue entry 98 system value 16
job schedule entry 227 Return codes, major and minor 127
prestart job entry 100 RLSJOBSCDE (Release Job Schedule Entry)
routing entry 100 command 227
workstation entry 96 RMVJOBSCDE (Remove Job Schedule Entry)
request data command 227
description 209 routing
example 113 based on communications program start
source 209 request 206
request end directly to user program 206
preventing 114 to QCMD based on workstation 161
requester device to QCMD to control job submitted through spooling
I/O error for job 167 reader 207
required password digits (QPWDRQDDGT) system to user program 164
value 12, 57 user-based 164
reroute workstation-based 164
conditions for interactive job 137 routing data 213
Reroute Job (RRTJOB) command 137 batch jobs 105
rerouting example 113
job 137 relationship to routing entry, routing data 101
resource accounting 269, 274 routing entry 100
restoring sources of 129
job schedule object 228 specifying 130
objects 18 routing entry 213
QALWOBJRST system value 18
activity level 93
restoring customized information
adding 100, 119
JOBD, SBSD 81, 496
changing 100
restricted condition 109
comparison values and sequence numbers 101
restriction
contents 100
journal and journal receiver 280
definition 100
using double-byte request data 114
description 100
retain server security (QRETSVRSEC) system
relationship to routing data, routing step 101
value 12, 61
removing 100
retrieve class information (QWCRCLSI) API
values to start routing step 101
(QWCRCLSI) retrieve class information 506
routing step
retrieve current attributes (QWCRTVCA) API
activity for display of command entry display 159
(QWCRTVCA)retrieve current attributes API 506 application as routing step program 209
retrieve data area (QWCRDTAA) API 506 approaches to controlling 206
Retrieve Group Attributes (RTVGRPA) command 176 batch jobs 105
retrieve IPL attributes (QWCRIPLA) API causes of additional 129
(QWCRIPLA) retrieve IPL attributes API 506 control batch using QCMD/QSYS 207, 208
retrieve job description information (QWDRJOBD) control using user program 162
API 506 controlling using IBM-supplied program
Retrieve Job Information (QUSRJOBI) QSYS/QCMD 161
QUSRJOBI (Retrieve Job Information) definition 100, 129
notification messages for jobs 126 program to control 165
retrieve job information (QUSRJOBI) API 506 relationship to routing data, routing entry 101
retrieve job queue information (QSPRJOBQ) API 506 running environment for 101

Index 535
routing step (continued) security (continued)
using QCMD to control 159 controlling IPL 200 (continued)
values to start routing step 101 changing IPL start-up program 116
ways to control 161 setting up unattended environment 116
RRTJOB (Reroute Job) command 137 setting up unattended nighttime environment 117
RTVGRPA (Retrieve Group Attributes) command 176 job descriptions and USER parameter 133
RTVNETA (Retrieve Network Attributes) command 79 mixing double-byte and alphanumeric display
RTVSYSVAL (Retrieve System Value) command 16 stations 118
run-time attribute 134 prestart job object authorization 220
running environment preventing sign-on display from QINTER
for routing step 101 subsystem 114
sending completion message 200
submitting a job using parameters from a display
S file 201
saving submitting batch job 195
job schedule entry, example 231 user sign-on 112
job schedule object 228 workstations, controlling a group 115
system values 16 security level (QSECURITY) system value 12, 63
SBMDBJOB (Submit Database Jobs) command 106, security officer
197 sign-on 157
SBMDKTJOB (Submit Diskette Jobs) command 106, security system values
197 changes to 12
SBMJOB (Submit Job) command overview 12
benefits of using to schedule jobs 224 selecting
JOBD value on create command 132 a list of system values 14
override default queues 197 sending
to user specified job queue 106 completion message 200
SBMJOB scheduled job sequence numbers and comparison values 101
cleared job queue 225 serial number (QSRLNBR) system value 6, 65
how scheduled 225 server authentication interval (QSVRAUTITV) system
SBMJOBSMP program value 6, 68
CL coding example 203 service dump (QSRVDMP) system value 11, 68
RPG coding example 203 Set Attention Program (SETATNPGM) command 180
SBMJOBSMPC program set job attribute (QSETJOBATR) system value 6, 64
example display file 201 set job user identity(QWTSJUID) API 506
SBMJOBSMPD program set lock flight recorder (QWTSETLF) API 507
example display file 201 Set Object Access (SETOBJACC) command 257
SBMXXXJOB command Set Profile (QWTSETP) API 507
compared to reader 200 Set Profile Exit Programs (QWTSETPX) API 507
scheduled job set tracer (QWTSETTR) API 507
cleared job queue 225 SETATNPGM (Set Attention Program) command 180
how scheduled using SBMJOB 225 at different call levels 180
introduction 223 scenario 180
printing a list 223 SETOBJACC (Set Object Access) command 257
scheduling setting
batch job 223 attention program 180
SBMJOB (Submit Job) command 223 initial tuning values 242
using job schedule entry 226 LOGCLPGM attribute 147
scheduling job object access 257
introduction 223 shared pool
SCPF (start-control-program-facility) 235 changing activity level 89
second (QSECOND) system value 5, 63 changing size 89
secondary shared storage pool
thread 121 definition 87
secondary interactive job 174 shipped system characteristics 499
security short wait
considerations definition 262
batch job 200 thread 262
prestart job 220 short wait extended
controlling IPL 115 definition 262
calling special IPL recovery program 116 thread 262

536 OS/400 Work Management V4R4

showing starting (continued)
double-byte versions of messages 118 prestart job 195
sign-off routing step 101
preventing 114 subsystem 83
sign-on state
display file tips 86 key/think wait 262
Sign-On display long wait 262
changing 85 short wait 262
sign-on display thread 261
preventing sign-on display from QINTER status
subsystem 114 performance monitor 298
subsystem activity leading to a 104 status messages (QSTSMSG) system value 11, 68
sign-on information storage
retrieving 111 *MACHINE (machine pool) 87
sign-on information (QDSPSGNINF) system value 12, requirements for group job 183
38 storage pool
signing on 112 *INTERACT (interactive jobs) 87
controlling 112 *SPOOL (spool writers) 87
under QSECOFR user profile 158 activity level 93
under security officer user profile 158 base 87
under workstation user profile 158 changing size 88
with SECOFR password 158 definition 87
SIGTERM, Asynchronous signal 127 description 88
simple system paging 240, 241
definition 1 private 87
software error log (QSFWERRLOG) system value 11, shared 87
64 size 88
sort sequence (QSRTSEQ) system value 6, 65 storage pool paging
source for CL start-up program 498 using CHGSHRPOOL command to adjust 241
SP and DP printer file accounting data 277 storage pools
special environment (QSPCENV) system value 6, 65 defining 93
specifying 130 how data is handled 89
attributes of a batch job 107, 197 subsystem monitor job 89
lists of system values 15 user-defined 89
order for job queues 199 using to tune system automatically 239
output queue for a job log 145 storage system values
system values qualified with library name 15 overview 11
spooling job STRPEX (Start Performance Explorer) command 433
queue used 197 STRPFRMON (Start Performance Monitor)
use of shipped objects 198 command 292
spooling subsystem 198 submit a batch job
spooling support example 195
input and output 197 Submit Database Jobs (SBMDBJOB) command 106,
queue 197 197
start-control-program-facility (SCPF) 235 Submit Diskette Jobs (SBMDKTJOB) command 106,
Start Performance Explorer (STRPEX) command 433 197
Start Performance Monitor (STRPFRMON) Submit Job (SBMJOB) command
command 292 JOBD value on create command 132
start printer writer (QSTRPRTWTR) system value 6, override default queues 197
67 to user specified job queue 106
start-up program submitting 197
source 498 batch job 195
start-up program, changing 116 database job 204
start-up program name (QSTRUPPGM) system diskette job 197
value 6, 67 diskette job :i2.database job 106
starting job
batch job 195 from another subsystem 201
line numbers, variable 499 JOBD value on create command 132
NIGHTQ subsystem 117 override default queues 197
performance explorer 433 SBMJOB command 224
performance monitor 292 to user specified job queue 106

Index 537
subsystem subsystem descriptions
activity keep customized information 496
creating job for security officer 158 subsystem example, interactive 119
display of program call menu 157 subsystem monitor job
activity for sign-on display 104 description 84
activity level 92 storage pools 89
base storage pool scenario 95 SYSNAME (system name) network attribute 77
configuration, shipped 502 system
contents of IBM-supplied 473 activity level 93
controlling characteristics of shipped 157
changing 110 spooling subsystem 198
creating 110 system and communications data
defining another 110 estimating file size for collecting 300
definition 81 system arbiter (QSYSARB) system job 235
determining which has job queue allocated 206 allocation workstation devices 103
determining which job queues are allocated to system availability
it 206 job scheduling 224
display of command entry display 159 system control (QABNORMSW) system value 6, 16
ending 84 system control system values
examples 119 overview 6
handles jobs on several job queues 199 system data
how it starts 83 collecting 292
introduction 81 definition 292
job queue allocation 105 estimating file size for collecting 300
monitor 84
system job 238
number of jobs allowed, changing 111
alert manager (QALERT) 237
QBASE 502
communications (QSYSCOM1) 238
QBATCH 502
database cross-reference (QBDSRVXR) 237
QCMN 502
database cross-reference (QBDSRVXR2) 237
QCTL 502
database parallelism (QQQTEMP1) 237
QINTER 502
database parallelism (QQQTEMP2) 237
QSERVER 502
database server (QDBSRV01..N) 236
QSNADS 502
decompress system object (QDCPOBJ1..N) 236
QSPL 502
definition 235
QSYSWRK 502
displaying information about 238
QSYSWRK (system work) 500
introduction 235
QUSRWRK 473, 502
job schedule (QJOBSCD) 236
relationship with job queue 106
logical unit services (QLUS) 236
scenario with four jobs 95
performance adjustment (QPFRADJ) 236
spooling 198
processing for job accounting 279
starting 83
QALERT (alert manager) 237
starting the nighttime 117
QBDSRVXR (database cross-reference) 237
subsystem activity
QBDSRVXR2 (database cross-reference) 237
before starting routing step 159 QDBSRV01..N (database server) 236
subsystem attributes QDCPOBJ1..N (decompress system object) 236
changing 89 QJOBSCD (job schedule) 236
subsystem configuration QLUS (logical unit services) 108, 236
shipped 502 QPFRADJ (performance adjustment) 236
subsystem description QQQTEMP1 (database parallelism) 237
activity level 89 QQQTEMP2 (database parallelism) 237
adding routing entries 102 QSPLMAINT (system spool) 237
changing 86, 89 QSYSARB (system arbiter) 235
copying 83 QSYSCOM1 (communications) 238
creating 83, 89 QSYSWRK (system work) 500
creating for nighttime jobs 116 QWCBTCLNUP (work control block table
definition 81 cleanup) 236
deleting 85 SCPF (start-control-program-facility) 235
displaying 206 start-control-program-facility (SCPF) 235
pool 87 subsystem monitor 84
relationship to job and class 136 system arbiter (QSYSARB) 235
routing entry 100 system spool (QSPLMAINT) 237

538 OS/400 Work Management V4R4

system job 237 (continued) system value (continued)
system work (QSYSWRK) 237 controlling subsystem (QCTLSBSD) 11, 33
work control block table cleanup coordinated universal time offset
(QWCBTCLNUP) 236 (QUTCOFFSET) 5, 75
system library list (QSYSLIBL) system value 10, 68 country identifier (QCNTRYID) 6, 31
system menu 499 create authority (QCRTAUT) 12, 31
system model (QMODEL) system value 6, 50 create object audit (QCRTOBJAUD) 12, 32
system name (SYSNAME) network attribute 77 currency symbol (QCURSYM) 6, 33
system performance database recovery (QDBRCVYWT) 6, 35
adjusting 245 date-and-time, overview 5
observing 245 date format (QDATFMT) 6, 34
system request function date separator (QDATSEP) 6, 34
group job 175 day (QDAY) 5, 35
system request Key day (QDAYOFWEEK) 35
Presystem Request Program exit program 175 days password valid (QPWDEXPITV) 12, 54
system spool (QSPLMAINT) system job 237 daywk (QDAYOFWEEK) 5
system tuning DBCS-installed (QIGC) 6, 40
decimal format (QDECFMT) 6, 36
automatic 239
detailed descriptions 16
concepts 261
device naming convention (QDEVNAMING) 6, 36,
manual 242
501
system tuning manual 242
device recovery action (QDEVRCYACN) 6, 37
system value
disconnect job interval (QDSCJOBITV) 6, 38
accounting level (QACGLVL) 11, 16
displaying 14
active jobs (QACTJOB) 10, 17
double-byte coded font name (QIGCCDEFNT) 6, 40
additional active jobs (QADLACTJ) 10, 18
double-byte coded font point size
additional storage (QADLSPLA) 10, 18
(QIGCFNTSIZ) 41
additional total jobs (QADLTOTJ) 10, 18
duplicate password (QPWDRQDDIF) 12, 58
allocation, overview 10
dynamic priority adjustment (QDYNPTYADJ) 38
allow object restore (QALWOBJRST) 12, 18
dynamic priority scheduler (QDYNPTYSCD) 10, 39
allow user domain (QALWUSRDMN) 12, 19
editing, overview 6
assistance level (QASTLVL) 6, 20
enclosed in apostrophes 14
attention program (QATNPGM) 6, 20
force conversion on restore (QFRCCVNRST) 6, 39
auditing control (QAUDCTL) 12, 20
graphic character set 29
auditing end action (QAUDENDACN) 12, 21
history log size (QHSTLOGSIZ) 11, 40
auditing force level (QAUDFRCLVL) 12, 22
hour (QHOUR) 5, 40
auditing level (QAUDLVL) 12, 22
inactive job time-out (QINACTITV) 12, 41
automatic configuration device (QAUTOVRT) 6, 26
inactive message queue (QINACTMSGQ) 12, 42
automatic configuration indicator (QAUTOCFG) 6,
initial spooling size (QJOBSPLA) 10, 45
24
introduction 5
automatic configuration remote controller
IPL console (QSCPFCONS) 6, 63
(QAUTORMT) 6, 25
IPL status (QIPLSTS) 6, 43
automatic IPL date and time (QIPLDATTIM) 6, 43
IPL type (QIPLTYPE) 6, 44, 501
automatic system disabled (QAUTOSPRPT) 6, 25
job message queue full (QJOBMSGQFL) 10, 44
auxiliary storage 26
job message queue maximum
auxiliary storage lower limit (QSTGLOWLMT) 66
(QJOBMSGQMX) 10, 44
auxiliary storage lower limit action
job message queue size (QJOBMSGQSZ) 10, 45
(QSTGLOWACN) 66
job message queue total (QJOBMSGQTL) 10, 45
base activity level (QBASACTLVL) 11, 26
keyboard buffer (QKBDBUF) 6, 45
base pool (QBASPOOL) 11, 27
keyboard type (QKBDTYPE) 6, 46
benefits 5
language identifier (QLANGID) 6, 46
book path search (QBOOKPATH) 6, 27
leap year adjust (QLEAPADJ) 5, 46
century (QCENTURY) 5, 28
library list, overview 10
changing 14
limit adjacent digits (QPWDLMTAJC) 12, 55
character identifier control (QCHRIDCTL) 6, 29
limit characters (QPWDLMTCHR) 12, 55
character set and code page (QCHRID) 6, 29
limit device session (QLMTDEVSSN) 12, 46
coded character set identifier (QCCSID) 6, 27
limit repeat characters (QPWDLMTREP) 12, 56
communications arbiters (QCMNARB) 30
limit security officer (QLMTSECOFR) 12, 47
communications recovery limit (QCMNRCYLMT) 6,
locale path name (QLOCALE) 6, 47
30
logging 16, 44
configuration message queue (QCFGMSGQ) 11, 28
machine pool (QMCHPOOL) 11, 49
console name (QCONSOLE) 6, 31

Index 539
system value (continued) system value (continued)
maximum activity level (QMAXACTLVL) 11, 47 QCONSOLE (console name) 11, 31
maximum characters (QPWDMAXLEN) 12, 56 QCRTAUT (create authority) 12, 31
maximum not valid sign-on (QMAXSIGN) 12, 48 QCRTOBJAUD (create object audit) 12, 32
maximum sign-on action (QMAXSGNACN) 12, 48 QCTLSBSD (controlling subsystem) 6, 33, 501
message 16, 44 QCURSYM (currency symbol) 6, 33
message-and-logging, overview 11 QDATE (system date) 5, 34
minimum characters (QPWDMINLEN) 12, 56 QDATFMT (date format) 6, 34
minimum problem retention (QPRBHLDITV) 11, 53 QDATSEP (date separator) 6, 34
minute (QMINUTE) 5, 50 QDAY (day) 5, 35
month (QMONTH) 5, 51 QDAYOFWEEK (day) 5, 35
multiple thread action (QMLTTHACN) 6 QDBRCVYWT (database recovery) 6, 35
multithreaded action (QMLTTHDACN) 50 QDECFMT (decimal format) 6, 36
overview 5 QDEVNAMING (device naming convention) 6, 36,
password validation program (QPWDVLDPGM) 12, 501
58 QDEVRCYACN (device recovery action) 6, 37
performance adjustment (QPFRADJ) 6, 51 QDSCJOBITV (disconnect job interval) 6, 38
placed in CL variables 16 QDSPSGNINF (sign-on information) 12, 38
position characters (QPWDPOSDIF) 12, 57 QDYNPTYADJ (dynamic priority adjustment) 38
power down limit (QPWRDWNLMT) 6, 59 QDYNPTYSCD (dynamic priority scheduler) 10, 39
power restore IPL (QPWRRSTIPL) 6, 59 QFRCCVNRST (force conversion on restore) 6, 39
print key format (QPRTKEYFMT) 6, 54 QHOUR (hour) 5, 40
print text (QPRTTXT) 11, 54 QHSTLOGSIZ (history log size) 11, 40
printer device (QPRTDEV) 6, 53 QIGC (DBCS-installed) 6, 40
problem filter (QPRBFTR) 11, 52 QIGCCDEFNT (double-byte coded font name) 6, 40
processor feature (QPRCFEAT) 6, 53 QIGCFNTSIZ (double-byte coded font point
processor multi-tasking (QPRCMLTTSK) 6, 53 size) 41
QABNORMSW (system control) 6, 16 QINACTITV (inactive job time-out) 12, 41
QACGLVL (accounting level) 11, 16 QINACTMSGQ (inactive message queue) 12, 42
QACTJOB (active jobs) 10, 17 QIPLDATTIM (automatic IPL date and time) 6, 43
QADLACTJ (additional active jobs) 10, 18 QIPLSTS (IPL status) 6, 43
QADLSPLA (additional storage) 10, 18 QIPLTYPE (IPL type) 6, 44, 501
QADLTOTJ (additional total jobs) 10, 18 QJOBMSGQFL (job message queue full) 10, 44
QALWBOJRST (allow object restore) 18 QJOBMSGQMX (job message queue
QALWOBJRST (allow object restore) 12 maximum) 10, 44
QALWUSRDMN (allow user domain) 12, 19 QJOBMSGQSZ (job message queue size) 10, 45
QASTLVL (assistance level) 6, 20 QJOBMSGQTL (job message queue total) 10, 45
QATNPGM (attention program) 6, 20 QJOBSPLA (initial spooling size) 10, 45
QAUDCTL (auditing control) 12, 20 QKBDBUF (keyboard buffer) 6, 45
QAUDENDACN (auditing end action) 12, 21 QKBDTYPE (keyboard type) 6, 46
QAUDFRCLVL (auditing force level) 12, 22 QLANGID (language identifier) 6, 46
QAUDLVL (auditing level) 12, 22 QLEAPADJ (leap year adjust) 5, 46
QAUTOCFG (automatic configuration indicator) 6, QLMTDEVSSN (limit device session) 12, 46
24 QLMTSECOFR (limit security officer) 12, 47
QAUTORMT (automatic configuration remote QLOCALE (locale path name) 6, 47
controller) 6, 25 QMAXACTLVL (maximum activity level) 11, 47
QAUTOSPRPT (automatic system disabled) 6, 25 QMAXSGNACN (maximum sign-on action) 12, 48
QAUTOVRT (automatic configuration device) 6, 26 QMAXSIGN (maximum not valid sign-on) 12, 48
QBASACTLVL (base activity level) 11, 26 QMCHPOOL (machine pool) 11, 49
QBASPOOL (base pool) 11, 27 QMINUTE (minute) 5, 50
QBOOKPATH (book path search) 6, 27 QMLTTHACN (multiple thread action) 6
QCCSID (coded character set identifier) 6, 27 QMLTTHACN (system model) 6
QCENTURY (century) 5, 28 QMLTTHDACN (multithreaded action) 50
QCFGMSGQ (configuration message queue) 11, 28 QMODEL (system model) 50
QCHRID (character set and code page) 6, 29 QMONTH (month) 5, 51
QCHRID system value 29 QPFRADJ (performance adjustment) 6, 51
QCHRIDCTL (character identifier control) 6, 29 QPRBFTR (problem filter) 11, 52
QCMNARB (communications arbiters) 30 QPRBHLDITV (minimum problem retention) 11, 53
QCMNRCYLMT (communications recovery limit) 6, QPRCFEAT (processor feature) 6, 53
30 QPRCMLTTSK (processor multi-tasking) 6, 53
QCNTRYID (country identifier) 6, 31 QPRTDEV (printer device) 6, 53

540 OS/400 Work Management V4R4

system value (continued) system value (continued)
QPRTKEYFMT (print key format) 11, 54 required password digits (QPWDRQDDGT) 11, 57
QPRTTXT (print text) 11, 54 retain server security (QRETSVRSEC) 12, 61
QPWDEXPITV (days password valid) 12, 54 retrieving 16
QPWDLMTAJC (limit adjacent digits) 12, 55 retsvrs (retain server security) 12
QPWDLMTCHR (limit characters) 12, 55 saving 16
QPWDLMTREP (limit repeat characters) 12, 56 second (QSECOND) 5, 63
QPWDMAXLEN (maximum characters) 12, 56 security, overview 12
QPWDMINLEN (minimum characters) 12, 56 security level (QSECURITY) 12, 63, 501
QPWDPOSDIF (position characters) 12, 57 selecting list 14
QPWDRQDDGT (required password digits) 12, 57 serial number (QSRLNBR) 6, 65
QPWDRQDDIF (duplicate password) 12, 58 server authentication interval (QSVRAUTITV) 6, 68
QPWDVLDPGM (password validation program) 12, service dump (QSRVDMP) 11, 68
58 set job attribute (QSETJOBATR) 6, 64
QPWRDWNLMT (power down limit) 6, 59 sign-on information (QDSPSGNINF) 12, 38
QPWRRSTIPL (power restore IPL) 6, 59 software error log (QSFWERRLOG) 11, 64
QQRYDEGREE (degree) 60 sort sequence (QSRTSEQ) 6, 65
QQRYDEGREE (query degree) 6 special environment (QSPCENV) 6, 65, 501
QQRYTIMLMT (query time limit) 6, 60 specified by object names 15
QRCLSPLSTG (reclaim spool storage) 10, 61 specifying in list 15
QRETSVRSEC (retain server security) 61 start printer writer (QSTRPRTWTR) 6, 67
QRMTIPL (remote IPL) 6, 61 start-up program name (QSTRUPPGM) 6, 67
QRMTSIGN (remote sign-on) 12, 62 status messages (QSTSMSG) 11, 68
QRMTSRVATR (remote service attribute) 6, 62 storage 49
QSCPFCONS (IPL console) 6, 63 storage, overview 11
QSECOND (second) 5, 63 system control, overview 6
QSECURITY (security level) 12, 63, 501 system control (QABNORMSW) 6, 16
QSETJOBATR (set job attribute) 6, 64 system date (QDATE) 5, 34
QSFWERRLOG (software error log) 11, 64 system library list (QSYSLIBL) 10, 68
QSPCENV (special environment) 6, 65, 501 system model (QMLTTHACN) 6
QSRLNBR (serial number) 6, 65 system model (QMODEL) 50
QSRTSEQ (sort sequence) 6, 65 system time (QTIME) 69
QSRVDMP (service dump) 11, 68 time (QTIME) 5, 69
QSTGLOWACN(auxiliary storage lower limit time separator (QTIMSEP) 6, 70
action) 66 time slice end pool (QTSEPOOL) 11, 71
QSTGLOWLMT(auxiliary storage lower limit ) 66 tips 15
QSTRPRTWTR (start printer writer) 6, 67 total jobs (QTOTJOB) 10, 70
QSTRUPPGM (start-up program name) 6, 67 uninterruptible power supply (UPS) delay time
QSTSMSG (status messages) 11, 68 (QUPSDLYTIM) 6, 71
QSVRAUTITV (server authentication interval) 6, 68 uninterruptible power supply (UPS) message queue
QSYSLIBL (system library list) 10, 68 (QUPSMSGQ) 6, 73
QTIME (time) 5, 69 use adopted authority (QUSEADPAUT) 74
QTIMSEP (time separator) 6, 70 useadp (QUSEADPAUT) 12
QTOTJOB (total jobs) 10, 70 user library list (QUSRLIBL) 10, 75
QTSEPOOL (time slice end pool) 11, 71 when takes effect 16
qualified with job name, specifying 15 working with 13
query degree (QQRYDEGREE) 6, 60 year (QYEAR) 5, 76
query time limit (QQRYTIMLMT) 6, 60 system work (QSYSWRK) subsystem 500
QUPSDLYTIM (uninterruptible power supply (UPS)
delay time) 6, 71
QUPSMSGQ (uninterruptible power supply (UPS)
T
task
message queue) 6, 73
type
QUSEADPAUT (use adopted authority) 12, 74
extender 423
QUSRLIBL (user library list) 10, 75
test request key 120
QUTCOFFSET (coordinated universal time
TFRGRPJOB (Transfer to Group Job) command 172
offset) 5, 75
TFRJOB (Transfer Job) command 129
QYEAR (year) 5, 76
thread
reclaim spool storage (QRCLSPLSTG) 10, 61
call stack 121
remote IPL (QRMTIPL) 6, 61
initial
remote service attribute (QRMTSRVATR) 6, 62
secondary 121
remote sign-on (QRMTSIGN) 12, 62
long wait extended 262

Index 541
thread (continued) user-based routing 166 (continued)
short wait 121 compared to workstation-based routing 166
short wait extended 262 user-defined storage pool
state transitions 263 creating 89
wait state 262 user-defined storage pools
thread, active 262 creating 90
thread state user domain
transitions 263 QALWUSRDMN system value 19
threads user library list (QUSRLIBL) system value 10, 75
state 261 user name
time definition 122
log-version 148 user profile
time (QTIME) system value 69 controlling assignment of accounting code 287
time separator (QTIMSEP) system value 6, 70 prestart job 220
time slice security considerations 220
changing 124 use with work management 499
changing for duration of CL command 124 using an initial menu 113
time slice end pool (QTSEPOOL) system value 11, 71 using an initial program 112
time slice parameter 265 using routing data 113
time stamp, spooled files 197 user program
tips for setting job priority 135 control routing step using 162
total jobs (QTOTJOB) system value 10, 70 user sign-on actions 112
trace using
dumping 295 retrieved data 111
trace data using subsystem
collecting 293, 294 changing subsystem description 86
definition 292 deleting subsystem description 85
dumping 295 ending 84
trace table, internal 295 starting 83
transaction
definition 169
Transfer Job (TFRJOB) command 129, 137 V
Transfer to Group Job (TFRGRPJOB) command 172 validity checking
transferring job accounting 287
control from one group job to another 172 values
from one group job to another 172 routing entry 101
how do batch jobs 138 varying calendar
how do interactive jobs 137 how to handle job scheduling 229
job 129, 137 version
to group job 172 history (QHST) log 148
transitions
from one thread state to another 263
TRCJOB (Trace Job) W
exit program 507 wait state 262
tuning definition 262
basic 242 key/think 262
specialized 253 long 262
short 262
wait states
U long wait 262
unattended environment short wait 262
setting up 116 weekly job
uninterruptible power supply (UPS) delay time example of scheduling 230
(QUPSDLYTIM) system value 6, 71 when does a system value take effect? 16
uninterruptible power supply (UPS) message queue when it is dumped 295
(QUPSMSGQ) system value 6, 73 work control block table cleanup (QWCBTCLNUP)
use adopted authority (QUSEADPAUT) system system job 236
value 12, 74 work entries 95
user authority work entry
QACGTLVL 282 autostart job entry 211
user-based routing 164 definition 95

542 OS/400 Work Management V4R4

work entry (continued) WRKJOBSCDE (Work with Job Schedule Entries)
job queue entry 211 command 227
prestart job entry 99 WRKSYSVAL (Work with System Values)
support for workstation generic name 97 command 13
workstation entry 96 WRKUSRJOB (Work with User Jobs) command 143
workstation generic name 97
work management
API (application programming interface) 505 Y
attention-key-handling 171 year (QYEAR) system value 5, 76
benefits of understanding 1 Year 2000
characteristics of shipped system 499 QAPMCONF
concept of 1 data collection 294
definition 1
exit program 505
group job 171
introduction 1
objects
shipped with the system 499
performance tuning 239
sign-on using shipped objects 157
Work with Active Jobs (WRKACTJOB) command
display system job information 238
observing system performance 252
Work with Disk Status (WRKDSKSTS) command 251
Work with Job Descriptions (WRKJOBD)
command 133
Work with Job Schedule Entries (WRKJOBSCDE)
command 227
Work with System Values (WRKSYSVAL)
command 13
Work with System Values display benefits 13
Work with User Jobs (WRKUSRJOB) command 143
working with
job description 133
job schedule entry 227
system value 13
workstation
allocation 103
allocation scenario 104
controlling group 115
generic names and types 97
long-running functions from 170
mixing double-byte and alphanumeric 118
support for generic names and types 97
workstation-based routing 164
compared to user-based routing 166
workstation display
controlling initial display 112
workstation entry
changing 96
removing 96
workstation user
signing on 499
writer 197
WRKACTJOB (Work with Active Jobs) command
display system job information 238
observing system performance 252
WRKDSKSTS (Work with Disk Status) command 251
WRKJOBD (Work with Job Descriptions)
command 133

Index 543
544 OS/400 Work Management V4R4
Readers’ Comments — We’d Like to Hear from You

AS/400e
Work Management
Version 4

Publication No. SC41-5306-03

Overall, how satisfied are you with the information in this book?

Very Satisfied Satisfied Neutral Dissatisfied Very Dissatisfied

Overall satisfaction h h h h h

How satisfied are you that the information in this book is:

Very Satisfied Satisfied Neutral Dissatisfied Very Dissatisfied

Accurate h h h h h
Complete h h h h h
Easy to find h h h h h
Easy to understand h h h h h
Well organized h h h h h
Applicable to your tasks h h h h h

Please tell us how we can improve this book:

Thank you for your responses. May we contact you? h Yes h No

When you send comments to IBM, you grant IBM a nonexclusive right to use or distribute your comments in any way
it believes appropriate without incurring any obligation to you.

Name Address

Company or Organization

Phone No.
 ___________________________________________________________________________________________________
Readers’ Comments — We’d Like to Hear from You Cut or Fold
SC41-5306-03 IBMR Along Line

_ _ _ _ _ _ _Fold
_ _ _ and
_ _ _Tape
_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _Please
_ _ _ _ do
_ _ not
_ _ _staple
_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _Fold
_ _ _and
_ _ Tape
______

NO POSTAGE
NECESSARY
IF MAILED IN THE
UNITED STATES

BUSINESS REPLY MAIL

FIRST-CLASS MAIL PERMIT NO. 40 ARMONK, NEW YORK

POSTAGE WILL BE PAID BY ADDRESSEE

IBM CORPORATION
ATTN DEPT 542 IDCLERK
3605 HWY 52 N
ROCHESTER MN 55901-7829

________________________________________________________________________________________
Fold and Tape Please do not staple Fold and Tape

Cut or Fold
SC41-5306-03 Along Line
IBMR

Printed in the United States of America

on recycled paper containing 10%
recovered post-consumer fiber.

SC41-5306-03
Spine information:

Version 4
IBM AS/400e OS/400 Work Management V4R4