chanr.els.
]2!~1: For compatatility with other RPGs, there should be an entry in at least one of the Space or Skip fields of the first FilE-Identificaticn sreci-fications line for each printer output
(i.e., it is not necessary in an OR line). If the user requires no entry
(no Space or Skip desired), he should enter a zero in ~pace/After (col. 18).
Q~!E~.!_I!!Qi:f~12£§==~21§~_~]=11
(File-Identificaticn Specifications) Indicator codes entered in these fields determine the conditions under which tre output operations defined in this File-Identification specifications line, and in its subsidiary Field-Description s~ecifica
tions lines, are to be executed.
17U SystEID/3EC Model 20 CPS BeFcrt Prcoraro Gererater
Note that output Indicators ~n thE FilE-Identificaticn ~pecificatict~ line control the cccurrEnce of that entire cutput-~LOt
ef a particular fiEld. (Cutrut Indicators may also tE assigned to individual fields.
This is discussed under
li§lg
~§§~rilti~~anQ_~~nt~sl, tElew.)
AtsencE of an entry calls fer Executien of that eutput at detail time er total time--D (or H) or T, respectively, in col.
15 (Type) --Each program cycle. Ncte that detail tine includes detail-cutput time teforE the .t:irst card has teen rEad (wrEn the 1P indicatcr is cn).
Any indicator--except OF or OV (dis-CUSSEd sEparately belc~ --rray te entered in cols. 24-25, 27-28, or 30-~1 te instruct the pregram to execute the particular out-put specificaticns only if that indicator is on at that time (detail time cr total time, as determined by the entry in col.
15). 1-:'" an N (=Not on) is enterEd in the column preCEding the indicatcr cedE (cel.
23, 26, er 29, respectively), the output is perfcrmed only i~ that indicator is nct on.
NO!~: Any ~ECrIC charactEr etrer than N in cel. 23, 26, cr 29 has the same meaning as a blank.
The ttrEe fields (cel~. 23-25, 26-28, 29-=1) arE identical in functicn. If lESS than thrE~ ccnditienina indicators are assigned, it does not mattEr which ef the
thr~e fields are used. Up to tr ree dif-ferent ccnditicning indicaters may te desiqnatEG in one File-Identificaticn spec-ificaticns line. All indicaters assicned to one line are in an AND relaticnshiF to each othEr; i.e., the conditions for all indicators in the line must te satisfiEd for the cutput te be performed. Each cf the several indicators may individually be required te te en er net cn (N) as a cendi-tien of perfermance of tr.e output
operaticn.
If more than threE OutFut Indicatcrs in
a~ ANr relaticnshir are needed to ccndition an output eperatien, additicnal lines may be used, each able to accemmedate up to three more indicator entries. Suct lines must be immediately below tr.e initial File-Identification specificatiens line for the particular outrut. They ffi~st te blank Except fcr the werd AND required in cols.
14-16 and the desired entries in Cutput Indicators (cols. 23-31).
Different Output Indicators may be
placed in an OR relatienshir to each ether;
i.e., the eutput oreratien is tc bE FEr-formed if any cne ef several indicatcr cri-teria is satisfied. A separate
file-Id€ntificaticn sFecificatic~~ line i~ us~d
for each OR line, and placed immediately beneath the initial File-Identification 1 i n e ( 0 ran y A. N D 0 r C R 1 i n e s ) for the p a r-ticular output. The word OB is entered in cols. 14-15, the desired indicators in Out-put Indicaters, and--optionally--Stacker Select and forms centrel instructions in cols. 16-22.
Eoth AND or OB relationships may te
speci~ied iT ccnjunction with each ether--i.e., the output operation is to te per-formEd if any ene ef several ccmtinatiens of indicator conditiens is satisfied.
when there are A1I or CE linES for an eutput cperatien, tren every AND line, every OR line, and the initial
File-Identification specifications line for that output opEration mu~t each have at least one entry in Output Indicators. If the indicators for successive lines in an OR relatiensrip are not cempletely mutually exclusive, the program executes the speci-fications (Stacker Select and forms cen-trol, if any) of the first line whose indi-cator criteria are satisfied (except if one of the Output Indicators specifications is CF or
cv,
for the lower or upper feed respectively--see telow).Entries in Output Indicators utilize indicators only to condition the executicn of an operation--trey do net set them as Besultinq or Field Indicators. ~herefore,
the use of an indicator in output Indica-tors never cranges its status (on or not on). An Indicator applied in Output Indi-cators reflects the statu~ (on or not on) it previously assumed:
1. As card-type Pesultinq Indicater, er 2. As Field Indicater, or
3. As calculation Resultina Indicator, or 4. As Control Level indicator, or
5. As Matching ":Fields indicater (MR), or 6. ~hrouah a SETON or SETCF instruction,
cr
7. As its initial status at tre bEqinning cf rroqram execution--if never cranced, er
8. As a result of a flank-After cutput instruction, or
9. As a censeguEncE o~ fcrrrs-centrol brush sensinq of a carriaqe-tape channel-12 punch--if OF or ov indicator.
Output-Format Specifications (Ortional) 175
The status of an indicator may have a different significance at detail time and at total tirne--for example:
(a) It may reflEct different cards. For instance:
At tetal time, the MR indicator and Field Indicaters reflEct tte previous input card whereas L-ipdicators and card-type Resulting Indicators already reflect the new input card; or
(b) Its use may have a different effect.
For instance, with L-indicators em-ploYEd in the normal maLner, with level--the standard method for proqram-ming output cf qroup tctals cr of level--a method for prcqramminq qroup-indication (printing identifying data only from the first card of a control grou p) •
For details on indicators, see also R£Q=
g£~~_1Qgif-Xlo~, RP§_f£Qg£~~Qgif, (Figure 6), lQQif~lQ£§, lQQif~!~f_]i§ra£ch~, and
Ma1~BiQg_Q1-Xil~§, all undEr g£2g£A~~iB~
fO£_]gG-=~~n§£~1_1n!Q£~~!i£ni ]§§~l!i~
lnQif~!or§L !i~ld_lnQifA1~£§, £Qntr£1_1~~~1 an-d"t1"a!.£:.l:!trrg~.I1:§.!gE..L a 11 IlTI<i"e t .ItLE]~L~:2.:f.§~l=
fi£~!iQn§i and lndifA1Q£§ and ]~§ult~
Te§iing_IieldsL under £Alf]l~!iQB .§E§~ifiS:E!iQn§..: situations in Output Indicators (cels.
23-31) applies:
(a) !he Output-Indicators fields are 1:1ank; or
(b) Any indicators specified, and not prEcedEd 1:y N, arE then cn; and any indicators specified, and preCEded 1:y N, are then off.
These criteria are valid alsc at the detail-output time that precedes the readinq of the first input card (the uppermost IIC tlock in Fiqure 6, ]£g
g.!~gfA~12gifl·
If the output is to ce suppreSSEd at
detail-output time prEcedinq the read-inq ef the first input card--and it should normally be suppressed at that time, except for the printinq of con-stant data as report or column
headinqs--an indicator must be assiqned in Output Indicators. This may either
€xecution (see also lngifA!or_]i~±E±S:BY
and Fiqure 11):
1P and La; and any indicator assiqned to "Zero or Blank" in input Field Indi-cators or in calculation Resultinq Indicators (arithmetic operaticns or TESTZ) .
Permittinq any output operation--apart from the printinq of constant report-headinq data (see Constants, below)--before the first input card has
Ki±st_~~£g_is_]~~QL under g±~±~~_logi£
K1Q~1 L-indicators to reflect group-control breaks. Thus, even thouqh total-time output is bypassed, I-indicators speci-fied in Output Indicators to control group-indication (i.e., printinq of identifyinq data from the first card of present a protlern in oro up-indication 176 System/360 Model 20 CPS Report ~reqram Generator
for the first contrcl group when the control fields cf the first greup con-tain no significant data. (See ~]~£i§!
Consideratiens for Indicators 11-19 on
~]un=In"~-under-lQdicator~~-In-thE-sec-tien Ri2~E~~i~g_i2~_]R~==g~B~~El Information. )
---A~echnIque for circumventing any sucr. preblem is presented in R£~g£am=
min3_1i2§L
Appendix E.Figures 50 A and B illustrate specifica-ticns for File Identificaticn and Centrol, temporarily Excludino the OF and OV indica-tors (discussed next). The reader is asked to assume, for pur roses of this illustra-tion, that Each File-Identificatien speci-ficatiens line (cr group of lines, wben there are AND or OR lines) is fellowed by at least one Field-Description specifica-tions line (discussed later).
Programmer _ _ _ _ _ _ _ _ _ _ _
I
Spac. Skip Indicators OutputLin_ Filename Ei
I
1
Q. .eJJ
~ E ;. ~
.
!l
~~ ~ Andof l ~ ~ ~ ~
3 A 5 6 7 8 9101112131<1 1516 1718 1920 2122 232425 262728 29 30 31 3~
0 1 oREPORr*tll 3 ~j tP
0 2 0
0 3 0 J) t N1P NHl
0 4 01
1 1 I
0 5 0 T 12 Lt
0 6 0
0 7 ojSUMCARD T Lt
0 8 01
0 9 oREPORT*t T ~1 LZ
1 0 01
! 1 °i I' T
t, '1
Lf<II:
2 1:1 I1111I I I I I
FiQure SOA. Simple Examrles of Entries for File Identificaticn and Cen-trol (Excluding O~ and OV Indicators)
Explanation of Entries in Figure SOA
h§s~m]1ien§: A straig~t listir.q is desired, with two classes ef total and grand total. Peadings of ccnstant data are to be printed on one line across the tep of the report on the first page. At each 1evel-1 centrol break, a summary card is to be punched. The printer has been assiqned
(in the file description specifications) the file name REFORT#1, and the card punch device has the file name SUMCARD.
~~£iiicE!if~_liB~_Ql caeses printing enly at detail time and only before the first data card has bEen read:
REPORT#1 is as~ociatea with the printer;
F in col. 1S (Type) specifies detail time (a D, instead of H, would have been synonymous) ;
The lF indicator is on at the beginninq of program execution, and is turned off by the RPG program itself immediately after the first card has been read.
Thus, the output is limited to ~rinting
at detail time, before the first card has been read; i.e., the first detail-output time only. The Field-Description specifi-cations following this File-Identification line are assumed to contain constants, to be printed as headings across the first print line of the first page.
If 1P were not specified, but Output Indicators left blank, the heading con-stants would be printed at detail-output time cf every program cycle.
Skip/Before to the next carriage-tape channel-01 punch is specified, to make sure to start at the to~ of a fresh page. After the headina, the form is advanced 3 lines, so that two blank lines intervene before the first detail-data line.
~iQ~Ql calls for printing the data in the fields presumed to te designated in Field-Description specifications beneath this line. The file name (REPCRT# 1, cols.
7-14) need not be repeated, because no other file name intervened-~but it may be
repeated. '
This output is at detail time CD in col.
i5--H could have been used instead) ; The output is sUfpressed if the H1 and/
or the 1P indicator is on. NH1 was arbitrarily chcsen to point out that P.1 might be assigned to an error con-dition, to halt the system after detail-output time, and the same indi-cator can conveniently be utilized to sUfpress output. If N'P were not assigned, the output would also occur tefere the first card has bEen read.
The 1 in cel. 18 causes sinqle spacinq after each detail-output line.
LiQ~_~2 causes printing at tota~ tlme (T in col. 1S), provided the 11 indicator is on.
This is the normal method for printinq totals at the end of a centrel group of Level 1. The file name need not be
repeated, eve~ though this specification is for total-time output and the previous one was fer detail time.
To offset the total line from a qreup of preceding detail lines, a space/Before is output-Format Specifications (cptional) 177
specified. This creates one blank line
The SUMCARD output spEcifications cculd have fellewed the 12- er IR-level printer output; cut they were delicerately inter-posed between the 11- and 12-level printer output specificationE: alternating eutput media for the same program cycle tends to speed throuqhput. Therefore, the higher the propertion of l2 contrel breaks in relatien to 11-only creaks, the more iE gainEd by interposinq the card-punch output cetween the two printer operations (Eee
Because ~his output File-Identification specificatiens line is celcw the 11 line, the cutput-fcrIPat q:ecifications (see
~~gQ§n~~_Ql_~E§~ifif~1i~B§, above).
After Every 12-level Frinter cutput, the forms-ccntrol-carriage tape advances tc the next channel-1 punch, i.e., the top of a specifications must precede all total-output specifications, and (2) Space and Skip are forms-control specifications and can, cf ccurse, only te entered if.
FilE-Identi~ication lineE fer Frinter output.
Progtammltr _ _ _ _ _ _ _ _ _ _ _ for File Identification and Control (Excludinc CF and OV
inventory-item master card. Inventory-item masters are in harFer 1, transaction (i File rescription specifications) as combi-ned files: the TRSACTNS file because its cards are to be read, punched, and stacker-selected at outFut ti~e; tbe 01DEAICE file only because, besides ceinq read, some of 178 SystEm/36C ~odel 2C CPS SeFort ~rc?rarn Gener2tor
its cards are to be stacker-selected on the basis of the MR innicator--which must be in the output specifications, and reguires an output operation (say, punchinq a "blank"
in col. 1). 'T'he piles are matched (Match-ina ~ielas--'l) on stock number.
The file TNVNrrF.Y is associated with the printer. The File Description specifica-tions call for turnina the T,R indicator on when hoth card files are exhausted.
Specification line 01 causes printina only
at-jetaii-tirne-(D-in-~ol. 15--P would have had the inentical effect), ann only before the first 1ata card has been read (1P in output Indicators). (Peadina oata, in the form of constants, is presume~ to be con-taineR in the ~ield-nescription specifica-tions.) Before the line is printed, the form skips to the top of a new paae (01 in cols. 1 <?-2('\); and a fter print ina, the form advances to the next ~arriaae-tape channel-2 punch (0channel-2 in cols. 21-22).
LiQ~§_Q2_~Qi_Q~ cause ola inventory mast~r
cards to enter the normal stacker (stacker 1) for the primary hopper of the MFCM
(blank in col. 1~--a 1 coul~ eaually well have b~en specified) whenever there is at least one match ina detail (item-orner) card--MR indicator on--but to enter stacker 2 (2 in col. 16) when there is no matchina detail--NMR. Tn line 13, new inventory masters are also selected to stacker 2.
tiQ~§_Q1L_~~_~Qi_l1 jointly have the effect of selectina out (to stacker 1) old inven-tory masters (line 03) that are beinq
replaced hy updated new ones (line 13); but directina to stacker 2 those old inventory masters for which no new ones are beina created (line 04). At the conclusion of the job, stacker 2 contains the updated complete inventory master-card file:
newly-punched updated cards to reflect transactions, plus old masters for items on which there were no transactions.
Besides MR and NMP, respectively, the card-type Resultinq Indicator (05) assumed to have be~n assiqned to the OLDBALCE cards in the input specifications is also speci-fied here--otherwise, in every program cycle in which a TRSACTNS card is pro-cessed, the next OLDBALCE card would also be fed through, but never read; and NMR alone would allow an OLDBALCE card to~be
fed through at the beginninq, without reinq read.
Lin~~06=Q2 illustrate AND and OR specifi-cations. The operations are performed if
eit~er 0+ t~ese combinations of conditions exists:
Indicators ~F ane 21 and 40 and 62 are all on; or
Tndi~ators MR and 21 and 14 are all on, and incicators 40 and 62 are both off.
These are presumed to be tvo types of item-orjer detail cards, to be processed alike.
Both types are selected to stacker 3 (by entry Of different stacker numbers in lines 06 ann OP, the two types could be aire~te1
to di -Fferent stackers) .
~~rr~_~J. All item-orner detail cards (say, card-type ~esultina Indicator 21) shou11 have a matchinq inventory master card
(Of.DBAfCF file). If there is no master (inBicator condition NMP), either a master cara is missina or the aetail carn is punched with a wrona stock number. The detail card is directed to the normal stacker (col. 16 blank) for the MP2M
se~ondary hopper, to be investigated.
A second indicator specification
(besines NNJR) is required (card type 211 was usea) to prevent performance of this output before the first data card has been read ana each ti me an Of DBA f,2P card is pro-cessed, an~ to distinnuish this card from the blank cara (spp line 13) at the end of
ea~h stock-number detail-card qroup.
'T'he file name (cols. 7-14) need not be repeated, hecause no other file name
intervened.
Tine 13 speci~ies the output ~or the blank
cara-at
the end Of each stock-number oetail-caro arou p. Th is card will be punched with the updated inventory informa-tion, and hecomes the new inventory master for the particular stock item.Resulting Indicator 01 was assiqned to this card type in the input specifications.
The cards are selected to stacker 2 to form--in conjunction with old master cards for which there were no transactions (see line 04)--an updatEd complete inventory master deck. The file name (TRSACTNS) was repeated just to show that this is
permissible--it,is not necessary.
output to this card could be performed at total time (T in col. 15). However, although totals for a preceding group of cards are to be punched, detail time (D in col. 15) was chosen, to illustrate that there is no fundamental difference between the operations that can be performed in these two seqments of the program cycle--provided the appropriate data and indicator settings are available: this card type output-Format Specifications (Optional) 179
(tre blank card), alt~ouqh part of a combi-ned file, serves only for output; no data is read from it; the·data is ready for
"summary" punchinq when the preceding card has been processed, ana the status of the MR indicator is not relevant. Therefore, this card can be punched at total or detail time. If i t is desired to perform output to the blank trailer card only if the detail cards matched the OLDBALCE cards, MR should be specified (in aedition to 01) in Output Indicators; the output should be performed at total time (T in col. 15), when the MR indicator s t i l l reflects the matching status of the previous card.
(Because all total-time specifications must follow all detail time specifications, the specifications now in line 13 would have to be moved beyond line ~5.)
lin~_12 provides for printinq the updated inventory information after the last trans-action card of each stock-number group.
This is the proaram cycle durinq which the rlank care (indicator 0
n
at the end of each group is beina processed; therefore, ineicator 01 is specified in output Indica-tors. Aqain, the printed output is per-formed at detail time (D in col. 15); but i t could equally well be performed at the precedinq or followinq total time. Either way, i t illustrates a qroup-printed report, since the individual transaction cards are not printed.T~e form is spaced 2 lines after each printinq.
Lirr~-1l provides for the printing of grand tota-ts-;---tire- -- output: ---i-s -p~rTorlife do-on JY'--wn-en-the LR indicator is on. This operation must be performed at total time, because--when the LR indicator is on--the job is terminated after total output.
The qrand totals are printed at the top of a new paqe (01 in cols. 19-20), and the form is aqain advanced to the top of a new paae after printinq (01 in cols. 21-22).
1. 11.11 detail-output specifications must precede all total-output
specifications.
2. Card outpu t operations contingen t upon the status of the MR indicator (applied in the normal manner, to the matchinq of files) at detail time reflect the matchina status of the card being pro-cessed; at total time, MR still
reflects the matchinq status of the precedinq card: this can be utilized
reflects the matchinq status of the precedinq card: this can be utilized