IST320I
DEFINITION configname NOT SUCCESSFUL — reason

Explanation

During activation of configuration configname, VTAM® detected an error in an NCP definition statement or VTAM definition statement.

reason can be one of the following:
  • DUPLICATE MACRO
  • INSUFFICIENT STORAGE
  • INVALID MAJOR NODE NAME
  • INVALID NAME
  • INVALID PARAMETER
  • INVALID VALUE
  • MISSING PARAMETER
  • MISSING MACRO
  • MISSING NAME
  • PARAMETER CONFLICT
  • SEQUENCE ERROR
  • SYNTAX ERROR

A second message, IST323I, provides details of the error.

System action

The VTAM network will not include configuration configname. If reason is INVALID MAJOR NODE NAME, the dynamic PUs and LUs supplied by the VTAM Configuration Services Exit will not be created.

Operator response

If reason is INSUFFICIENT STORAGE and VTAM has been initialized, wait a short time and attempt to reactivate configname. If VTAM continues to issue this message, enter the DISPLAY BFRUSE and DISPLAY STORUSE commands. Save the system log and request a dump for problem determination. If VTAM initialization failed, save the system log for problem determination.

For all other reasons, save the system log for problem determination.

System programmer response

Use the information in this message and in message IST323I to determine the cause of the error. Correct the definition statement.
  • If the error is in an NCP definition statement, correct the statement and regenerate the NCP.
  • If the error is in a VTAM definition statement, update the VTAM definition library to correct the definition of configuration configname. For more information on VTAM definition statements, see the z/OS Communications Server: SNA Resource Definition Reference .
  • If reason is INSUFFICIENT STORAGE, the storage required for internal VTAM tables is not available. Increase storage as required. For insufficient storage errors, you might want to redefine your buffer pool or CSA limits. If the start option cannot be modified using the MODIFY VTAMOPTS command, you must modify the VTAM start options file (ATCSTRxx) and restart VTAM to use the start option.
  • If reason is INVALID MAJOR NODE NAME, the VTAM Configuration Services Exit, ISTEXCCS, has supplied a major node name to VTAM that is not valid. The following rules apply to the name supplied:
    • configname must be 1-8 characters
    • The first character must be alphabetic or national; remaining characters must be alphabetic, national, or numeric
    • configname must not start with IST
    Based on the preceding rules, if a valid name is supplied and the major node already exists, the following rules must also apply to the major node name:
    • The resource must be a switched major node.
    • The switched major node must be dynamic.
    • The major node must be in an ACTIVE state.

    You can use the MODIFY EXIT command to install a new version of ISTEXCCS.

Routing code

2

Descriptor code

5

Parent topic: IST messages for VTAM network operators IST001I – IST399I