Defining connection credentials

When APA attempts to establish a system connection it must send your credential details, that is your user ID and password or pass phrase, to the APA Listener on z/OS for authentication. Each credential can be used on systems that share the credential without re-entering the details every time. At least one credential must be defined before a connection to APA can be established.

Before Starting

Before proceeding, ensure that you have all your system connection details and that you have the correct level of authorization to connect to your system.

Procedure
  1. On the workbench menu bar click Window > Manage Connections. The Host Connections view opens. The following shows the Host Connections view from the CICS Explorer®, showing the APA connection category and credentials.



    Host Connections View


  2. Click Add in the Credentials section to add a new credential. The New Credentials window opens.



    New Credentials


    Preference Description
    Name The local name is used to identify the credential.

    User ID TSO userid that is to be used for the APA Communications.

    Password Password/pass phrase for TSO userid that is to be used for the APA Communications. "Save Password" must be checked before the Password preference is enabled.

    Save Password Save the password.

    Default : false



  3. Enter your credential details and provide a credential name. The name can be anything you like, and is used only to help you distinguish between different credentials. If you do not type a name, then the default name used is the same as the User ID. Select the Save Password check box to save the password.

    Note: You might have a single user ID, but use different passwords for different systems. In this case, you can define multiple credentials, each one having the same user ID but with a different credential name and password or pass phrase. Alternatively you can choose to define one credential, but not to save the password or pass phrase, in which case you are required to enter them when you connect to a system.

  4. Click OK to save the credential or Cancel to cancel the process and close the window without saving the credential.

What to do next

You can click Add in the Connections section of the Host Connections view to configure an APA connection. Alternatively, click Connect to start the connection.

Parent topic: Tasks