Previous Topic: listItem—List Items of Scalability ServerNext Topic: swlibrary—Software Library Commands


removeItem—Remove Item from Staging Libraries

This action removes an item from one or more staging libraries.

This action has the following format:

stagingserver action=removeitem
item=item_name 
version=item_version 
{ { computer=computer_name }
| { compgrp=computer_group_name } }
[cname=name]
[{nolinkage | transaction | synchronized } ]
[atTime="YYYY-MM-DD hh:mm"]
[ timeout=hours]
[jcPriority={1,...,10}]
attime

Specifies the Specifies the date and time when the action will be started.

The date has the ISO format "YYYY-MM-DD hh:mm".

cname

Specifies the the optional unique name of a job container where the generated job will be stored.

If a job container / distribution with the specified name already exists an error will be reported.
If "cname" is not coded, a generic name is generated.

compgrp

Specifies the name of a server group of scalability servers from which the item is to be removed.

The parameter can be coded more than once to address a list of server groups.

The parameter should not be coded with the computer parameter.

computer

Specifies the name of the scalability server from which the item is to be removed.

The parameter can be coded more than once to address a list of scalability servers.

This parameter should not be coded with the compgrp parameter.

item

Specifies the name of the item to be removed.

jcPriority

Specifies the priority of the job container.

The priority specified has to be numeric and its value has to be greater or equal 1 and less or equal 10.

If not coded priority 5 is assumed.

nolinkage

Run the job independently of the other jobs in the container.

synchronized

The job linkage option is set to "Synchronized job execution".

timeout

Specifies the timeout specifies the expiration period of a job in the form “h” where h the number of hours. The range of the parameter is configurable at the manager’s site. When the specified value exceeds the configured upper limit then the value is set to the upper limit, if the specified value goes below the lower limit then the lower limit is taken. No warning is given in any case.
timeout should not be coded with the jobTimeout parameter otherwise an error is reported. If none of the parameters is coded the default is given by 168

transaction

The job linkage option is set to "Batch job execution".

version

Specifies the version of the item to be removed.

Note: If neither "synchronized" nor "transaction" is coded, then a job container of type "nolinkage" will be created.