Kernel Toolkit 7.3 APIs Banner
Office of Information and Technology (OIT) Banner
[skip navigation]

NDEL^XPAR(): Delete All Instances of a Parameter

Reference Type: Supported, Category: Toolkit—Parameter Tools, ICR#: 2263

Description

The NDEL^XPAR API deletes the value for all instances of a parameter for a given entity.

REF: For descriptive information about the elements and how they are used in the callable entry points into XPAR, see the “Definitions” section in the "Toolkit—Parameter Tools" section in the Kernel 8.0 & Kernel Toolkit 7.3 Developer's Guide.

Format

  NDEL^XPAR(entity,parameter[,.error])

Input Parameters

entity:

(required) Entity can be set to the following:

  • Internal VARIABLE POINTER (nnn;GLO(123,).

  • External format of the VARIABLE POINTER using the three-character prefix (prefix.entryname).

  • Prefix alone to set the parameter based on the current entity selected.

This works for the following entities:

  • USR—Uses current value of DUZ.

  • DIV—Uses current value of DUZ(2).

  • SYS—Uses system (domain).

  • PKG—Uses the package to which the parameter belongs.
parameter:

(required) Can be passed in external or internal format. Identifies the name or internal entry number (IEN) of the parameter as defined in the PARAMETER DEFINITION (#8989.51) file.

Output Parameter

.error:

(optional) If used, must be passed in by reference. It returns any error condition that may occur:

  • 0 (Zero)—If no error occurs.

  • #^errortext—If an error does occur.

    The # is the number in the VA FileMan DIALOG (#.84) file and the “errortext” describes the error.

Example

     >D NDEL^XPAR(“SYS”,”XPAR TEST MULTI FREE TEXT”,.ERROR)