ASG (Allen Systems Group, Inc) - SmartTest R5.0

Batch Program Testing

Developer Initial Setup Document

4/17/2023 Page 1 of 32 10:18 PM

The objective of this document is to assist team members with getting setup to test Batch programs using ASG (Allen Systems Group, Inc) -SmartTest R5.0. The process of testingbatch program using SmartTest is comprised of the following three main steps.

1.0 Compile your program using the Via soft compile/analyze job function.2.0 Execute Batch program using SmartTest tool3.0 Utilization of basic SmartTest commands

1.0 Compile your program using the Via soft compile/analyze job function

On the ISPF Primary Option Menu type “=N.T.C” Depress <ENTER> Key

4/17/2023 Page 2 of 32 10:18 PM

Enter all pertinent information. Depress <ENTER> Key

Note: Since this same panel is used for both batch and online programs include both batch and online load library names.

4/17/2023 Page 3 of 32 10:18 PM

If you choose “Y” on the previous screen for DB2 SQL Program you will encounter this screen. If you chose “N” on the previous screen you will NOT encounter this screen.

The screen requires you to enter the plan name (if program accesses DB2 tables). Enter DB2 plan name in the Member Name field and verify correct DB2 Bind Library name. Depress <ENTER> key. Note: The plan name can be obtained by scanning your environment bind control PDS (i.e. APPL.DEV4.BINDCNTL).

4/17/2023 Page 4 of 32 10:18 PM

It is important for you to use the Via soft compile/analyze job function when you compile. This will facilitate the appropriate update to the AKR file.

Enter “SV” on the command line to choose the Via soft compile/analyze job function. Verify that job card information is correct and Depress <ENTER> key.

4/17/2023 Page 5 of 32 10:18 PM

Include and/or verify correct AKR data set name (i.e. APPL.DEV4.AKR, APPL.IMPL.AKR, etc) Note: The AKR data set is where the version of your source will reside that enables you to see your lines of code during the SmartTest session.

After you have completed or inserted the AKR dataset name depress <ENTER> Key

4/17/2023 Page 6 of 32 10:18 PM

Depress <ENTER> Key

You have now completed the 1st step of compiling your program using the Via soft compile/analyze job function.

4/17/2023 Page 7 of 32 10:18 PM

You should now proceed to the active queue to verify the successful completion of the compilation of your program. On the command line type “=P.S.DA” depress <ENTER> Key.

4/17/2023 Page 8 of 32 10:18 PM

2.0 Execute Batch program using SmartTest toolAfter verification of a successful compilation of your Batch program it is now time to access the SmartTest tool to begin testing.

On the ISPF Primary Option Menu type “=P.SMRT” Depress <ENTER> Key

4/17/2023 Page 9 of 32 10:18 PM

Depress <ENTER> Key

4/17/2023 Page 10 of 32 10:18 PM

Type “ENV” on command line and depress <ENTER> Key

4/17/2023 Page 11 of 32 10:18 PM

Type in all of the Application Load Library names referenced at the bottom of this screen. Type “L” on the command line and depress <ENTER> key

4/17/2023 Page 12 of 32 10:18 PM

Enter the libraries referenced above. Note: Make sure you include the quotation characters at the beginning and end of the library names. Upon completion depress <PF3> Key.

4/17/2023 Page 13 of 32 10:18 PM

Choose option “P” to include target proclibs

4/17/2023 Page 14 of 32 10:18 PM

Enter the target procedure libraries. Note: Make sure you include the quotation characters at the beginning and end of he library names. Upon completion depress <PF3> Key.

4/17/2023 Page 15 of 32 10:18 PM

Choose option ‘9’ (MVS Batch) and depress the <ENTER> Key

4/17/2023 Page 16 of 32 10:18 PM

Choose option “E” (Edit execution JCL) if you are interested in changing the execution JCL and depress the <ENTER> Key

4/17/2023 Page 17 of 32 10:18 PM

Choose option ‘S’ (Submit execution JCL) and depress the <ENTER> Key to submit the JCL

4/17/2023 Page 18 of 32 10:18 PM

You must wait until you get the message “WAITING FOR CONNECTION BY ASG-SMARTTEST” before connecting SmartTest to your submitted job. Depress <ENTER> Key

4/17/2023 Page 19 of 32 10:18 PM

Choose option ‘C’ (Connect to submitted job) and depress the <ENTER> Key to prepare to engage SmartTest with your execution JCL

4/17/2023 Page 20 of 32 10:18 PM

You must WAIT until you see the message “WAITING FOR CONNECTION” next to your job. If you don't get this message you cannot connect to SmartTest!

After the message appears that states “WAITING FOR CONNECTION” and type “S” in the Select field.

4/17/2023 Page 21 of 32 10:18 PM

If your program abnormally terminates with an earlier execution of a job you are testing in SmarTest you will need to choose option “P” to purge the old job before continuing with testing with any newer version on the Job. If you do NOT have a earlier version of your job ignore the “P” option and continue.

4/17/2023 Page 22 of 32 10:18 PM

You are now ready to begin testing your program with the ASG SmartTest R5.0.

4/17/2023 Page 23 of 32 10:18 PM

SmartTest line commands can be utilized at this point. Type “BR” (Break Point) on a line with a COBOL action verb. See “BR” in 1st and 2nd position of line 001499.

4/17/2023 Page 24 of 32 10:18 PM

Observe break point insertion on line 001499. List of basic commands will be covered in section 3.0 Utilization of Basic SmartTest commands.

4/17/2023 Page 25 of 32 10:18 PM

Type “CAN” on the command line and depress the <ENTER> Key.

4/17/2023 Page 26 of 32 10:18 PM

A message will appear acknowledging the “TEST SESSION CANCELLED”

Depress <PF3> Key

4/17/2023 Page 27 of 32 10:18 PM

Depress <PF3> to exit from SmartTest.

4/17/2023 Page 28 of 32 10:18 PM

If you encounter this screen during your 1st attempt to exit SmartTest change the process option to the following:

OLD

Log List Punch----- ---- -------

Process Option PD PD D

NEW

Log List Punch----- ---- -------

Process Option D D D

Upon completion of changes depress <PF3> Key

4/17/2023 Page 29 of 32 10:18 PM

Depress <ENTER> Key to exit SmartTest tool

3.0 Utilization of basic SmartTest commandsNow that you are able to compile and execute your program with the SmartTest facility you will need to know some basic commands.

Command Action DescriptionBR Break Point Set break points in source codeD Delete Delete a break pointK Keep Keep displayed field contents on the screenZD Zoom Data Display field content (non-HEX format)ZH Zoom Data Hex Display field content (HEX format)ZO Zoom Off Turn off Zoom Data

You can obtain more information from the drop down menu available during your SmartTest session.

4/17/2023 Page 30 of 32 10:18 PM

Choose the VIEW item from the horizontal menu

4/17/2023 Page 31 of 32 10:18 PM

Get familiar with menu selection items

4/17/2023 Page 32 of 32 10:18 PM