ACS/QA ISPF interface - syncsort_allocation_control_center

ACS/QA test cases can be created, updated, and executed from an ISPF interface. The ISPF interface allows the user to define new test cases in a testcase library, select desired test cases to view or alter, or interactively execute one or more test cases.

The ACS/QA ISPF interface is entered by selecting option 7, 'ACSQA' from the DTS Software Primary Options Menu:

--------------- DTS Software ISPF Interface -------------------------------
Option ===>
1 DIF - DIF ISPF Interface
2 MON - Monitor ISPF Interface
3 DSL - DLIMIT ISPF Interface
4 DSR - Data Set Review ISPF Interface
5 ABC - ABC ISPF Interface
6 MONHSM - Monitor for HSM
7 ACSQA - ACS Routine Testing and Debugging
Enter END command to return to previous application

Figure 4-1. ACS/QA ISPF interface

0	OPTIONS	Set Up or Change ACS Testing Options
1	DEFINE	Define an ACS Test Case
2	LIST/ALTER	Display or Alter ACS Test Case(s)
3	EXECUTE	Execute ACS Test Case(s)

SMSDEBUG Primary Options Menu

The SMSDEBUG Primary Options Menu is then displayed. The PDS or PDSE containing the test cases must be specified as indicated in ACS TEST LIBRARY. This library must exist prior to using the ACS/QA ISPF interface. The member name, which may be a mem- ber name mask, must also be specified.

--------- DTS Software - SMSDebug ACS Routine Testing Primary Options --------
Command ===>
Select one of the following options:
0 OPTIONS Set Up or Change ACS Testing Options
1 DEFINE Define an ACS Test Case
2 LIST/ALTER Display or Alter ACS Test Case(s)
3 EXECUTE Execute ACS Test Case(s)
ACS Test Library ==> 'STEVE.TESTCASE.PDS'
ACS Test Member ==> TESTAC3 (Use '*' or '%' for member list)
(C) Copyright 2007, DTS Software, Inc., All rights reserved

Figure 4-2. SMSDEBUG Primary Options Menu

Selecting Option 0 displays the Default Options dialog. These panels allow you to select options for ACS/QA execution, such as PRINTRO, TRACE, and EXITSs. Default values for CDS1 and CDS2 may also be set in this dialog. Values set by option 0 are retained and used as defaults the next time the ACS/QA ISPF interface is started, or when option 3, EXECUTE is chosen.

Selecting Option 1, DEFINE, displays the Test Case Definition dialog. These panels allow you to define a new testcase member in the testcase PDS. The specified member must not already exist in the testcase PDS for Option 1. To change an existing member, use Option 2, LIST/ALTER.

Selecting Option 2, LIST/ALTER, allows you to display a list of testcase members and their descriptions (if a mask is specified for the member name) or a testcase member to be altered. If a member name mask is used to display a list of members, individual members may be selected to be altered or executed by placing an 'S' (Select) or 'X' (Execute) next to the displayed member. If a member name is specified instead of a member list, the Test Case Alter dialog is entered, and panels are displayed which allow you to alter an existing testcase.

Selecting Option 3, EXECUTE, displays the Test Case Execution dialog, which allows you to execute ACS/QA using one or more members of the testcase library.

Test Case Default Options Panels

Selecting Option 0, OPTIONS, from the ACS/QA Primary Options menu displays the Test Case Default Options panels. There are two of these panels, which may be displayed by entering the 'UP' or 'DOWN' commands. The first panel is shown below and allows you to set defaults for the CDS names, exit library, and some of the ACS/QA options.

-------------- SMSDebug ACS Routine Testing - Set Default Options -------------
Page 1 of 2
Command===>
ACS Testcase ==> STEVE.TESTCASE.PDS(TESTAC3)
CDS1 Name: 'SYS1.SCDS'____________________________________
CDS2 Name: 'ACTIVE'_______________________________________
ACS Routines to Execute (Y,N): Y DC Y SC Y MC Y SG
Options: N TRACE (Y,N) Trace ACS output?
N SETDCVARS (Y,N) Set ACS variables from data class?
Y PRINTRO (Y,N) Display all ACS variables for each test?
_ EXITS1 (Y,N) Call ACS exits for CDS1?
_ EXITS2 (Y,N) Call ACS exits for CDS2?
EXITLIB DSName: 'MY.EXIT.LOAD.LIB'
Use ENTER to Verify; DOWN for next Panel;Use END to Save and Exit.

