Tivoli Workload Scheduler - IBM Supportpublib.boulder.ibm.com/tividd/td/TWS/GC32-0644-00/... · Preface The information in this manual is intended for administrators who install and

Tivoli WorkloadSchedulerExtended Agent for Baan User’s GuideVersion 1.1

Tivoli WorkloadSchedulerExtended Agent for Baan User’s GuideVersion 1.1

Tivoli Workload Scheduler Extended Agent for Baan (March 2000)

Copyright Notice

Copyright © 2000 by Tivoli Systems Inc., an IBM Company, including this documentation and all software. All rightsreserved. May only be used pursuant to a Tivoli Systems Software License Agreement or Addendum for Tivoli Products toIBM Customer or License Agreement. No part of this publication may be reproduced, transmitted, transcribed, stored in aretrieval system, or translated into any computer language, in any form or by any means, electronic, mechanical, magnetic,optical, chemical, manual, or otherwise, without prior written permission of Tivoli Systems. Tivoli Systems grants youlimited permission to make hardcopy or other reproductions of any machine-readable documentation for your own use,provided that each such reproduction shall carry the Tivoli Systems copyright notice. No other rights under copyright aregranted without prior written permission of Tivoli Systems. The document is not intended for production and is furnished“as is” without warranty of any kind. All warranties on this document are hereby disclaimed including the warrantiesof merchantability and fitness for a particular purpose.

Note to U.S. Government Users—Documentation related to restricted rights—Use, duplication or disclosure is subject torestrictions set forth in GSA ADP Schedule Contract with IBM Corporation.

Trademarks

The following product names are trademarks of Tivoli Systems or IBM Corporation: AIX, IBM, OS/2, RS/6000, Tivoli,Tivoli Management Environment, and TME 10.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks or registered trademarks of Microsoft Corporation.

UNIX is a registered trademark in the United States and other countries licensed exclusively through X/Open CompanyLimited.

Java and all Java-based trademarks or logos are trademarks of Sun Microsystems, Inc.

Baan is a trademark of Baan Company.

TACF Copyright © 1993-1999 by MEMCO Software Ltd., U.S. patent pending. All rights reserved.

Other company, product, and service names mentioned in this document may be trademarks or servicemarks of others.

Notices

References in this publication to Tivoli Systems or IBM products, programs, or services do not imply that they will beavailable in all countries in which Tivoli Systems or IBM operates. Any reference to these products, programs, or services isnot intended to imply that only Tivoli Systems or IBM products, programs, or services can be used. Subject to TivoliSystem’s or IBM’s valid intellectual property or other legally protectable right, any functionally equivalent product, program,or service can be used instead of the referenced product, program, or service. The evaluation and verification of operation inconjunction with other products, except those expressly designated by Tivoli Systems or IBM, are the responsibility of theuser.

Tivoli Systems or IBM may have patents or pending patent applications covering subject matter in this document. Thefurnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to theIBM Director of Licensing, IBM Corporation, North Castle Drive, Armonk, New York 10504-1785, U.S.A.

Contents

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vPrerequisite Knowledge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v

Related Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v

What This Guide Contains. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v

Conventions Used in This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi

Platform-specific Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi

Contacting Customer Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Chapter 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Required Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Accessing Baan Modules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Chapter 2. Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Installation Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Chapter 3. Setting Up the Extended Agent. . . . . . . . . . . . . . . 5Creating a TWS Extended Agent for Baan Workstation . . . . . . . . . . . . . . . . . 5

Command Line Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Creating Jobs in Baan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Creating Baan Job Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Command Line Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Creating Baan Job Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Command Line Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

TWS and Baan Job States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

iiiTivoli Workload Scheduler Extended Agent for Baan User’s Guide

STDLIST Entries for a Baan Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Sample STDLIST for a Baan Job. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Chapter 4. Options File Reference . . . . . . . . . . . . . . . . . . . . . . 19The baan.opts File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Creating the baan.opts File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

KILLTASK Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

BSH_ENVVARS Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Sample Options Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

iv Version 1.1

Preface

The information in this manual is intended for administrators whoinstall and configure the Tivoli Workload Scheduler (TWS) ExtendedAgent for Baan.

