Menu principal                 [Fechar]


CICS Manual do Usuário - CHANGE PASSWORD


Volta a página anterior

Volta ao Menu Principal


Desenvolvido por DORNELLES Carlos Alberto - Analista de Sistemas - Brasília DF.

CHANGE PASSWORD

Application Programming Reference

CHANGE PASSWORD

Changes the password that is recorded by a security manager (possibly an EAM) for a specified user ID.

Syntax


CHANGE PASSWORD
 
>>-CHANGE PASSWORD(data-value)--NEWPASSWORD(data-value)--------->
 
>--USERID(data-value)--+----------------------+----------------->
                       '-ESMREASON(data-area)-'
 
>--+--------------------+--------------------------------------><
   '-ESMRESP(data-area)-'
 
 

Conditions: INVREQ, NOTAUTH, USERIDERR

 

Description

Unlike the SIGNON command, CHANGE PASSWORD does not depend upon the principal facility, so it can be issued when the facility is an APPC session.

Attention: Clear the password fields on the EXEC CICS commands that have a password option as soon as possible after use. This action ensures that passwords are not revealed in system or transaction dumps.

Options

ESMREASON(data-area)
Returns the reason code, in a fullword binary field, that CICS receives from the external authentication manager. If the EAM is RACF(R), this field is the RACF reason code.
ESMRESP(data-area)
Returns the response code, in a fullword binary field, that CICS receives from the external authentication manager. If the EAM is RACF, this field is the RACF return code.
NEWPASSWORD(data-value)
Specifies the new password, in eight characters, for the specified user ID. The password is changed only if the current password is correctly specified.
PASSWORD(data-value)
Specifies the current password, in eight characters, for the specified user ID.
USERID(data-value)
Specifies the user ID, in eight characters, of the user whose password is being changed.

Conditions

INVREQ
RESP2 values:

13
An unknown return code exists in ESMRESP from the external authentication manager.

18
The CICS external authentication manager interface is not initialized.

29
The external authentication manager is not responding.

Default action: Terminates the task abnormally.

NOTAUTH
RESP2 values:

2
The supplied password is wrong. If the external authentication manager is RACF, the revoke count that RACF maintains is incremented.

4
The new password is not acceptable.

19
The user ID is revoked.

Default action: Terminates the task abnormally.

USERIDERR
RESP2 values:

8
The user ID is not known to the external authentication manager.

Default action: Terminates the task abnormally.




© Copyright IBM Corp.