dsmDeleteObj

온라인 편집

dsmDeleteObj 함수 호출은 백업 오브젝트를 비활성화하거나 백업 오브젝트를 삭제하거나 스토리지에서 아카이브 오브젝트를 삭제합니다. dtBackup 유형은 현재 활성 백업 사본만 비활성화합니다. dtBackupID 유형은 지정된 모든 오브젝트 ID를 서버에서 제거합니다. 트랜잭션 내에서 이 함수를 호출하십시오.

자세한 정보는 dsmBeginTxn 의 내용을 참조하십시오.

제한사항: 보존 세트에 포함된 백업 오브젝트는 삭제할 수 없습니다. 장기간 데이터 보존 요구사항을 충족시키기 위해 이러한 파일은 서버 스토리지에 남아 있으며 보존 세트의 자체 만료 날짜에 따라 만료되며 이 날짜 이후에는 삭제할 수 있습니다.

dsmDeleteObj를 전송하기 전에 IBM Storage Protect 시스템 조회 에 설명된 조회 시퀀스를 전송하여 delInfo에 대한 정보를 얻으십시오. dsmGetNextQObj 에 대한 호출은 백업 조회의 경우 qryRespBackupData 데이터 구조를 리턴하고 아카이브 조회의 경우 qryRespArchiveData 데이터 구조를 리턴합니다. 이러한 데이터 구조에는 delInfo에 대해 필요한 정보가 포함되어 있습니다.

maxObjPerTxn의 값은 단일 트랜잭션에서 삭제할 수 있는 최대 오브젝트 수를 판별합니다. 이 값을 얻으려면 dsmQuerySessInfo를 호출하십시오.

팁: 노드에는 관리자가 설정한 적절한 권한이 있어야 합니다. 아카이브 오브젝트를 삭제하려면 아카이브 삭제 권한을 가지고 있어야 합니다. 백업 오브젝트를 비활성화하는 데는 백업 삭제 권한이 필요하지 않습니다.

구문

dsInt16_t dsmDeleteObj  (dsUint32_t      dsmHandle,
   dsmDelType  delType,
   dsmDelInfo  delInfo)

매개변수

dsUint32_t dsmHandle (I)

이 호출을 이전의 dsmInitEx 호출과 연관시키는 핸들입니다.

dsmDelType delType (I)

삭제할 오브젝트 유형(백업 또는 아카이브)을 나타냅니다. 다음 값을 사용할 수 있습니다.

	이름	설명
	dtArchive	삭제할 오브젝트가 이전에 아카이브되었습니다.
	dtBackup	비활성화할 오브젝트가 이전에 백업되었습니다.
	dtBackupID	삭제할 오브젝트가 이전에 백업되었습니다. 제한사항: 이 delType 를 objID 와 함께 사용하면 서버에서 백업 오브젝트가 제거됩니다. 오브젝트 소유자만 오브젝트를 삭제할 수 있습니다. 오브젝트의 모든 버전(활성 또는 비활성)을 삭제할 수 있습니다. 서버는 버전을 조정합니다. 오브젝트의 활성 버전을 삭제하면 첫 번째 비활성 버전이 활성 버전으로 됩니다. 오브젝트의 비활성 버전을 삭제하면 모든 이전 버전이 앞으로 이동합니다. 노드는 backDel 권한을 사용하여 등록해야 합니다.

dsmDelInfo delInfo (I)

필드가 오브젝트를 식별하는 구조입니다. 오브젝트가 백업 오브젝트인지 아니면 아카이브 오브젝트인지에 따라 필드는 다릅니다. 백업 오브젝트를 비활성화하는 구조(delBack)에는 오브젝트 이름 및 오브젝트 사본 그룹이 포함되어 있습니다. 아카이브 오브젝트의 구조(delArch)에는 오브젝트 ID가 포함되어 있습니다.

백업 오브젝트를 제거하는 구조(delBackID)에는 오브젝트 ID가 포함되어 있습니다.

리턴 코드

리턴 코드 번호는 괄호 ( ) 안에 표시됩니다.

표 1. 다음에 대한 반환 코드 dsmDeleteObj
리턴 코드	설명
DSM_RC_FS_NOT_REGISTERED (2061)	파일 공간 이름이 등록되어 있지 않습니다.
DSM_RC_WRONG_VERSION_PARM (2065)	애플리케이션 클라이언트 API 버전은 IBM® Storage Protect 라이브러리 버전과 다릅니다.