PTF Cover Letter
PTF ( Program Temporary Fixes ) Cover letter
OSP SPOOL FILES SAVED ON IASP ARE RESTORED TO SYSBAS FROM PD
Pre/Co-Requisite PTF / Fix List
REQ LICENSED PTF/FIX LEVEL
TYPE PROGRAM REL NUMBER MIN/MAX OPTION
---- -------- --- ------- ------- ------
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
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)
APAR Error Description / Circumvention
Restore of a spool file should fail if the spool file already
exists on the system.
Spool files saved on an independent auxiliary storage pool
(IASP) are restored to SYSBAS from PDM menu (WRKOBJPDM,
WRKLIBPDM, WRKMBRPDM, or STRPDM) even if they are already
present on IASP.
This will fail the next IASP vary on, with MSGCPD33AA logged for
each duplicated spool file.
CORRECTION FOR APAR 'SE64869' :
PDM is disabling the use of SETASPGRP, and the spooled file
restore code must use SETASPGRP to check for the existence of
duplicate spooled files in the IASPs. Restoring spooled files
to sysbase will now fail with new diagnostic message CPD33AF
"Unable to check for duplicate spooled files on an IASP" if
SETASPGRP is disabled and an IASP is in AVAILABLE status. You
may see multiple CPD33AF messages in the joblog if multiple
output queues are being restored at the same time, or if the
output queue is unusually large.
This same issue affects the CHGSPLFA command when moving a
spooled file from an IASP to sysbase if another IASP is
available. In this case, moving the spooled file will now fail
with a MSGCPF3330 exception "Necessary resource not available"
after the diagnostic MSGCPD33AF.
CIRCUMVENTION FOR APAR 'SE64869' :
THE FOLLOWING ARE SUPERSEDED SPECIAL INSTRUCTIONS. IF THE SUPERSEDED
PTF HAS ALREADY BEEN APPLIED AND ITS SPECIAL INSTRUCTION FOLLOWED,
IT IS NOT NECESSARY TO FOLLOW THAT SPECIAL INSTRUCTION AGAIN.
The recommended way to defer spooled file conversions during an upgrade
from Version 5 is to set the QSPL/QSPLDFRCVN data area value to '1'.
To prevent the converted spooled files from being detached when using
the QSPLDFRCVN data area with a value of '0', this PTF must be applied
to your system prior to creating your install media, or it must be
loaded and applied to the system before the system comes out of
Unless the PTF is applied to your install media, you must perform the
install with the key switch set to "D MANUAL" and at the IPL Options
screen after the first sign-on make sure to change the "Start system to
restricted state" value to 'Y', otherwise QSPRC00001 may remove all the
previous-version job table entries (detach their spooled files) before
you have an opportunity to load and apply the PTF. If you perform an
auto install, the controlling subsystem will start automatically during
the licensed program install step and QSPRC00001 will remove the jobs
before you can apply the PTF.
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.
If you do not wish to change the behavior of the WRKSPLF, WRKOUTQ, and
WRKJOB send options, nothing needs to be done.
To change the "1=Send" option on the WRKSPLF, WRKOUTQ, and WRKJOB
OPTION(*SPLF) panels to use SNDTCPSPLF instead of SNDNETSPLF, add a new
environment variable QIBM_SNDSPLF_OPT with a value of 'TCP'. The
environment variable name and its value must be uppercase, and may be
set at the *SYS level or *JOB, or both. Example:
> ADDENVVAR ENVVAR(QIBM_SNDSPLF_OPT) VALUE(TCP) LEVEL(*SYS)
To change option 1 back to SNDNETSPLF, remove the environment variable,
or change its value to something other than 'TCP'. Example:
> CHGENVVAR ENVVAR(QIBM_SNDSPLF_OPT) VALUE(SNA) LEVEL(*JOB)
> MONMSG MSGID(CPFA981)
The CPYSPLF command now supports copying spooled files into the
integrated file system. The spooled file can optionally be converted
using a workstation customizing object. This allows the spooled file
to be converted to other formats. To convert the spooled files to
Portable Document Format (PDF), you must also install licensed
program 5770TS1 "IBM Transform Services for i" and "Transforms - AFP
to PDF Transform"
To take advantage of this new function, specify the new *TOSTMF
special value on the CPYSPLF TOFILE parameter. The spooled file
will be converted based on the workstation customizing object
specified in the Workstation customizing object (WSCST) parameter
and the output placed in the stream file specified in the To stream
file (TOSTMF) parameter.
To stream file (TOSTMF)
Specifies the stream file where the output data is to be written.
All directories in the path name must exist. New directories are
not created. This parameter must specify a value other than *NONE
if the To data base file (TOFILE) parameter is *TOSTMF.
The output is written to a user-defined physical file. This
value is only valid if the To data base file (TOFILE)
parameter specifies a user-defined physical database file.
Specify the path name for the stream file where the output
data is to be written. This value is only valid if the To
data base file (TOFILE) parameter specifies *TOSTMF.
Note: If the stream file exists, the CCSID associated
with the stream file will not be changed.
For more information on specifying path names, refer to "Object
naming rules" in the CL topic collection in the Programming
category in the IBM i Information Center at
Note: This parameter is Unicode-enabled. See "Unicode
support in CL" in the CL topic collection in the Programming
category in the IBM i Information Center at
http://www.ibm.com/systems/i/infocenter/ for additional
Workstation customizing object (WSCST)
Specifies the workstation customizing object to use to transform
the spooled file output to final form before writing it to a
stream file. If the To data base file (TOFILE) parameter
specifies a physical database file, the WSCST parameter is
ignored. In order to convert a spooled file using the (WSCST)
parameter, the device type (DEVTYPE) of the spooled file must
be *SCS or *AFPDS.
Specifies that no workstation customizing object is to be
If the To data base file (TOFILE) parameter specifies *TOSTMF
and the device type of the spooled file is *AFPDS or *USERASCII,
the spooled file data will be copied directly to the stream file.
If the stream file does not exist, the associated CCSID of the
stream file will be set to 65535.
For other types of spooled files, the spooled file data will
be copied to the stream file using the Control character
(CTLCHAR) parameter to format the data. Lines will be ended
with carriage return and line feed controls to indicate record
boundaries. If the stream file does not exist, a CCSID
obtained from the spooled file attributes will be associated
with the stream file.
If the spooled file has a CHRID attribute other than *DEVD,
the CHRID attribute will be used to select the CCSID to be
associated with the stream file. If the spooled file has a
CHRID attribute of *DEVD, the CCSID of the job which created
the spooled file will be used.
The output is transformed to Portable Document Format (PDF)
before it is written into a stream file. If the stream file
does not exist, the CCSID associated with the stream file
will be set to 65535.
Qualifier 1: Workstation customizing object
Specify the name of the customizing object. When a named
customizing object is used and the stream file does not exist,
the CCSID associated with the stream file will be set to
Qualifier 2: Library
All libraries in the library list for the current thread are
searched until the first match is found.
The current library for the job is used to locate the
customizing object. If no current library entry exists in the
library list, QGPL is used.
Specify the name of the library where the customizing object
Stream file option (STMFOPT)
Specifies whether the copy operation replaces or fails to copy the
records to the stream file if a stream file with the specified
name already exists. If the stream file does not exist, it is
No records are copied and the operation will fail.
The records replace the existing stream file records.
THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.
PTF/FIX NO(S). APAR TITLE LINE
SI60497 IPL-PERFM REDUCE FREQUENCY OF CALLS TO SETPROGRESSSTATUS MAC
SI60497 OSP-PERFM IMPROVE ASP DEVICE VARY-ON PERFORMANCE
SI52003 OSP-F/QSPUPDPQ-MSGMCH3402 during CLROUTQ
SI50842 OSP-MSGCPF33BF-MSGCPF4235 RC5 UNABLE TO CREATE ANY SPOOLED F
SI49390 OSP - Internal Maintenance
SI48186 IPL C9002AAA Collect more data in Spool Init 2 flight record
SI47593 IPL-PERFM SRCD90027C0 PWRDWNSYS QSPRC00001
SI47165 OSP Long delay during IPL at C90029B0
SI47165 OSP-PERFM-IPL STUCK FOR HOURS AT STEP C9002AAA
SI47165 OSP AFTER DELAYED SPOOLED FILE CONVERSION UPON UPGRADING OS,
SI43140 OSP-MSGMCH3601-T/QSPSAVQ WHEN SAVING VERY LARGE OUTQ
SI42292 OSP QSPLMAINT RUNNING LONG TIME AFTER IPL
SI39471 IPL-SRCC9002AAA SPOOL FILE CLEANUP ADDS TO IPL TIME
SI37590 OSP-OTHER-SRCD90027C0-WAIT System job QSPRC00001 not ending
SI37260 OSP MSGCPD33AA WHEN VARYING ON A IASP.
SI36723 OSP-OTHER-F/QDBCNVME-T/QSPFXASP-MSGCPF32A0 Unmonitored durin
SI57312 OSP-MSGCPF4208-F/QWPOERRS-T/USRPGM-RC7 INTERMITTENT FAILURE
SI56003 OSP-PRT Allow CPYSPLF to copy open spooled files
SI54499 OSP-PRT JOB-LEVEL QMAXSPLF
SI54184 OSP-OTHER-INCORROUT SF D JOURNAL ENTRIES DO NOT ALWAYS CONTA
SI52959 OSP-TMPSTGLK-PRT AFPDS SPACE SEGMENTS NOT CLEANED UP
SI50975 OSP-PRT WRKSPLF WRKOUTQ WRKJOB ENHANCEMENT
SI47807 OSP CONTENTION FOR THE SPOOL CONTROL BLOCK OF A QPRTJOB
SI47011 OSP MSGCPF3303 IMMEDIATELY AFTER USE OF QIBM_QCA_RTV_COMMAND
SI45855 OSP MSGCPI33A2 CHANGING PAGE RANGE
SI45855 OSP JOBS IN OUTQ STATUS ARE NOT REMOVED FROM SYSTEM WHEN ALL
SI44645 OSP MSGCPF3303 ON CHGSPLFA AFTER CHGJOB SPLFACN(*DETACH) OF
SI41905 OSP-OTHER-UNPRED IF ALL SPLFS FOR A QPRTJOB HAVE BEEN DELETE
SI44670 OSP-OTHER-T/QSPCLOSE-MSGMCH2605 INTERMITTENT ERROR IN SPOOLE
SI40885 OSP MSGMCH3601 when restoring *SPLF using BRMS in restricted
SI39775 OSP SPOOLED FILES CREATED IN HLD STATUS IN DIFFERENT ORDER S
SI38617 OSP MANY JOBS IN LCKW STATUS WHILE CREATING AND PRINTING SPO
SI43471 OSP-PRT Enhancements to CPYSPLF command
|APAR Fixed..........................||View details for APAR SE64869|
|Superseded by:......................||View fix details for PTF SI65826|
|MRI Feature ........................||NONE|
Was this topic helpful?
26 August 2016