Figure 4-3. Test Case Default Options Panel 1

The ACS TESTCASE field shows the testcase library name and member name most recently entered on the ACS/QA Primary options menu. This is a read-only field for this panel.

The CDS1 NAME and CDS2 NAME fields indicate the SMS SCDS to use when running test cases. The dataset name of the control dataset may be specified, or the word 'ACTIVE' may be specified to indicate the active ACDS is to be used. Defaults set on this panel may be overridden in the Test Case Execution panel.

The ACS ROUTINES TO EXECUTE field indicates which ACS routines should be called when a testcase is executed. By default, all four ACS routines are executed. Defaults set on this panel may be overridden in the Test Case Execution panel.

The TRACE option indicates whether ACS routine tracing should be performed when the ACS routines are executed for a testcase. The default is not to perform tracing.

The SETDCVARS option indicates whether the ACS read-only variables should be updated after the data class routine has executed, using values obtained from the assigned data class. The default is not to update the read-only variables.

The PRINTRO option indicates whether the ACS read-only variables should be displayed on SYSPRINT prior to running the ACS routines for a testcase. The default is not to print the read-only variables.

The EXITS1 and EXITS2 variables indicate whether the ACS routine exits, if any, should be executed after the ACS routines have run for a testcase. The default is not to call the ACS routine exits.

The EXITLIB field indicates the name of the load library containing the ACS exit routines (IGDACSDC, IGDACSSC, and IGDACSMC) to be called when a testcase is run, if the value of EXITS1 or EXITS2 is set to YES.

-------------- SMSDebug ACS Routine Testing - Set Default Options -------------
Page 2 of 2
Command ===>
ACS Testcase: STEVE.TESTCASE.PDS(TESTAC3)
Filters: JOBNAME Mask: ________
DSN Mask: ___________________________________________________
Overrides: Data Class: ________
Stor Class: ________
Mgmt Class: ________
Userid : ________
Group : ________
Use ENTER to Verify; UP for previous Panel;Use END to Save and Exit.

Figure 4-4. Test Case Default Options Panel 2

The ACS TESTCASE field shows the testcase library name and member name most recently entered on the ACS/QA Primary options menu. This is a read-only field for this panel.

The JOBNAME MASK field indicates a jobname filter which is to be applied to deter- mine which test cases should be run. Only test cases which have a jobname defined in the testcase that matches this filter will be executed. The default is to execute all test cases.

The DSN MASK field indicates a jobname filter which is to be applied to determine which test cases should be run. Only test cases which have a dataset name defined in the testcase which matches this filter will be executed. The default is to execute all test cases.

The DATA CLASS override variable indicates a data class name which is to be used instead of the data class name defined in the selected testcase(s). The default is to use the data class name defined in the testcase, if any.

The STOR CLASS override variable indicates a storage class name which is to be used instead of the storage class name defined in the selected testcase(s). The default is to use the storage class name defined in the testcase, if any.

The MGMT CLASS override variable indicates a management class name which is to be used instead of the management class name defined in the selected testcase(s). The default is to use the management class name defined in the testcase, if any.

The USERID override variable indicates a RACF userid which is to be used instead of the USER field defined in the selected testcase(s). The default is to use the name defined in the testcase, if any.

The GROUP override variable indicates a RACF group id which is to be used instead of the GROUP field defined in the selected testcase(s). The default is to use the group defined in the testcase, if any.

ACS Test Case DEFINE and ALTER Panels

There are four panels which may be used to DEFINE a new testcase or ALTER an existing one. Most of the fields on these panels are self-explanatory. The values specified on these panels will be saved in the testcase member. These four panels are shown below.

