User s Guide for R/3 Access Method

Transcription

1 IBM Tioli Workload Scheduler for Applications User s Guide for R/3 Access Method Version (Maintenance Release Noember 2003) SH

2

3 IBM Tioli Workload Scheduler for Applications User s Guide for R/3 Access Method Version (Maintenance Release Noember 2003) SH

4 Note Before using this information and the product it supports, read the information in Notices on page 47. Refreshed Edition (Noember 2003) This edition applies to ersion 8, release 1, modification 1 of IBM Tioli Workload Scheduler for Applications User s Guide for R/3 Access Method (product number 5698-WSE) and to all subsequent releases and modifications until otherwise indicated in new editions. Copyright International Business Machines Corporation All rights resered. US Goernment Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

5 Contents Preface Maintenance Release Who should read this book What this book contains Publications i IBM Tioli Workload Scheduler Publications..i Related publications ii Accessing publications online ii Ordering publications ii Proiding feedback about publications.... ii Contacting Customer Support iii Conentions used in this book iii Typeface conentions iii Chapter 1. Introduction Features Scheduling Process for the R/3 Extended Agent..1 Chapter 2. Installation Software Requirements Installation Oeriew Installing to UNIX Host Installing to a Windows NT or Windows 2000 Host.5 Encrypting R/3 User Passwords Chapter 3. R/3 Configuration Oeriew Creating the Authorization Profile Creating the IBM Tioli Workload Scheduler RFC User Copy the Correction And Transport Files Import ABAP/4 Modules into R/ Installing the Extended Agent on the R/3 System..11 Troubleshooting the R/3 Connection Changing the Tioli Workload Scheduler RFC User ID Password Migrating from Preious Versions Print Parameter and Job Class Issues Chapter 4. Setting Up for IBM Tioli Workload Scheduler Defining an Extended Agent Workstation Defining Extended Agent Jobs Defining a Job in IBM Tioli Workload Scheduler 18 Defining a Job in R/ Defining a Job in IBM Tioli Workload Scheduler and R/ client Command Line Option Tioli Workload Scheduler and R/3 Job States..22 Defining Extended Agent Job Streams Defining an Extended Agent Workstation Creating the CPUREC Statement Defining the Workstation with ISPF Defining Extended Agent Jobs Defining Extended Agent Job Streams Chapter 6. Business Information Warehouse Business Information Warehouse Support - InfoPackages User Authorizations Business Warehouse Components R/3 Business Warehouse Definition Steps Defining a Job in IBM Tioli Workload Scheduler 29 R/3 Schedule Options of an InfoPackage...30 Appendix A. r3options File Reference 31 Sample r3options File Entry Modifying the r3options File Appendix B. New Access Method Options Files Configuration Options Global Options Local Options General Options Configuration Options Usage Configuration Files Migration Appendix C. National Language Support National Language Support Options R/3 Supported Codepages Supported Configurations and Limitations Appendix D. BDC Wait Using BDC Session Name Using BDC Queue ID Updates for Fix Pack 1 (patch WSE-FP01)..43 Using BDC Session Names Using DBC Session Queue ID with Report BDCRECXX Using BDC queue ID with FM BDC_OPEN_GROUP Notices Trademarks Glossary Chapter 5. Setting Up for IBM Tioli Workload Scheduler for z/os Index Copyright IBM Corp iii

6 i IBM Tioli Workload Scheduler for Applications: User s Guide for R/3 Access Method

7 Preface This guide proides information on how to install, configure, and use the R3 formally known as Tioli Workload Scheduler extended agent for R/3. Maintenance Release This is a maintenance refresh of the corresponding IBM Tioli Workload Scheduler for Applications Version manual, form number SH It contains updates for the APARS fixed with the Tioli Workload Scheduler patches WSE-FP01 and WSE-FP02. Throughout the book, the changed or new sections are marked by reision bars. The name of the fix pack or APAR causing the information change is also featured within the changed chapter, section, or paragraph. If your ersion of the product has not been fixed for a particular APAR, refer to the original ersion of the manual for the corresponding information. Who should read this book What this book contains The target audience for this guide is administrators who will install, configure and monitor job execution on the R/3 system from IBM Tioli Workload Scheduler for Applications R/3 Access Method. User s of this guide should hae some knowledge of the following: IBM Tioli Workload Scheduler - Distributed IBM Tioli Workload Scheduler for z/os R/3 operating enironment UNIX, Windows NT, Windows 2000 or IBM z/os operating systems. This guide contains the following sections: Chapter 1, Introduction, on page 1 Proides an introduction to Tioli Workload Scheduler for Applications for R/3 Access Methods. Chapter 2, Installation, on page 3 Proides installation instructions for UNIX, Windows NT, and Windows Chapter 3, R/3 Configuration, on page 9 Describes how to install R3batch. Chapter 4, Setting Up for IBM Tioli Workload Scheduler, on page 17 Describes how to configure the extended agent workstation, jobs and job streams in IBM Tioli Workload Scheduler. Chapter 5, Setting Up for IBM Tioli Workload Scheduler for z/os, on page 25 Describes how to configure the extended agent workstation, jobs and job streams in IBM Tioli Workload Scheduler for z/os. Chapter 6, Business Information Warehouse, on page 29 Describes the how to utilize the Business Warehouse functionalities. Copyright IBM Corp. 2002

