18.08.2013 Views

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 ...

SHOW MORE
SHOW LESS

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


*-*

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!