DBIA234    ICR (234)

Mailman is given permission to make the following calls
to Kernel:

1.   CHK^XM is an entry point set aside only for calls external from MailMan.
It is used by KERNEL routines to notify users of new messages for a user
during logon or as invoked from MenuMan. XMDUZ is used if supplied, otherwise
DUZ is a pointer to the user's Mailbox.  The symbol table of the caller is
changed as the code currently stands.  Y is output as a count of new messages.
% and D are also used and not killed by MailMan.  The Kernel security routine
will continue to use this entry point, which also is necessary to make sure
that ^TMP("XMY",$J) is cleaned out on login and ensures that when job numbers
are reused after reboot, there is not data in ^TMP("XMY",$J) to include
recipients from old mail sessions in currently generated bulletins that come
from outside of MailMan.  An example is the 'Dropping into Programmer Mode
bulletin'.

2.   ^XM may be called in order to offer MailMan as a service directly to
users on logon.

3.   The XMUSER and XMMGR menus may be used in high level menu structures.

4.   Kernel modules to which this document refers are (even if they are at
some point separated from the Kernel and become independent modules of their
own) are System security (XU* and XT*).

5.   Kernel security and user related modules currently can call NEW^XM to set
up an new user's or reactivated user's mail box.  The entry point uses the
variables I, Y and K destructively.  If it is called for a user who is being
reactivated, that user will not receive responses to messages he is a
recipient of and were created before his reinstatement, unless he is
explicitly forwarded them, or he 'owns' the original message in one of his
mail boxes.

6.   XMPC is called by the Kernel routine comparer.  All the proper set-up has
been done and MailMan will coordinate any changes in this area with the
programmer responsible for Kernel Utilities.

7.   Kernel directly references the 5th piece of the Mail Basket multiple of
the Mail Box file (3.7) to get the number of messages in a mail basket.

8.   Kernel directly references the 6th piece of the zero node of the Mail Box
file (3.7) to get the number of new messages in a mail box

9.   There are some data fields in the Mail Box file (3.7) that are not used
in MailMan.  They are used by sign-on security and should be maintained by
sign-on security routines also.

field #        Description         node;piece
20   Last Sign-on Date/Time        .1;1
21   Last Terminal Type Used       .2;1
22   Already Signed On To Devices  100 (multiple)

10.  The Kernel Site Parameters file contains fields that are used by modules
in Kernel other than MailMan.  The MailMan development team will maintain the
file and will reserve fields and field numbers in the range of 1000 to 1999
for the use of this kernel module.  No alpha subscripts will be used by
non-MailMan kernel packages without agreement from the MailMan development
team except for those already in use and noted below.  The exception to the
above are nodes beginning with the namespaces (XU amd XT) which are reserved
for non-MailMan kernel packages and cross references beginning with any
letter, but having the above namespaces immediately follow that letter (EG.
AXT5).

Any changes to this file require the notification of the MailMan development
team.  A method for ensuring that the distribution of the file by MailMan will
then be negotiated.

Field Number    #    Description           node;piece

11        Auto-generate access codes    3;1
12        User char Template            3;2
202       Default number of attempts    XUS;2
203       Default lock-out time         XUS;3
204       Default Multiple sign-ons     XUS;4
205       Ask device at sign-on         XUS;5
209       Default type-ahead            XUS;9
211       Bypass Device lock-out        XUS;10
212.1     Device to audit               4.33 (subfile)

240       INTRO text                    INTRO