MQ 메시지 가져오기(get) 옵션
MQ 메시지 가져오기(get) 옵션은 MQGET 조치를 제어합니다.
이후에 이 절에 설명된 옵션을 하나 또는 여러 개
지정하거나 지정하지 않을 수 있습니다. 둘 이상의 옵션을 지정해야 하는 경우,
다음과 같이 값을 처리할 수 있습니다.
- 더함(같은 상수를 두 번 이상 더하지 않음) 또는
- 비트 단위의 OR 조작을 사용하여 결합함(프로그래밍 언어가 비트 조작을 지원하는 경우)
옵션
필드의 초기값은
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이기 때문에 이러한 사용을 감지할 수 없습니다.