Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Option | Option | Description |
---|---|---|
Note: For information about customizing your personal view/print settings, see in the Setup Manual.
Method #1
Select View/Print on the strip menu that appears when creating specific reports, and set view print settings in the View & Print Options window that appears. This method allows you to view, print, save, and archive reports, but offers fewer tools than Method #2. This method is discussed on Viewing and Printing Reports.
Method #2
Select Utilities | System | View/Print to access the View/Print Utility (documented here). You may only access reports that have been saved to “spool” (disk). Reports are saved to spool if SAVE is set to “y” in the View & Print Options window.
Modify
Modify settings in the View & Print Options window. You might do this prior to viewing or running reports in the View/Print Utility, in order to establish default settings. The View & Print Options window also determines what other options are available. For example, if you have Print set to “n”, PRINT will not appear on the strip menu. See Viewing and Printing Reports for more information about these fields.
View
Background
When a report is run, you may specify (in the When field of the View & Print Options window) that it should be run as a background process. The screen will then be freed for other uses while the report is processed, but you will only be able to view it in the View/Print Utility. This option allows you to view field settings for reports that are (or were) running in the background. A selection window will open for you to multi-select the report settings to view (Enter selects, F1 accepts). If you select more than one, press the space bar to move from one viewing to the next. If you do not have any background jobs on record, this option will not appear.
Reports
Use this option to view reports that are stored in spool. A multi-select window will open for you to select reports to view. Once a report appears, use the arrow keys to scroll and press F4 to exit. If the terminal type VT100 is being used, the screen will automatically widen to display all 132 characters of a report. The screen will return to its normal size when you have finished viewing the report.
Deferred
After setting up a report, you may choose to defer it (by setting When to “Deferred” in the View & Print Options window). This option allows you to view the field settings for the report. A multi-select window will open for you to select settings to view. Press the space bar to exit or move on to the next viewing.
Input
Field settings for a group of reports or processes can be saved to an input file. The input files can then be added together in batches, allowing a number of options (for example, all of the churn reports) to be run with one command. See Batch Setup for more information about batches. This option allows you to view the field settings for input files. A multi-select window will open for you to select settings to view. Press the space bar to exit or move on to the next viewing.
Reports
Use this option to print reports saved to spool. A multi-select window will open for you to select report settings to print.
Range
If you want to print only a portion of a report, use this option. Choose the report to print from the multi-select window. Scroll to the first line that should be printed, and type “s” (for start). Then, go to the last line that should be printed and type “e” for end. Press F1 to print the portion you have selected.
Status
This option allows you to view the status of all printers on the computer system. Information about each print job is shown, including the queue name, the printer status, the job ID, the names of the files being printed, the user ID of the person initiating the print job, the number of pages printed, the percent of the total job printed, the number of blocks in the file, the number of copies requested, and the rank of the print job in the spooler print order. Press Enter to return to the View/Print Utility screen.
Cancel
Select this option to cancel a print job because, for example, paper has jammed the printer. Before printing can continue, the job must be cancelled and the problem fixed. You are prompted to enter the ID of the job to cancel (this can be found by selecting Status, above), or the printer ID if there is only one job running on that printer. After you enter the job ID, the job is cancelled and the View/Print Utility screen reappears.
Disable Printer
You can disable (bring off line) a printer with this option. You may want to do this to print forms, or to stop a job that was mistakenly sent. When you select this option, you are prompted for the printer to disable. The View/Print Utility screen then reappears.
Enable Printer
This option allows you to enable (bring back on line) a printer that has been disabled. Printers might be disabled because of form printing (see below), a canceled print job, or a paper jam, among other things. You should designate one person (e.g., the system administrator) to enable and disable printers, to avoid confusion. Enabling and disabling do not work on Sun systems. When you select this option, you are prompted for the printer to enable. The View/Print Utility screen then reappears.
Run
Deferred
This is where you process deferred reports. Select the report to process from the multi-select window. After processing is complete, the report can be viewed or printed by other options in the View/Print Utility.
Background
Use this option to run background reports, if the report failed to run for any reason.
Batch
Use this option to start a previously defined batch process. For example, you may want to run your publishing run as a single batch process so that it can be done overnight. Batches must be set up beforehand (See Batch Setup). Select the batches to run from the multi-select window that appears. You will then be prompted if you want to continue with the processing. If the batch has prompts, they will also appear. You should be aware that some batches can take several hours to run, and stopping them may create errors in Circulation. Note that once the batch is processed, any reports saved will not immediately be added to the saved file list—you must select Scan to update the list.
Archive
Append
Archive files are spool files (reports) to which other spool files can be added. For example, you may keep all of your Subscriber Payment Journals for one month in one archive file, and then transfer the file to diskette. To append a report to an archive file, enter the archive file name in Archive File and then select the reports to acrhive in the multi-select window. The reports will be added to the archive file and the View/Print Utility screen will appear. You can then delete the reports that were appended.
Copy
Use this option to copy a report to the archive area (i.e., make it an archive file). If an archive file of the same name exists, it will be overwritten. Using the Subscriber Payment Journal example again, each month after the archive file was transferred to disk, you could copy the next Journal and thus start the file again. To copy a report, choose the report(s) to copy from a multi-select window, and then specify the name of the archive file that will be created.
Move
This is the same as Copy, above, but the report(s) selected will be removed from the report area and will exist only as an archive file. If there is already an archive file with the same name, you will be prompted whether to replace it.
Replace
This is the same as Move, above, but you will not be prompted if there is already an archive file with the same name.
Delete
Background
This option allows you to delete reports that were run as background processes. A multi-select window will open for you to specify the reports to delete.
Reports
This option allows you to delete reports from spool. You should delete unneeded reports regularly in order to conserve disk space. A multi-select window will open for you to specify the reports to delete.
Input
This option allows you to delete input files for batch processes. A multi-select window will open for you to specify the input files to delete.
Scan
This is a “refresh” option that causes Circulation to re-read the report spool area.
Select Check Disk Space from the System menu to display disk space information. Press Enter to exit to the main menu.
Select Check Date & Time from the System menu to display date and time information. Press Enter to exit to the main menu.
Select Who’s Logged In from the System menu to display a list of users logged into your system.
If there is more information than can display on one screen, press Enter to scroll down. Press Enter (or F4 and Enter) to exit to the main menu.
The Process Log contains two kinds of information:
Inputs and processing messages from any process that produces a report. This includes transaction and account bill processing, for example, as well as all of the options on the Reports menu.
Error messages from transactions. Most of these transactions are entered in Services. If a transaction does not produce an error, it will not be entered in the Process Log.
Select Process Log Report from the System menu in Graphical Utilities to display the Process Log List screen.
Click Add and complete the following fields.
Select OK and then Continue to produce the report.
Field | Type | What to enter |
---|---|---|
START DATE END DATE
date
Enter the date range to cover in the report.
ALL LOG CLASSES LOG CLASS
yes/no predefined
To include all messages in the Process Log, check All Log Classes. Or, select the log class to include: Indicate whether the report should include info messages, warnings (minor errors that do not affect data integrity), more significant errors, or fatal errors.
ALL USERS USER NAME
yes/no open (60)
Select the user(s) whose processes would be included in the report, or check All Users to include log messages from processes run by all users.
ALL TITLES TITLE
yes/no predefined
Enter the title of the report area under which these messages were produced, or check All Titles to include all reports. Click the lookup icon to the right of the Title field to display a list of report titles. Customer Service transactions are valid but they are not included in the lookup.
FUNCTION LIST
predefined
Enter the function (such as “transfer in” or “validate truck name”) to include in the report. We recommend that you enter an asterisk (*) to include all functions.
TTY LIST
open (60)
Enter the terminal ID to include in the report (enter “*” to include all). Your terminal ID will default.
Use this feature to automate the execution of certain options. For example, you can set up some publishing run processes in one batch, or run a group of reports. Most options that produce output can be included in batches (e.g., reports, account billing, the publishing run). Options that input data into the system (such as Services and Setup options, payment entry options, or Press Room Entry) cannot be included in batches.
One aim of batch processing is to reduce the time spent entering parameters for Circulation’s processing options. For example, parameters must be entered for multiple options during the publishing run (starting the run, printing bundle tops, the DM report, etc.). Since the publishing run will generally be processed with the same parameters every day, these parameters can be saved as part of a batch and run automatically.
Another advantage to batch processing is that it reduces the chance for errors due to incorrect parameters being entered. Also, it can allow a sequence of events, such as an account billing run, to proceed without needing operator intervention. A newspaper could have its account billing run set up as a batch process, and instruct a night operator to run the process before leaving at midnight. The account billing run could then process when there was no other activity on the system.
Note: Circulation does not validate prompt entries in batch processing. Therefore, you must be sure that what you enter for these prompts is valid.
Save the parameters for each option to be included in the batch by selecting Save from the option’s strip menu (see Save and Find). You may set up fields that should be prompted for when the option is run, and these prompts will appear (in alphabetical order) before you run your batch.
During the Save, be sure to check the settings in the View & Print Options Window—these settings will be used by the batch when processing the report. You will want to have either View or Save set to “y”. In File Name, you may want to change the file name extension to “<N>” (current day of month) “<D>” (current week day) or “<M>” (current month). For example if your file name is “RTL” and the batch is run on the Wednesday June 5th, the extensions would result in the following file names:
RLT.<N> would result in RLT.05
RLT.<D> would result in RLT.WED
RLT.<M> would result in RLT.JUN
Use Batch Setup to assemble the saved parameters for the options you want to include into a batch.
Enter the View/Print Utility and select Run to run the batch. Or, run the batch from a UNIX prompt (see Running a Batch from a Command Line).
After parameters for each option to be included in the batch have been saved, the batch can be set up using this option.
Select Batch Setup from the System menu to display the Batch Setup screen.
Select Add and complete the following fields.
Select Specifics to add individual options to this batch (see below).
Select Accept to complete the batch setup. The batch is now ready to run. Note that you cannot Accept this record until you define a batch input record by selecting Specifics.
After a batch has been set up, specify the options that should belong to the batch with this specific. Each option must have a previously saved file containing field parameters for that option.
Select Specifics | Batch Setup
from the Batch Setup screen to display the Batch Input Setup screen.
Select Add and complete the following fields.
Select Accept to accept the file. You can now add other saved files to the batch, or press F4 and select Exit to return to the Batch Setup screen.
You may find it more convenient to run a batch from a command line or job scheduling software than from the View/Print Utility. To run a batch in this manner, you simply enter a batch print command at the UNIX prompt or in the job scheduler. The format for the batch print command is:
<app> -b -B /tmp/batch.log -p viewprint/initbatch -P “<batchname>”
<app>
is the application name. In most cases it will be “cm”.
-b
tells the program to skip the display of the startup banner.
-B
puts the process into background mode and sends the regular output to the file /tmp/batch.log
.
-p
specifies the program to run, in this case viewprint/initbatch
-P
specifies the name of the batch
cm -b -B /tmp/batch.log -p viewprint/initbatch -P “AAMDaily”
This would run the batch “AAMDaily”. In addition to the batch name, parameters for set fields can also be specified in the “-P” command. For example, if batch “AAMDaily” includes the Daily AAM and AAM History reports, and you have set up the batch to prompt for Start Date and End Date in both reports, you could specify them by expanding the “-P” command like this:
-P “AAMDaily:STARTDATE=01/15/2001,ENDDATE=01/31/2001”
Note: If date fields use the “today” variable, you do not need to specify them in the -P statement; the current system date will be used automatically.
Field | Type | What to enter |
---|---|---|
Field | Type | What to enter |
---|---|---|
BATCH
display
Circulation displays the batch name entered on the Batch Setup screen.
SEQUENCE NUMBER
integer (3)
Enter a sequence number for this option. The sequence number determines the order in which the option will be run in the batch (i.e., option 10 will run before option 20). Enter sequence numbers in increments of 10 so that you can add an item without having to re-sequence all items.
INPUT TYPE
predefined
Indicate if this batch consists of input files or batch (subbatch) files. Enter batch only if you have previously set up another batch and you want it to run as part of this batch.
INPUT FILE
open (40)
If you entered input in Input Type, enter the file name (case sensitive) under which the parameters for this option have been saved.
SUB BATCH
setup
If you enter batch in Input Type, enter the name of the batch that should be processed.
BATCH
open (8)
Enter a name for this batch. For example, you might call a batch “Monday” if it is to be run every Monday.
DESCRIPTION
open (30)
Enter a description for this batch.
USER NAME
setup
Enter your user name. This will be the user that prints on any reports generated by the batch.
SECURITY
setup
Enter the security identification that indicates who will be allowed to run this batch (see in the Setup Manual for more information).
The performance analysis tools can be used by system administrators and others to determine the users and processes that are affecting system performance. These tools are primarily database tools; they display the total number of reads, writes, and accesses to a database either by user or by database table. There are two basic types of tools:
Reports. The Table Statistics Report, Index Statistics Report, and User Statistics Report list the number of reads, writes, and accesses to a table, index, or by a user since the database was started.
Interactive Tools. The User Statistics and Table Statistics interactive tools display the number of reads, writes, and accesses to a database within a time period (for example, the last 10 seconds), by user or table.
These tools are based on Progress VSTs (Virtual System Tables—see your Progress documentation for more information on VSTs). The tools can help you analyze system performance issues. For example, if subscriber payment processing is taking an unusually long time, you could run the Table Stats tool to see how many records are being written while it processes, and what tables are involved.
There are three reports that can be run to analyze system performance:
The User Statistics Report lists the number of reads, writes, and accesses to one or more databases by the current sessions. Each session’s user name is listed, and the sessions are listed in order of total number of accesses (with the highest users at the top of the report). The report can be run in detail mode (each database broken out separately) or in summary mode (only one line for all databases).
The Table Statistics Report lists the number of reads, writes, creates and deletes that have been made to each table in one or more databases since the database was started. The report can list tables alphabetical by table name, or in order of reads (with the tables with the most reads at the top of the report).
The Index Statistics Report lists the number of reads, writes, creates and deletes that have been made to each index in one or more databases since the database was started. The report can list tables alphabetical by index name, or in order of reads.
All of the reports have the standard view/print options.
The interactive tools give a snapshot of what is going on in the system between regular time intervals. There are two interactive tools. The User Statistics tool displays the reads, writes, and accesses for the top users within a given period of time. The Table Statistics tools displays the same thing, but for tables rather than users.
Whether users should be sorted in order of the number of database writes, reads, or accesses. With tables, the sorting can be in reads, updates, creates or deletes.
The number of users (or tables) displayed.
Whether to update the display and, if so, the time interval (in seconds) at which the display is updated.
Whether the number should be the number of reads, writes and accesses since the tool was started (cumulative) or since the display was last updated.
Once started, the tool will display the top users or tables. If run with Repeat = “y”, the screen will update every fifteen seconds (or whatever time period you entered in Every).
To exit from the interactive tools, press F4.
This option will delete context data from the system (SessionContext and SessionTempTable tables), as of a specified cutoff date (default is two days prior). A warning is displayed if a cutoff date of less than two days prior is entered.
Note: The cutoff date should not be entered for the system date while graphical sessions are active.
Select Purge Session Data from the System menu to display the Session Context Purge screen.
Enter the cutoff date.
Select Accept to begin the purge.
Press the spacebar when the purge is complete.
The Process Log is a record of all report inputs, warnings and errors that develop while running jobs. You may want to delete log files that are older than a certain date, in order to save disk space.
Select Purge Process Log from the System menu in Graphical Utilities to display the Purge Process Log screen.
Enter the cutoff date and log type.
Click OK and then Continue to begin the purge.
Field | Type | What to enter |
---|---|---|
CUTOFF DATE
date
Enter the cutoff date. Only processes that occurred on or before this date are purged. Choose a cutoff date 30-45 days prior to the current date. Process log information should be retained for at least 30 days for error tracking purposes.
LOG TYPE
predefined
Indicate what should be included in the report: info (general information about processes started and completed, etc.), warning (minor errors which do not affect data integrity), error (a more significant problem which may affect data integrity), or fatal (an error which causes some or all processing activity or printing to cease or be skipped). Enter “*” to multi-select log types.
When writing a custom program or using Results (where you create ad hoc reports), it is useful to have a list of all files where a certain field is referenced. Use Find Fields to produce this list.
Select Find Fields from the System menu to display the Find Fields Report screen.
Select Add and enter a text string for which you want to search. You can press F2 to select from a list of exact field names.
Select Continue to produce the list. The list can be viewed and printed like other reports.
This section guides the user through the menu options that are available under the System menu.