Deleting libraries used for remote deployment

You can use the DELETE action to delete libraries used for remote deployment.

The process of deploying a remote environment using the Configuration Manager PACKAGE and DEPLOY actions results in multiple sets of data sets on multiple systems. In a remote deployment scenario, you create a runtime environment on a specific LPAR (the configuration system), package the runtime environment data sets into transferable dump data sets on the configuration system, transfer the packaged data sets to the remote target system (target system), and deploy the packaged runtime environment data sets on the target system. As mentioned previously, many data sets are created; and these data sets can also have different high-level qualifiers. Deleting these data sets manually would be a complex task. Instead, you can delete these data sets easily and accurately using the DELETE action.

Using the DELETE action, you can remove these data sets on the configuration system or the target system, and you must perform the DELETE action on the system where the files to be deleted exist. If you used the KFJ_LOCAL_PLIB_HILEV parameter when creating the runtime environment, the DELETE action identifies and deletes the runtime environment that was generated for a remote system using different high-level qualifiers.

Important: It is recommended that you review the list of data sets that will be deleted by using the CONFIRM workflow variable set to N before performing the delete. After you are satisfied with the generated list, run the DELETE action using the CONFIRM workflow variable set to Y to delete the data sets.

The following examples describe which parameters to use with the DELETE action depending on your situation and assumes that you used KFJ_LOCAL_PLIB_HILEV when creating your runtime environment.

Note: For information about the data sets that are affected, see Data sets that are deleted by the DELETE action.

Deleting data sets on the configuration system

To delete runtime environment data sets on the configuration system, run the DELETE action on the configuration system using the parameters in the following example. To indicate the high-level qualifier, note that both the RTE_PLIB_HILEV and KFJ_LOCAL_PLIB_HILEV parameters are specified.

Figure 1. Example to delete data sets on the configuration system
//KCIVARS  DD *                                        
ACTION                   DELETE
CONFIRM                  Y
RTE_NAME                 RTE1
RTE_PLIB_HILEV           TSOUID.TARG1
KFJ_LOCAL_PLIB_HILEV     TSOUID.LOCL1

This example will use the TSOUID.LOCL1.RTEDEF(PCK$*) members to generate the list of data sets to delete on the configuration system.

Important: Make sure to specify the correct values for the RTE_PLIB_HILEV and KFJ_LOCAL_PLIB_HILEV parameters; otherwise, unexpected results might occur. It is important that you review the generated list of data sets to be deleted using the CONFIRM workflow variable set to N.

Deleting data sets on the remote system (target system)

To delete runtime environment data sets on the target system, run the DELETE action on the target system using the parameters in the following example. To indicate the high-level qualifier, note that only the RTE_PLIB_HILEV parameter is specified.

Figure 2. Example to delete data sets on the remote system (target system)
//KCIVARS  DD *                                        
ACTION                   DELETE
CONFIRM                  Y
RTE_NAME                 RTE1
RTE_PLIB_HILEV           TSOUID.TARG1

This example will delete the data sets for the runtime environment on the target system with high-level qualifier TSOUID.TARG1, or as defined in TSOUID.TARG1.RTEDEF(RTE1).

Important: Make sure to specify the correct value for the RTE_PLIB_HILEV parameter. If you inadvertently specify the value that was used for parameter KFJ_LOCAL_PLIB_HILEV for parameter RTE_PLIB_HILEV, unexpected results might occur. It is important that you review the generated list of data sets that will be deleted using the CONFIRM workflow variable set to N.