
	Version 4.2.6 for Mainframes (Update)	SEARCH INDEX CONTENTS \| PDF PAGE PDF BOOKS \| HOME UP PREV NEXT

— Messages and Codes —

Natural under IMS TM Error Codes

This section lists the error codes and messages that may be issued by the Natural IMS Interface (NII).

Error texts are not issued for errors of the types "abend" and "abend with dump", and not in a server environment. When a server environment is used, the error code is returned to the caller in Register 15.

3500

Type	Abend with user abend code `U3500` with dump
Issuing Module	`CONV/NONC/NTRD` driver
Reason	You are not allowed to execute a driver of type `CONV`, `NONC` or `NTRD` in a BMP region.
Action	Check your installation.

3501

Type	Abend with user abend code `U3501` with dump
Issuing Module	BMP driver
Reason	You are not allowed to execute a driver of type BMP in an MPP region.
Action	Check your installation.

3502

Type	Abend with user abend code `U3502` with dump
Issuing Module	`NIIMPP`
Reason	The GU against the message queue failed.
Action	Check the status code contained in register 15.

3503

Type	Abend with user abend code `U3503` with dump
Issuing Module	All drivers
Reason	Unable to load the Natural IMS interface module.
Action	Check the `NIINAME` parameter of the driver and/or the steplib concatenation of the region.

3505

Type	Abend with user abend code `U3505` with dump
Issuing Module	All drivers.
Reason	The entry within the transaction code table could not be located.
Action	Check your transaction code table.

3506

Type	Abend with user abend code `U3506` with dump
Issuing Module	All drivers.
Reason	The entry within the NII parameter module could not be located.
Action	Check the transaction code table and/or environment table.

3507

Type	Error
Issuing Module	`NIIMPP`
Reason	The GN against the message queue failed.
Action	Check the status code contained in the message.

3508

Type	Error
Issuing Module	`NIIMPP`
Reason	The received input message is greater than the input message buffer.
Action	Increase the size of the input message buffer in your environment table.

3509

Type	Error
Issuing Module	`NIIINITS`
Reason	The session start exit `NIIXSSTA` requested that the Natural session be terminated abnormally.
Action	Check the return code contained in the message.

3510

Type	Abend with user abend code `U3510` with dump
Issuing Module	`NIIMPP`
Reason	The `ISRT` of the termination message failed.
Action	Check the status code contained in Register 15.

3511

Type	Abend with user abend code `U3511` with dump
Issuing Module	`NIIMPP`
Reason	The `ISRT` of the SPA failed.
Action	Check the status code contained in Register 15.

3513

Type	Abend with user abend code `U3513` with dump
Issuing Module	All drivers
Reason	The storage for the working area, the buffers or the Natural thread could not be obtained.
Action	Check the reason code contained in Register 15 and/or increase the size of your region.

3515

Type	Error with dump
Issuing Module	`NIIBTCH`, BMP driver
Reason	Open failed.
Action	Check your BMP JCL for the DD name contained in the message.

3517

Type	Error
Issuing Module	`NIIOLDSN`
Reason	The session resume exit `NIIXSTAR` requested that the Natural session be terminated abnormally.
Action	Check the return code contained in the message.

3518

Type	Abend with user abend code `U3518` with dump
Issuing Module	`NIISRTQ`
Reason	The `CHNG` call for the printer destination specified with the Natural profile parameter `SENDER` failed.
Action	Check the status code contained in Register 15. Probably an invalid printer destination was specified.

3519

Type	Abend with user abend code `U3519` with dump
Issuing Module	`NIIISRTQ`
Reason	The `ISRT` call to the assigned printer destination failed.
Action	Check the status code contained in Register 15.

3520

Type	Abend with user abend code `U3520` with dump
Issuing Module	`NIIISRTQ`
Reason	The `PURG` call for the assigned printer destination failed.
Action	Check the status code contained in Register 15.

3521

