HP FTAM/9000 User manual

HP FTAM/9000 Reference Manual
Edition 4
B1033-90004
HP 9000 Networking
E0597
Printed in: U.S.A.
© Copyright 1997, Hewlett-Packard Company.

2
Legal Notices
The information in this document is subject to change without notice.
Hewlett-Packard makes no warranty of any kind with regard to this
manual, including, but not limited to, the implied warranties of
merchantability and fitness for a particular purpose. Hewlett-Packard
shall not be held liable for errors contained herein or direct, indirect,
special, incidental or consequential damages in connection with the
furnishing, performance, or use of this material.
Warranty. A copy of the specific warranty terms applicable to your
Hewlett- Packard product and replacement parts can be obtained from
your local Sales and Service Office.
Restricted Rights Legend. Use, duplication or disclosure by the U.S.
Government is subject to restrictions as set forth in subparagraph (c) (1)
(ii) of the Rights in Technical Data and Computer Software clause at
DFARS 252.227-7013 for DOD agencies, and subparagraphs (c) (1) and
(c) (2) of the Commercial Computer Software Restricted Rights clause at
FAR 52.227-19 for other agencies.
HEWLETT-PACKARD COMPANY 3000 Hanover Street Palo Alto,
California 94304 U.S.A.
Use of this manual and flexible disk(s) or tape cartridge(s) supplied for
this pack is restricted to this product only. Additional copies of the
programs may be made for security and back-up purposes only. Resale of
the programs in their present form or with alterations, is expressly
prohibited.
Copyright Notices. ©copyright 1983-97 Hewlett-Packard Company, all
rights reserved.
Reproduction, adaptation, or translation of this document without prior
written permission is prohibited, except as allowed under the copyright
laws.
©copyright 1979, 1980, 1983, 1985-93 Regents of the University of
California
This software is based in part on the Fourth Berkeley Software
Distribution under license from the Regents of the University of
California.

3
©copyright 1980, 1984, 1986 Novell, Inc.
©copyright 1986-1992 Sun Microsystems, Inc.
©copyright 1985-86, 1988 Massachusetts Institute of Technology.
©copyright 1989-93 The Open Software Foundation, Inc.
©copyright 1986 Digital Equipment Corporation.
©copyright 1990 Motorola, Inc.
©copyright 1990, 1991, 1992 Cornell University
©copyright 1989-1991 The University of Maryland
©copyright 1988 Carnegie Mellon University
Trademark Notices UNIX is a registered trademark in the United
States and other countries, licensed exclusively through X/Open
Company Limited.
X Window System is a trademark of the Massachusetts Institute of
Technology.
MS-DOS and Microsoft are U.S. registered trademarks of Microsoft
Corporation.
OSF/Motif is a trademark of the Open Software Foundation, Inc. in the
U.S. and other countries.

4

5
Printing History
The manual printing date and part number indicate its current edition.
The printing date will change when a new edition is printed. Minor
changes may be made at reprint without changing the printing date. The
manual part number will change when extensive changes are made.
Manual updates may be issued between editions to correct errors or
document product changes. To ensure that you receive the updated or
new editions, you should subscribe to the appropriate product support
service. See your HP sales representative for details.
First Edition: April 1991 (HP-UX Release 8.0)
Second Edition: November 1992 (HP-UX Release 9.0)
Third Edition: January 1995 (HP-UX Release 10.0)
Fourth Edition: May 1997 (HP-UX Release 10.3)

6

7
Preface
Purpose and Scope
The purpose of this manual is to help you troubleshoot errors returned in
your HP FTAM/9000 applications. This manual lists the errors, probable
causes, and corrective actions. Additionally, this manual includes the HP
FTAM/ 9000 reference pages.
NOTE This manual lists FTAM error and reference information. If you are
learning FTAM and need more comprehensive explanations, refer to the
HP FTAM/9000 Programmer's Guide.
FTAM/9000 runs on HP OTS/9000, an HP network product that provides
a lower-level OSI protocol “stack,” in conjunction with an 802.3 network
link.
Audience
This manual is for application programmers who are familiar with the C
programming language and who need to correct errors in their
applications. This manual is also for programmers who need to consult
the FTAM/9000 reference pages (which are copies of the online man
pages).
MAP 3.0 Interface Note
Users should note that the FTAM/9000 programmatic interface is taken
from the MAP 3.0 specification for FTAM. The MAP 3.0 FTAM
specification includes error codes and other details, which consequently
appear in the programmatic interface to FTAM/9000. This document
contains numerous references to MAP–based details found in
FTAM/9000.

8
Organization
Chapter 1 FTAM return_codesThis chapter contains a list of
FTAM errors returned in the
inout_dcb->result_code.return_code field. Possible
causes and recovery actions are also listed.
Chapter 2 HP vendor_codesThis chapter contains a list
HP-specific errors returned in the
inout_dcb->result_code.vendor_code field. Possible
causes and recovery actions are also listed.
Chapter 3 Diagnostic error_idsThis chapter contains a list of
diagnostic values returned in the
inout_dcb->diagnostic->error_id field. Possible
causes and recovery actions are also listed.
Chapter 4 Event Management ErrorsThis chapter contains a
list of values returned when calling em_wait(),
em_fdmemory(), and em_gperror(). These errors
return in the result->return_code and
result->vendor_code fields. Possible causes and
recovery actions are also listed.
Chapter 5 HP FTAM/9000 PICSThis chapter contains
information on how to obtain a copy of the Protocol
Implementation Conformance Statement (PICS) for
the HP FTAM/9000 product. Use this information in
conjunction with other vendor's PICS to determine
how the various responders communicate.
Chapter 6 Installation FilesetsThis chapter lists the filesets
created during FTAM/9000 installation.
Chapter 7 HP FTAM/9000 Reference PagesThis chapter lists
the HP FTAM/9000 reference pages (man pages) that
are available online.

9
Documentation Guide
For More
Information Read
Installing and
Configuring HP
FTAM/9000
Installing and Administering HP
FTAM/9000 (B1033-90034)
Troubleshooting HP
FTAM/9000 OSI Troubleshooting Guide (32070-90020)
FTAM Programming HP FTAM/9000 Programmer's Guide
(B1033- 90014)
FTAM Protocol
Specifications ISO 8571, Information Processing Systems – Open Systems Interconnection – File
Transfer, Access and Management
International
Standards ISO 8571 ISO 8571, Information Processing Systems – Open Systems Interconnection – File
Transfer, Access and Management
MAP 3.0 Interface
Specifications MAP 3.0 Application Interface Specification
NBS Phase III Implementation Agreements for Open
Systems Interconnection Protocols from the
NBS Workshop for Implementors of Open
Systems Interconnection
ACSE ISO 8649, Information Processing Systems –
Open Systems Interconnection – Service
DefinitionfortheAssociationControlService
Element

10