Input Name	Type
DpOssvApplicationListInfoIterEnd	DpOssvApplicationListInfoIterEnd
Output Name	Type
DpOssvApplicationListInfoIterEndResult	DpOssvApplicationListInfoIterEndResult

Error Name	Description
EINTERNALERROR
EINVALIDTAG

Returns items From a previous call To DpOssvApplicationListInfoIterStart.

Input Name	Type
DpOssvApplicationListInfoIterNext	DpOssvApplicationListInfoIterNext
Output Name	Type
DpOssvApplicationListInfoIterNextResult	DpOssvApplicationListInfoIterNextResult

Error Name	Description
EINTERNALERROR
EINVALIDTAG

Browse the application components supported by an OSSV Host.

Input Name	Type
DpOssvApplicationListInfoIterStart	DpOssvApplicationListInfoIterStart
Output Name	Type
DpOssvApplicationListInfoIterStartResult	DpOssvApplicationListInfoIterStartResult

Error Name	Description
EDIRDOESNOTEXIST
EINTERNALERROR
EOBJECTAMBIGUOUS
EOBJECTNOTFOUND

Terminate an iteration started by DpOssvApplicationRestoreDestinationListInfoIterStart and clean up any saved info. Error conditions: EINTERNALERROR - An Error occurred while processing the Request. Try again later. EINVALIDTAG - The iterator Tag specified is not valid. Restart the iteration Operation To obtain a new valid Tag.

Input Name	Type
DpOssvApplicationRestoreDestinationListInfoIterEnd	DpOssvApplicationRestoreDestinationListInfoIterEnd
Output Name	Type
DpOssvApplicationRestoreDestinationListInfoIterEndResult	DpOssvApplicationRestoreDestinationListInfoIterEndResult

Error Name	Description
EINTERNALERROR
EINVALIDTAG

Returns items From a previous call To DpOssvApplicationRestoreDestinationListInfoIterStart

Input Name	Type
DpOssvApplicationRestoreDestinationListInfoIterNext	DpOssvApplicationRestoreDestinationListInfoIterNext
Output Name	Type
DpOssvApplicationRestoreDestinationListInfoIterNextResult	DpOssvApplicationRestoreDestinationListInfoIterNextResult

Error Name	Description
EINTERNALERROR
EINVALIDTAG

List all the OSSV Hosts through which a restore To the original location is possible for a given application.

Input Name	Type
DpOssvApplicationRestoreDestinationListInfoIterStart	DpOssvApplicationRestoreDestinationListInfoIterStart
Output Name	Type
DpOssvApplicationRestoreDestinationListInfoIterStartResult	DpOssvApplicationRestoreDestinationListInfoIterStartResult

Error Name	Description
EINTERNALERROR
EOBJECTAMBIGUOUS
EOBJECTNOTFOUND

Add a new OSSV Directory To the list of discovered Directories. If the Directory already exists, return its object ID. Error conditions: EOBJECTAMBIGUOUS - The specified Host Name could refer To 2 or more Hosts. Try again with a Host ID or a fully qualified Host Name or IP Address. There can be two applications with the same Name. Try specifying the application Path. EOBJECTNOTFOUND - The Host Name, IP Address, or Host ID was not found. EACCESSDENIED - Access was denied on the requested Host(s). EINTERNALERROR - An Error occurred while processing the Request. Try again later. EDIRDOESNOTEXIST - The specified Directory was not found.

Input Name	Type
DpOssvDirectoryAdd	DpOssvDirectoryAdd
Output Name	Type
DpOssvDirectoryAddResult	DpOssvDirectoryAddResult

Error Name	Description
EDIRDOESNOTEXIST
EINTERNALERROR
EOBJECTAMBIGUOUS
EOBJECTEXISTS
EOBJECTNOTFOUND

Terminate an iteration started by DpOssvDirectoryBrowseIterStart and clean up any saved info. Error conditions: EINTERNALERROR - An Error occurred while processing the Request. Try again later. EINVALIDTAG - The iterator Tag specified is not valid. Restart the iteration Operation To obtain a new valid Tag.

Input Name	Type
DpOssvDirectoryBrowseIterEnd	DpOssvDirectoryBrowseIterEnd
Output Name	Type
DpOssvDirectoryBrowseIterEndResult	DpOssvDirectoryBrowseIterEndResult

