Explanation
VTAM® issues
this message during processing of VTAM start
options or in response to a DISPLAY VTAMOPTS or MODIFY VTAMOPTS command
when an error is encountered while processing option.
option is
the name of the start option that was ignored.
reason indicates
the reason for the problem and is determined by when the error occurred.
- If the error occurred during the processing of VTAM start options, reason can
be one of the following:
- COUPLING FACILITY NOT SUPPORTED
- The coupling facility is not supported by the current version
of MVS™. There is no active CFRM
policy or no CFRM data set.
- CPC IS NOT A MEMBER OF AN ENSEMBLE
- The central processing complex (CPC) is not configured as a member
of an ensemble network.
- HARDWARE SUPPORT NOT AVAILABLE
- The required hardware support associated with this option is not
available.
- HPR FUNCTION NOT SUPPORTED
- This start option requires the NODETYPE to be NN.
- HPR PATH SWITCH NOT SUPPORTED
- This start option requires the specification of HPR=RTP.
- INSUFFICIENT STORAGE
- There was insufficient common or private storage to process this
start option.
- LLINES NO LONGER SUPPORTED
- This value (LLINES) for the OSITOPO start option is not supported
by the current version of VTAM.
- NO LONGER SUPPORTED
- This start option is not supported by the current version of VTAM.
- NOLLINES NO LONGER SUPPORTED
- This value (NOLLINES) for the OSITOPO start option is not supported
by the current version of VTAM.
- NOT A USS TABLE
- The table identified by the USSTAB start option is not a USS table.
- NOT VALID DUE TO HPR CAPABILITY
- This start option requires the specification of HPR=RTP.
- RESULTING STRUCTURE NAME TOO LONG
- Either the MNPS structure name specified by the STRMNPS start
option or the Generic Resource structure name specified by the STRGR
start option is too long (longer than 14 characters) to be suffixed
by the XCFGRPID value specified.
- VALID ONLY FOR ICN
- This start option is valid only for an interchange network node.
- VALID ONLY FOR ICN OR MDH
- This start option is valid only for an interchange network node
or migration data host.
- VALID ONLY FOR NETWORK NODE OR MDH
- This start option is valid only for a network node or migration
data host. It is not valid for an end node that supports only APPN
functions.
- XCF NOT SUPPORTED
- Either the sysplex is unavailable or you are running with a level
of MVS that does not support
XCF.
- If the error occurred in response to a DISPLAY VTAMOPTS command, reason can
be one of the following:
- CANNOT BE DISPLAYED
- This start option is not valid on the DISPLAY VTAMOPTS command.
- HAS NOT BEEN MODIFIED
- This start option cannot be displayed because FORMAT=MODIFIED
was specified on the command, and this start option has not been modified
since VTAM was initialized.
- UNRECOGNIZED OPTION
- option is not a valid VTAM start option.
- If the error occurred in response to a MODIFY VTAMOPTS command, reason can
be one of the following:
- CANNOT BE MODIFIED
- This start option is not valid on the MODIFY VTAMOPTS command.
- CANNOT VERIFY IF CONFLICT EXISTS
- This start option cannot be modified because VTAM is unable to verify if the start option
is in conflict with other start options specified on the MODIFY command. VTAM can process up to eight conflicting
start options on a MODIFY VTAMOPTS command. If more than eight are
specified, VTAM cannot verify
whether a conflict actually exists.
- CPC IS NOT A MEMBER OF AN ENSEMBLE
- The central processing complex (CPC) is not configured as a member
of an ensemble network.
- EE XCA MAJOR NODE MUST BE INACTIVE
- This start option cannot be modified while the XCA major node
representing Enterprise Extender connections is active.
- HARDWARE SUPPORT NOT AVAILABLE
- The required hardware support associated with this option is not
available.
- INSUFFICIENT STORAGE
- There was insufficient private storage to process this start option.
- IPADDR OBTAINED FROM TCP STACK
- This start option cannot be modified because VTAM has acquired the local IP address to use
for all Enterprise Extender connections from the TCP/IP stack.
- LLINES NO LONGER SUPPORTED
- This value (LLINES) for the OSITOPO start option is not supported
by the current version of VTAM.
- NOLLINES NO LONGER SUPPORTED
- This value (NOLLINES) for the OSITOPO start option is not supported
by the current version of VTAM.
- SAWDATA REQUIRES SAW DATA FILTER
- This value (SAWDATA) for the SAVERSCV start option is not valid
on the MODIFY VTAMOPTS command because there is not an active SAW
filter table.
- SPECIFIED VALUE NOT VALID
- The specified value for this start option is not a valid value
for this option.
- UNRECOGNIZED OPTION
- option is not a valid VTAM start option.
- VALID ONLY FOR A NETWORK NODE
- This start option is not valid on the MODIFY VTAMOPTS command
because it applies only to a network node configuration. This VTAM must be configured as a network
node in order for this start option to be modifiable.
- VALID ONLY FOR AN APPN NODE
- This start option is not valid on the MODIFY VTAMOPTS command
because it applies only to an APPN configuration. This VTAM must be configured as a network node, interchange
node, end node, or migration data host in order for this start option
to be modifiable.
- VALID ONLY FOR AN END NODE OR MDH
- This start option is only valid at end nodes and migration data
hosts (MDH).
- VALID ONLY FOR ICN
- This start option is not valid on the MODIFY VTAMOPTS command
because it applies only to an interchange network node configuration.
- VALID ONLY FOR ICN OR MDH
- This start option is not valid on the MODIFY VTAMOPTS command
because it applies only to an interchange network node or migration
data host configuration.
- VALID ONLY FOR NETWORK NODE OR MDH
- This start option is not valid on the MODIFY VTAMOPTS command
because it applies only to a network node or migration data host configuration.
It is not valid for an end node that supports only APPN functions.
This VTAM must be configured
as a network node or migration data host in order for this start option
to be modifiable.
System action
- Processing of VTAM start
options
- If reason is STRUCTURE NOT DEFINED,
a connection attempt will not be made to the coupling facility structure.
VTAM initialization continues.
- If reason is NOT A USS TABLE, VTAM uses the IBM-supplied default
USS table.
- If reason is LLINES NO LONGER SUPPORTED,
or NOLLINES NO LONGER SUPPORTED, VTAM will
ignore this value for OSITOPO. If other values have been specified
for OSITOPO, they will be processed.
- For all other reasons, VTAM ignores this start option, but the processing
of VTAM start options continues.
- DISPLAY VTAMOPTS command
- VTAM does not display this
start option.
- MODIFY VTAMOPTS command
- VTAM ignores this start
option. If there are other valid options specified on the MODIFY VTAMOPTS
command, processing of the command continues.
Operator response
- Processing of VTAM start
options
Provide the start options used to start VTAM.
- DISPLAY VTAMOPTS command
- MODIFY VTAMOPTS command
- For CANNOT VERIFY IF CONFLICT EXISTS, issue multiple MODIFY
VTAMOPTS commands with a single start option specified instead of
issuing a single MODIFY VTAMOPTS with multiple start options specified.
In particular, do not specify two or more conflicting start options
on the MODIFY command. See the z/OS Communications Server: SNA Resource Definition
Reference and z/OS Communications Server: SNA Operation for details about start option conflicts
when specified on MODIFY VTAMOPTS.
- For EE XCA MAJOR NODE MUST BE INACTIVE and IPADDR OBTAINED
FROM TCP STACK, the XCA major node that represents the
Enterprise Extender connections must be inactive before this
start option can be modified. Issue VARY INACT,ID=XCA_majornode_name to
deactivate the XCA major node if the start option modification
must be made immediately; otherwise, wait for all Enterprise
Extender connections to end and then issue the VARY INACT
command.
- For INSUFFICIENT STORAGE, wait a short time and reenter
the command. If VTAM continues
to issue this message, enter the DISPLAY BFRUSE command to display
information about total VTAM private
storage. Issue the DISPLAY STORUSE command to display storage usage
for storage pools. Save the system log and request a dump for problem
determination.
- For SPECIFIED VALUE NOT VALID, ensure that you entered option correctly.
See z/OS Communications Server: SNA Operation to check values that are valid
for this start option.
- For UNRECOGNIZED OPTION, ensure that you entered option correctly.
See z/OS Communications Server: SNA Operation to check options that are valid
for the MODIFY VTAMOPTS command.
- For VALID ONLY FOR A NETWORK NODE, save the system log
for problem determination. Message IST1348I is issued during VTAM initialization and in response
to the DISPLAY VTAMOPTS command and displays the node type of this VTAM.
If node type in message
IST1348I is NETWORK NODE or INTERCHANGE NODE, this VTAM is a network node.
- For VALID ONLY FOR AN APPN NODE, save the system log for
problem determination. Message IST1348I is issued during VTAM initialization and in response to the DISPLAY VTAMOPTS
command and displays the node type of this VTAM.
If node type in message IST1348I is END
NODE, INTERCHANGE NODE, MIGRATION DATA HOST, or NETWORK NODE,
this VTAM is an APPN node.
Otherwise, this node is a SUBAREA NODE.
- For VALID ONLY FOR ICN, save the system log for problem
determination. Message IST1348I is issued during VTAM initialization and in response to the DISPLAY
VTAMOPTS command and displays the node type of this VTAM.
If node type in message IST1348I
is INTERCHANGE NODE, this start option can be modified in this VTAM.
- For VALID ONLY FOR ICN OR MDH, save the system log for
problem determination. Message IST1348I is issued during VTAM initialization and in response to the DISPLAY VTAMOPTS
command and displays the node type of this VTAM.
If node type in message IST1348I is INTERCHANGE
NODE, or MIGRATION DATA HOST, this start option can be
modified in this VTAM.
- For VALID ONLY FOR NETWORK NODE OR MDH, save the system
log for problem determination. Message IST1348I is issued during VTAM initialization and in response
to the DISPLAY VTAMOPTS command and displays the node type of this VTAM.
If node type in message
IST1348I is NETWORK NODE, INTERCHANGE NODE, or MIGRATION
DATA HOST, this start option can be modified in this VTAM.
System programmer response
- Processing of VTAM start
options
- For HPR FUNCTION NOT SUPPORTED, stop VTAM, modify the NODETYPE start option to specify
NN, and restart VTAM.
- For HPR PATH SWITCH NOT SUPPORTED, stop VTAM, modify the HPR start option to specify
RTP, and restart VTAM.
- For INSUFFICIENT STORAGE, increase storage as required.
You can modify the CSALIMIT and CSA24 start options using the MODIFY VTAMOPTS
command.
- For NOT A USS TABLE, supply the operator with the name
of a valid USS table. The MODIFY TABLE command can be entered with
ID=ISTNOP to change the USS table used for operator messages and commands.
- For NOT VALID DUE TO HPR CAPABILITY, stop VTAM, modify the HPR start option to specify
RTP, and restart VTAM.
- For RESULTING STRUCTURE NAME TOO LONG, specify a shorter
(less than 15 characters) name on the STRGR or STRMNPS start option
keyword, and add a structure definition to the active CFRM policy
for the structure name suffixed by each of the possible subplex (XCFGRPID)
values.
- For STRUCTURE NOT DEFINED, define the structure name in
the active CRFM policy. See z/OS MVS Setting Up a Sysplex for more information on how to define a structure
in the CFRM policy.
- DISPLAY VTAMOPTS command
- MODIFY VTAMOPTS command
- For EE XCA MAJOR NODE MUST BE INACTIVE and IPADDR OBTAINED
FROM TCP STACK, specify the start option in the start option list
used to activate VTAM.
- For INSUFFICIENT STORAGE, increase storage as required.
- For VALID ONLY FOR A NETWORK NODE, review the system log
to correct the command issued and the definition statements (if appropriate).
To configure this VTAM as a
network node, you must specify NODETYPE=NN during start processing.
- For VALID ONLY FOR AN APPN NODE, review the system log
from the operator to correct the command issued and the definition
statements (if appropriate). To configure this VTAM as an APPN node, you must specify NODETYPE=NN
or NODETYPE=EN during start processing.
- For VALID ONLY FOR ICN, review the system log from the
operator to correct the command issued and the definition statements
(if appropriate). To configure this VTAM as
an interchange network node, you must specify NODETYPE=NN, HOSTSA=n,
and SACONNS=YES during start processing.
- For VALID ONLY FOR ICN OR MDH, review the system log from
the operator to correct the command issued and the definition statements
(if appropriate). To configure this VTAM as
an interchange network node, you must specify NODETYPE=NN, HOSTSA=n,
and SACONNS=YES during start processing. To configure this VTAM as a migration data host,
you must specify NODETYPE=EN, HOSTSA=n, and SACONNS=YES
during start processing.
- For VALID ONLY FOR NETWORK NODE OR MDH, review the system
log from the operator to correct the command issued and the definition
statements (if appropriate). To configure this VTAM as a network node, you must specify NODETYPE=NN
during start processing. To configure this VTAM as a migration data host, you must specify
NODETYPE=EN, HOSTSA=n, and SACONNS=YES during start
processing.
Routing code
Descriptor code