XMXGRP ;ISC-SF/GMB-Group creation/enrollment ;03/31/2003 13:38
Source file <XMXGRP.m>
| Name | Comments | DBIA/ICR reference |
|---|---|---|
| ADDMBRS(XMDUZ,XMGROUP,XMMBR,XMINSTR,XMTSK) | ; Add users to groups, if they aren't
; already members. This API handles adding local users, devices, ; server options, mail groups, and remote users to mail groups. ; It does not handle adding distribution lists or fax recipients ; or fax groups. ; ; Optionally, forward existing messages which are addressed to the ; groups to the users, and/or add the users to the messages, so that ; they will receive responses. (LOCAL USERS ONLY!) ; XMDUZ - The user who is doing this. Must be authorized to edit ; the mail groups. ; XMGROUP - The name or IEN (or list of same) of the groups. ; XMMBR - The user (or list of users) to add to the groups. ; XMINSTR - Special instructions ; ("FLAGS") - Flags, may contain any combination of the following: ; "A" - Add users to messages, but don't forward. ; (Messages will be delivered the next time ; someone replies, and users will be able to ; Query/Search for them at any time.) ; "F" - Forward messages to users, if the users aren't ; already on the messages. ; Closed messages will be ignored. Users will not be ; added to them. ; Note: If FLAGS contains only an "A", then FDATE and TDATE apply. ; If FLAGS contains only an "F", then FDATE and TDATE apply. ; If FLAGS contains "A" and "F", then messages from FDATE thru ; TDATE will be "F"orwarded, and all other messages will have ; the users "A"dded to them, without forwarding. ; Note: Currently, FLAGS may not contain "A". We don't yet have a way ; to mark users (recipients) who have been added to a message, but will ; not receive them until someone replies on the message, or until the ; user searches for them and reads them. This is a problem, because ; if someone does a QD on them, they have no idea why these recipients ; haven't read the message. Perhaps we could mark them 'Parked until ; next reply.' That would require a new field, and other routines would ; have to be aware of and handle this new field. Until that happens, ; we are stripping any "A" from XMINSTR("FLAGS"). ; ("FDATE") - Add users to messages originating on or after this ; date. Must be FM format. Default is from the ; beginning of time. Used in conjunction with FLAGS. ; ("TDATE") - Add users to messages originating on or before this ; date. Must be FM format. Default is to the present. ; Used in conjunction with FLAGS. ; XMTSK Output task number |
|
| CHKGRPS(XMDUZ,XMGROUP,XMGRP) | ;
|
|
| CHKGRP(XMDUZ,XMGROUP,XMGRP) | ;
|
|
| GRPOK(XMGROUP,XMGNAME,XMGIEN,XMABORT) | ;
; make sure group name is good, translate to group ien. |
|
| AUTHOK(XMDUZ,XMGIEN,XMABORT) | ;
; make sure user is authorized to add members to group. |
|
| CHKMBRS(XMDUZ,XMMBR) | ; Check the users to add.
|
|
| ADD2GRPS(XMGRP,XMTO,XMINSTR) | ; See if members already in the groups.
; If not, add them ; >> Question: May a broadcast or limited broadcast be added to a group? |
|
| AM(XMG,XMM,XMMIEN,XMTYPE,XMTO,XMINSTR) | ; Add/edit a member (not delete)
|
|
| AMINIT(XMG,XMM,XMMIEN,XMMULT,XMABORT) | ;
|
|
| JOIN(XMDUZ,XMGROUP,XMINSTR,XMTSK) | ; User chooses to join a group.
; XMGROUP - The name (or IEN) of the group. (Just one group!) ; XMINSTR - Special instructions. See ADDMBR, above ; Also, if XMINSTR("FLAGS")["F", may specify: ; ("SELF BSKT") - direct forwarded messages to a specific basket. |
|
| DROP(XMDUZ,XMGROUP) | ; User chooses to drop from a group.
; XMGROUP - The name (or IEN) of the group. |
|
| GRPINFO(XMDUZ,XMGIEN,XMTYPE,XMSELF,XMMBR,XMABORT) | ;
|
|
| ADD2GRPZ(XMGRP,XMMBR,XMTO) | ; See if members already in the groups.
; If not, add them |
|
| AMZ(XMG,XMM,XMTYPE,XMTO) | ; Add/edit a member (not delete)
|
