FTAM/9000 Programmer's Guide
12
Contents
Using Regimes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Regime Guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Using the FTAM Regime. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Using the File Selection Regime. . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Using the File Open Regime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Using the Data Transfer Regime . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Using Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
High Level Services (HLS) and Low Level Services (LLS). . . . . . . . . 51
Context Free (CF) and Context Sensitive (CS) Functions . . . . . . . . . 52
Available Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Typical Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Using Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Parameter Order. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Data Control Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
input_dcb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
inout_dcb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
General Recommendations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Handling Strings, HP-UX Lines, and FTAM-1 Lines. . . . . . . . . . . . . 64
3. HP FTAM/9000 Data Structures
Chapter Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Header Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Using Deļ¬ned Constants To Set Bits . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
EXAMPLE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Basic Data Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Object_id . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Octet_string. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71