8 Appendix A, r3options File Reference, on page 31 Describes File Reference for r3options. Appendix B, New Access Method Options Files, on page 33 Describes options in the New Access Method. Appendix C, National Language Support, on page 39 Describes the National Language Support options. Appendix D, BDC Wait, on page 41 Describes the Batch Data Collector options. Publications This section lists publications in the IBM Tioli workload Scheduler library and any other related documents. It also describes how to access Tioli publications online, how to order Tioli publications, and how to make comments on Tioli publications. IBM Tioli Workload Scheduler Publications This book is part of an extensie Tioli Workload Scheduler library. The books in this library can help you use Tioli Workload Scheduler more effectiely: Table 1. Tioli Workload Scheduler Publications Task Planning and installing Tioli Workload Scheduler. Using the Tioli Workload Scheduler command line, understanding how extended and network agent work, and integrating Tioli Workload Scheduler with NetView and with Tioli Business Systems Manager. Interpreting Tioli Workload Scheduler error messages Installing, configuring, and using Tioli Workload Scheduler fault-tolerant agents on AS/400. Setting up and using the Tioli Workload Scheduler Plus Module. Tioli Workload Scheduler last minute information. Publication Tioli Workload Scheduler Planning and Installation Guide Tioli Workload Scheduler Reference Guide Tioli Workload Scheduler Error Messages Tioli Workload Scheduler AS/400 Limited FTA User s Guide Tioli Workload Scheduler Plus Module User s Guide Tioli Workload Scheduler Release Notes Order number SH SH SH SH SH GI i IBM Tioli Workload Scheduler for Applications: User s Guide for R/3 Access Method

9 Related publications The following documents also proide useful information related to the product: Table 2. Related Publications Task Using the Jaa GUI to manage scheduling objects and run scheduling tasks. Using the Jaa GUI - Last minute changes Publication Tioli Job Scheduling Console User s Guide Order number SH Tioli Job Scheduling Console Release Notes GI Accessing publications online Publications in the product libraries are included in PDF or HTML formats, or both, on the product CD. To access the publications using a Web browser, open the infocenter.html file, which is located in the appropriate publications directory on the product CD. When IBM publishes an updated ersion of one or more online or hardcopy publications, they are posted to the Tioli Information Center. You can access updated publications in the Tioli Information Center from the following Tioli Customer Support Web site: The Tioli Information Center contains the most recent ersion of the books in the product library in PDF or HTML formats, or both. Translated documents are also aailable for some products. Note: If you print PDF documents on other than letter-sized paper, select the Fit to page check box in the Adobe Acrobat Print dialog (which is aailable when you click File --> Print) to ensure that the full dimensions of a letter-sized page are printed on the paper that you are using. Ordering publications You can order many Tioli publications online at the following Web site: You can also order by telephone by calling one of these numbers: In the United States: In Canada: In other countries, for a list of telephone numbers, see the following Web site: Proiding feedback about publications We are ery interested in hearing about your experience with Tioli products and documentation, and we welcome your suggestions for improements. If you hae comments or suggestions about our products and documentation, contact us in one of the following ways: Send an to pubs@tioli.com. Preface ii

10 Complete our customer feedback surey at the following Web site: Contacting Customer Support If you hae a problem with any Tioli product, you can contact Customer Support. See the Customer Support Handbook at the following Web site: The handbook proides information about how to contact Customer Support, depending on the seerity of your problem, and the following information: Registration and eligibility Conentions used in this book Telephone numbers and addresses, depending on the country in which you are located What information you should gather before contacting support This book uses seeral conentions for special terms and actions, operating system-dependent commands and paths, and margin graphics. Typeface conentions The following typeface conentions are used in this book: Bold Italic Monospace Lowercase and mixed-case commands, command options, and flags that appear within text appear like this, in bold type. Graphical user interface elements (except for titles of windows and dialogs) and names of keys also appear like this, in bold type. Variables, alues you must proide, new terms, and words and phrases that are emphasized appear like this, in italic type. Commands, command options, and flags that appear on a separate line, code examples, output, and message text appear like this, in monospace type. Names of files and directories, text strings you must type, when they appear within text, names of Jaa methods and classes, and HTML and XML tags also appear like this, in monospace type. iii IBM Tioli Workload Scheduler for Applications: User s Guide for R/3 Access Method

11 Chapter 1. Introduction Features IBM Tioli Workload Scheduler for Applications for R/3 gies you the ability to create, schedule, and control R/3 jobs using the job scheduling features of IBM Tioli Workload Scheduler. With IBM Tioli Workload Scheduler for Applications for R/3 Access Method, you can do the following: Use Tioli Workload Scheduler standard job dependencies and controls on R/3 jobs. Create R/3 jobs using the Tioli Workload Scheduler interface. Schedule R/3 jobs to run on specified days and times, and in a prescribed order. Define inter-dependencies between PeopleSoft jobs and Tioli Workload Scheduler jobs that run on different applications such as PeopleSoft and Oracle. Define inter-dependencies between R/3 jobs and jobs that run on different platforms, including UNIX, Windows NT, Windows 2000, z/os, and HP. Defines the National language support options. Defines how to utilize the R/3 Business Warehouse Support functionalities. Scheduling Process for the R/3 Extended Agent The Tioli Workload Scheduler launches jobs on an R/3 Scheduling extended agent workstation. The R/3 extended agent is defined in a standard Tioli Workload Scheduler workstation definition, which gies the extended agent a name and identifies the access method as r3batch. When inoked, the access method reads configuration information from an options file. Each instance of R/3 is defined as a separate extended agent, and each can use a different set of options. To launch a job on an extended agent for R/3 workstation, Tioli Workload Scheduler executes the access method, passing it information about the job. Using the extended agent workstation name as a key, r3batch uses the corresponding configuration file to determine which instance of R/3 will run the job. The access method r3batch makes a copy of a template job then marks it in R/3 as able to run and sets its start time to start immediate. It then monitors the job through to completion, writing job progress and status information to the job standard list file. For more information about job management, refer to the IBM Tioli Workload Scheduler Reference Guide SH Copyright IBM Corp

12 2 IBM Tioli Workload Scheduler for Applications: User s Guide for R/3 Access Method

