Cloud Data Access callable services

The z/OS Cloud Data Access callable services are:

• GDKGET — Retrieve a cloud object
• GDKWRITE — Write an object to cloud storage
• GDKDEL — Delete an object from cloud storage
• GDKLIST — List cloud objects
• GDKMSGTR — Translate a CDA return code into text
• GDKGETP — List cloud providers
• GDKKEYSR — Retrieve cloud credentials
• GDKKEYAD — Store cloud credentials
• GDKKEYDL — Delete cloud credentials
• GDKKEYGR — List resources for provider
• GDKINIT — Initialize a Session
• GDKTERM — Terminate a Session
• GDKGEN — Perform a Configurable request
• GDKVALD — Validate Provider File
• GDKQUERY — Query available CDA functions

All APIs accept a pointer to an optional parameter structure that describe a group of key:value pairs that can be used to modify the processing done by the particular API. The specific keys that are recognized varies per API and are described with each API. The APIs accept a pointer to the GDK_OPTIONAL_PARMS_TYPE structure, or NULL if none are desired. GDK_OPTION_KEY_TYPE is a pointer to character array (char *). GDK_OPTION_VALUE_TYPE is also a pointer to a character array unless the value is expected to be different.

   typedef struct {
     uint32_t GDK_NumberOfOptions;
     GDK_OPTION_TYPE GDK_OptionArray[];
   }   GDK_OPTIONAL_PARMS_TYPE;

   typedef struct { 
     GDK_OPTION_KEY_TYPE GDK_optionKey;
     GDK_OPTION_VALUE_TYPE GDK_optionValue;
   }   GDK_OPTION_TYPE;