SETCLOUD keyword definitions

PROVIDER (provider)
Specifies the global provider name to be used for all storage groups for which there is no provider specified. provider must be 1 to 20 characters in length and must match the name that is defined in a Cloud Data Access (CDA) cloud provider definition file. Valid characters in the provider name are uppercase alphabetic, numeric, @, #, and $. PROVIDER is required if CONTAINER is specified at the global level; otherwise, it is optional. There is no default value.
CONTAINER (container)
Specifies the global container (or bucket) name to be used for all storage groups for which there is no container that is specified. The value for container:
  • Must be from 3 to 63 characters in length.
  • Can only contain characters A-Z, a-z, 0-9, '.' (period), and '-' (hyphen)
  • Is case-insensitive.
Note: The cloud provider might have additional restrictions on the container name, but only the above are validated on the SETCLOUD statement. Refer to information from the cloud provider for the restrictions on the container (or bucket) name. If uppercase letters are specified for this keyword, Cloud Data Access converts the uppercase letters to lowercase.

CONTAINER is required if PROVIDER is specified at the global level; otherwise, it is optional. There is no default value.

Start of changeCDAALTCRED (mode)End of change
Start of changeSpecifies whether the CDA alternative credential function is enabled. If enabled, the alternative cloud credential (which needs to be configured and stored in a Cloud Data Access (CDA) configuration file) is to be used when accessing cloud data. This keyword can be specified at the global level or at the storage group level. Valid values for mode are:
OFF
The CDA alternative credential function is not enabled. The main cloud credential is to be used when accessing cloud data. This is the default.
ON
The CDA alternative credential function is enabled. The alternative cloud credential is to be used when accessing cloud data.
Here is a recommended use case for this keyword. For a SYSPLEX environment that is set up with both DR test systems and production systems and the same OAM cloud provider is shared across systems. One can set up an alternative set of cloud credential with read-only authorization level and program the CBROAMxx member to enable this CDA alternative credential function for the DR test systems. This can prevent the DR test systems accidentally deleting production data.
Note:
  • If the above use case is intended, the display SETCLOUD command should be issued on the DR test system to verify the CDAALTCRED keyword value to be ON after the first OAM initialization.
  • In the above use case, after the CDA alternative credential function is enabled for the DR test system, if the DR test system attempts to delete the production cloud object, the production cloud object will not be deleted but rather become orphaned just to the DR test system.
End of change
STORAGEGROUP (sgname)
Specifies the name of an Object storage group Start of changeor an Object backup storage groupEnd of change which is in the active configuration, and which was previously defined using ISMF. This parameter on the SETCLOUD statement provides additional information beyond what was specified using ISMF for the Object storage group Start of changeor the Object backup storage groupEnd of change in which it pertains.
PROVIDER (provider)
Specifies the wanted cloud provider name. sgprovider must be from 1 to 20 characters in length and must match the name defined in a Cloud Data Access (CDA) cloud provider definition file. Valid characters in the provider name are uppercase alphabetic, numeric, @, #, and $.

There is no default value.

If this keyword is not specified for a given storage group, then the provider for that storage group is set using the PROVIDER set at the global level. PROVIDER is required if CONTAINER is specified for this storage group and PROVIDER is not specified at the global level.

CONTAINER (container)
Specifies the name of the container in which the objects for this storage group are stored. If this keyword is not specified for a given storage group, then the container for that storage group is set using the value set at the global level. The value for sgcontainer:
  • Must be from 3 to 63 characters in length.
  • Can only contain characters A-Z, a-z, 0-9, '.' (period), and '-' (hyphen)
  • Is case-insensitive.
Note: The cloud provider might have additional restrictions on the container name, but only the above are validated on the SETCLOUD statement. Refer to information from the cloud provider for the restrictions on the container (or bucket) name. If uppercase letters are specified for this keyword, Cloud Data Access converts the uppercase letters to lowercase.

If this keyword is not specified for a given storage group, then the container for that storage group is set using the CONTAINER set at the global level. CONTAINER is required if PROVIDER is specified for this storage group and CONTAINER is not specified at the global level.