Use this topic to create new server, cluster, application, or authorization group objects
for your configuration.
About this task
Using the PropertiesBasedConfiguration command group for the AdminTask object, you can use
properties files to create configuration objects in 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 create the new server, cluster, application, or
authorization group object. 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:
#
# Create 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 applyConfigProperties command using this properties file.
#
ResourceType=AuthorizationGroup
ImplementingResourceType=AuthorizationGroup
ResourceId=AuthorizationGroup=
SKIP=true
CreateDeleteCommandProperties=true
#
#
#Properties
#
authorizationGroupName=authorizationGroupName #String,required
commandName=createAuthorizationGroup
- 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
.
#
# Create 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 applyConfigProperties command using this properties file.
#
ResourceType=AuthorizationGroup
ImplementingResourceType=AuthorizationGroup
ResourceId=AuthorizationGroup=
SKIP=false
CreateDeleteCommandProperties=true
#
#
#Properties
#
authorizationGroupName=ag1 #String,required
commandName=createAuthorizationGroup
- Apply the modified properties to your configuration.
Use the
applyConfigProperties command to apply the properties file to the
configuration, as the following Jython example
demonstrates:
AdminTask.applyConfigProperties('[-propertiesFileName authorizationGroup.template]')
The command creates the ag1
authorization group in your configuration.
- Save the configuration changes.
Use the following command example to save your configuration
changes:
AdminConfig.save()