13 Chapter 2. Installation Software Requirements This section contains information on installing the IBM Tioli Workload Scheduler for Applications for R/3. To install the IBM Tioli Workload Scheduler for Applications for R/3 Version 8.1.1, you must be running the following: Tioli Workload Scheduler distributed Versions 7.0, Tioli Workload Scheduler distributed Version 8.1 or Tioli Workload Scheduler for z/os with end to end. R/3 Version 3.1g, 3.1h, 3.1i, 4.0x, 4.5x, 4.6x or 6.10 The appropriate R/3 Support Package as stated in the following table: R/3 Versions R/3 Notes R/3 3.1i , , , , R/3 4.0x , , , , , R/3 4.5x , , , , , , , , R/3 4.6x , , , , , , , R/ , , , , , Note: R/3 notes and resole print parameter issues. Notes , and are Release - Independent. Installation Oeriew The following is an oeriew of the Tioli Workload Scheduler for Applications for R/3 Access Method installation steps. Before installing the extended-agent for R/3 Access Method, ensure that Tioli Workload Scheduler is properly installed on the host workstation. 1. On the system that will be the host of the extended agent for R/3 perform the following steps: a. Extract the IBM Tioli Workload Scheduler for Applications for R/3 software from the product CD-ROM. b. Install the product. Depending on the platform, follow the instructions described in Installing to UNIX Host on page 4 or in Installing to a Windows NT or Windows 2000 Host on page 5. c. Create the r3batch.opts file and install it to the TWShome/methods directory. This file is required and is created automatically during the installation. Note: TWShome stands for the name of the directory where you installed Tioli Workload Scheduler. d. Create an options file. This file could be r3options or a specific options file see Appendix B, New Access Method Options Files, on page 33. The r3options file can be created automatically during the installation. Copyright IBM Corp

14 Installing to UNIX Host Note: This applies only if you are installing to a Windows host. 2. Install the r3batch ABAPs on the R/3 system. To do this: a. Log in to the R/3 instance as a Basis administrator or user with the correct authorizations. b. Import the correction and transport files. 1. Log on as root and change to the TWShome directory usually /usr/lib/maestro. 2. From the installation CD-ROM, extract the software: tar xf cd_path/r3batch/platform/r3batch.tar where: cd_path is the pathname of your CD-ROM drie. platform is your platform type. The tar parameters are described in the following table: tar parameter cd_folder platform Description The pathname of your CD drie or folder. Your target platform from one of the following: AIX for IBM DGUX for Data General UNIX HPUX for Hewlett-Packard INTEL for Intel-based UNIX MIPS for MIPS-based UNIX OSF for Compaq True 64 SOLARIS for Sun Solaris 3. Verify that r3setup and r3btar.z hae been extracted successfully in the current directory. 4. Run the r3setup script to decompress the files, perform the initial setup, and create the r3options file: /bin/sh r3setup -new-update where: -new Specifies a new installation. -update Specifies that you are installing oer a preiously installed ersion. You will be prompted to specify the information listed below. See Appendix A, r3options File Reference, on page 31 and Appendix B, New Access Method Options Files, on page 33 for more details. The Tioli Workload Scheduler user name if different from the default alue (default: maestro). The directory where the extended agent should be installed (type the path to TWShome). The Launch User LJuser (default: maestro). This is the Tioli Workload Scheduler user name that runs r3batch. This must be a alid UNIX account. 4 IBM Tioli Workload Scheduler for Applications: User s Guide for R/3 Access Method

15 The Info User IFuser (default: maestro). This is the Tioli Workload Scheduler user name that retriees job information. IFuser must be the same as the LJuser. The Job definition type JobDef (default: r3batch). This is the Tioli Workload Scheduler job definition interface type. They could be: a. r3batch, (default) proides a job definition interface that is specific to R/3 jobs. b. generic, proides the standard job definition interface with no R/3 specific entry field. The host CPU name for the Tioli Workload Scheduler extended agent definition. The host name of your R/3 application serer. If you want to specify a separate R/3 gateway host, type NO. The three-character R/3 system id (for example: OSS or TRN). The two-digit R/3 instance number (for example: 00 or 01). The three-digit R/3 client number (for example: 100 or 900). The R/3 user id for RFC calls (for example: rfcuser) The password for your R/3 rfc user id. The R/3 interface audit leel (default: 0) If you wish to define the SAP R/3 login language for extended agent on this R/3 system (default No) If you wish to define another instance of the extended agent. If you reply Yes, you are asked to proide another set of parameters. An additional entry is inserted in the R/3 options file. 5. Open the Job Scheduling Console or Composer program and create a workstation definition in IBM Tioli Workload Scheduler for each instance of R/3. Installing to a Windows NT or Windows 2000 Host 1. Stop IBM Tioli Workload Scheduler. 2. Log on as a user in the local administrators group. 3. Insert the installation CD-ROM. 4. Exit all Windows applications, because you might be prompted to reboot. 5. Unzip the r3batch.zip into a temporary directory from: cd_path\r3batch\i386nt\ where cd_path specifies the location of your CD-ROM drie. 6. From your temporary directory, run the Setup.exe program. The Welcome window is displayed. It proides information about installing the R/3 extended agent software. If this ersion of the product is going to be installed on top of an existing installation, Setup asks for your confirmation and remoes the old installation. You then hae to re-run the Setup.exe program. 7. Click Next. The Choose Destination Location window is displayed. 8. Name the directory where Tioli Workload Scheduler is installed in your computer. IBM Tioli Workload Scheduler for Applications for R/3 will be installed in the methods subdirectory of TWShome. a. Click Browse to locate and select the TWShome directory. b. Click Next. 9. For the setup type, select Typical Installation. Chapter 2. Installation 5

