This document describes the steps for installing Natural Advanced Facilities (product code NAF) on BS2000/OSD.
For information on the features and functions provided by Natural Advanced Facilities, see the Natural Advanced Facilities documentation.
When used in this document, the notation
vrs or
vr represents the relevant product
version (see also Version in the
Glossary).
See General Prerequisites and System Support in the section Overview of the Installation Process.
The installation medium contains the following files required for product installation:
| File Name | Contents |
|---|---|
NAFvrs.SYSF |
Natural FSPOOL system file
definition
|
NAFvrs.MOD |
Load modules and object modules |
NAFvrs.MAC |
Macros |
NAFvrs.JOBS |
Sample installation jobs |
NAFvrs.INPL |
Natural objects |
NAFvrs.ERRN |
Natural error messages |
Copy the files into your environment as described in Copying Files to a BS2000/OSD Disk in the section Installing Natural.
Be sure to read Installation Process and Major Natural Features and Naming Conventions for Installation Procedures before you start the installation procedure.
Step 3: Assemble the Environment-Dependent Nucleus and the Natural Parameter Module
Step 10: Define Natural Advanced Facilities for Natural Security
(Job I050, Step 0300)
Skip this step if you want to use an existing spool file of Natural Advanced Facilities.
Load the new Natural FSPOOL system file definition
contained in the NAFvrs.SYSF file
by using the Adabas ADALOD utility.
(Job I055, Step 0300)
If required, modify the settings of the parameters in the source
module ANAFB2P, which is contained in the file
NAFvrs.JOBS.
The following examples illustrate how the parameters can be set:
DC01 = NAFDCAM1 DC02 = NAFDCAM2 DC03 = NO . . . . . DC30 = NO NAFERK1 = NAFP1 NAFERK2 = NAFP2 PA01 = 'STACK=(LOGON SYSPRINT,userid1,password;SVPBS201)' PA02 = 'STACK=(LOGON SYSPRINT,userid2,password;SVPBS201)' PA03 = 'NO' . . . . . PA30 = 'NO'
DC01 = NAFDCAM1 DC02 = NO . . . . . . DC30 = NO NAFERK1 = NAFP1 NAFERK2 = NAFP2 PA01 = 'STACK=(LOGON SYSPRINT;SVPBS201)' PA02 = 'NO' . . . . . PA30 = 'NO'
Note:
If Natural Security is installed, link the library
SYSPRINT to a user which is normally not active in the Natural
Security environment. Moreover, link SYSPRINT to as many users as
there are spool servers (1-9).
The parameters for DCAM connection (DC01 -
D30) and for P1-EVENTING
(NAFERK1, NAFERK2) must be
different from those used for the same function in any other application for
the same CPU.
Described below are the parameters that can be specified in the macro
NAFB2P:
| Parameter | Explanation |
|---|---|
DC01 - DC30 |
7 bytes indicating the name of the corresponding DCAM
application
Unused entries should be set to |
NAFERK1 |
8 bytes indicating the event ID for the communication between the online Natural and the spool server(s) and defining the name of the used common memory pool |
NAFERK2 |
8 bytes indicating the event ID for the automatic startup for
spool server(s) using an openUTM TP monitor and the corresponding
parameter SPOOL=(name,
number) |
PA01 - PA30 |
Stack data for the initialization of Natural by specifying
the following:
STACK=(LOGON library,userid; program-name) If Natural Security is installed, specify the following: STACK=(LOGON library,userid,password; program-name) Unused parameters must be set to |
MONEVT |
Name of the event ID for the BS2000/OSD monitor task (8 bytes maximum) |
PAMO |
LOGON command for the monitor
task.
The start program must always be set to If Natural Security is installed, specify the following: STACK=(LOGON library,userid,password; program-name) |
CMPSIZE |
Size of the Natural Advanced Facilities common memory pool
(in units of 1 KB)
The value is rounded up to the next higher multiple of 64 KB (64 KB = segment size = allocation unit for the common memory pools). |
RSOFORM |
Name of a form to be used by the spool server when output is
sent to an RSO printer
The information in the report is ignored. If value |
BS2FORM |
Name of a form to be used by the spool server when output is
sent to a system printer
The information in the report is ignored. If value |
PASEC |
Determines whether at logon the spool server uses the
FSEC value applicable to the invoking online application
(YES/NO).
|
PANAT |
Determines whether at logon the spool server uses the
FNAT value applicable to the invoking online application
(YES/NO).
|
ISO |
Determines whether the spool server(s) use a DCAM ISO
application in addition to the DCAM NEA application
(YES/NO).
|
RSOPROT |
Determines whether the RSO messages resulting from the
PRINT invocation are to be written to a log if
logical printers with RSO support are used.
|
MAXERR |
Maximum number of acceptable Natural spool server abends
(abnormal termination of Natural).
If the specified limit is exceeded, the spool server terminates itself. |
Assemble the source module ANAFB2P to create the
parameter module NAFB2P. If Natural Security is installed, check
the LOGON command to application
SYSPRINT.
(Job I055, Steps 0301, 0302, 0303)
Assemble the environment-dependent nucleus for batch mode and the Natural parameter module for the Natural Advanced Facilities server task and the Natural monitor task.
Assemble the following source modules:
ANAFFRNT |
Natural BS2000/OSD front-end for environment-dependent nucleus for batch |
ANAFRENT |
Natural BS2000/OSD reentrant, environment-dependent nucleus for batch |
ANAFPARM |
Natural BS2000/OSD parameter module for batch |
(Job I060, Step 0010, and Job I080, Step 0109)
Modify the parameters FSPOOL,
NTPRINT, NAFUPF and
NAFSIZE in the Natural parameter module according to
your site requirements. For more information on these parameters, see
Natural Profile
Parameters for NATSPOOL in the Natural Advanced
Facilities documentation.
Assemble and link the Natural parameter module.
(Job I060, Step 3802)
Add the following INCLUDE statements to the sources
LNATSHAR in the library
NAFvrs.JOBS:
INCLUDE NAFNUC ,NAFvrs.MOD INCLUDE NAFREENT ,NAFvrs.MOD INCLUDE NAFB2RSO ,NAFvrs.MOD INCLUDE NAFSERVR ,NAFvrs.MOD
(Job I061, Step 0300)
Load the Natural objects specific to Natural Advanced Facilities from the
NAFvrs.INPL file into the Natural
system files SYSPOOL and SYSPRINT by using the
Natural INPL
utility.
Ensure that the INPL load function finishes with the message:
Natural Advanced Facilities initialized by INPL
If this initialization fails, various problems will be encountered at execution time.
The maps contained on the data set are provided in source form so that you can modify them according to your requirements (for example, translate the maps from English into another language). If you modify these maps, ensure that all fields have the same format/length/relative position in the map. Failure to abide by this restriction will result in an invalid system.
(Job I061, Step 0304)
Load the Natural error messages specific to Natural Advanced
Facilities from the NAFvrs.ERRN
file into the Natural FDIC system file by using the
ERRLODUS
program of the Natural SYSERR utility (described in the
Utilities documentation).
(Job I065, Steps 0300, 0301, 0302, 0303)
Link the source members LNAFSERV, LNAFSEND,
LNAFMON and LNAFMEND in the library
NAFvrs.JOBS.
| Source | Function |
|---|---|
LNAFSERV |
Links the program that starts the Natural Advanced Facilities server task |
LNAFSEND |
Links the program that terminates the Natural Advanced Facilities server task |
LNAFMON |
Links the program that starts the Natural Advanced Facilities
monitor task
See also BS2000/OSD Monitor in the Natural Advanced Facilities documentation. |
LNAFMEND |
Links the program that terminates the Natural Advanced Facilities monitor task |
(Job I080, Steps 0110, 0200)
Add the following INCLUDE statements to the sources
LNUTFRNT, LNRTFRNT and/or LNATFRNT (Job
I060, Step 3801) in the library job-library:
INCLUDE NAFB2P ,job-library INCLUDE NAFFRONT ,NAFvrs.MOD
This step must be performed only if Natural Advanced Facilities is being installed in a Natural Security environment.
Define SYSPOOL to Natural Security with the startup
program MENU.
Start Natural and add the user profile, as defined in the
NAFUPF
parameter (see the Parameter Reference documentation) of
the Natural parameter module, to the SYSPOOL file by using
Function
31.1 (see the Natural Advanced Facilities
documentation).
Note:
A NAT7201 message is issued at the start
of the session indicating that the profile has not yet been added to the
SYSPOOL file.
Configure the spool file by following the instructions in NATSPOOL Initialization in the Natural Advanced Facilities documentation.
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.
You can also create test reports with Function 42 (described in the Natural Advanced Facilities documentation.
To proceed if a test report cannot be printed
Check whether the report is contained in the spool file. If the
report is not in the spool file, it is possible that a
FILE command for a print file has been active and
that the report has been written to the print file and not to the spool file.
This would occur because the FILE command has a
higher priority.
If the report is in the spool file but still is not printed, take the following steps.
Check whether the printer is in FREE status. If the
printer is in status BUSY, INOP, DEAC or
HUNG, reset it to FREE.
Check whether there is an error message on the console beginning with Natural Advanced Facilities. Normally, an error message will be sent to the console whenever a report is not printed. This allows the console operator to perform a more detailed analysis of the cause of the error.
Check whether the information in the printer definition (see Function 31.4 in the Natural Advanced Facilities documentation) and PDN are consistent with one another.
In addition, verify that the correct physical printer name and processor name have been specified.
Check whether the printer is reserved by another spool system and, although it is not currently in use, has been deactivated by the other spool system. In this case, it is best if the printer is reset via a direct operator command.
Check whether the printer is defined in an openUTM application (KDCDEF) and activated from that application. Deactivate the printer via an openUTM administration command.
If the printer prints only 80 characters per line and 24 lines per page, take the following step.
Check the PDN for the printer to see that the appropriate
LINELEN and MAXLINE parameters
have been included in the XOPCH macro.
For example, to cause the printer to print 132 characters per line and 80 lines per page, provide the following parameter values:
XOPCH LINELEN=132 MAXLINE=80
If a WRITE (rep) statement
with attribute definition AD=I (intensified display) is used, the
Natural profile parameter INTENS (see the
Parameter Reference documentation) must be specified to
enable intensified display.
The following must be true:
LS * INTENS < printer
buffer size
where LS is the line size as defined in the
FORMAT (rep) statement, and the printer
buffer size as specified in the printer definition (see
Function
31.4 in the Natural Advanced Facilities
documentation).
A system error may be issued upon initialization of openUTM if
the SPOOL parameter has been included in the
NATUTM macro and the spool server cannot be started during
initialization.
Possible causes of this error are:
The batch limit has been exceeded, and the spool server cannot be started.
The entry job name specified in the SPOOL
parameter either does not exist, or the entry job exists under a different name
than the one specified in the SPOOL parameter.