OA65224: NEW FUNCTION: CDA API ENHANCEMENTS

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• New Function
  GDKINIT/GDKTERM Application Programming Interfaces introduced
  for CDA Session
  GDKGEN API introduced for generic operation execution.
  GDKVALD API introduced for provider file validation and value
  retrieval.
  GDKQUERY API introduced to allow for query of available
  functionality.
  GDKUTIL is updated to support new OPERATION command, as well as
  new PREFIX and DELIMITER keywords. GDKUTIL is updated to support
  multi-object operations for z/OS UNIX files on UPLOAD and
  DOWNLOAD, as well as objects on DELETE with the REGEX, and TEST
  keywords.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * New Function - z/OS V2R5 and above support                   *
  * for new Application Programming Interfaces,                  *
  * GDKINIT, GDKTERM, GDKGEN, GDKVALD, and                       *
  * GDKQUERY, and new GDKUTIL OPERATION command                  *
  * and new PREFIX and DELIM keywords.                           *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * New Function - GDKUTIL supports a new                        *
  * command, OPERATION, which uses the new                       *
  * GDKGEN API to perform generic                                *
  * operations such as CREATEBUCKET and                          *
  * DELETEBUCKET. GDKUTIL is enhanced to                         *
  * support new keywords PREFIX and DELIM                        *
  * on the LIST command to list objects                          *
  * beginning with a prefix, or objects                          *
  * that share a common name up to a                             *
  * delimiter. GDKUTIL is enhanced to                            *
  * process multiple objects in a single                         *
  * command.                                                     *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  New Function - z/OS V2R5 and above DFSMSdfp CDA is enhanced to
  provide new Application Programming Interfaces (APIs), GDKINIT,
  GDKTERM, GDKGEN, GDKVALD, and GDKQUERY.
  GDKINIT and GDKTERM are used to create a CDA session where
  multiple CDA API calls share the same HTTPS connection.
  GDKGEN is used to perform a named operation from the CDA
  provider file. CREATEBUCKET and DELETEBUCKET are examples of
  operations that can be performed via the GDKGEN API.
  GDKVALD is used to validate and retrieve information from a CDA
  provider file.
  GDKQUERY is used to query the current functionality of DFSMSdfp
  CDA on the current system.
  The GDKWRITE API is enhanced to support multipart uploads for
  the streaming send exit path (GDK_EXIT_DATALOCATION).
  The GDKGET API is enhanced to support a multipart download for
  the streaming receive exit path (GDK_EXIT_DATALOCATION).
  
  The GDKUTIL utility is enhanced to provide a new OPERATION
  keyword to invoke provider file operations such as CREATEBUCKET
  or DELETEBUCKET. The GDKUTIL utility LIST command is enhanced to
  support new PREFIX and DELIM keywords. The GDKUTIL utility is
  additionally enhanced to UPLOAD multiple files from a z/OS UNIX
  directory tree, DOWNLOAD multiple objects to a z/OS UNIX
  directory, and DELETE multiple objects in one command.
  
  Additional problems fixed:
  The GDKUTIL LIST command is enhanced to list all objects within
  a bucket even when there are more than 1000 objects in that
  bucket. The provider file must be updated to include the marker
  URL_PARM object in the requestParameters, as well as the
  partial_list object in the schema object in the MESSAGE_BODY
  object for the responseResults of the LISTOBJECT operation. The
  GDKLIST API has also been updated to retrieve as many results as
  will fit in the list buffer. When the buffer is too small, it
  will be filled as much as possible and GDK_BUFFER_TOO_SMALL will
  be the return code. The calling application may utilize the
  "marker" optional parameter.
  The GDKUTIL GDKU0103I message is updated to display the name of
  the data set or z/OS UNIX file specified on the LOCAL DD
  statement. If the LOCAL DD is an instream DD, it will continue
  to display DD:LOCAL.
  The GDKLIST API Get-Response-Code optional parameter is now
  honored and the HTTP status code is returned.
  The GDKGET API will issue an ERROR message when an invalid
  DATA_LOCATION_TYPE value is passed.
  The GDKWRITE API for a DATA_LOCATION_TYPE of
  GDK_BUFFER_DATALOCATION no longer receives HTTP 411 when a
  binary buffer is passed. The HTTP 411 was received because
  Content-Length was not passed.
  
  Documentation updates are made to the following manuals:
  SA23-1377 - z/OS MVS Programming: Callable Services for High
  Level Languages
  SC23-6864 - z/OS DFSMSdfp Utilities
  SA38-0672 - z/OS MVS System Messages Vol 5 (EDG-GLZ)
  
  To view the PDF documentation changes for this support refer to
  the following website:
  https://public.dhe.ibm.com/eserver/zseries/zos/DFSMS/CDA/OA65224
  
   KEYWORDS: DFSMSCS/K
  

Problem conclusion

Temporary fix

Comments

•  KEYWORDS: DFSMSCS/K
  

APAR Information

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

  OA63892

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

  UJ94995 UJ94996

Modules/Macros

• GDKCSI   GDKTATH  GDKLIST  IBMCOS   GDKRQST  GDKKEYST GDKHTTPU
  GDKGETP  GDKJSONU GDKSYM   GDKUTILJ GDKLXML  GDKAUTH  GDKUTILM
  GDKBASIC GDKROUTR GDKSTUB  GDKKASM  GDKIQRY  GDKMSG   GDKCSS
  GDKFVCON GDKIC    GDKIQRYB GDKAPI   GDKAWS4  GDKOAUTH GDKS3ATH
  GDKCRYPT GDKS3CLD GDKGCP   GDKREX2C GDKAZURE GDKKEY   GDKGCPS3
  GDKB64   GDKCDA   GDKMETA  GDKUTIL  GDKCDAL  GDKCSSNL
  

Fix information

• Fixed component name

  CLOUD DATA ACCE

• Fixed component ID

  5695DF124

Applicable component levels

• R310 PSY UJ94995

     UP24/04/16 P F404

• R250 PSY UJ94996

     UP24/04/16 P F404

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.