PHASE II 4. Link Utilities
F. HARDWARE CONFIGURATION:
The 92~~II Configuration must be equipped with the hardware multiply/
divide/edit features.
Go TAPE PROCESSING CONSIDERATION:
It is advisable to have the "conunand" cards in the control stream deck in the same sequential order as the modules would appear on tape. This is to avoid getting "MODULE NOT ON TAPE" diagnostics.
The tape will be rewound by the cross-referencer when either of the two following conditions have been met:
1. The 'END' record on tape has been encountered subsequent to cross-referencing the module designated in the "conunand" card
without any intervening 'ELT' record. Processing resumes after the tape is rewound to load point.
2. If after reading another "command" from the control stream and the following conditions are met:
a. the tape is not on load point and
b. at least one 'ELT' record is detected subsequent to the module that has already been cross-referenced, and c. the module name specified in the current "conunand" card
is
n2i
found prior to encountering an 'END' record on that tape.~: "MODULE NOT ON TAPE" diagnostic will be issued. The next
"conunand" card is processed.
H. OOCUMENTATION:
Changes will be made to the TAPE UTILITY Manual UP-7727 to reflect this new feature.
APPENDIC P 4 of 4 9200/920011/9300/930011
Memo #147
.",,-,
APPENDIX Q. DISC CROSS-REFERENCING UTILITY
A. A new disc cross-referencing utility is now available.
The only fUnction of this utility is to cross-reference assembler source code from either 8411/14 disc or the control stream reader.
Input is controlled by command cards. The control character (specified when linking by "DEL") must appear in column 1 followed by at least one blank character. The "command" may be any word beginning with an
alphabetic character.
1. CARD INPUT. The command card has the following format:
\l COMMAND CARD$
EXAMPLE:
\l COpy CARD$
To list a module while cross-referencing card input, the
"command" word must begin with the letter "L".
EXAMPLE:
\l LIST CARD$
Listings will respond to SPACE, EJECT, and TITLE directives within the source element.
CARD$ identifies the input as coming from the control stream reader.
The source deck must immediately follow the "command" card.
2. DISC INPUT. The "command" card has the following format:
\l COMMAND GROUP-NAME/MODULE-NAME,L.U.#,FILE-NAME
The "command" may be any word beginning with an alphabetic character.
This could eliminate key-punching a new card if the card has been used in a LIBS run.
EXAMPLE:
\J
COpy /XREFIf the "command" word, as with card input, begins with the letter "L", the source element from disc will be listed.
EXAMPLE:
\l LIST /XREF
"GROUP-NAME" must be in the same format as a library services command ..
"MODULE-NAME" is the name of the source code module to be cross-referenced.
"L.U.#" is the logical unit number on which the module resides, expressed as one or two valid hexadecimal digits.
"FILE-NAME" is the name of the disc file-id (result of DASM) in which the module is to be found.
EXAMPLE:
v
COpy MACROLIB/UNIVAC/EXECMODL/JBCN,~~,SYSFILE9200/920011/9300/930011
Memo #147 1 of 6 APPENDIX Q
NOTE: If the logical unit number and file-name has not yet been specified, the default is to logical unit ¢, and "SYSFILE".
Otherwise the logical unit number and file-name from the previous "command" card will be used.
3. No further cards will be read from the control stream until the particular module in the "command" card has been cross-referenced.
Macro definitions may be included in the source code. All symbolic parameters containing an ampersand or a percent sign will be ignored.
Keyword parameters will not be cross-referenced (~.g. DISC;YES).
Any number of modules, in any combination of source inputs, may be cross-referencen in one run.
Each "command" card is checked for validity and invalid cards are flagged and ignored.
All literals and constants in the operand portion of the source input record will be ignored, except for address constants.
EXAMPLE 1:
CLC TAGA,;CL2¢"
where ;CL2¢' , will not be cross-referenced.
EXAMPLE 2:
CLC TAGA,;Y(TAGB)
where TAGB will be cross-referenced.
NOTE: No output disc file is required.
"**NO DATE**" will be printed on every header page of the listing if the supervisor's date contains a l I I bits (6 bytes of X'FF').
A 'DATE' card placed in front of the run deck will override the 'NO DATE' printout.
B. LINKING PROCEDURES:
The following elements are required to link the cross-reference utility:
1. DXREF - the relocatable supplied - for DISC and CARD cross-referencing.
~: DXREF uses the transient "FILE"?" to locate both the file-name and the module-name.
2. TPRYTR- The relocatable transient supplied for the printer I/O. This deck is for the bar printer only. If the user desires to
output his listing on the drum printer or the 1¢¢4 printer, etc., the user must assemble a new DTF element which uses such
printers. The filename of this IOCS routine should be 'TPRY' and the printer overflow routine must be specified as PROV;FFOV.
3. PLUN - the relocatable logical unit tables element generated during SYSGEN procedures.
4. DEL EOU 'n' - where 'n' (as in the LIBS manual) is the compressed code value, expressed in decimal or hexadecimal notation, of the control punches in column 1 of the "command" cards.
For example, if \l is desired as the control character, DEL EOU X'55; must be specified, and the punch is 12-¢-2.
APPENDIX 0 2 of 6
9200/920011/9300/930011 Memo #147
"'---/
It is possible to use the same card as in a LIBS run deck to
cross-reference a module by equating DEL to the same value as when LIBS was linked.
It is not necessary to link any control stream element to the program, since i t is part of the main cross-reference element - DXREF.
Cards are read from the control stream device as specified at systems generation time.
When linking the cross-referencer, DXREF must always appear last.
EXAMPLE: (a control stream linker deck run) / /
DEL
/*
EXEC DATA CTL PRGM LIBE EQU INCLUDE INCLUDE INCLUDE
DLll C card XREF,*
NONE X'55' (or /TPRYTR /PLUN /DXREF
DEL EQU 85)
The disc cross-reference routine will fit into 16K.
Symbols, when cross-referenced will appear in alphabetical order on the printout.
The cross-referencer uses all memory from the end of where the program is linked to the end of available memory for storage of symbols,
their references, etc.
The contents of the boundary table will be adjusted to reflect the memory available to the cross-reference routine when symbionts are used.
~: It is advisable to run the cross-referencer without symbionts because of memory limitations, and to prevent the cross-referencer from recycling itself and making more passes at the input source code than really required.
C. RESTRICTIONS:
At this time, i t is impossible to cross-reference a group. Each element to be cross-referenced must be specified.
9200/9200II/9300/9300I1
Memo #147 3 of6 APPENDIX Q