Previous Topic: ExampleNext Topic: Example


modify—Modify Attributes of a Template Group / Software Template

This command modifies the attributes of an existing software group and template.

This command has the following format:

templategroup action=modify name=template_group_name
[newName=template_group_name] 
[swTemplate=software_template_name]
[newSwTemplate=new_software_template_name]
[comment=comment]
[{query="query" | queryfile=filename | noquery}]
[engineName=engine_name
[enginePeriod=engine_evalution_frequence]]
[{transaction|synchronized|nolinkage}]
[rollback[={y|n}]] 
[cascade[={y|n}]]
[{nosetup | setup_jobs | setup&activate_jobs}]
| [regenerate [ = {y/n}]]
| [{adhoc_disable | adhoc_only | adhoc_always}] 
[evaluationstart="YYYY-MM-DD hh:mm"]
[evaluationperiod=hours]
[calendarname=calendar_name]
[globalTime[={y|n}]]
[jcPriority={1,...,10}]
[userMessage]
{adhoc_disable | adhoc_only | adhoc_always}

The coding has the following effects:

adhoc_disabled

Adhoc evaluation is disabled.

adhoc_only

Adhoc evaluation is enabled only when new or reinstalled targets report their inventory.

adhoc_always

Adhoc evaluation is enabled always when targets report their inventory.

calendarname

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

Note: To activate a calendarname entry you also have to code "evaluationPeriod".

cascade

If "cascade" or "cascade=y" is coded, the job linkage of the container is switched to resolution of dependencies into install cascades.
If "cascade=n" is coded, the job linkage is switched to no resolution.

This parameter should only be coded, if the job linkage of the container is in batch processing or in synchronous mode, or switched to it by this command (coding either "transaction" or "synchronous").

comment

a comment will be replaced by the specified value.

Note: To erase an existing comment, enter the empty string ("").

engineName

Specifies the name of an engine that will process the group evaluation.

If an empty string is coded then any engine can process the query

If currently no query is assigned to the group a warning is given and the parameter is ignored.

enginePeriod

Specifies in minutes the period in which the engine will re-evaluate the group. If not coded 1 min is assumed.If currently no query is assigned to the group and no special engine to process the evaluation then a warning is given and the parameter is ignored.

evaluationstart

Time, when the evaluation should start. The time should be coded in ISO format "YYYY-MM-DD hh:mm". If no EvaluationStart is coded, the actual time is used.

This parameter is to be used for query or template groups only.

evaluationperiod

Period in which the query is evaluated. The period is specified in hours.

This parameter is usable for query or template groups only.

If 0 (zero) is entered, the periodical evaluation is switched off.

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.

jcPriority

Specifies the new priority that will be assigned to 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 the priority is not changed.

name

Specifies the template group name to be modified.

newName

Specifies the new template group name.

newSwTemplate

Specifies the new name of the software template in question.

nolinkage

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

noquery

A possibly coded query is deleted.

nosetup

If this parameter is coded only conformance checks but no job setups will be performed.

query

Indicates that the template is also a query group. The query coded has to be a USD 4.0 SP1 legacy query.

queryfile

Specifies the file in which the query is stored. The size of the query stored is only limited by the capacity of the server. The query has to be a legal SD 4.0 SP1 legacy query.

regenerate

If "regenerate" or "regenerate=y" is coded the regeneration of jobs that have failed earlier for this template will be done.

If "regenerate=n" is coded it will not be done.

If the parameter is not coded, "regenerate=y" is assumed.

rollback

Set the job linkage option to "Enable Transaction".

This parameter should only be coded, if the container is already in the batch processing mode or if it is switched to it by this command (parameter "transaction").

setup_jobs

According to the conformance check, set up jobs but do not activate.

setup&activate_jobs

Set up and activate jobs according to the conformance check.

Notes: If the parameter setup&activate_jobs is used from the command prompt or shell level, the parameter should be enclosed in quotes due to the special meaning of "&" to the command prompt or the shell. If you use batch scripts, you do not need quotes for this parameter.

swTemplate

Specifies the name of the software template for which the attributes will be modified.

If not coded the default name “<group name> [$date $time]” is taken.

synchronized

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

transaction

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

userMessage

Modifies the custom administrator message while updating a template group.

Note: If a parameter is not coded the related attribute is not changed.