z/OS TSO/E Programming Services
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Passing Control to IKJEFTSR

z/OS TSO/E Programming Services
SA32-0973-00

Invoke the TSO/E Service Facility routine (IKJEFTSR) using one of the following methods:
  • The LINK macro instruction. Use this, for example, from an assembler program.

    Specify IKJEFTSR or its alias TSOLNK as the entry point name. TSOLNK is useful if the programming language you are using does not allow you to use names longer than six characters.

  • The address of IKJEFTSR that is in the TSVTASF field of the TSVT

    Use this, for example, when you want to get addressability to the common copy of IKJEFTSR for all applications.

  • Link-editing IKJEFTSR with your application program.

    Be aware that if you use this method and a change, for example, a release upgrade, occurs, then it is your responsibility to link-edit again to pick up the new level. For link-editing the user program, the SYSLIB concatenation must contain SYS1.LPALIB, in which TSOLNK and IKJEFTSR reside.

Standard linkage conventions are:
  • Register 1 must contain the address of a parameter list.
  • Register 13 must contain the address of an 18-word save area.
  • Register 14 must contain the return address.
  • Register 15 must contain the entry point address.

The parameter list pointed to by register 1 consists of a list of addresses. Each address points to a parameter. If you want to use a command, program, CLIST, or REXX exec, you must specify the first six parameters. If you want to pass parameters to a program, you can specify an optional seventh parameter when you invoke the TSO/E Service Facility. The seventh parameter is intended for use with assembler programs. The eighth and ninth parameters are optional, and are intended for use when invoking a command, REXX exec, or CLIST in an unauthorized environment. To indicate the end of the parameter list, you must set the high-order bit of the last address to 1.

Your application program can invoke IKJEFTSR in 24-bit or 31-bit addressing mode. IKJEFTSR returns control to its caller in the same addressing mode with which it was invoked.

The caller's parameters must be in the primary address space. Input can reside above or below 16 MB in virtual storage. IKJEFTSR treats input addresses according to the addressing mode in which IKJEFTSR was invoked.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014