Previous Topic: Define the NVCV Subtask to Tivoli NetView

Next Topic: Place the DSIEX11 and XITCI Modules Into the Tivoli NetView Load Library

Working with Other Products › How Customizing Tivoli NetView Works › Create an Initialization Member for the NVCV Subtask

Create an Initialization Member for the NVCV Subtask

To create an initialization member for the NVCV subtask

  1. Create the initialization member in the Tivoli NetView DSIPARM library.
  2. Name this member with the same name specified in the definition statement for the NVCV subtask. See the MEM parameter that you previously worked with when defining the NVCV subtask to Tivoli NetView.
  3. Code the following mandatory parameter in the initialization member:
    NVCMID=NMDID

    Specifies the domain ID of the product region with which the NVCV subtask can communicate through the PPI.

    Note: For more information, see the Tivoli NetView for z/OS Customization: Using Assembler guide.

  4. The following optional parameters can be specified in the initialization member in any order:
    DSIEX11=modname

    Specifies the module the NVCV subtask calls before the subtask sends PPO messages to Tivoli NetView. The parameter list that is provided to the called module conforms to Tivoli NetView conventions for calling user exits. This parameter is optional and can be the same as the module you specified when customizing the Tivoli NetView user exits.

    ESTAE={YES | NO}

    Specifies whether the NVCV subtask is to set up its own abend exit, ESTAE. This parameter is optional.

    If YES is specified and if the NVCV subtask ends abnormally, the exit is invoked. The exit tries to write a formatted dump to the NVCVDUMP data set, and to log off the operator autotasks that were created when operators logged on to Tivoli NetView from this product.

    MSGS=msgsno

    Specifies the number of messages that the NVCV subtask can receive within any control time interval (see the SECS parameter mentioned later) from this product. The range is 1 through 32767, with a default of 500.

    OQLIM=oqlimno

    Specifies the limit to the number of messages that can be on the private queue of the NVCV task in Tivoli NetView at any one time.

    Tivoli NetView keeps track of the message count on the NVCV public queue. If the limit specified in the Tivoli NetView constants module is reached, Tivoli NetView issues a DSI374A message. To prevent a DSI374A message from being issued, the OQLIM parameter set for the NVCV task must have a value well below the limit set in the Tivoli NetView constants module.

    For a detailed explanation of the DS1374A THRESHOLD REACHED message, see the Tivoli NetView for z/OS Messages manual.

    If the buffer count exceeds the number specified by this parameter, the NVCV subtask deactivates itself by turning the TVBSTOP bit on and the TVBACTV bit off in the task vector block.

    When the message count drops to 75% of the limit, the NVCV task reactivates itself by turning the TVBSTOP bit off and the TVBACTV bit on. The default oqlimno is 1000.

    If the TVBSTOP bit is on, Tivoli NetView tasks cannot queue messages to the NVCV task.

    For a detailed explanation of the task vector block, see the Tivoli NetView for z/OS Customization: Using Assembler manual.

    SECS=secsno

    Specifies the control time interval. (See also the MSGS parameter previously mentioned.) The range is 1 through 359, with a default of 5. This parameter is optional.

    XITCI=modname

    Specifies the module the NVCV subtask calls before the subtask sends CNM data to Tivoli NetView. The parameter list that is provided to the called module conforms to Tivoli NetView conventions for calling user exits. This parameter is optional and can be the same as the module you specified when customizing the Tivoli NetView user exits.