IBM Support

SI55214 - OSP-PRT JOB-LEVEL QMAXSPLF

PTF ( Program Temporary Fixes ) Cover letter


Order this fix

Abstract

OSP-PRT JOB-LEVEL QMAXSPLF


Pre/Co-Requisite PTF / Fix List

REQ  LICENSED           PTF/FIX  LEVEL

TYPE PROGRAM  RELEASE   NUMBER   MIN/MAX  OPTION
---- -------- --------- -------  -------  ------
NONE



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

-----------------------------------------------
Customers need the ability to set the maximum number of spooled
files for a job to a smaller value than the QMAXSPLF system
value allows.  They should also be able to set different limits
on different jobs.

CORRECTION FOR APAR SE60021 :
-----------------------------
This function will be provided by defining a new QIBM_SP_MAXSPLF
environment variable to override the QMAXSPLF system value.
Please read the PTF coverletter special instructions for more
details.

CIRCUMVENTION FOR APAR SE60021 :
--------------------------------
None.


Activation Instructions


None.




Special Instructions


This PTF allows setting the maximum number of spooled files for a job
to a different value than the QMAXSPLF system value by adding a new
environment variable QIBM_SP_MAXSPLF.

For example, set the system value to a low limit:
CHGSYSVAL QMAXSPLF VALUE(9999)

Set a higher limit in a job that is allowed to have more spooled files:
ADDENVVAR ENVVAR(QIBM_SP_MAXSPLF) LEVEL(*JOB) VALUE(99999)

Each job needs to set the environment variable after it is started, in
its initial program or during program setup. To minimize any
performance impacts, the operating system will retrieve the limit once
per job and use a cached value for subsequent calls to spool. Removing
or changing the environment variable will not have any effect if it has
already been retrieved for the job.

QIBM_SP_MAXSPLF can be set higher or lower than the QMAXSPLF system
value, and supports a range values from 1000 to 999999.  If the
variable is null, non-numeric, or outside of this range, it will be
ignored and no message issued.

QIBM_SP_MAXSPLF is ignored for spooled files created under a QPRTJOB
jobs -- for example spooled files generated for another user with the
Set Profile Handle (QWTSETP, QsySetProfileHandle) API, or by a TCP/IP
or Host Server job.


Default Instructions

THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.



Supersedes

PTF/FIX NO(S).  APAR TITLE LINE
--------------  ------------------------------------------------------------
     NONE

Summary Information

System.............................. i
Models..............................
Release............................. V7R2M0
Licensed Program............... 5770SS1
APAR Fixed.......................... View details for APAR SE60021
Superseded by:......................
Recompile........................... N
Library............................. QSYS
MRI Feature ........................ NONE
Cum Level........................... C6127720


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 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.

Document information

More support for: i family

Software version: V7R2M0

Operating system(s): OS/400

Reference #: SI55214

Modified date: 11 December 2015