normal return
UPDATE LEVEL
I
PAGE 2-48The error and normal returns are identical to those for PREPRM $. The absolute-eof return indicates that an EOF condition has been encountered which cannot be bypassed; that is, a nontransparent control statement or @ENDX was encountered. In that case, the processor cannot reuse itself and must terminate. The wrong-CUST -index return is optional for processors which have more than one item in their INFOR CUST and only want to analyze one specific command automatically, which is
\
specified by its CUST index given in AO prior to calling REPRM$. This return will never be taken if AO is zero on entry to REPRM $. After the wrong-CUST -index return, X 11 will point to a reentry location if it is desired to continue with the preprocessor routine after all. (Note that the CUST index encountered is found in S3 of INFOR$
+
1.) This may be done by the following instructions:LMJ X 11,O,X 11 error return normal return
where the two returns are as for PREPRM $.'
2.5.1.5. Processor Field Retrieval (FLDGEn
Purpose:This routine retrieves individual fields from the processor call card not normally processed by PRE PRO or PREPRM.
Format:
F66618 F2466
FORM FORM
6,6,6,18 24,6,6 the calling sequence is as follows:
L A 1 ,(F2466 O,I,f) l AO,(F6618 O,n,m,j)
lMJ X 11 ,FLDGETO$ (if using PREPRO$) or
lMJ X 11 ,FLDGETM $ (if using PREPRM $) error return
normal return
4144.41
UP-NUMBER
L
SPERRY UNIVAC 1100 Serle. ExecutiveSystem Utility Programs
----..:-~--~--'---UftOATE LEVEL 2-49 ,.AGE
where:
I -- list number desired, currently 01 is only valid list number f -- field number desired
n _. control bits
BIT 24 - if set field is to be used for output - if not set field is to be used for input BIT 25 - if set disallow tape for input
- if not set allow tape for input
BIT 26 - if set the routine will print any error messages - if not set the routine will not print error messages m - type of element (1-7); 070 for file only
j - address of 13 word data area Description:
The information pertaining to the requested field is transferred from the INFOR table to the 13 word data area specified by j. Files are assigned if necessary and the element, if designated for input, is verifie!d. A use name of the form 'F xxyy $' is attached to the file, where xx is the list number and yy is the field number. TPF$ is the default file.
It is possible to request either a file or an element by OR'ing 070 with the element type, i.e., 077 in field J71 indicates an omnibus element or a file. The request for an element has precedence over a request for a file.
When bilt 24 of field n is set the routine does the following:
1. Assign file E~xclusively 2. Taple file not alloweq
3. The' element name, version, and type are stored in the 13 word data area When bit 24 of field n is not set the routine does the following:
1. Tape file allowed, depending upon bit 25
2. Equipment code is stored in S4 of the first word of the 13 word data area.
3. An ER PFS $ is done on information supplied.
4. Elernent cycling is checked, relative cycling allowed.
When bit 26 is set, printing of the error message is suppressed when the field is not found and the first word of the 13 word data area is set negative.
4144.41
UP-NUMIER
SPERRY UNIVAC 1100 Serle. executive System Utility Programs
The error return is taken when:
1. the file cannot be assigned correctly, 2. the input element cannot be found, 3. incorrectly coded field, and
UPlMl1LML
4. the field specified cannot be found. (AO will contain the same information SEl T$ returned in AO on a no find return).
2.5.2. Preprocessor Routine (PREPF$)
Purpose:Generates the source input and source output fields of PARTBL (see Figure 2-1). Performs dynamic assigns of source input and output files. This routine is intended for processors which use files rather than elements.
Initial Conditions:
PARTBL must be externally defined and at least 27 decimal words in length.
Format:
LMJ X 11 ,PREPF$
error return normal return Description:
The information from the source input and source output parameters or the processor call statement, if given, is transfered to PARTBL. The options specified on the processor call statement governs how the information is placed in PARTBL.
no options
I option
U option
- if SI is given, the L option is assumed.
- if the SO field is given, an error message is printed.
- if both SI and SO fields are given, the files are assigned and no options are assumed.
- if neither 51 nor SO fields are given, a normal return to the user is taken.
- SI field is assumed to be the output file.
- if the SO field is given, an error message is output.
- if the 51 and SO fields are not given, a normal return to the user is taken.
\
- if the SI field is not given, an error message is printed and the error return taken.
- if the SO field is given, an error message is printed and the error return taken.
4144.41
L
SPERRY UNIVAC 1100 Series Executive 2-51~~______ _________ 5~y_s_te_m ___ U_ti_'i_ty~P_r_o_g_ra_m __ s ______________________ ~u_~_A_n_L_~ __ L _____ P_A_G_E __ ~
- the U option implies that the next higher f-cycle of the 51 file is to be produced.
PREPF$ assigns the next higher f-cycle. The name specified in the SI field cannot be a USE name.
It is important to remember that PREPF$ expects file names. If the user is not in DATA MODE then a peri()d must be included in the file name.
2.5.3. INFOR Table Interface Routines (INFOR$)
NOTE:When using the preprocessor routines, they must perform the first READ$ request and they must proces's the information from the processor control statement.
The INIFOR tabll~ interface routine:
'1. RE~ads the INFOR table.
2. SE~arches for a parameter subfield.
~l. RE!trieves a complete parameter.
4. Performs a dynamic @USE (see Volume 2-3.7.5).
Internall format (INFOR) is the table of information returned from the operand field of a processor call statemE~nt when a program is called for execution as a processor rather than by being named on an
@XOT control statement. The INFOR is returned on the program's first request to READ$ (see Volume 2-5.2.1 ).
The INF:OR call in contrast to @XOT is as follows:
@ .~Itname,()ptions operand-field
The opEirand-field may consist of many parameters, separated by commas, each of which may contain information of any kind, as long as it conforms to the syntax conventions of a file or element name.
For example, an operand field of 23, REVI5E/@7., 16/17 would create the following INFOR entries:
• •
•
Parameter 1 is treated as element name:
Parameter :2 is treated as filename:
read key:
write key:
Palrameter :3 is treated as element name:
version name:
'23 'REVISE '@
'7 '16 '17
The format of the INFOR table is flexible, with control words to indicate which components of a filenamE! or elemf~nt name are actually present (nonvoid). Figure 2-2 illustrates the INFOR table format.
A set oir routine!; is provided for reading and manipulating the INFOR table. These routines are describE!d in following subsections.
4144.41 UP-NUMBEA
Subfield Control Word
35
FT
SPERRY UNIVAC 1100 Serle. Executive System Utility Programs
2625 23 17 11
type options
subfield-descriptions