Automation Services Application Program Interface › $REDBAPI SERVICE=CREATE › How You Specify Field Values When Calling $REDBAPI from an NCL Procedure

How You Specify Field Values When Calling $REDBAPI from an NCL Procedure

If you are calling from an NCL procedure, consider the following:

• You can add the following statement before the call to share the field values:

  &CONTROL SHRVARS=(ZRE)
  

  Specify each value in ZREfield-name-n. In this case, you do not need to specify the field name operands. You can, however, override the specified variable values by using the operands.

  Important! If you share field values, the API ignores misspelled field names. If you misspell a name, the intended value is not set.

• You can use the following statement to preserve case-sensitive field values:

  &CONTROL NOUCASE
  

• If you use the operands to pass the values, beware of the following:
  • The maximum length of an &CALL or EXEC statement is 2048 characters.
  • Do not enclose values in quotes. Use variables to assign strings.
  • If a value contains blanks, then for an EXEC statement, use &CONTROL NOVARSEG and pass the value as a variable, for example:

        &CONTROL NOVARSEG
        &DESC=&STR SUPPRESSION RULES
        EXEC $REDBAPI SERVICE=CREATE … SDESC=&DESC …