Previous Topic: UnitGroupProperties2Next Topic: Array of Elements


More Information:

CreateSoftwareJobOrderPolicyProperties

CreateUnitGroupProperties3

You require the following properties for creating a group:

xsd:string groupLabel

Specifies the name of the group to be created.

xsd:string groupDescription

Specifies the description of the group.

xsd:boolean groupDescriptionSupplied

Specifies the True or False depending on the groupDescription value.

xsd:boolean membersInheritPermissions

Set the value to true if you want the group members to inherit the security permissions of the group.

xsd:boolean membersInheritPermissionsSupplied

Specifies the True or False depending on the membersInheritPermissions value.

xsd:string queryUUID

Specifies the uuid of the query that must be linked to the newly created group. If you do not specify, no query is linked to the group.

xsd:boolean queryUUIDSupplied

Specifies theTrue or false depending on the value of queryUUID.

xsd:string engineName

Specifies the name of the query evaluation engine to be associated with the unit group.

xsd:boolean engineNameSupplied

Specifies the True or False depending on the engineName value.

xsd:long evaluationPeriod

Specifies the Period, in which the query is evaluated, in minutes.

Default:

1440 minutes.

Limit:

10080 minutes.

xsd:boolean evaluationPeriodSupplied

Specifies the True or False depending on the value of evaluation period.

createAssessmentTemplate

The createAssessmentTemplate method creates an assessment template

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

AssessmentTemplate assessmentTemplate

Specifies the information required to create an assessment template. The assessment template name must be unique.

Return Values

Returns zero, if the assessment template is successfully created; otherwise, throws AutomationWebServiceException as a fault.

updateAssessmentTemplate

The updateAssessmentTemplate method updates an assessment template.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

xsd:string oldAssessmentTemplateName

Specifies the name of the old assessment template.

AssessmentTemplate assessmentTemplate

Specifies the information required to create an assessment template. The assessment template name must be unique.

Return Values

Returns zero, if the assessment template is successfully updated; otherwise, throws AutomationWebServiceException as a fault.

deleteAssessmentTemplates

The deleteAssessmentTemplates method deletes a list of assessment templates.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

xsd:string[] assessmentTemplateNames

Specifies the list of the assessment template names you want to delete.

Return Values

Returns zero on successful deletion of all the assessment templates; otherwise, throws AutomationWebServiceExceptionList as a fault.

getAssessmentTemplate

The getAssessmentTemplate method returns the properties of a specified assessment template.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

xsd:string assessmentTemplateName

Specifies the name of the assessment template you want to retrieve.

Return Values

AssessmentTemplate

Contains the properties of the assessment template on success; otherwise, throws AutomationWebServiceException as a fault.

getAssessmentTemplateList

The getAssessmentTemplateList method returns a list of assessment templates names and their last modified dates, based on the specified filter criteria.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

AssessmentTemplateFilter[] assessmentTemplateFilterArray

Specifies the filter condition on some of the assessment template properties.

xsd:boolean matchall

Specifies whether you want all the filter conditions to be satisfied. Set the parameter to True to perform an AND operation. Set the parameter to False to perform an OR operation.

dsm:ASSESSMENTTEMPLATEPROPERTY sortProperty

Specifies the property based on which you want to sort the results.

xsd:boolean sortAscending

Specifies whether you want to sort the list in ascending order.

int startIndex

Specifies an index number from which you want the objects to be returned from the result set. This is a zero based index.

int numberOfTemplatesRequired

Specifies the number of objects you want to retrieve from the startIndex position.

Return Values

GetTemplateListResponse

Returns a list of assessment templates names and their last modified dates, on success; otherwise, throws AutomationWebServiceException as a fault.

More information:

AssessmentTemplateFilter

GetTemplateListResponse

ASSESSMENTTEMPLATEPROPERTY

getAssessmentTemplateListDetailed

The getAssessmentTemplateListDetailed method returns a list of assessment templates and their details based on the specified filter criteria.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

AssessmentTemplateFilter[] assessmentTemplateFilterArray

Specifies the filter on some of the assessment template properties.

xsd:boolean matchall

Specifies whether you want all the filter conditions to be satisfied. Set the parameter to True to perform an AND operation. Set the parameter to False to perform an OR operation.

enum ASSESSMENTTEMPLATEPROPERTY sortProperty

Specifies the property based on which you want to sort the results.

xsd:boolean sortAscending

Specifies whether you want to sort the list in ascending order.

int startIndex

Specifies an index number from which you want the objects to be returned from the result set. This is a zero based index.

int noOfTemplatesRequired

Specifies the number of objects you want to retrieve from the startIndex position.

Return Values

GetAssessmentTemplateListDetailedResponse

Returns the list of Assessment templates, filtered and sorted as specified.

More information:

AssessmentTemplateFilter

ASSESSMENTTEMPLATEPROPERTY

GetAssessmentTemplateListDetailedResponse

createAssessmentTask

The createAssessmentTask method creates an assessment job.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

xsd:string groupName

Specifies the name of group to be assessed.

AssessmentTask assessmentTask

Specifies the information required to create an assessment task. The assessment task name must be unique.

Return Values

Returns zero, if the assessment template is successfully created; otherwise, throws AutomationWebServiceException as a fault.

executeAssessmentTask

The executeAssessmentTask method runs an assessment job.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

xsd:string assessmentTaskName

Specifies the name of the assessment task you want to run.

Return Values

Returns zero, if the assessment task is successfully executed; otherwise, throws AutomationWebServiceException as a fault.

getAssessmentStatus

The getAssessmentStatus method returns the status of assessment for a particular assessment task.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

xsd:string assessmentTaskName

Specifies the name of the assessment task.

Return Values

AssessmentStatus

Returns the status of assessment for the assessment task; otherwise, throws AutomationWebServiceException as a fault.

More information:

AssessmentStatus

getAssessmentResult

The getAssessmentResult method gets the results of the assessment task.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

xsd:string assessmentTaskName

Specifies the name of the assessment task, the results of which you want to retrieve.

Return Values

AssessmentResult[] assessmentResult

Returns the assessment results of the executed assessment task on success; otherwise, throws AutomationWebServiceException as a fault.

More information:

AssessmentResult

getAssessmentTask

The getAssessmentTask method returns information about the assessment task.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

xsd:string assessmentTaskName

Specifies assessment task name for which you need the information.

Return Values

Returns the following sequence as a response on success; otherwise, throws AutomationWebServiceException as a fault.

AssessmentTaskInfo assessmentTaskInfo

Contains information about the assessment task.

More information:

AssessmentTaskInfo

getAssessmenTaskList

The getAssessmenTaskList method returns information about all assessment tasks, based on the specified filter and sort criteria.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

AssessmentTaskFilter[] assessmentTaskFilterArray

Specifies the filter on some of the assessment task properties.

xsd:boolean matchall

Specifies whether you want all the filter conditions to be satisfied. Set the parameter to True to perform an AND operation. Set the parameter to False to perform an OR operation.

enum ASSESSMENTTASKPROPERTY sortProperty

Specifies the property based on which you want to sort the results.

xsd:boolean sortAscending

Specifies whether you want to sort the list in ascending order.

int startIndex

Specifies an index number from which you want the objects to be returned from the result set. This is a zero based index.

int noOfTemplatesRequired

Specifies the number of objects you want to retrieve from the startIndex position.

Return Values

Returns the following sequence on success; otherwise, throws AutomationWebServiceException as a fault.

GetAssessmentTaskListResponse

Returns the list of assessment tasks based on the mentioned filter and sort properties.

More information:

AssessmentTaskFilter

GetAssessmentTaskListResponse

ASSESSMENTTASKPROPERTY

deleteAssessmentTasks

The deleteAssessmentTasks method deletes a list of assessment tasks.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

xsd:string [] assessmentTaskName

Specifies the list of the assessment task names you want to delete.

Return Values

Returns zero on successful deletion of all the assessment tasks; otherwise, throws AutomationWebServiceExceptionList as a fault.

createOSIMTemplate

The createOSIMTemplate method creates an OSIM Template.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

OsimTemplate OSIMTemplate

Specifies attributes required to create the OSIM template.

Return Values

Returns zero on successful creation of OSIM template; otherwise, throws AutomationWebServiceException as a fault.

updateOSIMTemplate