16 10. Click Next to continue. 11. Select the Program Folder of the Tioli Workload Scheduler for Application for R/3 then click Next. If this is not a new installation and an R/3 extended agent options file already exists on your computer (in TWShome\methods), step 14 is anticipated here. 12. Specify the LJuser and the IFuser: LJuser The Tioli Workload Scheduler user name that executes the r3batch method. This must be a alid Windows account. IFuser The Tioli Workload Scheduler user name that executes the r3batch method to retriee job information. It must be the same as the LJuser. Note: Setup sets the job definition type (JobDef) to r3batch by default. It allows you to access R/3-specific job definition windows in Tioli Workload Scheduler through the Job Scheduling Console. If you want the standard job definition interface without specific R/3 entry fields, change the JobDef entry in the r3batch.opts file to Generic. 13. Click Next. If this is a first-time installation, a Modifying File window is displayed. In the Choose what you want Setup to do dialog box, select Let Setup modify the Serices file and click Next. 14. If prompted (that is, the r3batch.opts file already exists in the TWShome\methods directory) do one of the following: To create a new r3batch.opts file in the TWShome\methods directory, click No. To retain the existing r3batch.opts file, continue from the next step. 15. Click Next. The r3batch.opts file is created in the TWShome\methods directory. Note: During your installation of the program, a bar graph shows your progress. If you want to end the installation at any time, press Cancel. 16. When Setup is complete, click Finish to exit Setup. Note: If you plan to use National Language Support features, ensure the Launch the R3 Options Editor R3Opt check box is checked. This launches the options editor immediately after Setup. You can launch the options editor at any other time from the Start menu. For more information on National Language Support see Appendix C, National Language Support, on page 39. To learn how to edit the options file, see Appendix A, r3options File Reference, on page If the options editor is launched on a new installation, the r3options file does not exist. In the information window that tells you this, click OK to continue. Enter the options for each R/3 extended agent you are going to run. To see a listing of options with their descriptions, go to Appendix A, r3options File Reference, on page 31 or click Help in the options editor. 18. When you hae completed entering the options, click Sae and confirm. The r3options file is saed in the TWShome\methods directory. To define or manage multiple instances of the extended agent, use the Add/View/Modify dialog box of the options editor. When you add a new instance, an additional entry is inserted in the R/3 options file. 19. Click Exit and confirm. 6 IBM Tioli Workload Scheduler for Applications: User s Guide for R/3 Access Method

17 20. Using Tioli Job Scheduling Console or Composer, create a workstation definition in Tioli Workload Scheduler for each instance of R/3 extended agent. See Chapter 4, Setting Up for IBM Tioli Workload Scheduler, on page 17. For an explanation of terms and alues, see Appendix A, r3options File Reference, on page 31. Encrypting R/3 User Passwords When you make your entries in the r3options file using the r3setup script, the r3pass alue is automatically encrypted before it is written in the file. If you modify the file with a text editor, you must run the enigma program to encrypt the password before writing it in the file. Run the encryption command as follows: enigma [password] You can include the password on the command line or enter it in response to a prompt. The program returns an encrypted ersion that you can then enter in the r3options file. Chapter 2. Installation 7

18 8 IBM Tioli Workload Scheduler for Applications: User s Guide for R/3 Access Method

19 Chapter 3. R/3 Configuration Oeriew To communicate and control job execution on R/3 system using the IBM Tioli Workload Scheduler for Applications for R/3 you need to perform the following configuration steps on your R/3 enironment. The steps described in this chapter will require an R/3 BASIS Administrator. Here is an oeriew of the customization procedure: 1. Create the authorization profile. 2. Create a new RFC user ID in R/3 for IBM Tioli Workload Scheduler jobs. 3. Copy the correction and transport files from the IBM Tioli Workload Scheduler serer to the R/3 serer. 4. Import correction and transport files into R/3 and erify the installation. Note: These import procedures only add new ABAP/4 function modules to your R/3 system, and seeral new internal tables. No existing R/3 system objects are modified. Creating the Authorization Profile Before you create an RFC user ID for IBM Tioli Workload Scheduler batch processing, you must create the profile of the authorizations that the IBM Tioli Workload Scheduler user requires. These authorizations differ depending on your ersion of R/3. The R/3-defined authorizations are found under the Object Class Basis: Administration. Note: It is possible that S_RFC_ALL is found under the Object Class Cross-application Authorization Objects or Non-application-specific Authorization Objects. Create the following authorization profile: 1. To Create a profile called Z_MAESTRO. Note: Depending on the reision of the R/3 system, the following warning can occur: Choose another profile name (this name does not conform to the standard) This warning can be ignored or another name can be chosen. 2. Insert the following authorizations: Object Text Authorization S_RFC Auth. check for RFC access S_RFC_ALL S_XMI_PROD S_BTCH_ADM Auth. for External Management Interfaces (XMI) Background Processing: Background administrator S_XMI_ADMIN S_BTCH_ADM Copyright IBM Corp

20 Object Text Authorization S_BTCH_NAM S_BTCH_JOB S_XMI_LOG Background Processing: Background User Name Background Processing: Operations on Background Jobs Internal Access Authorizations for XMI Log S_BTCH_ALL S_BTCH_ALL S_XMILOG_ADM S_SPO_ACT Spool: Actions S_SPO_ALL S_SPO_DEV Spool: Deice Authorizations S_SPO_DEV_AL S_PROGRAM ABAP:program run checks S_ABAP_ALL Creating the IBM Tioli Workload Scheduler RFC User For IBM Tioli Workload Scheduler to communicate with R/3, you must create a user ID in R/3 for IBM Tioli Workload Scheduler batch processing. For security reasons, use a new user ID rather than an existing one. 1. Create a new RFC user ID. 2. Gie this new RFC user ID the following attributes: A user type of CPIC or Communications, depending on the R/3 release. A password at least six characters in length. Tioli Workload Scheduler requires this password to start or monitor R/3 jobs. If this password changes in R/3, you must update the options file used by r3batch with the new password. Assign the appropriate security profiles, depending on your ersion of R/3. Copy the Correction And Transport Files The setup file loads two correction and transport files into the IBM Tioli Workload Scheduler home directory. You must copy these correction and transport files to the R/3 serer and import them into the R/3 database, as follows: 1. On your R/3 database serer, log onto your R/3 system as an administrator. 2. Copy the control file and data file from the TWShome directory (if you are on Unix) or from the TWShome\methods directory (if you are on Windows) to the following directories on your R/3 database serer: copy controlfile /usr/sap/trans/cofiles/ copy datafile /usr/sap/trans/data/ Import ABAP/4 Modules into R/3 The names of controlfile and datafile ary from release to release. The files are installed in the TWShome directory (Unix) or in the TWShome\methods directory (Windows) and hae the following file names and format: K000xxx.TV1 (control file) and R000xxx.TV1 (data file), where xxx is a alue related to the release. This procedure generates, actiates, and commits new ABAP/4 function modules to your R/3 system and seeral new internal tables. No existing R/3 system objects are modified. 1. Change to the following directory: 10 IBM Tioli Workload Scheduler for Applications: User s Guide for R/3 Access Method

