AAL2ChangeStaticPasswordICSF

Function prototype (aal2sdk.h)

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

COBOL calling convention

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