Specifying values for the new environment

If you use IRXINIT to initialize a new language processor environment, the parameters you can specify on the call depend on:

Whether the environment is being initialized in a non-TSO/E address space or in the TSO/E address space
If the environment is being initialized in the TSO/E address space, whether the environment is to be integrated into TSO/E (TSOFL flag setting)

You can use many parameters only if the environment is initialized in a non-TSO/E address space or if the environment is initialized in TSO/E, but is not integrated into TSO/E (the TSOFL flag is off). Other parameters are intended only for use in the TSO/E address space where the environment is integrated into TSO/E (the TSOFL flag is on). The following information highlights different parameters. For more information about the values you can and cannot specify and various considerations for parameter values, see Specifying values for different environments.

When you call IRXINIT, you cannot specify the ID and VERSION. If you pass values for the ID or VERSION parameters, IRXINIT ignores the value and uses the default.

At offset +36 in the parameters module, the field is a fullword of bits that IRXINIT uses as flags. The flags define certain characteristics for the new language processor environment and how the environment and execs running in the environment operate. In addition to the flags field, the parameter following the flags is a mask field that works together with the flags. The mask field is a string that has the same length as the flags field. Each bit position in the mask field corresponds to a bit in the same position in the flags field. IRXINIT uses the mask field to determine whether it should use or ignore the corresponding flag bit.

The description of the mask field of Characteristics of a Language Processor Environment describes the bit settings for the mask field in detail. Table 2 summarizes each flag. Flags and corresponding masks describes each of the flags in more detail and the bit settings for each flag.

For a given bit position, if the value in the mask field is:

0 – IRXINIT ignores the corresponding bit in the flags field (that is, IRXINIT considers the bit to be null)
1 – IRXINIT uses the corresponding bit in the flags field

When you call IRXINIT, the flag settings that IRXINIT uses depend on the:

Bit settings in the flag and mask fields you pass in the in-storage parameter list
Bit settings in the flag and mask fields you pass in the parameters module
Flags defined for the previous environment
Flags defined in IRXPARMS if a previous environment does not exist.

IRXINIT uses the following order to determine what value to use for each flag bit:

IRXINIT first checks the mask setting in the in-storage parameter list. If the mask is 1, IRXINIT uses the flag value from the in-storage parameter list.
If the mask in the in-storage parameter list is 0, IRXINIT then checks the mask setting in the parameters module. If the mask in the parameters module is 1, IRXINIT uses the flag value from the parameters module.
If the mask in the parameters module is 0, IRXINIT uses the flag value defined for the previous environment.
If a previous environment does not exist, IRXINIT uses the flag setting from IRXPARMS.

If you call IRXINIT to initialize an environment that is not integrated into TSO/E (the TSOFL flag is off), you can specify a subpool number (SUBPOOL field) from 0 – 127. IRXINIT does not check the number you provide. If the number is not 0 – 127, IRXINIT does not fail. However, when storage is used in the environment, an error occurs.

If you call IRXINIT to initialize an environment in the TSO/E address space and the environment is integrated into TSO/E, you must provide a subpool number of 78 (decimal). If the number is not 78, IRXINIT returns with a reason code of 7 in parameter 7.

For detailed information about the parameters you can specify for initializing a language processor environment, see Specifying values for different environments.

The end of the parameter block must be indicated by X'FFFFFFFFFFFFFFFF'.