Version 4.2.6 for Mainframes (Update)
 —  Messages and Codes  —

Natural under CICS Messages


Natural under CICS Abend Codes and Error Messages

This section contains the abend codes, SCP environment initialization errors, SCP environment recovery errors, SCP processing errors and the Natural CICS interface session errors issued by the Natural CICS teleprocessing interface.

Unlike Natural system messages, the explanatory long texts to these messages and codes are only available in this document, not online.

This section covers the following topics:

The abend codes and corresponding error messages of the Natural CICS interface are listed groups in the following order:

NInn SCP environment initialization errors
NRnn SCP environment recovery errors
NSnn SCP processing errors
NTnn  Natural under CICS session errors

The Natural System Control Program (SCP) is part of the Natural CICS Interface. A dump is taken for most of the SCP failures.

Note:
All messages included in this document actually appear in mixed case format.

SCP Environment Initialization Errors

NIAB - INIT, ABEND xxxx DURING INITIALIZATION
Expl. CICS transaction abend xxxx occurred during system environment initialization.
Actn. Check the abend code and correct the error or print the dump and contact Software AG Support.
 
NIAD - xxxxxxxx, ABEND xxxx IN ADABAS LINKAGE ROUTINE
Expl. At system initialization, CICS transaction abend xxxx occurred in the Adabas linkage module xxxxxxxx that was specified via the Natural profile parameter ADANAME (see the Natural Parameter Reference documentation).
Actn. Check the Adabas documentation and correct the error or print a dump and contact Software AG Support.
 
NI01 - INIT, NO STORAGE FOR DIRECTORY EXTENSION (eeeeeeee)
Expl. At system initialization, the EXEC CICS GETMAIN command for the system directory extension has failed due to a CICS storage bottleneck, eeeeeeee being the CICS error condition.
Actn. Increase CICS dynamic storage.
 
NI02 - INIT, NO VALID THREADS
Expl.

At system initialization, the system is inoperational because all thread groups are of TYPE=SHR, but there are no valid threads.

a) The thread group definitions are setup incorrectly.

b) In CICS versions prior to CICS TS: The GETMAIN/GETVIS requests for TYPE=SHR threads have failed.

c) In CICS Transaction Server systems: The EXEC CICS GETMAIN SHARED requests for TYPE=SHR thread have failed.

Actn.

a) Check the thread group definitions by the NCMTGD macro in the system directory and make sure that enough storage is available in OSCOR/GETVIS or the relevant CICS (E)DSA to satisfy all TYPE=SHR thread GETMAIN requests.

b) Increase OSCOR/GETVIS storage.

c) Increase the relevant CICS (E)DSA.

 
NI03 - INIT, NO CICS ROLL FACILITY AVAILABLE
Expl. At system initialization, the system has TYPE=SHR or TYPE=GETM thread groups, but no CICS roll facilities are available for these and it has been defined that the NCI system is not to use the Natural Roll Server.
Actn. If VSAM RRDS roll files are to be used:

a) Check if the VSAM RRDS roll files are allocated (IDCAMS DEFINE CLUSTER) and formatted correctly (NATSCPRI program).

b) Check if the VSAM RRDS roll files are defined correctly in the CICS start-up JCL and in the CICS FCT.

c) Check if the VSAM RRDS roll files are supported at all (ROLLFLS parameter in the NCMPRM macro).

d) Check if the VSAM RRDS roll file names are consistent with the Natural under CICS definition (PREFIX parameter of the NCMPRM macro). If CICS auxiliary temporary storage is to be used:

e) Check if the TS CI-SIZE is greater/equal 4K and if the DFHTEMP data set is defined in the CICS start-up JCL. If CICS main temporary storage is to be used:

f) Make CICS main temporary storage available as roll facility by specifying a non-zero value in the TSRECSZ in the NCMDIR macro.

 
NI04 - INIT, ROLL/SIP SERVER SUBSID xxx MISSING/NOT ACTIVE
Expl. At system initialization: The Natural CICS environment has been specified to use SIP server and/or roll server (CICSPLX=YES or SIPSERV=YES or ROLLSRV=YES in NCISCPCB), but no valid Natural profile parameter SUBSID has been specified, or the specified subsystem is not active.
Actn. a) Specify a valid subsystem ID using the SUBSID profile parameter.

b) Start a roll server and/or SIP server for the specified subsystem ID.

 
NI05 - INIT, ABORTED BY INIT EXIT xxxxxxxx
Expl. At system initialization, the system initialization exit in NCISTART has aborted the initialization process with return code xxxxxxxx.
Actn. Contact Software AG Support.
 

SCP Environment Recovery Errors

