Updating z/OS endpoints

There might be situations in which you need to update the configuration of a z/OS® endpoint. To update a z/OS endpoint configuration, you can use the z/OS Cloud Broker user interface.

Important: When you update a z/OS endpoint configuration, existing suboperators and suboperator instances that are associated with the endpoint are automatically reconciled. The reconciled suboperators and suboperator instances automatically detect and use the updated z/OS endpoint variables.

Procedure

  1. Log in to the z/OS Cloud Broker instance that contains the z/OS endpoint you need to update. (See Logging in to z/OS Cloud Broker.)

  2. In the z/OS Cloud Broker navigation pane, select Manage z/OS endpoints.

    Import operator collections link

  3. On the "Configure z/OS endpoints" page, select the z/OS endpoint whose configuration you need to update.

    Existing endpoint selection on the "Configure z/OS endpoints" page

  4. In the z/OS Endpoint configuration section on the endpoint details page, if needed, click Edit and edit the configuration for the z/OS endpoint as follows:

    Editing existing endpoint configuration on the endpoint details page

    • If you are updating a z/OS endpoint that is not mapped, you can update the z/OS Endpoint type, z/OS Endpoint description, Host, and Port fields.

      Editing existing endpoint configuration for an unmapped endpoint on the endpoint details page

    • If you are updating a z/OS endpoint that is already mapped, you can update the z/OS Endpoint description field.

      Editing existing endpoint configuration for a mapped endpoint on the endpoint details page

  5. In the Variables (optional) section on the endpoint details page, if needed, click Edit and edit the configuration for the existing variable that is non-secure as follows:

    Editing existing variable configuration on the endpoint details page

    • Variable type: Select from possible values String, Boolean, or Integer.
    • Value: Enter a value appropriate to the variable type selected.
    • Secure variable: Switch to Secure if you want to hide the variable value in a read-protected, write-only state. Note that this value cannot be unhidden after your z/OS endpoint configuration is submitted.

    Note: The configuration for the existing secured variable cannot be changed. To edit it, it is recommended to delete the existing variable and create a new one.

  6. In the Variables (optional) section on the endpoint details page, if needed, click Edit and select Add variable. Specify values for your new variable configuration as follows:

    New variable configuration on the endpoint details page

    • Variable type: Select from possible values String, Boolean, or Integer.
    • Name: Enter a name for your variable.
    • Value: Enter a value appropriate to the variable type selected.
    • Secure variable: Switch to Secure if you want to hide the variable value in a read-protected, write-only state. Note that this value cannot be unhidden after your z/OS endpoint configuration is submitted.

  7. Click Save to save your updates.

  8. Click Submit.

  9. Verify your updates on the "z/OS Endpoint configuration warning" dialog box and click Submit.

    "z/OS Endpoint warning" dialog box

Procedure result

The endpoint configuration is updated. To verify, on the "Configure z/OS endpoints" page, select the z/OS endpoint whose configuration you updated and confirm that the changes are displayed.