Error Name	Description
EINTERNALERROR
EINVALIDTAG

Returns items From a previous call To DpOssvDirectoryBrowseIterStart. Error conditions: EINTERNALERROR - An Error occurred while processing the Request. Try again later. EINVALIDTAG - The iterator Tag specified is not valid. Restart the iteration Operation To obtain a new valid Tag.

Input Name	Type
DpOssvDirectoryBrowseIterNext	DpOssvDirectoryBrowseIterNext
Output Name	Type
DpOssvDirectoryBrowseIterNextResult	DpOssvDirectoryBrowseIterNextResult

Error Name	Description
EINTERNALERROR
EINVALIDTAG

Get the list of Subdirectories beneath a given Directory on an OSSV Host. Error conditions: EOBJECTAMBIGUOUS - The specified Host Name could refer To 2 or more Hosts. Try again with a Host ID or a fully qualified Host Name or IP Address. EOBJECTNOTFOUND - The Host Name, IP Address, or Host ID was not found. EACCESSDENIED - Access was denied on the requested Host(s). EINTERNALERROR - An Error occurred while processing the Request. Try again later. EDIRDOESNOTEXIST - The specified Directory was not found.

Input Name	Type
DpOssvDirectoryBrowseIterStart	DpOssvDirectoryBrowseIterStart
Output Name	Type
DpOssvDirectoryBrowseIterStartResult	DpOssvDirectoryBrowseIterStartResult

Error Name	Description
EDIRDOESNOTEXIST
EINTERNALERROR
EOBJECTAMBIGUOUS
EOBJECTNOTFOUND

Terminate an iteration started by DpOssvDirectoryDiscoveredIterStart and clean up any saved info. Error conditions: EINTERNALERROR - An Error occurred while processing the Request. Try again later. EINVALIDTAG - The iterator Tag specified is not valid. Restart the iteration Operation To obtain a new valid Tag.

Input Name	Type
DpOssvDirectoryDiscoveredIterEnd	DpOssvDirectoryDiscoveredIterEnd
Output Name	Type
DpOssvDirectoryDiscoveredIterEndResult	DpOssvDirectoryDiscoveredIterEndResult

Error Name	Description
EINTERNALERROR
EINVALIDTAG

Returns items From a previous call To DpOssvDirectoryDiscoveredIterStart. Error conditions: EINTERNALERROR - An Error occurred while processing the Request. Try again later. EINVALIDTAG - The iterator Tag specified is not valid. Restart the iteration Operation To obtain a new valid Tag.

Input Name	Type
DpOssvDirectoryDiscoveredIterNext	DpOssvDirectoryDiscoveredIterNext
Output Name	Type
DpOssvDirectoryDiscoveredIterNextResult	DpOssvDirectoryDiscoveredIterNextResult

Error Name	Description
EINTERNALERROR
EINVALIDTAG

List the OSSV Directories which have been discovered by the monitor. This list includes OSSV Roots, and siblings of Directories in backup relationships. The list can be filtered To exclude Directories which are marked as "ignored" and To exclude Directories which are protected. Error conditions: EOBJECTAMBIGUOUS - The specified Host Name could refer To 2 or more Hosts. Try again with a Host ID or a fully qualified Host Name or IP Address. There can be two applications with the same Name. Try specifying the ID of the application. EOBJECTNOTFOUND - The lookup object was not found. EINTERNALERROR - An Error occurred while processing the Request. Try again later. EACCESSDENIED - Access was denied on the requested Directory object(s).

Input Name	Type
DpOssvDirectoryDiscoveredIterStart	DpOssvDirectoryDiscoveredIterStart
Output Name	Type
DpOssvDirectoryDiscoveredIterStartResult	DpOssvDirectoryDiscoveredIterStartResult

Error Name	Description
EACCESSDENIED
EINTERNALERROR
EOBJECTAMBIGUOUS
EOBJECTNOTFOUND

Modify a Directory's information. If modifying of one property fails, nothing will be changed. Error conditions: EACCESSDENIED - When the user does not have DFM.Database.Write Capability on the specified Directory. EINTERNALERROR - An Error occurred while processing the Request. Try again later. EOBJECTNOTFOUND - When the DpOssvDirectoryNameOrId does not correspond To an ossv Directory. EDATABASEERROR - On database Error.

