Preface

This manual is intended for system managers, system designers, programmers, and operators.

Readers should first look at the manual OpenTP1 Description which introduces OpenTP1.

This manual is organized as follows:

1. Overview

Outlines OpenTP1 Client features.

2. Facilities

Describes OpenTP1 client facilities.

3. User Application Program Interface (C Language)

Describes the user application program interface in C.

4. TP1/Client Functions (C Language)

Describes the functions that can be used in TP1/Client.

5. User Application Program Interface (COBOL Language)

Describes the user application program interface in COBOL.

6. Request Statements Available for TP1/Client (COBOL Language)

Describes the request statements that can be used in TP1/Client.

7. Definition

Explains the client environment definition.

8. Operating Commands

Explains how to enter, code, and use TP1/Client operating commands.

9. Error Recovery

Explains how to deal with errors.

10. Messages

Explains TP1/Client messages.

A. Code Conversion Specifications

Explains the specifications of the code conversion performed by the character code converter.

B. Version Changes

Explains the changes to functions, definitions, and messages made when the TP1/Client version was updated.

This manual is part of a related set of manuals. The manuals in the set, including this manual, are listed below. The manual numbers follow the manual titles.

OpenTP1 products

• OpenTP1 Version 7 Description (3000-3-D50(E))
• OpenTP1 Version 7 Programming Guide (3000-3-D51(E))
• OpenTP1 Version 7 System Definition (3000-3-D52(E))
• OpenTP1 Version 7 Operation (3000-3-D53(E))
• OpenTP1 Version 7 Programming Reference C Language (3000-3-D54(E))
• OpenTP1 Version 7 Programming Reference COBOL Language (3000-3-D55(E))
• OpenTP1 Version 7 Messages (3000-3-D56(E))
• OpenTP1 Version 7 Tester and UAP Trace User's Guide (3000-3-D57(E))
• OpenTP1 Version 7 TP1/Client User's Guide TP1/Client/W, TP1/Client/P (3000-3-D58(E))
• OpenTP1 Version 7 TP1/Client User's Guide TP1/Client/J (3000-3-D59(E))
• OpenTP1 Version 7 Protocol TP1/NET/TCP/IP (3000-3-D70(E))

Other OpenTP1 products

• TP1/Web User's Guide and Reference (3000-3-D62(E))¹

Other related products

• VOS3 Data Management System XDM E2 Description (6190-6-620(E))
• VOS3 Data Management System XDM E2 System Definition (6190-6-625(E))

Note

You must check and confirm that the products described in these manuals will run on your operating system.

¹ If you want to use this manual, confirm that it has been published. (Some of these manuals might not have been published yet.)

This manual uses the following abbreviations for product names:

Full name	Abbreviation
AIX 5L V5.1	AIX
AIX 5L V5.2
AIX 5L V5.3
AIX 6.1
HP-UX 11i (PA-RISC)	HP-UX
HP-UX 11i V2 (IPF)
HP-UX 11i V2 (PA-RISC)
HP-UX 11i V3 (IPF)
Itanium(R) Processor Family	IPF
Red Hat Enterprise Linux 5.1 (AMD64)	Linux
Red Hat Enterprise Linux 5.1 (Intel EM64T)
Red Hat Enterprise Linux 5.1 (IPF)
Red Hat Enterprise Linux 5.1 (x86)
Red Hat Enterprise Linux 5.1 Advanced Platform
Microsoft(R) MS-DOS(R)	MS-DOS
Solaris 8	Solaris
Solaris 9
Solaris 10
uCosminexus TP1/Client/P	TP1/Client/P	TP1/Client
uCosminexus TP1/Client/W	TP1/Client/W
uCosminexus TP1/Extension 1	TP1/Extension 1
uCosminexus TP1/NET/TCP/IP	TP1/NET/TCP/IP
uCosminexus TP1/Online Tester	TP1/Online Tester
uCosminexus TP1/LiNK	TP1/LiNK	TP1/Server
uCosminexus TP1/Server Base	TP1/Server Base
Microsoft(R) Windows(R) 2000 Advanced Server Operating System	Windows 2000
Microsoft(R) Windows(R) 2000 Datacenter Server Operating System
Microsoft(R) Windows(R) 2000 Professional Operating System
Microsoft(R) Windows(R) 2000 Server Operating System
Microsoft(R) Windows(R) Software Development Kit	Windows SDK
Microsoft(R) Windows Server(R) 2003, Datacenter Edition	Windows Server 2003
Microsoft(R) Windows Server(R) 2003, Datacenter x64 Edition
Microsoft(R) Windows Server(R) 2003, Enterprise Edition
Microsoft(R) Windows Server(R) 2003, Enterprise x64 Edition
Microsoft(R) Windows Server(R) 2003 R2, Enterprise Edition
Microsoft(R) Windows Server(R) 2003 R2, Enterprise x64 Edition
Microsoft(R) Windows Server(R) 2003 R2, Standard Edition
Microsoft(R) Windows Server(R) 2003 R2, Standard x64 Edition
Microsoft(R) Windows Server(R) 2003, Standard Edition
Microsoft(R) Windows Server(R) 2003, Standard x64 Edition
Microsoft(R) Windows Vista(R) Business (x86)	Windows Vista (32bit)	Windows Vista
Microsoft(R) Windows Vista(R) Enterprise (x86)
Microsoft(R) Windows Vista(R) Ultimate (x86)
Microsoft(R) Windows Vista(R) Business (x64)	Windows Vista (64bit)
Microsoft(R) Windows Vista(R) Enterprise (x64)
Microsoft(R) Windows Vista(R) Ultimate (x64)
Microsoft(R) Windows(R) XP Home Edition Operating System	Windows XP
Microsoft(R) Windows(R) XP Professional Operating System

