IMSPT - Transaction Definitions for Natural IMS TM Interface

#### Search Results

Search

# 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

- Keyword Subparameters

- Example of NTIMSPT Macro

## 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.

## 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.

## Example of NTIMSPT Macro

             NTIMSPT TRAN=MYNAT,PSB=MYPSB

### On this page

- NTIMSPT Macro Syntax
- Keyword Subparameters
- Example of NTIMSPT Macro