JCA Resource Adapter Utilities

4 JCA Resource Adapter Utilities

This document provides reference information for Oracle Communications Billing and Revenue Management (BRM) JCA Resource Adapter and Web Services Manager utilities.

Topics in this document:

pin_dd_to_schema

Use the pin_dd_to_schema utility to generate the XSD schema for your storable classes and subclasses.

For more information, see "Generating the Schema for Your Storable Classes and Subclasses".

Note:

To connect to the BRM database, the pin_dd_to_schema utility needs a configuration file in the directory from which you run the utility. See "Connecting BRM Utilities" in BRM System Administrator's Guide.

Location

BRM_home/bin

Syntax

pin_dd_to_schema  -e config_file | -r storable_class | -h

Parameters

-e config_file

Generates the schema for all storable classes listed in the configuration file and their subclasses. For example, if the configuration file lists the /service/telco/gsm storable class, the utility generates the schema for /service/telco/gsm, /service/telco/gsm/telephony, /service/telco/gsm/sms, and any other /service/telco/gsm subclasses in your system.

Note:

You must specify both the name and path of the configuration file.

-r storable_class

Generates the schema for the specified storable class and all of its subclasses. For example:

pin_dd_to_schema -r /service/telco/gsm

-h

Displays the syntax and parameters for this utility.

Results

The pin_dd_to_schema utility generates the output files in the directory from which it was run.

The utility notifies you only if it encounters errors. For errors, look in the default.pinlog file, which is created in the directory from which the utility was run.

Note:

If you receive the following error when running pin_dd_to_schema on Linux systems, set the LC_ALL environment variable to C (setenv LC_ALL C) and then rerun the utility.

Malformed UTF-8 character
(unexpected continuation byte 0xac, with no preceding start byte)
in bitwise and (&) at BRM_home/lib/5.8.0/Switch.pm line 251.
Malformed UTF-8 character (unexpected continuation byte 0xab, with
no preceding start byte) in bitwise and (&).

pin_opspec_to_schema

Use the pin_opspec_to_schema utility to generate XSD schema files for opcodes.

For more information, see "Generating the Schema for Your Opcodes".

Location

BRM_home/bin

Syntax

pin_opspec_to_schema -i input_file [-o output_file] [-h]

Parameters

-i input_file: Specifies the name and location of the opcode XML flist specification file to convert into XSD schema. If you do not specify the absolute path to the file, the utility looks in the current directory.
-o output_file: Creates the XSD schema output file using the name and location you specify. By default, the utility generates an output file named opcode_name.xsd in the directory from which you run the utility.
-h: Displays the syntax and parameters for this utility.

Results

The pin_opspec_to_schema utility notifies you when it successfully generates schema files. Any errors are displayed on the console.

pin_opspec_to_schema_v2

Use the pin_opspec_to_schema_v2 utility to generate XSD schema files for opcodes that take payload as XML element.

For more information, see "Generating the Schema for Your Opcodes".

Location

BRM_home/bin

Syntax

pin_opspec_to_schema_v2 -i input_file > output_file

Parameters

input_file: Specifies the name and location of the opcode XML flist specification file to convert into XSD schema. If you do not specify the absolute path to the file, the utility looks in the current directory.
output_file: Creates the XSD schema output file using the name and location you specify. By default, the utility generates an output file named opcode_name.xsd in the directory from which you run the utility.

Results

The pin_opspec_to_schema_v2 utility notifies you when it successfully generates schema files. Any errors are displayed on the console.

pin_wsdl_generator

Use the pin_wsdl_generator utility to generate WSDL files for Web services.

For more information, see "Generating WSDL Files for Web Services".

Location

BRM_home/bin

Syntax

pin_wsdl_generator [-c config_file] [-j | -s] [-s XML] [-d] [-h]

Parameters

-c config_file

Specifies the name and location of the XML configuration file that describes how to group opcodes into Web services. By default, the utility uses the BRM_home/apps/brm_integrations/config/pin_wsdl_generator.xml file. See "Defining a Web Service".

-j | -s

Specifies whether to create WSDL files with JCA (-j) or SOAP (-s) bindings.

The default is to generate WSDL files with JCA bindings.

-s XML

Creates WSDL files for Web services that take payload as XML element. For example:

pin_wsdl_generator -c pin_wsdl_generator.xml -s XML

-d

Runs in debug mode and displays more detailed messages.

-h

Displays the syntax and parameters for this utility.

Results

The pin_wsdl_generator utility generates the output WSDL files in the directory from which it was run.

The utility notifies you when it successfully generates WSDL files. Any errors are displayed on the console.