This document describes the functionality of the Natural TSO Interface (product code NTI) and the operation and individual components of Natural under TSO in the operating system z/OS.
The following topics are covered:
Installing the Natural TSO Interface on z/OS in the Natural Installation for z/OS documentation.
The Natural TSO interface (load modules NATTSO and NATTSOL)
consists of a number of service routines interfacing with the z/OS operating system, see
also Installing the
Natural TSO Interface on z/OS in the Natural
Installation for z/OS documentation. The module NATTSOL contains
functions for the IBM LE environment. You can either link NATTSO to the
Natural nucleus or you can run it separately by connecting it with a shared Natural
nucleus using profile parameter NUCNAME.
NATTSO is fully reentrant and can run above the 16 MB line. Multiple Natural
sessions can be started in parallel within one TSO region, and you can toggle between the
sessions by means of a SWAPKEY (see the corresponding subparameter of profile
parameter TSOP in the
Parameter Reference documentation).
For information on the driver parameters that are available for the Natural TSO
Interface, refer to the description of profile parameter TSOP or parameter macro NTTSOP in the Parameter
Reference documentation.
The following data sets are required if certain functions are used during a Natural TSO session:
CMEDIT
|
Software AG Editor Work File |
CMHCOPY
|
Hardcopy Print Output |
CMPLOG
|
Dynamic Profile Parameter Report Output |
CMPRMIN
|
Dynamic Profile Parameter Input |
CMPRTnn
|
Additional Reports 01-31 |
CMTRACE
|
External Trace Output |
NATRJE
|
Job Submit Output |
STEPLIB
|
Load Library for External Modules |
CMWKFnn
|
Work Files 01-32 |
These data sets are described below.
Unless otherwise stated below, the default DCB RECFM/LRECL
information is as follows:
RECFM=FB and LRECL=80 for sequential input data sets
RECFM=FBA and LRECL=133 for sequential output data sets
The Software AG editor work file VSAM data set is required if a local or global
Software AG editor buffer pool is to be used. If not defined in the JCL or by TSO
command ALLOC, the name of the Editor work file specified by
subparameter DSNAME of profile parameter EDBP or parameter macro
NTEDBP is used by Natural to do the dynamic
allocation for the Editor work file.
Alternatively, profile parameter EDPSIZE can be used to run with an auxiliary
editor buffer pool, which does not require an editor work file. For more information
about the installation of the Software AG editor, refer to Installing the Software AG Editor on
z/OS in the Natural Installation for z/OS
documentation.
The default name of the hardcopy print output data set is CMHCOPY. It can
be changed by one of the following:
the DEST subparameter of profile parameter PRINT for Print File
0,
the profile parameter HCDEST, which is an equivalent of
PRINT=((0),DEST=...),
the setting of the system variable *HARDCOPY during the session,
the terminal command %H during the session.
The subparameters of the PRINT profile parameter for Print File 0 can be
used to change the default values for the hardcopy data set. The default data set name
CMHCOPY implies CLOSE=FIN for the hardcopy print data set,
that is, after the data set is opened for output, any subsequent change of the hardcopy
print output data set name is not honored. If a different name is defined at open time,
the hardcopy data set will be closed upon the next terminal I/O.
During the session, the hardcopy data set can be released and reallocated (before open
or after close) by the by dynamic allocation (see Natural Application Programming
Interface USR2021N).
If the profile parameter PLOG is set to ON and data set
CMPLOG is available, the evaluated dynamic profile parameters are written
to this data set during session initialization. If data set CMPLOG is not
available, the evaluated dynamic profile parameters are written to the TSO terminal in
line mode.
If available, this data set is read during session initialization to get dynamic profile parameters. Only the first 72 positions of each record are used to build a dynamic profile parameter string.
Any other profile parameters which are passed directly for the start of the Natural
nucleus, for example, by the TSO CALL command, are
concatenated at the end of the parameter string which is build from the input of
CMPRMIN; that is, these can be used to overwrite the parameters from
CMPRMIN.
These data sets can be used by Natural print file statements like WRITE (nn).
If no DCB information (for example, RECFM, LRECL,
BLKSIZE) is available, the defaults are defined by the profile parameter
PRINT or by the
macro NTPRINT in the Natural parameter module. The
print file data set names can be overwritten by subparameter DEST.
If the profile parameter ETRACE is set to ON, or if the
equivalent terminal command %TRE+ was issued, any Natural trace output
during the session is written to the CMTRACE data set. To define the
Natural components that shall be traced, the profile parameter TRACE is required.
If data set CMTRACE is not available, it will be allocated dynamically
as
//CMTRACE DD SYSOUT=*
when the first trace record is to be written.
This data set is used for the Natural job submitting utility. If it is not defined, it will be allocated dynamically as
//NATRJE DD SYSOUT=(A,INTRDR)
when the first job is submitted.
STEPLIB is the default load library name for loading external modules, for
example, the shared nucleus (profile parameter NUCNAME), a separate Adabas link routine module
(profile parameter ADANAME), the session back-end program (profile
parameter PROGRAM) and any external subprograms not linked to
the Natural parameter module.
The load library name can be overwritten by profile parameter LIBNAM. The specified load
library name must be defined in the TSO job control or by an ALLOC
statement, for example, in the CLIST which starts the Natural session.
These data sets can be used by Natural work file statements like READ WORK FILE
nn and WRITE WORK nn. If no DCB
information (RECFM, LRECL, BLKSIZE, etc.) is
available in the JCL or in the VTOC entry for the data set, the defaults are defined by
the WORK profile parameter or by the
NTWORK macro in the Natural parameter module. The
work file data set names can be overwritten by subparameter DEST.
You can use the Natural example program TSO in library SYSEXTP to issue TSO
commands; for example:
TSO LISTALC STATUS
If you enter TSO without parameters, a menu prompts you for a TSO command. To exit from the menu, enter a period (.) in the first position, or press PF3.