NRAB - RCVR, ABEND xxxx DURING DIRECTORY RECOVERY
Expl. At system recovery, CICS transaction abend xxxx occurred while recovering the system environment.
Actn. Print dump and contact Software AG Support.
 
NR01 - UNABLE TO RECOVER SIR BLOCKS CHAIN
Expl. At session initialization or termination, the session information record (SIR) blocks' forward and/or backward chain is broken and the system cannot recover from this by means of the system control record.
Actn. Print dump and contact Software AG Support.
 
NR02 - THREAD STORAGE OVERFLOW
Expl. At any SCP request with system integrity checking active, the prefix and suffix of a thread are not consistent.
Actn. Print dump and contact Software AG Support.
 
NR03 - THREAD GROUPS (INDEX) FAILURE
Expl. At an SCP request with system integrity checking being active, one of the following has occurred:

a) The thread groups index vector is not consistent with the number of thread groups;

b) the thread groups index does not point to the corresponding thread group;

c) the size of a thread group block is not consistent with its type and definition;

d) the name of a thread group does not match the common system prefix.

Actn. Print dump and contact Software AG Support.
 
NR04 - DIRECTORY EXTENSION FAILURE
Expl. The system directory extension is not consistent with the system directory or its eye catcher does not match the common system prefix.
Actn. Print dump and contact Software AG Support.
 
NR05 - VSAM ROLL FILES (DIRECTORY) FAILURE
Expl. It has been defined that the NCI system is not to use the Natural Roll Server. At an SCP request with system integrity checking being active, one of the following has occurred:

a) The name of a VSAM roll file does not match the common system prefix;

b) the VSAM roll facility RCB slot is not consistent with its online directory bitmap.

Actn. Print dump and contact Software AG Support.
 

SCP Processing Errors

NSAB - SCP, ABEND xxxx DURING SCP PROCESSING
Expl. An abend xxxx occurred during SCP processing.
Actn. Print dump and contact Software AG Support.
 
NSAD - xxxxxxxx, ABEND xxxx IN ADABAS LINKAGE ROUTINE
Expl. During SCP processing, CICS transaction abend xxxx occurred in the Adabas linkage module xxxxxxxx that was specified via the Natural profile parameter ADANAME (see the Natural Parameter Reference documentation).
Actn. Check the Adabas documentation and correct the error or print a dump and contact Software AG Support.
 
NS01 - SCP, GETMAIN FOR IOCB FAILED (eeeeeeee)
Expl. At session initialization, the EXEC CICS GETMAIN command for IOCB storage of a transaction belonging to a TYPE=NONE thread group has failed due to a CICS storage bottleneck, eeeeeeee being the CICS error condition.
Actn. Increase CICS storage or use a thread-bound transaction ID.
 
NS02 - SCP, SYSTEM INITIALIZATION/RECOVERY FAILURE xxxx
Expl. The Natural system environment is not operational due to a failure in a previous system initialization or recovery. xxxx indicates the initialization (NInn) and recovery (NRnn) message code respectively.
Actn. Determine the reason of the failure. Correct the error and load a new copy of the system directory to restart system initialization.
 
NS03 - SCP, BB INVALID DURING ROLL-IN
Expl. At session resumption, the IOCB and BB control block pointers are not consistent or the BB pointed to by IOCB is not in the valid storage range for this session.
Actn. Print dump and contact Software AG Support.
 
NS04 - SCP, IOCB NOT FOUND DURING ROLL-IN
Expl. At session resumption, the IOCB and SIR pointers are not consistent or the IOCB pointer to the session's "old thread" is invalid.
Actn. Print dump and contact Software AG Support.
 
NS05 - SCP, NO THREAD AVAILABLE (eeeeeeee)
Expl.

a) At session initialization or resumption, the EXEC CICS GETMAIN command for thread storage of a

transaction belonging to a TYPE=GETM thread group has failed, eeeeeeee being the CICS error condition.

b) A TYPE=SHR thread group has no valid threads.

c) The thread of a non-relocatable session has gone.

Actn.

a) Increase CICS dynamic storage.

b) and c) Print dump and contact Software AG Support.

 
NS06 - SCP, NO CICS ROLL FACILITY AVAILABLE
Expl. It has been defined that the NCI system is not to use the Natural Roll Server. At session initialization, no CICS roll facility is available for a new Natural session due to one of the following reasons:

a) All VSAM RRDS roll files are full or not available and temporary storage is full or not available;

b) CICS temporary storage auxiliary is full or not available;

c) CICS main temporary storage is not allowed.

Actn. a) Increase the size of the current VSAM RRDS roll file(s) or allocate additional VSAM RRDS roll file(s);

b) make CICS auxiliary temporary storage available as Natural roll facility by establishing CISIZE greater/equal 4K;

