Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (A-B)
Guardian Procedure Calls Reference Manual—522629-013
2-30
ALTER Procedure
(Superseded by FILE_ALTERLIST_ Procedure )
Table 2-2. ALTER Function Codes (page 1 of 2)
Code Description
1
File-code: Change the application defined file code associated with the file.
File codes 100-999 are reserved for use by HP. The
newvalue parameter
should be a one-word binary number.
2
Audited: Change the TMF audited characteristic of the file (
file-type.<2>
from FILEINFO or item 66 from FILE_GETINFOLIST[BYNAME
]_). The
newvalue parameter should be a 1-word binary number with a value of 1 to
make the file audited or a value of 0 to make it unaudited. Unless the value
of
partonly is 1, all alternate key files as well as all partitions will be
changed.
3
Refresh: Change the flag controlling whether the file’s EOF value is written
out each time it is changed (
file-type.<10> from FILEINFO or item 70 from
FILE_GETINFOLIST[BYNAME
]_). The newvalue parameter should be a
1-word binary number with a value of 1 to cause writing or 0 to avoid writing.
4
Oddunstr: For an unstructured file, make the file allow odd byte positioning
and transfers (indicated by
file-type.<12> from FILEINFO or item 65 from
FILE_GETINFOLIST[BYNAME
]_). The newvalue parameter must be a one-
word binary number with value of 1. Once set for a file, this characteristic
cannot be reset.
5
Alternate Keys: For a structured file, change the alternate key description.
The
newvalue parameter should be an array in the same format as the
alternate-key-params array of the CREATE procedure. This function
changes only the description in the primary file; no alternate key files are
purged or created. The
partonly parameter must be zero for this function.
This function is not supported for format 2 files.