Logging in to TEXTML Server

How to connect and login to an instance of TEXTML Server. How to free resources and logoff from TEXTML Server.

1. Prepare an object that you will need as a dummy parameter for a method call.

   // You need this HashMap object
   HashMap dummyParameter = new HashMap(1);

2. Get a ClientServices object from ClientServicesFactory.

   ClientServices cs = 
      com.ixia.textmlserver.ClientServicesFactory.getInstance
         ("CORBA", dummyParameter);

   When you call ClientServicesFactory.getInstance(), you must provide "CORBA" as the first parameter, and a HashMap object as the second parameter. The dummy parameter is neither referenced nor modified.

   The ClientServices object allows you login to server instances, logout from them, and to get access to various TEXTML Services.

3. Prepare the credentials required to login to the TEXTML Server instance.

   // The 3 parameters are all String objects.
   cs.Login(domain, userName, password));

   These credentials must be the same as the ones you use to login to the computer hosting the TEXTML Server instance.

   Note: ClientServices.Login() does not actually log you in to TEXTML Server. Instead, it just stores the information for the next step.
4. Login by getting an IxiaPowerServices object for the TEXTML Server instance running on the server that you specify.

   // The parameter is a String object.
   IxiaPowerServices ps = cs.GetPowerServices(serverName);

   This call connects to the TEXTML Server instance running on the server specified by serverName, and then uses the credentials you specified earlier to login.

   Any problems (serverName not found in your domain, invalid userName or password, no TEXTML Server instance running, etc.) will throw an exception that you must catch and handle appropriately. See the reference documentation for ClientServicesFactory.getPowerServices(), and the sample program mentioned below.

   You can use the IxiaPowerServices object to make sure that the TEXTML Server instance is running properly: for example, that the server is Running and not Paused. See the sample program below.

   Note: This is the starting point for many topics that discuss code snippets: your application is logged in to a TEXTML Server instance, and contains an IxiaClientServices object named cs and a IxiaPowerServices object named ps.
5. When you have finished using a TEXTML SDK object, free its memory by calling the object's Release() method.

   ps.Release();  // Free memory used by IxiaPowerServices object

6. When you are finished using the TEXTML Server instance, logout and disconnect by calling the logout() method of the ClientServices object that you used to login.

   cs.Logout();