IBM Support

SI61295 - OSP SPOOL FILES SAVED ON IASP ARE RESTORED TO SYSBAS FROM PD

PTF Cover Letter


PTF ( Program Temporary Fixes ) Cover letter


Order this fix

Abstract

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

-------------------------------------------------
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' :
----------------------------------
None.


Activation Instructions

None.




Special Instructions

********************************************************************
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
restricted state.

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.

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

path-name
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
http://www.ibm.com/systems/i/infocenter/.

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

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.

*NONE
Specifies that no workstation customizing object is to be
used.

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.

*PDF
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
name
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
65535.

Qualifier 2: Library
*LIBL
All libraries in the library list for the current thread are
searched until the first match is found.

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

name
Specify the name of the library where the customizing object
is located.

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

*NONE
No records are copied and the operation will fail.

*REPLACE
The records replace the existing stream file records.


Default Instructions

THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.



Supersedes

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
   SI42535      OSP-MSGMCH3601-T/QSPSAVQ
   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

Summary Information

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


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.

[{"Type":"MASTER","Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.1.0"},{"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":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
26 August 2016