Input Name	Type
DpOssvDirectoryModify	DpOssvDirectoryModify
Output Name	Type
DpOssvDirectoryModifyResult	DpOssvDirectoryModifyResult

Error Name	Description
EACCESSDENIED
EDATABASEERROR
EINTERNALERROR
EOBJECTNOTFOUND

Terminate an iteration started by DpOssvDirectoryRootsIterStart and clean up any saved info. Error conditions: EINTERNALERROR - An Error occurred while processing the Request. Try again later. EINVALIDTAG - The iterator Tag specified is not valid. Restart the iteration Operation To obtain a new valid Tag.

Input Name	Type
DpOssvDirectoryRootsIterEnd	DpOssvDirectoryRootsIterEnd
Output Name	Type
DpOssvDirectoryRootsIterEndResult	DpOssvDirectoryRootsIterEndResult

Error Name	Description
EINTERNALERROR
EINVALIDTAG

Returns items From a previous call To DpOssvDirectoryRootsIterStart. Error conditions: EINTERNALERROR - An Error occurred while processing the Request. Try again later. EINVALIDTAG - The iterator Tag specified is not valid. Restart the iteration Operation To obtain a new valid Tag.

Input Name	Type
DpOssvDirectoryRootsIterNext	DpOssvDirectoryRootsIterNext
Output Name	Type
DpOssvDirectoryRootsIterNextResult	DpOssvDirectoryRootsIterNextResult

Error Name	Description
EINTERNALERROR
EINVALIDTAG

Get the list of filesystem Roots From one or more OSSV Hosts. Error conditions: EOBJECTAMBIGUOUS - The specified Host Name could refer To 2 or more Hosts. Try again with a Host ID or a fully qualified Host Name or IP Address. EOBJECTNOTFOUND - The Host Name, IP Address, or Host ID was not found. EACCESSDENIED - Access was denied on the requested Host(s). EINTERNALERROR - An Error occurred while processing the Request. Try again later.

Input Name	Type
DpOssvDirectoryRootsIterStart	DpOssvDirectoryRootsIterStart
Output Name	Type
DpOssvDirectoryRootsIterStartResult	DpOssvDirectoryRootsIterStartResult

Error Name	Description
EHOSTDOESNOTEXIST
EINTERNALERROR
EOBJECTAMBIGUOUS
EOBJECTNOTFOUND

Terminate an iteration started by DpOssvApplicationListInfoIterStart and clean up any saved info. Error conditions: EINTERNALERROR - An Error occurred while processing the Request. Try again later. EINVALIDTAG - The iterator Tag specified is not valid. Restart the iteration Operation To obtain a new valid Tag.

Name	Type	Description
Tag	xsd:string	The Tag returned in a previous call To DpOssvApplicationListInfoIterStart.

[none]

Returns items From a previous call To DpOssvApplicationListInfoIterStart.

Name	Type	Description
Maximum	xsd:integer	The Maximum number of entries To retrieve. Range: [1..2^31-1]
Tag	xsd:string	The Tag returned in a previous dp-ossv-directory-application-list-info-iter-start call

Name	Type	Description
OssvApplicationList	ArrayOfOssvApplicationInfo	List of applications supported by OSSV Host.
Records	xsd:integer	The number of Records actually returned.

Browse the application components supported by an OSSV Host.

Name	Type	Description
OssvApplicationPath	xsd:string optional	The Path of the application To browse. If specified it must be an the application Path returned by DpOssvApplicationListInfoIterStart. If not specified, it is same as an empty string and all the Virtual Machines reported by the OSSV Host will be returned. Length: [1..255]
OssvHostNameOrId	OssvHostNameOrId	Name or ID of an OSSV Host.

Name	Type	Description
Records	xsd:integer	Number indicating how many items are available for future retrieval with DpOssvApplicationListInfoIterNext. Range: [1..2^31-1]
Tag	xsd:string	Tag To be used in subsequent calls To DpOssvApplicationListInfoIterNext or DpOssvApplicationListInfoIterEnd

Terminate an iteration started by DpOssvApplicationRestoreDestinationListInfoIterStart and clean up any saved info. Error conditions: EINTERNALERROR - An Error occurred while processing the Request. Try again later. EINVALIDTAG - The iterator Tag specified is not valid. Restart the iteration Operation To obtain a new valid Tag.

