IBM Support

SI44688 - OSP Asynchronous bring added to SAV command and QsrSave API

PTF Cover Letter


PTF ( Program Temporary Fixes ) Cover letter


Order this fix

Abstract

OSP Asynchronous bring added to SAV command and QsrSave API


Pre/Co-Requisite PTF / Fix List

REQ  LICENSED      PTF/FIX  LEVEL

TYPE PROGRAM  REL  NUMBER   MIN/MAX  OPTION
---- -------- ---  -------  -------  ------
PRE  5770SS1  710  SI44590   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

-----------------------------------------------
OSP Asynchronous bring added to SAV command and QsrSave API

CORRECTION FOR APAR SE49320 :
-----------------------------
A new parameter will be added to the SAV command and a new key
added to the QsrSave API which will specify whether objects
should be asynchronously brought into memory during the save
processing.

Asynchronous brings will only be done when saving objects from
the root ('/'), QOpenSys, and user-defined file systems.


SAV command help text for ASYNCBRING:

Asynchronous bring. Specify whether objects should be
asynchronously brought into memory during the save processing.
Depending on the directory tree structure, the amount of memory
available, and the number of objects which qualify for the save,
asynchronously bringing the objects may improve save
performance.  The best performance improvement may be seen with
a well balanced directory tree in which all objects qualify for
the save.  In situations where a large number of objects reside
in a single directory, few objects qualify for the save, or the
system is memory constrained, performance may degrade with
ASYNCBRING(*YES) specified. The default is *NO. The possible
values are:
*NO  Asynchronous bring is not done.
*YES Asynchronous brings are done.



Save Object (QsrSave) API documentation:

Valid Keys

The following table lists the valid keys for the key field area
of the variable length record. For detailed descriptions of the
keys, see the Field Descriptions.

Some messages for this API refer to parameters and values of the
Save Object (SAV) command. This table can also be used to locate
the key names that correspond to the SAV command parameters. The
field descriptions contain, in addition to detailed
descriptions, the corresponding parameter values.

The object path name key and the device path name key are
required keys. The other keys are optional.

Key Type      Field                   SAV Command Parameter
1   CHAR(*)   Device path name        DEV
2   CHAR(*)   Object path name        OBJ
3   CHAR(1)   Directory subtree       SUBTREE
4   CHAR(1)   System                  SYSTEM
5   CHAR(40)  Change period           CHGPERIOD
6   CHAR(1)   Object precheck         PRECHK
7   CHAR(10)  Target release          TGTRLS
8   CHAR(*)   Update history          UPDHST
9   CHAR(*)   Volume identifier       VOL
10  CHAR(*)   Label                   LABEL
11  BINARY(4) Sequence number         SEQNBR
12  CHAR(7)   Expiration date         EXPDATE
13  CHAR(1)   End of media option     ENDOPT
14  CHAR(1)   Clear                   CLEAR
15  CHAR(1)   Data compression        DTACPR
16  CHAR(1)   Data compaction         COMPACT
17  CHAR(*)   Optical file            OPTFILE
18  CHAR(1)   Save while active       SAVACT
19  CHAR(*)   Save-while-active message queue SAVACTMSGQ
20  CHAR(*)   Output                  OUTPUT, INFTYPE
21  CHAR(1)   Use optimum block size  USEOPTBLK
22  CHAR(1)   Save-while-active option SAVACTOPT
23  CHAR(10)  ASP device name         ASPDEV
24  CHAR(*)   Name pattern            PATTERN
25  CHAR(2)   Scan objects            SCAN
26  CHAR(10)  Synchronization ID      SYNCID
27  CHAR(1)   Private authorities     PVTAUT
>>28 CHAR(1)  Asynchronous bring      ASYNCBRING <<


Field Descriptions

Asynchronous bring. Specify whether objects should be
asynchronously brought into memory during the save processing.
Depending on the directory tree structure, the amount of memory
available, and the number of objects which qualify for the save,
asynchronously bringing the objects may improve save
performance.  The best performance improvement may be seen with
a well balanced directory tree in which all objects qualify for
the save.  In situations where a large number of objects reside
in a single directory, few objects qualify for the save, or the
system is memory constrained, performance may degrade with
Asynchronous bring specified. The default is 0. The possible
values are:
0 Asynchronous bring is not done. (*NO)
1 Asynchronous brings are done. (*YES)

CIRCUMVENTION FOR APAR SE49320 :
--------------------------------
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
--------------  ------------------------------------------------------------
   SI44528      OSP - SAV Perfomance enhancement
   SI43317      OSP-OTHER CPF3710 IS LOGGED WHEN IFS DATA IS RESTORED
   SI41875      OSP-XTND-OTHER-UNPRED SAVES OF THE IFS INCLUDING QNTC WILL S
   SI39662      OSP-OTHER VL10003000 after save/restore operation
   SI41742      OSP-F/QTACJMA-MSGCPF67B3 SAV OR RST COMMAND FAILING WHEN USI
   SI40778      OSP-OTHER-MSGCPF415E SAVING THE IFS IN PARALLEL CAN CAUSE MS
   SI39453      OSP Internal extensions

Summary Information

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


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, 2018 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":"LOB08","label":"Cognitive Systems"},"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:
20 December 2011