9.2 Target Services Generic Open Mode Values

The two types of generic open mode values are:

9.2.1 Generic Backup Open Mode Values

The generic backup open mode strings are built by the engine from the values given in the following table.

Value

Modes

Description

Numeric Modes:

 

0x0001

NWSM_USE_LOCK_MODE_IF_DW_FAILS

Open the data set using lock mode if a deny write open mode fails.

 

0x0002

NWSM_NO_LOCK_NO_PROTECTION

Circumvents lock and write protection. The engine should only use this mode when data integrity is not required.

 

0x0003

NWSM_OPEN_READ_ONLY

The dataset is opened in Read only mode and the data is of the last saved state. This mode circumvents lock and write protection and the engine should only use it when data integrity is not required.

9.2.2 Generic Restore Open Mode Values

The generic restore open mode strings are built by the engine from the values given in the following table.

Value

Modes

Description

Numeric Modes:

 

0x0000

Invalid

Invalid

 

0x0001

NWSM_OVERWRITE_DATA_SET

Open the data set and allow it to be overwritten.

 

0x0002

NWSM_DO_NOT_OVERWRITE_DATA_SET

Do not open the data set if it exists on the Target Service.

NWSM_DO_NOT_OVERWRITE_DATA_SET has lower precedence than excluding or including a data set. That is, if a data set is marked as do not overwrite and is also marked as included in the selection list, the data set will be overwritten. To avoid overwriting an included data set, it must be excluded.

 

0x0003

NWSM_CREATE_PARENT_HANDLE

Create a parent handle. If the parent does not exist on the Target Service, it is created. If the parent exists, it is not overwritten.

 

0x0004

NWSM_UPDATE_DATA_SET

If the data set on the media is newer than the Target Service's copy, update the Target Service's copy. This mode is applicable only for files.

Bitmap Modes:

 

0x0040

NWSM_CLEAR_MODIFY_FLAG_RESTORE

Clear the modify flag after the data set is restored.

 

0x0080

NWSM_RESTORE_MODIFY_FLAG

Set the data set's modify flag to what it was before the backup session began.

9.2.3 TSA-Specific Open Mode Values

For the NetWare TSAs, the returned strings represent the following TSA-specific open modes values:

The following table lists the TSA-specific open modes values.

Value

Modes

Description

0x0100

NWSM_NO_DATA_STREAMS

Do not read or write the data set's data streams

0x0200

NWSM_NO_EXTENDED_ATTRIBUTES

Do not read or write the data set's extended attribute

0x0400

NWSM_NO_PARENT_TRUSTEES

If the data set is a parent, do not read or write its trustee information

0x0800

NWSM_NO_CHILD_TRUSTEES

If the data set is a child, do not read or write its trustee information.

0x1000

NWSM_NO_VOLUME_RESTRICTIONS

Do not read or write the data set's resource restriction information.

0x2000

NWSM_NO_DISK_SPACE_RESTRICTIONS

Do not read or write the data set's space restrictions.

0x8000

NWSM_DELETE_EXISTING_TRUSTEES

Delete the existing trustees during a restore from a data set before restoring the backed up trustees.

0x10000

NWSM_EXPAND_COMPRESSED_DATA_SET

Expand data sets that are currently compressed on the host. This option is used only during backup.

0x20000

NWSM_EXCLUDE_MIGRATED_DATA

Do not backup migrated data sets.

0x4000

NWSM_INCLUDE_MIGRATED_DATA

Restore migrated streams for a data set on the primary storage medium. The default behavior is to skip migrated streams during a restore.

0x40000

NWSM_PRESERVE_ACCESS_TIME

Preserves the access time of the data set after a backup session.

0x80000

NWSM_NO_HARDLINK_DATA

Do not backup the data of consecutive hard link nodes of a particular hardlink network, except for the first encountered node.