Name	Type	Description
Tag	xsd:string	The Tag returned in a previous call To DpOssvApplicationRestoreDestinationListInfoIterStart.

[none]

Returns items From a previous call To DpOssvApplicationRestoreDestinationListInfoIterStart

Name	Type	Description
Maximum	xsd:integer	The Maximum number of entries To retrieve. Range: [1..2^31-1]
Tag	xsd:string	The Tag returned in a previous DpOssvApplicationRestoreDestinationListInfoIterStart call.

Name	Type	Description
OssvApplicationRestoreDestinationList	ArrayOfOssvApplicationRestoreDestinationInfo	List of all the OSSV Hosts through which the application can be restored To its original location.
Records	xsd:integer	The number of Records actually returned.

List all the OSSV Hosts through which a restore To the original location is possible for a given application.

Name	Type	Description
ApplicationNameOrId	ObjNameOrId	Name or ID of the application.

Name	Type	Description
Records	xsd:integer	Number indicating how many items are available for future retrieval with DpOssvApplicationRestoreDestinationListInfoIterNext. Range: [1..2^31-1]
Tag	xsd:string	Tag To be used in subsequent calls To DpOssvApplicationRestoreDestinationListInfoIterNext or DpOssvApplicationRestoreDestinationListInfoIterEnd

Add a new OSSV Directory To the list of discovered Directories. If the Directory already exists, return its object ID. Error conditions: EOBJECTAMBIGUOUS - The specified Host Name could refer To 2 or more Hosts. Try again with a Host ID or a fully qualified Host Name or IP Address. There can be two applications with the same Name. Try specifying the application Path. EOBJECTNOTFOUND - The Host Name, IP Address, or Host ID was not found. EACCESSDENIED - Access was denied on the requested Host(s). EINTERNALERROR - An Error occurred while processing the Request. Try again later. EDIRDOESNOTEXIST - The specified Directory was not found.

Name	Type	Description
DirectoryPath	xsd:string	Directory Path To add. This Path must be an absolute Path on the given Host. In case of adding an application component this should be the OssvApplicationPath returned by DpOssvApplicationListInfoIterNext.
OssvHostNameOrId	OssvHostNameOrId	Name or ID of an OSSV Host.

Name	Type	Description
DirectoryId	xsd:integer	ID of the newly added Directory. Range: [1..2^31-1]

Terminate an iteration started by DpOssvDirectoryBrowseIterStart and clean up any saved info. Error conditions: EINTERNALERROR - An Error occurred while processing the Request. Try again later. EINVALIDTAG - The iterator Tag specified is not valid. Restart the iteration Operation To obtain a new valid Tag.

Name	Type	Description
Tag	xsd:string	The Tag returned in a previous call To DpOssvDirectoryBrowseIterStart.

[none]

Returns items From a previous call To DpOssvDirectoryBrowseIterStart. Error conditions: EINTERNALERROR - An Error occurred while processing the Request. Try again later. EINVALIDTAG - The iterator Tag specified is not valid. Restart the iteration Operation To obtain a new valid Tag.

Name	Type	Description
Maximum	xsd:integer	The Maximum number of entries To retrieve. Range: [1..2^31-1]
Tag	xsd:string	The Tag returned in a previous DpOssvDirectoryBrowseIterStart call.

Name	Type	Description
Records	xsd:integer	The number of Records actually returned. Range: [0..2^31-1].
Subdirectories	ArrayOfDpOssvDirectoryName	List of Subdirectories.

Get the list of Subdirectories beneath a given Directory on an OSSV Host. Error conditions: EOBJECTAMBIGUOUS - The specified Host Name could refer To 2 or more Hosts. Try again with a Host ID or a fully qualified Host Name or IP Address. EOBJECTNOTFOUND - The Host Name, IP Address, or Host ID was not found. EACCESSDENIED - Access was denied on the requested Host(s). EINTERNALERROR - An Error occurred while processing the Request. Try again later. EDIRDOESNOTEXIST - The specified Directory was not found.