The updateOSIMTemplate method updates an OSIM template.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

Xsd:string oldOsimTemplateName

Specifies the name of the old OSIM template.

OsimTemplate OSIMTemplate

Specifies attributes required to update an OSIM template.

Return Values

Returns zero on successful update of OSIM template; otherwise, throws AutomationWebServiceException as a fault.

deleteOSIMTemplates

The deleteOSIMTemplates method deletes a list of OSIM templates.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

xsd:string [] OSIMTemplateNames

Specifies the list of OSIM template names you want to delete.

Return Values

Returns zero on successful deletion of all templates; otherwise, throws AutomationWebServiceExceptionList as a fault.

getOSIMTemplate

The getOSIMTemplate method returns the properties of an OSIM template.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

xsd:string OSIMTemplateName

Specifies OSIM template name for which you want to retrieve the properties.

Return Values

Returns the following sequence on success; otherwise, throws AutomationWebServiceException as a fault.

OsimTemplate

Returns OSIM template properties.

getOSIMTemplateList

The getOSIMTemplateList method returns a list of OSIM template names and their last modified date, based on the specified filter and sort criteria.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

OsimTemplateFilter[] OSIMTemplateFilterArray

Specifies the filter condition on the OSIM template properties.

xsd:boolean matchall

Specifies whether you want all the filter conditions to be satisfied. Set the parameter to True to perform an AND operation. Set the parameter to False to perform an OR operation.

enum OSIMTEMPLATEPROPERTY sortProperty

Specifies the property based on which you want to sort the results.

xsd:boolean sortAscending

Specifies whether you want to sort the list in ascending order.

int startIndex

Specifies an index number from which you want the objects to be returned from the result set. This is a zero based index.

int noOfTemplatesRequired

Specifies the number of objects you want to retrieve from the startIndex position.

Return Values

Returns the following sequence on success; otherwise, throws AutomationWebServiceException as a fault.

GetTemplateListResponse

Contains a list of OSIM template names and their last modified date.

More information:

GetTemplateListResponse

OsimTemplateFilter

OSIMTEMPLATEPROPERTY

getOsimTemplateListDetailed

The getOsimTemplateListDetailed method returns the OSIM templates objects list, based on filter and sort criteria.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

OsimTemplateFilter[] OSIMTemplateFilterArray

Specifies the filter condition on the OSIM template properties.

xsd:boolean matchall

Specifies whether you want all the filter conditions to be satisfied. Set the parameter to True to perform an AND operation. Set the parameter to False to perform an OR operation.

enum OSIMTEMPLATEPROPERTY sortProperty

Specifies the property based on which you want to sort the results.

xsd:boolean sortAscending

Specifies whether you want to sort the list in ascending order.

int startIndex

Specifies an index number from which you want the objects to be returned from the result set. This is a zero based index.

int noOfTemplatesRequired

Specifies the number of objects you want to retrieve from the startIndex position.

Return Values

Returns the following sequence on success; otherwise, throws AutomationWebServiceException as a fault.

GetOsimTemplateListDetailedResponse

Specifies the list of OSIM templates with all fields based on the mentioned filter and sort properties.

More information:

OsimTemplateFilter

OSIMTEMPLATEPROPERTY

GetOsimTemplateListDetailedResponse

createSoftwareDeploymentTemplate

The createSoftwareDeploymentTemplate method creates a software deployment template.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

SoftwareDeploymentTemplate swDeployTemplate

Specifies the properties required to create software deployment template.

Return Values

Returns zero on successful creation of software deployment template; otherwise, throws AutomationWebServiceException as a fault.

More information:

SoftwareDeploymentTemplate

updateSoftwareDeploymentTemplate

The updateSoftwareDeploymentTemplate method updates a software deployment template.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

Xsd:string oldSDTemplateName

Specifies the name of the old software deployment template.

SoftwareDeploymentTemplate swDeployTemplate

Specifies properties you want to update in the software deployment template.

Return Values

Returns zero on successful update of the template; otherwise, throws AutomationWebServiceException as a fault.

More information:

SoftwareDeploymentTemplate

deleteSoftwareDeploymentTemplates

The deleteSoftwareDeploymentTemplates method deletes a list of software deployment templates.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

xsd:string [] softwareDeploymentTemplateNames

List of software deployment template names you want to delete.

Return Values

Returns zero on successful deletion of all the software deployment templates; otherwise, throws AutomationWebServiceExceptionList as a fault.

getSoftwareDeploymentTemplate

The getSoftwareDeploymentTemplate method gets the properties of a software deployment template.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

xsd:string swDeployTemplateName

Specifies the name of the software deployment template for which you want to retrieve the properties.

Return Values

Returns the following sequence on success; otherwise, throws AutomationWebServiceException as a fault.

SoftwareDeploymentTemplate

Returns software deployment template properties.

More information:

SoftwareDeploymentTemplate

getSoftwareDeploymentTemplateList

The getSoftwareDeploymentTemplateList method returns a list of software template names and their last modified date, based on filter and sort criteria specified.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

SoftwareDeploymentTemplateFilter[] sdTemplateFilterArray

Specifies the filter condition on the properties of the software deployment template.

xsd:boolean matchall

Specifies whether you want all the filter conditions to be satisfied. Set the parameter to True to perform an AND operation. Set the parameter to False to perform an OR operation.

enum SOFTWAREDEPOYMENTTEMPLATEPROPERTY sortProperty

Specifies the property based on which you want to sort the results.

xsd:boolean sortAscending

Specifies whether you want to sort the list in ascending order.

int startIndex

Specifies an index number from which you want the objects to be returned from the result set. This is a zero based index.

int numberOfTemplatesRequired

Specifies the number of objects you want to retrieve from the startIndex position.

Xsd:boolean refreshList

Specifies whether you want to recompute the result set for each call.

Return Values

Returns the following sequence on success; otherwise, throws AutomationWebServiceException as a fault.

GetTemplateListResponse

Contains a list of software template names and their last modified date.

More information:

SoftwareDeploymentTemplateFilter

getSoftwareDeploymentTemplateListDetailed

The getSoftwareDeploymentTemplateListDetailed method returns the software deployment templates object list based on filter and sort criteria specified.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

SoftwareDeploymentTemplateFilter[] sdTemplateFilterArray

Specifies the filter condition on the properties of the software deployment template.

xsd:boolean matchall

Specifies whether you want all the filter conditions to be satisfied. Set the parameter to True to perform an AND operation. Set the parameter to False to perform an OR operation.

enum SOFTWAREDEPLOYMENTTEMPLATEPROPERTY sortProperty

Specifies the property based on which you want to sort the results.

xsd:boolean sortAscending

Specifies whether you want to sort the list in ascending order.

int startIndex

Specifies an index number from which you want the objects to be returned from the result set. This is a zero based index.

int numberOfTemplatesRequired

Specifies the number of objects you want to retrieve from the startIndex position.

Return Values

Returns the following sequence on success; otherwise, throws AutomationWebServiceException as a fault.

GetSoftwareDeploymentTemplateListDetailedResponse

Contains the list of software templates along with their details, retrieved based on the specified filter and sort properties.

More information:

SoftwareDeploymentTemplateFilter

SOFTWAREDEPLOYMENTTEMPLATEPROPERTY

GetSoftwareDeploymentTemplateListDetailedResponse

createAutomationProcess

The createAutomationProcess method creates an automation process (migration job).

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

AutomationProcess automationProcess

Specifies the properties of the automation process.

xsd:string [] listOfgroupNames

Specifies a list of computer groups to be migrated.

xsd:string [] listOfComputerNames

Specifies a list of computers to be migrated.

DataHandler dataHandler

Specifies the handle to the machine mapping file.

Return Values

Returns zero on successful initiation of job creation task else throws Automation Web Service Exception.

deleteAutomationProcesses

The deleteAutomationProcesses method deletes a list of automation processes.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

xsd:string [] automationProcessNames

Specifies the list of automation process names you want to delete.

Return Values

Returns zero on successful deletion of all processes; otherwise, throws AutomationWebServiceExceptionList as a fault.

More information:

ActionType

executeAutomationProcess

The executeAutomationProcess method initiates the migration or revalidation of an automation process.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

xsd:string automationProcessName

Specifies the name of the automation process you want to execute.

enum actionType action

Specifies the type of action.

Return Values

