TRANSFER Reference Manual

GET-FOLDER-DESCR
TISERV UOW Descriptions
2–264 069139, Update 1 to 40969 Tandem Computers Incorporated
OPTIONS
provides additional criteria for saving items.
ASCENDING-SEQUENCE
indicates whether items are saved within the folder in ascending or
descending key order.
Y Items are saved in ascending key order.
N Items are saved in descending key order.
ALLOW-DUPLICATES
indicates whether or not duplicate keys are allowed.
Y Duplicate ordering keys are allowed.
N Duplicate ordering keys are not allowed. This field has no effect if the
ORDERING-DISCIPLINE is TIME-SAVED (T); TIME-SAVED
ordering already ensures a unique key.
RESERVED-2 through RESERVED-7
are reserved for use by Tandem. These fields must be set to N.
ITEM-RETENTION-TIME
specifies the length of time an item can be stored in the folder.
QUANTITY
must be in the range 0 through 9999. UNITS is the unit of time denoted in
QUANTITY. UNITS can be set to D (for days), H (for hours), or M (for
minutes). For any unit, 0 means no maximum (items are saved forever).
You can also set this field to P, provided that you set QUANTITY to 0. The
value P specifies that the profile constraint should be used. The item retention
time for the folder then becomes the same as the item retention time for the
depot in which it resides.
GET-FOLDER-DESCR Operation
GET-FOLDER-DESCR retrieves the ordering criteria and default item retention time
for the name assigned in FOLDER-NAME.
The UOW always returns the largest time unit. For example, a value entered as 60 M
is returned as 1 H, and a value entered as 75 M is returned as 75 M.
The fields in GET-FOLDER-DESCR-RSP are defined to coincide with those in ALTER-
FOLDER-DESCR UOW, so that you can use the results of a GET-FOLDER-DESCR
UOW in an ALTER-FOLDER-DESCR operation.