pm˜ F„¤Fm›˜ —z›¨˜ m'›"dd"›apm˜%˜ pmOaV - Public Support Login ...
pm˜ F„¤Fm›˜ —z›¨˜ m'›"dd"›apm˜%˜ pmOaV - Public Support Login ...
pm˜ F„¤Fm›˜ —z›¨˜ m'›"dd"›apm˜%˜ pmOaV - Public Support Login ...
You also want an ePaper? Increase the reach of your titles
YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.
LINC on Sequent)<br />
DYNIX/ptx)<br />
Installation and Configuration<br />
Guide<br />
July 1998<br />
v
!()+<br />
LINC on Sequent)<br />
DYNIX/ptx)<br />
Installation and Configuration<br />
Guide<br />
Copyright ( 1998 Unisys Corporation.<br />
All rights reserved.<br />
Unisys is a registered trademark of Unisys Corporation.<br />
LINC is a registered trademark of Unisys Corporation.<br />
Griffin is a trademark of Unisys Corporation.<br />
Sequent is a registered trademark of Sequent Computer Systems Inc.<br />
DYNIX/ptx is a registered trademark of Sequent Computer Systems Inc.<br />
Release 16.3 July 1998<br />
v
The names, places, and/or events used in this publication are not intended to correspond to any<br />
individual, group, or association existing, living, or otherwise. Any similarity or likeness of the names,<br />
places, and/or events with the names of any individual living or otherwise is purely coincidental and<br />
unintentional.<br />
NO WARRANTIES OF ANY NATURE ARE EXTENDED BY THIS DOCUMENT. Any product and related<br />
material disclosed herein are only furnished pursuant and subject to the terms and conditions of a duly<br />
executed Program Product License or Agreement to Purchase or Lease Equipment. The only warranties<br />
made by Unisys, if any, with respect to the products described in this document are set forth in such<br />
License or Agreement. Unisys cannot accept any financial or other responsibilities that may be the<br />
result of your use of this information or software material, including direct, indirect, special or<br />
consequential changes.<br />
You should be very careful to ensure that the use of this information and/or software material complies<br />
with the laws, rules, and regulations of the jurisdictions with respect to which it is used.<br />
The information contained herein is subject to change without notice. Revisions may be issued to advise<br />
of such changes and/or additions.<br />
RESTRICTED. Use, reproduction, or disclosure is subject to the restrictions set forth in DFARS<br />
252.227-7013 and FAR 52.227-14 for commercial computer software.<br />
TRADEMARKS. All other terms mentioned in this book that are known to be trademarks or service marks<br />
have been appropriately capitalized. Unisys Corporation cannot attest to the accuracy of this<br />
information. Use of a term in this book should not be regarded as affecting the validity of any trademark<br />
or service mark.<br />
Correspondence regarding this publication should be forwarded using the Business Reply Mail form at<br />
the back of this document to:Australian Centre for Unisys Software, 115 Wicks Road, North Ryde NSW<br />
2113, AUSTRALIA. Alternatively you can send an E-Mail message to: linc.pi@unisys.com<br />
MicroFocus is a registered trademarks of MicroFocus Ltd.<br />
ORACLE is a registered trademark of Oracle Corporation.<br />
SQL*Plus is a registered trademark of Oracle Corporation.<br />
UNIX is a registered trademark of X/Open Company Ltd.
Contents<br />
About This Document :::::::::::::::::::::::::::::::::::::::::: vii<br />
Section 1. Preparing for Installation of LINC Software<br />
Overview :::::::::::::::::::::::::::::::::::::::::: 1-1<br />
About Object Packaging :::::::::::::::::::::::::::::: 1-1<br />
Required Hardware ::::::::::::::::::::::::::::::::: 1-2<br />
Configuring the UNIX Kernel :::::::::::::::::::::::::: 1-3<br />
Required Software :::::::::::::::::::::::::::::::::: 1-5<br />
Section 2. Installing LINC Deployment Executables<br />
Overview :::::::::::::::::::::::::::::::::::::::::: 2-1<br />
Contents of the LINC Deployment CD-ROM ::::::::::::: 2-1<br />
Pre-Installation Requirements ::::::::::::::::::::::::: 2-2<br />
Starting the Installation of LINC Deployment Executables : 2-3<br />
Supplying Details for LINC Deployment Executables ::::: 2-3<br />
Validation Checks Performed during Installation ::::::::: 2-5<br />
Defining Environment Variables ::::::::::::::::::::::: 2-5<br />
Setting Up the LINC Tidy Up Script :::::::::::::::::::: 2-5<br />
Section 3. Installing LINC Generate Executables<br />
Overview :::::::::::::::::::::::::::::::::::::::::: 3-1<br />
Contents of the LINC Generate CD-ROM :::::::::::::::: 3-1<br />
Pre-Installation Requirements ::::::::::::::::::::::::: 3-2<br />
Starting the Installation of LINC Generate Executables ::: 3-3<br />
Supplying Details for LINC Generate Executables :::::::: 3-3<br />
After Installation Is Complete ::::::::::::::::::::::::: 3-6<br />
v iii
Contents<br />
Section 4. Maintaining Your LINC Environment<br />
Overview ::::::::::::::::::::::::::::::::::::::::::: 4-1<br />
Typical LINC Environments ::::::::::::::::::::::::::: 4-1<br />
Installing LINC Deployment Objects :::::::::::::::::::: 4-3<br />
Pre-Installation Requirements ::::::::::::::::::: 4-3<br />
Starting the Installation of LINC Deployment Objects : 4-3<br />
Supplying Details for LINC Deployment Objects ::::: 4-4<br />
Installing LINC Generate Objects :::::::::::::::::::::: 4-4<br />
Pre-Installation Requirements ::::::::::::::::::: 4-4<br />
Starting the Installation of LINC Generate Objects ::: 4-5<br />
Supplying Details for LINC Generate Objects :::::: 4-5<br />
The Product Menu Utility ::::::::::::::::::::::::::::: 4-6<br />
The EIF Installation Menu ::::::::::::::::::::::::::::: 4-8<br />
Applying EIFs ::::::::::::::::::::::::::::::::::::::: 4-9<br />
Applying a Validation EIF ::::::::::::::::::::::: 4-9<br />
Applying Other EIFs :::::::::::::::::::::::::: 4-10<br />
Uninstalling an EIF ::::::::::::::::::::::::::: 4-11<br />
Building Executables ::::::::::::::::::::::::::::::::: 4-12<br />
Building Executables During Installation ::::::::::: 4-12<br />
Building Executables with Product Menu :::::::::: 4-12<br />
Creating a Package for Distribution :::::::::::::::::::: 4-13<br />
Creating a Package :::::::::::::::::::::::::: 4-14<br />
Removing a Spooled Package :::::::::::::::::: 4-14<br />
Appendix A. Configuring and Tuning ORACLE and Griffin for<br />
LINC Software<br />
Overview ::::::::::::::::::::::::::::::::::::::::::: A-1<br />
Planning Your ORACLE SIDs and Griffin Universes ::::::: A-2<br />
Choosing the Number of ORACLE SIDs and Griffin<br />
Universes ::::::::::::::::::::::::::::::: A-2<br />
Choosing Names for ORACLE SIDs and Griffin<br />
Universes ::::::::::::::::::::::::::::::: A-2<br />
Choosing Names and Sizes of Tablespaces and<br />
Database Files ::::::::::::::::::::::::::: A-3<br />
Creating ORACLE SIDs ::::::::::::::::::::::::::::::: A-4<br />
Before You Start ::::::::::::::::::::::::::::: A-4<br />
Guidelines for Creating ORACLE SIDs :::::::::::: A-4<br />
Creating an ORACLE SID :::::::::::::::::::::: A-6<br />
Creating Griffin Universes :::::::::::::::::::::::::::: A-8<br />
Before You Start ::::::::::::::::::::::::::::: A-8<br />
Guidelines for Creating Griffin Universes :::::::::: A-8<br />
iv v
Glossary<br />
Index<br />
Contents<br />
Creating a Griffin Universe ::::::::::::::::::::: A-10<br />
Tuning ORACLE SIDs ::::::::::::::::::::::::::::::::: A-12<br />
Default Configuration of ORACLE SIDs :::::::::::: A-12<br />
Tuning the Configuration of ORACLE SIDs ::::::::: A-12<br />
Allowing for Cursors :::::::::::::::::::::::::: A-15<br />
Changing LINC Structures in Tablespaces ::::::::: A-16<br />
Tuning Griffin Universes :::::::::::::::::::::::::::::: A-17<br />
Tuning the Configuration of Griffin Universes ::::::: A-17<br />
Tuning Griffin ::::::::::::::::::::::::::::::: A-18<br />
Changing LINC Structures in Tablespaces ::::::::: A-21<br />
v v
About This Document<br />
Purpose<br />
Scope<br />
Audience<br />
This document provides information and instructions for the installation and configuration<br />
of LINC software on the Sequent hosts.<br />
This document provides step-by-step instructions for installing and configuring LINC<br />
software at your site.<br />
Additional information is contained in your LINC Administration and Operations Guide<br />
for the UNIX Operating System, andinLate-Breaking Changes, available from the LINC<br />
<strong>Support</strong> Web page at http://www.support.unisys.com/. This information must be used in<br />
conjunction with this document.<br />
The primary audience for this document consists of those responsible for the installation<br />
of LINC software.<br />
A secondary audience consists of LINC System designers who need to understand<br />
operational aspects of LINC Systems that may be pertinent to their design considerations.<br />
Prerequisites<br />
The primary audience is presumed to have had training in installing, implementing, and<br />
operating LINC Systems, and to be familiar with the operational aspects of the Sequent<br />
host. The secondary audience should be trained in developing LINC Systems.<br />
How to Use This Document<br />
Read section 1, which gives an overview of LINC software environments and installation,<br />
and lists installation prerequisites. Then read the introductory paragraphs at the start of the<br />
following sections to gain a basic understanding of the layout and scope of this document.<br />
Read sections 2 and 3 to install supplied LINC software executable packages.<br />
v vii
About This Document<br />
Read section 4 to install supplied LINC software object packages, to build LINC<br />
executables from supplied LINC software object packages, to create object and executable<br />
packages, and to apply Engineering Interim Fixes (EIFs).<br />
As part of the installation process, you must also read the Late-Breaking Changes,<br />
available from the LINC <strong>Support</strong> Web page at http://www.support.unisys.com/.<br />
Organization<br />
Notations<br />
Caution<br />
If you are migrating a system from a previous release of LINC, it is important that<br />
you refer to your LINC Release 16.3/16R3 Migration and Conversion Guide.<br />
This document contains four sections and an appendix.<br />
Section 1. Preparing for Installation of LINC Software<br />
This section describes the preparation required before LINC software can be installed. It<br />
includes configuration of the host and software requirements.<br />
Section 2. Installing LINC Deployment Executables<br />
This section describes the installation of LINC Deployment Executables.<br />
Section 3. Installing LINC Generate Executables<br />
This section describes the installation of LINC Generate executables.<br />
Section 4. Maintaining Your LINC Environment<br />
This section describes typical LINC environments, the installation of LINC software object<br />
packages, the building of LINC executables, the creation of LINC object and executable<br />
packages, and the application of Engineering Interim Fixes (EIFs).<br />
Appendix A. Configuring and Tuning ORACLE and Griffin for LINC Software<br />
This section describes the configuration of ORACLE and Griffin for use with LINC.<br />
In this document, and throughout the LINC documentation, ORACLE SID is used in place<br />
of the term database that is used in ORACLE documentation. LINC documentation uses<br />
database in a different context.<br />
viii v
Related Product Information<br />
About This Document<br />
The following publications contain information relevant to the definition and operation of<br />
a LINC System. These publications are reference sources for users who have completed<br />
LINC training courses. See your local Unisys representative for information on available<br />
LINC training courses.<br />
Most of these documents are published by Unisys Corporation and can be ordered through<br />
Plymouth Operations Software Manufacturing (POSM), or your local Unisys subsidiary.<br />
LINC documents without part numbers in the following list are included on the LINC<br />
Deployment CD.<br />
In addition to these documents, you may require documentation specific to your Sequent<br />
host to describe the operation of the related software.<br />
LINC Administration and Operations Guide for the UNIX Operating System<br />
This document describes the generation and operation of LINC Systems and Reports, and<br />
the general administration of LINC Systems.<br />
LINC Generate Operations Guide<br />
This document describes the use of LINC Generate to create and maintain user<br />
information systems.<br />
LINC Programming Reference Manual<br />
This document contains reference material for developers, such as LINC Logic commands<br />
and System Data items used in creating LINC Systems.<br />
LINC Generate Reference Manual: Painter and Editor<br />
This document contains reference material for LINC Generate, including LINC Editor and<br />
LINC Painter commands, Data commands and Data Attributes, and screens and commands<br />
for defining Profiles.<br />
LINC Programming Reference Handbook(7844 8057)<br />
This document contains the syntax of LINC Logic commands and System Data items and<br />
other commands used in LINC Generate.<br />
LINC Ad Hoc Inquiry Operations Guide<br />
This document describes the operation of LINC Ad Hoc Inquiry, which enables users to<br />
make inquiries against a LINC System, either interactively, or by using structured (SQL)<br />
statements.<br />
LINC Developers Guide: LCOPY<br />
This document provides reference material for using the LINC LCOPY Utility, which is<br />
used to transfer LINC Specifications between versions of LINC Generate.<br />
v ix
About This Document<br />
LINC Executive Overview - The Business Case (7833 2145)<br />
This document is an introduction to LINC for executive and general readers.<br />
LINC Technical Overview - The Business Case (7833 2152)<br />
This document is an overview of LINC features and facilities for more technically oriented<br />
readers.<br />
Griffin Data Engine Installation and Administration Guide<br />
This document describes the installation and administration of the Griffin database<br />
management system used with LINC Systems.<br />
ORACLE8 Server for Sun SPARC Solaris 2.x Installation Guide<br />
ORACLE8 Server for Sun SPARC Solaris 2.x Administrator’s Reference<br />
These documents describe the installation and administration of the ORACLE database<br />
management system used with LINC Systems.<br />
x v
Section 1<br />
Preparing for Installation of LINC<br />
Software<br />
Overview<br />
Before you install the LINC Software, you should perform the following tasks described in<br />
this section.<br />
$ Ensure the required hardware is installed.<br />
$ Ensure the required software is installed.<br />
Note: It is important that you study the Late-Breaking Changes, available from the<br />
LINC <strong>Support</strong> Web page at http://www.support.unisys.com/, before installing<br />
LINC software.<br />
About Object Packaging<br />
As of LINC Release 16.3/16R3, Deployment and Generate products are supplied as<br />
packages in two formats u ready-to-install executables and object modules. The object<br />
packages contain the entire product.<br />
You can choose to install only the executables, and you will be able to run LINC as soon as<br />
the installation finishes.<br />
You can choose to install only the object packages, and the LINC executables must be built<br />
from the objects before you can run LINC. If you select the build option during object<br />
package installation, LINC executables are built and you will be able to run LINC as soon<br />
as the installation finishes. Until the LINC executables are built, either during object<br />
package installation or afterwards, you will be unable to run LINC from this installation. If<br />
you install object packages with the build option, there is no need to install executables.<br />
Usually there is no need to install object packages unless you want to install an EIF or you<br />
want to use the Forms Translation Utility (FTU) to translate parts of the LINC software.<br />
To install LINC executable packages, see Section 2 and Section 3.<br />
To install LINC object packages, see Section 4.<br />
v 1-1
Required Hardware<br />
Engineering Interim Fixes (EIFs) are supplied in cpio format. From LINC Release<br />
16.3/16R3, EIFs are usually supplied as object modules. If the EIF contains object modules,<br />
a build is necessary. To build LINC executables that include the EIF, the object packages<br />
must be installed.<br />
A special type of EIF called a Validation EIF may be provided from time to time. Validation<br />
EIFs will allow you to build LINC with different levels of ORACLE, Griffin, Cobol, and<br />
Tuxedo (see the LINC <strong>Support</strong> Web page at http://www.support.unisys.com/ for availability<br />
of Validation EIFs). You will usually apply Validation EIFs during installation of object<br />
packages with the build option selected.<br />
You access object packaging functions through the Product Menu utility. It allows you to<br />
install EIFs and it also allows you to make backups of your LINC installation in executable<br />
package and object package formats. You should make backups after installing EIFs.<br />
Product Menu is described in Section 4.<br />
Required Hardware<br />
The following minimum hardware configuration is required to support the installation and<br />
operation of this LINC Release.<br />
$ Sequent DYNIX/ptx host.<br />
$ A CD-ROM device if you are installing from the supplied LINC executable or object<br />
packages.<br />
$ 64 Mb memory for LINC Deployment.<br />
$ 64 Mb memory for LINC Generate.<br />
$ Shared memory for ORACLE configuration. Installing LINC Software with the default<br />
ORACLE configuration requires 8 Mb for each ORACLE SID.<br />
Note: Increasing the parameters from the default ORACLE configuration<br />
may increase the shared memory requirements.<br />
$ Shared memory for Griffin configuration. Installing the LINC Software with the default<br />
Griffin configuration requires 8 Mb for each Griffin Universe.<br />
$ 70 Mb disk space for LINC Deployment executables. Approximately 30 Mb of<br />
additional space is required if object modules are installed.<br />
$ 125 Mb disk space for LINC Generate executables. Approximately 120 Mb of additional<br />
space is required if object modules are installed.<br />
$ Disk space for ORACLE SIDs and Griffin Universes. See ‘‘Creating ORACLE SIDs’’ and<br />
‘‘Creating Griffin Universes’’, in Appendix A.<br />
$ Swap space at least equal to three times the size of main memory. A more accurate<br />
estimate can be calculated from the sum of the following:<br />
v Code size of fully bound executable program.<br />
v For each server, add the cursor pool size times 50 Kb, plus the data size of the<br />
server.<br />
1-2 v
v For each requestor, add 300 Kb.<br />
Configuring the UNIX Kernel<br />
v Add 735 Kb.<br />
Determine the cursor pool size with the LINC System command :CPS. This command<br />
is described in your LINC Administration and Operations Guide for the UNIX<br />
Operating System.<br />
Determine the amount of swap space used with the UNIX command:<br />
<br />
Symptoms of insufficient swap space are:<br />
v Messages in the error log that show a fork failing.<br />
v Messages in the error log that show a return value of -1 from c_procstart.<br />
v ORACLE shadow process failing to start.<br />
Note: LINC is only qualified to run with an Oracle Dedicated Server and has not been<br />
qualified in an SQL*Net configuration. Cursor pooling has been implemented<br />
in LINC to reduce the considerable overheads that have been detected in<br />
reparsing and rebinding SQL statements.<br />
Configuring the UNIX Kernel<br />
Before installing LINC on a Sequent DYNIX/ptx host, ensure that the kernel is configured<br />
with at least the minimum values. If you wish to increase these minimum values, see your<br />
DYNIX/ptx System Administration Guide. Your Sequent DYNIX/ptx environment should<br />
be configured as Commercial or Timeshare.<br />
The following table contains suggested minimum values for the kernel of a host running<br />
LINC Systems. See also the notes following the table.<br />
Parameter Minimum Value<br />
hfszlim unlimited<br />
maxproc 150<br />
maxup 150<br />
msgmap 1024<br />
msgmax (8*1024)<br />
msgmnb (32*1024)<br />
msgmni 128<br />
msgseg 4096<br />
msgssz 32<br />
continued<br />
v 1-3
Configuring the UNIX Kernel<br />
hfszlim<br />
continued<br />
Parameter Minimum Value<br />
semmni 300<br />
semmns 512<br />
semmnu 128<br />
shmmax (See below)<br />
shmseg 10<br />
sfszlim unlimited<br />
This parameter specifies the hard limit (in bytes) for the largest file size that can be<br />
specified by sfszlim. The default size is unlimited.<br />
maxproc<br />
This parameter determines the maximum number of processes per user.<br />
For LINC, maxproc should be set to at least 150.<br />
msgmni<br />
This parameter defines the maximum number of message queues in the system.<br />
Each active LINC user and each server requires one message queue, so if the system has a<br />
large number of users, you will need to increase this value. The recommended value of<br />
msgmni is the number of users, plus the number of servers, plus 50 for the UNIX system<br />
and other applications. You can safely overestimate the required value, as the memory<br />
usage is only 52 bytes per message queue.<br />
semmni/semmns/semmnu<br />
The number of semaphores required is the number of processes specified for each<br />
ORACLE SID, plus 3 for each LINC System. See the ORACLE8 Server Administrator’s<br />
Guide and your ORACLE8 Server Installation Reference for advice on setting and altering<br />
these parameters.<br />
For Griffin, the number of semaphores required is the number of Griffin Clients for each<br />
Griffin Universe, rounded to the nearest multiple of 20. The number of Clients is specified<br />
when a Griffin Universe is created. See Appendix A for details.<br />
sfszlim<br />
This parameter specifies the soft limit (in bytes) for the largest file size that can be created<br />
by a user. The value of sfszlim cannot exceed hfszlim. The default size is unlimited.<br />
1-4 v
shmmax<br />
Required Software<br />
The amount of shared memory required will depend on the number of ORACLE SIDs and<br />
Griffin Universes that you want active simultaneously, together with the parameters used<br />
when initializing or altering each ORACLE SID or Griffin Universe, plus 0x6000 for each<br />
installed LINC System.<br />
Set this value to be at least 0xA00000.<br />
Required Software<br />
This LINC Release may be installed and run with the software configuration in the<br />
following table. Future Engineering Interim Fixes (EIFs) may provide support for<br />
additional software levels. See the LINC <strong>Support</strong> Web page at<br />
http://www.support.unisys.com/ and the EIF documentation for details. See also the<br />
comments following the table.<br />
DYNIX/ptx release 4.4.2<br />
Software<br />
MicroFocus COBOL/2 v4.1 PRN=OXUNY/ZZN:8a.1c.13.01<br />
ORACLE RDBMS 8.0.3.0<br />
ORACLE PL*SQL<br />
Griffin 4.2.2<br />
<strong>Support</strong> for standard UNIX character-mode terminals<br />
TCP/IP software<br />
Tuxedo ETP System 6.4<br />
When preparing to install LINC Software<br />
$ Your COBOL compiler must have been installed and configured before your LINC<br />
Software can be installed. To install LINC Software you need to know the COBOL<br />
compiler installation directory and the COBOL software level.<br />
$ Your ORACLE, ORACLE PL*SQL and Griffin software must have been installed and<br />
configured before LINC Software can be installed. To install LINC Software you need<br />
to know the ORACLE and Griffin installation directories, DBA usernames, and<br />
software levels. See Appendix A.<br />
Note: If you do not have a full (unrestricted) Griffin license, and you<br />
intend to use LINC Generate, you must install the restricted Griffin<br />
software from the LINC Generate CD-ROM. See your Griffin Data<br />
Engine Installation and Administration Guide for installation details.<br />
v 1-5
Required Software<br />
$ Network software is required if you intend to use PowerClient or external Automatic<br />
Entries to other hosts.<br />
$ Tuxedo is required if you intend to use On Line Transaction Processing (OLTP). To<br />
include OLTP support, you need to know the Tuxedo installation directory.<br />
1-6 v
Section 2<br />
Installing LINC Deployment Executables<br />
Overview<br />
This section describes how to install LINC Deployment Executables on Sequent hosts. You<br />
must install LINC Deployment before you set up your ORACLE SIDs and Griffin Universes,<br />
and before you install LINC Generate.<br />
This section contains the following topics:<br />
$ Contents of the LINC Deployment CD-ROM<br />
$ Pre-installation Requirements<br />
$ Starting the Installation of LINC Deployment Executables<br />
$ Supplying Details for LINC Deployment Executables<br />
$ Defining Environment Variables<br />
$ Setting Up the LINC Tidy Up Script<br />
Further parts of the installation process, such as configuring ORACLE SIDs and Griffin<br />
Universes, the installation of object packages, and the installation of LINC Generate<br />
software, are described in later sections of this document.<br />
Other considerations, such as setting up usernames and running LINC Systems, are<br />
described in your LINC Administration and Operations Guide for the UNIX Operating<br />
System.<br />
Contents of the LINC Deployment CD-ROM<br />
The LINC Deployment CD-ROM contains the following products:<br />
$ LINC Deployment Executables<br />
LINC Deployment software in executable format (approximately 70 Mb).<br />
$ LINC Deployment Objects<br />
LINC Deployment software in object format (approximately 30 Mb). See Section 4 for<br />
details about installing LINC Deployment Objects.<br />
$ LINC Documentation<br />
The LINC documentation library is supplied as online documentation in Acrobat and<br />
WinHelp format.<br />
v 2-1
Pre-Installation Requirements<br />
Pre-Installation Requirements<br />
Before you install LINC Deployment Executables<br />
1. Ensure that the required hardware and software is installed and configured. See<br />
Section 1 for details.<br />
2. Back up any LINC Systems that will use the new LINC Deployment Software.<br />
3. Ensure that you have the following information which is requested during LINC<br />
installation:<br />
$ LINC home directory ($LINCIIDIR).<br />
$ COBOL installation directory ($COBDIR).<br />
$ ORACLE DBA username and ORACLE home ($ORACLE_HOME) directory.<br />
$ Griffin DBA username and Griffin home ($GRFNDIR) directory (if you intend to<br />
use Griffin LINC Systems, such as LINC Generate).<br />
$ Tuxedo installation directory ($TUXDIR) if OLTP support is required.<br />
Note: If the location of any of the underlying support software changes,<br />
or if any of these values change, you must re-install LINC.<br />
2-2 v
Supplying Details for LINC Deployment Executables<br />
Starting the Installation of LINC Deployment<br />
Executables<br />
Note: If you are installing LINC on top of existing LINC Software, first ensure that<br />
no LINC processes using that existing software are currently running.<br />
To start the installation<br />
1. Log in to your Sequent host as a superuser.<br />
2. Insert the LINC Deployment CD-ROM into the CD-ROM drive.<br />
3. Mount the CD-ROM file system.<br />
Enter the following from the shell:<br />
<br />
Where cdrom is the mount point for the CD-ROM device.<br />
4. Install the LINC Deployment Executables from the CD-ROM.<br />
Enter the following from the shell:<br />
<br />
$ cdrom is the mountpoint for the CD-ROM device.<br />
$ deployment is the LINC Deployment package which contains LINC Deployment<br />
software.<br />
$ l2r163 is the LINC Deployment product in executable format.<br />
5. The installation process commences and displays the message<br />
Installation in progress. Do not remove the media.<br />
Processing package instance from <br />
LINC Deployment 16.3, Release <br />
Version 163.ptx (Sequent)<br />
Unisys<br />
Supplying Details for LINC Deployment Executables<br />
When the installation has started, you are asked a number of questions. To get help for a<br />
question, enter a question mark (?).<br />
If this package has been installed on this machine before, the system displays the following<br />
message:<br />
This appears to be an attempt to install the same architecture and version of a package<br />
which is already installed. This installationwill attempt to overwrite this package.<br />
v 2-3
Supplying Details for LINC Deployment Executables<br />
It may be several minutes before the first prompt appears. In any of the following steps,<br />
you can<br />
$ Either enter the required information (for example, a directory path). Error messages<br />
are displayed if you enter invalid information (for example, a path that does not exist).<br />
$ Or enter Y or N to specify whether or not to perform the action (for example, install<br />
ORACLE database support). Required information is displayed (for example, required<br />
software levels).<br />
$ Press Return to accept the default value.<br />
$ Enter q to abort the installation.<br />
1. You are prompted to enter the full path of the LINC installation directory. If there is<br />
an existing LINC installation in this directory, it will be overwritten.<br />
2. You are prompted to enter the full path of the COBOL home directory.<br />
3. You are prompted whether or not to install ORACLE database support.<br />
4. You are prompted to enter the ORACLE DBA username.<br />
5. You are prompted to enter the full path of the ORACLE Home directory.<br />
6. You are prompted whether or not to install Griffin database support.<br />
7. You are prompted to enter the Griffin DBA username.<br />
8. You are prompted to enter the Griffin Home directory.<br />
9. You are prompted whether or not to install Tuxedo support.<br />
10. You are prompted to enter the Tuxedo installation directory. Tuxedo is needed only if<br />
you intend to use On-Line Transaction Processing (OLTP).<br />
11. You are prompted whether or not to install Package Creation support. Package<br />
creation support enables you to create LINC object or executable packages from<br />
your LINC installation using the Object Packaging utility.<br />
12. You are prompted whether or not to apply EIFs during installation of the LINC<br />
Deployment Executables.<br />
Caution<br />
All EIFs in the directory you specify will be applied in numeric order. You should<br />
read EIF installation instructions to ensure they can be applied with LINC<br />
Deployment Executables. Most EIFs require that LINC objects are installed and<br />
they cannot be applied during the installation of LINC Deployment Executables.<br />
Ensure that the directory you specify contains only those EIFs that can be<br />
applied and that you want to apply.<br />
13. If you specified that you wanted to apply EIFs, you are prompted to enter the full<br />
path of the directory containing the EIFs you want to apply. An attempt will be made<br />
to apply all EIFs (files with extension .eif, .EIF, .cer, .CER or additionally,<br />
compressed EIFs with a .Z extension) found in the directory.<br />
2-4 v
Setting Up the LINC Tidy Up Script<br />
14. You are prompted whether or not to proceed with the installation of LINC<br />
Deployment Executables.<br />
Installation then commences.<br />
On successful completion of the LINC Deployment Executables installation, the following<br />
message is displayed:<br />
Deployment installed on <br />
Installation of was successful.<br />
You may want to create or change the configuration of your ORACLE SIDs or Griffin<br />
Universes. See Appendix A for details of ORACLE and Griffin configuration.<br />
Validation Checks Performed during Installation<br />
The following are some of the validation checks performed during LINC installation:<br />
$ Tuxedo cannot be selected unless ORACLE is also selected.<br />
$ Checks are made in ORACLE, Griffin, COBOL, and Tuxedo installation directories to<br />
ensure that the version installed matches the expected level (executables) or the user<br />
entered level (objects).<br />
A warning is given if software levels do not match.<br />
$ All options, or no options, must be entered for each support software package. For<br />
example, an error is raised if you enter the ORACLE-DBA value but fail to enter an<br />
ORACLE-HOME value.<br />
Defining Environment Variables<br />
Following LINC Deployment installation, you must define or modify the following<br />
environment variables:<br />
$ LINCIIDIR<br />
The LINCIIDIR variable must be set to the full path name of the directory where the<br />
LINC Deployment software is installed (for example, /usr/linc163).<br />
$ PATH<br />
The PATH variable should include $LINCIIDIR/bin.<br />
Note: You must define these variables before you create ORACLE SIDs or Griffin<br />
Universes.<br />
Setting Up the LINC Tidy Up Script<br />
v 2-5
Setting Up the LINC Tidy Up Script<br />
The LINC Tidy Up script removes files from the $LINCIIDIR/trace directory that have not<br />
been accessed for three days . These files are used for diagnostic purposes, and need not<br />
normally be retained.<br />
Add the following line to the file root in the /usr/spool/cron/crontabs directory:<br />
<br />
This line sets linc16tdy to run each day at 3:00 a.m. You can change this time as required. In<br />
this line, $LINCIIDIR should be replaced with the actual directory in which the LINC<br />
Software was installed.<br />
For example, if the /usr/linc163 directory was used, the following entry would be made:<br />
<br />
2-6 v
Section 3<br />
Installing LINC Generate Executables<br />
Overview<br />
This section describes how to install LINC Generate Executables on Sequent hosts.<br />
Note: Before installing LINC Generate Executables, you must install LINC<br />
Deployment Executables. See Section 2.<br />
This section covers the following:<br />
$ Contents of the LINC Generate CD-ROM<br />
$ Pre-Installation Requirements<br />
$ Starting the Installation of LINC Generate Executables<br />
$ Supplying Details for LINC Generate Executables<br />
$ After Installation Is Complete<br />
Other considerations, such as setting up usernames and running LINC Systems, are<br />
described in your LINC Administration and Operations Guide for the UNIX Operating<br />
System.<br />
Contents of the LINC Generate CD-ROM<br />
The LINC Generate CD-ROM contains the following products:<br />
$ Restricted Griffin Software<br />
Database engine for LINC Generate (approximately 12 Mb), not required if you already<br />
have a full Griffin license.<br />
$ LINC Generate Executables<br />
LINC Generate Software in executable format (approximately 120 Mb).<br />
$ LINC Generate Objects<br />
LINC Generate software in object format (approximately 125 Mb). See Section 4 for<br />
details about installing LINC Generate Objects.<br />
v 3-1
Pre-Installation Requirements<br />
Pre-Installation Requirements<br />
Before you install LINC Generate Executables,<br />
$ Ensure that the required hardware and software is installed and configured. See<br />
Section 1 for details.<br />
$ Back up any LINC Specifications in the LINC Generate System, if it already exists.<br />
$ Install the restricted Griffin software if you do not have an unrestricted Griffin<br />
installation. See your Griffin Data Engine Installation and Administration Guide<br />
for installation details.<br />
$ Install LINC Deployment Executables. See Section 2 for details.<br />
Note: LINC Generate should be installed into the directory in which LINC<br />
Deployment was last installed on your host. If you are installing<br />
LINC software into multiple locations, you should first install LINC<br />
Deployment and then LINC Generate for each of these environments.<br />
$ Create the Griffin Universe if necessary, and configure it for LINC. See Appendix A for<br />
details.<br />
$ Ensure that you know which Griffin Universe is used for LINC Generate.<br />
$ Ensure that no LINC users are using the Griffin Universe that is to be used by LINC<br />
Generate. To do this, from the shell, enter:<br />
<br />
See your LINC Administration and Operations Guide for the UNIX Operating<br />
System for details of the linc16 command.<br />
$ Start the Griffin Universe to be used by LINC Generate with the LINC Griffin Database<br />
Management Utility (GMU):<br />
1. Sign on to your host using the Griffin DBA username.<br />
2. Enter the following from the shell:<br />
<br />
3. Select option 3, Change or Set Griffin Universe from the main GMU menu. Enter<br />
the name of the Griffin Universe to be used for LINC Generate.<br />
4. Select option 2, Perform Griffin Administration from the main GMU menu. The<br />
Griffin Administration Functions menu is displayed.<br />
5. Select option 5, Start this Griffin Universe from the Griffin Administration<br />
Functions menu. Enter the name of the Griffin Universe to be used by LINC<br />
Generate.<br />
The Griffin Universe will be started.<br />
6. Exit from GMU.<br />
See your LINC Administration and Operations Guide for the UNIX Operating<br />
System for details of the Database Management Utility for Griffin.<br />
3-2 v
Supplying Details for LINC Generate Executables<br />
Starting the Installation of LINC Generate<br />
Executables<br />
Note: Ensure that no LINC processes using the existing software are running.<br />
To start the installation:<br />
1. Log in to your Sequent host as a superuser.<br />
2. Insert the LINC Generate CD-ROM into the CD-ROM drive.<br />
3. Mount the CD-ROM file system.<br />
Enter the following from the shell:<br />
<br />
Where cdrom is the mount point for the CD-ROM device.<br />
4. Install the LINC Generate Executables from the CD-ROM.<br />
Enter the following from the shell:<br />
<br />
$ cdrom is the mountpoint for the CD-ROM device.<br />
$ generate is the LINC Generate package which contains LINC Generate product.<br />
$ ln2163 is the LINC Generate product in executable format.<br />
5. The installation process commences and displays the message<br />
Installation in progress. Do not remove the media.<br />
Processing package instance from <br />
LINC Generate 16.3, Release <br />
Version 163.ptx (Sequent)<br />
Unisys<br />
Supplying Details for LINC Generate Executables<br />
When the installation starts, you are asked a number of questions. To obtain help for a<br />
question, enter a question mark (?).<br />
If this package has been installed on this machine before, the system displays the following<br />
message:<br />
This appears to be an attempt to install the same architecture and version of a package<br />
which is already installed. This installation will attempt to overwrite this package.<br />
It may be several minutes before the first prompt appears. In any of the following steps,<br />
you can perform one of these actions:<br />
v 3-3
Supplying Details for LINC Generate Executables<br />
$ Enter the required information (for example, a directory path). Error messages are<br />
displayed if you enter invalid information (for example, a path that does not exist).<br />
$ Enter Y or N to specify whether or not to perform the action (for example, install<br />
ORACLE database support). Required information is displayed (for example, required<br />
software levels).<br />
$ Press Return to accept the default value.<br />
$ Enter q to abort the installation.<br />
1. You are prompted to enter the full path of the LINC installation directory.<br />
2. You are prompted to enter the Griffin Universe to be used by LINC Generate.<br />
3. You are prompted whether or not to retain LINC Specifications and LINC Security<br />
settings in an existing installation.<br />
Caution<br />
Before you choose to delete all existing LINC Specifications, ensure that you<br />
have a backup copy.<br />
4. You are prompted to make Reserved word host list selections. An entry for a host<br />
type enables reserved word checking for that host type if it is currently not selected,<br />
and disables reserved word checking for that host type if it is currently selected.<br />
UNIX is mandatory and cannot be disabled. A table showing the current status of the<br />
Reserved word host list selections is displayed, and redisplayed after each selection.<br />
For new installations, the default is to check for UNIX reserved words only.<br />
Note: You can also set and change target host types and Reserved word<br />
lists using the Supervisor mode in LINC Generate. If you opted to<br />
Retain the existing database then the entries you make here will<br />
not override your existing HOSTLIST settings and you will have to<br />
use the Supervisor mode Host Maintenance feature to change your<br />
host settings. See the LINC Generate Operations Guide for further<br />
details.<br />
5. You are prompted whether or not to load templates into shared memory when LINC<br />
systems are generated. Loading templates uses more memory, but will speed up the<br />
generate process.<br />
6. You are prompted whether or not to allow automatic resequencing of line numbers in<br />
the Editor.<br />
7. You are prompted whether or not to enable Change Identification for LINC Generate.<br />
See your LINC Generate Operations Guide for information on change control<br />
settings.<br />
8. You are prompted whether or not to enable Resource Locking for LINC Generate. See<br />
your LINC Generate Operations Guide for information on Resource Locking.<br />
3-4 v
Supplying Details for LINC Generate Executables<br />
9. If you have enabled either Change Identification or Resource Locking, you are<br />
prompted to enter the type of identification mode.<br />
Value Identification Mode<br />
1 Identification by Station Name<br />
2 Identification by LSM usercode<br />
3 Identification by Change Identifier<br />
10. You are prompted whether or not to enable Patch Identification. See your LINC<br />
Generate Operations Guide for details of Patch Identification.<br />
11. You are prompted to specify your required audit level. See your LINC Generate<br />
Operations Guide for details about audit levels.<br />
12. You are prompted whether or not to use the Specification Administration facility.<br />
This facility enables you to define administration tasks for your LINC Specifications.<br />
See your LINC Generate Operations Guide for details of the Specification<br />
Administration utility.<br />
13. You are prompted whether or not to reset Run Time Version counts when the patch<br />
identifier is changed. See your LINC Generate Operations Guide for details about<br />
runtime version counts.<br />
14. You are prompted whether or not to reset Report version counts each time your LINC<br />
System is generated. See your LINC Generate Operations Guide for details about<br />
Report version counts.<br />
15. You are prompted whether or not to propagate your configuration settings to all<br />
LINC Specifications (that is, use the same change control and patch identification<br />
settings for all LINC Specifications in LINC Generate). See your LINC Generate<br />
Operations Guide for details about the Propagate All Settings option.<br />
16. You are prompted whether or not to install Package Creation support. Package<br />
Creation support enables you to create LINC object or executable packages from<br />
your LINC installation using the Object Packaging utility.<br />
17. You are prompted whether or not to apply any EIFs during installation.<br />
Caution<br />
All EIFs in the directory you specify will be applied in numeric order. You should<br />
read EIF installation instructions to ensure they can be applied with LINC<br />
Generate Executables. Most EIFs require that LINC objects are installed and<br />
they cannot be applied during the installation of LINC Generate Executables.<br />
Ensure that the directory you specify contains only those EIFs that can be<br />
applied and that you want to apply.<br />
v 3-5
After Installation Is Complete<br />
18. If you specify that you want to apply EIFs, you are prompted to enter the full path of<br />
the directory containing the EIFs you want to apply. An attempt will be made to<br />
apply all EIFs (files with extension .eif, .EIF, .cer, .CER or additionally, compressed<br />
EIFs with a .Z extension) found in the directory.<br />
19. You are prompted whether or not to proceed with the installation of LINC Generate<br />
Executables.<br />
Installation then commences.<br />
On successful completion of the LINC Generate Executables installation, the following<br />
message is displayed:<br />
Generate installed on <br />
Installation of was successful.<br />
After Installation Is Complete<br />
After installation is complete, perform the following tasks:<br />
$ Enable the system with the shell command<br />
<br />
if you disabled it before installation. See your LINC Administration and Operations<br />
Guide for the UNIX Operating System for details of the linc16 command.<br />
$ Change the configuration of the Griffin Universe as required. See Appendix A for<br />
configuration details.<br />
$ Update any LINC Specifications as detailed in the output file produced by reserved<br />
word checking.<br />
3-6 v
Section 4<br />
Maintaining Your LINC Environment<br />
Overview<br />
This is a general guide to maintenance in your LINC environment. It is by no means<br />
exhaustive. You must carefully consider your own specific requirements and how you can<br />
best use the features of object packaging.<br />
Much of the process of maintaining your LINC environment is controlled on site using<br />
object packaging. From LINC 16.3, LINC Deployment and LINC Generate products are<br />
supplied as packages in two formats u ready-to-install executables, and object modules.<br />
The object packages contain everything needed to build the entire product and are<br />
required for translation and for the installation of most Engineering Interim Fixes (EIFs).<br />
The directory you install LINC into is defined by the environment variable LINCIIDIR. A<br />
LINCIIDIR that contains the LINC object packages necessary to build LINC executables is<br />
a buildable LINCIIDIR. The creation and maintenance of a buildable LINCIIDIR is essential<br />
to the use of object packaging in maintaining your LINC environment.<br />
As of LINC 16.3, EIFs, in cpio format, will usually be supplied as objects. If the EIF<br />
contains object modules, the LINC object packages will have to be installed before you<br />
apply the EIF. You then build your new LINC executables incorporating the EIF.<br />
A special type of EIF called a Validation EIF may be provided from time to time. Validation<br />
EIFs will allow you to build the LINC products with different levels of ORACLE, Griffin,<br />
COBOL, and Tuxedo (see the LINC <strong>Support</strong> Web page at http://www.support.unisys.com/<br />
for availability of Validation EIFs). You will usually apply Validation EIFs during<br />
installation of object packages with the build option selected.<br />
You access object packaging functions with the Product Menu utility. It allows you to<br />
install EIFs and it also allows you to make backups of your LINC installation in executable<br />
package and object package formats. You should make backups before and after installing<br />
EIFs. The Product Menu utility is described later in this section.<br />
To install LINC executable packages, see Section 2 and Section 3.<br />
Typical LINC Environments<br />
With the availability of user controlled object packaging, you may want to reconsider your<br />
change control and maintenance strategy. Object packaging allows you to create and<br />
archive new LINC object and executable packages incrementally with each EIF. It will be<br />
important that you maintain version control of the packages supplied and those you build,<br />
to provide a complete audit trail of incremental LINC changes as implemented through the<br />
installation of EIFs.<br />
v 4-1
Typical LINC Environments<br />
The expected LINC environments fall into two broad types:<br />
$ A basic environment which would comprise a single LINCIIDIR which provides for<br />
both development and production activities. You will need to take your LINC<br />
production off-line to perform maintenance tasks with object packaging including<br />
installing, building, and testing.<br />
$ A standard environment comprising a single maintenance LINCIIDIR and one or more<br />
production LINCIIDIRs on the same or other machines. The other machines must be<br />
running identical levels of system software. All maintenance tasks involving object<br />
packaging are performed in the maintenance LINCIIDIR. The newly created LINC<br />
executables are then transferred to each production LINCIIDIR and installed. LINC<br />
must be shut down on each production LINCIIDIR only for the time taken to install the<br />
new executables.<br />
It is desirable to have a LINC maintenance environment which is not used for production<br />
work. This is because the buildable LINCIIDIR will be unavailable while EIFs are installed,<br />
and while LINC executables are built and tested.<br />
The recommended incremental maintenance cycle in your maintenance environment<br />
would be as follows:<br />
1. Initial installation<br />
Install LINC executable packages from CD-ROM into your production LINCIIDIR<br />
directory or directories.<br />
2. First EIF<br />
$ When required, download an EIF (cpio file) from the web.<br />
$ Install LINC object packages from CD-ROM into your maintenance environment<br />
LINCIIDIR directory, applying EIFs and requesting a build.<br />
$ Test your newly built executables in your maintenance environment LINCIIDIR<br />
directory.<br />
$ Create backup packages for objects and executables.<br />
$ Archive the object packages for use when installing the next EIF.<br />
$ Install the executable packages into your production LINCIIDIR directory or<br />
directories.<br />
3. Subsequent EIFs<br />
$ When required, download another EIF (cpio file) from the web.<br />
$ Install most recent LINC object packages from archive into your maintenance<br />
environment LINCIIDIR directory, applying new EIFs and requesting a build.<br />
$ Test your newly built executables in your maintenance environment LINCIIDIR<br />
directory.<br />
$ Create backup packages for objects and executables.<br />
$ Archive the object packages for use when installing the next EIF.<br />
4-2 v
Installing LINC Deployment Objects<br />
$ Install the executable packages into your production LINCIIDIR directory or<br />
directories.<br />
This strategy means you are always applying an EIF to a proven LINC build. This takes the<br />
shortest time to process and provides you with an immediate fallback to the most recent<br />
version if required.<br />
Note: If you can guarantee the integrity of the objects in your maintenance<br />
environment, you can install and build subsequent EIFs using the Product<br />
Menu utility instead of reinstalling object packages from archive.<br />
Installing LINC Deployment Objects<br />
To maintain your own LINC environment, you need to be able to build new LINC<br />
executables for installation at your site. New LINC executables are built from LINC objects<br />
and EIFs located in a buildable installation. A buildable installation requires the<br />
installation of the LINC Deployment Objects from the LINC Deployment CD-ROM or from<br />
an archived LINC Deployment Objects package.<br />
This section describes how to install LINC Deployment objects. You must install LINC<br />
Deployment Objects before you can install LINC Generate Objects.<br />
The environment variable LINCIIDIR specifies the full path of the buildable installation of<br />
LINC Deployment objects. A log of the installation process is written to<br />
LINCIIDIR/install/ProductLog in the installation LINCIIDIR.<br />
To create a buildable installation requires the following:<br />
$ Pre-Installation Requirements<br />
$ Starting the Installation of LINC Deployment objects<br />
$ Supplying Details for LINC Deployment objects<br />
Pre-Installation Requirements<br />
Pre-installation requirements for LINC Deployment Objects are similar to those described<br />
for LINC Deployment installation in ‘‘Pre-Installation Requirements’’. Also ensure that you<br />
know the ORACLE, Griffin, COBOL and Tuxedo software levels.<br />
Starting the Installation of LINC Deployment Objects<br />
Starting the installation of LINC Deployment Objects is almost identical to ‘‘Starting the<br />
Installation of LINC Deployment Executables’’ described in Section 2. The only difference<br />
is that you must choose LINC Deployment Objects (l2ro163) and not LINC Deployment<br />
Executables (l2r163).<br />
Enter the following from the shell:<br />
<br />
v 4-3
Installing LINC Generate Objects<br />
Supplying Details for LINC Deployment Objects<br />
Supplying details for LINC Deployment objects is almost identical to Supplying Details for<br />
LINC Deployment executables described in Section 2. The differences are that you must<br />
enter the following additional values. The values you enter must be in the validated list of<br />
software supported by LINC.<br />
$ COBOL level<br />
$ ORACLE level<br />
$ Griffin level<br />
$ Tuxedo level<br />
$ You are prompted whether or not to build LINC Deployment executables as part of<br />
this installation.<br />
Normally you do not build LINC Deployment if you are going to install LINC Generate<br />
unless you need to configure a Griffin Universe to install LINC Generate into.<br />
After installing LINC Deployment objects, you should configure your ORACLE SIDs or<br />
Griffin Universes for use with LINC. You will not be able to perform this configuration until<br />
you have built LINC Deployment executables. See Appendix A for details of ORACLE and<br />
Griffin configuration.<br />
Installing LINC Generate Objects<br />
A buildable installation which includes LINC Generate requires the installation of the LINC<br />
Generate Objects from the LINC Generate CD-ROM or from an archived LINC Generate<br />
Objects package.<br />
The environment variable LINCIIDIR specifies the full path of the buildable installation of<br />
LINC objects. A log of the installation process is written to<br />
$LINCIIDIR/install/ProductLog in the installation LINCIIDIR.<br />
To create a buildable installation requires the following:<br />
$ Pre-Installation Requirements<br />
$ Starting the Installation of LINC Generate Objects<br />
$ Supplying Details for LINC Generate Objects<br />
Pre-Installation Requirements<br />
Pre-installation requirements for LINC Generate Objects are almost identical to those<br />
described in ‘‘Pre-Installation Requirements’’ in Section 3.<br />
Additionally, you must have already installed LINC Deployment Objects. See ‘‘Installing<br />
LINC Deployment Objects’’ earlier in this section.<br />
4-4 v
Starting the Installation of LINC Generate Objects<br />
Installing LINC Generate Objects<br />
Starting the installation of LINC Generate Objects is almost identical to ‘‘Starting the<br />
Installation of LINC Generate Executables’’ described in Section 3. The only difference is<br />
that you must choose LINC Generate Objects (ln2o163) and not LINC Generate<br />
Executables (ln2163).<br />
Enter the following from the shell:<br />
<br />
Supplying Details for LINC Generate Objects<br />
Supplying Details for LINC Generate Objects is almost identical to ‘‘Supplying Details for<br />
LINC Generate Executables’’ described in Section 3. The difference is that you are<br />
prompted whether or not to build LINC Deployment executables as part of this installation.<br />
Do you want to build the product now (default: no) [y,n,?,q]<br />
Enter Y or N to specify whether or not to build LINC Generate executables from this<br />
installation. It is usual to build LINC executables during the LINC Generate Objects<br />
installation.<br />
Alternatively, enter q to abort the installation.<br />
v 4-5
The Product Menu Utility<br />
The Product Menu Utility<br />
Product Menu is a menu driven utility for maintaining your LINC environment. You must<br />
be logged in as the root user to run the Product Menu utility. You start Product Menu with:<br />
<br />
<br />
The product menu appears with the following options:<br />
1 - Display Software Environment<br />
Use this option to display the software environment settings you have chosen for this<br />
installation. The Display Software Environment screen appears.<br />
2 - Install Package<br />
Use this option to install a LINC package from the original CD-ROM or from a package you<br />
have created into another LINCIIDIR.<br />
You will be prompted to enter the device name for the device (or path) containing the<br />
LINC package. See ‘‘Installing LINC Deployment Objects’’ or ‘‘Installing LINC Generate<br />
Objects’’earlier in this section, or see Section 2 or Section 3 for further details.<br />
Caution<br />
Don’t use Product Menu to install LINC Deployment into the same LINCIIDIR from<br />
which you are running Product Menu to avoid overwriting Product Menu with a<br />
changed version.<br />
3 - Build Executables<br />
Use this option to build LINC executables from a buildable LINCIIDIR (a LINCIIDIR that<br />
contains the LINC object packages). During the build, no users are permitted to run<br />
anything in the LINCIIDIR and you should ensure that there are no running processes<br />
using the LINCIIDIR. You are prompted to enter the build type. The build type can be one<br />
of the following:<br />
$ Normal<br />
The product status file is used to determine which components to build. Use this build<br />
type to initiate a build after installation.<br />
$ Timestamps<br />
Caution<br />
The product status file is LINCIIDIR/install/ProductStatus. You should never<br />
manually edit this file.<br />
4-6 v
The Product Menu Utility<br />
The time and date stamps of the individual object files are compared with the existing<br />
executables (if they exist) to determine which files to build. Use this build type to<br />
initiate a build after installing an EIF.<br />
$ Forced<br />
All files and components are built regardless of their status. This build type is not<br />
usually required.<br />
You will need to build new LINC executables using the timestamps option when you have<br />
applied an EIF (see your EIF installation instructions).<br />
Check that the environment variables LINCIIDIR and PATH are set correctly and use<br />
1 - Display Software Environment to ensure you have the correct values for your software<br />
environment.<br />
4 - Finish Post-Install Processing<br />
Use this option to finish the installation processing before you attempt to run LINC. This is<br />
required if you initiated a build with the Product Menu utility rather than during<br />
installation.<br />
5 - Create Package<br />
Use this option to create an object or executable package. You can use the created<br />
packages for archiving or distributing to other environments for installation.<br />
You are prompted to specify whether you want to create a Deployment or Generate<br />
package, whether you want to create an Object or Executable package, and the pathname<br />
of the directory you want to use as a spool directory to hold the packages you create.<br />
You are prompted to enter a version suffix. The default suffix is the last one entered.<br />
Increment the version suffix if you have added EIFs since the last packages used.<br />
Once you have created a package, you can use 6 - Transfer Packages to Final Media, to<br />
move one or more packages to a device or file for archive or distribution to other<br />
environments. You can also choose to install LINC directly from your spool directory.<br />
6 - Transfer Packages to Final Media (optional)<br />
Use this option to transfer all object and executable packages in your spool directory to an<br />
installable file or mounted device. This is one way to distribute packages you have created<br />
to other environments for installation.<br />
You can also use this option to create archives of the packages you have created and<br />
installed, or to create a single file that contains multiple packages.<br />
7 - Remove Spooled Packages<br />
Use this option to remove packages you have created from your spool directory.<br />
Packages you have created using 5 - Create Package, are stored in a spool directory that<br />
you specify. Once you have archived and distributed your package, you can delete it from<br />
the spool directory to reclaim the disk space.<br />
v 4-7
The EIF Installation Menu<br />
8 - Install EIF<br />
You can use this option to install an EIF in your buildable LINCIIDIR and then build new<br />
executables for installation. However, if you cannot guarantee the integrity of the objects<br />
in your buildable LINCIIDIR, you should apply EIFs during installation of a recent object<br />
package archive and not use this option.<br />
Do not use this option to apply a Validation EIF. If you want the Validation EIF to take<br />
effect in the current installation, it must be applied during installation. For a description of<br />
the procedure to install an EIF using the options of this screen, see ‘‘Applying Other EIFs’’<br />
later in this section.<br />
9-Exit<br />
Use this option to exit the Product Menu utility and return to the shell prompt.<br />
The EIF Installation Menu<br />
From the Product Menu screen, select 8 - Install EIF to display the EIF Installation menu.<br />
See ‘‘Applying EIFs’’ later in this section for details. The EIF Installation menu has the<br />
following options:<br />
1 - Select EIF to install<br />
Select this option to specify the EIF you want to apply, or to specify the EIF you want to<br />
back out. You are prompted to enter the full pathname of the cpio file containing the EIF.<br />
2 - Change Backup Directory<br />
Select this option to specify the backup directory where files that will be replaced by<br />
application of the EIF are to be stored.<br />
3 - Backup LINC product files to be replaced by EIF<br />
Select this option to backup LINC files that will be replaced by the EIF to the location you<br />
specified in 2 - Change Backup Directory. The files will be saved in a file with the same<br />
name as the EIF but with the extension .save. You can use these files to back out of the EIF<br />
installation and return the LINCIIDIR to its previous state.<br />
4 - Copy EIF from cpio file to $LINCIIDIR<br />
Specify this option to copy the files from the EIF cpio file into your defined LINCIIDIR<br />
directory. The files will be used with the LINC objects in LINCIIDIR to build the new LINC<br />
executables.<br />
5 - Build Executables<br />
Select this option to build new LINC executables from the LINC and EIF objects in your<br />
LINCIIDIR. The resulting executables are updated with the EIF you have applied.<br />
4-8 v
6 - Run installeifnnnn script<br />
Applying EIFs<br />
Select this option to run the script supplied with the EIF. This script performs additional<br />
actions specific to this EIF (see your EIF installation instructions for further details).<br />
7 - Restore LINC product files from backup<br />
Select this option to restore the LINC files from the .save file in the backup directory to the<br />
LINCIIDIR directory. This action overwrites the EIF files and enables you to rollout the<br />
EIF. If you did a build to apply the EIF, then you must build your LINC executables again<br />
to return to your LINC installation to its previous state.<br />
8 - Remove backup files<br />
Once the EIF has been installed and tested, select this option to remove the backup files<br />
contained in the .save file in the backup directory you specified in 2 - Change Backup<br />
Directory. Option 7 will then be disabled for this EIF.<br />
9 - Return to Main Menu<br />
Select this option to exit the EIF Installation menu and return to the main menu.<br />
Applying EIFs<br />
EIFs can be applied in several ways. The installation instructions accompanying an EIF<br />
will detail specific installation requirements. Two types of EIF are considered and<br />
described here:<br />
$ Validation EIFs<br />
Validation EIFs provide additional support for different versions of software which<br />
have been validated for use with LINC. The newly validated versions are then available<br />
as support software choices during LINC installation. To use a new software level,<br />
Validation EIFs must be applied during LINC Deployment Objects installation, and a<br />
build is normally required.<br />
$ Other EIFs<br />
These EIFs usually require new LINC executables to be built from a buildable<br />
LINCIIDIR. If you are installing LINC objects, you should apply the EIF during<br />
installation. Otherwise, install the EIF with Product Menu after the installation of LINC<br />
objects (see the EIF Installation Instructions for further details).<br />
Before installing an EIF, you should create backup packages of your LINC installation. See<br />
‘‘Creating a Package for Distribution’’, later in this section.<br />
Read any special instructions that come with the EIF. To apply EIFs during installation,<br />
the file name must be either eif or EIF followed by the EIF number. File names of<br />
compressed EIFs should retain the .Z suffix.<br />
Applying a Validation EIF<br />
v 4-9
Applying EIFs<br />
During LINC Deployment Objects installation (see ‘‘Installing LINC Deployment Objects’’<br />
earlier in this section), you are prompted whether or not you want to apply EIFs. If you<br />
answer yes you are then prompted to enter the full pathname of the directory containing<br />
the Validation EIFs you want to install.<br />
All EIF files in the specified directory will be applied.<br />
You can choose the newly validated level during this installation. The new level will not<br />
appear in the list of valid levels, as the EIF has not yet been installed. Enter the new level<br />
anyway. You will be cautioned that a Validation EIF must be applied during this<br />
installation.<br />
The new level of software must already be installed.<br />
Object packages subsequently created from this LINCIIDIR will include the new software<br />
level in the list of valid levels displayed for subsequent installs.<br />
Applying Other EIFs<br />
You usually apply non Validation EIFs in one of two ways:<br />
1. During LINC objects installation (see ‘‘Installing LINC Deployment Objects’’ or<br />
‘‘Installing LINC Generate Objects’’earlier in this section), you are prompted whether<br />
or not you want to apply EIFs. If you answer yes you are then prompted to enter the<br />
full pathname of the directory containing the Validation EIFs you want to install.<br />
All EIF files in the specified directory will be applied.<br />
2. Following LINC objects installation, use the Product Menu utility to install an EIF.<br />
To install an EIF to an existing buildable LINC installation,<br />
1. Log in to your system as a superuser.<br />
2. Change directory to the LINCIIDIR directory containing your buildable LINC<br />
installation.<br />
3. Start Product Menu with<br />
<br />
The Product Menu screen appears.<br />
4. Select 8 - Install EIF.<br />
The EIF installation screen appears. The display-only fields at the top of the screen<br />
show the current settings for the LINCIIDIR directory, the EIF file and the backup<br />
directory.<br />
5. Select 1 - Select EIF to install.<br />
Enter the full pathname of the EIF to install. If the EIF file is compressed, be sure to<br />
include the .Z suffix.<br />
6. Select 2 - Change Backup Directory.<br />
4-10 v
Applying EIFs<br />
Enter a directory where files replaced by the EIF are backed up.<br />
7. Select 3 - Backup LINC product files to be replaced by EIF.<br />
This creates backup files in the backup directory you specified. The backup files are<br />
named the same as the EIF file, but with a .save suffix.<br />
8. Select 4 - Copy EIF from cpio file to $LINCIIDIR.<br />
This copies (and expands if the file is compressed) the EIF file into your buildable<br />
LINC installation directory.<br />
9. Select 5 - Build Executables.<br />
This builds the new executables from the LINC and EIF objects in the buildable LINC<br />
installation directory.<br />
10. If instructed in the EIF installation instructions, select 6 - Run installeifnnnn script.<br />
This runs the post installation script supplied with the EIF.<br />
If the installation failed, or if you find that you did not require the EIF you installed, you<br />
can restore the files you backed up before the installation. See ‘‘Uninstalling an EIF’’ later<br />
in this section.<br />
Uninstalling an EIF<br />
You can restore the files you backed up before the EIF installation, and rebuild LINC to its<br />
previous status as follows:<br />
1. Log in to your system as a superuser.<br />
2. Change directory to the LINCIIDIR directory containing your buildable LINC<br />
installation.<br />
3. Start Product Menu with<br />
<br />
The Product Menu screen appears.<br />
4. Select 8 - Install EIF.<br />
The EIF installation screen appears.<br />
5. Select 1 - Select EIF to Install.<br />
Enter the full pathname of the EIF you want to uninstall.<br />
6. Select 2 - Change Backup Directory.<br />
Specify the location of the backup file for the EIF you want to uninstall.<br />
7. Select 7 - Restore LINC product files from backup.<br />
The currently selected EIF is uninstalled using the specified backup file to replace<br />
the relevant EIF files in the selected LINCIIDIR.<br />
8. Select 5 - Build Executables.<br />
v 4-11
Building Executables<br />
This builds executables from the LINC objects in the buildable LINC installation<br />
directory. The EIF files have been overwritten by the restore action and the new<br />
LINC executables are created using the newly restored files.<br />
Building Executables<br />
There are two ways in which you can build executables. They are described in the<br />
following subsections.<br />
Building Executables During Installation<br />
Follow the instructions in ‘‘Installing LINC Deployment Objects’’ or ‘‘Installing LINC<br />
Generate Objects’’ earlier in this section.<br />
You are prompted whether or not to build LINC Deployment executables during the<br />
installation of LINC Objects, Deployment and Generate.<br />
Do you want to build the product now (default: no) [y,n,?,q]<br />
Enter Y to specify that you want to build LINC (Deployment or Generate) executables<br />
from this installation.<br />
The resultant LINCIIDIR will contain both executables and objects.<br />
If you are going to install LINC Generate Objects, usually you would not install LINC<br />
Deployment Objects with the build option. You would install LINC Generate Objects with<br />
build which would automatically build LINC Deployment executables before building<br />
LINC Generate Executables.<br />
If you build executables in this way, you can choose to apply any EIFs during the<br />
installation. Executables built in this way will include any EIFs in the specified EIF<br />
directory (see ‘‘Applying EIFs’’ earlier in this section for filename restrictions).<br />
Building Executables with Product Menu<br />
1. Log in to the system as a superuser.<br />
2. Change directory to the LINCIIDIR directory containing your buildable LINC<br />
installation.<br />
3. Start Product Menu with<br />
<br />
The Product Menu screen appears.<br />
4. Select 3 - Build Executables.<br />
The Build Executables screen appears displaying the free space in your LINCIIDIR<br />
and TMPDIR directories.<br />
4-12 v
Creating a Package for Distribution<br />
5. Press Return to continue. You are warned about running LINC executables in this<br />
LINCIIDIR.<br />
Ensure that no users attempt execution of LINC during the build.<br />
6. Press Return to continue.<br />
7. Enter the type of build you want and press Return.<br />
The build can be one of the following:<br />
$ Normal<br />
The product status file is used to determine which components to build. Use this<br />
type to restart a stopped build, or to initiate a build after installation.<br />
Caution<br />
The product status file is LINCIIDIR/install/ProductStatus. You should<br />
never manually edit this file.<br />
$ Timestamps<br />
The time and date stamps of the individual object files are compared with the<br />
existing executables (if they exist) to determine which files to build. Use this<br />
type of build after installing an EIF.<br />
$ Forced<br />
All files and components are built regardless of their status. Use this type of build<br />
to force a build of everything. This should not normally be required.<br />
The LINC executables are created in your LINCIIDIR directory.<br />
8. Select 4 - Finish Post-Install Processing.<br />
Processing is performed to finish LINC installation processing.<br />
Use this option to finish the installation processing before you attempt to run LINC.<br />
This step is only required once per release level (for example 16.3) per universe.<br />
Future installations of the same release level into the same universe do not require<br />
this step to be repeated. However, repeating the step does no harm if you are unsure.<br />
Creating a Package for Distribution<br />
The Product Menu utility allows you to create a package of your LINC installation, in either<br />
executable or object formats. It is recommended that you create backups of both objects<br />
and executables.<br />
You can create packages with support for any validated software installed with this LINC<br />
installation, and all packages created will contain all EIFs applied to this LINC installation.<br />
v 4-13
Creating a Package for Distribution<br />
Executable packages can only be installed into an environment with the same software<br />
levels as the software levels that were used to build the executables in the package.<br />
Software levels can only be changed during the installation of LINC Deployment Objects.<br />
Creating a Package<br />
1. Log in to your system as a superuser.<br />
2. Change directory to the LINCIIDIR directory containing your buildable LINC<br />
installation.<br />
3. Start Product Menu with<br />
<br />
The Product Menu screen appears.<br />
4. Select 5 - Create Package.<br />
The Create Package screen appears. You are prompted to specify the following:<br />
$ Whether to create a Deployment (Runtime) or Generate (Development) package.<br />
If you intend to distribute LINC Generate, then you will need to distribute LINC<br />
Deployment as well.<br />
$ Whether to create an Object or Executable package. You can only create an<br />
object package if you have installed the Deployment or Generate objects.<br />
Similarly, you can only create an executable package if you have built or installed<br />
the Deployment or Generate executables.<br />
$ The location of the spool directory where you want the packages created.<br />
$ The suffix to be appended to the LINC version for your information. The default<br />
suffix is the current version.<br />
You should increment the suffix if you have applied EIFs as a means of tracking<br />
your different packages.<br />
The Product Menu utility then creates the specified package in the specified spool<br />
directory.<br />
5. Select 6 - Transfer Packages to Final Media (optional).<br />
When the Product Menu utility has successfully created the package, this action<br />
creates a single file in a distribution directory or on mounted distribution media.<br />
You can use this distribution file or media to install the newly created package on<br />
your production machines. The distribution file or media will contain all packages<br />
that were in your specified spool directory.<br />
To install an executable package you have created, see Section 2 or Section 3.<br />
To install an object package you have created, see ‘‘Installing LINC Deployment Objects’’ or<br />
‘‘Installing LINC Generate Objects’’ earlier in this section.<br />
Removing a Spooled Package<br />
4-14 v
Creating a Package for Distribution<br />
If you have created a number of packages in your spool directory, you may wish to remove<br />
one or more of them after you transfer a package to a file. You may also want to remove<br />
spooled packages once you have archived the package and have distributed the file for<br />
installation in your production LINCIIDIRs.<br />
1. Change directory to the LINCIIDIR directory containing your buildable LINC<br />
installation.<br />
2. Start Product Menu with<br />
<br />
The Product Menu screen appears.<br />
3. Select 7 - Remove Spooled Packages.<br />
The Remove Spooled Packages screen appears.<br />
4. Enter the location of the spool directory containing packages you want to remove.<br />
5. Enter the name of the package you want to remove from the spool directory or press<br />
Return to see a list of packages in the specified spool directory.<br />
Removing a package from the spool directory does not remove the source of the<br />
package in your LINCIIDIR. Once the package has been successfully removed, you<br />
are prompted to enter the name of the next package you want to remove.<br />
6. Press Ctrl-D to return to the Product Menu screen when you have finished removing<br />
packages from the spool directory.<br />
v 4-15
Appendix A<br />
Configuring and Tuning ORACLE and<br />
Griffin for LINC Software<br />
Overview<br />
ORACLE and Griffin must be configured before your LINC Software can be used, and<br />
before LINC Generate can be installed. You cannot configure ORACLE and Griffin until<br />
you have installed the LINC Deployment Executables or built them from the installed LINC<br />
Deployment Objects.<br />
This section contains the following procedures for configuring ORACLE and Griffin:<br />
$ Planning your ORACLE SIDs and Griffin Universes<br />
$ Creating ORACLE SIDs<br />
$ Creating Griffin Universes<br />
$ Tuning ORACLE SIDs<br />
$ Tuning Griffin Universes<br />
Note: In this document and throughout the LINC documentation, ORACLE SID is<br />
used in place of the term database that is used in ORACLE documentation.<br />
LINC documentation uses database in a different context.<br />
v A-1
Planning Your ORACLE SIDs and Griffin Universes<br />
Planning Your ORACLE SIDs and Griffin Universes<br />
In order to run LINC Systems whose databases will reside in an ORACLE SID or Griffin<br />
Universe, you must first plan your ORACLE SIDs and Griffin Universes by performing the<br />
following tasks:<br />
$ Choose the number of ORACLE SIDs and Griffin Universes<br />
$ Choose names for your ORACLE SIDs and Griffin Universes<br />
$ Choose Names and Sizes of Tablespaces and Database Files<br />
Choosing the Number of ORACLE SIDs and Griffin Universes<br />
Use the following guidelines when deciding how many ORACLE SIDs and Griffin<br />
Universes to create.<br />
$ You can choose to create a separate ORACLE SID or Griffin Universe for each LINC<br />
System, or assign all LINC Systems to a single ORACLE SID or Griffin Universe.<br />
$ The Griffin Universe for LINC Generate should be separate from those used for LINC<br />
Deployment.<br />
Caution<br />
Do not use the same ORACLE SID or Griffin Universe for multiple versions of LINC<br />
Software. This could corrupt data for the LINC Report Output Control System (ROC)<br />
and other system tables.<br />
You should install multiple versions of LINC Software in separate ORACLE SIDs or<br />
Griffin Universes.<br />
Choosing Names for ORACLE SIDs and Griffin Universes<br />
LINC is designed only for one- or two-character ORACLE SID and Griffin Universe names,<br />
where the first character is uppercase A through Z only, and the second character is<br />
uppercase A through Z, or0 through 9.<br />
Examples of valid and invalid names for use with LINC Software are contained in the<br />
following table.<br />
A-2 v
Planning Your ORACLE SIDs and Griffin Universes<br />
Valid names A C1 HB Z9<br />
Invalid names ABC aB Ab 1A<br />
Note: Do not use the same name for an ORACLE SID and a Griffin Universe.<br />
Choosing Names and Sizes of Tablespaces and Database Files<br />
Structures in the LINC Database are assigned to disk locations according to Tablespace<br />
name. The disk locations available to a given Tablespace are determined by the ORACLE<br />
or Griffin database files the Tablespace contains.<br />
You may want to separate files from each other for reasons of hardware failure and I/O<br />
load. For example, you can put audit and control files on a different physical disk unit from<br />
the rest of the database. You can improve performance by placing high-usage files on<br />
physical disk units of their own, reducing I/O contention, and placing the files in such a<br />
way as to reduce head movement.<br />
For the initial installation, most Tablespaces normally consist of a single ORACLE or<br />
Griffin database file, unless there is insufficient available contiguous space. More database<br />
files can be added subsequently to Tablespaces as required.<br />
v A-3
Creating ORACLE SIDs<br />
Creating ORACLE SIDs<br />
Before You Start<br />
Before you begin the process of creating an ORACLE SID, you need to gather the following<br />
information:<br />
$ Password for the ORACLE DBA username. The password is required to allow access<br />
to the functions and privileges of the username.<br />
$ Name of the new ORACLE SID. See ‘‘Choosing Names for ORACLE SIDs and Griffin<br />
Universes’’, earlier in this section.<br />
$ Configuration information for the ORACLE SID<br />
v Proposed location of additional control files.<br />
v Number of 2 KB database buffers.<br />
v Name of rollback segments.<br />
v Number and size of extents, which determine the size of the rollback segments.<br />
v Sizes, names, and locations of Tablespaces and ORACLE database files. You will<br />
be adding one database file in the SYSTEM Tablespace during the creation of the<br />
ORACLE SID, and adding the remaining database files later.<br />
v Location and size of Redo Log files.<br />
See ‘‘Guidelines for Creating ORACLE SIDs’’ for further details.<br />
In addition to the above, you must have installed LINC Deployment and set up<br />
environment variables. See Section 2 of this document.<br />
Guidelines for Creating ORACLE SIDs<br />
Use the following points as a guide for the minimum requirements for your ORACLE SID.<br />
$ Location of additional control files for the ORACLE SID<br />
The ORACLE Control file contains the location of database and Redo Log files, and is<br />
used to record information about the use of the ORACLE SID. Multiple copies of the<br />
Control file are recommended to ensure database reliability and recoverability.<br />
Additional copies of the file should be placed on different physical disk drives.<br />
$ Number of 2 KB database buffers<br />
If the ORACLE SID is to be used for small LINC systems, accept the default value of<br />
1000. If the ORACLE SID is to be used for large LINC systems, increase the value to<br />
2000. This value has a significant impact on the amount of shared memory required for<br />
the ORACLE SID.<br />
$ Name of rollback segments<br />
The default name is RBS_1.<br />
A-4 v
Creating ORACLE SIDs<br />
$ Number and size of extents which determine the size of the rollback segments<br />
If you do not create rollback segments for an ORACLE SID used for LINC systems, the<br />
SYSTEM rollback segment will be used. You can add rollback segments to any<br />
Tablespace later, by using the Database Management Utility (DMU). For details of<br />
DMU, see your LINC Administration and Operations Guide for the UNIX Operating<br />
System.<br />
See also the descriptions of the init.ora and rollback_segments parameters in the<br />
ORACLE8 Server Administrator’s Guide.<br />
Note: All rollback segments you create should be the same size. The<br />
SYSTEM rollback segment is created automatically, and need not be<br />
the same size as other rollback segments.<br />
$ Size and locations of Tablespaces and database files<br />
The initial file (SYSTEM Tablespace) should be at least 25 MB to hold ORACLE system<br />
tables and LINC system tables. Both sets of system tables will require space as more<br />
LINC Systems are generated and run. Additional space is required for LINC Report<br />
Output Control System (ROC16) and LINC Ad Hoc Inquiry Utility (ADHOC16)<br />
structures. See ‘‘Changing LINC Structures in Tablespaces’’ later in this section.<br />
The location of the file or files will be determined by the availability of raw disk<br />
partitions or space available in the UNIX file system. You must ensure that permissions<br />
of any raw disk or directories will allow users access to the database files. See also<br />
‘‘Choosing Names and Sizes of Tablespaces and Database Files’’, earlier in this section.<br />
$ Location and size of Redo Log files<br />
For the LINC Deployment ORACLE SID, two 500 KB Redo Log files may be sufficient<br />
for small LINC systems. Increase the size for large systems.<br />
The amount of space required will be affected by<br />
$ The size of the LINC Databases stored in an ORACLE SID for LINC Systems<br />
$ The size of the database for the LINC Report Output Control System (ROC) in an<br />
ORACLE SID<br />
Note: You will find that more space is required as you add data for your systems. You<br />
can use DMU to alter the size of your ORACLE SIDs. For details of DMU, see<br />
your LINC Administration and Operations Guide for the UNIX Operating System.<br />
Additional considerations for ORACLE SIDs are as follows:<br />
$ ORACLE parameter init_sql_files<br />
Ensure that the init_sql_files parameter includes catalog.sql, catexp.sql and<br />
catproc.sql, or ensure that these files are run using sqldba after creating a new<br />
ORACLE SID. The LINC Database Management Utility (DMU) runs these files<br />
automatically after creating a new ORACLE SID.<br />
See also the descriptions of the init.ora parameters in the ORACLE8 Server<br />
Administrator’s Guide.<br />
v A-5
Creating ORACLE SIDs<br />
$ Raw disk<br />
If you intend to use raw disk devices, see ‘‘Tuning ORACLE under UNIX’’ in your<br />
ORACLE Installation and Configuration Guide.<br />
Creating an ORACLE SID<br />
Use the LINC Database Management Utility (DMU) to create ORACLE SIDs. DMU is<br />
installed as part of LINC Deployment.<br />
To create a new ORACLE SID,<br />
1. Enter the following from the shell:<br />
<br />
The main DMU menu is displayed.<br />
2. Select option 3, Change or Set ORACLE_SID. You are asked for the name of an<br />
ORACLE SID.<br />
3. Enter the name of your new ORACLE SID.<br />
You are notified if the ORACLE SID does not exist, and asked whether you want to<br />
initialize it. Answer Y. The main DMU menu is redisplayed for the ORACLE SID you<br />
specified.<br />
4. Select option 2, Perform Database Administration Functions on the whole<br />
ORACLE_SID. The ORACLE Administration Functions menu is displayed.<br />
5. Select option 3, Initialize an ORACLE_SID. You are asked for the password<br />
associated with the ORACLE DBA username. Enter this password.<br />
6. Name any additional control files you want to create for the ORACLE SID. See<br />
‘‘Guidelines for Creating ORACLE SIDs’’, earlier in this section.<br />
7. Specify the number of 2 KB database buffers. See ‘‘Guidelines for Creating ORACLE<br />
SIDs’’, earlier in this section.<br />
8. Specify the name (location), size, and Tablespace name of one of the database files.<br />
See ‘‘Guidelines for Creating ORACLE SIDs’’, earlier in this section. Add additional<br />
database files and Tablespaces after the ORACLE SID has been created.<br />
9. Enter the name (location) and size of the Redo Log files. See ‘‘Guidelines for Creating<br />
ORACLE SIDs’’, earlier in this section.<br />
The ORACLE SID is created.<br />
10. Indicate whether you want to change the passwords for the SYS and SYSTEM<br />
ORACLE usernames. If you have a requirement to do so, enter Y and then the new<br />
passwords. If you do not want to change the passwords, enter N.<br />
The ORACLE SID is shut down and warm started.<br />
11. Indicate whether you want to grant privileges to the users LINC and LINCINQ. Ifthe<br />
ORACLE SID is to be used for LINC purposes, you must answer Y.<br />
12. Indicate whether you want to create rollback segments. Answer Y and name the<br />
rollback segment you want to create.<br />
A-6 v
Creating ORACLE SIDs<br />
13. Enter the size and minimum number of extents for the rollback segment. See<br />
‘‘Guidelines for Creating ORACLE SIDs’’, earlier in this section.<br />
14. Set the Optimal Size parameter to the rollback segment size. If the rollback segment<br />
grows larger than this size during a transaction, ORACLE will shrink it back to its<br />
Optimal Size when any transactions using the larger rollback segment are committed.<br />
15. Indicate whether you want to create LINC System tables in the ORACLE SID. Answer<br />
Y to create the tables. Answer N to defer this process (see your LINC<br />
Administration and Operations Guide for the UNIX Operating System for the use<br />
of DMU to create the tables).<br />
After the ROC, ADHOC, and other system tables are created, you are returned to the<br />
ORACLE Administration Menu.<br />
16. Indicate whether you want to change the password for the LINC and LINCINQ users.<br />
You must know the root password to perform this operation.<br />
17. Add any additional database files and Tablespaces you need.<br />
18. Enter 99 to exit DMU.<br />
v A-7
Creating Griffin Universes<br />
Creating Griffin Universes<br />
Before You Start<br />
Before you begin the process of creating a Griffin Universe, you need to gather the<br />
following information:<br />
$ Password for the Griffin DBA username. The password is required to allow access to<br />
the functions and privileges of the username.<br />
$ Name of the new Griffin Universe. See ‘‘Choosing Names for ORACLE SIDs and Griffin<br />
Universes’’, earlier in this section.<br />
$ Configuration information for the Griffin Universe:<br />
v Whether Archiving is to be used<br />
v Maximum number of Griffin servers<br />
v Number and location of Tablespaces<br />
v Name and size of each Tablespace<br />
v Number and location of Griffin database files<br />
v Name, size, and Tablespace name for each Griffin database file<br />
v Number and location of Griffin audit files<br />
v Name and size of each Tablespace name for each Griffin audit file<br />
v Number of Audit Arms<br />
See ‘‘Guidelines for Creating Griffin Universes’’, later in this section.<br />
Note: Table, Index, Audit Arm, and Tablespace names are converted to lowercase for<br />
use with Griffin.<br />
In addition to the above information, you must have installed LINC Deployment and set up<br />
environment variables. See Section 2.<br />
Guidelines for Creating Griffin Universes<br />
Use the following points as a guide for the minimum requirements for your Griffin<br />
Universe.<br />
$ Whether Archiving is to be used<br />
Choosing this function means that you are required to back up Audit Arms on a regular<br />
basis, so that recovery can be guaranteed. See the recovery section of your Griffin<br />
Data Engine Installation and Administration Guide for details and requirements of<br />
archiving.<br />
A-8 v
Creating Griffin Universes<br />
You should consider enabling this function for your production systems. However, you<br />
should be aware that Griffin does not automatically archive Audit Arms, and that when<br />
all Audit Arms are ready to be archived, you are required to intervene manually.<br />
$ Maximum number of Griffin servers<br />
You will need four Griffin servers (for the LINC lcp, Griffin Utility, audit daemon, and<br />
monitor daemon), plus one for each LINC Server, plus two if you are using the LINC<br />
Report Output Control System (ROC), plus one for each concurrent LINC Report that<br />
is to be run.<br />
Note: The number of Griffin servers affects the number of semaphores<br />
required during creation of Griffin Universes. If you specify too<br />
high a value, the creation of the Griffin Universe may fail.<br />
$ Number of Griffin database files, and the name, size, and Tablespace name for each<br />
Griffin database file<br />
Griffin database files are the names (locations) of UNIX files or raw disk partitions<br />
used to store data for the Griffin Universe. Tablespaces are logical groupings of Griffin<br />
database files.<br />
The number and size of your Griffin database files will depend on the amount of data<br />
to be stored. See your Griffin Data Engine Installation and Administration Guide<br />
and the following notes on space requirements for guidelines. You will need a<br />
minimum of 40 MB of space for Tablespaces for LINC Generate, and 8 MB of space for<br />
LINC System Tables.<br />
$ Number of Griffin audit files, and the name, size, and Tablespace name for each Griffin<br />
audit file<br />
Griffin audit files are the names (locations) of UNIX files or raw disk partitions used to<br />
store transactions and audit information for the Griffin Universe. See your Griffin<br />
Data Engine Installation and Administration Guide and the following notes on<br />
space requirements for guidelines. Additional space is required if LINC Report Output<br />
Control System (ROC16) and LINC Ad Hoc Inquiry Utility (ADHOC16) structures are<br />
included. See ‘‘Changing LINC Structures in Tablespaces’’ later in this section.<br />
$ Number of Audit Arms<br />
Audit Arms are used for recovery purposes. At least two Audit Arms are required, and<br />
four are recommended for use with LINC Systems. Four 15 MB Audit Arms are<br />
required for LINC Generate. At least 8 MB of space are required for LINC System<br />
tables in runtime Griffin Universes. These requirements will increase as LINC Systems<br />
are created, generated, and run.<br />
See also ‘‘Tuning the Configuration of Griffin Universes’’, later in this section.<br />
The amount of space required by a Griffin Universe will be affected by the following:<br />
$ Size of the LINC Databases stored in a runtime Griffin Universe<br />
$ Size of the database for the LINC Report Output Control System (ROC) in a Griffin<br />
Universe<br />
$ Size of data for the LINC Ad Hoc Inquiry Utility<br />
v A-9
Creating Griffin Universes<br />
$ Size of the LINC Specifications stored in a development Griffin Universe<br />
Note: You can use GMU to increase the size of your Griffin Universes. For details of<br />
GMU, see your LINC Administration and Operations Guide for the UNIX<br />
Operating System.<br />
Creating a Griffin Universe<br />
Use GMU to create Griffin Universes. GMU is installed as part of LINC Deployment.<br />
To create a new Griffin Universe<br />
1. Enter the following from the shell:<br />
<br />
The main GMU menu is displayed.<br />
2. Select option 3, Change or set Griffin Universe. You are asked for the name of a<br />
Griffin Universe.<br />
3. Enter the name of your new Griffin Universe.<br />
You are notified if the Griffin Universe does not exist and asked whether you wish to<br />
initialize it. Answer Y. The main GMU menu is redisplayed for the Griffin Universe<br />
you specified.<br />
4. Select option 2, Perform Griffin Administration. The Griffin Administration<br />
Functions menu is displayed.<br />
5. Select option 3, Create a Griffin Universe. You are asked for the password<br />
associated with the Griffin DBA username. Enter this password.<br />
6. Enter Y if you want Archiving to be turned on for the Griffin Universe. Enter N if you<br />
do not want to enable Archiving. See ‘‘Guidelines for Creating Griffin Universes’’,<br />
earlier in this section.<br />
7. Enter the maximum number of concurrent Griffin servers, in the range 5 through 500,<br />
and press Return. The default is 15. See ‘‘Guidelines for Creating Griffin Universes’’,<br />
earlier in this section.<br />
8. Enter the number of Griffin database files, in the range 1 through 100, and press<br />
Return. The default is 1. See ‘‘Guidelines for Creating Griffin Universes’’, earlier in<br />
this section.<br />
9. Ensure the default name, size, and Tablespace for each Griffin database file are<br />
correct.<br />
$ Enter N and press Return to accept the displayed values.<br />
$ Enter Q and press Return to cancel the definition of this Griffin Universe.<br />
$ Enter Y and press Return if you want to change the values. You will be asked to<br />
change the values for the name, size, and Tablespace. See ‘‘Guidelines for<br />
Creating Griffin Universes’’, earlier in this section.<br />
A-10 v
Creating Griffin Universes<br />
10. Enter the number of Griffin audit files, in the range 1 through 100, and press Return.<br />
The default is 1. See ‘‘Guidelines for Creating Griffin Universes’’, earlier in this<br />
section.<br />
11. Ensure the default name, size, and Tablespace for each Griffin audit file are correct.<br />
$ Enter N and press Return to accept the displayed values.<br />
$ Enter Q and press Return to cancel the definition of this Griffin Universe.<br />
$ Enter Y and press Return if you want to change the values. You will be asked to<br />
change the values for the name, size, and Tablespace. See ‘‘Guidelines for<br />
Creating Griffin Universes’’, earlier in this section.<br />
12. Enter the number of Audit Arms, in the range 2 through 100, and press Return. The<br />
default value is 2. See ‘‘Guidelines for Creating Griffin Universes’’, earlier in this<br />
section.<br />
13. Enter Y and press Return, if you want to check the configuration values, to repeat all<br />
of the previous questions.<br />
Enter N and press Return to accept the current values. The name of the configuration<br />
file is displayed.<br />
14. Enter Y and press Return to create the Griffin Universe.<br />
Enter N and press Return to abandon the creation.<br />
15. Enter 99 to exit GMU.<br />
v A-11
Tuning ORACLE SIDs<br />
Tuning ORACLE SIDs<br />
Default Configuration of ORACLE SIDs<br />
The following table shows the parameter values for an ORACLE SID created by the LINC<br />
Database Management Utility (DMU).<br />
Parameter Value<br />
db_block_buffers 1000<br />
db_block_size 2048<br />
db_files 20<br />
dml_locks 300<br />
enqueue_resources 650<br />
log_buffer 32768<br />
open_cursors 250<br />
processes 25<br />
shared_pool_size 6000000<br />
sort_area_size 1024000<br />
Tuning the Configuration of ORACLE SIDs<br />
Guidelines for Configuring ORACLE SIDs<br />
For maximum performance, set the ORACLE parameter log_checkpoint_interval to a value<br />
larger than the Redo Log file size. This will trigger a checkpoint only when log file switches<br />
occur.<br />
Setting a value smaller than the Redo Log file size reduces the amount of work required in<br />
the event of an ORACLE failure, but causes more frequent checkpoints, resulting in greater<br />
runtime overheads.<br />
Enable Redo Log Archiving and set the ORACLE parameters log_archive_start and<br />
log_archive_dest if automatic Redo Log Archiving is required.<br />
Note: Multiple LINC Deployment Systems may coexist in the same ORACLE SID.<br />
Configuration of an ORACLE SID must take into account the sum of<br />
requirements for all LINC Systems in that ORACLE SID.<br />
For a discussion of Redo Log files, see your LINC Administration and Operations Guide<br />
for the UNIX Operating System.<br />
A-12 v
See also the descriptions of the init.ora parameters in the ORACLE8 Server<br />
Administrator’s Guide.<br />
db_block_buffers<br />
dml_locks<br />
Tuning ORACLE SIDs<br />
The default values that are configured in the installation of LINC Software have been<br />
determined to be most suitable for the typical required performance of LINC Software.<br />
These values take block size into account, and represent a minimum of 2 MB of<br />
bufferspace for LINC Generate and 1 MB for LINC Deployment.<br />
You can choose to amend these values, but you may experience performance degradation<br />
if the values are decreased.<br />
Increasing the default values will have a significant, favorable impact on performance, but<br />
at the expense of extra shared memory requirements.<br />
If you change db_block_buffers, use the SQL*DBA monitor command to monitor the<br />
number of physical reads/writes compared to logical reads/writes.<br />
This parameter defines the maximum number of DML locks held simultaneously. Set<br />
dml_locks to 1 for each table modified in a concurrent transaction.<br />
enqueue_resources<br />
This parameter defines the number of resources that can be locked by lock manager.<br />
Set enqueue_resources to 120 percent of the sum of the maximum number of DML locks<br />
and the maximum number of parse locks held simultaneously.<br />
log_archive_dest<br />
Set this parameter together with log_archive_start.<br />
log_archive_start<br />
log_buffer<br />
This parameter invokes automatic archiving when Redo Log Archiving is enabled.<br />
Set this parameter together with log_archive_dest if automatic Redo Log file Archiving is<br />
required. See your LINC Administration and Operations Guide for the UNIX Operating<br />
System for a discussion of archiving Redo Log files.<br />
v A-13
Tuning ORACLE SIDs<br />
This parameter determines the size (in bytes) of the Redo Log buffer for the ORACLE SID.<br />
Larger values generally reduce the number of accesses (I/O) to the log file.<br />
log_checkpoint_interval<br />
open_cursors<br />
processes<br />
For maximum performance, set the parameter log_checkpoint_interval to a value larger<br />
than the Redo Log file size. This triggers a checkpoint only when log file switches occur.<br />
Setting a value smaller than the log file size will cause more frequent checkpoints (thus<br />
having a greater runtime overhead) and reduce the amount of work required in the event of<br />
an ORACLE failure.<br />
Set open_cursors to a value greater than the cursor pool size plus ten. For maximum<br />
performance, cursor pool size should allow all the cursors used in the system and reports<br />
to remain open.<br />
The number of cursors required depends on<br />
$ The number of Components and Profiles used<br />
$ The types of database accesses used on each Profile (for example, DETERMINE;<br />
EVERY and DETERMINE; FROM LINC logic commands)<br />
$ The number of Ordinates declared for each Profile<br />
The maximum value of open_cursors is 255.<br />
LINC allocates a default cursor_pool value of 40 for LINC Systems, and 200 for LINC<br />
Generate. The maximum value of cursor_pool is 200.<br />
Note: The value 100 is used for all LINC Reports.<br />
The cursor pool size value can be altered dynamically in a LINC System, using the LINC<br />
System command :CPS.<br />
For more details about cursors, see ‘‘Allowing for Cursors’’, later in this section.<br />
Set this parameter to a value more than ten greater than the number of concurrent<br />
processes of your LINC System.<br />
The number of concurrent processes includes<br />
$ Six ORACLE background processes<br />
$ One process for each user of the LINC System (if not in LINC server mode)<br />
A-14 v
esource_limit<br />
$ One process for each server (if in LINC server mode)<br />
Tuning ORACLE SIDs<br />
$ Two processes for every recoverable Report running against the LINC System<br />
$ One process for every other LINC System potentially using external Automatic Entries<br />
(HUB) to communicate with this LINC System<br />
$ One process for monitoring and recovery<br />
Set resource_limit to true if you want to enforce a read limit for the SQL Views feature.<br />
See your LINC Administration and Operations Guide for the UNIX Operating System<br />
for details of the SQL Views feature.<br />
shared_pool_size<br />
Set shared_pool_size to 3500000 for a small ORACLE SID, 6000000 for a medium<br />
ORACLE SID, and 9000000 for a large ORACLE SID. See the ‘‘Memory Structures and<br />
Processes’’ section of the ORACLE8 Server Administrator’s Guide for further<br />
information.<br />
Allowing for Cursors<br />
A cursor is a work area used by ORACLE to contain a query and its results. One cursor is<br />
associated with each ORACLE data manipulation statement used.<br />
The cursor pool size is the number of concurrently open cursors maintained by LINC. An<br />
open cursor remains open until the cursor pool is exhausted. At this point, the next request<br />
to open a cursor will result in a search for the most appropriate cursor to replace.<br />
Frequency of use, recent use, and cost to reopen the cursors are taken into account.<br />
Cursors are marked ‘‘in use’’ only when being used by an iterative data access by the<br />
DETERMINE; and LOOK.UP; commands.<br />
Size of the Cursor Pool<br />
Generally, each inquiry function on a Standard Component (using a LOOK.UP; command,<br />
for example) uses one cursor. An update function on a Standard Component (using a<br />
FLAG; command, for example) uses another cursor. DETERMINE; commands on Profiles<br />
generally use one cursor for every Profile Ordinate. Conditional Profiles use an additional<br />
three cursors if the contents of the Conditional Profile table are being updated (using a<br />
FLAG; command, for example). All Profiles over Events are Conditional Profiles.<br />
You can control the cursor pool size for a LINC System, by using the LINC System<br />
command :CPS. For more details, see your LINC Administration and Operations Guide<br />
for the UNIX Operating System.<br />
When running in LINC server mode, the setting of the cursor pool applies to the whole<br />
system.<br />
v A-15
Tuning ORACLE SIDs<br />
Obtaining Maximum Performance<br />
For maximum performance, cursor pool size should allow all the frequently used cursors<br />
in LINC Systems and Reports running in the ORACLE SID to remain open.<br />
The cost of a large cursor pool is the use of additional memory.<br />
You can use the ORACLE MONITOR utility to assist you to determine the most appropriate<br />
number of open cursors.<br />
Changing LINC Structures in Tablespaces<br />
If you use DMU to create system tables, all LINC Ad Hoc Inquiry Utility (ADHOC16), LINC<br />
Report Output Control System (ROC16), and LINC global database (LINCGLB) structures<br />
will go to the Tablespace which is declared as the ORACLE default for the LINC usercode<br />
at that time.<br />
ADHOC16 and ROC16 can subsequently be moved to other Tablespaces using linc16cfg.<br />
The LINC global database cannot be moved from the default Tablespace. Since ORACLE<br />
does not allow dropping or reducing of the size of the SYSTEM Tablespace, to place<br />
ADHOC16 and ROC16 in another Tablespace, defer the creation of LINC system tables<br />
when you create an ORACLE SID, then set the LINC default Tablespace appropriately<br />
before creating system tables. The LINC default Tablespace can be changed again after the<br />
system tables are created.<br />
To change Tablespaces or populations for ADHOC16 or ROC16,<br />
1. Log in to your host as root.<br />
2. Ensure that the LINCIIDIR/bin directory is included in your path. To do this, you can<br />
enter the following from the shell:<br />
<br />
3. Move to the appropriate directory under $LINCIIDIR (ADHOC16 for LINC Ad Hoc<br />
Inquiry Utility, or ROC16 for the LINC Report Output Control System).<br />
4. Access the LINC Configure Utility (linc16cfg), and ensure that you are accessing the<br />
ORACLE version of the utilities and that you will create a new database. See your<br />
LINC Administration and Operations Guide for the UNIX Operating System for<br />
details of linc16cfg.<br />
5. Make Tablespace and population changes as required, and then regenerate the<br />
database.<br />
When creating subsequent ORACLE SIDs with the same $LINCIIDIR, follow the above<br />
procedure. However, if you used linc16cfg to move ADHOC16 and ROC16, you will not<br />
have to change the Tablespaces again, as linc16cfg uses the same RDML.EXT files you<br />
modified earlier. You must still change the retain database flag to new database, since<br />
linc16cfg has not previously created the database in this ORACLE SID.<br />
A-16 v
Tuning Griffin Universes<br />
Tuning the Configuration of Griffin Universes<br />
The main parameters affecting the use of LINC Systems are<br />
Tuning Griffin Universes<br />
$ shm_size parameter<br />
The default value for this parameter is 60 KB. If you experience Griffin error 1005,<br />
increase the value of shm_size.<br />
$ cache_size parameter<br />
Increasing the value of this parameter results in increased performance, at the cost of<br />
increased shared memory and recovery time. A value of 8 MB is recommended for use<br />
with LINC Systems, provided there is no restriction on the amount of shared memory.<br />
$ Number of Audit Arms<br />
The recommended number of Audit Arms is four. If you experience shut downs of<br />
your Griffin Universes due to Audit Arms wraparound (while running without<br />
Archiving), increase the size or number of your Audit Arms.<br />
$ Number and size of Audit Buffers<br />
$ Number of Servers<br />
You may need to increase the number of servers if you need to increase the number of<br />
concurrently running LINC Reports.<br />
Caution<br />
The number of Griffin servers affects the number of semaphores required<br />
during creation of Griffin Universes. If you specify too high a value, the creation<br />
of the Griffin Universe may fail.<br />
$ Disk I/O<br />
The performance of a Griffin Universe is highly dependent on disk I/O. This includes<br />
the number of I/Os initiated, and the number of bytes transferred with each I/O. Griffin<br />
configuration parameters directly related to disk I/O are the size and number of Audit<br />
Arms, cache size, and number of Audit Buffers, and size of each Audit Buffer.<br />
Note: Disk I/O performs much better on raw disk rather than on regular<br />
UNIX files. All partitions in a Griffin Universe should be on raw<br />
disk.<br />
v A-17
Tuning Griffin Universes<br />
Tuning Griffin<br />
Audit Arms<br />
Griffin Universes require at least four Audit Arms each of 15 MB or more. If you configure<br />
additional Audit Arms, they must be at least 15 MB in size.<br />
The number and size of Audit Arms that you configure depends on the number of<br />
concurrent servers that you are running and the amount of audit records each server<br />
generates. A server is any process that opens a Griffin database; for example, PGEN, SGEN<br />
and glcp.<br />
Both the number of concurrent servers and the number of audit records depend on the<br />
database schema and the type of server activity.<br />
Checking Size and Number of Audit Arms<br />
You can check the size and number of audit arms by executing the following Griffin (grfn)<br />
command:<br />
<br />
This command lists details for each Audit Arm. You can calculate the size (in bytes) of<br />
each Audit Arm by multiplying "num pieces" by "piece size".<br />
Gathering Statistics<br />
In order to gather cache and audit statistics, turn on the statistics parameters in the cache<br />
and audit sections.<br />
To turn on cache statistics, use the following Griffin (grfn) command:<br />
<br />
To turn on audit statistics, use the following Griffin (grfn) command:<br />
<br />
To turn on statistics you require execute permission for grfncmd or gsql.<br />
Cache Configuration<br />
The cache parameter in your Griffin configuration file is cache_size. This parameter should<br />
be set initially to at least 1% the size of all your database partitions (but no less than 2 MB).<br />
For example, if the sum of all your database partitions is 2000 MB, the cache-size should be<br />
set to 20 MB (2000 times 1 divided by 100).<br />
A-18 v
Checking the cache hit rate<br />
Tuning Griffin Universes<br />
To check the cache hit rate, while servers are running execute the following Griffin (grfn)<br />
command:<br />
<br />
If the "normal read only" hit rate is less than 90%,<br />
1. Increase the cache size by 5 MB to the new size size by using the following Griffin<br />
(grfn) command:<br />
<br />
2. Stop and start your Griffin Universe and servers.<br />
3. Check whether the hit rate improves.<br />
4. Keep increasing the cache size by 5 MB (repeat Steps 1, 2, and 3) until the "normal<br />
read only" hit rate reaches 90% or until the cache size reaches 5% of the size of all<br />
your database partitions.<br />
For example, if the sum of all your database partitions is 1000 MB, do not increase<br />
the cache size beyond 50 MB. At this point the low hit rate could be due to<br />
unoptimized audit parameters.<br />
Audit Configuration<br />
In the AUDIT section of configuration file,<br />
$ Set the max_size parameter to 0.<br />
$ Set the max_buffers parameter initially to half the value of max_servers, but to at least<br />
4.<br />
$ Set the buffer_size parameter to 32 KB and the block0_writes parameter to 256.<br />
$ Make sure that the audit daemon is turned on by checking that the min_open<br />
parameter in the audit daemon section is 1 and the max_open parameter is at least 1.<br />
Producing statistics<br />
While your servers are running, execute the following Griffin (grfn) command:<br />
<br />
Check "average flushed block size"<br />
If the "average flushed block size" value is 90% or more,<br />
1. Increase the buffer_size parameter by 1 KB to the new size size by using the<br />
following Griffin (grfn) command:<br />
<br />
v A-19
Tuning Griffin Universes<br />
Note: Do not increase the buffer_size parameter over 63 KB.<br />
2. Stop and start your Griffin Universe and servers to action the change.<br />
3. Check whether the "average flushed block size" value drops below 90%.<br />
Check "avg number of buffers daemon was behind manager"<br />
If the "avg number of buffers daemon was behind manager" is more than half the "number<br />
of buffers",<br />
1. Increase the max_buffers parameter by 1 to value by using the following Griffin<br />
(grfn) command:<br />
<br />
Note: Do not increase the max_buffers parameter above the value of the<br />
max_servers parameter.<br />
2. Increase the buffer_size parameter by 1 KB to size (unless you have already<br />
increased it when you checked the "average flushed block size")byusingthe<br />
following Griffin (grfn) command:<br />
<br />
Note: Do not increase the buffer_size parameter over 63 KB.<br />
3. Stop and start your Griffin Universe and servers to make the changes take effect.<br />
4. Check whether the value drops to less than half the number of buffers.<br />
Continuing checking<br />
Repeat your checks of the "average flushed block size" and "avg number of buffers daemon<br />
was behind manager" until the conditions are satisfied.<br />
If both these limits have been reached and your performance is still not satisfactory, then<br />
make sure that you have at least four Audit Arms, each at least 15 MB.<br />
If performance is still unsatisfactory, look at database-specific performance using GSQL.<br />
Section 10 of the Griffin Data Engine Installation and Administration Guide is devoted<br />
to performance tuning using GSQL. The two most important database-specific subsections<br />
are "Retrieving Statistics on Cache Memory Usage" and "Analyzing Statistics". Thereare<br />
SELECT statements described in those subsections that may be used to get cache<br />
information specific to a structure (table or index) in a database including the cache hit<br />
rate for that structure.<br />
A-20 v
About "avg number of buffers daemon was behind manager"<br />
Tuning Griffin Universes<br />
The Griffin audit manager writes audit records into the audit buffers in memory. The audit<br />
manager writes into audit buffer memory in a circular fashion: when the audit manager<br />
reaches the end of the audit buffer space, it begins writing to the first audit buffer again.<br />
The Griffin audit daemon writes audit buffers to disk, freeing audit buffers written by the<br />
audit manager. If the audit manager is faster than the daemon, the daemon may be "caught"<br />
by the audit manager. The goal is to minimize the number of times the daemon is "caught".<br />
The space (in terms of number of buffers) between the buffer that the audit manager is<br />
currently filling and the buffer that the audit daemon is currently writing to disk varies<br />
with activity in the Griffin Universe.<br />
The "avg number of buffers daemon was behind manager" is the average number of buffers<br />
between the audit manager and the audit daemon during the course of the Griffin Universe<br />
session.<br />
Note: If you have not configured an audit daemon, then the "avg number of buffers<br />
daemon was behind manager" has no meaning. By default you will have an<br />
audit daemon.<br />
About Griffin Commands<br />
Griffin uses the configuration file in the $GRFNDIR/dbs/$GRFNUNI directory. All changes<br />
must be made to this file using the ALTER grfn command and can be made effective by<br />
stopping and starting the universe. You do not need to stop and start the universe after<br />
adding or dropping audit arms.<br />
Changing LINC Structures in Tablespaces<br />
When LINC system tables are created for a Griffin Universe, all structures are included in<br />
the default Tablespace.<br />
LINC Generate (LINC16DB), LINC Ad Hoc Inquiry Utility (ADHOC16) and LINC Report<br />
Output Control System (ROC16) can be moved to other Tablespaces by using linc16cfg.<br />
The LINC global database (LINCGLB) cannot be moved. The default Tablespace can then<br />
be reduced in size by using the Griffin command processor (grfn) to back up the LINCGLB<br />
database, drop the Tablespace, create the Tablespace with a smaller size, and restore the<br />
LINCGLB database. You should ensure that the default Tablespace is empty before<br />
dropping it.<br />
To change Tablespaces or populations for LINC16DB, ADHOC16, or ROC16<br />
1. Log in to your host as root.<br />
2. Ensure that the $LINCIIDIR/bin directory is included in your path. To do this, you can<br />
enter the following from the shell:<br />
<br />
v A-21
Tuning Griffin Universes<br />
3. Move to the appropriate directory under $LINCIIDIR (LINC16SYS for LINC Generate,<br />
ADHOC16 for the LINC Ad Hoc Inquiry Utility or ROC16 for the LINC Report Output<br />
Control System).<br />
4. Access the LINC Configure Utility (linc16cfg), and make changes to the Griffin LINC<br />
System as required. See your LINC Administration and Operations Guide for the<br />
UNIX Operating System for details of linc16cfg.<br />
5. Use linc16cfg to regenerate the database.<br />
Subsequent Griffin Universes created with the same $LINCIIDIR will pick up any changes<br />
made to ADHOC16 and ROC16. The default Tablespace can be created with a size<br />
appropriate for LINCGLB.<br />
A-22 v
Glossary<br />
A<br />
access class<br />
For LINC Ad Hoc Inquiry, a particular type of user access to queries, defined by a letter (A<br />
through Z) or an asterisk (*, for unrestricted access). Also called query class.<br />
Action line<br />
A field that appears on most screens in LINC Generate, enabling fast-track navigation to<br />
required functions. Also referred to as the Action field.<br />
Ad Hoc Inquiry<br />
See LINC Ad Hoc Inquiry.<br />
Automaint Profile<br />
The Profile of a Multiple Ordinate Memo Component that provides automatic access to the<br />
records of that Component. See Multiple Ordinate Memo Component, Profile.<br />
Automatic Entry<br />
(1) A facility that enables an Ispec to create a record in another Ispec. (2) A facility that<br />
enables an Ispec to modify an existing record in a Standard Component, Table Component,<br />
or Multiple Ordinate Memo Component. (3) Not applicable to Copy.From Ispecs. (4) See<br />
also Automatic Entry buffer, external Automatic Entry, internal Automatic Entry, HUB.<br />
Automatic Entry buffer<br />
An area in memory used by the Automatic Entry facility. See Automatic Entry.<br />
Automatic Lookup<br />
A process where a Component record is automatically read into memory from the<br />
database.<br />
v Glossary-1
Glossary<br />
B<br />
banner<br />
A system-generated page that prints at the start of a Report and provides control<br />
information about that Report.<br />
base year<br />
The year upon which the DATE.CONVERT; command bases relative day numbers. The<br />
year is defined using the Primary Database Options screen and may be accessed through<br />
the System Data item GLB.BASE. See relative day number.<br />
Buildable LINCIIDIR<br />
The LINC installation directory is defined by the environment variable LINCIIDIR. A<br />
LINCIIDIR that contains the LINC object packages necessary to build LINC executables<br />
using object packaging is a buildable LINCIIDIR. A buildable LINCIIDIR is necessary to use<br />
object packaging to maintain your LINC environment<br />
Bulk Option screens<br />
A group of screens in LINC Generate that enable options for several Ispecs, Reports,<br />
Profiles, or Global Logics to be entered together.<br />
C<br />
Change Control<br />
A method for tracking changes to LINC Specifications in LINC Generate.<br />
Change identifier<br />
A alphanumeric value used to identify a single user or user terminal for change control<br />
purposes. Applies when the Change Identification option is selected for that LINC<br />
Specification. Contrast with Patch identifier.<br />
class<br />
See access class, security class.<br />
Column name<br />
For LINC Ad Hoc Inquiry, an SQL term equivalent to data item.<br />
Component<br />
(1) A business resource such as a customer, product or vendor. (2) A store of static data<br />
about a business resource. (3) Consists of a screen layout and associated logic (Pre-Screen<br />
logic, Pre-LINC logic, and Main logic). (4) Together with Events, Components form the<br />
fundamental building blocks of a LINC System. (5) See also Ispec, Standard Component,<br />
Table Component, Memo Component, Multiple Ordinate Memo Component.<br />
Component Profile<br />
For LINC Ad Hoc Inquiry, a Profile over one Component. (2) Contrast with Event Profile.<br />
Glossary-2 v
Glossary<br />
Component record<br />
For LINC Ad Hoc Inquiry, an individual database record for a Component. Equivalent in<br />
SQL terminology to a row.<br />
COMUS<br />
For OS 2200 based LINC Systems, a product used to build LINC Deployment before<br />
installation (see SOLAR).<br />
Copy.From Ispec<br />
An Ispec with a screen that has a number of identical recurring lines. Transmission of the<br />
whole screen produces a separate record in the database for each completed line. See also<br />
Ispec.<br />
Critical Point<br />
(1) A procedure used within a LINC Report to aid in recovery following a system failure.<br />
(2) Created by using the CRITICAL.POINT; LINC Logic command.<br />
D<br />
DAD<br />
See Data Display.<br />
Data Attribute<br />
An attribute of a data item. For example, LENGTH, EDIT, BRIGHT.<br />
Data Command<br />
A command that identifies or creates a data item used in a screen layout, LINC Report, or<br />
logic.<br />
Data Display (DAD)<br />
(1) Optional descriptive text for a data item. Used in status messages in place of the name<br />
of the data item. (2) Defined using the DATA.DISPLAY Data Attribute.<br />
Data item<br />
Part of a LINC Specification defined by using the DATA; command in LINC Painter. Used<br />
to enter, store and display data.<br />
data item<br />
The collective term for the variables used to enter, manipulate, store, and display data<br />
(Data items, Ordinates, Setup Data items, and so on).<br />
database<br />
See LINC Database.<br />
v Glossary-3
Glossary<br />
Database Management Utility (DMU)<br />
(1) A LINC Utility that enables you to maintain your LINC Database. (2) Use to perform<br />
such tasks as changing the amount of disk space allocated to database structures, initiate a<br />
full or partial database reorganizations (for MCP based LINC Systems), and creating<br />
ORACLE SIDs and Griffin Universes (for LINC Systems based on the UNIX operating<br />
system). (3) See also Griffin Database Management Utility (GMU).<br />
Development System<br />
See LINC Development and LINC Generate.<br />
Direct Component<br />
A Component type that uses a key for direct access to the dataset, saving on the number of<br />
Input/Output operations. It has a single numeric Ordinate with a maximum of 8 digits. See<br />
Component.<br />
Direct Report<br />
(1) A specific type of Report that uses the LINC Report Output Control System (ROC), and<br />
which sends output directly to an output device and not to the ROC database. (2) See also<br />
LINC Report Output Control System. (3) Contrast with Standard Report.<br />
Display item<br />
A string of descriptive information displayed on an Ispec screen layout or Report Frame,<br />
primarily used to inform the user which data items are which.<br />
DMU<br />
E<br />
Editor<br />
EIF<br />
See Database Management Utility.<br />
See LINC Editor.<br />
Engineering Interim Fixes (EIFs) are used to distribute new features, fixes, customer<br />
requests and newly validated versions of support software.<br />
Environmental Options screens<br />
Screens in LINC Generate that enable you to define options for your LINC Specification<br />
that apply to the generation on a particular host type.<br />
Event<br />
(1) An activity performed by an organization, for example a sale, purchase, or payment. (2)<br />
A store of data about an activity performed. (3) Consists of a screen layout and associated<br />
logic (Pre-Screen logic, Pre-LINC logic, and Main logic). (4) Together with Components,<br />
Events form the fundamental building blocks of a LINC System. (5) See also Ispec.<br />
Glossary-4 v
Event file<br />
For LINC Ad Hoc Inquiry, the file containing the Event records.<br />
Glossary<br />
Event Profile<br />
For LINC Ad Hoc Inquiry, a Profile over one or more Events. Contrast with Component<br />
Profile.<br />
Event record<br />
For LINC Ad Hoc Inquiry, an individual database record for an Event. Equivalent in SQL<br />
terminology to a row.<br />
Executables<br />
Executables are one of two methods of distributing LINC to customers. They are the<br />
compiled set of LINC files which are ready to install and run. Contrast this with Objects.<br />
external Automatic Entry<br />
An Automatic Entry to or from an external source, such as another LINC System. See<br />
Automatic Entry, HUB. Contrast with internal Automatic Entry.<br />
Extract file<br />
A non-database (text) file created or read by a LINC Report.<br />
F<br />
Fireup Ispec<br />
A particular Ispec that is displayed on your terminal when you sign on to a LINC System.<br />
G<br />
Generalized LINC Interface (GLI)<br />
A facility that enables a non-LINC program to initiate transactions into a LINC Information<br />
System.<br />
Generate Group<br />
A specified group of Reports that can be generated together.<br />
Generate Set<br />
A named set of values for generating a particular LINC System from a LINC Specification;<br />
for example, for a particular host type.<br />
GLI<br />
See Generalized LINC Interface.<br />
v Glossary-5
Glossary<br />
Global Data Dictionary<br />
(1) A data dictionary that controls the use of data items over all LINC Specifications within<br />
the same LINC Generate. (2) Part of GLOBAL Specification. (3) See also LINC Data<br />
Dictionary, Local Data Dictionary.<br />
Global Logic<br />
(1) Part of a LINC Specification that can be reused in other parts of your LINC<br />
Specification. (2) Inserted into Ispecs, Reports, or Global Logics by using the INSERT;<br />
logic command. (3) See Insertable Global Logic, Performable Global Logic.<br />
Global Setup Data item<br />
A Setup Data item that can be used by any Ispec or Report logic within a LINC<br />
Specification. See Setup Data item, Group Global Setup Data item.<br />
GMU<br />
See Griffin Database Management Utility.<br />
Griffin Database Management Utility (GMU)<br />
The equivalent of the Database Management Utility (DMU) for Griffin.<br />
Griffin<br />
Database Management System used as the underlying database software for LINC Systems<br />
based on the UNIX operating system and LINC Generate. Griffin is produced by Unisys<br />
Corporation. See also ORACLE.<br />
Griffin Universe<br />
A Griffin term for a logical storage area that may contain one or more LINC Databases.<br />
Equivalent of ORACLE SID. See also Tablespace.<br />
Group Global Setup Data item<br />
A Global Setup Data item that is a concatenation of a number of other Global Setup Data<br />
items. See Global Setup Data item.<br />
group query<br />
For LINC Ad Hoc Inquiry, an SQL format query whose output lines are for groups of<br />
related records (rather than individual records). The group is defined by including a<br />
GROUP BY clause, or by including group functions (such as MAX, MIN, SUM, and AVG) in<br />
the select list.<br />
Group Setup Data item<br />
A Setup Data item that is a concatenation of a number of other Setup Data items. See Setup<br />
Data Item.<br />
Glossary-6 v
H<br />
Glossary<br />
highlighting attribute<br />
An attribute of a data item or Display item that affects its appearance when displayed on a<br />
screen or printed in a LINC Report. For example, BRIGHT or REVERSE.<br />
Home position<br />
Top left corner of the screen. Often used as the position from which commands are<br />
entered.<br />
Home screen<br />
For LINC Ad Hoc Inquiry, the base screen from which the main functions are chosen.<br />
host list<br />
(1) The list of valid host types for which LINC Generate can perform reserved word<br />
checking and generation of LINC Systems. (2) The initial list is specified on installation. (3)<br />
Can be changed in the GLOBAL Specification, using the Supervisor screen.<br />
HUB Background Run<br />
For OS 2200 LINC Systems, a background run that processes external Automatic Entries.<br />
There is one LINC Background Run for each LINC Deployment. See also HUB.<br />
HUB<br />
I<br />
ICP<br />
The facility that controls external Automatic Entries between LINC Systems. See<br />
Automatic Entry, external Automatic Entry.<br />
See Initial Control Program (for OS 2200 based LINC Systems) and Ispec Control Program<br />
(for LINC Systems based on the UNIX operating system).<br />
Initial Control Program (ICP)<br />
The program that controls the generated Ispec subprograms in OS 2200 based LINC<br />
Systems. Contrast with Update Program (for MCP based LINC Systems) and Ispec Control<br />
Program (for LINC Systems based on the UNIX operating system).<br />
Insertable Global Logic<br />
A sequence of business rules (logic) and a screen layout that can be copied into any<br />
number of Ispecs and LINC Reports. Contrast with Performable Global Logic.<br />
interdatabase access<br />
The accessing of the database of an OS 2200 based LINC System by another OS 2200 based<br />
LINC System.<br />
v Glossary-7
Glossary<br />
internal Automatic Entry<br />
An Automatic Entry from within the same LINC System. See Automatic Entry. Contrast<br />
with external Automatic Entry.<br />
interrogation point<br />
For LINC Ad Hoc Inquiry, a regular interval during query execution when the status of that<br />
query is written to the database.<br />
Ispec<br />
(1) A collective term for Components and Events. (2) A contraction of the term Interface<br />
Specification. (3)See also Component, Event.<br />
Ispec Control Program (ICP)<br />
The program that controls the generated Ispec subprograms in LINC Systems based on the<br />
UNIX operating system. Contrast with Update Program (for MCP based LINC Systems)<br />
and Initial Control Program (for OS 2200 based LINC Systems).<br />
K<br />
Keyword<br />
A data item that has multiple data entry fields and display items. See also Keyword Term<br />
Item, Keyword Term Display.<br />
Keyword Term Display<br />
The Display item associated with a Keyword. See Keyword.<br />
Keyword Term Item<br />
The data item associated with a Keyword. See Keyword.<br />
L<br />
LDA<br />
See LINC Development.<br />
LDL Listing Utility<br />
A facility in LINC Generate used for printing a LINC Specification.<br />
LCOPY Utility<br />
(1) A utility that provides a means of backing up, maintaining and controlling LINC<br />
Specifications, on the same or different machines (and host types). (2) Formerly known as<br />
LINC Copy.<br />
LINC Ad Hoc Inquiry<br />
A facility used for making inquiries on a LINC Database.<br />
Glossary-8 v
Glossary<br />
LINC Administration Guide<br />
The LINC manual that contains instructions for administering and operating LINC Systems<br />
on a particular host type. See the front matter for details.<br />
LINC Background Run<br />
For OS 2200 LINC Systems, a background run that controls certain functions; for example<br />
recovery, report handling, and setting up of Common Banks. There is one LINC<br />
Background Run for each LINC Deployment.<br />
LINC Data Dictionary<br />
A collective name for the Local and Global data dictionaries. See Local Data Dictionary,<br />
Global Data Dictionary.<br />
LINC Database<br />
The database created in the generation of a LINC System. Used for storing data.<br />
LINC Deployment<br />
(1) A collective term for the software programs required to operate, control and audit a<br />
LINC System and its LINC Database. (2) Contrast with LINC Generate. (3) Formerly LINC<br />
Run Time.<br />
LINC Development<br />
(1) PC based development tool for creating and maintaining LINC Business Models (LINC<br />
Specifications). (2) LINC Business Models are transferred to host based LINC Generate for<br />
generation and deployment in LINC Deployment. (3) Formerly known as LDA III.<br />
LINC Development Environment<br />
A collective term for the tools used to design, develop and generate LINC Systems.<br />
Includes LINC Development, LINC Generate, and LINC utilities.<br />
LINC Development System<br />
See LINC Generate.<br />
LINC Development Test<br />
Part of LINC Development that enables testing of your LINC Business Model.<br />
LINC Editor<br />
A facility for specifying business rules (logic), expressed using LINC Logic commands and<br />
text.<br />
LINC Generate<br />
(1) The LINC Software used to generate LINC Specifications as LINC Systems for use in<br />
LINC Deployment. (2) Formerly known as LINC Development.<br />
LINCIIDIR<br />
LINCIIDIR is an environment variable specifying the LINC installation directory.<br />
v Glossary-9
Glossary<br />
LINC Installation Guide<br />
The LINC manual that contains instructions for installing and configuring LINC Systems on<br />
a particular host type. See the front matter for details.<br />
LINC Interactive Test Environment (LITE)<br />
(1) Software that enables testing and debugging of LINC Systems. (2) Interacts with LINC<br />
Generate and LINC Deployment.<br />
LINC Painter<br />
A facility of LINC Generate used to define an Ispec screen layout or Report Frame layout.<br />
LINC Report<br />
(1) Part of a LINC Specification, generated and used to produce output or to carry out<br />
specialized batch processing of a LINC Database. (2) Consists of Report Frames and<br />
Report Main logic, and a number of options that define the operation and output of the<br />
Report. (3) Many programs in LINC Generate and LINC Utilities are LINC Reports.<br />
LINC Report Output Control System (ROC)<br />
A utility that provides control over the output of a LINC Report.<br />
LINC Run Time<br />
See LINC Deployment.<br />
LINC Security Level<br />
A value from 0 through 9 that is assigned to a specific user or terminal to restrict access to<br />
various functions.<br />
LINC Security Module (LSM)<br />
A utility which provides security facilities for both LINC Generate and LINC Systems.<br />
LINC Specification<br />
(1) The source definition of a LINC System. LINC Specifications are stored within LINC<br />
Generate. (2) The result of specifying a LINC Business Model using LINC Development. (3)<br />
The source from which a LINC System is generated.<br />
LINC System<br />
The set of programs (and database) generated from a LINC Specification.<br />
LINC System command<br />
A command to assist in the operation of a LINC System or LINC Report. Formerly known<br />
as a colon command.<br />
LITE<br />
See LINC Interactive Test Environment.<br />
Glossary-10 v
Glossary<br />
local Data Dictionary<br />
A data dictionary that controls the use of data items within a single LINC Specification. See<br />
also LINC Data Dictionary, Global Data Dictionary.<br />
locked query<br />
For LINC Ad Hoc Inquiry, a query that is not available for editing or running because it is<br />
currently queued for execution, or its execution has terminated abnormally, or it is being<br />
edited.<br />
logically deleted<br />
A term used to describe the status of an Ispec record that has been deleted from a database<br />
as far as all processes are concerned, but is physically still present.<br />
LSM<br />
See LINC Security Module.<br />
LSM security<br />
For LINC Ad Hoc Inquiry, the security imposed by the LINC Security Module (LSM). If in<br />
effect, user access to queries and the limits associated with queries may be restricted.<br />
M<br />
Main Logic<br />
A section of user-specified Ispec logic that is executed after any Pre-LINC logic and LINC<br />
automatic editing and validating sequences have been executed.<br />
MAINT<br />
(1) A System Data item, stored with each record of every Standard, Table, and Multiple<br />
Ordinate Memo Component, that indicates whether that record is added, changed or<br />
deleted. (2) A screen field for every Standard, Table, and Multiple Ordinate Memo<br />
Component used to indicate the database maintenance action request.<br />
Maintenance Mode<br />
A Painter facility that enables an existing Ispec screen layout or Report Frame to be<br />
modified.<br />
Memo Component<br />
A Component type that has no Ordinate, and which is used to store data of a memorandum<br />
nature. See Component, Multiple Ordinate Memo Component.<br />
Memo Data<br />
Memo-type, optional Ispec data that is stored separately to the primary Ispec records to<br />
assist with the optimization of disk usage. Valid for MCP based LINC Systems only. See<br />
Ispec.<br />
v Glossary-11
Glossary<br />
Menu Assistance<br />
A LINC Painter facility that provides assistance when painting an Ispec screen layout or<br />
LINC Report Frame.<br />
menu format query<br />
A query created using the various selection screens of LINC Ad Hoc Inquiry. Contrast with<br />
SQL format query.<br />
MLA<br />
Module<br />
See Multiple Language Mode.<br />
LINC Specification that is a subset of a Module Master. When generated a Module<br />
produces a complete LINC System. See also Module Master.<br />
Module Master<br />
A complete LINC Specification that contains defined parts (Modules) that can be<br />
generated as separate LINC Systems. See also Module.<br />
multiple language facilities<br />
A collective term for the LINC facilities that enable a LINC System to be translated and<br />
used in up to fifteen different languages, from a single LINC Specification.<br />
Multiple Language Mode (MLA)<br />
An facility in a menu of LINC Generate that enables a language name or number to be<br />
defined. (2) See multiple language facilities.<br />
Multiple Ordinate Memo Component<br />
(1) A Memo Component with one or more Ordinates defined by a specified Profile (that is<br />
sometimes referred to as its Automaint Profile). (2) Similar to a Standard Component, but<br />
with multiple Ordinates. (3) See also Component, Standard Component and Automaint<br />
Profile.<br />
N<br />
NOF<br />
NOFORM<br />
See NOF.<br />
(1) A facility for interfacing to and from a LINC System, usually to an non-LINC System and<br />
terminals. (2) The interface to PowerClient uses NOF.<br />
Non-Formatted Input/Output (NOF)<br />
See NOF.<br />
Glossary-12 v
O<br />
Glossary<br />
Object Packaging<br />
Object packaging allows the creation of LINC executables from supplied LINC object files,<br />
the installation of LINC, the installation of LINC EIFs, and the maintenance of your LINC<br />
environment. It also allows the creation of new LINC object and executable packages<br />
which can include supplied EIFs. Packages can be created for distribution and as backups.<br />
Objects<br />
Objects are one of two methods of distributing LINC to customers. They are the set of<br />
LINC object files which must be built into executables on your site before LINC can be run.<br />
Objects files are built using Object Packaging. Contrast this with Executables<br />
Offline interface<br />
A facility for passing batches of high-volume, non-LINC transactions for a LINC System.<br />
OLTP<br />
See Online Transaction Processing.<br />
On Change Statistical Routine<br />
A statistical routine (for example, AVERAGE;) that can be performed on a data item as<br />
part of an ON.CHANGE; LINC Logic command.<br />
Online Transaction Processing (OLTP)<br />
A generic method for transferring transactions to other systems.<br />
ORACLE<br />
Relational Database Management System used as the underlying database software for<br />
LINC Systems based on the UNIX operating system. ORACLE is produced by Oracle<br />
Corporation. See also Griffin.<br />
ORACLE SID<br />
An ORACLE term for a logical storage area that may contain one or more LINC Databases.<br />
Equivalent of Griffin Universe. See also Tablespace.<br />
Ordinate<br />
The data item of a Component that acts as the unique identifier of one record from<br />
another. The access path to individual Component records.<br />
v Glossary-13
Glossary<br />
P<br />
pack<br />
Painter<br />
patch<br />
The location in which part of a LINC System or LINC Database is stored. For a LINC System<br />
based on the UNIX operating system, a pack is either a Tablespace or a UNIX pathname.<br />
See LINC Painter.<br />
A set of changes to a LINC Specification made over a period of time by users signing on to<br />
LINC Generate under a specific patch identifier value.<br />
Patch identifier<br />
A number used to identify and group changes to a LINC Specification by one or more<br />
users. Applies when the patch identification option is selected for that LINC Specification.<br />
Contrast with Change identifier.<br />
Performable Global Logic<br />
A sequence of business rules (logic) that can be executed by any number of Ispecs and<br />
LINC Reports. Contrast with Insertable Global Logic.<br />
Pre-LINC Logic<br />
A section of user-specified Ispec logic that is executed before the Ispec Main logic is<br />
executed.<br />
Pre-Screen Logic<br />
A section of user-specified Ispec logic that is executed before the screen layout is<br />
displayed on the terminal.<br />
Primary Database Options screen<br />
The screen in LINC Generate for setting basic options and parameters for a LINC System.<br />
The screen displayed whenever a new LINC Specification is being created.<br />
Product Menu Utility<br />
Product Menu is a menu driven utility to access object packaging features. See Object<br />
Packaging for details of the functions that can be performed with Product Menu.<br />
Profile<br />
(1) An index to a specified selection of records. (2) A method of providing access to just<br />
those records that are required to perform a specific function. (3) A functional view of the<br />
database.<br />
Profile Data<br />
A data item that is physically stored in a Profile as well as in its associated Ispec. See also<br />
Profile.<br />
Glossary-14 v
Glossary<br />
Profile Ordinate<br />
The data item by which a Profile accesses individual records. A Profile can have several<br />
Profile Ordinates. See also Profile.<br />
Q<br />
query class<br />
See access class.<br />
Query Compiler<br />
For LINC Ad Hoc Inquiry, the part of LINC Ad Hoc Inquiry that validates an entered query<br />
and transforms it to a standard internal code and format. See also Query transformation.<br />
Query Front End<br />
For LINC Ad Hoc Inquiry, the part of LINC Ad Hoc Inquiry that allows a query to be entered.<br />
Query Optimizer<br />
The part of LINC Ad Hoc Inquiry that selects the most efficient way to access the LINC<br />
Database for a query.<br />
Query Output Handler<br />
The part of LINC Ad Hoc Inquiry that provides facilities to manipulate query output.<br />
Query Processor<br />
The part of LINC Ad Hoc Inquiry that interprets the query code and runs the query against<br />
the LINC Database.<br />
Query Processor report<br />
For LINC Ad Hoc Inquiry, the program that performs the functions of the Query Processor.<br />
This program is a LINC Report.<br />
query transformation<br />
For LINC Ad Hoc Inquiry, the process performed by the Query Compiler to convert a<br />
validated query into a standard internal form.<br />
queued query<br />
For LINC Ad Hoc Inquiry, a query waiting (for resources) to begin execution.<br />
v Glossary-15
Glossary<br />
R<br />
relation name<br />
For LINC Ad Hoc Inquiry, an SQL term equivalent to a Component, the Event file, or an<br />
Event Profile. Also called a table .<br />
relative day number<br />
A date expressed as the number of days since January 1 of the base year (which is<br />
accessible through the System Data item GLB.BASE). The relative day number of January<br />
1 of the base year is zero. See also base year.<br />
Report<br />
See LINC Report.<br />
Report Frame<br />
(1) Layout that contains display text and data items, and some associated logic that is part<br />
of a LINC Report. (2) The logic is executed (often to define the data items in the layout)<br />
and then the layout is included in the Report output. (3) Report Frames are accessed as<br />
single units from the logic of Report Frame or from Main logic of the Report.<br />
Report Initiation Program (RIP)<br />
An MCP based LINC utility that enables you to execute a line printer Report or terminal<br />
printer Report in batch mode.<br />
Report Output Control System (ROC)<br />
See LINC Report Output Control System.<br />
resource locking<br />
A facility of LINC Generate that prevents access to parts of a LINC Specification by more<br />
than one user at a time.<br />
ROC<br />
See LINC Report Output Control System.<br />
ROC Background Run<br />
For OS 2200 LINC Systems, a background run that identifies Report output requests and<br />
spools the output to the required print queue. There is one ROC Background Run for each<br />
LINC Deployment.<br />
row<br />
For LINC Ad Hoc Inquiry, an SQL term equivalent to a Component record or an Event<br />
record.<br />
Run Time Environment<br />
See LINC Deployment.<br />
Glossary-16 v
S<br />
Screen Build mode<br />
A Painter facility that is used to specify a new Ispec screen layout.<br />
Glossary<br />
search expression<br />
For LINC Ad Hoc Inquiry, a logical expression used in a search list to define records to be<br />
included in query output.<br />
search list<br />
For LINC Ad Hoc Inquiry, the part of a query that determines whether records will be<br />
included in the output.<br />
security access<br />
For LINC Ad Hoc Inquiry, full access to all queries.<br />
security class<br />
For LINC Ad Hoc Inquiry, a type of user access to queries. See access class.<br />
select list<br />
For LINC Ad Hoc Inquiry, the part of a query that defines the data items to be included in<br />
the output.<br />
Setup Data item<br />
A data item used in memory only for data manipulation by an Ispec or LINC Report. See<br />
also Global Setup Data item, Group Setup Data item.<br />
Shadow Report<br />
Part of a LINC Report used to produce additional output separate from that produced by<br />
the primary functions of the Report.<br />
Sleeping Report<br />
A Report that, by the use of the SLEEP; LINC Logic command, stops executing for a<br />
predetermined number of seconds or until reactivated by your LINC System.<br />
SOLAR<br />
For OS 2200 LINC Systems, a product used to install LINC Software.<br />
sort expression<br />
For LINC Ad Hoc Inquiry, a logical expression used in a sort list to define output sort order.<br />
sort list<br />
spooler<br />
For LINC Ad Hoc Inquiry, the part of a query that defines the order of the output.<br />
See Terminal Printer Spooler.<br />
v Glossary-17
Glossary<br />
SQL format query<br />
AnSQLqueryenteredinfreeformatinLINCAdHocInquiry.Contrast with menu format<br />
query.<br />
Standard Component<br />
A Component type that requires a single Ordinate. See also Component.<br />
Standard Report<br />
A specific type of Report that uses the LINC Report Output Control System, and whose<br />
output is written to the database. Subsequent use of the output is determined by the user.<br />
See Report Output Control System. Contrast with Direct Report.<br />
station<br />
structure<br />
(1) General term in LINC for method used to identify users. (2) For LINC Systems based on<br />
the UNIX operating system, station equates to user name, while for OS 2200 based LINC<br />
Systems, station equates to userid.<br />
(1) In LINC Generate, part of a LINC Specification that can be selected (for example, for<br />
printing, copying, or extraction). (2) For LINC Ad Hoc Inquiry, part of a LINC Database<br />
that can be the subject of a query.<br />
structure list<br />
For LINC Ad Hoc Inquiry, the part of a query that defines the structures to be included.<br />
One of the following:<br />
$ Component<br />
$ Event Profile<br />
$ All Events<br />
Supervisor<br />
A facility of LINC Generate enabling administration-level functions.<br />
System Data item<br />
(1) Data item that is automatically part of your LINC Specification. (2) Used for accessing<br />
or setting parameter or control-type data in LINC logic. (3) Some System Data Items are<br />
stored automatically in your LINC Database (for example, MAINT).<br />
Glossary-18 v
T<br />
table<br />
Glossary<br />
For LINC Ad Hoc Inquiry, an SQL term equivalent to a Component, the Event file, or an<br />
Event Profile. Also called relation name.<br />
Table Component<br />
A Component type that is used to store low-volume, frequently accessed data, such as code<br />
tables. See also Component.<br />
Tablespace<br />
Discrete part of an ORACLE SID or Griffin Universe. Tablespaces in the same ORACLE<br />
SID or Griffin Universe can be stored on different physical devices.<br />
Teach Screen<br />
A user-written screen display of information about an Ispec being used within a LINC<br />
System, intended to provide online help for users at run time.<br />
Terminal Printer Spooler (TPS)<br />
An MCP based LINC Utility that enables users to manipulate the output of a LINC Report<br />
to terminal printers.<br />
TPS<br />
Trace<br />
See Terminal Printer Spooler.<br />
(1) A facility to monitor the logic of an Ispec or Report in your LINC System. (2) Enabled in<br />
LINC Generate. (3) Contrast with LINC Interactive Test Environment.<br />
Translation Screen<br />
A copy of an Ispec screen that is modified to create a secondary language version.<br />
U<br />
Update program<br />
A generated program that contains the necessary logic for performing Ispec operations in a<br />
MCP based LINC System.<br />
Usage Input<br />
An Ispec attribute that enables a data item to be entered or displayed on the screen,<br />
accessed by logic, but not stored in the database.<br />
Usage Input Ispec<br />
An Event or Memo Component that is not output to the database, and where Data items<br />
default to Usage Input. (Individual data items can be set to Usage Inquiry.)<br />
v Glossary-19
Glossary<br />
Usage Input-Output<br />
An Ispec attribute that enables a data item to be entered or displayed on the screen,<br />
accessed by logic, and stored in the database.<br />
Usage Input-Output Ispec<br />
Ispec that is both Usage Input and Usage Output.<br />
Usage Inquiry<br />
An Ispec attribute that enables a data item displayed on the screen, but not to be entered<br />
on the screen, nor written to the database.<br />
Usage Output<br />
An Ispec attribute that enables a data item to be written to the database and accessed by<br />
logic, but not entered or displayed on the screen.<br />
Usage Output Ispec<br />
An Ispec that is written to the database, but does not have a screen display.<br />
V<br />
Validation EIF<br />
Validation EIFs are a special type of EIF which provide support for newly validated<br />
versions of LINC support software such as ORACLE, Griffin, COBOL, and Tuxedo.<br />
value expression<br />
For LINC Ad Hoc Inquiry, a logical expression used in an SQL format query to define a<br />
value, and made up of data items, literals, operators, and functions.<br />
value logic<br />
Logic associated with a Dictionary item that determines acceptable values for that item.<br />
version control<br />
A method for identifying different versions of a LINC System by version number,<br />
description, and generation date.<br />
Glossary-20 v
Index<br />
A<br />
applying an EIF, 4-9<br />
B<br />
buildable LINC Installation<br />
creating, 4-3, 4-4<br />
building executables, 4-12<br />
C<br />
creating<br />
LINC package, 4-13<br />
cursors in ORACLE<br />
allowing for, A-15<br />
cursor pool size, A-15, A-16<br />
D<br />
directory<br />
spool, 4-14<br />
disk space required, 1-2<br />
DMU<br />
for defining ORACLE SIDs, A-5, A-6, A-12<br />
DYNIX/ptx<br />
installing LINC Deployment, 2-3<br />
E<br />
EIF, 4-11<br />
applying, 4-9<br />
installation, 4-8<br />
validation, 4-9<br />
environment variables<br />
defining, 2-5<br />
executables<br />
building, 4-12<br />
installing LINC Deployment, 2-3<br />
extents in ORACLE, A-4<br />
G<br />
GMU<br />
for defining Griffin Universes, A-10<br />
for starting Griffin Universes, 3-2<br />
Griffin Universes<br />
changing LINC structures in Tablespaces,<br />
A-21<br />
choosing the number of, A-2<br />
configuring and tuning, A-1<br />
creating, A-8, A-10<br />
guidelines for configuring, A-8<br />
planning, A-2<br />
Tablespaces for, A-3<br />
tuning, A-17<br />
using GMU to define, A-10<br />
using GMU to start, 3-2<br />
H<br />
hardware required, 1-2<br />
I<br />
init.ora parameters for ORACLE SIDs, A-5,<br />
A-12<br />
installation<br />
EIF, 4-8<br />
validation checks, 2-5<br />
installing<br />
LINC Deployment executables, 2-3<br />
LINC Generate, 3-3<br />
preparing for, 1-1<br />
v Index-1
Index<br />
K<br />
kernel<br />
configuring, 1-3<br />
minimum values, 1-3<br />
L<br />
LINC<br />
building executables, 4-12<br />
creating a buildable installation, 4-3, 4-4<br />
creating a package, 4-13<br />
installing Deployment Objects, 4-3<br />
installing object packages, 4-4<br />
LINC Database Management Utility (DMU),<br />
A-5<br />
LINC Deployment<br />
contents of CD-ROM, 2-1<br />
Griffin Universe for, A-2<br />
installing, 2-1<br />
installing executables, 2-3<br />
ORACLE SIDs for, A-2, A-4<br />
LINC environment<br />
maintaining, 4-1<br />
LINC environments<br />
typical, 4-1<br />
LINC Generate<br />
contents of CD-ROM, 3-1<br />
Griffin Universe for, A-2<br />
installing, 3-1, 3-3<br />
LINC Griffin Database Management Utility<br />
(GMU), 3-2<br />
LINC tidy up script<br />
setting up, 2-5<br />
M<br />
memory required, 1-2<br />
O<br />
Objects<br />
creating a buildable LINC installation, 4-3,<br />
4-4<br />
installing, 4-3<br />
installing object packages, 4-4<br />
ORACLE Monitor, A-16<br />
ORACLE SIDs<br />
P<br />
changing LINC structures in Tablespaces,<br />
A-16<br />
choosing the number of, A-2<br />
configuring and tuning, A-1<br />
creating, A-4, A-6<br />
cursor pool size, A-16<br />
cursors, A-15<br />
db_block_buffers, A-13<br />
default configuration of , A-12<br />
dml_locks, A-13<br />
enqueue_resources, A-13<br />
guidelines for configuring, A-4, A-12<br />
init.ora parameters, A-5, A-12<br />
log_archive_dest, A-13<br />
log_archive_start, A-13<br />
log_buffer, A-13<br />
log_checkpoint_interval, A-14<br />
names for, A-2<br />
open_cursors, A-14<br />
planning, A-2<br />
processes, A-14<br />
rollback segments, A-4, A-5<br />
shared_pool_size, A-15<br />
Tablespaces for, A-3<br />
using DMU to define, A-5, A-6, A-12<br />
package<br />
creating a LINC package, 4-13<br />
removing spooled, 4-14<br />
spool directory, 4-14<br />
pre-installation requirements<br />
disk space, 1-2<br />
hardware, 1-2<br />
kernel configuration, 1-3<br />
for LINC Deployment, 2-2<br />
for LINC Generate, 3-2<br />
memory, 1-2<br />
software, 1-5<br />
swap space, 1-2<br />
product menu utility, 4-6<br />
PTX<br />
installing LINC Deployment, 2-3<br />
Index-2 v
R<br />
removing<br />
spooled packages, 4-14<br />
rollback segments in ORACLE, A-4, A-5<br />
S<br />
Sequent<br />
installing LINC Deployment, 2-3<br />
software required, 1-5<br />
space<br />
disk space required, 1-2<br />
memory required, 1-2<br />
swap space required, 1-2<br />
spooled package<br />
creating, 4-14<br />
removing, 4-14<br />
swap space required, 1-2<br />
T<br />
tidy up script<br />
setting up LINC, 2-5<br />
typical<br />
LINC environment, 4-1<br />
U<br />
uninstalling, 4-11<br />
uninstalling EIFs, 4-11<br />
UNIX kernel<br />
configuring, 1-3<br />
minimum values, 1-3<br />
V<br />
validation<br />
during LINC installation, 2-5<br />
validation EIFs, 4-9<br />
Index<br />
v Index-3
Tape<br />
Fold Here<br />
Airmail<br />
Unisys Australia Pty Ltd<br />
115-117 Wicks Rd<br />
North Ryde, NSW 2113<br />
Australia<br />
Cut along dashed line<br />
Do Not Staple<br />
Please Fold and Fasten<br />
Attention: ACUS Product Information<br />
Correct Airmail<br />
Postage Required<br />
Tape
Addition Deletion<br />
Revision Error<br />
<strong>Public</strong>ation title<br />
Document number<br />
Comments:<br />
Name<br />
Title<br />
Address<br />
City<br />
Help Us To Help You<br />
Unisys Corporation is interested in your comments and suggestions regarding this manual. We will<br />
use them to improve the quality of your Product Information. Please check type of suggestion:<br />
Company<br />
Date<br />
Telephone number<br />
( )<br />
State ZIP code
*-*