Previous Topic: Alternate Userid DiagnoseNext Topic: Security Diagnose - Return CA Top Secret Server Userid

Security Diagnose Subfunctions › Security Diagnose - Logon Password Verification

Security Diagnose - Logon Password Verification

The Security Diagnose (X'A0') provides Logon Password Verification (subcode X'04'). This diagnose is used by application programs or multiuser service machines to verify the identity of the user. (Password verification refers to the user, not the issuer.)

This diagnose verifies the appropriate password required by the user to log on to the system (not specifically CA Top Secret or CP Directory), and is dependent upon:

Password violation counts are controlled by PTHRESH if this function is executed with an incorrect password.

The Logon Password Verification function is defined as follows:

CA Top Secret permission to DIAG(A0) ACTION(VMPRIV)

Rx = Address of parameter list. It must be double word aligned and cannot cross a page boundary.

Ry = X'04' subcode

Logon Password Verification Parameter List

Position

Length

Explanation

0(0)

8

The target userid of the password query

8(8)

8

The password that is to be verified

Logon Password Verification Return Codes

X'04'

ACID not defined to CA Top Secret (FAIL mode) or user not defined in CP Directory (WARN/DORM mode with NOWARNPW/NODORMPW attribute only)

X'08'

Password invalid

X'0C

Password correct, but expired

X'18

Failed by Installation Exit

X'1C

ACID suspended, expired, or inactive

X'20'

CA Top Secret inactive