la, e
A user who does not have the macro assembler in the version of MSOS originally ordered from Control Data may add this product to his system. To do this, he must order the installation materials (see the MSOS Version 5 Ordering Bulletin). The macro assembler installation materials, on punched cards or magnetic tape, consist of a binary copy of each macro assembler program.
Since SYSDAT is not modified by this addition, the user need not rebuild the entire system using the techniques of section 5, method 1. Instead, by using the techniques of section 5, method 2, the user may generate a separate installation file for this product alone. This file is used to update the system library, thereby adding the new product to the system.
Using method 2, the installation steps are:
1. Use SKED utility to produce the m3.cro a~sembler
skeleton file. Records that compose the file are specified in this section.
2. Use the LIBILD utility to produce the macro assembler installation file, a complete and inde-pendent installation file containing the skeleton and binary programs for the macro assembler alone.
3. Use the LIBEDT utility to enter the macro assem-bler programs from the new installation file into the program library.
4. (Optional) The system may be verified in whole or in part using the verification procedures described in section 4.
The detailed procedures for steps 1, 2, and 3 are described below.
9.1 BUILDING MACRO ASSEMBLER INSTALLATION FILE SKELETON
If the system has a card reader, the skeleton records defined in figure 9-1 may be punched and used as the LIBILD skeleton input (described in section 9.2).
If no card reader is available, the skeleton records can be put onto magnetic tape using the following MSOS functions. The operator enters the job processor with:
*JOB
96769410 A
•
After the system repUes with:
J
the operator calls the library editor with:
*LIBEDT
to transfer the first two records of the skeleton to an output tape mounted on logical unit 6. After the library editor is loaded, transfer of records is accomplished by:
*T, 4, A, 6, A, 2 Transfers two records from the comment device to logical unit 6 (ASCII mode)
*K, 16, P8
*L, LIBMAC
*z
*z
J
First two records from figure 9-1 (macro-assembler skeleton records)Exit LIBEDT} Control statements;
Exit job not transferred to processor tape.
Next, the operator calls debug to close the file and to rewind the new tape:
MI DB
When the system replies that debug is loaded (DEBUG IN), the operator writes an end-of-file mark and rewind the tape:
WEF, 6,1 NEXT REW, 6 NEXT OFF
Write end-of-file mark.
Rewind tape.
Exit from debug.
The skeleton editor can now be used to build the remainder of the installation file. After entering the job processor, SKED is called with:
*SKED~
The computer replies with:
SKED IN NEXT
9-1
9-2
OPERATOH ENTERED CODE (SKELETON)
*K, 16, PB
*L, LIBMAC
*B'LIBMAC'
*L.ASSEM
*B 'ASSEM'
*K.PS
*P.F
*B 'PASS1'
*B 'PAIPR2'
*T
*K.IB
*N. PASS1 ••• B
*K.16
*K.PS
*P.F
*B 'PASS2'
*B 'PA2PR2'
*T
*K.IS
*N, PASS2 ••• B
*K,I6
*K,PS
*P,F
*B 'PASS3'
*B 'PA3PR2'
*B 'PA3PR3'
*T
*K.IS
*N. PASS3 ••• B
*K.16
*K.:PS
*P.F
*B 'TABLST'
*T
*K. IS
*N. TABLST ••• B
*K.I6
*K.PS
*P.F
*B 'XREF'
*K.IS
*N.XREF ••• B
*K.I6
*B 'MACSKL'
*B 'MACROS'
*z
*CTO, MACRO ASSEMBLER INSTALLED
*z
SKELETON DIRECTS PROCESSING AS SHOWN:
ALL INPUT IS FOR LOGICAL UNIT 6. IF THE INSTALLA TION IS TO BE MADE FROM ANOTHER LOGICAL UNIT, CHANGE I VALUE AS
APPROPRIATE.
SET OF BINARY PROGRAMS IS ENTERED WITH MSOS PROGRAM LIBRARY AS AN ABSOLUTE FILE. '
ABSOLUTE FILE
} ABSOLUTE FILE
.} ABSOLUTE FILE
} ABSOLUf E FILE
}
THESE TWO PROGRAMS REMAIN IN BINARY FORMAT.
EXIT LIBEDT } EXIT JOB
CONTROL STATEMENTS USED DURING LIBEDT PROCESSING
NOTE: EACH LINE ENDS WITH A CARRIAGE RETURN AND A LINE FEED.
Figure 9-1. Skeleton for Adding Macro Assembler to System
96769410 A
The operator loads the first two records just written on the installation tape:
LOAD,6
After loading the records, the computer replies:
ANY MORE INPUT, ENTER LU
This SKED internal condition is cleared by pressing carriage return. The computer replies:
NEXT
The operator now inserts all the other records in the skeleton of figure 9-1. Each input record is followed by a carriage return and a line feed.
INSERT, 2,4
*B 'LIBMAC'
*L,ASSEM
*z
carriage return
Remaining records from skeleton in figure 9-1
The final carriage return terminates the loading com-mand sequence. The comment device displays:
NEXT
The operator may now list the full skeleton by:
CATLOG
When the computer replies:
NEXT
the operator is ready to dump the skeleton onto the 'installation tape, using the same magnetic tape as before:
REW,6
When the tape is rewound and the computer replies (NEXT), the operator writes the skeleton with:
DUMP, 6
The computer replies with:
NEXT
and the skeleton is now saved on the output device. The operator exits from the skeleton editor with:
EXIT
96769410 A
9.2 BUILDING MACRO ASSEMBLER INSTALLATION FILE
The skeleton is now used in conjunction., with the macro assembler binaries to create the macro aat3embler instal-lation file. The utillty program LIBILD generates the file. In the following example, both the new skeleton and the macro assembler binaries are on magnetic tape and are input from logical unit 16.
Assuming that the job processor is still in control of the computer, LIBILD is put in control by the operator entering:
*LIBILD The Comment Device Displays:
CONTROL LU = DEFS LU
=
INSTALL LU = NEWLIB LU ==
LIB 01 LU ==
LIB 02 LU = SKELETON LU ==
The Operator Replies:
Carriage return Carriage return Six carriage returns Carriage return 16 carriage returns Carriage return 16 carriage returns Note that only a carriage return is entered as the response to the query CONTROL LU ==. This is because the
sequence control statements are read from the comment device. A carriage return is also the response' to the query DEFS LU =, since the installation file is to be created according to the skeleton and not according to a definitions deck. The response to INSTALL LU = indi-cates that the installation file is to be written on logical unit 6. No new'output library is to be created. There-fore, a carriage return is entered following the query NEWLIB LU.=.
Following the 16-carriage-return reply to the query SKELETON LU
=,
the binary programs are read from logical unit 16 and saved on mass storage. When all the binary programs have been read, the comment device displays:LOAD SKEL/INSTAL, CR WHEN READY
After mounting the skeleton tape prepared by SKED (sec-tion 9.1) on logical unit 16, mounting the installa(sec-tion tape on logical unit 6, and readying both of these units, the operator replies with a carriage return. LIBILD reads the skeleton and prepares a macro assembly installation file by reading the skeleton records and binaries and proceSSing the binaries according to the instructions of the skeleton records.
9-3
When the installation file is complete, the comment device displays:
LIBRARY BUILD COMPLETE TYPE *Z TO TERMINATE OR
TYPE *C TO CONTINUE WITH CURRENT SKELETON AND/OR
OUTPUT LIBRARY LUIS
Since the installation file is now complete and residing on logical unit 6, the operator exits from LIBILD by replying:
Z
The system returns to job processor control.
9.3 ENTERING MACRO ASSEMBLER INTO MSOS
The newly prepared macro assembler installation file may now be used by LIBEDT utility to enter the macro assem-bler into MSOS.
9-4
Assuming that the job processor is stlll controlling the computer, the library editor is placed in control by the operator entering:
* LIB EDT
When the library editor Is controlling the computer, the comment device displays:
LIB IN
The operator loads the installation file on logical unit 6 and readies that tape unit. He then causes the file to be read by entering:
*V,6
After LIBEDT has processed the file, the comment device displays the CTO statement entered at the end of the skeleton:
MACRO ASSEMBLER INSTALLED
The first *Z statement from the skeleton causes LIBEDT termination; the second *z statement causes job proces-sor termination. MSOS is now augmented by addition of the macro assembler.
96769410 A