Sub-Field: 3.702

Parent File	Name	Number	Package
3.701	MESSAGE	3.702	MailMan

Field #	Name	Loc	Type	Details
.01	MESSAGE	0;1	POINTER TO MESSAGE FILE (#3.9)	MESSAGE(#3.9) INPUT TRANSFORM: `S DINUM=+X` LAST EDITED: `JUL 30, 1997` HELP-PROMPT: `Users may not enter messages except through the SEND A MESSAGE option.` DESCRIPTION: Messages exist in the MESSAGE file and are pointed to by multiple RECIPIENTS. NOTES: `XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER` CROSS-REFERENCE: `3.7^M` 1)= S ^XMB(3.7,"M",$E(X,1,30),DA(2),DA(1),DA)="" 2)= K ^XMB(3.7,"M",$E(X,1,30),DA(2),DA(1),DA) CROSS-REFERENCE: `^^TRIGGER^3.702^2` 1)= K DIV S DIV=X,D0=DA(2),DIV(0)=D0,D1=DA(1),DIV(1)=D1,D2=DA,DIV(2)=D2 S Y(1)=$S($D(^XMB(3.7,D0,2,D1,1,D2,0)):^(0),1:"") S X=$P(Y(1),U,2),X=X S DIU=X K Y X ^DD(3.702,.01,1,3,1.1) X ^DD(3.702,.01,1,3,1.4) 1.1)= S X=DIV S X=$O(^XMB(3.7,DA(2),2,DA(1),1,"C",""),-1)+1 1.4)= S DIH=$S($D(^XMB(3.7,DIV(0),2,DIV(1),1,DIV(2),0)):^(0),1:""),DIV=X S $P(^(0),U,2)=DIV,DIH=3.702,DIG=2 D ^DICR:$O(^DD(DIH,DIG,1,0))>0 2)= Q CREATE VALUE)= XM NEXT SEQUENCE NUMBER DELETE VALUE)= NO EFFECT FIELD)= MAILBOX INDEX This trigger gives a new message the next sequence number in the mail basket.
2	MAILBOX INDEX	0;2	NUMBER	**********************REQUIRED FIELD********************** INPUT TRANSFORM: `K:+X'=X!(X>99999)!(X<1)!(X?.E1"."1N.N) X` LAST EDITED: `JUL 25, 1997` HELP-PROMPT: `Type a Number between 1 and 99999, 0 Decimal Digits` DESCRIPTION: This field is used to help the user choose a message. It is assigned when a message is delivered into a MailBox. NOTES: `TRIGGERED by the MESSAGE field of the MESSAGE sub-field of the BASKET sub-field of the MAILBOX File` CROSS-REFERENCE: `3.702^C` 1)= S ^XMB(3.7,DA(2),2,DA(1),1,"C",$E(X,1,30),DA)="" 2)= K ^XMB(3.7,DA(2),2,DA(1),1,"C",$E(X,1,30),DA)
3	NEW FLAG	0;3	SET	'0' FOR NOT NEW; '1' FOR NEW; LAST EDITED: `JUN 11, 1999` HELP-PROMPT: `If this message is new, set it to 1, otherwise delete it.` DESCRIPTION: This field indicates to the user and to MailMan whether or not a message is new. TECHNICAL DESCR: `While it is proper to set this field to 0 when the message is no longer new, the preferred method is to delete the field (=@).` Please note that the cross references on this field, N and N0, are not standard FileMan. They should be: ^XMB(3.7,duz,2,"N",X,xmk,xmz)="" But they are: ^XMB(3.7,duz,"N",xmk,xmz)="" CROSS-REFERENCE: `3.701^N0^MUMPS` 1)= S:X=1 ^XMB(3.7,DA(2),"N0",DA(1),DA)="" 2)= K ^XMB(3.7,DA(2),"N0",DA(1),DA) This x-ref is for new messages. CROSS-REFERENCE: `3.701^N^MUMPS` 1)= I X=1,$$PRIORITY^XMXSEC($G(^XMB(3.9,DA,0))) N % S %=$G(^XMB(3.9,DA,1,+$O(^XMB(3.9,DA,1,"C",DA(2),0)),0)) I '($P(%,U,9)&$P(%,U,10)) S ^XMB(3.7,DA(2),"N",DA(1),DA)="" 2)= K ^XMB(3.7,DA(2),"N",DA(1),DA) This x-ref is for priority messages. If the message is priority, this x-ref is set if the message is a new message or if the message has a new reply, and the user has chosen to have replies priority, too.
4	LAST READ DATE/TIME	0;4	DATE	INPUT TRANSFORM: `S %DT="ETR" D ^%DT S X=Y K:Y<1 X` LAST EDITED: `JUL 25, 1997` HELP-PROMPT: `Enter the date & time.` DESCRIPTION: This is the last date/time the message was read, printed. TECHNICAL DESCR: This field is used during the 'in basket purge' to identify messages which haven't been read in a while.
5	AUTOMATIC DELETE DATE	0;5	DATE	INPUT TRANSFORM: `S %DT="FEST" D ^%DT S X=Y K:Y<1 X` LAST EDITED: `OCT 25, 2000` HELP-PROMPT: `Enter the date (in the future) when this message should be deleted from your basket.` DESCRIPTION: This is the date at which this message will be 'vaporized', deleted from this mail basket for this user. WRITE AUTHORITY: ^ NOTES: `XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER` CROSS-REFERENCE: `3.7^AC` 1)= S ^XMB(3.7,"AC",$E(X,1,30),DA(2),DA(1),DA)="" 2)= K ^XMB(3.7,"AC",$E(X,1,30),DA(2),DA(1),DA)
6	NETWORK PRIORITY TRANSMISSION?	0;6	SET	'1' FOR HIGH PRIORITY; '0' FOR REGULAR PRIORITY; '2' FOR LOW PRIORITY; LAST EDITED: `FEB 22, 2002` HELP-PROMPT: `How should this message be handled during transmission?` DESCRIPTION: `This field is used to flag messages that need to be transmitted before or after all other messages in a queue.` Messages in the queue which are flagged as HIGH priority are transmitted before all other messages. Messages in the queue which are flagged as REGULAR priority (default) are transmitted next. Messages in the queue which are flagged as LOW priority are transmitted after all other messages. Messages with the same priority are transmitted in IEN order, which is not necessarily the order in which they appear in the transmit queue. Only the POSTMASTER (or surrogate) may change the priority of a message in a transmit queue. If, during a transmission, MailMan has problems with a particular message, MailMan may flag that message as LOW priority, so that other messages in the queue will transmit, before the problem message is attempted again. Changes to message priorities can be made even while a queue is being transmitted. FIELD INDEX: `AC (#183) REGULAR IR SORTING ONLY` Short Descr: Transmission Priority Cross Reference Description: This xref is used by MailMan during message transmission to identify messages which should be transmitted first (high priority) or last (low priority). Messages with regular priority are not xref'd. Set Logic: S ^XMB(3.7,DA(2),2,DA(1),1,"AC",$E(X,1,1),DA)="" Set Cond: S X=X Kill Logic: K ^XMB(3.7,DA(2),2,DA(1),1,"AC",$E(X,1,1),DA) Kill Cond: S X=X Whole Kill: K ^XMB(3.7,DA(2),2,DA(1),1,"AC") X(1): NETWORK PRIORITY TRANSMISSION? (3.702,6) (Subscr 1) (Len 1) (forwards)
7	DELETE DATE SET BY MAILMAN?	0;7	SET	'0' FOR NO; '1' FOR YES; LAST EDITED: `JUN 13, 1997` HELP-PROMPT: `Did MailMan set the automatic delete date for this message?` DESCRIPTION: `When the IN BASKET PURGE sets a delete date for a message, it sets this field to 1.` If a user sets a delete date for a message, this field is set to 0.

