technical specification - rpr6620f cobol

RSSP Franchise Service Plan Automation

Technical Specification

RPR6620F

Ver 1.0

Approved and Issued by: IT Governance

Template Version: 2.4

Template Revised: August 8, 2013

RSSP Franchise Service Plan Automation Technical Specification

RPR6620F

100%

PREPARED BY APPROVED BY

NAME Jon Fortman

ROLE SME/Developer

of 34 Last Update Date: 10/23/2015 3:23:00 PM

Last Saved By: Jon Fortman

/tt/file_convert/588141ee1a28abf65a8b66ab/document.docx


RPR6620F

TABLE OF CONTENTS

1. CURRENT ISSUES............................................................................................................................ 3

2. CONVENTIONS AND STANDARDS..................................................................................................3

3. FUNCTIONAL DESCRIPTION...........................................................................................................3

4. ASSUMPTIONS.................................................................................................................................. 3

5. CONSTRAINTS.................................................................................................................................. 3

6. INTERFACE ARCHITECTURE..........................................................................................................3

INTERFACE DIAGRAM............................................................................................................................. 3

7. BATCH/SCHEDULE INFORMATION.................................................................................................3

JOB DEPENDENCIES.............................................................................................................................. 3

FREQUENCY.......................................................................................................................................... 3

PERFORMANCE/VOLUME CONSIDERATIONS.............................................................................................3

8. PROGRAM I/O.................................................................................................................................... 3

9. FINAL PHYSICAL DATA MODEL DESIGN.......................................................................................4

DATABASE/FILE SYSTEM ORGANIZATION................................................................................................4

Physical Data Model:........................................................................................................................................4

Record Layouts:................................................................................................................................................4

DATABASE/FILE SYSTEM INTERFACE DETAILS.........................................................................................4

File Name: (Repeat as needed).........................................................................................................................4

File Name: (Repeat as needed).........................................................................................................................6

DATABASE/FILE SYSTEM SPACE REQUIREMENTS....................................................................................8

Minimal. Franchise collectively sells ~100 service plans per day...............................................8

DATABASE/FILE SYSTEM DECOMMISSIONING ACTIVITIES.........................................................................8

None known................................................................................................................................ 8

DATABASE TABLE/FILE LAYOUT.............................................................................................................8

Table Name: (Repeat for each table or file).......................................................................................................8

DATA MAPPING..................................................................................................................................... 9





RPR6620F

10. DETAILED PROGRAM DESCRIPTION...................................................................................10

PROGRAM FLOW................................................................................................................................. 10

DETAILED PSEUDO-CODE..................................................................................................................... 10

11. ERROR HANDLING................................................................................................................. 15

ERROR CONDITIONS/RESTART LOGIC...................................................................................................15

12. REPORT LAYOUTS................................................................................................................. 15

13. KEY CONTRIBUTORS............................................................................................................17

14. REFERENCE............................................................................................................................ 17

15. CHANGE LOG......................................................................................................................... 17





RPR6620F

1. Current Issuesnone

2. Conventions and StandardsIBM z/OS Mainframe COBOL

3. Functional DescriptionNEW 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. Assumptionsnone

5. Constraintsnone

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 DependenciesMust wait on the job that runs the Ab Initio graph, VASFRNSR

Frequency DAILY





RPR6620F

Performance/Volume ConsiderationsNone. Franchise collectively sells approximately 100 service plans per day.

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:





RPR6620F

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

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





RPR6620F

****************************************************************

* 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 *

* *

****************************************************************

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).





RPR6620F

15 :F:-POS-TRANS-DD PIC 9(2).


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-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.

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-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-SS PIC 9(2).

15 :F:-ORG-POS-DECPOINT PIC X(1).





RPR6620F

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:-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).

05 F PIC X(1243).

****************************************************************

* END COPYBOOK SCFRNSR

****************************************************************

File Name: (Repeat as needed)

Dev:

CSVDQ.RS.RPR6620F.FRANRSPP.SALERFND.&MTH&DD&YY





RPR6620F

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.

*-----------------------------------------------------------

* FIELDS RETRIEVED FROM SQL SERVER EXTRACTION BUT REDUCED TO

* NORMAL DEFINITIONS AND THE MAINFRAME NAMES APPLIED.

*-----------------------------------------------------------

05 :F:-POS-TRANS-TYPE PIC X(1).





RPR6620F

88 :F:-SALE VALUE 'S'.

88 :F:-REFUND VALUE 'R'.

05 :F:-POS-USER-ID PIC X(2).

05 :F:-POS-STOREID PIC X(4).

05 :F:-POS-TICKET-NUMBER PIC X(6).

05 :F:-POS-TRANS-DATE-TIME.

10 :F:-POS-TRANS-DATE-MMSDDSYYYY.

15 :F:-POS-TRANS-MM PIC 9(2).


15 :F:-POS-TRANS-DD PIC 9(2).


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-MN PIC 9(2).


15 :F:-POS-TRANS-SS PIC 9(2).

