Sun Java System Messaging Server 6.3 관리 설명서

22.3.5 알림 메시지 등록 정보

모든 메시지는 등록 정보에 정의된 추가 정보를 전달합니다. 메시지마다 다른 등록 정보가 있습니다. 예를 들어, NewMsg는 새 메시지의 IMAP uid를 나타냅니다.

22.3.5.1 표준 알림 메시지 등록 정보

표 22–3에서는 표준 알림 메시지 등록 정보에 대해 설명합니다. 이 등록 정보는 모든 JMS 메시지에 있습니다.

표 22–3 표준 알림 메시지 등록 정보

등록 정보 

데이터 유형 

설명 

hostname

ConstMQString 

메시지를 생성한 시스템의 호스트 이름입니다. 

pid

MQInt32 

메시지를 생성한 프로세스의 ID입니다. 

process

ConstMQString 

메시지를 생성한 프로세스의 이름을 지정합니다. 

timestamp

MQFloat64 

기준 시점(GMT로 1970년 1월 1일 자정)으로부터 지난 시간(밀리초)을 지정합니다. 

22.3.5.2 특정 알림 메시지에만 해당되는 등록 정보

표 22–4에서는 특정 알림 메시지와 함께 전달되는 등록 정보에 대해 설명합니다.

각 메시지에는 아래 표에 표시된 등록 정보의 일부가 포함됩니다. 각 메시지에 연결된 등록 정보의 목록은 표 22–5를 참조하십시오.

표 22–4 특정 알림 메시지에만 해당되는 등록 정보

등록 정보 

데이터 유형 

설명 

client

ConstMQString 

메시지에 연결된 Message Queue 클라이언트의 IP 주소입니다. 

diskquota

MQInt32 

메시지에 연결된 사용자의 디스크 공간 할당량(KB)입니다. 값이 -1로 설정되면 할당량이 없는 것을 나타냅니다. 

diskquotaused

MQInt32 

메시지와 연결된 사용자가 사용하는 디스크 공간 크기(KB)입니다. 

hdrLen

MQInt32 

메시지 헤더의 크기입니다. 메시지 본문에 있는 헤더가 잘렸을 수도 있기 때문에 해당 헤더의 크기와 이 값이 다를 수도 있습니다. 

imapUid

MQInt32 

메시지와 연결된 IMAP uid 등록 정보입니다. 

lastUid

MQInt32 

메일함에 사용된 마지막 IMAP uid 값입니다. 

mailboxName

ConstMQstring 

이벤트와 연결된 메시지 저장소 메일함 이름입니다. mailboxName에는 다음 형식 중 하나가 지정됩니다. 여기서 uid는 사용자의 고유 식별자입니다.

uid — 기본(주) 도메인에 있는 사용자의 받은 메일함을 식별합니다.

uid@domain — 호스트된 도메인에 있는 사용자의 받은 메일함을 식별합니다.

uid/mailboxname — 기본 도메인에 있는 사용자의 최상위 메일함을 식별합니다.

uid@domain/mailboxname — 호스트된 도메인에 있는 사용자의 최상위 메일함을 식별합니다.

uid/foldername/mailboxname — 기본 도메인에 있는 사용자 폴더의 메일함을 식별합니다.

uid@domain/foldername/mailboxname — 호스트된 도메인에 있는 사용자 폴더의 메일함을 식별합니다.

msgquota

MQInt32 

최대 메시지 수에 대한 사용자의 할당량입니다. 값이 -1로 설정되면 할당량이 없는 것을 나타냅니다. 

newflags

ConstMQString 

현재 작업으로 인해 플래그가 변경된 후에 사용자의 메일함 메시지에 설정되는 플래그입니다. MsgFlags 알림 메시지가 생성된 경우에는 항상 이 등록 정보가 oldflags와 함께 존재합니다.

newflags의 구문과 값은 이 표 아래 있는 newflags 및 oldflags 등록 정보의 구문을 참조하십시오.

numDeleted

MQInt32 

메일함에서 삭제됨으로 표시된 메시지의 수입니다.  

이 수는 메일함 소유자가 삭제한 메시지의 수를 계산합니다. 다른 사용자가 메일함에 액세스할 수 있는 경우 메일함에서 다른 사용자가 수행하는 작업은 이 수에 포함되지 않습니다. (다른 사용자의 작업으로 DeleteMsg 등의 알림이 트리거될 수는 있습니다.)

numDeletednn

MQInt32 

