56
Reference Manual Genio Scheduler 8469-0M

genio scheduler

Embed Size (px)

Citation preview

Page 1: genio scheduler

Reference Manual

Genio Scheduler

8469-0M

Page 2: genio scheduler

8469-0M

Hummingbird Communications Ltd.1 Sparks Avenue, North York, Ontario, Canada M2H 2W1Telephone: +1-416-496-2200Fax: +1-416-733-5825BBS: +1-416-496-9233E-mail: [email protected] Site: www.hummingbird.comFTP: ftp.hummingbird.com

RESTRICTED RIGHTS LEGEND. Unpublished rights reserved under the copyright laws of the United States. The SOFTWARE is provided with restricted rights. Use, duplications, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c) (1)(ii) of The Rights in Technical Data and Computer Software clause at DFARS 252.227-7013, subparagraph (c)(1) and (2) (a) (15) of the Commercial Computer Software-Restricted Rights clause at 48 CFR 52.227-19, as applicable, similar clauses in the FAR and NASA FAR Supplement, any successor or similar regulation.

Copyright © 1999 Hummingbird Communications Ltd. All rights reserved. Genio Designer, Genio Scheduler, Genio Adminsitration Console, Genio Repository Manager, Genio Engine, Genio Polling, Genio Met@Data, Genio MetaLink for SAP are trendmarks of Hummingbird Communications Ltd.

All other copyrights, trademarks, and tradenames are the property of their respective owners.

DISCLAIMER. Hummingbird software and documentation has been tested and reviewed. Nevertheless, Hummingbird Communications Ltd. makes no warranty or representation, either express or implied, with respect to the software and documentation included. In no event will Hummingbird Communications Ltd. be liable for direct, indirect, special, incidental, or consequential damages resulting from any defect in the software or documentation included with these products. In particular, Hummingbird Communications Ltd. shall have no liability for any programs or data used with these products, including the cost of recovering such programs or data.

Information in this document is subject to change without notice and does not represent a commitment on the part of Hummingbird Communications Ltd. Not all copyrights pertain to all products.

This guide contains proprietary information that is protected by copyright. All rights are reserved. This guide may not be photocopied, reproduced, or translated into another language, in whole or in part, without prior written consent from Hummingbird.

This edition published June 1999.

Printed in Canada.

Page 3: genio scheduler

7DEOH�RI�&RQWHQWV

$ERXW�WKLV�%RRN Y

Who Should Read this Book? ..................................................................................................................v

Associated Documents ............................................................................................................................v

Conventions ............................................................................................................................................vi

,QWURGXFWLRQ �

Chapter Structure .................................................................................................................................... 8

Conceptual Overview .............................................................................................................................. 9

Launching other Genio applications from the Scheduler ...................................................................... 11

7KH�3URJUDPV�&RPSRQHQW ��

Creating and modifying a program ........................................................................................................ 14

Copying or moving programs ................................................................................................................ 23

Suspending or activating programs ....................................................................................................... 25

Refreshing programs ............................................................................................................................. 26

7KH�/RJV�&RPSRQHQW ��

Checking the process logs .................................................................................................................... 29

Log information ..................................................................................................................................... 29

Purging logs .......................................................................................................................................... 34

Refreshing logs ..................................................................................................................................... 36

7KH�+LVWRU\�&RPSRQHQW ��

Displaying Log Information............................................................................................................. 40Purging Logs .................................................................................................................................. 40Refreshing History View ................................................................................................................. 41

H u m m i n g b i r d ��LLL�� G e n i o S c h e d u l e r

7KH�5HDO�7LPH�$GPLQLVWUDWLRQ ��

Page 4: genio scheduler

7DEOH�RI�&RQWHQWV

G e n i o S c h e d u l e r ��LY�� H u m m i n g b i r d

Page 5: genio scheduler

$ERXW�WKLV�%RRN

:KR�6KRXOG�5HDG�WKLV�%RRN"

This book describes the scheduling aspects of Genio exploitation. It is intended as areference manual for all *HQLR�6XLWH users wanting to automate the launch of thepopulation processes they have defined in the 'HVLJQHU.

$VVRFLDWHG�'RFXPHQWV

For details on all aspects of Data populating process design, you may refer to the *HQLR'HVLJQHU�5HIHUHQFH�0DQXDO.

H u m m i n g b i r d - v - G e n i o S c h e d u l e r

For all topics related to the installation of *HQLR�6FKHGXOHU and the administration of userrights, refer to the *HQLR�6XLWH�6WDUWXS�*XLGH.

Page 6: genio scheduler

$ERXW�WKLV�%RRN &RQYHQWLRQV

&RQYHQWLRQV

Throughout this book the following notations have been applied :

