Explanation
XCF detected an incorrect keyword value member
while a system was being IPLed into the sysplex.
In the message
text:
- xx
- The suffix identifying the COUPLE parmlib member.
- keyword
- The keyword in error.
- n
- The line in the COUPLExx parmlib member containing the error.
- dev
- The duplicate device number.
- keytype
- The keyword type in error.
- classname
- The name of the transport class.
- item
- The name of the item in error.
- name
- The name of the transport class or group in error.
- strucname
- The name of the structure.
- parmlib
- The name of the parmlib member.
- statement
- The statement in error.
- KEYWORD keyword IS ERRONEOUS: SYSPLEX NAME
IS NOT VALID. ERROR IN LINE n.
- The sysplex name specified on the SYSPLEX keyword is not a valid
sysplex name.
- KEYWORD keyword IS ERRONEOUS: PRIMARY DATA
SET NAME OR VOLUME IS NOT VALID. ERROR IN LINE n.
- On the PCOUPLE keyword, one of the following is incorrect:
- The data set specified is not valid.
- The volume serial specified is not a valid volume serial.
- KEYWORD keyword IS ERRONEOUS: DEVICE NUMBER
MUST BE THREE OR FOUR HEX DIGITS. ERROR IN LINE n.
- The device number(s) for the signalling paths are not valid.
- KEYWORD keyword IS ERRONEOUS: ALTERNATE DATA
SET NAME OR VOLUME IS NOT VALID. ERROR IN LINE n.
- On the ACOUPLE keyword, one of the following is incorrect:
- The data set specified is not valid.
- The volume serial specified is not a valid volume serial.
- KEYWORD keyword IS ERRONEOUS: MAXMSG VALUE
MUST BE IN RANGE 1 TO 999999. ERROR IN LINE n.
- The MAXMSG value is not valid.
- KEYWORD keyword IS ERRONEOUS: CLASS NAME IS
NOT VALID. ERROR IN LINE n.
- The class specified on the CLASS keyword is not a valid class
name.
- KEYWORD keyword IS ERRONEOUS: TIME INTERVAL
MUST BE IN RANGE 3 TO 86400 SECONDS. ERROR IN LINE n.
- The time interval specified is not valid.
- KEYWORD keyword IS ERRONEOUS: RETRY LIMIT MUST
BE IN RANGE 3 TO 255. ERROR IN LINE n.
- The RETRY limit value specified is not valid.
- KEYWORD keyword IS ERRONEOUS: CLEANUP INTERVAL
MUST BE IN RANGE 0 TO 86400 SECONDS. ERROR IN LINE n.
- The interval specified for CLEANUP is not valid.
- KEYWORD keyword IS ERRONEOUS: CLASSLEN MUST
BE IN RANGE 0 TO 62464. ERROR IN LINE n.
- The transport class length specified for CLASSLEN is not valid.
- KEYWORD keyword IS ERRONEOUS: GROUP NAME IS
NOT VALID. ERROR IN LINE n.
- The group specified on the GROUP keyword is not a valid group
name.
- KEYWORD keyword IS ERRONEOUS: DUPLICATE KEYWORD
IS SPECIFIED. ERROR IN LINE n.
- The indicated keyword was specified more than once.
- KEYWORD keyword IS ERRONEOUS: OPNOTIFY VALUE
CANNOT BE LESS THAN INTERVAL VALUE. ERROR IN LINE n.
- The value specified for OPNOTIFY is less than the value specified
for INTERVAL. The system cannot notify the operator of a system failure
before the system detects the failure.
- KEYWORD keyword IS ERRONEOUS: TOO MANY CLASS
DEFINITIONS, LIMIT IS 62 NON DEFAULT CLASSES. ERROR IN LINE n.
- Too many transport classes are defined in the COUPLExx parmlib
member. The maximum does not include the default class.
- KEYWORD keyword IS ERRONEOUS: TOO MANY GROUPS
DEFINED, LIMIT IS 2045. ERROR IN LINE n.
- There are too many groups assigned to transport classes in the
COUPLExx parmlib member.
- KEYWORD keyword IS ERRONEOUS: GROUP COULD NOT
BE ADDED DUE TO STORAGE CONSTRAINTS. ERROR IN LINE n.
- XCF could not obtain the storage needed to add this group.
- KEYWORD keyword IS ERRONEOUS: TYPE NAME IS
NOT VALID. ERROR IN LINE n.
- The type name specified on the TYPE keyword is not valid. The
TYPE keyword is associated with the DATA statement.
- KEYWORD keyword IS ERRONEOUS: CTRACE PARMLIB
MEMBERS MUST BEGIN WITH 'CT' AND CHARACTERS 4-6 MUST BE 'XCF' OR 'XES'
AND CHARACTERS 7-8 CAN BE ANY VALID CHARACTERS. ERROR IN LINE n.
- A CTRACE parmlib member name was incorrect. The CTRACE parmlib
member name must be in format CTyXCFxx or CTyXESxx.
- KEYWORD keyword IS ERRONEOUS: STRUCTURE NAME
IS NOT VALID. ERROR IN LINE n.
- The structure name specified on the STRUCTURE keyword is not valid.
- KEYWORD keyword IS ERRONEOUS: CFRMOWNEDCFPROMPT
VALUE MUST BE YES OR NO. ERROR IN LINE n.
- The CFRMOWNEDCFPROMPT keyword value must be either YES or NO.
- KEYWORD keyword IS ERRONEOUS: VMCPUIDTOLERATION
VALUE MUST BE YES OR NO
- The VMCPUIDTOLERATION keyword value must be either YES or NO.
- KEYWORD keyword IS ERRONEOUS: REQUIRED KEYWORD
IS MISSING
- The indicated required keyword was not specified in the parmlib
member.
- KEYWORD keyword IS ERRONEOUS: DUPLICATE DEVICE
SPECIFIED: dev. ERROR IN LINE n.
- Device number, dev, was specified more than
once in the COUPLExx parmlib member.
- KEYWORD TYPE IN DATA IS ERRONEOUS: DUPLICATE TYPE SPECIFIED: keytype.
ERROR IN LINE n.
- The type name for keyword TYPE has been specified more than once.
The TYPE keyword is associated with the DATA statement.
- KEYWORD keyword IS ERRONEOUS: DUPLICATE LOCALMSG
SPECIFIED FOR CLASS classname. ERROR IN LINE n.
- More than one LOCALMSG statement was coded for a transport class.
Only one LOCALMSG statement can be coded per class.
- KEYWORD keyword IS ERRONEOUS: item name IS
NOT DEFINED. ERROR IN LINE n.
- A necessary item was not specified on the CLASSDEF statement.
- KEYWORD keyword IS ERRONEOUS: item name IS
MULTIPLY DEFINED. ERROR IN LINE n.
- A transport class name was specified on more than one CLASSDEF
statement.
- KEYWORD keyword IS ERRONEOUS: item name IS
MULTIPLY SPECIFIED. ERROR IN LINE n.
- A group name was specified more than once on the same CLASSDEF
statement.
- KEYWORD keyword IS ERRONEOUS: DUPLICATE STRUCTURE
NAME SPECIFIED: strucname. ERROR IN LINE n.
- Structure name, strucname, was specified more
than once in the COUPLExx parmlib member.
- KEYWORD keyword IS ERRONEOUS: DEVICE AND STRNAME
ARE MUTUALLY EXCLUSIVE. ERROR IN LINE n.
- DEVICE and STRNAME cannot be coded on the same PATHOUT or PATHIN
statement in the COUPLExx parmlib member.
- KEYWORD keyword IS ERRONEOUS: DUPLICATE SPECIFICATION
FOR THE parmlibXX PARMLIB MEMBER. ERROR IN LINE n.
- Parmlib member, parmlib, was specified more
than once.
- statement STATEMENT AT LINE n IS
ERRONEOUS: EITHER THE DEVICE OR STRNAME KEYWORD MUST BE SPECIFIED
- Either the DEVICE or STRNAME keyword must be specified on the
indicated statement type.
- KEYWORD keyword IS ERRONEOUS: CFRM POLICY NAME
IS NOT VALID. ERROR IN LINE n
- The CFRM policy name specification for the CFRMPOL keyword was
incorrect.
- KEYWORD keyword IS ERRONEOUS: OPNOTIFY VALUE
IS LESS THAN DERIVED SPIN INTERVAL
- The user-specified OPNOTIFY value is less than the derived spin
failure detection interval.
- KEYWORD keyword IS ERRONEOUS: FUNCTION NAME
IS NOT VALID
- Function names specified with the FUNCTIONS statement ENABLE or
DISABLE keywords must be 1-16 characters in length, inclusive. Valid
characters are alphabetic, national ($, @, or #), or underscore (_).
- KEYWORD keyword is ERRONEOUS: SYNCASYNC THRESHOLD
MUST BE 'DEFAULT' OR A NUMERIC VALUE IN THE RANGE 1-10000
- A SYNCASYNC conversion threshold specified by the SIMPLEX, DUPLEX,
LOCKSIMPLEX, or LOCKDUPLEX keyword must be either the string 'DEFAULT'
(to restore the system-determined default threshold), or a value between
1 and 10,000 microseconds.
System action
If the message contains the text OPNOTIFY
VALUE IS LESS THAN DERIVED SPIN INTERVAL, XCF records the
user-specified OPNOTIFY value. However, the effective OPNOTIFY value
actually used by the system is the effective failure detection interval
value. The IPL continues. Message IXC470I is issued to document
the specified OPNOTIFY value and the effective OPNOTIFY value being
used by the system.
For all other cases, XCF stops using the
COUPLExx parmlib member. The system issues message IXC201A to prompt
the operator for a new COUPLExx parmlib member.
Operator response
Correct the error indicated in the message
or notify the system programmer.
System programmer response
If the message contains
the text
OPNOTIFY VALUE IS LESS THAN DERIVED SPIN INTERVAL,
use the
DISPLAY XCF,COUPLE command to determine the
effective OPNOTIFY value, the effective failure detection interval
and the INTERVAL derived from the excessive spin parameters. The
DISPLAY command issues message IXC357I to report this information.
Determine whether the values are suitable and take the following
actions to change the values when needed:
- Use the SETXCF COUPLE command to dynamically change the OPNOTIFY
value; or make similar updates to the COUPLExx parmlib member to have
the change become effective at the next IPL.
- Use the SET EXS command to change the excessive spin recovery
parameters used to compute the derived spin INTERVAL.
For all other cases, correct the COUPLExx
parmlib member or specify a new one. If needed, ask the operator to
reIPL the system with the corrected COUPLExx parmlib member or a different
one if the wrong parmlib member was specified.
Source
Cross System Coupling Facility (SCXCF)
Module
Routing code
Descriptor code