Start of change

Interactive ISPF Gateway

This section provides information about preparing for and using the Interactive ISPF Gateway. For information about the Interactive ISPF Gateway and the Legacy ISPF Gateway and the benefits of using the Interactive ISPF Gateway, see TSO/ISPF client gateway.

To use the Interactive ISPF Gateway, define the environment variable CGI_CEATSO and set it to the value TRUE before invoking the gateway.

The Interactive ISPF Gateway is invoked and runs under the caller's address space. It then uses the z/OS® CEA TSO/E Start of changeaddress spaceEnd of change services to start and communicate with the TSO address space on behalf of the caller. The types of requests that can be issued by the caller are:

Some types of gateway requests (for example, start a TSO/E address space, issue a command in the address space, and end the address space) can be combined in a single request. Upon completion of a request, the gateway returns the results to the client. Examples of items returned are the return code value, the output from the command run in the address space, and the information needed to reuse the address space for a subsequent command.

Start of changeAfterEnd of change a TSO/E address space is created, it can be used for a single TSO/ISPF command and then ended or it can be kept active and used for subsequent commands. The advantage of keeping the address space active is that the overhead of establishing a new Start of changeaddress spaceEnd of change for every TSO/ISPF command request is avoided.

The gateway does not provide the network communications and data transport between the client and z/OS host. The gateway is a thin service designed to interface with a local z/OS application that is serving remote users that have been authenticated to z/OS. The local application is responsible for any network communications when serving the remote client connections.

Note: ISPF commands invoked by means of the gateway run in an ISPF batch environment.
End of change