SI66881 - OSP-MEDIA-TAPE SETTAPCGY TGTCGY ENHANCEMENTS

TYPE PROGRAM  RELEASE   NUMBER   MIN/MAX  OPTION
---- -------- --------- -------  -------  ------
DIST 5770SS1  V7R3M0    SI66907   NONE     0013



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

-----------------------------------------------
The SETTAPCGY command needs to be enhanced to allow more control
over when a cartridge is moved to the target category.

CORRECTION FOR APAR SE68815 :
-----------------------------
The SETTAPCGY command has been changed to allow for more control
over when a cartridge is moved to the target category.

CIRCUMVENTION FOR APAR SE68815 :
--------------------------------
None.


Activation Instructions


None.




Special Instructions


The SETTAPCGY command has been changed to add a new TGTCGYOPT parameter
to control when a cartridge will be moved to the target category if it
is different from the mounted category.

Option
'*MOUNT' - (Default) Category changed when cartridge mounted.
'*UNLOAD' - Category changed when cartridge unloaded.
'*EOV' - Category changed when end of volume is reached.

The QTARDSTS API has been changed to add a new field at the end of the
device information.

Offset (Dec) 90
Offset (Hex) 5A
Type         CHAR(1)
Field        Target category option

Target category option. Indicates when the target category will be
changed for a cartridge mounted during the mounted category session.
Possible values follow:
'0' - When the cartridge is mounted.
'1' - When the cartridge is unloaded.
'2' - When the cartridge encounters end of volume.


Default Instructions

THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.



Supersedes

PTF/FIX NO(S).  APAR TITLE LINE
--------------  ------------------------------------------------------------
   SI59228      OSP-MEDIA-TAPE-MSGCPF415E PARALLEL SAVE/RESTORE
   SI65193      OSP-MEDIA-TAPE-MSGCPF9E1F
   SI60331      OSP-MEDIA-TAPE-MSGCPF41B0 TAPE IMGCLG
   SI65971      OSP-MEDIA-TAPE WRONG DATA DISPLAYED FOR DSPTAP

Summary Information

IBM i Support