This Natural profile parameter specifies the maximum number of work files to be used
during the session. It corresponds to the NTWORK
macro in the Natural parameter
module.
Possible settings | See WORK Parameter Syntax. | |
---|---|---|
Default setting | See default values of the keyword subparameters described below. Depending on the access method and the environment, there may be different default settings. | |
Dynamic specification | yes | The parameter WORK can only be specified dynamically.
In the Natural
parameter module, the macro NTWORK must be
used.
|
Specification within session | no |
Notes:
WORK
or
NTWORK
can be specified multiple times.
AM
.
AM=STD
, they can be allocated
dynamically during the session by a Natural program using the DEFINE WORK FILE
statement or the
application programming interface USR2021
(in library
SYSEXT
).
This document covers the following topics:
With the WORK
parameter, you first specify one or more logical
work file numbers and then several keyword subparameters, which define the characteristics
for these work files:
WORK=((work-file-numbers),keyword-subparameters,...) |
Where:
Note:
To provide different work file definitions, WORK
can be
specified multiple times.
WORK=((2,12,18),AM=STD,DEST='WORK**') WORK=((1,3,6-11,15),AM=COMP,OPEN=INITOBJ,CLOSE=CMD)
With an NTWORK
macro, you first specify one or more logical work
file numbers, and then several keyword subparameters, which define the characteristics for
these work files:
NTWORK (work-file-numbers),keyword-subparameters,...
Where:
Note:
To provide different work file definitions, NTWORK
can be
specified multiple times.
NTWORK (2,12,18),AM=STD,DEST='WORK**' NTWORK (1,3,6-11,15),AM=COMP,OPEN=INITOBJ,CLOSE=CMD
The following keyword subparameters are available for all environments:
AM
| DEST
| OPEN
| CLOSE
| LRECL
| TRUNC
| PAD
| PADCHRO
| PADCHRI
AM=value
specifies the type of access method to
be used.
Value | Access Method |
---|---|
STD |
Standard sequential files (batch, TSO). |
COMP |
Com-plete work files. |
SMARTS |
SMARTS work files. Work file on a SMARTS Portable File System (PFS). |
CICS |
CICS transient data or temporary storage. |
PC |
Entire Connection. |
USER |
Third-party vendor work-file interface. |
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.
DEST=value
specifies the external data set
name.
Value | Explanation |
---|---|
1 - 8 characters or 1 - 7 characters, depending on access method and environment. | Name of the external data set.
Note: |
The meaning of the subparameter DEST
depends on the access
method specified with the AM
subparameter:
Access Method | Meaning of Keyword Subparameter DEST |
---|---|
AM=STD |
DEST is the logical data set name (DDNAME ,
LINK name, DTF name).
Notes:
|
AM=CICS |
There is no default value for work files under CICS. Here, the
DEST subparameter is mandatory; that is, CICS work
files defined without a valid DEST specification are
ignored.
Note: |
AM=COMP |
DEST defines the name of the Com-plete SD-file. The
length is restricted to a maximum of 8 characters.
Notes:
|
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 default value. |
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).
|
OBJ1 |
when the execution of the first object on level 1 which accesses the file starts. Otherwise, it is opened when it is first accessed. |
ACC |
when it is first accessed by a statement. |
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 which 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 |
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 value. |
FIN |
at session end.
Note: |
USER |
This value specifies that a work file is closed only if the file is open
and one of the following conditions is true:
|
LRECL=value
specifies the record length of the
data set.
Value | Explanation |
---|---|
0 or 5 - 32767 |
Record length of the data set (in bytes). |
0 |
This is the default value. |
Note:
This subparameter is used particularly to check for truncation and padding. For more
information on AM=STD
, see the keyword subparameter LRECL
in the section
Keyword
Subparameters for AM=STD in All Environments.
TRUNC=value
specifies whether the output
records are truncated or not.
Possible values:
Value | Explanation |
---|---|
ON |
Output records that are longer than the record length
(LRECL ) of the data set will be truncated.
|
OFF |
Error NAT1512 will be issued if an output record is longer
than the data set record length.
This is the default value. |
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 of output records if PAD=ON
is defined for the work file.
Value | Explanation |
---|---|
|
One character |
x'00' |
This is the default value. |
PADCHRI=value
specifies the character which is
used for padding of input records.
Value | Explanation |
---|---|
|
One character |
x'40' |
Blank.
This is the default value. |
The following keyword subparameters are available for AM=STD
in all environments:
RECFM=value
specifies the default record format
of the data set.
Supported formats:
Value | Format |
---|---|
F |
Fixed |
V |
Variable |
U |
Undefined |
B |
Blocked |
S |
Spanned |
A |
ASA |
M |
Machine control characters |
Possible values or combinations of values:
Value | Explanation |
---|---|
F, FA, FM, FB, FBA, FBM, V, VA, VM, VB, VBA, VBM, VBS,
VBSA, VBSM, U, UA, UM |
These values or combinations of values that can be specified. |
VB |
Variable blocked.
This is the default value. |
Note:
The RECFM
specification only applies if no record format is
predefined in the JCL or (under z/OS only) in the data set DCB.
BLKSIZE=value
specifies the default block size
of the data set.
Value | Explanation |
---|---|
|
Default block size of the data set (in bytes). |
4628 |
This is the default value. |
Note:
The BLKSIZE
specification only applies if no block size is
predefined in the JCL or (under z/OS only) in the data set DCB.
LRECL=value
specifies the record length of the
data set.
Value | Explanation |
---|---|
|
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: With
RECFM=V(B)
, LRECL
defaults to
BLKSIZE-4
. With RECFM=U
, LRECL
defaults to BLKSIZE
. With 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
, this leads to an
error.
LRECL
specification only applies if no record length
is predefined in the JCL or (z/OS only) in the data set DCB.
The following keyword subparameters are available for 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 |
With BUFNO=0 , z/OS allocates five I/O buffers
per default.
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 that the work file is
opened for modification.
Value | Explanation |
---|---|
MOD |
New records are added at the end of the file.
Note: |
NOMOD |
The work file is rewritten from the start.
This is the default value. |
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
is used.
This is the default value. |
The following keyword subparameters are available for 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 the 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 default value.
DISP=(value1,value2)
specifies the CICS temporary storage queue disposition.
Value Pairs | 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. |
Note:
The DISP
specification does not apply to CICS extra-partition
transient data queues.
The following keyword subparameters are available for AM=COMP
:
TYPE=value
specifies the type of storage access
to be used.
Value | Explanation |
---|---|
SHR |
Shared access; that is, the work file is accessible by all users. |
TID |
The work file is only available to the current Com-plete terminal ID. |
DYN |
The work file is only available to the current terminal stack level. |
BLOCKS=value
specifies the number of storage
blocks to be allocated.
Value | Explanation |
---|---|
1 - 9999 |
Number of storage blocks to be allocated. |
20 |
This is the default value. |
BLKSIZE=value
specifies the default block size
of the data set.
Value | Explanation |
---|---|
|
Default block size of the data set (in bytes). |
4628 |
This is the default value. |
The following keyword subparameters are available for AM=SMARTS
:
DEST=value
specifies the work file name.
Value | Explanation |
---|---|
1 - 8 characters. | Work file name. |
Notes:
DEST
clause is restricted to an 8 character
maximum, it is useless to define a file with absolute PFS path specification.
DEST
clause is relative to the
work file root directory. The work file root directory is specified with the
environment variable NAT_WORK_ROOT
.
DEFINE WORK FILE
statement.
TYPE=value
specifies the type of storage access
to be used.
Value | Explanation |
---|---|
BIN |
Each line is written to the work file without terminating
end-of-line character.
This is the default value. |
TXT |
Each line is written to the work file with a terminating
end-of-line character (x'15' ).
|
DISP=(value1,value2,value3)
specifies the mode
of the work file.
Value | Explanation | |
---|---|---|
value1 |
value1
specifies whether an existing file should be deleted or new data should be
appended to the file.
|
|
NEW |
An existing file will be deleted if the file is opened for
writing.
This is the default value. |
|
OLD or MOD |
New data written are appended at the end of the file. | |
value2 |
value2
specifies whether a file should be kept or removed after access.
|
|
KEEP |
Permanent file that will be kept after close.
This is the default value. |
|
DELETE |
Temporary file that will be removed after close. | |
value3 |
value3
specifies whether a user has exclusive access to the file or not.
|
|
SHR |
Shared access; that is, the work file is accessible by all
users.
This is the default value. |
|
OWN |
Exclusive access, the work file is accessible to the current Comp-lete user ID. Files with exclusive access are located in an additional directory which has the name of the current user ID. |
DISP=(NEW,KEEP,SHR)
If you specify only the first value (with or without parentheses), the other values will assume their default settings:
DISP=(MOD)
or
DISP=MOD
Both specifications correspond to:
DISP=(MOD,KEEP,SHR)