3 Testing and Troubleshooting

After you deploy the connector, you must test it to ensure that it functions as expected. This chapter discusses the following topics related to connector testing:

• Running Test Cases

• Troubleshooting

Running Test Cases

You can use the troubleshooting utility to identify the cause of problems associated with connecting to the target system and performing basic operations on the target system.

In a command window, change to the directory in which the xlutilHostAccess.jar file is present. This file is in the OIM_home\Xellerate\JavaTasks directory. This utility uses some files from the ThirdParty directory.

Then, use the troubleshooting utility to perform the following tests:

• Create an IBM RACF user by entering the following command:

  java -jar xlUtilHostAccess.jar 1 user_id
  
  

• Update an IBM RACF user by entering the following command:

  java -jar xlUtilHostAccess.jar 3 user_id attribute_name attribute_value
  
  

  In this command, attribute_name can be set to one of the following:

  • NAME: To update the name

  • PASSWORD: To update the password

  • OWNER: To update the owner

  • DFLTGRP: To update the default group

  • DATA: To update the installation data

• Delete an IBM RACF user by entering the following command:

  java -jar xlUtilHostAccess.jar 2 user_id
  
  

Troubleshooting

The following table lists solutions to some commonly encountered issues associated with the connector.

Problem Description	Solution
Oracle Identity Manager cannot establish a connection with the IBM Mainframe server	Ensure that the IBM Mainframe server is up and running. Check if the user is already logged in. Check if the user has been disabled on the IBM Mainframe server. Check if Oracle Identity Manager is running. Ensure that all the adapters have been compiled. Use the IT Resources form to examine the Oracle Identity Manager record. Ensure that the IP address, admin ID, and admin password are correct. Check the security parameters if an SSL connection is in use.
The Operation Failed message is displayed on the Oracle Identity Manager Administrative and User Console.	Ensure that the values for the attributes do not contain delimiter characters (such as white space, commas, apostrophes, and quotation marks). Ensure that the attribute values do not exceed their permitted lengths.
Reconciliation fails	Ensure that the files specified for storing new user data on IBM RACF do not already exist on the server.