Sub-Field: 3.715

Parent File	Name	Number	Package
MAILBOX(#3.7)	FILTER	3.715	MailMan

Field #	Name	Loc	Type	Details
.01	FILTER	0;1	FREE TEXT	INPUT TRANSFORM: `K:$L(X)>30!($L(X)<3) X` LAST EDITED: `APR 22, 2002` HELP-PROMPT: `Answer must be 3-30 characters in length.` DESCRIPTION: `This is the name of your filter. The filter is used by MailMan to determine into which basket to place a message. Messages can be filtered based on up to three criteria which must all be true:` - Subject contains - Message is from - Message is to For example, if you specify 'subject contains' and 'message is from', the filter takes effect only if the subject contains the string you specify AND the message is from the person you specify. If you wish the filter to take effect upon 'subject contains' OR 'message is from' you must create two filters, one with 'subject contains', and the other with 'message is from'. Filtering takes place during message delivery and can also be selected as a basket action. The filter is ignored during delivery under the following conditions: - The message already exists in one of your baskets. - The message is from you, and you specified a basket (other than the IN basket) at the transmit prompt. - The sender has specified a delivery basket and you have allowed it. CROSS-REFERENCE: `3.715^B` 1)= S ^XMB(3.7,DA(1),15,"B",$E(X,1,30),DA)="" 2)= K ^XMB(3.7,DA(1),15,"B",$E(X,1,30),DA)
1	ORDER	0;2	NUMBER	**********************REQUIRED FIELD********************** INPUT TRANSFORM: `K:+X'=X!(X>999)!(X<1)!(X?.E1"."1N.N) X` LAST EDITED: `MAY 20, 1997` HELP-PROMPT: `Type a Number between 1 and 999, 0 Decimal Digits` DESCRIPTION: `This is the order in which you wish to have your filters checked.` A message may match several filters, depending on the conditions you have set. It is here that you specify relative filter priority. If several filters have the same order, then the first one you entered receives priority. If you aren't sure, enter 100. You can always change it later. CROSS-REFERENCE: `3.715^AF^MUMPS` 1)= N XMSTAT S XMSTAT=$P($G(^XMB(3.7,DA(1),15,DA,0)),U,4) I XMSTAT S ^XMB(3.7,DA(1),15,"AF",X,DA)="" 2)= N XMSTAT S XMSTAT=$P($G(^XMB(3.7,DA(1),15,DA,0)),U,4) I XMSTAT K ^XMB(3.7,DA(1),15,"AF",X,DA)
2	BASKET	0;3	FREE TEXT	**********************REQUIRED FIELD********************** INPUT TRANSFORM: `D BASKET^XMTDF(.X)` LAST EDITED: `MAY 21, 1997` HELP-PROMPT: `Answer must be a valid basket name (not the IN basket).` DESCRIPTION: `This is the basket you want any messages to go into if they match all of the conditions you specify for this filter.` The basket may not be the "IN" basket, because that is the default basket. The basket must exist (or be created) at the time you specify it. You may delete this basket later. If a message filters to this basket, and the basket does not exist, the basket will be created. EXECUTABLE HELP: `D BSKTHELP^XMTDF` NOTES: `XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER` CROSS-REFERENCE: `3.715^C` 1)= S ^XMB(3.7,DA(1),15,"C",$E(X,1,30),DA)="" 2)= K ^XMB(3.7,DA(1),15,"C",$E(X,1,30),DA)
3	STATUS	0;4	SET	**********************REQUIRED FIELD********************** '0' FOR OFF; '1' FOR ON; LAST EDITED: `MAY 20, 1997` DESCRIPTION: If the filter is active, it will be used. If the filter is not active, it will be ignored. CROSS-REFERENCE: `3.715^AC^MUMPS` 1)= Q:'X N XMORDER S XMORDER=$P($G(^XMB(3.7,DA(1),15,DA,0)),U,2) I XMORDER S ^XMB(3.7,DA(1),15,"AF",XMORDER,DA)="" 2)= Q:'X N XMORDER S XMORDER=$P($G(^XMB(3.7,DA(1),15,DA,0)),U,2) I XMORDER K ^XMB(3.7,DA(1),15,"AF",XMORDER,DA)
4	SUBJECT CONTAINS	0;5	FREE TEXT	INPUT TRANSFORM: `K:$L(X)>25!($L(X)<3) X S:$D(X) X=$$UP^XLFSTR(X)` LAST EDITED: `AUG 06, 1997` HELP-PROMPT: `Answer must be 3-25 characters in length.` DESCRIPTION: `If the subject contains the string you specify AND if the message matches the other conditions (if any), then the message matches this filter.` The subject is capitalized automatically to facilitate filtering. NOTES: `XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER`
5	FROM	0;6	FREE TEXT	INPUT TRANSFORM: `D FROM^XMTDF(.X)` OUTPUT TRANSFORM: `S:+Y=Y Y=$$NAME^XMXUTIL(Y)` LAST EDITED: `APR 22, 2002` HELP-PROMPT: `Who is the sender of the message?` DESCRIPTION: `This is the person who sent the message.` If it's a local person, just enter the name. If it's a remote person, enter name@site. MailMan will match any sender whose name contains 'name' and whose site contains 'site'. 'Name' may be null, in which case, MailMan will match any sender whose site contains 'site'. 'Site' may be null, in which case, MailMan will match any sender whose name contains 'name'. In any event, the string must be from 2 to 45 characters and must contain '@'. If it's a local message from a VISTA package/fake sender, put '@' at the end, like ACCOUNTS RECEIVABLE@ The sender's name is capitalized automatically to facilitate filtering. For this filter to activate, its STATUS must be on, this condition and the other conditions (if any) must match the message, and it must be the first filter (as controlled by its ORDER) to match the message. Finally, filtering must be turned on. NOTES: `XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER`
6	ADDRESSED TO	0;7	FREE TEXT	INPUT TRANSFORM: `D TO^XMTDF(.X)` LAST EDITED: `MAY 21, 1997` HELP-PROMPT: `Answer must be 1-55 characters in length.` DESCRIPTION: `Enter the person or group to whom the message is addressed. If the person is remote, enter name@site. MailMan will match any sender whose name contains 'name' and whose site contains 'site'. 'name' or 'site' may be` null. The addressee's name may be automatically capitalized to facilitate filtering. MailMan will check the addressees that you see when you Query (Q) the message. MailMan will NOT check the expanded list of addresses that you see when you Query Detailed (QD) the message. For this filter to activate, its STATUS must be on, this condition and the other conditions (if any) must match the message, and it must be the first filter (as controlled by its ORDER) to match the message. Finally, filtering must be turned on. NOTES: `XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER`
7	VAPORIZE DAYS	0;8	NUMBER	INPUT TRANSFORM: `K:+X'=X!(X>365)!(X<7)!(X?.E1"."1N.N) X` LAST EDITED: `APR 22, 2002` HELP-PROMPT: `Type a Number between 7 and 365, 0 Decimal Digits` DESCRIPTION: `The message will be set to vaporize (be deleted from your mailbox) this many days after it is delivered to you. This date will override any vaporize date set by the sender. You will be able to change or delete the` vaporize date at the message action prompt whenever you read the message. If this field is null, the filter will not set any vaporize date. This will only apply to new messages and responses which are put into your mailbox (includes moving from the WASTE basket) as a result of delivery or latering. It won't apply to messages which are already in your mailbox. It won't apply when you filter messages which are already in your mailbox.
8	DELIVER NEW?	0;9	SET	'Y' FOR YES; 'N' FOR NO; LAST EDITED: `MAY 05, 2000` HELP-PROMPT: `Answer YES or NO.` DESCRIPTION: `If you don't answer, or delete the answer, the default is YES.` YES means that the message will be delivered as usual, and made new as usual. NO means that the message will be delivered as usual, but it won't be made new, so you won't know it's arrived unless you check. This will only apply to new messages which you have not seen before. It won't apply to responses or forwarded messages with responses. It won't apply when you filter messages which are already in your mailbox.
9	FORWARD TO	1;0	Multiple #3.7159	3.7159

