dsmDeleteFS

온라인 편집

dsmDeleteFS 함수 호출은 스토리지에서 파일 공간을 삭제합니다. 파일 공간을 삭제하려면 IBM® Storage Protect 관리자가 제공한 적절한 권한이 있어야 합니다. 필요한 권한이 있는지 판별하려면 dsmQuerySessInfo를 호출하십시오. 이 함수 호출은 archDel 및 backDel 필드가 포함된 ApiSessInfo 유형의 데이터 구조를 리턴합니다.

참고:

UNIX 또는 Linux® 운영 체제에서는 루트 사용자 또는 권한이 있는 사용자만 파일 공간을 삭제할 수 있습니다.
삭제해야 하는 파일 공간에 백업 버전이 포함되어 있는 경우 백업 삭제 권한을 가지고 있어야 합니다(backDel = BACKDEL_YES). 파일 공간에 아카이브 사본이 포함되어 있는 경우 아카이브 삭제 권한을 가지고 있어야 합니다(archDel = ARCHDEL_YES). 파일 공간에 백업 버전과 아카이브 사본이 둘 다 포함되어 있는 경우 두 유형의 삭제 권한을 모두 가지고 있어야 합니다.
아카이브 관리자 서버 사용 시 파일 공간은 실제로는 제거할 수 없습니다. 이 함수 호출은 파일 공간이 실제로 삭제되지 않은 경우에도 rc=0을 리턴합니다. 파일 공간이 삭제되었는지 확인할 수 있는 유일한 방법은 서버에 대한 파일 공간 조회를 발행하는 것입니다.
IBM Storage Protect 서버 파일 공간 삭제 기능은 백그라운드 프로세스입니다. 리턴 코드를 전달하기 전에 발견된 오류 이외의 오류가 발생하면 IBM Storage Protect 서버 로그에 기록됩니다.

구문

dsInt16_t dsmDeleteFS  (dsUint32_t          dsmHandle,
   char           *fsName,
   unsigned char   repository);

매개변수

dsUint32_t dsmHandle (I)

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

char *fsName (I)

삭제할 파일 공간 이름에 대한 포인터입니다. 와일드카드 문자는 허용되지 않습니다.

unsigned char repository (I)

삭제할 파일 공간이 백업 저장소인지 아카이브 저장소인지 아니면 둘 다인지를 나타냅니다. 이 필드에 사용할 수 있는 값은 다음과 같습니다.

DSM_ARCHIVE_REP     /* archive repository   */
DSM_BACKUP_REP      /* backup repository    */
DSM_REPOS_ALL       /* all repository types */

리턴 코드

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

표 1. 다음에 대한 반환 코드 dsmDeleteFS
리턴 코드	설명
DSM_RC_ABORT_NOT_AUTHORIZED (27)	파일 공간을 삭제하기 위해 필요한 권한이 없습니다.
DSM_RC_INVALID_REPOS (2015)	저장소의 값이 올바르지 않습니다.
DSM_RC_FSNAME_NOTFOUND (2060)	파일 공간 이름을 찾을 수 없습니다.
DSM_RC_NEED_ROOT (2300)	API 호출자는 root 사용자여야 합니다.