|
|
|
Source: ACS Test Case Library
ACS Testing Output Report File
Function: This facility analyzes the results of the ACS
routine testing process to make sure your ACS
routines are working correctly. Another CA MICS
StorageMate facility, the ACS Test Case Creation
facility, is used to build a library of ACS test
cases from your CA MICS data. That library is read
by the ISMF ACS Test Facility, and each test case
is passed to your production/test ACS Routine(s).
The test results are written by ISMF to a report
output file. This facility read both the test case
library and the testing output file, merges them,
and provides a number of reports useful in
evaluating the operation of the ACS routines.
The exception reports identify conditions that may
indicate an error in the operation of the ACS
routine. Two different exception reports may be
requested. One report lists test cases that
received a non-zero return code from the ACS
routine, while the other report indicates test
cases that received a blank (null) value back from
one or more of the ACS routines.
Further information about the use of the ACS Test
Facility is available in the facility instructions
at the end of this section.
Features: Options allow you to restrict reporting to only
those ACS routines specified. For example, when
executing the ISMF Test Facility you can specify
that all four types of ACS routines be executed
(Storage Class, Management Class, Data Class,
Storage Group), but when running reports you can
only be interested in results of the Data Class
routine.
Up to eight different reports can be generated by
this facility, each showing a different view of the
test results, or showing a different summarization.
The reports can be selected in any combination.
SMS
Issues: An important phase of any SMS conversion project is
making sure your ACS routines are operating
correctly and achieving their desired results.
This problem is no less critical after SMS
conversion, as regular maintenance to the ACS
routines will still be necessary. Because of their
critical nature, accuracy of ACS routines is just
as important as the accuracy of any system exit.
Using this facility to carefully analyze your test
results will help ensure your success in this
critical task.
COLUMN DESCRIPTIONS
TITLE 4
The fourth title line of the report indicates which
exception report is being produced. This title
will be either 'TEST CASES WITH NON-ZERO RETURN
CODES' or 'TEST CASES WITH NULL VALUES ASSIGNED'.
Test cases will appear on these reports if ANY of
the ACS routines called for a test case returns a
non-zero value or a null assignment.
SYSID
This value appears at the top of each page and
identifies the system to which this data applies.
The System Identifier (SYSID) is copied from the
CA MICS data used in creating the test cases.
Maximum Return Code
A numeric value indicating the maximum return code
received from any of the ACS routines called on
behalf of this test case. This column will be
blank if the return code was zero. Examination of
the next four columns (class and group names)
should reveal the error codes presented by
individual routines.
Storage Class Name
The name of the storage class assigned to this data
set by the storage class ACS routine. A BLANK
value indicates that the ACS routine was not
invoked for this data set. A value of '(NONE)'
indicates that the ACS routine was called, but no
value was assigned. A value of '*RC=nnnn'
indicates a nonzero return code from the routine,
where 'nnnn' is the numeric representation of the
return code.
Manage. Class Name
The name of the management class assigned to this
data set by the management class ACS routine. A
BLANK value indicate that the ACS routine was not
invoked for this data set. A value of '(NONE)'
indicates that the ACS routine was called, but no
value was assigned. A value of '*RC=nnnn'
indicates a nonzero return code from the routine,
where 'nnnn' is the numeric representation of the
return code.
Storage Group Name
The name of the storage group assigned to this data
set by the storage group ACS routine. A BLANK
value indicates that the ACS routine was not
invoked for this data set. A value of '(NONE)'
indicates that the ACS routine was called, but no
value was assigned. A value of '*RC=nnnn'
indicates a nonzero return code from the routine,
where 'nnnn' is the numeric representation of the
return code.
Data Class Name
The name of the data class assigned to this data
set by the data class ACS routine. A BLANK value
indicates that the ACS routine was not invoked for
this data set. A value of '(NONE)' indicates that
the ACS routine was called, but no value was
assigned. A value of '*RC=nnnn' indicates a
nonzero return code from the routine, where 'nnnn'
is the numeric representation of the return code.
Data Set Name
The name of the data set passed to the testing
routine for this test case.
Test Case Member
Identifies the test case library member (PDS
member) that was passed to the ACS test routine.
You may want to browse this member in the test case
library to identify the actual values passed to the
ACS routine. This is especially valuable when
investigating errors or improper results in the ACS
routines.
Size (KB)
The calculated size of the identified data set as
passed to the ACS routine. The value is
represented in kilobytes (thousands of bytes).
This value is important as the ACS routine often
makes decisions based on it.
Input Type
The location of the original data set upon which
this test case was based. This value is supplied
by the ACS Test Case Creation function, based on
the original source of the data. Valid values are
DASD (VCADAA file), VSAM (VCA_VS file), TAPE
(External), MIGRATE (HSMMIG file), or BACKUP
(HSBBAC file).
ACS TESTING RESULTS (STGELG) CA MICS StorageMate - EXCEPTIONS ABC CORPORATION TEST CASES WITH NULL VALUES ASSIGNED ------------------------------------------------------------ SYSID=SYSA ------------------------------------------------------------ Maximum Storage Manage. Storage Data | Data Set Name Test Size Input Return Class Class Group Class | Case (KB) Type Code Name Name Name Name | Member STANDARD STANDARD TSOWRK (NONE) | ATA.TEST2.LOAD @ATAA002 364.5 MIGRATE STANDARD STANDARD TSOWRK (NONE) | BACKIT.DATASETS.SETS5.LIST @BACA002 18.4 MIGRATE STANDARD STANDARD TSOWRK (NONE) | BSS.V22.P1.SOURCE @BSSA002 510.0 MIGRATE STANDARD STANDARD TSOWRK (NONE) | BTEST.PROD.AAAFMCF @BTEA002 739.3 MIGRATE STANDARD STANDARD TSOWRK (NONE) | CAPPLN.C.PXX.PROCLIB @CAPA001 65.5 MIGRATE STANDARD STANDARD TSOWRK (NONE) | CAPPLN.DEVT1111.ISPTLIB @CAPA004 2.0 MIGRATE (NONE) DCPS | CST.RCP.COMPLOAD.PREPROC @CSTA001 94.9 DASD STANDARD STANDARD TSOWRK (NONE) | CSTPLN.ACTIVET.PST.DOC.TEXT @CSTA002 149.5 MIGRATE (NONE) DCPS | CSUT.BXXXR250.XXX.CLOSED.ADJUST.CNTL @CSUA001 712.1 DASD STANDARD (NONE) TSOWRK (NONE) | CSUT.BXXXR302.DOCFIX @CSUA002 10.2 MIGRATE STANDARD (NONE) TSOWRK DCPO | CSUT.PXXXX04U.CNTL @CSUA003 793.3 DASD (NONE) DCPO | CSUT.PXXXX10C.INCLLIB @CSUA004 1139.4 DASD STANDARD STANDARD TSOWRK (NONE) | CSUT.PXXXX10C.PSTTEST.CNTL @CSUA005 73.7 MIGRATE (NONE) DCPS | WDDA.PROD.TCORP.XXXBEXT.BKUP @WDDA004 9113.3 TAPE (NONE) DCPS | WDDA.WDDADBTC.STEP87.PRCOPY @WDDA005 32.8 TAPE ----- ------------ SYSID 13818.9 ============ N= 15
Figure 4-8. ACS Testing Results / Exceptions
| Copyright © 2012 CA. All rights reserved. | Tell Technical Publications how we can improve this information |