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