Service call requests consist of a parameter string passed by means of STDIN to the interface module ISPZINT. The first word of the service request string identifies if the request is for a TSO or ISPF service:

TSO service-request

or

ISPF service-request

A TSO service request results in the TSO service running in a TSO address space without the overhead of establishing an ISPF environment. Shown here are some examples of TSO service requests:

TSO time

TSO alloc fi(temp1) da('hlq.filetemp') shr

An ISPF service request can be for a TSO or ISPF service. The service runs in an ISPF environment established in a TSO address space. The caller can request the ISPF environment be "reusable" (that is, remain active for running subsequent service requests) by including &SESSION=SPAWN in the parameter string. Also the caller can request an existing ISPF profile be dynamically allocated by including &ISPPROF= my.profile.dataset in the parameter string. Shown here are some examples of ISPF service requests:

ISPF tso profile
ISPF select cmd(%myexec)
ISPF tso listalc&SESSION=SPAWN&ISPPROF=HLQ.ISPPROF
ISPF tso ex 'my.dataset(exec1)'&SESSION=SPAWN

ISPPROF may contain the strings &SYSUID., &SYSPREF. and &SYSNAME. in any order. These strings can also be used in the CGI_ISPWORK environment variable. Note that the trailing dot (.) must exist for the variable to be recognised correctly.

&SYSUID.

Replaced by the userid of the active session.

&SYSPREF.

Replaced by the TSO PREFIX, if that can be determined; otherwise, it has the same value as &SYSUID..

&SYSNAME.

Replaced by the SYSNAME IPL parameter.

For example, for this command (where PREFIX is mypref and SYSUID is myuser):

ISPF tso mycmd&SESSION=SPAWN&ISPPROF=HLQ.&SYSPREF..&SYSUID..LLQ

where &SYSPREF is "mypref" and &SYSUID is "myuse" the string becomes:

ISPF tso mycmd&SESSION=SPAWN&ISPPROF=HLQ.mypref.myuser.LLQ

To terminate a "reusable" ISPF session, pass the parameter string shown here to ISPZINT:

ISPFFUNC=SHUTDOWN

or

ISPFFUNC=CANCEL