TRANSFER Reference Manual

ALTER-ITEM-DESCR
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–85
DEF alter-item-descr-rsp.
02 hdr.
03 self-ident PIC AA VALUE "UW".
03 uow-code TYPE BINARY 16 UNSIGNED
VALUE 116.
02 retn-code TYPE BINARY 16.
02 retn-code-detail TYPE BINARY 16.
END.
HDR
is the UOW header. The UOW-CODE value is 116.
ITEM-ID
identifies the item whose descriptor record is to be changed. To refer to an item
produced by a previous UOW within the same IPC, you can replace ITEM-ID with
ITEM-HANDLE, which is defined in the “Commonly Used Fields” subsection of
this manual.
UPDATE-CONTROL
is the counter used to control concurrent update operations. Enter the value
returned by the GET-ITEM-DESCR UOW. If the UPDATE-CONTROL field is
greater than 0, it must match the update control value stored in the database for
the update to succeed. If you set the UPDATE-CONTROL field to -1, the
TRANSFER delivery system does not check this field against the value stored in
the database. UPDATE-CONTROL values of 0 or less than -1 are invalid.
FIELDS-TO-ALTER
lets you select the fields to be altered within the item descriptor.
Y Select the field for alteration.
N Disable the field from alteration.
The meaning of each item descriptor field that your process can access is discussed
under ALTERABLE-FIELDS. You can retrieve all of these fields through the
GET-ITEM-DESCR UOW.
The alterable fields do not require system administrator capability for alteration.
If the item is alterable, a correspondent who has access to the item can modify it.