dsmUpdateFS

The dsmUpdateFS function call updates a file space in IBM Spectrum Protect storage. This update ensures that the administrator has a current record of your file space.

Syntax

dsInt16_t dsmUpdateFS  (dsUint32_t      dsmHandle,
   char         *fs,
   dsmFSUpd     *fsUpdP,
   dsUint32_t    fsUpdAct);

Parameters

dsUint32_t dsmHandle (I)

The handle that associates this call with a previous dsmInitEx call.

char *fs (I)

This parameter is a pointer to the file space name.

dsmFSUpd *fsUpdP (I)

This parameter is a pointer to the structure that has the correct fields for the update that you want. Complete only those fields that need updating.

dsUint32_t fsUpdAct (I)

A 2-byte bit map that indicates which of the fields to update. The bit masks have the following values:

DSM_FSUPD_FSTYPE
DSM_FSUPD_FSINFO
Tip: For Windows operating systems, the drive letter value from dsmDOSAttrib is also updated when FSINFO is selected.
DSM_FSUPD_OCCUPANCY
DSM_FSUPD_CAPACITY
DSM_FSUPD_BACKSTARTDATE
DSM_FSUPD_BACKCOMPLETEDATE

For a description of these bit masks, see the DSM_FSUPD definitions in the following topic: API type definitions source files.

Return codes

The following table lists return codes for the dsmUpdateFS function call.

Table 1. Return codes for dsmUpdateFS
Return code	Return code number	Description
`DSM_RC_FS_NOT_REGISTERED`	2061	File space name is not registered.
`DSM_RC_WRONG_VERSION_PARM`	2065	The API version of the application client is different from the IBM Spectrum Protect library version.
`DSM_RC_FSINFO_TOOLONG`	2106	File space information is too long.