OpenTP1 Version 7 Programming Reference COBOL Language

[Contents][Index][Back][Next]

1.2.4 stbmake - Stub source file creation

Organization of this subsection
(1) Format
(2) Description
(3) Options
(4) Flags
(5) Note
(6) Example

(1) Format

stbmake [-s [stub-source-file-name]] definition-file-name

(2) Description

Creates a stub source file from the RPC interface definition file.

To create a UAP that will use both OpenTP1 remote procedure calls and the XATMI interface, see the explanation about the stbmake command in A. Using OpenTP1 Remote Procedure Calls and XATMI-interfaced API Functions in Combination.

(3) Options

-s stub-source-file-name ~ <pathname>

Specify the pathname of the stub source file to be created. If no pathname is specified here, the source file name is the same as the RPC interface definition file name except that the suffix.def is replaced with _sstb.c and the source file is created in the current directory.

If a source file with the specified file name is already present, it is replaced with the created source file and is lost.

(4) Flags

definition-file-name ~ <pathname>

Specify the pathname of the RPC interface definition file.

(5) Note

The names of files that the stbmake command can take as input or create as output are up to 255 characters long. Note, however, that a lower upper limit is used under some OSs.

(6) Example

An example of using the stbmake command is given below.

Example:
Creating a stub source file from an RPC interface definition file test.def in the current directory.

Format 1:
stbmake test.def

A stub source file test_sstb.c is created from an RPC interface definition file test.def in the current directory.

Format 2:
stbmake -s stub/test.c test.def

A directory stub is created under the current directory and a stub source file test.c is created in the created directory.