Version 4.2.6
 —  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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

3507

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

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

3522

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

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

3624

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

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

3650

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

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

3672

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

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

3802

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

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

3810

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

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

3814

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

Top of page

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.

Top of page

3816

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

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

3950

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

Top of page

3951

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

Top of page

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.

Top of page

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.

Top of page

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.

Top of page

3963

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

Top of page

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.

Top of page

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.

Top of page

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.

Top of page