21 cd /usr/sap/trans/bin 2. Add the transport file to the buffer: tp addtobuffer transport sid where: transport is the transport request file. sid is your R/3 system ID. Under the TWShome directory (if you are on Unix), or the TWShome\methods directory (if you are on Windows), you can find a file named K000xxx.TV1, so the transport request is t1k000xxx. 3. Run the tp tst command to test the import: tp tst transport sid After you hae run this command, examine the log files in the /user/sap/trans/log directory for error messages. Warnings of seerity leel 4 are normal. If you hae errors, check with a person experienced in correction and transport, or try using unconditional modes to do the import. 4. Run the following command to import all the files in the buffer: tp import transport sid This command generates the new ABAP/4 modules and commits them to the R/3 database. They automatically become actie. After you hae run this command, examine the log files in the /user/sap/trans/log directory for error messages. Warnings of seerity leel 4 are normal. If a problem is encountered, use unconditional mode when executing this step: tp import transport sid U When the import is complete, check the log files to erify that the import was successful. The log files are in the /usr/sap/trans/log directory. Installing the Extended Agent on the R/3 System Install r3batch ABAP modules on the R/3 system. For details about installing the r3batch ABAP modules see Chapter 3, R/3 Configuration, on page 9. This Chapter includes instructions for creating an RFC user and installing the following ABAP modules: J_1O1_BDC_STATUS J_1O1_DATE_TIME J_1O1_JOB_ABAP_STEP_MODIFY J_1O1_JOB_ADD_ABAP_STEP J_1O1_JOB_ADD_EXTPGM_STEP J_1O1_JOB_CLOSE J_1O1_JOB_COPY J_1O1_JOB_DEFINITION_GET J_1O1_JOB_DELETE J_1O1_JOB_EXTPGM_STEP_MODFY J_1O1_JOB_FIND J_1O1_JOB_FINDALL J_1O1_JOB_HAS_EXTENDED_VARIANT J_1O1_JOB_LOG J_1O1_JOB_LOG_READ J_1O1_JOB_OPEN J_1O1_JOB_START J_1O1_JOB_STATUS J_1O1_JOB_STATUS_CHECK Chapter 3. R/3 Configuration 11

22 J_1O1_JOB_STOP J_1O1_RAISE_EVENT J_1O1_REPORT_ALL_SELECTIONS J_1O1_REPORT_DYNSEL_GET_DEF J_1O1_REPORT_GET_TEXTPOOL J_1O1_TABLE_GET_NAMETAB J_1O1_VARIANT_COPY J_1O1_VARIANT_COPY_4X J_1O1_VARIANT_CREATE J_1O1_VARIANT_CREATE_NEW J_1O1_VARIANT_DELETE J_1O1_VARIANT_DELETE_NEW J_1O1_VARIANT_EXISTS J_1O1_VARIANT_GET_DEFINITION J_1O1_VARIANT_GET_DEF_NEW J_1O1_VARIANT_GET_HELP_VALUES J_1O1_VARIANT_INFO_GET J_1O1_VARIANT_MAINTAIN_CNT_TBL J_1O1_VARIANT_MAINTAIN_SEL_TBL J_1O1_VARIANT_MODIFY J_1O1_VARIANT_MODIFY_NEW Troubleshooting the R/3 Connection If you are unable to submit R/3 jobs using IBM Tioli Workload Scheduler after the R/3 configuration, perform the following tests: Ensure you can ping the R/3 system from the IBM Tioli Workload Scheduler system. This will show basic network connectiity. Please note that using the R/3 routers to access the R/3 system could exceed the size of internal buffers of the RFC library used to store the hostname of the R/3 system. When this occurs, the hostname gets truncated, causing the connection to the R/3 system to fail. To work around this problem, use either not fully qualified names of R/3 routers or their IP addresses. Run the following telnet command to erify connectiity: telnet systemname 33xx where systemname is the system name or IP address of the R/3 serer and xx is the R/3 instance. Log on to the R/3 system as an administrator and erify that the IBM Tioli Workload Scheduler RFC user (created in the Creating the IBM Tioli Workload Scheduler RFC User on page 10) exists. Create a new IBM Tioli Workload Scheduler job to be run under R/3, and add the following adanced options: -debug -trace These options are selected using the radio buttons in the Properties - Job Definition Task page in the Job Scheduling Console. Using the -debug option, additional debug information is included in the job stdlist file (in IBM Tioli Workload Scheduler). When you use the -trace option, a trace file is created in the IBM Tioli Workload Scheduler home directory. On UNIX, this trace file is called de_rfc. On Windows, the file is called rfcxxxxx_xxxxx.trc. Ensure you delete the trace option from the job after you hae performed debug procedures. The trace file can become ery large and unmanageable. 12 IBM Tioli Workload Scheduler for Applications: User s Guide for R/3 Access Method

