TRANSFER Reference Manual

GET-ITEM-NAME
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–297
GET-ITEM-NAME
(UOW Code 152)
GET-ITEM-NAME retrieves the name assigned to an instance of a named item saved
in a folder.
DEF get-item-name-uow.
02 hdr.
03 self-ident PIC AA VALUE "UW".
03 uow-code TYPE BINARY 16 UNSIGNED
VALUE 152.
02 folder-name PIC X(80).
02 item-id.
03 dummy PIC X(12).
END.
DEF get-item-name-rsp.
02 hdr.
03 self-ident PIC AA VALUE "UW".
03 uow-code TYPE BINARY 16 UNSIGNED
VALUE 152.
02 retn-code TYPE BINARY 16.
02 retn-code-detail TYPE BINARY 16.
02 folder-name PIC X(80).
02 item-id.
03 dummy PIC X(12).
02 unsave-time TYPE DATE-TIME.
02 simple-item-name PIC X(32).
END.
HDR
is the UOW header. The UOW-CODE value is 152.
FOLDER-NAME
is the name of a folder in which an instance of the item exists. The name can be
supplied in abbreviated form, but it must resolve to a unique and unambiguous
folder name. In the UOW response, this field contains the fully qualified name
assigned to the folder (including the correspondent name, folder name, system
trigger, and node name). If the request UOW contained an abbreviated name, the
fully qualified name returned can be useful for subsequent operations.
ITEM-ID
is the ID of the item whose name is to be returned. (The first item in the folder is
indicated by the value of the figurative constant LOW-VALUES.) In the UOW
response, the item ID is returned to this field. 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.