Test the Basic FOCUS System

In this section:

This step under TSO tests the basic system installed in Unload the FOCUS Distribution Tape.


Top of page

x
Logon to a TSO Region

You can use any TSO ID from which the installed FOCUS libraries can be accessed. Any logon procedure will do.


Top of page

x
Allocate Space for a Test FOCUS Database
ALLOC DA(CAR.FOCUS) SP(5,5) TRACKS LRECL(4096) BLKSIZE(4096) RECFM(F) NEW

This database will be allocated as ddname CAR and loaded with data in the next step. You can use it for any additional tests and experiments with FOCUS after the completion of Execute the FOCUS Test Procedure CARTEST.


Top of page

x
Execute the TSOALLOC CLIST

This TSO CLIST allocates the FOCUS libraries and invokes FOCUS using the CALL command. The CLIST is member TSOALLOC of FOCCTL.DATA, as allocated in Allocate Disk Space for FOCUS Libraries. You will be prompted for the fully qualified data set names of FOCLIB.LOAD, ERRORS.DATA, MASTER.DATA, FOCEXEC.DATA, and of the test FOCUS database allocated in Allocate Space for a Test FOCUS Database. After this step, you get the FOCUS release banner, indicating that you are in FOCUS, and the FOCUS (command) prompt (>>) indicating that FOCUS is ready to receive a command.


Top of page

x
Execute the FOCUS Test Procedure CARTEST

After receiving the command prompt from FOCUS, issue the following command and press Enter:

>>EX CARTEST

The CARTEST procedure, a member of FOCEXEC.DATA, will load data into the CAR database, as defined by member CCARS of MASTER.DATA, and test the major areas of FOCUS. The FOCEXEC and MASTER PDSs must be allocated for this procedure to work. Messages are displayed as each test completes and the end of all tests is signaled by the message:

AT END OF TEST MAJOR AREAS OK

This completes the installation of the basic FOCUS system. You can return to the TSO command level by issuing the FOCUS command FIN at the FOCUS prompt after you receive the above message.

If you receive any error messages during the test step, call your local Information Builders representative or the Information Builders Customer Support Department in New York at 1-800-736-6130.

The most common error causes are failed allocations for ddnames CAR, CCARS, MASTER, FOCEXEC, HOLD, HOLDMAST, FOCSTACK, or FOCSML, all of which are allocated by TSO ALLOCATE commands issued by the TSOALLOC CLIST.



Example: Sample JCL for Executing CARTEST as a Batch Job
//CARTEST  EXEC PGM=FOCUS,REGION=2048K
//STEPLIB      DD  DSN=prefix.FOCLIB.LOAD,DISP=SHR
//MASTER       DD  DSN=prefix.MASTER.DATA,DISP=SHR
//FOCEXEC      DD  DSN=prefix.FOCEXEC.DATA,DISP=SHR
//ERRORS       DD  DSN=prefix.ERRORS.DATA,DISP=SHR
//CCARS        DD  DSN=prefix.MASTER.DATA(CCARS),DISP=SHR
//CAR          DD  DSN=prefix.CAR.FOCUS,DISP=SHR
//SYSPRINT     DD  SYSOUT=*
//OFFLINE      DD  SYSOUT=*
//SYSIN   DD  *
 EX CARTEST
 FIN
/*

where:

prefix

Is the high-level qualifier for your FOCUS production data sets.

If you omit FIN as the last command to be executed, FOCUS will run properly but will terminate with condition code 8.


Top of page

x
Online Release Information

Release statistics, installation and operation changes, program temporary fix (PTF) information, and release notes are available online. To view the online release information, issue the following command from the FOCUS prompt:

EX READMEF

This FOCEXEC allows you to choose to view several types of release information (for example, PTFs, installation information, new features). The ERRORS and MASTER PDSs must be allocated in order to run READMEF.


Information Builders