CADSMCMD Command Line Interface › cadsmcmd Commands › swpolicy—Software Policy Commands › modify—Modify Attributes of Unsealed Local Software Policy

modify—Modify Attributes of Unsealed Local Software Policy

This command modifies the attributes of an unsealed local software policy. You can optionally seal the policy with this command.

This command has the following format:

swPolicy	action=modify

name=software_policy_name
[newName=new_name_of_software_template]
[jcPriority=«1…10»]
[{transaction|synchronized|nolinkage}]
[rollback[={y|n}]]
[cascade[={y|n}]]
[{nosetup|setup_jobs|setup&activate_jobs}]
[regenerate[={y|n}]]
[evaluateGroup[={y|n}]]
[evaluationStart=YYYY-MM-DD hh:mm]
[globalTime[={y|n}]]
[evaluationPeriod=hours]
[calendarname=calendar_name]
[{adhoc_disable|adhoc_only|adhoc_always}]
[comment=new_comment_on_the_software_policy]
[seal[={y|n}]]
[userMessage]

name

The name of a local software policy that is modified.

newname

Specifies the new name of the selected software policy.

If this option is not coded the policy name is not changed.

jcPriority

This option specifies the new priority for job container generated by this policy. A valid priority is one of the values 1, 2, 3, 4, 5, 6, 7, 8, 9, 10. 1 is the highest priority and 10 is the lowest.

If this option is not coded the priority is not changed.

{transaction|synchronized|nolinkage}

This option specifies the new job linkage for job containers created by the policy.

«not coded»

The job linkage is not changed.

batch

The job linkage is set to batch jobs without transaction.

transaction

The job linkage is set to batch jobs without transaction.

synchronized

The job linkage is set to synchronized job execution.

nolinkage

The job linkage is set to no linkage.

rollback

If the option “rollback” or “rollback=y” is coded then the job linkage is set to "Enable Transaction". If the option is coded as “rollback=n” then “Enable Transaction” is not set.

If this option is not coded the option is not changed.
The parameter should only coded if the job is already in batch processing mode or switched to it by using parameter "transaction" with this command.

Default: rollback=n.

cascade

If the option “cascade” or cascade=y is coded then the SD will resolve the dependencies of cascaded installation request and add the missing installation orders automatically. If the option is coded as “cascade=n” then the dependency is not resolved any longer.

If this option is not coded the option is not changed.

{nosetup|setup_jobs|setup&activate_jobs}

This option drives the results of the policy’s evaluation:

«not coded»

The degree of automation is not changed.

nosetup

The degree of automation is changed to checking for conformity only.

setup_jobs

The degree of automation is changed to setting up jobs for non conformant targets but does not activate them.

setup&activate_jobs

The degree of automation is changed to setting up and activating jobs for non conformant targets.

regenerate

If the option “regenerate” or “regenerate=y” is coded then all jobs that failed earlier and have not been completed successfully yet are rescheduled for execution for achieving conformity. If the option “regenerate=n” is coded then this rescheduling is now skipped.

If this option is not coded the option is not changed.

evaluateGroup

If the option “evaluateGroup” or “evaluateGroup=y” is coded then in case of a query group associated with the policy this group will be re-evaluated during the policy’s evaluation too. If “evaluationGroup=n” is coded then this re-evaluation of the group will not happen.

If this option is not coded the option is not changed.

evaluationStart

This option specifies a new earliest point in time when the evaluation of the policy will start. The value is specified in ISO format “YYYY-MM-DD hh:mm” where YYYY specifies the year, MM the month, DD the current day of month, hh the hour and mm the minute.

If this option is not coded the option is not changed.

globalTime

If “globalTime” or “globalTime=y” is specified then the time specifications with the policy are based on enterprise time. If “globalTime=n” is coded then the time is domain based.

If this option is not coded the option is not changed.

evaluationPeriod

This option specifies the new period in which the evaluations of the policy takes place. The value is specified in hours. If 0 is specified then the evaluation happens only once at seal.

If this option is not coded the option is not changed.

calendarname

This option specifies the name of a new calendar used by the SD for scheduling the time driven actions of the policy. If an empty string is entered then a possibly calendar entry is removed and calendars are no longer taken into account.

If this option is not coded the option is not changed.

{adhoc_disable|adhoc_only|adhoc_always}

This option specifies the new type of adhoc evaluation:

«not coded»

The adhoc evaluation type does not change.

adhoc_disable

No adhoc evaluation is provided any longer.

adhoc_only

The adhoc evaluation now starts when inventory reports of new or re-installed targets arrive.

ad_hoc_always

The adhoc evaluation now starts at any inventory report from targets.

comment

This option specifies the new comment on the software policy. If an empty string is coded then the old comment is removed.

If the option is not coded the comment remains unchanged.

seal

If “seal” or “seal=y” is coded then the policy is sealed after the modification has been completed otherwise it remains unsealed for further modifications. The seal is only performed when the modification has been successful and no error has been reported. Warnings do not suppress the seal.

If this option is not coded the option is not changed.

userMessage

Modifies the custom administrator message while updating the software policy properties.