IBM Support

SI46442 - CCA CSNDDSG return reason codes 8/95 using key labels

PTF Cover Letter


PTF ( Program Temporary Fixes ) Cover letter


Order this fix

Abstract

CCA CSNDDSG return reason codes 8/95 using key labels


Pre/Co-Requisite PTF / Fix List

REQ  LICENSED      PTF/FIX  LEVEL

TYPE PROGRAM  REL  NUMBER   MIN/MAX  OPTION
---- -------- ---  -------  -------  ------
PRE  5770999  710  MF99001   00/00    0000
DIST 5733CY3  710  SI43664   NONE     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

-----------------------------------------------
Return code 8 and reason code 95 is returned from the CSNDDSG
API when using a key label and the job is logged on to a 4765
cryptographic coprocessor.

CORRECTION FOR APAR SE51558 :
-----------------------------
Requests to the card are protected by a MAC.  If key labels are
used, the key label in the request is replaced by the actual key
token.  This invalidates the MAC.  The MAC will now be
calculated after the key labels are replaced.

CIRCUMVENTION FOR APAR SE51558 :
--------------------------------
None.


Activation Instructions


None.




Special Instructions


********************************************************************
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 SI45912 :
=================================================

If there is at least one 4765 Cryptographic Coprocessor installed, load
and apply PTF SI43664.

Run the following command to determine if any jobs are currently using
any cryptographic coprocessor (4758, 4764, or 4765):

WRKCFGSTS *DEV *CRP

If there are any jobs currently using a cryptographic coprocessor, end
them and then start them again after applying this PTF (SI45912).

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI40203 :
=================================================

If you do not currently have a 4764 Cryptographic Coprocessor installed
or do not have any AES keystore files created, nothing further needs to
be done.

This PTF introduces a format change to AES keystore files used with the
4764 cryptographic coprocessor.  Existing AES keystore files will be
unusable until they are converted.  Operations using the old format
keystore files will fail with either return/reason codes 12/197 or
return/reason codes 8/6009.  A migration utility program is
provided to convert your existing AES keystore files to the new format.

Before using the the migration utility program, it is recommended that
you save a backup copy of each AES keystore file.

To convert AES keystore files, use the following command:

CALL QCCA/QC6UPDAES PARM('FILENAME' 'LIBNAME')

where FILENAME is the name of an AES keystore and LIBNAME is the
name of the library in which the file is stored.

Run this command for each AES keystore file on the system.

If this PTF is removed, delete the converted AES files and restore the
backed up copies.

DES and PKA keystores are unaffected by this PTF.


Default Instructions

THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.



Supersedes

PTF/FIX NO(S).  APAR TITLE LINE
--------------  ------------------------------------------------------------
   SI45912      CCA - CSNDPKX fails with return reason code 8/72 for ECC key
   SI43428      CCA Key_Storage_Designate (CSUAKSD) fails with 8/752
   SI42111      CCA enable future enhancement
   SI40203      CCA Add support for the 4765 cryptographic coprocessor

Summary Information

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


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 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.

[{"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":""}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG16D","label":"PTF Cover Letters - IBM i 7.1 environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"V7R1M0","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
06 April 2012