6W\OH 0HDQLQJ ([DPSOH

Italics In the text, italics indicate a reference to applications or manuals of the Genio Suite.

The Scheduler.

Regular Arial Text in regular arial font denotes win-dow or window tab names.

Options

Courrier new

Text in regular fixed width courrier new font is used to represent file names or paths.

Crebas.sql

%ROG�$ULDO Bold Arial text is used to represent text that appears in the application, whether a button to click on, or a menu item.

&DQFHO

�.H\! Text between angle brackets represents keyboard or Mouse keys

�&WUO���6KLIW!

G e n i o S c h e d u l e r ��YL�� H u m m i n g b i r d

Page 7: genio scheduler

histenthain.

by the

processulatinghey are

,QWURGXFWLRQ

The *HQLR�6FKHGXOHU is *HQLR’s exploitation application. It provides planning for botGenio and external processes. It enables you to go from populating rules to consprocessing triggered according to a time schedule and integrated in the production c

You can launch other applications (i.e. $GPLQLVWUDWLRQ�0DQDJHU��'HVLJQHU��0HW#'DWD, ifyou have the appropriate user rights) directly from the 6FKHGXOHU.

Information in the 6FKHGXOHU often needs to be refreshed.

The Scheduler only uses objects managed (created or modified) in the 'HVLJQHU. Allprocesses and processing conditions are stored in the current repository. The VFKHGXOHU’saccess to all versions of all projects in the repository depends on the rights granted administrator.

The transition between the designing phase and the scheduling phase is made by theobject. Processes are the end-line objects in the designing phase. They allow the poptasks to be performed. Processes are the raw material for the scheduling phase. Ttherefore key objects in the 6FKHGXOHU.

H u m m i n g b i r d - 7 - G e n i o S c h e d u l e r

A process is a sequence of processes structured with the following tasks: modules, events,commits, rollbacks, message sending. A process enables you to manage triggering andvalidation of these tasks.

Page 8: genio scheduler

,QWURGXFWLRQ &KDSWHU�6WUXFWXUH

Processes are managed with scheduling tools. Tools are contextual. In other words, theyare available (their corresponding tool buttons are highlighted) only if they are useful towhat you have selected. Apart from a few tools which are generic (refresh, ...), all othertools are specific to the objects you are managing .

Four different views exist in the Scheduler. Each view can be accessed by clicking on thecorresponding icon. All four icons are shown below:

&KDSWHU�6WUXFWXUH

,WHPV�LQ�WKH�6FKHGXOHU Describes the different objects in the Scheduler window.

3URJUDPV�&RPSRQHQW The Programs�component lets you choose and schedule thetasks you want to carry out.

/RJV�&RPSRQHQW The Logs component enables you to see the different processexecutions chronologically grouped according to eachprocess.

+LVWRU\�&RPSRQHQW� The History component enables you to verify the history of allthe previous process executions and to view all the processexecutions scheduled in the future up until a given date. Itcontains the same information as the Logs component,organized differently.

5HDO�WLPH�DGPLQLVWUDWLRQ The Real-Time Administration component gives an overviewof background information. It displays the current state of thescheduler, engine and polling services, of the communicationand execution threads.

,03257$17� 0RVW�PDQLSXODWLRQV�RI�SURJUDPV�DQG�ORJV�GHVFULEHG�LQ�WKH�VHFWLRQV�EHORZ�UHTXLUH�WKH�6FKHGXOLQJ�VHUYLFH�WR�EH�ODXQFKHG�WR�EH�WDNHQ�LQWR�DFFRXQW��,I�WKLV�LV�QRW�WKH�FDVH��WKH\�ZLOO�EH�PHPRUL]HG�DQG�GLVSOD\HG��

3URJUDPV /RJV +LVWRU\ 5HDO�7LPH�$GPLQLVWUDWLRQ

G e n i o S c h e d u l e r ����� H u m m i n g b i r d

EXW�ZLOO�EHFRPH�HIIHFWLYH�RQO\�DW�WKH�QH[W�VWDUW�RI�WKH�6FKHGXOLQJ�VHUYLFH�

Page 9: genio scheduler

rs to

se

very

ed to

&RQFHSWXDO�2YHUYLHZ ,QWURGXFWLRQ

&RQFHSWXDO�2YHUYLHZ

This unit provides planning functions for Genio. The following chapter describes differentobjects in the Scheduler window.

• 3URMHFWV

Projects are the starting point of any Genio processing. The scheduler refeall the projects in the Designer. They contain all existing objects (folders, processes, etc...).

You can not create projects in the scheduler, you can only open them to uthe objects they contain.

� )ROGHUV

Folders are used to group objects together. You can work with folders at elevel of your project.

It is possible to hide or display the empty folders by clicking on . Thisbutton works like a switch and remains active if you don’t click it again.

• Processes

Processes are the main elements of the scheduler programs. They are uschain modules. Processes are created in the Designer only.

From the process icon, it is possible to:

- Verify process properties by double-clicking on the process.LWV�QDPH��

LWV�FUHDWLRQ�GDWH�

LWV�PRGLILFDWLRQ�GDWH�

SRVVLEOH�FRPPHQWV�

LWV�H[HFXWLRQ�GDWH�

- Program process executions by clicking on the button.

- Execute a process directly by clicking on the button.

H u m m i n g b i r d ����� G e n i o S c h e d u l e r

Page 10: genio scheduler

,QWURGXFWLRQ &RQFHSWXDO�2YHUYLHZ

� /RJV

Logs are lists of process execution descriptions. There are several flags for logs:

- Logs for successfully executed processes- Logs for erroneous process executions- Logs for forgotten processes- Logs for interrupted processes- Logs of processes that were not executed because of a non-ready engine

� +RVWV

Hosts represent the logical presence of a physical network host. Hosts are displayed in the Real-Time Administration module. They show the Genio hosts that are defined in the Genio Administration Console.

� *HQLR�VHUYLFHV

Services are managed in the Real-Time Administration module.

There are three types of Genio services:

3ROOLQJ�VHUYLFH��A polling service (or poller) is a detection module. Its purpose is to probe directories to see if one or several files have been created, modified, replaced or removed.

6FKHGXOHU�VHUYLFH��The service capable of scheduling all process executions in the future and of logging them for viewing. You can have only one scheduler service running on a Genio repository.

(QJLQH�VHUYLFH�The service in charge of executing the Genio tasks (processes, modules). It is in fact the motor. You can have up to one engine per host.

� *HQLR�WKUHDGV

There are two kinds of threads: administrator threads and execution threads. Administrator threads order the execution threads. There is one administrator thread per *HQLR service ( i.e. one on the VFKHGXOHU, one on each poller, one on each engine). Threads are seen in the 5HDO�7LPH�$GPLQLVWUDWLRQ module.

� *HQLR�HYHQWV

Events are actions which are capable of triggering process executions. They

G e n i o S c h e d u l e r ������ H u m m i n g b i r d

are triggered by processes. Events are managed in the (YHQW�0DQDJHU which

is run with the button. New events can be created with the button.

Page 11: genio scheduler

/DXQFKLQJ�RWKHU�*HQLR�DSSOLFDWLRQV�IURP�WKH�6FKHGXOHU ,QWURGXFWLRQ

/DXQFKLQJ�RWKHU�*HQLR�DSSOLFDWLRQV�IURP�WKH�6FKHGXOHU

7R�ODXQFK�DQ\�RWKHU�DSSOLFDWLRQ�IURP�WKH�6FKHGXOHU�

� Select the ’Scheduler’ item in the main menu.

� Select the ’Launch’ item in this Scheduler menu.

� Select one of the four applications to be launched from the scheduler:

� *HQLR�'HVLJQHU� *HQLR�$GPLQLVWUDWLRQ�&RQVROH� *HQLR�0HW#'DWD�6WXGLR� *HQLR�0HW#'DWD�([SORUHU

:$51,1*� 7KH�*HQLR�$GPLQLVWUDWLRQ�&RQVROH��*HQLR�0HW#'DWD�6WXGLR�DQG�*HQLR�0HW#'DWD�([SORUHU�FDQ�RQO\�EH�ODXQFKHG�LI�WKH�FRUUHVSRQGLQJ�ULJKWV�KDYH�EHHQ�JUDQWHG�WR�WKH�XVHU�

H u m m i n g b i r d ������ G e n i o S c h e d u l e r

Page 12: genio scheduler

,QWURGXFWLRQ /DXQFKLQJ�RWKHU�*HQLR�DSSOLFDWLRQV�IURP�WKH�6FKHGXOHU

G e n i o S c h e d u l e r ������ H u m m i n g b i r d

Page 13: genio scheduler

7KH�3URJUDPV�&RPSRQHQW

The Programs view is accessed by clicking on the�3URJUDPV�YLHZ�icon�

This hierarchical component displays the scheduled processes read in the currentrepository, in a structured view.

All nodes in this view can be expanded or collapsed thanks to the button.

Under the current root (displayed as the DSN name and the Database type), there can beone or several *HQLR projects, displayed. These projects are all read in the current *HQLRrepository.

These projects may contain one or several folders, depending on whether there were any

H u m m i n g b i r d - 13 - G e n i o S c h e d u l e r

created in the designer.

Page 14: genio scheduler

7KH�3URJUDPV�&RPSRQHQW &UHDWLQJ�DQG�PRGLI\LQJ�D�SURJUDP

Inside the project (or in the folders if there are any), all project versions are shown.Depending on the rights granted by the�*HQLR administrator (or in the *HQLR�$GPLQLVWUDWLRQ&RQVROH), these versions will or will not be able to be modified. If they are displayed ingrey, that means that you can view them but that you cannot modify them.

For each project version, all the processes are shown:

+LHUDUFK\�RI�WKH�6FKHGXOHU¶V�6WUXFWXUHG�9LHZ

&UHDWLQJ�DQG�PRGLI\LQJ�D�SURJUDP

Programs are created only on Processes. The program icon changes depending on whetherit is active or not.

Rootproject

version

[folder]

[folder]

process

processprocess

version

project

���������

G e n i o S c h e d u l e r ������ H u m m i n g b i r d

Page 15: genio scheduler

&UHDWLQJ�DQG�PRGLI\LQJ�D�SURJUDP 7KH�3URJUDPV�&RPSRQHQW

7R�SURJUDP�D�SURFHVV�IURP�WKH�µ6FKHGXOHU¶�ZLQGRZ

� Click 3URJUDPV or

� Open the desired project.

You access the list of folders, processes, etc... contained in your project.

� Click the process.

� Click right.

� Choose 1HZ�SURJUDP.

� Click left.

You access the first wizard window:

Four types of programming are available:

2QH�WLPH��DW�D�IL[HG�GDWH���KRXU

You can program the task at a given day or at a given hour. If you want to program a list of dates, you must create several programs.

3HULRGLFDOO\

You can execute a program periodically according to several options. You can only execute a task once a day, but if this is not enough, you can create several programs.

7ULJJHUHG�E\�DQ�HYHQW

A process program can be triggered by an event. This event may, in turn trigger another process program.

H u m m i n g b i r d ������ G e n i o S c h e d u l e r

7ULJJHUHG�E\�WKH�PRGLILFDWLRQ���SUHVHQFH�RI�D�ILOH

You can execute a program as a consequence of the modification and/or presence of a file (thanks to the 3ROOLQJ 6HUYLFH, if you have it).

Page 16: genio scheduler

7KH�3URJUDPV�&RPSRQHQW &UHDWLQJ�DQG�PRGLI\LQJ�D�SURJUDP

Thanks to the wizard, programming is an easy task where you just have to answerquestions.

127(� )XUWKHUPRUH��LW�LV�SRVVLEOH�WR�H[HFXWH�D�3URFHVV�LQ�LPPHGLDWH�PRGH�ZLWKRXW�KDYLQJ�WR�SURJUDP�LW��7R�GR�VR��

� Select the process.

� Click

r One time or fixed time programming

7R�SURJUDP�WKH�VFKHGXOHU�RQH�WLPH�RQO\��DW�D�IL[HG�GDWH���KRXU��IURP�WKHµ3URFHVV�3URJUDPPLQJ�:L]DUG¶�ZLQGRZ��

� Select the 2QH�WLPH��DW�D�IL[HG�GDWH���KRXU option

� Click 1H[W

You access the second wizard window:

� Pick the date using the scroll bar or enter the date manually in the corresponding line.

� Enter the time using the arrows in the corresponding areas.

� Click 1H[W.

G e n i o S c h e d u l e r ������ H u m m i n g b i r d

Page 17: genio scheduler

&UHDWLQJ�DQG�PRGLI\LQJ�D�SURJUDP 7KH�3URJUDPV�&RPSRQHQW

You access the third window of the wizard:

� Use the arrows to define the delay if a problem occurs.The default delay is 1 minute.

� Select the *HQLR Engine for the Process execution in the combo box.

� Choose whether the program is active or not.

� Press the )LQLVK button. If it is unavailable, press 1H[W.

r Periodical programming

7R�SHULRGLFDOO\�SURJUDP�WKH�6FKHGXOHU��IURP�WKH�µ3URFHVV�3URJUDPPLQJ:L]DUG¶�

� In the first step, select the 3HULRGLFDOO\ option.

� Click 1H[W.

H u m m i n g b i r d ������ G e n i o S c h e d u l e r

Page 18: genio scheduler

7KH�3URJUDPV�&RPSRQHQW &UHDWLQJ�DQG�PRGLI\LQJ�D�SURJUDP

You access the Periodical programming window of the wizard:

� Pick the type of interval using the Periodical programming scroll bar. The options are:

• Every day� Every week, on D ����H�J��¶)ULGD\¶�� Every month, on the N th ���H�J��¶�WK¶��� The first D of the month ��H�J��¶7XHVGD\¶�� The last D of the month �����H�J��¶:HGQHVGD\¶�� N days before the end of each month ����H�J�¶�¶�GD\V�

The window changes according to your choice.

If you choose (YHU\�GD\, go to step �.

If you choose (YHU\�PRQWK�RQ�WKH�>1WK@, choose the date of the month.

If you choose (YHU\�ZHHN��RQ�>'@, 7KH�ILUVW�GD\�>'@�RI�PRQWK, or 7KH�ODVW�>'@�RI�WKH�PRQWK you must pick the day of the week or the date, using the scroll arrow.

If you choose the >1@�GD\V�EHIRUH�WKH�HQG�RI�HDFK�PRQWK you will have to pick the number of days, using the scroll arrow.

� Enter the desired time of execution.

� Click 1H[W.You access the third wizard window: to see how to use it, please refer to the appropriate steps and corresponding illustration in ‘One time or fixed time programming’, on page 16.

G e n i o S c h e d u l e r ������ H u m m i n g b i r d

� Press the )LQLVK button. If it is unavailable, press 1H[W.

Page 19: genio scheduler

&UHDWLQJ�DQG�PRGLI\LQJ�D�SURJUDP 7KH�3URJUDPV�&RPSRQHQW

r Programming triggered by an event

7R�SURJUDP� WKH�VFKHGXOHU� � WR� WULJJHU� DQ� HYHQW�� IURP� WKH� µ3URFHVV3URJUDPPLQJ�:L]DUG¶�

� In the first step, select the Triggered by an event option.

� Click 1H[W.You access the second window of the Triggered by an event program option.

� Pick the task using the scroll bar, then go to step 7 or click to create a new event.

You access the Event Manager window:

In this window is displayed a list with two columns: the first contains the name of the eventsmanaged in the current project. The second column contains comments describing theseevents.

127(� (YHQWV�DUH�FURVV�SURMHFW�REMHFWV��$Q�HYHQW�GHILQHG�LQ�D�SURMHFW�LV�DYDLODEOH�WR�DOO�RWKHUV�LQ�WKH�UHSRVLWRU\�

H u m m i n g b i r d ������ G e n i o S c h e d u l e r

Page 20: genio scheduler

re is

vent

event

e

7KH�3URJUDPV�&RPSRQHQW &UHDWLQJ�DQG�PRGLI\LQJ�D�SURJUDP

Three buttons let you manipulate events:

To add an event.

To modify a selected event.

To delete a selected event.

A &ORVH button enables you to exit the tool.

When you activate the add or modify buttons, the Event properties window appears.Inside this window, there are two views designated by tabs: the General view and theDependencies view:

The ‘General’ view displays the name of the event and the associated comment if theone.

The Dependencies view displays the name of the processes which depend on this eand those which use this event. This view consists of two areas.

• The upper area summarizes the processes responsible for triggering the (with their name, project, version and status).

• The lower area summarizes the processes programmings triggered by thevent (with their name, project, version and status).

G e n i o S c h e d u l e r ������ H u m m i n g b i r d

Page 21: genio scheduler

&UHDWLQJ�DQG�PRGLI\LQJ�D�SURJUDP 7KH�3URJUDPV�&RPSRQHQW

� Click the 1HZ button.*HQLR creates the new event.

� Click &ORVH

� Click the event which triggers the event using the scroll bar.

� Click 1H[W.You access the third wizard window: to see how to use it, please refer to the appropriate steps and corresponding illustration in ‘One time or fixed time programming’, on page 16.

� Press the )LQLVK button.

r Programming triggered by the modification/presence of a file

7R�SURJUDP�WKH�VFKHGXOHU�WR�WULJJHU�WKH�FXUUHQW�SURFHVV�RQ�PRGLILFDWLRQ�SUHVHQFH�RI�D�ILOH��

� Select the 7ULJJHUHG�E\�WKH�PRGLILFDWLRQ�SUHVHQFH�RI�D�ILOH option.

� Click 1H[W.You now access the second window of the wizard:

H u m m i n g b i r d ������ G e n i o S c h e d u l e r

Page 22: genio scheduler

7KH�3URJUDPV�&RPSRQHQW &UHDWLQJ�DQG�PRGLI\LQJ�D�SURJUDP

The Polling modes are the following:

With all these modes, WKH�ILOH refers to the file defined in the File area of the wizard windowabove.

:DLW�IRU�ZULWH�DFFHVV��� The :DLW�IRU�ZULWH�DFFHVV�WR�WULJJHU�HYHQW polling modecan be used in combination with any other polling mode. Ifthis mode is selected, the process is triggered as soon as thepolling service detects that the user account on which it isrunning has write access on this file.

&UHDWLRQ As soon as the polling service detects that the file is present,the process is triggered. This supposes that the file waspreviously missing (i.e. Not Found or Deleted) and that it isnow present.

'HOHWLRQ As soon as the polling service detects that the file has beendeleted, the process is triggered.

0RGLILFDWLRQ As soon as the polling service detects that the file has beenmodified, that is if the file modification date has been changedbut not the creation date, the process is triggered.

5HSODFH As soon as the polling service detects that the file has beenreplaced, that is if the file creation date has been changed, theprocess is triggered.

&$87,21� 7KH�5HSODFH�PRGH�GRHV�QRW�ZRUN�LI�WKH�ILOH�LV�UHDG�XQGHU�:LQGRZV�17�7KLV�LV�EHFDXVH�ZKHQ�\RX�UHSODFH�D�ILOH�XQGHU�:LQGRZV�17��LWV�FUHDWLRQGDWH�GRHV�QRW�FKDQJH��6R��LI�\RX�ZDQW�\RXU�SURFHVV�WR�EH�WULJJHUHG��XVHWKH�0RGLILFDWLRQ�PRGH�LQVWHDG�

� Select the Polling Engine from the list using the combo box.

The Polling Engine is the name of the host on which the polling service is running. The trigger file must be located on or visible from this host.

� Select the file whose behavior will trigger the process, with the Browse button.

� Check the option from the 3ROOLQJ�0RGH options (see above for explanations).

� Click 1H[W.You access the third wizard window. To see how to use it, please refer to the appropriate steps and corresponding illustration in ‘One time or fixed time programming’, on page 16.

� Press the )LQLVK button. If it is unavailable, press 1H[W.

G e n i o S c h e d u l e r ������ H u m m i n g b i r d

Page 23: genio scheduler

&RS\LQJ�RU�PRYLQJ�SURJUDPV 7KH�3URJUDPV�&RPSRQHQW

r Initializing global variables before process execution

If some global user variables used in the process you are programming have been set to$VN�IRU�YDOXH�DW�H[HFXWLRQ in the Description view of their Variable window (VHH*HQLR�'HVLJQHU�5HIHUHQFH�0DQXDO), the following extra window will appear in the wizard.

� Check the names of the variables used in the Process you are scheduling.

� Check the current value(s) of these variables.

� Enter the new value for each variable, if necessary.

The variables will be initialized with these values just before the Process execution is triggered by the Scheduler service.

� Press )LQLVK.

The current Process is programmed or re-programmed.

&RS\LQJ�RU�PRYLQJ�SURJUDPV

127(� $V� LQ� DQ\� VWDQGDUG�:LQGRZV�DSSOLFDWLRQ�� LQ� RUGHU� WR�FRS\� D� SURJUDPZLWKLQ�WKH�VFKHGXOHU�YLHZ��VLPSO\�SUHVV�&WUO�DQG�GUDJ�GURS�LW�DW�WKH�VDPHWLPH�IURP�RQH�SODFH�WR�DQRWKHU��7R�PRYH�D�SURJUDP�ZLWKLQ�WKH�VFKHGXOHUYLHZ��VLPSO\�GUDJ�GURS�LW�IURP�RQH�SODFH�WR�DQRWKHU����

H u m m i n g b i r d ������ G e n i o S c h e d u l e r

Page 24: genio scheduler

7KH�3URJUDPV�&RPSRQHQW &RS\LQJ�RU�PRYLQJ�SURJUDPV

r Copy or move a single program

7R�FRS\�RU�PRYH�D�VLQJOH�SURJUDP�RQWR�DQ\�RWKHU�SURFHVV�

� Drag (pressing &WUO to copy) the program to be copied or moved.

� Drop it on a new process.

r Copy or move all the programs associated with a process

7R�FRS\�RU�PRYH�DOO�SURJUDPV�DVVRFLDWHG�WR�D�SURFHVV�RQWR�WKH�VDPHSURFHVV�LQ�D�GLIIHUHQW�YHUVLRQ�RI�WKH�VDPH�SURMHFW�

� Drag (pressing &WUO to copy) the process with which all these programs are associated.

� Drop it on the same process name in a different version of the same project.

r Copy or move all the programs of a project version

7R�FRS\�RU�PRYH�DOO�SURJUDPV��WR�D�QHZ�YHUVLRQ�RI�WKH�VDPH�SURMHFW

� Drag (pressing &WUO to copy) the version with which all these programs are associated.

� Drop it on another version of the same project.

127(6� 7KH�SURJUDPV�DUH�FRSLHG�RU�PRYHG�RQO\�ZKHQ�WKH�SURFHVV�QDPHV�DUHWKH�VDPH��7KH�SURJUDPV�DUH�FRSLHG�RU�PRYHG�ZKHUHYHU�WKH�DVVRFLDWHGSURFHVVHV�DUH�SODFHG�LQ�WKH�VFKHGXOLQJ�WUHH�

G e n i o S c h e d u l e r ������ H u m m i n g b i r d

Page 25: genio scheduler

6XVSHQGLQJ�RU�DFWLYDWLQJ�SURJUDPV 7KH�3URJUDPV�&RPSRQHQW

6XVSHQGLQJ�RU�DFWLYDWLQJ�SURJUDPV

r Suspend or activate a single program

7R�VXVSHQG�RU�DFWLYDWH�D�VLQJOH�SURJUDP�

� Select the program.

� Click once on the button to activate the program if it is inactive or to suspend it, if it is active.

r Suspend or activate all programs on a process

7R�VXVSHQG�RU�DFWLYDWH�DOO�SURJUDPV�RQ�D�SURFHVV�

� Select the process which the programs you want to suspend or activate are associated with.

� Click once on the button to suspend the programs associated to this process or twice to activate it.

r Suspend or activate all programs in the entire version of a project

7R�VXVSHQG�RU�DFWLYDWH�DOO�SURJUDPV�RQ�D�SURMHFW�YHUVLRQ�

� Select the project version which the programs you want to suspend or activate belong to.

� Click once on the button to suspend all programs belonging to the selected project version or twice to activate it.

&$87,21� ,I� D� SURFHVV� RU� D� YHUVLRQ� KDV� QRQ�FRQVLVWHQW� SURJUDPV� �L�H�� VRPH

H u m m i n g b i r d ������ G e n i o S c h e d u l e r

VXVSHQGHG�DQG�VRPH�DFWLYH��� WKH�GHIDXOW�DFWLRQ�ZKHQ�\RX�SUHVV�WKHEXWWRQ�LV�WR�VXVSHQG�DOO�SURJUDPV�

Page 26: genio scheduler

7KH�3URJUDPV�&RPSRQHQW 5HIUHVKLQJ�SURJUDPV

5HIUHVKLQJ�SURJUDPV

r Refresh an entire process

7R�UHIUHVK�DQ�HQWLUH�SURFHVV

� Select a process from the Programs View.

� Press the button in the tool bar to refresh the entire process.

This refreshes all programs, and events on this process.

r Refresh an entire project version

7R�UHIUHVK�DQ�HQWLUH�SURMHFW�YHUVLRQ

� Select a project version from the Programs View.

� Press the button in the tool bar to refresh the entire version.

This refreshes all folders, processes, programs, and events.

r Refresh an entire project

7R�UHIUHVK�DQ�HQWLUH�SURMHFW

� Select a project from the Programs View.

� Press the button in the tool bar to refresh the entire project.

This refreshes all versions, folders, processes, programs, and events.

G e n i o S c h e d u l e r ������ H u m m i n g b i r d

Page 27: genio scheduler

5HIUHVKLQJ�SURJUDPV 7KH�3URJUDPV�&RPSRQHQW

r Refresh the entire repository

7R�UHIUHVK�DQ�HQWLUH�UHSRVLWRU\

� Select the entire *HQLR root by clicking once on the icon in the Programs view.

� Press the button in the tool bar to refresh the entire view.

This refreshes all projects, versions, folders, processes, programs, and events.

H u m m i n g b i r d ������ G e n i o S c h e d u l e r

Page 28: genio scheduler

7KH�/RJV�&RPSRQHQW 5HIUHVKLQJ�SURJUDPV

7KH�/RJV�&RPSRQHQW

The Logs view is accessed by clicking on the /RJV�YLHZ�LFRQ�

The Logs component enables you to verify the logs of all the previous executions. Thishierarchical component displays the scheduled processes read in the current repository, ina structured view.

All nodes in this view can be expanded or collapsed thanks to the button. Under thecurrent root (displayed as the DSN name and the Database type), there can be one or several*HQLR projects, displayed. These projects are all read in the current Genio repository.

These projects may contain one or several folders, depending on whether there were anycreated in the designer.

Inside the project (or in the folders if there are any), all project versions are shown.Depending on the rights granted by the Genio administrator (in the *HQLR�$GPLQLVWUDWLRQ&RQVROH), these versions will or will not be able to be modified. If they are displayed ingrey, that means that you can view them but that you cannot modify them.

For each project version, all the processes are shown.

With this component, you can:

� &KHFN�WKH�SURFHVV�ORJV

- The process execution was successful.- An error occurred during the execution.- The process has been omitted.- The process has been interrupted.

� &RQVXOW�WKH�ORJ�LQIRUPDWLRQ

- Verify the information for each process logs.

G e n i o S c h e d u l e r ������ H u m m i n g b i r d

� 3XUJH�WKH�H[HFXWLRQV

- Clear the executions, selectively.

Page 29: genio scheduler

ted.

cens by

tion

&KHFNLQJ�WKH�SURFHVV�ORJV 7KH�/RJV�&RPSRQHQW

&KHFNLQJ�WKH�SURFHVV�ORJV

7R�FKHFN�WKH�ORJV�RI�D�SURFHVV��IURP�WKH�µ6FKHGXOHU¶�ZLQGRZ

� Click the History tab.

� Open a project.

You access the list of folders and processes contained in your project.

Displaying Log Information

There are three ways of visualizing a log, in other words of displaying log information, inthe History view:

• By double-clicking on the log itself.

• By clicking on the button in the tool bar when the log is already selec• By right-clicking on the log and selecting the 'LVSOD\�/RJ�,QIRUPDWLRQ

pop-up item.

You access the Log information window. Depending on the way the execution took plathe icons at the beginning of the line change. You can check the meaning of the ico

clicking on . You then access the Legend widow which explains the icons.

127(� 7KH� ¶/RJ� ,QIRUPDWLRQ¶� ZLQGRZ� LV� PRGHOHVV� EXW� LW� LV� DOZD\V� LQ� WKHIRUHJURXQG��<RX�FDQ�JR�IURP�ORJ�LQIRUPDWLRQ�WR�ORJ� LQIRUPDWLRQ�ZLWKRXWKDYLQJ�WR�FORVH�LW�

/RJ�LQIRUPDWLRQ

The log information window has four tabs. They display all necessary informaconcerning one specific execution of a single process.

H u m m i n g b i r d ������ G e n i o S c h e d u l e r

Page 30: genio scheduler

7KH�/RJV�&RPSRQHQW /RJ�LQIRUPDWLRQ

The�Log�view

The Log view shows process execution status. It also shows starting date, ending date,elapsed time and name of the event responsible for triggering this process (if this is thecase). When the process is triggered by a polling event, the name of the polled file isdisplayed, too.

G e n i o S c h e d u l e r ������ H u m m i n g b i r d

Page 31: genio scheduler

/RJ�LQIRUPDWLRQ 7KH�/RJV�&RPSRQHQW

The Volume view

The Volume view displays the connections for tables, views, look ups and cubes. It alsoshows the number of insertions, deletions or updates that were made on each objectimpacted by the process objects. Depending on the connectivity, volume information is notalways available. In this case, the word ³8QNQRZQ´�is displayed.

H u m m i n g b i r d ������ G e n i o S c h e d u l e r

Page 32: genio scheduler

7KH�/RJV�&RPSRQHQW /RJ�LQIRUPDWLRQ

The Console view

The Console view shows all the actions that the process has done. For example it givesinformation on the beginning and the end of a module, the SQL queries executed and themessages created in the scripts. It is possible to save the contents of the console, using theSave console button. When you press this button, the contents of the console are copied inthe Windows notepad (after that, you may paste this information anywhere you like).

G e n i o S c h e d u l e r ������ H u m m i n g b i r d

Page 33: genio scheduler

/RJ�LQIRUPDWLRQ 7KH�/RJV�&RPSRQHQW

The Exceptions view

The Exceptions view displays the list of exceptions generated by a process execution.

In the exception view there are two options and three areas:

• The�6HOHFW�YLHZ�PRGH enables you to choose whether you want *HQLR to sort the exceptions by exception types ( V\VWHP types or else XVHU types: Type mode) or by their place in the process (Process mode). You can check or uncheck the items displayed in this view.

H u m m i n g b i r d ������ G e n i o S c h e d u l e r

Page 34: genio scheduler

e

7KH�/RJV�&RPSRQHQW /RJ�LQIRUPDWLRQ

The system types of exceptions are the following:

Other types of exceptions (User exceptions) are created in *HQLR�'HVLJQHU. Please refer to the *HQLR�'HVLJQHU�5HIHUHQFH�0DQXDO.

• The exception�area on the upper right-hand side of the window displays thnumber, type, process line, corresponding object type that the exception occurs on, the object name and the DBerror generated. The exception areadisplays all this in separate columns.

• The description area, at the bottom of the window displays the detailed description of the exception you have selected in the exception area.

If the value of the @ExceptionMode system variable is set to�’ �’ , when the exceptions occur, these variables will be shown in a separate column of the area, on the right. For more information, please refer to the description of @ExceptionMode in the *HQLR�'HVLJQHU�5HIHUHQFH�0DQXDO.

#&RQQHFWLRQ([FHSWLRQ Genio generates this exception when it could not con-nect to a database.

#64/([FHSWLRQ Genio generates this exception when the database could not understand the SQL clause.

#&RKHUHQFH([FHSWLRQ Genio generates this exception when the module fails during the coherence test.

#([SUHVVLRQ([FHSWLRQ Genio generates this exception when it does not understand the calculated expression.

#2/$3([FHSWLRQ Genio generates this exception when it meets prob-lems with multidimensional connection levels.

G e n i o S c h e d u l e r ������ H u m m i n g b i r d

Page 35: genio scheduler

3XUJLQJ�ORJV 7KH�/RJV�&RPSRQHQW

3XUJLQJ�ORJV

The Purge option clears logs (those you select, al the logs of a process, all the logs in therepository between two dates). When you choose to remove a Log, a window appears tooffer you the possibility of also deleting all the Fixed Time programs of the processesinvolved. This avoids the recreation of Forgotten Program Logs.

r Clearing out a selected log

7R�FOHDU�D�ORJ��IURP�WKH�µ6FKHGXOHU¶�ZLQGRZ�

� Click the Logs tab.

� Open the project.

You access the list of folders and processes in your project.

� Open the process.

You access the list of process logs.

� Click the log.

� Click .

You access the Purge window:

� Click 3XUJH to clear the log

Your log is removed from the list.

H u m m i n g b i r d ������ G e n i o S c h e d u l e r

Page 36: genio scheduler

7KH�/RJV�&RPSRQHQW 3XUJLQJ�ORJV

r Clearing out all logs of a process

7R�FOHDU�RXW�D�DOO�ORJV�RI�D�SURFHVV��IURP�WKH�µ6FKHGXOHU¶�ZLQGRZ�

� Click History.

� Click the project.

� Click the process.

� Click

You access the Purge menu.

� Select the DOO�H[HFXWLRQV�RI�WKLV�SURFHVV�option.

� Click 3XUJH.

You access the Scheduler window.

� Click 2..

r Clearing out the logs between two dates

7R�FOHDU�RXW�H[HFXWLRQV�EHWZHHQ�WZR�GDWHV��IURP�WKH�µ6FKHGXOHU¶�ZLQGRZ�

� Click the History tab.

� Click the project.

� Click the process.

� Click

You access the Purge menu.

� Select between two dates option.

� Pick the desired Begin date and End date from the calendar with the scroll bar.

� Click 3XUJH.

You access the Scheduler window.

� Click 2..

G e n i o S c h e d u l e r ������ H u m m i n g b i r d

Page 37: genio scheduler

5HIUHVKLQJ�ORJV 7KH�/RJV�&RPSRQHQW

5HIUHVKLQJ�ORJV

r Refresh a single process

7R�UHIUHVK�D�VLQJOH�ORJ

� Select a process from the Logs View.

� Press the button in the tool bar to refresh the entire process.

r Refresh all logs in a project version

7R�UHIUHVK�DOO�ORJV�LQ�D�SURMHFW�YHUVLRQ

� Select a project version from the Logs View.

� Press the button in the tool bar to refresh the entire version.

This refreshes all folders, processes and logs in the selected project version.

r Refresh all logs in an entire project

7R�UHIUHVK�DOO�ORJV�LQ�D�SURMHFW

� Select a project from the Logs View.

� Press the button in the tool bar to refresh the entire project.

This refreshes all versions, folders, processes and logs in the selected project.

H u m m i n g b i r d ������ G e n i o S c h e d u l e r

Page 38: genio scheduler

7KH�/RJV�&RPSRQHQW 5HIUHVKLQJ�ORJV

r Refresh all logs in the entire repository

7R�UHIUHVK�DOO�ORJV�LQ�WKH�UHSRVLWRU\

� Select the entire *HQLR root by clicking once on the icon in the Logs View.

� Press the button in the tool bar to refresh the entire view.

This refreshes all projects, versions, folders, processes and logs in the repository.

G e n i o S c h e d u l e r ������ H u m m i n g b i r d

Page 39: genio scheduler

5HIUHVKLQJ�ORJV 7KH�+LVWRU\�&RPSRQHQW

7KH�+LVWRU\�&RPSRQHQW

The History view is accessed by clicking on the�+LVWRU\�YLHZ�LFRQ�

The History view displays all necessary information concerning the logs, but in a KLVWRULFDO(FKURQRORJLFDO) presentation, whereas the Logs view displays them in a structural(hierarchic) manner. Each view column displays a different type of information about thelogs.

As mentioned above, this view is mainly chronological. By default, it shows all the logs inthe current repository by increasing date and time.

H u m m i n g b i r d ������ G e n i o S c h e d u l e r

Page 40: genio scheduler

geng to

a loge

7KH�+LVWRU\�&RPSRQHQW 5HIUHVKLQJ�ORJV

Nevertheless, if you wish, you can sort the entire log view according to other criteria simplyby clicking on the respective column header:

• Name of the associated project (Project Name column)• Status of that project (Project Status column)• Version of that project (Project Version column)• Name of the process that the log accounts for (Process Name column)• Duration of the process execution (Execution Duration column )• Number of exceptions in the process (Number of Exceptions column)

&KURQRORJLFDO�/RJ�9LHZ

To return to the chronological view of all logs, just go back and click the Date and Timecolumn header (the first one from the left).

$OSKDEHWLF�DQG�1XPHULF�'LVSOD\�2UGHU

Some of the columns in the History view, such as Date and Time, Execution Duration,Number of Exceptions, contain strictly numeric information. When you want to chanthe order of the fields in those columns (that is change the display from increasidecreasing or from decreasing to increasing), just FOLFN�RQFH�RQ�LWV�FROXPQ�KHDGHU�

/RJ�7\SHV

In *HQLR, there are different types of process logs. You can recognize the type of displayed in the History view (or in the Log view, for that matter) by looking at the littlcolor symbol that the log has just in front of it in the Date and Time column. To know themeaning of these symbols you have an easy to read Legend, in the Legend window:

G e n i o S c h e d u l e r ������ H u m m i n g b i r d

Page 41: genio scheduler

ted.

‘Log

5HIUHVKLQJ�ORJV 7KH�+LVWRU\�&RPSRQHQW

)XWXUH�3URJUDPV

Programs scheduled for the future (i.e. in relation to server date and server time) are also

displayed in the History view. They have a special symbol, in front of them: In theFilter Definition window, described below, you can give a maximum date. Event andPolling programs are not displayed, nor are the suspended scheduled programs.

&$87,21� ,I�HLWKHU�WKH�PD[LPXP�GDWH�RU�WKH�GHIDXOW�PD[LPXP�GDWH�GHILQHG�LQ�WKHILOWHU�DUH�WRR�IDU�LQ�WKH�IXWXUH��DQG�WKDW�DUH�PDQ\�SURJUDPV�VFKHGXOHG�IRUWKH�IXWXUH� LQ�\RXU�UHSRVLWRU\��\RX�PD\�UHWULHYH�D�JUHDW�GHDO�RI�IXWXUHSURJUDPV�LQ�\RXU�+LVWRU\�YLHZ��7KLV�PD\�WDNH�D�YHU\�ORQJ�WLPH��6R�EHFDUHIXO��ZKHQ�\RX�JLYH�D�PD[LPXP�GDWH�RWKHUZLVH�\RX�PLJKW�ORRVH�\RXUSDWLHQFH�DQG�KDYH�WR�LQWHUUXSW�WKH�VFKHGXOHU�VHUYLFH�DOWRJHWKHU�

'LVSOD\LQJ�/RJ�,QIRUPDWLRQ

There are three ways of visualizing a log, in other words of displaying log information, inthe History view:

• By double-clicking on the log itself.

• By clicking on the button in the tool bar when the log is already selec

• By right-clicking on the log and selecting the Display Log Information pop-up item.

When one of the three actions above has been performed, the Log Information windowappears. For further information on how to read this important window, take a look at information’, on page 29.

3XUJLQJ�/RJV

To purge a log, just select it and press the '(/ key on the keyboard.

H u m m i n g b i r d ������ G e n i o S c h e d u l e r

Page 42: genio scheduler

7KH�+LVWRU\�&RPSRQHQW 5HIUHVKLQJ�ORJV

7R�SXUJH�VHYHUDO�ORJV�DW�D�WLPH�

� Either select a process or multi-select several logs in a process.

� Press the 'HO key or click the button (purge bin) in the tool bar.

The Purge window appears.

� You can purge the current log by selecting the VHOHFWHG�H[HFXWLRQ option. You can purge all logs in the current process by selecting the DOO�H[HFXWLRQV�RI�WKLV�SURFHVV option. At last, you can purge all logs in a process according to a begin date and an end date by selecting the EHWZHHQ�WZR�GDWHV options and defining the required dates.

� Then just press 3XUJH to confirm or &DQFHO to exit.

5HIUHVKLQJ�+LVWRU\�9LHZ

To refresh the History view, all you have to do is click the button.

&$87,21� 5HIUHVKLQJ�PD\�WDNH�D�ORQJ�WLPH�EHFDXVH�RI�ORJ�YROXPH�DQG�QXPEHU�RIORJV��5HIUHVK�WLPH�LV�HVSHFLDOO\� ORQJ�WKH�0D[LPXP�'DWH�YDOXHV�LQ�WKH+LVWRU\�YLHZ�ILOWHU�GHILQLWLRQ�DUH�YHU\�GLVWDQW�DQG�WKDW�PDQ\�SURFHVV�ORJVZHUH�JHQHUDWHG�LQ�EHWZHHQ�

)LOWHULQJ�'LVSOD\�LQ�+LVWRU\�9LHZ

An essential feature of the History view in *HQLR�6FKHGXOHU, is the Filter.

Two buttons are used in the tool bar:

G e n i o S c h e d u l e r ������ H u m m i n g b i r d

The button which opens the Filter Definition window.

The button which applies the filter defined in the Filter Definition window to the

Page 43: genio scheduler

5HIUHVKLQJ�ORJV 7KH�+LVWRU\�&RPSRQHQW

History view or takes it away. To return to the full view (i.e. take off the filter) after it hasbeen applied or just after the filter definition has been confirmed in the window, press thisbutton again.

The Filter Definition� window has three views:

• the Time Frame view

• the Project and Process Filter view

• the Log Filter view

The Time frame view

H u m m i n g b i r d ������ G e n i o S c h e d u l e r

Page 44: genio scheduler

y.

y.

server

7KH�+LVWRU\�&RPSRQHQW 5HIUHVKLQJ�ORJV

The Time�Frame view (above) has two areas:

• The 0LQimum�GDWH area:

1R�0LQ There is no minimum date. All past logs will be displayed.

7RGD\ The history view will display all logs beginning from thepresent day.

2WKHU A calendar lets you choose any other date in a realistic wa

• The 0D[imum�GDWH area:

7RGD\ The date of the last log displayed is today.

2WKHU A calendar lets you choose any other date in a realistic wa

The Default values button resets the minimum and maximum dates to the current date.

The 2. button confirms the filter definition and applies it to the current view.

,03257$17� 7KH�0D[LPXP�GDWH�YDOXH�HQDEOHV�WKH�VFKHGXOHU�WR�FRPSXWH�DQG�GLVSOD\�DOO�WKH�IXWXUH�VFKHGXOHG�SURJUDPV�WR�EH�GLVSOD\HG�LQ�WKH�YLHZ�

G e n i o S c h e d u l e r ������ H u m m i n g b i r d

Page 45: genio scheduler

5HIUHVKLQJ�ORJV 7KH�+LVWRU\�&RPSRQHQW

The Project and Process filter view

The Project and Process Filter view (above) has four fields:

1DPH Logs will be filtered by associated project names (several canbe selected with the standard MS-DOS selection method).

6WDWXV Logs will be filtered by associated project status.

9HUVLRQ Logs will be filtered by associated version number.

3URFHVV�QDPH Logs will be filtered by name of associated process.

The Default values button:

• Resets 1DPH to (i.e. ’all’).• Checks all three VWDWXVHV�• Sets version to 1.

H u m m i n g b i r d ������ G e n i o S c h e d u l e r

• Resets 3URFHVV�1DPH to (i.e. ’all’).

Page 46: genio scheduler

7KH�+LVWRU\�&RPSRQHQW 5HIUHVKLQJ�ORJV

The Log Filter view

The Log Filter view (above) has five areas:

/RJ�7\SH Logs will be filtered according to log types: types aredescribed in ‘Log Types’, on page 39.

0D[�'XUDWLRQ Maximum process execution duration can be set to:’No limit’ or to ’Less than QE¶��

0LQ�'XUDWLRQ Minimum process execution duration can be set to: ’No limit’ or to ’More than QE¶��

0D[�([FHSWLRQV Maximum number of exceptions can be set to:’No limit’ or to ’Less than QE¶�

0LQ�([FHSWLRQV Minimum number of exceptions can be set to:’No limit’ or to ’More than QE¶��

The 'HIDXOW�YDOXHV�button:

• Checks all log types.

G e n i o S c h e d u l e r ������ H u m m i n g b i r d

• Reset all options in the four other areas to 1R�OLPLW.

Page 47: genio scheduler

5HIUHVKLQJ�ORJV 7KH�5HDO�7LPH�$GPLQLVWUDWLRQ

7KH�5HDO�7LPH�$GPLQLVWUDWLRQ�&RPSRQHQW

The Real-Time Administration Component view is accessed by clicking on the�5HDO�7LPH�$GPLQLVWUDWLRQ�&RPSRQHQW�YLHZ�LFRQ�

The Real-Time Administration tab gives an overview of background information. Itdisplays icons representing the Genio services. Click the 5HDO�7LPH�$GPLQLVWUDWLRQicon or choose 5HDO�7LPH�$GPLQLVWUDWLRQ from the View sub-menu. You access theReal-Time Administration view:

H u m m i n g b i r d ������ G e n i o S c h e d u l e r

Page 48: genio scheduler

7KH�5HDO�7LPH�$GPLQLVWUDWLRQ 5HIUHVKLQJ�ORJV

A symbol is associated to each service. Its meaning is detailed below:

The services exhibit symbols representing the current tasks being performed

From this window it is possible to:

• Refresh the window or each engine individually with

• Configure the window properties with

Green Means that the corresponding engine is running.

Red Means that the corresponding engine is not running.

Grey Means that Genio is in the process of finding out whether or not the corresponding engine is running.

Purple Means that the service is running but that it is running on a different repository than the current repository used by the Scheduler.

Blue Means that the time scheduler limit for engine response has expired (refer to ‘Configuring Real-Time Parameters’, on page 48, ’Time Out’ option).

Represents administration threads. If Genio displays it the thread is available.

Takes the place of the thread icon when a scheduler program launches an execution. The thread icon is restored at the end of the execution.

Is added to the icons when a module is executed on the engine from the designer.

Is present in front of the files that are checked by the polling service on a given host, in a directory. The status of the files determined by the polling service is displayed as well.

G e n i o S c h e d u l e r ������ H u m m i n g b i r d

• Stop or view an execution with

• Show or hide all empty folders with

Page 49: genio scheduler

esh

anlerst

eanork

be

5HIUHVKLQJ�ORJV 7KH�5HDO�7LPH�$GPLQLVWUDWLRQ

r Configuring Real-Time Parameters

7R�FRQILJXUH�WKH�µ5HDO�7LPH�$GPLQLVWUDWLRQ¶�SDUDPHWHUV

Click the &RQILJXUH item of the Scheduler menu.

The ’Configuration’ window appears:

5HIUHVK�UDWH Indicates how long it takes between each scheduler refrprocess (in seconds). Maximum rate is �� seconds. When thefield is set to zero, there is no refresh at all.

7LPH�RXW Indicates how long the scheduler waits for an answer fromengine before giving up (in seconds). When the schedugives up it will give you an message telling you that the hodoesn’t answer. Maximum time out is ����� seconds. If thisoption is set to zero, the scheduler will not limit the timneeded to wait for the host to respond. (There will be answer, but depending on the number of hosts and the netwload, it might take a long time.)

9LHZ�DGPLQLVWUDWLRQ� Activates visualization and refresh on the administration WKUHDG threads. If this option is not checked, only task threads will

visible and refreshed.

H u m m i n g b i r d ������ G e n i o S c h e d u l e r

Page 50: genio scheduler

’View

es are

7KH�5HDO�7LPH�$GPLQLVWUDWLRQ 5HIUHVKLQJ�ORJV

r Refreshing the view for the entire root

7R�UHIUHVK�WKH�YLHZ�IRU�WKH�HQWLUH�URRW

� Select the entire Genio root by clicking once on the icon in the Real-Time Administration view.

� Press the button in the tool bar to refresh the entire view.

The display of all hosts, services and task threads currently running on the current repository is refreshed.

The administration threads (one per service) appear and are refreshed only if the administration thread’ option in the Configuration window is checked (refer to ‘Configuring Real-Time Parameters’, on page 48 ).

,03257$17� 5HIUHVKLQJ�WKH�6FKHGXOHU�YLHZ�PD\�WDNH�WLPH��DV�UHVSRQVH�WLPH�GRHV�QRW�GHSHQG�XQLTXHO\�RQ�*HQLR��2WKHU�SDUDPHWHUV��VXFK�DV�QHWZRUN�RYHUORDG�RU�WXUQHG�RII�KRVWV�RQ�WKH�QHWZRUN�PD\�VORZ�WKH�UHIUHVK�SURFHVV�

r Refreshing the view of each host individually

7R�UHIUHVK�WKH�YLHZ�IRU�HDFK�LQGLYLGXDO�KRVW

� Select the adequate service by clicking once on the icon in the Real-TimeAdministration view.

� Press the button in the tool bar to refresh all services running on this host.

All services running on this host only are refreshed. The task threads on those servicrefreshed.

G e n i o S c h e d u l e r ������ H u m m i n g b i r d

Page 51: genio scheduler

5HIUHVKLQJ�ORJV 7KH�5HDO�7LPH�$GPLQLVWUDWLRQ

r Refreshing the view of each service individually

7R�UHIUHVK�WKH�YLHZ�RI�HDFK�LQGLYLGXDO�VHUYLFH

� Select the adequate service by clicking once on the icon (when it is red or green, not grey) in the Real-Time Administration view.

� Press the button in the tool bar to refresh the selected service.

The current service is refreshed. The task threads on that service are also refreshed.

r Stopping or viewing an execution

7R�YLHZ�DQ�H[HFXWLRQ

� Select the execution you want tot stop.

� Click

The Execution Viewer is launched. For information on this application, please re

r Stopping an execution

7R�VWRS�DQ�H[HFXWLRQ

� Select the execution you want tot stop.

� Click

H u m m i n g b i r d ������ G e n i o S c h e d u l e r

Page 52: genio scheduler

7KH�5HDO�7LPH�$GPLQLVWUDWLRQ 5HIUHVKLQJ�ORJV

G e n i o S c h e d u l e r ������ H u m m i n g b i r d

Page 53: genio scheduler

,QGH[

@CoherenceException, 34@ConnectionException, 34@ExpressionException, 34@OLAPException, 34@SQLException, 34

$

Activating programs, 25Activating a single program, 25Activating all programs associated with a process,

25Activating all the programs of a project version,

25At a fixed date or time programming, 16

&

Checking process logs, 28Configuring Real Time Parameters, 48Consulting log information, 28Copying programs, 23

a single program, 24all the programs associated with a process, 24Copying all the programs of a project version, 24

Creating a program, 14

(

Event driven programming, 15, 19

)

File behavior driven programming, 21Fixed date programming, 15

*

Genio Suite Installation GuideAbout the book, vAssociated documents, vReadership, v

Global variablesInitializing before process execution, 23

+

History, 8Hosts, 10

/

Launching applications from the Scheduler, 11Log information, 29Log types, 39Logs, 8, 10Logs component, 28

0

Modifyinga program, 14

Moving programs, 23a single program, 24all the programs associated with a process, 24all the programs of a project version, 24

3

Periodical programming, 15, 17

H u m m i n g b i r d - 51 - G e n i o S c h e d u l e r

Foldersin the Scheduler, 9

Future Programs, 40

Polling modes for polling driven programming, 22Process hierarchy in programs, 14Process logs

Page 54: genio scheduler

,QGH[

Alphanumeric order, 39Chronological view, 39Consulting log information, 28Displaying log information, 29Log types, 39Purging logs, 34, 40

Clearing out a log, 35Clearing out all logs between two dates, 36Clearing out all logs of a process, 35

Sorting, 39Processes

Activating all associated programs, 25Copying all associated programs, 24Moving all associated programs, 24Refreshing an entire process, 26Refreshing logs, 36Suspending all associated programs, 25

ProgrammingAt a fixed date, 15At a fixed date or at a fixed time, 16Periodically, 15, 17With events, 15, 19With polling, 15, 21

Programs, 8Activating, 25Copying, 23Copying a single program, 24Copying or moving all programs associated with a

process, 24Copying or moving all programs of a project

version, 24Creation, 14Moving, 23Moving a single program, 24One time or fixed time programming, 16Periodical, 17Programs view, 13Refreshing, 26Refreshing an entire process, 26Refreshing an entire project, 26Refreshing an entire project version, 26Refreshing an entire repository, 27Suspending, 25Triggered by an event, 19Triggered by the modification/presence of a file,

PurgingExecutions, 28Logs, 34

5

Real time administration, 8, 46Color symbolics, 47Parameter configuration, 48

Refresh rate, 48Time out, 48

Refreshing individual hosts, 49Refreshing individual services, 50Refreshing the entire root, 49View configuration

Thread, 48Real time administration Component, 46Refresh rate, 48Refresh Scheduler, 49, 50Refreshing

an entire process, 26an entire project, 26an entire project version, 26Programs, 26the entire repository, 27

Refreshing logs, 36all logs in a project, 37all logs in a project version, 37all logs in the entire repository, 37in a single process, 36

6

SchedulerFolders, 9History component, 8Hosts, 10Launching applications, 11Logs, 10Logs component, 8Processes, 9Program component, 8, 13

G e n i o S c h e d u l e r ������ H u m m i n g b i r d

21Project and process filter, 44Projects in the Scheduler, 9

Projects, 9Purging executions, 28Refresh, 49

Page 55: genio scheduler

,QGH[

Services, 10Stopping an execution, 50The History component, 38The logs component, 28The Real Time Administration component, 46Viewing an execution, 50

Stopping an execution, 50Suspending programs, 25

Suspending a single program, 25Suspending all programs associated with a process,

25Suspending all the programs of a project version,

25

7

The Programs component of the Scheduler, 13

9

VariablesGlobal

Initializing before process execution, 23Viewing an execution, 50

H u m m i n g b i r d ������ G e n i o S c h e d u l e r

Page 56: genio scheduler

,QGH[

G e n i o S c h e d u l e r ������ H u m m i n g b i r d