z/OS TSO/E Guide to SRPI
Previous topic |
Next topic
|
Contents
|
Contact z/OS
|
Library
|
PDF
Contents (exploded view)
z/OS TSO/E Guide to SRPI
SA32-0980-00
Abstract for TSO/E Guide to the Server-Requester Programming Interface
z/OS Version 2 Release 1 summary of changes
Introduction
Concepts of the TSO/E Enhanced Connectivity Facility
What is an MVS Server?
Service Functions
Initialization/Termination Programs
What is MVSSERV?
The SRPI
The CPRB Control Block
The INITTERM Control Block
The Sequence of Events in an MVSSERV Session
What You Need to Do to Write Servers
Writing Access Method Drivers for MVSSERV
Designing and Writing a Server
Server Design
Steps for Designing a Server
Writing a Server
Using the CPRB
Receiving the Service Request
Mapping to the CPRB Fields
The Receive Request CPRB (Entry to Server)
Performing the Service
Using Request and Reply buffers
Sending the Service Reply
The Send Reply CPRB (Exit from Server)
Sending a Service Request
Receiving a Service Reply
The Receive Reply CPRB (Entry to Server)
Issuing Messages
The Server Recovery Routine
Compiling or Assembling a Server
Sample Servers
Sample Server IBMABASE
Sample Server IBMABAS1
Sample Server IBMABAS2
Designing and Writing a Server Initialization/Termination Program
Program Design
Steps for Designing an Initialization/Termination Program
Writing an Initialization/Termination Program
Initialization
Input to the Initialization/Termination Program
Loading the Servers
Obtaining Resources
Defining a Server
Results of the DEFSERV Macro
The DEFSERV Request CPRB
The Define Server Parameter Area
Sending a Service Request
Receiving a Service Reply
Issuing Messages
Recovery
Ending Initialization
Termination
Freeing Resources
Deleting the Servers
Compiling or Assembling an Initialization/Termination Program
Sample Initialization/Termination Program
Writing an Access Method Driver
What is an Access Method Driver?
Using the AMD Interface
Writing an Access Method Driver
Installing and Defining an Access Method Driver
AMD Invocation
Considerations for Writing Access Method Drivers
Sending a Service Request
Receiving a Service Reply
Issuing Messages
Sample Access Method Driver
Installing Programs and Data Sets for Use with MVSSERV
Installing a Program
In a STEPLIB
In a System Library
Using the Input Parameter Data Set
Allocating the Input Parameter Data Set
Initializing the Input Parameter Data Set
Additional MVSSERV Data Sets
Trace Data Set
Allocating the Trace Data Set
Dump Data Set
Allocating the Dump Data Set
Dump Suppression Data Set
Allocating the Dump Suppression Data Set
Initializing the Dump Suppression Data Set
Testing and Diagnosis
Testing Servers
Steps for Testing Servers
Diagnosing Servers
Reading the Trace Data Set
Informational Messages
Error Messages
The Internal Execution Path Trace Table
Macro Syntax and Parameters
CHSDCPRB Macro
Accessing the CPRB
Creating a CPRB for the DEFSERV or SENDREQ Macro
CHSCED Macro
INITTERM Macro
DEFSERV Macro
Register Contents for DEFSERV
DEFSERV Syntax and Parameters
Execute Form
List Form
The DEFSERV CPRB
SENDREQ Macro
Register Contents for SENDREQ
SENDREQ Syntax and Parameters
Execute Form
List Form
The SENDREQ CPRB
CHSTRACE Macro
CHSTRACE Considerations
CHSTRACE Syntax and Parameters
Execute Form
List Form
MVSSERV Return Codes
Return Codes from the DEFSERV Macro
Return Codes from the DEFSERV CPRB
Return Codes from the SENDREQ Macro
Return Codes from the SENDREQ CPRB
Return Codes from the CHSTRACE Macro
Copyright IBM Corporation 1990, 2014