Field #

Name

Loc

Type

Details

.01

FILTER

0;1

FREE TEXT

INPUT TRANSFORM: K:$L(X)>30!($L(X)<3) X
LAST EDITED: APR 22, 2002
HELP-PROMPT: Answer must be 3-30 characters in length.

DESCRIPTION: This is the name of your filter. The filter is used by MailMan to determine into which basket to place a message. Messages can be filtered based on up to three criteria which must all be true:

- Subject contains

- Message is from

- Message is to

For example, if you specify 'subject contains' and 'message is from', the filter takes effect only if the subject contains the string you specify AND the message is from the person you specify.

If you wish the filter to take effect upon 'subject contains' OR 'message is from' you must create two filters, one with 'subject contains', and the other with 'message is from'.

Filtering takes place during message delivery and can also be selected as a basket action.  The filter is ignored during delivery under the following conditions:

- The message already exists in one of your baskets.

- The message is from you, and you specified a basket (other than the IN basket) at the transmit prompt.

- The sender has specified a delivery basket and you have allowed it.

CROSS-REFERENCE: 3.715^B

1)= S ^XMB(3.7,DA(1),15,"B",$E(X,1,30),DA)=""

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

1

ORDER

0;2

NUMBER

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

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

DESCRIPTION: This is the order in which you wish to have your filters checked.

