Contents

Introduction

Purpose 1‑1

Organization 1‑1

See Also 1‑2

Overview of the Batch Runtime Environment

Oracle Tuxedo Application Runtime for Batch Presentation and Structure 2‑1

Technical Functions 2‑1

High-Level Functions 2‑1

Interface-Level Functions 2‑2

Script Execution Phases 2‑2

Using Batch Runtime

Configuration files 3‑1

BatchRT.conf 3‑2

Messages.conf 3‑2

FunctionReturnCode.conf 3‑2

ReturnCode.conf 3‑2

Setting Environment Variables 3‑2

Configuring Batch Runtime in MP Mode 3‑4

Creating a Script 3‑5

General Structure of a Script 3‑5

Script Example 3‑7

Defining and Using Symbols 3‑9

Creating a Step That Executes a Program 3‑10

Creating a Procedure 3‑11

Using a Procedure 3‑13

Modifying a Procedure at Execution Time 3‑13

Controlling a Script's Behavior 3‑16

Conditioning the Execution of a Step 3‑16

Controlling the Execution Flow 3‑18

Changing Default Error Messages 3‑19

Using Files 3‑19

Creating a File Definition 3‑19

Assigning and Using Files 3‑20

Using a Generation File (GDG) 3‑21

Using an In-Stream File 3‑23

Using a Set of Concatenated Files 3‑23

Using an External “sysin” 3‑24

Deleting a File 3‑24

RDB Files 3‑24

Using an RDBMS Connection 3‑25

Submitting a Job using INTRDR facility 3‑27

Submitting a Job With EJR 3‑27

LOG File Structure 3‑27

Using Batch Runtime With a Job Scheduler 3‑29

Executing an SQL request 3‑30

Simple Application on COBOL-IT / BDB 3‑30

Best Practices

Adapting z/OS Capabilities on a UNIX/Linux Environment 4‑1

Defining Paths for Procedures, Includes and Programs 4‑1

Prohibiting the Use of UNIX Commands 4‑2

Avoiding the Use of File Overriding 4‑2

Using Tuxedo Job Enqueueing Service (TuxJES)

Overview 5‑1

Requirements 5‑1

TuxJES Components 5‑2

Configuring a TuxJES System 5‑2

Setting up TuxJES as an Oracle Tuxedo Application 5‑2

Setting up TuxJES in MP mode 5‑7

Using TuxJES 5‑7

Submitting a Job 5‑7

Displaying Job Information 5‑8

Holding a Job 5‑9

Releasing a Job 5‑9

Canceling a Job 5‑9

Purging a Job 5‑10

Displaying/Changing ARTJESINITIATOR Configuration 5‑10

Event Subscribing/Unsubscribing 5‑10

See Also 5‑11