------------------------ SMSDebug ACS Test Case DEFINE -----------------------
COMMAND ===> _____________________________________________________ Page 1 of 4
ACS Testcase => STEVE.TESTCASE.PDS(MYTEST3)
Description => ____________________________________________________________
Expected Result=> ____________________________________________________________
DSN (or OAM Collection)==> ____________________________________________
JOB => ________ DD ==> ________ PGM ===> _______ SIZE ==> __________
UNIT=> ________ USER=> ________ SYSNAME=> _______ MAXSIZE=> __________
VOL => ______ GROUP=> ________ SYSPLEX=> _______ BLKSIZE=> __________
NVOL=> ____ SPACETYPE=> ________ SECQTY==> _______
ACSENVIR XMODE DSNTYPE DSORG DSTYPE RECORG LABEL
_ ALLOC _ BATCH _ BASIC _ PS _ PERM _ KS _ SL
_ ALLOCTST _ TSO _ PDS _ PO _ TEMP _ ES _ NL
_ RENAME _ TASK(STC) _ LIBRARY _ VS _ GDS _ RR _ AL
_ RECALL _ EXC _ DA _ LS _ NSL
_ RECOVER _ EXR _ SUL
_ CONVERT _ LARGE _ AUL
_ CHANGE (OAM) _ HFS _ BLP
_ CTRANS (OAM) _ LTM
_ STORE (OAM)
_ RMMPOOL Use '/' to select option, or leave blank.
_ RMMVRS Use ENTER to Verify; DOWN for next Panel;
________ (Other) Use END to Save and Exit.

Figure 4-5. Test Case DEFINE/ALTER Panel 1

------------------------ SMSDebug ACS Test Case DEFINE -----------------------
COMMAND ===> _____________________________________________________ Page 2 of 4
ACS Testcase ===> STEVE.TESTCASE.PDS(NEWMEMBR)
DATACLAS=> ________ DEF_DATACLAS=> ________
STORCLAS=> ________ DEF_STORCLAS=> ________
MGMTCLAS=> ________ DEF_MGMTCLAS=> ________
STORGRP => ________
(VOL=REF/UNIT=AFF)
EXPDT=> _______ APPLIC => ________ SECLABL=> ________
RETPD=> ____ DSOWNER => ________
ACCT_JOB => __________________________________________________
=> __________________________________________________
=> __________________________________________
ACCT_STEP=> __________________________________________________
=> __________________________________________________
=> __________________________________________
Use ENTER to Verify; DOWN for next Panel;
UP for previous Panel; END to Save and Exit.

Figure 4-6. Test Case DEFINE/ALTER Panel 2

------------------------ SMSDebug ACS Test Case DEFINE -----------------------
COMMAND ===> _____________________________________________________ Page 3 of 4
ACS Testcase ===> STEVE.TESTCASE.PDS(NEWMEMBR)
MEMN (OAM Object Name)=> ____________________________________________
FILENUM => ____
Tape Management Variables
LIBNAME => ________
MSPOOL => ________
MSPOLICY=> ________
MSPDEST => ____________________________________________
MSPARM => __________________________________________________
=> __________________________________________________
=> __________________________________________
MSVGP => ________
Use ENTER to Verify; DOWN for next Panel;
UP for previous Panel; END to Save and Exit.

Figure 4-7. Test Case DEFINE/ALTER Panel 3

------------------------ SMSDebug ACS Test Case DEFINE -----------------------
COMMAND ===> _____________________________________________________ Page 4 of 4
ACS Testcase ===> STEVE.TESTCASE.PDS(NEWMEMBR)
Volume Serial Nos. for volumes 2 - 59
VOLSER==> ______ ==> ______ ==> ______ ==> ______ ==> ______
VOLSER==> ______ ==> ______ ==> ______ ==> ______ ==> ______
VOLSER==> ______ ==> ______ ==> ______ ==> ______ ==> ______
VOLSER==> ______ ==> ______ ==> ______ ==> ______ ==> ______
VOLSER==> ______ ==> ______ ==> ______ ==> ______ ==> ______
VOLSER==> ______ ==> ______ ==> ______ ==> ______ ==> ______
VOLSER==> ______ ==> ______ ==> ______ ==> ______ ==> ______
VOLSER==> ______ ==> ______ ==> ______ ==> ______ ==> ______
VOLSER==> ______ ==> ______ ==> ______ ==> ______ ==> ______
VOLSER==> ______ ==> ______ ==> ______ ==> ______ ==> ______
VOLSER==> ______ ==> ______ ==> ______ ==> ______ ==> ______
VOLSER==> ______ ==> ______ ==> ______

Figure 4-8. Test Case DEFINE/ALTER Panel 4

ACS Test Case Selection List Panel

This panel is displayed if Option 2 (LIST/ALTER) is chosen from the SMSDEBUG Pri- mary Options Menu and a member name filter containing a percent sign (%) or asterisk(*) is specified in the ACS TEST MEMBER field. This panel shows a list of all the selected members and the DESCRIPTION line, if any, defined in the testcase. The standard ISPF commands for 'UP', 'DOWN', 'TOP', 'BOTTOM', and 'LOCATE' may be used to position the member list. Specifying 'S' (for Select) or 'X' (for Execute) n the OPT field selects a member for alteration or execution. If more than one member is specified, the specified action will be performed only for the first member.