Name	Type	Description
DirectoryPath	xsd:string optional	Directory Name To browse. Must be an absolute Path, or an empty string. If DirectoryPath is omitted, it is the same as an empty string. If this Value is omitted, or an empty string, then a list of all the Roots of filesystems that are suitable for backup will be returned. On some systems, special backup sources will be returned as well. These special backup sources will not have a trailing slash when returned. For example, on Windows, "SystemState" is a valid backup Source returned by this API, but it cannot be browsed by this API.
OssvHostNameOrId	OssvHostNameOrId	Name or ID of an OSSV Host.

Name	Type	Description
Records	xsd:integer	Number indicating how many items are available for future retrieval with DpOssvDirectoryBrowseIterNext. Range: [1..2^31-1]
Tag	xsd:string	Tag To be used in subsequent calls To DpOssvDirectoryBrowseIterNext or DpOssvDirectoryBrowseIterEnd.

Terminate an iteration started by DpOssvDirectoryDiscoveredIterStart and clean up any saved info. Error conditions: EINTERNALERROR - An Error occurred while processing the Request. Try again later. EINVALIDTAG - The iterator Tag specified is not valid. Restart the iteration Operation To obtain a new valid Tag.

Name	Type	Description
Tag	xsd:string	The Tag returned in a previous call To DpOssvDirectoryDiscoveredIterStart.

[none]

Returns items From a previous call To DpOssvDirectoryDiscoveredIterStart. Error conditions: EINTERNALERROR - An Error occurred while processing the Request. Try again later. EINVALIDTAG - The iterator Tag specified is not valid. Restart the iteration Operation To obtain a new valid Tag.

Name	Type	Description
Maximum	xsd:integer	The Maximum number of entries To retrieve. Range: [1..2^31-1]
Tag	xsd:string	The Tag returned in a previous DpOssvDirectoryDiscoveredIterStart call.

Name	Type	Description
Directories	ArrayOfDpOssvDirectoryInfo	List of Directories.
Records	xsd:integer	The number of Records actually returned. Range: [0..2^31-1].

List the OSSV Directories which have been discovered by the monitor. This list includes OSSV Roots, and siblings of Directories in backup relationships. The list can be filtered To exclude Directories which are marked as "ignored" and To exclude Directories which are protected. Error conditions: EOBJECTAMBIGUOUS - The specified Host Name could refer To 2 or more Hosts. Try again with a Host ID or a fully qualified Host Name or IP Address. There can be two applications with the same Name. Try specifying the ID of the application. EOBJECTNOTFOUND - The lookup object was not found. EINTERNALERROR - An Error occurred while processing the Request. Try again later. EACCESSDENIED - Access was denied on the requested Directory object(s).

Name	Type	Description
IncludeIsAvailable	xsd:boolean optional	If true, the IsAvailable Status is calculated for each Directory which may make the call To this zapi take much longer. Default is false.
IsDpIgnored	xsd:boolean optional	If the Value is true, only list Directories which are marked as ignored Freya/DFM for the purpose of data protection. If the Value is false, only list Directories which are not marked as ignored. If the Value is not specified, then list all Directories.
IsInBackupRelationship	xsd:boolean optional	If this Value is true, only list Directories which are in a backup relationship. If this Value is false, only list Directories which are not in a backup relationship. If this Value is unspecified, then list all Directories.
IsInDataset	xsd:boolean optional	If the Value is true, only list Directories which are Members of a Dataset. If the Value is false, only list Directories which are not Members of Datasets. If the Value is not specified, list all Directories.
ObjectNameOrId	xsd:string optional	Name or identifier of an object To list OSSV Directories for. The allowed object types for this argument are: Resource Group Dataset OSSV Host OSSV Directory If ObjectNameOrId identifies an OSSV Directory, that single OSSV Directory will be returned. If ObjectNameOrId resolves To more than one OSSV Directory, all of them will be returned. If no ObjectNameOrId is provided, all OSSV Directories will be listed. The same applies To OSSV applications as well.

Name	Type	Description
Records	xsd:integer	Number indicating how many items are available for future retrieval with DpOssvDirectoryDiscoveredIterNext. Range: [1..2^31-1]
Tag	xsd:string	Tag To be used in subsequent calls To DpOssvDirectoryDiscoveredIterNext or DpOssvDirectoryDiscoveredIterEnd.

Modify a Directory's information. If modifying of one property fails, nothing will be changed. Error conditions: EACCESSDENIED - When the user does not have DFM.Database.Write Capability on the specified Directory. EINTERNALERROR - An Error occurred while processing the Request. Try again later. EOBJECTNOTFOUND - When the DpOssvDirectoryNameOrId does not correspond To an ossv Directory. EDATABASEERROR - On database Error.

