Termination routine

Use the IRXTERM routine to terminate a language processor environment.

Note: To permit FORTRAN programs to call IRXTERM, TSO/E provides an alternate entry point for the IRXTERM routine. The alternate entry point name is IRXTRM.

You can optionally pass the address of the environment block in register 0 that represents the environment you want terminated. IRXTERM then terminates the language processor environment pointed to by register 0. The environment must have been initialized on the current task.

If you do not specify an environment block address in register 0, IRXTERM locates the last environment that was created under the current task and terminates that environment.

When IRXTERM terminates the environment, IRXTERM closes all open data sets that were opened under that environment. IRXTERM also deletes any data stacks that you created under the environment using the NEWSTACK command.

IRXTERM does not terminate an environment under any one of the following conditions:

The environment was not initialized under the current task
An active exec is currently running in the environment
The environment was the first environment initialized under the task and other environments are still initialized under the task.

The first environment initialized on a task must be the last environment terminated on that task. The first environment is the anchor environment because all subsequent environments that are initialized on the same task share information from the first environment. Therefore, all other environments on a task must be terminated before you terminate the first environment. If you use IRXTERM to terminate the first environment and other environments on the task still exist, IRXTERM does not terminate the environment and returns with a return code of 20.