1 03/31/83  display_file_value_
 2 
 3 
 4 Entry points in display_file_value_:
 5    (List is generated by the help command)
 6 
 7 
 8 :Entry: display_file_value_: 02/01/83  display_file_value_
 9 
10 
11 Function: outputs information about a file on a user-supplied switch.
12 
13 
14 Syntax:
15 dcl display_file_value_ entry (ptr, file, fixed bin (35));
16 call display_file_value_ (switch, a_file, code);
17 
18 
19 Arguments:
20 switch
21    is a pointer to the iocb of the switch on which output is to be
22    written.  If it is null, then iox_$user_output is used.  (Input)
23 a_file
24    is the file, variable, or constant whose value is to be displayed.
25    (Input)
26 code
27    is a standard status code.  (Output)
28 
29 
30 Notes:
31 The output produced is, first, the values of the two pointers that
32 comprise a file.  If the file is closed, then a note to that effect is
33 produced, and the values of the file attribute block are given, and
34 that is all.
35 
36 For all open files, the file name, address of its iocb, and pathname
37 are given.  If the file is neither stream nor record type, or if it is
38 both, then a note to the effect that the fsb is inconsistent is given.
39 Attributes relevant to the type of file (stream or record) are given.
40 For stream input files, the current input buffer is printed, with a
41 circumflex above the next character that is to be parsed.