Delete server, cluster, application, or authorization group objects using properties files

Use this topic to delete server, cluster, application, or authorizationgroup objects from the configuration.

Use the PropertiesBasedConfiguration command group for AdminTask, we can use properties files to delete configuration objects from your environment.

We cannot apply a z/OS operating system properties file directly to a distributed operating system. Similarly, we cannot apply a distributed operating system properties file directly to a z/OS operating system. gotcha

 

1. Launch the wsadmin scripting tool using the Jython scripting language.

2. Create a properties file template. Create a properties file template to use to delete the server, cluster, application, or authorization group object of interest. Use the -configType parameter and the following guidelines to specify the type of template to create:

   • Specify Server to create a server type properties file template.

   • Specify ServerCluster to create a server cluster type properties file template.

   • Specify Application to create an application type properties file template.

   • Specify AuthorizationGroup to create an authorization group type properties file template.

   The following Jython example uses the createPropertiesFileTemplates command to create a new AuthorizationGroup object template:

   AdminTask.createPropertiesFileTemplates('[-propertiesFileName authorizationGroup.template -configType AuthorizationGroup]')

   The command generates a template file similar to the following sample template:

   #
   # Delete parameters
   # Replace the line 'SKIP=true' with 'SKIP=false' under each section that is needed
   # Set necessary parameters under each command or step sections
   # Invoke deleteConfigProperties command using this properties file.
   # 
   ResourceType=AuthorizationGroup 
   ImplementingResourceType=AuthorizationGroup 
   ResourceId=AuthorizationGroup= 
   SKIP=true 
   CreateDeleteCommandProperties=true
   #
   
   #
   #Properties
   # 
   authorizationGroupName=authorizationGroupName #String,required commandName=deleteAuthorizationGroup
   

3. Modify the new template file.

   Modify the new AuthorizationGroup template file by setting the required parameters. We can also modify the optional parameters, but modify the required parameters. Change the SKIP required property value from SKIP=true to SKIP=false to indicate that the system should apply the properties in the specific section of the properties file to the configuration. To ignore a specific section of a properties file, set the SKIP property to SKIP=true.

   #
   # Delete parameters
   # Replace the line `SKIP=true` with 'SKIP=false' under each section that is needed
   # Set necessary parameters under each command or step sections
   # Invoke deleteConfigProperties command using this properties file.
   # 
   ResourceType=AuthorizationGroup 
   ImplementingResourceType=AuthorizationGroup 
   ResourceId=AuthorizationGroup=authorizationGroupName 
   
   SKIP=false CreateDeleteCommandProperties=true
   #
   
   #
   #Properties
   # 
   authorizationGroupName=authorizationGroupName #String,required 
   commandName=deleteAuthorizationGroup
   
   

4. Remove the object from the configuration. Use the deleteConfigProperties command to remove the existing AuthorizationGroup object from the configuration, as the following Jython example demonstrates:

   AdminTask.deleteConfigProperties('[-propertiesFileName authorizationGroup.template]')

   The command removes the ag1 authorization group in the configuration.

5. Save the configuration changes...

   AdminConfig.save()

 

Related tasks

Create server, cluster, application, or authorization group objects using properties files
Create and deleting configuration objects using properties files
Validating properties files
Applying properties files
Manage environment configurations using properties files
Extracting properties files
Extracting properties files to troubleshoot the environment
Manage servers and nodes with scripting

 

Related

PropertiesBasedConfiguration