JetNet/Oracle Tuxedo Guide

A

Accessors

maximum number for machine 3-13

Advertise and Unadvertise Events 6-8

Advertise event 6-8

built-in handlers 6-10

handler contract 6-9

Application

booting from command line A-5

configuring middleware 3-1

libraries 2-3

packaging checklist F-2

Motif/UNIX F-5

Windows F-2

setting up

JetNet E-1

shutting down from command line A-9

Application components

activating and deactivating 4-2

adding and deleting 3-6

editing properties 3-7

forcibly deactivating 4-5

interaction 1-3

Application configuration properties 3-7

Application directory 2-2, 3-14

Application Name property 3-8

Application Password property 3-12

Application server

defined 1-3

Application-level event scope

advertise handlers 6-9

exception handlers 6-12

jif_changed handlers 6-16

message handlers 6-19

post_request handlers 6-21

post_service handlers 6-25

pre_request handlers 6-21

pre_service handlers 6-25

request_received handlers 6-22

server_exit handlers 6-24

unadvertise handlers 6-9

unload handlers 6-29

ASCII output

JetNet configuration file A-4

Auto Advertised Services option 3-23

B

Backup master machine 3-8

BBL 1-3

Blocking timeout

setting default 3-12

Built-in handlers 6-6

advertise events 6-10

exception events 6-15

jif_changed events 6-17

message events 6-20

post_requests events 6-21

post_service events 6-28

pre_request events 6-21

pre_service events 6-27

request_received events 6-23

server_exit events 6-24

unadvertise events 6-10

unload events 6-31

Built-in services 7-1

C

Cache Service Containers property 3-27

Client

environment 2-8

Client authentication

setting application password 3-12

Client connection

enabling 2-8

Client events 6-1

Client Timeout property 3-18

Client/server

comparison 1-1

clnt2svr A-2, B-1

and transaction model 7-1

Conversion utilities

rb2asc A-4

D

Data transport buffers 8-1

Database Connect String property

for conversion server 3-26

for standard server 3-26

Database connections

via server initialization 8-18

DBBL 1-3

Debuggable server

configuring 8-18

Default Blocking Timeout property 3-12

Deployment

directory structure

JetNet/BEA Tuxedo F-1

Dequeue 8-13

Development Server ID property 3-27

E

Enable Cross-Service Calls option 3-23

Enqueue 8-12

Enterprise Bank

design issues C-27

Error messages

JetNet 4-10

Event

post 8-5

subscribe 8-5

Event broker 8-5

example 8-8

used in Enterprise Bank C-1

Event processing

request broker 6-1

Event scope

defined 6-3

jif_changed handler 6-16

message handler 6-19

Exception code property

set in exception handler 6-11

Exception event 6-11

built-in handlers 6-15

handler contract 6-13

handler scope 6-12

handlers 6-11

severity 6-13

TP_UNLOAD_FAILED 6-30

types of D-1

Exception severity property

set in exception handler 6-12

Exception types D-1

External Network Address property

for workstation connections 3-18

F

Firewall

specifying workstation listener 3-18

FML buffers 5-17, 8-2

converted from JAMFLEX 5-18

FML file 5-17

I

Independent queue 8-15

Init Routine property 3-26

Initialization

server 8-17

Installation directory

specifying in configuration file 3-14

IP Address property 3-15

IPC Key property 3-8

IPC resources 2-15

controlling through JetMan configuration 4-9

message queues 2-12

semaphores 2-14

shared memory 2-15

J

JAMFLEX buffers

converting to FML 5-18

JDB

in Enterprise Bank C-1

JetNet

setting up application E-1

JetNet configuration file

application properties 3-7

ASCII/binary conversion A-4

changing selection 3-7

creating with JetNet manager 3-2

creating with rbconfig A-6

defined 1-3

editing 3-5

machine properties 3-12

server properties 3-19

specifying location 3-14

JetNet manager 3-1

connecting as client 4-4

disconnecting from application 4-5

setting default configuration file 3-2

JetNet utilities

rbboot A-5

rbconfig A-6

rblisten A-7

rbshutdown A-9

jetrb1

modifying 7-2

JIF

invoking service with 5-12