A message may match several filters, depending on the conditions you have set.  It is here that you specify relative filter priority.  If several filters have the same order, then the first one you entered receives

priority.

If you aren't sure, enter 100.  You can always change it later.

CROSS-REFERENCE: 3.715^AF^MUMPS

1)= N XMSTAT S XMSTAT=$P($G(^XMB(3.7,DA(1),15,DA,0)),U,4) I XMSTAT S ^XMB(3.7,DA(1),15,"AF",X,DA)=""

2)= N XMSTAT S XMSTAT=$P($G(^XMB(3.7,DA(1),15,DA,0)),U,4) I XMSTAT K ^XMB(3.7,DA(1),15,"AF",X,DA)

2

BASKET

0;3

FREE TEXT

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

INPUT TRANSFORM: D BASKET^XMTDF(.X)
LAST EDITED: MAY 21, 1997
HELP-PROMPT: Answer must be a valid basket name (not the IN basket).

DESCRIPTION: This is the basket you want any messages to go into if they match all of the conditions you specify for this filter.

The basket may not be the "IN" basket, because that is the default basket.

The basket must exist (or be created) at the time you specify it.  You may delete this basket later.  If a message filters to this basket, and the basket does not exist, the basket will be created.

EXECUTABLE HELP: D BSKTHELP^XMTDF
NOTES: XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER

CROSS-REFERENCE: 3.715^C

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

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

3

STATUS

0;4

SET

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

'0' FOR OFF;
'1' FOR ON;

LAST EDITED: MAY 20, 1997

DESCRIPTION:

If the filter is active, it will be used.  If the filter is not active, it will be ignored.

CROSS-REFERENCE: 3.715^AC^MUMPS

1)= Q:'X  N XMORDER S XMORDER=$P($G(^XMB(3.7,DA(1),15,DA,0)),U,2) I XMORDER S ^XMB(3.7,DA(1),15,"AF",XMORDER,DA)=""

2)= Q:'X  N XMORDER S XMORDER=$P($G(^XMB(3.7,DA(1),15,DA,0)),U,2) I XMORDER K ^XMB(3.7,DA(1),15,"AF",XMORDER,DA)

4

SUBJECT CONTAINS

0;5

FREE TEXT

