DSIV XPAR MULT ACTION (3343)    REMOTE PROCEDURE (8994)

Name Value
NAME DSIV XPAR MULT ACTION
TAG MULT
ROUTINE DSIVXPR
RETURN VALUE TYPE ARRAY
AVAILABILITY AGREEMENT
WORD WRAP ON TRUE
DESCRIPTION
This is a multi-function front end to the Parameter APIs.  It allows you 
with a single RPC call to take edit type actions on several 
parameter/entity/instance combinations.
 
You can only do these actions:  add, change, or delete
 
Each entry in the passed list is treated as if it was a separate RPC 
call.  Thus each entry is totally independent of the others.  So you can 
mix and match parameters, entities, instances, and actions.
INPUT PARAMETER
  • DSICLIST
    PARAMETER TYPE:   LIST
    MAXIMUM DATA LENGTH:   250
    REQUIRED:   YES
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    DSICLIST - required - p1^p2^p3^p4^p5^p6^p7  where
      p5 := new instance value
      p6 := format for GET1 call
      p7 := action to be taken - must be ADD, CHG, or DEL
            if p7 = "ADD" then for this list element perform ADD function
            if p7 = "CHG" then for this list element perform change value
                     for a parameter/entity/instance
            if p7 = "DEL" then for this list element perform delete of
                    of a parameter/entity/instance
     
    For p1 - p6 see the equivalent DSIC XPAR xxxxxx RPC definition to see 
    which p1 - p6 are required for the action requested
     
      p1 := entity - default to USR
      p2 := parameter name
      p3 := instance
      p4 := value
    
RETURN PARAMETER DESCRIPTION
Return the input array exactly like inputted except each array element 
NOTE:  The GUI program should check for the value in the Error Text field 
before reporting an error (p9). A -1 is a possible result from a
successful call to this RPC.
will have an 8th (or 8th and 9th tilde pieces)
 
So the return array will be LIST[n] = p1~p2~p3~p4~p5~p6~p7~p8~p9
where n=1,2,3,4,5,...
  p1~...~p7 will be exactly what was input
  if the action was successful, then p8 = 1 and there will be no p9
  if the action was unsuccessful, the p8 = -1, p9 = error message