z/VSE JCL example 1: Non-VSAM-managed sequential files

Figure 1 shows simplified z/VSE® JCL for searching a non-VSAM-managed sequential file. This example is supplied with SuperC in the Librarian member ASMFVSS1.Z.

Before running this example, edit the lines highlighted by numbers (such as  1 ) as described in the instructions following the example listing.
Figure 1. Sample z/VSE JCL for searching a non-VSAM-managed sequential file
// JOB ASMFVSS1
// LIBDEF *,SEARCH=(PRD2.PROD)
// OPTION NODUMP
/*
/* Define file to be searched
/*
// DLBL search_file_name,'search_file_ID',0,SD                    ┐
// EXTENT extent_information                                      ├─  1 
// ASSGN assign_logical_unit_information                          ┘
/*
/* Note: The listing file is output to SYSLST.
/*       (If the WIDE process option is used, SYSLST must be
/*       assigned to a printer capable of handling lines of
/*       at least 202 characters.)
/*
/* Run the search with these options…
/*
// EXEC ASMFSUPC,PARM='SRCHCMP process_options'                       2 
*
*  …and these process statements
*
NEWDD search_file_name,attributes                                     3 
SRCHFOR 'search_string'                                               4 other_process_statements                                              5 
⋮
/*
/&
 1 
Replace search_file_name with your choice of DLBL name for the file to be searched; also insert this DLBL name in the NEWDD process statement (see  3 ). Replace search_file_ID with the name of the file to be searched. Insert appropriate extent information and assign logical unit information.
 2 
Replace process_options with any process options you want to use to customize how SuperC performs the search or formats the listing.

For a description of each process option, see Process options.

For example:
PARM='SRCHCMP DPCBCMT COBOL'
instructs SuperC to perform a search:
  • Ignoring COBOL comment lines. (Process option DPCBCMT ignores lines with an * in column 7.)
  • Ignoring columns 1 to 6. (Process option COBOL ignores columns 1 to 6 which are assumed to be sequence numbers.)

SuperC outputs the listing file to SYSLST. For a selection of sample listing files, see Understanding the listings.

 3 
NEWDD is a process statement that allows you to:
  • Use your own choice of DLBL name for the file to be searched. If you do not specify a NEWDD process statement, you must use the DLBL name NEWDD.
  • Specify file attributes for the file to be searched. If you do not specify a NEWDD process statement with file attributes, SuperC assumes that the (non-VSAM) file to be searched contains fixed-length unblocked records with a record size and block size of 80.

For more information about the NEWDD process statement, see DD-VSE DLBL/TLBL definitions.

 4 
Replace search_string with a string that you want to search for. For information about specifying search strings, see Search strings in the input file.
 5 
Insert any other process statements (one per line) that you want to use.
For example, the following process statement:
DPLINE 'ignore this line'
instructs SuperC to exclude from the search any lines containing the specified string (ignore this line).

For more information about process statements, see Process statements.