Command Reference
tmloadrepos
- creates or updates the binary Tuxedo Service Metadata Repository file and loads it with service parameter information
tmloadrepos
[-e|-d service1[,...]
] [-y
] [-i
repository_input
file] repository_file
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 respository 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:
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.
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.
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.
If -y
is specified, service information is edited, added, or deleted to the metatdata repository file directly without user confirmation,
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, Creating the Metadata Repository.
If an error is detected in the input, the offending line is printed to standard error along with a message indicating the problem.
Example 1: A simple tmloadrepos input file example.
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 2 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
tpgetrepos(3c), tpsetrepos(3c), tmunloadrepos(1)
, TMMETADATA(5), Managing The Tuxedo Service Metadata Repository