1 06/30/86 print_data_
2
3
4 Entry points in print_data_:
5 List is generated by the help command
6
7
8 :Entry: print_data_: 06/30/86 print_data_
9
10 Function: formats and prints the output of a PL/I put data statement.
11 The output switch for printing may be specified, as well as various
12 formatting options.
13
14 Syntax:
15 declare print_data_ entry char * varying ptr fixed bin 35;
16 call print_data_ put_data_string print_data_info_ptr code;
17
18
19 Arguments:
20 put_data_string
21 is the output of a PL/I put data statement. Usually obtained as
22 follows: put data xxx string put_data_string, where xxx is a
23 structure whose values are to be formatted and printed. Input
24 print_data_info_ptr
25 is a pointer to a structure which describes the formatting options
26 to be used for printing the input. See Notes below. Input
27 code
28 is a system status code. Output
29
30
31 :Entry: rs: 06/30/86 rs
32
33 Function: formats the output of a PL/I put data statement. The result
34 is returned in a string. Various formatting options may be specified.
35
36 Syntax:
37 declare print_data_$rs entry char * varying ptr char * varying
38 fixed bin 35;
39 call print_data_$rs put_data_string print_data_info_ptr
40 return_string code;
41
42
43 Arguments:
44 put_data_string
45 is the output of a PL/I put data statement. Usually obtained as
46 follows: put data xxx string put_data_string, where xxx is a
47 structure whose values are to be formatted and printed. Input
48 print_data_info_ptr
49 is a pointer to a structure which describes the formatting options
50 to be used for printing the input. See Notes below. Input
51 return_string
52 is a string in which the output is returned. Input/Output
53 code
54 is a system status code. Output
55
56
57 Notes: The include file pointed to by print_data_info_ptr is declared
58 in print_data_info.incl.pl1 as follows:
59
60 dcl print_data_info_version_1 fixed bin options constant init 1
61 internal static;
62
63 dcl print_data_info_ptr ptr;
64 dcl 1 print_data_info based print_data_info_ptr,
65 2 version fixed bin,
66 2 indentation fixed bin,
67 2 value_column fixed bin,
68 2 output_switch ptr,
69 2 flags,
70 3 octal bit 1 unal,
71 3 hex bit 1 unal,
72 3 pad bit 34 unaligned,
73 2 intervals char 256 varying;
74
75
76 where:
77
78 version
79 is the version of this structure. It should be set to
80 print_data_info_version_1.
81 indentation
82 is the number of spaces by which structure level names are indented.
83 value_column
84 is the column in which the printing of values begins. The structure
85 names are indented, but the values all begin in the same column, so
86 this value should allow a reasonable amount of space for structure
87 names so they don't overlap the values column.
88 output_switch
89 is the output switch to use. This is ignored for the rs entry. If
90 it is null then user_output is used.
91
92
93 octal
94 specifies that bit string values should be converted to octal. This
95 is incompatible with the hex flag. The bit string value must be an
96 integral multiple of 3 bits long in order to be converted, otherwise
97 it is not converted.
98 hex
99 specifies that bit string values should be converted to hexadecimal.
100 This is incompatible with the octal flag. The bit string value must
101 be an integral multiple of 4 bits long in order to be converted,
102 otherwise it is not converted.
103 intervals
104 is not currently supported and must be set to the null string "".