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.
Note: 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()