c) specify a non-zero value in the TSRECSZ parameter of the NCMDIR macro to allow main temporary storage.

 
NS07 - SCP, THREAD GROUP NOT AVAILABLE
Expl. At session initialization, the TYPE=SHR thread group associated to the current transaction has no valid thread(s).
Actn. Check the thread group definition by the NCMTGD specification in the system directory generation.
 
NS08 - xxxxxxxx, SYSTEM DIRECTORY MISSING/INVALID (eeeeeeee)
Expl. At an SCP request, one of the following has occurred:

a) The EXEC CICS LOAD command for the Natural system directory has failed (no valid PPT entry / directory name incorrect), xxxxxxxx representing the name of the module to be loaded and eeeeeeee being the CICS error condition;

b) the loaded directory module is incorrectly linked;

c) the loaded directory module is not compatible to NCISTART.

Actn. Check by means of CEDF which of the explanations applies:

If a) or b), set up SCP environment correctly;

if c), reassemble NCISCPCB with correct macro library.

 
NS09 - SCP, NO SESSION INFO RECORD AVAILABLE
Expl. At session initialization, one of the following has occurred:

a) the primary SIR block is full and secondary SIR blocks are disallowed;

b) the EXEC CICS GETMAIN command for a secondary SIR block has failed due to CICS storage bottleneck;

c) at session resumption, SIR and restart data are inconsistent.

Actn. a) Increase the primary SIR block (first subparameter of the USERS parameter in the NCMDIR macro) or allow secondary SIR blocks (second subparameter of the USERS parameter in the NCMDIR macro);

b) increase CICS dynamic storage;

c) print dump and contact Software AG Support.

 
NS10 - SCP, COMPRESSION ERROR DURING ROLL-OUT
Expl. At session suspension, one of the following has occurred:

a) The roll file bitmap in the IOCB is exhausted, i.e., more than 128 records are to be written to the roll facility.

b) the size of storage to be rolled out does not fit into the session's VSAM RRDS roll file slot;

c) the size of storage to be rolled out is larger than the session's storage currently allocated.

Actn. If a), redefine the VSAM RRDS or the CICS auxiliary temporary storage size with greater control-interval size;

if b) or c), print dump and contact Software AG Support.

 
NS11 - SCP, BB INVALID DURING ROLL-OUT
Expl. At session suspension, IOCB and BB pointers are not consistent or the BB pointer in the IOCB is not in the valid storage range of this session.
Actn. Print dump and contact Software AG Support.
 
NS12 - xxxxxxxx, ROLL-OUT, FC=ffff, RSP=ccc, RSP2=rrr, eeeeeeee
Expl. At session suspension, a roll facility I/O request has failed.

xxxxxxxx - CICS roll facility name

ffff - failing EXEC CICS command (EIB field EIBFN)

ccc - EXEC CICS command response code (EIB field EIBRESP)

rrr - EXEC CICS command reason code (EIB field EIBRESP2)

eeeeeeee - CICS error condition

Actn. Print dump and contact Software AG Support.
 
NS13 - xxxxxxxx, ROLL-IN, FC=ffff, RSP=ccc, RSP2=rrr, eeeeeeee
Expl. At session resumption, a roll facility I/O request has failed.

xxxxxxxx - CICS roll facility name

ffff - failing EXEC CICS command (EIB field EIBFN)

ccc - EXEC CICS command response code (EIB field EIBRESP)

rrr - EXEC CICS command reason code (EIB field EIBRESP2)

eeeeeeee - CICS error condition

Actn. Print dump and contact Software AG Support.
 
NS14 - CNTRL RECORD ACCESS, FC=ffff, RSP=ccc, RSP2=rrr, eeeeeeee
Expl. At session initialization or termination, access to the SCP system control record has failed.

ffff - failing EXEC CICS command (EIB field EIBFN)

ccc - EXEC CICS command response code (EIB field EIBRESP)

rrr - EXEC CICS command reason code (EIB field EIBRESP2)

eeeeeeee - CICS error condition

Actn. Print dump and contact Software AG Support.
 
NS15 - SCP, SYNCHRONIZATION, FC=ffff, RSP=ccc, RSP2=rrr, eeeeeeee
Expl. At session synchronization/serialization, a request as ENQ/DEQ/WAIT EVENT has failed; the following parameters apply:

ffff - failing EXEC CICS command (EIB field EIBFN)

ccc - EXEC CICS command response code (EIB field EIBRESP)

rrr - EXEC CICS command reason code (EIB field EIBRESP2)

eeeeeeee - CICS error condition

Actn. Print dump and contact Software AG Support.
 
