CONTENTS Title Page Copyright Page Preface 1 OSAK Routines 1.1 Include Files 1.2 OSAK Parameter Block 1.3 Data Type Definitions 1.4 Routine Descriptions 1.4.1 Arguments Common to All Outbound Services 1.4.2 Parameters Common to All Outbound Services osak_abort_req osak_accept_rsp osak_act_discard_req osak_act_discard_rsp osak_act_end_req osak_act_end_rsp osak_act_interrupt_req osak_act_interrupt_rsp osak_act_resume_req osak_act_start_req osak_alter_req osak_alter_rsp osak_associate_req osak_async_close osak_capability_req osak_capability_rsp osak_close_port osak_collect_pb osak_control_give_req osak_data_req osak_exception_req osak_expedited_req osak_get_event osak_get_handle osak_give_buffers osak_major_req osak_major_rsp osak_minor_req osak_minor_rsp osak_open_initiator osak_open_redirect osak_open_responder osak_redirect osak_reject_rsp osak_release_req osak_release_rsp osak_resync_req osak_resync_rsp osak_select osak_send_more osak_token_give_req osak_token_please_req osak_typed_req 2 OSAK Events ABORT indication A-ASSOCIATE-ACCEPT confirm A-ASSOCIATE-REJECT confirm A-ASSOCIATE indication A-RELEASE confirm A-RELEASE indication P-ACTIVITY-DISCARD confirm P-ACTIVITY-DISCARD indication P-ACTIVITY-END confirm P-ACTIVITY-END indication P-ACTIVITY-INTERRUPT confirm P-ACTIVITY-INTERRUPT indication P-ACTIVITY-RESUME indication P-ACTIVITY-START indication P-ALTER-CONTEXT confirm P-ALTER-CONTEXT indication P-CAPABILITY-DATA confirm P-CAPABILITY-DATA indication P-CONTROL-GIVE indication P-DATA indication P-EXPEDITED-DATA indication P-P-EXCEPTION-REPORT indication P-U-EXCEPTION-REPORT indication P-RESYNCHRONIZE confirm P-RESYNCHRONIZE indication P-SYNC-MAJOR confirm P-SYNC-MAJOR indication P-SYNC-MINOR confirm P-SYNC-MINOR indication P-TOKEN-GIVE indication P-TOKEN-PLEASE indication P-TYPED-DATA indication REDIRECT indication 3 ROSE Routines 3.1 Include Files 3.2 Data Type Definitions 3.2.1 osak_buffer 3.2.2 osak_mem_descriptor 3.2.3 osak_ro_problem 3.2.4 osak_ro_reason 3.2.5 osak_rose_pb 3.2.6 osak_status_block 3.3 Common Arguments 3.4 ROSE Routine Descriptions osak_ro_invoke osak_ro_result osak_ro_error osak_ro_reject_u osak_ro_decode 4 Trace Emitter Routines osak_trace_dcs_verify osak_trace_close osak_trace_open osak_trace_start osak_trace_stop 5 How OSAK Calls Map to Protocol Messages 6 Checking OSAK Status Codes 6.1 Success Status Codes 6.2 Informational Status Codes 6.3 Error Status Codes 7 Disruptive Events 7.1 ABORT request (Local Abort) 7.2 ABORT indication (Peer Abort) 7.3 Transport Connection Loss 7.4 P-ACTIVITY-INTERRUPT indication 7.5 P-ACTIVITY-DISCARD indication 7.6 P-RESYNCHRONIZE indication 7.7 P-EXCEPTION-REPORT indication 7.8 PREPARE (RESYNC) 8 Parameter Passing Mechanisms 9 How the OSAK Interface Implements the ISO Standards 9.1 The OSAK Interface and the ISO Protocol Definitions 9.2 Restrictions in the OSAK Implementation of the ISO Protocol Definitions 10 Possible Values for OSAK Data Types 10.1 Data Type: osak_abort_ppdu 10.2 Data type: osak_abort_reason 10.3 Data type: osak_action_result 10.4 Data type: osak_activity_reason 10.5 Data type: osak_exception_reason 10.5.1 Exception Originating from User 10.5.2 Exception Originating from Presentation Provider 10.6 Field: pm_state 10.7 Field: reason 10.8 Data type: osak_pdefault_context_res 10.9 Data type: osak_reject_reason 10.9.1 Rejection Originating from User 10.9.2 Rejection Originating from ACSE Provider 10.9.3 Rejection Originating from Presentation Provider 10.9.4 Rejection Originating from Session Provider 10.10 Data type: osak_release_reason 10.11 Data type: osak_release_resp_reason 10.12 Field: request_mask and returned mask 10.13 Field: result 10.14 Data type: osak_resync_type 10.15 Fields: data, sync_minor, major_activity and release 10.16 Field: type A Reporting Problems B OSAKserver (OpenVMS Systems Only) B.1 Active and Passive Addresses B.2 What OSAKserver Does B.3 OSAK Databases B.4 NCL and the OSAK Databases B.5 Starting OSAKserver B.6 Registering Active and Passive Addresses B.6.1 Active B.6.2 Passive FIGURES B-1 OSAKserver TABLES 1-1 OSAK API Parameters 1-2 osak_associate_req: Default Protocol Version Numbers 1-3 OSAK Event Types 1-4 osak_open_responder: Default Protocol Version Numbers 1-5 osak_redirect: Default Protocol Version Numbers 1-6 Definitions of Request-Event Mask and Returned-Event Mask 2-1 A-ASSOCIATE indication: Default Protocol Version Numbers 2-2 REDIRECT indication: Default Protocol Version Numbers 2-3 Sequence of Calls After the Arrival of a REDIRECT Indication 3-1 Problem Codes 5-1 Mappings Between OSAK Routines and Protocol Messages 8-1 Parameter Passing Mechanisms B-1 Mapping Between NCL and OSAK