Table of Contents Previous Next PDF


Migrating from Jolt Repository to Oracle Tuxedo Service Metadata Repository
Migrating from Jolt Repository to Oracle Tuxedo Service Metadata Repository
Jolt Repository is deprecated in this release. All service definitions stored in Jolt repository can be loaded in the Tuxedo metadata repository using the bulk loader tool.
The original Jolt repository server JREPSVR is also deprecated, and all services that JREPSVR provided are now provided by TMMETADATA. If tmloadcf detects presence of JREPSR in ubbconfig, it automatically removes JREPSVR and adds TMETADATA if not already configured.
Using one repository (Tuxedo metadata repository) and one server (TMMETADATA) improve operational effectiveness and reduces the risk of service definitions getting out of sync.
This topic includes the following sections:
•
Replacing JREPSVR with TMMETADATA in UBBCONFIG
•
Loading Jolt Repository to Oracle Tuxedo Service Metadata Repository
•
Sample: joltapp Migration
Notes:
 
•
TMMETADATA must run on Oracle Tuxedo 12c Release 2 (12.2.2) or later.
•
Oracle Tuxedo Service Metadata Repository does not support package function.
•
Bulk Loader is still supported but some behaviors are changed.
•
Do not support for deleting service definitions. You should use tmloadrepos -d service[...] or the Metadata Editor to delete services.
•
service (that represents the service entry stored in the Metadata Repository) and tuxservice (that represents the actual Oracle Tuxedo service name) must be same; otherwise you cannot update this service definition and JSH in Oracle Tuxedo 12c Release 1 (12.1.3) or earlier cannot work.
•
The servicetype must be "service"; otherwise you cannot update this service definition.
Replacing JREPSVR with TMMETADATA in UBBCONFIG
Oracle Tuxedo command tmloadcf browses your UBBCONFIG and creates a new one (you can compare these two UBBCONFIG files to see the difference after invoking tmloadcf).
In your UBBCONFIG,
•
If JREPSVR is configured, tmloadcf automatically replaces JREPSVR with TMMETADATA when creating the new UBBCONFIG.
In this scenario, tmloadcf prints a prompt like this:
CMDTUX_CAT:8401: WARNING: The JoltRepository Server has been deprecated and replaced with the Tuxedo Servicata Server
•
If both JREPSVR and TMMETADATA are configured, tmloadcf just ignores JREPSVR when creating the new UBBCONFIG.
In this scenario, tmloadcf prints a prompt like this:
CMDTUX_CAT:8401: WARNING: The JoltRepository Server has been deprecated and replaced with the Tuxedo Service Metadata Server
You can use tmloadrepos/tmunloadrepos to load Jolt Repository file to Metadata Repository file; this loading is necessary because you can access to Jolt Repository only after it is loaded to Metadata Repository. If you want to update the loaded Metadata Repository, you should remove -r option from TMMETADATA in UBBCONFIG. For more information, see tmloadcf(1).
Loading Jolt Repository to Oracle Tuxedo Service Metadata Repository
You should use Oracle Tuxedo command tmunloadrepos to display Jolt Repository in plain text, which tmloadrepos can parse. See tmloadrepos(1) and tmunloadrepos(1) for more information.
Two parameter-level keywords, fieldname and fieldindex, are added to the Oracle Tuxedo Service Metadata Repository for this loading (and for FML/FML32 only). See Creating The Oracle Tuxedo Service Metadata Repository for more information.
Sample: joltapp Migration
This is a sample for migrating joltapp from Jolt Repository to Oracle Tuxedo Service Metadata Repository.
1.
Use tmloadcf to compile UBBCONFIG, which handles JREPSVR automatically. See Listing 7‑1 for an example.
2.
Use tmunloadrepos to load Jolt Repository file named jrep (see Listing 7‑2) to Oracle Tuxedo Service Metadata Repository file named jolt.metarepos (see Listing 7‑3).
3.
Use tmloadrepos to insert the above jolt.metarepos file into the original Metadata Repository file. See Listing 7‑4 for an example.
Listing 7‑1 Example for Compiling UBBCONFIG
$ tmloadcf -y ubb
$ tmunloadcf #to check whether JREPSVR still existed.
 
