Simatic IT Unilab Database Job Structures

7/23/2019 Simatic IT Unilab Database Job Structures

1/17

s

Preface

Table of Contents

Introduction 1ORACLE Structure 2

ORACLE DB Views 3

ORACLE Associated Procedures 4

Unilab Job Management 5

Important info 6

SIMATIC IT Unilab 6.4

Unilab Database Job

Structures

Technical Note

Edition 11/2009


2/17

Siemens AGIndustry SectorPostfach 48 4890026 NRNBERGGERMANY

11/2009Copyright Siemens AG 2009Technical data subject to change

Guidelines

This manual contains notices intended to protect the products and connectedequipment against damage. These notices are graded according to severity by thefollowing texts:

Caution

Indicates that if the proper precautions are not taken, this can result into propertydamage.

Notice

Draws your attention to particularly important information on handling the product,the product itself or to a particular part of the documentation.

Trademarks

All names identified by are registered trademarks of the Siemens AG.The remaining trademarks in this publication may be trademarks whose use bythird parties for their own purposes could violate the rights of the owner.

Disclaimer of Liability

We have reviewed the contents of this publication to ensure consistency with thehardware and software described. Since variance cannot be precluded entirely, wecannot guarantee full consistency. However, the information in this publication isreviewed regularly and any necessary corrections are included in subsequenteditions.


3/17

Preface

Where is th is Technical Note valid?

This Technical Note is valid for Unilab 6.3 and higher.

Basic knowledge required

This guide is intended for SIMATIC IT Unilab users who are responsible forsystem configuration, such as application managers and system integrators(consultants). To be able to understand the concepts and examples discussed inthis guide, the reader should at least have taken the SIMATIC IT Unilab Basic

Training.

Purpose

Prior to version 6.2 of SIMATIC IT Unilab, the functionalities using jobs werebased on the Oracle standard package DBMS_JOB. As of version 6.2, this hasbeen replaced by another Oracle standard package DBMS_SCHEDULER.Additional note: this migration was necessary in order to fully support/implementmulti time zone jobs.

Conventions

The table below describes the specific typographic conventions that are usedthroughout this manual:

Symbol/Convention Indicates...

E.g. Where examples are given.

Text inbold The names of menus, commands, dialog boxesand toolbar buttons and, in general, all strings(e.g. Filemenu; Savecommand).

KEY1+KEY2 Shortcut keys, which permit rapid access tocommands (e.g. CTRL+C).

UPPERCASE The names of keyboard keys (e.g. RETURN key).

Italics Noun with special importance or significance forwhich emphasis is needed.

The names of parameters that must be replacedwith a specific name or value.

> A succession of commands in which the commandpreceding the symbol must be selected before thecommand following it.

Code exampl e

Code example.

SIMATIC IT Unilab V6.4 iii


4/17

Preface

SIMATIC IT Documentation Library

The SIMATIC IT Unilab Documentation Libraryprovides you with acomprehensive and user-friendly interface to access the overall productdocumentation where manuals and helps online can be browsed by functionalityor by component.

Readme

The installation includes a readme file, which contains information on upgradeprocedures and compatibility with previous releases. This file is supplied both instandard text (Readme.wri) and in Acrobat PDF (Readme.pdf) format.

This file is available in folder \ReleaseNotes of the setup DVD and is availablefrom the SIMATIC IT Unilab Documentation Library.

SIMATIC IT Training Center

Siemens IA AS MES offers a number of training courses to familiarize you withthe SIMATIC IT product suite. To successfully achieve this goal, training consistsof lessons in both theory and practice.

Courses are held year-round, according to a program that is published well inadvance of the first scheduled session.

The material on the basis of which our courses are conducted reflects the result ofyears of experience in process, LIMS, quality control and productionmanagement.

All courses are held by expert personnel that are aware of the developments andinnovations in the Siemens IA AS MES product suite.