Returns zero on successful execution; otherwise, throws AutomationWebServiceException as a fault.

getAutomationProcessList

The getAutomationProcessList method returns basic information about the automation processes, based on the filtering criteria.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

AutomationProcessFilter[] apTemplateFilter

Specifies the filter condition on some of the properties of the automation process.

xsd:boolean matchall

Specifies whether you want all the filter conditions to be satisfied. Set the parameter to True to perform an AND operation. Set the parameter to False to perform an OR operation.

enum AUTOMATIONPROCESSPROPERTY sortProperty

Specifies the property based on which you want to sort the results.

xsd:boolean sortAscending

Specifies whether you want to sort the list in ascending order.

int startIndex

Specifies an index number from which you want the objects to be returned from the result set. This is a zero based index.

int noOfAutomationProcessesRequired

Specifies the number of objects you want to retrieve from the startIndex position.

Return Values

Returns the following sequence on success; otherwise, throws AutomationWebServiceException as a fault.

GetAutomationProcessListResponse

Returns a list automation process names and their last modified date.

More information:

AutomationProcessFilter

GetAutomationProcessListResponse

AUTOMATIONPROCESSPROPERTY

getAutomationProcessListDetailed

The getAutomationProcessListDetailed method returns a list of automation process names and their last modified dates, based on the filtering criteria.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

AutomationProcessFilter[] apTemplateFilterArray

Specifies the filter condition on some of the properties of the automation process.

xsd:boolean matchall

Specifies whether you want all the filter conditions to be satisfied. Set the parameter to True to perform an AND operation. Set the parameter to False to perform an OR operation.

enum AUTOMATIONPROCESSPROPERTY sortProperty

Specifies the property based on which you want to sort the results.

xsd:boolean sortAscending

Specifies whether you want to sort the list in ascending order.

int startIndex

Specifies an index number from which you want the objects to be returned from the result set. This is a zero based index.

int noOfAutomationProcessesRequired

Specifies the number of objects you want to retrieve from the startIndex position.

Return Values

Returns the following sequence on success; otherwise, throws AutomationWebServiceException as a fault.

GetAutomationProcessListDetailedResponse

Returns the properties of the filtered automation processes.

More information:

AutomationProcessFilter

GetAutomationProcessListDetailedResponse

AUTOMATIONPROCESSPROPERTY

getAutomationResult

The getAutomationResult method returns the result of the automation process.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

xsd:string automationProcessName

Specifies the automation process name for which you want to retrieve the results.

Return Values

Returns the following sequence on success; otherwise, throws AutomationWebServiceException as a fault.

AutomationResultResponse

Contains the automation process results.

getAutomationResult2

The getAutomationResult2 method returns the results of the automation process. This methods supports sort and filtering operations.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

xsd:string automationProcessName

Specifies the automation process name for which you want to retrieve the results.

AutomationResultFilter [] automationResultFilter

Specifies the filter on some of the automation result properties.

xsd:boolean matchall

Specifies whether you want all the filter conditions to be satisfied. Set the parameter to True to perform an AND operation. Set the parameter to False to perform an OR operation.

enum AutomationResultProperty sortProperty

Specifies the property based on which you want to sort the results.

xsd:boolean sortAscending

Specifies whether you want to sort the list in ascending order.

int startIndex

Specifies an index number from which you want the objects to be returned from the result set. This is a zero based index.

xsd:int numberOfRecordsRequired

Specifies the number of objects you want to retrieve from the startIndex position.

Return Values

Returns the following sequence on success; otherwise, throws AutomationWebServiceException as a fault.

AutomationResultResponse

Contains the automation process results.

More information:

AutomationResultResponse

AutomationResultProperty

getAutomationProcessTargetStatus

The getAutomationProcessTargetStatus method returns the migration status for the specified target computer.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

xsd:string automationProcessName

Specifies the automation process name. The process name must be a valid and the automation process must at least be in the Validation phase. Otherwise, an error message "No Activity information available" is returned.

xsd:string targetName

Specifies the target computer name.

xsd: string sourceName

Specifies the source computer name.

xsd: string targetUUID

Specifies the UUID of the target computer.

xsd: string sourceUUID

Specifies the UUID of the source computer.

xsd: string processInstanceName

Specifies the IT PAM process instance name.

AutomationTargetStatus status

Specifies the migration status of the target computer.

Return Values

Returns Automation Process Target Status on success; otherwise, throws AutomationWebServiceException as a fault.

More information:

AutomationTargetStatus

getAutomationProcessStatus

The getAutomationProcessStatus method returns the migration job status.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

xsd:string automationProcessName

Specifies the automation process name. The process name must be a valid and the automation process must at least be in the Validation phase. Otherwise, an error message "No Activity information available" is returned.

Return Values

Returns the automation process status; otherwise, throws AutomationWebServiceException as a fault.

runAutomationSoftwareJobContainer

The runAutomationSoftwareJobContainer method launches the software job container execution from CA IT PAM process.

Note: This method can only be called from a workflow within CA IT PAM process and cannot be used as a standalone method.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

xsd: int containerType

Specifies whether to run the preinstall or postinstall job container. Following are valid values:

0 (GENERIC)

Defines a generic job container. When this parameter is set, the generic job execution is initiated, using the information provided in SD template.

1 (PREINSTALL)

Defines a pre-install job container. When this parameter is set, the pre-install job execution is initiated, using the information provided in SD template.

2 (POSTINSTALL)

Defines a post-install job container. When this parameter is set, the post-install job execution is initiated, using the information provided in SD template.

xsd:string AutomationTaskUUID

Specifies the ID of the automation job which has spawned the CA IT PAM process.

xsd:string machineUUID

Specifies the UUID of the computer participating in automated migrations. This ID identifies an CA IT PAM instance launched for the computer. This ID is unique for each computer participating in the automation job.

Return Values

Returns the following information on success; otherwise, throws AutomationWebServiceException as a fault.

xsd:string jobId

Contains a handle that is used in subsequent calls related to automation job container. There will be one unique automation service JobID per computer regardless of how the jobs are optimized in Client Automation.

runAutomationOSInstallJob

The runAutomationOSInstallJob method launches the OS deployment execution from CA IT PAM process.

Note: This method can only be called from a workflow within CA IT PAM process and cannot be used as a standalone method.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

xsd:string AutomationTaskUUID

Specifies the ID of the automation job which has spawned this CA IT PAM process.

xsd:string machineUUID

Specifies the UUID of the computer participating in automated migrations. This ID identifies an CA IT PAM instance launched for the computer. This ID is unique for each computer, participating in an automation job.

Return Values

Returns the following information on success; otherwise, throws AutomationWebServiceException as a fault.

xsd:string jobId

Contains a handle that is used in subsequent calls related to automation job container.

runAutomationGenericJobContainer

The runAutomationGenericJobContainer method executes the automation generic job container. This method will be called from CA IT PAM process. Once a job is scheduled for execution, the job cannot be rerun because the JobID cannot be used to rerun the job. This eliminates the need to call a method to close the generic job container. Based on the BatchMode, the success status of the generic job container is determined.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

xsd:string automationTaskUUID

Specified the ID that identifies the automation job that has spawned this ITPAM process.

xsd:string machineUUID

Specifies the ID that identifies the machine participating in automated migrations. Automation services provides this ID to ITPAM process instance.

SoftwareContainerData softwareContainerData,

Specifies software container data.

SoftwareJobData softwareJobData

Specifies software job data.

Return Values

Returns the following information on success; otherwise, throws AutomationWebServiceException as a fault.

xsd:string jobId

Contains a handle that is used in subsequent calls related to automation generic job container.

More information:

SoftwareContainerData

SoftwareJobData

getActivityLog

The getActivityLog method provides the activity log for a computer participating in the automation process, identified by computer name.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

xsd:string automationProcessName

Specifies the automation process name. The process name must be a valid and the automation process must at least be in the Validation phase. Otherwise, an error message "No Activity information available" is returned.

xsd:String machineName

Specifies the computer name for which activity log is required. The computer name must be valid, and must be the original name of the machine. For example, if machine Test001-XP was submitted for Win7 deployment and is being renamed as Test001-W7, then this parameter should be Test001-XP. Otherwise an error "Invalid machine name" is returned.

Return Values

Returns the following sequence on success; otherwise, throws AutomationWebServiceException as a fault.

