1

CSG Vantage

ACP
Overview
Oracle

2
CSG Vantage

ACP Overview

3
CSG Vantage

ACP Overview
4
Vantage ACP Tables
House Tables

CHX_CUS_HSE

This table includes the start and end dates for connected
service and provides the necessary keys to link customer
billing and dwelling data to a customer account. Vantage
retains the customer house relationship for up to two years
after you disconnect service at the house.



5
Vantage ACP Tables
In ACP there is no longer a house to subscriber relationship like we have in legacy.
So if you look at the HIU screen in ACP, the three fields on the right side of the HIU
screen, where we used to see the current subscriber account number and the two
previous account numbers, is no longer there.

So, how do we join house to sbb? We are going to have to start using another
join. We are going to bring in the CHX_CUS_HSE table. This table contains the
customer account number and house key. Here is what we will do:

WHERE HSE_KEY_HSE = HSE_KEY_CHX
AND CUST_ACCT_NO_CHX = CUST_ACCT_NO_SBB

Additionally, there may be more than one subscriber for the customer account
sbb. One way to reduce the amount of "garbage" you bring back is to add this one
additional Where clause for active accounts:
AND END_DTE_CHX = '0001-01-01'
The end date is 0001-01-01 until all services for the customer in that house are
disconnected. So you need to use this additional line in your queries when trying
to join house to sbb for active accounts.


6
Vantage ACP Tables
Subscriber Tables

CUS_BASE
This table includes customer information such
as address, creation date, Name, and Drivers
License #. It can be used instead of or in
conjunction with the HSE_BASE and the
SBB_BASE tables.

Join to this table using the
CUST_ACCT_NO_XXX field.


7
Vantage ACP Tables
Subscriber Tables continued

OCI_CUR_ITEM
This table contains information about all of a customers
current services similar to what the SBS_SERV_CODES
table does for you in the Legacy System.

Example Query -
ALL ACTIVE SUBSCRIBERS WHO HAVE BOTH SERVICE CODES AA & BB

