OA65990: NEW FUNCTION - DFSMSdfp CDA Enhancements

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• NEW FUNCTION - DFSMSdfp CDA Enhancements
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: New Function - DFSMSdfp CDA Enhancements     *
  *                 A new AMODE31 C language DLL for all         *
  *                 DFSMSdfp CDA APIs is available.              *
  *                 A new AMODE64 C language DLL with            *
  *                 credential management JSON APIs is           *
  *                 available on z/OS 3.1.                       *
  *                 A new CDA metadata variable, GDK_SECONDARY,  *
  *                 is available to resolve the secondary        *
  *                 allocation for data sets during GDKWRITE.    *
  *                 A new optional parameter, logOutput, is      *
  *                 recognized for directing CDA logging to      *
  *                 other than stderr/DD:SYSOUT.                 *
  *                 A new optional parameter, localCodePage,     *
  *                 is recognized for overriding the default     *
  *                 local code page of IBM-1047 when performing  *
  *                 text conversion.                             *
  *                 A new optional parameter, remoteCodePage,    *
  *                 is recognized for overriding the default     *
  *                 remote code page of IS08859-1 when           *
  *                 performing text conversion.                  *
  *                 A new optional parameter, keyFile, is        *
  *                 recognized allowing the keyfile contents     *
  *                 to be passed in rather than read from        *
  *                 the UNIX file.                               *
  *                 A new optional parameter, providerFile, is   *
  *                 recognized, allowing the provider file       *
  *                 contents to be passed in rather than read    *
  *                 from the UNIX file named by the provider     *
  *                 name on the API invocation.                  *
  *                 The GDKUTIL JCL utility accepts a new        *
  *                 command, CREDENTIALS, with sub-parameters    *
  *                 (ADD|DELETE|LIST).                           *
  *                 The GDKUTIL JCL utility will recognize a     *
  *                 new DD named OBJNAMEX, which allows for      *
  *                 the name of the object to be spread across   *
  *                 multiple lines or records on the DD          *
  *                 statement.                                   *
  *                 The GDKUTIL JCL utility will recognize       *
  *                 additional sub-keywords on the CONVERT       *
  *                 keyword for the UPLOAD and DOWNLOAD          *
  *                 commands. The subkeywords identify the       *
  *                 code page or CCSID name for the local        *
  *                 and remote code pages when converting the    *
  *                 text.                                        *
  ****************************************************************
  * PROBLEM DESCRIPTION: New Function - DFSMSdfp CDA             *
  *                      Enhancements.                           *
  *                      Callers of DFSMSdfp CDA APIs wanted to  *
  *                      direct logging output to a specific     *
  *                      place.                                  *
  *                      Callers of DFSMSdfp CDA APIs wanted to  *
  *                      override the default local and remote   *
  *                      code pages when requesting text         *
  *                      conversion.                             *
  *                      Callers of DFSMSdfp CDA APIs wanted to  *
  *                      avoid reading the keyfile and provider  *
  *                      file for each API call.                 *
  *                      The secondary allocation of a data set  *
  *                      was not one of the data set attributes  *
  *                      that was resolved for metadata values.  *
  *                      Language Environment C callers of the   *
  *                      CDA APIs wished to have a more direct   *
  *                      method of calling.                      *
  *                      Language Environment C callers wanted   *
  *                      to be able to stay in AMODE64 while     *
  *                      calling credential management APIs      *
  *                      with a JSON input and output            *
  *                      interface.                              *
  *                      GDKUTIL users wanted a method to        *
  *                      perform credential management via JCL.  *
  *                      GDKUTIL users wanted a method to        *
  *                      specify an object name in an            *
  *                      in-stream DD that was longer than 80    *
  *                      characters.                             *
  *                      GDKUTIL users wanted a method to        *
  *                      override the default local and remote   *
  *                      code pages when the CONVERT keyword     *
  *                      is specified.                           *
  ****************************************************************
  New Function - DFSMSdfp CDA has been enhanced to support an
  AMODE31 DLL for Language Environment C callers of all CDA APIs.
  The GDKDLL31 dynamic load library is delivered into
  SYS1.SIEALNKE.
  The GDKDLL31 side file is delivered into SYS1.SIEASID.
  z/OS 3.1 DFSMSdfp CDA has been enhanced to provide an AMODE64
  DLL for Language Environment C callers of new JSON APIs for
  credential management.
  The GDKDLL64 dynamic load library is delivered into
  SYS1.SIEALNKE.
  The GDKDLL64 side file is delivered into SYS1.SIEASID.
  DFSMSdfp CDA now supports a new metadata variable named
  GDK_SECONDARY for both GDKWRITE API callers, as well as GDKUTIL
  users.
  DFSMSdfp CDA supports a new optional parameter, logOutput, on
  all CDA API calls. The value is expected to be a string
  conforming to the name requirements for the fopen() function.
  z/OS UNIX filenames, z/OS Data Sets, or DD names may be passed.
  
  DFSMSdfp CDA supports a new optional parameter, localCodePage,
  on the GDKGET and GDKWRITE CDA API calls. The value is expected
  to be a string that matches the name of a code page or CCSID
  accepted by the iconv() function. This code page name will be
  used as the local code page when performing text conversion.
  
  DFSMSdfp CDA supports a new optional parameter, remoteCodePage,
  on the GDKGET and GDKWRITE CDA API calls. The value is expected
  to be a string that matches the name of a code page or CCSID
  accepted by the iconv() function. This code page name will be
  used as the remote code page when performing text conversion.
  
  GDKUTIL accepts a new CREDENTIALS command with sub-parameters,
  ADD, DELETE, and LIST. The ADD sub parameter requires a new DD
  named CREDSNAM, which contains the name of a UNIX file or data
  set which holds a JSON document containing the credentials to
  be added. A new ZUSERID keyword allows for the credentials to
  be saved for a user other than the current JCL job userid.
  
  GDKUTIL will recognize the OBJNAMEX DD statement which allows
  the object name to be split across multiple lines or records.
  
  The GDKUTIL CONVERT keyword will additionally accept sub-
  parameters that are the names of the local and remote code
  pages to be used when performing text conversion. i.e.
  CONVERT(IBM-278,ISO8859-1)
  
  MVS Programming: Callable Services for High Level Languages
  SA23-1377
  DFSMSdfp Utilities
  SC23-6864
  MVS System Messages Volume 5 (EDG - GLZ)
  SA38-0672-60
  
  To view the PDF documentation changes for this support refer to
  the following website:
  https://public.dhe.ibm.com/eserver/zseries/zos/DFSMS/CDA/OA65990
  
  KEYWORDS: DFSMSCS/K
  

Problem conclusion

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UJ96280 UJ96281

Modules/Macros

• GDKAPI   GDKAUTH  GDKAWS4  GDKAZURE GDKB64   GDKBASIC GDKCDA
  GDKCDAL  GDKCOP24 GDKCRYPT GDKDLL31 GDKDLL64 GDKGETP  GDKHTTPU
  GDKIC    GDKIQRY  GDKIQRYB GDKJSONU GDKKEY   GDKKEYST GDKLIST
  GDKLJSN  GDKLXML  GDKMETA  GDKMSG   GDKOAUTH GDKREGEX GDKROUTR
  GDKRQST  GDKS3ATH GDKSYM   GDKTATH  GDKUTIL  GDKUTILJ GDKUTILM
  GDKXML   IBMCOS
  

Fix information

• Fixed component name

  CLOUD DATA ACCE

• Fixed component ID

  5695DF124

Applicable component levels

• R250 PSY UJ96281

     UP24/11/19 P F411  

• R310 PSY UJ96280

     UP24/11/19 P F411  

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.