Table of Contents (exploded view)
Abstract for MVS Programming: Writing Servers for APPC/MVS
z/OS Version 2 Release 1 summary of changes
Introduction
Distributed Applications
The Client/Server Model
Overview
APPC/MVS Server Facilities
Resource Management
Owning Inbound Conversations
The Allocate Queue
Creating an Allocate Queue
APPC/MVS Inbound Processing
Server Processing: An Overview
Request Flow
Managing Allocate Queues
Server Initialization
Special Considerations for Authorized Servers
Related System Functions
What the Application Programmer Provides
What Your Installation Can Provide
Using Allocate Queue Services
Using the Services Asynchronously
Using JES Services
The Basic Server Functions
Creating An APPC/MVS Server
Specifying Symbolic Destination Names
Filtering Requests
Receiving the Allocate Queue Token
Securing Access to Client TPs
For Which Local LUs Can a Server Register?
Additional Considerations for Registering
Receiving Inbound Conversations
Specifying the Allocate Queue Token
Allowing the Request to Wait
Specifying the Timeout Value
Used With Notify_Type
Receiving the Conversation ID
Other Outputs From Receive_Allocate
Conversation Mode Name/Partner LU Name
Conversation Type/Synchronization Level
User ID/Security Profile
Using the Get_Attributes Service
Rejecting Conversations
Unregistering For Allocate Requests
Using Multiple Servers
Advanced Server Functions
Querying the Allocate Queue
TP Name/Local LU name
Other Information About the Allocate Queue
Receiving Notification of Events
Requesting Notification of Events
Using Get_Event to Retrieve Event Elements
Specifying Event Notification Types
Specifying Thresholds
Threshold Already Reached
Specifying Multiple Thresholds
Modifying Thresholds
Example of Modifying a Threshold
Cancelling Event Notification
Event Notification Clean-Up
Retrieving Event Elements
Specifying the Event Buffer
Effect of Unregister_For_Allocates
Allowing the Allocate Queue to Persist
Use of Unregister_For_Allocates
Multi-Tasking Servers
Model One — Empowerment
Model Two — Management-Directed
Model Three — Unmanaged
General Considerations for Multi-Tasking Servers
Managing Protected Conversations
Accounting for Server Usage
Tracking Server-Specific Resources through SMF
Adding User Data to Accounting Records
Performance Considerations for Allocate Queue Services
Installing APPC/MVS Servers
Diagnosing Problems with APPC/MVS Servers
Invocation Details for Allocate Queue Services
Interface Definition Files (IDFs)
Syntax and Linkage Conventions for Allocate Queue Services
Linkage Conventions
Parameter Description for Allocate Queue Services
Required Modules
Versions of Callable Services
Interface Definition Files (IDFs) for APPC/MVS Services
APPC/MVS Allocate Queue Services
Get_Event
Environment for Get_Event
Restrictions
Input Register Information
Output Register Information
Syntax Format for Get_Event
Parameters for Get_Event
Abend Codes for Get_Event
Query_Allocate_Queue
Environment for Query_Allocate_Queue
Restrictions
Input Register Information
Output Register Information
Syntax Format for Query_Allocate_Queue
Parameters for Query_Allocate_Queue
Abend Codes for Query_Allocate_Queue
Receive_Allocate
Environment for Receive_Allocate
Restrictions
Input Register Information
Output Register Information
Syntax Format for Receive_Allocate
Parameters for Receive_Allocate
Abend Codes for Receive_Allocate
Register_for_Allocates
Environment for Register_For_Allocates
Restrictions
Input Register Information
Output Register Information
Syntax Format for Register_For_Allocates
Parameters for Register_For_Allocates
Abend Codes for Register_For_Allocates
Set_Allocate_Queue_Attributes
Environment for Set_Allocate_Queue_Attributes
Restrictions
Input Register Information
Output Register Information
Syntax Format for Set_Allocate_Queue_Attributes
Parameters for Set_Allocate_Queue_Attributes
Abend Codes for Set_Allocate_Queue_Attributes
Set_Allocate_Queue_Notification
Environment for Set_Allocate_Queue_Notification
Restrictions
Input Register Information
Output Register Information
Syntax Format for Set_Allocate_Queue_Notification
Parameters for Set_Allocate_Queue_Notification
Abend Codes for Set_Allocate_Queue_Notification
Unregister_For_Allocates
Environment for Unregister_For_Allocates
Restrictions
Input Register Information
Output Register Information
Syntax Format for Unregister_For_Allocates
Parameters for Unregister_For_Allocates
Abend Codes for Unregister_For_Allocates
Character Sets
Explanation of Return and Reason Codes
Return Codes
Reason Codes
Symptom Records for APPC Service Failures
Sample APPC/MVS Server
Sample Client Program
Sample Error Routine and Header File
Header File