ActivityLog

Contains the ActivityLog, which provide chronically ordered activities for each requested state.

getActivityLog2

The getActivityLog2 method provides the activity log for a computer participating in the automation process, identified by the computer UUID.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

xsd:string automationProcessName

Specifies the automation process name. The process name must be a valid and the automation process must at least be in the Validation phase. Otherwise, an error message "No Activity information available" is returned.

xsd:String machineUUID

Specifies the computer UUID for which activity log is required.

Return Values

Returns the following sequence on success; otherwise, throws AutomationWebServiceException as a fault.

ActivityLog

Contains the ActivityLog, which provide chronically ordered activities for each requested state.

setActivationStatus

The setActivationStatus method enables or disables a list of computers for migrations.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

xsd:string automationProcessName

Specifies the automation process name. The process name must be a valid and the automation process must at least be in the Validation phase. Otherwise, an error message "No Activity information available" is returned.

xsd:string [] listOfComputers

Specifies the list of computers on which you want to enable or disable migration.

boolean enableForMigration

Specifies whether you want to enable the list of computer for migration.

Return Values

Returns 0 on success; otherwise, throws AutomationWebServiceException as a fault.

getSupportedOSForAssessment

The getSupportedOSForAssessment method returns a list of OS family ClassIDs supported for assessment.

Parameters

xsd:string sessionId

Specifies the session ID obtained from the DSM web services login.

Return Values

Returns the list of following sequence on success; otherwise, throws AutomationWebServiceException as a fault.

OperatingSystemType

Contains operating system name and its classID.

More information:

OperatingSystemType

SDTemplateProperties

The SDTemplateProperties sequence includes the properties of CA Service Desk templates.

Xsd:string templateName

Specifies the template Name.

Xsd:string templateId

Specifies the template ID.

SoftwarePackageFilter

The BootServerFilter sequence specifies a search filter that you can use for searching or listing boot servers.

dsm:FILTERCONDITION condition

Specifies the filter condition you want to apply.

dsm:SoftwarePackageProperty biProperty

Specifies the property you want to filter.

xsd:string searchString

Specifies the string you want to search in the name property.

dsm: DateTime2 dateTime

Specifies the date and time value you want to search in the last modified date property.

Xsd:long searchValue

Specifies the search value for xsd:long type properties.

dsm:SoftwarePackagingType pkgType

Specifies the search value for dsm:SoftwarePackagingType type properties.

dsm: PackageFormat format

Specifies the search value for dsm:PackageFormat type properties.

dsm: SoftwarePackageFiledBy filedBy

Specifies the search value for dsm: SoftwarePackageFiledBy type properties.

dsm: ArchivePath archivedAt

Specifies the search value for dsm:ArchivePath type properties.

SoftwarePackageProperties2

The SoftwarePackageProperties2 sequence contains the software package properties.

xsd:string softwarePackageId

Specifies the UUID identifying the software package.

xsd:string softwarePackageName

Specifies the name of the software package.

xsd:string softwarePackageVersion

Specifies the version of the software package.

xsd:string basedOnSoftwarePackageId

Specifies the UUID of the software package based on which this software package is created or from which this software package is imported. A software package can be created or imported based on another software package.

xsd:string basedOnSoftwarePackageName

Specifies the name of the software package based on which this software package is created or from which this software package is imported. A software package can be created or imported based on another software package.

xsd:string basedOnSoftwarePackageVersion

Specifies the version of the software package based on which this software package is created or from which this software package is imported. A software package can be created or imported based on another software package.

xsd:string supplier

Specifies the vendor of the software package.

xsd:string comment

Specifies the comment for the software package.

xsd:string sourcePath

Specifies the package source path.

dsm:SoftwarePackageType softwarePackageType

Specifies the type of software package.

xsd:boolean userSelectable

Specifies whether the package is selectable from the SD Catalog.

dsm:SourceMedium softwarePackageDataSource

Specifies the source medium for the software package data source.

dsm:SoftwarePackageFiledBy softwarePackageFiledBy

Specifies the user who created the software package.

dsm:DateTime registrationDateTime

Specifies the date and time the software package was created.

dsm:DateTime changeDateTime

Specifies the date and time the software package was last changed.

dsm:SoftwarePackagingType packageType

Specifies the type of the software package. The only type of package you can create is a GENERIC package type.

xsd:long packetSize

Specifies the package size.

xsd:long buildOnSize

Specifies the build on size of the package.

xsd:string archivePath

Specifies the archive path of the package, if the package is archived.

xsd:string archiveComment

Specifies the archive comment, if the package is archived.

xsd:string archivedBy

Specifies the user who performed the archive, if the package is archived.

dsm:ArchivePath archiveFlag

Specifies the archive flag of the package, if the package is archived.

dsm:DateTime archDateTime

Specifies the date and time when the package was archived, if the package is archived.

SDProperties

The SDProperties sequence includes the software delivery properties of a computer.

xsd:string jobCalendar

Specifies the name of the job calendar, if any.

xsd:Boolean softwareManagedSystem

Specifies whether to push only the packages created by CA software packager to the computer.

dsm:RACPolicy racPolicy

Specifies the RAC Policy for the computer.

dsm:DownloadMethod downloadMethod

Specifies the download method configured for the computer.

ManagerProperties

The ManagerProperties sequence includes the manager properties.

xsd:string managerUUID

Specifies the UUID of the manager.

xsd:boolean isEnterprise

Specifies whether the manager is an enterprise manager or domain manager.

xsd:string language

Specifies the installed language on manager.

dsm:ManagerVersion version

Specifies the manager version.

ManagerVersion

The ManagerVersion sequence specifies the different versions of the manager that are retrieved.

xsd:int majorVersion

Specifies the Client Automation major version on the manager.

xsd:int minorVersion

Specifies the Client Automation minor version on the manager.

xsd:int buildNumber

Specifies the Client Automation build number on the manager.

xsd:int patchNumber

Specifies the Client Automation patch number on the manager.

CreateSoftwareJobContainerProperties4

The CreateSoftwareJobContainerProperties4 sequence of elements specifies the job container properties you want initialize when a software job container is created. This sequence is derived from the CreateSoftwareJobContainerProperties3 sequence and includes additional parameters for opening a CA Service Desk ticket when a job fails.

xsd: string parentSoftwareJobContainerId

Specifies the parent software job container ID. If no value is provided, the root “__SD_Jobs” is used as the parent.

xsd:boolean parentSoftwareJobContainerIdSupplied

Specifies true or false depending on whether the parentSoftwareJobContainerId parameter is supplied.

xsd:string name (m)

Specifies the name of the software job container.

xsd:string comment

Specifies the comment for the software job container.

xsd:boolean commentSupplied

Specifies true or false depending on whether the comment parameter is supplied.

xsd:long priority

Specifies the priority that can range from 1 (highest) to 10 (lowest), If no value is provided, the default value, 5, is used.

xsd:long prioritySupplied

Specifies true or false depending on whether the priority parameter is supplied.

SoftwareJobContainerPropertyMask softwareJobContainerPropertyMask

Specifies the mask for the software job container property. If no value is provided, the default value, linkageBatch and Cascade, is used.

xsd:boolean softwareJobContainerPropertyMaskSupplied

Specifies true or false depending on whether the softwareJobContainerPropertyMask parameter is supplied.

xsd:string userMessage

Specifies the custom administrator message.

xsd:int userMessageSupplied

Checks whether or not the custom administrator message is provided.

Xsd:boolean openTicketOnFailure

Specifies whether to create a CA Service Desk ticket on failure of jobs in job container.

Xsd:String templateName

Specifies the name of the CA Service Desk ticket template for creating ServiceDesk requests. Set this parameter only if you have set the openTicketOnFailure parameter to True.

BootImageFilter

The BootImageFilter sequence specifies a search filter that you can use for searching or listing boot images.

dsm:FILTERCONDITION condition

Specifies the filter condition you want to apply.

dsm: BootImageProperty biProperty

Specifies the property you want to filter.

xsd:string searchString

Specifies the string you want to search in the name property.

dsm: DateTime2 dateTime

Specifies the date and time value you want to search in the last modified date property.

BootImageProperties

The BootImageProperties sequence specifies the boot image properties.

xsd:string bootImageName

Specifies the name of the boot image.

Xsd:string typeIndicator

