United States-English

HP 9000 Networking: HP FTAM/9000 Programmer's Guide

»

Technical documentation


	Complete book in PDF


»	Feedback

» Table of Contents

» Glossary

» Index

HP Part Number: B1033-90014

Edition: Edition 5

Published: E0597

© Copyright 1997, Hewlett-Packard Company. .

Table of Contents

Printing History

1 HP FTAM/9000 Overview

Chapter Overview

The HP-UX Implementation of FTAM

Open Systems Interconnection (OSI)
ISO/IS 8571 FTAM
Manufacturing Automation Protocol (MAP) 3.0
NBS (NIST) Implementors Agreements
Protocol Implementation Conformance Statement (PICS)

Overview of FTAM Concepts

The Virtual Filestore (VFS)
Regimes
FTAM Communication
Document Types
FTAM File Structure Model

2 Using HP FTAM/9000

Chapter Overview

Starting and Stopping the FTAM System

Generating FTAM Programs

Header Files
libmapftam.a Library
lint(1) Library

Using Regimes

Regime Guidelines

Using Functions

High Level Services (HLS) and Low Level Services (LLS)
Context Free (CF) and Context Sensitive (CS) Functions
Available Functions
Typical Applications

Using Parameters

Parameter Order
Data Control Blocks

General Recommendations

Handling Strings, HP-UX Lines, and FTAM-1 Lines

3 HP FTAM/9000 Data Structures

Chapter Overview

Header Files

Using Defined Constants To Set Bits

EXAMPLE

Basic Data Types

Object_id
Octet_string

Directory Services Data Structures

Organizing Directory Services
Using Directory Services
Ae_dir_name
Dir_dn
Dir_rdn
Dir_ava
Setting Ae_dir_name Example

Ae_title_option

Connection_id

Ft_access_context

Ft_access_control

Ft_access_control_element

Ft_attribute_groups

Ft_attribute_names

Ft_attributes

Ft_attribute_names
Ft_attribute_values

Ft_concurrency_control

Ft_file_lock
Rules for Ft_concurrency_control

Ft_contents_type_element

Ft_contents_type

Ft_contents_form
Ft_contents_info

Ft_data_unit

Ft_structure_id
Ft_data_element
Ft_node_descriptor
Rules for Ft_data_unit Linked Lists (FTAM-2 Only)

Ft_dcb_type

Ft_delete_action

Ft_delete_overwrite

Ft_diagnostic

Ft_diag_type
Ft_entity_ref

Ft_fadu_identity

Ft_fadu_form
Ft_fadu_info

Ft_fadu_operation

Ft_file_actions

Ft_file_passwords

Ft_file_status

Ft_filename

Ft_functional_units

Ft_initiator_identity

Ft_processing_mode

Ft_service_class

Ft_single_file_pw

Ft_output
Ft_xxx_out_dcb
Memory Allocation for inout_dcbs

Local_event_name

4 Using Support Functions

Chapter Overview

Managing Memory

ft_didcb()
ft_dfdcb()
em_fdmemory()
ft_fdmemory()

Responding to Asynchronous Calls

When to Use em_wait()
When to Use em_hp_select()
When to Use em_hp_sigio()
Using em_wait()
Using em_hp_select()
Using em_hp_sigio()

Translating Error Messages

em_gperror()
ft_gperror()

Determining Available Resources

ft_nwcleared()

5 Using High Level, Context Free Functions

Chapter Overview

Copying and Moving FTAM Files (HLCF)

ft_fcopy()
ft_fmove()
ft_fcopy_aet
ft_fmove_aet()

Reading and Changing Attributes (HLCF)

ft_frattributes()
ft_fcattributes()
ft_frattributes_aet()
ft_fcattributes_aet()

Deleting Files (HLCF)

ft_fdelete()
ft_fdelete_aet()

6 Managing HP FTAM/9000 Connections

Chapter Overview

