SCANFOC Running Environments

How to:

SCANFOC can be run interactively using a CLIST or as a batch job.

Procedure: How to Run the FOCUS Scanning Utility Interactively

  1. To run the FOCUS Scanning Utility, type the following command on the command line: 
    EX SCANFOC

    The FOCUS Scanning Utility - Options screen opens, as shown in the following image.



  2. Choose one of the following scanning options:
    • 1 to run CHECK FILE on selected Master Files. This is the default option. To select a different option, type a different choice over the 1 that displays by default.
    • 2 to find a specific value in the selected files.
    • 3 to find a specific value in the selected files and replace that value with another value.
    • 4 to issue a FOCUS command or execute a FOCEXEC.
    • 5 to scan for possible behavioral issues.
    • 6 to exit the scanning utility.
  3. Press Enter.

    The next screen that opens depends on the option you chose in step 2.

    Note: If a screen requires multiple entries, you can press the Tab key to move from one entry field to the next, or Shift+Tab to move back to the previous entry field.

The screen is the normal output. To HOLD FORMAT WP from the online version, you can comment out a line as marked in chkapps.fex.

Procedure: How to Run the FOCUS Scanning Utility in Batch Mode

This process can be submitted in batch, with the use of the SCANFOCP FOCEXEC, which includes the -SET commands for all of the required parameters. The command that executes the FOCEXEC must then include the name of the parameter file as the first parameter, following the FOCEXEC name.

  1. Add the EX SCANFOC SCANFOCP command to the SYSIN DD allocation of your FOCUS JCL, as shown in the following example.
    //SYSIN DD *
EX SCANFOC SCANFOCP 
FIN
  2. Edit the parameter file SCANFOCP to include system specific values for &&PDSN and &&NPDSN, which can be used with Options 2 and 3 to search for and replace strings within a group of files

    For example, for Option 5:

    • &&FTYPE must be set to the type of file being read in batch, FOCEXEC, MASTER, or JCL.

      &&OUTNAME must be set to the full name of the data file to put the HOLD FORMAT WP output in. It is allocated to ddname FX776OUT. This is the normal output for batch.

    • &&OUTTYPE must be set to the HOLD FORMAT type desired—WP, CSV, EXL2K, HTML, PDF, or SCREEN. SCREEN brings the output to the screen and should not be used in batch.
    • &&FDSN must be set to the full name of the PDS to be scanned.
    • &&TSNAME must be set to the name of the FOCEXEC that contains the DEFINEs used to do the search that are -INCLUDED into the process. This is set to INCFX776, which is the only set of tests released so far.

The output will be placed in a HOLD file allocated by the application using the &&OUTNAME specified.

 Information Builders