QUERY IN ACP:
SELECT SUB_ACCT_NO_OCI
FROM OCI_CUR_ITEM A
WHERE A.SERV_CDE_OCI = AA
AND EXISTS (SELECT 1
FROM OCI_CUR_ITEM B
WHERE A.SUB_ACCT_NO_OCI = B.SUB_ACCT_NO_OCI
AND B.SERV_CDE_OCI = BB

8
Vantage ACP Tables
Order Tables
OOR_ORDER_OPEN
Corresponding legacy table is WOO_BASE_OPEN
OCR_ORDER_COMP
Corresponding legacy table is WOC_BASE_COMP
OTR_TROUBLE_CALL
Corresponding legacy table is TBC_BASE

Common fields to join the OOR, OCR, and OTR are -
CUST_ACCT_NO_XXX
ORDER_NO_XXX corresponding legacy field is the
WO_KEY_XXX



9
Vantage ACP Tables

Job Tables
OJB_JOBS
This table contains information on scheduling and
technicians associated with a particular job.

Main fields contained in the table
Job completion information
Bill start/stop information
Scheduling times/units
Dispatch information
Custom fields




10
Vantage ACP Tables
Job Tables continued

OJA_JOBS_ALT_ADDR
This table contains information about jobs containing an
address other than the bill-to address.

Main Fields contained in this table -
Alternate Address
Alternate City, State, and Zip
Alternate Name for mailing purposes.


11
Vantage ACP Tables


Item Tables
OPI_OPEN_ITEM contains information about a
customers services that currently have changes pending
through an order.

OHI_HIST_ITEM
This table contains information on all of the services
previously stored on pending and current tables (e.g.,
OCI_CUR_ITEM and OPI_OPEN_ITEM tables)





12
Vantage ACP Tables

Item Tables continued
OBI_BASELINE_ITEM
The OBI_BASELINE_ITEM provides a more accessible
way for you to identify items that are active at the account
customer-location levels at the time you add or remove
another item. It provides a snap-shot of the customer-
location items after you add or remove items. (CSG is
retaining two years of historical data on this table in
Vantage.)
Benefit: The OBI_BASELINE_ITEM table allows you to
view your customers items at a given point in time. This
provides the ability to measure the effectiveness of cross-
sells and up-sells. In addition, you can analyze the items
that a customer or account had when you downgraded or
upgraded particular items.

13
Vantage ACP Tables
Optional Tables

Auditing Order and Jobs (replaces WOA)
OAJ_AUDIT Job Audit Table
OAO_AUDIT Order Audit Table

14
Vantage Columns (cont)
Indexes
Indexes allow database to rapidly and efficiently
locate specific records rather than examining each
row in a table
Indexes are placed on frequently used columns such
as
Customer Account Number
Subscriber Account Number
Order Number
Job Number
House Key
Equipment Serial Number

15
Vantage Columns (cont)
Joins
Necessary when data is in different tables
Like data fields, (Cust Acct No, Sub Acct No,
Order Number, House Key) are join candidates
Use column 5 on table layouts to determine join
candidate fields

NOTE: When linking some tables together, more than
one join may be required. Example: ALA, PKS, EQS,
OCI, OHI & OPI. Please contact your Information
Specialist if you are unsure of how many joins to use.

16
Joins
Many queries will contain 2 or more Vantage
tables
Tables are joined by comparing like columns
in each table
Example
CUST_ACCT_NO_SBB = CUST_ACCT_NO_OCR
ORDER_NO_OCR = ORDER_NO_OHI
SUB_ACCT_NO_SBB = EQP_LOCAL_EQP

17
Join Example 1
Select RES_NAME_SBB, ADDR1_HSE, RES_CITY_HSE,
RES_STATE_HSE, POSTAL_CDE_HSE
From SBB_BASE, HSE_BASE, CHX_CUS_HSE
Where HSE_KEY_HSE = HSE_KEY_CHX
AND CUST_ACCT_NO_CHX = CUST_ACCT_NO_SBB
AND END_DTE_CHX = '0001-01-01'
And EXT_STAT_SBB =
And MGMT_AREA_HSE = 01


Shows active accounts that reside in management area 01

18
Join Example 2
Select DISTINCT RES_NAME_SBB, SALESREP_OCR
From SBB_BASE, OCR_ORDER_COMP, OHI_HIST_ITEM
Where CUST _ACCT_NO_SBB = CUST_ACCT_NO_OCR
And ORDER_NO_OCR = ORDER_NO_OHI
And SERV_CDE_OHI = IA
And DELQ_AMT_SBB > 0
And EXT_STAT_SBB =
And LS_CHG_DTE_OCR > 2004-03-01


Shows active accounts who connected after March 1, 2004, had
install code IA on the connect Order, and are delinquent

19
Join Example 3
Select SUB_ACCT_NO_SBB, HOME_PHONE_SBB
From SBB_BASE, OCR_ORDER_COMP
Where CUST_ACCT_NO_OCR = CUST_ACCT_NO_SBB
And ORD_STAT_OCR = C
And LS_CHG_DTE_OCR Between 2004-01-01 and 2004-03-31



Shows all account records that had an Order completed between
January 1 and March 31, 2004.

20
Top ACP Vantage Data Columns

21
1. ORDER_NO_OCR, OOR, OTR, OJB, OCI, OHI, OPI
The Order number is a key field for all Orders, Job and Items tables
because it is used to join these tables to each other.
Each ACP Order that is generated will be assigned a unique 16 digit,
alpha-numeric order number.
In CSG there is a Last Number Used file, used by all ACP clients which
generates Order numbers. The Order number is a randomly generated
sequential number. Random because the order number does not relate
to anything such as house key, zip code, account number, etc.
Sequential because each order number coming out of the last number
used file will be incremented by one from the previous order number that
was generated. There are approximately 900 billion possible order
numbers.
Due to the way the order numbers are generated and used across all
ACP clients, it is unlikely that you will see two sequential order numbers
on a single account.
Example: ORDER_NO_OCR = ORDER_NO_OHI
ORDER_NO_OTR > ORDER_NO_OCR
22
2. JOB_SEQ_NO_OJB, OCI, OHI, OPI
The Job sequence number is a key field for the Job
and Items tables. It is a 7 digit numerical field.
There can be multiple jobs on a single order, and the
possibility of multiple items on each job. When the job
and item tables are properly joined, using the job
sequence number, it keeps each item in the Items table
correlated to the specific job in the Jobs table.
If an Item did not have a Job associated with it
because a technician was not required, the default
value of 0 will be displayed in the job sequence
number field for that item.
23
3. ORD_RSN_OCR, OOR, OTR
Contains an 8 character alphanumeric field
Contains up to 4, 2 character Order reasons
Must use the Substring function when used as part of
the Where Clause
Example
SUBSTR(ORD_RSN_OCR,1,2) = 20
SUBSTR(ORD_RSN_OTR,3,2) = BP

24
4. COMPL_CDE_OCR, OOR, OTR
Contains a 18 character alphanumeric field
Contains up to 6, 3 character completion codes on an
Order
Must use the Substring function when used as part of
the Where Clause

Examples
(SUBSTR(COMPL_CDE_OCR, 1, 3) = 100 or
SUBSTR(COMPL_CDE_OCR, 4, 3) = 100)

25
5. CREATE_DTE_OCR, OOR, OTR
Contains the date the Order was created and entered
into the system
Field set by ACP system, cannot be modified from
terminals
Example
CREATE_DTE_OOR = TRUNC(SYSDATE) -1
CREATE_DTE_OTR >= 2004-05-01

26
6. DUE_DTE_OCR, OOR, OTR
Contains the date the Order is scheduled to be
worked if there is no Job.
If there is a job, the Due date defaults to the
scheduled begin date of the job.
Will be 0001-01-01 if the Order is unscheduled.
Example
DUE_DTE_OOR >= TRUNC(SYSDATE) - 7
27
7. SALESREP_OCR, OOR, OTR, OCI, OHI,
OPI
Contains the sales representative number
associated with the order or item.
Alphanumeric field.
Example
SALESREP_OCR Between 12000000 and 13999999
NOTE: The SALESREP column is an 8 character
alphanumeric field and requires the use of tick
marks when used in a query. Please note that
your system may not use the full 8 characters.
Vantage does not pad the Salesrep field out to
the full 8 character length.
28
8. CAMP_CDE_OCR, OOR, OTR, OCI, OHI,
OPI
Contains a 3 character alphanumeric field
Contains the campaign code associated with the
Order or Item.

Example
CAMP_CDE_OCR = HHH
CAMP_CDE_OPI = SHO

29
9. LS_CHG_DTE_OCR, OOR, OTR, OJB,
OCI, OHI, OPI
Contains the date of the last change made to the
Order, Job, or Item
Field set by ACP system, cannot be modified from
terminals
Use this field when trying to write queries that tie
back to ACP production reports
Is an indexed field
Example
LS_CHG_DTE_OCR Between 2004-02-22 and 2004-03-21
LS_CHG_DTE_OJB > TRUNC(SYSDATE) 3

30
10. COMPL_DTE_OCR, OOR, OTR, OJB
Contains the date the Order/Job was completed
Entered by CSR when closing the Order and can be
backdated up to 30 days
Automatically defaults to current date if not entered by
CSR
Example
COMPL_DTE_OCR between 2004-03-01 and 2004-03-31
COMPL_DTE_OJB >= TRUNC(SYSDATE) 7

31

11. ORD_STAT_OCR, OOR, OTR

Contains the Order status
Different Values exist in different tables

C Completed OCR/OTR Tables
O Open OOR/OTR Tables
X - Cancelled OOR/OTR Tables

Example
ORD_STAT_OOR = O
ORD_STAT_OTR NOT IN (O,X)

32

12. ORD_CLASS_OCR, OOR, OTR

Class of the Order
Valid Values:
S - Service Order: Connect, Reconnect, Restart,
Change of Service, Disconnect
T - Trouble Call
M - Special Request: Verify service,
Pickup Equipment, Bury Drop, etc.
Example
ORD_CLASS_OCR = S
33
13. JOB_CLASS_OJB

Class of the Job
Valid Values:
C Connect
D Disconnect
R Restart
S Service Change
T Trouble Call
Z Special Request
Example: JOB_CLASS_OJB In (C,R)
Note: Not all Orders will have a job associated with them.
34
14. IR_TECH_OJB
Contains the technician code on the Job. Order
tables do not contain the technician code.
Alphanumeric field
Example
IR_TECH_OJB Between 11000000 and 11999999
IR_TECH_OJB = 38097063
NOTE: The IR_TECH column is a 8 character
alphanumeric field and does require the use of tick marks
when used in a query. Please note that your system may
not use the full 8 characters for IR_TECH_OJB. Vantage
does not pad the technician field out to the full 8
character length.
35
15. JOB_TYP_OJB
Indicates the type of Job
Determines connects, restarts, reconnects,
disconnects, upgrades, downgrades, special
requests
Code Table CTD-32 describes Job Types
Example
JOB_TYP_OJB In (NC,RC,RS)
JOB_TYP_OJB In (VD,NP,UP)
JOB_TYP_OJB In (TC,FN)

36
16. JOB_STAT_OJB
Contains the status of that Job on the Order
Possible Job Status values:
C Completed as Ordered
D Completed Different than Ordered
H Held
O Open
R Rescheduled
X Canceled

Example
JOB_STAT_OJB = C
37
17. ITEM_STATUS_OCI, OHI, OPI
Item status is a 1 character, alpha-numeric field.
In the Current Items table, the current status of that
item will be displayed.
In the Historical Items table, the status of the Item as it
relates to the Order will be displayed.
In the Pending Items table, this field will display the
current status of the Item as it awaits a pending
change.
Possible values: Space, A,B,C,H,O,P,R,X.
Where table will you find a specific status in?
OCI_CUR_ITEM: C,R
OHI_HIST_ITEM: B,C,O,P,X
OPI_OPEN_ITEM: Space, A, H
38
18. ITEM_STATUS_OCI, OPI, OHI (contd)
Item Status and Descriptions
Space: Pending connect/disconnect items that require manual intervention
to complete. A truck roll is required. Tech has to do something.
A: Auto-Provisionable. Pending upgrade/downgrade items that can be
completed by an addressable controller. No technician required.
B: Billing Change. Current items with pending billing changes such as a bill
code, discount code, and account number changes.
C: Current Item. This item status represents the current state of billing and
non billing data.
H: Held. Completed items that are held from the Current Item file.
O: Other Change. Current items with pending non-billing changes such as
outlet changes.
P: Provisioned Items. Completed upgrade/downgrade items. All required
provisioning has been completed.
R: Restart Item. These items are used during an account restart. They will
only be found on the Current Item file.
X: Cancelled Item. This status will only be found in the History Item file.
39
19. SERV_CDE_OCI, OHI, OPI
Contains a single, 5 character ala carte Item code
Examples
SERV_CDE_OCI = HB
SERV_CDE_OCI In (HB, CX, DS, MC)
NOTE: In ACP, each service code (item) can be displayed multiple times,
equivalent to the quantity of that item. If a subscriber has 3 DC digital
converters on their account, there will be 3 lines of DC, each with a quantity of
one. In the case of bulk charge Items, those will normally have only one line
and will have a quantity > 1.
Additionally, for Items on Orders, ACP displays the items along with their billing
codes, no matter what their ala-carte or package status is. Items are always
broken out on the Order, auto-packaged or not, which was not always the case
in the legacy work order system.
For OHI/OPI Items tables, this column displays Items present on the Order.
Only those Items which are being affected on that order will be displayed in the
OHI and OPI tables. Install items are found in this column
Example: SERV_CDE_OPI = BA
40
20. BILL_CDE_OCI, OHI, OPI
Contains billing/package code on the account that
is associated with the ala-carte item code.
Examples
BILL_CDE_OCI = XX
BILL_CDE_OHI In ( BT, D4, K2, S5, XD )
ACP displays billing/package codes only in the
BILL_CDE_OCI/OHI/OPI column. ACP always breaks
down the package codes in the Items tables, no matter what
the package/auto-package status is. In legacy, a non auto-
packaged code would display in both the service code and
billing code columns. ACP does not allow that. This makes
it much easier to see which components were added without
joining to the package tables to break out components.
41
21. DSC_CDE_OCI, OHI, OPI
Identifies a permanent or temporary discount
code associated with a specific Item
Discounts are alphanumeric
Discounts can be up to five characters

Example
DSC_CDE_OHI = 36

42
22. BEF_QTY_OCI, OHI, OPI
For the Current Items tables, the BEF_QTY_OCI will
be either 0, 1, or in the case of bulk services may be
greater than 1.
For Historical and Open Items tables,
BEF_QTY_OHI/OPI will contain the quantity of each
Item on an order
> 0 if Item is present before Order
= 0 if Item is not present before Order

Example
BEF_QTY_OHI > 0
and SERV_CDE_OHI = SH

43
23. AFT_QTY_OCI, OHI, OPI
For the Current Items table, the AFT_QTY_OCI will display
the quantity of the Item on the account, and will = 1, or in
the case of bulk services may be greater than 1.
For Historical and Open Items tables, AFT_QTY_OHI/OPI
will display the quantity of each Item on an order
> 0 if Item is present after the Order
= 0 if Item is not present after Order
Example
AFT_QTY_OHI > 0
and SERV_CDE_OHI = AO
NOTE: When a customer disconnects, the AFT_QTY_OHI for
each Item on the Order will remain as it was prior to the Order.
For Disconnect Jobs, the AFT_QTY_OHI does not go to 0.