모든 메시지는 등록 정보에 정의된 추가 정보를 전달합니다. 메시지마다 다른 등록 정보가 있습니다. 예를 들어, NewMsg는 새 메시지의 IMAP uid를 나타냅니다.
표 22–3에서는 표준 알림 메시지 등록 정보에 대해 설명합니다. 이 등록 정보는 모든 JMS 메시지에 있습니다.
표 22–3 표준 알림 메시지 등록 정보
등록 정보 |
데이터 유형 |
설명 |
---|---|---|
hostname |
ConstMQString |
메시지를 생성한 시스템의 호스트 이름입니다. |
pid |
MQInt32 |
메시지를 생성한 프로세스의 ID입니다. |
process |
ConstMQString |
메시지를 생성한 프로세스의 이름을 지정합니다. |
timestamp |
MQFloat64 |
기준 시점(GMT로 1970년 1월 1일 자정)으로부터 지난 시간(밀리초)을 지정합니다. |
표 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 |
메일함에서 조회(읽음)으로 표시되고 삭제됨으로 표시된 메시지의 수입니다. 이 값은 읽음으로 표시되고 메일함 소유자에 의해 삭제된 메시지의 수를 나타냅니다. 다른 사용자가 메일함에 액세스할 수 있는 경우 메일함에서 다른 사용자가 수행하는 작업은 이 수에 포함되지 않습니다. (하지만 다른 사용자의 작업으로 ReadMsg 및 DeleteMsg와 같은 알림이 트리거될 수는 있습니다). |
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 등록 정보는 5자로 된 문자열입니다. 문자열에는 다음 값이 있어야 합니다.
/answered 플래그가 설정된 경우 첫 문자는 "A"입니다. 설정되지 않은 경우 비어 있습니다(“ “).
/flagged 플래그가 설정된 경우 둘째 문자는 "F"입니다. 설정되지 않은 경우 비어 있습니다(“ “).
/deleted 플래그가 설정된 경우 셋째 문자는 "D"입니다. 설정되지 않은 경우 비어 있습니다(“ “).
/seen 플래그가 설정된 경우 넷째 문자는 "S"입니다. 설정되지 않은 경우 비어 있습니다(“ “).
/draft 플래그가 설정된 경우 다섯째 문자는 "R"입니다. 설정되지 않은 경우 비어 있습니다(“ “).
표 22–5에서는 각 알림 메시지와 연결된 등록 정보가 표시되어 있습니다.
예를 들어 TrashMsg 메시지에 적용되는 등록 정보를 보려면 "ReadMsg, TrashMsg"의 열 헤더를 살펴 봅니다.TrashMsg 메시지에는 표준 등록 정보 외에도 mailboxName, numMsgs, uidValidity, numSeen 및 numDeleted를 사용할 수 있습니다.
표 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, numSeenn 및 numSeenDeletedn 등록 정보는 메시지 저장소에 메시지 유형이 정의된 경우에만 알림과 함께 전달됩니다.