|
The module name table contains the names of: - The DDs for reading and writing data
- The DD from which to load REXX execs
- Replaceable routines
- Several exit routines
In the parameter block, the MODNAMET field points to the module
name table (see Characteristics of a Language Processor Environment).
Table 1 shows the format of the module
name table. Each field is described in detail following the table.
The end of the table is indicated by X'FFFFFFFFFFFFFFFF'.
TSO/E provides a mapping macro IRXMODNT for the module name table.
The mapping macro is in SYS1.MACLIB.
Table 1. Format of the module name tableOffset (decimal) |
Number of bytes |
Field name |
Description |
---|
0 |
8 |
INDD |
The DD from which the PARSE EXTERNAL instruction
reads input data. |
8 |
8 |
OUTDD |
The DD to which data is written for either a SAY
instruction, for REXX error messages, or when tracing is started. |
16 |
8 |
LOADDD |
The DD from which REXX execs are fetched. |
24 |
8 |
IOROUT |
The name of the input/output (I/O) replaceable
routine. |
32 |
8 |
EXROUT |
The name of the exec load replaceable routine. |
40 |
8 |
GETFREER |
The name of the storage management replaceable
routine. |
48 |
8 |
EXECINIT |
The name of the exec initialization exit routine. |
56 |
8 |
ATTNROUT |
The name of an attention handling exit routine. |
64 |
8 |
STACKRT |
The name of the data stack replaceable routine. |
72 |
8 |
IRXEXECX |
The name of the exit routine for the IRXEXEC routine. |
80 |
8 |
IDROUT |
The name of the user ID replaceable routine. |
88 |
8 |
MSGIDRT |
The name of the message identifier replaceable
routine. |
96 |
8 |
EXECTERM |
The name of the exec termination exit routine. |
152 |
8 |
— |
The end of the module name table must be indicated
by X'FFFFFFFFFFFFFFFF'. |
Each field in the module name table is described below. You can
specify some fields for any type of language processor environment. You
can use other fields only for environments that are integrated into
TSO/E or for environments that are not integrated into TSO/E. The
description of each field below indicates the type of environment
for which you can use the field. Relationship of fields in module name table to types of environments summarizes
the fields in the module name table and the environments for which
you can specify each field.
- INDD
- Specifies the name of the DD from which
the PARSE EXTERNAL instruction reads input data (in a language processor environment that
is not integrated into TSO/E). The system default is SYSTSIN.
If
the environment is integrated into TSO/E (the TSOFL flag is on), the
system ignores any value you specify for INDD. In TSO/E foreground,
TSO/E uses the terminal. In the background, TSO/E uses the input
stream, which is SYSTSIN.
- OUTDD
- Specifies the name of the DD to which
data is written for a SAY instruction, for REXX error messages, or
when tracing is started (in a language processor environment that
is not integrated into TSO/E). The system default is SYSTSPRT.
If
the environment is integrated into TSO/E (the TSOFL flag is on), the
system ignores any value you specify for OUTDD. In TSO/E foreground,
TSO/E uses the terminal. In the background, TSO/E uses the output
stream, which is SYSTSPRT.
- LOADDD
- Specifies the name of the DD from which
REXX execs are loaded. The default is SYSEXEC. You can specify a
ddname in any type of language processor environment (integrated
or not integrated into TSO/E).
In TSO/E, you can store REXX execs
in data sets that are allocated to SYSEXEC or SYSPROC. If you store
an exec in a data set that is allocated to SYSPROC, the exec must
start with a comment containing the characters REXX within
the first line (line 1). This is required to distinguish REXX execs
from CLISTs that are also stored in SYSPROC.
In data sets that
are allocated to SYSEXEC, you can store REXX execs only, not CLISTs.
If you store an exec in SYSEXEC, the exec does not need to start
with a comment containing the characters "REXX". However, it
is suggested that you start all REXX programs with a comment regardless
of where you store them. SYSEXEC is useful for REXX execs that follow
the SAA Procedures
Language standards and that will be used on other SAA environments.
The NOLOADDD
flag (see Flags and corresponding masks) controls whether the
system searches the DD specified in the LOADDD field. - If the NOLOADDD flag is off, the system searches the DD specified
in the LOADDD field. If the language processor environment is integrated
into TSO/E and the exec is not found, the system then searches SYSPROC.
- If the NOLOADDD flag is on, the system does not search the DD
specified in the LOADDD field. However, if the language processor environment is integrated
into TSO/E, the system searches SYSPROC.
In the default parameters module that
is provided for TSO/E (IRXTSPRM), the NOLOADDD mask and flag settings
indicate that SYSEXEC is searched before SYSPROC. (Note that before
TSO/E 2.3, the default settings indicated that SYSPROC only was searched).
In the default parameters module for ISPF (IRXISPRM), the defaults
indicate that the environment inherits the values from the previous
environment, which is the environment initialized for TSO/E. By default,
the system searches the ddname specified in the LOADDD field (SYSEXEC).
To use SYSPROC exclusively, you can provide your own parameters module
or use the EXECUTIL SEARCHDD command. For more information, see Using SYSPROC and SYSEXEC for REXX execs.
- IOROUT
- Specifies
the name of the routine that is called for input and output operations.
The routine is called for:
- The PARSE EXTERNAL, SAY, and TRACE instructions when the exec
is running in an environment that is not integrated into TSO/E
- The PULL instruction when the exec is running in an environment
that is not integrated into TSO/E and the data stack is empty
- Requests from the EXECIO command
- Issuing REXX error messages
You can specify an I/O replaceable routine only in language processor environments that
are not integrated into TSO/E. For more information about the replaceable
routine, see Input/Output routine.
- EXROUT
- Specifies
the name of the routine that is called to load and free a REXX exec.
The routine returns the structure that is described in The in-storage control block (INSTBLK). The specified routine is called
to load and free this structure.
You can specify an exec load
replaceable routine only in language processor environments that
are not integrated into TSO/E. For more information about the replaceable
routine, see Exec load routine.
- GETFREER
- Specifies
the name of the routine that is called when storage is to be obtained
or freed. If this field is blank, TSO/E storage routines handle storage
requests and use the GETMAIN and FREEMAIN macros when larger amounts
of storage must be handled.
You can specify a storage management
replaceable routine only in language processor environments that
are not integrated into TSO/E. For more information about the replaceable
routine, see Storage management routine.
- EXECINIT
- Specifies
the name of an exit routine that gets control after the system initializes
the REXX variable pool for a REXX exec, but before the language processor processes
the first clause in the exec. The exit differs from other standard
TSO/E exits. The exit does not have a fixed name. You provide the
exit and specify the routine's name in the EXECINIT field. REXX exit routines describes the exec initialization
exit.
You can provide an exec initialization exit in any type
of language processor environment (integrated
or not integrated into TSO/E).
- ATTNROUT
- Specifies
the name of an exit routine that is invoked if a REXX exec is processing
in the TSO/E address space (in an environment that is integrated into
TSO/E), and an attention interruption occurs. The attention handling
exit differs from other standard TSO/E exits. The exit does not have
a fixed name. You provide the exit and specify the routine's name
in the ATTNROUT field. REXX exit routines describes
the attention handling exit.
You can provide an attention handling
exit only in a language processor environment that
is integrated into TSO/E.
- STACKRT
- Specifies
the name of the routine that the system calls to handle all data stack
requests.
You can specify a data stack replaceable routine only
in language processor environments
that are not integrated into TSO/E. For more information about the
replaceable routine, see Data stack routine.
- IRXEXECX
- Specifies
the name of an exit routine that is invoked whenever the IRXEXEC routine
is called to run an exec. You can use the exit to check the parameters
specified on the call to IRXEXEC, change the parameters, or decide
whether IRXEXEC processing should continue.
The exit differs from
other standard TSO/E exits. The exit does not have a fixed name.
You provide the exit and specify the routine's name in the IRXEXECX
field.
You can provide an exit for the IRXEXEC routine in any
type of language processor environment (integrated
or not integrated into TSO/E). For more information about the exit,
see REXX exit routines.
- IDROUT
- Specifies
the name of a replaceable routine that the system calls to obtain
the user ID. The USERID built-in function returns the result that
the replaceable routine obtains.
You can specify a user ID replaceable
routine only in language processor environments that
are not integrated into TSO/E. For more information about the replaceable
routine, see User ID routine.
- MSGIDRT
- Specifies
the name of a replaceable routine that determines whether the system
should display the message identifier (message ID) with a REXX error
message.
You can specify a message identifier replaceable routine
only in language processor environments
that are not integrated into TSO/E. For more information about the
replaceable routine, see Message identifier routine.
- EXECTERM
- Specifies
the name of an exit routine that gets control after the language processor processes
a REXX exec, but before the system terminates the REXX variable pool.
The exit differs from other standard TSO/E exits. The exit does
not have a fixed name. You provide the exit and specify the routine's
name in the EXECTERM field. REXX exit routines describes
the exit in more detail.
You can provide an exec termination exit
in any type of language processor environment (integrated
or not integrated into TSO/E).
- X'FFFFFFFFFFFFFFFF'
- The end of the module name table must be indicated by X'FFFFFFFFFFFFFFFF'.
|