Field #

Name

Loc

Type

Details

.01

MESSAGE

0;1

POINTER TO MESSAGE FILE (#3.9)

MESSAGE(#3.9)

INPUT TRANSFORM: S DINUM=+X
LAST EDITED: JUL 30, 1997
HELP-PROMPT: Users may not enter messages except through the SEND A MESSAGE option.

DESCRIPTION:

Messages exist in the MESSAGE file and are pointed to by multiple RECIPIENTS.

NOTES: XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER

CROSS-REFERENCE: 3.7^M

1)= S ^XMB(3.7,"M",$E(X,1,30),DA(2),DA(1),DA)=""

2)= K ^XMB(3.7,"M",$E(X,1,30),DA(2),DA(1),DA)

CROSS-REFERENCE: ^^TRIGGER^3.702^2

1)= K DIV S DIV=X,D0=DA(2),DIV(0)=D0,D1=DA(1),DIV(1)=D1,D2=DA,DIV(2)=D2 S Y(1)=$S($D(^XMB(3.7,D0,2,D1,1,D2,0)):^(0),1:"") S X=$P(Y(1),U,2),X=X S DIU=X K Y X ^DD(3.702,.01,1,3,1.1) X ^DD(3.702,.01,1,3,1.4)

1.1)= S X=DIV S X=$O(^XMB(3.7,DA(2),2,DA(1),1,"C",""),-1)+1

