getNextElement()

getNextElement() 함수는 지정된 iSeries 데이터 큐에서 데이터를 읽은 다음 큐에서 해당 데이터를 삭제합니다. 이 함수를 동일한 방식으로 데이터를 읽지만 큐에서 데이터를 삭제하지 않는 browseNextElement() 함수와 비교하십시오.

데이터의 대상이 HEX(2) 요소의 배열로 구성되는 경우, 함수는 해당 데이터를 원시 바이트로 읽습니다. 그밖의 경우에는 해당 데이터를 STRING으로 읽습니다.

키를 지정하지 않으면 함수는 큐의 첫 번째 요소를 읽습니다. 키를 지정하면 함수는 키 및 검색 유형(예: 키 값보다 큼, 키 값과 같지 않음 등)에 일치하는 요소를 읽습니다.

구문

  iplatformLib.getNextElement(
    dataQueueDef DataQueueDefinition inOut,
    elementData ANY inOut,
    wait INT in,
    [, keyData ANY in,
    searchType CHAR[2] inOut] )
  returns (result BOOLEAN)
platform
프로그램을 생성할 플랫폼에 따라 문자열 "Cobol" 또는 "Java™"입니다.
dataQueueDef
DataQueueDefinition 레코드를 기반으로 하는 변수입니다(iSeries 레코드 정의 참조).
elementData
데이터의 대상입니다. 데이터 유형이 HEX(2)[]이면 데이터를 바이트로 읽습니다. 그렇지 않으면 STRING 유형으로 읽습니다.
wait
읽기 조작을 완료할 수 없는 경우 함수가 대기에야 하는 시간(초)입니다. 두 가지 특수한 경우가 있습니다.
0
즉시 돌아갑니다.
-1
무제한으로 대기합니다.
keyData
키가 있는 데이터 큐에 대한 선택적 키 스펙입니다.
searchType
일치하는 데이터가 충족해야 하는 keyData에 대한 관계입니다. 검색 유형은 다음 관계 중 하나로 구성됩니다.
GT
함수는 키 값이 keyData보다 큰 요소를 읽습니다.
GE
함수는 키 값이 keyData보다 크거나 같은 요소를 읽습니다.
EQ
함수는 키 값이 keyData와 같은 요소를 읽습니다.
NE
함수는 키 값이 keyData와 같지 않은 요소를 읽습니다.
LE
함수는 키 값이 keyData보다 작거나 같은 요소를 읽습니다.
LT
함수는 키 값이 keyData보다 작은 요소를 읽습니다.
result
성공적으로 읽은 경우 함수는 TRUE를 리턴합니다.