--- title: "AAL2ChangeStaticPasswordICSF" slug: "a3s-cppprg-icsf-zos-aal2changestaticpasswordicsf-4-0" updated: 2026-11-11T10:02:33Z published: 2026-11-11T10:02:33Z canonical: "docs.onespan.com/a3s-cppprg-icsf-zos-aal2changestaticpasswordicsf-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. # AAL2ChangeStaticPasswordICSF ## Function prototype (aal2sdk.h) ```cpp aat_int32 AAL2ChangeStaticPasswordICSF ( TDigipassBlob* DPBlob, TKernelParms* CallParms, aat_ascii* aStorageKeyNameIn, aat_ascii* aInitialVectorIn, aat_ascii* NewStaticPassword1, aat_ascii* NewStaticPassword2); ``` ## Description This function is used with a Digipass authenticator that can use static passwords (e.g. Digipass GO 3). It allows administrators to provide a new static password on a mandatory basis. As this function is critical, only an authenticated user may use it in a regular integration. ## Parameters | Type | Name | Use | Description | | --- | --- | --- | --- | | TDigipassBlob * | DPBlob | I/O | 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. | | aat_ascii * | NewStaticPassword1 | I | First entry of the password change trial. Up to 8 printable ASCII-EBCDIC invariant characters. Must be null-terminated. For a list of the characters that can be used for the new static password, see [Supported new static password charset](/secsdks/docs/a3s-cppprg-aal2changestaticpassword-4-0#supported-new-static-password-charset). | | aat_ascii * | NewStaticPassword2 | I | Second entry confirmation of the password change trial. Must be identical to NewStaticPassword1. | ## COBOL calling convention ```custom Entry point: AA2CSPIC 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-OLDPIN PIC X(9). 02 W-NEWPIN PIC X(9). 02 W-RETURN PIC S9(8) USAGE BINARY. 02 W-API-NAME PIC X(8) VALUE 'AA2CSPIC'. . . . CALL W-API-NAME USING BY REFERENCE W-BLOB BY REFERENCE W-KERNELPARMS BY REFERENCE W-STORAGEKEY BY REFERENCE W-INITVECTOR BY REFERENCE W-OLDPIN BY REFERENCE W-NEWPIN RETURNING W-RETURN. ``` ## Return codes | Code | Meaning | Code | Meaning | | --- | --- | --- | --- | | 0 | Success | 805 | Password not equal | | 130 | Invalid response pointer | 900 | Invalid session context handle | | 412 | Invalid checksum (software) | 908 | HSM key not found | | 413 | Invalid Base64 format | 951 | Invalid HSM key type for HSM decryption | | 414 | Invalid checksum (HSM) | 1000 | Function does not support EMV-CAP | | 510 | Invalid Digipass data pointer | 1103 | Unlock Version 2 not supported | | 801 | Static password not supported | 1118 | Unsupported BLOB | | 803 | New password too short | -1501 | Memory allocation failed | | 804 | New password too long | | |