INPUT TRANSFORM: K:$L(X)>25!($L(X)<3) X S:$D(X) X=$$UP^XLFSTR(X)
LAST EDITED: AUG 06, 1997
HELP-PROMPT: Answer must be 3-25 characters in length.
DESCRIPTION: If the subject contains the string you specify AND if the message matches the other conditions (if any), then the message matches this filter.
```
The subject is capitalized automatically to facilitate filtering.
```
NOTES: XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER

5

FROM

0;6

FREE TEXT

INPUT TRANSFORM: D FROM^XMTDF(.X)
OUTPUT TRANSFORM: S:+Y=Y Y=$$NAME^XMXUTIL(Y)
LAST EDITED: APR 22, 2002
HELP-PROMPT: Who is the sender of the message?

DESCRIPTION: This is the person who sent the message.

If it's a local person, just enter the name.

If it's a remote person, enter name@site.  MailMan will match any sender whose name contains 'name' and whose site contains 'site'.  'Name' may be null, in which case, MailMan will match any sender whose site contains

'site'.  'Site' may be null, in which case, MailMan will match any sender whose name contains 'name'.  In any event, the string must be from 2 to 45 characters and must contain '@'.

If it's a local message from a VISTA package/fake sender, put '@' at the end, like ACCOUNTS RECEIVABLE@

The sender's name is capitalized automatically to facilitate filtering.

For this filter to activate, its STATUS must be on, this condition and the other conditions (if any) must match the message, and it must be the first filter (as controlled by its ORDER) to match the message.  Finally,

filtering must be turned on.

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

6

ADDRESSED TO

0;7

FREE TEXT

INPUT TRANSFORM: D TO^XMTDF(.X)
LAST EDITED: MAY 21, 1997
HELP-PROMPT: Answer must be 1-55 characters in length.

DESCRIPTION: Enter the person or group to whom the message is addressed. If the person is remote, enter name@site. MailMan will match any sender whose name contains 'name' and whose site contains 'site'. 'name' or 'site' may be

null.

The addressee's name may be automatically capitalized to facilitate filtering.

MailMan will check the addressees that you see when you Query (Q) the message.  MailMan will NOT check the expanded list of addresses that you see when you Query Detailed (QD) the message.

For this filter to activate, its STATUS must be on, this condition and the other conditions (if any) must match the message, and it must be the first filter (as controlled by its ORDER) to match the message.  Finally,

filtering must be turned on.

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

7

VAPORIZE DAYS

0;8

NUMBER

INPUT TRANSFORM: K:+X'=X!(X>365)!(X<7)!(X?.E1"."1N.N) X
LAST EDITED: APR 22, 2002
HELP-PROMPT: Type a Number between 7 and 365, 0 Decimal Digits

DESCRIPTION: The message will be set to vaporize (be deleted from your mailbox) this many days after it is delivered to you. This date will override any vaporize date set by the sender. You will be able to change or delete the

vaporize date at the message action prompt whenever you read the message.

If this field is null, the filter will not set any vaporize date.

This will only apply to new messages and responses which are put into your mailbox (includes moving from the WASTE basket) as a result of delivery or latering.  It won't apply to messages which are already in your

mailbox.  It won't apply when you filter messages which are already in your mailbox.

8

DELIVER NEW?

0;9

SET

'Y' FOR YES;
'N' FOR NO;

LAST EDITED: MAY 05, 2000
HELP-PROMPT: Answer YES or NO.

DESCRIPTION: If you don't answer, or delete the answer, the default is YES.

YES means that the message will be delivered as usual, and made new as usual.

NO means that the message will be delivered as usual, but it won't be made new, so you won't know it's arrived unless you check.

This will only apply to new messages which you have not seen before.  It won't apply to responses or forwarded messages with responses.  It won't apply when you filter messages which are already in your mailbox.

9

FORWARD TO

1;0

Multiple #3.7159

3.7159

Customize PDF page

Package: MailMan

MAILBOX(#3.7)-->3.715

Sub-Field: 3.715

Information

Details