Listing 7‑2 Example for jrep
$ cat jrep
!JOLT1.0
add SVC/.NUMRECS:vs=1:ex=0:bt=FML32:\
bp:pn=NRECS:pt=integer:pf=33554435:pa=rd:ep:\
bp:pn=STATLIN:pt=string:pf=167772163:pa=rd:ep:
add SVC/.GETREC:vs=1:ex=0:bt=FML32:\
bp:pn=REPNAME:pt=string:pf=167772161:pa=wr:ep:\
bp:pn=REPVALUE:pt=string:pf=167772162:pa=rd:ep:\
bp:pn=STATLIN:pt=string:pf=167772163:pa=rd:ep:
add SVC/.GETSVC:vs=1:ex=0:bt=FML32:\
bp:pn=REPNAME:pt=string:pf=167772161:pa=wr:ep:\
bp:pn=REPVALUE:pt=string:pf=167772162:pa=rd:ep:\
bp:pn=STATLIN:pt=string:pf=167772163:pa=rd:ep:
add SVC/.ADDREC:vs=1:ex=0:bt=FML32:\
bp:pn=REPVALUE:pt=string:pf=167772162:pa=wr:ep:\
bp:pn=STATLIN:pt=string:pf=167772163:pa=rd:ep:
add SVC/.DELREC:vs=1:ex=0:bt=FML32:\
bp:pn=REPNAME:pt=string:pf=167772161:pa=wr:ep:\
bp:pn=STATLIN:pt=string:pf=167772163:pa=rd:ep:
add SVC/.GETKEYS:vs=1:ex=1:bt=FML32:\
bp:pn=PATTERN:pt=string:pf=167772164:pa=wr:ep:\
bp:pn=NRECS:pt=integer:pf=33554435:pa=rd:ep:\
bp:pn=REPNAME:pt=string:pf=167772161:po=0:pa=rd:ep:
add SVC/.GETALL:vs=1:ex=0:bt=FML32:\
bp:pn=PATTERN:pt=string:pf=167772164:pa=wr:ep:\
bp:pn=NRECS:pt=integer:pf=33554435:pa=rd:ep:\
bp:pn=REPVALUE:pt=string:pf=167772162:po=0:pa=rd:ep:
add SVC/.FLUSHCACHE:vs=1:ex=0:bt=FML32:\
bp:pn=REPNAME:pt=string:pf=167772161:po=200:pa=wr:ep:
add SVC/.GARBAGECOLLECT:vs=1:ex=0:bt=FML32:\
bp:pn=STATLIN:pt=string:pf=167772163:pa=rd:ep:
add SVC/INQUIRY:vs=1:ex=1:bt=FML:\
bp:pn=ACCOUNT_ID:pt=integer:pf=33554436:pa=wr:ep:\
bp:pn=SBALANCE:pt=string:pf=167772164:pa=rd:ep:\
bp:pn=STATLIN:pt=string:pf=167772163:pa=rd:ep:\
bp:pn=FORMNAM:pt=string:pf=167772165:pa=rd:ep:
add SVC/WITHDRAWAL:vs=1:ex=1:bt=FML:\
bp:pn=ACCOUNT_ID:pt=integer:pf=33554436:pa=wr:ep:\
bp:pn=SAMOUNT:pt=string:pf=167772166:pa=wr:ep:\
bp:pn=SBALANCE:pt=string:pf=167772164:pa=rd:ep:\
bp:pn=STATLIN:pt=string:pf=167772163:pa=rd:ep:\
bp:pn=FORMNAM:pt=string:pf=167772165:pa=rd:ep:
add SVC/DEPOSIT:vs=1:ex=1:bt=FML:\
bp:pn=ACCOUNT_ID:pt=integer:pf=33554436:pa=wr:ep:\
bp:pn=SAMOUNT:pt=string:pf=167772166:pa=wr:ep:\
bp:pn=SBALANCE:pt=string:pf=167772164:pa=rd:ep:\
bp:pn=BALANCE:pt=float:pf=100663303:pa=rd:ep:\
bp:pn=STATLIN:pt=string:pf=167772163:pa=rd:ep:\
bp:pn=BALANCE:pt=float:pf=100663303:pa=rd:ep:\
bp:pn=STATLIN:pt=string:pf=167772163:pa=rd:ep:\
bp:pn=FORMNAM:pt=string:pf=167772165:pa=rd:ep:
add SVC/TRANSFER:vs=1:ex=1:bt=FML:\
bp:pn=ACCOUNT_ID:pt=integer:pf=33554436:po=2:pa=wr:ep:\
bp:pn=SAMOUNT:pt=string:pf=167772166:pa=wr:ep:\
bp:pn=SBALANCE:pt=string:pf=167772164:po=2:pa=rd:ep:\
bp:pn=STATLIN:pt=string:pf=167772163:pa=rd:ep:\
bp:pn=FORMNAM:pt=string:pf=167772165:pa=rd:ep:
add PKG/BANKAPP:INQUIRY:DEPOSIT:WITHDRAWAL:TRANSFER:
add SVC/TOUPPER:vs=1:ex=1:bt=STRING:\
bp:pn=STRING:pt=string:pf=167772161:pa=rw:ep:
add PKG/SIMPSERV:TOUPPER:
 
