TSOP - Parameters for Natural TSO Interface

This Natural profile parameter is used to specify the parameters for the Natural TSO Interface. It corresponds to the macro NTTSOP in the Natural parameter module.

Possible settings See TSOP Parameter Syntax.
Default setting See Keyword Subparameters.
Dynamic specification yes The parameter TSOP can only be specified dynamically. In the Natural parameter module, use the macro NTTSOP.
Specification within session no  

The following topics are covered:


TSOP Parameter Syntax

The TSOP parameter is specified as follows:

TSOP=(keyword-subparameter=value,keyword-subparameter=value,...)

For information on subparameter names and values, see Keyword Subparameters.

NTTSOP Macro Syntax

The NTTSOP macro is specified as follows:

         NTTSOP ABEXIT=value,                                          *
               ALTSCRN=value,                                          *
               LBPNAME=value,                                          *
               LEHDLR=value,                                           *
               NDBFSRV=value,                                          *
               PA2=value,                                              *
               SUBPOOL=value,                                          *
               SWAPKEY=value,                                          *
               TIOBSZ=value

See Keyword Subparameters.

Keyword Subparameters

ABEXIT | ALTSCRN | LBPNAME | LEHDLR | NDBFSRV | PA2 | SUBPOOL | SWAPKEY | TIOBSZ

ABEXIT - Abend Processing

ABEXIT=value specifies the mode of abend processing within Natural.

Value Explanation
ESTAE Natural intercepts all abends and issues the appropriate error messages.

This is the default value.

SPIE Only program checks (S0Cx abends) are intercepted.
OFF Natural does not intercept any abends or program checks at all.

Notes:

  1. The setting ABEXIT=OFF corresponds to profile parameter DU=FORCE.
  2. The setting ABEXIT=OFF is not recommended because some functions, which require the abend interception, will not work any longer. The usage of profile parameter MT will cause an abend U0322 instead of error NAT0953 when the CPU time limit is reached.

ALTSCRN - Session Screen Mode

ALTSCRN=value specifies whether the 3270 alternate screen size is to be used.

Value Explanation
ON The alternate screen size is to be used.

This is the default value.

OFF The default screen size is to be used.

Notes:

  1. There are 2 sets of screen heights/widths from the VTAM LOGMODE definition for the terminal, default and alternate screen size. Usually, the default screen size is 24 lines and 80 columns. The alternate screen size depends on the 3270 terminal model (2, 3, 4 or 5).
  2. The screen size can be overwritten with Natural profile parameter TMODEL.

LBPNAME - Sharing of Local Buffer Pools

LBPNAME=value controls the sharing of the local buffer pool when running multiple Natural sessions within the same TSO region. It defines the name of the shared buffer pool environment and is used to locate the shared local buffer pool.

Value Explanation

1 - 8 characters
or
' ' (blank)

Name of the shared buffer pool.
' ' (blank) The local buffer pools are not shared.

This is the default value.

Note:
When running multiple Natural sessions in a z/OS batch or TSO region concurrently, each session allocates storage for a separate local buffer pool. Except for the Natural z/OS batch mode server, the local buffer pools are not shared by default; that is, if the different sessions use the same Natural objects, these have to be loaded once for each session separately. If a shared buffer pool name is specified, all Natural sessions will share the same local buffer pool.

LEHDLR - Use of an LE Error Handler for Calling LE Subprograms

LEHDLR=value specifies whether Natural uses an LE error handler for the call of LE subprograms.

Value Explanation
ON An LE error handler is set up by Natural during the call of LE subprograms. This means, if an unhandled LE error occurs during the execution of an LE subprogram, Natural will get control and can handle it (by issuing error NAT0954).

This is the default value.

OFF No setting of an LE error handler is done by Natural during the call of LE subprograms. This means, if an unhandled error occurs during the execution of a LE subprogram, the LE enclave is terminated and so the Natural session is lost.

Notes:

  1. For information on LE runtime options, see the description of source module NATLEOPT in the Installation for z/OS documentation.
  2. For information on Natural running with the IBM Language Environment, refer to Natural Execution - Miscellaneous Topics, LE Subprograms in the Operations documentation.

NDBFSRV - Natural for Db2 File Server

NDBFSRV=value specifies whether the Natural for Db2 file server is to be used.

Value Explanation
OFF The Natural for Db2 file server will not be used.

This is the default value.

ON The Natural for Db2 file server is invoked at each terminal I/O.

PA2 - Behavior of PA2 Key

PA2=value specifies how the PA2 key shall work.

Value Explanation
ON The PA2 key value is passed to the Natural application.
OFF The PA2 key value is used to redisplay the terminal screen and is not passed to the Natural application.

This is the default value.

Note:
The PA2 subparameter specification is irrelevant if the PA2 key is defined as the split screen swap key by subparameter SWAPKEY.

SUBPOOL - Storage Subpool for GETMAIN Requests

SUBPOOL=value defines the storage subpool for GETMAIN requests.

Value Explanation
1 - 127 Subpool number.
0 This is the default value.

Notes:

  1. The subparameter SUBPOOL is honored only in the Natural parameter module which is linked to the TSO driver, but not in an alternative parameter module which is activated using a PARM= specification.
  2. As the subparameter SUBPOOL is evaluated during session initialization only, it cannot be specified as a dynamic subparameter.

SWAPKEY - TSO/ISPF Split Screen Feature Support

SWAPKEY=value defines the TSO/ISPF split screen swap key for Natural, which is assigned to PF9 on most of the panels of Software AG product Natural ISPF (Integrated Structured Programming Facility).

Value Explanation
PF1 - PF24 Defines the PF- or PA-key which shall be used to swap to the next TSO/ISPF session.
PA1 - PA3
OFF By default, no swap key is defined; that is, no split screen feature support is generated.

Notes:

  1. The specified key cannot be used by Natural applications. Usually, the SWAP command in TSO/ISPF is assigned to the PF9 key on most TSO/ISPF panels.
  2. Split screen support requires the TSO/ISPF interface module ISPLINK from the ISPF load library. You can include ISPLNK in the link step for NATTSO. If not linked, Natural tries to load it dynamically when the key defined with SWAPKEY is first used in the session. If ISPLINK is not contained in the load library, Natural treats SWAPKEY as set to OFF.

TIOBSZ - Size of the Terminal I/O Buffer

TIOBSZ=value specifies the size of the terminal I/O buffer.

Value Explanation
4 - 32 Size of the terminal I/O buffer in KB.
8 This is the default setting.

Note:
The terminal I/O buffer is allocated below the 16 MB line.

Example of TSOP Parameter

TSOP=(LBPNAME=NATTEST1,TIOBSZ=12,SWAPKEY=PF9)

Example of NTTSOP Macro

         NTTSOP LBPNAME=NATTEST1,TIOBSZ=12,SWAPKEY=PF9