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/OSD
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
).