This Natural profile parameter is used to specify the parameters for
z/VSE batch. It corresponds to the NTVSEP
macro in the
Natural
parameter module.
Possible settings | See VSEP Parameter Syntax. | |
---|---|---|
Default settings | See default values of keyword subparameters. | |
Dynamic specification | yes | |
Specification within session | no |
The following topics are covered:
The VSEP
parameter is specified as follows:
VSEP=(keyword-subparameter=value,keyword-subparameter=value,...) |
The VSEP
parameter covers a subset of the
subparameters which are available with the
NTVSEP
macro. The following keyword subparameters are available with
VSEP
:
CANCEL
|
FILMNGR
|
FILSCAN
|
FLUSH
|
MAXABND
|
RCSIZE
|
RJEUSER
|
SEGMENT
|
TIOBSZ
|
USERID
For subparameter descriptions, see Keyword Subparameters.
The NTVSEP
macro is specified as follows:
NTVSEP CANCEL=value, * FILEID=value, * FILMNGR=value, * FILSCAN=value, * FLUSH=value, * LIBRID=value, * MAXABND=value, * RCSIZE=value, * RJEUSER=value, * SEGMENT=value, * SPOOLID=value, * TIOBSZ=value, * USERID=value, * WAITIME=value
For subparameter descriptions, see Keyword Subparameters.
CANCEL
|
FILEID
|
FILMNGR
|
FILSCAN
|
FLUSH
|
LIBRID
|
MAXABND
|
RCSIZE
|
RJEUSER
|
SEGMENT
|
SPOOLID
|
TIOBSZ
|
USERID
|
WAITIME
Note:
The VSEP
parameter covers only a subset of
the subparameters which are available with the NTVSEP
macro. For details, see VSEP
Parameter Syntax.
CANCEL=value
specifies how
the Natural z/VSE interface proceeds at session termination.
Value | Explanation |
---|---|
ON |
The Natural z/VSE interface cancels
the Natural batch job if an error has occurred during the session.
The job is not cancelled in the case of a
NAT9995 termination message or when a user terminates
the session with a Natural |
OFF |
The Natural z/VSE interface always
terminates with a return code.
This is the default value. |
FILEID=value
specifies a
string of characters which is checked against the start of a DLBL
or TLBL
file ID.
Value | Explanation |
---|---|
String of up to 8 characters. | Any character string, which must be enclosed in apostrophes if it contains special characters. |
IGNORE |
This is the default value. |
Notes:
NTVSEP
macro. It cannot be specified dynamically using the profile
parameter VSEP
.
DLBL
or TLBL
statements for CMWKFnn*
and/or
CMPRTnn*
are supplied in the
(partition) standard labels, but should not be used.
// DLBL CMPRT01,'...'
statement is found, it is not possible to direct a WRITE(1)
output
to a printer SPOOL
. To do so, use the JCS statement // DLBL
CMPRT01,'IGNORE'
and a suitable printer assignment of the relevant
SYSnnn
.
FILMNGR=value
specifies how a print or a work file is to be managed in Natural.
Value | Explanation |
---|---|
ON |
The fact that there is label
information for a print or a work file and the fact that
LABEL=ON or
LABEL=OFF is specified for an unlabeled work file indicates to
Natural that this file is available. In particular, this is relevant if the
Natural print and work files are to be managed by a file management system.
|
OFF |
The logical unit number of the Natural
print or work file must be assigned to the appropriate device type.
This is the default value. |
FILSCAN=value
specifies
whether print or work files are to be scanned.
Value | Explanation |
---|---|
ON |
The Natural z/VSE interface scans the
z/VSE label area for all Natural print and work files for which no specific
file access method has been defined via Natural profile parameters, as this may
cause overhead.
This is the default value. |
OFF |
Access to all Natural print and work files must be specified explicitly via Natural profile parameters in order to be "available". This concentrates all file access efforts on the defined files. |
FLUSH=value
specifies how
the Natural z/VSE interface is to proceed at session termination with the
CMSYNIN/CMOBJIN
card input files.
Value | Explanation |
---|---|
ON
|
At session termination, the Natural
z/VSE interface will read the SYSIN/SYSRDR/SYSIPT card input file
until EOF , unless EOF had been encountered by
Natural; this means that when driving the batch mode Natural session completely
with STACK data, an extra "/*" has to be provided in
the JCL for a CMSYNIN /CMOBJIN null file.
This is the default value. |
OFF |
No extra
SYSIN/SYSRDR/SYSIPT card input (null) file is required, if the
batch mode Natural session is completely driven with STACK data;
the SYSIN/SYSRDR/SYSIPT card input file is then left as is, thus
potentially resulting in INVALID STATEMENT operator prompts or job
cancellation due to INVALID STATEMENT , when the Natural
CMSYNIN /CMOBJIN had not been retrieved
completely.
|
LIBRID=value
specifies a
string of up to 8 characters which is checked against the start of a DLBL file
ID. If it matches, the remaining portion of that file ID is scanned for
information specifying a library member in a z/VSE library or library
chain.
Value | Explanation |
---|---|
String of up to 8 characters. | Any character string, which must be enclosed in apostrophes if it contains special characters. |
LIBR: |
This is the default value. |
Note:
This subparameter can be specified only in the
NTVSEP
macro. It cannot be specified dynamically using the profile
parameter VSEP
.
MAXABND=value
specifies
the maximum number of abends which NATVSE
tolerates (that is,
NATVSE
intercepts the abend and invokes the Natural abend handler)
until it assumes an unrecoverable abend situation or abend loop and terminates
the Natural session abnormally by itself.
Value | Explanation |
---|---|
Numeric. | Maximum number of abends. |
16
|
This is the default value. |
RCSIZE=value
specifies
the default roll cache size for a server environment for the case that the roll
cache size is not passed with the Initialize Environment request.
Value | Explanation |
---|---|
Numeric. | Default roll cache size in KB. |
0 |
This is the default value. |
Note:
This subparameter can be specified only in the
NTVSEP
macro. It cannot be specified dynamically using the profile
parameter VSEP
.
RJEUSER=value
defines
which user ID is to be set for submission via XPCC
macro requests.
Value | Explanation |
---|---|
|
The system variable
*INIT-USER is used as the mandatory submission
user ID.
|
(ON,NAT) |
The system variable
*USER is used as the mandatory submission user
ID.
|
OFF |
The user ID R000 is
used.
|
SEGMENT=value
specifies
how the Natural z/VSE interface is to behave at CLOSE
of an output
SPOOL
file (print or punch).
Value | Explanation |
---|---|
ON |
A file close is accompanied by a
POWER segment close unless CLOSE=FIN is in effect for
that file.
|
OFF |
The SPOOL file is closed
without closing the POWER segment.
This is the default value. |
SPOOLID=value
specifies a
string which is checked against the start of a DLBL file ID or the file ID of a
DEFINE PRINTER
or
DEFINE WORK FILE
statement.
Value | Explanation |
---|---|
String of up to 8 characters. | Any character string, which must be enclosed in apostrophes if it contains special characters. If it matches, the output will be directly spooled to POWER using POWER SPOOL access services. |
SPL2PWR |
This is the default value. |
Note:
This subparameter can be specified only in the
NTVSEP
macro. It cannot be specified dynamically using the profile
parameter VSEP
.
TIOBSZ=value
specifies the
size of the Natural I/O buffer which is used for all input and output
operations.
Value | Explanation |
---|---|
Minimum: 8 |
Size of the Natural I/O buffer in KB. |
8 |
This is the default value. |
USERID=value
specifies
the content of the system variable *INIT-USER
.
Value | Explanation |
---|---|
ON |
The following logic applies:
|
OFF
|
The VSE job name is taken for the
Natural user ID.
This is the default value. |
WAITIME=value
specifies a
time limit for session roll-out.
Value | Explanation |
---|---|
Numeric. | Time limit in milliseconds. |
1000 |
This is the default value. |
Notes:
CMROLL
call in
a Natural server environment: if the time interval passed in the
CMROLL
call is not less than the WAITIME
interval, the session is rolled-out and the its thread is released, while the
session is waiting.
NTVSEP
macro. It cannot be specified dynamically using the profile
parameter VSEP
.
VSEP=(FILMNGR=OFF,FILSCAN=OFF,FLUSH=ON,RJEUSER=(ON,NAT),SEGMENT=ON,USERID=ON)
NTVSEP FLUSH=ON, * FILEID=IGNORE, * FILMNGR=OFF, * FILSCAN=ON, * LIBRID='LIBR:', * MAXABND=16, * RCSIZE=0, * RCSIZE=0, * RJEUSER=ON, * SEGMENT=OFF, * SPOOLID='SPL2PWR', * TIOBSZ=8, * USERID=OFF, * WAITIME=1000