1. Approved and Issued by: IT Governance
Template Version: 2.4
Template Revised: August 8, 2013
RSSP Franchise Service Plan Automation
Technical Specification
RPR6620F
Ver 1.0
100%
2. RSSP Franchise Service Plan Automation Technical Specification
RPR6620F
Page 2 of 30 Last Update Date:10/23/2015 3:19:00 PM
Last Saved By:Jon
Z:tempw indows20151023151949_0b8dc1375aa4e2650264042fffdbee0d571a716d4dfa9968-fd92-4ec1-85fe-3d7c55250759-
151023152401-lva1-app6891.docx
PREPARED BY APPROVED BY
NAME Jon Fortman
ROLE SME/Developer
3. RSSP Franchise Service Plan Automation Technical Specification
RPR6620F
Page 3 of 30 Last Update Date:10/23/2015 3:19:00 PM
Last Saved By:Jon
Z:tempw indows20151023151949_0b8dc1375aa4e2650264042fffdbee0d571a716d4dfa9968-fd92-4ec1-85fe-3d7c55250759-
151023152401-lva1-app6891.docx
TABLE OF CONTENTS
1. CURRENT ISSUES ....................................................................................................................5
2. CONVENTIONS AND STANDARDS ...........................................................................................5
3. FUNCTIONAL DESCRIPTION ....................................................................................................5
4. ASSUMPTIONS .........................................................................................................................5
5. CONSTRAINTS..........................................................................................................................5
6. INTERFACE ARCHITECTURE ...................................................................................................5
INTERFACE DIAGRAM.....................................................................................................................5
7. BATCH/SCHEDULE INFORMATION ..........................................................................................5
JOB DEPENDENCIES ......................................................................................................................5
FREQUENCY ................................................................................................................................5
PERFORMANCE/VOLUME CONSIDERATIONS.......................................................................................5
8. PROGRAM I/O...........................................................................................................................6
9. FINAL PHYSICAL DATA MODEL DESIGN .................................................................................6
DATABASE/FILE SYSTEM ORGANIZATION ..........................................................................................7
Physical Data Model: .......................................................................................................................................................7
Record Layouts:................................................................................................................................................................7
DATABASE/FILE SYSTEM INTERFACE DETAILS ...................................................................................7
File Name: (Repeat as needed).......................................................................................................................................7
File Name: (Repeat as needed).....................................................................................................................................10
DATABASE/FILE SYSTEM SPACE REQUIREMENTS .............................................................................13
Minimal. Franchise collectively sells ~100 service plans per day..........................................13
DATABASE/FILE SYSTEM DECOMMISSIONING ACTIVITIES ...................................................................14
None known. ....................................................................................................................14
DATABASE TABLE/FILE LAYOUT.....................................................................................................14
Table Name: (Repeat for each table or file).................................................................................................................14
DATA MAPPING ..........................................................................................................................15
10. DETAILED PROGRAM DESCRIPTION .............................................................................17
PROGRAM FLOW.........................................................................................................................17
DETAILED PSEUDO-CODE .............................................................................................................17
11. ERROR HANDLING .........................................................................................................28
4. RSSP Franchise Service Plan Automation Technical Specification
RPR6620F
Page 4 of 30 Last Update Date:10/23/2015 3:19:00 PM
Last Saved By:Jon
Z:tempw indows20151023151949_0b8dc1375aa4e2650264042fffdbee0d571a716d4dfa9968-fd92-4ec1-85fe-3d7c55250759-
151023152401-lva1-app6891.docx
ERROR CONDITIONS/RESTART LOGIC ............................................................................................28
12. REPORT LAYOUTS .........................................................................................................29
13. KEY CONTRIBUTORS .....................................................................................................30
14. REFERENCE ...................................................................................................................30
15. CHANGE LOG .................................................................................................................30
5. RSSP Franchise Service Plan Automation Technical Specification
RPR6620F
Page 5 of 30 Last Update Date:10/23/2015 3:19:00 PM
Last Saved By:Jon
Z:tempw indows20151023151949_0b8dc1375aa4e2650264042fffdbee0d571a716d4dfa9968-fd92-4ec1-85fe-3d7c55250759-
151023152401-lva1-app6891.docx
1. Current Issues
none
2. Conventions and Standards
IBM z/OS Mainframe COBOL
3. Functional Description
NEW 010118 VERSION OF RPR6620 (from 1999 ANSO 010119 replacements project) – module
responsible for taking in output from Ab Initio module (SCFRNSR cobol copybook
layout) and performing any calculations/DB2 lookups needed to fill in needed data
that is not on fran sql server DB. It is also responsible for conforming the sql
server harvested fields to mainframe-sized definitions and to mainframe naming
conventions.
4. Assumptions
none
5. Constraints
none
6. Interface Architecture
Interface Diagram
HW Platform: IBM z/OS mainframe
DB Platform: DB2
Interface Method:na
Program Language: COBOL
Comments:
7. Batch/Schedule Information
Job Dependencies
Must wait on the job that runs the Ab Initio graph, VASFRNSR
Frequency
DAILY
Performance/Volume Considerations
None. Franchise collectively sells approximately 100 service plans per day.
6. RSSP Franchise Service Plan Automation Technical Specification
RPR6620F
Page 6 of 30 Last Update Date:10/23/2015 3:19:00 PM
Last Saved By:Jon
Z:tempw indows20151023151949_0b8dc1375aa4e2650264042fffdbee0d571a716d4dfa9968-fd92-4ec1-85fe-3d7c55250759-
151023152401-lva1-app6891.docx
8. Program I/O
Input:
Dev:
CSVDQ.RS.VASFRNSR.FRANRSPP.SALERFND.&MTH&DD&YY
Prod:
CSVPQ.RS.VASFRNSR.FRANRSPP.SALERFND.&MTH&DD&YY
Format/Type: COBOL COPYBOOK CMNTIS.COBCOPY.CP2(SCFRNSR)
Output:
Dev:
CSVDQ.RS.RPR6620F.FRANRSPP.SALERFND.&MTH&DD&YY
Prod:
CSVPQ.RS.RPR6620F.FRANRSPP.SALERFND.&MTH&DD&YY
Format/Type: COBOL COPYBOOK CMNTIS.COBCOPY.CP2(SCFRNSR2)
Command Line/Program Parameters:
9. Final Physical Data Model Design
7. RSSP Franchise Service Plan Automation Technical Specification
RPR6620F
Page 7 of 30 Last Update Date:10/23/2015 3:19:00 PM
Last Saved By:Jon
Z:tempw indows20151023151949_0b8dc1375aa4e2650264042fffdbee0d571a716d4dfa9968-fd92-4ec1-85fe-3d7c55250759-
151023152401-lva1-app6891.docx
Database/File System Organization
Physical Data Model:
Record Layouts:
Database/File System Interface Details
File Name: (Repeat as needed)
Dev:
CSVDQ.RS.VASFRNSR.FRANRSPP.SALERFND.&MTH&DD&YY
Prod:
CSVPQ.RS.VASFRNSR.FRANRSPP.SALERFND.&MTH&DD&YY
Format/Type: COBOL COPYBOOK CMNTIS.COBCOPY.CP2(SCFRNSR)
Input Output
****************************************************************
* SERVICE CONTRACTS SYSTEM *
* FILE LAYOUT FOR FRANCHISE SALES/REFUNDS AUTOMATE *
* FOR AB INITIO GRAPH, VASFRNSR, TO LAND DATA FROM SQL SERVER *
* *
* C O B O L - COPYBOOK - SCFRNSR *
* *
* S C F R N S R *
* *
****************************************************************
8. RSSP Franchise Service Plan Automation Technical Specification
RPR6620F
Page 8 of 30 Last Update Date:10/23/2015 3:19:00 PM
Last Saved By:Jon
Z:tempw indows20151023151949_0b8dc1375aa4e2650264042fffdbee0d571a716d4dfa9968-fd92-4ec1-85fe-3d7c55250759-
151023152401-lva1-app6891.docx
03 :F:-FRAN-RSPP-SQLSERV-REC PIC X(2000).
03 :F:-FRAN-RSPP-SQLSERV-REC-INIT REDEFINES
:F:-FRAN-RSPP-SQLSERV-REC.
*--------------------------------------------------------
* FIELDS RETRIEVED FROM SQL SERVER EXTRACTION. THESE DATA
* DEFINITIONS MATCH THE DEFINITIONS ON SQL SERVER DB.
*--------------------------------------------------------
05 :F:-POS-TRANS-TYPE PIC X(1).
88 :F:-SALE VALUE 'S'.
88 :F:-REFUND VALUE 'R'.
05 :F:-POS-USERID PIC X(2).
05 :F:-POS-STOREID PIC X(4).
05 :F:-POS-TICKET-NUMBER PIC X(50).
05 :F:-POS-TRANS-DATE-TIME.
10 :F:-POS-TRANS-DATE-MMSDDSYYYY.
15 :F:-POS-TRANS-MM PIC 9(2).
15 :F:-POS-TRANS-S1 PIC X(1).
15 :F:-POS-TRANS-DD PIC 9(2).
15 :F:-POS-TRANS-S2 PIC X(1).
15 :F:-POS-TRANS-YYYY PIC 9(4).
10 :F:-POS-TRANS-TIME-HH-MN-SS.
15 :F:-POS-TRANS-HH PIC 9(2).
15 :F:-POS-TRANS-C1 PIC X(1).
15 :F:-POS-TRANS-MN PIC 9(2).
15 :F:-POS-TRANS-C2 PIC X(1).
15 :F:-POS-TRANS-SS PIC 9(2).
15 :F:-POS-DECPOINT PIC X(1).
15 :F:-POS-TRANS-MILLSS PIC 9(3).
05 :F:-ORG-POS-USER-ID PIC X(30).
05 :F:-ORG-POS-STOREID PIC X(30).
05 :F:-ORG-POS-TICKET-NUMBER PIC X(30).
05 :F:-ORG-POS-TRANS-DATE-TIME.
9. RSSP Franchise Service Plan Automation Technical Specification
RPR6620F
Page 9 of 30 Last Update Date:10/23/2015 3:19:00 PM
Last Saved By:Jon
Z:tempw indows20151023151949_0b8dc1375aa4e2650264042fffdbee0d571a716d4dfa9968-fd92-4ec1-85fe-3d7c55250759-
151023152401-lva1-app6891.docx
10 :F:-ORG-POS-TRANS-DT-MMSDDSYYYY.
15 :F:-ORG-POS-TRANS-MM PIC 9(2).
15 :F:-ORG-POS-TRANS-S1 PIC X(1).
15 :F:-ORG-POS-TRANS-DD PIC 9(2).
15 :F:-ORG-POS-TRANS-S2 PIC X(1).
15 :F:-ORG-POS-TRANS-YYYY PIC 9(4).
10 :F:-ORG-POS-TRANS-TIME-HH-MN-SS.
15 :F:-ORG-POS-TRANS-HH PIC 9(2).
15 :F:-ORG-POS-TRANS-C1 PIC X(1).
15 :F:-ORG-POS-TRANS-MN PIC 9(2).
15 :F:-ORG-POS-TRANS-C2 PIC X(1).
15 :F:-ORG-POS-TRANS-SS PIC 9(2).
15 :F:-ORG-POS-DECPOINT PIC X(1).
15 :F:-ORG-POS-TRANS-MILLSS PIC 9(3).
05 :F:-ITEM-QUANTITY PIC S9(9)V9.
05 :F:-UNIT-SELL-PRICE PIC S9(7)V99.
* THIS HAS TO BE SHORTENED. THE SQL SERVER DEF IS 9(18)V99 BUT
* THAT IS BEYOND THE LIMIT OF WHAT CAN BE DEFINED IN COBOL.
05 :F:-EXTENDED-PRICE PIC S9(9)V99.
05 :F:-DISCOUNT-AMT PIC S9(7)V99.
05 :F:-COMPANY-NAME PIC X(50).
05 :F:-FIRSTNAME PIC X(50).
05 :F:-LASTNAME PIC X(50).
05 :F:-ADDRESS-1 PIC X(50).
05 :F:-ADDRESS-2 PIC X(50).
05 :F:-CITY PIC X(50).
05 :F:-STATE PIC X(50).
05 :F:-ZIP PIC X(50).
05 :F:-CUST-CNTRY-ISO-CD PIC X(2).
05 :F:-TELEPHONE PIC X(50).
05 :F:-PARENTSKU PIC X(50).
05 :F:-SKU-ID PIC X(25).
10. RSSP Franchise Service Plan Automation Technical Specification
RPR6620F
Page 10 of 30 Last Update Date:10/23/2015 3:19:00 PM
Last Saved By:Jon
Z:tempw indows20151023151949_0b8dc1375aa4e2650264042fffdbee0d571a716d4dfa9968-fd92-4ec1-85fe-3d7c55250759-
151023152401-lva1-app6891.docx
05 F PIC X(1243).
****************************************************************
* END COPYBOOK SCFRNSR
****************************************************************
File Name: (Repeat as needed)
Dev:
CSVDQ.RS.RPR6620F.FRANRSPP.SALERFND.&MTH&DD&YY
Prod:
CSVPQ.RS.RPR6620F.FRANRSPP.SALERFND.&MTH&DD&YY
Format/Type: COBOL COPYBOOK CMNTIS.COBCOPY.CP2(SCFRNSR2)
Input Output
****************************************************************
* SERVICE CONTRACTS SYSTEM *
* FILE LAYOUT FOR FRANCHISE SALES/REFUNDS AUTOMATE *
* FOR RPR6620F INPUT TO REFORMAT DATA BEFORE INPUT TO RPR6621A *
* *
* C O B O L - COPYBOOK - SCFRNSR2 *
* *
* S C F R N S R 2 *
* *
****************************************************************
03 :F:-FRAN-RSPP-REC PIC X(1000).
03 :F:-FRAN-RSPP-REC-INITIAL REDEFINES :F:-FRAN-RSPP-REC.
*-----------------------------------------------------------
13. RSSP Franchise Service Plan Automation Technical Specification
RPR6620F
Page 13 of 30 Last Update Date:10/23/2015 3:19:00 PM
Last Saved By:Jon
Z:tempw indows20151023151949_0b8dc1375aa4e2650264042fffdbee0d571a716d4dfa9968-fd92-4ec1-85fe-3d7c55250759-
151023152401-lva1-app6891.docx
88 :F:-CARRY-IN-RENEWAL VALUE '3'.
88 :F:-ON-SITE-IN-WARR VALUE '4'.
88 :F:-ON-SITE-OUT-OF-WARR VALUE '5'.
88 :F:-ON-SITE-RENEWAL VALUE '6'.
88 :F:-CARRY-IN-SVP VALUE '1' THRU '3'.
88 :F:-ON-SITE-SVP VALUE '4' THRU '6'.
* THIS IS THE PRODUCT SKU DESC
05 :F:-SKU-SLMKR-DESC PIC X(30).
05 :F:-SVP-BEG-DT.
10 :F:-SVP-BEG-MM PIC X(2).
10 :F:-SVP-BEG-DD PIC X(2).
10 :F:-SVP-BEG-CC PIC X(2).
10 :F:-SVP-BEG-YY PIC X(2).
05 :F:-SVP-END-DT.
10 :F:-SVP-END-MM PIC X(2).
10 :F:-SVP-END-DD PIC X(2).
10 :F:-SVP-END-CC PIC X(2).
10 :F:-SVP-END-YY PIC X(2).
05 :F:-SVP-DSCNT-PCT PIC S9(3) COMP-3.
05 :F:-SVP-COST-AMT PIC S9(7)V9(2) COMP-3.
05 :F:-FRAN-PRECISION-PCT PIC S9(3)V9(4) COMP-3.
05 :F:-SVP-RTL-AMT PIC S9(9)V99 COMP-3.
05 :F:-SVP-CATG-ID PIC X(4).
05 :F:-SVP-CMNT-LN1-DESC PIC X(50).
05 F PIC X(617).
****************************************************************
* END COPYBOOK SCFRNSR2
****************************************************************
Database/File System Space Requirements
Minimal. Franchise collectively sells ~100 service plans per day.
14. RSSP Franchise Service Plan Automation Technical Specification
RPR6620F
Page 14 of 30 Last Update Date:10/23/2015 3:19:00 PM
Last Saved By:Jon
Z:tempw indows20151023151949_0b8dc1375aa4e2650264042fffdbee0d571a716d4dfa9968-fd92-4ec1-85fe-3d7c55250759-
151023152401-lva1-app6891.docx
Database/File System Decommissioning Activities
None known.
Database Table/File Layout
Table Name: (Repeat for each table or file)
Field Name Description Required Field Data Type/Size
15. Approved and Issued by: IT Governance
Template Version: 2.4
Template Revised: August 8, 2013
Data Mapping
The following mapping represents only those fields that will have data definition changes during RPR6620F’s processing.
Source File/Table Destination File/Table
File/Table
Name
Field Name Data
Type/Size
File/Table
Name
Field Name Data
Type/Size
:F:-POS-TICKET-NUMBER PIC X(50) :F:-POS-TICKET-NUMBER PIC X(6)
:F:-POS-TRANS-DATE-TIME PIC X(22) :F:-POS-TRANS-DATE-TIME PIC X(18)
:F:-ORG-POS-USER-ID PIC X(30) :F:-ORG-POS-USER-ID PIC X(2)
:F:-ORG-POS-STOREID PIC X(30) :F:-ORG-POS-STOREID PIC X(4)
:F:-ORG-POS-TICKET-NUMBER PIC X(30) :F:-ORG-POS-TICKET-NUMBER PIC X(6)
:F:-ORG-POS-TRANS-DATE-TIME PIC X(22) :F:-ORG-POS-TRANS-DATE-TIME PIC X(18)
:F:-COMPANY-NAME PIC X(50) :F:-COMPANY-NAME PIC X(30)
:F:-FIRSTNAME PIC X(50) :F:-FIRSTNAME PIC X(9)
:F:-LASTNAME PIC X(50) :F:-LASTNAME PIC X(20)
:F:-ADDRESS-1 PIC X(50) :F:-ADDRESS-1 PIC X(30)
:F:-ADDRESS-2 PIC X(50) :F:-ADDRESS-2 PIC X(30)
:F:-CITY PIC X(50) :F:-CITY PIC X(21)
:F:-STATE PIC X(50) :F:-STATE PIC X(2)
:F:-ZIP PIC X(50) :F:-ZIP PIC X(11)
:F:-TELEPHONE PIC X(50) :F:-TELEPHONE PIC X(12)
16. RSSP Franchise Service Plan Automation Technical Specification
RPR6620F
Page 16 of 30 Last Update Date:10/23/2015 3:19:00 PM
Last Saved By:Jon
Z:tempw indows20151023151949_0b8dc1375aa4e2650264042fffdbee0d571a716d4dfa9968-fd92-4ec1-85fe-3d7c55250759-151023152401-lva1-app6891.docx
:F:-PARENTSKU PIC X(50) :F:-PARENTSKU PIC X(7)
:F:-SKU-ID PIC X(25) :F:-SKU-ID PIC X(7)
17. Approved and Issued by: IT Governance
Template Version: 2.4
Template Revised: August 8, 2013
10. Detailed Program Description
Program Flow
For the fields within the file layout, SCFRNSR, that are found in the section marked “fields retrieved
from sql server extraction…” the program will simply move the input file fields to the corresponding
fields on the output file SCFRNSR2 but with any trimming as needed in some cases.
For the fields within the file layout, SCFRNSR2, that are found in the section marked “fields retrieved
post sql server extraction” the program will have to do lookups to db2 control tables to locate and/or
calculate these values.
Detailed pseudo-code
Initialization
Check/process any parms
Open input file SCFRNSR
Open output file SCFRNSR2
Read input file SCFRNSR [priming read]: If EOF detected here, do empty-file paragraph, shut
down, abend if appropriate.
Process input file
Move all input fields found in the “fields retrieved from sql server extraction…” section to their
corresponding output fields – trim where needed.
If refund:
Perform lookup to db2 transactional ticket tables to verify that the fields:
:F:-ORG-POS-USER-ID
:F:-ORG-POS-STOREID
:F:-ORG-POS-TICKET-NUMBER
:F:-ORG-POS-TRANS-DATE-TIME
Represent a valid ticket. The above fields plus the merch sku :F:-PARENTSKU
18. RSSP Franchise Service Plan Automation Technical Specification
RPR6620F
Page 18 of 30 Last Update Date:10/23/2015 3:19:00 PM
Last Saved By:Jon
Z:tempw indows20151023151949_0b8dc1375aa4e2650264042fffdbee0d571a716d4dfa9968-fd92-4ec1-85fe-3d7c55250759-
151023152401-lva1-app6891.docx
and svp sku id :F:-SKU-ID must all be present on an original service plan ticket in order
for the refund to be valid. Tweak this SQL from cics program sc53p53s:
***************************************************************
RADIO-SHACK-RFND.
***************************************************************
EXEC SQL
DECLARE RS-SKU-CURSOR CURSOR FOR
SELECT SVP_RFND_MTCH_IND
FROM SALE_TKT_SVP A,
SVP_ITEM B
WHERE A.USER_NBR = :SQL-USER-NBR
AND A.STR_ID = :SQL-STR-ID
AND A.SLTKT_NBR = :SQL-SLTKT-NBR
AND A.SLTKT_DT = :SQL-SLTKT-DT
AND A.SKU_ID = :SQL-SKU-ID
AND A.SVP_SKU_ID = :SQL-SVP-SKU-ID
AND A.TS_PTN_NBR = B.TS_PTN_NBR
AND A.SLTKT_DT = B.SLTKT_DT
AND A.USER_NBR = B.USER_NBR
AND A.STR_ID = B.STR_ID
AND A.SLTKT_NBR = B.SLTKT_NBR
AND A.SLTKT_TM = B.SLTKT_TM
AND A.SLTKT_LINSEQ_NBR = B.SLTKT_LINSEQ_NBR
END-EXEC
EVALUATE TRUE
WHEN SQLCODE NOT = ZERO
MOVE 'N' TO LINK-SQL-VALID-IND
WHEN SQLCODE = ZERO
PERFORM FETCH-RS-SKU-CURSOR
19. RSSP Franchise Service Plan Automation Technical Specification
RPR6620F
Page 19 of 30 Last Update Date:10/23/2015 3:19:00 PM
Last Saved By:Jon
Z:tempw indows20151023151949_0b8dc1375aa4e2650264042fffdbee0d571a716d4dfa9968-fd92-4ec1-85fe-3d7c55250759-
151023152401-lva1-app6891.docx
* an sqlcode other than 100 or zero is handled by 'whenever
* sqlerror'
EVALUATE TRUE
WHEN SQLCODE = ZERO
PERFORM UNTIL NOT REFUND-MATCHED OR
EOF-SKU-CRSR
PERFORM FETCH-RS-SKU-CURSOR
END-PERFORM
IF NOT REFUND-MATCHED
MOVE 'Y' TO LINK-SQL-VALID-IND
ELSE
MOVE 'A' TO LINK-SQL-VALID-IND
END-IF
WHEN SQLCODE = 100
MOVE 'N' TO LINK-SQL-VALID-IND
END-EVALUATE
END-EVALUATE
EXEC SQL CLOSE RS-SKU-CURSOR END-EXEC
For some fields in the “fields retrieved post sql server extraction” section of file layout,
SCFRNSR2, lookups to db2 control tables must be done:
***************************************************************
GET-SVP-SKU-FIELDS.
***************************************************************
MOVE :F:-SKU-ID TO SQL-SVP-SKU-ID
* reformat the link date to yyyymmdd
20. RSSP Franchise Service Plan Automation Technical Specification
RPR6620F
Page 20 of 30 Last Update Date:10/23/2015 3:19:00 PM
Last Saved By:Jon
Z:tempw indows20151023151949_0b8dc1375aa4e2650264042fffdbee0d571a716d4dfa9968-fd92-4ec1-85fe-3d7c55250759-
151023152401-lva1-app6891.docx
EVALUATE TRUE
WHEN :F:-SALE
MOVE POS-TRANS-YYYY TO WS-COMPARE-YYYY
MOVE POS-TRANS-MM TO WS-COMPARE-MM
MOVE POS-TRANS-DD TO WS-COMPARE-DD
WHEN :F:-REFUND
MOVE ORG-POS-TRANS-YYYY TO WS-COMPARE-YYYY
MOVE ORG-POS-TRANS-MM TO WS-COMPARE-MM
MOVE ORG-POS-TRANS-DD TO WS-COMPARE-DD
WHEN OTHER
PERFORM APPROPRIATE ABEND ROUTINE
END-EVAL
EXEC SQL
SELECT
SVD.SVP_COVER_MTH_QTY
,SVD.SVP_WRNTY_TYP_CD
,SVD.SVP_SRVC_LOC_CD
,SVD.BILL_FREQ_MTH_QTY will be examined to make sure recur bill sku
was not used
INTO
:SVP-DETAIL.SVP-COVER-MTH-QTY
,:SVP-DETAIL.SVP-WRNTY-TYP-CD
,:SVP-DETAIL.SVP-SRVC-LOC-CD
,:SVP-DETAIL.BILL-FREQ-MTH-QTY
FROM
SVP_DETAIL SVD
WHERE
SVD.SVP_SKU_ID = :SQL-SVP-SKU-ID
END-EXEC
21. RSSP Franchise Service Plan Automation Technical Specification
RPR6620F
Page 21 of 30 Last Update Date:10/23/2015 3:19:00 PM
Last Saved By:Jon
Z:tempw indows20151023151949_0b8dc1375aa4e2650264042fffdbee0d571a716d4dfa9968-fd92-4ec1-85fe-3d7c55250759-
151023152401-lva1-app6891.docx
05 :F:-SVP-COVER-MTH-QTY SVP-DETAIL.SVP-COVER-MTH-QTY
05 :F:-SVP-LOC-WRNTY-COND-CD [derived by examining
SVP-DETAIL.SVP-WRNTY-TYP-CD in conjunction with SVP-DETAIL.SVP-SRVC-LOC-CD]
05 :F:-SKU-SLMKR-DESC from :PRODUCT.SKU-DESC
SELECT A.SKU_DESC
INTO :PRODUCT.SKU-DESC
FROM PRODUCT A
WHERE SKU_ID = :SQL-SKU-ID
AND PROD_EXP_DT =
(SELECT MAX(PROD_EXP_DT)
FROM PRODUCT X
WHERE X.SKU_ID = A.SKU_ID)
05 :F:-SVP-BEG-DT from 10 :F:-POS-TRANS-DATE-MMSDDSYYYY.
05 :F:-SVP-END-DT figure using date math: 05 :F:-SVP-BEG-DT + 05
:F:-SVP-COVER-MTH-QTY
05 :F:-SVP-DSCNT-PCT figure as 05 :F:-DISCOUNT-AMT ÷ 05 :F:-UNIT-
SELL-PRICE
05 :F:-SVP-COST-AMT retrieve from service plan price control DB2
table: CMP.SVP_COST_DTL using the code/sql [with minor modifications] found in
paragraphs “GET-SALES-CHANNEL” then “GET-SVP-COST” in CICS program:
CMNTIS.CICSPGM.SRC(SC53P53S):
****************************************
GET-SALES-CHANNEL.
****************************************
22. RSSP Franchise Service Plan Automation Technical Specification
RPR6620F
Page 22 of 30 Last Update Date:10/23/2015 3:19:00 PM
Last Saved By:Jon
Z:tempw indows20151023151949_0b8dc1375aa4e2650264042fffdbee0d571a716d4dfa9968-fd92-4ec1-85fe-3d7c55250759-
151023152401-lva1-app6891.docx
MOVE 05 :F:-POS-USER-ID TO SQL-USER-NBR
MOVE 05 :F:-POS-STOREID TO SQL-STR-ID
EXEC SQL
SELECT
SLS_CHNL_ID
INTO
:RS-SLS-CHNL.SLS-CHNL-ID
FROM
RS_SLS_CHNL
WHERE
USER_NBR = :SQL-USER-NBR
AND STR_ID = :SQL-STR-ID
END-EXEC
**************************************************************
GET-SVP-COST.
**************************************************************
MOVE SLS-CHNL-ID OF RS-SLS-CHNL TO SQL-SLS-CHNL-ID
MOVE 05 :F:-SKU-ID TO SQL-SVP-SKU-ID
Jeremy,
When a service plan refund is transacted, does the fran POS have the ability to refund at the
original amt that the customer paid or does it just refund the current price of the service plan?
The retail price can be overriddentoanyamountby the associate. So,yestheycan refundat the
original amounteventhoughthe price mayhave changed.
Jeremy
23. RSSP Franchise Service Plan Automation Technical Specification
RPR6620F
Page 23 of 30 Last Update Date:10/23/2015 3:19:00 PM
Last Saved By:Jon
Z:tempw indows20151023151949_0b8dc1375aa4e2650264042fffdbee0d571a716d4dfa9968-fd92-4ec1-85fe-3d7c55250759-
151023152401-lva1-app6891.docx
MOVE ‘/’ TO
SQL-COMPARE-SLASH1
SQL-COMPARE-SLASH2
If sale transaction:
MOVE 10 :F:-POS-TRANS-DATE-MMSDDSYYYY TO SQL-COMPARE-MMSDDSYYYY-DT
If refund transaction:
MOVE 10 :F:-ORG-POS-TRANS-DATE-MMSDDSYYYY TO SQL-COMPARE-MMSDDSYYYY-DT
EXEC SQL
SELECT
SCD.SVP_COST_AMT,
SCD.CORP_PROFIT_PCT
INTO
:SVP-COST-DTL.SVP-COST-AMT,
:SVP-COST-DTL.CORP-PROFIT-PCT:
WS-CORP-PROFIT-PCT-IND
FROM
SVP_COST_DTL SCD
WHERE
SCD.SVP_SKU_ID = :SQL-SVP-SKU-ID
AND SCD.SLS_CHNL_ID = :SQL-SLS-CHNL-ID
AND SCD.SVP_COST_EFF_DT =
(SELECT
MAX(X.SVP_COST_EFF_DT)
FROM
SVP_COST_DTL X
WHERE X.SVP_SKU_ID = SCD.SVP_SKU_ID
AND X.SLS_CHNL_ID = SCD.SLS_CHNL_ID
AND X.SVP_COST_EFF_DT <=
:SQL-COMPARE-MMSDDSYYYY-DT)
24. RSSP Franchise Service Plan Automation Technical Specification
RPR6620F
Page 24 of 30 Last Update Date:10/23/2015 3:19:00 PM
Last Saved By:Jon
Z:tempw indows20151023151949_0b8dc1375aa4e2650264042fffdbee0d571a716d4dfa9968-fd92-4ec1-85fe-3d7c55250759-
151023152401-lva1-app6891.docx
END-EXEC
Note: this SVP-RTL-AMT is not the same as the SVP_RTL_AMT on db2 price control
table SVP_PRICE_DTL. The version below holds the cust tender amt after
discounting and/or pro-rating and/or the franchise calc [the piece of paper
from Karen H. hung on my wall].
05 :F:-FRAN-PRECISION-PCT
IF 05 :F:-UNIT-SELL-PRICE > ZERO
* calculation supplied from accounting:
* ((svp rtl amt - dealer net) x corp profit%) + dealer net
COMPUTE WS-COST-TO-FRAN-AMT ROUNDED =
((05 :F:-UNIT-SELL-PRICE - SVP-COST-DTL.SVP-COST-AMT)
* SVP-COST-DTL.CORP-PROFIT-PCT / WS-FACTOR)
+ SVP-COST-DTL.SVP-COST-AMT
05 WS-FACTOR PIC S9(5) COMP-3 VALUE 100.
* the next multiply is because the ibm compute statement has
* known bug that rounds intermittently instead of at the end
MULTIPLY WS-COST-TO-FRAN-AMT BY 1 GIVING
WS-COST-TO-FRAN-AMT ROUNDED
* figure as a pct the relationship between the "cost to franchise"
* and the svp rtl amt (cost to fran divided by svp rtl amt) in
* order to allow the existing calc infrastructure to continue
* to operate properly. previously, this % would have been a
* constant 75% sourced from in5.rpr.control. now it must be
* derived after the new accounting formula is executed above.
COMPUTE 05 :F:-FRAN-PRECISION-PCT ROUNDED =
(WS-COST-TO-FRAN-AMT / 05 :F:-UNIT-SELL-PRICE) * 100
25. RSSP Franchise Service Plan Automation Technical Specification
RPR6620F
Page 25 of 30 Last Update Date:10/23/2015 3:19:00 PM
Last Saved By:Jon
Z:tempw indows20151023151949_0b8dc1375aa4e2650264042fffdbee0d571a716d4dfa9968-fd92-4ec1-85fe-3d7c55250759-
151023152401-lva1-app6891.docx
* the next multiply is because the ibm compute statement has
* known bug that rounds intermittently instead of at the end
MULTIPLY 05 :F:-FRAN-PRECISION-PCT BY 1 GIVING
05 :F:-FRAN-PRECISION-PCT ROUNDED
ELSE
MOVE 100.0000 TO 05 :F:-FRAN-PRECISION-PCT
END-IF
05 :F:-SVP-RTL-AMT
IF 05 :F:-FRAN-PRECISION-PCT > ZERO
COMPUTE 05 :F:-SVP-RTL-AMT ROUNDED =
05 :F:-UNIT-SELL-PRICE * ( 100 / 05 :F:-FRAN-PRECISION-PCT)
*---------------------------------------------------------------*
* the next multiply is because the ibm compute statement has *
* known bug that rounds intermittently instead of at the end *
*---------------------------------------------------------------*
MULTIPLY 05 :F:-SVP-RTL-AMT BY 1 GIVING 05 :F:-SVP-RTL-AMT
ROUNDED
ELSE
PERFORM ABEND ROUTINE TO INDICATE CRITICAL ERROR: 05 :F:-FRAN-PRECISION-PCT WAS
FOUND LESS THAN OR EQUAL TO ZERO. EITHER IS UNACCEPTABLE. SHUT DOWN.
END-IF
Subtract out discount:
SUBTRACT 05 :F:-DISCOUNT-AMT FROM 05 :F:-SVP-RTL-AMT
05 :F:-SVP-CATG-ID
26. RSSP Franchise Service Plan Automation Technical Specification
RPR6620F
Page 26 of 30 Last Update Date:10/23/2015 3:19:00 PM
Last Saved By:Jon
Z:tempw indows20151023151949_0b8dc1375aa4e2650264042fffdbee0d571a716d4dfa9968-fd92-4ec1-85fe-3d7c55250759-
151023152401-lva1-app6891.docx
***************************************************************
GET-SVP-CATG-ID.
***************************************************************
SELECT
MSA.SVP_CATG_ID
INTO
:MDSE-SVP-ASOC.SVP-CATG-ID
FROM
MDSE_SVP_ASOC MSA
WHERE
MSA.SKU_ID = :05 :F:-SKU-ID
* this subselect gets the most current merch-sku-to-svp-catg-id
* assoc according to the compare date that is sent from the
* calling program. if the compare date sent is in the future,
* the comparison is done against the system date
AND MSA.ASOC_EFF_DT =
(SELECT MAX(MSA2.ASOC_EFF_DT)
FROM MDSE_SVP_ASOC MSA2
WHERE MSA2.ASOC_EFF_DT <=
:SQL-COMPARE-MMSDDSYYYY-DT AND
MSA2.MDSE_GRP_NBR = MSA.MDSE_GRP_NBR AND
MSA2.SKU_ID = MSA.SKU_ID AND
MSA2.SLS_CHNL_ID = MSA.SLS_CHNL_ID)
--------------
At EOF:
Close input file SCFRNSR
27. RSSP Franchise Service Plan Automation Technical Specification
RPR6620F
Page 27 of 30 Last Update Date:10/23/2015 3:19:00 PM
Last Saved By:Jon
Z:tempw indows20151023151949_0b8dc1375aa4e2650264042fffdbee0d571a716d4dfa9968-fd92-4ec1-85fe-3d7c55250759-
151023152401-lva1-app6891.docx
Close output file SCFRNSR2
Produce sysout log:
01 SYSOUT-TOTAL-LINE.
05 SYSOUT-NBR PIC ZZZ,ZZZ,ZZ9-.
05 F PIC X(2) VALUE SPACES.
05 SYSOUT-MSG PIC X(35) VALUE SPACES.
DISPLAY '***************************************'
DISPLAY '* R P R 6 6 2 0 F *'
DISPLAY '***************************************'
DISPLAY ' '
xxx,xxx,xxx Total Recs read
xxx,xxx,xxx Total Recs written
xxx,xxx,xxx Total Recs marked in error for agent review in CICS
MOVE IN-COUNT TO SYSOUT-NBR
MOVE ' TOTAL RECORDS READ' TO SYSOUT-MSG
DISPLAY SYSOUT-TOTAL-LINE
MOVE OUT-COUNT TO SYSOUT-NBR
MOVE ' TOTAL RECORDS WRITTEN' TO SYSOUT-MSG
DISPLAY SYSOUT-TOTAL-LINE
MOVE ESO-ERRRPT-COUNT TO SYSOUT-NBR
MOVE ' Total Recs marked in error for agent review in CICS' TO SYSOUT-MSG
DISPLAY SYSOUT-TOTAL-LINE
DISPLAY SPACE
EVALUATE TRUE
28. RSSP Franchise Service Plan Automation Technical Specification
RPR6620F
Page 28 of 30 Last Update Date:10/23/2015 3:19:00 PM
Last Saved By:Jon
Z:tempw indows20151023151949_0b8dc1375aa4e2650264042fffdbee0d571a716d4dfa9968-fd92-4ec1-85fe-3d7c55250759-
151023152401-lva1-app6891.docx
WHEN EMPTY-INPUT-FILE
DISPLAY 'NO RECORDS FOUND ON INPUT FILE'
DISPLAY 'FRANCHISE STORES COLLECTIVELY SELL AT'
DISPLAY 'LEAST A FEW SERVICE PLANS ON MOST DAYS.'
DISPLAY 'THUS THIS SITUATION SHOULD BE SCRUTINIZED'
DISPLAY 'FOR VALIDITY.'
WHEN OTHER
CONTINUE
END-EVALUATE
11. Error Handling
Error Conditions/Restart Logic
When processing a ticket, program will populate field:
05 :F:-SVP-CMNT-LN1-DESC PIC X(50)
with text describing any issue encountered during processing. For example, if the lookup to the db2
price control tables fails, the program should populate the above field with something along the lines
of “Dealer net lookup failed. Correct on SKU screen.”
RPR6621A will check this comment field. If it is nonblank, RPR6621A will set the ticket status to
“incomplete” and RPR6622A will route it to an open daily report for agent review.
The above comment text field is visible by an agent on the 010118 CICS summary screen, sc54p54:
29. RSSP Franchise Service Plan Automation Technical Specification
RPR6620F
Page 29 of 30 Last Update Date:10/23/2015 3:19:00 PM
Last Saved By:Jon
Z:tempw indows20151023151949_0b8dc1375aa4e2650264042fffdbee0d571a716d4dfa9968-fd92-4ec1-85fe-3d7c55250759-
151023152401-lva1-app6891.docx
12. Report Layouts
123456789012345678901234567890123456789012345678012345678901234567890
30. Approved and Issued by: IT Governance
Template Version: 2.4
Template Revised: August 8, 2013
13. Key Contributors
Name Project Role
14. Reference
15.Change Log
New
Version #
Changes Effected
Page # Effective
Date
Remarks