메일함에서 삭제됨으로 표시된 메시지의 총 수를 나타내며, 각 메시지 유형별로 지정됩니다. 메시지 유형이 구성된 경우  

numDeletednn 등록 정보는 각 메시지 유형 nn에 대한 수를 전달합니다.

numDeleted 등록 정보는 항상 전달됩니다. 이 등록 정보는 모든 유형을 포함하여 삭제됨으로 표시된 모든 메시지의 총 수를 계산합니다.

예를 들어 20개의 메시지가 삭제됨으로 표시된 경우 10개가 유형 3이고, 7개가 유형 16이고, 나머지 메시지의 유형은 인식되지 않았다면 알림과 함께 다음 등록 정보 및 수 값이 전달됩니다.  

numDeleted=20

numDeleted3=10

numDeleted16=7

numMsgs

MQInt32 

현재 메일함에 있는 총 메시지 수입니다. 

numMsgsnn

MQInt32 

현재 메일함에 있는 메시지의 총 수를 나타내며 각 메시지 유형별로 지정됩니다. 메시지 유형이 구성된 경우  

numMsgsnn 등록 정보는 각 메시지 유형 nn에 해당하는 개수를 전달합니다.

numMsgs 등록 정보는 항상 전달됩니다. 이 등록 정보는 모든 유형을 포함하여 메일함에 있는 모든 메시지의 총 수를 나타냅니다.

예를 들어, 현재 메일함에 20개의 메시지가 있는 경우 10개가 유형 3이고, 7개가 유형 16이고, 나머지 메시지의 유형은 인식되지 않았다면 알림과 함께 다음 등록 정보 및 수 값이 전달됩니다.  

numMsgs=20

numMsgs3=10

numMsgs16=7

numSeen

MQInt32 

메일함에서 조회(읽음)로 표시된 메시지의 수입니다. 

이 수는 메일함 소유자가 읽은 메시지의 수를 계산합니다. 다른 사용자가 메일함에 액세스할 수 있는 경우 메일함에서 다른 사용자가 수행하는 작업은 이 수에 포함되지 않습니다. (다른 사용자의 작업으로 ReadMsg 등의 알림이 트리거될 수는 있습니다).

numSeennn

MQInt32 

메일함에서 조회(읽음)으로 표시된 메시지의 총 수를 나타내며, 각 메시지 유형별로 지정됩니다. 메시지 유형이 구성된 경우 numSeennn 등록 정보는 각 메시지 유형 nn에 해당하는 개수를 전달합니다.

numSeen 등록 정보는 항상 전달됩니다. 여기서는 모든 유형을 총괄하여 조회로 표시된 모든 메시지의 수를 나타냅니다.

예를 들어 20개의 메시지가 조회로 표시된 경우 10개가 유형 3이고, 7개가 유형 16이고, 나머지 메시지의 유형은 인식되지 않았다면 알림과 함께 다음 등록 정보 및 수 값이 전달됩니다.  

numSeen=20

numSeen3=10

numSeen16=7

numSeenDeleted

MQInt32 

메일함에서 조회(읽음)으로 표시되고 삭제됨으로 표시된 메시지의 수입니다. 

이 값은 읽음으로 표시되고 메일함 소유자에 의해 삭제된 메시지의 수를 나타냅니다. 다른 사용자가 메일함에 액세스할 수 있는 경우 메일함에서 다른 사용자가 수행하는 작업은 이 수에 포함되지 않습니다. (하지만 다른 사용자의 작업으로 ReadMsgDeleteMsg와 같은 알림이 트리거될 수는 있습니다).

numSeenDeletednn

MQInt32 

메일함에서 조회(읽음)으로 표시되고 삭제됨으로 표시된 메시지의 총 수를 나타내며, 각 메시지 유형별로 지정됩니다. 메시지 유형이 구성된 경우 numSeenDeletednn 등록 정보는 각 메시지 유형 nn에 해당하는 개수를 전달합니다.

numSeenDeleted 등록 정보는 항상 전달됩니다. 이 등록 정보는 모든 유형을 포함하여 읽음 및 삭제됨으로 표시된 모든 메시지의 총 수를 나타냅니다.

예를 들어 20개의 메시지가 읽음 및 삭제됨으로 표시된 경우 10개가 유형 3이고, 7개가 유형 16이고, 나머지 메시지의 유형은 인식되지 않았다면 알림과 함께 다음 등록 정보 및 수 값이 전달됩니다.  

numSeenDeleted=20

