This Natural profile parameter specifies the print files to be used during the session. It
corresponds to the NTPRINT
macro in the Natural parameter
module.
Possible settings | See PRINT Parameter Syntax. | |
---|---|---|
Default setting | See the default values of the different keyword subparameters described below. Depending on the access method and the environment, there may be different default settings. | |
Dynamic specification | yes | The parameter PRINT can only be specified dynamically.
In the Natural
parameter module, use the macro NTPRINT .
|
Specification within session | no |
Notes:
PRINTER
can be used as a synonym for
PRINT
.
AM
.
AM=STD
, they can be allocated
dynamically during the session in a Natural program using the DEFINE PRINTER
statement
or the application programming interface USR2021
(in library
SYSEXT
).
This document covers the following topics:
With the PRINT
parameter, you first specify one or more logical
print file numbers, and then several keyword subparameters, which define the
characteristics for these print files:
PRINT=((print-file-numbers),keyword-subparameter=value,...) |
Where:
Note:
To provide different print file definitions, PRINT
can be
specified multiple times.
PRINT=((2,12,18),AM=STD,DEST='PRINT**',OPEN=INITOBJ,CLOSE=CMD) PRINT=((1,3,6-11,15),AM=NAF) PRINT=((0),AM=STD,DEST=HARDCOPX)
With an NTPRINT
macro, you first specify one or more logical print
file numbers, and then several keyword subparameters which define the characteristics that
are to apply to these print files:
NTPRINT (print-file-numbers),keyword-subparameter=value,...
Where:
Note:
To provide different print file definitions, NTPRINT
can be
specified multiple times.
NTPRINT (2,12,18),AM=STD,DEST='PRINT**',OPEN=INITOBJ,CLOSE=CMD NTPRINT (1,3,6-11,15),AM=NAF NTPRINT (0),AM=STD,DEST=HARDCOPX
The following keyword subparameters are available for all environments:
AM
| CCHAR
| DEST
| OPEN
| CLOSE
| ROUTE
| CP
| SHIFT
AM=value
specifies the type of access method to
be used.
Value | Access Method |
---|---|
STD |
Standard sequential batch files (batch, TSO). |
COMP |
Com-plete print files. |
CICS |
CICS transient data or temporary storage. |
NAF |
Natural Advanced Facilities. |
IMS |
IMS TM destinations. |
PC |
Entire Connection. |
USER |
Third-party vendor print interface. |
SMARTS |
SMARTS print file. |
ESS |
Entire System Server. |
NOM |
Entire Output Management.
Note: |
OFF |
Unassigned. No automatic assignments if FAMSTD=OFF is set.
Note: |
0 |
Unassigned. Automatic assignments if FAMSTD=OFF is set.
This is the default value. |
Notes:
AM=STD
), provided that they have been predefined in the JCL. See also
FAMSTD - Overwriting of Print and Work File
Access Method Assignments .
PRINT=((0),AM=xxx)
or NTPRINT
(0),AM=xxx
determines the hardcopy print access
method and is equivalent to the profile parameter HCAM
=xxx
.
CCHAR=value
allows you to define hexadecimal
control characters for print file I/O to be passed through unchanged.
Value | Explanation |
---|---|
a1 or
(a1,a2,…)
|
A single hex character or a list of hex characters enclosed
in brackets can be specified. The hex characters must be within
x'01' through x'3F' . A hex character range
a1-a2 is allowed instead of a hex
character.
There is no default value. |
OFF |
CCHAR=OFF resets any previous
CCHAR definitions.
|
Notes:
x'01'
through x'3F'
to '?'
. In some
cases, however, certain control characters are required for special purposes. These
can be specified with CCHAR
.
CCHAR
specification
replaces the definitions in the output translation tables NTTAB
,
NTTAB1
and NTTABL
as contained in the configuration module
NATCONFG
or defined by the corresponding dynamic profile parameter or
by the corresponding macro in the Natural parameter module.
CCHAR=17
CCHAR=19-1B
CCHAR=(03-06,0A,1B,3A-3F)
DEST=value
specifies the print destination (1 -
8 characters).
Access Method | Meaning of Keyword Subparameter DEST |
---|---|
AM=STD |
DEST is the logical data set name (DDNAME ,
LINK name, DTF name).
If the destination is to be
for multiple files, two asterisks (**) have to be specified for the file
number. These will be replaced by the corresponding logical file number for
each print file. A The default value is |
AM=CICS |
There is no default value for print files under CICS. Here, the
DEST subparameter is mandatory, that is, CICS print
files defined without a valid DEST specification are
ignored.
The Natural CICS interface also supports a variable (see the
|
AM=IMS |
Specifies the IMS TM destination. |
Notes:
DEST=value
corresponds to the
OUTPUT
value of the DEFINE PRINTER
statement (and can be overwritten by a DEFINE PRINTER OUTPUT
specification).
PRINT=((0),DEST=xxx)
or NTPRINT
(0),DEST=xxx
determines the hardcopy print
destination and is equivalent to the Natural profile parameter HCDEST
=xxx
.
OPEN=value
specifies when the file is to be
opened.
Value | Explanation: The file is opened ... |
---|---|
INIT |
for output at session initialization. |
OBF |
according to the default OPEN value for the
different environments (batch, CICS, Com-plete, TSO).
|
OBJ |
when the execution of the first object which accesses the file starts.
This is the general default, except for |
OBJ1 |
when the execution of the first object on Level 1 that accesses the file starts. Otherwise, it is opened when it is first accessed. |
ACC |
when it is first accessed by a statement.
This is the default for
|
INITOBF |
for output at session initialization. Any subsequent re-opening of the file
sets the default OPEN value for the different
environments (batch, CICS, Com-plete, TSO).
|
INITOBJ |
for output at session initialization. Any subsequent re-opening of the file will be performed when the execution of the first object which accesses the file starts. |
INITOBJ1 |
when the execution of the first object on Level 1 that accesses the file starts. Otherwise, it is opened when it is first accessed. |
INITACC |
for output at session initialization. Any subsequent re-opening of the file will be performed when it is first accessed by a statement. |
CLOSE=value
specifies when the file is to be
closed.
Value | Explanation: The file is closed ... |
---|---|
OBJ |
either when processing of the object in which it was first accessed is
finished or when command mode, NEXT mode or MAINMENU
is reached.
|
CMD |
when command mode, NEXT mode or MAINMENU is
reached.
This is the default for |
FIN |
at session end (this is the default for AM=STD ).
Note: |
USER |
only if the file is open and one of the following conditions is true:
|
ROUTE=value
specifies whether logical print
file routing is done according to the OUTPUT
clause of the DEFINE
PRINTER
statement.
Value | Explanation |
---|---|
ON |
Print file routing is done. The target print file can be any available
print file except PC .
This is the default value. |
OFF |
No print file routing is done. |
am |
Print file routing is done to printers of the specified access method only.
Possible value is any valid print file access method (see subparameter
|
Note:
Print file routing means that, if the name defined in the OUTPUT
clause
of a DEFINE PRINTER
statement denotes a print file destination which is
defined by a different logical printer, all print output is routed to this print file.
If no printer with the specified name is found, the print output can be routed to any
free printer.
CP=value
specifies the code page for the print
output.
Value | Explanation |
---|---|
1 - 64 characters. | The name of the desired code page.
Any character string
is possible, but must be predefined by one of the code page parameters
|
Notes:
CP
, the code page resulting from the
evaluation of the profile parameter CP
is used.
CP=OFF
), any value specified for this parameter is ignored.
CP
and Profile Parameters and Macros in the
Unicode and Code Page Support documentation.
SHIFT=value
specifies whether the print records
are shifted to the right by the number of blanks
nnn
.
Value | Explanation |
---|---|
0 or 1 - 248 |
The print records are shifted to the right and the specified number of blanks is inserted in front of the record starting with column 1. |
0 |
The print records are not shifted.
This is the default value. |
Notes:
The following keyword subparameters are available for access method AM=STD
in all environments:
RECFM
| BLKSIZE
| LRECL
| TRUNC
| PAD
| PADCHRO
| ASA
| STRIP
RECFM=value
specifies the default record format
of the data set.
Value | Format |
---|---|
F |
Fixed |
V |
Variable |
U |
Undefined |
B |
Blocked |
S |
Spanned |
A |
ASA |
M |
Machine control characters |
Value | Explanation |
---|---|
RECFM=F, RECFM=FA, RECFM=FM, RECFM=FB, RECFM=FBA,
RECFM=FBM, RECFM=V, RECFM=VA, RECFM=VM, RECFM=VB, RECFM=VBA, RECFM=VBM,
RECFM=VBS, RECFM=VBSA, RECFM=VBSM, RECFM=U, RECFM=UA, RECFM=UM |
These values or combinations of values can be specified. |
RECFM=VBA |
Variable blocked with ASA.
This is the default value. |
Note:
The RECFM
specification only applies if no record format is
predefined in the JCL or (z/OS only) in the data set DCB.
BLKSIZE=value
specifies the default block size
of the data set.
Value | Explanation |
---|---|
0 or 8 -
32767 |
Default block size of the data set (in bytes). |
1016 |
This is the default value. |
Note:
The BLKSIZE
specification only applies if no block size is
predefined in the JCL or (z/OS only) in the data set DCB.
LRECL=value
specifies the default record
length of the data set.
Value | Explanation |
---|---|
0 or 5 - 254 |
Record length of the data set (in bytes). |
0 |
This is the default value. |
Notes:
RECFM=V(B)
the
LRECL
value includes a 4-byte record descriptor word.
LRECL=0
is defined, the following applies: RECFM=V(B)
,
LRECL
defaults to the minimum of BLKSIZE-4
and
254
.RECFM=U
, LRECL
defaults to BLKSIZE
.RECFM=F(B)
,
the maximum record length in the Natural program being executed is taken when the file
is opened. If no record length from a program is available when the file is opened,
for example with OPEN=INIT
, a record length of 132 is taken (plus 1 for
ASA or a machine control character and/or plus 4 for a record-descriptor word if the
record format is variable).
LRECL
specification only applies if no record length
is predefined in the JCL or (z/OS only) in the data set DCB.
TRUNC=value
specifies whether the output
records are truncated.
Value | Explanation |
---|---|
ON |
Output records that are longer than the record length
(LRECL ) of
the data set will be truncated.
This is the default value. |
OFF |
Error NAT1512 will be issued if an output record is longer than the data set record length. |
PAD=value
specifies whether the output records
are padded or not (applies only to data sets of fixed record length).
Value | Explanation |
---|---|
ON |
Output records that are shorter than the record length
(LRECL ) of
the data set will be padded with padding characters defined by keyword
subparameter PADCHRO .
This is the default value. |
OFF |
Error NAT1510 will be issued if an output record is shorter than the data set record length. |
PADCHRO=value
specifies the character which is
used for padding if PAD=ON
is
defined for the print file.
Value | Explanation |
---|---|
'x' |
One character x
within single quotes
|
x'xx' |
One hex character
xx |
' ' (blank)
|
Blank or x'40'
This is the default value. |
ASA=value
specifies whether the ASA record
format is used.
Value | Explanation |
---|---|
ON |
An ASA character is included in the output print records.
Under z/OS, this enforces ASA record format, regardless of the
RECFM setting in the DCB or the
RECFM subparameter.
This is the default value. |
OFF |
No ASA character is included in the output print records. |
STRIP=value
can be used to inhibit the removal
of trailing blanks.
Value | Explanation |
---|---|
ON |
Trailing blanks are stripped off.
This is the default value. |
OFF |
Trailing blanks are not stripped off. |
Note:
Trailing blanks are stripped off for batch sequential print files (access method
AM=STD
) if the data set is
defined with variable record format (RECFM
=VB
) to reduce disk space. This may cause
problems with subsequent applications accessing this data set, due to the missing
blanks. These problems can be avoided by setting STRIP=OFF
.
The following keyword subparameters are available for access method AM=STD
in z/OS environments:
REREAD
| FREE
| BUFNO
| DISP
| VMAX
REREAD=value
specifies the REREAD
option for the closing of the tape file.
Value | Explanation |
---|---|
ON |
The REREAD option is set for the CLOSE
SVC . This causes the volume to be repositioned to reprocess the data
set .
This is the default value. |
OFF |
The REREAD option is not set for the
CLOSE SVC .
|
FREE=value
specifies whether the data set is
de-allocated when the file is closed.
Value | Explanation |
---|---|
ON |
The FREE option is set for the CLOSE
SVC , which means that the data set is de-allocated when it is closed
(and not at step termination).
|
OFF |
The FREE option is not set for the
CLOSE SVC .
This is the default value. |
BUFNO=value
specifies the default number of
z/OS I/O buffers of the data set.
Value | Explanation |
---|---|
0 or 1 - 255 |
Default number of z/OS I/O buffers of the data set. |
0 |
In this case, z/OS allocates five I/O buffers.
This is the default value. |
Notes:
BUFNO
specification applies only if the
BUFNO
parameter is not specified in the JCL for the data
set.
DISP=value
specifies whether the print file is
opened for modification.
Value | Explanation |
---|---|
MOD |
New records are added at the end of the file. |
NOMOD |
The print file is rewritten from the start.
This is the default value. |
Note:
This subparameter corresponds to the JCL DD statement parameter
DISP=MOD
.
VMAX=value
controls the
LRECL
setting for an output file with variable record format
(RECFM=V
).
Value | Explanation |
---|---|
ON |
Providing a non-zero BLKSIZE value
exists for the file, VMAX=ON sets LRECL=BLKSIZE-4 for
variable record format, regardless of the LRECL setting
in the DCB or the LRECL
subparameter.
|
NAT |
LRECL is set to the length +4 of the
largest record in the application program if this value is less than
LRECL in the DCB for the data
set.
|
OFF |
LRECL from the DCB for
the data set or the LRECL subparameter is used.
This is the default value. |
The following keyword subparameters are available for access method AM=CICS
:
TYPE=value
specifies the type of CICS storage
medium to be used.
Value | Explanation |
---|---|
MAIN |
Temporary main storage. |
AUX |
Temporary auxiliary storage. |
TD |
Transient data. |
Note:
The default value used depends on the setting of subparameter DEST
. If the
DEST
subparameter value matches a valid CICS transient data
queue, the TYPE
subparameter defaults to TD
,
otherwise MAIN
will be taken as the default value.
DISP=(value1,value2)
specifies the CICS temporary storage queue disposition.
Value Pair | Explanation |
---|---|
(NEW,KEEP) |
The storage queue is deleted when the file is opened.
This is the default value. |
(NEW,DELETE) |
The storage queue is deleted when the file is opened and when it is closed. |
(OLD,DELETE) |
The storage queue is deleted when the file is closed. |
(OLD,KEEP) |
The storage queue is not deleted. |
DISP=(NEW,DELETE)
Note:
The DISP
specification does not apply to CICS
extra-partition transient data queues.
The following keyword subparameter is available for access method AM=COMP
(Com-plete):
DRIVER
DRIVER=value
specifies the name of the
Com-plete print driver to be used.
The following keyword subparameter is available for access method AM=SMARTS
(Com-plete):
DEST
DEST=value
specifies the logical printer.
Value | Explanation |
---|---|
print-server-queue |
The environment variable
SAG_APS_LPD_xyz defines a logical
printer under Com-plete, where xyz is
the name of the print server queue.
If the environment variable
For more information, see the Complete Initialization and Startup Manual, section Defining Terminals and Printers. |
printer-file-name |
If no print server queue for that printer is available,
DEST specifies a printer file name. It specifies the
location of the output file in the file system. The name of the output file is
generated from the UserId and a sequence number.
Since the
|
NAT_PRINT_ROOT=/nat/printer DEST=printer1 UserId=xyz
The first output will be written to file /nat/printer/printer1/xyz1
.
To specify a file with absolute path definition, the OUTPUT
clause of the
DEFINE PRINTER
statement
must be used.
The following keyword subparameters are available for AM=IMS
:
For possible values and further information, see Support of the Natural WRITE (n) Statement in the Natural under IMS TM part of the TP Monitor Interfaces documentation.
BLKSIZE=value
specifies the size of the print
buffer sent to the IMS TM destination.
DRIVER=value
specifies the name of the Natural
IMS print driver to be used.
With the following keyword subparameters, you can set the default values for the
DEFINE PRINTER
statement
options of the same names. When a printer is closed, all DEFINE PRINTER
statement options are reset to their default values.
PROFILE
| NAME
| FORMS
| DISP
| COPIES
| CLASS
| PRTY
PROFILE=value
specifies the name of the printer
control characters table (NTCCTAB
macro).
NAME=value
specifies the listing name.
FORMS=value
specifies the listing forms
name.
DISP=value
specifies the listing disposition
(HOLD
, KEEP
, DELETE
or LEAVE
).
COPIES=value
specifies the number of copies to
be printed (1 - 255
).
CLASS=value
specifies the spool class (1
byte).
PRTY=value
specifies the listing priority
(1 - 255
).