Natural under IMS TM - Configuration Macros

In case of CONV, a dialog-oriented conversational environment is generated.

You can also use this interface in the DLIBATCH environment.

In case of YES, the IBM Language Environment is initialized and remains so until the Natural IMS front-end returns to the IMS program controller.

LE-conforming 3GL programs are called according to the LE calling conventions. While the LE program has control, user written or language-specific condition handlers are honored.

Specifies the z/OS subpool number for the STORAGE OBTAIN requests. Any valid z/OS task-related subpool number for a problem state program (0 – 127) can be used.

Note:
If you operate an earlier version of the Natural IMS TM interface in the same IMS TM dependent region, you should not use the subpool numbers 126 and 127.

• TRNCODE parameter on the first card of the BPM CONTROL file,

• TRNCODE parameter of the NIMBOOT macro,

• TRNCODE startup parameter of the server environment.

• the Natural/IMS THSIZE parameter is ignored by all except for the first Natural session in an MPP,

• RELO=FORCE is disabled,

• the storage for the Natural thread remains allocated until the MPP is stopped.

Note:
This parameter should only be used by customers using Con-form.

In case of YES, an accounting record is written with each terminal I/O.

log code

or

SMF record type

Specifies the accounting record ID if the accounting record is written using the LOG or SMF settings of the ACTLOG parameter.

BMPABER specifies how a BMP run should be terminated if either a Natural runtime error or a Natural IMS interface non-recoverable error occurs.

In case of YES, the BMP run is abended with user Abend Code U3521.

The command buffer is used by the service APIs NIICMD and NIIGCMD, the service module CMCMMND and the Accounting function.

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.

Enables Natural to be included in a customer-specific menu.

The value of the ENDMODN parameter can be overridden by the service API NIIEMOD and the service module CMEMOD.

If a Natural session terminates with an error, DFSMO2 is always used to issue the appropriate Natural error message.

If you do not wish a message to be written to the IMS log in the case of a non-recoverable Natural IMS error, set the ERRLHDR parameter explicitely to null, that is, specify ERRLHDR=,.

For further information, see Recovery Handling.

In case of YES, the session status is written to the SIP server at each terminal I/O.

If MSCMPTB=YES, MSCRKEY must be set to NONE.

Drivers for SCS Printers
Drivers for Non-SCS Printers
Drivers for JES API

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.

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.

Used in dialog-oriented environments only.

See also Roll File and Roll Server in Natural under IMS TM - Components.

Any numeric value up to 16 MB is possible.

Used in dialog-oriented environments only.

If you set TERMDB to NO and one of the databases is not available when it is accessed, the Natural transaction code is suspended by IMS TM.

In case of SYSPCB, the first alternative TP PCB is used.

In case of SYSPCB, the first alternative TP PCB is used.

If NO is specified, the multi-session feature is not used.

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

In case of 0, no IMS printer is available.

Specifies whether a user-specific physical input edit routine is to be called if the NIMPIXT macro does not find the SPA.

If a user-specific input edit routine is to be called, specify the name of the routine.

TYPE specifies the type of the interface module to be generated.

With TYPE=SERVER, the server call interface NIIBOOTS is generated.

This parameter specifies the name of the front-end module.

If TYPE=SERVER is specified, the front-end module must have been generated for the server environment (NIMDRIV parameter TYPE=SRVD). If no TYPE is specified the front-end module must have been generated for the message-oriented environemt (NIMDRIV parameter TYPE=NTRD).

This parameter is only used by the bootstrap module for the message-orineted environment (TYPE is empty).

This parameter specifies the name of the environment table. This parameter is optional. If it is not specified, the environment table is determined by the entry in the transaction code table which corresponds to the transaction code used.

This parameter is only used by the bootstrap module for the message-orineted environment (TYPE is empty).

This parameter specifies the name of the transaction code which is internally used by the Natural IMS interface. This parameter is optional and is only honored if TRNCODE=YES is coded in the NIMDRIV macro. If it is not specified or if TRNCODE=YES is not specified in the NIMDRIV macro, the transaction code returned by the IMS TM INQY call is used.

The transaction code is used to determine the entry in the transaction code table NIITRTAB.

This parameter is only used by the bootstrap module for the message-oriented environment (TYPE is empty).

This parameter is used to define a valid string of up to 80 characters of Natural dynamic parameters.

This parameter specifies the name of the server environment. It is only relevant if you want to use several Natural servers in the same region. In this case, you must generate multiple server call interfaces and specify a unique name with SERVERN for each each of them. See Special Functions, Server Environment.