Type	Abend with user abend code `U3521` with dump
Issuing Module	BMP driver
Reason	Either Natural terminated with a bad return code or an NII error occurred and you requested an abend.
Action	If the abend is caused by a Natural error, `CMPRINT` contains the error message. If the abend is caused by a Natural under IMS error, a WTO with the error message has been issued before.

3522

Type	Error
Issuing Module	`NIIMPP`
Reason	The SPA is greater than the size specified for the SPA buffer.
Action	Check the environment table.

3523

Type	Error
Issuing Module	`NIIBTCH`
Reason	The storage for the back-end program area could not be allocated.
Action	Check the `TERMINATE` statement and/or increase the size of your BMP region.

3524

Type	Error with dump
Issuing Module	`NIIBTCH`
Reason	The back-end program could not be loaded.
Action	Check the name of the back-end program contained in the message and/or the steplib concatenation of your region.

3525

Type	Abend with user abend code `U3525` with dump
Issuing Module	`NIIDRIV`
Reason	The save area stack is exhausted.
Action	Contact Software AG Support.

3527

Type	Error
Issuing Module	`NIIMPP`
Reason	You specified `RELO=FORCE`, but there is insufficient memory for a new thread. `RELO=FORCE` will cause storage allocation for a second thread, if the first allocated thread is at the same storage location as the thread used before the terminal I/O.
Action	Increase the size of your region.

3530

Type	Abend with user abend code `U3530`
Issuing Module	`NIIBOOTS`, `CONV/NONC` driver
Reason	Unable to obtain our name/token pair.
Action	Check the return code contained in Register 15 and/or the steplib concatenation of your region.

3531

Type	Error
Issuing Module	`NIIBOOTS`
Reason	Unable to load the driver.
Action	Check the return code contained in Register 15 and/or the steplib concatenation of your region.

3600

Type	Error
Issuing Module	`NIIVTRTA`
Reason	Transaction type does not match driver type. For example, you specified transaction code conversational in the transaction code table but the driver type is non-conversational and vice versa.
Action	Check the transaction code table.

3601

Type	Error
Issuing Module	`NIIVTRTA`
Reason	The SPA is too small. The SPA must be at least 157 bytes plus the offset of the Natural reserved area defined in the transaction table.
Action	Check the transaction code table and/or increase the size of the SPA.

3602

Type	Error
Issuing Module	`NIIVTRTA`
Reason	IOPCB is the only PCB in the PSB. At least one additional PCB is required.
Action	Check your PSB.

3604

Type	Error
Issuing Module	`NIIVTRTA`
Reason	Not enough alternate TP PCBs. The PSB does not contain the number of alternate modifiable TP PCBs specified in the transaction code table as additional work PCBs.
Action	Check your transaction code table and/or your PSB.

3605

Type	Error
Issuing Module	`NIIVTRTA`
Reason	Message PCB is not a modifiable alternate TP PCB. You specified a separate message PCB in the transaction code table, but your PSB does not contain enough modifiable alternate TP PCBs.
Action	Check your transaction code table and/or your PSB.

3607

Type	Error
Issuing Module	`NIIVTRTA`
Reason	The PCB number specified for the logical PCB name is greater than the maximum number of PCBs.
Action	Check your transaction code table and/or your PSB for the PCB name contained in the message.

3611

Type	Error
Issuing Module	`NIIINITS`
Reason	The user exit `NIIXRFNU` returned a roll file number not in the range of 1 to the total available number of roll files as defined in the environment table, that is, larger than the total number of allowed roll files.
Action	Correct the user exit.

3612

Type	Error with dump
Issuing Module	`NIIDRIV`
Reason	The roll server `ALLOC` request failed. The message contains the return code/reason code.
Action	Contact Software AG Support.

3613

Type	Error
Issuing Module	`NIIDRIV`
Reason	The roll server `ALLOC` request failed because the roll file is full.
Action	Increase the size of the roll file or increase the number of roll files.

3614

