home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1997 October / PCO1097.ISO / FilesBBS / WINNT / LISTSVNT.EXE / intel.z / listall.refcard < prev    next >
Encoding:
Text File  |  1997-01-21  |  30.5 KB  |  523 lines

  1.            LISTSERV(R) System Reference Library, release 1.8c
  2.            --------------------------------------------------
  3.                 Copyright L-Soft international, 1986-1996
  4.  
  5.                         Last update: 13 Aug 1996
  6.  
  7. .IH
  8.  
  9. Commands are  listed in alphabetical  order, with the  minimum acceptable
  10. abbreviation  in capital  letters. Angle  brackets are  used to  indicate
  11. optional parameters. All commands which  return a file accept an optional
  12. 'F=fformat' keyword (without the quotes)  that lets you select the format
  13. in  which  you  want  the  file sent;  the  default  format  is  normally
  14. appropriate  in  all  cases.  Some esoteric,  historical  or  seldom-used
  15. commands and options have been omitted.
  16.  
  17. .1
  18. List subscription commands (from most to least important)
  19. ---------------------------------------------------------
  20. SUBscribe    listname <full_name>              Subscribe to a list, or change
  21.                                                your name if already subscribed
  22.                       ANONYMOUS                -> Subscribe anonymously
  23.  
  24. SIGNOFF                                        Remove yourself:
  25.              listname                          - From the specified list
  26.              *                                 - From all lists on that server
  27.              * (NETWIDE                        - From all lists in the network
  28.  
  29. SET          listname options                  Alter your subscription options:
  30.              ACK/NOACK/MSGack                  -> Acknowledgements for postings
  31.              CONCEAL/NOCONCEAL                 -> Hide yourself from REVIEW
  32.              Mail/NOMail                       -> Toggle receipt of mail
  33.              MIME/NOMIME                       -> Prefer/avoid MIME format
  34.                                                   (especially MIME digests)
  35.              DIGests/INDex/NODIGests/NOINDex   -> Ask for digests or message
  36.                                                   indexes rather than getting
  37.                                                   messages as they are posted
  38.              REPro/NOREPro                     -> Copy of your own postings?
  39.              TOPICS: ALL                       -> Select topics you are
  40.                      <+/->topicname               subscribed to (add/remove
  41.                                                   one or replace entire list)
  42.  
  43. Options for mail headers of incoming postings (choose one):
  44.              FULLhdr or FULL822                -> "Full" (normal) mail headers
  45.              IETFhdr                           -> Internet-style headers
  46.              SHORThdr or SHORT822              -> Short headers
  47.              DUALhdr                           -> Dual headers, useful with PC
  48.                                                   or Mac mail programs
  49.              SUBJecthdr                        -> Normal header with list name
  50.                                                   in subject line
  51.  
  52. CONFIRM      listname1 <listname2 <...>>       Confirm your subscription
  53.                                                (when LISTSERV requests it)
  54.  
  55. Other list-related commands
  56. ---------------------------
  57. GETPOST      listname ref1 <ref2 <...>>        Order individual messages from
  58.                                                list archives
  59.  
  60. INDex        listname                          Sends a directory of available
  61.                                                archive files for the list, if
  62.                                                postings are archived
  63.  
  64. Lists        <option>                          Send a list of lists as follow:
  65.              (no option)                       -> Local lists only, one line
  66.                                                   per list
  67.              Detailed                          -> Local lists, full information
  68.                                                   returned in a file
  69.              Global /xyz                       -> All known lists whose name or
  70.                                                   title contains 'xyz'
  71.              SUMmary <host>                    -> Membership summary for all
  72.                                                   lists on specified host
  73.              SUMmary ALL                       -> For all hosts (long output,
  74.                                                   send request via mail!)
  75.              SUMmary TOTAL                     -> Just the total for all hosts
  76.  
  77. Query        listname                          Query your subscription options
  78.                                                for a particular list (use the
  79.                                                SET command to change them)
  80.              *                                 -> Query all lists you are
  81.                                                   subscribed to on that server
  82.  
  83. REGister     full_name                         Tell your name to LISTSERV, so
  84.                                                that you don't have to specify
  85.                                                it on subsequent SUBSCRIBE's
  86.              OFF                               Make LISTSERV forget your name
  87.  
  88. REView       listname <(options>               Get information about a list
  89.              BY sort_field                     -> Sort list in a certain order:
  90.                 Country                           by country of origin
  91.                 Name                              by name (last, then first)
  92.                 NODEid                            by hostname/nodeid
  93.                 Userid                            by userid
  94.              BY (field1 field2)                -> You can specify more than one
  95.                                                   sort field if enclosed in
  96.                                                   parentheses: BY (NODE NAME)
  97.              Countries                         -> Synonym of BY COUNTRY
  98.              LOCal                             -> Don't forward request to
  99.                                                   peers
  100.              Msg                               -> Send reply via interactive
  101.                                                   messages (BITNET users only)
  102.              NOHeader                          -> Don't send list header
  103.              Short                             -> Don't list subscribers
  104.  
  105. SCAN         listname text                     Scan a list's membership for a
  106.                                                name or address
  107.  
  108. SEArch       listname word1 <word2 <...>>      Search list archives
  109.         or:  word1 <word2 <...>> IN listname
  110.              FROM date1                        -> From this date
  111.                   TODAY                        -> From today
  112.                   TODAY-7                      -> In the last 7 days
  113.              TO   date2                        -> To this date
  114.              WHERE
  115.                SUBJECT CONTAINS xxxx           -> Only this subject
  116.              AND/OR
  117.                SENDER  CONTAINS xxxx           -> Only this author
  118.                                                Complex boolean operations are
  119.                                                supported, see database guide
  120.  
  121. STats        listname <(options>               Get statistics about a list (VM)
  122.              LOCal                             -> Don't forward to peers
  123.  
  124. Informational commands
  125. ----------------------
  126. Help                                           Obtain a list of commands
  127.  
  128. INFO         <topic>                           Order a LISTSERV manual, or get
  129.              <listname>                        a list of available ones (if no
  130.                                                topic was specified); or get
  131.                                                information about a list
  132.  
  133. Query        File fn ft <filelist> <(options>  Get date/time of last update of
  134.                                                a file, and GET/PUT file access
  135.                                                code
  136.              FLags                             -> Get additional technical
  137.                                                   data (useful when reporting
  138.                                                   problems to experts)
  139.  
  140. RELEASE                                        Find out who maintains the
  141.                                                server and the version of the
  142.                                                software and network data files
  143.  
  144. SHOW         <function>                        Display information as follows:
  145.              ALIAS node1 <node2 <...>>         -> BITNET nodeid to Internet
  146.                                                   hostname mapping
  147.              BITEARN (VM only)                 -> Statistics about the BITEARN
  148.                                                   NODES file
  149.              DISTribute                        -> Statistics about DISTRIBUTE
  150.              DPATHs host1 <host2 <...>>        -> DISTRIBUTE path from that
  151.                                                   server to specified host(s)
  152.              DPATHs *                          -> Full DISTRIBUTE path tree
  153.              FIXes (VM only)                   -> List of fixes installed on the
  154.                                                   server (non-VM see LICENSE)
  155.              HARDWare or HW                    -> Hardware information
  156.              LICense                           -> License/capacity information
  157.                                                   and software build date
  158.              LINKs node1 <node2 <...>>         -> Network links at the BITNET
  159.                                                   node(s) in question
  160.              NADs node1 <node2 <...>>          -> Addresses LISTSERV recognizes
  161.                                                   as node administrators
  162.              NETwork (VM only)                 -> Statistics about the NJE
  163.                                                   network
  164.              NODEntry node1 <node2 <...>>      -> BITEARN NODES entry for the
  165.                                                   specified node(s)
  166.              NODEntry node1 /abc*/xyz          -> Just the ':xyz.' tag and all
  167.                                                   tags whose name starts with
  168.                                                   'abc'
  169.              PATHs snode node1 <node2 <...>>   -> BITNET path between 'snode'
  170.                                                   and the specified node(s)
  171.              POINTs <ALL | list1 list2...>     -> Graduated license point
  172.                                                   information for planning
  173.              STATs                             -> Usage statistics
  174.                                                   (default option)
  175.              VERSion                           -> Same as RELEASE command
  176.              (no function)                     -> Same as SHOW STATS
  177.  
  178. Commands related to file server functions
  179. -----------------------------------------
  180. AFD                                            Automatic File Distribution
  181.              ADD    fn ft <filelist <prolog>>  Add file or generic entry to
  182.                                                your AFD list
  183.              DELete fn ft <filelist>           Delete file(s) from your AFD
  184.                                                list (wildcards are supported)
  185.              List                              Displays your AFD list
  186.  
  187.              For node administrators:
  188.              FOR user ADD/DEL/LIST etc         Perform requested function on
  189.                                                behalf of a user you have
  190.                                                control over (wildcards are
  191.                                                supported for DEL and LIST)
  192.  
  193. FUI                                            File Update Information: same
  194.                                                syntax as AFD, except that FUI
  195.                                                ADD accepts no 'prolog text'
  196.  
  197. GET          fn ft <filelist> <(options>       Order the specified file or
  198.                                                package
  199.              PROLOGtext xxxx                   -> Specify a 'prolog text' to be
  200.                                                   inserted on top of the file
  201.  
  202. GIVE         fn ft <filelist> <TO> user        Sends a file to someone else
  203.  
  204. INDex       <filelist>                         Same as GET xxxx FILELIST
  205.                                                (default is LISTSERV FILELIST)
  206.  
  207. PW           function                          Define/change a "personal
  208.                                                password" for protecting AFD/FUI
  209.                                                subcriptions, authenticating PUT
  210.                                                commands, and so on
  211.              ADD firstpw                       -> Define a password for the
  212.                                                   first time
  213.              CHange newpw <PW=oldpw>           -> Change password
  214.              RESET                             -> Reset (delete) password
  215.  
  216. SENDme                                         Same as GET
  217.  
  218. Other (advanced) commands
  219. -------------------------
  220. DATAbase     function                          Access LISTSERV database:
  221.              Search DD=ddname <ECHO=NO>        -> Perform database search
  222.                                                   (see INFO DATABASE for more
  223.                                                    information on this)
  224.              List                              -> Get a list of databases
  225.                                                   available from that server
  226.              REFRESH dbname                    -> Refresh database index, if
  227.                                                   suitably privileged
  228.  
  229. DBase                                          Same as DATABASE
  230.  
  231. DISTribute   <type> <source> <dest> <options>  Distribute a file or a mail
  232.                                                message to a list of users (see
  233.                                                INFO DIST for more details on
  234.                                                the syntax)
  235.              Type:
  236.              MAIL                              -> Data is a mail message, and
  237.                                                   recipients are defined
  238.                                                   by '<dest>'
  239.              FILE                              -> Data is not mail, recipients
  240.                                                   are defined by '<dest>'
  241.              RFC822                            -> Data is mail and recipients
  242.                                                   are defined by the RFC822
  243.                                                   'To:'/'cc:' fields
  244.              Source:
  245.              DD=ddname                         -> Name of DDname holding the
  246.                                                   data to distribute (default:
  247.                                                   'DD=DATA')
  248.              Dest:
  249.              <TO> user1 <user2 <...>>          -> List of recipients
  250.              <TO> DD=ddname                    -> One recipient per line
  251.              Options for the general user:
  252.              ACK=NOne/MAIL/MSG                 -> Acknowledgement level
  253.                                                   (default: ACK=NONE)
  254.              CANON=YES                         -> 'TO' list in 'canonical' form
  255.                                                   (uid1 host1 uid2 host2...)
  256.              DEBUG=YES                         -> Do not actually perform the
  257.                                                   distribution; returns debug
  258.                                                   path information
  259.              INFORM=MAIL                       -> Send file delivery message to
  260.                                                   recipients via mail
  261.              TRACE=YES                         -> Same as DEBUG=YES, but file
  262.                                                   is actually distributed
  263.              Options requiring privileges:
  264.              FROM=user                         -> File originator
  265.              FROM=DD=ddname                    -> One line: 'address name'
  266.  
  267. FOR          user command                      Execute a command on behalf of
  268.                                                another user (for node
  269.                                                administrators)
  270.  
  271. SERVE        user                              Restore service to a disabled
  272.                                                user
  273.  
  274. THANKs                                         Check the server is alive
  275.  
  276. UDD                                            Access the User Directory
  277.                                                Database (there are 18 functions
  278.                                                and many sub-functions, so the
  279.                                                syntax is not given here)
  280. .2
  281. File management commands (for file owners only)
  282. -----------------------------------------------
  283. AFD/FUI                                        Automatic File Distribution
  284.              GET fn ft <filelist>              Get a list of people subscribed
  285.                                                to a file you own
  286.  
  287. GET          fn FILELIST <(options>            Special options for filelists:
  288.              CTL                               -> Return filelist in a format
  289.                                                   suitable for editing and
  290.                                                   storing back
  291.              NOLock                            -> Don't lock filelist (use in
  292.                                                   conjunction with CTL)
  293.  
  294. PUT          fn ft <filelist <NODIST>>         Update a file you own
  295.              <CKDATE=NO>                       -> Accept request even if
  296.                                                   current version of the file
  297.                                                   is more recent than the
  298.                                                   version you sent
  299.              <DATE=yymmddhhmmss>               -> Set file date/time
  300.              <PW=password>                     -> Supply your password for
  301.                                                   command authentication
  302.              <RECFM=F <LRECL=nnn>>             -> Select fixed-format file (not
  303.                                                   to be used for text files)
  304.              <REPLY-TO=user>                   -> Send reply to another user
  305.              <REPLY-TO=NONE>                   -> Don't send any reply
  306.              <REPLY-VIA=MSG>                   -> Request reply via interactive
  307.                                                   messages, not mail
  308.              <"parameters">                    -> Special parameters passed to
  309.                                                   FAVE routine, if any
  310.              Standard parameters supported for
  311.              all files:
  312.              TITLE=file title                  -> Change file "title" in
  313.                                                   filelist entry
  314.  
  315. REFRESH      filelist <(options>               Refresh a filelist you own
  316.              NOFLAG                            -> Don't flag files which have
  317.                                                   changed since last time as
  318.                                                   updated (for AFD/FUI)
  319.  
  320. UNLOCK       fn FILELIST                       Unlock filelist after a GET with
  321.                                                the CTL option if you decide not
  322.                                                to update it after all
  323.  
  324. List management functions
  325. -------------------------
  326. Commands that support the QUIET keyword are marked (*)
  327.  
  328. ADD(*)       listname user <full_name>         Add a user to one of your lists,
  329.                                                or update his name
  330.              listname DD=ddname                -> Add multiple users, one
  331.                                                   address/name pair per line
  332. ADDHere(*)                                     Same as ADD, but never forwards
  333.                                                the request to a possibly closer
  334.                                                peer
  335.  
  336. DELete(*)    listname user <(options>          Remove a user from one of your
  337.                                                lists, or from all local lists
  338.                                                if listname is '*'
  339.              GLobal                            -> Forward request to all peers
  340.              LOCal                             -> Don't try to forward request
  341.                                                   to closest peer if not found
  342.                                                   locally
  343.              TEST                              -> Do not actually perform any
  344.                                                   deletion (useful to test
  345.                                                   wildcard patterns)
  346.  
  347.  
  348. EXPLODE      listname <(options>               Examine list and suggest better
  349.                                                placement of recipients,
  350.                                                returning a ready-to-submit MOVE
  351.                                                job
  352.              BESTpeers n                       -> Suggest the N best possible
  353.                                                   peers to add
  354.              Detailed                          -> More detailed analysis
  355.              FOR node                          -> Perform analysis as though
  356.                                                   local node were 'nodeid'
  357.              PREFer node                       -> Preferred peer in case of
  358.                                                   tie (equidistant peers)
  359.              SERVice                           -> Check service areas are
  360.                                                   respected
  361.              With(node1 <node2 <...>>>)        -> Perform analysis as though
  362.                                                   specified nodes ran a peer
  363.              WITHOut(node1 <node2 <...>>>)     -> Opposite effect
  364.  
  365. FREE         listname <(options>               Release a held list
  366.              GLobal                            -> Forward request to all peers
  367.  
  368. GET          listname <(options>               Get a copy of a list in a form
  369.                                                suitable for editing and storing
  370.                                                list and lock it
  371.              GLobal                            -> Forward request to all peers
  372.              HEADer                            -> Send just the header; on the
  373.                                                   way back, only the header
  374.                                                   will be updated
  375.              NOLock                            -> Do not lock the list
  376.              OLD                               -> Recover the "old" copy of the
  377.                                                   list (before the last PUT)
  378.  
  379. HOLD         listname <(options>               Hold a list, preventing new
  380.                                                postings from being processed
  381.                                                until a FREE command is sent
  382.              GLobal                            -> Forward request to all peers
  383.  
  384. MOVE(*)      listname user <TO> node           Move a subscriber to another
  385.                                                peer
  386.              listname DD=ddname                -> Move several subscribers to
  387.                                                   various peers
  388.  
  389. PUT          listname LIST                     Update a list from the file
  390.                                                returned by a GET command
  391.  
  392. Query        listname <WITH options> FOR user  Query the subscription options
  393.                                                of another user (wildcards are
  394.                                                supported)
  395.              *        <WITH options> FOR user  Searches all the lists you own
  396.  
  397. SET(*)       listname options <FOR user>       Alter the subscription options
  398.              *                                 of another user or set of users
  399.                                                (when using wildcards)
  400.              Additional options for list owners:
  401.              NORENEW/RENEW                     -> Waive subscription
  402.                                                   confirmation for this user
  403.              NOPOST/POST                       -> Prevent user from posting to
  404.                                                   list
  405.              EDITor/NOEDITor                   -> User may post without going
  406.                                                   through moderator
  407.              REView/NOREView                   -> Postings from user go to list
  408.                                                   owner or moderator even if
  409.                                                   user is allowed to post
  410.  
  411. STats        listname (RESET                   Resets statistics for the list
  412.  
  413. UNLOCK       listname                          Unlock a list after a GET, if
  414.                                                you decide not to update it
  415.                                                after all
  416. .3
  417. CMS          command_text                      Issue a CMS command and get the
  418.                                                last 20 lines of response sent
  419.                                                back to you, the rest being
  420.                                                available from the console log
  421.  
  422. CP           command_text                      Issue a CP command and get up to
  423.                                                8k of response data sent to you
  424.                                                (the rest is lost)
  425.  
  426. DATAbase     function                          Control operation of databases:
  427.              DISAble                           -> Disable interactive database
  428.                                                   access, without shutting down
  429.                                                   existing sessions
  430.              ENAble                            -> Re-enable interactive access
  431.              SHUTDOWN                          -> Shut down all interactive
  432.                                                   database sessions, and
  433.                                                   disable interactive access
  434.  
  435. INSTALL      function                          Software update procedure:
  436.              CLEANUP shipment                  -> Remove an installed shipment
  437.                                                   from the log
  438.              CLEANUP BEFORE dd mmm yy          -> Remove all shipments
  439.                                                   installed before that date
  440.              PASSWORD shipment PW=instpw       -> Confirm installation of a
  441.                                                   shipment, when requested by
  442.                                                   LISTSERV
  443.              RELOAD shipment                   -> Attempt to reload a shipment
  444.                                                   which failed due to a disk
  445.                                                   full condition
  446.              STATus                            -> Get a list of installed
  447.                                                   "shipments"
  448.  
  449. NODESGEN     <WTONLY>                          Regenerate all LISTSERV network
  450.                                                tables, or just compile the
  451.                                                links weight file (debugging
  452.                                                command)
  453.  
  454. OFFLINE                                        Suspend processing of reader
  455.                                                files and disable the GET
  456.                                                command
  457.  
  458. ONLINE                                         Cancel OFFLINE condition
  459.  
  460. PUT          listname LIST                     Create a new list
  461.  
  462. PUTC         fn ft <fm|cuu|dirid>              Update a CMS file on one of
  463.              <RECFM=F LRECL=nnn>               LISTSERV's R/W minidisks; note
  464.                                                that this is similar to SENDFILE
  465.                                                + RECEIVE or LINK + COPYFILE and
  466.                                                should NOT be used to update
  467.                                                file-server files
  468.  
  469. PWC          function                          Password file management:
  470.              ADD    user newpw                 -> Define a password for the
  471.                                                   specified user
  472.              DELete user                       -> Delete password for that user
  473.              Query  user                       -> Query the password of the
  474.                                                   specified user
  475.  
  476. REGister     name|OFF FOR user                 Set a user's SIGNUP FILE entry
  477.  
  478. SENDFile     fn ft <fm|cuu|dirid>              Request the server to send you a
  479.                                                file from one of its disks
  480.  
  481. SERVE        user OFF                          Permanently suspend access from
  482.                                                an abusive user or gateway
  483.                                                (restore with 'SERVE user')
  484.  
  485. SF                                             Same as SENDFILE
  486.  
  487. SHOW         BENCHmarks                        -> CPU/disk/paging benchmarks
  488.              EXECLoad                          -> Statistics about EXECLOADed
  489.                                                   REXX files
  490.              LSVFILER                          -> Statistics about LSVFILER
  491.                                                   file cache
  492.              PREXX                             -> Statistics about PREXX
  493.                                                   functions usage
  494.              STORage                           -> Information about available
  495.                                                   disk space and virtual
  496.                                                   storage
  497.  
  498. SHUTDOWN     <REBOOT|REIPL>                    Stop or reboot the server (the
  499.                                                two options are synonyms)
  500.  
  501. STOP                                           Same as SHUTDOWN
  502.  
  503. Note: some debugging commands and options have been omitted.
  504. .P
  505.  
  506. Syntax of parameters
  507. --------------------
  508. filelist  = 1 to 8 characters from the following set: A-Z 0-9 $#@+-_:
  509. fformat   = Netdata, Card, Disk, Punch, LPunch, UUencode, XXencode, VMSdump,
  510.             MIME/text, MIME/Appl, Mail
  511. fn        = same syntax as 'filelist'
  512. ft        = same syntax as 'filelist'
  513. full_name = firstname <middle_initial> surname (*not* your e-mail address)
  514. host      = Internet hostname
  515. listname  = name of an existing list
  516. node      = BITNET nodeid or Internet hostname of a BITNET machine which
  517.             has taken care of supplying a ':internet.' tag in its BITEARN
  518.             NODES entry
  519. pw        = A password with characters from the set: A-Z 0-9 $#@_-?!|%
  520. user      = Any valid Internet address not longer than 80 characters; if
  521.             omitted, the 'hostname' part defaults to that of the command
  522.             originator
  523.