This Natural profile parameter can only be specified with the NTIMSPE
macro,
dynamic parameter specification is not possible yet.
The NTIMSPE
macro is used to define environment-specific parameter sets, which
can be assigned to transaction definitions (ENVPID
keyword subparameter of NTIMSPT
macro).
Note:
You can only define an NTIMSPE
macro to the Natural parameter
module if the module already contains at least one NTIMSPT
macro.
Otherwise, an assembly error occurs when trying to assemble the module.
Possible settings | See below. |
---|---|
Default setting | See below. |
Dynamic specification | no |
Specification within session | no |
This section covers the following topics:
The NTIMSPE
macro is specified as follows:
NTIMSPE ACTACTV=value, * ACTAHDR=value, * ACTARID=value, * ACTLOG=value, * BMPABER=value, * BROACTV=value, * CMBSIZE=value, * COLPSCR=value, * ENDMODN=value, * ENTRYNM=value, * ERRLHDR=value, * HCBSIZE=value, * HDENSDU=value, * LINPSCR=value, * MISIZE=value, * MONACTV=value, * MOSIZE=value, * PRTDRIV=value, * ROLLSRV=value, * ROLLFN=value, * SPASIZE=value, * SPATID=value, * SUPNONC=value, * TERMIPL=value, * THBELOW=value, * THSIZE=value, * USERID=value
ACTACTV
| ACTAHDR
| ACTARID
| ACTLOG
| BMPABER
| BROACTV
| CMBSIZE
| COLPSCR
| ENDMODN
| ENTRYNM
| ERRLHDR
| HCBSIZE
| HDENSDU
| LINPSCR
| MISIZE
| MONACTV
| MOSIZE
| PRTDRIV
| ROLLSRV
| ROLLFN
| SPASIZE
| SPATID
| SUPNONC
| TERMIPL
| THBELOW
| THSIZE
| USERID
This keyword subparameter only applies in dialog-oriented environments.
ACTACTV=value
specifies whether the accounting
function is activated.
Value | Explanation |
---|---|
ON |
An accounting record is written with each terminal I/O. |
OFF |
No accounting record is written.
This is the default value. |
This keyword subparameter only applies to the accounting function.
ACTAHDR=value
defines the header for the
accounting records if written to the IMS log file. This keyword subparameter is only
evaluated if the ACTLOG
keyword subparameter is set to CMD
.
Value | Explanation |
---|---|
1 - 8 characters | A header name. |
SAG$$$$$ |
This is the default value. |
This keyword subparameter only applies to the accounting function.
ACTARID=value
specifies the accounting record
ID if the accounting record is written using the LOG
or SMF
settings of the ACTLOG
keyword subparameter.
Value | Explanation |
---|---|
A0 - FF |
The log code if ACTLOG is set to
LOG .
|
128 - 255 |
The number of the SMF record type if ACTLOG is
set to SMF .
|
Note:
There is no default value.
This keyword subparameter only applies to the accounting function.
ACTLOG=value
specifies how accounting records
are written.
Value | Explanation |
---|---|
CMD |
Accounting records are written to the IMS log file using the
CMD call.
This is the default value. |
LOG |
Accounting records are written to the IMS log file using the
LOG call.
|
SMF |
Accounting records are written to SMF using the Authorized Services Manager (see the TP Monitor Interfaces documentation). |
BMPABER=value
specifies how a BMP run should be
terminated if either a Natural runtime error or a Natural IMS TM Interface
non-recoverable error occurs.
Value | Explanation |
---|---|
ON |
The BMP run is terminated with user abend code U3521. |
OFF |
The BMP run is terminated normally with the Natural
termination error as the condition code. If the BMP run is terminated with a
non-recoverable Natural IMS TM Interface error, condition code
1024 is set.
This is the default value. |
This keyword subparameter only applies in dialog-oriented environments.
BROACTV=value
enables or disables the
broadcasting function.
Value | Explanation |
---|---|
ON |
The broadcasting function is enabled |
OFF |
The broadcasting function is disabled.
This is the default value. |
CMBSIZE=value
specifies the size of the command
buffer.
The command buffer is used by the application programming interfaces NIICMD
and
NIIGCMD
, the service module CMCMMND
and
the accounting function. For details, see the TP Monitor Interfaces
documentation.
The size of the command buffer must accommodate the maximum length of the IMS commands to be processed and the maximum length of the accounting record including the user extension.
Value | Explanation |
---|---|
100 – 16777216 |
A buffer size in KB. |
1024 |
This is the default value. |
COLPSCR=value
specifies the number of columns
per screen.
Value | Explanation |
---|---|
35 – 250 |
A screen width. |
80 |
This is the default value. |
ENDMODN=value
specifies the MOD
name
to be used for formatting the screen which appears after a Natural
session is terminated successfully. ENDMODN
enables Natural to be included
in a customer-specific menu.
The value of ENDMODN
can be overridden by the application programming
interface NIIEMOD
and the service module CMEMOD
. For
details, see the TP Monitor Interfaces documentation.
If a Natural session terminates with an error, DFSMO2
is always used to
issue the appropriate Natural error message.
Value | Explanation |
---|---|
1 - 8 characters | A valid MOD name .
|
DFSMO2 |
This is the default value. |
ENTRYNM=value
identifies the current
environment-specific parameter set.
Value | Explanation |
---|---|
1 - 8 characters | The name of the environment parameter set currently used. |
ENV00000 |
This is the default value. |
ERRLHDR=value
specifies the header of the IMS
TM log records which are written when errors occur in the Natural IMS TM Interface.
If you do not wish a message to be written to the IMS TM log in the case of a
non-recoverable Natural IMS TM Interface error, explicitly set ERRLHDR
to
null, that is, specify ERRLHDR=,
.
For further information, see Recovery Handling in the TP Monitor Interfaces documentation.
Value | Explanation |
---|---|
1 - 8 characters | A header name. |
NIIERR$$ |
This is the default value. |
HCBSIZE=value
specifies the size of the
hardcopy print buffer.
Records which are sent to a printer destination using the Natural hardcopy function are buffered.
Value | Explanation |
---|---|
0 – 16777216 |
A buffer size in KB. |
1024 |
This is the default value. |
HDENSDU=value
specifies whether a snap dump
provoked by a Natural IMS TM Interface error is to be written as a high-density dump to
a 3800 printing subsystem.
Value | Explanation |
---|---|
ON |
A high-density dump is written. |
OFF |
No high-density dump is written.
This is the default value. |
LINPSCR=value
defines the number of lines per
screen.
Value | Explanation |
---|---|
1 – 250 |
A screen size. |
24 |
This is the default value. |
MISIZE=value
specifies the size of the buffer
which is to contain the input message.
This area must be as large as the largest input message to be received from IMS TM.
Value | Explanation |
---|---|
100 – 16777216 |
A buffer size in KB. |
4096 |
This is the default value. |
This keyword subparameter only applies in dialog-oriented environments.
MONACTV=value
enabled or disables the
monitoring function. If enabled, the session status is written to the SIP server at each
terminal I/O. If disabled, no session status is maintained.
Value | Explanation |
---|---|
ON |
The monitoring function is enabled. |
OFF |
The monitoring function is disabled.
This is the default value. |
MOSIZE=value
specifies the size of the buffer
which is to contain the output message. This area must be as large as the largest output
message to be sent to IMS TM.
Value | Explanation |
---|---|
2048 - 16777216 |
A buffer size in KB. |
4096 |
This is the default value. |
PRTDRIV=value
specifies the print driver to be
used for reports which are directly written to an IMS TM printer.
For further information, see Support of the Natural WRITE (n) Statement in the TP Monitor Interfaces documentation.
Value | Explanation |
---|---|
driver-name |
A driver name as listed in the following tables:
Drivers for SCS
Printers |
SCS_S2 |
This is the default value. |
- Drivers for SCS Printers
Driver Purpose SCS_B1
Form feed at start and end of report, starts page on line 1. SCS_B2
Form feed at start and end of report, starts page on line 2. SCS_E1
Form feed at end of report, starts page on line 1. SCS_E2
Form feed at end of report, starts page on line 2. SCS_N1
No form feed at start or end of report, starts page on line 1. SCS_N2
No form feed at start or end of report, starts page on line 2. SCS_S1
Form feed at start report, starts page on line 1. SCS_S2
Form feed at start of report, starts page on line 2. - Drivers for Non-SCS Printers
Driver Purpose NSCS_B1
Form feed at start and end of report, starts page on line 1. NSCS_B2
Form feed at start and end of report, starts page on line 2. NSCS_E1
Form feed at end of report, starts page on line 1. NSCS_E2
Form feed at end of report, starts page on line 2. NSCS_N1
No form feed at start or end of report, starts page on line 1. NSCS_N2
No form feed at start or end of report, starts page on line 2. NSCS_S1
Form feed at start report, starts page on line 1. NSCS_S2
Form feed at start of report, starts page on line 2. - Drivers for JES API
Driver Purpose JES
The following data set processing options for JES are taken from the corresponding NTPRINT
macro parameters orDEFINE PRINTER
statement (see the Statements documentation) options:JES
NTPRINT
DEFINE PRINTER
CLASS
CLASS
CLASS
COPIES
COPIES
COPIES
DEST
DEST
OUTPUT
FORMS
FORMS
FORMS
NAME
NAME
NAME
OUTDISP
DISP
DISP
PRTY
PRTY
PRTY
The generated JES API parameter string is:
IAFP=A0M,PRTO=..OUTDI(disp),DES(dest), CLA(class,COP(copies), FORMS(forms),NAME(name), PRTY(prty)Note:
UnspecifiedNTPRINT
/DEFINE PRINTER
parameters/options are ignored.JES xxxxx The data set processing options for JES are taken from the OUTPUT JCL
statement with the nameJESxxxxx
wherexxxxx
can be up to 5 characters.The generated JES API parameter string is:
IAFP=A0M,OUTN=JESxxxxxThe
OUTPUT JCL
statement may look like:JESxxxxx OUTPUT OUTDISP=WRITE,DEST=dest, CLASS=A,COPIES=1,FORMS=form,...Note:
If theOUTPUT JCL
statement is missing in the job stream, an error is reported.
This keyword subparameter only applies in dialog-oriented environments.
ROLLSRV=value
specifies the medium for saving a
Natural thread between terminal output and input.
See also Roll File and Roll Server in the TP Monitor Interfaces documentation.
Value | Explanation |
---|---|
ON |
The Natural roll server is used.
This is the default value. |
OFF |
Roll files are used: see ROLLFN .
|
This keyword subparameter only applies in dialog-oriented environments.
ROLLFN=value
specifies the number of roll files
to be used if ROLLSRV
is
set to OFF
.
Value | Explanation |
---|---|
1 - 5 |
The number of roll files to be used. |
1 |
This is the default value. |
This keyword subparameter only applies in dialog-oriented environments.
SPASIZE=value
specifies the size of the buffer
which is to contain the scratch-pad area.
In a non-conversational environment, this is also the size of the simulated SPA which is written to the SIP server.
Value | Explanation |
---|---|
256 - 16777216 |
A buffer size in KB. |
1024 |
This is the default value. |
SPATID=value
specifies the Natural subsystem ID
for the Authorized Services
Manager (ASM) which is used to save the SPA for a non-conversational
driver. The ASM is described in the Operations documentation.
Value | Explanation |
---|---|
1 - 4 characters | A subsystem ID.
This value must be the same for all
parameter tables and must be the same as the value specified for
|
NAT2 |
This is the default value. |
This keyword subparameter only applies in dialog-oriented conversational environments.
SUPNONC=value
specifies whether switching from
a terminal-oriented non-conversational environment to a conversational environment is
possible.
Value | Explanation |
---|---|
ON |
Switching is allowed. |
OFF |
Switching is not allowed.
This is the default value. |
This keyword subparameter only applies in dialog-oriented environments.
TERMIPL=value
specifies whether a Natural
session is terminated with an error message when an IPL has occurred between the current
transaction step and the start of the session.
Value | Explanation |
---|---|
ON |
The Natural session terminates. |
OFF |
The Natural session does not terminate.
This is the default value. |
THBELOW=value
specifies whether the Natural
thread is allocated below or above the 16 MB line.
Value | Explanation |
---|---|
ON |
The Natural thread is allocated below the 16-MB line.
This is the default value. |
OFF |
The Natural thread is allocated above the 16 MB line. |
THSIZE=value
specifies the size of the Natural
thread. This is the area which contains all Natural buffers that relate to user
sessions.
Value | Explanation |
---|---|
100000 - 99999999 |
A thread size in bytes in multiples of eight greater than or equal to 100000. |
1048576 |
This is the default value. |
This keyword subparameter only applies to the BMP driver.
USERID=value
specifies how the value of the
system variable *INIT-USER
(see the System
Variables documentation) is determined.
Value | Explanation |
---|---|
ON |
The Natural user ID specified in
*INIT-USER is either taken from the security
access control block if a security package is active or from the
USER parameter of the job card.
|
OFF |
The Natural user ID specified in
*INIT-USER is taken from the job name.
This is the default value. |
NTIMSPE ENTRYNM=ENV0021, * ACTACTV=ON, * ACTLOG=LOG, * ACTARID=A1, * PRTDRIV=SCS_E1, * THBELOW=OFF, * THSIZE=1000000, * SPATID=ASM1