Previous Topic: progress—Checking Distribution ProgressNext Topic: Example


rdereg—Deregistering Items Remotely

Use the rdereg command to send an order to deregister (remove) software items from the software library, at one or more domain managers. The order originates from the enterprise manager. The deregistration order is sent from the enterprise manager to the specified CA ITCM domains or domain groups.

This command is valid for enterprise managers only.

It has the following format:

rdereg  item=item_name  
version=version_name
{{area=area_name} | {domain=domain_name} | toAllAreas}
[cname=name]
[sendTime="YYYY-MM-DD hh:mm"] 
[haltTime="YYYY-MM-DD hh:mm"]
area

Specifies the name of a CA ITCM domain where the item is to be deregistered.

The item can specified more than once to address a list of CA ITCM domains.

The item should not be coded with the parameters domain or toAllAreas.

cname

Specifies the the optional unique name of a job container.

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.

domain

Specifies the name of a CA ITCM domain group where the item is to be deregistered.

The parameter can be specified more than once to address a list of CA ITCM domain groups.

The parameter should not be specified with the area or toAllAreas parameters.

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".

item

Specifies the name of the item to be deregistered or removed from one or more local libraries.

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.

toAllAreas

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

version

Specifies the version of the item to be deregistered or removed.