• In this manual, Windows 2000, Windows Server 2003, Windows XP, and Windows Vista are generally referred to as Windows.
• In this manual, AIX, HP-UX, Linux, and Solaris are generally referred to as UNIX.

Abbreviations used in this manual are listed below.

Abbreviation	Full name
API	Application Programming Interface
CUP	Client User Program
DAM	Direct Access Method
DLL	Dynamic Linking Library
EBCDIC	Extended Binary Coded Decimal Interchange Code
ID	Identifier
JIS	Japanese Industrial Standard
KEIS	Kanji Processing Extended Information System Code
MHP	Message Handling Program
MTU	Maximum Transmission Unit
OLTP	Online Transaction Processing
PC	Personal Computer
PRF	PeRFormance
RPC	Remote Procedure Call
SPP	Service Providing Program
TCP/IP	Transmission Control Protocol/Internet Protocol
UAP	User Application Program
WAN	Wide Area Network
WS	Workstation

The components of the diagrams in this manual have the following meanings unless otherwise specified:

This manual uses the following conventions:

• 1 KB (kilobyte) is 1,024 bytes.
• 1 MB (megabyte) is 1,024² bytes.
• 1 GB (gigabyte) is 1,024³ bytes.
• 1 TB (terabyte) is 1,024⁴ bytes.

For the Windows version of OpenTP1, there are some notational differences from the description in the manual. The following table describes these differences.

Item	Description in the manual	Change to:
Environment variable	$aaaaaa Example: $DCDIR	%aaaaaa% Example: %DCDIR%
Path name separator	Colon (:)	Semicolon (;)
Directory name separator	Slash (/)	Backslash (\)
Absolute path name	A path from the root directory Example: /tmp	A path name from a drive letter and the root directory Example: C:\tmp
Executable file name	File name only (without an extension) Example: mcfmngrd	File name with an extension Example: mcfmngrd.exe
make command	make	nmake

Note that the version numbers of Hitachi program products are often written as two sets of two digits separated by a hyphen. For example:

• version 1.00 (or version 1.0) is written as 01-00
• version 2.05 is written as 02-05
• version 2.50 (or version 2.5) is written as 02-50
• version 12.25 is written as 12-25

So, for example, the version number written on the spine of a manual might take the form Ver. 2.00 but the version number written in the program might take the form 02-00. These numbers indicate the same version.

Quotations from X/Open CAE Specification Distributed Transaction Processing: The XATMI Specification published by X/Open Company Limited

The following section comes from Chapter 5 COBOL Reference Manual Pages of the above document.

Chapter 4. User Application Program Interface (C Language)

4.8 XATMI interface facility (tp~)

COBOL acknowledgments

COBOL was developed by CODASYL (the Conference on Data Systems Languages). The publisher of this manual expresses acknowledgment to the original developer and presents the following acknowledgment statement as requested by CODASYL. This statement is quoted from the acknowledgment in the original CODASYL COBOL specification titled COBOL Journal of Development 1984.

Any organization interested in reproducing the COBOL report and specifications in whole or in part, using ideas from this report as the basis for an instruction manual or for any other purpose, is free to do so. However, all such organizations are requested to reproduce the following acknowledgment paragraphs in their entirety as part of the preface to any such publication. Any organization using a short passage from this document, such as in a book review, is requested to mention "COBOL" in acknowledgment of the source, but need not quote the acknowledgment.

COBOL is an industry language and is not the property of any company or group of companies, or of any organization or group of organizations.

No warranty, expressed or implied, is made by any contributor or by the CODASYL COBOL Committee as to the accuracy and functioning of the programming system and language. Moreover, no responsibility is assumed by any contributor, or by the committee, in connection therewith.

The authors and copyright holders of the copyrighted material used herein

FLOW-MATIC (trademark of Sperry Rand Corporation), Programming for the Univac (R) I and II, Data Automation Systems copyrighted 1958, 1959, by Sperry Rand Corporation; IBM Commercial Translator From No. F28-8013, copyrighted 1959 by IBM; FACT, DSI 27A5260-2760, copyrighted 1960 by Minneapolis-Honeywell

have specifically authorized the use of this material in whole or in part, in the COBOL specifications. Such authorization extends to the reproduction and use of COBOL specifications in programming manuals or similar publications.

Please check the availability of the products and manuals for HAmonitor, ServerConductor/DeploymentManager, Cosminexus, and Job Management Partner 1/Automatic Job Management System 2.