This document explains the features of Natural Advanced Facilities specific to an IMS TM environment.
NATSPOOL
accumulates all reports generated during a
Natural user session in the spool file.
To physically print a report (that is, to send output to an IMS
LTERM assigned to a printer), NATSPOOL
performs the following
steps:
The MPP Natural inserts a message into the IMS message queue for a transaction code that is used as (non-conversational) input transaction code for a BMP region. This transaction code can be a Wait for Input (WFI) transaction code or not.
If the BMP is generated as WFI and has been started by the IMS
TM operator, all reports which are created during the IMS TM session are
printed by this BMP. If the BMP is not generated as WFI, Natural issues the
/STA REGxxxxxxxx
command
to start the BMP region, where xxxxxxxx
represents the BMP JCL member name specified in the spool file options (see
Function
30.5).
The BMP region executes Natural under the control of the Natural BMP interface for IMS TM. The input to Natural must be as follows:
//CMSYNIN DD * LOGON SYSPRINT SVPIMS01 FIN /*
The Natural program SVPIMS01
in library
SYSPRINT
retrieves the message from the IMS message queue to find
out what has to be printed and sends the selected output to the IMS printer.
Depending on whether the transaction code is WFI or not, the BMP region either
"waits" for the next input message or terminates. The message
contains the BMP transaction code specified in the spool file options (see
Function 30.5)
and the LTERM name of the IMS printer. Since SVPIMS01
dynamically
calls CMGETMSG
, the load library containing this module must be
concatenated in the BMP JCL.
The logical connection between the two Natural sessions used by
NATSPOOL
is shown below.
To install NAF in an IMS TM environment, set the
NATSPOOL
parameters listed below.
You can also specify these parameters with Function 30.5 (Set Spool Option) as described in Layout of Spool File.
Parameter | Explanation |
---|---|
BMPCODE=
name |
Specifies the BMP transaction code. |
BMPNAME=
name |
Specifies the BMP JCL member name. |
BMPWFI=ON/OFF |
Specifies the BMP WFI option. |
You can omit a parameter or set the value
(name
or
OFF
/ON
) assigned to blank.
The following rule of precedence applies to the use of parameters:
For all parameters that have not been defined in
NAFPRMI
or have been set to blank, the corresponding values
defined in the spool file applies.
Parameters that have been defined in the NAFPRMI
parameter module by setting the value not equal to blank rank before the values
defined on the spool file. As a result, you can use the NAFPRMI
parameter module to set certain options for certain BMPs only. This can be
useful for several IMS TM environments sharing the same spool file.
Under IMS TM, an option is provided to use only one BMP to print
all reports which are created during an IMS TM session. To make this possible,
the BMP program SVPIMS01
in library SYSPRINT
can be
made to "Wait for Input" after it has been started by the IMS
operator. No /STA REG
command will be issued from
the MPP region after the message for the BMP input transaction code has been
inserted in the IMS message queue.
To stop the BMP, issue the command /PSTO
REG
. The BMP is stopped automatically when the database in which
the spool file is located is no longer active, or if any error occurs during
execution.
To use this feature, the BMP transaction must be generated as WFI
in the IMS TM TRANSACT
macro, and "Wait for input"
must be set in the spool file options or in the NAFPARMI
parameter
module.
Since the Natural Advanced Facilities transaction can be run as BMP-WFI, it is also possible to have this printer transaction as an online transaction running under the message-oriented online Natural.
This can be achieved by specifying the spool file options with a
BMP ID equal to a non-conversational transaction code received by the
message-oriented online Natural. Also "Wait for input" equal to Y
is required to suppress the /STA REG
command,
because this transaction is scheduled like the normal conversational
dialog-oriented Natural transactions.
To tell the message-oriented Natural to run the
SVPIMS01
Natural print program, a bootstrap module with the
following Natural dynamic parameters must be generated as the transaction start
program:
STACK=(LOGON SYSPRINT;SVPIMS01),PRINTER=LTERMP01
Other requirements, such as WRKPCBS are equivalent to the BMP version. You will find instructions for generating the bootstrap in the section Installing the Natural IMS TM Interface on z/OS in the Installation for z/OS documentation.
When deciding how to run Natural Advanced Facilities under IMS,
you need to take into account site specifics. For example, extremely long
printouts may hinder other online transactions running in the same region.
Permanently having print transactions in the queue may also lead to a region
lock by printing. You can avoid this by using IMS transaction parameters, such
as PROCLIM
.