1 02/03/84  vfile_status_
 2 
 3 
 4 Entry points in vfile_status_:
 5    (List is generated by the help command)
 6 
 7 
 8 :Entry: vfile_status_: 02/03/84  vfile_status_
 9 
10 
11 Function: returns various items of information about a file supported
12 by the vfile_ I/O module.
13 
14 
15 Syntax:
16 declare vfile_status_ entry (char(*), char(*), ptr, fixed bin(35));
17 call vfile_status_ (dir_name, entryname, info_ptr, code);
18 
19 
20 Arguments:
21 dir_name
22    is the pathname of the containing directory.  (Input)
23 entryname
24    is the entryname of the file of interest.  (Input) If the entry is a
25    link, the information returned pertains to the entry to which it
26    points.
27 info_ptr
28    is a pointer to the structure in which information is to be
29    returned.  (Input) See "File information" below.
30 code
31    is a storage system status code.  (Output)
32 
33 
34 File information:
35 The info_ptr argument points to one of the following structures which
36 are all declared in the include file vfs_info.incl.pl1.
37 
38 For unstructured files, use the uns_info structure.
39 
40 For sequential files, use the seq_info structure.
41 
42 For blocked files, use the blk_info structure.
43 
44 For indexed files, use the indx_info structure.
45 
46 
47 Notes:  The user must provide the storage space required by the above
48 structures.  The following declaration:
49 
50         dcl info aligned like indx_info;
51 
52 will provide the necessary space for the largest of the structures.
53 
54 See the description of the vfile_ I/O module for further details.