To create the NATSPOOL environment, the following steps are
required:
Format the data area of the spool file (Function 30.1).
Set the options of the spool file (Function 30.5).
Set the general options for the spool server (Function 30.5).
Set the system-dependent options for the spool server:
BS2000/OSD options (Function 30.5),
CICS options not defined in NAFPAMC parameter module
(Function
30.5), or
IMS TM options not defined in NAFPARMI parameter module
(Function
30.5).
Define the main objects:
user profile (Function 31.1),
logical printer (Function 31.2),
allocation (Function 31.3),
physical printers (Function 31.4).
For additional functionality, you can define objects for:
header pages (Function 31.5),
applications (Function 31.6),
clusters (Function 31.7),
NTCC tables (Function
31.8),
calendars (Function 31.9).
You can also define specific options, such as:
logging function (Function 30.5),
defaults (Function 30.5),
statistics (Function 30.5),
access authorization (Function 30.7).
Your Natural environment must include the following:
a parameter module with settings for:
NAFUPF =
user-profile-name
NTPRINT (1- n), AM = NAF
FSPOOL = (DBID,FNR)
NAFSIZE = 1
the corresponding NAF modules.
When starting a Natural session, the defined user profile (parameter
NAFUPF) is read from the specified spool file (parameter
FSPOOL) and an internal cache is initialized for usage of
WRITE (rep) statements. The maximum
number that can be used for rep
corresponds to the value n defined in
the NTPRINT macro.
Example:
NTPRINT (1,3,6-11,15), AM = NAF
This allows the usage of the following statements to be executed for
Natural Advanced Facilities reports: WRITE (1), WRITE
(3), WRITE (6) to WRITE (11) and WRITE
(15).
If the user profile is not found on the spool file, the access method is not initialized and a corresponding warning is issued.
After reading the user profile, the values of the referenced logical printer(s) and allocation(s) are transferred to memory. This saves I/O time during the Natural session. If you modify any of these objects, you must therefore restart your session.
Initialization is now complete and your WRITE
(rep) statements will route the data to the
defined reports.
Example:
NAFUPF = SAG00001 NTPRINT (1-3), AM = NAF FSPOOL = (6,47) NAFSIZE = 1
User profile SAG00001 is defined on the spool file and uses
LPF1, LPF2, LPF3 and LPF4. After initialization, you can use the WRITE
(1) to WRITE (3) statements. A WRITE (4)
statement cannot be executed due to the maximum number 3 specified for the
NTPRINT macro.
The data are routed to the spool file by using the logical printers LPF1
for WRITE (1), LPF2 for WRITE (2) and LPF3 for
WRITE (3).
To get the information the physical printer uses for printout, the
allocation (Destination/Form) assigned to the logical printer is
read. After closing the report, the specified physical printer from this
allocation is used for starting the printout.
Note:
If Natural Security is installed, a user profile can be assigned by
using a library or user ID definition. This assignment is used when executing a
LOGON to a library and overwrites the information used by the
Natural initialization.
The Natural programs NTEST and SPPTEST in
library SYSPOOL are sample programs which produce test reports.
The resulting reports can be listed and their contents can be displayed by
using Function 10.
You can also create test reports with Function 42.
