PTF Cover Letter
PTF ( Program Temporary Fixes ) Cover letter
OSP-PRT WRKSPLF WRKOUTQ WRKJOB ENHANCEMENT
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
Customers would like a way to reprogram the "1=Send" option on
WRKSPLF and WRKOUTQ panels to execute SNDTCPSPLF instead of
CORRECTION FOR APAR SE56761 :
The "1=Send" option on the WRKSPLF panel can be changed to use
SNDTCPSPLF by setting a new environment variable
QIBM_SNDSPLF_OPT. Please refer to the PTF coverletter "Special
Instructions" section for more details.
CIRCUMVENTION FOR APAR SE56761 :
Use the QIBM_QSP_SPLF_LSTACT exit point to create your own
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 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.
SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI43471 :
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
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 SE56761|
|Superseded by:......................||View fix details for PTF SI65826|
|MRI Feature ........................||NONE|
Was this topic helpful?
28 October 2013