MQ 메시지 가져오기(get) 옵션
MQ 메시지 가져오기(get) 옵션은 MQGET 조치를 제어합니다.
이후에 이 절에 설명된 옵션을 하나 또는 여러 개
지정하거나 지정하지 않을 수 있습니다. 둘 이상의 옵션을 지정해야 하는 경우,
다음과 같이 값을 처리할 수 있습니다.
- 더함(같은 상수를 두 번 이상 더하지 않음) 또는
- 비트 단위의 OR 조작을 사용하여 결합함(프로그래밍 언어가 비트 조작을 지원하는 경우)
Options
필드의 초기값은 MQGMO_NO_WAIT 더하기 MQGMO_PROPERTIES_AS_Q_DEF입니다.
특성 옵션
다음 옵션은 메시지의 특성과 관련되어 있습니다.
- MQGMO_PROPERTIES_AS_Q_DEF
메시지 디스크립터(또는 확장자)에 포함된 특성을 제외한 메시지의 특성이 PropertyControl 큐 특성에 의해 정의된 대로 표시되어야 합니다.
MsgHandle
가 제공되면 PropertyControl 큐 특성의 값이MQPROP_FORCE_MQRFH2
이 아니면MsgHandle
를 사용하여 메시지 특성을 사용할 수 있습니다.이는 특성 옵션이 지정되지 않은 경우 기본 조치입니다.
- MQGMO_PROPERTIES_IN_HANDLE
메시지의 특성이
MsgHandle
을 통해 사용 가능하게 되어야 합니다. 메시지 핸들이 제공되지 않은 경우 MQRC_HMSG_ERROR 이유와 함께 호출이 실패합니다.- MQGMO_NO_PROPERTIES
메시지 디스크립터(또는 확장자)에 포함된 특성을 제외한 메시지의 특성이 검색되지 않습니다.
MsgHandle
이 제공된 경우 이 옵션은 무시됩니다.- MQGMO_PROPERTIES_FORCE_MQRFH2
메시지 디스크립터(또는 확장자)에 포함된 특성을 제외한 메시지의 특성이 MQRFH2 헤더를 사용하여 표시되어야 합니다. 이는 특성을 검색할 것으로 예상되지만 메시지 핸들을 사용하도록 변경할 수 없는 애플리케이션의 이전 버전과의 호환성을 제공합니다.
MsgHandle
이 제공된 경우 이 옵션은 무시됩니다.- MQGMO_PROPERTIES_COMPATIBILITY
- 메시지에 접두부가 "mcd.", "jms.", "usr."또는 "mqext."인 특성이 포함된 경우 모든 메시지 특성이 MQRFH2 헤더의 응용프로그램에 전달됩니다. 그렇지 않은 경우에는 메시지 디스크립터(또는 확장자)에 포함된 특성을 제외한 메시지의 모든 특성이 제거되며 애플리케이션에 더 이상 액세스할 수 없습니다.
기본 옵션
이전에 설명된 옵션이 모두 필요하지 않은 경우, 다음 옵션을 사용할 수 있습니다.
- MQGMO_NONE
- 기타 옵션이 지정되지 않았음을 표시하려면 이 값을 사용하십시오. 모든 옵션은 기본 값을 가정합니다. MQGMO_NONE은 프로그램 문서를 지원합니다. 이 옵션은 다른 옵션과 함께 사용할 수 없지만 값이 0이기 때문에 이러한 사용을 감지할 수 없습니다.