NS16 - SCP, NATURAL SESSION LOST
Expl. At session resumption, session data cannot be found, neither in a thread nor in a roll facility.
Actn. Print dump and contact Software AG Support.
 
NS17 - SCP, SYSTEM CONTROL RECORD INVALID
Expl. At session suspension or termination, when trying to release a SIR block, the SCP system control record is inconsistent with the current system.
Actn. Print dump and contact Software AG Support.
 
NS18 - SCP, SYSTEM DIRECTORY EXTENSION MISSING/INVALID
Expl. At an SCP request one of the following has occurred:

a) The system directory has no extension;

b) the directory and its extension are not consistent.

Actn. Print dump and contact Software AG Support.
 
NS19 - SCP, DUPLICATE TERMINAL ID ENCOUNTERED xxxxxxxx
Expl. At Natural session start the Natural CICS interface has detected, that a session for the mentioned terminal ID still/already exists. This message only comes up then DUPTID=NO has been specified in NCIPARM.

a) The existing session is "dead", i.e. a terminal disconnected from CICS without prior session termination, or Natural failed to clean-up properly after an abend.

b) A Natural CICS terminal ID exit generates non-unique logical terminal IDs.

c) CICS regions with identical terminal IDs are sharing the same Natural SIP server and/or roll server.

d) The user's CICS auto-install exit generates non-unique CICS terminal IDs.

Actn.

Specify DUPTID=YES in NCIPARM to make the Natural CICS interface handle these duplicate terminal IDs internally.

a) Use SYSTP E,U to cancel the renegade Natural session.

b) Correct your Natural CICS terminal ID exit.

c) Either provide unique terminal IDs over all CICS regions sharing Natural roll and/or SIP server, or do not share these Natural resources amongst CICS regions with non-unique terminal IDs.

d) Correct your CICS auto-install exit.

 
NS21 - SCP, RELOCATION ERROR FC=ffff, RSP=ccc, RSP2=rrr, eeeeeeee
Expl. At session resumption, the relocation process has failed.

ffff - failing EXEC CICS command (EIB field EIBFN)

ccc - EXEC CICS command response code (EIB field EIBRESP)

rrr - EXEC CICS command reason code (EIB field EIBRESP2)

eeeeeeee - CICS error condition

Actn. Contact Software AG Support.
 
NS22 - SCP, COMPRESSION FAILURE, RSP=nn
Expl. At session suspension, the compression process has failed, the response code nn reflects the last 2 digits in a NUS02nn message number. This NUS02nn message is issued in addition upon the message log (NCIPARM generation parameter MSGDEST) giving detailed information about the compression failure.
Actn. Print dump and contact Software AG Support.
 
NS23 - SCP, DE-COMPRESSION FAILURE, RSP=nn
Expl. At session resumption, the decompression process has failed, the response code nn reflects the last 2 digits in a NUS02nn message number. This NUS02nn message is issued in addition upon the message log (NCIPARM generation parameter MSGDEST) giving detailed information about the decompression failure.
Actn. Print dump and contact Software AG Support.
 
NS30 - ROLL SERVER ALLOC FAILURE, RSP=ccc, RSP2=rrr
Expl. At session initialization, the request to register a session to the Roll Server has failed.

ccc - Roll Server return code

rrr - Roll Server reason code

Actn. Check Roll Server return code and reason code (Reason Codes of the Roll Server Requests). Print dump and contact Software AG Support.
 
NS31 - ROLL SERVER FREE FAILURE, RSP=ccc, RSP2=rrr
Expl. At session termination, the request to deregister a session from the Roll Server has failed.

ccc - Roll Server return code

rrr - Roll Server reason code

Actn. Check Roll Server return code and reason code (Reason Codes of the Roll Server Requests). Print dump and contact Software AG Support.
 
NS32 - ROLL SERVER WRITE FAILURE, RSP=ccc, RSP2=rrr
Expl. At session suspension, the request to pass a session's data to the Roll Server has failed.

ccc - Roll Server return code

rrr - Roll Server reason code

Actn. Check Roll Server return and reason code (see Roll Server Messages, Condition Codes and Abend Codes, in the Natural Operations documentation). Print dump and contact Software AG Support.
 
NS33 - ROLL SERVER READ FAILURE, RSP=ccc, RSP2=rrr
Expl. At session resumption, the request to retrieve a session's data from the Roll Server has failed.

ccc - Roll Server return code

rrr - Roll Server reason code

Actn. Check Roll Server return and reason code (see Roll Server Messages, Condition Codes and Abend Codes, in the Natural Operations documentation). Print dump and contact Software AG Support.
 
NS34 - ROLL SERVER STATS FAILURE, RSP=ccc, RSP2=rrr
Expl. A SYSTP utility request for Roll Server Statistics has failed.

