TRANSFER Reference Manual

SAVE-ITEM-BY-KEY
TISERV UOW Descriptions
2–452 069139, Update 1 to 40969 Tandem Computers Incorporated
If you set QUANTITY to 0 and UNITS to F or P:
F specifies the folder default should be used. The retention time for the
individual item becomes the same as the retention time for the folder in
which it resides.
P specifies the profile constraint. The retention time for the individual item
becomes the same as the retention time for the depot in which it resides.
For example, to save the item in the folder and not have the item automatically
unsaved, specify the following values:
1. Set DATE-IS-REL to Y
2. Set UNITS to M, H, or D
3. Set QUANTITY to 0
APPLIC-KEY-LEN
is the length, in bytes, of the ordering key by which items are stored in the folder.
The length of the key must be a constant from 0 through 200 and must match the
length of the key specified in the APPLIC-KEY field.
If variable APPLIC-KEY-LENs are used to save items within the same folder,
ordering anomalies can exist in folders that are ordered in descending sequence or
that allow duplicates; therefore, APPLIC-KEY-LEN should contain a fixed length
for a given folder. The application should pad short keys with an application-
specific pad character.
If APPLIC-KEY-LEN is less than 0 or greater than 200, the error E-INVALID-KEY-
LEN is returned.
APPLIC-KEY
is the ordering key of the item. This key is supplied by the application. The length
of this key must match the length specified in APPLIC-KEY-LEN.
Note UOWs must start on word boundaries. If APPLIC-KEY-LEN contains an odd value and other UOWs
follow this one in the request, you must append a one-byte filler character to APPLIC-KEY.