reliable queue identification 8-14

Jif_changed event 6-15

built-in handlers 6-17

handler contract 6-17

L

Library

setting shared access for workstation client

setting shared access for client 2-8

Listener Port property

for machine listener process 3-15

Listener process

specifying port 3-15

starting A-7

Load Balancing property 3-11

Local JetNet Configuration File property 3-14

Log file

JetNet 4-10

M

Machine

activating and deactivating 4-4

adding to application configuration 3-6

listener port 3-15

maximum number in configuration 3-10

removing from application configuration 3-6

Machine configuration properties 3-12

network settings 3-15

Machine environment file

required entries 2-5

Master machine

reassigning 3-8

reassigning in active application 4-7

Max Accessors property 3-13

Max Machines property 3-10

Max Server Processes property 3-10

Max Servers property 3-11

Max Services property 3-11

Memory model property 3-8

Message

dequeuing 8-13

enqueuing 8-12

queue 8-11

Message event 6-17

built-in handlers 6-20

handler contract 6-19

Message queuing

in Enterprise Bank C-1

setting resources 2-12

Middleware configuration file

defined 2-10

Min Handlers property 3-18

Minimum Instances property 3-20

Motif

deploying application F-5

Multiprocessor property 3-13

N

Name property

for machine 3-13

for server 3-20

Network Device property 3-15

Network settings

in machine configuration 3-15

P

Panther Install Directory property 3-14

Partial command 7-2, B-4

Password

setting for application 3-12

Post_request event 6-20

built-in handlers 6-21

handler contract 6-21

handlers 6-20

Post_service event 6-25

built-in handlers 6-28

handlers 6-25

Pre_request event 6-20

built-in handlers 6-21

handler contract 6-21

handlers 6-20

Pre_service event 6-25

built-in handlers 6-27

handlers 6-25

Public module

for service routines 5-13

Q

Queuespace 8-14

R

rb2asc A-4

rbboot A-5

rbconfig A-6

rblisten A-7

rbshutdown A-9

Reliable queue 8-11

example of 8-15

identifying 8-14

Report service

configuring standard server to advertise 3-23

Request broker

and client 7-1

and transaction control 7-3

events 6-1

Request broker event handlers 6-5

advertise events 6-9

contract 6-9

built-in 6-6

default handlers 6-7

exception events 6-11

contract 6-13

installing 6-3

jif_changed events 6-16

contract 6-17

message events 6-17

contract 6-19

post_request events 6-20

contract 6-21

post_service events 6-25

contract 6-26

pre_request events 6-20

contract 6-21

pre_service events 6-25

contract 6-26

request_received events 6-22

contract 6-23

server_exit events 6-24

contract 6-24

unadvertise events 6-9

contract 6-9

unload events 6-29

contract 6-29

Request broker events

default handlers 6-7

generated from within a handler 6-5

types 6-1

Request_received event 6-22

built-in handlers 6-23

Request-level event scope

exception handlers 6-12

unload handlers 6-29

S

Sample application

Enterprise Bank C-1

Semaphores

setting parameters 2-14

Server

activating and deactivating 4-4

adding and removing instances 4-6

adding to application configuration 3-6

balance load distribution among 3-11

connecting to database 3-26

enabling to request services 3-23

error output to stderr 4-10

initialization routine 3-26

initializing 8-17

maximum allowed in application 3-11

maximum processes allowed in application 3-10

message forwarding 8-11

options 8-17

removing from application configuration 3-6

restart frequency 3-21

setting advertised services 3-23

types 3-20

Server configuration properties 3-19

Server environment file 2-3

format 2-5

required entries 2-6

specifying for server 3-14, 3-21

Server Environment Variable File property 3-14, 3-21

Server events 6-1

Server Executable option

for standard server 3-23

Server Executable property

for conversion server 3-26

Server executables

specifying for conversion server 3-26

specifying for standard server 3-23

types 2-2

Server initialization

example in Enterprise Bank C-28

Server instances

adding and removing 4-6

initial number 3-20

Server library

creating via clnt2svr B-1

Server Restart Frequency property 3-21

Server Type property 3-20

Server_exit event 6-23

built-in handlers 6-24

