Web Express Logon client-side messages
When an unexpected problem occurs during the Web Express Logon
process, the Z and I Emulator for Web client provides information about the
problem to the user by displaying a panel with an informational message.
Each of these messages contain an error code that you can use as a
unique identifier for the problem that is occurring. The following
is a list of all Web Express Logon messages for the Z and I Emulator for Web client.
- WELM001: Message key not found: status = value
- This message should only be seen in the event of an error found in a custom plug-in. If you have customized the Web Express Logon credential mapper framework, you can create user defined error codes. If the Web Express Logon credential mapper returns such a code, this message will be displayed.
- WELM002: No suitable Host credential plug-in found
- This message is displayed when there is no appropriate credential plug-in found to handle the Z and I Emulator for Web client's credential request. Verify that your Web Express Logon credential mapper application is properly configured to handle the Z and I Emulator for Web client's session type.
- WELM003: Invalid network user ID
- The Web Express Logon credential mapper cannot acquire the user's network ID. This can be caused by improper settings in the network security plug-in section of the CMS configuration. If the local operating system identification is being used to identify the user, make sure this option is selected in the Express Logon section of the Session Configuration panel.
- WELM004: Invalid Application ID
- This message indicates the lack of a valid Application ID. You specify the Application ID when you create the Web Express Logon macro. When you create the macro, be sure that you enter the proper value for the Application ID.
- WELM005: Invalid server address
- This message indicates the lack of a valid server address. The server address is specified as the Destination Address on the Session Configuration panel. For some credential plug-ins, this is a required parameter.
- WELM006: Could not connect to database
- This problem can be generated by an improperly configured database link. Please verify that the database is properly configured in your CMS configuration. If the configuration information looks correct, you should independently verify the database's availability and running status. The database's configuration and management tools are a good place to perform this test.
- WELM007: A matching user ID not found in database
- The credential plug-in is not able to find a match for the user's host ID, given the search criteria. Verify that the user's host ID is specified in the database or other storage medium used by the credential plug-in. In addition, you may want to enable server-side logging and verify that the parameters being sent to the CMS are correct.
- WELM008: The Credential Mapper Servlet reported an exception while processing a credential request. Please see the server log for details.
- This generalized message is a result of an exception occurring on the CMS. Please follow the instructions for enabling server-side logging for more information about the cause of this problem.
- WELM009: Invalid User ID
- A credential plug-in does not have a valid user's host ID. For some plug-ins, the host ID is used to obtain a temporary passticket credential to access the host. If the value used is not appropriate, this message is generated. You may want to verify the user's host ID is specified in the database or other storage medium used by the credential plug-in. In addition, you may want to enable server-side logging and verify that the parameters being sent to the CMS are correct.
- WELM010: Passticket could not be obtained
- This message is displayed when a credential plug-in receives an error during the passticket creation process. Typically, the actual creation of the passticket occurs in a process outside of the credential plug-in. If that external process returns an error, this message displays. You should enable server-side logging and perform the credential request again. Using the information in the log along with the messages found in this section of the document should provide a better understanding of the problem.
- WELM011: Credential/Passticket request timed out
- This message is the result of a pending request timing out before it could be resolved. This could happen when the Z and I Emulator for Web client is making a request of the Credential Mapper Server, or it could be the credential plug-in making a request of an external entity. In either case, if the default time elapses before the request is fulfilled, this message is generated. To rectify the problem, verify that the addresses being used are correct. For the Z and I Emulator for Web client, the Credential Mapper server is specified as the Credential Mapper Server address in the Express Logon properties window of the Session Configuration panel. If the credential plug-in is generating this problem, verify that the credential plug-in is properly configured in your CMS configuration.
- WELM012: Unexpected return code received from DCAS
- This error is created when a credential plug-in receives an unexpected return value of an external application. You should enable server-side logging and perform the credential request again. Using the information in the log along with the messages found in this section of the document should provide a better understanding of the problem.
- WELM013: API not supported. Contact the system administrator for server log.
- This message informs the user that an unsupported request has been made of the credential plug-in selected by the credential mapping application. You should enable server-side logging and perform the credential request again. Using the information in the log along with the messages found in this section of the document should provide a better understanding of the problem.
- WELM014: A malformed URL was specified for the Credential Mapper Server Address
- The address used for the Credential Mapper server is not a valid URL address. The Credential Mapper server is specified as the Credential Mapper server address in the Express Logon properties of the Session Configuration panel.
- WELM015: Unable to parse Credential Mapper response
- The response generated by the Credential Mapper server application contains a response that is improperly formatted. This may happen when a custom Credential Mapper server application is used in place of the default Z and I Emulator for Web Credential Mapper server application. Refer to Customizing Web Express Logon for more information about the CMS response format.
- WELM016: Local user ID not available
- This message is generated when the operating system on which the Z and I Emulator for Web client is running does not support the Use Local Operating System ID option for network security identification. Refer to the Introduction for more information about which operating systems and versions are supported by this option.
- WELM017: Credential Mapper response contained a duplicate userid, password, or status tag
- This problem is caused when the response generated by the Credential Mapper server application contains duplicate response values. This may happen when a custom Credential Mapper server application is used in place of the default Z and I Emulator for Web Credential Mapper server application. Refer to Customizing Web Express Logon for more information about the CMS response format.
- WELM018: An exception occurred while processing the credential request: some exception
- This message is displayed when an exception occurs in the Z and I Emulator for Web client during the Web Express Logon process. If the exception is an IOException, the problem may be the Credential Mapper server address specified in the Express Logon properties panel in the session configuration. If the address seems correct, validate that the CMS server is available. Typing the Credential Mapper address specified in the session configuration into the address entry field of your browser allows you to test access to the CMS server easily. The results should be an XML document similar to the one described earlier in this document.
- WELM020: Portal user ID not available
- This message is generated when the Portal ID cannot be retrieved. The HTML page may not be configured as a Z and I Emulator for Web portlet.
- WELM021: A matching user ID not found in Portal Vault
- The matching user's host credentials are not found in the Portal Vault. Be sure that the Portal Vault parameters are configured when the HTML page is generated.
- WELM050: Web Express Logon Credential Mapper Server Address not specified
- Web Express Logon is used to automate the Z and I Emulator for Web configuration server login process, but the Credential Mapper server address is not specified. Verify that you have specified the proper value for the Credential Mapper server address in the Deployment Wizard.
- WELM051: User name returned from Web Express Logon is not a known Z and I Emulator for Web user
- Web Express Logon is used to automate the Z and I Emulator for Web configuration server login process and the user name provided by Web Express Logon is not a valid Z and I Emulator for Web user. Verify that the user is listed in the Z and I Emulator for Web configuration by accessing the Z and I Emulator for Web Administrative Console. In addition, view the server-side log to verify that the user name is being retrieved properly.
- WELM052: Invalid password returned from Web Express Logon
- Web Express Logon is used to automate the Z and I Emulator for Web configuration server login process, and the password provided by Web Express Logon is not a valid. Verify that the user is listed in the Z and I Emulator for Web configuration by accessing the Z and I Emulator for Web Administrative Console. In addition, view the server-side log to verify that the user name is being retrieved properly.
- WELM053: This session is not enabled for Web Express Logon
- A Web Express Logon macro is executed, and the session on which it is running has not been configured to use Web Express Logon. Web Express Logon can be configured via the Z and I Emulator for Web session configuration panel.