Type	Error
Issuing Module	`NIIDRIV`, `NIIOLDSN`, `NIIENDSN`, `NIIWTERM`
Reason	The roll server is not active.
Action	Check the roll server status and restart the roll server.

3620

Type	Error with dump
Issuing Module	`NIIOLDSN`
Reason	Error during address relocation. The message contains the `NATRELD` return code.
Action	Contact Software AG Support.

3621

Type	Error
Issuing Module	`NIIOLDSN`
Reason	An IPL has occurred since the start of the Natural session and `TERMIPL=YES` is specified in the environment table.
Action	Restart your session.

3623

Type	Error
Issuing Module	`NIIOLDSN`
Reason	Another Natural product version has been installed by the Natural system administrator since the start of the Natural session. All active Natural sessions are terminated.
Action	Restart your session.

3624

Type	Error with dump
Issuing Module	`NIIOLDSN`
Reason	A wrong user thread has been rolled in.
Action	Contact Software AG Support.

3626

Type	Error
Issuing Module	`NIIOLDSN`
Reason	The roll files used by the roll server have been reformatted by the Natural system administrator since the start of the Natural session. All active Natural sessions are lost.
Action	Restart your session.

3627

Type	Error with dump
Issuing Module	`NIIOLDSN`
Reason	The roll server `READ` request failed. The message contains the return code/reason code.
Action	Contact Software AG Support.

3628

Type	Error
Issuing Module	`NIIDRIV`, `NIIOLDSN`, `NIIENDSN`, `NIIWTERM`
Reason	The Natural system administrator has purged the Natural session from the roll server using the `SYSTP` utility or the application programming interface `USR3002N`. This error may also occur in the following scenario: A Natural session has been suspended by IMS TM (due to an unavailable resource) and you have started a new Natural session at the same LTERM. If later on the suspended Natural session is re-scheduled by IMS TM, the suspended Natural session is cancelled with this error.
Action	Restart your session.

3629

Type	Error
Issuing Module	`NIIOLDSN`
Reason	The IMS TM user who is currently logged on at the IMS TM LTERM is different to the user who started the IMS TM conversation at this LTERM. For security reasons, the IMS TM conversation (and the corresponding Natural session) is terminated.
Action	Restart your session.

3630

Type	Error
Issuing Module	`NIIMSESS`
Reason	The MSPCB specified in the transaction code table does not address the multiple-session database.
Action	Check your transaction code table and/or your PSB.

3631

Type	Error with dump
Issuing Module	`NIIMSESS`
Reason	Access to the multiple-session database failed.
Action	Check the status code contained in the message.

3632

Type	Error with dump
Issuing Module	`NIIMSESS`
Reason	The entry for the transaction code to be resumed could not be found in the transaction code table.
Action	Contact Software AG Support.

3633

Type	Error with dump
Issuing Module	`NIIMSESS`
Reason	The `ISRT` call for the SPA or the message failed.
Action	Check the status code contained in the message.

3634

Type	Error with dump
Issuing Module	`NIIMSESS`
Reason	The `CHNG` call for the transaction code to be resumed failed.
Action	Check the status code contained in the message and/or contact Software AG Support.

3635

Type	Error with dump
Issuing Module	`NIIMSESS`
Reason	The multiple-session prefix could not be built due to an illegal character in the terminal name. Register 2 of the error registers in the dump points to the illegal character.
Action	Check the terminal name and/or use the `NIIXMSSP` exit.

3636

Type	Error with dump
Issuing Module	`NIIMSESS`
Reason	An invalid return code was received from the `NIIXMSSP` exit. Register 2 of the error registers in the dump contains the return code.
Action	Check your exit.

3640

Type	Error with dump
Issuing Module	`NIIPFAM`
Reason	Unexpected status code for the `CHNG` call.
Action	Check the status code contained in the message and/or contact Software AG Support.

3641

Type	Error with dump
Issuing Module	`NIIPFAM`
Reason	Unexpected status code on the `ISRT` call.
Action	Check the status code contained in the message and/or contact Software AG Support.

