home *** CD-ROM | disk | FTP | other *** search
/ Complete Linux / Complete Linux.iso / docs / apps / database / ingres04.lzh / doc / unix / ingres.doc < prev    next >
Encoding:
Text File  |  1992-11-19  |  7.3 KB  |  140 lines
  1.  
  2.  
  3.  
  4.  
  5.      INGRES(UNIX)                 3/14/79                 INGRES(UNIX)
  6.  
  7.  
  8.  
  9.      NAME
  10.           ingres - INGRES relational data base management system
  11.  
  12.      SYNOPSIS
  13.           _i_n_g_r_e_s [ _f_l_a_g_s ] dbname [ process_table ]
  14.  
  15.      DESCRIPTION
  16.           This is the UNIX command which is  used  to  invoke  INGRES.
  17.           Dbname  is  the name of an existing data base.  The optional
  18.           flags have the following meanings (a ``+_''  means  the  flag
  19.           may  be stated ``+_x'' to set option _x or ``-_x'' to clear op-
  20.           tion _x.  ``-'' alone means that ``-_x'' must be stated to get
  21.           the _x function):
  22.  
  23.           +_U        Enable/disable direct update of the  system  rela-
  24.                     tions  and  secondary indicies.  You must have the
  25.                     000004 bit in the status field of the  users  file
  26.                     set  for this flag to be accepted.  This option is
  27.                     provided for  system  debugging  and  is  strongly
  28.                     discouraged for normal use.
  29.           -uname    Pretend you are the  user  with  login  name  _n_a_m_e
  30.                     (found in the users file).  If _n_a_m_e is of the form
  31.                     :_x_x, _x_x is the two character user code of a  user.
  32.                     This  may only be used by the DBA for the database
  33.                     or by the INGRES superuser.
  34.           -cN       Set the minimum field width for printing character
  35.                     domains to _N.  The default is 6.
  36.           -ilN      Set integer output field width to _N.  _l may be  1,
  37.                     2, or 4 for i1's, i2's, or i4's repectively.
  38.           -flxM.N   Set floating point output field width to _M charac-
  39.                     ters  with  _N  decimal places.  _l may be 4 or 8 to
  40.                     apply to f4's or f8's respectively.  _x may  be  _e,
  41.                     _E,  _f,  _F, _g, _G, _n, or _N to specify an output for-
  42.                     mat.  _E is exponential form, _F is  floating  point
  43.                     form,  and  _G  and _N are identical to _F unless the
  44.                     number is too big to fit in that field, when it is
  45.                     output  in  _E format.  _G format guarantees decimal
  46.                     point alignment; _N does not.  The  default  format
  47.                     for both is _n_1_0._3.
  48.           -vX       Set the column seperator for retrieves to the ter-
  49.                     minal  and print commands to be _X.  The default is
  50.                     vertical bar.
  51.           -rM       Set modify mode on the _r_e_t_r_i_e_v_e command to  _M.   _M
  52.                     may  be  _i_s_a_m,  _c_i_s_a_m,  _h_a_s_h,  _c_h_a_s_h, _h_e_a_p, _c_h_e_a_p,
  53.                     _h_e_a_p_s_o_r_t, or _c_h_e_a_p_s_o_r_t, for ISAM, compressed ISAM,
  54.                     hash   table,   compressed   hash   table,   heap,
  55.                     compressed heap, sorted heap, or compressed sorted
  56.                     heap.  The default is ``cheapsort''.
  57.           -nM       Set modify mode on the _i_n_d_e_x command to _M.  _M  can
  58.                     take  the  same  values as the -_r flag above.  De-
  59.                     fault is ``isam''.
  60.           +_a        Set/clear the autoclear  option  in  the  terminal
  61.                     monitor.  It defaults to set.
  62.           +_b        Set/reset batch update.  Users must the 000002 bit
  63.                     set in the status field of the users file to clear
  64.                     this flag.   This  flag  is  normally  set.   When
  65.                     clear,  queries  will  run slightly faster, but no
  66.                     recovery can take place.  Queries which  update  a
  67.                     secondary  index  automatically  set this flag for
  68.                     that query only.
  69.           +_d        Print/don't print the dayfile.  Normally set.
  70.           +_s        Print/don't print any of the monitor messages, in-
  71.                     cluding  prompts.  This flags is normally set.  If
  72.                     cleared, it also clears the -_d flag.
  73.           +_w        Wait/don't wait for the database.  If the +_w  flag
  74.                     is  present, INGRES will wait if certain processes
  75.                     are running (purge,restore, and/or sysmod) on  the
  76.                     given   data   base.   Upon  completion  of  those
  77.                     processes INGRES will proceed.  If the -_w flag  is
  78.                     present,  a  message  is  returned  and  execution
  79.                     stopped if the data base is not available.  If the
  80.                     +__w  flag  is omitted and the data base is unavail-
  81.                     able, the error message is returned if  INGRES  is
  82.                     running  in foreground (more precisly if the stan-
  83.                     dard input is from a terminal), otherwise the wait
  84.                     option is invoked.
  85.  
  86.           _P_r_o_c_e_s_s__t_a_b_l_e is the pathname of a UNIX file  which  may  be
  87.           used  to specify the run-time configuration of INGRES.  This
  88.           feature is intended for use in system maintenance only,  and
  89.           its  unenlightened  use  by  the  user community is strongly
  90.           discouraged.
  91.  
  92.           Note: It  is  possible  to  run  the  monitor  as  a  batch-
  93.           processing interface using the `<', `>' and `|' operators of
  94.           the UNIX  shell,  provided  the  input  file  is  in  proper
  95.           monitor-format.
  96.  
  97.      EXAMPLE
  98.           ingres demo
  99.           ingres -d demo
  100.           ingres -s demo < batchfile
  101.           ingres -f4g12.2 -i13 +b -rhash demo
  102.  
  103.      FILES
  104.           .../files/users - valid INGRES users
  105.           .../data/base/* - data bases
  106.           .../datadir/* - for compatability with previous versions
  107.           .../files/proctab8 - runtime configuration file
  108.  
  109.  
  110.      SEE ALSO
  111.           monitor(quel)
  112.  
  113.      DIAGNOSTICS
  114.           Too many options to INGRES - you have stated too many  flags
  115.               as INGRES options.
  116.           Bad flag format - you have stated a flag in a  format  which
  117.               is not intelligible, or a bad flag entirely.
  118.           Too many parameters - you have given a database name, a pro-
  119.               cess  table  name,  and  ``something else'' which INGRES
  120.               doesn't know what to do with.
  121.           No database name specified
  122.           Improper database name - the database name is not legal.
  123.           You may not access database _n_a_m_e - according  to  the  users
  124.               file, you do not have permission to enter this database.
  125.           You are not authorized to use  the  _f_l_a_g  flag  -  the  flag
  126.               specified requires some special authorization, such as a
  127.               bit in the users file, which you do not have.
  128.           Database _n_a_m_e does not exist
  129.           You are not a valid INGRES user - you have not been  entered
  130.               into  the  users  file, which means that you may not use
  131.               INGRES at all.
  132.           You may not specify this process table - special  authoriza-
  133.               tion is needed to specify process tables.
  134.           Database temporarily unavailable - someone else is currently
  135.               performing some operation on the database which makes it
  136.               impossible for you  to  even  log  in.   This  condition
  137.               should disappear shortly.
  138.  
  139.  
  140.