Changing RACF passwords by using client messages

When IMS Connect is configured to call RACF® directly, users of the user message exit routines HWSSMPL0, HWSSMPL1, and HWSJAVA0 can change RACF passwords by submitting a client message that includes a password change request keyword.

To enable this feature, you must bind the HWSPWCH0 object code with the user message exit routine you are using. The HWSPWCH0 object code is stored in the IMS.ADFSLOAD member of the distribution library.

The password change request keyword must appear at the beginning of the application data section of the message and be followed by a blank, the old password, the new password, and the new password again.

For example, for the HWSSMPL0 and HWSSMPL1 user message exit routines, a password change request message has the following format:

llllIRMllzzHWSPWCH old-password/new_password/new_password|llzz

For the HWSJAVA0 user message exit routine, a password change request message has the following format:

llllIRMOTMALLzzHWSPWCH old_password/new_password/new_password|llzz

The password change request keyword that is defined in the sample user message exit routines is HWSPWCH. You can change this keyword by modifying the user message exit routine. Any password change request keyword that you define must be followed by a blank as a delimiter.

IMS Connect returns a response message to the client application in one of the following formats:

For the user message exit routine HWSSMPL0, the format is:
```
llzzmessage_textCSMllzz
```
For the user message exit routine HWSSMPL1, the format is:
```
llllmessage_textCSMllzz
```
For the user message exit routine HWSJAVA0, the format is:
```
llllOTMAheadermessage_textllzz
```

The communication sequence for a password change request is:

Procedure

Connect.
Send the password change request.
Receive message HWSC00xxy, where xx is the final two digits of the message number and y is the message type identifier.
If you are using HWSSMPL0 or HWSSMPL1, the user-written client application receives the message HWSC00xxy appended with *CSMOKY*.
If you are using HWSJAVA0, the IMS TM Resource Adapter client application receives the HWSC00xxy message in the application data portion of the OTMA header and the appropriate return and reason codes in the user data portion of the OTMA header.