IBM Support

SI42845 - OSP-OTHER-UNPRED Job at limit should be held not ended.

PTF Cover Letter


PTF ( Program Temporary Fixes ) Cover letter


Order this fix

Abstract

OSP-OTHER-UNPRED Job at limit should be held not ended.


Pre/Co-Requisite PTF / Fix List

REQ  LICENSED      PTF/FIX  LEVEL

TYPE PROGRAM  REL  NUMBER   MIN/MAX  OPTION
---- -------- ---  -------  -------  ------
PRE  5770SS1  710  SI42759   00/00    0000



NOTICE:
-------
Application of this PTF may disable or render ineffective programs that
use system memory addresses not generated by the IBM translator,
including programs that circumvent control technology designed to limit
interactive capacity to purchased levels.  This PTF may be a prerequisite
for future PTFs.  By applying this PTF you authorize and agree to the
foregoing.

This PTF is subject to the terms of the license agreement which
accompanied, or was contained in, the Program for which you are obtaining
the PTF.  You are not authorized to install or use the PTF except as part
of a Program for which you have a valid Proof of Entitlement.

SUBJECT TO ANY WARRANTIES WHICH CAN NOT BE EXCLUDED OR EXCEPT AS EXPLICITLY
AGREED TO IN THE APPLICABLE LICENSE AGREEMENT OR AN APPLICABLE SUPPORT
AGREEMENT, IBM MAKES NO WARRANTIES OR CONDITIONS EITHER EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON INFRINGEMENT,
REGARDING THE PTF.

The applicable license agreement may have been provided to you in printed
form and/or may be viewed using the Work with Software Agreements (WRKSFWAGR)
CL command.





APAR Error Description / Circumvention

-----------------------------------------------
When a job reaches the maximum processing unit time, it is ended
with MSGCPC1218. When a job reaches the maximum temporary
storage allowed, it is ended with MSGCPC1217.  These limits are
defined in the class object named by the routing entry in the
subsystem description.

In some cases, the jobs would be successful if allowed a bit
more CPU time or storage.  The jobs should be held rather than
ended.  The system operator should be notified.

CORRECTION FOR APAR SE45779 :
-----------------------------
The code is changed so that jobs that exceed their maximum
processing unit time or exceed their maximum temporary storage
will be held rather than ended. When the job is held, a message
is sent to the QSYSOPR message queue. Two new messages are
defined: CPI112D (Job held by the system, CPUTIME limit
exceeded) and CPI112E (Job held by the system, MAXTMPSTG limit
exceeded).  The jobs can be ended or the jobs can be allowed to
continue.

If you want the jobs to continue, you need to change the limit
for the job and then use the Release Job (RLSJOB) command. The
RLSJOB processing is changed so that you cannot release a job
that is currently above a limit. Two new messages are defined:
CPF134C for CPUTIME and CPF134D for MAXTMPSTG.

The Change Job (CHGJOB) command now supports two new parameters:
Maximum CPU time (CPUTIME) and Maximum temporary storage
(MAXTMPSTG).  You must have job control (*JOBCTL) special
authority to change CPUTIME or MAXTMPSTG.

The Maximum CPU time (CPUTIME) parameter specifies the maximum
processing unit time (in milliseconds) that the job can use. If
the job consists of multiple routing steps, only the current
routing step is affected. If the job is on a job queue, only the
next routing step is affected.  If the maximum time is exceeded,
the job is held. The CPUTIME parameter defaults to *SAME.  Valid
values are *SAME, *NOMAX, or 1 to 9999999.

The Maximum temporary storage (MAXTMPSTG) parameter specifies
the maximum amount of temporary auxiliary storage (in megabytes)
that the job can use. If the job consists of multiple routing
steps, only the current routing step is affected. If the job is
on a job queue, only the next routing step is affected.  This
temporary storage is used for storage required by the program
itself and by implicitly created internal system objects used to
support the job. (It does not include storage for objects in the
QTEMP library.) If the maximum temporary storage is exceeded,
the job is held. This parameter does not apply to the use of
permanent storage, which is controlled through the user profile.
The MAXTMPSTG parameter defaults to *SAME.  Valid values are
*SAME, *NOMAX, or 1 to 2147483647.

The Change Job (QWTCHGJB) API now supports two new keys: Maximum
processing unit time allowed, in milliseconds (1302) and Maximum
temporary storage allowed, in megabytes (1305).  These new keys
are valid on the JOBC0100 and JOBC0200 formats.  These are
BINARY(4) values and use -1 for *NOMAX and -2 for *SAME.  You
must have job control (*JOBCTL) special authority to change
these values.

On current systems the way temporary storage is accounted for is
not always accurate. However, you can still protect your system
from the effects of a run-away job by setting a limit that is
larger than what any job should use. Because the job will be
held rather than ended, the limit does not need to be set
perfectly.

At the current time, the Maximum temporary storage (MAXTMPSTG)
parameter on the Create Class (CRTCLS) command and on the Change
Class (CHGCLS) command are specified in kilobytes.  The value
shown by the Work with Job (WRKJOB) command is in megabytes.
The new Maximum temporary storage (MAXTMPSTG) parameter on the
Change Job (CHGJOB) command is specified in megabytes.

CIRCUMVENTION FOR APAR SE45779 :
--------------------------------
None.


Activation Instructions


None.




Special Instructions


None.


Default Instructions

THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.



Supersedes

PTF/FIX NO(S).  APAR TITLE LINE
--------------  ------------------------------------------------------------
   SI41333      OSP-OTHER-T/QWTMCRTG-MSGMCH3601 LOGGED IN QCMN JOBLOG DURING
   SI40568      OSP-OTHER-PERFM Error case runs too fast creating new jobs
   SI39786      OSP-INCORROUT Base Function to Enable Future Extensions

Summary Information

System..............................i
Models..............................
Release.............................V7R1M0
Licensed Program...............5770SS1
APAR Fixed..........................View details for APAR SE45779
Superseded by:......................View fix details for PTF SI66949
Recompile...........................N
Library.............................QSYS
MRI Feature ........................NONE
Cum Level...........................C1270710


System i Support

IBM disclaims all warranties, whether express or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. By furnishing this document, IBM grants no licenses to any related patents or copyrights. Copyright © 1996,1997,1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018 IBM Corporation. Any trademarks and product or brand names referenced in this document are the property of their respective owners. Consult the Terms of use link for trademark information.

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG15V","label":"PTF Cover Letters - OS\/400 General"},"Component":"","ARM Category":[],"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"V7R1M0","Edition":""},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG16D","label":"PTF Cover Letters - IBM i 7.1 environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"V7R1M0","Edition":""}]

Document Information

Modified date:
15 March 2011