Specifies the type of the boot image.

Xsd:string platform

Specifies the operating system of the boot image.

dsm:DateTime2 registeredDateTime

Specifies the date and time of the boot image registration.

Xsd:string sdPackageName

Specifies the software delivery package associated with the boot image.

Xsd:string sdPackageVersion

Specifies the version of the software delivery package associated with the boot image.

Xsd:string sdPackageComment

Specifies the comment included in the software delivery package associated with the boot image.

Xsd:string imageFlags

Specifies the FIPS image flag associated with the boot image.

BootServerProperties

The BootServerProperties sequence contains the boot server properties.

xsd:string serverName

Specifies the boot server name.

Xsd:string bsStatus

Specifies the boot server status.

Xsd:string platform

Specifies the operating system of the boot server.

Xsd:string nfsSupport

Specifies the NFS support for boot server.

Xsd:string accessMethod

Specifies the access method configured for the boot server.

dsm:DateTime2 lastReport

Specifies the date and time of last boot server report.

dsm:DateTime2 lastResponse

Specifies the date and time of last boot server response.

dsm:DateTime2 lastReportReq

Specifies the date and time when the last boots server was requested.

Xsd:string pxeInterfaces

Specifies the configured PXE interface.

Xsd:string sdPkgWin

Specifies the software delivery package name for Windows.

Xsd:string sdPkgLinux

Specifies the software delivery package name for Linux.

Xsd:string sdPkgR11

Specifies the software delivery package for r11 version.

OSIMTargetProperties2

The OSIMTargetProperties includes the following parameters:

xsd:string targetName

Specifies the name of the target computer.

xsd:string targetMACAddress

Specifies MAC address of the target computer.

dsm:WS-OSIM-CONFIG-STATE configType

Specifies the configuration state of the target computer.

dsm:DateTime2 stateChangedDateTime

Specifies the changed or activated date and time of the target computer.

xsd:string imageName

Specifies the name of the OS image.

Xsd:string createdDateTime

Specifies the created date and time of the target computer.

OSIMTargetProperties

The following are the OSIMTargetProperties:

xsd:string targetName

Specifies the name of the target computer.

xsd:string targetMACAddress

Specifies MAC Address of the target computer.

dsm:WS-OSIM-CONFIG-STATE configType

Specifies the configuration state of the target computer.

dsm:DateTime2 stateChangedDateTime

Specifies the changed or activated date and time of the target computer.

xsd:string imageName

Specifies the name of the OS image.

BootServerFilter

The BootServerFilter sequence specifies a search filter that you can use for searching or listing boot servers.

dsm:FILTERCONDITION condition

Specifies the filter condition you want to apply.

dsm: BootServerProperty biProperty

Specifies the property you want to filter.

xsd:string searchString

Specifies the string you want to search in the name property.

dsm: DateTime2 dateTime

Specifies the date and time value you want to search in the last modified date property.

ComputerProperties2

The following sequences of elements specify the properties required when you are retrieving the properties of a computer.

xsd:string computerUUID

Specifies the UUID of the computer.

xsd:string computerLabel

Specifies the display name of the computer.

xsd:string computerDomainUUID

Specifies the UUID identifying the Client Automation domain of the computer.

xsd:string computerPrimaryNetworkAddress

Specifies the IP address of the computer in 0.0.0.0 format.

xsd:string computerHostUUID

Specifies the agent-generated UUID that identifies the computer.

xsd:string computerAssetSourceUUID

Specifies the UUID identifying the common CA asset to which this computer is linked.

xsd:string computerHostName

Specifies the host name of the computer.

xsd:string computerSerialNumber

Specifies the serial number of the computer.

xsd:string computerDiscSerialNumber

Specifies the serial number of the computer disc.

xsd:string computerPrimaryMACAddress

Specifies the MAC address of the computer. The string must have a maximum length of 64 characters.

xsd:string computerAssetTag

Specifies the string value that identifies a computer asset.

xsd:long computerClassID

Specifies the numeric value indicating the class of the computer object. For example, Operating System.

dsm:UsageListMask computerUsageList

Specifies the computer usage list mask.

xsd:string computerURI

Specifies the fully qualified Uniform Resource Identifier of the computer.

xsd:string computerSystemID

Specifies the user-defined identifier for computer.

xsd:string computerVendorName

Specifies the name of the computer vendor.

xsd:string computerDomainLabel

Specifies the display name of the DSM domain to which the computer belongs.

xsd:string computerCreationUser

Specifies the name of the user account that created the computer record.

dsm:DateTime computerCreationDate

Specifies the computer creation date and time.

xsd:string computerLastUpdatedUser

Specifies the name of the user account that last updated the computer properties.

dsm:DateTime computerLastUpdatedDate

Specifies the date and time when the computer properties were last updated.

xsd:long computerVersionNumber

Specifies the version number of the computer record.

Note: The version number is incremented each time a record is updated.

xsd:string agentName

Specifies the agent name of the computer.

xsd:long agentRestrictions

Specifies the agent restrictions.

xsd:string agentDescription

Specifies the agent description.

xsd:string userdata1

Specifies the user defined data1.

xsd:string userdata2

Specifies the user defined data2.

xsd:string userdata3

Specifies the user defined data3.

xsd:string userdata4

Specifies the user defined data4.

xsd:string scalabilityserverName

Specifies the name of the scalability server that the agent is pointing to.

dsm:DateTime2 agentCreationDateTime

Specifies the agent creation data and time.

dsm:DateTime2 lastRunDateTime

Specifies the agent last run date and time.

xsd:string agentIPAddress

Specifies the IP address of the agent.

xsd:long agentTrustlevel

Specifies the trust level of the agent.

xsd:string agentOrigin

Specifies the origin of the agent.

dsm:AMAgentStatus amStatus

Specifies the AM Agent status.

dsm:SDAgentStatus sdStatus

Specifies the SD Agent status.

dsm:RCAgentStatus rcStatus

Specifies the RC Agent status.

dsm:ProtectionStatus protectionStatus

Specifies the Protection Agent status.

dsm:ASPStatus aspStatus

Specifies the ASP status.

dsm:AVStatus avStatus

Specifies the AV status.

dsm:HIPSStatus hipsStatus

Specifies the HIPS status.

QueryFilter

The QueryFilter sequence specifies a search filter that you can use for searching or listing queries.

dsm: QueryFilterCondition filterCondition

Specifies the filter condition you want to apply.

dsm: QueryProperty queryProperty

Specifies the property you want to filter.

xsd:string searchString

Specifies the string you want to search in the name property.

dsm: QueryTargetType targetType

Specifies the query target type.

QueryProperties2

The QueryProperties2 sequence contains the properties of a query.

xsd:string queryUUID

Specifies the UUID of the query.

Xsd:string queryName

Specifies the name of the query.

dsm: QueryTargetType queryType

Specifies the type of the query.

Xsd:boolean replicated

Specifies whether is query is replicated from enterprise manager. If true, it indicates that the query is replicated from enterprise manager.

QueryProperty

The QueryProperty sequence specifies the query properties on which you can apply the sort and filter conditions.

QUERY-LABEL

Specifies the name of the query.

QUERY-TARGET-TYPE

Specifies the target type of the query.

QueryFolderProperties

The QueryFolderProperties sequence contains the properties of a query folder.

Xsd:string folderName

Specifies the name of the query folder.

Xsd: long folderId

Specifies the ID of the query folder.

HWModelFilter

The HWModelFilter sequence specifies a search filter that you can use for searching or listing unique hardware models.

dsm: HWMODEL-FILTER-CONDITION filterCondition

Specifies the filter condition you want to apply.

xsd:string searchString

Specifies the string you want to search in the hardware model name.

Health Monitoring Sequences

UpdateAlertsProperties

The properties of the HM Alert to be updated.

xsd:boolean updateState.

Specifies the state of alert. When set to false, the state of the alert is not updated. However, the userMessage is modified.

xsd:boolean ignorePreviousState.

Defines the state of alert. When set to true, no error message is seen when new state of alert matches with the old state.

dsm:ALERTSTATE alertstate.

Indicates enumerated elements (New = 0, FollowUp = 1 and Cleared = 2), to change the state of the HM Alert.

xsd:boolean updateUserMessage.

Specifies True or False depending on the value of userMessage.

xsd:string userMessage.

