[TUXEDO] tmloadrepos command

 

tmloadrepos(1)

Name

tmloadrepos - creates or updates the binary Tuxedo Service Metadata Repository file and loads it with service parameter information

Synopsis

tmloadrepos [-e|-d service1[,...]] [-y] [-i repository_input file] repository_file

Description

Use this command to create or update the binary Tuxedo Service Metadata Repository file and load it with service parameter information.

If no repository file exists and no input file is specified, the repository file is created and service parameter information is input from the console (standard input). Standard input is also used if the repository file already exists, but no input file or particular service name is specified.

Note:

tmloadrepos cannot be used to update, add, or delete service parameter information in a JOLT Repository file.

 

tmloadrepos accepts the following options:

 

-i

 

When -i is specified, tmloadrepos uses a specific input file to create and load service parameter information into a new metadata repository file or to modify an existing one.

By default, the -i option allows tmloadrepos to keep pre-existing repository_file information that is not listed in repository_input file or if repository_input file has a syntax error.

Example 1: tmloadrepos -i infile reposfile
If the specified input file is not found, an error message appears.

 

 

 

-e

If -e is specified, tmloadrepos replaces all pre-existing repository information with the information specified by repository_input file.

If no repository_input file is specified, the user is required to enter service parameter information from the console and this information replaces the pre-existing repository information.

Example 2: tmloadrepos -e reposfile

Example 3: tmloadrepos -e -i infile reposfile

 

 

 

-d

If the -d is specified, tmloadrepos will delete information for the specified service(s) from the repository. -d cannot be used with the -i option and cannot use regular expressions to delete particular service information.

Example 4: tmloadrepos -d newservice reposfile

Note:

In order to prevent accidental information erasure, the -e and -d options prompt for user confirmation unless the -y option is specified.

A confirmation message appears and you must select “Y” to continue or “N” to discontinue editing, adding, or deleting any service information from the metadata repository file.

 

 

 

-y

If -y is specified, service information is edited, added, or deleted to the metatdata repository file directly without user confirmation,

Example 5: tmloadrepos -e -y -i infile reposfile

Example 6: tmloadrepos -d newservice -y reposfile

 

 

 

repository_input file

The repository_input file is a text-based file containing service/parameter keywords and their values. Keyword abbreviations are also supported. Both keywords and abbreviations are case sensitive. For a listing of keywords, abbreviations, and values, see Managing The Tuxedo Service Metadata Repository in Setting Up an Oracle Tuxedo Application <Default ? Font>, Creating the Metadata Repository.

 

repository_file

The tmloadrepos-created binary file that contains all metadata repository service information

Diagnostics

If an error is detected in the input, the offending line is printed to standard error along with a message indicating the problem.

 

 

 

Examples

 

Example 1: A simple tmloadrepos input file example.

 

Listing 7 TMLOADREPOS Input

service=TRANSFER
svcdescription=This service transfers money from one account to another
export=Y
inbuf=FML
outbuf=FML

param=ACCOUNT_ID
type=integer
paramdescription=The withdrawal account is 1st, and the deposit account is 2nd.
access=in
count=2
requiredcount=2

param=SAMOUNT
paramdescription=This is the amount to transfer. It must be greater than zero.
type=string
access=in
param=SBALANCE
paramdescription=The withdrawal account is 1st, and the deposit account is 2nd.
type=string
access=out
count=2
requiredcount=2

param=STATLIN
type=string
access=out

service=LOGIN
svcdescription=This service allows users to log in to the Acme Banking\ Corporation computer systems. Only tellers and trusted administrators may\
make use of this service.
inbuf=VIEW
inview=LOGINS
outview=LOGINR
export=Y

param=user
type=string
access=in

param=passwd
type=string
access=in

param=token
type=integer
access=out

 

Example 2: An embedded parameter tmloadrepos input file.

Listing 8 Embedded Parameter TMLOADREPOS Input

