Parameters

In register 1, you pass the address of a parameter list, which consists of a list of addresses. Each address in the parameter list points to a parameter. The high-order bit of the last address in the parameter list must be set to 1 to indicate the end of the parameter list. For more information about passing parameters, see Parameter lists for TSO/E REXX routines.

Table 1 shows the parameters for IRXTERMA.

Table 1. Parameters for IRXTERMA
Parameter	Number of bytes	Description
Parameter 1	4	A fullword field in which you specify whether you want to terminate the environment in addition to terminating all active execs running in the environment. Specify one of the following: 0 — terminates all execs and the environment X'80000000' — terminates all execs, but does not terminate the environment.
Parameter 2	4	The address of the environment block that represents the environment you want IRXTERMA to terminate. This parameter is optional. If you specify an environment block address, IRXTERMA uses the value you specify and ignores register 0. However, IRXTERMA does not check whether the address is valid. Therefore, you must ensure the address you specify is correct or unpredictable results can occur. If you do not want to use this parameter, you cannot simply specify an address of 0. If you specify 0, IRXTERMA tries to use 0 as a valid address and fails with a return code of 28. To not use this parameter, end the parameter list at parameter 1 by setting the high-order bit on in the address that points to parameter 1. You can also use register 0 to specify the address of an environment block. If you use register 0, IRXTERMA checks whether the address is valid. If the address is valid, IRXTERMA terminates that environment. Otherwise, IRXTERMA locates the current non-reentrant environment that was created at the same task level and terminates that environment.