3642

Type	Error with dump
Issuing Module	`NIIPFAM`
Reason	Unexpected status code on the `PURG` call.
Action	Check the status code contained in the message and/or contact Software AG Support.

3650

Type	Error
Issuing Module	`NIICDBPC`
Reason	Database not available and `TERMDB=YES` is specified in the environment table.
Action	Start the database.

3651

Type	Error
Issuing Module	`NIICDBPC`
Reason	The `PROCOPT` option in the PCB is set to update but the database is not available for update and `TERMDB=YES` is specified in the environment table.
Action	Check the database.

3652

Type	Abend with user abend code `U3652`
Issuing Module	`NIIINQYE`
Reason	The `INQY ENVIRON` call failed. Register 15 contains the return code in bytes 0 and 1 and the reason code in bytes 2 and 3.
Action	Contact Software AG Support.

3661

Type	Error with dump
Issuing Module	`NIIWTERM`
Reason	Error during release of programs. The message contains the `NATRELSE` return code.
Action	Contact Software AG Support.

3662

Type	Error with dump
Issuing Module	`NIIWTERM`
Reason	The `ISRT` call to the alternate PCB for the SPA failed.
Action	Check the status code contained in the message.

3663

Type	Error with dump
Issuing Module	`NIIWTERM`
Reason	The `ISRT` call to the alternate PCB for the message failed.
Action	Check the status code contained in the message.

3664

Type	Abend with user abend code `U3664` with dump
Issuing Module	`NIIWTERM`
Reason	The `ISRT` call for the SPA failed.
Action	Check the status code in Register 15.

3665

Type	Abend with user abend code `U3665` with dump
Issuing Module	`NIIWTERM`
Reason	The `ISRT` call for the message failed.
Action	Check the status code in Register 15.

3666

Type	Error
Issuing Module	`NIIWTERM`
Reason	The current compressed thread size exceeds the maximum slot size defined for the roll file. The message contains the slot size in bytes required for the roll file. Note: This message arises only if roll files are used, that is, if the `NIMPARM` parameter `ROLLSRV=NO` is set.
Action	Increase the slot size of your roll file.

3668

Type	Error with dump
Issuing Module	`NIIWTERM`
Reason	Roll server `WRITE` request failed. The message contains the return code/reason code.
Action	Contact Software AG Support.

3669

Type	Error
Issuing Module	`NIIWTERM`
Reason	You tried to switch to a non-Natural session using a Natural transaction code.
Action	Correct the application.

3670

Type	Error
Issuing Module	`NIIWTERM`
Reason	You can not switch directly from a non-conversational transaction code to a conversational one.
Action	Correct the application.

3671

Type	Error with dump
Issuing Module	`NIIWTERM`
Reason	The `CHNG` call for the transaction switch failed. The message contains the first five bytes of the transaction code and the status code.
Action	Check the status code and/or correct the application.

3672

Type	Error
Issuing Module	`NIIWTERM`
Reason	Direct switch to a non-existent transaction code.
Action	Check your transaction code or IMSGEN.

3673

Type	Abend with user abend code `U3673` with dump
Issuing Module	`NIIWTERM`
Reason	Deferred switch to a non-existent transaction code.
Action	Check your transaction code or IMSGEN.

3680

Type	Error
Issuing Module	`NIISIPSS`
Reason	The subsystem entry for SPATID could not be located. The message contains the subsystem ID as specified in the environment table.
Action	Check your subsystem in your environment table and/or verify that the Authorized Services Manager is started.

3682

Type	Error
Issuing Module	`NIISIPSS`
Reason	The session information pool (SIP) is full.
Action	Restart the Authorized Services Manager with an increased number of SIP slots. For further information, see Authorized Services Manager in the Operations documentation.

3683

