stbmake [-x] [-b] [-S stub-source-file-name] [-H stub-header-file-name] [-i include-file-pathname] [-m server-definition-file-pathname] [-p] definition-file-name

Creates XATMI stub source files needed when XATMI-interfaced communication is to be used under TCP/IP. The stbmake command creates the following files by referring to the XATMI interface definition file:

• XATMI stub source file
• XATMI stub header file (used with UAPs written in C)
• XATMI stub copy file (used with UAPs written in COBOL)

When creating a UAP that uses OpenTP1 remote procedure calls and XATMI interface functions in combination, see the descriptions of the stbmake command in A. Using OpenTP1 Remote Procedure Calls and XATMI-interfaced API Functions in Combination.

• -x
  Indicates that the stub created will serve the UAP which uses the XATMI interface. The -x option can be omitted.
  
• -b
  Specify this option when creating an XATMI stub copy file which is to be used with COBOL UAPs. If this option is omitted, any XATMI stub copy file will not be created.
  The name of an XATMI stub copy file is output in the format of subtype-name.cbl. The XATMI interface for the COBOL language does not support X_C_TYPE as a record type. If X_C_TYPE is specified in the XATMI interface definition, the stbmake command with the -b option specified will return with an error.
  
• -S stub-source-file-name ~ <pathname>
  Specify this option if the XATMI stub source file created is to be renamed. The relative or absolute pathname may be used for this file name.
  If this option is omitted, the file will be created with name xxxxx_stbx.c in the current directory.
  
• -H stub-header-file-name ~ <pathname>
  Specify this option if the XATMI stub header file created is to be renamed. The relative or absolute pathname may be used for this file name.
  If this option is omitted, the file will be created with name xxxxx_stbx.h in the current directory.
  
• -i include-file-pathname ~ <pathname>
  Specify the search path containing the include file specified by the #include statement to be used. The stbmake command searches the directory identified by the -i option for the include file.
  If the -i option is omitted, the current directory is searched for the include file.
  The -i option can be specified only once. If more than one search path is needed, -i must be followed by the desired paths separated by colons (:). The search order is the order in which the paths are written as the argument to the -i option.
  Use alphanumeric characters, underscore (_), slash (/), and period (.) when specifying a search pathname.
  
• -m server-definition-file-pathname ~ <pathname>
  Specify the search path containing the server definition file to be used. The stbmake command searches the directory identified by the -m option for the server definition file specified by the called_servers statement.
  If the -m option is omitted, the current directory is searched for the definition file.
  The -m option can be specified only once. If more than one search path is needed, -m must be followed by the desired paths separated by colons (:). The search order is the order in which the paths are written as the argument to the -m option.
  Use alphanumeric characters, underscore (_), slash (/), and period (.) when specifying a search pathname.
  
• -p
  Specify this option to output the allocation status of the typed record in memory to the standard output. In the case of testing by the online tester, use the -p option to learn about how XATMI structure members are allocated in memory.
  When the -p option is specified, the stbmake command creates no files. Thus, output file names specified in the -S and -H option are ignored. Specify the -m and -i options to search for files as needed.
  

• definition-file-name
  Specify the XATMI interface definition file name. Its suffix must be.def.
  

• Each option to the stbmake command for XATMI stub creation can be specified only once. If an option is specified more than once, the last specified value will be valid.
• 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.