ccc - Roll Server return code

rrr - Roll Server reason code

Actn. Check Roll Server return and reason code (see Roll Server Messages, Condition Codes and Abend Codes, in the Natural Operations documentation). Print dump and contact Software AG Support.
 
NS39 - ROLL SERVER NOT ACTIVE
Expl. The NCI environment is to use the Natural Roll Server (ROLLSRV=YES in NCMDIR), but it is currently not active. No dump is created.
Actn. Start the Natural Roll Server.
 
NS40 - SIP SERVER ALLOC FAILURE, RSP=ccc, RSP2=rrr
Expl. At session initialization, the request to register a session to the Authorized Services Manager's SIP handler has failed.

ccc - SIP Server return code

rrr - SIP Server reason code

Actn. Check ASM return code and reason code (see ASM Messages, Condition Codes and Abend Codes, in the Natural Operations documentation). Print dump and contact Software AG Support.
 
NS41 - SIP SERVER FREE FAILURE, RSP=ccc, RSP2=rrr
Expl. At session termination, the request to deregister a session from the Authorized Services Manager's SIP handler has failed.

ccc - SIP Server return code

rrr - SIP Server reason code

Actn. Check ASM return code and reason code (see ASM Messages, Condition Codes and Abend Codes, in the Natural Operations documentation). Print dump and contact Software AG Support.
 
NS42 - SIP SERVER READ FAILURE, RSP=ccc, RSP2=rrr
Expl. At session resumption, the request to retrieve the session's information record (SIR) from the Authorized Services Manager's SIP handler has failed.

ccc - SIP Server return code

rrr - SIP Server reason code

Actn. Check ASM return code and reason code (see ASM Messages, Condition Codes and Abend Codes, in the Natural Operations documentation). Print dump and contact Software AG Support.
 
NS43 - SIP SERVER BROWSE-F FAILURE, RSP=ccc, RSP2=rrr
Expl. A SYSTP utility request to browse forward through the session information records has failed.

ccc - SIP Server return code

rrr - SIP Server reason code

Actn. Check ASM return code and reason code (see ASM Messages, Condition Codes and Abend Codes, in the Natural Operations documentation). Print dump and contact Software AG Support.
 
NS44 - SIP SERVER BROWSE-B FAILURE, RSP=ccc, RSP2=rrr
Expl. A SYSTP utility request to browse backward through the session information records has failed.

ccc - SIP Server return code

rrr - SIP Server reason code

Actn. Check ASM return code and reason code (see ASM Messages, Condition Codes and Abend Codes, in the Natural Operations documentation). Print dump and contact Software AG Support.
 
NS45 - SIP SERVER WRITE FAILURE, RSP=ccc, RSP2=rrr
Expl. At session suspension, the request to pass the session's information record (SIR) to the Authorized Services Manager's SIP handler has failed.

ccc - SIP Server return code

rrr - SIP Server reason code

Actn. Check ASM return code and reason code (see ASM Messages, Condition Codes and Abend Codes, in the Natural Operations documentation). Print dump and contact Software AG Support.
 
NS46 - SIP SERVER QUERY FAILURE, RSP=ccc, RSP2=rrr
Expl. A SYSTP utility request for SIP Server statistics has failed.

ccc - SIP Server return code

rrr - SIP Server reason code

Actn. Check ASM return code and reason code (see ASM Messages, Condition Codes and Abend Codes, in the Natural Operations documentation). Print dump and contact Software AG Support.
 
NS49 - SIP SERVER NOT ACTIVE
Expl. The NCI environment has been defined to be able to switch CICS application regions (parameter CICSPLX=YES in NCMDIR). This requires that the Authorized Services Manager's SIP handler is active, but it is currently not. No dump is created.
Actn. Start the Authorized Services Manager's SIP handler.
 
NS50 - SWAP MANAGER SWAP POOL INSTALLATION FAILURE
NS51 - SWAP MANAGER SESSION INITIALIZATION FAILURE
NS52 - SWAP MANAGER SESSION ROLL-OUT FAILURE
NS53 - SWAP MANAGER SESSION ROLL-IN FAILURE
NS54 - SWAP MANAGER NORMAL TERMINATION FAILURE
NS55 - SWAP MANAGER ABNORMAL TERMINATION FAILURE
Expl. For swap manager failures, additional NUSnnnn error messages giving more detailed error information are issued upon the message log (NCIPARM generation parameter MSGDEST) and the transaction is terminated with a dump. The abend code along with the dump depends on the failing swap operation.
Actn. Print dump and contact Software AG Support.
 
NS59 - SWAP MANAGER MODULE NATSWPMG NOT INSTALLED
Expl. The swap manager module NATSWPMG is not linked to the Natural nucleus.
Actn. Relink the Natural nucleus with module NATSWPMG included.
 

