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

REP^XPAR(): Replace Instance Value

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

Description

The REP^XPAR API replaces the value of an instance with another value.

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

  REP^XPAR(entity,parameter,currentinstance,newinstance[,.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.
currentinstance:

(required) The instance for which the value is currently defined.
newinstance:

(required) The instance to which you want to assign the value that is currently assigned to currentinstance.

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.