Listing 7‑3 Example for jolt.metarepos
$ tmunloadrepos jrep >jolt.metarepos
 
# #Generated from Repository file : /u01/common/patches/huchchen/TUX13c64/LC/bld/qa/sanity_tests/apps/joltapp/jrep
#
#####################
# service : .GETALL #
#####################
service=.GETALL
export=N
inbuf=FML32
outbuf=FML32
version=1
param=PATTERN
type=string
access=in
param=NRECS
type=integer
access=out
param=REPVALUE
count=0
type=string
access=out
 
######################
# service : .GETKEYS #
######################
service=.GETKEYS
export=Y
inbuf=FML32
outbuf=FML32
version=1
param=PATTERN
type=string
access=in
param=NRECS
type=integer
access=out
param=REPNAME
count=0
type=string
access=out
 
#####################
# service : .ADDREC #
#####################
service=.ADDREC
export=N
inbuf=FML32
outbuf=FML32
version=1
param=REPVALUE
type=string
access=in
param=STATLIN
type=string
access=out
 
######################
# service : TRANSFER #
######################
service=TRANSFER
export=Y
inbuf=FML
outbuf=FML
version=1
param=ACCOUNT_ID
count=2
type=integer
access=in
param=SAMOUNT
type=string
access=in
param=SBALANCE
count=2
type=string
access=out
param=STATLIN
type=string
access=out
param=FORMNAM
type=string
access=out
 
########################
# service : WITHDRAWAL #
########################
service=WITHDRAWAL
export=Y
inbuf=FML
outbuf=FML
version=1
param=ACCOUNT_ID
type=integer
access=in
param=SAMOUNT
type=string
access=in
param=SBALANCE
type=string
access=out
param=STATLIN
type=string
access=out
param=FORMNAM
type=string
access=out
 
#############################
# service : .GARBAGECOLLECT #
#############################
service=.GARBAGECOLLECT
export=N
inbuf=FML32
outbuf=FML32
version=1
param=STATLIN
type=string
access=out
 
#####################
# service : TOUPPER #
#####################
service=TOUPPER
export=Y
inbuf=STRING
outbuf=STRING
version=1
param=STRING
type=string
access=inout
 
#####################
# service : .DELREC #
#####################
service=.DELREC
export=N
export=N
inbuf=FML32
outbuf=FML32
version=1
param=REPNAME
type=string
access=in
param=STATLIN
type=string
access=out
 
#########################
# service : .FLUSHCACHE #
#########################
service=.FLUSHCACHE
export=N
inbuf=FML32
outbuf=FML32
version=1
param=REPNAME
count=200
type=string
access=in
 
######################
# service : .NUMRECS #
######################
service=.NUMRECS
export=N
inbuf=FML32
outbuf=FML32
version=1
param=NRECS
type=integer
access=out
param=STATLIN
type=string
access=out
 
#####################
# service : INQUIRY #
#####################
service=INQUIRY
export=Y
inbuf=FML
outbuf=FML
version=1
param=ACCOUNT_ID
type=integer
access=in
param=SBALANCE
type=string
access=out
param=STATLIN
type=string
access=out
param=FORMNAM
type=string
access=out
 
#####################
# service : DEPOSIT #
#####################
service=DEPOSIT
export=Y
inbuf=FML
outbuf=FML
version=1
param=ACCOUNT_ID
type=integer
access=in
param=SAMOUNT
type=string
access=in
param=SBALANCE
type=string
access=out
param=BALANCE
type=float
access=out
param=STATLIN
type=string
access=out
param=FORMNAM
type=string
access=out
 
#####################
# service : .GETSVC #
#####################
service=.GETSVC
export=N
inbuf=FML32
outbuf=FML32
version=1
param=REPNAME
type=string
access=in
param=REPVALUE
type=string
access=out
param=STATLIN
type=string
access=out
 
#####################
# service : .GETREC #
#####################
service=.GETREC
export=N
inbuf=FML32
outbuf=FML32
version=1
param=REPNAME
type=string
access=in
param=REPVALUE
type=string
access=out
param=STATLIN
type=string
access=out
 
Listing 7‑4 Example for Inserting jolt.metarepos to the Original Metadata Repository File
tmloadrepos -i meta.data jolt.metarepos
 
 

Copyright © 1994, 2017, Oracle and/or its affiliates. All rights reserved.