numSeenDeleted3=10

numSeenDeleted16=7

oldflags

ConstMQString 

현재 작업으로 인해 플래그가 변경되기 전에 사용자의 메일함 메시지에 설정되었던 플래그입니다. MsgFlags 알림 메시지가 생성된 경우에는 항상 이 등록 정보가 newflags와 함께 존재합니다.

oldflags의 구문과 값은 이 표 아래 있는 newflags 및 oldflags 등록 정보의 구문을 참조하십시오.

quotaRoot

ConstMQString 

이 값은 사용자 이름, 폴더 이름 또는 메시지 유형이 될 수 있습니다. 

size

MQInt32 

메시지의 크기입니다. 본문은 보통 메시지가 잘린 버전이기 때문에 이 값은 메시지 본문의 크기와 다를 수 있습니다. 

uidValidity

MQInt32 

IMAP uid 유효성 등록 정보입니다. 

userid

ConstMQString 

메시지와 연결된 사용자 아이디입니다. 


주 –

가입자는 메시지 참조를 구문 분석할 때 기록되지 않은 등록 정보를 허용해야 합니다. 그러면 이후에 새 등록 정보가 추가되어도 호환성을 유지할 수 있습니다.


newflags 및 oldflags 등록 정보의 구문

newflagsoldflags 등록 정보는 5자로 된 문자열입니다. 문자열에는 다음 값이 있어야 합니다.

22.3.5.3 각 알림 메시지와 함께 전달되는 등록 정보

표 22–5에서는 각 알림 메시지와 연결된 등록 정보가 표시되어 있습니다.

예를 들어 TrashMsg 메시지에 적용되는 등록 정보를 보려면 "ReadMsg, TrashMsg"의 열 헤더를 살펴 봅니다.TrashMsg 메시지에는 표준 등록 정보 외에도 mailboxName, numMsgs, uidValidity, numSeennumDeleted를 사용할 수 있습니다.

표 22–5 각 알림 메시지와 함께 전달되는 등록 정보

등록 정보 

NewMsg, UpdateMsg 

ReadMsg, TrashMsg 

DeleteMsg, PurgeMsg 

MsgFlags 

 

Login, Logout 

OverQuota, UnderQuota 

client

아니요 

아니요 

아니요 

아니요 

예 

아니요 

diskquota

아니요 

아니요 

아니요 

아니요 

아니요 

예 

diskquotaused

아니요 

아니요 

아니요 

아니요 

아니요 

예 

hdrLen

예 

아니요 

아니요 

예 

아니요 

아니요 

hostname

예 

예 

예 

예 

예 

예 

imapUid

예 

아니요 

예 

예 

아니요 

아니요 

lastUid

아니요 

아니요 

예 

아니요 

아니요 

아니요 

mailboxName

예 

예 

예 

예 

아니요 

아니요 

msgquota

아니요 

아니요 

아니요 

아니요 

아니요 

예 

newflags

아니요 

아니요 

아니요 

예 

아니요 

아니요 

numDeleted

예 

예 

예 

아니요 

아니요 

아니요 

numDeletedn

예* 

예* 

예* 

아니요 

아니요 

아니요 

numMsgs

예 

예 

예 

아니요 

아니요 

예 

numMsgsn

예* 

예* 

예* 

아니요 

아니요 

아니요 

numSeen

예 

예 

예 

아니요 

아니요 

아니요 

numSeenn

예* 

예* 

예* 

아니요 

아니요 

아니요 

numSeenDeleted

예 

예 

예 

아니요 

아니요 

아니요 

numSeenDeletedn

예* 

예* 

예* 

아니요 

아니요 

아니요 

oldflags

아니요 

아니요 

아니요 

예 

아니요 

아니요 

Owner

아니요 

예 

아니요 

아니요 

아니요 

아니요 

pid

예 

예 

예 

예 

예 

예 

process

예 

예 

예 

예 

예 

예 

quotaRoot

아니요 

아니요 

아니요 

아니요 

아니요 

예 

size

예 

아니요 

아니요 

아니요 

아니요 

아니요 

timestamp

예 

예 

예 

예 

예 

예 

uidValidity

예 

예 

예 

예 

아니요 

아니요 

userid

아니요 

예 

아니요 

아니요 

예 

예 


주 –

* numDeletedn, numMsgs n, numSeennnumSeenDeletedn 등록 정보는 메시지 저장소에 메시지 유형이 정의된 경우에만 알림과 함께 전달됩니다.