Configuring a Client Application

Once the certificates are in the correct format you can configure your client application to use these certificates to make a connection to a mainframe:

1. Create a CCI.INI file in the bin directory of the product installation directory, typically C:\Program Files (x86)\Micro Focus\Enterprise Developer\bin. This file holds information that links the certificates to the connection being made in the client application.
   Important: The CCI.INI file has a limitation to the length of paths specified in it. Micro Focus recommend you store your certificate in a non-spacey short path form, for example, C:\SSL.
2. In the CCI.INI file, specify the following lines:

   [ccitcp-targets]
   CCITCPT_<CCI_Key>=,MFCONN:SSL:<"A:\path\to\the\servername-root-cert.pem">:<"A:\path\to\the\servername-user-cert.pem">::<"A:\path\to\the\servername-user-key.der">:<Pass_Phrase>,MFNODE:<Node>,MFPORT:<Port>

   In the CCI.INI file, you must replace values in the angle brackets <> with values specific to your system configuration:

   <CCI_Key>

   The connection name given to these credentials which are displayed in the connection wizard, for example, CSIMVSSSL.

   <"A:\path\to\the\servername-root-cert.pem">

   The quoted path to the root certificate PEM file.

   <"A:\path\to\the\servername-user-cert.pem">

   The quoted path to the user certificate PEM file.

   <"A:\path\to\the\servername-user-key.der">

   The quoted path to the private key DER file.

   <Pass_Phrase>

   The pass phrase used to encrypt the private key file.

   <Node>

   The DNS name or IP address of the mainframe.

   <Port>

   The MFA port defined in AT-TLS; the default is 2020.

   When you have finished editing the CCI.INI file, it should look similar to the following:

   [ccitcp-targets]
   CCITCPT_CSIMVSSSL=,MFCONN:SSL:"C:\SSL\CSIMVS-root-cert.pem":"C:\SSL\CSIMVS-MYUSER-cert.pem"::"C:\SSL\CSIMVS-MYUSER-key.der":A1B2C3D4,MFNODE:CSIMVS,MFPORT:20201

3. Test that your configuration of the CCI.INI file allows you to connect using mfdasmx.exe. See Verifying the CCI.INI file for more information.
4. Start Enterprise Developer for Eclipse.

   If the Remote Systems window is not displayed, click Window > Show View > Remote Systems.

5. In the Remote Systems window, click (Define a connection to remote system).

   This opens the New Connection dialog box.

6. Click Micro Focus z/Server.
7. Click Next.
8. In the Host name field, type the value of the MFNODE specified in your CCI.INI file. In this case, CSIMVS.
9. Click Next.
10. In the Port field, type the value of the MFPORT specified in your CCI.INI file. In this case, 20201.
11. In the CCI Key list, select the SSL/TLS connection you specified in your CCI.INI file. In this case, CCITCPT_CSIMVSSSL.
12. Click Finish to connect to the mainframe.