Section 1 - Commands

Command Reference

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 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:

-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 reposfileIf 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, 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 1 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 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