Name	Type	Description
DpOssvDirectoryNameOrId	xsd:string	Name or identifier of the Directory To modify. If a Name is specified, it must be of the form "HostName:DirectoryPath".
IsDpIgnored	xsd:boolean optional	True if an administrator has chosen To ignore this object for purposes of data protection.

[none]

Terminate an iteration started by DpOssvDirectoryRootsIterStart and clean up any saved info. Error conditions: EINTERNALERROR - An Error occurred while processing the Request. Try again later. EINVALIDTAG - The iterator Tag specified is not valid. Restart the iteration Operation To obtain a new valid Tag.

Name	Type	Description
Tag	xsd:string	The Tag returned in a previous call To DpOssvDirectoryRootsIterStart.

[none]

Returns items From a previous call To DpOssvDirectoryRootsIterStart. Error conditions: EINTERNALERROR - An Error occurred while processing the Request. Try again later. EINVALIDTAG - The iterator Tag specified is not valid. Restart the iteration Operation To obtain a new valid Tag.

Name	Type	Description
Maximum	xsd:integer	The Maximum number of entries To retrieve. Range: [1..2^31-1]
Tag	xsd:string	The Tag returned in a previous DpOssvDirectoryRootsIterStart call.

Name	Type	Description
Records	xsd:integer	The number of Records actually returned. Range: [0..2^31-1].
Roots	ArrayOfDpOssvDirectoryRootInfo	List of Roots.

Get the list of filesystem Roots From one or more OSSV Hosts. Error conditions: EOBJECTAMBIGUOUS - The specified Host Name could refer To 2 or more Hosts. Try again with a Host ID or a fully qualified Host Name or IP Address. EOBJECTNOTFOUND - The Host Name, IP Address, or Host ID was not found. EACCESSDENIED - Access was denied on the requested Host(s). EINTERNALERROR - An Error occurred while processing the Request. Try again later.

Name	Type	Description
FsInfo	xsd:boolean optional	If FsInfo is specified and true, then a list of all filesystems is returned instead of a list of root of filesystems suitable for backup. For example, CD-ROM drives and NFS mounts will be returned if FsInfo is true. Additional information will be included in the output, specifically the filesystem device, Type and state, as reported by NDMP. While this flag causes this API To return more data, the recommended way To find filesystems suitable for backup is To set this flag To false.
OssvHostNameOrId	OssvHostNameOrId optional	Name or ID of an OSSV Host. If no OSSV Host is specified, Roots are returned for all OSSV Hosts.

Name	Type	Description
Records	xsd:integer	Number indicating how many items are available for future retrieval with DpOssvDirectoryRootsIterNext. Range: [1..2^31-1]
Tag	xsd:string	Tag To be used in subsequent calls To DpOssvDirectoryRootsIterNext or DpOssvDirectoryRootsIterEnd.

Name	Type	Description
DpOssvDirectoryInfo	DpOssvDirectoryInfo[]

Name	Type	Description
DpOssvDirectoryName	DpOssvDirectoryName[]

Name	Type	Description
DpOssvDirectoryRootInfo	DpOssvDirectoryRootInfo[]

Name	Type	Description
OssvApplicationInfo	OssvApplicationInfo[]

Name	Type	Description
OssvApplicationRestoreDestinationInfo	OssvApplicationRestoreDestinationInfo[]

Name or internal ID of a DFM object. This typedef is an alias for the builtin ZAPI Type string. An ObjNameOrId must contain between 1 and 64 characters, and must conform To one of the following formats: It must have the format of an ObjName, or It must be the decimal numeric string form of a positive integer whose Value is in the range [1..2^31 - 1]. Elements of Type ObjNameOrId are used only as inputs To ZAPIs. The Value must Match either the Name or internal ID of an existing DFM object. The ZAPI must specify the object's DFM object Type (e.g. Dataset, Host, DP Policy, etc.). Some ZAPIs allow the object To be one of several different types. If the format of an ObjNameOrId input element does not conform, or the Value does not Match the Name or ID of an existing object, then generally the ZAPI documents that it fails with Error code EOBJECTNOTFOUND. A ZAPI may return more specific Error codes. In such cases, the ZAPI specification must document its behavior. If a ZAPI can accept a null Value (e.g. reference To no object at all) for such an element, then the element is declared optional, and the absence of the input element represents a null Value.