Type	Error
Issuing Module	`NIISIPSS`
Reason	The Authorized Services Manager is not active. The Authorized Services Manager must be active if the terminal-oriented non-conversational environment is used.
Action	Start the Authorized Services Manager. For further information, see Authorized Services Manager in the Operations documentation.

3684

Type	Error
Issuing Module	`NIISIPSS`
Reason	The SIP function of the Authorized Services Manager is disabled. The SIP function must be active if the terminal-oriented non-conversational environment is used.
Action	Start the Authorized Services Manager with the SIP function enabled as described in the section Authorized Services Manager in the Operations documentation.

3685

Type	Error with dump
Issuing Module	`NIISIPSS`
Reason	The Authorized Services Manager SIP function failed. The message contains the return and the reason code.
Action	For further information on the return/reason codes see the section Authorized Services Manager in the Operations documentation. If necessary, contact Software AG Support.

3686

Type	Error
Issuing Module	`NIISIPSS`
Reason	The size of the SPA buffer is greater than the SIP slot size.
Action	Increase the SIP slot size as described in the section Authorized Services Manager in the Operations documentation.

3690

Type	Error
Issuing Module	`NIIDRIV`, `NIIOLDSN`, `NIISIPSM`
Reason	The subsystem entry could not be located. The message contains the subsystem ID as specified with the Natural profile parameter `SUBSID`.
Action	Check your subsystem in the `NATPARM` parameter module and/or verify that the roll server or (only if monitoring is used) the Authorized Services Manager is started.

3692

Type	Error with dump
Issuing Module	`NIIENDSN`
Reason	The roll server `FREE` request failed. The message contains the return code/reason code.
Action	Contact Software AG Support.

3800

Type	Error with dump
Issuing Module	`NIIBDAMR`
Reason	DCB not allocated for one of the roll files. The message contains the DD name of the roll file.
Action	Contact Software AG Support.

3801

Type	Error
Issuing Module	`NIIBDAMR`
Reason	The `OPEN` of the roll file failed.
Action	Check your region JCL for the DD name contained in the message.

3802

Type	Error with dump
Issuing Module	`NIIBDAMR`
Reason	Invalid function code for `NIIBDAMR`.
Action	Contact Software AG Support.

3803

Type	Error
Issuing Module	`NIIBDAMR`
Reason	No free slot in roll file. The message contains the DD name of the roll file.
Action	Increase the size of your roll file.

3804

Type	Error
Issuing Module	`NIIBDAMR`
Reason	The roll file has been reformatted by the Natural system administrator since the start of the Natural session. All active Natural sessions are lost.
Action	Restart the session.

3805

Type	Error
Issuing Module	`NIIBDAMR`
Reason	The roll file has been formatted with a Natural version that is incompatible to the Natural version used by the current Natural session. This error typically indicates that the roll file has been formatted with a Natural roll file initialization module of a newer Natural version.
Action	Reformat the roll file with the Natural roll file initialization module of the correct Natural version.

3810

Type	Error with dump
Issuing Module	`NIISEOS`
Reason	The `CHNG` call failed.
Action	Check the status code contained in the message.

3811

Type	Error
Issuing Module	`NIISEOS`
Reason	You tried to switch from a non-conversational Natural session to a conversational one.
Action	Check your application.

3812

Type	Error with dump
Issuing Module	`NIISEOS`
Reason	The `ISRT` call for the message into the alternate PCB failed.
Action	Check the status code contained in the message.

3813

Type	Error with dump
Issuing Module	`NIISEOS`
Reason	The `ISRT` call for the SPA into the alternate PCB failed.
Action	Check the status code contained in the message.

3814

Type	Error
Issuing Module	`NIISEOS`
Reason	The `ISRT` call for the dummy message failed.
Action	Check the status code contained in the message.

3815

Type	Abend with user abend code `U3815` with dump
Issuing Module	`NIISEOS`
Reason	The `ISRT` call for the SPA into the IOPCB failed.
Action	Check the status code contained in Register 15.

3816