Prerequisite KnowledgeUsers of the guide should have some knowledge of:

¶ The UNIX operating system

¶ The Tivoli Workload Scheduler(TWS) environment

¶ Baan job scheduling environment

Related DocumentsThe following document contains information related to the TivoliWorkload Scheduler (TWS) Extended Agent for Baan:

¶ Tivoli Workload Scheduler User’s Guide

Provides information about setting up and managing the TivoliWorkload Scheduler environment. It also provides generalinformation about extended agents.

What This Guide ContainsThe sections are:

¶ Section 1 Introduction—provides an introduction to the productand installation instructions.

¶ Section 2 Setting Up the Extended Agent for Baan—describeshow to configure the extended agent cpu, and how to documentand schedule Baan jobs in TWS.

¶ Section 3 Options File Reference—describes the extended agentoptions parameters, and the format of the options file.

vTivoli Workload Scheduler Extended Agent for Baan User’s Guide

Conventions Used in This GuideThe guide uses several typeface conventions for special terms andactions. These conventions have the following meaning:

Bold Commands, keywords, file names, or other information thatyou must use literally appear bold.Names of windows,dialogs, and other controls also appear bold.

Italics Variables and values that you must provide appear in italics.

Bold ItalicsNew terms appear in bold italics the first time they are used.

MonospaceCode examples appear in monospace font.

Platform-specific InformationFor the latest supported platforms information, contact the TivoliCustomer Support representative.

Text Supported Platform

AIX 4.x IBM RS/6000 series running AIX 4.2 or 4.3

DG/UX Data General AViiON series running DG/UXR4.20MU04 on the ix86 platform

HP-UX 10.20 and11.0

HP9000/700 and 800 series running HP-UX 10.20and 11.0

Solaris Sun SPARC series running Solaris 2.6 and 2.7

SGI IRIX 6.5

NCR SVR4 MP-RAS V3.02 UNIX

DEC Unix OSF1 4.0D and 4.0F

SINIX Pyramid 5.4.4 and 5.4.5

Sequent DYNIX 4.4x and 4.5.1

SCO unixware 7.1.0

vi Version 1.1

Contacting Customer SupportIf you encounter difficulties with any Tivoli products, you can enterhttp://www.support.tivoli.com to view the Tivoli Support home page.After you link to and submit the customer registration form, you willbe able to access many customer support services on the Web.

Use the following phone numbers to contact customer support in theUnited States: the Tivoli number is 1-800-848-6548(1-800-TIVOLI8) and the IBM number is 1-800-235-5511 (press orsay 8 after you reach this number). Both of these numbers directyour call to the Tivoli Customer Support Call Center.

We are very interested in hearing from you about your experiencewith Tivoli products and documentation. We welcome yoursuggestions for improvements. If you have comments or suggestionsabout this documentation, please send e-mail to [email protected].

viiTivoli Workload Scheduler Extended Agent for Baan User’s Guide

viii Version 1.1

Introduction

The TWS Extended Agent for Baan gives you the ability to scheduleBaan jobs using the sophisticated job scheduling features of TivoliWorkload Scheduler (TWS).

OverviewTivoli Workload Scheduler (TWS) can launch and monitor jobs inBaan using an Extended Agent for Baan workstation. The ExtendedAgent for Baan workstation is defined in a standard workstationdefinition. This workstation is logical however and must be hostedby a master, domain manager, or fault-tolerant agent. This is alogical workstation definition, that uses the access method baan andan options file baan.opts to communicate with the Baan application.

To launch a Baan job, TWS executes the baan access method,passing it information about the job. The baan.opts file provides themethod with the path, executable and other information about theBaan server used to execute the job. The extended agent can thenaccess the Baan server and launch the job and monitor it throughcompletion, writing job progress and status information to the job’sstandard list file.

Features¶ Use TWS’s standard job dependencies.

¶ Schedule Baan jobs to run on specified days, times, and in aprescribed order.

1

1Tivoli Workload Scheduler Extended Agent for Baan User’s Guide

1.In

trod

uctio

n

¶ Define inter-dependencies between Baan jobs and jobs that runon different systems such as SAP R/3, Peoplesoft, and OracleApplications.

