Programming Reference Manual - Public Support Login - Unisys

Acquiring Program File Information
PACK_PF_TEXT_SIZE_TO_COPY
Indicates the amount of mass storage (in words) that would be copied if this file
were processed with the PACK_PF function. See C.1 for a description of how this
value affects PACK_PF function performance. Has a value of zero if the calling
program set GET_SUMMARY_INFO = FALSE.
Data Type: unsigned integer, returned
Notes: The following points apply to each item that returns the number of available
entries in a table of contents:
• For a standard program file, if a table is empty (current number of entries is zero), the
value that PCFP returns for the number of available entries in the table is also zero
even though in most cases entries can be added to the table.
• For a standard program file, PCFP calculates the number of available entries by
assuming that all tables that are currently empty remain empty. If an entry is added
later to a table that is currently empty, the number of entries available in other tables
might be significantly reduced.
• For a large program file, all tables have fixed sizes and a fixed maximum number of
entries. PCFP calculates the number of available entries by subtracting from the
fixed maximum the number of entries currently in the table.
• Some tables (for example, the COBOL procedure table) have variable-length entries.
PCFP calculates the number of available entries by assuming entries of maximum
size.
6.1.3. File Identifier
The file identifier parameter names the file from which information is to be acquired.
The named file must be a program file on sector-addressable mass storage for which the
calling program has read privileges. See 2.3 for a description of this parameter.
6.1.4. Work Area
The ACQ_BASIC_PF_INFO function operates with any work area greater than or equal to
the minimum size of 1,000 words. When the calling program sets
GET_SUMMARY_INFO = FALSE, this function never uses a work area larger than this
minimum. When the calling program sets GET_SUMMARY_INFO = TRUE, the function
works more efficiently with larger work area sizes. The actual memory usable by the
function varies with the size of the program file on which it operates. This function can
make effective use of about 200 + 10*N words, where N is the number of elements
(deleted and undeleted) in the program file. Thus, a work area size larger than the
minimum is used with a program file containing more than 80 elements. The maximum
size work area is used for program files containing about 2,000 or more elements.
6–10 7830 9796–013