IMSPE - Environment Parameters for Natural IMS TM Interface

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:


NTIMSPE Macro Syntax

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,                                           *
               NSBNAME=value,                                          *
               PRTDRIV=value,                                          *
               ROLLSRV=value,                                          *
               ROLLFN=value,                                           *
               SPASIZE=value,                                          *
               SPATID=value,                                           *
               SUPNONC=value,                                          *
               TERMDB=value,                                           *
               TERMIPL=value,                                          *
               THBELOW=value,                                          *
               THSIZE=value,                                           *
               USERID=value

See Keyword Subparameters.

Keyword Subparameters

ACTACTV | ACTAHDR | ACTARID | ACTLOG | BMPABER | BROACTV | CMBSIZE | COLPSCR | ENDMODN | ENTRYNM | ERRLHDR | HCBSIZE | HDENSDU | LINPSCR | MISIZE | MONACTV | MOSIZE | NSBNAME | PRTDRIV | ROLLSRV | ROLLFN | SPASIZE | SPATID | SUPNONC | TERMDB | TERMIPL | THBELOW | THSIZE | USERID

ACTACTV - Activate Accounting

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.

ACTAHDR - Header for Accounting Records

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.

ACTARID - Accounting Record ID

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.

ACTLOG - Write Accounting Records to Log File

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 - Specify Termination Error for BMP Run

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.

BROACTV - Enable/Disable Broadcasting

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 - Command Buffer Size

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 - Number of Screen Columns

COLPSCR=value specifies the number of columns per screen.

Value Explanation
35 – 250 A screen width.
80 This is the default value.

ENDMODN - Format of Termination Screen

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 - Identify Current Environment Parameter Set

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 - Header for IMS TM Error Logs

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 - Size of Hardcopy Print Buffer

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 - High-Density Dump

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 - Number of Screen Lines

LINPSCR=value defines the number of lines per screen.

Value Explanation
1 – 250 A screen size.
24 This is the default value.

MISIZE - Buffer Size for Input Message

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.

MONACTV - Enable/Disable Monitoring

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 - Buffer Size for Output Message

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.

NSBNAME - Use NSB Name of Natural DL/I Interface

NSBNAME=value sets the name of the NSB to the NSB used by the Natural DL/I Interface.

Value Explanation
ON Sets the NSB name to the PSB name defined by the PSB keyword subparameter of the NTIMSPT macro for the transaction code in use.
OFF Sets the NSB name to the PSB name used by IMS TM.

This is the default value.

PRTDRIV - Driver for IMS TM Printer

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
Drivers for Non-SCS Printers
Drivers for JES API

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 or DEFINE 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:
Unspecified NTPRINT/DEFINE PRINTER parameters/options are ignored.

JES xxxxx The data set processing options for JES are taken from the OUTPUT JCL statement with the name JESxxxxx where xxxxx can be up to 5 characters.

The generated JES API parameter string is:

IAFP=A0M,OUTN=JESxxxxx

The OUTPUT JCL statement may look like:

JESxxxxx OUTPUT OUTDISP=WRITE,DEST=dest,
CLASS=A,COPIES=1,FORMS=form,...

Note:
If the OUTPUT JCL statement is missing in the job stream, an error is reported.

ROLLSRV - Natural Thread Storage

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.

ROLLFN - Number of Roll Files

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.

SPASIZE - Buffer Size for Scratch-Pad Area

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 - Subsystem ID for ASM

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 - 5 characters A subsystem ID.

This value must be the same for all parameter tables and must be the same as the value specified for SPATID in the NIMPIXT macro (see the TP Monitor Interfaces documentation).

NAT2 This is the default value.

SUPNONC - Enable/Disable Environment Switching

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.

TERMDB - Session Termination for Missing DL/I Database

This keyword subparameter only applies in dialog-oriented environments.

TERMDB=value specifies whether the Natural session is to be terminated if one of the DL/I databases specified in the PSB is not available.

Value Explanation
ON The Natural session terminates.
OFF The Natural session does not terminate.

If one of the databases is not available when it is accessed, the Natural transaction code is suspended by IMS TM.

This is the default value.

TERMIPL - Session Termination for IPL

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 - Natural Thread Allocation

THBELOW=value specifies whether the Natural thread is allocated below or above the 16 MB line. For batch message processing, the thread is always allocated below 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 - Natural Thread Size

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 multiples of eight greater than or equal to 100000.
1048576 This is the default value.

USERID - Determine *INIT-USER 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.

Example of NTIMSPE Macro

         NTIMSPE ENTRYNM=ENV0021,                                      *
               ACTACTV=ON,                                             *
               ACTLOG=LOG,                                             *
               ACTARID=A1,                                             *
               PRTDRIV=SCS_E,                                          *
               THBELOW=OFF,                                            *
               THSIZE=1000000,                                         *
               SPATID=ASM1