23 Note: Typically these options are for debugging the extended agent and should not be used in standard production. Verify that an R/3 gateway process is actie on the R/3 system to which you are connecting. Verify that a sapgwnn entry is present in the IBM Tioli Workload Scheduler system serices file. Note: If YP/NIS (or any other directory serice) is managing the serices entries, erify that the master serices file on your IBM Tioli Workload Scheduler system is being used rather than the local serices file. If you are installing on an AIX system that does not use U.S. English, you must install the U.S. Language Enironment on the IBM Tioli Workload Scheduler workstation and the R/3 database workstation. Otherwise the error BAD TEXTENV (or a similar error message) might appear in the de_rfc trace file and connections to R/3 will fail. Changing the Tioli Workload Scheduler RFC User ID Password If the password of the IBM Tioli Workload Scheduler RFC user ID is modified after the initial installation, the options file used by r3batch must be updated with this change. On UNIX, log on as root to the system where IBM Tioli Workload Scheduler is installed. On Windows, log on as an administrator and start a DOS shell on the system where IBM Tioli Workload Scheduler is installed, as follows: 1. Generate an encrypted ersion of the new password using the enigma command in TWShome/bin. To do this in a command shell, type: enigma newpass where newpass is the new password for the IBM Tioli Workload Scheduler RFC user ID. The enigma command prints an encrypted ersion of the password. 2. Copy the encrypted password into the options file, which is located in the TWShome/methods directory. The file can be edited with any text editor. Ensure you copy the password exactly, presering upper case, lower case, and punctuation. The encrypted password looks similar to: #TjM-pYm#-z82G-rB If the encrypted password is mistyped, IBM Tioli Workload Scheduler will not be able to start or monitor R/3 batch jobs. Migrating from Preious Versions This ersion of the Tioli Workload Scheduler extended agent for R/3 supports all releases of R/3 from 3.1g to 4.6x. To achiee R/3 XBP certification for R/3 release 4.0 and 4.5, a few changes had to be made to the scheduling agent. The Tioli Workload Scheduler extended agent for R/3 4.x uses the official R/3 RFC interfaces for job scheduling. These are: The SXMI_XBP interface for R/3 releases 3.1g to 4.0x The BAPI_XBP interface since release 4.5a To aoid conflicts with other endors, the Tioli Workload Scheduler ABAP modules now belong to the Tioli Workload Scheduler partner namespace Chapter 3. R/3 Configuration 13

24 J_1O1_xxx. After you hae completed the imports as described in Import ABAP/4 Modules into R/3 on page 10, the RFC J_1O1_xxx function modules are installed on your system. If you had a preious installation of Tioli Workload Scheduler extended agent for R/3 on your system, you can delete the following function modules from your R/3 system: Z_MAE2_BDC_STATUS Z_MAE2_DATE_TIME Z_MAE2_JOB_COPY Z_MAE2_JOB_DELETE Z_MAE2_JOB_FIND Z_MAE2_JOB_FINDALL Z_MAE2_JOP_OPEN Z_MAE2_JOB_LOG Z_MAE2_JOB_START Z_MAE2_JOB_STATUS Z_MAE2_JOB_STOP These are old ersions of the Tioli ABAP functions, which belong to the customer name space. You can also delete the function group YMA3. It is not necessary to delete the function modules and the function group, but you should do so if you want to clean up your system. Print Parameter and Job Class Issues Tioli Workload Scheduler extended agent for R/3 Version 4.x and 6.10 uses the official R/3 RFC interfaces for job scheduling. When you migrate from preious ersions of Tioli Workload Scheduler extended agent for R/3, there can be problems with print parameters in jobs launched by Tioli Workload Scheduler. This is because of limitations in the RFC interfaces. The following table shows the supported print parameters: Print Parameter 3.1x 4.0x 4.5x 4.6x output deice U U U U print immediately delete after output number of copies U U U U U U U U U U U U archiing mode U U U U authorization U U U U selection coer page x U U U sap coer page U U U U spool retention period U U U U recipient x x U U lines x x U U columns x x U U 14 IBM Tioli Workload Scheduler for Applications: User s Guide for R/3 Access Method

25 To resole the loss of print parameters during job copy, install the appropriate R/3 Support Package as stated in the R/3 notes and The same applies to the job class. Official R/3 interfaces allow only class C jobs. Installing the R/3 Support Package also resoles this issue. Chapter 3. R/3 Configuration 15

26 16 IBM Tioli Workload Scheduler for Applications: User s Guide for R/3 Access Method

27 Chapter 4. Setting Up for IBM Tioli Workload Scheduler This chapter describes how to perform the following tasks: Create the extended agent for R/3 workstation in the IBM Tioli Workload Scheduler network Create jobs in IBM Tioli Workload Scheduler that correspond to jobs already in the R/3 database Create jobs in the R/3 database controlled by IBM Tioli Workload Scheduler Create job streams that use IBM Tioli Workload Scheduler for Applications for R/3 jobs You can use the Tioli Job Scheduling Console to perform these tasks. See the Tioli Job Scheduling Console User s Guide for further reference. Defining an Extended Agent Workstation R/3 extended agent workstation definitions are required for each instance of R/3 that will run IBM Tioli Workload Scheduler controlled jobs. To define an R/3 extended agent workstation perform the following steps: 1. In the Tioli Job Scheduling Console, highlight the scheduler engine. 2. From the Selected menu, select New Workstation. The Properties - Workstation in Database window is displayed. Figure 1. Properties - Workstation in Database 3. In the Name field, enter a scheduler name for the R/3 extended agent workstation. This must be the same name that was entered in the options files as the xagent parameter, or the name of the configuration file specific to that extended-agent, see Appendix B, New Access Method Options Files, on page 33. The name can contain eight alphanumeric characters, or 16 Copyright IBM Corp

