Guardian Programming Reference Summary for pTAL and TAL

Procedure Calls Summary (D-F)
Guardian Programming Reference Summary for pTAL and TAL—522631-001
5-57
FILENAME_MATCH_
Determines whether one or more contiguous sections of a file name match the
corresponding sections of a file-name pattern.
<0:8> Reserved (specify 0).
<9> The search is to be executed in a nowait manner. The results of the search
are returned in system messages sent to $RECEIVE.
<10> Device simulation by subtype 30 devices is not to be supported.
<11> The search is not to include subprocesses.
<12> If an entity is encountered that is offline (that is, the system is not connected
or the device is down), an error is to be reported.
<13> If device-subtype is supplied, a file name must not match the device
subtype value to be returned.
<14> If device-type is supplied, a file name must not match the device type
value to be returned.
<15> If startname is supplied, and if the first name returned would be
startname, then that name is to be skipped and the following name should be
returned.
startname:length, STRING .EXT:ref:*,INT:value input:input
error := FILENAME_MATCH_ ( filename:length
,pattern:length
,[ generic-set ] );
error, INT returned value
2 Match; name fits pattern.
1 Partial match; name fits lefthand pattern sections.
0 No match; name does not fit pattern.
<0 An error occurred:
-1 Missing name parameter.
-2 Missing pattern parameter.
-3 Length error on name parameter.
-4 Length error on pattern parameter.
-5 Bounds error on generic-set parameter.