set_local_provider

Function

Sets or updates attributes of a local provider. This function invokes the RACF R_Secret callable service.

Requirements

The RACF callable service defines execution environment requirements.

Authorization

RACF enforces authorization. The caller must have sufficient authority to define or modify the provider.

Format

The caller specifies the request as a JSON object. The system passes the request to RACF without modification.

Parameter

key_label

Type: String

Required: Yes

Specifies the ICSF key label used to encrypt secret data. Allowed characters: a-z, A-Z, 0-9, ".", ":", "::", "-".

Note: RACF does not validate the existence of this key label when the system updates the provider.

Usage notes

• Ensure that the key label exists in ICSF before setting secret data.
• Ensure that the key supports encryption operations.
• Define the AES key with an appropriate encryption mode.
• Refer to the z/OS Cryptographic Services ICSF documentation for key creation and management.

Examples

{
  "key_label": "ZSMSECKEY01"
}

Return and reason codes

The RACF callable service returns return codes and reason codes. See the return code reference topic.