This documentation supports the 9.1 to 9.1 Service Pack 3 version and its patches of BMC Atrium Core. The documentation for version 9.1.04 and its patches is available here.

To view the latest version, select the version from the Product version menu.

SetDataset function

Sets or creates dataset with the specified properties. If the dataset does not exist, it is created. If the dataset exists, it is updated with the specified settings.

Namespace



*

http://atrium.bmc.com/2009/01/datasets/types*
 

WSDL operation

<operation name="SetDataset" parameterOrder="inargs">
<input message="tns:SetDatasetRequest"
	name="SetDatasetRequest"/>
<output message="tns:SetDatasetResponse"
	 name="SetDatasetResponse"/>
<fault message="tns:AtriumFault" name="AtriumFault"/>
</operation>

WSDL messages

<message name="SetDatasetRequest">
	<part element="types:SetDataset" name="inargs"/>
</message>
<message name="SetDatasetResponse">
	<part element="common:StatusOutput" name="outargs"/>
</message>
<message name="AtriumFault">
	<part element="common:AtriumFault" name="errargs"/>
</message>

XSD schema

<element name="SetDataset">
	<complexType>
		<sequence>
			<element name="lang" type="string"/>
			<element name="coreDatasetId" type="string" />
			<element name="instanceId" type="string" 
				nillable="true" />
			<element name="datasetName" type="string" 
				nillable="true" />
			<element name="description" type="string" 
				nillable="true" />
			<element name="datasetType" type="tns:DatasetType" 
				nillable="true" />
			<element name="accessibility" type="tns:DatasetAccessType"
				nillable="true" />
			<element name="clientTypeList" 
				type="common:ArrayOf_String" nillable="true" />
			<element name="sourceDatasetId" type="string"
				nillable="true" />
			<element name="extensions" type="common:ExtensionsList"
				nillable="true" />
		</sequence>
	</complexType>
</element>
<element name="StatusOutput">
	<complexType>
		<sequence>
			<element name="status" type="impl:StatusList"/>
		</sequence>
	</complexType>
</element>
<element name="AtriumFault">
	<complexType>
		<choice>
			<element name="serviceFault"
				type="tns:AtriumServiceFault" />
			<element name="backendFault"
				type="tns:AtriumBackendFault" />
		</choice>
	</complexType>
</element>

Input arguments

 

lang

The language of the product specific to the locale. If no language is specified, the default language is used.

coreDatasetId

The unique ID for the dataset. The dataset ID cannot contain a slash (tick), semicolon ((wink), or comma (,). If you do not provide an ID, the system generates a GUID to use for this ID. The dataset ID cannot be changed after the dataset is created.

instanceId

The unique identifier.

datasetName

The unique name for the dataset. The dataset name cannot be changed after the dataset is created.

description

The description of the dataset.

datasetType

The type of dataset, Regular or Overlay. See DatasetType.

accessibility

The level of accessibility for the dataset: Writable, Read-Only, or Writable by client only. This refers to whether instances can be created, modified, and deleted in the dataset. See DatasetAccessType (datasets).

clientTypeList

The client IDs of each BMC Atrium CMDB client that can write to this dataset for the Writable by client only accessibility option. To allow all clients to write to this dataset, specify a NULL value in this argument. If you specify any IDs here, only those clients can create, modify, or delete instances in the dataset. Client IDs are integer values, and must be delimited by semicolons. For more information about the allowable values for this parameter, see the BMC Atrium Core 7.6.03 Installation Guide.

sourceDatasetId

The source dataset ID for an Overlay type of dataset.

extensions

A list of extension types for the operation.

 

Return values

 

status

A list of zero or more notes, warnings, or errors generated from a call of this operation.

 

Fault message

 

Fault message

See Fault message.

Was this page helpful? Yes No Submitting... Thank you

Comments