---------------------------------------------------------------------- VisualAge Generator Templates V2.2 fixpak 2 ---------------------------------------------------------------------- Ref MD 100 OS2 V6 ---------------------------------------------------------------------- README.TXT Topics: ------ - What's new in fixpak 2 - What's new in fixpak 1 - Contents - Procedures ---------------------------------------------------------------------- What's new in fixpak 2 ---------------------------------------------------------------------- INFORMATION MODEL AND WORKSTATION --------------------------------- . (2.2) New attributes allowing you to specify whether a Relational View can have updates, inserts, or deletes. These attributes are initialized by the import utility but you can modify them. . (2.2) You can modify the SQL Qualifier on Relational Tables . Extra values for thousand separator: ' ' (space), '' (empty string) IMPORT ------ . (2.1) Import user interface allows you to specify selection criteria on qualifier, table identifier and type (table/view) . Initialization of DataElement Display Name attribute When a new DataElement is created its Display Name is initialized with the contents of its identifier: - all letters are lower-case, except the first one and the first letter after an "underscore", - all "underscores" are removed . Initialization of DataElement Default Value Mode attribute - If a DB2 column is "with default", the corresponding DataElement Default Value Mode is set to "system", otherwise it is set to "none" - When a DataElement is reused or re-imported, if there are differences on this topic between corresponding columns, or between database and the specified Default Value Mode, this attribute is set to the more specific value ("constant" > "system" > "none") . DB2/400: the import utility runs properly (some memory problems that occurred previously in the standard version of the product have been fixed) . DB2/MVS: the import utility properly accesses all the tables of a DB2 sub-system GENERATORS ---------- . (2.1) Generators manage authorized accesses on views (insert/update/delete) . New methods are provided: they are used in standard generators to manage textual attributes of the Information Model. Their standard implementation calls the corresponding getters of the Information Model API. By redefinition, you can customize the processing of textual attributes. TARGET ENTITIES --------------- . You can now remove and add connections without problems. CUSTOMIZATION ------------- . You can now properly package your Smalltalk extensions of the "*Extension" generation classes. ---------------------------------------------------------------------- What's new in fixpak 1 ---------------------------------------------------------------------- WORKSTATION ----------- . The Product Information Window has been resized (previously the Copyright line was hidden) . Window Notebook: an erroneous choice has been removed from the available values in the "Layout type" column IMPORT ------ . The Import Utility doesn't initialize the DataElement default labels any more. The layout generator uses: - for lists: the column label or, if empty the default label or, if empty the display name or, if empty the identifier - for details: the default label or, if empty the display name or, if empty the identifier (with the previous behaviour of the Import Utility, the customization of the display name had no effect). GENERATED APPLICATIONS ---------------------- - Window: . An empty communication Record is shared by all the windows and business objects, and passed to the servers. - Business Object part: . A BO can include more than 30 fields (previously the limit was due to generated Statement Group that was too large) . BO new event: APIcheckSucceeded . BO new attributes: APIzoomAvailable (enable when zoom is available) . BO new actions: - APIsetSelectedInstance (set attributes: APIselectedInstance and APIselectedInstance data) - APIzoom (fills detail data with selected instance and displays it) APIzoom action is triggered on defaultActionRequested event . BO new hook: XXXSO-U-SRV-HOOK after returning from single row server XXXSO-N-SRV-HOOK after returning from multi-row server XXXSO-DEF-HOOK after the XXXSO-TO-DEFAULT Statement Group - Miscellaneous . Generation of "level-77" data-items in some generated records . "Notify on each key stroke" set only for key fields . Timestamp read again after an update (fixes a bug occurring on the second update on BOs with customized join condition) . In SQL update order, columns are not qualified any longer (MVS compatibility) API AVAILABLE FOR GENERATORS ---------------------------- In this version, methods belonging to categories suffixed by "_API110" should be considered as "internal": they can be modified or removed in a further version without notification (however, extended API on Target Entities, though belonging to such categories, is actually running and virtually stabilized). ONLINE DOCUMENTATION -------------------- . All books are upgraded . Reference Guide is now divided in 2 .boo files (previously 3) ---------------------------------------------------------------------- CONTENTS ---------------------------------------------------------------------- VAG Templates is installed in the following directories: -------------------------------------------------------- - VAG Templates root directory MDLROOT, with sub-directories: - build : where ESF files will be generated (default) - books : softcopy documentation - doc : introduction to the product and the generated application architecture - standard : the product as a stand-alone application (that may run without Visual Age Smalltalk installed) - VAG Templates storage directory (example: C:\VAGT\STORE): directory containing the specification files (must be HPFS) - Notice: - VAG Templates root directory will be referred to as MDLROOT - VAG Templates storage directory will be referred to as MDLSTORE - VA Smalltalk directory will be referred to as VASTROOT - VA Smalltalk installation directory will be referred to as VASTCTL - VA Smalltalk import directory will be referred to as VASTIMP (see #AbtInstallationDirectory and #AbtImportDirectory - the following should be present in VASTROOT\abt.cnf: ... "Installation globals" "This is where we find the *.ctl files." Smalltalk at: #AbtInstallationDirectory put: 'c:\vag_smtk\feature'! "This is where we find the *.dat files of the import server. This path MUST include a trailing path separator." Smalltalk at: #AbtImportDirectory put: 'c:\vag_smtk\import\'! ...) VAG Templates special files are: -------------------------------- MDLROOT\mdl.cnf: Startup file read when Opening or Customizing the Workstation (stand-alone or feature), where the following are specified: - the repository root directories: directories from which sub-directories will be considered as Workspace candidates - the VA/ST installation directory (used for VAG Templates repackaging) MDLROOT\mdl.log: Log file for the product (you can check VAG Templates' version in it) Files included in the complete version are: ------------------------------------------- MDLROOT\build: empty directory MDLROOT\books: vagte10.bks mdline10.boo mdluse10.boo mdlr1e10.boo mdlr2e10.boo MDLROOT\doc: appl_sod.doc : Generated Applications General Architecture gn_orga.doc : Generated Applications Organic Documentation MDLROOT\standard: This is the version of the product that can be used on a machine that does not have VisualAge for Smalltalk installed. A lighter version is installed if you have Visual Age Smalltalk installed. mdl.exe mdl.img mdlgfe10.mpr mdlime10.mpr mdlmee10.mpr mdlrie10.mpr mdlsge10.mpr mdlvee10.mpr mdlwse10.mpr mdlbmps.dll mdlicons.dll mdlhelp.hlp ABTARE30.mpr ABTBAE30.mpr ABTDBE30.mpr ABTRIE30.mpr CURSORS.OBJ RGB.TXT abtbmp30.dll abtdc30.bnd abtdc30.dll abtdnc30.bnd abtdnc30.dll abtdrag.dll abtdso30.bnd abtdso30.dll abtprm30.dll escgi30.dll esdec30.dll esmem30.dll esswp30.dll estks30.dll esvm30.dll nls.cnf *.cat MDLSTORE: empty directory This is where specification files contained in MDLROOT\sample\sample2 are copied. VASTCTL: This is where VAG Templates loadable feature control files are installed. VASTIMP: This is where VAG Templates loadable feature binary files are installed. ---------------------------------------------------------------------- PROCEDURES ---------------------------------------------------------------------- Fixpak requirements: - before installing VAG Templates fixpak, you should have installed VAG Templates 2.2. 1 - Installation: 1 - set the current directory to the directory that contains the product installation files 2 - type 'install' WARNING: in this version the installation utility does not upgrade the LIBPATH variable in the CONFIG.SYS file. To avoid any problem, it is strongly recommended to add the path \standard to the LIBPATH variable in the CONFIG.SYS file. Next step could be 2a or 2b. 2a- Start VAG Templates standard version: cd MDLROOT\standard mdl or use icon in folder VAG Templates. 2b- Load and start VAG Templates feature version: To avoid any load problem it is recommended that a new image be used. - Before loading VAG Templates feature you should: - check that VASTROOT and VASTROOT\MPR do not contain any mdl*10.mpr files. - load feature 'IBM database' - load feature 'Odbc database' - Load VAG Templates in your environment by selecting Visual Age Organizer -> Options -> Load Features and choosing '(3.0) VAG Templates V2.2 fixpak 2.' or '(3.0a) VAG Templates V2.2 fixpak 2.' according to the version of VA Smalltalk that you are using. - start VAG Templates workstation by selecting System Transcript -> Model tools -> Open Workstation 3 - If you have written new generators in the feature version and want to incorporate them in the standard version: - select System Transcript -> Model Tools -> Customize Workstation - select the generators you want to use - click on Package Workstation (this will generate files VASTROOT\md1cus1.app and VASTROOT\md1cus2.app, copy them into MDLROOT\standard, and generate file MDLROOT\standard\abtapp.cnf) - start VAG Templates; the workstation will import the two files; and then save the image before exiting - delete file MDLROOT\standard\abtapp.cnf - start VAG Templates again; your new generators will be present in the workstation Notice: you may want to make a backup copy of MDLROOT\standard\mdl.img before this step; if you do not, you can still recover by re-installing the standard version only. The following is an attached File item from cc:Mail. It contains information that had to be encoded to ensure successful transmission through various mail systems. To decode the file use the UUDECODE program.