The fetch command is valid on enterprise managers only.
Use the fetch command to fetch files from a CA ITCM domain manager or a group of CA ITCM domain managers and store it into the fetch area of the enterprise manager.
This action has the following format:
fetch item=item [comment=comment]
path=path_name
{{area=area_name} | {domain=domain_name} | toAllAreas}
[cname=name]
[sendTime="YYYY-MM-DD hh:mm"]
[haltTime="YYYY-MM-DD hh:mm"]
Specifies the name of a CA ITCM domain from which the items are fetched.
You can specify this parameter more than once to address a list of CA ITCM domains.
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.
Specifies a comment providing a description of the fetched item or items.
Specifies the name of one or more CA ITCM domain groups from which the items are fetched
You can specify this parameter more than once to address a list of CA ITCM domain groups.
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".
Specifies the name of the items to fetch from the targeted CA ITCM domain managers.
Specifies the path to the items to be fetched.
The specifies path name is that on the targeted CA ITCM domain managers.
It has to be coded according to the conventions of the operating system.
To retrieve data from a CA ITCM domain manager, the fetch command uses the parameter "path" to specify what is to be retrieved from the domain manager.
For ease of use the path may contain environment variables defined by the system or user or the configuration files of SD.
(For details, see the DSM Explorer Help).
In SD, these environment variables have to enclosed by percent signs "%".
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.
If coded the related distribution will be sent to all CA ITCM domains registered at the enterprise manager.
Assume that on both, the enterprise and the domain manager, the environment variable %SAMPLES% is defined, but on the enterprise the variable is pointing to "c:\samples", while on the domain manager it is pointing to "g:\examples".
All txt files should be fetched. Now launching the following command from the Windows command prompt
cadsmcmd fetch item=sample path=%SAMPLE%\*.txt area=domain_manager
will result in an error or unexpected results. Because SAMPLES is defined on the enterprise manager the command prompt will resolve the variable and launch the cadsmcmd with the following path parameter:
path=c:\samples\*.txt
To avoid the variables resolution by the Windows command prompt the percent sign has to be escaped from being interpreted by the command prompt. This is done by preceding the percent sign with a caret "^".
Therefore, in the following invocation, all parameters will by passed unmodified by the command prompt to the cadsmcmd and the environment variable SAMPLES will be resolved at the domain manager's site:
cadsmcmd fetch item=samples path=^%SAMPLES^%\*.txt area=domain_manager
|
Copyright © 2013 CA.
All rights reserved.
|
|