메시지 헤더 필드 및 특성과 IBM MQ 형식 사이의 맵핑
서비스 통합이 메시지를 IBM MQ 형식으로 변환할 때 서비스 통합 메시지 헤더 필드 및 특성(메시지에 적용 가능한 JMS 메시지 헤더 필드 및 특성이 포함됨)에 따라 MQMD, MQRFH2의 필드를 설정합니다. 서비스 통합이 IBM MQ 형식으로부터 메시지를 변환할 때, IBM MQ 메시지에 있는 MQMD, MQRFH2의 서비스 통합 메시지 헤더 필드 및 특성을 설정합니다.
서비스 통합 및 IBM MQ
일반적으로, 서비스 통합과 IBM MQ 사이에서 JMS 메시지를 교환하기 위해 메시지 형식 간 변환을 인식하지 않아도 됩니다. 왜냐하면, 서비스 통합이 해당 변환(문자 및 숫자 인코딩 포함)을 자동으로 수행하기 때문입니다. 하지만 JMS 애플리케이션이 예상대로 작동하지 않거나 서비스 통합 구성에 비JMS IBM MQ 프로그램에서 메시지를 처리하는 JMS 프로그램 또는 중개가 포함되는 경우 메시지 변환에 대해 알아야 합니다.
서비스 통합 애플리케이션에서 MapMessage 오브젝트를 IBM MQ 애플리케이션과 교환하는 경우, 기본이 아닌 맵 메시지 인코딩 형식을 지정해야 합니다.
IBM MQ 메시지 특성: MQMD 및 MQRFH2
비슷하게 서비스 통합은 MQRFH2 없이 메시지를 생성하는 IBM MQ 애플리케이션으로부터 메시지를 수신할 수 있습니다. MQRFH2가 없는 메시지를 수신하면 서비스 통합은 MQMD에서 가져올 수 있는 양만큼 정보를 가져오고 다른 필드에는 기본 값을 사용하여 "최선의 추측" 서비스 통합 헤더를 작성합니다.
메시지 디스크립터 및 메시지 헤더의 컨텐츠에 관한 상세한 설명은 IBM MQ 애플리케이션 프로그래밍 참조를 참조하십시오. IBM MQ가 MQMD 및 MQRFH2에 JMS 메시지 특성 및 헤더 필드를 저장하는 방법의 세부사항을 포함하여 IBM MQ JMS 지원의 자세한 내용은 IBM MQ의 내용을 참조하십시오.
IBM MQ 메시지 특성: JMS 헤더 필드
다음 표는 IBM MQ 형식으로(부터) 메시지를 변환할 때 서비스 통합이 MQMD, MQRFH2 필드로(부터) JMS 헤더 필드를 맵핑하는 방법을 보여줍니다.
테이블에 MQRFH2 필드가 folder.field로 표시됩니다. 여기서 folder는 해당 필드를 포함하는 MQRFH2 폴더 이름이고, field는 MQRFH2 폴더에 있는 필드 이름입니다.
여러 JMS 헤더 필드의 경우, MQMD 필드 및 MQRFH2 필드가 둘 다 있습니다. 서비스 통합으로 메시지가 IBM MQ 형식으로 변환되는 경우, MQMD 및 MQRFH2 필드를 둘 다 설정합니다. 서비스 통합이 IBM MQ 형식으로부터 메시지를 변환 중일 때 사용 가능한 경우 MQRFH2 필드로부터 JMS 헤더 필드를 설정하고, 그렇지 않으면 MQMD 필드로부터 설정합니다.
JMS 헤더 필드 | MQMD 필드 | MQRFH2 필드 | 참고 |
---|---|---|---|
JMSCorrelationID | CorrelId | jms.Cid | 참고 1을 참조하십시오. |
JMSDeliveryMode | 지속 | jms.Dlv | 참고 15를 참조하십시오. |
JMSDestination | jms.Dst | 참고 16을 참조하십시오. | |
JMSExpiration | 만기 | jms.Exp | |
JMSMessageID | MsgId | ||
JMSPriority | 우선순위 | 참고 2를 참조하십시오. | |
JMSRedelivered | BackoutCount | 참고 3을 참조하십시오. | |
JMSReplyTo | ReplyToQ 및 ReplyToQMgr | jms.Rto | 참고 16을 참조하십시오. |
JMSTimestamp | PutDate 및 PutTime | jms.Tms | |
JMSType | mcd.Type |
IBM MQ 메시지 특성: JMS 정의 특성
다음 표는 IBM MQ 형식으로(부터) 메시지를 변환할 때 서비스 통합이 MQMD, MQRFH2 필드로(부터) JMS 정의 특성을 맵핑하는 방법을 보여줍니다.
테이블에 MQRFH2 필드가 folder.field로 표시됩니다. 여기서 folder는 해당 필드를 포함하는 MQRFH2 폴더 이름이고, field는 MQRFH2 폴더에 있는 필드 이름입니다.
여러 JMS 정의 특성의 경우, MQMD 필드 및 MQRFH2 필드가 둘 다 있습니다. 서비스 통합으로 메시지가 IBM MQ 형식으로 변환되는 경우, MQMD 및 MQRFH2 필드를 둘 다 설정합니다. 서비스 통합이 IBM MQ 형식으로부터 메시지를 변환 중일 때 사용 가능한 경우 MQRFH2 필드로부터 JMS 정의 특성을 설정하고, 그렇지 않으면 MQMD 필드로부터 설정합니다.
JMS 정의 특성 | MQMD 필드 | MQRFH2 필드 | 참고 |
---|---|---|---|
JMSXAppID | PutApplName | ||
JMSXDeliveryCount | BackoutCount | ||
JMSXGroupID | GroupId | jms.Gid | 참고 4 및 5를 참조하십시오. |
JMSXGroupSeq | MsgSeqNumber | jms.Seq | |
JMSXUserID | UserIdentifier |
IBM MQ 메시지 특성: JMS 제공자 특정 특성
다음 표에서는 메시지를 WebSphere MQ 형식으로(부터) 변환할 때 서비스 통합이 JMS 제공자 특정 특성을 MQMD, MQRFH2 필드로(부터) 맵핑하는 방법에 대해 설명합니다. 일반적으로 수신 애플리케이션의 특수 요구사항을 처리하기 위해 이러한 특성을 사용하므로, 필수 특성 값의 세부사항은 수신 애플리케이션의 개발자나 관리자에게 문의해야 합니다.
JMS 제공자 특정 특성 | MQMD 필드 | MQRFH2 필드 | 참고 |
---|---|---|---|
JMS_IBM_ArmCorrelator | mqext.Arm | 참고 6을 참조하십시오. | |
JMS_IBM_Character_Set | CodedCharacterSetId | CodedCharacterSetId | 참고 7을 참조하십시오. |
JMS_IBM_Encoding | Encoding | Encoding | 참고 7을 참조하십시오. |
JMS_IBM_Feedback | 피드백 | ||
JMS_IBM_Format | Format | Format | 참고 7을 참조하십시오. |
JMS_IBM_Last_Msg_In_Group | MQMF_LAST_MSG_IN_GROUP | 참고 8을 참조하십시오. | |
JMS_IBM_MQMD_CorrelId | CorrelId | 참고 9와 10을 참조하십시오. | |
JMS_IBM_MQMD_MsgId | MsgId | 참고 9와 11을 참조하십시오. | |
JMS_IBM_MQMD_Persistence | Persistence | 참고 9, 12, 15를 참조하십시오. | |
JMS_IBM_MQMD_ReplyToQ | ReplyToQ | 참고 9, 13, 16을 참조하십시오. | |
JMS_IBM_MQMD_ReplyToQMgr | ReplyToQMgr | 참고 9, 13, 16을 참조하십시오. | |
JMS_IBM_MsgType | MsgType | ||
JMS_IBM_PutDate | PutDate | ||
JMS_IBM_PutTime | PutTime | ||
JMS_IBM_Report_* | Report | 참고 14를 참조하십시오. | |
JMS_IBM_RMCorrelator | mqext.Wrm | ||
JMS_TOG_ARM_Correlator | mqext.Arm | 참고 6을 참조하십시오. |
서비스 통합은 IBM MQ 형식으로부터 메시지를 변환할 때 대응하는 MQMD 필드로부터 이들 각 특성의 설정합니다.
서비스 통합이 메시지를 IBM MQ 형식으로부터 변환할 때, 서비스 통합은 MQRFH2 jms.Cid 필드의 값(있는 경우)과 상관없이 JMS_IBM_MQMD_CorrelId 특성을 MQMD CorrelId 필드의 값(byte[])으로 설정합니다.
서비스 통합이 메시지를 IBM MQ 형식으로부터 변환할 때, 서비스 통합은 JMS_IBM_MQMD_MsgId 특성을 MQMD MsgId 필드의 값(byte[])으로 설정합니다.
서비스 통합이 메시지를 IBM MQ 형식으로부터 변환할 때, 서비스 통합은 MQRFH2 jms.Dlv 필드의 값(있는 경우)과 상관없이 JMS_IBM_MQMD_Persistence 특성을 MQMD Persistence 필드의 값(정수)으로 설정합니다.
서비스 통합이 메시지를 IBM MQ 형식으로부터 변환하는 경우, 서비스 통합은 MQRFH2 jms.Rto 필드의 값(있는 경우)과 상관없이 JMS_IBM_MQMD_ReplyToQ 및 JMS_IBM_MQMD_ReplyToQMgr 특성을 MQMD ReplyToQ 및 ReplyToQMgr 필드의 값(문자열)으로 설정합니다.