home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat1 / QuickPage.z / QuickPage
Encoding:
Text File  |  2002-10-03  |  40.6 KB  |  859 lines

  1.  
  2.  
  3.  
  4. QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee((((1111))))                                                      QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      QuickPage - SNPP client/server for sending messages to an alpha-numeric
  10.      pager
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      qqqqppppaaaaggggeeee [ ----ddddhhhhiiiimmmmQQQQvvvv ] [ ----aaaa [+][_d_d+]_h_h_m_m | ----aaaa _Y_Y_M_M_D_D_H_H_M_M_S_S ] [ ----cccc _c_o_v_e_r_a_g_e ] [
  14.      ----ffff _f_r_o_m ] [ ----llll _l_e_v_e_l ] [ ----pppp _p_a_g_e_r_i_d ] [ ----PPPP _p_a_g_e_r_i_d ] [ ----ssss _s_e_r_v_e_r ] [
  15.      _m_e_s_s_a_g_e ]
  16.  
  17.      qqqqppppaaaaggggeeee [ ----dddd ] [ ----CCCC _c_o_n_f_i_g ] ----qqqq _i_n_t_e_r_v_a_l
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee sends messages to a paging terminal using the SNPP and IXO
  21.      (also known as TAP) protocols.  It is normally used with no options other
  22.      than a recipient and the message text, in which case the message is sent
  23.      to the SNPP server where it is submitted to a page queue to be sent by a
  24.      separate daemon process.  Page groups and duty schedules are supported.
  25.      Status notification messages indicating the success or failure of a page
  26.      are sent via e-mail to submitters of high-priority (level 0) pages.
  27.  
  28.      If no message is specified on the command line, the user is prompted for
  29.      the message text.  Characters are read from standard input until a line
  30.      containing only a period is received, or until EOF is received.  All
  31.      occurrences of whitespace within the message text are reduced to a single
  32.      space character.
  33.  
  34.      Messages received by the QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee daemon that are longer than the
  35.      maximum page length (see below) are split into multiple segments and sent
  36.      as separate pages.  Each message segment is prefixed with its segment
  37.      number.  The maximum number of segments a into which a message will be
  38.      split is configurable.  If a message exceeds this limit, the last allowed
  39.      segment will be prefixed with 't', indicating that the message is
  40.      truncated; otherwise, the last segment is prefixed with 'e' to indicate
  41.      the end of the message.  Messages that fit into a single page are not
  42.      prefixed with segment numbers.  All message segments are prefixed with
  43.      CALLerid information (see RFC-1861), if available.
  44.  
  45. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  46.      The following options are supported:
  47.  
  48.      ----aaaa   Send the page at the specified time.  A time specification prefixed
  49.           with a plus sign (+) is added to the current time.  The QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee
  50.           daemon will not send any pages with a timestamp newer than the
  51.           current time.  This feature may be used to provide a simple alarm
  52.           clock function for meeting reminders, etc.  This option applies only
  53.           to the pagerid(s) specified by the next ----pppp option.  If the specified
  54.           time is in the format YYMMDDHHMMSS, the two-digit year is
  55.           interpreted as follows: if the last two digits of the specified year
  56.           are in the range 00-49 and the last two digits of the current year
  57.           are in the range 50-99, assume the specified time is in the next
  58.           century.  Otherwise assume the specified time is in the current
  59.           century.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee((((1111))))                                                      QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee((((1111))))
  71.  
  72.  
  73.  
  74.      ----cccc   Use a different coverage area or paging service.  This option is
  75.           only useful if the recipient has more than one pager and/or more
  76.           than one paging service. This option applies only to the pagerid(s)
  77.           specified by the next ----pppp option.
  78.  
  79.      ----CCCC   Specify an alternate configuration file.  This option may only be
  80.           used on the QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee server.
  81.  
  82.      ----dddd   Debug mode.  Very verbose and probably not interesting for the
  83.           normal user.  This option is provided for debugging purposes only.
  84.  
  85.      ----ffff   Specify who the page is from.  This option specifies the argument to
  86.           the SNPP CCCCAAAALLLLLLLLeeeerrrriiiidddd command.  Every message segment will be prefixed
  87.           with the value specified by this option unless disabled by the
  88.           msgprefix keyword in the configuration file.  A null argument ( ----ffff
  89.           "") may be specified to suppress the message prefix for a particular
  90.           message.  However, this will also suppress e-mail status
  91.           notification.  The default is the userid of the person running
  92.           QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee....
  93.  
  94.      ----hhhh   Help.  Print a brief summary of the command line options.
  95.  
  96.      ----iiii   Use interactive mode.  The page is sent immediately and summary
  97.           messages are printed during the course of the transaction.  This
  98.           option may only be used on a machine with a physically attached
  99.           modem.  This option is intended for debugging purposes only and
  100.           should not be used in a production environment.  The ----dddd option, when
  101.           used in conjunction with this option, can be very effective in
  102.           troubleshooting problems between the SNPP server and the remote
  103.           paging terminal.
  104.  
  105.      ----llll   Specify the service level for this page.  The service level must be
  106.           a number between 0 and 11, inclusive.  The TME protocol specifies
  107.           service level as follows:
  108.  
  109.                0 - Priority
  110.                1 - Normal (default)
  111.                2 - Five minutes
  112.                3 - Fifteen minutes
  113.                4 - One hour
  114.                5 - Four hours
  115.                6 - Twelve hours
  116.                7 - Twenty Four hours
  117.                8 - Carrier specific '1'
  118.                9 - Carrier specific '2'
  119.                10 - Carrier specific '3'
  120.                11 - Carrier specific '4'
  121.  
  122.           With the exception of level zero, service levels have no meaning to
  123.           QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee but they are accepted for compatibility with other
  124.           programs.  Pages submitted with service level zero cause e-mail to
  125.           be sent to the submitter whenever a page succeeds or fails.  Any
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee((((1111))))                                                      QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee((((1111))))
  137.  
  138.  
  139.  
  140.           service level specified by the user is passed on to the SNPP server.
  141.           This option applies only to the pagerid(s) specified by the next ----pppp
  142.           option.
  143.  
  144.      ----mmmm   This option tells QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee to read an e-mail message from standard
  145.           input.  A page is constructed by concatenating the From: header
  146.           (XXX), the Subject: header (YYY), and lines from the message body
  147.           (ZZZ) as follows:
  148.  
  149.                XXX (Subj: YYY) ZZZ ...
  150.  
  151.           Minimal support is provided for multipart MIME messages.  The first
  152.           part with a Content-Type: of text/plain will be processed.  The
  153.           remaining parts will be discarded.  This will reduce the problems
  154.           associated with people accidentally mailing binaries to their
  155.           pagers.
  156.  
  157.           The X-sun-attachment type is not supported and should not be used.
  158.           MIME is a documented standard.  The X-sun-attachment type is neither
  159.           documented nor standard.  However, QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee will still use the
  160.           From: and Subject: lines (but no message body) from such messages
  161.           for those people who insist on using it anyway.
  162.  
  163.           A line starting with two dashes (--) in the message body (or in a
  164.           MIME text part) is assumed to be the start of a signature and will
  165.           cause QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee to stop processing the e-mail message at that point.
  166.  
  167.      ----pppp   Specify the pagerid of the intended recipient.  Multiple recipients
  168.           may be specified by separating their pager IDs with commas (e.g.
  169.           pagerid1,pagerid2,pagerid3).  No spaces are permitted between
  170.           recipients and the comma separator characters.  Any ----aaaa,,,, ----cccc,,,, or ----llll
  171.           options previously encountered on the command line are reset to
  172.           their default values after this option is processed.  This option
  173.           may occur multiple times on the command line, each possibly preceded
  174.           by different ----aaaa,,,, ----cccc,,,, or ----llll options.
  175.  
  176.      ----PPPP   Like ----pppp but does not reset ----aaaa,,,, ----cccc,,,, or ----llll options previously
  177.           encountered on the command line.
  178.  
  179.      ----qqqq   Start a QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee daemon.  This option causes QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee to detach
  180.           itself from the controlling terminal and run as a daemon process.
  181.           This option requires a numerical argument.  If the argument is
  182.           greater than zero, it specifies the number of seconds QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee
  183.           should sleep between queue runs.  An argument less than zero signals
  184.           QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee to accept incoming SNPP connections and write new pages to
  185.           the page queue, but to never process the page queue.  An argument of
  186.           zero signals QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee not to listen for incoming SNPP connections,
  187.           but to process the page queue one time and then exit.  See the NOTES
  188.           section below for more information.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee((((1111))))                                                      QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee((((1111))))
  203.  
  204.  
  205.  
  206.      ----QQQQ   Print the current contents of the page queue.  This option may only
  207.           be used on the QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee server.
  208.  
  209.      ----ssss   Specify the name(s) of the SNPP server(s).  The hostnames used by a
  210.           client to contact a server are determined by checking the following
  211.           in this order:
  212.  
  213.                the ----ssss option
  214.                the environment variable SNPP_SERVER
  215.                the contents of the compiled in filename
  216.                the compiled in hostname
  217.  
  218.           Multiple hostnames are permitted by separating them with commas.  If
  219.           multiple servers are used, it is assumed that they all have
  220.           identical copies of the configuration file.
  221.  
  222.      ----vvvv   Print the version of QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee and exit.
  223.  
  224.      The QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee server requires a configuration file.  This file is read
  225.      one time during startup and again upon receipt of SIGHUP.  The
  226.      configuration file is made up of major and minor keyword=value pairs.
  227.      Major keywords must start at the beginning of a line.  Minor keywords
  228.      must contain leading whitespace.  All keywords must be immediately
  229.      followed with an equal sign (=).  Spaces are permitted between the equal
  230.      sign and the value.  The value may not contain whitespace.  Keywords may
  231.      appear in any order with the following four exceptions:
  232.  
  233.           Minor keywords must be grouped together under their respective major
  234.           keyword.
  235.  
  236.           Modems must be defined before any services that reference them.
  237.  
  238.           Services must be defined before any pagers that reference them.
  239.  
  240.           Pagers must be defined before any groups that reference them.
  241.  
  242.      The major keywords are:
  243.  
  244.           administrator  The e-mail address of the QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee administrator.
  245.                          If defined, e-mail notification will be sent to the
  246.                          QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee administrator whenever a page fails (i.e.
  247.                          when mmmmaaaaxxxxttttrrrriiiieeeessss has been exceeded).  This address is
  248.                          also used in the Reply-To: header for status
  249.                          notification messages sent to users who submit high-
  250.                          priority pages.
  251.  
  252.           forcehostname  (true, false, or @mailhost) Force the destination
  253.                          address to be qualified with a hostname when sending
  254.                          e-mail status notification to users.  This option can
  255.                          be used when the QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee daemon is running on a
  256.                          machine that does not handle unqualified e-mail
  257.                          addresses correctly.  If the value of this keyword
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee((((1111))))                                                      QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee((((1111))))
  269.  
  270.  
  271.  
  272.                          starts with the '@' character, it will be appended
  273.                          as-is to unqualified e-mail addresses.  If the value
  274.                          of this keyword is "true" then the submitter's
  275.                          hostname will be appended to such addresses.  The
  276.                          default is false (do not append hostnames).
  277.  
  278.           identtimeout   The number of seconds to wait for a reply before
  279.                          giving up on RFC-1413 queries.  An integer less than
  280.                          or equal to zero disables ident functionality.  The
  281.                          default is 10 seconds.
  282.  
  283.           include        If present, this keyword specifies the name of
  284.                          another configuration file that should be processed
  285.                          at this point.  Processing of the current file
  286.                          resumes after the specified file has been processed.
  287.                          QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee makes no attempt to prevent infinite
  288.                          recursion; do not use this keyword in multiple files
  289.                          that point at each other.
  290.  
  291.           pidfile        If present, this keyword specifies a file into which
  292.                          the server should write its process ID.  For security
  293.                          reasons, the file must already exist and it must be
  294.                          writable by the userid in effect while the server is
  295.                          running.  If either if these conditions are not
  296.                          satisfied, this keyword is silently ignored.
  297.  
  298.           sigfile        If present, this keyword specifies a file containing
  299.                          an alternate signature that qpage should append to
  300.                          e-mail status notification messages sent to page
  301.                          submitters.  Use sigfile=/dev/null to suppress the
  302.                          signature completely.
  303.  
  304.           synchronous    (true or false) Whether or not queue runs are
  305.                          synchronized with new pages.  If true, the submission
  306.                          of a new page initiates a queue run without waiting
  307.                          for the normal sleep counter (set by the -q option).
  308.                          If false, the page is queued and the server waits for
  309.                          the time remaining on the sleep counter (if any)
  310.                          before starting another queue run.  The default is
  311.                          true.
  312.  
  313.           lockdir        The location of the lock directory.  This keyword may
  314.                          be used to override the compiled in location of the
  315.                          lock directory.  It should rarely be necessary to
  316.                          specify this keyword.
  317.  
  318.           snpptimeout    The number of seconds to wait for an SNPP command
  319.                          before terminating the connection.  The default is 60
  320.                          seconds.
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee((((1111))))                                                      QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee((((1111))))
  335.  
  336.  
  337.  
  338.           queuedir       The location of the page queue.  There is no default
  339.                          queue directory; this option must be specified in the
  340.                          configuration file.
  341.  
  342.           modem          The start of a modem definition.  The argument to
  343.                          this keyword is the name of a modem device (e.g.
  344.                          hayes).  This keyword has the following minor
  345.                          keywords:
  346.  
  347.                          text           Optional text specified by the
  348.                                         administrator.  This text may not
  349.                                         contain whitespace.  However,
  350.                                         underscores are converted to spaces
  351.                                         when the value of this keyword is
  352.                                         read.  This keyword is not interpreted
  353.                                         by QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee and is only provided for
  354.                                         the administrator's convenience.
  355.  
  356.                          device         The name of the device the modem is
  357.                                         physically connected to, such as
  358.                                         /dev/cua/a.  There is no default
  359.                                         device; this option must be specified
  360.                                         in the configuration file.
  361.  
  362.                          initcmd        The initialization command for this
  363.                                         modem.  The initialization command
  364.                                         must cause the modem to respond with
  365.                                         OK.  The default initialization
  366.                                         command is ATZ.  dialcmd The dial
  367.                                         command for this modem.  The dial
  368.                                         command specified here should not
  369.                                         contain any phone number.  The default
  370.                                         dial command is ATDT.
  371.  
  372.           service        The start of a paging service definition.  The
  373.                          argument to this keyword is the name of the paging
  374.                          service.  If a service named ddddeeeeffffaaaauuuulllltttt exists, the
  375.                          values of its minor keywords are used as defaults for
  376.                          all other service definitions.  This keyword has the
  377.                          following minor keywords:
  378.  
  379.                          text           Optional text specified by the
  380.                                         administrator.  This text may not
  381.                                         contain whitespace.  However,
  382.                                         underscores are converted to spaces
  383.                                         when the value of this keyword is
  384.                                         read.  This keyword is not interpreted
  385.                                         by QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee and is only provided for
  386.                                         the administrator's convenience.
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee((((1111))))                                                      QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee((((1111))))
  401.  
  402.  
  403.  
  404.                          device         One or more names of modem
  405.                                         definitions.  Multiple modems may be
  406.                                         specified by separating them with
  407.                                         commas.  For backward compatibility
  408.                                         with previous QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee versions, a
  409.                                         physical device path may be specified
  410.                                         here.  However, this may not be
  411.                                         supported in future releases; modem
  412.                                         definitions should be used instead.
  413.  
  414.                          dialcmd        The command that the modem should use
  415.                                         to connect to the remote paging
  416.                                         service.  This keyword is accepted for
  417.                                         backward compatibility with previous
  418.                                         QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee versions and may not be
  419.                                         supported in future releases.  If
  420.                                         specified, this keyword overrides the
  421.                                         dialcmd keyword in all modem
  422.                                         specifications used by this service.
  423.  
  424.                          phone          The phone number of the paging
  425.                                         service.  The specified phone number
  426.                                         will be appended to the modem's
  427.                                         dialcmd when calling the paging
  428.                                         service.
  429.  
  430.                          password       The password to use when logging into
  431.                                         the remote paging service.  The IXO
  432.                                         specification defines the password as
  433.                                         an optional six character alphanumeric
  434.                                         string.  Most paging services in the
  435.                                         United States do not require a
  436.                                         password.  The default is an empty
  437.                                         string ("").
  438.  
  439.                          baudrate       The speed to use while talking to the
  440.                                         modem.  The default is 300 baud.
  441.  
  442.                          parity         The parity to use (even, odd, or none)
  443.                                         while talking to the modem.  The
  444.                                         default is even.
  445.  
  446.                          maxmsgsize     The maximum number of characters
  447.                                         allowed in a single page segment.  The
  448.                                         default is 80 characters.
  449.  
  450.                          maxpages       The maximum number of page segments to
  451.                                         send when a message exceeds
  452.                                         mmmmaaaaxxxxmmmmssssggggssssiiiizzzzeeee.... The value of this option
  453.                                         must be between 1 and 9, inclusive.
  454.                                         The default is 9 page segments.
  455.  
  456.  
  457.  
  458.  
  459.                                                                         PPPPaaaaggggeeee 7777
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee((((1111))))                                                      QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee((((1111))))
  467.  
  468.  
  469.  
  470.                          maxtries       The number of times to attempt sending
  471.                                         a page before giving up.  If the modem
  472.                                         is busy (i.e. tip or cu is currently
  473.                                         using it) or if the modem returns BUSY
  474.                                         in response to the dial command, the
  475.                                         counter is not incremented.  Thus a
  476.                                         busy modem will cause QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee to
  477.                                         retry the page forever.  The default
  478.                                         is 6.
  479.  
  480.                          identfrom      (true or false) This keyword specifies
  481.                                         whether to use the ident response as
  482.                                         the message prefix if no CALLerid SNPP
  483.                                         command is received.  The default is
  484.                                         true.
  485.  
  486.                          allowpid       (true or false) This keyword specifies
  487.                                         whether the QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee daemon will
  488.                                         accept numeric pagerids for pagers not
  489.                                         specified in the configuration file.
  490.                                         The default service is used for such
  491.                                         pagerids unless the user explicitly
  492.                                         chooses a different service.  The
  493.                                         default for this keyword is false.
  494.  
  495.                          msgprefix      (true or false) Whether to prepend the
  496.                                         sender's name (the CALLerid
  497.                                         information) to the beginning of each
  498.                                         page segment.  This keyword can be set
  499.                                         to false for paging services that
  500.                                         support numeric pagers if the message
  501.                                         contains only digits.  The default for
  502.                                         this keyword is true.
  503.  
  504.           pager          The start of a pager definition.  The argument to
  505.                          this keyword is the username associated with the
  506.                          pager.  This username will be specified by the ----pppp
  507.                          option on the command line when running QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee in
  508.                          client mode.  This keyword has the following minor
  509.                          keywords:
  510.  
  511.                          text           Optional text specified by the
  512.                                         administrator.  This text may not
  513.                                         contain whitespace.  However,
  514.                                         underscores are converted to spaces
  515.                                         when the value of this keyword is
  516.                                         read.  Pager specifications containing
  517.                                         this keyword will be listed by the
  518.                                         XWHO SNPP command.  See the NOTES
  519.                                         section below for more information.
  520.  
  521.  
  522.  
  523.  
  524.  
  525.                                                                         PPPPaaaaggggeeee 8888
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee((((1111))))                                                      QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee((((1111))))
  533.  
  534.  
  535.  
  536.                          pagerid        The pagerid sent to the remote paging
  537.                                         service for this pager.
  538.  
  539.                          service        The default service to use for this
  540.                                         pager.
  541.  
  542.           group          The start of a group definition.  The argument to
  543.                          this keyword is the name of a new page group.  This
  544.                          keyword has the following minor keywords:
  545.  
  546.                          text           Optional text specified by the
  547.                                         administrator.  This text may not
  548.                                         contain whitespace.  However,
  549.                                         underscores are converted to spaces
  550.                                         when the value of this keyword is
  551.                                         read.  Group specifications containing
  552.                                         this keyword will be listed by the
  553.                                         XWHO SNPP command.  See the NOTES
  554.                                         section below for more information.
  555.  
  556.                          member         A member of this group.  The member
  557.                                         must have a valid ppppaaaaggggeeeerrrr entry before
  558.                                         this group definition.  An optional
  559.                                         duty schedule (see below) may be
  560.                                         specified.  This keyword may appear
  561.                                         multiple times within a single group.
  562.  
  563.      The service named "default" always exists (even if not specified in the
  564.      configuration file) and has the default values listed above.  However,
  565.      the default service may be redefined in the configuration file if
  566.      desired.
  567.  
  568.      Member definitions within a page group have the syntax:
  569.  
  570.           member=name[/DayStart-End]
  571.  
  572.      Where the square brackets indicate an optional duty schedule.  The duty
  573.      schedule has the same syntax as the TTTTiiiimmmmeeee parameter in the UUCP SSSSyyyysssstttteeeemmmmssss
  574.      file:  DDDDaaaayyyy is a list of case-sensitive weekday abbreviations (e.g.
  575.      MoTuTh), SSSSttttaaaarrrrtttt is the start time (e.g. 800), and EEEEnnnndddd is the end time
  576.      (e.g. 1700).  The word AAAAnnnnyyyy is synonymous with SSSSuuuuMMMMooooTTTTuuuuWWWWeeeeTTTThhhhFFFFrrrrSSSSaaaa.... Midnight
  577.      may be represented as either 0 or 2400.  The time range must not span
  578.      across midnight.  A slash is required to separate the duty schedule from
  579.      the member name.  Multiple member definitions for the same person with
  580.      different duty schedules are permitted (see the example below).
  581.      Overlapping duty schedules for the same person within a group will not
  582.      cause duplicate pages to be sent to that person.  See the following
  583.      example configuration file:
  584.  
  585.           #
  586.           # QuickPage configuration file
  587.           #
  588.  
  589.  
  590.  
  591.                                                                         PPPPaaaaggggeeee 9999
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598. QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee((((1111))))                                                      QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee((((1111))))
  599.  
  600.  
  601.  
  602.           administrator=tomiii@qpage.org
  603.           identtimeout=5
  604.           queuedir=/var/spool/qpage
  605.  
  606.           modem=ttya
  607.                device=/dev/cua/a
  608.  
  609.           # use the S7 modem register to set a connection timeout
  610.           modem=ttyb
  611.                device=/dev/cua/b
  612.                initcmd=ATS7=45V1Q2&K0&M0
  613.  
  614.           service=airtouch
  615.                device=ttya,ttyb
  616.                phone=9,9500572
  617.                baudrate=1200
  618.                allowpid=yes
  619.                maxtries=6
  620.  
  621.           service=skytel
  622.                device=ttya
  623.                phone=9,18007596366
  624.  
  625.           service=supercom
  626.                device=ttya
  627.                phone=9,4879889
  628.  
  629.           pager=tomiii
  630.                pagerid=1234567
  631.                service=skytel
  632.  
  633.           pager=ginger
  634.                pagerid=5551212
  635.                service=skytel
  636.  
  637.           pager=tony
  638.                pagerid=711
  639.                service=supercom
  640.  
  641.           group=sysadmin
  642.                member=tomiii/MoWeFr800-1700
  643.                member=tony/TuTh800-1700
  644.                member=tony/SaSu900-1600
  645.  
  646. NNNNOOOOTTTTEEEESSSS
  647.      The order of the command line options is important.  The ----aaaa,,,, ----cccc,,,, and ----llll
  648.      options must precede the pagerids they refer to.
  649.  
  650.      The ----pppp option resets ----aaaa,,,, ----cccc,,,, and ----llll to their default values after it is
  651.      processed.  If this behavior is not desired, use ----PPPP instead.
  652.  
  653.  
  654.  
  655.  
  656.  
  657.                                                                        PPPPaaaaggggeeee 11110000
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664. QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee((((1111))))                                                      QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee((((1111))))
  665.  
  666.  
  667.  
  668.      All 8-bit characters are stripped to 7 bits before they are transmitted
  669.      to the paging service, regardless of the parity setting defined in the
  670.      configuration file.  Also, all control characters (ASCII values between
  671.      0x00 and 0x20) are "escaped" as specified by the IXO/TAP protocol.
  672.      Escaping is done by converting each control character into two bytes
  673.      consisting of a SUB (0x1A) character followed by the printable ASCII
  674.      character formed by adding 0x40 to the ASCII value of the control
  675.      character.  Thus, Ctrl-A is transmitted as the two-byte sequence 0x1A,
  676.      0x41.
  677.  
  678.      QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee daemon listens for incoming SNPP connections and periodically
  679.      processes the page queue.  A child process is created to handle each
  680.      incoming request and each queue run.
  681.  
  682.      After a page is accepted, the child sends SIGUSR1 to its parent forcing
  683.      it to start a queue run immediately without waiting for the time
  684.      specified by -q.  If desired, this signal can be suppressed using the
  685.      "synchronous" keyword described above.
  686.  
  687.      The page queue is locked during queue runs to prevent multiple processes
  688.      from competing for modem resources.
  689.  
  690.      The QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee SNPP daemon supports a proprietary XWHO command not
  691.      documented in the official SNPP protocol as described in RFC-1861.  XWHO
  692.      takes no arguments and returns a multi-line response of the form:
  693.  
  694.           214 pager1 text1
  695.           214 pager2 text2
  696.           214 pager3 text3
  697.            .
  698.            .
  699.            .
  700.           214 pagerN textN
  701.           250
  702.  
  703.      where the first word after the 214 response code is the name of a pager
  704.      or page group, followed by the value of the corresponding text keyword
  705.      (with underscores converted to spaces) from the configuration file.
  706.      Pager and group specifications that do not have the text keyword defined
  707.      in the configuration file will not be included in the XWHO response.  The
  708.      purpose of the XWHO command is to allow SNPP clients to present users
  709.      with a list of possible recipients and their names or descriptions.  XWHO
  710.      is supported by QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee in an attempt to overcome the current SNPP
  711.      protocol's deficiency.  If the protocol is ever revised in the future to
  712.      include this functionality, support for the XWHO command will be dropped
  713.      in favor of whatever facilities are specified at that time.  Software
  714.      developers writing their own SNPP clients should be advised that the XWHO
  715.      command is not stable and may be removed from future versions of
  716.      QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee without notice.
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.                                                                        PPPPaaaaggggeeee 11111111
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730. QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee((((1111))))                                                      QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee((((1111))))
  731.  
  732.  
  733.  
  734.      If the CALLerid information received by the QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee daemon contains the
  735.      '@' character, it is truncated at that character before being prepended
  736.      to messages.  However, it is used as-is for the destination address when
  737.      sending e-mail notification for high-priority recipients.
  738.  
  739.      Due to the protocol limitations of SNPP, QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee derives e-mail
  740.      notification addresses from the CCCCAAAALLLLLLLLeeeerrrriiiidddd information.  Since the CCCCAAAALLLLLLLLeeeerrrriiiidddd
  741.      information might be bogus, all e-mail notifications are sent using a
  742.      null reverse path.  This will prevent error messages from being generated
  743.      by the mail system if a bogus address is used for e-mail notification.
  744.  
  745.      If the server does not receive a CCCCAAAALLLLLLLLeeeerrrriiiidddd command (sent by the QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee
  746.      client unless -f"" is specified on the command line) notification
  747.      messages will not be sent, regardless of the specified service level.
  748.  
  749.      When the ----mmmm flag is used to send a high-priority page, the status
  750.      notification is sent to the return address in the original e-mail message
  751.      unless overridden by the ----ffff option.
  752.  
  753.      The length of SNPP commands is limited only by the amount of memory
  754.      available to QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee....
  755.  
  756.      QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee uses a timeout of 255 seconds while waiting for a connection
  757.      from the remote modem.  This allows the administrator to specify an
  758.      appropriate timeout by setting the modem's S7 register in the dial
  759.      command.
  760.  
  761.      The modem must control the CD (carrier-detect) line.  Otherwise, the
  762.      on/off hook status of the modem cannot be determined.  This is especially
  763.      important if more than one paging service is used since QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee must be
  764.      able to detect when it's safe to send dial commands to the modem.
  765.  
  766. FFFFIIIILLLLEEEESSSS
  767.      /etc/qpage.cf
  768.  
  769. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  770.      RRRRFFFFCCCC----1111888866661111
  771.  
  772. KKKKNNNNOOOOWWWWNNNN BBBBUUUUGGGGSSSS
  773.      Pages are not queued on the client side.  As a result, if no servers are
  774.      available to the client at the time a page is submitted, an error message
  775.      is printed and the page is discarded.
  776.  
  777.      Pages received after a queue run has started will not be processed until
  778.      the following queue run.
  779.  
  780.      The default service requires a phone keyword (just like the rest of the
  781.      service definitions), even if no pager entries specifically reference the
  782.      default service.
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.                                                                        PPPPaaaaggggeeee 11112222
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796. QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee((((1111))))                                                      QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee((((1111))))
  797.  
  798.  
  799.  
  800.      Please send bug reports to tomiii@qpage.org.
  801.  
  802. AAAAUUUUTTTTHHHHOOOORRRR
  803.      QQQQuuuuiiiicccckkkkPPPPaaaaggggeeee was written by Thomas Dwyer III <tomiii@qpage.org> and is
  804.      provided to the internet community free of charge.
  805.  
  806.      Copyright (c) 1995-1998 Thomas Dwyer III
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.                                                                        PPPPaaaaggggeeee 11113333
  856.  
  857.  
  858.  
  859.