05 :F:-ORG-POS-USER-ID PIC X(2).

05 :F:-ORG-POS-STOREID PIC X(4).

05 :F:-ORG-POS-TICKET-NUMBER PIC X(6).

05 :F:-ORG-POS-TRANS-DATE-TIME.

10 :F:-ORG-POS-TRANS-DT-MMSDDSYYYY.

15 :F:-ORG-POS-TRANS-MM PIC 9(2).


15 :F:-ORG-POS-TRANS-DD PIC 9(2).


15 :F:-ORG-POS-TRANS-YYYY PIC 9(4).





RPR6620F

10 :F:-ORG-POS-TRANS-TIME-HH-MN-SS.

15 :F:-ORG-POS-TRANS-HH PIC 9(2).


15 :F:-ORG-POS-TRANS-MN PIC 9(2).


15 :F:-ORG-POS-TRANS-SS PIC 9(2).

05 :F:-SVP-RTL-QTY PIC S9(5) COMP-3.

05 :F:-UNIT-SELL-PRICE PIC S9(7)V99 COMP-3.

05 :F:-EXTENDED-PRICE PIC S9(9)V99 COMP-3.

05 :F:-DISCOUNT-AMT PIC S9(7)V99 COMP-3.

05 :F:-COMPANY-NAME PIC X(30).

05 :F:-CUST-NM PIC X(30).

05 F REDEFINES :F:-CUST-NM.

10 :F:-FIRSTNAME PIC X(9).

10 F PIC X.

10 :F:-LASTNAME PIC X(20).



05 :F:-CITY PIC X(21).

05 :F:-STATE PIC X(2).

05 :F:-ZIP PIC X(11).

05 :F:-CUST-CNTRY-ISO-CD PIC X(2).

05 :F:-TELEPHONE PIC X(12).

05 :F:-PARENTSKU PIC X(7).

05 :F:-SKU-ID PIC X(7).

*--------------------------------------------------------

* FIELDS RETRIEVED POST SQL SERVER EXTRACTION

*--------------------------------------------------------





RPR6620F

05 :F:-SVP-COVER-MTH-QTY PIC S9(5) COMP-3.

05 :F:-SVP-LOC-WRNTY-COND-CD PIC X(1).

88 :F:-CARRY-IN-IN-WARR VALUE '1'.

88 :F:-CARRY-IN-OUT-OF-WARR VALUE '2'.

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).





RPR6620F

05 F PIC X(617).

****************************************************************

* END COPYBOOK SCFRNSR2

****************************************************************

Database/File System Space RequirementsMinimal. Franchise collectively sells ~100 service plans per day.

Database/File System Decommissioning ActivitiesNone known.

Database Table/File Layout

Table Name: (Repeat for each table or file)

Field Name Description Required Field Data Type/Size




Data MappingThe 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)





RPR6620F

: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)

:F:-PARENTSKU PIC X(50) :F:-PARENTSKU PIC X(7)

:F:-SKU-ID PIC X(25) :F:-SKU-ID PIC X(7)




10. Detailed Program Description

Program FlowFor 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-codeInitialization

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





RPR6620F

:F:-ORG-POS-TRANS-DATE-TIME

Represent a valid ticket. The above fields plus the merch sku :F:-PARENTSKU

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





RPR6620F

END-EXEC

EVALUATE TRUE

WHEN SQLCODE NOT = ZERO

MOVE 'N' TO LINK-SQL-VALID-IND

WHEN SQLCODE = ZERO

PERFORM FETCH-RS-SKU-CURSOR

* 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





RPR6620F

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

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 of 34 Last Update Date: 10/23/2015 3:23:00 PM




RPR6620F

,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

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





RPR6620F

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.

****************************************

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





RPR6620F

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 overridden to any amount by the associate. So, yes they can refund at the original amount even though the price may have changed.

Jeremy

MOVE ‘/’ TO

SQL-COMPARE-SLASH1

SQL-COMPARE-SLASH2





RPR6620F

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)





RPR6620F

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





RPR6620F

* 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

* 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.





RPR6620F

END-IF

Subtract out discount:

SUBTRACT 05 :F:-DISCOUNT-AMT FROM 05 :F:-SVP-RTL-AMT

05 :F:-SVP-CATG-ID

***************************************************************

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)





RPR6620F

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

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 of 34 Last Update Date: 10/23/2015 3:23:00 PM




RPR6620F

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


MOVE ESO-ERRRPT-COUNT TO SYSOUT-NBR

MOVE ' Total Recs marked in error for agent review in CICS' TO SYSOUT-MSG


DISPLAY SPACE

EVALUATE TRUE

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





RPR6620F

11. Error Handling

Error Conditions/Restart LogicWhen 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:





RPR6620F

12. Report Layouts

123456789012345678901234567890123456789012345678012345678901234567890




13. Key Contributors

Name Project Role

14. Reference

15.Change Log

New Version # Changes Effected Page # Effective

Date Remarks





RPR6620F




technical specification - rpr6620f cobol

Documents