Spooled Files Fail with Message CPA3388 RC4 after Upgrading to R530 or R540 i5/OS

Technote (troubleshooting)


Problem(Abstract)

This document discusses a problem where certain spooled files fail with message CPA3388 RC4 after upgrading to V5R3M0 (R530) or V5R4M0 (R540) IBM i5/OS.

Resolving the problem

Certain spooled files can fail with message CPA3388 - Attributes of file &4 not supported for device &9 and return code 4 (RC4) after upgrading to V5R3M0 (R530) or V5R4M0 (R540) IBM i5/OS. RC4 indicates that special device requirements of the file are not supported on the device.

This problem is caused by using the Character Size (CHRSIZ) DDS keyword when generating a spooled file with the Printer device type (DEVTYPE) parameter set to *SCS. According to the AS/400 DDS Reference, the Character Size (CHRSIZ) DDS keyword "is valid only for IPDS printers and only for printer files with device type *IPDS and *AFPDS." Therefore, use of the CHRSIZ DDS is not valid when the printer file has device type *SCS specified.

Prior to V5R3M0 i5/OS, the CHRSIZ DDS keyword was ignored for *SCS spooled files, except when generating the spooled file on a DBCS-capable system, in which case a Set Font Size Scaling (SFCC) SCS command was inserted in the data stream. The SFCC command is understood only by printers emulating a D/T5553 and by some DBCS host print transforms, but not by non-DBCS capable printers and host print transforms.

A design change was made in V5R3M0 i5/OS to allow the CHRSIZ DDS keyword even in *SCS spooled files and to place a Set Font Size Scaling (SFCC or X'2BFD0402') SCS command into the spooled file. However, this command is still honored only by DBCS-capable printers and a few Manufacturer type and model (MFRTYPMDL) settings within Host Print Transform (HPT) that support DBCS printing (such as *HPDBCS). If the SFCC command is sent to a non-DBCS printer or if a MFRTYPMDL settings that does not support DBCS printing is used, then the spooled file will fail to print and message CPA3388 RC 4 will be issued. For more information on this design change, refer to APAR SE17822 OSP-DDS-PRT CHRSIZ WITH DEVTYPE(*SCS) DOES NOT WORK R530.

The recommended way to resolve this problem is to change the data description specifications (DDS) source code for the *SCS printer file to remove or comment out the use of the Character Size (CHRSIZ) DDS keyword, then use the Create Printer File (CRTPRTF) command to re-create the *SCS printer file.

Circumvention for When the Printer File Cannot Be Changed (or Until the Printer File Can Be Changed)

There is a way to circumvent the design change made in V5R3, but this is only recommended when the printer file cannot be changed because the DDS source code is no longer available or because the printer file is shipped with a third-party application. The circumvention can also be used when the printer file is shipped with a third-party application and the third-party vendor cannot provide a new printer file right away.

The first step to circumventing the design change is to download and apply R530 PTF SI25129 or R540 PTF SI25473. Once the appropriate PTF has been applied, follow the Special Instructions in the PTF cover letter, or use the following instructions, to create and setup the QPRTVALS data area in the QUSRSYS library. These instructions will cause the i5/OS Spool function to create the *SCS spooled file using the old behavior of ignoring the CHRSIZ DDS keyword.

Note: If running 6.1 (V6R1M0 or R610) or 7.1 (V7R1M0 or R710) i5/OS, then no PTF is required to use the PRTVALS data area to have the i5/OS Spool function ignore the CHRSIZ DDS keyword when creating *SCS spooled files.

The following steps can be used to create and setup the QUSRSYS/QPRTVALS data area:

1. Determine if the data area called QUSRSYS/QPRTVALS exists on your system by using the following Display Data Area (DSPDTAARA) command:

DSPDTAARA DTAARA(QUSRSYS/QPRTVALS)

Press the Enter key.
2. o If the QPRTVALS data area does not exist, use the following Create Data Area (CRTDTAARA) command to create the data area and to place a 'Y' character (indicating "YES") in the seventh byte of the data area:

CRTDTAARA DTAARA(QUSRSYS/QPRTVALS) TYPE(*CHAR) LEN(256) VALUE('NNNNNNY')

Press the Enter key.

o If the QPRTVALS data area already exists, use the following Change Data Area (CHGDTAARA) command to place a 'Y' character (indicating "YES") in the seventh byte of the data area:

CHGDTAARA DTAARA(QUSRSYS/QPRTVALS (7 1)) VALUE('Y')

Press the Enter key.
3. Use the following Change Object Owner (CHGOBJOWN) command to ensure that the QPRTVALS data area is owned by the QSYS user profile:

CHGOBJOWN OBJ(QUSRSYS/QPRTVALS) OBJTYPE(*DTAARA) NEWOWN(QSYS) CUROWNAUT(*SAME)

Press the Enter key.
Note: If this change causes any other issues, or if the DDS source code is later changed to remove or comment out the use of the CHRSIZ DDS keyword, then the QPRTVALS data can be changed to deactivate the special handling of the CHRSIZ DDS keyword. This can be done by using the following Change Data Area ( CHGDTAARA) command:

CHGDTAARA DTAARA(QUSRSYS/QPRTVALS (7 1)) VALUE('N')

Press the Enter key.

References

For additional information, refer to the following publication:

iSeries Programming DDS for Printer Files, Version 5 Release 4, which is available at the following Web site:

http://publib.boulder.ibm.com/infocenter/iseries/v5r4/topic/rzakd/rzakd.pdf

For additional information, refer to the following APARs and PTFs:

APAR SE26699, OSP-MSGCPF5261-PRT RC10050228 USING DEVTYPE(*SCS) AND CHRSIZ
R540 PTF SI25473 (C7107540)

Historical Number

433661364

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

IBM i
Print

Software version:

5.3.0, 5.3.5, 5.4.0, 5.4.5, 6.1, 6.1.0, 6.1.1, 7.1, 7.1.0, Version Independent

Operating system(s):

IBM i

Reference #:

N1014639

Modified date:

2012-09-28

Translate my page

Machine Translation

Content navigation