Renaming a Managed System

You can change the name assigned to the Managed System during Connector for RACF installation.

Once the Managed System has been defined in SailPoint, renaming the Managed System involves changes both on the SailPoint workstation and in Connector for RACF. The procedure described below changes the name of the Managed System only in Connector for RACF.

Note
This procedure should only be performed within the framework of the procedure for changing the name of the Managed System in SailPoint.

The name of an Managed System is changed in Connector for RACF using utility CTSAADPT.

Member CTSADAPT in the JCL library contains a sample job to invoke the JCL procedure for the CTSAADPT utility (procedure <prefix>AADPT, where <prefix> is the prefix of your Connector JCL procedures). The utility should be run when Connector for RACF and the Interceptors are inactive.

Specify the old and new Managed System names as values of parameters FROMRSS and TORSS respectively when invoking the <prefix>AADPT procedure to execute the CTSAADPT utility.

This will change all occurrences of the old Managed System name in Connector for RACF datasets to new Managed System name. Note that the RSSPARM member itself is also modified.

The utility reports which datasets (and how many records in each) were modified. Most datasets considered for modification are allocated via JCL (see the relevant DD statements in the <prefix>AADPT JCL procedure).

One exception to this is the OFLRIMG dataset, used by Offline Interceptor utility. The DSNAME for this dataset is determined during CTSAADPT execution by the value of the RSS_WORK_DIR parameter for TORSS name in the RSSPARM member. The DSNAME dynamically allocated is the concatenation of the value of RSS_WORK_DIR with the suffix OFLRIMG (for example: CTSA.V400.MYRSS.OFLRIMG). If this DSNAME does not exist, no dynamic allocation (and thus, no modification) is done by CTSAADPT for this dataset.

Before running the CTSAADPT utility, verify that the RSS_WORK_DIR parameter value conforms to MVS dataset naming conventions.

Note
If the new Managed System name is longer than 8 characters, additional adjustments must be performed. For more information, see Step 13 – Adjust for Longer Managed System Names.

The CTSAADPT utility does not modify the Connector for RACF started task procedures. After running the utility, the following additional changes must be done manually.

Changes to Online Interceptor

Change the name of the Managed System in the CTSAONI (Online Interceptor) started task procedure as follows:

  1. Stop all the Connector for RACF and Online Interceptor processes. Ensure that all the Connector for RACF and Interceptor processes have shut down.

  2. Edit the CTSAONI member in the PROCLIB library containing Connector for RACF procedures.

    The name of the PROCLIB library is defined in variable %PROCLIB% of member DEFPARMS in the INSTALL library.

  3. Locate the following line:

    Managed System=<rss_name>

  4. Modify the value for <rss_name> to the new Managed System name.

  5. Save the member.

  6. Restart the Connector for RACF and the Online Interceptor.

    Note
    If you use the Delayed Delete utility, repeat steps 2 and 3 for procedure CTSC100. For more information, see Renaming a Managed System and Shared RACF Database Support.

Changes to Offline Interceptor

Change the name of the Managed System in the CTSAOFI (Offline Interceptor) procedure as follows:

  1. Edit member CTSAOFI in the PROCLIB library containing Connector for RACF procedures.

    The name of the PROCLIB library is defined in variable %PROCLIB% of member DEFPARMS in the INSTALL library.

  2. Locate the following line:

    Managed System=<rssName>

  3. Modify the value for <rssName> to the new Managed System name.

  4. Save the member.