Operating Systems: AIX, HP-UX, Linux, Solaris, Windows, z/OS

---

 

servicepolicy.py script

You can use the servicepolicy.py script to perform operations on service policies from the command line, such as creating service policies, removing service policies, and editing transaction classes.

 

Purpose

You can perform the following actions with the servicepolicy.py script:

• Create a service policy

• Remove a service policy

• Create a transaction class

• Remove a transaction class

To create, modify, and remove service policies and transaction classes, have configurator or administrator administrative privileges.

 

Location

The servicepolicy.py script is located in the install_root/bin directory.

 

Usage

The script usage for general help follows:

./wsadmin.sh|bat -lang jython -f servicepolicy.py

The script usage for operation-specific help follows:

./wsadmin.sh|bat -lang jython -f servicepolicy.py operation --help

 

Operations

You can perform the following operations with the servicepolicy.py script:

createServicePolicy

Creates a service policy with the specified options. You must create and associate transaction classes separately.

--spname

Specifies a name for the service policy that is unique in the cell.

--spgt

Specifies an integer that represents one of the following service policy goal types:

• 0: discretionary

• 1: average response time

• 2: percentile response time

• 4: completion time

--spgv

Specifies a service policy goal value for non-discretionary goals. This value is assumed to be in milliseconds if you do not specify the units.

--spgvu

Specifies an integer that represents a service policy goal value for non-discretionary goals. This value is assumed to be in milliseconds if you do not specify the units.

• 0: milliseconds

• 1: seconds

• 2 : minutes

--sppgv

Specifies an integer that represents a percentile value for a service policy with percentile response time goal between 1 and 100.

--spi

Specifies an integer that represents one of the following service policy goal types:

• 1: highest

• 2: higher

• 3: high

• 4: medium

• 5: low

• 6: lower

• 7: lowest

--spd

Specifies a service policy description.

removeServicePolicy

Deletes an existing service policy with the specified option.

--spname

Specifies the unique name for the service policy that you want to remove.

createTransactionClass

Creates a transaction class with the specified options.

--spname

Specifies a name for the service policy that is unique in the cell.

--tcname

Specifies a name for the transaction class to create that is unique in the cell.

--tcd

Specifies a transaction class description.

removeTransactionClass

Removes a transaction class with the specified option. All Uniform Resource Identifiers (URIs) in the transaction class are no longer associated with the parent service policy. If a request comes in for these URIs and they are not associated with a new service policy and transaction class, they are classified to the default service policy with a discretionary goal.

--tcname

Specifies the cell-unique name for the transaction class that you want to remove.

 

Example

Create a service policy:

./wsadmin.sh|bat -lang jython -f servicepolicy.py createServicePolicy --spname Platinum --spgt 2 --spgv 3000 --spgvu 0 --sppgv 80 --spi 5

Remove an existing service policy:

./wsadmin.sh|bat -lang jython -f servicepolicy.py removeServicePolicy --spname Bronze 

Create a new transaction class:

./wsadmin.sh|bat -lang jython -f servicepolicy.py createTransactionClass --spname Platinum --tcname PlatinumWorkload --tcd 'my platinum workload'

Remove an existing transaction class:

./wsadmin.sh|bat -lang jython -f servicepolicy.py removeTransactionClass --tcname PlatinumWorkload  

---

Related tasks

Defining a service policy

 

Related reference