X$DUMP B1,32,'0' PRINTOUT:
Volume 3 System Processors UPOA 1'£ lEVEL
F. ELT,NEWELT
5. ELT Processor
5.1. INTRODUCTION
This section describes the EL T processor and the @END control statement (see 5.2.1), which is used with the EL T and DATA (see Section 6) processors.
The EL T processor is used to introduce an element into a particular program file or make corrections to a symbolic element in a program file from within the runstream.
5.2. @ELT FOFIMAT
Purpose::Introduces an element into a particular program file or makes corrections to a symbolic element in a progralm file from the runstream. The @ELT control statement is used to call the EL T processor and it must precede the element or correction images in the runstream. With the exception of the
@ELT,D control statement, the EL T processor is terminated by the first nontransparent control statement encountered in the runstream. The EL T,O processor is terminated by an @END control statement (see 5.2.1) whose sentinel matches the sentinel on the @ELT,O control statement. Any control statements, with the exception of the @ FIN and @ADD,O statements (see Volume 2-3.4.2 and 2-3.10. 'I, respectively), appearing between the @ELT,O control statement and the @END control statement are treated as data.
All parameters in the @ EL T control statement are optional except eltname-1.
Format:
@label:ELT,clptions eltname-1 ,eltname-2,sentinel,time-and-date,bank- information Parameters:
options See Table 5-1. All of the source input/output routine (SIR$) options contained in Table 1-2 may be used. The A, 0, R, and S options (element type options) identify the element type, while the I, L, and U options principally outline element (image handling) options. The 0 option is used to insert control statements into a symbolic element.
Those elements identified as type S are considered symbolic elements and also may be corrected by using the correction statements (see 1.2).
4144.31 UP-NUMBER
eltname-1
eltname-2
sentinel
time-and-date
bank-information
Option Character
SPERRY UNIVAC 1100 Series Executive
Volume 3 System Processors UPDATE lEVEL
5-2 PAGE
The S option is assumed when the element type options are not specified. The L option is assumed when the image handling options are omitted and no eltname-2 is given.
Specifies the input element. With the I option this parameter specifies the new element being inserted into the program file. With the U option this parameter specifies both the symbolic input and output elements.
Specifies the new output element to be generated. Not used with I.
May be specified with U option to retain all element cycles up to cycle specified in a new SO element.
Specifies, when the @ELT,D control statement is used, the character code which terminates the flow of data images into the element being created. This parameter may consist of one to six characters and must agree exactly with the sentinel code appearing on the @END control statement (see 5.2.1) used to terminate the EL T processor.
Specifies time and date element was created in TDATE$ format (see Volume 2-4.5.2) shifted circularly 18 bits. Applies to absolute and relocatable elements only. This parameter is optional.
Applies to absolute elements only and is required. Contains the same information as absolute element table item word 6 (see Figure 11-3).
Table 5-1. @EL T Control Statement, Options
Description
Element Type Options
A Identifies element as an absolute element; used only with the I option.
o Images following the @ELT are inserted as they appear in the run stream into an omnibus element. The elemt:rnt is not formatted by EL T. Applies only with the I option.
R Identifies element as a relocatable element, used only with the I option.
S Identifies element as a symbolic element. This option is assumed when no element type option is specified.
Image Handling Options
o
Indicates that the symbolic input images following the @ELT control statement may include control statements which are to be transferred as data. All control statements are transferred until a @FIN or @END (with matching sentinel) control statement is encountered (see Volume 2-3.4.2 and 5.2.1, respectively).L Requests a listing of the complete symbolic element. The listing provides line numbers, cycle information and identification of the newly added and deleted images. This option may be specified for absolute, omnibus or relocatable elements to furnish an unedited listing of the images as they appear in the runstream. This option is assumed when the I, Land U options are omitted and no eltname-2 is given.
X Take error exit (ERR$ see Volume 2-4.3.2.2) upon occurrence of an error.
4144 31
I
SPERRY UNIVAC 1100 Series ExecutiveI I
5 3up~u~~
____________ V_o_'u_m __ e_3 __ S_y_s_te_m __ p_r_o_c_e_ss_o_r_s ___________________~_U_PO_A_TE_L_~_EL
____~_PA_G_E-
____ __Descript.ion:
The EL T"O control statement allows insertion of control statements into a program file as elements which may repres~nt @RUN and @ADD runstreams (see Volume 2-3.4. 1 and 2-3. 10. 1, respectively) of the input to subsequent runs. If the element is to be added to a file other that the one from which it was punched, the filename on the @ELT statement must be changed.
The @El.T statement generated by FURPUR when an element is punched also contains information in specification fic31ds 4 and 5. Field 4 contains the time and date the element was created from word 9 of the Program File table item (see Figure 11-3). Field 5 applies only to absolute elements and contains bank information from word 6 of the absolute element table item. If field 4 is not present the curre~nt time and date is used when the element is added to a program file. Field 5 must be present when an absoluto element is to be added.
1. The' correction images following this control statement update ELEMENT 1 of program file PF 1.
The! updated element replaces the old ELEMENT 1 in PF 1. Since the element type is not option is omitted. ELEMENT2 remains unchanged.
5. The~ images following this control statement are inserted as a new symbolic element (ELEMENT3) in program file PF 1.
6. ThE~ images following this control statement are inserted as a new absolute element (EL T) in program file TPF$. The time and date of the ~Iement will be 10:00: 14 and 20 APR 72. The
4144.31 UP-HUMBER
SPERRY UNIVAC 1100 Series Executive
Volume 3 System Processors UPDATE LEVEL
5-4 PAGE
I-bank length of this element is 2401 decimal words and the D-bank length is 1510 decimal words.
7. The images following this control statement are inserted as a new relocatable element (ELEMENT5) in program file PF 1. Since there is no time and date specified the current time and date is used.
8. . The images following this control statement are inserted as a new symbolic element (ELEMENT6) in program file PF 1.
9. The images following this control statement are inserted as a new data element (ELEMENT7) in program file PF 1. The data stream is terminated when an @END control statement having the matching sentinel STOP is encountered.
10. The correction images following the control statement are applied to element A in program file TPF$ to produce the next higher element cycle which then becomes the new symbolic element B. Element A remains unchanged. Previous element cycles are retained in element B.
11. The images following the @ EL T are inserted as a new omnibus element (OMNI) in program file TPF$. The images are listed as they appear in the runstream.
5.2.1. Input Termination Sentinel (@END)
Purpose:Marks the end of a data file or element. It follows the data images introduced by either an @ELT,D or @ DATA controls statement (see Section 6).
The sentinel parameter is optional.
Format:
@END Parameters:
sentinel
Description:
sentinel
A one- to six-character code corresponding exactly to the sentinel contained in the @DATA or @ELT,D control statement introducing the data images. The end of the file or element is determined when the character string in this parameter matches the character string of the
-.
sentinel parameter specified in the associated @DATA or @ELT,D control statement.
@END control statements cannot have labels and cannot be continued. The @END control statement must be coded exactly as shown (punched into first four columns of the card).
Examples:
@END FINISH
When the @END control statement is encountered, it ends the data file or element introduced by the
@DATA or @ELT,D control statement that has its sentinel parameter coded FINISH.
4144.31