¶ Define inter-dependencies between Baan jobs and jobs that runon different platforms, including Windows NT, MVS, and UNIX.

Required SoftwareThe Tivoli Workload Scheduler(TWS) Extended Agent for Baanrequires the following software:

¶ Tivoli Workload Scheduler (TWS) version 5.2 or higher.

¶ Baan IV b or higher. If you have IVb you must download threemodules from the Baan website.

Accessing Baan ModulesIf you have Baan IVb or earlier download three modules from theBaan website at:ftp://www.support.baan.com

The keyword TWS should be used to find the modules. (″TS″ usedto be ″Maestro″). The solution number is 13803. The followingmodules must be downloaded:

¶ oaad500

¶ oaad5208

¶ oaad5203

Features

2 Version 1.1

Installation

This chapter provides information on installing the Tivoli WorkloadScheduler (TWS) Extended Agent for Baan.

Installation InstructionsTo install the Baan Extended Agent from CD-ROM, perform thefollowing steps:

1. Using the Job Scheduling Console, stop Tivoli WorkloadScheduler (TWS) on the host workstation.

2. Log in as root on the host workstation, and change yourdirectory to TWShome.

3. Mount the installation CD-ROM, and restore the tar file:tar -xvfcd_device/BAAN/platform/BAAN.TAR

where:

cd_deviceThe path and name of your CD drive.

platformThe target platform from the list below.

AIX IBM

DECUXDigital UNIX

2


2.In

stallation

DGUXData General UNIX

HPUXHewlett-Packard

INTELSystem V Interface Definition for INTEL Binaris

HIPS System V Interface Definition for HIPS ABI

SOLARISSun Solaris

4. Execute the following command to install the Baan method:/bin/sh TWShome/baaninstall

5. Create the baan.opts file.

6. Using the Job Scheduling Console, start Workload Scheduler onthe host workstation. Check your TWShome/methods directoryfor the following file:

¶baan

7. Check your TWShome/catalog directory for the following files:

¶baan.cat

¶baan.msg

Installation Instructions

4 Version 1.1

Setting Up the Extended Agent

This chapter provides information on creating TWS Extended Agentfor Baan workstation, job and jobstream definitions.

Creating a TWS Extended Agent for BaanWorkstation

TWS Extended Agent for Baan workstation definitions are requiredfor each instance of Baan that will execute TWSr scheduled jobs.They are defined the same as standard workstations except theyinclude the name of the Extended Agent’s host workstation and theaccess method name. Figures of both the legacy GUI and the JSConsole GUI are shown here.

Figure 1 shows the legacy GUI workstation definition window for aBaan Extended Agent named BAAN002. Figure 2 shows the JSConsole workstation definition window.

3


3.S

etting

Up

the

Exten

ded

Ag

ent

Figure 1. Properties - Workstation in Database Window (Legacy GUI)

Creating a TWS Extended Agent for Baan Workstation

6 Version 1.1

To define a TWS Extended Agent for Baan workstation:

1. Log into the Job Scheduling Console.

2. Highlight the Tivoli Workload Scheduler(TWS) Engine.

3. From the Selected Menu, click New Workstation. TheProperties - Workstation in Database window is displayed.

4. In the Name field, specify a name for this workstation. Theworkstation name can have up to 8 alphanumeric characters forunexpanded database or 16 alphanumeric characters forexpanded database. The name can include a dash andunderscore, but must begin with a letter.

5. In the Node field, specify the node name or the IP address forthis workstation. Fully qualified domain names are accepted.This is a required field.

6. In the TCP Port field, enter 0.

7. For Operating System, select OTHER.

Figure 2. Properties - Workstation in Database Window (JS Console)



3.S

etting

Up

the

Exten

ded

Ag

ent

8. In the Domain field, enter the domain name of the hostworkstation. The Extended Agent and the Host workstationmust be in the same domain.

9. In the Time Zone field, enter the Time zone of the ExtendedAgent workstation. This option is only valid if time zones areturned on in your Tivoli Workload Scheduler (TWS) network.

10. In the Description field, enter a description for the ExtendedAgent workstation. This field is an optional text description ofthe workstation (up to 40 characters).