handler contract 6-24

Service

aborting 6-25

adding to service group 5-14

built-in 7-1

limitations 7-2

components of 5-2

creating 5-5

defining in JIF 5-4

in transaction model 7-1

initiating 5-8, 5-12

Service container 5-3

and JPL 5-12

creating 5-5

creating via clnt2svr B-1

editing 5-7

Service containers

caching for conversion server 3-27

Service group 5-13

adding service to 5-14

Service messages

argument types 5-15

default mapping of output data 5-16

defining argument types 5-19

FML arguments 5-17

forwarding 8-5

listing buffer fields 5-16

NULL arguments 5-17

STRING arguments 5-18

Service properties 5-5

Service queue 8-14

Service request

forwarding 8-5

Service routine 5-2, 5-9

Services

advertising automatically 3-23

maximum allowed advertised in application 3-11

Severity

of exception events 6-13

Shared memory

setting resources 2-15

Shared Memory Protection property 3-12

sm_tp_advertise_cond_winopen 6-10

sm_tp_advertise_ignore 6-10

sm_tp_advertise_log 6-10

sm_tp_advertise_winopen 6-10

sm_tp_exception_no_change 6-15

sm_tp_exception_print_all 6-15

sm_tp_exception_print_warning 6-15

sm_tp_exception_promote_error 6-15

sm_tp_jif_changed_ignore 6-17

sm_tp_jif_changed_read 6-17

sm_tp_message_ignore 6-20

sm_tp_message_print_string 6-20

sm_tp_post_request_ignore 6-21

sm_tp_post_service_ignore 6-28

sm_tp_post_service_winclose 6-28

sm_tp_post_service_windeselect 6-28

sm_tp_pre_request_ignore 6-21

sm_tp_pre_service_ignore 6-28

sm_tp_pre_service_winopen 6-28

sm_tp_pre_service_winopen_or_select 6-28

sm_tp_pre_service_winselect 6-28

sm_tp_request_received_ignore 6-23

sm_tp_request_received_jif_check 6-23

sm_tp_server_exit_ignore 6-24

sm_tp_server_exit_log_down 6-24

sm_tp_unadvertise_cond_winclose 6-10

sm_tp_unadvertise_ignore 6-10

sm_tp_unadvertise_log 6-10

sm_tp_unadvertise_winclose 6-10

sm_tp_unload_call_origin 6-31

sm_tp_unload_immediate 6-31

SMRBHOST 2-9

SMRBPORT 2-9

Status window

in JetNet manager 4-10

STRING data transport buffer 8-3

STRING message arguments 5-18

T

Three-tier applications

conversion from 2-tier B-1

Three-tier architecture

sample application C-1

TMQFORWARD 8-12, 8-14

TMQUEUE 8-12

TMSYSEVT 8-6

TMUSREVT 8-6

TP_COMMAND 6-14

TP_CONNECTION 6-14

TP_ERROR 6-14

TP_INFORMATION 6-13

TP_MESSAGE 6-14

TP_NONE 6-13

TP_PANIC 6-15

TP_REQUEST 6-14

TP_TRANSACTION 6-14

TP_WARNING 6-14

Transaction

control and request broker 7-3

Transaction control 8-3

Transaction model

for request broker

modifying 7-2

Transaction-level event scope

exception handlers 6-12

unload handlers 6-29

TUXEDO 8-1

setting up application E-1

U

ULOG file 4-10

Unadvertise event 6-8

built-in handlers 6-10

handler contract 6-9

UNIX

deploying application F-5

UNIX kernel

setting for Panther application 2-15

Unload event 6-28

built-in handlers 6-31

Unnamed procedure

for service routine 5-12

Utilities

clnt2svr A-2, B-1

rb2asc A-4

rbboot A-5

rbconfig A-6

rblisten A-7

rbshutdown A-9

W

Web applications

specifying firewall access 3-18

Windows

deploying application F-2

Workstation client

connecting to application 1-4

defined 1-2

environment 2-8

idle time allowed 3-18

Workstation handler

minimum available on machine 3-18

timing out idle client 3-18

Workstation listener process

specifying network address 3-18

X

XA transactions 8-3