Type	Error
Issuing Module	`NIISEOS`
Reason	You tried to switch to a non-existent transaction code.
Action	Check your transaction code or IMSGEN.

3820

Type	Error
Issuing Module	`NIISIPSM`
Reason	The Authorized Services Manager is not active. The Authorized Services Manager must be active if the monitoring function is used.
Action	Start the Authorized Services Manager as indicated in the section Authorized Services Manager in the Operations documentation.

3821

Type	Error
Issuing Module	`NIISIPSM`
Reason	The SIP function of the Authorized Services Manager is disabled. The SIP function must be active if the monitoring function is used.
Action	Start the Authorized Services Manager with the enabled SIP function as indicated in the section Authorized Services Manager in the Operations documentation.

3822

Type	Error with dump
Issuing Module	`NIISIPSM`
Reason	An unexpected return code was received from the SIP function of the Authorized Services Manager. The message contains the return code and the reason code.
Action	For the return codes, see the section Authorized Services Manager in the Operations documentation. If necessary, contact Software AG Support.

3823

Type	Error
Issuing Module	`NIISIPSM`
Reason	The SIP server pool is full.
Action	Increase the number of SIP slots in the Authorized Services Manager as indicated the section Authorized Services Manager in the Operations documentation.

3830

Type	Abend with user abend code `U3830` with dump
Issuing Module	`NIIACT`
Reason	The `CMD` command failed when issuing the `/LOG` command to write the accounting record. The transaction code must be authorized to use the `/LOG` command when `ACTLOG=LOG` is set for accounting.
Action	Check the status code contained in Register 15.

3831

Type	Abend with user abend code `U3831` with dump
Issuing Module	`NIIACT`
Reason	The `/LOG` command failed when writing the accounting record.
Action	Check the status code contained in Register 15.

3832

Type	Abend with user abend code `U3832` with dump
Issuing Module	`NIIACT`
Reason	The Authorized Services Manager failed when writing the accounting record to SMF.
Action	Check the status/reason code contained in Register 15.

3950

Type	Error with dump
Issuing Module	`NIIESTAE`
Reason	A system abend code has been intercepted.
Action	Examine the dump.

3951

Type	Error with dump
Issuing Module	`NIIESTAE`
Reason	A recursive system abend code has been intercepted.
Action	Examine the dump.

3960

Type	Error
Issuing Module	`CMGETMSG`, `NIGETMSG`
Reason	The retrieved message exceeds the specified size of the input message buffer.
Action	Increase the size of your input message buffer.

3961

Type	Error
Issuing Module	`CMGETSEG`, `CMGSEGO`
Reason	The segment received does not fit into the input message buffer.
Action	Increase the size of the input message buffer.

3962

Type	Abend with user abend code `U3962`
Issuing Module	`CMSVC13D`, `NIIU3962`
Reason	The Natural session has been abended on request.
Action	Contact the application developer.

3963

Type	Error
Issuing Module	`CMSTCKSY`
Reason	The synchronized `STCK` value could not be obtained.
Action	Contact the system administrator.

3970

Type	Error
Issuing Module	`NIIOLDSN`
Reason	`COMPOSE` has issued a terminal I/O and the Natural nucleus has been displaced.
Action	When using `COMPOSE`, put the Natural nucleus into the (E)LPA or use a dedicated region and put the Natural nucleus into the preload list.

3971

Type	Error
Issuing Module	`NIIOLDSN`
Reason	`COMPOSE` has issued a terminal I/O and the Natural thread has been displaced.
Action	When using `COMPOSE`, use a dedicated region and do not specify `RELO=FORCE`.

4093

Type	Error with dump
Issuing Module	`NIIERROR`
Reason	An unknown error has occurred. The message contains the original error number. This error may happen if the reported error number is not contained in the error message file `NIIMSGT`.
Action	Contact Software AG Support.

SEARCH INDEX CONTENTS | PDF PAGE PDF BOOKS | HOME UP PREV NEXT