FAD XCA
CHAPTER 1: SCAT LISTINGS
Symbolic listings of a program reproduce, with some exceptions, the symbolic source program deck. The exceptions which are never reproduced are:
1. Invalid operation codes, which are replaced in the listing by
I II.
2. Invalid symbols, such as those longer than six characters, which are replaced by
1111//.
3. The shortened forms of extended operation codes, which are changed to, and listed in their extended forms, e. g., the instruction WRS 1169 is listed as WTBB 1.
In addition to the above, words generated by the BCI, DEC, DUP, LBR and OCT instructions or by macro-instructions are not normally listed in detail (see Chapter 3). Instead, only a "title line" and the first word generated by these instructions are printed. (The "title line" reproduces the card containing the BCI, DEC, DUP, LBR, OCT, or macro-instruction.) All generated words may, however, be listed by exercising one or more of the options available.
When a SQUOZE deck is listed, comments are aligned with the first comment in the program, and therefore may not be aligned as in the source deck.
Symbolic listings produced by SCAT may consist of four main parts:
A. The first part may be either of two items depending on whether the program is being processed by the Compiler or by Modify and Load.
1. During Compiler processing, this part is a listing of errors found in the program (see "Compiler Error Listing" below).
2. During processing by Modify and Load, this part is a listing of the
modification cards (if any) for the program and any errors found in those cards (see "Modifications Listing" below).
B. The next part produced is a listing of all inconsistently defined principal pseudo-operations and of all undefined and doubly-defined symbols in the program. (See "Symbol and Pseudo-Operation Error Listing. ")
C. The third part of the listing will be the symbolic program with absolute (octal) equivalents. (See "Program Listing. ")
04.01. 01 3 (1/61)
D. The final part is a (dictionary) listing of all symbols in the program which have been defined at least once. (See "Symbol Listing. ")
Each of these four parts of the listing is described in more detail in the following paragraphs.
COMPILER ERROR LISTING
The list of errors detected during the processing of a program will be headed by the statement
COMPILER ERROR LIST XX/XX/XX
where XX/XX/XX is the date of compilation, if supplied to the Compiler; other-wise it will be 0/ 0/00. This statement will be followed by a list of all instructions, including comments and alter numbers (see Chapter 2) in which errors were
found. Messages which indicate the type of errors found will be given following each instruction. If no errors are found by the Compiler, this part will consist of merely the statement
NO ERRORS FOUND BY COMPILER
MODIFICATIONS LISTING
A listing of all modification cards is always produced during processing of a EQUOZE deck, if the deck includes such cards. If no modification cards are included, this listing will, of course, be omitted.
The modifications listing may also include messages indicating errors found in modification cards. These messages will follow immediately after the cards in which the errors were found. Error messages (when using 32K SOS only) will be indicated by a row of asterisks to make them easily distinguishable.
04. 01. 02 3 (1/61)
A sample of a modifications listing is given below.
CHANGE CRTl+16,CRTl+17 ClM
llS 35
ALTER 45,46 ClM
llS 35
CHANGE ST AF<T+14 TIX
MISSING ADDRESS FIELD TAG AND/OR DECR EXPECTD
CHANGE CRTl+21,CRTl+22 Cll'Vl
llS 35
SYMBOL AND PSEUDO-OPERATION ERROR LISTING
This part of the listing is always given during processing of a program if errors of the types described below are detected.
The symbol and pseudo-operation error listing may consist of up to five parts as indicated below. Anyone or more of these parts will be omitted when no items are found which fall into the given category.
1. The first list which may appear in this part will be labelled "INCONSISTENTLY DE FINED PRIN PSEUDO OPS" and will be a list of all the principal pseudo-operations (BES, BOOL, BSS, END, EQU, HEAD, ORG, SYN, TCD), which have caused a circular definition of a symbol(s) in the program. A given principal pseudo-operation may appear more than once in the list if that pseudo-operation occurs in more than one instruction which has caused a circular definition. All items in the list are given in the order in which they are encountered.
2. The next list which may occur in this part is a list of all undefined symbols which occur in the program in connection with a principal pseudo-operation, i. e., in the variable field of a principal pseudo-instruction. This part is labelled "UNDEF SYMBOLS IN PRIN PSEUDO OPS. II
This list will also show the value which has been arbitrarily assigned to each symbol in the list.
3. The third list which may appear in this part is a list of all symbols which appear in the program in connection with principal pseudo-operations and
04.01.03 2 (2/60)
are defined more than once in the program. Each symbol listed will also show the arbitrary value assigned to it.
This list will be labelled "DOUBLY DEF SYMBOLS IN PRIN PSEUDO OPS."
4. Next may appear a list of all symbols in the program, other than those described in 2 above, which are undefined. The symbols given in this part also will be shown with the arbitrary values assigned them.
This list will be labelled "UNDEF SYMBOLS IN TEXT. "
5. The final list which may be given in this part is labelled "DOUBLY DEF SYMBOLS IN TEXT." This will be a list of all symbols, other than those described in 3 above, which are defined more than once in the program.
The arbitrary values assigned each symbol will also be shown.
PROGRAM LISTING
The third part of listings produced by SCAT will be a listing of the program itself. This part will occupy as many pages as is necessary.
Each page of this part will show the job identification, page number, and date in the upper right-hand corner. Page numbers will be assigned beginning with the first page of this part. The job identification and date will be given only if supplied with the program. (See the Monitor sector for information on how these are supplied.) If no date is supplied, 0/ 0/00 will be printed where the date would appear.
Up to fifty lines of the program will be printed on each page, and will include the symbolic program instructions and octal equivalents. These instructions will be given numbers from two reference systems (i. e., relative and alter numbers) which are assigned as described in Chapter 2.
SYMBOL LISTING
The last part of listings produced by SCAT will be a list of all defined symbols in the program, whether they are defined once or more than once. Six-character symbols will be listed first, followed by symbols less than six characters long which are not explicitly headed, followed by symbols which are explicitly headed.
The symbols will be listed in five columns and will be arranged alphabetically within each category. Symbols which are doubly-defined will be listed at the end in the order in which they were encountered, and will appear once for every appearance in a location field in the program.
04.01. 04 2 (2/60)
Any symbol in this list which is defined (whether once or more than once) but not used in the variable field of any instruction is indicated by an "*".
The number of the page on which a symbol appears in the location field of the program listing will be shown with the symbol. Thus, since doubly-defined symbols appear in the list once for each definition, all page numbers for doubly-defined symbols are shown.
A sample symbol listing is shown below.
PRCOMM 0001 RESTOR 0002 STRTWD 0001 SWITCH 0002
04.01.05 1 (11/59)
1S1811 0002 WKAREA 0001 CLEAR 0001 CON6 0001
EXIT IMAGE MASK PRINT
0002 0002 0002 0002
WRITE 0002 lNUM 0002 NUMBER *0002 NUMBER *0002
ZERO ZERO
*0002
*0002
LISTER