OSI/MHS Management Programming Manual

Password Server Interfaces
OSI/MHS Management Programming Manual—424824-001
7-18
Error Handling
In the event of a process failure, retry the command to make sure the request succeeded.
In the case of an MS register command, retry with the old password and then with the
new password.
Note that within the tokens of the MS password server interface, those data fields that
are shorter than the maximum length may not have valid data in the unused portion of
the field. Use the associated length field to determine how much of the field contains
valid data.
Appendix C, Examples
, contains an example of a password server that uses the MS
password server programmatic interface.
Error Handling
This section describes the error-handling procedures for the MS process and the MHS
manager process when they interface with the MS password server.
MS Process Error-Handling Actions
The MS process issues the ZMHS-VAL-PASSW-MS-BIND command to the password
server when an MS APPL object attempts to bind with the MS and the use of the MS
bind password server is configured for that MS. If there are no problems
communicating with the MS bind password server, and no error responses are returned
by the server, then association establishment proceeds normally and no EMS events are
generated.
The EMS events that can be generated if errors occur are listed in Table 7-6
.
password server when an MS APPL object attempts to use the register-MS service and
the use of the MS password server is configured for that MS. If there are no problems
communicating with the MS password server and no error responses are returned by the
server, then a result indicating the success of the register-MS operation is returned to the
MS APPL object.
The EMS events that can be generated if errors occur are listed in Table 7-7
.
Table 7-6. OSI/MHS Event Messages, MS Password Server Interface—MS Bind
Event
Number
Symbolic Name
(ZMHS-EVT-) Description
12 IO-ERR If the MS process cannot communicate with the
password server process, then this event is generated,
specifying the name of the password server process,
and a bind error is returned to the MS APPL object.
19 INVALID-PASSWORD If an error response is received back from the password
server, then this event is generated and a bind error is
returned to the MS APPL object.