28 alphanumeric characters if you are using the expanded database option. The workstation name must start with a letter. 4. In the Node field, type null. 5. In the TCP Port field, type any number other than 0. The recommended alue is In the Operating System field, select OTHER. 7. In the Domain field, select the domain for this workstation. Note that the domain for the extended agent for R/3 must be the same as the domain for the host workstation. 8. If your scheduler network is using the Time Zone option, enter the time zone of the extended agent workstation. 9. In the Description field, enter a description for the scheduling agent. This field is an optional text description of the workstation and can be up to 40 characters. 10. Select the Workstation Type as scheduling agent. The Auto Link check box is automatically selected, and the Ignore check box is enabled, but deselected. Refer to the Tioli Workload Scheduler Reference Guide for more information. Full Status, Resole Dep, and Serer are disabled because they are not applicable to R/3 workstation definitions. 11. In the Access Method field, enter the name of the R/3 access method, r3batch. This file is run by the scheduler host to connect to an instance of R/ In the Host field, enter the scheduler name of the extended agent host. This is the scheduler master, fault-tolerant agent, or standard agent that hosts the R/3 extended agent definition. 13. Select OK to sae the workstation definition. Defining Extended Agent Jobs To control job execution on the R/3 workstation from IBM Tioli Workload Scheduler you must define the following: Jobs in R/3 that you want to run under IBM Tioli Workload Scheduler control. You can define these jobs using standard R/3 tools, or the Job Scheduling Console. Jobs in IBM Tioli Workload Scheduler that correspond to the jobs in R/3. The IBM Tioli Workload Scheduler job definitions are used in scheduling and defining dependencies, but the R/3 jobs are actually run. Defining a Job in IBM Tioli Workload Scheduler To create a new job definition in the IBM Tioli Workload Scheduler database for a job that already exists in the R/3 database, perform the following steps: 1. In the Job Scheduling Console, highlight the scheduler engine. 2. From the Selected menu, select New Job Definition. The Select a Task Type window is displayed. 3. From the Task Type scroll down menu, select the SAP job type and click OK. The Properties - Job Definition window is displayed. 18 IBM Tioli Workload Scheduler for Applications: User s Guide for R/3 Access Method

29 Figure 2. Properties - Job Definition 4. In the General page the Name field, enter a scheduler name for the R/3 job. The name can contain 8 alphanumeric characters or 40 alphanumeric characters if you are using the expanded database option. The job name must start with a letter. 5. In the Workstation field, click the ellipsis (...) to open a Find window to select an aailable workstation. 6. In the Description field, enter a description for the job. This field is an optional text description of the job and can be up to 64 alphanumeric characters. 7. In the Login field, enter the Tioli Workload Scheduler log on ID that is used to run the job. 8. Click Add Parameter to add any predefined parameters to the log on ID. 9. In the Recoery Options fields, specify any recoery options for the R/3 job. Refer to the Tioli Workload Scheduler Reference Guide for information about recoery options. 10. Select Task, the Task page is displayed. Chapter 4. Setting Up for IBM Tioli Workload Scheduler 19

30 Figure 3. Properties - Job Definition Task 11. Next to the Job Name field, click the ellipsis (...). The SAP Pick List window is displayed. 12. Use the pick list to find and select an R/3 job and click OK. The job information is is displayed in the Task page. 13. Click OK to sae the job definition to the scheduler database. Defining a Job in R/3 To create R/3 jobs that are controlled by IBM Tioli Workload Scheduler, use either of the following: The standard R/3 tools for defining jobs The Job Scheduling Console Refer to the R/3 documentation for information on creating jobs with R/3 tools. When creating jobs in R/3, do not assign a start time and do not specify any dependencies. These are specified and controlled in IBM Tioli Workload Scheduler. The job is identified in IBM Tioli Workload Scheduler by its R/3 job name and job ID. The same job can be scheduled to run repeatedly by IBM Tioli Workload Scheduler without haing to redefine it each time in R/3. Note: For R/3 jobs controlled by IBM Tioli Workload Scheduler, the job log output in R/3 is found under the user name defined in the r3user option of the options file. Defining a Job in IBM Tioli Workload Scheduler and R/3 To create a new job definition in the IBM Tioli Workload Scheduler database and a new job definition in the R/3 database perform the following steps: 1. In the Job Scheduling Console, highlight the scheduler engine. 2. From the Selected menu, select New Job Definition. The Select a Task Type window is displayed. 20 IBM Tioli Workload Scheduler for Applications: User s Guide for R/3 Access Method

31 3. From the Task Type scroll down menu, select the SAP job type and click OK. The Properties - Job Definition window is displayed. 4. In the Name field, enter a scheduler name for the R/3 job. The name can contain eight alphanumeric characters, or 40 alphanumeric characters if you are using the expanded database option. The job name must start with a letter. 5. In the Workstation field, click the ellipsis (...) button to open a Find window to select an aailable workstation. 6. In the Description field, enter a description for the job. This field is an optional text description of the job and can be up to 64 alphanumeric characters. 7. In the Login field, enter the Tioli Workload Scheduler log on ID that is used to run the job. 8. Click Add Parameter to add any predefined parameters to the log on ID. 9. In the Recoery Options fields, specify any recoery options for the R/3 job. Refer to the Tioli Workload Scheduler Reference Guide for information about recoery options. 10. Select Task. 11. Next to the Job Name field, click New. The SAP Job Definition window is displayed. 12. In SAP Job page, enter information about the job you are creating: a. In the Job Name field, type an R/3 job name. b. In the User Name field, type the name of the R/3 user who runs the job. c. In the Target Host field, type the name of the target workstation where this job is run. 13. In the Steps page you must add an ABAP or external program to the R/3 job. a. Click the Add row button to add a row to the steps table. b. Double-click in the Type field and select whether this is to be an ABAP or External step. c. In the Name field, enter an ABAP name or a fully qualified path and file name for an external program. d. In the Userfield, type the name of the R/3 user who runs this step. e. In the Var/Parm field, type a ariant name or a parameter, if necessary. Variants are used with ABAPs, and parameters are used with external programs, but both are optional. Not all ABAPs require ariants and not all external programs require parameters. f. In the Target Host field, enter the R/3 workstation where this step runs. Target hosts are only required for external programs. 14. When you hae completed creating the ABAP or external program steps, click OK. The R/3 job definition is saed to the R/3 database and the window is closed. If the R/3 job was successfully saed to the R/3 database, the Properties - Job Definition Task page should display an R/3 job ID. 15. Click OK in the Properties - Job Definition window to sae the job definition to the scheduler database. -client Command Line Option This is an ehancement introduced by the WSE-FP02 patch. When R3BATCH is inoked, it reads configuration information from an option file such as the R/3 host, the R/3 RFC use and forth. Moreoer it receies information about the R/3 job to run from IBM Tioli Workload Scheduler. Chapter 4. Setting Up for IBM Tioli Workload Scheduler 21

