PRODUCING OR PREVIEWING THE REPORT [ INFORM/V User's Guide ] MPE/iX 5.0 Documentation
INFORM/V User's Guide
Chapter 3 PRODUCING OR PREVIEWING THE REPORT
It is possible to produce a report from many points in INFORM/V. As a
general rule, if there is a report currently available, either newly
defined or called up from the catalog (the report catalog is described in
Section 4), the assumption is that you want to produce the report.
The first subsection below describes how to produce a report from the
Data Names Menu right after the report has been defined or modified. A
later discussion in this section described the steps used to produce a
report from the Main Menu.
A feature that is closely related to producing the report is previewing
the report. This feature, option 4 on the Main Menu, allows you to see a
"dummy" of the first few lines, so that you can be sure the report is in
the format you want. The steps required to preview a report are
described at the end of this section.
Producing a Report from the Data Names Menu
Section 2 described the steps used to define a simple report. When you
have finished defining the report, INFORM/V prints the message
PREPARING REPORT
The next prompt on the Data Names Menu will ask if you want to produce
the report.
You have the choice of producing the report interactively or in batch
mode. The complete set of prompts and responses are described below,
first, for interactive processing and, second, for batch processing.
Producing the Report Interactively. When INFORM/V prompts with
PRODUCE THE REPORT(Y/N)?>
answer Y no matter how you want to produce it. The next prompt will then
be
PRODUCE REPORT IN BATCH MODE?(N/Y)>
At this point, answer N if you want to produce the report interactively.
The interaction is shown in Figure 3-1.
______________________________________________________________________________
| |
| INFORM/V HP32246v.uu.ff - (C) Hewlett-Packard Co. 1986 |
| |
| DATA NAMES IN ACCOUNTING INFORMATION |
| |
| 1: NAME 7: DESCRIPTION 13: PRICE |
| 2: ADDRESS 8: PURCHASE NUMBER 14: TOTAL |
| 3: ACCOUNT 9: PURCHASE DATE 15: SHIPDATE|
| 4: DATE 10: BACKORDERFLG 16: DELVDATE|
| 5: CREDIT 11: QUANTITY |
| 6: PRODUCT NUMBER 12: UNIT COST |
| |
| TYPE NUMBER(S) FOR DATA NAME(S): |
| |
| TO INCLUDE IN REPORT> 1,6,11 |
| TO SORT BY> ! |
| |
| REPORT TITLE> |
| |
| PREPARING REPORT |
| |
| PRODUCE THE REPORT(Y/N)?>Y |
| |
| PRODUCE REPORT IN BATCH MODE?(N/Y)>N |
______________________________________________________________________________
Figure 3-1. The Data Names Menu - Preparing a Report
INFORM/V presents the Report Process Menu and prints the message
REPORT PROCESS STARTED
If the data you are accessing comes from a database, the next prompt may
be:
PASSWORD FOR database>
This prompt may appear even if you are reporting from an INFORM/V Group,
depending on how security is structured for your data. Because the
information you want may be located in more than one database, INFORM/V
may prompt for a password more than once.
The password does not appear on the screen when you type it, so that
security will be maintained. The password that you enter must be
identical to the password as it was assigned to you--upper and lower case
characters must match exactly. If you make a mistake, INFORM/V reprompts
for the password.
MPE/V and KSAM files are often secured with lockwords. Like passwords,
lockwords protect files that contain sensitive or privileged information.
If a lockword exists for a file, you may be prompted for it.
Finally, the following prompt appears:
DISPLAY OR PRINT(D/P)?>
_______________________________________________________________
| |
| INFORM/V HP32246v.uu.ff - (C) Hewlett-Packard Co. 1986|
| |
| REPORT PROCESS STARTED |
| |
| PASSWORD FOR PURCHA> |
| |
| DISPLAY OR PRINT(D/P)?> D |
_______________________________________________________________
Figure 3-2. Producing a Report Interactively
Type D or RETURN to display the report on your terminal. Type P to have
the report printed. Printing a report interactively ties up your
terminal until the report is finished, so you cannot do any other work.
If the report that you are going to print is long, it is therefore better
to use the batch option. You can change the destination of a printed
file by issuing an MPE/V file equation before you enter INFORM/V. See
Appendix B for the default output file name.
If you choose to display the report on your terminal, INFORM/V clears the
screen and displays the first page of the report. The Report Process
Menu in Figure 3-2 shows an example of the interaction to display a
report at the terminal. The report produced is shown in Figure 3-3.
_______________________________________________________________
| |
| NAME PRODUCT NUMBER QUANTITY |
| --------------------------------------------------------|
| Lewis Charles 55C 20 |
| Peterson Paul P 70A 20 |
| Albertson John B 90C 100 |
| Lewis Charles 90C 700 |
| Limburger Frank 60D 15 |
| Albertson John B 60D 130 |
| Baker Bill B 80B 55 |
| Albertson John B 50B 30 |
| Albertson John B 50B 5 |
| Smith John Q 11A 40 |
| Smith John Q 11B 400 |
| Smith John Q 11C 400 |
| |
| *****END OF REPORT***** |
| |
| |
| RETURN TO DATA NAMES MENU(Y/N)?> |
| |
| |
_______________________________________________________________
Figure 3-3. Simple Report Produced by INFORM/V
If the report is longer than one screen, INFORM/V fills the screen, then
prints the prompt
CONTINUE(Y/N)>
If you answer Y, INFORM/V will display the next screen full of data, then
prompt again.
If you answer N, INFORM/V displays
***** END OF REPORT *****
After the report is displayed, you have the option of changing the report
and looking at it again or returning to the Main Menu. The prompt is
RETURN TO CURRENT DATA NAMES MENU(Y/N)?>
To return to the Main Menu, enter N. Once you return to the Main Menu,
you can use any option displayed there.
CAUTION If you want to save the report that you have just defined, that
should be your next move. Invoking other options might destroy
your report before you have a chance to save it. See Section 4
for a description of how to save the report by adding it to the
catalog.
If you want to modify the report just defined, answer Y or RETURN. The
Data Names Menu you used to select data names is redisplayed so that you
can change the report if you want to. The process of modifying a report
is described in Section 10.
Batch Mode. The batch mode option is a very easy way to have your report
printed without tying up your terminal during the process. If you choose
batch mode, INFORM/V prompts for all the information needed, creates the
batch job, and streams it. Once the job is streamed, you can then use
your terminal for other tasks.
The process of producing the report by batch begins just like the process
for producing a report interactively. On the Data Names Menu, after you
respond to the prompt for a report title, INFORM/V prompts with
PRODUCE THE REPORT(Y/N)?>
If you respond with Y, the next prompt is
PRODUCE REPORT IN BATCH MODE?(N/Y)>
If you also answer Y to this prompt, the Report Process Menu then
appears, and you are prompted for user, group, and account passwords.
INFORM/V then builds a jobfile called INFJOBnn, where nn can be any
number between zero and 99. The number is assigned randomly, just to
assure that the job file name is unique.
INFORM/V allows you to control many of the parameters that apply to the
batch job, such as its priority and the naming or disposition of files
created by the job. If you want to see what these parameters are, and
the default values, refer to the discussion of format options in Section
8.
An example of the procedure for creating a batch job is shown in Figure
3-4. For this example, default values are used for all the batch
parameters.
The prompt
PASSWORD FOR database>
will appear if the database administrator has not programmed a link
between database security and INFORM/V security (details of setting up
security are described in Section 11).
The next prompts are for logon passwords:
ENTER USER PASSWORD>
ENTER ACCOUNT PASSWORD>
ENTER GROUP PASSWORD>
_______________________________________________________________
| |
| INFORM/V HP32246v.uu.ff - (C) Hewlett-Packard Co. 1986|
| |
| REPORT PROCESS STARTED |
| |
| PASSWORD FOR PURCHA> |
| |
| |
| PREPARE TO STREAM BATCH JOB |
| |
| ENTER USER PASSWORD> |
| |
| ENTER ACCOUNT PASSWORD> |
| |
| ENTER GROUP PASSWORD> |
| |
| #J93 |
| BATCH JOB SUCCESSFULLY STREAMED |
| |
| RETURN TO CURRENT DATA NAMES MENU(Y/N)?> |
| |
| |
_______________________________________________________________
Figure 3-4. Creating a Report in Batch Mode
When the system sets up a batch job, that job in many respects looks like
you are logged onto the system a second time. The system must have your
logon passwords, just as you enter them when you log on, in order to set
up that job. The passwords will not show when you enter them, so as to
maintain security.
INFORM/V next tells you the job number and says that it has been
successful in establishing the batch job. The messages are
#Jnn
BATCH JOB SUCCESSFULLY STREAMED
It pays to make a note of the job number (#Jnn). If you need to query
the system about the job, or if you ask your database administrator about
the job, the job number is the quickest and most direct identifier of the
job once it has been streamed.
After you have completed the batch job, INFORM/V asks whether you want to
see the Data Names Menu again, so that you can change the report. The
prompt is
RETURN TO CURRENT DATA NAMES MENU(Y/N)?
Interaction from this point is identical to that just described for
interactive processing.
Producing a Report from the Main Menu
If you are at the Main Menu and want to produce the current report,
choose option 5 (an example is shown in Figure 3-5). You will
immediately be prompted with the question
PRODUCE REPORT IN BATCH MODE(N/Y)?>
If you respond N, INFORM/V assumes that you want to produce the report
interactively. The interaction would then be as described earlier in
this section for interactive reporting.
If you respond Y, INFORM/V will then begin prompting for the responses
for batch production. The interaction would be as described earlier in
this section for batch mode.
_______________________________________________________________
| |
| INFORM/V HP32246v.uu.ff - (C) Hewlett-Packard Co. 1986|
| |
| INFORM OPTIONS: |
| |
| 1: DEFINE A REPORT |
| 2: DISPLAY REPORT CATALOG |
| 3: SELECT A REPORT DEFINITION |
| 4: PREVIEW REPORT LAYOUT |
| 5: PRODUCE THE REPORT |
| 6: ADD REPORT DEFINITION TO CATALOG |
| 7: DELETE A REPORT DEFINITION FROM CATALOG |
| 8: SET OPTIONS |
| 9: MODIFY THE REPORT |
| 10: EXIT FROM INFORM/V |
| |
| TYPE AN OPTION NUMBER> 5 |
| |
| PRODUCE REPORT IN BATCH MODE?(N/Y)> |
_______________________________________________________________
Figure 3-5. Choosing to Produce a Report on the Main Menu
Previewing the Report Layout
INFORM/V allows you to check the appearance of a report before you
produce it. It displays the headings and a few simulated rows of data,
and then allows you to change the report definition or to produce the
report.
To preview the current report layout, type 4 in response to the following
Main Menu prompt:
TYPE AN OPTION NUMBER> 4
_______________________________________________________________
| |
| INFORM/V HP32246v.uu.ff - (C) Hewlett-Packard Co. 1986|
| |
| INFORM OPTIONS: |
| |
| 1: DEFINE A REPORT |
| 2: DISPLAY REPORT CATALOG |
| 3: SELECT A REPORT DEFINITION |
| 4: PREVIEW REPORT LAYOUT |
| 5: PRODUCE THE REPORT |
| 6: ADD REPORT DEFINITION TO CATALOG |
| 7: DELETE A REPORT DEFINITION FROM CATALOG |
| 8: SET OPTIONS |
| 9: MODIFY THE REPORT |
| 10: EXIT FROM INFORM/V |
| |
| TYPE AN OPTION NUMBER> 4 |
| |
| DISPLAY OR PRINT(D/P)?> |
| |
| NUMBER OF LINES TO PREVIEW> |
_______________________________________________________________
Figure 3-6. Choosing to Preview a Report Layout
If there is no current report, INFORM/V displays the following message:
CURRENT REPORT HAS NOT BEEN SPECIFIED
TYPE A REPORT NAME(6)>
If a current report is present, the following prompt appears:
DISPLAY OR PRINT(D/P)?>
Press RETURN or D to preview the report layout on the terminal. Type a P
to have the preview listed on the line printer. When the report layout
is displayed, 9's are substituted in numeric fields, and X's are
substituted in character fields. The plus (+) preceding the 9's in a
numeric field is called a sign field. If the actual data contains a
negative number, for example, the sign field will contain a minus sign
(-).
The next prompt to appear is:
NUMBER OF LINES TO PREVIEW>
You may not want to preview the entire report. You may simply want to
look at a few lines. This prompt gives you that chance. Press RETURN to
have five lines of the report displayed. Five lines is usually enough
for you to get a good idea of the report's layout. Enter another number
to have more or fewer lines printed.
A report preview is shown in Figure 3-7.
_____________________________________________________________________
| |
| SALES |
| |
| NAME PRODUCT NUMBER QUANTITY |
| --------------------------------------------------------------|
| XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXX +9999999 |
| XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXX +9999999 |
| XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXX +9999999 |
| XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXX +9999999 |
| XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXX +9999999 |
| |
| *****END OF PREVIEW***** |
| |
| PRODUCE THE REPORT(Y/N)?> |
_____________________________________________________________________
Figure 3-7. Preview of a Report
After the preview, INFORM/V asks you if you want to produce the report:
PRODUCE THE REPORT(Y/N)?>
Type Y or press RETURN if you want to produce the report, then follow the
steps described earlier in this section.
If you type N, INFORM/V displays the following prompt:
TYPE 'RETURN' KEY TO CONTINUE
When you press RETURN, the Main Menu is displayed.
MPE/iX 5.0 Documentation