Vista Plus for MPE Administrator’s Guide
610 Newport Center Drive, Suite 1400, Newport Beach, CA 92660
This guide contains proprietary information which is protected by copyright. The information in this guide is subject to change without notice and does not represent a commitment on the part of Quest Software. The software described in this guide is furnished under a license or nondisclosure agreement. This software may be used or copied only in accordance with the terms of this agreement.
T A B L E O F C O N T E N T S VISTA Plus for MPE Administrator’s Guide Chapter 1 - Getting Started..................................................................................................................................1-1 A Word About Installation.................................................................................................................1-2 About This Guide .....................................................................................................................
VISTA Plus for MPE Administrator’s Guide Chapter 4 - Managing Folders ............................................................................................................................ 4-1 Folder Profile Maintenance Window......................................................................................................4-2 Folder Profile Inquire Window...........................................................................................................4-6 Expanding a Folder ..............
Table of Contents Chapter 8 - Printer Maintenance .........................................................................................................................8-1 Printer Maintenance Window ................................................................................................................8-2 Printer Inquire Window .........................................................................................................................8-5 Chapter 9 - Archiving Reports ..............
C H A P T E R 1 Getting Started VISTA is an electronic report management application that allows you to quickly view long reports without wasting the paper and time it takes to print them. You can use it to skim through any report and search for specific text faster than you can page through a paper printout. There are two enhanced versions of VISTA VISTA Plus for MPE and VISTA Plus for Windows MPE. Like VISTA, VISTA Plus for MPE uses a character-mode interface.
Chapter 1 A Word About Installation The VISTA module you purchase either VISTA or VISTA Plus for MPE is installed automatically along with NBSpool. For information on installing NBSpool, refer to either the NBSpool for MPE Reference Guide or the NBSpool for MPE Demonstration Guide. If you are using VISTA Plus for Windows MPE, you must install it on each PC that will be used as a VISTA Plus client.
Getting Started About This Guide This guide describes VISTA administration tasks for VISTA, VISTA Plus for MPE, and VISTA Plus for Windows MPE. All chapters except Chapter 2 apply to all three products. Chapter 1 This chapter introduces VISTA and VISTA Plus. Chapter 2 This chapter covers procedures and programs that are unique to administering the VISTA Plus for Windows MPE client, including installation and configuration.
Chapter 1 VISTA Plus Overview VISTA is Easy to Use Viewing reports is simple with VISTA. You can quickly scroll through any report, or select a specific page to be displayed and printed. VISTA also offers function keys that let you move within a report, search for text strings, and customize VISTA. The terminal’s arrow keys can be used to scroll the report vertically and horizontally. The terminal’s tab key can be used to shift the report’s page 80 characters to the right.
Getting Started Customization Options VISTA offers several viewing configuration options, including the width and length of the screen. If the terminal or PC supports 132-column displays and the configuration variable for the screen width is set to 132 columns, VISTA automatically loads reports in a compressed display format for viewing an entire page at a time. Similarly, you can define the number of lines to be displayed.
Chapter 1 VISTA Plus Features VISTA Plus increases the number of pages allowed per report from 32,000 to 100,000 and offers you the additional features listed below (these features are not available with VISTA Plus for Windows MPE). Turn to the VISTA Plus for MPE User’s Guide for more information on these features. • The Notes function for creating, editing and viewing electronic notes. • The Add Field function for adding fields to a report.
Getting Started Report Viewing Features VISTA offers the following features when viewing a report: • Captures and catalogs production reports automatically for long or short-term storage. • Provides easy organization of similar reports via VISTA folders. • Supports both spool files and MPE files. • Compresses reports, reducing disk storage requirements. • Retains multiple report generations with automatic cleanup. • Provides robust security features at the report level for viewing, deleting, and printing.
Chapter 1 Operational Overview This section provides an overview of working with VISTA folders and reports. Capturing Reports Folders can be created to hold reports with similar information, and to separate them by department and users. A report folder named “Payroll” can be created to hold reports associated with the payroll function. Storing reports in a folder that describes them will assist future users determine where a report is located.
Getting Started Restricting Access Security can be assigned to individual reports by running the VISTA Report Maintenance program. When security has been assigned to a report, VISTA does not allow users to view reports that they have not been authorized to read. Turn to Chapter 7 in this guide for more information on defining report security. Components VISTA is a combination of several components.
Chapter 1 Additional VISTA Programs The following is a list of additional VISTA programs that allow you to manage captured reports: VISTA This program provides online viewing of reports. Turn to the VISTA Plus for MPE User’s Guide or the VISTA Plus for Windows MPE User’s Guide for more information. VISTAMNT This program is used by the VISTA administrator to add, modify, or delete reports, folders, users, and security. The functionality of this program is discussed throughout this guide.
Getting Started Starting the VISTA Administration Program This section provides instruction on starting the VISTA Administration program. Follow the instructions in this section to start the VISTAMNT program. Note. Anyone with SM capability can run this program, modifying reports and security across accounts. You should secure this program by assigning a lockword to the file. :RUN VISTAMNT.PUB.NETBASE When you start the VISTAMNT program, VISTA Plus Maintenance window shown below appears.
C H A P T E R 2 Server Administration for Windows Clients This chapter covers the procedures and programs that are unique to administering VISTA Plus for Windows MPE clients from a VISTA Plus MPE server: • The first part of the chapter covers the setup required to run the VISTA Plus for Windows MPE client.
Chapter 2 Installation and Configuration for Windows Clients Review the flow chart below for the installation order of VISTA Plus for Windows MPE. NBSpool and VISTA Plus for MPE must be installed on the HP 3000. The VISTA Plus for Windows MPE application must be installed on each Windows client that requires access to the reports on the HP 3000 server. Once these products are installed, several steps must be performed to configure the VISTA Plus server to accept VISTA Plus for Windows MPE clients.
Server Administration for Windows Clients Step1 Install VISTA Plus on the HP 3000 VISTA Plus for MPE must be installed on the HP 3000 machine that will be used as the server for your Windows clients. VISTA Plus is packaged as a module to NBSpool and in most cases, is automatically installed when NBSpool is installed. If VISTA Plus was already installed, you can skip this step. If VISTA Plus was not installed with NBSpool, you must purchase a VISTA Plus upgrade package that includes the VISTA Plus files.
Chapter 2 Step 3 Configure Folder Profiles Folder profiles must be defined for each user who will view reports using the VISTA Plus for Windows MPE client. For more information on maintaining and defining folder profile records, refer to Chapter 4 in this guide. Any folder profiles currently being used with the VISTA Plus character-mode product can also be used by VISTA Plus for Windows MPE. Note. Folder profiles are optional with the VISTA Plus character-mode product.
Server Administration for Windows Clients 3. Define the demo folder profile exactly as shown below. Use the Tab key to move between fields. Use the Enter key on your number pad when you have filled the screen as shown below. 4. Press the Save Changes function key and then use F8 to return to the main menu.
Chapter 2 Step 4 Add Users This section provides information on adding VISTA Plus for Windows MPE users to the VISTA Plus server. The VISTA Plus server maintains a users file with the names of all users that will access the reports on the HP 3000. Each VISTA Plus user that will access reports must be added to this file to establish a connection to the VISTA Plus server.
Server Administration for Windows Clients Add Users VISTAMNT Administration Program This section provides instructions on using the VISTA Plus VISTAMNT.PUB.NETBASE administration program to add a user record. A user record must be created for each VISTA Plus for Windows MPE client. Follow the instructions below for adding a user with the vistamnt program. The values that you enter for session user and account must also be entered when you use the vusers program to add a VISTA Plus user.
Chapter 2 2-8 2. Define the demo user record exactly as shown below. Use the Tab key to move between fields. Use the Enter key on your number pad when you have filled the screen as shown below. 3. Once this is complete, use F8 to go to the main menu and then F8 again to exit the program.
Server Administration for Windows Clients Add Users VUSERS Program This section provides instruction on adding a VISTA Plus for Windows MPE user to the VISTA Plus server using the vusers program. To add a user with the vusers program: 1. Log on as the NetBase manager on the HP 3000. :HELLO TED,MGR.NETBASE 2. Enter the POSIX shell and change to the vcs directory. :sh.hpbin.sys $cd /vcs 3. Start the vusers program. $shell/iX> ./vusers 4.
Chapter 2 Step 5 Enable VISTA Plus for Windows MPE To enable VISTA Plus for Windows MPE, a flag in the VISTAINI.DATA.NETBASE file must be set to ON. The flag is named $VISTA-PLUS-FOR-WINDOWS. A text editor must be used to modify the VISTAINI.DATA.NETBASE file. Note. This procedure must be performed to enable VISTA Plus for Windows MPE. To enable VISTA Plus for Windows MPE: 1. Log on as the NetBase manager on the HP 3000. :HELLO TED,MGR.NETBASE 2. Change to the DATA group. :CHGROUP DATA 3.
Server Administration for Windows Clients Step 6 Index Folders for VISTA Plus for Windows MPE If you are installing VISTA Plus for Windows MPE for the first time, follow the procedure given here to create the demo folder. To create the demo folder: 1. Create a spoolfile to view: :FILE DEMORPT;DEV=LP,1 :LISTF @.PUB.NETBASE,2;*DEMORPT 2. Run the NBSPool program: :RUN NBSPOOL.PUB.NETBASE 3. Create the DEMO VISTA folder: VSAVE DEMORPT;FILE=DEMO.ARCHIVE.NETBASE;INDEX;LIMIT=999,100000 4.
Chapter 2 When capturing reports in batch mode, you should periodically monitor these datasets to verify that space is available to support the indexing of captured reports. Note. The VISTA Plus for MPE character-mode product only requires the ;INDEX option when reports contain search indices. However, the VISTA Plus for Windows MPE client requires that the ;INDEX option be specified for all reports. Indexing Existing Folders You may have a lot of reports that have been captured but not indexed.
Server Administration for Windows Clients Step 7 Start the VISTA Plus Server The VISTA Plus server process provides clients access to folders containing report data. As clients request pages of a report, the server process obtains the pages and sends them to the client for display. The server process executes in a batch job named VISTAPLS.JOB.NETBASE. This batch job must be executed to provide clients access to reports. To launch the server process, stream the batch job VISTAPLS.JOB.
Chapter 2 Server Programs for Windows Clients This section covers the files and programs that are installed on the HP 3000 server to support the VISTA Plus for Windows MPE application. These files and programs allow the VISTA administrator to control the server, add and manage users, and view information on the server background process. The files discussed in this section can be accessed with the following steps. To access VISTA Plus server configuration files: 1.
Server Administration for Windows Clients Using the VCTL Program This section provides instructions on using the vctl program. The vctl program enables the VISTA Plus administrator to display information on the server and to stop the server. The available options are listed below. VCTL Program Options abort Immediately aborts the VISTA Plus server and terminates all client processes. ping Checks to see if the VISTA Plus server is responding.
Chapter 2 To display the status of the server, enter the vctl program’s status command. # ./vctl status Control Port: 3105 Server Version: Server Id: Server Pid: Started: Last Login: CPU time: Current Clients: Maximum Clients: X.X 1101002 1933 04/11/94 15:14 04/11/94 15:30 0 1 20 Permanent license.
Server Administration for Windows Clients Using the VUSERS Program This section provides information on using the vusers program to add, list, and modify VISTA Plus for Windows MPE users. For more information on maintaining and defining user records, refer to Chapter 6 in this guide. To access the vusers program: 1. Log on as the NetBase manager on the HP 3000. :Hello Ted,MGR.NETBASE 2. Enter the POSIX shell and change to the vcs directory. :sh $shell/iX>cd /vcs 3.
Chapter 2 To list a user, enter the vusers program’s list command followed by the name of the user. For example, list Ted. You may also list every user by typing list only.
Server Administration for Windows Clients Modifying the SERVER.CFG File You can configure several options in the server.cfg file which will affect the operation of VISTA Plus. Instructions for using the options are provided below. For information on configuring parameters in the VISTAINI and VISTACFG files, see Chapter 10. Item Description and Use socket This number represents the Port Number for the VISTA Plus server. The default Port Number is 3105.
Chapter 2 time_out_margin 2-20 This number plus the time_out number specifies the maximum time interval of inactivity allowed before a VISTA Plus client/server connection is terminated. For example, if time_out was set to 5 and this number was set to 2, the server will terminate the client connection if there is no client activity for 7 minutes. Client inactivity can result from a GPF error, client power off, or other system error. If the time_out number is 0, the time_out_margin number is not used.
Server Administration for Windows Clients Setting Up for VISTA Plus e-mail This section describes the setup required before users can send e-mail from VISTA Plus for Windows MPE. The e-mail function is available with version 2.2 and higher. It is the VISTA Plus administrator’s responsibility to set up each VISTA Plus client to interface with the e-mail MAPI using a MAPI *.DLL obtained from a third-party vendor. Both MS Mail and cc:Mail use the MAPI interface, which is installed with the mail provider.
Chapter 2 Setup for Windows 95 Clients Here is the e-mail setup required for VISTA Plus clients running Windows 95. To set up for MS Mail: 1. Install MAPI.DLL in the WINDOWS\SYSTEM directory. To set up for cc:Mail: 1. Install MAPIVIM.DLL in the WINDOWS\SYSTEM directory. 2. Add the directory containing VIM.DLL to the DOS path, for example: X:\CCMAIL\CCMAIL where X: is the drive containing the cc:Mail directory 3. Add the following lines to the WIN.
C H A P T E R 3 NBSpool Commands This chapter provides information and instruction on the NBSpool commands that are used with VISTA. NBSpool is a spool file management program provided by Quest Software. The NBSpool program is used in conjunction with VISTA to quickly browse through spool files, display the contents of a VISTA folder, and save spool files to a VISTA folder. All of these commands can be grouped together for complete automation.
Chapter 3 BROWSE Command The BROWSE command invokes the VISTA Online Report Viewer for a subset of spool files from within NBSpool. The BROWSE command executes in two stages. First the subset of spool files are processed for viewing, then the VISTA Online Report Viewer is invoked. You can then view any reports specified in the subset. The BROWSE command creates a temporary VISTA folder named VISTATMP, which can be reexamined by entering BROWSE with no parameters.
NBSpool Commands BROWSE Command Parameters subset This parameter specifies the subset of spool files to be viewed. The format of this parameter is described under the topic SUBSET of the NBSpool Online Help facility. ASK This parameter prompts each file to include for processing. COMP This parameter specifies that compression should be used when processing the spool files (building the temporary folder file).
Chapter 3 VDIR Command The VDIR command displays the directory of a VISTA folder. The display format is similar to that for the Show command. A sector count shows how many sectors in the folder are used by each spool file, not the original number of sectors in the spool file. The size of the folder and its directory is displayed before the list of spool files. Available folder space is also displayed. VDIR Command Syntax O> VDIR filename O> VDIR subset;FILE=filename Note.
NBSpool Commands VDIR Command Examples To list the reports in the folder MONTHEND.ARCHIVE.NETBASE: O> VDIR MONTHEND.ARCHIVE.NETBASE Directory for Folder created on 01/11/93 09:44:48 Folder Directory Limit = 10 Directory Entries Available = 7 Folder Limit in Sectors = 500 Folder Sectors Available = 459 FILENAME JOB SESSION USER NAME PAGES SECTORS WHEN CREATED ------------------------------------------------------------------APMONTH DEMO MGR.NETBASE 1 7 01/11/93 09:44 ARMONTH DEMO MGR.
Chapter 3 VFILE Command The VFILE command stores one or more non-spool files into a VISTA folder file for later access by the VISTA online report viewer. If a file is not a fixed ASCII file or a spool file, it will be ignored and a warning message will be displayed. For more information on using VISTA folders, see the command in the following section. VFILE operates on any ASCII file with a record size of no more than 512 bytes. The block size must be less than 8,192 bytes.
NBSpool Commands VFILE Command Parameters fileset This parameter specifies the set of disk files to be saved. The format of this “fileset” is the same as that used by the MPE LISTF command. TEMP This parameter specifies that only files in the temporary domain will be processed. filename This parameter specifies the formal file designator of a new folder file. This file cannot exist before the command is executed unless APPEND is also specified.
Chapter 3 VFILE Command Examples To save all files beginning with “N” in the DOC group to the DOCFILES folder: O> VFILE N@.DOC;FILE=DOCFILES FILE NAME RECORDS STATUS -------------------------------------------------------------NBHYPER.DOC.NETBASE 82 Processed NBINSTAL.DOC.
NBSpool Commands VSAVE Command The VSAVE command stores a subset of spool files to a folder, creating the folder if necessary. A folder is a term used to describe a file that contains reports. As spool files are copied to the folder, they are compressed. This reduces the disk space required by up to fifty percent (50%). Spool files within a folder can be viewed with the VISTA Online Report Viewer program. The VSAVE command also enables you to create a folder.
Chapter 3 VSAVE Command Syntax o> VSAVE [subset] ;FILE=[filename] [;DESC=“description” [;FLAG=errorflag [;LIMIT=files[,sectors] [;LPP=lines [;NEWPRI=outpri [;OVERSTIKE={Y|N|C} [;PRINTER=printername [;RDESC=“reportdesc” [;START=firstrec [;APPEND [;ASK [;FFSCAN[=“ffdelim”] [;INDEX [;NOCOMP [;NOSTRIP [;PURGE [;RELEASE ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] Note. This command can be abbreviated to VS.
NBSpool Commands Outpri This parameter specifies the output priority to assign to spool files that have been captured with the VSAVE command. Lines This parameter assigns a default number of lines per page to reports in a folder. You do not need to specify this option when reports contain form feeds. The default number of lines per page is 60. Printername This parameter specifies a default printer definition name defined by the PRINTDEF program.
Chapter 3 VSAVE Command Examples To add all GL reports (spool files with a filename starting with GL) to a folder (GLREPS) creating a description, and then altering their priorities to 8, enter: O> VSAVE GL@;FILE=GLREP.ARCHIVE.NETBASE;DESC=“General Ledger Reports”;NEWPRI=8 8 Spool files Qualify DFID FILENAME JOB USER NAME SECTORS STATUS -----------------------------------------------------------------#O387 GL0100 #S35 MGR.NETBASE 32 PROCESSED #O390 GL0100 #S35 MGR.
NBSpool Commands XEQ Command The XEQ command executes one or more of the NBSpool commands either once or repetitively. The major use of this command is to execute various NBSpool functions in a background job. The command first parses all commands in the input file. If any command is not valid, the entire XEQ command is terminated. As each command is parsed, it will be displayed with a special X> prompt. Continuation lines are valid up to 254 characters.
Chapter 3 Background Execution More than one XEQ command can be executed simultaneously in one job or session by using the XEQ ...;BACKGROUND option. This option starts a son process and executes in the background. As many as eight background processes can be started in this manner, unless SET MAXPROCS is used, which allows up to 99 processes. Each son process has its option routed to a spool file named XEQOUTn, where n is a number from 1 to 8 of the process in question.
NBSpool Commands Valid XEQ Commands The following is a list of commands that can be used in the body of an XEQ file. ALTER ARCDIR ARCHIVE BANNER COPY DUP END ERROR INPUT MERGE MOVE OUTPUT PURGE RESTORE SHOW SORT STORE STREAM TAPEDIR UNARCHIVE VDIR VSAVE XEQ Command Syntax O> XEQ [filename] [;REPEAT=count [;WAIT=seconds [;PROCNUM=number [;DEVICE==dev[,dev[, [;PRI=priority [;BACKGROUND [;SHOW [;SHORT ] ] ] ]]] ] ] ] ] Note. This command can be abbreviated to X.
Chapter 3 XEQ Command Parameters 3-16 filename This parameter specifies the name of the file that contains the command to be executed. If omitted, the commands will come from the $STDIN. count This parameter specifies the number of times to execute the commands. The default is 1 unless the WAIT= parameter is specified, in which case the default is repeated forever. seconds This parameter specifies the number of seconds to delay between executions of the commands. The default is 60 seconds.
NBSpool Commands XEQ Command Examples The file MOVECMDS.SPOOL is an ASCII file that contains a number of MOVE commands. To repeat these move commands every 20 seconds, enter: O> XEQ MOVECMDS.SPOOL;WAIT=20 To execute the same file only once and to show the commands as they occur, enter: O> XEQ MOVECMDS.
Chapter 3 XEQSTOP Command The XEQSTOP command is used to stop an executing NBSpool process. An NBSpool process is one which is executing an XEQ command with either a repeat or wait option. The process number is assigned when the process is first started and is displayed in the $STDLIST and on the console. The XEQSTOP command takes effect when the executing process reaches the end of its list of commands to execute. This command requires SM or OP capability.
C H A P T E R 4 Managing Folders This chapter provides information and instruction on managing VISTA folders. As a VISTA administrator, you will be responsible for adding, deleting, and modifying VISTA folders. This chapter also provides a section on expanding and cleaning folders. For information on building folders, turn to the section in this chapter titled “Running VISTACLN.
Chapter 4 Folder Profile Maintenance Window The Folder Profile Maintenance window allows you to add, delete, find, and modify folder profiles. Folder profiles are a way of linking multiple folders and associating them to a specified user account. They allow you to define the folders each user or group of users can access in VISTA. When a user belongs to a group that has been assigned folder profiles, VISTA retrieves folders based on the group record and not on the user’s record.
Managing Folders To add a folder: 1. Enter A in the Function field of the Folder Profile Maintenance window. 2. Enter the folder profile and description. Then, enter a folder title and filename, and press Enter. 3. Save the changes by pressing F6 or the Save Changes button. To modify a folder: 1. Enter F in the Function field to find the folder you want to modify. 2. Enter folder profile and description information and press Enter. 3. Enter M in the Function field to modify the folder. 4.
Chapter 4 The sample below shows how the folders defined in the Profile Maintenance window would look in the Select Report window when you run VISTA Plus. Folder Profile Maintenance Fields The following fields appear in the Folder Profile Maintenance window. 4-4 Folder Profile This field displays the set of folders associated with a common name. Description This field displays a description for a given set of folders.
Managing Folders Folder Profile Maintenance Function Keys This section provides information on the Folder Profile Maintenance function keys. F1 List Folders This option displays the Folder Profile Inquire window, which lists all the folder profiles that have already been created. F2 Next Page This option displays the next page of folder profiles. F3 Previous Page This option displays the previous page of folder profiles.
Chapter 4 Folder Profile Inquire Window The Folder Profile Inquire window provides online viewing of all folder profiles. A description appears next to each folder profile listed in the window. To display the Folder Profile Inquire window, press F1, List Folders, from the Folder Profile Maintenance window. The Folder Profile Inquire window shows all of the defined folder profiles. Press F2 and F3 to display the next and previous pages. To exit from this window, press F8, Previous Screen.
Managing Folders Folder Profile Inquire Fields The following fields appear in the Folder Profile Inquire window. Folder Profile This field displays the common name associated with a set of folders. Description This field displays the description for a given set of folders. Folder Profile Inquire Function Keys This section details the Folder Profile Inquire function keys. F2 Next Page This option displays the next page of records. F3 Previous Page This option displays the previous page of records.
Chapter 4 Expanding a Folder When you first create a folder, you specify the number of reports and the disk space reserved for reports within this folder. As you append additional reports to the folder, its available space is consumed. Eventually, you may need to expand the folder to hold additional reports. Enter the following command: : RUN VISTACLN.PUB.NETBASE,menu By using the menu entry point, the VISTACLN menu is displayed.
Managing Folders Cleaning Folders When deleting reports, specified reports are flagged as deleted by the user but not removed from a folder. Since reports are not removed, it is possible that a folder can become full and prevent other reports from being added. To remove deleted reports from a folder, you must perform a folder cleanup process. The folder cleanup process is performed by executing the VISTACLN.PUB.NETBASE program.
Chapter 4 Running VISTACLN The VISTACLN program can be used in several different ways, depending on what you want the program to do. If you want to simply remove reports from a specified folder based on generations or months and days defined in the report record, you can run the program without any entry points. Enter the following command: : RUN VISTACLN.PUB.
Managing Folders Each of the options listed on the VISTACLN menu has a specific entry point name associated with it. You can either select the number of the option you wish to use from the VISTACLN menu, or you can use the entry point name with the VISTACLN command as follows: : RUN VISTACLN.PUB.NETBASE,entrypoint Each of the entry points is described in the following sections. They are numbered according to the order in which they appear on the VISTACLN window. 1.
Chapter 4 2. GENERATION The Generation entry point overrides generation numbers assigned to reports. The number you enter here will be used instead of the number defined in the Archive Rules window under Report Maintenance. The generation number entered overrides generation numbers assigned to each report within the folder. Stop! Entering a value of zero (0) will remove all reports in the folder. For example: : RUN VISTACLN.PUB.NETBASE,GENERATION Enter folder fileset to remove reports from: TESTFD1.
Managing Folders 4. BUILD The Build entry point creates an empty folder. You are prompted to enter a folder name, the total number of reports that will be placed in the folder, and the total number of sectors that the folder will consume. Note. A header consumes one sector, while a directory consumes two sectors per report. For example, a directory with three reports consumes six sectors. For example: : RUN VISTACLN.PUB.NETBASE,BUILD Enter Name of folder file to create (// to cancel): SUSAN.
Chapter 4 6. UNDELETE The Undeleted entry point reverses the flag setting for any reports previously marked for deletion via VISTA. For example: : RUN VISTACLN.PUB.NETBASE,UNDELETE Enter folder file to undelete reports from: TESTFD1.ARCHIVE 10 Reports undeleted from folder TESTFD1.ARCHIVE 7. DELETED The Deleted entry point removes only reports that have been flagged for deletion by VISTA users. Many sites utilize this facility as a way for their users to control which reports are removed from folders.
Managing Folders 9. AGE The Age entry point removes reports that are older than (n) number of days. You are prompted to enter the number of days of reports to retain. The age of a report is determined by taking today’s date minus the date the report was created. For example: :run VISTACLN,age VISTA Plus Folder Clean UP [A.05.05] Copyright 1992 Quest Software Enter folder fileset to remove reports from: banner.archive Enter number of days of reports to retain (// to cancel): 60 Process folder - > BANNER.
C H A P T E R 5 Managing Reports This chapter provides information and instruction on managing reports in VISTA. As a VISTA administrator, you are responsible for adding, deleting, and modifying VISTA reports. You also have the ability to display information on all of the documents in the VISTA report database.
Chapter 5 Report Maintenance Window The Report Maintenance window allows you to assign security to reports, define the number of copies of a report to retain, and assign report descriptions. Security masks can be defined to allow specific users or a group of users to view a report. Report descriptions are displayed on the Select Report window when viewing reports within a folder. VISTA does not allow anyone to view a report they have not been authorized to view.
Managing Reports Report Maintenance Fields This section provides information on the fields found in the Report Maintenance window. Report Name In this field, enter up to an eight-character string that defines the name of a report. If you want to assign this security to all reports in this account, enter @. Job Name In this field, enter the name of a batch job that creates the report, or @. User Name In this field, enter the log on user name that creates the report, or @.
Chapter 5 Data Col In this field, enter the data column in the report to display in a window. When this field is set to 50 and the Length field is set to 20, columns 50 through 70 in the report are displayed in the window. * Length In this field, enter the number of characters displayed per line in a window. * Screen Col In this field, enter the column to start a window.
Managing Reports Report Maintenance Function Keys This section details the Report Maintenance function keys. F1 List Reports This option displays the Report Inquire window for viewing all report records. F2 Next Report This option displays the next report record. F3 Previous Report This option displays the previous report record. F4 Define Index This option displays a window for modifying and deleting indices. You can modify a blank index to be functional.
Chapter 5 Report Maintenance Functions Add This function adds a report record. Enter the report record information and A in the Function field, then press Enter. Delete This function deletes the current report record. Enter a D in the Function field and press Enter. Find This function retrieves a report record. Enter the report name in the report field and enter F in the Function field, then press Enter. If a matching record is found, the record is displayed.
Managing Reports Modifying a Report Record To modify a report record, locate the record you want. Use the Find function to retrieve a record. Use the F2 and F3 function keys to display next and previous records. When the right record is displayed, enter your changes. Then enter the letter M in the Function field, and press Enter. Deleting a Report Record To delete a report record, find the report and enter the letter D in the Function field.
Chapter 5 Assigning Report Security Security for reports will be checked when security masks have been defined for a report. When a security mask has not been assigned to a report, all users will be allowed to view the report. When security masks have been assigned to a report, only users that match the security masks are allowed to view, delete, or print the report. You can assign a security mask to a report by positioning the cursor in the User.Account field and entering a mask.
Managing Reports Report Inquire Window The Report Inquire window provides online viewing of all report records. All report records that have been defined are displayed. The Report Inquire window appears when you press F1, List Reports, from the Report Maintenance window. Function keys are available to scroll forward and backward through report records. Use F2 and F3 to display the next and previous window pages of report records. The F5, Print All function key prints report records to the system printer.
Chapter 5 Report Inquire Fields The following section describes the fields found in the Report Inquire window. Report Name This field displays an eight-character string defining the name of a report. Description This field displays a 40-character text string describing the contents of a report. Job Name This field displays the name of the job that creates the report. User Name This field displays the log on user name that creates the report.
Managing Reports Index Definition Window The Index Definition window allows you to modify and delete indices for a specified report. This window appears when you press F4, Define Index, from the Report Maintenance window. Indices for reports to be viewed with the Windows client must be defined from the server from the Index Definition window; an administrator can define up to four per report.
Chapter 5 Index Definition Fields Index Field In this field, enter the name of the index value. Page Line In this field, enter the line on which the value appears if the value is greater than zero. All Lines In this field, enter the desired value that may appear on any line within a page (Y), or the desired value that appears only on one specific line (N). Start Column In this field, enter the first column in which this value appears. Length In this field, enter the length of the index value.
Managing Reports Re-indexing Reports When you change search indices or page security for a report after the report has been saved in a folder, you need to rebuild the indices to implement the changes. Rebuilding indices implements index search options and page security. A couple of examples where this is necessary are when you create a Logical View with Page Security for a new user, or add search keys to a report.
Chapter 5 Assigning Indices to Reports To automate the addition of the indices, a slight modification is necessary to the background job. Modify the VSAVE command to include the INDEX parameter. Note. Turn to the VISTA Plus for MPE User’s Guide or the VISTA Plus for Windows MPE User’s Guide for more information on creating and saving search indices. !JOB VISTA,OPERATOR.SYS !COMMENT This batch job wakes and runs every 2 minutes ! !RUN NBSPOOL.PUB.NETBASE XEQ;WAIT=120 VSAVE IVBYDEPT,%1;FILE=IVRPT.ARCHIVE.
Managing Reports Report Profile Maintenance Window The Report Profile Maintenance window allows you to add, delete, find, and modify all existing field definitions for reports. This is a VISTA Plus feature. The definitions that will be used when you set up page security for specific users and reports in the Logical View Maintenance window must be set up here first. Note. You can define fields in VISTA using the Add Field function.
Chapter 5 Report Profile Maintenance Fields This section gives information on the fields that appear in the Report Profile Maintenance window. 5-16 Report In this field, enter the name of the report. Field Name In this field, enter the identifying name associated with the specific location defined by the line number, start column, and length. This name will be used in Page Security to define selection criteria. Line Number In this field, enter the line number on the page where the field is located.
Managing Reports Link Reports to User Window The Link Reports to User window allows you to assign specific reports to users. Up to 120 report names can be specified to each user. This reduces the number of reports a user will see when opening a folder within VISTA. When this feature is not used, every user will see the names of all reports in a folder file. Wild cards can be entered with each report name to include many reports that have similar names.
Chapter 5 Link Reports to User Function Keys This section provides information on the Link Reports to User function keys. 5-18 F1 List Users This option enters the User Inquire window where all user records can be viewed. For more information on this, see the section on User Maintenance. F2 List Reports This option enters the Report Inquire window which lists all report names with their descriptions, as well as job name, user name, and account name.
Managing Reports Columns Specification Maintenance Window The Columns Specification Maintenance window allows you to define the columns specific users of a report will be able to view. Use this screen to create definitions and give the columns for a specific report an identifying name and description. Note. This is a VISTA Plus feature. To display the Columns Specification Maintenance window, start the VISTAMNT program, enter 8 in the Function field of the VISTA Plus Maintenance window, and press Enter.
Chapter 5 Columns Specification Maintenance Fields The following fields appear in the Columns Specification Maintenance window: 5-20 Columns ID A 16-character identifying name for a set of columns associated with a specific report. Description A 40-character string that describes the column ID. Report An eight-character string defining the name of the report to which the column ID pertains. Column Number The column number to which the column ID pertains.
Managing Reports Capturing Reports to VISTA Folders NBSpool’s background processing capability can be used to create folders automatically. Spool files can be copied to the folder directly from the MPE spooler. Background processing is made available through the use of the XEQ command, which executes a list of commands either once or repetitively. The execution of the command list is implemented as a background task if the REPEAT or the WAIT parameter is specified.
Chapter 5 Deleting Reports from a Folder If a folder is full, you can delete old versions of a report using the VISTACLN.PUB.NETBASE program. This program deletes the oldest n versions of a report within a specific folder. While in the VISTAMNT program, you can define n for different reports. In the VISTAINI.PUB.NETBASE initialization file, you define a default n to be applied to all other reports.
C H A P T E R 6 Managing Users and Groups This chapter provides information and instruction on managing users and groups. As the VISTA administrator, you will be responsible for defining user and group access. VISTA offers several windows which allow you to configure VISTA users and groups. This chapter contains the following sections: • User Maintenance • User Inquire Window • VISTA Group Maintenance Window • VISTA Group Inquire Window • Routing List Maintenance Window Note.
Chapter 6 User Maintenance Window The User Maintenance window allows you to view, modify, delete, and add user records. A user record defines a default printer and the group a user belongs to. You can link folder profiles to user records and group records in the Folder Profile Maintenance window. Folder profiles define the folder sets a user can access in VISTA. For more information on defining folder profiles, turn to Chapter 4 of this guide. Note.
Managing Users and Groups User Maintenance Fields This section provides information on the fields that appear in the User Maintenance window. Session Name In this field, enter the log on session name that creates the report, or @. User Name In this field, enter the log on user name that creates the report, or @. Account Name In this field, enter the log on account name that creates the report, or @.
Chapter 6 Adding a User Record Enter A in the Function field and enter information in the appropriate fields. Press Enter to add the record. If a user record exists, then a message will be displayed specifying that the user record cannot be added. Note. At a minimum, the Session Name, User Name, and Account Name fields must be entered. Finding a User Record Enter F in the Function field and enter the Session Name, User Name and Account Name for the user you wish to find.
Managing Users and Groups User Inquire Window The User Inquire window provides online viewing of all user records. Press F1, List Users, from the User Maintenance window to display the User Inquire window. Press F2 and F3 to display the next and previous pages of user records. To exit this window and return to the User Maintenance window, press F8, Previous Screen. User Inquire Fields This section provides information on the fields that appear in the User Inquire window.
Chapter 6 User Inquire Function Keys This section provides information on the User Inquire window’s function keys. 6-6 F2 Next Page This option displays the next page of records. F3 Previous Page This option displays the previous page of records. F8 Previous Screen This option exits the User Inquire window and displays the User Maintenance window.
Managing Users and Groups VISTA Group Maintenance Window The VISTA Group Maintenance window allows you to view all existing groups with their associated folder profiles. The folder profiles are maintained in the Folder Profile Maintenance window. However, you can use the Folder Profile fields in this window to link folder profiles to a specific group. This controls which folder profiles users in a specified group view when they execute VISTA. A maximum of 21 folder profiles can be assigned to a group.
Chapter 6 VISTA Group Maintenance Function Keys This section provides information on the VISTA Group Maintenance window’s function keys. 6-8 F1 List Groups Select this option to enter the VISTA Group Inquire window. This window displays all group records. F8 Main Menu Select this option to return to the main menu.
Managing Users and Groups VISTA Group Inquire Window The VISTA Group Inquire window shows all defined group names and their descriptions. To display the VISTA Group Inquire window, press F1, List Groups, in the VISTA Group Maintenance window. Use F2 and F3 to display next and previous screen pages of group records. VISTA Group Inquire Function Keys This section provides information on the VISTA Group Inquire window’s function keys. F2 Next Page This option displays the next page of records.
Chapter 6 Routing List Maintenance Window The Routing List Maintenance window allows you to define who views which reports and in what order they are viewed. Note. This is a VISTA Plus feature. This feature is not available for Windows clients. When you want users to view a report in sequence, the View in Sequence field must be specified as Y or Yes. When Yes, the current user must approve the report in order for the next defined user to have permission to view the report.
Managing Users and Groups Routing List Maintenance Fields This section provides information on the fields in the Routing List Maintenance window. Report Name In this field, enter an eight-character string for the name of a report, or an @ symbol. Job Name In this field, enter the log on job name that creates the report, or @. User Name In this field, enter the log on user name that creates the report, or @.
Chapter 6 Routing List Maintenance Function Keys This section provides information on the Routing List Maintenance window’s function keys. 6-12 F1 List Routing Select this option to view a routing list from the Routings Inquire Screen. F2 Next Page Select this option to view the next page. F3 Previous Page Select this option to view the previous page. F8 Main Menu Select this option to return to the main menu.
C H A P T E R 7 Security This chapter provides information and instruction on implementing VISTA security. VISTA contains many powerful and flexible security options. As a VISTA administrator, you will be required to manage the security settings for folders, reports and users. These settings allow you to control which folders and reports users can access.
Chapter 7 Folder Security When VISTA starts, it looks for folder files in the ARCHIVE group of the NETBASE account. This logic can be altered by specifying an INFO string with the MPE RUN command when VISTA is started. If you specify RUN VISTA;INFO=“@.FOLDERS.PAYROLL,” VISTA looks for folders in the FOLDERS group of the PAYROLL account. For example: RUN VISTA.PUB.NETBASE;INFO=“@.folders.payroll” Multiple folder files can also be specified with the INFO string of the MPE RUN command.
Security Folder Selection Rules The following rules apply to folder selection, in descending order of importance: 1. Folder Profiles defined in the Group Record. 2. Folder Profiles defined in the User Record. 3. Folders specified on the INFO string. 4. Folders defined in the ARCHIVE group of the NETBASE account. Folder Security Rules The following rules apply to folder security, in descending order of importance: 1. MPE security must be set to allow user access to folders.
Chapter 7 User Security User security can be utilized to define the folders users will see when they execute VISTA. In addition, the reports that are displayed when a user opens a folder can be defined. The User Maintenance window within the VISTA Maintenance program can be utilized to create User Records. User Records define a default printer and folder profiles that will be displayed when a user executes VISTA. User records can be used to control the folders a user can access.
Security Report Security All users can read a report until one or more security masks are assigned to it. Once a security mask is assigned, then only the users matching the security mask are allowed to read or delete a report. A user is not allowed to delete a report unless that capability has been assigned to the user or the user is also the report creator. Read and Delete security is assigned to a report in the Report Maintenance window described in Chapter 5 of this guide.
Chapter 7 Report Keys When security is assigned to a report, security masks are linked to a report key. A report key defines a unique report within the system and consists of a report name and the creator of a report (session,user and account names). Report keys allow different security masks to be assigned to reports with the same name but created by different batch jobs or by different users.
Security Report Security Checking when Viewing The following report security checking takes place when you attempt to view a report. If one of these applies, you will be allowed to view the report: • No security masks have been assigned to the report. • You are the report creator. • You have System Manager capability. The VISTAINI file’s $ALLOW-SM-SYSCAPABILITY option must be enabled. • You are the Account Manager of the account where the report was created.
Chapter 7 Assigning Report Security There are two methods of assigning report security: • Assigning Users to Reports • Assigning Reports to Users The advantages and disadvantages of each method are detailed in the following section. Assigning Users to Reports Use this method to define which users can read, print, and delete a report. When you use this method, you can easily determine all users who can read or delete a report.
Security Assigning Reports to User Assigning reports to users eliminates the disadvantages of the first method. With this method, report names are assigned to a specific user. When a folder is opened, the user will only see the names of reports that have been assigned to them. A user name consists of session name, user name and account name. This allows VISTA to reference a specific user on the system. Use the Link Reports to User window to define reports a user can access.
Chapter 7 Page Security Page security provides report security by page. Users can be assigned specific pages to view based on the contents of a report. If a report contains sales account numbers for multiple users, VISTA can be set up to allow users to view only the pages that contain their sales account numbers. A logical copy of the report is made for each user that can view the report. This eliminates retaining multiple copies of a report, thereby reducing disk space requirements.
Security Logical View Maintenance Window The Logical View Maintenance window allows you to link columns, a default printer, and other characteristics (such as lock columns and lock headings) to a specific user. Logical Views are used to tailor VISTA Plus to a specific user’s needs. Each report in the system can be setup differently for each user that will read the report. Use logical views to set up page-level security. When VISTA Plus is executed, it looks to see if a logical view has been defined.
Chapter 7 Logical View Maintenance Fields This section gives information on the fields that appear in the Logical View Maintenance window. 7-12 Session In this field, enter the log on session identification of the user who will be viewing the report. User In this field, enter the log on user name of the person who will be viewing the report. Account In this field, enter the log on account name of the person who will be viewing the report.
Security Report Name In this field, enter a new name for the subreport. Print Device In this field, enter the printer where the subreport will be printed. Priority In this field, define the priority for printing the subreport. Copies In this field, select the number of copies to print. Logical View Maintenance Window Function Keys This section provides information on the Logical View Maintenance window’s function keys. F1 Page Security This option displays the Security Maintenance window.
Chapter 7 Adding a Logical View with Page Security Follow the instructions in this section to add a logical view with page security. 1. Enter the Logical View window. 2. Enter an A in the function and key fields. 3. Press F1, Page Security, and enter the Page Security window. 4. Add the page security information as described in the following section. 5. When you are finished making changes, press F8 to return to the Logical View window. 6.
Security Page Security Maintenance Window The Page Security Maintenance window allows you to define the selection criteria that is to be used when indexing a report by pages. After a report has been indexed, users are only allowed to view the pages that match the selection criteria. Note. This is a VISTA Plus feature. To open the Page Security Maintenance window press F1, Page Security, while in the Logical View Maintenance window. When you enter the window, you are in modify mode.
Chapter 7 Page Security Maintenance Fields This section provides information on the fields that appear in the Page Security Maintenance window. Report In this field, enter an eight-character string defining the name of a report for which you are defining page security. Field Name In this field, enter report field name defined under Report Profile Maintenance or using the Add Field function in VISTA. The field name determines the start line number, column and the length for a given user.
Security Page Security Function Keys This section provides information on the Page Security Maintenance window’s function keys. F1 Report Profile This option enters the Report Profile Maintenance window. See Chapter 5 in this guide for more information on the Report Profile Maintenance window. F2 Next Page This option displays the next page of information. F3 Previous Page This option displays the previous page of information.
Chapter 7 Page Security Example The following example illustrates a page security setup for several security fields. If any of the fields meet any of the following criteria, the user specified on the Logical View Maintenance window will be able to view the page: • Store number is either 5 or 7. The operator value is equal to. • Employee number is between the range of 20065 and 20099. The operator value is range. • The department number is 11. The operator value is equal to.
Security Additional Security Features This section provides information on additional security features available through VISTA. Group Records The Group Maintenance window within the VISTA Maintenance program can be utilized to create Group Records. Group Records define default folder profiles that are displayed when a user linked to a group with folder profiles starts VISTA.
Chapter 7 Routing Lists Routing lists simulate manually passing reports from one user to another. They retain a list of the users that are required to view a report, and track users that have read a report. With routing lists, you can easily determine which users have not read a report. Routing lists can also be used as a security mechanism. Associated with a routing list is a flag that can be enabled to allow only the users on the list to read a report.
Security Changing VISTA Database Passwords When VISTA is started, the VISTA database is opened to retrieve configuration information. To successfully open the database, the database passwords must be obtained and passed to the database open routine. The passwords are stored in and retrieved from an external file named VISTADB.DATA.NETBASE. Using an external file makes it possible for a customer to alter the passwords without having to recompile VISTA programs.
Chapter 7 Bypassing MPE Security A feature named Global Read is available to allow non-account users access to local folder files without having to release the folders. An example of using this feature is when a site wants to store all folder files in the same account but does not want to release the folders. VISTA users can read the reports within the account where they are stored but cannot read the contents of a folder with MPE utilities.
C H A P T E R 8 Printer Maintenance This chapter provides information and instruction on printer maintenance. As the VISTA administrator, you will be responsible for using the Printer Maintenance window to setup printers that will be used by VISTA users.
Chapter 8 Printer Maintenance Window The Printer Maintenance window is used to define printers and assign descriptions to a printer. The printer records are displayed in the List Printers window within VISTA. To access the Printer Maintenance window, start the VISTAMNT program. Then press F2, Printer Maint. Printer records link printers attached to an HP 3000 with optional printer definitions. When a user selects a printer, he does not have to specify a print device or a printer definition.
Printer Maintenance Printer Maintenance Fields This section provides information on the Printer Maintenance window’s fields. Printer Name In this field, enter a 16-character string defining the name of a printer. Device In this field, enter a system-configured printer device name. Print Def/Env In this field, enter a printer definition to assign to a printer. The printer definition must have been created with the PRINTDEF program. You can also specify an HP 3000 environment file for this file.
Chapter 8 Printer Maintenance Functions This section gives information on the functions available through the Printer Maintenance window. Add This function adds a printer record. Enter the printer record information and A in the Function field, then press Enter. Delete This function deletes the current printer record. Enter a D in the Function field and press Enter. Find This function retrieves a printer record.
Printer Maintenance Printer Inquire Window The Printer Inquire window provides online viewing of all printer records. You can display this window by pressing F1, Printer Inquire, while in the Printer Maintenance window. Press F2 and F3 to display the next and previous pages of printer records. To exit this window, press F8, Printer Maint, to return to the Printer Maintenance window.
Chapter 8 Printer Inquire Fields This section provides information on the fields that are displayed in the Printer Inquire window. Printer Name This field displays the 16-character string defining the name of a printer. Device This field displays an eight-character device name of a printer attached to the HP 3000. PrintDef This field displays the name of a printer definition. Environment File This field displays the name of the environment file.
C H A P T E R 9 Archiving Reports This chapter provides information and instruction on archiving reports in VISTA. As a VISTA administrator, it will be your responsibility to delete or archive outdated reports. You will also be responsible for restoring and managing archived reports. This chapter contains the following sections: • VISTA Plus Report Archiving • Archive Rules Window • Optical Disk Volume Maintenance Window Note. Report Archiving is a VISTA Plus feature.
Chapter 9 VISTA Plus Report Archiving After running VISTACLN, you can store the removed reports to tape. This provides you with longterm storage for all production reports. These reports can still be accessed in VISTA Plus using the Select Archive window. For more information on this feature and on listing archived reports, turn to the VISTA Plus for MPE User’s Guide.
Archiving Reports After the reports are placed on tape, the MPE files holding the reports are purged. The following command is used to start the VISTA Plus archive job: :STREAM VISTAARC.JOB.NETBASE VISTARST Program VISTARST is a VISTA Plus restore program. The VISTARST job restores reports from tape that have been requested by a VISTA Plus user. You can request reports to restore by entering the Select Archive screen, tagging the reports to restore, and pressing the Restore Reports function key.
Chapter 9 Archive Rules Window Archive rules specify the number of report copies to be retained, and when to store reports to tape or optical disk. When establishing archive rules, you can specify either Generations or Months and Days. If you use Generations and specify five, VISTA will save the five most recent copies of a report. If you use Months and Days, VISTA will save all copies of a report that accumulate for the specified period. The VISTA clean program (VISTACLN.PUB.
Archiving Reports Archive Rules Fields This section provides information on the fields that appear in the Archive Rules window. Archive to Tape In this field, enter a Yes/No flag that specifies whether a report is to be stored to tape. When this flag is set to Y, the VISTACLN program writes the report to tape when the report is removed from a folder. Archive to Optical Disk In this field, enter a Yes/No flag that specifies whether a report is to be stored to an optical disk.
Chapter 9 Optical Disk Volume Maintenance Window The Optical Disk Volume Maintenance window lets you create, modify, delete and view optical disk volumes available for storing archived reports. This window provides a way for notifying VISTA Plus of available optical disk volumes. It also defines the sequence VISTA Plus will use to search optical disk volumes when determining the next volume to which to write a report.
Archiving Reports Optical Disk Volume Maintenance Fields This section provides information on the fields that appear in the Optical Disk Volume Maintenance window. Volume Name In this field, enter the optical disk volume name. Archive Group In this field, enter the name of the group where reports will be written. Archive Account In this field, enter the name of the account where reports will be written. Volume Number In this field, enter the sequence number assigned to an optical disk volume.
Chapter 9 Optical Disk Volume Maintenance Function Keys This section gives information on the Optical Disk Volume Maintenance window’s function keys. 9-8 F1 List Volumes This option displays the Optical Disk Volume Inquire window. This window shows all of the optical disk volumes that have been defined. F8 Main Menu This option returns you to the main menu.
C H A P T E R 1 0 VISTA Plus Configuration This chapter provides information on the configuration files in VISTA. There are dozens of parameters that are outlined and described in this chapter that allow you to configure VISTA specifically to your environment. These parameters may allow you to work more efficiently with VISTA and also allow your users to have greater control over the reports and VISTA application.
Chapter 10 VISTAINI File The VISTA program is initialized by the VISTAINI.DATA.NETBASE file which contains parameters to enable and disable VISTA features. To modify this file and change parameter values, you can use any text editor. Most of the following parameters can be set to ON or OFF, enabling or disabling the feature. A sample VISTAINI file is shown below, with values and detailed explanations for each parameter.
Configuration $AM-SM-REQ-TO-SAVEWINDOWS This parameter allows only account managers and system managers to save window definitions with a report within VISTA. If it is set to OFF, all users can save window definitions. $ARCHIVE-DEFAULT-CODE This parameter defines the default code to assign to report records when report skeleton records are created. This flag is used by the VISTA archive process to select groups of reports to store on a tape. The default is VI.
Chapter 10 10-4 $DEFAULT-ARCHIVEMONTHS This parameter determines the default number of archive months to be assigned to report records when they are automatically created. $DEFAULT-GENERATIONS This parameter defines the default number of generations to be assigned to new reports when automatically created. Specific reports can have different numbers of generations maintained by modifying their report record in VISTAMNT.
Configuration $DEFAULT-REPORT-SORT This parameter defines how reports will be sorted prior to displaying the report screen. Many options are available, but only one can be enabled. The default sort option when VISTA is shipped is “By create date in descending order.” The other available options are listed below: Sort Option Description REPORT-ASC This option sorts by report name in ascending order. REPORT-DESC This option sorts by report name in descending order.
Chapter 10 $ENABLE-EUROPEAN-DATE If this parameter is set to ON, the date will be displayed in European format (DDMMYY). $ENABLE-SAFE-READS This parameter disables arrow keys within windows. Arrow keys occasionally corrupt data being entered, and their use may hang the terminal. By disabling the arrow keys, you increase the integrity of entered data. If OFF, terminal arrow keys can be used to place the cursor on the character to be changed, rather than re-entering all characters within the field.
Configuration $LOG-READ This parameter controls writing history records to the HISTORY dataset in the VISTA database. The information written defines who opened a report for reading, the date and time the transaction was written, and the name of the folder where the report was located. History information can be used to generate reports of who read certain reports and the number of times a report has been read. $MAX-HOLD-RECORDS This parameter controls the size of the hold buffer file.
Chapter 10 10-8 $PURGE-SPOOL-FILES This parameter controls deleting spool files associated with a $STDLIST report when that report is deleted with VISTA. When it is set to ON and a user deletes a $STDLIST report in VISTA, a spool file delete command will be issued to remove the $STDLIST report from the spooler subsystem. $SEARCH-MULTIPLEINPUTS This parameter defines the character that used to search for multiple strings. The default is an ampersand (&).
Configuration VISTACFG File When VISTA displays a report, it searches for the VISTACFG.DATA.NETBASE file in your current logon group. This file contains user configuration values for displaying and printing reports locally. A standard version of this file is VISTACFG.DATA.NETBASE. To set default configuration values for a specific user, copy VISTACFG.DATA.NETBASE into the user’s logon group and edit it to reflect the user’s preferences.
Chapter 10 Adjusting the Screen Size VISTA has been developed to display 24 lines of text on a screen, including two lines for function key labels. On non-VGA PCs, which run through a terminal emulator such as Reflection, only 23 lines of text can be displayed without losing the bottom row of user labels. To fix this problem, you can set the $Screenlines configuration record in the VISTACFG.PUB.NETBASE file to a value of 21, which allows two additional lines for function keys.
A P P E N D I X A Index A F Age Folder Maintenance .................................. 4-15 Archive Rules Window Fields.......................................................... 9-5 Using archive rules with VISTACLN ......... 4-9 Files VISTA Plus Server configuration ..............2-19 Folder Maintenance Building a folder .......................................4-13 Cleaning a folder.........................................4-9 Date ..........................................................
Appendix A H HP 3000 Environment File ............................. 8-3 I Index Definition Window Fields ....................................................... 5-12 Function keys ........................................... 5-12 Index, creating automatically.................... 5-14 Re-indexing reports .................................. 5-13 L Link Reports to User Window Function keys ........................................... 5-18 List Reports....................................................
Index Re-indexing.............................................. 5-13 Security ............................................... 5-8, 7-5 Routing List Maintenance Window Fields........................................................ 6-11 S Screen Size Adjusting................................................ 10-10 Security Bypassing MPE security ........................... 7-22 Changing VISTA database passwords....... 7-21 Folder......................................................... 7-2 Page ...............
Appendix A e-mail setup.............................................. 2-21 Enabling................................................... 2-10 Indexing existing folders .......................... 2-12 Indexing folders ....................................... 2-11 Installing and configuring .......................... 2-2 Server programs for Windows clients ....... 2-14 Starting the server .................................... 2-13 VISTA Security..............................................