Indicates the user description with the HM Alert.

Sequences for Automation Web Services

The Automation Services uses the sequences listed in the subsequent section for automated OS migration functionality.

AssessmentTemplate

The AssessmentTemplate sequence contains the properties of an assessment template. You can use this sequence to refer to a new or existing template.

xsd:string name

Specifies the name of the assessment template.

dsm:AssessmentTemplateType assessmentTemplatetype

Specifies the assessment template type.

dsm:ArrayOfOperatingSystemType operatingSystemsArray

Specifies an array of operating system types.

dsm:ArrayOfParameter parameters

Specifies the assessment attributes supplied, which needs to be used for assessment. There could be ‘n’ number of parameters. However each type of assessment will use only a fixed set of parameters.

xsd:DateTime lastModifiedDate

Retrieves the last updated date of the template. This parameter contains null value for createAssessmentTemplate and updateAssessmentTemplate methods.

xsd:DateTime creationDate

Retrieves the creation date of the template. This parameter contains null value for createAssessmentTemplate and updateAssessmentTemplate methods.

xsd:String lastModifiedUser

Retrieves the last modified user of the template. This parameter contains null value for createAssessmentTemplate and updateAssessmentTemplate methods.

xsd:String creationUser

Retrieves the creation user of the template. This parameter contains null value for createAssessmentTemplate and updateAssessmentTemplate methods.

xsd:String templateDescription

Retrieves the description of the template.

AssessmentTask

The AssessmentTask sequence contains the properties of an assessment job.

xsd:string taskName

Specifies the name for the assessment job.

xsd:string superUserName

Specifies the super user name. Super user is the administrator of the computer on which the automation service runs.

xsd:string superUserPasswd

Specifies the super user password.

AssessmentTemplate assessmentTemplate

Specifies the assessment template to be used for running the job.

ArrayOfParameter

The ArrayOfParameter sequence specifies the array of assessment parameters.

dsm:Parameter[] parameterList

Specifies an array of assessment parameters.

Parameter

The Parameter sequence specifies the name, data type, and value of a parameter.

dsm:AssessmentTemplateParameterDataType dataType

Specifies the data type of the assessment parameter.

dsm:AssessmentTemplateParameterName name

Specifies the name of the assessment parameter.

xsd:string value

Specifies the value for the assessment parameter.

AssessmentTemplateFilter

The AssessmentTemplateFilter sequence specifies the search filter for searching and listing assessment templates.

dsm:ASSESSMENTTEMPLATEPROPERTY assessmentTemplateProperty

Specifies the property you want to filter.

dsm:FILTERCONDITION condition

Specifies the filter condition you want to apply.

xsd:string searchString

Specifies the string you want to search in the name property.

DateTime dateTime

Specifies the date and time value you want to search in the last modified date property.

GetTemplateListResponse

The GetTemplateListResponse sequence returns the number of templates and basic information about the templates.

int totalNoOfRecords

Specifies the total number of templates available.

ArrayOfTemplateProperties templatePropertiesArray

Specifies the array of template properties.

TemplateProperties

The TemplateProperties sequence specifies the properties of the template.

string templateName

Specifies the name of the template.

DateTime templateLastModifiedDate

Specifies the last modified date of the template.

xsd:DateTime creationDate

Retrieves the creation date of the template. This parameter contains null value for createAssessmentTemplate and updateAssessmentTemplate methods.

xsd:String lastModifiedUser

Retrieves the last modified user of the template. This parameter contains null value for createAssessmentTemplate and updateAssessmentTemplate methods.

xsd:String creationUser

Retrieves the creation user of the template. This parameter contains null value for createAssessmentTemplate and updateAssessmentTemplate methods.

xsd:String templateDescription

Retrieves the description of the template.

GetAssessmentTemplateListDetailedResponse

The GetAssessmentTemplateListDetailedResponse sequence contains the list of templates and the number of records retrieved.

int totalNoOfRecords

Contains the total number of records retrieved after applying the filter condition.

ArrayOfAssessmentTemplate assessmentTemplateArray

Specifies the array of assessment templates.

AssessmentResult

The AssessmentResult sequence contains the result of an assessment job.

ResultGroup grpName

Specifies the group type. The assessment job creates various groups depending on whether computers are ready for OS. This parameter contains the different groups.

xsd:string groupUUID

Specifies the group UUID.

AssessmentTaskInfo

The AssessmentTaskInfo sequence specifies the details of the assessment job.

xsd:string name

Specifies the assessment task name.

AssessmentTemplate assessmentTemplate

Contains assessment template properties.

xsd:string group

Specifies the group name on which this assessment task was executed.

AssessmentStatus status

Specifies the assessment task status.

DateTIme creationTime

Specifies creation time of the task.

String creationUser

Specifies who created the task.

DateTime executionFinishTime

Specifies completion time of the task.

DateTime executionStartTime

Specifies the start time of execution of the task.

String executionUser

Specifies execution user who executed the job.

AssessmentTaskFilter

The AssessmentTaskFilter sequence specifies the search filter for searching and listing assessment jobs.

enum ASSESSMENTTASKPROPERTY assessmentTaskProperty

Specifies the property you want to filter.

enum FILTERCONDITION condition

Specifies the filter condition you want to apply.

xsd:string searchString

Specifies the string you want to search in the name property.

Date dateTime

Specifies the date and time value you want to search in the last modified date property.

GetAssessmentTaskListResponse

The GetAssessmentTaskListResponse sequence contains the list of assessment jobs and the number records retrieved.

int totalNoOfRecords

Contains the total number of records retrieved after applying the filter condition.

ArrayOfAssessmentTaskInfo assessmentTaskInfoArray

Specifies the array of assessment tasks.

OsimTemplate

The OsimTemplate sequence contains the details of an OSIM template.

xsd:string name

Specifies OSIM template name.

OsimTemplateType type

Specifies OSIM template type.

GlobalType globalType

Specifies the OS image information as given in ImageType.

ArrayOfGroupType groupTypeArray

Specifies the array of group information mapped against the OS template.

ArrayOfHardWareModelType hwModelTypeArray

Specifies the array of hardware models mapped against the OS template.

Date lastModifiedDate

Specifies the last modified date of the OSIM template.

xsd:DateTime creationDate

Retrieves the creation date of the template. This parameter contains null value for createOsimTemplate and updateOsimTemplate methods.

xsd:String lastModifiedUser

Retrieves the last modified user of the template. This parameter contains null value for createOsimTemplate and updateOsimTemplate methods.

xsd:String creationUser

Retrieves the creation user of the template. This parameter contains null value for createOsimTemplate and updateOsimTemplate methods.

xsd:String templateDescription

Retrieves the description of the template.

CustomizationParameter

The CustomizationParameter sequence specifies the OS installation parameters.

xsd:string name

Specifies OS installation parameter name.

xsd:string value

Specifies OS installation parameter value.

ImageType

The ImageType sequence specifies the OS image you want to use in the OSIM template.

xsd:string name

Specifies the OS image name.

xsd:string imageUUID

Specifies the UUID of the OS Image ID. This ID is used to uniquely identify the OS image to be deployed.

ArrayOfCustomizationParameter customizationParameters

Specifies an array of OS installation parameters. This is a key-value pair.

OsimTemplateFilter

The OsimTemplateFilter sequence specifies the search filter for searching and listing OSIM templates.

dsm:OSIMTEMPLATEPROPERTY OSIMTemplateProperty

Specifies the property you want to filter.

dsm:FILTERCONDITION condition

Specifies the filter condition you want to apply.

xsd:string searchString

Specifies the string you want to search in the name property.

DateTime dateTime

Specifies the date and time value you want to search in the last modified date property.

GetOsimTemplateListDetailedResponse

The GetOsimTemplateListDetailedResponse sequence contains the list of OSIM templates and the number records retrieved.

int totalNoOfRecords

Contains the total number of records retrieved after applying the filter condition.

ArrayOfOsimTemplate osimTemplatesArray

Specifies the array of osim templates

SoftwareDeploymentTemplate

The SoftwareDeploymentTemplate sequence contains the properties of a software deployment template. You can use this sequence to refer to a new or existing template.

xsd:string name

Specifies a unique name for the software deployment.

SoftwareJobContainerType preInstallJobs

Specifies the software packages to be installed before the OS Deployment.

SoftwareJobContainerType postInstallJobs