11. In the Workstation Type field, select Extended Agent.

12. In the Access Method field, enter the name of the accessmethod, Baan. This file is executed by the TWS host toconnect to an instance of Baan. Click the Methods button toselect the Baan method from a list.

13. In the Host workstation field, enter the name of the ExtendedAgent’s host workstation. This is the Master, domain manager,or fault-tolerant agent that hosts the Extended Agent for Baanworkstation definition. Click the workstations button to select aworkstation from the list.

14. Click OK to save the workstation definition to the database.

Note: The new workstation will not be recognized by TWS untilJnextday executes.

Command Line ExampleWorkstation definitions can also be entered using the Composercommand line. The workstation definition shown in the previousexample would be entered as follows:workstationname baan002

node saturn

os other

description "Baan Extended Agent #002"

host goliath

access baan

end


8 Version 1.1

For information about using the command line to create aworkstation definition, refer to the Tivoli Workload SchedulerReference Guide.

Creating Jobs in BaanTo create jobs in Baan, use a Baan job scheduler session. A Baan jobcan be run through both the Baan job scheduler and TWS. When ajob is scheduled through TWS, the Baan job scheduler settings areoverwritten.

When defining a Baan job that you want controlled from TWS,make sure the following parameters are set:Periodical=Yes

Period=1 minute

Status=Free

If a job needs to be scheduled through both TWS and Baan, the jobneeds to be defined as a regular Baan job with valid start date andtime. When this job is scheduled through Baan, it will run as anormal Baan job.

TerminologyTWS and Baan use different terms for the same objects. Below is anexplanation of how TWS and Baan terminology correlate.

TWS Term Baan Term

JobStream Job

Job Session

Creating Baan Job DefinitionsTWS job definitions are required for each Baan job you intend toschedule. Baan jobs are defined in TWS like other jobs and includejob name, owner name, script file specifications, and recoveryoptions.

Both the lecgay GUI and JS Console GUI windows are shown here.



3.S

etting

Up

the

Exten

ded

Ag

ent

Figure 3 shows the legacy GUI Job Definition window for a jobnamed BAANJOB2 on the Baan Extended Agent workstationBAANCPU2.

Figure 4 shows the JS Console GUI Job Definition window.

Figure 3. Properties - Job Definition Window (Legacy GUI)

Creating Baan Job Definitions

10 Version 1.1

To define a Baan job in TWS:


2. Highlight the Tivoli Workload Scheduler (TWS) Engine.

3. From the Selected Menu, click New Job. The Select a TaskType window is displayed.

4. Select the task type for the job. The task type should be eitheran NT Command or a UNIX Command based on the platformof the extended agent host workstation.

5. Once you have selected the task type click OK. The Properties- Job Definition window is displayed.

6. In the Name field, enter a name for this job. The job name canhave up to 8 alphanumeric characters for unexpanded databaseor 40 alphanumeric characters for expanded database. The namecan include a dash and underscore, but must begin with a letter.

7. In the Workstation field, enter the name of the Baan extendedagent workstation.

Figure 4. Properties - Job Definition Window (JS Console GUI)



3.S

etting

Up

the

Exten

ded

Ag

ent

8. In the Description field, enter a description for the job. Thedescription can be up to 64 characters.

9. In the Login field, enter the Baan user ID who runs the Baanjobs. This user ID is required to run jobs in Baan, and it willappear in TWS displays.

Note: Recovery Options are optional. For information on RecoveryOptions and other Job control features refer to the TivoliWorkload Scheduler User’s Guide.

10. Click the Task tab.

11. In the Command field, enter the specifications for the Baan jobfile. There are three parameters:-j baanjob -u baanuser -c company

where:

baanjobThe Baan job name. For example: -j payroll

baanuserA valid Baan user ID. For example: -u bsp

companyThe three digit company code number. This parameter is notrequired. For example: -c 002

12. Click OK to save the job definition to the database.

Command Line ExampleJobs can also be defined at the Composer command line. Thefollowing example documents a TWS job named BAANJOB2 thatruns on an Baan Extended Agent workstation named BAAN. Ifrecovery is needed, TWS will run job RECOV2 and then continueprocessing.baan#baanjob2

