SI47243 - OSP-INTSRVSUP-MSGCPF383A RC X'C4C7' Restore Storage Space

TYPE PROGRAM  REL  NUMBER   MIN/MAX  OPTION
---- -------- ---  -------  -------  ------
PRE  5770999  710  MF53609   00/00    0000
PRE  5770999  710  MF53610   00/00    0000
PRE  5770SS1  710  SI43463   00/00    0000



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

-------------------------------------------------
When restoring a network server storage space that was created
prior to V4R4 to system running V6R1 or later release causes the
restore to fail with error message CPF383A error summary code
X'C4C7'.
================================
CPF383A    Diagnostic              40   01/25/12
15:06:35.713288
QSRGENSE     QSYS        *STMT    QUICMENU    QSYS        00C1


From module . . . : QSRIOREQ

From procedure  . :
qsrSendIO_EscapeMsg__FP15qsrIO_Request_TP16qs
IO_Feedback_TPv

Statement   . . . :   311

Message . . . . :   Save or restore ended unsuccessfully.

Cause . . . . . :   The save or restore request ended because
of an
unexpected error. If the error occurred on a specific object,
the
object is /QFPNWSSTG/STGNAME.
Recovery . . . :   Save the information created by the message
and
report the problem (ANZPRB command).

Technical description . . . . .  . . : Error summary code
X'C4C7'.
Device dependent error code X'0000'.

================================

The issue occurs because a storage space created prior to V4R4
uses a file system format named Type-1 BSF (Byte Stream Files).
Starting in V6R1, the restore storage space object handler will
pre-create the storage space being restored using only Type-2
BSF which causes an issue when the Type-1 BSF data is being
written over the pre-created Type-2 BSF storage space.

CORRECTION FOR APAR 'SE52449' :
-------------------------------
The restore object handler will only pre-create a storage space
using Type-2 BSF, so the storage space must be created using
Type-1 BSF before using the RST command.

The PTF associated with this APAR provides a new method to the
serviceability program "QFPHPSF" which will allow a storage
space to be pre-created using Type-1 BSF.  The process to
manually pre-create the storage space and restore from backup is
as follows.
Note:  The storage space name "STGNAME" should be replaced with
the actual storage space name.

1.Delete the incorrect network storage left by the restore
failure.
RMVDIR '/QFPNWSSTG/STGNAME' SUBTREE(*ALL)

2.Call the QFPHPSF serviceability program to pre-create a
storage space with Type-1 stream files.
CALL QFPHPSF PARM(*CRTSTGTY1 STGNAME)

3.Attempt the restore again which will over write the existing
Type-1 files with saved data.

Note: The storage space can only be restored to System ASP, and
it can only be linked to NWSD with type *IXSRV.

CIRCUMVENTION FOR APAR 'SE52449' :
----------------------------------
None.


Activation Instructions


None.




Special Instructions

None.


Default Instructions

THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.



Supersedes

PTF/FIX NO(S).  APAR TITLE LINE
--------------  ------------------------------------------------------------
   SI46627      OSP-INTSRVSUP CPE3029 WHEN ESX STORAGE IS SAVED WHILE ACTIVE
   SI43969      OSP-INTSVRSUP-PERFM Remove duplicate initializing of new NWS
   SI43825      OSP-WINDOWS VOLUME NOT USEABLE AFTER IBM i UPGRADE
   SI43007      OSP-ACTIVE SAVES OF SHARED UPDATE STORAGE ON ESX NWSDS
   SI41708      OSP-OTHER-THREADS-MSGCPDA4C5 COPY OF NWSSTG FOR HOSTED IBM I
   SI41049      OSP-INTSVRSUP COPYING NWSSTG REQUIRES BATCH STATUS MESSAGES
   SI38944      OSP-PARTITION INFORMATION MISSING ON PRE-V5R3 NWSSTG
   SI38111      OSP-NWSSTG SIZE NOT SET CORRECT AFTER RESTORE
   SI37436      OSP-CHGNWSSTG CAUSES DATA LOSS ON A RESTORED STORAGE SPACE
   SI37436      OSP-RESTORED NWS STORAGE SPACE SHOWS 0 BYTE DATA LENGTH

Summary Information

System i Support