[none]

Name or ID of a Host. IP addresses are also accepted.

[none]

Information about one Directory.

Name	Type	Description
DatasetId	xsd:integer optional	If IsInDataset is true, then this is the ID number of the Dataset To which the Directory belongs. This field is deprecated in favor of Datasets, which lists all Datasets the Directory belongs To. It is still populated with one of the Dataset ids.
Datasets	ArrayOfDatasetReference	A list of the names and identifiers of the Datasets this Directory belongs To. If IsInDataset is false, this list will be empty.
DirId	xsd:integer	ID of the Directory. Range: [1..2^31-1]
HostId	xsd:integer	ID of the Host that contains this Directory. Range: [1..2^31-1]
HostName	xsd:string	Name of the Host that contains this Directory.
IsAvailable	xsd:boolean optional	True if this Directory and it's parent Host are up and online. Since OSSV Hosts can only be contacted with valid credentials, if the login credentials are unset or invalid, the IsAvailable Status will be false. Only output if the call To iter-start included the "IncludeIsAvailable" flag.
IsBrowsable	xsd:boolean	Set To true if the Directory Path can be used as an input To DpOssvDirectoryBrowseIterStart. If set To false, this Path is guaranteed not To have browsable child Paths.
IsDpIgnored	xsd:boolean	Indicates that the Directory is marked as ignored by Freya/DFM for the purposes of data protection.
IsInBackupRelationship	xsd:boolean	Indicates that the Directory is in a backup relationship.
IsInDataset	xsd:boolean	Indicates if the Directory is a member of any Dataset.
Path	xsd:string	Path of the Directory.

Name of one subdirectory. The Name is relative To the parent Directory ("DirectoryPath" in the DpOssvDirectoryBrowseIterStart API). If the parent Directory was empty, then this will be an absolute Path. The Name will always end with a slash character appropriate To the Host operating system of the OSSV agent, unless the Path is a special Directory which has no children.

[none]

Information about one filesystem root.

Name	Type	Description
FilesystemDevice	xsd:string optional	Filesystem device From NDMP. Included only if FsInfo is true.
FilesystemState	xsd:string optional	Filesystem state From NDMP. Included only if FsInfo is true.
FilesystemType	xsd:string optional	Filesystem Type From NDMP. Included only if FsInfo is true.
HostId	xsd:integer	ID of the Host that contains this root. Range: [1..2^31-1]
HostName	xsd:string	Name of the Host that contains this root.
RootPath	xsd:string	Path of the filesystem root. For example: "C:\" or "/".

Application related information.

Name	Type	Description
CanBackup	xsd:boolean	If true this component can be added To a Dataset.
IsLeaf	xsd:boolean	If true this Path cannot be browsed further. If false the Path can be specified as input To the DpOssvApplicationListInfoIterStart zapi.
Name	xsd:string	The display Name for the application component.
Path	xsd:string	The application Path To be used for further browsing components under this Path.
UniqueId	xsd:string optional	Universal unique identifier for the application component.

OSSV Host related information.

Name	Type	Description
HostFullName	ObjFullName	The fully qualified domain Name of the Host.
HostId	ObjId	The ID of the OSSV Host.
HostName	ObjName	The Name of the OSSV Host.

Name	Type	Description
DatasetReference	DatasetReference[]

Full Name of a DFM object. This typedef is an alias for the builtin ZAPI Type string. An object full Name conforms To all the rules of an ObjName, except that the full Name may be up To 255 characters long. DFM creates full names by concatenating an object Name with any parent object names, so as To create a unique Name for an object. The format of full names is as follows: Host full names are the either the fully-qualified domain Name or the IP Address of the Host. Aggregate full names are the Host Name and the Aggregate Name, separated by a colon, e.g. Hostname:aggr0. Volume full names are the Host Name and the Volume Name, separated by ":/", e.g. Hostname:/volume. Note this does not include "/vol". Volume and Aggregate full names are distinguished by the presence of a forward slash after the colon. Qtree full names are the containing Volume full Name and the Qtree Name, separated by a slash, e.g. Hostname:/volume/qtree. The data not contained by any Qtree may be represented by "-", e.g. Hostname:/volume/-. Lun Path full names are either a Volume or Qtree full Name and the LUN Path, separated by a slash, e.g. Hostname:/volume/LUN or Hostname:/volume/qtree/LUN. Network full names are a network Address block in CIDR format, e.g. 1.2.3.0/8. OSSV Directory full names are the OSSV Host Name and the OSSV Path, separated by a colon, e.g. host-lnx:/usr/local or host-w2k:c:/temp Include any others here... Initiator Group full names are Host Name and the initiator Group Name, separated by a colon, e.g. Hostname:igroup. For any DFM object not listed above, the ObjName and ObjFullName are identical.