32 A TWS job could point to an R/3 job by specifying its job name (with the -job option) and job id (with the -i option) or jobname and user name (with the -user option) which it belongs to. Once R3BATCH has collected the whole set of information it connects to the R/3 system and makes a copy of the selected job (which is actually a template job) and marks it in the R/3 as able to run and sets its start time to start immediate. The copied job will belong to the RFC user used by R3BATCH to establish the connection and it will run on the R/3 client specified in the option file. By using the -client command line option it was possible to use a different client than the one specified in the option file. This option was incomplete, because there is an ambiguity between the client used to find the job to run and the client when the selected job should be actually run. With the current R3BATCH it is possible to use the following command line options: -client instructs R3BATCH to find a job definition in a specific R/3 client -exec_client instructs R3BATCH to exec a job in a specific R/3 client For instance, the following TWS job definition will copy the MYUSER s MYJOB1 job (defined in the client 555) in the client 888, een if the default client (defined in the options file) is 000: MYR3CPU#MYTWSJOB SCRIPTNAME "/ -job MYJOB1 -user MYUSER -client 555 -exec_client 888" STREAMLOGON "mytwsuser" DESCRIPTION "" RECOVERY STOP Note that the picklist function (proided by the JSC) will still display all the jobs defined in the default client. As default the JSC saes R/3 related jobs with the R/3 job name and R/3 job id. For instance, once the job MYJOB2 (with id ) has been selected on the picklist panel, the TWS job in the TWS database will look as follows: MYR3CPU#MYTWSJOB SCRIPTNAME "/ -job MYJOB -i " STREAMLOGON "mytwsuser" DESCRIPTION "" RECOVERY STOP In order customize this definition you could: 1. Modify the job definition through the TWS composer utility 2. remoe the JobDef=R3BATCH line in the r3batch.opts file and access to the job definition through the JSC as any other extended agent access method. In this way all the R/3 specific panels won t be no longer display until the JobDef=R3BATCH line is not inserted again in r3batch.opts. Tioli Workload Scheduler and R/3 Job States When an R/3 job is launched by Tioli Workload Scheduler, you can monitor its progress. The status transitions in Tioli Workload Scheduler (internal status) and the corresponding R/3 status are listed in the following table. Toli Workload Scheduler Job State INTRO WAIT R/3 Job State N/A Ready 22 IBM Tioli Workload Scheduler for Applications: User s Guide for R/3 Access Method

33 Toli Workload Scheduler Job State EXEC SUCC ABEND R/3 Job State Actie Finished Canceled The INTRO state indicates that Tioli Workload Scheduler is in the process of introducing the job, but in R/3, the job has not yet entered the ready state. Because it takes some time to get a job queued and into the ready column, the INTRO state may last a few minutes if the R/3 system is particularly busy. Although a job may be finished in R/3, Tioli Workload Scheduler will keep it in the EXEC state if its BDC sessions are not complete and you hae not selected the Disable BDC Wait option. To use this option see Appendix D, BDC Wait, on page 41. Defining Extended Agent Job Streams R/3 job streams are scheduled in the same manner as other IBM Tioli Workload Scheduler job streams and can include dependencies, run cycles, time restrictions, and other controls, except Files dependencies. Before creating job streams you must define the R/3 jobs to the IBM Tioli Workload Scheduler database. To define a job stream using R/3 job perform the following steps: 1. In the Job Scheduling Console, select the scheduler engine. 2. From the Selected menu, select New Job Stream. The Job Stream Editor and Properties - Job Stream windows are displayed. Figure 4. Properties - Job Stream General 3. In the Properties - Job Stream window, in the Name field, enter a name for the job stream. The name can contain eight alphanumeric characters, or 16 alphanumeric characters if you are using the expanded database option. The job stream name must start with a letter. Chapter 4. Setting Up for IBM Tioli Workload Scheduler 23

34 4. In the Workstation field, enter the name of the R/3 scheduling agent workstation that runs this job stream or use the ellipsis (...) button to search for an R/3 workstation. 5. When you hae finished, click OK to close the Properties - Job Stream window. All the fields in the Properties - Job Stream window, other than Name and Workstation, are optional. See the Tioli Job Scheduling Console User s Guide for further reference. 6. Add the R/3 jobs that you want to be part of this job stream in the Job Stream Editor window as shown below: Figure 5. Job Stream Editor a. In the Job Stream Editor, from the Actions menu, select Add Job, then Job Definition. The Properties - Job Definition window is displayed. b. In the Name field, enter the Tioli Workload Scheduler name of the R/3 job you want to add to the job stream. c. Repeat these steps to add all the desired R/3 jobs. Note: If you add two or more jobs you can specify dependencies between these jobs. 7. Create run cycles that determine the days that this job stream will run. 8. Sae the job stream by clicking Sae from the File menu. 24 IBM Tioli Workload Scheduler for Applications: User s Guide for R/3 Access Method