Google
 

Trailing-Edge - PDP-10 Archives - BB-H548B-BM - iql-documentation/iql3a.doc
There is 1 other file named iql3a.doc in the archive. Click here to see a list.
IQL3A.DOC -- Changes from V3 to V3A                               Page 1


COPYRIGHT (C) 1976,1977,1978,1979 BY
DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS.


THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE  USED  AND  COPIED
ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND WITH THE INCLUSION
OF THE ABOVE COPYRIGHT  NOTICE.   THIS  SOFTWARE  OR  ANY  OTHER  COPIES
THEREOF  MAY  NOT  BE  PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY OTHER
PERSON.   NO  TITLE  TO  AND  OWNERSHIP  OF  THE  SOFTWARE   IS   HEREBY
TRANSFERRED.

THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE AND
SHOULD   NOT   BE   CONSTRUED  AS  A  COMMITMENT  BY  DIGITAL  EQUIPMENT
CORPORATION.

DIGITAL ASSUMES NO RESPONSIBILITY FOR THE  USE  OR  RELIABILITY  OF  ITS
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL.
IQL3A.DOC -- Changes from V3 to V3A                               Page 2


1.0  SUMMARY

IQL is a joint product of Digital Equipment Corporation and AZREX, INC.


IQL Version 3A is a maintenance  release  of  IQL  Version  3.   Several
outstanding  bugs  are corrected in this release, and some new DBMS FIND
record selection expressions are supported.

IQL3A runs under release 3 and 3A of TOPS-20 and under release  6.03  or
later of TOPS-10.  It has been tested in-house under 3A and 7.01.

IQL3A has been compiled and tested with COBOL/LIBOL V12.  It  will  also
work  with V12A, but will have to be recompiled.  See IQL3A.BWR for more
details.  IQL3A also requires SORT V4 for TOPS-20 or SORT V3A or  4  for
TOPS-10.  It is loaded with LINK V3A or higher.



2.0  EXTERNAL CHANGES

2.1  Functional Changes

     1.  IQSCH now works correctly.  The R  (Replace)  update  code  now
         works   correctly.    There   are   some   differences  in  the
         dictionaries generated by IQSCH V3 and V3A, which are described
         in detail in the .BWR file.

     2.  IQL3A will accept  lower-case  commands  and  convert  them  to
         upper-case.   There  are  some  other considerations concerning
         upper and lower case which are described in the .BWR file.

     3.  Most IQL modules are now loaded to use the  sharable  reentrant
         LIBOL  (LIBO12.EXE).   See  the .BWR file for details on how to
         build IQL completely using reentrant LIBOL.

     4.  FIND statements which result in  a  FIND  of  the  SYSTEM  DBMS
         record  now  work correctly.  It is no longer necessary to do a
         FIND rse 3 before doing a FIND rse 1 or FIND rse 5.

     5.  The extension of saved queried has been changed  from  .QRY  to
         .INQ   to   avoid   conflict  with  TOPS-20  EDIT  backup  file
         extensions.  It will be necessary  to  rename  *.QRY  to  *.INQ
         under both TOPS-10 and TOPS-20.

     6.  IQL3A uses a universal password to protect access to changes in
         any  dictionaries which include passwords ton data items.  This
         password will also allow access to any data item  protected  by
         any  password.   The  distributed  password  can  be changed by
         changing  the  value  of   the   working-storage   item   named
         UNIVERSAL-PASSWORD  in  COBOL  modules  IQA, IQD, IQL, and IQU.
         For convenience, it is positioned as the first data item in the
         WORKING-STORAGE SECTION of these programs.
IQL3A.DOC -- Changes from V3 to V3A                               Page 3


2.2  Functional Additions

     1.  Most of the DBMS FIND  rse's  now  work.   See  .BWR  for  more
         details.

     2.  DBMS records may  now  have  any  SCHEMA-allowable  mixture  of
         COMPUTATIONAL,  DISPLAY-6, and DISPLAY-7 item types (mixing all
         three in the same record is not allowed in DBMS).

     3.  There are several new pre-defined item names pertaining to DBMS
         usage.  They are:

         1.  ERROR-COUNT -- a numeric item which is  set  to  0  if  the
             just-completed  DBMS FIND/GET was successful, and is set to
             non-0 if an error occurred.

         2.  ERROR-STATUS -- a numeric item which is set  to  the  error
             status  retuned  by DBMS in case of errors, and is set to 0
             if no error occurred.

         3.  RECORD-NAME -- an alpha item which returns the ASCII record
             name of the last record successfully found/gotten.

         4.  AREA-NAME -- an alpha item which  returns  the  ASCII  area
             name of the last record successfully found/gotten.

         5.  CURRENT-RECORD-KEY -- a  numeric  item  which  returns  the
             encoded  data  base  key  of  the  last record successfully
             found/gotten.

         6.  AREA-ID -- an alpha item which is set by the programmer  to
             to the ASCII area name of records which are to be found via
             rse 5.  This is the only instance where it should be used.


     4.  The REWRITE verb now works correctly when used in  a  query  to
         replace   an   existing  ISAM  record.   Caution,  however,  is
         recommended when using this verb that your data  files  are  in
         fact being correctly updated.

     5.  A panic interrupt feature is available to  TOPS-20  IQL  users.
         See file SETINT.MEM for more details.




3.0  KNOWN BUGS AND DEFICIENCIES

See IQL3A.BWR for a list of known bugs.
IQL3A.DOC -- Changes from V3 to V3A                               Page 4


4.0  INSTALLATION INSTRUCTIONS

See IQLINS.CTL and IQL3A.MEM for installation instructions.



5.0  INTERNAL CHANGES

Major rewrite of DBMS modules.




[End of IQL3A.DOC]