streamlogin baanjobs

scriptname "-j payroll -u bsp -c 002"

description "baan job #2"

recovery continue after recov2


12 Version 1.1

For information about using the command line to create Baan jobdefinitions, refer to the Tivoli Workload Scheduler Reference Guide.

Creating Baan Job StreamsBaan jobs are scheduled in the same manner as other TWS jobs andcan include dependencies and other controls.

Figure 5 shows the legacy GUI Job Stream Editor window for aschedule named MYJOBSTREAM, which includes the BaanExtended Agent jobs BAANJOB1 and BAANJOB2.

Figure 6 shows the JS Console GUI Job Stream Editor window.

Figure 5. Job Stream Editor Window (Legacy GUI)



3.S

etting

Up

the

Exten

ded

Ag

ent

To define a job stream using Baan jobs:


2. Highlight the Tivoli Workload Scheduler (TWS) Engine.

3. From the Selected Menu, click New Job Stream. TheProperties - Job Stream window is displayed in the JobStream Editor.

4. In the Name field of the Properties - Job Stream window,specify the name of the job stream. You can enter up to 8alphanumeric characters for unexpanded database or 16alphanumeric characters for expanded database. In theWorkstation field of the Properties - Job Stream window,specify the Extended Agent for Baan workstation. In theDescription field of the Properties - Job Stream window, entera description of the job stream.

5. Click the OK button to save and close the job streamproperties. The Job Stream Editor is now displayed.

6. Add the Baan jobs to the job stream:

Figure 6. Job Stream Editor Window (JS Console GUI)

Creating Baan Job Streams

14 Version 1.1

a. Click the Add Job Definition button on the toolbar. TheProperties - Job window is displayed.

b. Use the search button to search for and select the Baan jobdefinition you want to add to the job stream. Once you haveselected a job the workstation field is automatically filled in.

c. You can now optionally add time restrictions, resourcedependencies, files dependencies, or prompts to the job. Formore information, refer to the Tivoli Workload SchedulerUser’s Guide.

d. After you have completed all the fields, click OK. The jobis added to the job stream.

7. If you added two or more jobs, you can create a followdependency between the jobs.

a. Ensure that the jobs are displayed in the Graph View of theJob Stream Editor.

b. Click the Add Link button on the toolbar and then click thepredecessor job icon and drag the link to the successor jobicon. An arrow is drawn between the two jobs. This arrowrepresents a follows dependency between the two jobs.

8. Create run cycles that determine the days that this job streamwill execute. Create run cycles using the Run Cycle view of theJob Stream Editor, for more information refer to the TivoliWorkload Scheduler User’s Guide.

9. Compare run times of the job stream and the jobs and adjustthem as necessary.

10. Save the job stream.

Note: When creating schedules using Baan IV Extended Agent jobs,you can use TWS’s standard dependencies and other controls.For more information about using these TWS features refer tothe Tivoli Workload Scheduler User’s Guide.



3.S

etting

Up

the

Exten

ded

Ag

ent

Command Line ExampleSchedules can also be defined using the Composer command line.The following example shows a schedule called MYSKED on theBaan Extended Agent BAAN002.schedule baan002#mysked

on monthend

at 1600

:

main#myjob

baan002#baanjob1 follows main#myjob

baan002#baanjob2 follows baan002#baanjob1

end

For information about using the command line interface to createschedules, refer to the Tivoli Workload Scheduler User’s Guide.

TWS and Baan Job StatesWhen a Baan job is launched by TWS, you can monitor its progresswith TWS’s Console Manager. The state transitions in TWS and thecorresponding Baan states are listed below.

Baan Job status TWS Job Status Possible Baan Action

Free No Error Available to run(Activate, In queue,Blocked, Waiting)

Waiting WAIT Canceled, Running

In queue WAIT Canceled, Running

Canceled No State Free, In queue, Blocked

Blocked No State Free, In queue

Running EXEC Terminate

Run time error ABEND


16 Version 1.1

STDLIST Entries for a Baan JobThe STDLIST for a Baan job contains the following information:

STDLIST Entry Definition

bpid baan process id

sess session

sesn session number

info information field in baan

comp company

stim start time

