메시지 데이터
모든 문제 판별 공통 기본 이벤트는 공통 기본 이벤트의 msg 필드 내 보고된 특정 이벤트를 설명하는 사람이 읽을 수 있는 텍스트를 제공해야 합니다.
실제 메시지나 로그 항목을 표시하는 이벤트와 연관된 텍스트가 변환되고 로컬화될 것으로 예상합니다. 국제화된 텍스트가 이벤트에 제공될 때마다 공통 기본 이벤트에 msgDataElement 요소를 포함하십시오. 이 요소는 메시지 텍스트가 작성되는 방법 및 해석되는 방법에 대한 정보를 제공합니다. 프로그래밍 방식으로 이벤트를 해석하려고 하거나 메시지 텍스트를 포맷하는 데 사용되는 로케일이나 언어와 상관 없이 메시지를 해석하려고 하는 경우 이 정보는 특히 귀중합니다.
전제조건: 국제화된 메시지 작성과 연관된 개념을 이해하십시오. 이 개념에 대한 교육의 좋은 소스가 Java™ 정보의 국제화 및 Java 언어 내 자원 번들 사용과 연관된 문서에서 제공됩니다.
공통 기본 이벤트의 msgDataElement 요소는 이벤트와 제공된 msg 필드의 값에 대한 다음 정보를 포함합니다.
- 제공된 메시지 텍스트의 로케일이며, 메시지의 언어(msgLocale)뿐만 아니라 메시지 내 로케일 독립 필드가 포맷 지정되는 방식을 식별합니다.
- 메시지 언어, 메시지 로케일 및 메시지 포맷(msgId 및 msgIdType)과 독립적인 메시지를 해석하는 데 사용될 수 있는 메시지와 연관된 로케일 독립적인 ID입니다.
- 다음을 포함한 변환된 메시지가 작성되는 방법에 대한 정보:
- 메시지 템플리트(msgCatalogId)를 검색하는 데 사용된 ID.
- 메시지 템플리트(msgCatalog 및 msgCatalogType)를 검색하는 데 사용된 메시지 카탈로그의 이름과 유형.
- 메시지 템플리트로 삽입되어 최종 메시지(msgCatalogTokens)를 작성하는 로케일 독립적인 정보.
- msg
- 모든 메시지, 로그 및 추적 이벤트는 공통 기본 이벤트의 msg 필드에서 사람이 읽을 수 있는 메시지를 제공해야 합니다. msg 필드는
문제점 판별 이벤트, 로그 이벤트와 진단 이벤트 모두에 대해 필요합니다. 이 필드는 공통 기본 이벤트에 대한 기본 스펙보다 제한적이며,
선택사항으로 이 필드를 나열합니다. 효과적이며 효율적인 문제점 판별은 보고된 조건을 빨리 식별하는 기능을 필요로 합니다.
이 메시지의 포맷과 사용법은 컴포넌트에 따라 다르지만 다음 일반 가이드라인을 사용합니다.
- 메시지와 로그 이벤트로 제공된 메시지 텍스트를 국제화할 것으로 예상합니다.
- 공통 기본 이벤트의 msgDataElement 요소에서 msgLocale 필드와 함께 제공된 메시지 텍스트의 로케일을 제공합니다.
- 공통 기본 이벤트의 msgDataElement 요소를 사용하여, 가능할 때마다 국제화된 메시지의 포맷과 구성에 대한 추가 정보를 제공합니다.
- msgLocale
- 모든 문제점 판별 이벤트의 경우처럼 메시지 텍스트가 공통 기본 이벤트 내에 제공될 때마다 메시지 로케일을 제공합니다. msgLocale 필드는 공통 기본 이벤트 스펙 내 선택사항 값으로 나열되지만, 가능할 때마다 문제점 판별 이벤트 내 이 정보를 제공합니다. 이 필드가 문제점 판별 이벤트에 대해 필요하지 않는 이유는 공통 기본 이벤트 포맷을 지정할 때 로케일 정보를 제공하거나 사용 가능하지 않은 경우가 존재하기 때문입니다.
- msgId 및 msgIdType
- 몇몇 회사는 메시지와 상관 없이 메시지 텍스트에서 설명한 조건을 해석하는 데 사용할 수 있는 국제화된 메시지 텍스트 내 로케일 독립적인 ID를 포함합니다. 예를 들어, IBM® 소프트웨어에서 실행된 대부분의 메시지는 IEE890I WTO Buffers in console backup storage = 1024와 유사하며, 여기서 고유한 로케일 독립적인 ID IEE890I는 변환된 메시지 텍스트보다 선행합니다. 이 ID는 위치와 언어에 독립적인 메시지를 고유하게 발견하고 식별하는 방법을 제공합니다. 이 발견은 로케일 독립적인 프로그래밍 방식의 분석에 중요합니다.
- msgId 필드는 공통 기본 이벤트 스펙 내 선택사항 값으로 나열되지만, 이 ID가 메시지 텍스트에 포함될 때마다 문제점 판별 이벤트 내 제공되어야 합니다. 마찬가지로, msgIdType 필드는 공통 기본 이벤트 스펙 내 선택적 값으로 나열되지만, 값이 msgId에 제공될 때마다 문제점 판별 이벤트 내에 제공되어야 합니다. 추적 이벤트와 같이 메시지 텍스트가 변환되거나 로컬화되지 않으면 이 필드를 제공하지 마십시오.
- msgCatalogId
- msgCatalogId 필드는 공통 기본 이벤트 스펙 내 선택사항 값으로 나열되지만, 공통 기본 이벤트가 로컬화되거나 변환된 메시지 텍스트를 포함할 때마다 이 값을 제공합니다. 예를 들어 실행된 메시지나 로그 이벤트를 표시하는 문제점 판별 이벤트를 제공하는 경우입니다. 모든 문제점 판별 이벤트가 변환된 메시지 텍스트를 포함하는 것은 아니기 때문에 문제점 판별 이벤트에 대해 이 필드가 필요하지 않으며, 공통 기본 이벤트 포맷을 지정할 때 값이 제공되지 않거나 사용 불가능한 경우가 일부 존재합니다. 추적 이벤트와 같이 메시지 텍스트가 변환되거나 로컬화되지 않으면 이 필드를 제공하지 마십시오.
- msgCatalogTokens
- msgCatalogTokens 필드는 공통 기본 이벤트 스펙 내 선택사항 값으로 나열되지만, 공통 기본 이벤트가 로컬화되거나 변환된 메시지 텍스트를 포함할 때마다 이 값을 제공합니다. 예를 들어 실행된 메시지나 로그 이벤트를 표시하는 문제점 판별 이벤트를 제공하는 경우입니다. 모든 문제점 판별 이벤트가 변환된 메시지 텍스트를 포함하는 것은 아니기 때문에 문제점 판별 이벤트에 대해 이 필드가 필요하지 않으며, 공통 기본 이벤트 포맷을 지정할 때 값이 제공되지 않거나 사용 불가능한 경우가 존재합니다. 이 값은 변환된 메시지 작성 시 로컬화된 메시지로 삽입된 메시지 토큰이나 로케일 독립적인 값의 목록을 포함합니다.
- 메시지를 작성하는 데 사용되는 변환된 메시지 템플리트를 알지 않고 변환된 메시지에서 이 값을 추출하기는 어렵습니다. 메시지 텍스트가 변환되거나 로컬화되지 않으면 이 필드를 제공하지 마십시오.
- 공통 기본 이벤트는 이 필드, 확장된 데이터 요소 및 스키마에 대한 확장기능을 포함한 이벤트에 대한 추가 데이터를 제공하기 위한 여러 메커니즘을 제공합니다. 항상 msgCatalogTokens 필드를 사용하여 이벤트와 연관된 메시지 텍스트에 포함된 메시지 토큰의 목록을 제공합니다. 이 값은 공통 기본 이벤트의 다른 부분에도 제공될 수 있지만 이 필드에 포함되어야 합니다.
- msgCatalog 및 msgCatalogType
- msgCatalog 및 msgCatalogType 필드는 공통 기본 이벤트 스펙 내 선택사항 값으로 나열되지만, 공통 기본 이벤트가 로컬화되거나 변환된 메시지 텍스트를 포함할 때마다 이 값을 제공합니다. 예를 들어 실행된 메시지나 로그 이벤트를 표시하는 문제점 판별 이벤트를 제공하는 경우입니다. 모든 문제점 판별 이벤트가 변환된 메시지 텍스트를 포함하는 것은 아니기 때문에 문제점 판별 이벤트에 대해 이 필드가 필요하지 않으며, 공통 기본 이벤트 포맷을 지정할 때 값이 제공되지 않거나 사용 불가능한 경우가 존재합니다. 추적 이벤트와 같이 메시지 텍스트가 변환되거나 로컬화되지 않으면 이 필드를 완료하지 마십시오.