dsmBeginQuery

매개변수

dsUint32_t dsmHandle (I)

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

dsmQueryType queryType (I)

실행할 조회 유형을 식별합니다. 다음 옵션 중 하나를 지정하십시오.

qtArchive

아카이브된 오브젝트를 조회합니다.

qtBackup

백업된 오브젝트를 조회합니다.

qtBackupActive

전달하는 전체 파일 공간 이름에 대한 활성 백업 오브젝트만 조회합니다. 이 조회는 빠른 경로라고 하며 스토리지에서 활성 오브젝트를 조회하기에 효율적인 방법입니다.

전제조건: UNIX 또는 Linux® 운영 체제에서 루트 사용자로 로그온해야 합니다.

qtFilespace

등록된 파일 공간을 조회합니다.

qtMC

정의된 관리 클래스를 조회합니다.

qtBackupGroups

닫힌 그룹을 조회합니다.

qtOpenGroups

열린 그룹을 조회합니다.

qtProxyNodeAuth

이 노드가 프록시를 통해 사용할 수 있는 노드를 조회합니다.

qtProxyNodePeer

동일한 대상이 포함된 피어 노드를 조회합니다.

dsmQueryBuff *queryBuffer (I)

특정 데이터 구조에 맵핑된 버퍼에 대한 포인터를 식별합니다. 이 구조는 전달하는 조회 유형과 연관됩니다. 이러한 구조에는 각 조회 유형에 대한 선택 기준이 포함되어 있습니다. 각 구조의 필드를 완료하여 실행하려는 조회의 범위를 지정하십시오. 각 구조의 stVersion 필드에는 구조 버전 번호가 포함됩니다.

데이터 구조 및 관련된 필드에는 다음 항목이 포함됩니다.

qryArchiveData

objName

완전한 오브젝트 이름입니다. 이름의 상위 레벨 또는 하위 레벨 부분에 별표 (*) 또는 물음표 (?) 와 같은 와일드카드 문자를 사용할 수 있습니다. 별표는 0개 이상의 문자와 일치하며 물음표는 하나의 문자와 일치합니다. objName의 objType 필드에는 다음 값 중 하나가 있습니다.

• DSM_OBJ_FILE
• DSM_OBJ_DIRECTORY
• DSM_OBJ_ANY_TYPE

상위 레벨 및 하위 레벨 이름에 대한 자세한 정보는 상위 레벨 및 하위 레벨 이름주제를 참조하십시오.

소유자

오브젝트의 소유자 이름입니다.

insDateLowerBound

오브젝트가 아카이브된 삽입 데이터의 하위 경계. 경계가 없는 하한의 경우 연도 컴포넌트를 DATE_MINUS_INFINITE 로 설정하십시오.

insDateUpperBound

오브젝트가 아카이브된 삽입 날짜의 상위 경계. 경계가 없는 상한에 대해 연도 컴포넌트를 DATE_PLUS_INFINITE 로 설정하십시오.

expDateLowerBound

만료 날짜의 하한값입니다. 경계가 없는 하한의 경우 연도 컴포넌트를 DATE_MINUS_INFINITE 로 설정하십시오.

expDateUpperBound

만료 날짜의 상한값입니다. NOLIMIT의 관리 클래스 RETVer 설정을 일치시키려면 연도 구성요소를 DATE_PLUS_INFINITE로 설정하십시오.

DESCR

아카이브 설명입니다. 별표(*)를 입력하여 모든 설명을 검색하십시오.

qryBackupData

objName

완전한 오브젝트 이름입니다. 이름의 상위 레벨 또는 하위 레벨 부분에 별표 (*) 또는 물음표 (?) 와 같은 와일드카드 문자를 사용할 수 있습니다. 별표는 0개 이상의 문자와 일치하며 물음표는 하나의 문자와 일치합니다. objName의 objType 필드에는 다음 값 중 하나가 있습니다.

• DSM_OBJ_FILE
• DSM_OBJ_DIRECTORY
• DSM_OBJ_ANY_TYPE

상위 레벨 및 하위 레벨 이름에 대한 자세한 정보는 상위 레벨 및 하위 레벨 이름주제를 참조하십시오.

소유자

오브젝트의 소유자 이름입니다.

objState

다음 오브젝트 상태 중 하나를 조회할 수 있습니다.

• DSM_ACTIVE
• DSM_INACTIVE
• DSM_ANY_MATCH

pitDate

특정 시점 값입니다. 이 필드를 사용한 조회는 이 날짜 및 시간 전에 백업되는 최신 오브젝트를 리턴합니다. objState는 활성 또는 비활성이 될 수 있습니다. pitDate 전에 삭제된 오브젝트는 리턴되지 않습니다. 예를 들어,

   Mon - backup ABC(1), DEF, GHI
   Tue - backup ABC(2), delete DEF
   Thr - backup ABC(3)

금요일에는 수요일 12:00:00 a.m의 특정 시점 값으로 조회를 호출하십시오. 호출은 다음 정보를 리턴합니다.

    ABC(2) - an Inactive copy
    GHI    - an Active copy

해당 오브젝트가 특정 시점 전에 삭제되므로 호출은 DEF를 리턴하지 않습니다.

qryABackupData

objName

완전한 오브젝트 이름입니다. 이름의 상위 레벨 또는 하위 레벨 부분에 별표 (*) 또는 물음표 (?) 와 같은 와일드카드 문자를 사용할 수 있습니다. 별표는 0개 이상의 문자와 일치하며 물음표는 하나의 문자와 일치합니다. objName의 objType 필드에는 다음 값 중 하나가 있습니다.

• DSM_OBJ_FILE
• DSM_OBJ_DIRECTORY
• DSM_OBJ_ANY_TYPE

상위 레벨 및 하위 레벨 이름에 대한 자세한 정보는 상위 레벨 및 하위 레벨 이름주제를 참조하십시오.

qryFSData

fsName

특정 파일 공간의 이름을 이 필드에 입력하거나 별표(*)를 입력하여 등록된 모든 파일 공간에 대한 정보를 검색하십시오.

qryMCData

mcName

특정 관리 클래스의 이름을 입력하거나 비어 있는 문자열( )을 입력하여 모든 관리 클래스에 대한 정보를 검색하십시오.

주: 별표 (*) 를 사용할 수 없습니다.

mcDetail

관리 클래스의 백업 및 아카이브 사본 그룹에 대한 정보가 리턴되는지 여부를 판별합니다. 유효값은 다음과 같습니다.

• bTrue
• bFalse

qryBackupGroup:

groupType

그룹 유형은 DSM_GROUPTYPE_PEER입니다.

fsName

파일 공간 이름입니다.

소유자

소유자 ID입니다.

groupLeaderObjId

그룹 리더 오브젝트 ID입니다.

objType

오브젝트 유형입니다.

qryProxyNodeAuth:

targetNodeName

대상 노드 이름입니다.

peerNodeName

피어 노드 이름입니다.

hlAddress

상위 레벨 이름의 피어 주소입니다.

llAddress

하위 레벨 이름의 피어 주소입니다.

qryProxyNodePeer:

targetNodeName

대상 노드 이름입니다.

peerNodeName

피어 노드 이름입니다.

hlAddress

상위 레벨 이름의 피어 주소입니다.

llAddress

하위 레벨 이름의 피어 주소입니다.

리턴 코드

다음 표에서는 dsmBeginQuery 함수 호출의 리턴 코드를 설명합니다.