--- title: "AAL2ResetStaticPasswordICSF" slug: "a3s-cppprg-icsf-zos-aal2resetstaticpasswordicsf-4-0" updated: 2026-11-11T09:54:58Z published: 2026-11-11T09:54:58Z canonical: "docs.onespan.com/a3s-cppprg-icsf-zos-aal2resetstaticpasswordicsf-4-0" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.onespan.com/llms.txt > Use this file to discover all available pages before exploring further. # AAL2ResetStaticPasswordICSF ## Function prototype ```cpp aat_int32 AAL2ResetStaticPasswordICSF ( TDigipassBlob* DPBlob, TKernelParms* CallParms, aat_ascii* aStorageKeyNameIn, aat_ascii* aInitialVectorIn); ``` ## Description This function extends the AAL2ResetStaticPasswordHSM and allows the integrator to address the HSM storage key by name and specifying an initial vector. The initial vector is used during the 3DES/AES decryption/encryption of the sensitive data of the authenticator application BLOB. The reset static password on the HSM has the same functionality as the Authentication Suite Server SDK standard API AAL2ResetStaticPassword(). For information about this functionality, refer to the [Authentication Suite Server SDK C-C++ Programmer's Guide](/secsdks/docs/a3s-cpp-programmers-guide-4-0). ## Parameters > The memory management of the output parameters must be performed by the calling function. | Type | Name | Use | Description | | --- | --- | --- | --- | | TDigipassBlob * | DPBlob | I/O | The authenticator application BLOB. | | TKernelParms * | CallParms | I | Structure of runtime parameters to use during this function call. | | aat_ascii * | aStorageKeyNameIn | I | String of up to 64+1 characters, left-justified, null-terminated, or right-padded with spaces. This is the label of the HSM storage key used to encrypt the sensitive authenticator application BLOB data. | | aat_ascii * | aInitialVectorIn | I | String of 16 or 32 hexadecimal characters, left-justified, null-terminated. This is the initial vector used to encrypt the sensitive authenticator application BLOB data. | ## COBOL calling convention ```custom Entry point: AA2RSPIC 02 02 W-BLOB PIC X(248). 02 W-KERNELPARMS. 03 W-PARMCOUNT PIC 9(8) USAGE BINARY. 03 W-PARM01 PIC 9(8) USAGE BINARY. . . . 03 W-PARM19 PIC 9(8) USAGE BINARY. 02 W-STORAGEKEY PIC X(65). 02 W-INITVECTOR PIC X(17). 02 W-RETURN PIC S9(8) USAGE BINARY. 02 W-API-NAME PIC X(8) VALUE 'AA2RSPIC'. . . . CALL W-API-NAME USING BY REFERENCE W-BLOB BY REFERENCE W-KERNELPARMS BY REFERENCE W-STORAGEKEY BY REFERENCE W-INITVECTOR RETURNING W-RETURN ``` ## Return codes | Code | Meaning | Code | Meaning | | --- | --- | --- | --- | | 0 | Success | 806 | Static password change not supported | | 133 | Invalid RandomNumber pointer | 900 | Invalid session context handle | | 134 | Invalid UnlockCode pointer | 908 | HSM key not found | | 138 | Unlock function not supported | 951 | Invalid HSM key type for HSM decryption | | 412 | Invalid checksum (software) | 1000 | Function does not support EMV-CAP | | 413 | Invalid Base64 format | 1103 | Unlock Version 2 not supported | | 414 | Invalid checksum (HSM) | 1118 | Unsupported BLOB | | 510 | Invalid Digipass data pointer | -1501 | Memory allocation failed |