Specifies the software packages to be installed after the OS Deployment.

SoftwarePackageMappingType packageMapping

Defines the mapping between an old and new software packages.

xsd:DateTime lastModifiedDate

Specifies last modified date of the template.

xsd:DateTime creationDate

Retrieves the creation date of the template. This parameter contains null value for createSoftwareDeploymentTemplate and updateSoftwareDeployemntTemplate methods.

xsd:String lastModifiedUser

Retrieves the last modified user of the template. This parameter contains null value for createSoftwareDeploymentTemplate and updateSoftwareDeployemntTemplate methods.

xsd:String creationUser

Retrieves the creation user of the template. This parameter contains null value for createSoftwareDeploymentTemplate and updateSoftwareDeployemntTemplate methods.

xsd:String templateDescription

Retrieves the description of the template.

SoftwareJobContainerType

The SoftwareJobContainerType sequence specifies the job properties of the software job container.

SoftwarePackageType [] softwarePackages

Specifies the array of software packages.

xsd:string userMessage

Specifies the user message.

boolean promptUser

Specifies whether you want to prompt the user with the message.

boolean allowCancellation

Specifies whether you want to allow the user to cancel the job.

boolean executeOnPromptTimeout

Specifies whether you want to execute jobs, if the user prompt times out.

boolean preventUserLogOn

Specifies whether you want to prevent users from logging in while job executes.

long promptTimeOutHours

Specifies the number of hours for which you want to display a user prompt before forced execution of the job starts.

Default: 24 hours

long jobTimeOutHours

Specifies the time (in hours) after which, if the job is unable to complete, the job will cease attempts to complete.

Default: 48 hours

boolean storePackageAtSSLibrary

Specifies whether you want to store packages in the scalability server library.

SoftwarePackageType

The SoftwarePackageType sequence specifies the properties of the software package.

xsd:string name

Specifies the software package name.

xsd:string version

Specifies the software package version.

xsd:string procedure

Specifies the software package procedure you want to use.

int bootLevelPriorExec

Specifies the restart options requested for the software job before the job is executed.

Default: noReboot

int bootLevelAfterExec

Specifies the restart options requested for the software job after the job is executed.

Default: noReboot

xsd:string userMessage

Specifies the user message.

SoftwarePackageMappingType

The SoftwarePackageMappingType sequence specifies the mapping between an old and a new software package. If you want to replace a software with a newer version of the software after OS deployment, you can map such software using this sequence.

SoftwarePackageType source package

Specifies the package type defining the source software package.

SoftwarePackageType targetpackage

Specifies the package type defining the target software package.

SoftwareDeploymentTemplateFilter

The SoftwareDeploymentTemplateFilter sequence specifies the search filter for searching and listing software deployment templates.

dsm:SOFTWAREDEPLOYMENTTEMPLATEPROPERTY sdTemplateProperty

Specifies the property you want to filter.

dsm:FILTERCONDITION condition

Specifies the filter condition you want to apply.

xsd:string searchString

Specifies the string you want to search in the name property.

DateTime dateTime

Specifies the date and time value you want to search in the last modified date property.

GetSoftwareDeploymentTemplateListDetailedResponse

The GetSoftwareDeploymentTemplateListDetailedResponse sequence contains the list of software deployment templates and the number records retrieved.

int totalNoOfRecords

Contains the total number of records retrieved after applying the filter condition.

ArrayOfSoftwareDeploymentTemplate sdTemplateArray

Specifies the array of available software deployment templates.

AutomationProcess

The AutomationProcess sequence contains the details of an automation process.

xsd:string name

Specifies automation process name. The name must be unique.

xsd:string OSIMTemplateName

Specifies OSIM template name.

xsd:string softwareDeploymentTemplateName

Specifies software deployment template name.

xsd:string processInstanceName

Specifies process instance name.

xsd:string superUserName

Specifies the user name of the CA IT PAM users that you have configured in Client Automation.

xsd:string superUserpasswd

Specifies the password of the CA IT PAM users that you have configured in Client Automation.

xsd:DateTime executionTime

Specifies the execution time of the process.

enum AutomationProcessMode automationProcessMode

Specifies automation process mode.

enum AutomationProcessStatus processStatus

Specifies automation process status.

xsd:string StatusText

Specifies additional information regarding status of the automation job created.

AutomationProcessFilter

The AutomationProcessFilter sequence specifies the search filter for searching and listing automation processes.

dsm:AUTOMATIONPROCESSPROPERTY apProperty

Specifies the property you want to filter.

dsm:FILTERCONDITION condition

Specifies the filter condition you want to apply.

xsd:string searchString

Specifies the string you want to search in the name property.

DateTime dateTime

Specifies the date and time value you want to search in the last modified date property.

GetAutomationProcessListResponse

The GetAutomationProcessListResponse sequence contains the list of automation processes and the number records retrieved.

int totalNoOfRecords

Contains the total number of records retrieved after applying the filter condition.

ArrayOfAutomationProcessBasicInfo apBasicInfoArray

Specifies the list of automation processes basic information.

GetAutomationProcessListDetailedResponse

The GetAutomationProcessListDetailedResponse sequence contains the details of the automation processes.

xsd:int totalNoOfRecords

Specifies the total number of available automation processes.

ArrayOfAutomationProcessDetailed automationProcessArrayDetailed

Specifies the list of automation processes.

AutomationProcessListDetailed

The AutomationProcessListDeailed contains the detailed information about the automation process.

OsimTemplate OSIMTemplate

Specifies the OSIM template parameters used in the automation process.

SoftwareDeploymentTemplate SDTemplate

Specifies the software deployment template parameters used in the automation process.

String additionalInfo

Provides additional information in case of a failure.

DateTime creationTime

Specifies the creation time of the job.

String creationUser

Specifies the user who created the job.

DateTime executionFinishTime

Specifies the completion time of the job.

DateTime executionStartTime

Specifies the start time of the job execution.

String executionUser

Specifies the super user name provided while creating the job.

String jobName

Specifies the name of the job.

AutomationProcessMode mode

Specifies the mode of the created job.

AutomationProcessStatus status

Specifies the current status of the job.

AutomationProcessBasicInfo

The AutomationProcessBasicInfo contains the details of the basic information about the automation processes.

xsd:string name

Specifies the automation process name.

xsd:string processInstanceName

Specifies process instance name.

enum AutomationProcessMode processMode

Specifies automation process mode.

enum AutomationProcessStatus processStatus

Specifies automation process status.

String additionalInfo

Provides additional information in case of job execution or job creation failure.

DateTime creationTime

Specifies creation time of the job.

String creationUser

Specifes the user who created the job.

DateTime executionFinishTime

Specifies the completion time of the job.

DateTime executionStartTime

Specifies the start time of the job.

String executionUser

Specifies the user who executed the job.

SoftwareContainerData

The SoftwareContainerData sequence contains details about the software container used in automation process.

xsd:boolean BatchMode

Specifies whether you want to execute the jobs in batch mode. If set to false the jobs will execute in No Linkage mode.

xsd:string name

Specifies the software container name.

xsd:long priority

Specifies the job priority.

Range: 1 (highest) to 10 (lowest)

Default: 5

xsd:string userMessage

Specifies the custom user message.

SoftwareJobData

The SoftwareJobData sequence contains details about the software jobs.

xsd:dateTime activationTime

Specifies the execution date. If not specified, the default value is the current date and time of the domain manager computer.

xsd:boolean allowCancellation

Allows end users to cancel the prompt for the software job.

xsd:int bootLevelAfterExec

Specifies the restart options required for the software job after the job is executed.

Default: 0 (noReboot)

xsd:int bootLevelPriorExec

Specifies the restart options required for the software job before the job is executed.

Default: 0 (noReboot)

xsd:string deliveryCalendar

Specifies the name of a delivery calendar to be used for scheduling the job. The calendar controls the days, dates, and times when delivery is permitted. The time cells that are not set in the calendar define the exclusion intervals. If the name of the calendar is unknown to SD, the job is not created.

xsd:dateTime deliveryTime

Specifies the delivery date and time. If not supplied, the default value is the current date and time of the domain manager computer.

xsd:boolean executeOnPromptTimeout

Specifies whether to execute jobs, if prompt times out.

xsd:boolean ignoreJobCalendarsOnTargetComputers

