MQSeries 컨텍스트 속성
MQSeries 어댑터는 응용 프로그램에서 사용할 수 있는 MQSeries 관련 컨텍스트 속성 집합을 제공합니다. 이러한 속성은 필터 식 및 오케스트레이션에서 사용할 수 있습니다.
MQSeries 어댑터에 바인딩된 송신 포트로 향하는 메시지에 MQSeries 컨텍스트 속성을 할당하려면 메시지 할당 연산자를 사용하여 MQSeries 네임스페이스에서 사용 가능한 컨텍스트 속성 중 하나를 지정합니다.
다음은 MQSeries MQMD_UserIdentifier 속성을 설정하는 예제입니다.
Message_2(MQSeries.MQMD_UserIdentifier) = "MeMyselfAndI";
IBM MQSeries SDK에 포함된 C 프로그래밍 언어 헤더 파일에서 열거된 값을 가져와야 합니다. 이러한 파일은 Program Files\IBM\WebSphere MQ\Tools\c\include 폴더에서 찾을 수 있으며, MQSeries 컨텍스트 속성 값을 설정하거나 읽을 때 사용할 값을 정의합니다.
16진수 문자열 값은 이진 값을 나타내는 문자열로서, 0x와 같은 접두사가 없습니다. 0에서 9 사이의 숫자와 "a"에서 "f" 또는 "A"에서 "F" 사이의 문자를 포함하며, 공백은 어댑터에서 무시됩니다.
이러한 속성에 대한 자세한 내용은 IBM WebSphere MQ 설명서를 참조하십시오.
다음 표는 사용 가능한 전체 메시지 설명자(MQMD 구조) 속성과 해당 유형 및 값 집합을 보여 줍니다.
| Name | 형식 | 길이 | 값 |
|---|---|---|---|
| MQMD_AccountingToken | 문자열 | 64 | 16진수 문자열 |
| MQMD_ApplIdentityData | 문자열 | 32 | 16진수 문자열 |
| MQMD_ApplOriginData | 문자열 | 4 | String 기본값: 공백 |
| MQMD_BackoutCount | 부호 없는 정수 | 4 | 숫자 읽기 전용 기본값: 0 |
| MQMD_CodedCharSetId | 부호 없는 정수 | 4 | 숫자 기본값: 0 |
| MQMD_CorrelId | 문자열 | 48 | 16진수 문자열 |
| MQMD_Encoding | 부호 없는 정수 | 4 | 숫자 헤더 파일 값을 사용합니다. 기본값: 0 |
| MQMD_Expiry | 부호 없는 정수 | 4 | 숫자 |
| MQMD_Feedback | 부호 없는 정수 | 4 | 숫자 헤더 파일 값을 사용합니다. 기본값: 0 |
| MQMD_Format | 문자열 | 8 | String MQXMIT로 설정된 경우 MQXQH 속성에 값이 있는지 확인합니다. |
| MQMD_GroupID | 문자열 | 48 | 16진수 문자열 |
| MQMD_MsgFlags | 부호 없는 정수 | 4 | 숫자 헤더 파일 값을 사용합니다. 기본값: 0 |
| MQMD_MsgId | 문자열 | 48 | 16진수 문자열 |
| MQMD_MsgSeqNumber | 부호 없는 정수 | 4 | |
| MQMD_MsgType | 부호 없는 정수 | 4 | 숫자 헤더 파일 값을 사용합니다. |
| MQMD_Offset | 부호 없는 정수 | 4 | |
| MQMD_OriginalLength | 부호 없는 정수 | 4 | |
| MQMD_Persistence | 부호 없는 정수 | 4 | 숫자 헤더 파일 값을 사용합니다. |
| MQMD_Priority | 부호 없는 정수 | 4 | 숫자 |
| MQMD_PutApplName | string | 28 | String 기본값: 공백 |
| MQMD_PutApplType | 부호 없는 정수 | 4 | 숫자 헤더 파일 값을 사용합니다. 기본값: 0 |
| MQMD_PutDate | 문자열 | 8 | Date |
| MQMD_PutTime | 문자열 | 8 | Time |
| MQMD_ReplyToQ | string | 48 | String 기본값: 공백 |
| MQMD_ReplyToQMgr | 문자열 | 48 | String 기본값: 공백 |
| MQMD_Report | 부호 없는 정수 | 4 | 숫자 헤더 파일 값을 사용합니다. |
| MQMD_UserIdentifier | 문자열 | 12 | 문자열 SSOAffiliateApplication 속성을 사용할 때 사용자 식별자를 포함합니다. |
MQSeries 전송 큐에서 직접 메시지를 받는 경우 MQSeries 어댑터에서 전송 큐 헤더 속성(MQXQH 데이터 구조)의 형식을 지정하여 해당 컨텍스트 속성에 배치합니다. MQSeries 전송 큐에 직접 메시지를 보낼 때 헤더 속성은 MQMD_Format 속성의 값이 MQXMIT인 경우에만 해당 컨텍스트 속성의 형식이 지정되고 값이 할당됩니다. 다음 표는 이러한 속성에 대해 설명합니다.
| Name | 형식 | 길이 | 값 |
|---|---|---|---|
| MQXQH_RemoteQMgrName | 문자열 | 48 | 문자열 |
| MQXQH_RemoteQName | 문자열 | 48 | 문자열 |
이 항목의 앞부분에 나열된 속성과 함께 어댑터에서는 동일한 규칙에 따라 다음 메시지 설명자 값을 채웁니다. 이러한 속성 이름 앞에는 MQMD_ 대신 MQXQH_가 접두사로 오지만 그렇지 않은 경우에는 메시지 설명자 테이블에 정의된 해당 속성에 직접 매핑됩니다.
MQXQH_MsgDesc_AccountingToken
MQXQH_MsgDesc_ApplIdentityData
MQXQH_MsgDesc_ApplOriginData
MQXQH_MsgDesc_BackoutCount
MQXQH_MsgDesc_CodedCharSetId
MQXQH_MsgDesc_CorrelId
MQXQH_MsgDesc_Encoding
MQXQH_MsgDesc_Expiry
MQXQH_MsgDesc_Feedback
MQXQH_MsgDesc_Format
MQXQH_MsgDesc_MsgId
MQXQH_MsgDesc_MsgType
MQXQH_MsgDesc_Persistence
MQXQH_MsgDesc_Priority
MQXQH_MsgDesc_PutApplName
MQXQH_MsgDesc_PutApplType
MQXQH_MsgDesc_PutDate
MQXQH_MsgDesc_PutTime
MQXQH_MsgDesc_ReplyToQ
MQXQH_MsgDesc_ReplyToQMgr
MQXQH_MsgDesc_Report
MQXQH_MsgDesc_UserIdentifier
필터링 식에 사용할 수 있는 추가 MQSeries 관련 속성이 속성 스키마에 포함되어 있습니다. 다음 표는 이러한 속성을 보여 줍니다.
| Name | 형식 | 길이 | 값 |
|---|---|---|---|
| MQCIH_AbendCode | 문자열 | 4 | |
| MQCIH_ADSDescriptor | 부호 없는 정수 | 4 | |
| MQCIH_AttentionId | 문자열 | 4 | |
| MQCIH_Authenticator | 문자열 | 8 | SSOAffiliateApplication 속성을 사용할 때 SSO 암호로 설정합니다. 참고: 이 값은 SSO 암호 길이가 8자를 초과하는 경우 MQSeries 어댑터에 의해 공백으로 설정됩니다. |
| MQCIH_CancelCode | 문자열 | 4 | |
| MQCIH_CompCode | 부호 없는 정수 | 4 | |
| MQCIH_ConversationalTask | 부호 없는 정수 | 4 | |
| MQCIH_CursorPosition | 부호 없는 정수 | 4 | |
| MQCIH_ErrorOffset | 부호 없는 정수 | 4 | |
| MQCIH_Facility | 문자열 | 16 | 16진수 문자열 |
| MQCIH_FacilityKeepTime | 부호 없는 정수 | 4 | |
| MQCIH_FacilityLike | 문자열 | 4 | |
| MQCIH_Flags | 부호 없는 정수 | 4 | |
| MQCIH_Format | 문자열 | ||
| MQCIH_Function | 문자열 | 4 | |
| MQCIH_GetWaitInterval | 부호 없는 정수 | 4 | |
| MQCIH_LinkType | 부호 없는 정수 | 4 | |
| MQCIH_NextTransactionId | 문자열 | 4 | |
| MQCIH_OutputDataLength | 부호 없는 정수 | 4 | |
| MQCIH_Reason | 부호 없는 정수 | 4 | |
| MQCIH_ReplyToFormat | 문자열 | ||
| MQCIH_ReturnCode | 부호 없는 정수 | 4 | |
| MQCIH_StartCode | 문자열 | 4 | |
| MQCIH_TaskEndStatus | 부호 없는 정수 | 4 | |
| MQCIH_TransactionId | 문자열 | 4 | |
| MQCIH_UOWControl | 부호 없는 정수 | 4 | |
| MQIIH_Authenticator | 문자열 | 8 | SSOAffiliateApplication 속성을 사용할 때 SSO 암호로 설정합니다. 참고: 이 값은 SSO 암호 길이가 8자를 초과하는 경우 MQSeries 어댑터에 의해 공백으로 설정됩니다. |
| MQIIH_CommitMode | string | ||
| MQIIH_Flags | 부호 없는 정수 | 4 | |
| MQIIH_Format | 문자열 | ||
| MQIIH_LTermOverride | 문자열 | 8 | |
| MQIIH_MFSMapName | 문자열 | 8 | |
| MQIIH_ReplyToFormat | string | ||
| MQIIH_SecurityScope | 문자열 | ||
| MQIIH_TranInstanceId | 문자열 | 32 | 16진수 문자열 |
| MQIIH_TranState | string |