Tool Adapter as ISPF Service

If the invoke forms CMD or PGM are used when modeling an ISPF tool, the call-up of the tool will take place via the ISPF SELECT Service, as follows:
  • SELECT CMD(toolname parmlist)
  • SELECT PGM(toolname) PARM(parmlist)

With CMD, tools can be called up that are implemented as CLIST, REXX or TSO Command. With PGM, compiled programs are called up.

The parameter transfer takes place according to modeled parameter sequence numbers. The rules and restrictions of the ISPF SELECT Service must be observed, however.                  

The tool adapter must return both a return code, and, if modeled, output parameters to the client application. The output parameters must be made available by the tool in the ISPF Shared Pool Variable named TAUTOPM.

The installation SAMPLIB contains two samples (TAUSAPL1 and TAUSACOB) to demonstrate how to set the ISPF variable TAUTOPM from a PL1 and COBOL program respectively. The sample programs just return the parameter string passed to them via the shared pool variable TAUTOPM.