TRANSFER Reference Manual

ALTER-PROFILE-ELEM
TISERV UOW Descriptions
2–120 069139, Update 1 to 40969 Tandem Computers Incorporated
NUM-RETURNED
is the number of data elements that you alter. You can specify any number of
elements, restricted only by the length of the entire IPC that contains this UOW. In
the response, this field contains:
The number actually altered if no serious errors are detected
0 if serious errors are detected
ELEM-DATA-BLOCK
is used in Definition II only. It represents specific fields to be altered, and is either
36 or 84 bytes long. The format of the ELEM-DATA-BLOCK field is the same as
the format in which this field is returned by the GET-PROFILE-ELEM UOW. See
the description of the GET-PROFILE-ELEM UOW in this section.
You can specify several element blocks in one ALTER-PROFILE-ELEM UOW.
Long and short element blocks can, in fact, be mixed; TISERV accepts a mixture of
block lengths in one occurrence of this UOW.
For general applications (Definition I), you typically construct an ALTER-
PROFILE-ELEM UOW by specifying all fields up to and including NUM-
RETURNED, and then specifying separate definitions for each particular element.
Alternatively, you can define the element block as a DEPENDING ON
construction, using either PROFILE-ELEMENT-SHORT or PROFILE-ELEMENT-
LONG; notice, however, that this type of construction does not permit mixing both
long and short blocks. An example of an element block construction is:
DEF my-special-request TYPE
ALTER-PROFILE-ELEMENT-UOW.
02 data-depot-priorities TYPE *.
02 data-depot-mail-flags TYPE *.
02 data-depot-mail-filename TYPE *.
END.
For this example, NUM-RETURNED would be set to 3.