XMXUTIL ;ISC-SF/GMB-Message & Mailbox Utilities ;06/19/2002 07:39
Source file <XMXUTIL.m>
| Name | Comments | DBIA/ICR reference | 
|---|---|---|
| BSKTNAME(XMDUZ,XMK) | ; What's the name of this basket for this user? | 
 
 | 
| BMSGCT(XMDUZ,XMK) | ; Basket msg count | 
 
 | 
| ERRSET(XMID,XMPARM,XMZ) | ; For internal MailMan use only. | |
| TMSGCT(XMDUZ) | ; Total msg count | 
 
 | 
| KILLMSG(DA) | ; For internal MM use only.  Kill a msg in ^XMB(3.9 | |
| DECRNEW(XMDUZ,XMK,XMCNT) | ; Decrement the number of new messages in a basket ; For internal use only! | |
| PAGE(XMABORT) | ; | 
 
 | 
| TNMSGCT(XMDUZ) | ; Total new msg count | 
 
 | 
| NONEW(XMDUZ,XMK,XMZ,XMLOCKIT) | ; Make a message not new ; Should lock before calling AND unlock after. ; If you set XMLOCKIT=1, I'll do the locking for you. | 
 
 | 
| MAKENEW(XMDUZ,XMK,XMZ,XMLOCKIT) | ; Make a message new ; Should lock before calling AND unlock after. ; If you set XMLOCKIT=1, I'll do the locking for you. | 
 
 | 
| LOCK(XMDOOR,XMLOCKED,XMWAIT) | ; Lock a global (** NOT USED **) | |
| TPMSGCT(XMDUZ) | ; Total new priority msg count | 
 
 | 
| NAME(XMID,XMIT) | ; Given a name or DUZ, return the name ; XMID user's DUZ or name ; XMIT 1=if DUZ, return institution and title, too, if needed ; 0=just return the name (default) | 
 
 | 
| KVAPOR(XMDUZ,XMK,XMZ,XMVAPOR,XMIU) | ; Set/delete a message's vaporize date in user's basket ; XMVAPOR ="@" delete it ; =FM date/time set/change it | 
 
 | 
| LASTACC(XMDUZ,XMK,XMZ,XMRESP,XMIM,XMINSTR,XMIU,XMCONFRM) | ; Note first, last accesses, number of responses read ; in: ; XMDUZ,XMK,XMZ the usual. If message not in basket, set XMK=0. ; XMRESP last response read this time ; XMIM "SUBJ", "FROM" ; XMINSTR "FLAGS" ; XMIU "IEN", "RESP" ; out: ; XMCONFRM Confirmation message was sent to message sender (0=no; 1=yes) | 
 
 | 
| BPMSGCT(XMDUZ,XMK) | ; Basket new priority msg count | 
 
 | 
| INCRNEW(XMDUZ,XMK,XMCNT) | ; Increment the number of new messages in a basket ; For internal use only! | |
| NEWS(XMDUZ,XMTEST) | ; ; Given: ; XMDUZ User's DUZ ; XMTEST 0=this is not a test. (DEFAULT) ; (Field 1.12 LAST NEW MSG NOTIFY DATE/TIME may be updated) ; 1=this is just a test. ; (Field 1.12 will not be updated) ; Returns: ; -1 If no record of this user ; 0 If no new mail ; Otherwise, if the user has new mail, returns an ^-delimited string: ; Piece 1: # New Msgs ; Piece 2: Does the user have new priority mail? (1=yes;0=no) ; Piece 3: # New Msgs in IN basket ; Piece 4: Date/Time (FileMan) that the last msg was received ; Piece 5: Have there been any new messages since the last time ; this function was called? (1=yes;0=no) ; And for the first priority read basket with new messages in it: ; (If none has new messages, then first priority read basket) ; Piece 6: # New Msgs in basket ; Piece 7: Basket IEN ; Piece 8: Basket name | 
 
 | 
| WAIT | ; | 
 
 | 
| NETNAME(XMDUZ) | ; Given a DUZ or a string, return an internet name @ site name. | 
 
 | 
| BNMSGCT(XMDUZ,XMK) | ; Basket new msg count | 
 
 | 
| FileNo | Call Tags | 
|---|---|
| ^XMB(3.9 - [#3.9] | Classic Fileman Calls | 
| Name | Line Occurrences (* Changed, ! Killed) | 
|---|---|
| ^DIC(3.1 - [#3.1] | NAME+12 | 
| ^TMP("XMERR" | ERRSET+2*, ERRSET+3*, ERRSET+4*, ERRSET+6* | 
| ^VA(200 - [#200] | NAME+6, NAME+11, NAME+12 | 
| ^XMB("NETNAME" | NETNAME+16 | 
| ^XMB(3.7 - [#3.7] | NEWS+23, NEWS+29*, NEWS+30, TNMSGCT+1, BNMSGCT+1, TPMSGCT+1, TPMSGCT+4, TPMSGCT+5, BPMSGCT+1, BPMSGCT+4 , TMSGCT+3, BMSGCT+1, BSKTNAME+1, NAME+14, NAME+15, NETNAME+6, MAKENEW+3, MAKENEW+4, MAKENEW+7, MAKENEW+9 , INCRNEW+3, INCRNEW+4, INCRNEW+5, INCRNEW+6*, INCRNEW+7, NONEW+3, NONEW+6, NONEW+8, DECRNEW+3, DECRNEW+4 , DECRNEW+5, DECRNEW+6, LASTACC+28, LASTACC+31* | 
| ^XMB(3.9 - [#3.9] | KILLMSG+3, KILLMSG+5, LASTACC+12, LASTACC+18, LASTACC+25*, LASTACC+26* | 
| Name | Line Occurrences | 
|---|---|
| $$BMSGCT | TMSGCT+3 | 
| $$NAME | NETNAME+6 | 
| DECRNEW | NONEW+9 | 
| INCRNEW | MAKENEW+10 | 
| Name | Field # of Occurrence | 
|---|---|
| ^( | NETNAME+6 | 
| ^(0 | NAME+12, INCRNEW+4*, INCRNEW+5*, DECRNEW+4*, DECRNEW+5* | 
| >> | Not killed explicitly | 
| * | Changed | 
| ! | Killed | 
| ~ | Newed | 
| Name | Field # of Occurrence | 
|---|---|
| DA | KILLMSG~ | 
| DIK | KILLMSG+1~, KILLMSG+2* | 
| DIR | WAIT+1~, PAGE+1~ | 
| DIR("A" | WAIT+1* | 
| DIR(0 | WAIT+1*, PAGE+1* | 
| DIRUT | WAIT+1~, PAGE+1~ | 
| DUZ | LASTACC+26 | 
| I | TPMSGCT+2~, TPMSGCT+3*, TPMSGCT+5*, TPMSGCT+6, BPMSGCT+2~, BPMSGCT+4*, BPMSGCT+5, TMSGCT+1~, TMSGCT+2*, TMSGCT+3* , TMSGCT+4 | 
| U | NEWS+25, NEWS+27, NEWS+28, NEWS+29, NEWS+30, TNMSGCT+1, BNMSGCT+1, BMSGCT+1, BSKTNAME+1, NAME+11 , NAME+12, NAME+15, NETNAME+6, INCRNEW+4, INCRNEW+5, INCRNEW+6, DECRNEW+4, DECRNEW+5, LASTACC+12, LASTACC+19 , LASTACC+20, LASTACC+23, LASTACC+24, LASTACC+30, LASTACC+31 | 
| XMABORT | PAGE~, PAGE+1* | 
| XMCNT | INCRNEW~, INCRNEW+2*, INCRNEW+4, INCRNEW+5, DECRNEW~, DECRNEW+2*, DECRNEW+4, DECRNEW+5 | 
| XMCONFRM | LASTACC~, LASTACC+14*, LASTACC+22* | 
| XMDOOR | LOCK~, LOCK+1 | 
| XMDUZ | NEWS~, NEWS+23, NEWS+29, NEWS+30, TNMSGCT~, TNMSGCT+1, BNMSGCT~, BNMSGCT+1, TPMSGCT~, TPMSGCT+1 , TPMSGCT+4, TPMSGCT+5, BPMSGCT~, BPMSGCT+1, BPMSGCT+4, TMSGCT~, TMSGCT+3, BMSGCT~, BMSGCT+1, KVAPOR~ , KVAPOR+4, BSKTNAME~, BSKTNAME+1, NETNAME~, NETNAME+2, NETNAME+3, NETNAME+4*, NETNAME+6, NETNAME+11, MAKENEW~ , MAKENEW+3, MAKENEW+4, MAKENEW+6, MAKENEW+7, MAKENEW+9, MAKENEW+10, INCRNEW~, INCRNEW+3, INCRNEW+4, INCRNEW+5 , INCRNEW+6, INCRNEW+7, NONEW~, NONEW+3, NONEW+5, NONEW+6, NONEW+8, NONEW+9, DECRNEW~, DECRNEW+3 , DECRNEW+4, DECRNEW+5, DECRNEW+6, LASTACC~, LASTACC+22, LASTACC+26, LASTACC+28, LASTACC+31, LASTACC+34 | 
| >> XMERR | ERRSET+1*, ERRSET+2, ERRSET+3, ERRSET+4, ERRSET+5, ERRSET+6 | 
| XMFDA | KVAPOR+3~, MAKENEW+5~, NONEW+4~, LASTACC+9~ | 
| XMFDA( | KVAPOR+5*, KVAPOR+8*, KVAPOR+11*, MAKENEW+6*, NONEW+5*, LASTACC+35*, LASTACC+36*, LASTACC+37* | 
| XMID | NAME~, NAME+4, NAME+6, NAME+7, NAME+11, NAME+12, NAME+14, NAME+15, ERRSET~, ERRSET+2 , ERRSET+5, ERRSET+6 | 
| XMIENS | KVAPOR+3~, KVAPOR+4*, KVAPOR+5, KVAPOR+8, KVAPOR+11, LASTACC+9~, LASTACC+34*, LASTACC+35, LASTACC+36, LASTACC+37 | 
| XMIM | LASTACC~, LASTACC+22 | 
| XMIM("FROM" | LASTACC+22 | 
| XMINST | NAME+5~, NAME+15*, NAME+16 | 
| XMINSTR | LASTACC~ | 
| XMINSTR("FLAGS" | LASTACC+22 | 
| XMIT | NAME~, NAME+9 | 
| XMIU | KVAPOR~, LASTACC~ | 
| XMIU("IEN" | LASTACC+15, LASTACC+18, LASTACC+25, LASTACC+26 | 
| XMIU("KVAPOR" | KVAPOR+7!, KVAPOR+10* | 
| XMIU("RESP" | LASTACC+16*, LASTACC+24* | 
| XMK | BNMSGCT~, BNMSGCT+1, TPMSGCT+2~, TPMSGCT+3*, TPMSGCT+4*, TPMSGCT+5, BPMSGCT~, BPMSGCT+1, BPMSGCT+4, TMSGCT+1~ , TMSGCT+2*, TMSGCT+3*, BMSGCT~, BMSGCT+1, KVAPOR~, KVAPOR+4, BSKTNAME~, BSKTNAME+1, MAKENEW~, MAKENEW+3 , MAKENEW+4, MAKENEW+6, MAKENEW+7, MAKENEW+9, MAKENEW+10, INCRNEW~, INCRNEW+4, NONEW~, NONEW+3, NONEW+5 , NONEW+6, NONEW+8, NONEW+9, DECRNEW~, DECRNEW+4, LASTACC~, LASTACC+27, LASTACC+28, LASTACC+31, LASTACC+34 | 
| XMLOCKED | LOCK~, LOCK+1*, LOCK+2* | 
| XMLOCKIT | MAKENEW~, MAKENEW+7, MAKENEW+9, NONEW~, NONEW+6, NONEW+8 | 
| XMNAME | NAME+5~, NAME+8*, NAME+9, NAME+13*, NAME+16*, NAME+17 | 
| XMNAME("FIELD" | NAME+7* | 
| XMNAME("FILE" | NAME+7* | 
| XMNAME("IENS" | NAME+7* | 
| XMNETNAM | NETNAME+1~, NETNAME+6*, NETNAME+7, NETNAME+8*, NETNAME+9*, NETNAME+11*, NETNAME+12, NETNAME+13, NETNAME+14*, NETNAME+15* , NETNAME+16 | 
| XMNEW | NEWS+22~, NEWS+25*, NEWS+26, NEWS+30 | 
| XMNOTIFY | NEWS+22~, NEWS+28*, NEWS+29, NEWS+30 | 
| XMNOW | LASTACC+9~, LASTACC+17*, LASTACC+20, LASTACC+23, LASTACC+31, LASTACC+35 | 
| XMPARM | ERRSET~, ERRSET+5 | 
| XMPARM("PARAM" | ERRSET+4 | 
| XMREC | NEWS+22~, NEWS+23*, NEWS+24, NEWS+25, NEWS+27, NEWS+28, LASTACC+9~, LASTACC+18*, LASTACC+19, LASTACC+20* , LASTACC+23*, LASTACC+24*, LASTACC+25, LASTACC+28*, LASTACC+29, LASTACC+30 | 
| XMRECEIV | NEWS+22~, NEWS+27*, NEWS+29, NEWS+30 | 
| XMRESP | LASTACC~, LASTACC+10, LASTACC+13*, LASTACC+16, LASTACC+24 | 
| XMRESPS | LASTACC+11~, LASTACC+12*, LASTACC+13 | 
| XMTEST | NEWS~, NEWS+29 | 
| XMTITLE | NAME+5~, NAME+11*, NAME+12*, NAME+13 | 
| >> XMV("DUZ NAME | " , LASTACC+26 | 
| >> XMV("SHOW INS | T" , NAME+14 | 
| >> XMV("SHOW TIT | L" , NAME+10 | 
| >> XMV("TITL SRC | " , NAME+11 | 
| XMVAPOR | KVAPOR~, KVAPOR+5, KVAPOR+6, KVAPOR+10 | 
| XMWAIT | LOCK~, LOCK+1 | 
| XMZ | TPMSGCT+2~, TPMSGCT+3*, TPMSGCT+5*, BPMSGCT+2~, BPMSGCT+3*, BPMSGCT+4*, KVAPOR~, KVAPOR+4, MAKENEW~, MAKENEW+3 , MAKENEW+4, MAKENEW+6, MAKENEW+7, MAKENEW+9, NONEW~, NONEW+3, NONEW+5, NONEW+6, NONEW+8, LASTACC~ , LASTACC+12, LASTACC+18, LASTACC+22, LASTACC+25, LASTACC+26, LASTACC+28, LASTACC+31, LASTACC+34, ERRSET~, ERRSET+3 | 
| Y | WAIT+1~, PAGE+1~ |