Specifies whether to ignore job calendars, if any, on target computers.

xsd:long jobTimeOutHours

Specifies the number of hours after the job the will timeout if it was unable to complete.

Default: 168 hours

xsd:boolean jobsTriggerSS

Specifies whether the job must trigger the scalability server.

xsd:boolean logonShield

Specifies whether to prevent users from being logged on while job executes.

xsd:string name

Specifies the software job name.

xsd:long promptTimeOutHours

Specifies the number of hours for which you want to display a user prompt before forced execution of the job starts.

Default: 24 hours

xsd:boolean promptUser

Specifies a message to be prompted on the target computer before the job starts.

xsd:boolean resolveQueryGroups

Specifies whether to resolve the target groups before the job is set up.

xsd:boolean runAtShutdown

Specifies whether to run while the system is allowed to shutdown.

xsd:boolean runofflineFromSS

Specifies whether to execute procedure offline from the scalability server.

SoftwarePackageData softwarePackage

Specifies the software package data.

xsd:boolean storePackageAtSSLibrary

Specifies whether to store the packages in the scalability server library.

xsd:boolean timesRelativeToEM

Specifies whether the time is relative to enterprise manager.

xsd:boolean useDeliveryCalender

Specifies whether the deliveryCalendar parameter is supplied.

xsd:string userParameters

Specifies the user-defined parameters.

SoftwarePackageData

The SoftwarePackageData sequence contains details about the software package.

xsd:string packageName

Specifies the software package name.

xsd:string procedureName

Specifies the name of the procedure to be run.

xsd:string versionNumber

Specifies the version number of the software package.

AutomationResultResponse

The AutomationResultResponse sequence contains the result of the automation process.

int totalnumberOfTargets

Specifies the number of computers involved in the automation process.

enum AutomationProcessStatus jobStatus

Specifies the job status. This is the overall job status.

ArrayOfAutomationProcessTargetStatus status

Specifies the array of target status.

String additionalInfo

Specifies additional information in case of job execution failure.

SoftwareJobContainerParameter

The SoftwareJobContainerParameter sequence specifies the details of software job container.

xsd:string parameterName

Specifies the name of the software job container parameter.

xsd:string parameterValue

Specifies the value of the software job container parameter.

ActivityLog

The ActivityLog sequence contains the activity log details:

xsd:string activityMessage

Specifies the activity message.

enum LogLevel logLevel

Specifies the log level.

xsd:dateTime timestamp

Specifies the timestamp of the message.

ActivityLogResponse

The ActivityLogResponse sequence contains the following information:

ArrayOfActivityLog activityLogArray

Specifies an array of activity log entries.

GlobalType

The GlobalType sequence contains the following information:

ImageType imageType

Specifies information about the OS image that is applicable for all the target computers.

GroupType

The GroupType sequence specifies the following information about the group type. This sequence can have multiple group information mapped against an OS image.

xsd:string name

Specifies the name of the group.

ImageType imageType

Specifies information about the OS image mapped to the group.

HardWareModelType

The HardWareModelType sequence contains the following information:

xsd:string name

Specifies name of the hardware model.

ImageType imageType

Specifies information about the OS image mapped to the hardware model.

AutomationProcessTargetStatus

The AutomationProcessTargetStatus sequence contains the following information:

xsd:string targetName

Specifies the target name.

xsd:string targetUUID

Specifies the UUID of the target computer.

enum AutomationTargetStatus status

Specifies the automation status of the target computer.

ArrayOfAutomationProcessTargetStatus

The ArrayOfAutomationProcessTargetStatus sequence contains the following information:

AutomationProcessTargetStatus [] targetStatusArray

Specifies an array of target status.

AutomationResultFilter

The AutomationResultFilter sequence contains the following information:

enum AutomationResultProperty automationResultProperty

Specifies the automation result property.

enum FilterCondition filterCondition

Specifies the filter condition.

xsd:string searchString

Specifies the string you want to search in the specified property.

AutomationTargetStatus status

Specifies the target status.

AutomationWebServiceException

The AutomationWebServiceException sequence contains the following information:

xsd:string errorCode

Specifies the error code.

xsd:string errorMessage

Specifies the error message.

xsd:string additionalInfo

Specifies additional error details, if any.

AutomationWebServiceExceptionList

The AutomationWebServiceExceptionList sequence contains the following information:

ArrayOfAutomationWebServiceException automationWebServiceExceptionArray

Specifies the array of AutomationWebServiceExceptions.

ArrayOfAutomationWebServiceException

The ArrayOfAutomationWebServiceException sequence contains the following information:

AutomationWebServiceException [] automationWebServiceExceptionArray

Specifies the array of AutomationWebServiceExceptions.

OperatingSystemType

The OperatingSystemType sequence contains the following information:

xsd:string name

Specifies the operating system name.

xsd:long classID

Specifies the operating system classID.

ArrayOfAutomationProcessListDetailed

The ArrayOfAutomationProcessListDetailed sequence includes the automation process properties.

AutomationProcessListDetailed[] automationProcessListDetailed

Specifies the list of automation processes with detailed information about OSIM and SD Options.

ArrayOfAutomationProcess

The ArrayOfAutomationProcess sequence includes the automation process properties.

AutomationProcess[] automationProcess

Specifies an array of automation process properties.

ArrayOfAutomationProcessBasicInfo

The ArrayOfAutomationProcessBasicInfo sequence contains basic information about the automation process.

AutomationProcessBasicInfo[] apBasicInfo

Specifies an array of basic information about the automation processes.

ArrayOfAutomationProcessTargetStatus

The ArrayOfAutomationProcessTargetStatus sequence specifies a list of target statuses.

AutomationProcessTargetStatus [] targetStatusArray

Specifies the list of target statuses.

ArrayOfActivityLog

The ArrayOfActivityLog sequence contains the following information:

ActivityLog [] activityLog

Specifies the array of activity logs.

ArrayOfAssessmentTaskInfo

The ArrayOfAssessmentTaskInfo sequence contains the following information:

AssessmentTaskInfo [] assessmentTasks

Specifies an array of assessment tasks.

ArrayOfAssessmentTemplate

The ArrayOfAssessmentTemplate sequence contains the following information:

AssessmentTemplate [] assessmentTemplates

Specifies an array of assessment templates.

ArrayOfGroupType

The ArrayOfGroupType sequence contains the following information:

GroupType [] groupType

Specifies an array of group type. This parameter can have multiple group information mapped against an OS image. For example: Group1 -> OSImage1, Group3-> OSImage2.

ArrayOfHardWareModelType

The ArrayOfHardWareModelType sequence contains the following information:

HardWareModelType [] hwModelType

Specifies an array of hardware model types. This parameter can have multiple hardware models mapped against OS images. For example:HWModelName->OSImage1, HWModel2->OSImage3.

ArrayOfOsimTemplate

The ArrayOfOsimTemplate sequence contains the following information:

OsimTemplate [] osimTemplates

Specifies the array of osim templates

ArrayOfSoftwareDeploymentTemplate

The ArrayOfSoftwareDeploymentTemplate sequence contains the following information:

SoftwareDeploymentTemplate [] sdTemplates

Specifies an array of software deployment templates.

ArrayOfSoftwarePackageMappingType

The ArrayOfSoftwarePackageMappingType sequence contains the following information:

SoftwarePackageMappingType [] softwarePackageMappingTypeArray

Specifies an array of software package mapping types.

ArrayOfSoftwarePackageType

The ArrayOfSoftwarePackageType sequence contains the following information:

SoftwarePackageType [] softwarePackageTypeArray

Specifies an array of software package types.

ArrayOfTemplateProperties

The ArrayOfTemplateProperties sequence contains the following information:

TemplateProperties [] templates

Specifies an array of template properties.

ArrayOf_xsd_string

The ArrayOf_xsd_string sequence contains the following information:

xsd:string [] stringArray

Specifies an array of string values.

ArrayOfCustomizationParameter

The ArrayOfCustomizationParameter sequence contains the following information:

CustomizationParameter [] customizationParameters

Specifies an array OS installation parameters that you want to customize. This parameter provides a placeholder for OS deployment parameters.

ArrayOfOperatingSystemType

The ArrayOfOperatingSystemType sequence contains the following information:

OperatingSystemType[] operatingSystemTypeArray

Specifies the array of operating system type.