You can verify the successful installation of Natural Advanced Facilities by following the instructions provided in this section.
You can perform the following steps to determine whether Natural Advanced Facilities functions correctly.
To print a test report
In the appropriate logical printer, set the
Disposition
to K
for testing.
Log on to the Natural system library SYSPOOL
and
execute the programs NTEST
and SPPTEST
. These
programs contain WRITE (1)
statements.
Or:
Create test reports with
Function
42 described in the Natural Advanced Facilities
documentation.
To proceed if a test report cannot be printed
Check that the CICS printer status is IN
SERVICE
.
Use the CICS message switching transaction CMSG
to route a message to the specified printer:
CMSG 'message',ROUTE=term-id,SEND
where term-id
is the
terminal identification of the CICS printer as specified in the TCT.
If Natural Security is installed, check whether logon error
records (of the NATSPOOL
spool server NATP
) have been
written to the Natural Security system file. The maintenance system for these
error records can be invoked by entering ERROR
in the command line
of Natural Security.
Check that the standard Natural LOGON
object has
not been replaced. The NATSPOOL
spool server
NATP
must be able to execute the SVPCIC01
module in
the SYSPRINT
library.
Also check whether the LOGON
user exit causes the
LOGON
of the spool server to SYSPRINT
to
terminate.
Check that the catalog dates of the objects in
SYSPRINT
and SYSPOOL
are identical to one
another.
Check that the parameters for the spool server match the
Natural Advanced Facilities environment. To do so, invoke MENU
in
the SYSPOOL
library and check the
CICS
Options defined with
Function
30.5 (see the Natural Advanced Facilities
documentation).
Check that neither the external security (EXTSEC
operand of CICS PCT) nor the security levels (TRANSEC
operand of
CICS PCT) are defined for the spool server NATP
. This ensures that
NATP
can be initiated without security violations.
Check the TCT and VTAM definitions (see Step 10: Define Natural Advanced Facilities for Natural Security, Step 13: Define Natural Advanced Facilities for VTAM/SNA and Step 14: Define Natural Advanced Facilities for VTAM/non-SNA in the section Installing Natural Advanced Facilities under CICS).
Allocate a screen device instead of a printer device to the
Destination/Form
pairing of the first logical printer, execute
NTEST
in the SYSPOOL
library, and check for error
messages on the screen.
On certain devices, the CICS abend ATNI may occur.
Since the Natural Security logon processing checks whether the device is a printer, this test is only possible if Natural Security is not installed.
Start the transaction CEDF
for your terminal
device and check whether the command EXEC CICS START
(to start the
spool server) is executed.
Start the transaction CEDF
for your printer
device (CEDF
terminal ID of printer) and check which commands are
executed.
Check the Natural Advanced Facilities messages on the system operator console and/or in the log file (the destination of messages is defined with Function 30.5 (see the Natural Advanced Facilities documentation).
Console messages sent by the spool server start with:
NAF SP-SERV:
Console messages sent by the terminal task start with:
NAF-
Obtain a NATSPOOL
trace and check which Natural
Advanced Facilities modules are called, which Adabas commands are executed, and
which return codes are encountered.
To obtain an online NATSPOOL
trace by using the
Natural SYSRDC utility
Start a Natural session with the following dynamic parameters:
RDCSIZE=100, TRACE=(NATAM08), ITRACE=ON
Log on to the SYSRDC
library.
Execute the following command to select the internal trace type:
RDCSET N
Execute the following command to start the trace:
RDCSTART
Execute a program which creates a report, for example,
NTEST
in the SYSPOOL
library.
Log on to the SYSRDC
library.
Execute the following command to display the trace entries:
RDCDISP
You will now see when a NATSPOOL
module begins
(marked as BEG
) and ends (marked as END
) as well as
its return code in decimal representation.
After the execution of an Adabas call (marked as
ADA
), you will see the command code, the first byte of the command
ID and the return code in decimal representation.
For detailed information on the SYSRDC utility, see the Utilities documentation.
Errors that may occur during the check for printer availability:
Error | Description |
---|---|
INV REQU |
Invalid request |
INV ID |
Invalid ID |
INV ADDR |
Invalid address |
INV DEVC |
Invalid logical device code for page status |
ATI REQU |
ATI required on NON-ATI terminal |
RESO PRO |
Resource problem for inter-partition session |
INV PROG |
Invalid program name |
UNAB PER |
Unable to perform request |
INV TYPE |
Type is not LUC |
RESO QUI |
Resource quiesced by TMP |
LOCATERR |
Any error different from those listed above |
Errors that may occur during the start of the spool server:
Error | Description |
---|---|
TERMIDER |
Terminal ID error |
TRANIDER |
Transaction ID error |
SYSIDERR |
SYSID error
|
INVREQ |
Invalid request |
IOERR |
I/O error |
LENGERR |
Length error |
ISCINVRE |
ISC invalid request |
NOTAUTH |
Not authorized |
STARTERR |
Any error different from those listed above |
Messages that may occur during the initialization of
NATSPOOL
:
Message | Text |
---|---|
NAF-01C |
ADABAS RCxxx,
DBIDxxx, FNRxxx, AT
OPEN |
NAF-02C |
Not used |
NAF-03C |
ADABAS RCxxx,
DBIDxxx, FNRxxx, AT READ
REPORT |
NAF-04C |
ADABAS RCxxx,
DBIDxxx, FNRxxx, AT READ
PRINTER |
NAF-05C |
ADABAS RCxxx,
DBIDxxx, FNRxxx, AT
CLOSE |
NAF-06C |
ADABAS RCxxx,
DBIDxxx, FNRxxx, AT
UPDATE REPORT |
NAF-07C |
ADABAS RCxxx,
DBIDxxx, FNRxxx, AT
UPDATE PRINTER |
NAF-08I |
REPORT
xxxxxxxxx ,
JOBxx.xxx , SET -TO BE
PRINTED- |
NAF-09I |
PRINTER xxxx SET
-FREE- |
NAF-10I |
PRINTER xxxx RESTARTS
IN 20 SECONDS, DEST=xxxxxxxx,
FORM=x |
NAF-11C |
RESTART ERROR NAT xxxx
ON PRINTER xxxx |
See the online help for descriptions of the NATSPOOL
print server messages.
To invoke online help for print server messages
In the PF1.
, pressEnter function code 99
(miscellaneous
information).
Enter function code 4
(Natural Advanced
Facilities SP-SERV
messages from spool server).
Abend Code | Reason | Action |
---|---|---|
NAF1 - INVALID
LENGTH |
The length of the data to be printed is not positive. | Obtain the dump and contact Software AG technical support. |
NAF2 - INVALID
LENGTH |
The length of the data to be printed is
greater than the maximum length of the terminal I/O buffer
(TIOBM ).
|
Obtain the dump and contact Software AG technical support. |
NAF3 - INVALID RETURN
CODE |
The return code of the task-end routine
CMTSKND is not zero.
|
Obtain the dump and contact Software AG technical support. |
NAF4 - INVALID RETURN
CODE |
The return code of the print routine
CMWTERM is not zero.
|
Obtain the dump and contact Software AG technical support. |