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, TIAM). |
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=STD
in z/VSE
environments:
SYSNR
| LABEL
|
REWIND
|
BLOCKS
|
DISP
SYSNR=value
specifies the
logical VSE SYS number.
Value | Explanation |
---|---|
1 - 99 |
Logical VSE SYS number.
By default, the SYS number is identical to the work file number. |
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. |
BLOCKS=value
specifies the
number of file blocks or file tracks to be allocated for a dynamic
NATVSE
work file.
Value | Explanation |
---|---|
1 - 9999 |
Number of file blocks or file tracks to be allocated. |
20 |
This is the default value. |
Note:
See
NATVSE Dynamic Work File Allocation (DYNALLOC)
Support in the Operations
documentation.
DISP=(value1,value2)
specifies the disposition of a dynamic NATVSE
work file controlled
by VSAM/SAM.
Value Pair | Explanation |
---|---|
(NEW,KEEP) |
File is to be reset at open and to be kept at
close.
This is the default value. |
(NEW,DELETE) |
File is to be reset at open and to be made inaccessible at close. |
(OLD,DELETE) |
File is not to be reset at open and to be made inaccessible at close. |
(OLD,KEEP) |
File is not to be reset at open and to be kept at close. |
Note:
See
NATVSE Dynamic Work File Allocation (DYNALLOC)
Support in the Operations
documentation.
The following keyword subparameter is available for
AM=STD
in BS2000
environments:
DISP
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. |
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)