usti universal start time

etim end time

ueti universal end time

ssta session status

jsta job status

Sample STDLIST for a Baan JobBelow is a sample STDLIST for a Baan Job:

STDLIST Entries for a Baan Job


3.S

etting

Up

the

Exten

ded

Ag

ent

Figure 7. Sample STDLIST for a Baan Job

18 Version 1.1

Options File Reference

This section provides detailed information about the TWS ExtendedAgent for Baan options file, baan.opts.

The baan.opts FileThe options file contains information about the Baan applicationserver that TWS will run jobs on. This file must reside on the hostcomputer for the Baan Extended Agent in the TWShome\methodsdirectory.

Creating the baan.opts FileTo create the baan.opts file:

1. Open a text editor.

2. Enter the parameters and values specific to your site. Thebaan.opts file entries must be in the following format:BSH=baanint

BSE=baanpath

BSH_LAUNCH_4GL=ttaad5203m000

BSH_MANAGE_4GL=ottaad5208

BSH_KILLTASK= killtask

BSH_ENVVARS=envvars

where:

baanintEnter the name of the Baan interface. The default is ba6.1.

4


4.O

ptio

ns

File

Referen

ce

baanpathEnter the fully qualified path to the BSE environment.

killtaskEnter the name of the executable file used to kill backgroundprocesses in Baan. This entry is optional.

envvarsEnter the name of the environment variable file.

Note: The BSH_LAUNCH_4GL and BSH_MANAGE_4GLentries must be entered as shown.

3. Save the file in the methods directory with the name baan.opts.The file must exist on the host computer for the extended agent,with the following directory and file name:TWShome/methods/baan.opts

4. Set the permissions for the baan.opts file to 755:chmod 755 baan.opts

KILLTASK VariableThe killtask parameter refers to the name of an executable file usedto track down background processes not directly controlled by theinitial job. The kill task executable is not included with the BaanExtended Agent, and must be provided by the user. It allowsenterprises that have customized environments or solutions to bringthese customizations into the Baan environment. This parameter isoptional.

BSH_ENVVARS VariableThe ENVVARS variable refers to the location of an environmentvariable file. The environment variable file is used to pass the BaanExtended Agent any necessary environment variables. The syntaxrequired for the file is:variable=value

For example, the file might contain the following variable:PATH=$PATH:/usr/local/visix

The baan.opts File

20 Version 1.1

Note: The contents of the environment variable file can varysignificantly from site to site.

Sample Options FilesBelow are two sample options file definitions.

Example 1BSH=ba6.1

BSE=/usr/baan4_b/bse

BSH_LAUNCH_4GL=TTAAD5203M000

BSH_MANAGE_4GL=OTTAAD5208

BSH_KILLTASK=/usr/baan4_b/genocide

BSH_ENVVARS=/usr/baan4_b/bse_env

Example 2BSH=ba6.1

BSE=/usr/baan_3/bse

BSH_LAUNCH_4GL=TTAAD5203M000

BSH_MANAGE_4GL=OTTAAD5208

BSH_KILLTASK=/usr/local/bin/killproc

BSH_ENVVARS=/usr/baan_3/bse_envs

The baan.opts File


4.O

ptio

ns

File

Referen

ce

22 Version 1.1

Index

Aaccess method 8

BBaan modules required 2Baan support 2BSH_ENVVARS Variable 20

Ccommand line example

job definition 12job stream definition 16workstation definition 8

creating Baan job definitions 9creating Baan job streams 13customer support information vii

Ddefining a Baan workstation 5defining jobs in Baan 9

Ffeatures 1

Hhost workstation 8

Iinstallation 3introduction 1

Jjob definitions 9job status mapping 16

KKILLTASK variable 20

Ooptions file 21options file examples 21options file reference 19

Pparameters required in Baan jobs 9


Ind

ex

Ssample options file 21sample STDLIST 17status mapping 16STDLIST entry descriptions 17STDLIST for Baan jobs 17supported platforms 2

Tterminology 9TWS and Baan job status 16

Wworkstation, defining 5

24 Version 1.1

Printed in the United States of Americaon recycled paper containing 10%recovered post-consumer fiber.

GC32-0644-00