Before any APA information can be viewed, a connection must be established between APA on CICS Explorer™ and the APA Listener started task on z/OS. Details about the system connection must be provided to z/OS, including its location, and authentication requirements.
Note: APA must be exited and re-started for SSL connection changes to take effect.
Before Starting
At least one connection credential must be defined before a system connection can be configured. See the topic Defining connection credentials for further information.
If an APA Connection has not been configured, or an additional connection is to be setup, perform these steps:
Procedure
![]() Host Connections View |
![]() Add APA Connection |
Preference | Description |
Type | The type of the connection. Select "APA Connection". |
Name | The local name is used to identify the connection. |
Host Name | z/OS server address where the APA server communications reside. |
Port Number | Port where the z/OS APA server is listening. |
SSL Connection | Use SSL (secure) connection Default: unchecked |
Truststore File | Truststore file used for SSL connection, should point to the directory and file that has the truststore. |
Truststore Pass phrase | Pass phrase for truststore - should have the password used to access the truststore file. |
Protocol | Protocol to be used for SSL connection. |
Cipher | Cipher to be used for SSL connection. |
Results
The connection and associated credential are displayed in the Host Connections view.
What to do next
Click Connect to start the connection. If the connection is associated with a credential, the connection will be started. If the connection is not already associated with a credential, you will be prompted to choose an existing credential or create one.
Parent topic: Tasks