1.2.2 Service Contract Text File Output

If you want collected service contract discovery information logged to a file instead of directly to the metadata repository, you must use the TMMETADATA(5) -o<filename> option and then use tmloadrepos to manually load the file to the metadata repository. For more information, see tmloadrepos in the Oracle Tuxedo Command Reference Guide.

The output complies with the format imposed by tmloadrepos if a file is used as storage instead of the metadata repository. The file contains a service header section and a parameter section for each parameter. Service header contains items listed in the table below:

The "service" field format is <TuxedoServiceName>+'_'+<SequenceNo>. The suffix <SequenceNo> is used to avoid name conflict when multiple patterns are recognized for an Oracle Tuxedo service.

Note:

<SequenceNo> starts from the last <SequenceNo> number already stored in the metadata repository.

Service parameter contains information is listed in the following table:

Table 1-16 Service Level Attributes

Keyword (abbreviation) Sample Value Description
service(sv) TOUPPER_1 <RealServiceName>_<SequenceNo>.
tuxservice(tsv) TOUPPER The service name.
servicetype(st) service|oneway one way if TPNOREPLY is set.
inbuf(bt) STRING FML, FML32, VIEW, VIEW32, STRING, CARRAY, XML, X_OCTET, X_COMMON, X_C_TYPE, MBSTRING or other arbitrary string representing an application defined custom buffer type.
outbuf(BT) FML32 set to "NULL" if it is an error reply.
errbuf(ebt) STRING present only when it is an error reply.
inview - View name. Present only when inbuf is of type VEW or VIEW32.
outview - View name. Present only when outbuf is of type VIEW or VIEW32.
errview - View name. Present only when errbuf is of type VIEW or VIEW32.
autodiscovery true Set to "true".

Table 1-17 Parameter Level Attributes

Keyword (abbreviation) Sample Description
param(pn) USER_INFO -
paramdescription(pd) service parameter -
access(pa) in A combination of {in}{out}{err}.
type(pt) fml32 byte, short, integer, float, double, string, carray, dec_t, xml, ptr, fml32, view32, mbstring.
subtype(pst) - A view name for a view or view32 typed parameter.
count 100 The maximum occurrence of FML/FML32 field watched during the collection period
requiredcount 1 The minimum occurrence of FML/FML32 field watched during the collection period.