Jobs system values: Allocate storage at restart

Specifies the storage used at restart for active and total jobs. (QACTJOB, QTOTJOB)

Allocate storage at restart, also known as QACTJOB, and QTOTJOB, is a member of the jobs category of system values. You can use this system value to set the amount of storage used at restart for active and total jobs. To learn more, keep reading.

Quick reference
Location In iSeries™ Navigator, select your system, > Configuration and Service > System Values > Jobs > Allocation
Special authority None
Default value For active jobs -- 20; For total jobs -- 30
Changes take effect At the next restart of the system
Lockable No

What can I do with this system value?

These two system values specify the number of active and total jobs to allocate storage for at restart.

Active Jobs (QACTJOB)

Specifies the initial number of active jobs for which auxiliary storage is allocated when you restart the system. An active job is a job that has started running but not ended. This storage is in addition to the storage allocated using the total jobs system value. Possible values are 1 through 32767.

You may determine a new value to assign to active jobs. This value should be the estimated number of jobs that are active on a typical heavy-use day. You can see the number of active jobs on the system in iSeries Navigator by selecting Work Management and then selecting Active Jobs. The total number of active jobs is shown in the status bar at the bottom of the iSeries Navigator window. To ensure that this number is accurate, make sure the include criteria specifies all jobs except system jobs. For more information about specifying the include criteria, see the include section in the find a job topic. Select to include everything except System in the Type field. System jobs do not need to be considered when assigning a value to the active jobs at restart system value.

Total Jobs (QTOTJOB)

Represents the minimum number of jobs for which storage is allocated when you restart the system. 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.Possible values are 1 through 32767.

If this value is set so that the amount of storage required exceeds the amount currently allocated, additional storage is allocated. If this value 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, right-click your system in iSeries Navigator and select System Status. This number should usually be kept within reason as it is a factor in the time to perform a restart 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 attached to the job, knowledge of the job remains in the system and counts toward the display system status value.

You may also use the Detach printer output after jobs have ended (QSPLFACN) system value to control the reuse of job structures. This will give you more control of the number of jobs being processed.

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

Where can I get more information about this system value?

To learn more, go to the jobs system values overview topic. If you are looking for a specific system value or category of system values, try using the system value finder.

Related concepts
System values: Jobs overview
Jobs system values: Detach printer output after jobs have ended
Related tasks
Find a job
Related information
CL Programming
System value finder