1.4)= S DIH=$S($D(^XMB(3.7,DIV(0),2,DIV(1),1,DIV(2),0)):^(0),1:""),DIV=X S $P(^(0),U,2)=DIV,DIH=3.702,DIG=2 D ^DICR:$O(^DD(DIH,DIG,1,0))>0

2)= Q

CREATE VALUE)= XM NEXT SEQUENCE NUMBER

DELETE VALUE)= NO EFFECT

FIELD)= MAILBOX INDEX

This trigger gives a new message the next sequence number in the mail basket.

2

MAILBOX INDEX

0;2

NUMBER

************************REQUIRED FIELD************************

INPUT TRANSFORM: K:+X'=X!(X>99999)!(X<1)!(X?.E1"."1N.N) X
LAST EDITED: JUL 25, 1997
HELP-PROMPT: Type a Number between 1 and 99999, 0 Decimal Digits

DESCRIPTION:

This field is used to help the user choose a message.  It is assigned when a message is delivered into a MailBox.

NOTES: TRIGGERED by the MESSAGE field of the MESSAGE sub-field of the BASKET sub-field of the MAILBOX File

CROSS-REFERENCE: 3.702^C

1)= S ^XMB(3.7,DA(2),2,DA(1),1,"C",$E(X,1,30),DA)=""

2)= K ^XMB(3.7,DA(2),2,DA(1),1,"C",$E(X,1,30),DA)

3

NEW FLAG

0;3

SET

'0' FOR NOT NEW;
'1' FOR NEW;

LAST EDITED: JUN 11, 1999
HELP-PROMPT: If this message is new, set it to 1, otherwise delete it.

DESCRIPTION:

This field indicates to the user and to MailMan whether or not a message is new.

TECHNICAL DESCR: While it is proper to set this field to 0 when the message is no longer new, the preferred method is to delete the field (=@).

Please note that the cross references on this field, N and N0, are not standard FileMan.

They should be:  ^XMB(3.7,duz,2,"N",X,xmk,xmz)="" But they are:    ^XMB(3.7,duz,"N",xmk,xmz)=""

CROSS-REFERENCE: 3.701^N0^MUMPS

1)= S:X=1 ^XMB(3.7,DA(2),"N0",DA(1),DA)=""

2)= K ^XMB(3.7,DA(2),"N0",DA(1),DA)

This x-ref is for new messages.

CROSS-REFERENCE: 3.701^N^MUMPS

1)= I X=1,$$PRIORITY^XMXSEC($G(^XMB(3.9,DA,0))) N % S %=$G(^XMB(3.9,DA,1,+$O(^XMB(3.9,DA,1,"C",DA(2),0)),0)) I '($P(%,U,9)&$P(%,U,10)) S ^XMB(3.7,DA(2),"N",DA(1),DA)=""