---------------------- SMSDebug Testcase ALTER Selection --------- Row 1 of 46
Command ===> Scroll ===> CSR
Enter "S" to select a testcase to Alter, "X" to execute
Opt Member Description
ALLVARS1 A TESTCASE WITH MANY VARIABLES SPECIFIED____________________
ALLVARS2 ALTERNATE TESTCASE WITH LOTS OF VARIABLES___________________
DATAINV THIS IS THE DATAINV DESCRIPTION_____________________________
FAILD2 THIS MEMBER TESTS FOR ACS FAILURE___________________________
FAILIT THIS IS MEMBER FAILIT_______________________________________
GDSTEST THIS IS A TEST FOR A GENERATION DATASET_____________________
GSPACE GUARANTEED SPACE TEST_______________________________________
MEM1 ____________________________________________________________
MSGS ISSUE LOTS OF MSGS__________________________________________
MTEST THIS IS THE DESCRIPTION LINE________________________________
NEWMEMBR ____________________________________________________________
NEWTEST THIS IS A TESTCASE FOR TEST SYSTEM FILES____________________
NEWTEST1 THIS IS A NEW TEST FOR PRODUCTION FILES_____________________
NULLMEM1 THIS IS NULLMEM1____________________________________________
NULLMEM2 ____________________________________________________________
NULLMEM3 THIS IS NULLMEM3____________________________________________

Figure 4-9. ACS Test Case Selection List Panel

ACS Test Case EXECUTE Panel

Selecting Option 3, EXECUTE, from the SMSDEBUG Primary Options Menu, or speci- fying 'X' for a member in a selection list displays the ACS Test Case Execute Panel. This panel allows you to enter the CDS1 and CDS2 names, listing dataset, summary dataset, and other fields necessary to run an ACS testcase. Multiple test cases may be executed from this panel if the ACS TEST MEMBER field is specified as a mask. When the ENTER key is pressed, the test cases are executed and the resulting listing and optional summary dataset are displayed.

--------------- SMSDebug ACS Routine Testing - Execute Testcases --------------
Command ===>
ACS Test Library ==> 'STEVE.TESTCASE.PDS'_____________________
ACS Test Member ==> NEWTEST
(Use '*' or '%' for member list)
CDS1 Name: ACTIVE____________________________________________
CDS2 Name: 'STEVE.SCDS' _____________________________________
(or blank)
Listing Data Set: 'MY.LISTING.DATASET'_______________________
(or blank)
Summary Data Set: 'MY.SUMMARY.DATASET'________________________
(or blank)
ACS Routines to Execute (Y,N): Y DC Y SC Y MC Y SG
Use ENTER to Execute; END or CANCEL to exit

Figure 4-10. ACS Test Case EXECUTE Panel

The ACS TEST LIBRARY field shows the testcase library name. The ACS TEST MEM- BER field shows the testcase member name(s). These fields are populated from the prior panels, but may be overridden on this panel. These fields are required.

The CDS1 NAME and CDS2 NAME fields indicate the SMS SCDS(s) to use when run- ning test cases. The dataset name of the control dataset may be specified, or the word 'ACTIVE' may be specified to indicate the active ACDS is to be used. These values are obtained from the Option 0 (DEFAULTS) panel and may be overridden on this panel. If changed on this panel, the changed values will become the new default.

The LISTING DATA SET field indicates the name of the dataset which will contain the SYSPRINT output from the ACS/QA execution. After ACS/QA has executed, the user will be put into TSO BROWSE for this dataset. If this field is left blank the output is sent directly to the TSO user via TPUT.

The SUMMARY DATA SET field indicates the name of the dataset which will contain the SUMMARY output from the ACS/QA execution. After ACS/QA has executed, the user will be put into TSO BROWSE for this dataset. If this field is left blank no summary is produced.

ACS/QA ISPF interface - syncsort_allocation_control_center - Latest

Syncsort™ Storage Management Sms/Debug User Guide

SMSDEBUG Primary Options Menu

Test Case Default Options Panels

ACS Test Case DEFINE and ALTER Panels

ACS Test Case Selection List Panel

ACS Test Case EXECUTE Panel