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

Creates XATMI stub source files needed when XATMI-interfaced communication is to be used under OSI TP. The tpstbmk 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)

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

• -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 tpstbmk command with the -b option specified will return with an error.
  
• -S stub-source-file-name ~ <pathname>
  Specify the relative or absolute pathname of the XATMI stub source file to be created.
  If this option is omitted, an XATMI stub source file named XXXXX_stbx.c will be created in the current directory.
  
• -H stub-header-file-name ~ <pathname>
  Specify the relative or absolute pathname of the XATMI stub header file to be created.
  If this option is omitted, an XATMI stub header file named XXXXX_stbx.h will be created in the current directory.
  
• -i include-file-pathname ~ <pathname>
  Specify the search path of the include file assigned to the #include statement in the XATMI interface definition file. The tpstbmk 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 paths are searched in the order in which they are specified.
  When specifying a search path, you can use alphanumeric characters, underscores (_), slashes (/), and periods (.).
  
• -m server-definition-file-pathname ~ <pathname>
  Specify the search path of the server definition file given in the called_servers statement in the XATMI interface definition file. The tpstbmk command searches the directory identified by the -m option for the server definition file.
  If the -m option is omitted, the current directory is searched for the server 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 paths are searched in the order in which they are specified.
  When specifying a search path, you can use alphanumeric characters, underscores (_), slashes (/), and periods (.).
  

• definition-file-name ~ <pathname>
  Specify the XATMI interface definition file name. Its suffix must be.def.
  

• Each option to the tpstbmk command can be specified only once. If an option is specified more than once, the last specified value will be in effect.
• The names of files that the tpstbmk 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.