service=DEPOSIT
svcdescription=This service saves money to one account
export=Y
inbuf=FML32
outbuf=FML32

param=USER_INFO
type=fml32
paramdescription=user information of the account
access=in
count=1
requiredcount=1
fldnum=20000
# embedded field
(
       param=USERNAME
       type=string
       paramdescription=user name
       size=8
       count=1
       requiredcount=1
       fldnum=20001
       param=GENDER
       type=string
       size=6
       count=1
       requiredcount=1
       fldnum=20002
)
param=ACCOUNT_ID
type=integer
paramdescription=the deposit account.
access=in
count=1
requiredcount=1
fldnum=20003

param=SAMOUNT
paramdescription=This is the amount to transfer. It must be greater than zero.
type=string
access=in
fldnum=20004

param=SBALANCE
paramdescription=the deposit account
type=string
access=out
count=1
requiredcount=1
fldnum=20005

param=STATLIN
type=string
access=out
fldnum=20006

 

 

 

 

Examples

 

 

# tmloadrepos -e -i infile jrepository

# tmloadrepos -e -i  infile jrepository

WARN: contents of repository file /ofm/jwchoi/sw2/tp/tuxedo12.2.2.0.0/samples/atmi/simpapp/jrepository will be completely deleted
Proceed(Y/N)[N]?Y
tmloadrepos:4: warning: keyword(export): attribute value is not valid

tmloadrepos: info: service(TOUPPER): new loading successful

tmloadrepos:12: warning: keyword(export): attribute value is not valid

tmloadrepos: info: service(TOLOWER): new loading successful


tmloadrepos: info: service(TRANSFER): new loading successful


tmloadrepos: error: service(LOGIN): error: attribute(outview) is restricted to the service



Metadata Repository Load Summary
--------------------------------
Repository file name:      /ofm/jwchoi/sw2/tp/tuxedo12.2.2.0.0/samples/atmi/simpapp/jrepository
Services defined in file:  0
Services Inserted:         3
Services Replaced:         0
Services Errors:           1
Previous Services deleted: 0

 

# tmunloadrepos jrepository

 

# tmunloadrepos jrepository 
#
# #Generated from Repository file : /ofm/jwchoi/sw2/tp/tuxedo12.2.2.0.0/samples/atmi/simpapp/jrepository
#


#####################
# service : TOUPPER #
#####################
service=TOUPPER
servicetype=service
export=Y
inbuf=STRING
outbuf=STRING
tuxservice=TOUPPER
param=STRING
count=1
requiredcount=1
fractiondigits=0
type=string
access=inout
hidden=N

#####################
# service : TOLOWER #
#####################
service=TOLOWER
servicetype=service
export=Y
inbuf=STRING
outbuf=STRING
tuxservice=TOLOWER
param=STRING
count=1
requiredcount=1
fractiondigits=0
type=string
access=inout
hidden=N

######################
# service : TRANSFER #
######################
service=TRANSFER
servicetype=service
export=Y
inbuf=FML
outbuf=FML
svcdescription=This service transfers money from one account to another
tuxservice=TRANSFER
param=ACCOUNT_ID
count=2
requiredcount=2
fractiondigits=0
type=integer
access=in
paramdescription=The withdrawal account is 1st, and the deposit account is 2nd.
hidden=N
param=SAMOUNT
count=1
requiredcount=1
fractiondigits=0
type=string
access=in
paramdescription=This is the amount to transfer. It must be greater than zero.
hidden=N
param=SBALANCE
count=2
requiredcount=2
fractiondigits=0
type=string
access=out
paramdescription=The withdrawal account is 1st, and the deposit account is 2nd.
hidden=N
param=STATLIN
count=1
requiredcount=1
fractiondigits=0
type=string
access=out
hidden=N

 

 

 

 

https://docs.oracle.com/cd/E35855_01/tuxedo/docs12c/rfcm/rfcmd.html#1789066

Section 1 - Commands

\