Use this topic to delete server, cluster, application, or authorizationgroup objects from
your configuration.
About this task
Using the PropertiesBasedConfiguration command group for the AdminTask object, you can use
properties files to delete configuration objects from your environment.
Avoid trouble: You cannot apply a z/OS® operating system
properties file directly to a distributed operating system. Similarly, you cannot apply a
distributed operating system properties file directly to a z/OS operating system.
Procedure
- Start the wsadmin scripting tool.
- 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
- Modify the new template file.
Modify the new AuthorizationGroup template file by setting the required parameters. You can also
modify the optional parameters, but you must 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
- Remove the object from your 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 your configuration.
- Save the configuration changes.
Use the following command example to save your configuration
changes:
AdminConfig.save()