Guardian Programming Reference Summary for pTAL and TAL

Procedure Calls Summary (D-F)
Guardian Programming Reference Summary for pTAL and TAL—522631-001
5-59
FILENAME_SCAN_
Checks for valid file-name syntax and returns the length in bytes of that part of the input
string that constitutes a file name.
<12> If a DEFINE name is supplied for partialname, and if the DEFINE
contains only a file name (that is, it is a simple MAP DEFINE), then
FILENAME_RESOLVE_ returns that file name as the result. If neither this
option nor options.<11> is specified, then the DEFINE name is returned as
the result.
<13> If a logical device number (LDEV) appears as part of partialname,
FILENAME_RESOLVE_ translates it to the corresponding symbolic device
name.
<14> A single name part supplied in partialname is to be treated as a subvolume
name or pattern.
<15> All alphabetic characters in the resolved file name are to be shifted to upper
case.
override-name:length, STRING .EXT:ref:*,INT:value input:input
search:length, STRING .EXT:ref:*,INT:value input:input
defaults:length, STRING .EXT:ref:*,INT:value input:input
error := FILENAME_SCAN_ ( string:length
,[ count ]
,[ kind ]
,[ entity-level ]
,[ options ] );
error, INT returned value
string:length, STRING .EXT:ref:*,INT:value input:input
count, INT .EXT:ref:1 output
kind, INT .EXT:ref:1 output
0 File name (that is, the name of an entity).
1 File-name pattern. This value can be returned only if options.<15> is set to 1.
If the input is a name as well as a file-name pattern (that is, it does not contain an
asterisk or question mark), FILENAME_SCAN_ classifies it as a name and not a
pattern.
2 DEFINE name.
entity-level, INT .EXT:ref:1 output