Natural CICS Interface Session Errors

NTAD - xxxxxxxx, ABEND xxxx IN ADABAS LINKAGE ROUTINE
Expl. CICS transaction abend xxxx occurred in the Adabas linkage module xxxxxxxx that was specified via the Natural profile parameter ADANAME (see the Natural Parameter Reference documentation).
Actn. Check the Adabas documentation and correct the error or print a dump and contact Software AG Support.
 
NT02 - SESSION WAS CANCELLED BY ADMINISTRATOR uuuuuuuu tttt
Expl. The user session was cancelled via the system administrator function in SYSTP or via CICS Node Error Program (NEP) processing.

uuuuuuuu - system administrator's user ID (*USER)

tttt - system administrator's terminal ID (*INIT-ID)

Actn. Contact your system administrator.
 
NT04 - ABORTED BY TERMINAL ID EXIT xxxxxxxx
Expl. At session initialization or resumption, the Natural CICS Interface terminal ID exit NCITIDEX has aborted the session with return code xxxxxxxx.
Actn. Check the reason for the abortion within your terminal ID exit.
 
NT05 - EXTERNAL CALLNAT INTERFACE LEVEL FAILURE
Expl. At terminal I/O, the Natural CICS Interface has detected an inconsistency between the current CICS link level and the Natural external CALLNAT interface level. The session is cancelled.
Actn. Print dump and contact Software AG Support.
 
NT06 - SEND ATTEMPTED WITHOUT A TERMINAL
Expl. Self-explanatory.
Actn. When *DEVICE=ASYNC, Natural must not issue screen I/Os (DISPLAY, WRITE, etc.) unless the session parameter SENDER was specified. Restart the session with the SENDER parameter to get the terminal output or check the dump.
 
NT07 - ERROR AT TASK END: FC=ffff, RSP=ccc, RSP2=rrr, eeeeeeee
Expl. At session suspension or termination, the EXEC CICS RETURN command has failed.

ffff - failing EXEC CICS command (EIB field EIBFN)

ccc - EXEC CICS command response code (EIB field EIBRESP)

rrr - EXEC CICS command reason code (EIB field EIBRESP2)

eeeeeeee - CICS error condition

Actn. Contact Software AG Support.
 
NT08 - TERMINAL WRITE ERROR FC=ffff, RSP=ccc, RSP2=rrr, eeeeeeee
Expl. An EXEC CICS SEND command has failed.

ffff - failing EXEC CICS command (EIB field EIBFN)

ccc - EXEC CICS command response code (EIB field EIBRESP)

rrr - EXEC CICS command reason code (EIB field EIBRESP2)

eeeeeeee - CICS error condition

Actn. Contact Software AG Support.
 
NT09 - TERMINAL READ ERROR FC=ffff, RSP=ccc, RSP2=rrr, eeeeeeee
Expl. An EXEC CICS RECEIVE command has failed.

ffff - failing EXEC CICS command (EIB field EIBFN)

ccc - EXEC CICS command response code (EIB field EIBRESP)

rrr - EXEC CICS command reason code (EIB field EIBRESP2)

eeeeeeee - CICS error condition

Actn. Contact Software AG Support.
 
NT10 - MESSAGE SWITCH ERROR: FC=ffff, RSP=ccc, RSP2=rrr, eeeeeeee
Expl. An EXEC CICS SEND request of the Natural CICS Interface message switching transaction has failed.

ffff - failing EXEC CICS command (EIB field EIBFN)

ccc - EXEC CICS command response code (EIB field EIBRESP)

rrr - EXEC CICS command reason code (EIB field EIBRESP2)

eeeeeeee - CICS error condition

Actn. Contact Software AG Support.
 
NT11 - ASYNCH SEND FAILURE: FC=ffff, RSP=ccc, RSP2=rrr, eeeeeeee
Expl. An asynchronous Natural session has failed to route a message to the facility (terminal/destination) specified via the SENDER/OUTDEST session parameters.

ffff - failing EXEC CICS command (EIB field EIBFN)

ccc - EXEC CICS command response code (EIB field EIBRESP)

rrr - EXEC CICS command reason code (EIB field EIBRESP2)

eeeeeeee - CICS error condition

Actn. Check the failing CICS command and response code.
 
NT12 - ASYNC START FAILURE: FC=ffff, RSP=ccc, RSP2=rrr, eeeeeeee
Expl.

A pseudo-conversational asynchronous Natural session has failed to start its continuation task.

ffff - failing EXEC CICS command (EIB field EIBFN)

ccc - EXEC CICS command response code (EIB field EIBRESP)

