Previous Topic: ExampleNext Topic: Software Group Management


undeliverGroupFromStage—Undeliver Items of Software Group From Scalability Servers

This action "undelivers" the items of a software group from scalability servers, in other words, they will be removed from the software library of the scalability server.

This action has the following format:

swLibrary action=undeliverGroupFromStage name=group_name 
{{computer=computer_name
| {compgrp=computer_group_name | ccompgrp=(computer_group_name sep groupScope)}}
[sep=separator_sign]
[dname=distribution_name] 
cname=[name]
[unsealed]
[{nolinkage|transaction[rollback]|synchronized}[nocascade]]
[deliveryTime="YYYY-MM-DD hh:mm"] 
[calendarname=deliverycalendar]
[globalTime]
[{{area=area_name} | {domain=domain_name} | toAllAreas}]
[sendTime="YYYY-MM-DD hh:mm"] 
[haltTime="YYYY-MM-DD hh:mm"]
[jcPriority={1,...,10}]
[distPriority={1,...,10}]	
area

Specifies the name of a Client Automation domainthe distribution will be sent to.

The parameter can be coded more than once to address a list of Client Automation domains.

If this parameter is coded then the distribution will be sealed and automatically sent to its destinations after the command has been successfully completed.

If neither the area nor the domain nor the toAllAreas parameter is coded, the distribution remains unsealed and can further be manipulated.

This parameter should not be coded with the domain or toAllAreas parameters.

(Enterprise manager only)

calendarName

Specifies the name of the calendar that controls the time when the evaluation can take place.

ccompgrp

Specifies the computer group to be addressed as a pair of group name and scope. By default, name and scope are separated by a dot ("."), but an alternate separator can be specified with the "sep" option. The separator should not be used as part of the names.

For the group scope only the following values are valid.

local

The group is created at the local domain manager,

global

The group has been created at the enterprise manager and may be replicated.

The "ccompgrp" can be coded with the "compgrp" in one call.

cname

Specifies an the optional unique name of a job container.

If no cname parameter is given, a name is generated internally and the command line interface returns this identifier.

compgrp

Specifies the name of the server group, which contains the scalability servers to be addressed.

The parameter can be coded more than once to address more than one server group.

The parameter should not be coded with the computer parameter.

computer

Specifies the name of the scalability server to be addressed.

The parameter can be coded more than once to address more than one scalability server.

The compgrp and computer parameter should not be mixed.

(Domain manager only)

deliveryTime

Specifies the start time of delivery from the domain manager.
The date has the ISO format "YYYY-MM-DD hh:mm".

If the parameter is not coded, the actual date and time are used.

distPriority

Specifies the priority that will be assigned to the distribution.

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.

dname

Specifies the name of the distribution

(Enterprise manager only)

domain

Specifies the name of a Client Automation domain group the distribution will be sent to.

The parameter can be coded more than once to address a list of Client Automation domain groups.

If this parameter is coded then the distribution will be sealed and automatically sent to its destinations after the command has been successfully completed.

If neither the area nor the domain nor the toAllAreas parameter is coded, the distribution remains unsealed and can further be manipulated.

This parameter should not be coded with the area or toAllAreas parameters.

(Enterprise manager only)

globalTime

If "globalTime" or "globalTime=y" is coded, then the time specifications are based on the enterprise manager time.

If "globalTime=n" is coded, it is based on domain manager time.

haltTime

Specifies the date and time at which a distribution order should be halted. The date has to be specified in the ISO format "YYYY-MM-DD hh:mm".

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.

name

Specifies the name of a software group of which the members will be undelivered from the specified scalability server.

noCascade

The job linkage option is set to "Ignore cascading".

This parameter is allowed only if "transaction" or "synchronized" are coded.

noLinkage

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

rollback

Set the job linkage option to "Enable Transaction".

sendTime

Specifies the time to send the associated distribution to the addressed domain managers. The date has to be specified in the ISO format "YYYY-MM-DD hh:mm". If the parameter is not coded, the actual date and time is used.

(for enterprise manager only)

sep

Specifies an alternate separator used with the "ccompgroup" option. The separator should not be part of the group name code with the "ccompgroup" options.

synchronized

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

toAllAreas

If coded the related distribution will be sent to all Client Automation domains registered at the enterprise manager.

If this parameter is coded then the distribution will be sealed and automatically sent to its destinations after the command has been successfully completed.

If neither the area nor the domain nor the toAllAreas parameter is coded, the distribution remains unsealed and can further be manipulated.

"toAllAreas" should not be coded with the "area" or "domain" parameters.

(Enterprise manager only)

transaction

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

unsealed

The addressed job container remains unsealed after the generated job has successfully been created.

(Domain manager only)

If neither area, nor domain, nor toAllAreas is coded, the distribution container remains unsealed and further manipulation is possible.