Courses are held in English at the Siemens IA AS MES Training Centers.Upon request, training courses can also be organized on the customerspremises.

For more information on the training course calendar, please visit our technicalweb site (http://www.siemens.com/simatic-it/training).

SIMATIC IT Service & Support

A comprehensive Software Maintenance program is available with SIMATIC ITproducts. Software Maintenance includes the following services:

Software Update Service(SUS): automatic distribution of upgrades and

service packs

Technical Support Service(TSS): support on technical problems withSIMATIC IT software (standard support and other optional services)

Online Support: a technical web site, providing information such asFrequently Asked Questions and technical documentation on SIMATIC ITproducts

Software Update Service (SUS)

This service provides automatic shipment of new versions and service packswhen released. When a new version / service pack is available for shipping, it istypically shipped within one month.

SIMATIC IT Unilab V6.4iv
http://goaer42a/Documentation/DOC_TEMPLATES/CURRENT/TEMPLATESMANUALIUNICO/PRS_ENG_DOC.htmhttp://goaer42a/Documentation/DOC_TEMPLATES/CURRENT/TEMPLATESMANUALIUNICO/PRS_ENG_DOC.htmhttp://www.siemens.com/simatic-it/traininghttp://www.siemens.com/simatic-it/traininghttp://goaer42a/Documentation/DOC_TEMPLATES/CURRENT/TEMPLATESMANUALIUNICO/PRS_ENG_DOC.htmhttp://goaer42a/Documentation/DOC_TEMPLATES/CURRENT/TEMPLATESMANUALIUNICO/PRS_ENG_DOC.htm


5/17

Preface

One copy of the installation DVD is shipped for each Server covered by SoftwareMaintenance.

Hot fixes (officially tested and released) are not shipped and must be downloadedfrom the Technical Support ServiceWeb site.

Technical Support Service (TSS)

Siemens provides a dedicated technical support team for SIMATIC IT products..

The following options are available:

Bronze support: 9 hours/day, 5 days/week

Silver support: 24 hours/day, 5 days/week

Gold support: 24 hours/day, 7 days/week

The principal language of the SIMATIC IT hotline is English.

SIMATIC IT partners and customers covered by the Software Maintenanceprogram are entitled to direct access to the TSS.

Access to the TSS

To be able to access the TSS, the customer needs to register as a user on theTechnical Support Web site. Connect to http://www.siemens.com/mes-simaticit/and follow the Technical Support Servicelink.

The registration form must be completed with:

Personal data The required company and plant information

The Contract Number provided by Siemens Back Office when the contract isagreed.

Online Support

A customer who is a registered TSS user, can access the Technical Support Website (http://www.siemens.com/mes-simaticit/tss), which contains technicalinformation such as:

Service conditions (Phone numbers, Working hours, Reaction times,) SIMATIC IT knowledge base: a technical support database that includes

practical service solutions from the Technical Support or the SIMATIC ITcommunity

SIMATIC IT software (e.g. hot fixes, software examples) and release notesthat can be downloaded

SIMATIC IT cross-industry libraries that can be downloaded (limited access toSIMATIC IT certified partners)

SIMATIC IT product documentation that can be downloaded

Frequently Asked Questions and useful tips.

SIMATIC IT Unilab V6.4 v
http://www.siemens.com/mes-simaticit/http://www.siemens.com/mes-simaticit/tsshttp://www.siemens.com/mes-simaticit/tsshttp://www.siemens.com/mes-simaticit/


6/17

Table of Contents

SIMATIC IT Unilab V6.4vi

Table of Contents

Preface ......................................................................................................................................... ii i

Table of Contents ....................................................................................................................... vi

1 Introduction..........................................................................................................................1-1

1.1 Basic Definitions ............................................................................................................1-11.1.1 Oracle Instance.................................................................................................1-11.1.2 Services ............................................................................................................1-11.1.3 Job Classes ......................................................................................................1-11.1.4 Jobs...................................................................................................................1-1

2 ORACLE Structure ..............................................................................................................2-1

3

ORACLE DB Views ..............................................................................................................3-1

4 ORACLE Assoc iated Procedures ......................................................................................4-1

5 Unilab Job Management .....................................................................................................5-1

6 Important info ......................................................................................................................6-1


7/17

1 Introduction

This Technical Note has been written to provide users with information on the differencesexisting between Oracle and Unilab for what concerns job management.

1.1 Basic Definitions

1.1.1 Oracle Instance

Every running Oracle database is associated with an Oracle instance. When a database isstarted on a database server (regardless of the type of computer), Oracle allocates a memoryarea called the System Global Area (SGA) and starts one or more Oracle processes. Thiscombination of the SGA and the Oracle processes is called an Oracle instance. The memoryand processes of an instance manage the associated database's data efficiently and serve oneor multiple users of the database.

1.1.2 Services

Services represent groups of applications with common attributes, service level thresholds, andpriorities. Application functions can be divided into workloads identified by services. A servicecan span one or more instances of an Oracle database or multiple databases in a global cluster,

and a single instance can support multiple services.

The number of instances offering the service is transparent to the application. Services providea single system image to manage competing applications, and they allow each workload to bemanaged as a single unit.

1.1.3 Job Classes

A job class is a group of jobs that have similar characteristics and behaviour. A job class is away of grouping jobs into larger entities, thus enabling access to limited resources to beprioritized among the job classes.

1.1.4 Jobs

A job is a user-defined task that is scheduled to run one or more times. A job contains twopieces of information: what task (the action) needs to run, and when it should run (theschedule). The action and schedule can be specified when creating the job or alternatively canrefer to an existing program and schedule.

SIMATIC IT Unilab V6.4 1-1


8/17


9/17


2 ORACLE Structure


10/17


11/17


3 ORACLE DB Views

View Description

sys.gv_$instances Displays the Oracle DBinstances.

sys.DBA_services Displays the Oracle services.

sys.DBA_scheduler_Job_classes Displays the Oracle Jobclasses.

sys.DBA_scheduler_Jobs Displays the Oracle Jobs.


12/17


13/17


4 ORACLE Associated Procedures

Package Procedure Descript ion

DBMS_SERVICE Create_Service Creates a service.

Delete_Service Deletes a service.

Start_Service Starts a service.

Stop_Service Stops a service.

DBMS_SCHEDULER Create_Job_Class Creates a job class.

Drop_Job_Class Deletes a job class.Set_Attribute Sets an attribute for a

job.

Set_Scheduler_Attribute Sets an attribute for ascheduler.

Create_Job Creates a job.

Drop_Job Deletes a job.

Disable Disables a job.

Enable Enables a job.


14/17


15/17


5 Unilab Job Management

In Unilab, there is a one-to-one relationship between DB Instance and Service.

Each Service, except for Service_1, contains a single Job Class (namedUNI_JC_EventMgr_n).

Each Job Class contains all the Event Managers associated to the relative DB Instance.

Service_1 contains, in addition to UNI_JC_EventMgr_1, UNI_JC_OTHER_JOBS, whichcontains all other jobs, such as Version Manager, Timed Event Manager, etc..

Rather than using the Oracle associated procedures to manage services, job classes and jobs,Unilab uses proprietary procedure UNAPIEV.CreateDefaultServiceLayerto create the job-class layer and the connection with the services.

For an example on how to use the new Unilab job technology, see file cxapp.sql in ServerSetup/db.


16/17


17/17


6 Important info

As of Unilab 6.4, the scripts that launch the Unilab jobs (BEGINcxapp.startalldbjobs; END;) have been improved to control these structures.

For information on how to create the Oracle services necessary for the Unilabjobs, see manual Oracle RAC Support in the Unilab Product Library.

Documents

Simatic IT Unilab Database Job Structures