Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-5
FILE_ALTERLIST_ Procedure
error-item output
INT .EXT:ref:1
if present, returns the index of the item in
item-list that was being processed
when an error was detected, or is one greater than the number of items if an error
was detected after the processing of individual items was completed. The index of
the first item in
item-list is 0.
Considerations
•
The specified file cannot be open when FILE_ALTERLIST_ is called.
•
The caller of FILE_ALTERLIST_ must have read and write access to the specified
file.
•
If a file attribute already has the value supplied to FILE_ALTERLIST_, no error is
returned.
•
Except as noted in the table below, the alterations are not made to alternate-key
files, but they are made to secondary partitions unless
partonly is 1.
•
If a partition or alternate-key file is not accessible, error 3 or 4 is returned. The
accessible partitions or alternate-key files are still altered.
Table 5-2. FILE_ALTERLIST_ Item Codes (page1of9)
Items in this table with a size of 2 bytes are of data type INT. The term “disk file”
applies only to Enscribe files. The term “disk object” applies to Enscribe files and
SQL objects.
Code
Size
(bytes) Description
42 2 File code. For disk objects other than SQL shorthand views, an
application-defined value associated with the file. File codes
100 to 999 are reserved for use by HP.
57 8 Expiration time. For disk objects other than SQL shorthand
views, the Julian GMT timestamp giving the time before which
the file cannot be purged.
65 2 Odd unstructured. For unstructured files, causes the file to
allow odd-byte positioning and transfers. The supplied value
must be 1. Once this attribute is set for a file, it cannot be
reset.
66 2
Audited file. A value of 1 if the file is to be a TMF-audited
object; 0 otherwise. Must be 0 for systems without the TMF
subsystem. Unless
partonly is 1, all alternate-key files and all
partitions are changed.