Global: ^XMB(1

FileMan FileNo	FileMan Filename	Package
4.3	MAILMAN SITE PARAMETERS	MailMan

Package	Total	Routines
MailMan	2	XMA32 XMXADDR2
Medicine	2	MCARAP1 MCARPAL
Consult Request Tracking	1	GMRCISEG
Health Data and Informatics	1	HDISDSR1
Health Summary	1	GMTSOBE
Imaging	1	MAGIPT20
Lab Service	1	LRPHLIST
Scheduling	1	SDEC46

Package	Total	FileMan Files
Kernel	3	COMMUNICATIONS PROTOCOL(#3.4)[8.23] INSTITUTION(#4)[217] NEW PERSON(#200)[#4.31(2)]
MailMan	3	DOMAIN(#4.2)[.01, 3, #4.31(.01)] MAILMAN TIME ZONE(#4.4)[1] TRANSMISSION SCRIPT(#4.6)[8.24]
VA FileMan	1	FILE(#1)[#4.32(1)]

Fields, Total: 68

Field #	Name	Loc	Type	Details
.001	NUMBER		NUMBER	INPUT TRANSFORM: `K:+X'=X!(X>1)!(X<1)!(X?.E1"."1N.N) X` LAST EDITED: `DEC 17, 1985` HELP-PROMPT: `TYPE A WHOLE NUMBER BETWEEN 1 AND 1` DESCRIPTION: `Used to have VA fileman only have one entry in the file.`
.01	DOMAIN NAME	0;1	POINTER TO DOMAIN FILE (#4.2)	**********************REQUIRED FIELD********************** DOMAIN(#4.2) INPUT TRANSFORM: `S DINUM=1` LAST EDITED: `MAY 17, 2024` DESCRIPTION: `This is the name of this installation of MailMan, as it is known to the rest of the network. It must appear in the DOMAIN file. This name applies to all CPUs or Volume sets which access this ^XMB global.` AUDIT: `YES, ALWAYS` DELETE TEST: `.01,0)= I 1` NOTES: `XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER` CROSS-REFERENCE: `4.3^B` `1)= S ^XMB(1,"B",$E(X,1,30),DA)=""` `2)= K ^XMB(1,"B",$E(X,1,30),DA)` CROSS-REFERENCE: `4.3^AD^MUMPS` `1)= S ^XMB("NUM")=X` `2)= K ^XMB("NUM")` `This cross reference is used to record the pointer to the domain that is the name of the local site.` CROSS-REFERENCE: `4.3^AF^MUMPS` `1)= I $D(^DIC(4.2,+X,0)) S (^XMB("NAME"),^XMB("NETNAME"))=$P(^DIC(4.2,+X,0),"^")` `2)= K ^XMB("NAME"),^XMB("NETNAME")` `This cross reference is used to record the human readable name of the local site's identity.`
1	TIME ZONE	0;2	POINTER TO MAILMAN TIME ZONE FILE (#4.4)	**********************REQUIRED FIELD********************** MAILMAN TIME ZONE(#4.4) LAST EDITED: `MAY 17, 2024` HELP-PROMPT: `Enter the time zone of this domain.` DESCRIPTION: `This field defines the timezone in which this domain is located. Note that Standard and Daylight savings times are considered two different timezones, requiring that the timezone be changed with the changing of daylight` `savings. The timezones are located in the MailMan timezone file. The values of the cross references on this field are appended to message dates as they are sent over the network.` AUDIT: `YES, ALWAYS` CROSS-REFERENCE: `4.3^AC^MUMPS` `1)= S ^XMB("TIMEZONE")=$P(^XMB(4.4,X,0),U)` `2)= K ^XMB("TIMEZONE")` `This cross reference is used to record the name of the timezone that is the correct time zone for the local site.` CROSS-REFERENCE: `4.3^AG^MUMPS` `1)= S ^XMB("TIMEDIFF")=$$TIMEDIFF^XMXUTIL1($P(^XMB(4.4,X,0),U,3))` `2)= K ^XMB("TIMEDIFF")` `This cross reference records the time difference, in standard internet format, between this time zone and GMT.` `For example, +0800 means 8 hours ahead of GMT.` `-0130 means 1 1/2 hours behind GMT.`
2	SUBORDINATE DOMAIN	1;0	POINTER Multiple #4.31	4.31 DESCRIPTION: `This field is not currently used. This field describes the domains which are subordinate to this one; that is, those domains which consider this domain a parent.`
3	PARENT	0;3	POINTER TO DOMAIN FILE (#4.2)	DOMAIN(#4.2) INPUT TRANSFORM: `S DIC("S")="I +Y'=^XMB(""NUM"")" D ^DIC K DIC S DIC=DIE,X=+Y K:Y<0 X` LAST EDITED: `JAN 24, 2001` DESCRIPTION: `This field holds the name of the domain which is considered the parent of this domain. The parent domain's subordinate domain list will contain this domain, also.` `Parent domains are used for routing messages when a subordinate domain does not know a direct path to the selected domain.` `Domains are connected to their parents as follows:` `1. The local domain is named. 2. The parent is named at the local site. 3. A script from the parent to the subordinate domain is created. 4. A christening operation is performed by the parent domain.` `When the subordinate domain is christened, the domain is connected` `to the network. (Mail may be addressed to remote domains)` SCREEN: `S DIC("S")="I +Y'=^XMB(""NUM"")"` EXPLANATION: `Parent may not be the site itself.` CROSS-REFERENCE: `4.3^AE^MUMPS` `1)= S ^XMB("PARENT")=X` `2)= K ^XMB("PARENT")` `This cross reference is used to record the IEN of the domain that is the Parent of the local site.`
4	DATE CHRISTENED	0;4	DATE	INPUT TRANSFORM: `S %DT="ET" D ^%DT S X=Y K:Y<1 X` HELP-PROMPT: `Date on which this domain was christened by its parent.` DESCRIPTION: `This holds the date on which this local domain was christened by its parent domain.`
4.301	NO-PURGE DAYS BUFFER	.14;1	NUMBER	INPUT TRANSFORM: `K:+X'=X!(X>5)!(X<2)!(X?.E1"."1N.N) X` LAST EDITED: `SEP 18, 1998` HELP-PROMPT: `Type a Number between 2 and 5, 0 Decimal Digits` DESCRIPTION: `This field is used by the unreferenced messages purge to avoid purging the last few days worth of messages in the message file. It should be a number sufficiently high so as to avoid purging messages which are in danger` `of being purged before they can be delivered. This includes incoming network mail messages. The minimum (and default if this field is null) is two days.` `For example, if this field is 2, then messages up to and including those whose local create date is 2 days ago are subject to possible purge.`
4.302	PURGE AUDIT	.1;0	DATE Multiple #4.302	4.302 LAST EDITED: `JAN 23, 1998` DESCRIPTION: `This multiple contains a history of Message file purges. Generally, a record of the last 20 purges is kept.` `MailMan has two ways to purge messages. The option XMAUTOPURGE is generally run after XMCLEAN (the waste basket cleaner) and will purge any messages that are not pointed at by any recipients nor the sender. The option` `XMPURGE-BY-DATE can also be run to purge messages that have an origination date older than one used to initiate the process. It is recommended that before XMPURGE-BY-DATE is used, users be notified of the proposed purge` `date so they have a chance to preserve important texts. These are the only options that actually kill off entries in the message file. The XMPURGE option does the same thing as XMAUTOPURGE, but is meant to be run in` `foreground and displays data as it proceeds.` `Unlike XMPURGE and XMAUTOPURGE, which only remove messages that no one holds in their mail baskets any more, XMPURGE-BY-DATE will remove messages from users' mail baskets and then delete them from the message file (3.9).`
4.303	AUTOMATIC INTEGRITY CHECK	.12;1	SET	'0' FOR YES; '1' FOR NO; LAST EDITED: `MAY 20, 1991` HELP-PROMPT: `Enter 'Y' if you wish to run the integrity checker, 'N' if you do not wish to run the Integrity Checker (before the XMAUTOPURGE).` DESCRIPTION: `XMAUTOPURGE is generally run at least once a week at most sites. It is the process that purges messages that are no longer referenced. Before it is run, XMCLEAN is generally run. XMCLEAN removes messages from WASTE` `baskets so that they will be unreferenced when XMAUTOPURGE comes along. XMAUTOPURGE kicks off the part of XMUTCHECKFILE that checks the Mail Box file. XMUTCHECKFILE also resets and cleans up the x-refs of this file. If` `your system has had fairly clean runs of XMUTCHECKFILE or if the entire XMUTCHECKFILE process is run regularly as a separate process, it is not necessary for XMAUTOPURGE to run any part of it again.` TECHNICAL DESCR: `If this field is set to nill or other value that can be evaluated to zero (+field=zero), then XMUTCHECKFIL is called to check MailBoxes and recreate the X-ref that the XMAUTOPURGE uses to verify that a message is no longer` `referenced by anyone. If it is set to 1, then this call to XMUTCHECKFIL is skipped.`
4.304	WEEKDAY DAYS TO PURGE	NOTOPURGE;1	NUMBER	INPUT TRANSFORM: `K:+X'=X!(X>999)!(X<30)!(X?.E1"."1N.N) X` LAST EDITED: `SEP 17, 1998` HELP-PROMPT: `Type a Number between 30 and 999, 0 Decimal Digits` DESCRIPTION: `When the unreferenced messages purge runs, it purges messages from the message file, ^XMB(3.9, which are no longer referenced, meaning they aren't in anyone's mailbox.` `If this field is null, OR if the purge is run on Saturday, the purge starts at the beginning of the message file.` `If this field has a value, AND the purge is run on Sunday through Friday, the purge starts at the message create date calculated by subtracting the number of days from today's date.` `So, if this number is 45, the unreferenced message purge would start with messages created 45 days ago, and work from there forward.`
5	SHOW INSTITUTION IN MAILMAN?	0;5	SET	'y' FOR YES; 'n' FOR NO; HELP-PROMPT: `If yes, then the user's institution code will be displayed.` DESCRIPTION: `This field controls whether mailman will show the user's organization after his name. This is useful when MailMan has many remote users, who may not know each other's location or affiliation.`
5.1	MESSAGE ACTION DEFAULT	0;15	SET	'I' FOR IGNORE; 'D' FOR DELETE; LAST EDITED: `DEC 06, 1990` DESCRIPTION: `This is the default for the user prompt, "Message Action". The user may over-ride this default by selecting his own under "Edit User Options".`
5.11	COPY LIMIT - RECIPIENTS	.11;1	NUMBER	INPUT TRANSFORM: `K:+X'=X!(X>99999)!(X<1)!(X?.E1"."1N.N) X` LAST EDITED: `JAN 23, 1998` HELP-PROMPT: `Type a Number between 1 and 99999, 0 Decimal Digits` DESCRIPTION: `This field enables site management to control whether a message with more than a certain number of recipients may be copied. A user may not copy a message which has more than this number of recipients. If this field is` `null, then the limit is 2999.`
5.12	COPY LIMIT - RESPONSES	.11;2	NUMBER	INPUT TRANSFORM: `K:+X'=X!(X>9999)!(X<0)!(X?.E1"."1N.N) X` LAST EDITED: `JAN 23, 1998` HELP-PROMPT: `Type a Number between 0 and 9999, 0 Decimal Digits` DESCRIPTION: `This field enables site management to limit the number of responses to a message that may be copied. A user may not copy more than this number of responses to a message. If this field is null, then the limit is 99.`
5.13	COPY LIMIT - LINES	.11;3	NUMBER	INPUT TRANSFORM: `K:+X'=X!(X>9999999)!(X<99)!(X?.E1"."1N.N) X` LAST EDITED: `JAN 23, 1998` HELP-PROMPT: `Type a Number between 99 and 9999999, 0 Decimal Digits` DESCRIPTION: `This field enables site management to limit the number of lines that may be copied from a message and its responses. A user may not copy more than this number of message lines. If this field is null, then the limit is` `3999.`
7	REQUIRE INTRODUCTIONS?	0;6	SET	'y' FOR YES; 'n' FOR NO; LAST EDITED: `JAN 23, 1998` HELP-PROMPT: `Are users required to enter introductory text about themselves to the MailMan system?` DESCRIPTION: `If this is turned on, then users must introduce themselves when they first log in to MailMan. This forces users to describe themselves, and enter their phone numbers and addresses for others to query with the HELP options` `in MailMan.`
7.01	FWD TEST MESSAGE TO POSTMASTER	FORWARD;1	SET	'1' FOR NO; '0' FOR YES; LAST EDITED: `DEC 28, 1992` HELP-PROMPT: `Enter NO (or 1) to not send test messages about forwarding addresses to the Postmaster.` DESCRIPTION: `Messages are sent automatically to a user's forwarding address if he changes it. If you want these messages to be sent to the Postmaster, also, so that he is aware that the forwarding addresses are proper mark this field` `with "YES".`
7.2	BIG GROUP SIZE	0;7	NUMBER	INPUT TRANSFORM: `K:+X'=X!(X>10000)!(X<50)!(X?.E1"."1N.N) X` LAST EDITED: `APR 24, 2002` HELP-PROMPT: `Type a Number between 50 and 10000, 0 Decimal Digits` DESCRIPTION: `During message addressing, when a user addresses a message to a mail group with a lot of members, it can seem to take forever to process the group. (Dots of death!) This field, BIG GROUP SIZE, can help.` `IF you enter a number in this field, AND` `- If the group contains member groups` `or - If the group contains distribution lists` `or - If the number of local members plus the number of remote members exceeds or equals the BIG GROUP SIZE boundary` `THEN the user is asked whether s/he wants to queue the group for later delivery, and avoid waiting while the group is processed.` `The user is also warned that if s/he chooses to queue delivery, then recipients may not be 'minus'ed from the group.` `If the user chooses not to queue delivery, then processing proceeds in the foreground, as usual.` `If the user chooses to queue delivery, then s/he is asked when the delivery should take place. The group is then queued for processing and delivery at the specified time (by the same background job which 'news' messages).` `There is no default. (If BIG GROUP SIZE equates to zero, then groups are processed in the foreground as usual.)`
7.3	SHOW DUZ WHEN ADDRESS MESSAGE	0;8	SET	'0' FOR NO; '1' FOR YES; LAST EDITED: `APR 24, 2002` DESCRIPTION: `When someone addresses a message to a local user, should the DUZ of the local user be displayed?` `(If this field is null, the default answer is "no".)` `Disadvantages:` `- Your site's DUZs may be SSNs. They should not be displayed.` `- Users may be confused by the display.` `Advantages:` `- A DUZ is unique, whereas some users may share the same or very similar name. If a user knows the addressee's DUZ, the DUZ may be used to address a message, instead of the name.`
7.4	SHOW ADDRESS ON USER LOOKUP	0;10	SET	'0' FOR NO; '1' FOR YES; LAST EDITED: `MAY 11, 1999` HELP-PROMPT: `Should the user's address be displayed in a MailMan lookup?` DESCRIPTION: `Option XMHELPUSER displays user information. Among the items displayed are the address fields (.111 through .116) from the NEW PERSON file.` `Some sites have home address information in these fields, which should not be displayed.` `If the address fields should be displayed, answer YES; otherwise, answer NO. If this field is null, the default answer is NO.`
7.5	CPU (UCI,VOL) FOR FILER TO RUN	0;12	FREE TEXT	INPUT TRANSFORM: `K:$L(X)>30!($L(X)<3) X` LAST EDITED: `JAN 22, 1998` HELP-PROMPT: `Answer must be 3-30 characters in length.` DESCRIPTION: `Enter the UCI,VOL of where you want the background filer routines to run. It is recommended that the XMB global also reside in this location. If you are unsure what to enter, leave this field blank.`
7.6	FTP ADDRESS FOR BLOB	FTP-GET;1	FREE TEXT	INPUT TRANSFORM: `K:'($$VALIDATE^XLFIPV(X)) X` LAST EDITED: `AUG 13, 2015` HELP-PROMPT: `Enter a valid IP address in the form: nn.nn.nn.nn (IPv4) or hhhh:hhhh:hhhh:hhhh:hhhh:hhhh:hhhh:hhhh (IPv6)` DESCRIPTION: `If your images are on a network that is available via FTP from your main node and you have no other way of accessing those message to get them onto you main node so that you can FTP them to other sites, put the IP address` `of the machine that you will GET your images from into this field.` NOTES: `XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER`
7.7	FTP RECEIVE DIRECTORY	DISK/VOL;1	FREE TEXT	INPUT TRANSFORM: `K:$L(X)>90!($L(X)<3) X` LAST EDITED: `FEB 25, 1994` HELP-PROMPT: `Answer must be 3-90 characters in length.` DESCRIPTION: `This field is used to store the path for BLOBs to be received in. It is communicated to the transmitter of messages containing BLOBS so that they can be FTP'd to the correct directory once the disk has been designated` `with field 7.711.` `If the receiving system is a DOS system the disk portion of the path is in the field 'FTP RECEIVE DISK'.` TECHNICAL DESCR:
7.71	FTP RECEIVE NETWORK LOCATION	FTPNETLOC;1	FREE TEXT	INPUT TRANSFORM: `K:$L(X)>30!($L(X)<3) X` LAST EDITED: `APR 26, 1993` HELP-PROMPT: `Answer must be 3-30 characters in length.` DESCRIPTION: `This field should be the name of an entry in your 2005.2 file (Network Location). It maps where incoming BLOBs will be placed and is the logical equivalent of field 7.7.` TECHNICAL DESCR:
7.711	FTP RECEIVE DISK	FTPRCVDISK;1	FREE TEXT	INPUT TRANSFORM: `K:$L(X)>30!($L(X)<2) X` LAST EDITED: `APR 26, 1993` HELP-PROMPT: `Answer must be 2-30 characters in length.` DESCRIPTION: `This field contains the name of the physical disk that the FTP Receive Network Location is on if the receiving system is a DOS system.`
7.72	FTP ADDRESS FOR BLOB RECEIVE	FTP-RCV;1	FREE TEXT	INPUT TRANSFORM: `K:'($$VALIDATE^XLFIPV(X)) X` LAST EDITED: `AUG 13, 2015` HELP-PROMPT: `Enter a valid IP address in the form: nn.nn.nn.nn (IPv4) or hhhh:hhhh:hhhh:hhhh:hhhh:hhhh:hhhh:hhhh (IPv6)` DESCRIPTION: `This is the IP address that you will advertise to other sites that wish to send you images that attach to multimedia messages.` NOTES: `XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER`
7.73	FTP USERNAME	FTPUSER;1	FREE TEXT	INPUT TRANSFORM: `K:$L(X)>30!($L(X)<3) X` LAST EDITED: `APR 23, 1993` HELP-PROMPT: `Answer must be 3-30 characters in length.` DESCRIPTION: `This is the VMS username that the sender will be told to use when he FTP's BLOBs to this domain.`
7.731	FTP PASSWORD	FTPPWD;1	FREE TEXT	INPUT TRANSFORM: `K:$L(X)>30!($L(X)<3) X` LAST EDITED: `APR 23, 1993` HELP-PROMPT: `Answer must be 3-30 characters in length.` DESCRIPTION: `This is the password if any that a BLOB sender needs to have when he FTPs into the system.`
7.7999	FTP NOTES	FTP-NOTES;0	WORD-PROCESSING #4.37	DESCRIPTION: `This field holds site specific notes for this site on FTP operations. It is not used by MailMan.` LAST EDITED: `JUN 16, 1993` HELP-PROMPT: `Put special notes revelant to the FTP operations of this site.` DESCRIPTION: `See above.`
8.11	LPC CHECKSUM	LPC;E1,245	MUMPS	INPUT TRANSFORM: `K:$L(X)>245 X D:$D(X) ^DIM` LAST EDITED: `MAR 10, 1989` HELP-PROMPT: `This is Standard MUMPS code used by network mail to calculate checksums.` DESCRIPTION: `The code in this field will be obsolete after installation of KERNEL 6, if the "LPC" node in ^%ZOSF [^%ZOSF("LPC")] is defined. This field is inserted by the MailMan POST-init if the ^%ZOSF("OS") is defined, contains` `"DSM" and does not contain "VAX". This is because of a situation that exists where DSM for PDP-aa series used to use on $ZCALL anbd in the updated version uses a slightly different one. Both do not exist in one system.` `The way it is inserted is by setting an error trap and then trying one. If it doesn't work, it must be the onther.` `WRITE AUTHORITY: @`
8.12	TCP CHANNEL - MAXIMUM TO USE	0;17	NUMBER	INPUT TRANSFORM: `K:+X'=X!(X>999)!(X<0)!(X?.E1"."1N.N) X` LAST EDITED: `SEP 26, 1992` HELP-PROMPT: `Type a Number between 0 and 999, 0 Decimal Digits` DESCRIPTION: `This field contains a value that is checked before starting a process to transmit mail via a TCP/IP channel. If there are already as many processes running as is in this field, no process is started.`
8.13	STATS NORMALIZATION	7;1	FREE TEXT	INPUT TRANSFORM: `K:$L(X)>99!($L(X)<1) X` LAST EDITED: `JAN 23, 1998` HELP-PROMPT: `Answer must be 1-99 characters in length.` DESCRIPTION: `This option allows the user to customize the normalized report.`
8.14	LARGE MESSAGE REPORT LINES	XMUT2-LINES;1	NUMBER	INPUT TRANSFORM: `K:+X'=X!(X>999999)!(X<1)!(X?.E1"."1N.N) X` LAST EDITED: `JAN 23, 1998` HELP-PROMPT: `Type a Number between 1 and 999999, 0 Decimal Digits` DESCRIPTION: `This field is used by the large message report. Any message with more than this many lines is included in the report. If this field is null, the default is 100.`
8.15	TCP/IP POLLER RUN FLAG	0;18	SET	'1' FOR STOP RUNNING; '0' FOR OKAY TO RUN; LAST EDITED: `JUN 26, 1995` DESCRIPTION: `This field is checked every time the background tcp poller, XMRTCP, starts to process poller request. If it is set to 1, XMRTCP stops running. If it is null or zero, XMRTCP processes the next entry. If XMRTCP is not` `running it will not be restarted if the field is set to 1. If it is null or 0, and XMRTCP is not running, a background task will be created to restart it.`
8.2	RECORD NETMAIL TRANSCRIPT?	0;14	SET	'1' FOR YES; '0' FOR NO; LAST EDITED: `JUN 27, 1990` DESCRIPTION: `This field allows the site manager to turn on and off (toggle) whether or not MailMan records all script transcripts in background. The send portion of scripts played (using the 'Play Script' option) will not be recorded.`
8.21	XMITS TILL ERROR MESSAGE	NETWORK;1	NUMBER	INPUT TRANSFORM: `K:+X'=X!(X>999)!(X<5)!(X?.E1"."1N.N) X` LAST EDITED: `FEB 11, 1993` HELP-PROMPT: `Type a Number between 5 and 999, 0 Decimal Digits` DESCRIPTION: `How many times will a transmission be attempted before a message is sent to the Postmaster indicating that there have been multiple, unsuccessful transmissions to a domain.`
8.22	DNS AWARE	NETWORK;2	SET	'0' FOR NO; '1' FOR YES; LAST EDITED: `APR 22, 2002` HELP-PROMPT: `Should MailMan use DNS to look up IP addresses?` DESCRIPTION: `In order for MailMan to be DNS aware, the site must have installed the requisite Kernel patches for DNS.` `- DNS IP (field 51 in file 8989.3) must contain an IP address for a DNS server.` `- Routine ^XLFNSLK must exist.` `If you answer 'no', MailMan will use the IP addresses in the domain scripts.` `If you answer 'yes', MailMan will use the IP addresses in the domain scripts, but if they fail, or don't exist, MailMan will use DNS to ascertain other IP addresses to try. MailMan will replace failed script IP address` `with the successful DNS IP address.`
8.23	TCP/IP COMMUNICATIONS PROTOCOL	NETWORK;3	POINTER TO COMMUNICATIONS PROTOCOL FILE (#3.4)	COMMUNICATIONS PROTOCOL(#3.4) LAST EDITED: `JUN 12, 2002` HELP-PROMPT: `Which protocol shall be used for TCP/IP?` DESCRIPTION: `For TCP/IP connections, the scripts (the TEXT field, 2, in the TRANSMISSION SCRIPT multiple, 4, of the DOMAIN file, 4.2) can be built on-the-fly, if they don't exist, and if both this field and field 8.24 are filled in.` `We identify the TCP/IP transmission scripts in file 4.2 by the TYPE field, 1.2, within the TRANSMISSION SCRIPT multiple. Those whose TYPE is 'SMTP', 'TCPCHAN', or null are considered TCP/IP transmission scripts.` `We can build the scripts, because they are standard.` `Here's an example of one for FORUM:` `O H=DOMAIN.EXT,P=TCP/IP-MAILMAN C TCPCHAN-SOCKET25` `In this script, the TCP/IP-MAILMAN refers to the communications protocol to use. This field should point to the communications protocol in file 3.4 that should be used for TCP/IP connections.`
8.24	TCP/IP TRANSMISSION SCRIPT	NETWORK;4	POINTER TO TRANSMISSION SCRIPT FILE (#4.6)	TRANSMISSION SCRIPT(#4.6) LAST EDITED: `JUN 12, 2002` HELP-PROMPT: `Which script shall be used for TCP/IP?` DESCRIPTION: `For TCP/IP connections, the scripts (the TEXT field, 2, in the TRANSMISSION SCRIPT multiple, 4, of the DOMAIN file, 4.2) can be built on-the-fly, if they don't exist, and if both this field and field 8.23 are filled in.` `We identify the TCP/IP transmission scripts in file 4.2 by the TYPE field, 1.2, within the TRANSMISSION SCRIPT multiple. Those whose TYPE is 'SMTP', 'TCPCHAN', or null are considered TCP/IP transmission scripts.` `We can build the scripts, because they are standard.` `Here's an example of one for FORUM:` `O H=DOMAIN.EXT,P=TCP/IP-MAILMAN` `C TCPCHAN-SOCKET25` `In this script, the TCPCHAN-SOCKET25 refers to the transmission script to use. This field should point to the transmission script in file 4.6 that should be used for TCP/IP connections.`
8.25	TCP/IP DEVICE	NETWORK;5	FREE TEXT	INPUT TRANSFORM: `K:$L(X)>30!($L(X)<1) X I $D(X) S %ZIS="NQRS",IOP=X D ^%ZIS K:POP X S:$D(X) X=ION W:$D(X) " Stored internally as ",X D ^%ZISC S IOP="HOME" D ^%ZIS K IOP,%ZIS` LAST EDITED: `SEP 06, 2002` HELP-PROMPT: `Which device shall be used for TCP/IP?` DESCRIPTION: `For TCP/IP connections, the physical link/device to be used is usually standard - some sort of NULL device. This field is a free-text pointer to that device in the DEVICE (#3.5) file.` `The device pointed to by this field will be used for a TCP/IP connection if, in the DOMAIN (#4.2) file, the device field is null in both of the following fields:` `- PHYSICAL LINK / DEVICE (#1.3) field of the TRANSMISSION SCRIPT (#4) multiple` `- PHYSICAL LINK DEVICE (#17) field` `For more information, see the PHYSICAL LINK DEVICE (#17) field in the DOMAIN (#4.2) file.` NOTES: `XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER`
8.3	NETWORK - MAX LINES SEND	NETWORK-LIMIT;1	NUMBER	INPUT TRANSFORM: `K:+X'=X!(X>15000)!(X<2000)!(X?.E1"."1N.N) X` LAST EDITED: `JAN 22, 1998` HELP-PROMPT: `Type a Number between 2000 and 15000, 0 Decimal Digits` DESCRIPTION: `This field enables site management to limit the number of lines which a message may have when it is addressed to a remote recipient. A user may not send a message across the network with more than this number of lines.` `If this field is null, there is no limit.`
8.31	NETWORK - MAX LINES RECEIVE	NETWORK-LIMIT;2	NUMBER	INPUT TRANSFORM: `K:+X'=X!(X>99999999)!(X<0)!(X?.E1"."1N.N) X` LAST EDITED: `APR 22, 2002` HELP-PROMPT: `Type a Number between 0 and 99999999, 0 Decimal Digits` DESCRIPTION: `This field enables site management to limit the number of lines which a message may have when it is received from a remote site. Any message received from a remote site which has more lines than this number is` `automatically rejected. If this field is null, there is no limit.` `KIDS and PackMan messages are not affected by this limit.`
8.32	NETWORK - BLOCK SIZE RECEIVE	NETWORK-LIMIT;3	SET	'A' FOR 255; 'B' FOR 512; LAST EDITED: `APR 22, 2002` HELP-PROMPT: `Select the block size for incoming transmissions.` DESCRIPTION: `* This field is reserved for future use. Not currently used. *` `This is the maximum number of characters to read at a time when receiving incoming transmissions. Default is 255.` `Limiting factors are:` `- Maximum string length on the system.` `- Maximum global length on the system. In particular, maximum (desirable) length of a line of message text in the MESSAGE file:` `S ^XMB(3.9,xmz,2,x,0)=` `You may also wish to consider the maximum string length that the system's various editors can handle. See the Technical Description for more information.` TECHNICAL DESCR: `Why would you want to set the block size higher than 255, which has been the historical setting? Just how long a line do you need for the text in a message? Well, for user-to-user communication, 255 is more than enough.` `But for application-to-application communication, 255 may not be enough. 512 may be. So, if your system can handle globals with 512 characters, setting this field to 512 is recommended.` `How can you tell how long a string a global can be set to? Do this at the programmer prompt:` `> S ^TMP("XM",$J)="" F I=1:1 S ^TMP("XM",$J)=^TMP("XM",$J)_"X"` `> W $L(^TMP("XM",$J)) <--- This is your answer` `> K ^TMP("XM",$J)` `Yes, some systems can handle way more than 512, but we need to limit the maximum, so that if we need to port data from one system to another, any system can handle data from any other system.` `There is one caution. It's a small one, but you should be aware of it. Your system's text editors, which are used to edit message text in MailMan messages, may not be able to handle line lengths of more than 245 or 255.` `When does this become a problem? Only if you attempt to copy and edit messages which have such lengthy lines. Such lines may be truncated by the editors. This is not really much of a problem, because you probably won't` `be copying and editing such messages, since they would most likely contain application-to-application communication.`
8.4	DIRECTORY REQUEST FLAG	8.4;1	SET	'0' FOR Requests will NOT be granted.; '1' FOR Requests will be granted.; LAST EDITED: `APR 17, 1994` HELP-PROMPT: `Enter 0 to stop all requests for the local directory from being granted.` DESCRIPTION: `This field controls whether or not the XMMGR-DIRECTORY-RECV option will grant request from remote site to send domain user directory information.` `If the value is null or zero, request is rejected. If the value is one, a request is granted and domain user directory will be made available to the remote site.`
10	IN-BASKET-PURGE DAYS	0;9	NUMBER	INPUT TRANSFORM: `K:+X'=X!(X>999)!(X<30)!(X?.E1"."1N.N) X` LAST EDITED: `JAN 23, 1998` HELP-PROMPT: `Type a Number between 30 and 999, 0 Decimal Digits` DESCRIPTION: `This field is used by the IN BASKET PURGE to identify inactive messages and mark them for purging.` `A message is considered inactive if it has not been accessed in the past number of days specified here. The default is 30 days.` `The IN BASKET PURGE sends a message to each user listing all messages which it has marked for purging and stating that they will be purged in an additional 30 days if they remain in the 'IN' basket and are not accessed` `again.`
10.01	IN-BASKET-PURGE TYPE	.15;1	SET	'0' FOR IN BASKET ONLY; '1' FOR ALL BASKETS; LAST EDITED: `APR 22, 2002` HELP-PROMPT: `Enter 0 for IN Basket, 1 for All baskets or ? for more information.` DESCRIPTION: `This field controls the extent of the IN-BASKET-PURGE. If is is not filled in the effect on the IN-BASKET-PURGE is the same as it would be if the value of the field is zero.` `The field can have the following values:` `0 or null = The IN-BASKET-PURGE will affect user IN baskets only.` `1 = The IN-BASKET-PURGE will affect all user baskets. (This is not the normal way for this process to be run. It is recommended that you discuss this with site management and get user input before doing this.)` `In either case the users will be sent the now familiar message listing the messages that will be deleted from their baskets in 30 days. In either case the field 'IN-BASKET-PURGE DAYS' will control how long a message can` `remain inactive in a basket before it is considered okay to put on the list of messages to be considered for deletion.`
10.03	DATE PURGE CUTOFF DAYS	.18;1	NUMBER	INPUT TRANSFORM: `K:+X'=X!(X>9999)!(X<365)!(X?.E1"."1N.N) X` LAST EDITED: `NOV 17, 2000` HELP-PROMPT: `Type a Number between 365 and 9999, 0 Decimal Digits` DESCRIPTION: `This field is used by the option XMPURGE-BY-DATE. When this option is run, the date purge will be set to purge all messages originating this many days ago and before.` `If this field is null, the default will be 730 days (2 years).`
10.04	DATE PURGE GRACE PERIOD	.18;2	NUMBER	INPUT TRANSFORM: `K:+X'=X!(X>31)!(X<3)!(X?.E1"."1N.N) X` LAST EDITED: `NOV 17, 2000` HELP-PROMPT: `Type a Number between 3 and 31, 0 Decimal Digits` DESCRIPTION: `This is the number of days' warning the users get before the date purge, XMPURGE-BY-DATE, is run.` `This field is used by the option XMPURGE-BY-DATE only if that option is scheduled, not if it is run interactively.` `At the scheduled date/time, the bulletin, XM DATE PURGE WARNING, is broadcast to all users to warn them of the coming date purge, and the actual date purge is then queued to run this many days later.` `If this field is null, the date purge will run at the scheduled date/time, and no bulletin will be sent.`
10.1	BACKGROUND FILER HANG TIME	0;13	NUMBER	INPUT TRANSFORM: `K:+X'=X!(X>99)!(X<0)!(X?.E1"."1N.N) X` LAST EDITED: `NOV 15, 1988` HELP-PROMPT: `Background filer hangs up to 99 seconds between mail deliveries (default=5).` DESCRIPTION: `This field is used by the background filer when it is started up to determine the amount of time it will hang between deliveries of messages. Since mail is not delivered, even to the sender, unless the backgournd filer` `delivers it, it should not be too long a period so that your users are inconvenienced. If this field is not filled in the background filer will hang for 5 seconds between deliveries. 5 to 15 seconds is the recommended` `range.`
10.2	BACKGROUND FILER RUN FLAG	0;16	SET	'1' FOR STOP RUNNING; '0' FOR OKAY TO RUN; LAST EDITED: `JAN 23, 1992` DESCRIPTION: `The background filer checks this field every time it is about to deliver a message or response. If it is set to 1, it stops running, and will not restart until it is set to null or zero. If it is null or zero, and is` `already running, it continues. If it is null or zero, and is not running, a background task will be created to restart it.` `WRITE AUTHORITY: @`
10.3	BACKGROUND FILER RUN PRIORITY	.13;1	NUMBER	INPUT TRANSFORM: `K:+X'=X!(X>10)!(X<0)!(X?.E1"."1N.N) X` LAST EDITED: `NOV 12, 1992` HELP-PROMPT: `Type a Number between 0 and 10, 0 Decimal Digits` DESCRIPTION: `This field is used by the background filer to set its priority at runtime.`
16.1	P-MESSAGE LINE LIMIT	.16;1	NUMBER	INPUT TRANSFORM: `K:+X'=X!(X>9999999)!(X<2000)!(X?.E1"."1N.N) X` LAST EDITED: `APR 08, 1998` HELP-PROMPT: `Type a Number between 2000 and 9999999, 0 Decimal Digits` DESCRIPTION: `This field enables site management to limit the number of lines which may be printed to P-MESSAGE. If this field is null, there is no limit.`
17.1	MAX DIGITS FOR MESSAGE NUMBER	.17;1	NUMBER	INPUT TRANSFORM: `K:+X'=X!(X>14)!(X<7)!(X?.E1"."1N.N) X` LAST EDITED: `SEP 17, 1998` HELP-PROMPT: `Type a Number between 7 and 14, 0 Decimal Digits` DESCRIPTION: `This field is used to control the size of the message number in ^XMB(3.9, the MESSAGE file. If this field is null, its default will be 8 digits. If the message number becomes greater than this many digits, the message` `numbers will recycle back to the next vacant message number after 999999. In this way, message numbers will cease being too ungainly in size.` `So message numbers will be re-used.` `If MailMan is not able to find a vacant message number less than this number of digits, then MailMan will take the next available message number, no matter how many digits it has, AND MailMan will change this field to` `reflect the new maximum.` `It is very important that the unreferenced messages purge and/or the date purge be run on a regular basis to free up message numbers for re-use.`
21	FORWARD PRIORITY MAIL TO GROUP	2;1	SET	'0' FOR NO; '1' FOR YES; LAST EDITED: `MAY 25, 2000` HELP-PROMPT: `Let users forward priority messages to mail groups?` DESCRIPTION: `Enter YES if you wish to allow users to forward priority messages to mail groups.` `Enter NO if you don't. (This is the default, if this field is null.) Then only the message originator or anyone with the XM GROUP PRIORITY key may forward priority messages to mail groups.` TECHNICAL DESCR: `The issue here is one of annoyance. Priority messages can be annoying. When priority messages are inappropriately forwarded to mail groups, the annoyance quotient rises dramatically. If you wish to have MailMan be the` `enforcer, then set this field to NO. (Then only a select few users will be able to forward priority messages to mail groups.) If you wish to have the user's peers be the enforcers, then set this field to YES. (Then` `anyone can forward priority messages to mail groups, and users who inappropriately do so, risk the wrath and flames of the annoyed recipients.)`
22	DROP OUT OF RESTRICTED GROUP	2;2	SET	'0' FOR NO; '1' FOR YES; LAST EDITED: `JUN 06, 2000` HELP-PROMPT: `Let users drop out of non-self-enrolling mail groups?` DESCRIPTION: `Enter YES if you wish to allow users to drop out of non-self-enrolling mail groups. The user will be warned that this is a non-self-enrolling group, and that they won't be allowed to rejoin later, and then they will be` `asked to re-confirm the decision to drop out.` `Enter NO if you don't. (This is the default if this field is null.) Then users will have to contact IRM or the mail group coordinator to ask to be dropped.` TECHNICAL DESCR: `If a mail group is not a self-enrolling mail group, then users can't just join. They must be added by the mail group coordinator.` `If a user no longer wishes to be a member of such a group, he must ask the group coordinator to drop him. But what if the group coordinator has left the organization or is unresponsive? Then what? Then the user will` `have to ask IRM to help. This problem can be avoided by setting this field to YES.` `Some would argue that the coordinator added the user to the group for a reason, and the user should not be allowed to drop out. (Perhaps the coordinator is the user's boss.) They would argue that it is MailMan's job to` `prevent the user from dropping out. (Set the field to NO.) Others would argue that it is not MailMan's job at all, but the boss's job to prevent the user from dropping out, and to discipline the user if he does. (Set the` `field to YES.)`
23	TITLE SOURCE	0;11	SET	'S' FOR SIGNATURE BLOCK TITLE; 'T' FOR TITLE; LAST EDITED: `JUL 18, 2000` HELP-PROMPT: `Where should the user's title come from?` DESCRIPTION: `Where in the NEW PERSON file should the user's title come from?` `Enter 'S' if the user's title should come from field 20.3, SIGNATURE BLOCK TITLE. If that field is empty, then we'll try field 8, TITLE.` `Enter 'T' if the user's title should come from field 8, TITLE. If that field is empty, we won't show any title.` `The default is 'T', if this field is not filled in.`
31	AUTO-FORWARD LIMITED?	3;1	SET	'0' FOR NO; '1' FOR YES; LAST EDITED: `APR 15, 2003` HELP-PROMPT: `Should auto-forward capability be limited?` DESCRIPTION: `For security or privacy reasons, you may wish to limit the sites to which users may have their mail auto-forwarded. If so, set this field to YES, and enter the approved sites in the AUTO-FORWARD APPROVED SITE multiple.` `For VA sites, this field must be set to YES. The only approved sites are those ending in ".DOMAIN.EXT".` `If this field is set to YES, MailMan will limit auto-forwarding to only those sites whose names are in (or end in the ones in) the AUTO-FORWARD APPROVED SITE multiple.`
31.1	AUTO-FORWARD APPROVED SITE	3.1;0	Multiple #4.33	4.33
31.2	AUTO-FORWARD WAIVER SITE	3.2;0	Multiple #4.34	4.34 LAST EDITED: `APR 14, 2003`
40	PREVENT MESSAGE RELAY?	4;1	SET	'1' FOR YES; '0' FOR NO; LAST EDITED: `FEB 09, 2004` HELP-PROMPT: `Should message relaying be prevented?` DESCRIPTION: `Answer YES if you want to prevent outside sites from sending mail through your site to other outside sites. Spammers and Virus propagators use this technique to disguise the source of their mail, and to make it appear to` `come from a trusted source, namely your site.` `Answer NO if you want your site to act as a relay site for anyone.` `It is strongly recommended that you answer YES to prevent your site from unwittingly relaying destructive mail.` `If you answer YES, you should define your "inside" sites in the MY DOMAIN (field #41) multiple, so that MailMan can distinguish them from outside sites.` `Note: This does NOT prevent users from receiving mail from outside sites. It also does NOT prevent users from forwarding mail to outside sites. Such actions are perfectly acceptable.`
41	MY DOMAINS	4.1;0	Multiple #4.341	4.341
50	LIMITED BROADCAST	5;0	Multiple #4.32	4.32
51	LIMITED BROADCAST DEFAULT	0;20	NUMBER	INPUT TRANSFORM: `D INXFORM^XMXADDR2(.X)` OUTPUT TRANSFORM: `S:Y Y=$P($G(^XMB(1,1,5,Y,0)),U,1)` LAST EDITED: `NOV 29, 1999` HELP-PROMPT: `Select a limited broadcast default` DESCRIPTION: `When sending a limited broadcast message, this is the default which will appear when the user is presented with limited broadcast choices.` `If you don't want a default to appear, delete this entry.` TECHNICAL DESCR: `For this field, we are simulating a pointer to a record in the LIMITED BROADCAST multiple. The executable help displays the choices in the multiple. The input transform makes sure you choose one of the choices. The` `output transform converts the "pointer" to the limited broadcast name.` EXECUTABLE HELP: `D EXHELP^XMXADDR2` NOTES: `XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER`
142	NO-PURGE DAYS BUFFER (LOCAL)	.14;2	NUMBER	INPUT TRANSFORM: `K:+X'=X!(X>10)!(X<2)!(X?.E1"."1N.N) X` LAST EDITED: `SEP 18, 1998` HELP-PROMPT: `Type a Number between 2 and 10, 0 Decimal Digits` DESCRIPTION: `This field is used during the un-referenced-messages purge to avoid purging the last few messages in the message file, according to their local create date.` `We subtract the NO-PURGE DAYS BUFFER (LOCAL) from today's date, giving a 'no-purge date'. Local messages which were created on or after that date and which were sent to remote sites are not subject to purge. Other` `messages are not affected by this buffer.` `If this field is not filled in, it defaults to 7 days. This is the recommended value.` `It should not be less than the NO-PURGE DAYS BUFFER (field 4.301) or it will have no effect.` `One situation in which this buffer may be useful is in the case of a message sent only to a remote site. Such a message is unreferenced and would otherwise be subject to purge. If a reply came from the remote site after` `the original message had been purged, the sender would have access only to the reply and not to the original message. The NO-PURGE DAYS BUFFER (LOCAL) could be set to a reasonable number of days to allow for a reply.`
143	FAX ENABLED	0;19	SET	'0' FOR no; '1' FOR yes; LAST EDITED: `FEB 11, 1997` HELP-PROMPT: `Is your site fax enabled?` DESCRIPTION: `Your site is fax enabled if you have the suite of fax software and files (^AKF) and fax capability and you choose to allow faxes to be sent via MailMan.` `To send faxes via MailMan, Mail groups (file 3.8) must first be populated in the fax recipient and fax group multiples. Then, when a user sends a message to a mail group, the message is also faxed to any fax recipients in` `that mail group. Responses to the message are not faxed.`
217	DEFAULT INSTITUTION	XUS;17	POINTER TO INSTITUTION FILE (#4)	**********************REQUIRED FIELD********************** INSTITUTION(#4) LAST EDITED: `MAY 17, 2024` HELP-PROMPT: `Enter the instutition to use as a default for users without one.` DESCRIPTION: `This field is the default institution that is shown for any user who hasn't chosen one under "edit user options"` TECHNICAL DESCR: `This field is set by a Mumps xref on file 8989.3, field 217, making it a duplicate of that field.` AUDIT: `YES, ALWAYS` `WRITE AUTHORITY: ^`
241	BACKGROUND MESSAGE DELIVERERS	6;1	FREE TEXT	INPUT TRANSFORM: `D CHKQ^XMKPLQ` LAST EDITED: `JAN 21, 1998` HELP-PROMPT: `Enter a set of increasing numbers separated by commas.` DESCRIPTION: `This field is used by the background filer to determine how many message delivery queues (and tasks) there should be and how to separate them.` EXECUTABLE HELP: `D HELPQ^XMKPLQ` NOTES: `XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER`
242	BACKGROUND RESPONSE DELIVERERS	6;2	FREE TEXT	INPUT TRANSFORM: `D CHKQ^XMKPLQ` LAST EDITED: `JAN 21, 1998` HELP-PROMPT: `Enter a set of increasing numbers separated by commas.` DESCRIPTION: `This field is used by the background filer to determine how many response delivery queues (and tasks) there will be and how to separate them.` EXECUTABLE HELP: `D HELPQ^XMKPLQ` NOTES: `XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER`

ICR LINK	Subscribing Package(s)	Fields Referenced	Description
ICR #239	Automated Medical Information Exchange	DOMAIN NAME (.01). Access: Read w/Fileman
ICR #2496	Pharmacy Benefits Management Mental Health	NETWORK - MAX LINES @ SEND TO (8.3). Access: Read w/Fileman NETWORK - MAX LINES RECEIVE (8.31). Access: Read w/Fileman
ICR #3231	Imaging ADVANCED PROSTHETICS ACQ TOOL	TIME ZONE (1). Access: Direct Global Read & w/Fileman TIME ZONE (1). Access: Read w/Fileman	This is the field 1 cross-reference.
ICR #4020	Scheduling
ICR #4319	Kernel	TIME ZONE (1). Access: Direct Global Read & w/Fileman
ICR #5812	Mental Health Health Data and Informatics	NETWORK - MAX LINES SEND (8.3). Access: Read w/Fileman NETWORK - MAX LINES RECEIVE (8.31). Access: Read w/Fileman
ICR #10091		DEFAULT INSTITUTION (217). Access: Read w/Fileman

Customize PDF page

Package: MailMan

Global: ^XMB(1

Information

Description

Accessed By FileMan Db Calls, Total: 10

Pointer To FileMan Files, Total: 7

Fields, Total: 68

Found Entries, Total: 1

ICR, Total: 7