rrr - EXEC CICS command reason code (EIB field EIBRESP2)

eeeeeeee - CICS error condition

Actn. Check the failing CICS command and response code.
 
NT13 - COMMAREA WRITE ERROR: FC=ffff, RSP=ccc, RSP2=rrr, eeeeeeee
Expl.

A Natural session has failed to write its session restart data into CICS temporary storage.

ffff - failing EXEC CICS command (EIB field EIBFN)

ccc - EXEC CICS command response code (EIB field EIBRESP)

rrr - EXEC CICS command reason code (EIB field EIBRESP2)

eeeeeeee - CICS error condition

Actn. Check the failing CICS command and response code.
 
NT89 - xxxxxxxx, INCOMPATIBLE CICS VERSION: MACLIB=xxxx SYSTEM=yyyy
Expl. The indicated module has been assembled with macros of a CICS version xxxx, which is different to the one which is currently active (yyyy).
Actn. Assemble NCISTART with the correct CICS macro library.
 
NT90 - xxxxxxxx, BACK-END PROGRAM/TRANSACTION MISSING (eeeeeeee)
Expl. The back-end program or transaction specified via front-end program of session parameter PROGRAM or CALLNAT 'CMPGMSET' does not exist; back-end transactions have a back-end "program" name STR=xxxx or RET=xxxx.

eeeeeeee - CICS error condition.

Actn. Check the program or transaction name and its CICS program and transaction definition respectively.
 
NT91 - xxxxxxxx, ADABAS LINKAGE ROUTINE MISSING/INVALID (eeeeeeee)
Expl. a) A CICS LINK/LOAD request for the indicated module has failed.

eeeeeeee - CICS error condition.

b) The requested module is not a valid CICS command level program.

Actn. a) Check if the Natural profile parameter ADANAME (see the Natural Parameter Reference documentation) specifies the correct Adabas linkage program, if it is defined in CICS and if it is linked in a library available to CICS.

b) Check if the module named by the Natural profile parameter ADANAME is the Adabas command level version and if it is linked correctly.

 
NT92 - xxxxxxxx, Natural NUCLEUS MODULE MISSING/INVALID (eeeeeeee)
Expl. For xxxxxxxx = NATPARM:

a) NATPARM is not linked to the CICS interface for xxxxxxxx = NATSTUB.

b) NATSTUB is not linked to the CICS interface, while the Natural nucleus is linked to it.

c) NATSTUB is not the entry point of the shared Natural nucleus which is not linked to the CICS interface.

Else:

d) Unable to load the shared Natural nucleus module xxxxxxxx.eeeeeeee - CICS error condition.

Actn. a) Link the Natural parameter module to the CICS interface.

b) Link module NATSTUB to the CICS interface.

c) Specify entry point CMSTUB linking the shared Natural or specify the correct module in the NUCNAME session parameter.

d) Check if session parameter NUCNAME is consistent with the CICS program definition and if the shared Natural nucleus has been linked correctly.

For z/OS only: If the shared Natural nucleus is to be loaded into the LPA/ELPA, check if LPA=YES has been specified in the CICS SIT or startup parameters.

 
NT93 - xxxxxxxx, Natural DRIVER MODULE MISSING/INVALID
Expl. The indicated module is not linked or invalid or does not have the same system maintenance (SM) level as the CICS interface.
Actn. Link the correct module to the CICS interface.
 
NT94 - xxxxxxxx, MANDATORY MODULE NOT ACCESSIBLE
Expl. The indicated module is not accessible by the Natural CICS Interface, because

a) it resides "above the line", whereas NCISTART runs in 24-bit mode (the shared Natural nucleus, for example);

b) it cannot be modified.

Actn. a) Link the Natural CICS Interface and the indicated module with consistent AMODE/RMODE.

b) Link the indicated module with NORENT option and define it with EXECKEY=USER in the CICS program definition (CICS Transaction Server).

 
NT95 - TRANSACTION xxxx, TWA SIZE TOO SMALL
Expl. The size of the transaction work area for Natural is too small. It must be at least 128 bytes.
Actn. Correct the TWASIZE parameter in the CICS transaction definition entry for transaction xxxx.
 
NT96 - Natural TRANSACTION xxxx MISSING/INVALID
Expl. The Natural pseudo-conversational restart transaction ID specified in a front-end parameter list does not exist.
Actn. Check the transaction code and its CICS transaction definition entry.
 
NT97 - NATURAL HAS BEEN RESET, PLEASE RESTART
Expl. A new copy of the Natural under CICS system directory module has been loaded. Existing sessions cannot survive.
Actn. The session is terminated.
 
NT98 - SESSION TERMINATED, xxxx ABEND OCCURRED
Expl. An abend xxxx has occurred and Natural is unable to continue.
Actn. The session will be terminated with a dump.
 
