One or more physical printers must be defined to NATSPOOL
to indicate where reports are to be routed.
Besides general information, a physical printer describes technical data required to establish a connection. This information depends on the operating system: CICS, BS2000 or IMS TM.
This document covers the following topics:
When you invoke this function, the Printer window appears:
Time 15:02:17 *** Natural Spool Administration *** Date 2002-10-21
User SAG M e n u File 7/411
+---------- Printer 7/411 ---------------+
Administration ! !
! Enter name of !
10 Reports / Queues ! !
11 Devices ! Printer !
12 Abstracts ! !
13 Applications ! or !
14 Change Spool File ! !
! * for Selection !
Maintenance ! !
! ? for Help !
30 Spool File Properties ! !
31 Objects ! . for End !
32 Mass Update ! !
33 Hardcopy Allocations ! ------------------------- !
34 Transfer Objects ! / ________ / !
! !
+----------------------------------------+
Enter values.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Menu Exit User Logic Alloc Print Heade Appli NTCC Canc |
In this window, you can specify the name of an existing physical printer, select a physical printer from a list of printers available or add a new physical printer to the spool file.
To select a physical printer from a list, enter one of the following:
a partly-qualified name (e.g. D* to list all physical
printers starting alphabetically from D),
an asterisk (*) to list all physical printers in the
NATSPOOL system.
A list of physical printers is then shown in a window.
Time 15:23:06 *** Natural Spool Administration *** Date 2002-10-21
User SAG M e n u File 7/411
+-------------Select with D*-------------+
Administration ! New start value ......... _________ !
! ----------------------------------- !
10 Reports / Queues ! Fl Cm Name Fl Cm Name !
11 Devices ! -- -- --------- -- -- --------- !
12 Abstracts ! _ DAEPRTCA _ DAEPRT10 !
13 Applications ! S _ DAEPRT12 _ DAEPRT13 !
14 Change Spool File ! _ DAEPTR10 _ DAPERT13 !
! _ DEAPRTCA S _ DR1171 !
Maintenance ! S _ DR1490 _ HCTEST !
! _ HHIPID _ HUGO !
30 Spool File Properties ! _ MK1 _ MK10 !
31 Objects ! _ MK11 _ MK12 !
32 Mass Update ! _ MK13 _ MK2 !
33 Hardcopy Allocations ! _ MK3 _ MK4 !
34 Transfer Objects ! _ MK5 _ MK6 !
! _ MK7 _ MK8 !
+----------------------------------------+
Mark on selection list.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Menu Exit -- + Canc |
The physical printer which was used for the initialization of the current Natural session is highlighted in the window.
The Fl (flag) column indicates the following:
| Flag | Description |
|---|---|
P |
Protected by administrator(s). |
S |
Physical printer is defined for usage by another operating/TP system. |
In the Cm column, you can enter one of the following
codes:
| Code | Description |
|---|---|
C |
Copy physical printer. |
D |
Delete physical printer. |
R |
Rename physical printer. |
. |
Exit function. |
X or any other character
|
Display physical printer for modification or deletion, see below. |
If the specified physical printer exists, it is displayed. You can modify the form feed parameters or delete the whole physical printer.
Note:
If you specify a name that does not yet exist, you can add a new
physical printer. In this case, the Delete option is not provided in the
window.
Time 10:29:04 *** Natural Spool Administration *** Date 2002-10-21
User SAG M e n u File 7/411
+-------------------------------- Printer --------------------------------+ +
! Modify DAEPRT10 Delete (Y/N) N ! !
! --------------------------------------------------------------------- ! !
! Owner ........... N Private printer N Cluster .... -- ! !
! --------------------------------------------------------------------- ! !
! Standard profiles N Opsys/Tpsys CICS____ ! !
! Statistics ...... N ! !
! ! +
! Check for form .. N Initial form ________ / _ FF control B ! !
! FF sequence ..... 0C00 LF sequence 1500 Sever exit ________ ! !
! ! !
! NTCC type ...... ________ ! !
! --------------------------------------------------------------------- ! !
! CICS System ID .. ____ ! +
! --------------------------------------------------------------------- ! !
! Notes ! !
! ________________________________________________________________ ! !
+-------------------------------------------------------------------------+ +
Enter values for the printer.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Menu Exit User Logic Alloc Print Heade Appli NTCC Canc
|
Note:
The layout of the window above changes depending on the operating
system specified.
The physical printer name must correspond to one of the following, according to the operating system used:
the CICS Terminal ID, as specified in the CICS Terminal Control Table TCT; or
it must be an IMS TM LTERM name; or
the physical name (PDN) of a BS2000 printer.
You can specify the following for all operating systems:
Whether standard profiles are to be used (Y/N). When you
add a physical printer, a logical printer and Destination/Form are
automatically created. The names of the logical printer and destination
correspond to the name of the physical printer. As a form name, A
is provided. If you specify N, these objects are deleted.
The operating system or TP monitor for which you define the printer. You can specify CICS, BS2000 or IMS TM.
Whether you require statistics (Y/N). If you specify
Y, the number of pages, lines and reports for this allocation are
collected and can be maintained by using Function 20. When Y is
specified, an additional field appears (Add/modify time values). If you specify
Y for this additional field and press Enter, the
Time Window appears in which you can restrict this
function to a user-defined time range.
Whether the spool server is to check which form (Destination/Form)
was printed on this physical device before (Y/N). If the form
differs, printout is not started and a message is sent to the console. This
check is not done under BS2000 using system printers and for printers being
accessed via a user application programming interface (API).
The initial form to be used if Check for form is set to
Y. If you do not specify an initial form and this flag is set to
Y, the first printout will be started and the Destination/Form of
this report will then be used.
When a form feed is to be performed. This information is only evaluated at print time (not when the report is stored on the spool file). Enter one of the following values:
| Value | Description |
|---|---|
A |
Form feed at beginning and end. |
B |
Form feed at beginning only. |
E |
Form feed at end only. |
F |
Form feed at end only. (Leading form feed is ignored.) |
I |
No form feed at beginning and end. (Leading form feed is ignored.) |
N |
No form feed at beginning and end. |
T |
Transparent (no modifications). |
Control sequences for the form feed and line feed.
The type of printer if you work with printer-specific NTCC tables
(see Function
31.8 and the
DEFINE
PRINTER statement).
The name of the subprogram that takes control in the spool server over each block sent to the printer. If you do not specify a name, control is passed to the user exit USPSER01. If you do not want a user exit to take control, enter *DUMMY.
A description of the physical printer can be added in the
Notes field.
All other fields in the screen depend on the operating system currently:
Time 13:53:29 *** Natural Spool Administration *** Date 2002-10-21
User SAG M e n u File 7/411
+-------------------------------- Printer --------------------------------+ +
! Modify DAEPRT10 Delete (Y/N) N ! !
! --------------------------------------------------------------------- ! !
! Owner ........... N Private printer N Cluster .... -- ! !
! --------------------------------------------------------------------- ! !
! Standard profiles N Opsys/Tpsys CICS____ ! !
! Statistics ...... N ! !
! ! +
! Check for form .. N Initial form ________ / _ FF control B ! !
! FF sequence ..... 0C00 LF sequence 1500 Sever exit ________ ! !
! ! !
! NTCC type ...... ________ ! !
! --------------------------------------------------------------------- ! !
! CICS System ID .. ____ ! +
! --------------------------------------------------------------------- ! !
! Notes ! !
! ________________________________________________________________ ! !
+-------------------------------------------------------------------------+ +
Enter values for the printer.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Menu Exit User Logic Alloc Print Heade Appli NTCC Canc |
A specific CICS system ID can be defined for each printer. If you do not specify a value, the value from the spool file options is used (see Function 30.5).
Time 14:05:10 *** Natural Spool Administration *** Date 2002-10-21
User SAG M e n u File 7/411
+-------------------------------- Printer --------------------------------+ +
! Modify IMSPRI Delete (Y/N) N ! !
! --------------------------------------------------------------------- ! !
! Owner ........... N Private printer N Cluster .... -- ! !
! --------------------------------------------------------------------- ! !
! Standard profiles N Opsys/Tpsys IMS TM__ ! !
! Statistics ...... N ! !
! ! +
! Check for form .. N Initial form ________ / _ FF control B ! !
! FF sequence ..... 0C00 LF sequence 1500 Server exit ________ ! !
! --------------------------------------------------------------------- ! !
! Printer Type .... ________ SCS printer (Y/N) Y Buffer size 1024 ! !
! --------------------------------------------------------------------- ! !
! IMS BMP Transaction ID .. ________ ! +
! IMS BMP JCL Member ...... ________ ! !
! Notes ! !
! ________________________________________________________________ ! !
+-------------------------------------------------------------------------+ +
Enter values for the printer.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Menu Exit User Logic Alloc Print Heade Appli NTCC Canc |
Report data are processed differently. Therefore, you must specify SCS
printers by entering Y (yes) or N (no) in the field
SCS Printer. In addition, in the Buffer Size field, enter the size of the
buffer used by the blocks transferred to the physical printer. The buffer size
is defined in bytes and must be in the range of 256 and
4048.
BMP name and JCL member can be defined for each printer. If you do not specify any values, the values from the spool file options are used (see Function 30.5).
Time 14:06:43 *** Natural Spool Administration *** Date 2002-10-21
User SAG M e n u File 7/411
+-------------------------------- Printer --------------------------------+ +
! Modify DR1171 Delete (Y/N) N ! !
! --------------------------------------------------------------------- ! !
! Owner ........... N Private printer N Opsys/Tpsys BS2000__ ! !
! --------------------------------------------------------------------- ! !
! Standard profiles N Statistics N ! !
! Check form ...... N Init. form ________ / _ FF control N ! !
! FF sequence 0D0C LF sequence 0D15 Server Exit ________ ! !
! --------------------------------------------------------------------- ! !
! User exit _____ NTCC type ________ RSO (Y/N) N RSO form ______ ! !
! --------------------------------------------------------------------- ! !
! Protocol type NEAR Processor VR3_____ Trace (Y/N) N ! !
! SEC. retry 20_ SEC. timeout 60___ ! !
! Max.No. restarts 0 Buffer size 1920 ! !
! Connection type S Message header *STD____ Cluster -- ! !
! --------------------------------------------------------------------- ! !
! Notes ________________________________________________________________ ! !
+-------------------------------------------------------------------------+ +
Enter values for the printer.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Menu Exit User Logic Alloc Print Heade Appli NTCC Canc |
You can specify the following:
The name of a user exit:
| User Exit | Description |
|---|---|
EXIT1 |
A user-written program gets control for each line of a
report created for this physical printer. The control sequences for line feed
and form feed are not modified. The program name for this type of exit is
NAFEXIT1.
|
EXIT2 |
A user-written program gets control for each block before it
is send to the physical printer using the YSEND macro. The program name for
this type of exit is NAFEXIT2.
|
EXIT3 |
A user-written program gets control for all required
functions (that is, open connection, start report, send data, close report,
close connection). These functions must be executed by the user-written
program. The program name for this type of exit is
NAFEXIT3.
|
| no specification | A user-written program will not be invoked. |
Whether the SNI spool system RSO is to be used
(Y/N).
An RSO form parameter for printers that are controlled using the SNI spool system RSO. If you do not specify a parameter, the destination value from the allocation is used. It is also possible to define a value in the NAF parameter module which ignores all other values.
A protocol type (NEAR or ISO).
The name of the processor which controls the printers.
Whether the trace option is to be activated (Y/N) to
get information on the DCAM and PRNT macros that are
executed for this physical printer. When activated, trace messages (that is,
the functions, their return codes, the name of the physical printer, date and
time) are written to the protocol file SYSOUT.
The number of seconds after which the system tries to reestablish the connection to a printer. After 3 unsuccessful attempts, this is canceled.
The spool server expects an acknowledgement for each message sent to a printer. You can specify the period in seconds after which a timeout is to occur.
If the Restart option is active (see
Function
30.5), you can specify the maximum number of restarts.
When the maximum number is reached, the printer is deactivated for the spool
server. Value 99 means that the number of restarts is unlimited.
Value 0 means that there is no restart and that the printer will
be set to FREE status.
The buffer size, that is, the maximum size of a block that is sent to a printer. The maximum number is 4048 bytes.
The connection types for physical printers that are accessed by DCAM calls. You can specify one of the following:
| Value | Description |
|---|---|
B |
Should be used for devices defined as bypass printers in the PDN definition. This is important for printers used as hardcopy devices. |
N |
Should be used for devices connected to directly to VR or to a MSF using the BAM protocol. |
| S | Should be used for devices connected to a MSN or an emulation. |
| P | Should be used to access a device or application (emulation) without modification to the data stream. |
The name of a message header. See also Function 31.A.
The name of the message header is D9001 and the
connection type is B. The spool server looks for a message header
named D9001_ _ _B. If this message header is not defined, the
spool server uses the standard message header for the corresponding connection
type: *STD_ _ _ _N (BAM) or *STD_ _ _ _B
(bypass).
Standard values are used for bypass and BAM connections only. When a
printer is accessed via EXIT3 or is set to Connection Type
P, the spool server searches for a correct message header. If a
message header is not found, the data are processed without message header
values.