[none]

Identification number (ID) for a DFM object. This typedef is an alias for the builtin ZAPI Type integer. Object IDs are unsigned integers in the range [1..2^31 - 1]. In some contexts, an object ID is also allowed To be 0, which is interpreted as a null Value, e.g., a reference To no object at all. The ID for a DFM object is always assigned by the system; the user is never allowed To assign an ID To an object. Therefore, an input element of Type ObjId is always used To refer To an existing object by its ID. The ZAPI must specify the object's DFM object Type (e.g. Dataset, Host, DP Policy, etc.). Some ZAPIs allow the object To be one of several different types. If the Value of an ObjId input element does not Match the ID of any existing DFM object of the specified Type or types, then typically the ZAPI fails with Error code EOBJECTNOTFOUND. A ZAPI may deviate From this general rule, for example, it may return a more specific Error code. In either case, the ZAPI specification must document its behavior.

[none]

Name of a DFM object. This typedef is an alias for the built in ZAPI Type string. An object Name must conform To the following format: It must contain between 1 and 64 characters. It may start with any character and may contain any combination of characters, except that it may not consist solely of decimal digits ('0' through '9'). In some contexts, a Name may be the empty string (""), which is interpreted as a null Value, e.g., a reference To no object at all. The behavior of a ZAPI when it encounters an Error involving an ObjName input element depends on how the ZAPI uses the input element. Here are the general rules: If the input Name element is used To create a new object with the given Name, or rename an existing object To that Name, and the Name does not conform To the above format, then the ZAPI fails with Error code EINVALIDINPUTERROR. Note that because EINVALIDINPUTERROR is such a common Error code, ZAPI specifications are not required To document cases when they may return it. If the input Name element is used To refer To an existing object with that Name, and there is no object with that Name, then the ZAPI fails with Error code EOBJECTNOTFOUND. Generally the ZAPI specification documents cases when it may return this Error code. A ZAPI may deviate From these general rules, for example, it may return more specific Error codes. In such cases, the ZAPI specification must document its behavior. If an input Name element is used To refer To an existing object, then the ZAPI specification must specify which DFM object Type (e.g. data set, Host, DP Policy, etc.) is allowed. Some ZAPIs allow the object To be one of several different types. See the Description of ObjFullName for examples of valid input formats. Note that there is no requirement that all object names must be unique. However, the names for some specific types of Objects are constrained such that no two Objects of that Type may have the same Name. For example, this constraint applies To Datasets, DP schedules, and DP policies. This means that no two Datasets may have the same Name, but a Dataset may have the same Name as a DP schedule or DP Policy. In general, object names are compared in a case-insensitive manner. This means that, for example, "MyObject" and "MYOBJECT" are considered To be the same Name for purposes of: creating new Objects, renaming existing Objects, or looking up an object by Name. On the other hand, ZAPIs that return an ObjName generally do not change the capitalization at all. For example, if an object's Name has been set To "MyObject", then list iteration ZAPIs that return the object's Name return it as "MyObject" rather than "MYOBJECT" or "myobject". ZAPIs that operate on ObjName Values and do not follow these general rules about case sensitivity must document the rules that they do follow. One important exception To these general rules is that Volumes, Qtrees, OSSV Directories, SRM Paths, Interfaces, FCP Targets and FC switch ports all have case-sensitive names. When looking up Objects of these types by Name, the case must Match the object Name.

[none]

The Name and Id of a Dataset.

Name	Type	Description
DatasetId	ObjId	Identifier for the Dataset. Range: [1..2^31-1]
DatasetName	ObjName	Name of the Dataset.