Connection Establishment Process

Starting and Stopping Application Entities

ft_aeactivation()
ft_aedeactivation()

Establishing and Removing Connections

ft_connect()
ft_rrequest()
ft_aereset()

Aborting Connections

ft_abort()
ft_ireceive()

7 Managing and Accessing HP FTAM/9000 Files

Chapter Overview

Gaining Access to FTAM Files

ft_create()
ft_select()
ft_open() (LLCS)
ft_close() (LLCS)
ft_delete() (LLCS)
ft_deselect()

Opening and Closing Files (HLCS)

ft_fopen() (HLCS)
ft_fclose() (HLCS)

Reading and Changing Attributes (LLCS)

ft_rattributes() (LLCS)
ft_cattributes() (LLCS)

Locating and Erasing FTAM Files

ft_locate()
ft_erase()

Grouping LLCS FTAM Functions

Allowable Groupings
ft_bgroup()
ft_egroup()

8 Transferring HP FTAM/9000 Data

Chapter Overview

Sequence of Transferring Data

Reading Data

ft_read()
ft_rdata()
ft_rdataqos()

Writing Data

ft_write()
ft_sdata()

Ending Data Transfer

ft_edata()
ft_etransfer()
ft_cancel()
ft_rcancel()

9 Handling Errors

Chapter Overview

General Approach to Troubleshooting FTAM

Interpreting Errors

Function Return Values
Output Errors

Example Program Checking for Errors

Logging Errors

Example Program Containing Error Information

Using API Tracing

API Tracing Variables
Enabling API Tracing
Interpreting the Trace File

10 Example Programs

Former Introduction ... need to change
Using HLCF Functions Example
Managing FTAM Connections Example
Using LLCS Functions Example
Setting Ae_dir_dn and P_address Utility Example
Checking for Errors Example
Common Code Example

11 Document Types and Constraint Sets

Document Types

FTAM-1 Document Type
FTAM-2 Document Type
FTAM-3 Document Type
INTAP-1 Document Type
NBS-9 Document Type

Constraint Sets

Access Contexts
Unstructured Constraint Set
Sequential Flat Constraint Set

12 Character Sets

Former Intro ... Change

List of Figures

1-1 HP-UX FTAM Virtual Filestore (VFS)
1-2 FTAM Regime Order
1-3 FTAM Communication Process
1-4 FTAM Document Types
1-5 FADU Defined by Unstructured Constraint Set
1-6 FADU Defined by Sequential Flat Constraint Set
2-1 FTAM Regime Order
2-2 Available FTAM Functions Per Regime
2-3 Example Use of Low Level FTAM Functions
3-1 Example Directory Services (X.500) Structure
3-2 Ae_dir_name Structure
3-3 Example Directory Distinguished Name Structure
3-4 Dir_rdn Structure
3-5 Dir_ava Structure
3-6 attr_id Structure
3-7 Ft_access_control Structure
3-8 Ft_data_unitcStructure
3-9 Ft_data_element Structure
3-10 Ft_node_descriptor Structure
3-11 Ft_diagnostic Structure
6-1 Connection Establishment Process
9-1 General Approach to Troubleshooting FTAM
9-2 inout_dcb->diagnostic
11-1 FTAM-1 Document Type Structure
11-2 FTAM-1 Document Type Restrictions
11-3 FTAM-2 Document Type Structure
11-4 FTAM-2 Document Type Restrictions
11-5 FTAM-3 Document Type Structure
11-6 FTAM-3 Document Type Restrictions
11-7 INTAP-1 Document Type Structure
11-8 NBS-9 Document Type Structure
11-9 NBS-9 Document Type Restrictions

List of Tables

3-1 Concurrency Control: Default Settings
11-1 Legal Operations for the NBS-9 Document Type

Printable version


Privacy statement	Using this site means you accept its terms	Feedback to webmaster

© 1997 Hewlett-Packard Development Company, L.P.