txidl filename [argument] ...

The txidl command activates the TxRPC interface definition language compiler.

-cptype process_type

Specify a client process type. Specify either of the following values for the process_type:

• ndce
  This process uses the TP1/Server Base library.
  
• nbet
  This process uses the DCE library only.
  

If no value is specified, ndce is assumed. The program does not run if compiled with an incorrect process type specified. (For example, the program does not run if the TP1/Server Base library is incorporated in a stub compiled with nbet specified.)

-sptype process_type

Specify a server process type. The process_type is the same as the -cptype.

If no value is specified, ndce is assumed. The program does not run if it is compiled with an incorrect process type specified. (For example, the program does not run if the TP1/Server Base library is incorporated in a stub compiled with nbet specified.)

-client file_type

Specify which client file is to be created. If this argument or file_type is not specified, the compiler creates all client files. Specify one of the following values for the file_type:

• none
  No file is created.
  
• stub
  Only stub files are created.
  
• all
  Stub and client-created files are created.
  

-server file_type

Specify which server file is to be created. If this argument or file_type is not specified, the compiler creates all client files. The file_type is the same as the -client.

-cstub filename

Specify the pathname of the client stub.

Do not specify an extension for the file name. The txidl compiler suffixes .c to a source file in C language. It suffixes _cstub.c to the file if the -cstub option is not used.

When the client process type is gateway and the server process type is dce, two types of stub files are created. In this case, B is prefixed to the filename of the OpenTP1 stub file name.

-sstub filename

Specify the pathname of the server stub. Do not specify an extension for the file name. The txidl compiler suffixes .c to a source file in C language. It suffixes _sstub.c to the file if the -sstub option is not used.

-header header_file

Specify the pathname of the header file to be created.

Do not specify an extension for the file name. For default, the txidl compiler suffixes .h to the base name of the IDL file.

-cconf conffile

Specify the pathname of the user service definition file or environment establishment file of the client program. If the -cconf option is not used, a file having the name with C prefixed to the base name of the IDL file is created. This option is valid only when the process type combination is IDL-only TxRPC. If this option is specified with any other process type combination, this option is simply ignored without causing an error.

-sconf conffile

Specify the pathname of the user service definition file of the server program. If the -sconf option is not used, a file having the name with S prefixed to the base name of the IDL file is created. This option is valid only when the process type combination is IDL-only TxRPC. If this option is specified with any other process type combination, this option is simply ignored without causing an error.

-out directory

Creates an output file under a specified directory. For default, the compiler creates an output file under the current directory.

A path name specified in another option has priority regardless of the specification sequence.

-Idirectory

Specify the name of a directory containing the interface definition file to be imported. Multiple directories can be specified by specifying the additional -Idirectory argument on the command line. The compiler searches the directories in the sequence set in this argument.

If one file is under multiple directories, the compiler imports the file that first appears.

If this argument is omitted, the directories are searched in the following sequence:

1. Current directory
2. All specified directories
3. System IDL directory ($DCDIR/include)

-no_def_idir

Specify this argument when the compiler is to search only the current directory for the import file. If this option is specified together with -Idirectory, the compiler searches only the directory specified by the user, but not the current and system directories.

-noconf

Specify this argument when the templates of OpenTP1 user service definition and environment establishment files are not to be created. This argument is valid only when the process type combination is only IDL-only TxRPC.

-noserver

Specify this argument when the template of the server program is not to be created. This argument is valid only when the process type combination is only IDL-only TxRPC.

-syntax_only

Specify this argument when only the syntax of the IDL file is to be checked but the file is not to be output.

• The txidl command analyzes the interface definition written in the IDL and creates requisite files (including a header file, server stub file, client stub file, auxiliary file, and OpenTP1 definition file template).
• The IDL compiler searches each directory for the related ACF. For example, when a file named source.idl is compiled, the compiler automatically searches for a file named source.acf. It also searches for the imported IDL file (and related ACFs).
  The compiler searches for these files in the following sequence:
  
  1. Current directory
     The compiler always searches this directory unless the -no_def_idir and -Idirectory arguments are specified at the same time.
     
  2. Imported directory
     The compiler searches each directory specified for the -Idirectory argument.
     
  3. System IDL directory
     The compiler automatically imports dctrpb.idl in the system IDL directory. The compiler always searches this directory unless the -no_def_idir argument is specified.
     
  4. Directory specified for the source file name
     If a directory is explicitly specified for the source IDL pathname, the corresponding ACF is searched under that directory.
     
• The txidl command automatically creates the OpenTP1 definition file with IDL-only TxRPC. It can be designed not to create the file by specifying an option in the txidl command.
• If the operation name is changed, the OpenTP1 definition file also needs to be re-created.

The txidl compiler outputs the three types of messages listed below. For details on the messages, see the indicated manuals.

1. Messages output by the txidl compiler
   See the manual OpenTP1 Messages.
   
2. Messages output by DCE idl activated by the txidl compiler
   See the corresponding DCE manuals.
   
3. Messages output by cpp or cc activated by DCE idl.
   See the manual corresponding to each command.
   

Files related to IDL-only TxRPC are as follows:

$DCDIR/bin/txidl: IDL compiler

$DCDIR/include/dctrpb.idl: System IDL file

$DCDIR/include/dctrp.h: Header file

• The IDL compiler creates ANSI C code. No warning message is returned while a stub is being compiled by the C compiler. However, the following messages may be posted if the C compiler does not completely conform to the ANSI C specification:
  

  warning: & before array or function: ignored warning: enumeration type clash, operator=

• Place a space between the option and parameter.
  Example:
  

  -out xxx (Do not write as -outxxx.)

• The file names listed below are reserved by the IDL compiler. If the IDL file is named using any of these file names, the operation is undefined.
  iovector.idl, lbase.idl, nbase.idl, ncastat.idl, rpc.idl, rpcbase.idl, rpcpvt.idl, rpcsts.idl, rpctypes.idl, twr.idl, uuid.idl, or dctrpb.idl
  
• This version does not support RPC TxRPC. Therefore, even if you specify nbet as the process type in the -cptype option and -sptype option of the txidl command, the generated stub file cannot be used.