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, TIAM). |
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 Under z/VSE, only 7-character names are supported. |
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. Under z/VSE batch access method (AM=STD ), a
valid ASA character must be supplied in column one of the output record if the
output file is a spool file, otherwise error NAT1530 will be issued.
|
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=STD
in z/VSE
environments:
SYSNR=value
specifies the
logical VSE SYS number.
Value | Explanation |
---|---|
1 - 99 |
Logical VSE SYS number.
Default value:
|
The z/VSE default SYS number for print file 11 is 11 + 40
>= SYS051
:
SYSNR=51
LABEL=value
specifies the
tape label processing.
Value | Explanation |
---|---|
ON |
The tape is in standard label format.
This is the default value. |
OFF |
The tape is unlabeled with front tape mark. |
NOTM |
The tape is unlabeled without front tape mark. |
REWIND=value
specifies the
action to be taken when a tape file is closed.
Value | Explanation |
---|---|
ON |
The tape is rewound when the file is
closed.
This is the default value. |
OFF |
The tape is not rewound when the file is closed. |
UNLOAD |
The tape is unloaded when the file is closed. |
The following keyword subparameters are available for access method
AM=STD
in BS2000
environments:
DISP=value
specifies the
open mode of the file.
Value | Explanation |
---|---|
EXT |
The open mode is set to
EXTEND .
|
NOEXT |
The open mode is set to the default
value OUTPUT .
This is the default value. |
FREE=value
specifies
whether the linkname of the file is released when the destination file is
switched over to another one.
Value | Explanation |
---|---|
ON |
The linkname is released. |
OFF |
The linkname is kept. |
DEFINE PRINTER (1) OUTPUT 'P01' WRITE (1) 'TEST' CLOSE (1) DEFINE PRINTER (1) OUTPUT 'FILE=REPORT01.NEW,LINK=LINKP01
If FREE=ON
is set, the linkname is released; with
FREE=OFF
, it is kept.
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
).