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