I IOF I BEC
4. CULL Processor
4. 1. INTRODUCTION
This section describes the CULL processor which generates a listing of symbols, cross-referenced to the e!lement and line in which they are found.
4.2. @CULL
Scans a collection of symbolic elements and produces a cross-reference listing of the symbols found, the elements, and the lines on which they occur. A list of symbols which are either to be omitted from thEt sort or the only symbols to be included in the sort may be specified. The CULL processor is called by the @CULL control statement.
All parameters in the @CULL control statement are optional.
Format:
@ I abe I : CULL, opt ions p ro/sco I ( res) ,name-1, ... ,name-n.
Parameters:
options Specifies available options for obtaining sorted symbolic listings (see Table 4-1).
pro Specifies the symbolic elment being scanned/sorted. The possible values are:
ALG - ALGOL elements
ASM - 1100 Series assembly code COB - COBOL elements
DATA - all symbolic e,lements DOC - DOC elements
ELT - symbolic data element
4144.41
UfI-HUMIER
scol
res
names Description:
SPERRY UNIVAC 1100 Serle. Executive System Utility Programs
FOR - FORTRAN elements MAP - MAP elements PLS - PLUS elements If omitted, ASM is assumed.
UfIOA Tt lEVEL
I
flAGE 4-2Specifies the column number where the scan automatically stops. If omitted, the following values are assumed:
ASM- 40
ALG, COB, FOR - 72
DATA, DOC, ELT, MAP, PLS - 80
Specifies the number of mass storage positions reserved for scratch files. If omitted, 2 is assumed (approximately 70,000 references).
Specifies element or filenames in standard notation (see Volume 2-2.6.6).
Each file must be assigned or catalogued. If filename is not given, TPF$ is assumed. All files are returned to their original status when the CULL processor terminates. If a file is not a FASTRAND-formatted program file, an error is noted, and the parameter is ignored.
I
If read/write keys are necessary, they must be given in the first reference to the file. Keys appearing anywhere else are ignored.
The set of elements to be scanneo and sorted is formed in one of two ways:
• If an element name is a parameter, it is included in the scan/sort.
• If a filename is a parameter, the most recent cycle of each symbolic and procedure element is included in the scan/sort, unless the 0 and P options are specified.
Standard system dropout rules apply to both file and element name formats (see Volume 2-3.2.7).
Data images, following the @CULL control statement, are scanned for strings of characters separated by blanks; these strings are the special symbol table. If the M option is specified, only the symbols in .this table are accepted; if omitted, the symbols in this table are ignored. If the S option is used, the special symbol table is printed. Processing does not begin until the end of the data is encountered (indicated by encountering a control statement).
Certain options specify that a symbol which is found under special circumstances is to be marked.
When a symbol is to be marked, then all occurrences of that symbol elsewhere are to be marked.
If the N option is not specified, only unmarked symbols are printed. If the N option is specified, then only marked symbols are printed.
4144.41
UfI-HUMBEA
L
SPERRY UNIVAC 1100 Serie.ExecutlveI I
4-3System Utilhy Prog~r_a_m_s~~~~~~~~~~~~_u_~_A_n~~~L~~~_P_~_E~~_
The following special options are available:
• Special Options for Symbolic Data Elements
Tlhe data scanner accepts strings of characters from the set A-X, 0-9, $, and period (.) up to 1.2 characters in length. See Table 4-1 for the special options available only to the data scanner.
•. Scanner for Fortran Elements
Action is the same as data scanner, except comment lines are ignored.
• Scanner for COBOL Elements
Action is the same as data scanner, except symbols may be up to 30 characters.
• Special Options for Assembly Language Elements
The assembler scanner accepts strings which are valid identifiers or numbers in the 1100 Series assembly language. These strings may include up to 12 characters, and the symbol $ is recognized. The assembler scanner recognizes an identifier when it is a label, directive, or operand; occurrences of labels and directives are followed by
*
and 0, respectively. Labels defined at clnother level are marked with a double asterisk. The special options available to the as!sembler scanner are given in Table 4-1.Tllble 4-1. @CULL Control Stlltement, Options
OPtiO~~
____~
__~
____________~
___D_e_s_c_r_iP_t_i_o_n~~~~~
__~~
__~
____~~
__~
General Option.
C Produces a 72-column listing; omits list of elements processed and summary information at end.
E Does not eject the page. Otherwise. page eject for each time symbol begins with different character than pre"ious symbol.
H Coupled with the l option. produces page headings of the element name currently being listed.
l Produces a full listing of each element scanned/sorted.
M Only symbols in data images are accepted.
N Marked symbols only are printed; otherwise only ullmarked symbols printed.
o
Symbolic elements are not scanned.P Procedure elements are not scanned.
S Symbols in data images are printed.
Z ACCElpts symbolic elements with subtype _ O.
4144.41 UP-NUMBER
Option
SPERRY UNIVAC 1100 Serle, executive
System Utility Programs
r.blll 4-1. @CULL Control St.ttlmllnt, Option. (continulld)
Description
Special Option, for Symbolic Data Elements A Does not son strings beginning with an alphabetic character.
UPDATE LEVEL
o
Does not son strings beginning with any character from the set: 0-9, ., and period (.).Special Option, for AsHmbler Language Element.
A Does not son identifiers.
o
Sons numbers and the symbol t.N Prints only marked symbols (otherwise, prints only unmarked symbols).
4-4 'AGE
I Any symbol that appears in the special internal table is not soned. This table contains all symbols that are commonly used as directives, mnemonics, register names, and j designators. If the M option is specified, the internal table is Llsed as 8 supplement to the special symbol table.
a
Sons data items from the set A-Z, 0-9, ., and period (.) which are enclosed in quotes. These references are followed by a O.U Causes used symbols to be marked (and hence not printed in absence of N option, thus giving listing of symbols defined as labels but not otherwise referenced).
W Marks a symbol when it appears in the label field.
X Marks a symbol when it appears in the label field and is followed by an asterisk (*).
Y Restricts the Wand X options to elements explicitly named in the @CULL control statement.
Examples:
1. @CULL
2. @CULL,D ASM/SO(30),EXEC1. ,EXEC2. ,EXEC3. ,EXEC4.
3. @CULL,D DATA/SO(10),PRM/REV21 4. @CULL , Q*F . A, . B, . C, .0
1. Sorts all of the elements in the Temporary Program File (TPF$) using the assembler scanner.
2. Used to obtain a complete scan and sort of the assmebly language files EXEC 1 through EXEC4 and to reserve 30 positions of mass storage for use by the CULL processor.
3. Data element PRM/REV21 contains images for a document. This control statement is used to generate a glossary of words used.
4. Used to CULL elements A,B,C and D in file Q*F.
_ __ UP-NUMBER 4_1_44_'4_1__