Natural for Mainframes Version 8.2.5 for Mainframes
 —  Parameter Reference  —

IMSPT - Transaction Definitions for Natural IMS TM Interface

This Natural profile parameter can only be specified with the NTIMSPT macro, dynamic parameter specification is not possible yet.

The NTIMSPT macro is required to define the transaction code for each Natural transaction, along with individual transaction parameters. The keyword subparameters TRAN and PSB must be explicitly specified; there are no default value settings.

Possible settings See below.
Default setting See below.
Dynamic specification no
Specification within session no

This section covers the following topics:


NTIMSPT Macro Syntax

The NTIMSPT macro is specified as follows:

         NTIMSPT ALTPCB=value,                                         *
               ENVPID=value,                                           *
               HCPCB=value,                                            *
               MSGPCB=value,                                           *
               NRAST=value,                                            *
               PCBS=value,                                             *
               PSB=value,                                              *
               TRAN=value,                                             *
               TYPE=value,                                             *
               WRKPCBS=value

See Keyword Subparameters.

Top of page

Keyword Subparameters

ALTPCB | ENVPID | HCPCB | MSGPCB | NRAST | PCBS | PSB | TRAN | TYPE | WRKPCBS

ALTPCB - Alternate TP PCB

ALTPCB=value determines the alternate TP PCB to be used for the service modules CMQUEUE, CMQUEUEX, NIIDQUMS and NIIDPURG (see the TP Monitor Interfaces documentation).

The specified number can be overwritten by the service modules.

Value Explanation
1 - 255 The number of the alternate TP PCB to be used.
1 This is the default value.

ENVPID - Specify Environment Parameter Set

ENVPID=value specifies the environment parameter set to be used in the transaction code table.

Value Explanation
1 - 8 characters The name of the environment parameter set as defined by the ENTRYNM keyword subparameter in the NTIMSPE macro.
ENV00000 This is the default value.

HCPCB - PCB for Hardcopy

HCPCB=value specifies the PCB number to be used for the hardcopy print function.

Value Explanation
SYSPCB The first alternate TP PCB is used.

This is the default value.

WRKPCB One of the additional alternate TP PCBs is used. This enables you to use an express TP PCB for the hardcopy function.

MSGPCB - Message Print PCB

This parameter only applies to message-oriented environments and the server driver.

MSGPCB=value specifies the PCB to be used for printing error messages and standard output in a message-oriented environment and the server driver.

Value Explanation
SYSPCB The first alternate TP PCB is used.

This is the default value.

OWNPCB The second alternate TP PCB is reserved and used. This enables you to use an express TP PCB for sending messages.

NRAST - Natural Offset within Scratch Pad Area

NRAST=value defines the offset of the Natural Reserved Area (NRA) within the IMS TM scratch-pad area.

The current length of the NRA is 157 bytes. The length of the NRA can change with the next version of the Natural IMS TM Interface.

Note:
If you want to save your own information in the SPA in order to pass it to a non-Natural transaction, we recommended that you save your data in front of the NRA in order to be version compatible.

Value Explanation
16 - 32600 The offset of the NRA within the scratch-pad area.
16 This is the default value.

PCBS - PCB Name Assignment

PCBS=(pcb-1,num-1,pcb-2,num-2,...) is used to assign a logical name to a PCB.

Value Explanation
pcb-n

(1 - 8 characters)

pcb-n specifies the logical name of the PCB.
1-255 This parameter is optional.

num-n specifies the positional number of the PCB in the PSB. If not specified, the sequence number of the PCB in the parameter list is used.

Note:
There is no default value.

PSB - PSB Name of IMS TM Transaction

PSB=value defines the name of the PSB used by the IMS TM transaction. The PSB name is used to identify the entry in the IMS TM transaction code table for non-message-driven batch message processing and for batch environment.

Value Explanation
1 - 8 characters The PSB name that corresponds to the current transaction code. The PSB name must comply with the naming conventions IMS TM uses in the APPLCTN macro.

There is no default value.

TRAN - IMS TM Transaction Code

TRAN=value specifies the IMS TM transaction code.

The transaction code is ignored in non-message-driven BMP and batch processing environments.

Value Explanation
1 - 8 characters A transaction code. The code must comply with the naming conventions IMS TM uses in the TRANSACT macro.

There is no default value.

TYPE - Natural Transaction Type

TYPE=value defines the type of Natural transaction.

Value Explanation
CONV Conversational Natural session.

This is the default value.

NONC Non-conversational Natural session.
SFE Natural Development Server and/or Natural Web I/O Interface server session.

WRKPCBS - Number of Alternate PCBs for Printing

WRKPCBS=value specifies the number of alternate TP PCBs used for printing in addition to the first TP PCB and, if appropriate, to the MSGPCB.

Value Explanation
0 No IMS TM printer is available.

This is the default value.

1 - 32 The number of alternate TP PCBs used for printing.

Example 1:

MSGPCB=SYSPCB
WRKPCBS=2

The PSB must contain 3 alternate TP PCBs.

Example 2:

MSGPCB=OWNPCB
WRKPCBS=2

The PSB must contain 4 alternate TP PCBs. The second alternate TP PCB is reserved for the error messages and standard output of the message-oriented environment.

Top of page

Example of NTIMSPT Macro

         NTIMSPT TRAN=MYNAT,PSB=MYPSB

Top of page