Abstract for TSO/E Guide to the Server-Requester Programming Interface

This information supports z/OS® (5694-A01).

Purpose of this information

The server-requester programming interface (SRPI) of the TSO/E Enhanced Connectivity Facility lets you write server programs. The servers can provide MVS™ host computer services, data, and resources to requester programs on IBM® personal computers.

This information tells you how to write an MVS server to receive a service request, process the request, and return a reply to the requester. The information includes a sample server, along with information on installing, testing, and debugging servers.

This information also includes information about how to write programs called access method drivers. Access method drivers allow the MVS host to manage server-requester communications across different hardware connections with the personal computer (PC).

Who should use this information

This information is intended for:

Application programmers who design, write, and test MVS servers and server initialization/termination programs.
System programmers who allocate and initialize the data sets that make MVS servers and diagnosis information available to users.
System programmers who write or install access method drivers for use with the TSO/E Enhanced Connectivity Facility.

The audience must be familiar with MVS programming conventions and the assembler programming language.

How this information is organized

Introduction describes MVS servers and how they provide MVS services, data, and resources to requester programs.
Designing and Writing a Server describes the input a server receives, the tools a server can use to process requests, and the output a server must provide.
Designing and Writing a Server Initialization/Termination Program describes how to write a program that initializes one or more servers, obtains resources for them, and terminates them.
Writing an Access Method Driver describes how to write a program that can manage server-requester communications across specific PC-to-Host hardware connections.
Installing Programs and Data Sets for Use with MVSSERV describes how to allocate and initialize the data sets that give users access to servers, initialization/termination programs, access method drivers, and diagnosis information.
Testing and Diagnosis explains how to use the MVSSERV command to test a server. This chapter also tells how to use the MVSSERV trace data set to diagnose server problems.
Macro Syntax and Parameters describes the syntax and parameters of the macros you can use in MVSSERV programming.
MVSSERV Return Codes describes the return codes that you may receive from the MVSSERV macros.