NT99 - SESSION TERMINATED, UNRECOVERABLE ABEND xxxx/yyyyy
Expl. A second abend xxxx has occurred while processing abend yyyy.
Actn. The session is terminated with a dump. Specify parameter DU=ON and reproduce the problem to get a dump for the first abend.
 

Top of page

Natural under CICS Informational Messages

The Natural under CICS informational messages comprise NCI environment startup messages and other messages, such as termination messages and messages issued via WTL, etc.

NCI0000 Unknown message NCInnnn
NCI0001 NciPfx Natural/CICS Interface Version nnn Lvl nnn
NCI0002 NciPfx Installing Natural system
NCI0003 NciPfx Natural system successfully started
NCI0004 NciPfx Natural system reset
NCI0005 NciPfx Un-installing old Natural system
NCI0006 NciPfx NCIPARM generation parameters modified
NCI0007 NciPfx NCI system directory dir-name at address
NCI0008 NciPfx NCI system directory extension at address
NCI0009 NciPfx NCI directory extension released at address
NCI0010 grp-name, Installing thread group, thread size = nnnnn
NCI0011 grp-name, Terminating thread group, thread size = nnnnn
NCI0012 grp-name, Thread group (type) available: threads = nnn
NCI0013 grp-name, Thread group (type) dead due to no threads available
NCI0015 grp-name, Thread(s) released at address
NCI0016 thd-name, Thread allocated at address
NCI0017 thd-name, Thread allocation failure: failure
NCI0020 NciPfx Max thread size for VSAM roll files: nnnnn
NCI0040 NciPfx Loading NCI dyn parms from destination dest-id
NCI0041 NciPfx Deleting NCI common dyn parms
NCI0042 NciPfx NCI common dyn parms deleted at address
NCI0043 NciPfx NCI common dyn parms loaded at address
NCI0044 NciPfx NCI dyn parms load failure' failure
NCI0050 NciPfx Installing type pool, size = nnnnnnn Pool-name
NCI0051 NciPfx Creating type pool cache, size = nnnnnnn
NCI0052 NciPfx Deleting type pool cache, size = nnnnnnn
NCI0053 NciPfx type pool allocated at address size = nnnnnnn
NCI0054 NciPfx type pool released at address size = nnnnnnn
NCI0055 NciPfx type pool GETMAIN failure: failure
NCI0056 NciPfx type pool cache created ALET = xxxxxxxx
NCI0056 NciPfx type pool cache created 64-bit address
NCI0057 NciPfx type pool cache deleted ALET = xxxxxxxx
NCI0057 NciPfx type pool cache deleted 64-bit address
NCI0058 NciPfx type pool cache creation failure: failure
NCI0059 NciPfx type pool cache deletion failure: failure
NCI0060 NciPfx Swap pool successfully initialized pool-name
NCI0100 Message produced by CMWTL
NCI0110 Message produced by CMTRACE
NCI0200 Natural termination message
NCI0210 z/VSE submit debug message
NCI0300 server-id: Master session installed
NCI0301 server-id: Master session installation failed
NCI0302 server-id: Server environment terminated

Top of page

NCISCPRI Warnings and Error Messages

The following messages may be output during the initialization of VSAM roll files for Natural; see also the corresponding step of the Installation Procedure for the Natural CICS Interface in the Natural Installation documentation:

mmmmmmmm REQUEST FAILURE AT OFFSET xxxxx, RTC=rrrr, ERROR=eeee, FTNCD=ffff (E)

A VSAM macro request failed. mmmmmmmm is the failing macro; xxxxx is the offset of the macro request within NCISCPRI; rrrr, eeeee and fffff are the VSAM macro request return, feedback and function code.

RECORD SIZE IS LESS THAN OPTIMUM OF CI-SIZE - 7 (W)

For an (unblocked) VSAM file, the maximum possible record size is the control interval size minus 7. Any smaller record size means wasted disk space and can result in more roll I/Os.

ACCESSED FILE IS NOT AN RRDS FILE (E)

The VSAM file to be initialized is not an RRDS, but a KSDS or ESDS file. Only VSAM RRDS files are supported as VSAM roll files for Natural.

RECORD SIZE IS LESS THAN ALLOWED MINIMUM OF 4089 (E)

The minimum VSAM control interval size supported by the Natural CICS interface is 4096 and the minimum record size supported by Natural under CICS is the corresponding optimum record size.

PARAMETER INPUT OBSOLETE AND THEREFORE IGNORED (W)

NCISCPRI does not require parameter input in JCL stream. But if available, it is retrieved (until the end-of-data). The message is not issued for null files.

Top of page