This documentcovers the following topics:
Several tests may be conducted following the installation of Natural Advanced Facilities, to determine whether the system functions correctly.
The programs NTEST
and SPPTEST
are contained
in the SYSPOOL
application. These programs contain WRITE
(1)
statements. Run the program NTEST
or
SPPTEST
. In the appropriate logical printer, the
Disposition
should be set to K
for testing.
Instead of using NTEST
or SPPTEST
, you can
also create test reports with Function
42.
If the report cannot be printed, take the following steps:
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=termid,SEND
where termid
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
module has been
modified. Since the NATSPOOL
spool server NATP
executes module SVPCIC01
in library SYSPRINT
, the
LOGON
module must not be modified by the user.
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 modules 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 library
SYSPOOL
and check the CICS options defined with
Function
30.5.
Check that neither external security (EXTSEC
operand of
CICS PCT) nor 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 9, Step 13 and Step 14 in the section Installing NAF under CICS).
Allocate a screen device instead of a printer device to the
Destination/Form
pairing of the first logical printer, run
NTEST
in library SYSPOOL
, 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 transaction CEDF
for your terminal device and
check whether the command EXEC CICS START
(to start the spool
server) is executed.
Start 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).
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
SYSRDC
utility, perform the following steps:
Start a Natural session with the following dynamic parameters:
RDCSIZE=100, TRACE=(CMAM08), ITRACE=ON
Log on to library SYSRDC
.
Execute the following command to select 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 library SYSPOOL
.
Log on to library SYSRDC
.
Execute the following command to display the trace entries:
RDCDISP
You will now see when a NATSPOOL
nucleus 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.
Errors that may occur during the check of 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 interpartition 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 | Description |
---|---|
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, proceed as follows:
On the NATSPOOL
menu, press PF1.
Enter function code 99
(miscellaneous information).
Enter function code 4
(NAF SP-SERV
messages
from spool server).
Reason: | Action: |
---|---|
The length of the data to be printed is not positive. | Obtain the dump and contact Software AG Support. |
Reason: | Action: |
---|---|
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 Support. |
Reason: | Action: |
---|---|
The return code of the task-end routine CMTSKND is
not zero.
|
Obtain the dump and contact Software AG Support. |
Reason: | Action: |
---|---|
The return code of the print routine CMWTERM is
not zero.
|
Obtain the dump and contact Software AG Support. |