2)= K ^XMB(3.7,DA(2),"N",DA(1),DA)

This x-ref is for priority messages.  If the message is priority, this x-ref is set if the message is a new message or if the message has a new reply, and the user has chosen to have replies priority, too.

4

LAST READ DATE/TIME

0;4

DATE

INPUT TRANSFORM: S %DT="ETR" D ^%DT S X=Y K:Y<1 X
LAST EDITED: JUL 25, 1997
HELP-PROMPT: Enter the date & time.

DESCRIPTION:

This is the last date/time the message was read, printed.

TECHNICAL DESCR:

This field is used during the 'in basket purge' to identify messages which haven't been read in a while.

5

AUTOMATIC DELETE DATE

0;5

DATE

INPUT TRANSFORM: S %DT="FEST" D ^%DT S X=Y K:Y<1 X
LAST EDITED: OCT 25, 2000
HELP-PROMPT: Enter the date (in the future) when this message should be deleted from your basket.

DESCRIPTION:

This is the date at which this message will be 'vaporized', deleted from this mail basket for this user.

WRITE AUTHORITY:  ^

NOTES: XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER

CROSS-REFERENCE: 3.7^AC

1)= S ^XMB(3.7,"AC",$E(X,1,30),DA(2),DA(1),DA)=""

2)= K ^XMB(3.7,"AC",$E(X,1,30),DA(2),DA(1),DA)

6

NETWORK PRIORITY TRANSMISSION?

0;6

SET

'1' FOR HIGH PRIORITY;
'0' FOR REGULAR PRIORITY;
'2' FOR LOW PRIORITY;

LAST EDITED: FEB 22, 2002
HELP-PROMPT: How should this message be handled during transmission?

DESCRIPTION: This field is used to flag messages that need to be transmitted before or after all other messages in a queue.

Messages in the queue which are flagged as HIGH priority are transmitted before all other messages.

Messages in the queue which are flagged as REGULAR priority (default) are transmitted next.

Messages in the queue which are flagged as LOW priority are transmitted after all other messages.

Messages with the same priority are transmitted in IEN order, which is not necessarily the order in which they appear in the transmit queue.

Only the POSTMASTER (or surrogate) may change the priority of a message in a transmit queue.  If, during a transmission, MailMan has problems with a particular message, MailMan may flag that message as LOW priority, so

that other messages in the queue will transmit, before the problem message is attempted again.

Changes to message priorities can be made even while a queue is being transmitted.

FIELD INDEX: AC (#183) REGULAR IR SORTING ONLY

Short Descr:  Transmission Priority Cross Reference

Description:  This xref is used by MailMan during message transmission to identify messages which should be transmitted first (high priority) or last (low priority).  Messages with regular priority are not xref'd.

Set Logic:  S ^XMB(3.7,DA(2),2,DA(1),1,"AC",$E(X,1,1),DA)=""

Set Cond:  S X=X

Kill Logic:  K ^XMB(3.7,DA(2),2,DA(1),1,"AC",$E(X,1,1),DA)

Kill Cond:  S X=X

Whole Kill:  K ^XMB(3.7,DA(2),2,DA(1),1,"AC")

X(1):  NETWORK PRIORITY TRANSMISSION?  (3.702,6)  (Subscr 1)  (Len 1)  (forwards)

7

DELETE DATE SET BY MAILMAN?

0;7

SET

'0' FOR NO;
'1' FOR YES;

LAST EDITED: JUN 13, 1997
HELP-PROMPT: Did MailMan set the automatic delete date for this message?
DESCRIPTION: When the IN BASKET PURGE sets a delete date for a message, it sets this field to 1.
```
If a user sets a delete date for a message, this field is set to 0.
```

Customize PDF page

Package: MailMan

MAILBOX(#3.7)-->3.701-->3.702

Sub-Field: 3.702

Information

Details