Guardian Procedure Calls Reference Manual

generic-set
output
INT .EXT:ref:1
if status is 0, returns a value indicating whether filename is a member of, falls before, or
falls after the generic set of names defined by pattern. A name is part of the generic set if
it matches pattern up to the first wild-card character (* or ?). Valid values are:
The name falls before the first possible match.-1
The name falls within the set of possible matches.0
The name falls after the last possible match.1
Returned Value
INT
A status value that indicates the outcome of the call:
Match; the name fits the pattern.2
Partial match; the name fits the left-hand pattern sections.1
No match; the name does not fit the pattern.0
An error occurred; one of these values is returned:<0
Missing filename parameter.-1
Missing pattern parameter.-2
Length error on filename parameter.-3
Length error on pattern parameter.-4
Bounds error on generic-set parameter.-5
Considerations
CAUTION: Passing an invalid file name or file-name pattern to this procedure can result in a
trap, a signal, or data corruption. To verify that a file name or file-name pattern is valid, use the
FILENAME_SCAN_ procedure.
• filename and pattern must have the same level of left-hand qualification. For example,
if pattern has a node-name section, filename matches only if it contains a node name.
FILENAME_MATCH_ does not support file-name resolution with current default values; you
can use the FILENAME_RESOLVE_ procedure to resolve partially qualified file names before
calling FILENAME_MATCH_.
• Matching is syntactic only and does not involve lookups of actual processes, logical devices,
or other entities.
• FILENAME_MATCH_ does not use the process or system context (as defaulting would require),
so it can be used in environments where the process file segment (PFS) is not available.
584 Guardian Procedure Calls (F)