MQMD 보고 필드를 JMS 제공자 특정 특성에 맵핑
JMS 애플리케이션은 보고 메시지를 관리 요청/응답 처리 양식으로 사용하여 생성자의 전송 조작의 출력과 메시지의 결말에 대한 원격 피드백을 생성자에게 제공할 수 있습니다. JMS 애플리케이션은 JMS_IBM_Report_Xxxx 메시지 특성 및 옵션을 설정하여 여러 가지 유형의 보고 메시지를 요청할 수 있습니다.
- MQRO_report-type
- 원래 메시지의 IBM MQ 메시지 디스크립터(MQMD)를 포함하는 표시된 유형의 보고 메시지가 생성됩니다. 메시지 본문 데이터를 포함하지 않습니다.
- MQRO_report-type_WITH_DATA
- MQMD, 임의의 MQ 헤더, 100바이트의 본문 데이터를 포함하는 표시된 유형의 보고 메시지가 생성됩니다.
- MQRO_report-type_WITH_FULL_DATA
- 원래 메시지의 모든 데이터를 포함하는 표시된 유형의 보고 메시지가 생성됩니다.
각 옵션과 함께 com.ibm.websphere.sib.api.jms 접두부를 사용하십시오.
예를 들어 전체 데이터를 갖는 COD(Confirm on delivery) 보고 메시지를 요청하려면 JMS 애플리케이션이 JMS_IBM_Report_COD를 값 com.ibm.websphere.sib.api.jms.MQRO_COD_WITH_FULL_DATA로 설정해야 합니다.
보고 메시지의 각 유형에 대해, 다음 표는 JMS 애플리케이션이 설정할 수 있는 JMS_IBM_Report_Xxxx 메시지 특성과 해당 특성에 맵핑하는 MQMD 보고 필드 옵션을 보여줍니다.
보고 메시지의 유형 | 설명 | JMS_IBM_Report_Xxxx 메시지 특성 및 옵션 |
---|---|---|
예외 | 요청 메시지를 대상 큐에 둘 수 없으면 보고 메시지를 전송합니다. 메시지가 예외 대상으로 경로 재지정되면 예외 보고 메시지가 생성됩니다. | JMS_IBM_Report_Exception
|
버리기 | 원래 요청 메시지를 예외 대상으로 보내지 않고 버립니다. MQRO_EXCEPTION_WITH_FULL_DATA로 설정된 JMS_IBM_Report_Exception 특성과 함께 이 옵션을 사용하여 전달할 수 없는 요청 메시지를 전송자에게 반송할 수 있습니다. | JMS_IBM_Report_Discard_Msg
|
만기 | 요청 메시지가 만기 시간을 지나는 경우 보고 메시지를 보냅니다. | JMS_IBM_Report_Expiration
|
COA(Confirm on arrival) | 요청 메시지가 대상 큐에 들어갔을 때 보고 메시지를
보냅니다. 공개/등록 메시징의 경우, COA 보고 메시지는 생성자 메시징 엔진에서만 생성됩니다. 따라서 해당 보고서는 로컬 등록에 대해서만 관련됩니다. 지점간 메시징의 경우, COA 메시지는 메시지가 최종 대상에 도달하는 경우에 생성됩니다. 파티션 큐의 경우, 보고 메시지는 PUT 조작이 커미트되어 최종 대상이 선택된 경우에만 생성됩니다. 지정된 임의의 With_Data 또는 With_Full_Data 보고서 옵션은 무시됩니다. COA 보고 메시지는 메시지 헤더만 처리합니다. 전달 경로 지정 경로가 사용되는 경우, COA 메시지는 메시지가 경로의 최종 대상에 도달하는 경우에 생성됩니다. |
JMS_IBM_Report_COA
|
COD(Confirm on delivery) | 큐 또는 토픽 영역에서 메시지 이용자에 의해 요청
메시지가 제거된 경우 보고 메시지를 전송합니다. 공개/등록 메시징의 경우, COD 메시지는 모든 등록자가 요청 메시지를 수신한 경우에 생성됩니다. 따라서 모든 COA에 대해 생성된 하나의 COD 메시지가 있습니다. 메시지가 등록자에 의해 소비되면, 토픽 공간에서 메시지의 참조 계수가 줄어듭니다. 참조 계수가 0에 도달하면, 메시지가 토픽 공간에서 제거되며 COD 보고 메시지가 생성됩니다. 지점간 메시징의 경우, COD 메시지는 메시지가 이용하는 애플리케이션에 의해 성공적으로 수신된 경우에 생성됩니다. 지정된 모든 With_Data 또는 With_Full_Data 보고서 옵션은 무시되며, COD 보고 메시지는 메시지 헤더만 처리합니다. |
JMS_IBM_Report_COD
|
PAN(Positive action notification) | 성공적으로 요청 메시지를 처리했을 때 보고 메시지를 전송하도록 이용자 애플리케이션에 요청합니다. | JMS_IBM_Report_PAN
|
NAN(Negative action notification) | 성공적으로 요청 메시지를 처리하지 못한 경우 보고 메시지를 전송하도록 이용자 애플리케이션에 요청합니다. | JMS_IBM_Report_NAN
|
- 보고 메시지 및 임의의 응답 메시지에 대해
메시지 ID가 생성되는 방법:
- MQRO_New_Msg_Id
- 이것이 기본값입니다. 보고 메시지에 대해 새 메시지 ID가 생성됩니다.
- MQRO_Pass_Msg_Id
- 보고 메시지의 메시지 ID가 요청 메시지의 메시지 ID로 설정됩니다.
- 보고 또는 응답 메시지의 상관 ID가 설정되는
방법.
- MQRO_Copy_Msg_Id_To_Correl_Id
- 이것이 기본값입니다. 보고 메시지의 상관 ID는 요청 메시지의 메시지 ID로 설정됩니다.
- MQRO_Pass_Correl_Id
- 보고 메시지의 상관 ID가 요청 메시지의 상관 ID로 설정됩니다.
보고 메시지 및 연관된 특성과 옵션에 대한 자세한 정보는 WebSphere® MQ 라이브러리에서 볼 수 있는 WebSphere MQ Information Center의 Java™ 사용 섹션을 참조하십시오.