Singleview Operations Guide
Singleview Operations Guide
VERSION: V0.1
FDATE: 26 Nollaig 2024
STATUS: For Review
Copyright ©2021 CSG Systems International, Inc. and/or its affiliates (“CSG”). All rights reserved. The information contained within this document is
the property of CSG, which is confidential and protected by international copyright laws and any unauthorized use of this document or its contents
may violate copyright, trademark, and other laws. No part of this document may be photocopied, reproduced or translated in any form or by any
means, or stored in a retrieval system or transmitted electronically or otherwise, without the prior written consent of CSG.
SYNERGY
SINGLEVIEW OPERATIONS GUIDE
COPYRIGHT
Copyright © 2021 CSG Systems International, Inc. and/or its affiliates (“CSG”). All rights reserved.
DISCLAIMER
The information contained within this document is the property of CSG, which is confidential and protected by
international copyright laws and any unauthorized use of this document or its contents may violate copyright,
trademark, and other laws. No part of this document may be photocopied, reproduced or translated in any
form or by any means, or stored in a retrieval system or transmitted electronically or otherwise, without the
prior written consent of CSG.
If you breach any of these terms, your authorization to use this document automatically terminates. You may
not modify this document or its contents in any way or publicly display, perform, or distribute or otherwise use
this document or its contents for any public or commercial purpose. Any use of this document or its contents
for any other purpose other than as mutually agreed upon with CSG is prohibited.
Although every endeavour has been made to ensure that the information contained within this document is up
to date and accurate, CSG cannot be held responsible for any inaccuracy or error in the information contained
within this document. CSG makes no warranty of any kind with regard to the information and CSG shall not be
liable for any direct, indirect, incidental or consequential damages which may arise in connection with the
furnishing, reliance or use of the information contained within this document.
Specifications and statements as to performance in this document are CSG estimates, intended for general
guidance. CSG reserves the right to change the information contained within this document and any product
specification and/or availability dates without notice.
Statements in this document are not part of a contract or program product license. Issue of this document
does not entitle the recipient to access or use of the products described, and such access or use shall be
subject to separate contracts or licenses.
TRADEMARKS
CSG® is a registered trademark of CSG Systems International, Inc., and all associated designs and trade names
are trademarks of CSG Systems International, Inc. and/or affiliate companies.
All third party trademarks, service marks, and/or product names which are referenced in this document are
the property of their respective owners, and all rights therein are reserved
The Singleview Operations Guide for Synergy provides production, environment and operations
support information required for the successful operation of Singleview.
Included in this guide is reference information pertaining to how each operational area is to be
managed along with the proposed method of operation by Synergy. The areas include: Rating,
Billing, Batch Payment (Direct Debit), Financial Data (GL) Extract, Maintenance and
Troubleshooting information.
This guide should be used in conjunction with the Singleview Operations Guide and System
Reference Guide provided in the product documentation pack. A number of other Singleview
product documents are referenced which provide additional detailed information relevant to
operating the Singleview product.
Note that the responsibility of the operational plan/schedule for Singleview resides with service
provider and as such this document is a general guide to assist the setup of Singleview for
production operations. Service provider will need to consider the frequency, timing, performance
parameters and dependencies of tasks to be executed in production according to their business
processes. As such, this document should be considered a starting point from which service
provider can supplement and enhance to suit their specific operational needs.
2.1 Audience
The guide is intended for the users who will administer Singleview and for the teams that will
assist them in setting up and running the system.
2.2 Prerequisites
The reader of this document is expected to be aware of the Synergy Singleview functional solution
(as described in the Feature Description Document [Error: Reference source not found]) and have
access to the Singleview Product Documentation listed in the References section below. Those
responsible for administration and running of the Singleview application should also have
attended product training, in order to be familiar with the fundamentals of the various
components of the application. In particular, the Singleview Operations Application Administration
training course is a useful reference for common Singleview operations tools and commands.
2.3 References
Ref Description
1. System Administration Guide for Singleview 11
11. Installation and Integration Guide for Singleview Web Services Adapter 11
12. Business Data Management with Business & Administration Studio
The Singleview product documentation referred to in the References table above is supplied to
service provider as a zipped file package. Updated product documentation will be supplied with
Singleview software releases. We recommend that service provider share the Singleview product
documentation from a central location so that all service provider’s Singleview users will have
access to the latest version. Relevant product documentation (Online Help) is also available via
the ‘Help’ button on the Singleview GUIs.
Term Definition
API Application Programming Interface
ASM Oracle’s Automatic Storage Management
BAS Business & Administration Studio
BE Billed and Earned revenue
BGP Bill Generation Process. A TRE server (trebgp) that generates billing data based on the costed event
records output from the rating engine and customer details extracted from the database.
BIC Bank Identiification Code
BKR Event Rating Broker Process. Controls the overall rating process and monitors the server processes
used during event rating (i.e., ENM, ERT, ERO). Also manages shared memory for database cache and
inter-process communication.
BMP Background Monitor Process.
BSS Business Support System
BUE Billed and UnEarned revenue
CB Convergent Billing. Singleview Billing application.
CM Customer Management. Singleview customer/case management (CRM) application.
CM (PE) Web The web server based presentation layer of the Customer Management solution.
CPL Extract to Credit Bureau
CPU Central Processing Unit.
CSR Customer Service Representative
CSV Comma Separated Values
DA Derived Attribute tables, used to store business or operational lookup data
DB Database
DBA Database Administrator
DNS Internet Domain Name Server.
DVP Database Validation Process. A tool used for validation and integrity checking of the CB database.
The DVP identifies problems of data consistency.
E// Ericsson
EFT Electronic Funds Transfer
ELK Elastic Search, Logstash and Kibana
EMM Ericsson Multi Mediation
ENDO Enhanced Debit Orders
ENM Event Normalization Process. A server process responsible for reading event records (raw event
data) from nominated input files, normalizing those records, and forwarding the resulting normalized
event records to the Event Rating (ERT) process for rating.
EPM Expression Parser Module. Parses and executes expressions. Used to make comparisons, validate
input, and calculate values. The EPM provides a number of built-in functions, including mathematical,
type conversions, string processing, date functions, subtotal history, invoice data, and format
automation.
ERO Event Rating Output Process. A server process that outputs charges, normalized events, and file
Term Definition
information from the rating engine into the database.
ERP Enterprise Resource Planning
ERT Event Rating Process. A server process that receives normalized events from the Event
Normalization (ENM) process and rates the events to generate charges that are passed to the Event
Rating Output (ERO) process for output.
EVS Entity Validation Server. Makes Singleview CB entity validation rules available to remote API’s.
FTP File Transfer Protocol. File-sharing protocol that allows users to transfer text and binary files to and
from servers.
FTS File Transfer Subsystem: a framework within Singleview used to configure and control outbound file
transfers.
GL General Ledger
GOP General Output Process. A server process that manages the printing of images (usually invoices)
generated by bill runs. Controls the selection, sorting, and output of images.
GUI Graphical User Interface.
HA High Availability
ICCID Integrated Circuit Card Identification Number. Unique identifier for a SIM card.
IGP Invoice Generation Process. A TRE server (treigp) that formats invoices and statements by
substituting billing data into a rep-defined invoice template.
IO Input/Output. Term used when discussing the movement of data onto and off the Unix server as well
as into and out of the database.
IP IP address
MI Multi Instance
MSISDN Mobile Station International Subscriber Directory Number
MTC Mobile TeleComs
NGVS Voucher Management System
OCS Online Charging System
OLTP Online Transaction Processing. Includes transactions like creating and maintaining customers,
processing orders and processing various queries like balance enquiries and transaction history
queries.
One Off Task A one off task is an operation which executes a Schedule Type once, at a specific time/date e.g. now.
Oracle XA Oracle XA is Oracle’s implementation of the X/Open Distributed Transaction Processing (DTP) XA
interface. The XA standard specifies a bi-directional interface between resource managers (like Oracle)
that provide access to shared resources within transactions, and between a transaction service that
monitors and resolves transactions.
Oracle XA (API) is used to enable an Oracle database to interact with a transaction processing (TP)
monitor such as Tuxedo.
PDF Portable Document Format
PE Process Engine. The Singleview Process Engine application, on which Customer Management is built.
This application handles the retrieval, processing, validation and update/storage of customer
information in the server architecture.
POP Point of presence
POS Point of Sale
PS PostScript
QA Quality Assurance
QC Quality Check
RAC Real Application Clusters
REST Representational State Transfer
RGP Rental Generation Process. A TRE server (trergp) that provides the services for generating
normalized events for recurring and one-off charges, such as line rental, handset rental, and frequently
used number plan fees. The rating engine then rates the normalized events generated by the RGP.
The RGP is also used to adjust recurring charges that were generated during a previous billing cycle.
Term Definition
Adjustments may be required to correct charges made for periods where services were unavailable or
cancelled.
Schedule A Schedule is a timed operation which executes a Schedule Type at a specific interval e.g. once per
day, one per month, etc.
Schedule Type A Schedule Type in Singleview defines a type of job e.g. rating files, billing charges, generating general
ledger files, clean up old log files, etc. Schedule Types are utilized by the Operation team to create
schedules and one-off tasks.
SDP Service Data Point, a component of the Ericsson charging system which maintains balances and
subscriber information
SEPA Single Euro Payments Area
SMPP Short Message Peer-to-Peer Protocol
SMS Short Message Service
SNMP Simple Network Management Protocol
SOAP Simple Object Access Protocol
SQL Sequential Query Language. A standard data definition and manipulation language for relational
databases.
STD Scheduled Task Dispatcher. This is known as the Singleview scheduler. The scheduler supports
defining tasks to run run as one-off tasks or as repetitive tasks.
STONITH Shoot The Other Node In The Head. A mechanism to ensure that only one node performs a particular
operation.
SV Singleview
TCP/IP Network Communications Protocol.
TCP - is responsible for verifying the correct delivery of data from client to server.
IP - is responsible for moving packet of data from node to node.
TDR Transactional Data Record
TLM Task Launch Monitor. This Singleview process is responsible for launching and monitoring
operational tasks in Singleview.
TRE Transaction Engine. The TRE is the middle tier of the open, n-tier architecture of Singleview CB that
is based on Tuxedo middle ware. The TRE contains a comprehensive set of functions that are organized
around logical entities in the system (e.g., customer, product, payment), that readily allow search,
view, update, and delete access to these entities in the system. Although the Client and Server
processes to access data in the database use this layer internally, it has also been exposed for external
use via a fully documented API (e.g., Perl, Java) that allows any external system to access the database.
WAN Wide Area Network.
3 Operations Planning
The business tasks, housekeeping tasks, CSR activities and other interfaces interacting on the
production server need to be planned and organised. Activities should be coordinated to prevent
conflicts with server resources and to ensure optimal performance from the environment is
maintained over time. Scheduling should ensure that Singleview delivers required files and
information for efficient running of service provider’s business processes e.g. bill run completion,
General Ledger file extracts, etc.
3.1 Operations Scheduling Overview
The tables below introduces some typical operational processes to be run in the production
environment together with the user group responsible for running that process.
The operations are grouped based on their function within the end-to-end billing life cycle. The
table indicates whether each task is a one-off task, a scheduled recurring task or whether it is a
manual activity.
Where it is appropriate, the Singleview schedule type that would be used for each step is listed in
the table.
Note: The full list of schedule types/activities are covered in section 5 of this document. Each
schedule/activity is documented in more detail within that section. This section provides only a
summary of some production activities, in the order they would be performed, as an example.
2. Post rating QA - Check task results for rating summary - to Execution method: Manual.
checks verify the file names and the count of files
processed. Frequency: Daily
- This data could include Product Offers, DA Owner: Finance, Operations, etc.
tables, reference types and GL entities.
4. Extract Changes - A controlled release process should be Execution method: Manual
from Master followed to test and promote the reference
environment data changes (i.e. Use of a reference data Frequency: Ad-hoc
environment, data repository, etc.). Owner: Operations/Infrastructure
Stages Details Task Execution
5. Test table - Promote the release of reference data into a Execution method: Manual
changes pre-production environment and perform
testing. Frequency: Ad-hoc
Owner: Test team/
Operations/Infrastructure
6. Promote - If changes test successfully then the data can Execution method: Manual
Reference Data be promoted into the production system.
Frequency: Ad-hoc
Owner: Operations/Infrastructure
There are three nodes defined in the Singleview cluster. All nodes are active and will be
performing operations.
A total of six customer partitions are configured and assigned to Singleview instances. (Initially;
partitions 1 and 4 to SV1, 2 and 5 to SV2, 3 and 6 to SV3).
Pacemaker is deployed as the cluster manager for Singleview and will perform necessary actions
required during instance failures.
A Layer 7 Load Balancer is the load balancer for distributing the HTTP/HTTPS PE Web requests
between the three PE web servers. PE Web servers will be connected to the PE instance in the
cluster via the PE Virtual IP.
External Systems that are sending API requests (SOAP and REST APIs) will interact with Singleview
application nodes via the PE Virtual IP or Layer 4 Load balancer.
External Systems that are transferring files to Singleview will do so via the Layer 4 Load balancer
or the PE Virtual IP.
4.2 Directory Structures
This section describes the base directory structure to provide a map to navigate around the
server filesystem.
$ATA_HOME
|
+-----------+----------------------|--------------------------+--- ...
| | | |
rel product imp data
| | | |
| | +-------|-------+ +------|-----+
+->11.06.x +->QCM_YY_ZZ | | | | |
rel product loc client server
|
+-> 1.0
Directory Purpose
rel Symbolic link that points to the current product version that is installed under the sv directory. This is
where the product Singleview application code resides.
The contents under the rel directory should never be modified. Any modifications will be lost when
the environment is upgraded to a new product release when the symbolic links are switched to point
to a new product directory tree.
product Contains a sub-directory for each Client release installed. Each sub-directory is a full listing of all code
for that release.
imp This is the directory tree for Client specific CB implementation code or modified product scripts.
imp/rel Symbolic link that points to the current Client specific configuration release that is installed under the
imp/product directory.
The contents under the rel and imp/rel directories should never be modified. Any modifications will be
lost when the environment is upgraded to a new product or custom release when the symbolic links
are switched to point to a new directory tree.
imp/product Contains a sub-directory for each customized Client release installed. Each sub-directory is a full
listing of all customized components.
imp/loc Used only for temporary product patches or product processes that have been modified for Client.
data This is the working directory for the Singleview CB application. This directory is static, it is not
refreshed or replaced during upgrades or release installations. This is where all inputs into the
Singleview application are processed from and all outputs from Singleview applications are placed.
(e.g., traffic feeds are placed here, log files written to, and various invoice outputs are placed here.
The contents of these directories will grow daily and depending on the level of tracing or reporting
being used, the contents of these directories can become quite large. The maintenance tasks required
to manage this space as well as the manual tasks required are detailed in further sections of this
guide.
data/client The content of the data/client directory includes the client executable, help, and error message from
the product releases.
data/server The content of the data/server directory includes product directories for traditional CB processes as
well as new directories for Client customized processes. The directories that should exist under the
data/server structure are specified in the following section.
4.2.2 Work Directories
This area is considered the operational working area of the Unix server. The majority of the server
IO (inbound and outbound file transfers) will occur in these directories.
+
|
data
|
server
|
+-------+-----+--------+---------+---------+--------+-------+--------+-----+----
| | | | | | | | | |
input error log archive invoices config build reports loader output
These directories either contain files to be processed within Singleview or contain the outputs of
Singleview operations. These areas will need to be monitored carefully during heavy operational
periods to identify any IO bottlenecks. Available disk space also needs to be monitored. It is
recommended that the archive directory (where successfully processed files are archived) is
backed up as necessary and cleaned up regularly.
The table below provides a summary of each of the top level working directories under the
/data/server directory.
Directory Purpose
archive Where successfully rated traffic feeds and RGP files are placed.
build If rating is configured to write charges and event records to files instead of inserting directly into
the database, then the files are placed in this directory. These files can then be loaded into the
database at a later time. This option will not be used by Client.
config Where executable versions of Tuxedo configurations and database configurations are generated
from the configuration files in this directory.
error Where corrupt or filtered events from traffic feeds are written to this directory.
input Where traffic feeds and RGP event files are rated from this directory.
invoices Contains directories for building temporary images for viewing in the GUI or contains directories for
printed invoice image files that are FTP’d to print vendors and other destinations.
log This contains many log files for server processes and Tuxedo. Trace files or debug files are also
written to this directory. Whenever the archiver is run through the GUI, the archived files are
placed in the log directory.
reports Generally used as the location for building report images to be viewed through the GUI.
output Other file output generated by Singleview is created under the output directory. Files which are to
be transferred to external systems (e.g. invoice images) are created in subdirectories of /output.
4.3 Creating Schedules and One-Off tasks
Schedules support running tasks at specific times and frequencies in Singleview. Schedules are
typically used to manage all billing tasks such as the rating of events, and the preparation and
printing of invoices. Tasks can be set up to run automatically at predefined intervals or at a
specified time and date. The schedule definition is determined in part by the associated
Schedule Type.
The following table describes the components of the Schedule task form.
Task Generation Preschedule Count Displays the number of tasks that must be
scheduled in advance at any time. This must
be greater than 0
Baseline Duration Displays the expected duration of tasks of this
schedule in seconds.
Maximum Displays the maximum permitted duration of
Duration tasks of this schedule in seconds. If the task
has not completed, it is terminated. If a
maximum duration is not specified, the task is
not terminated before it completes.
Purge Period Displays the maximum number of days for
which any temporary data associated with a
task of this type will be kept.
Task Updated to If option is set, then the tasks that are runable
Held Status will be initially updated to a 'Held' status and
need to be submitted explicitly at a later point
of time.
Do Not Generate If option is set, then tasks whose calculated
tasks that are SCHEDULED_START_DATE is less than the
already overdue. current date and time are automatically
suppressed and not created by the scheduler.
Pending Task If the 'Pending Task Generation' option
Group Box is set, then this schedule has pending
tasks that need to be generated or re-
generated. This checkbox is read-only.
The 'Pending Generation Schedule'
field displays the schedule that has
stalled task generation for this
schedule. This field is read-only.
The 'Details...' button will allow the
viewing of the schedule of the pending
task. This will open in a new window.
Parameters Tab Parameters The contents of the Parameters tab are
controlled by Entity Validation associated with
the schedule's Schedule Type.
Additional Server Contains additional arguments that will be
Arguments added to the server command when it runs.
Prerequisites Tab Prerequisites Contains schedules whose tasks are
prerequisites for the tasks associated with this
schedule. This tab gives the user the ability to
manage the prerequisite schedules for this
schedule. The 'Search' and 'Assign' buttons
can be used to add prerequisite schedules
Fail on A task associated with this schedule will be
Prerequisite updated to Failure if one of its prerequisite
Failure tasks fails
Start Task If option is selected, then this schedule will
Immediately start immediately after the prerequisites have
been met. This field may be checked even if
no prerequisites are specified.
One-Off Tasks
One-Off tasks are used on an Ad Hoc basis when the exact time and parameters required for the
task may not be known. One-off tasks also use a Schedule Type definition, but execute that
schedule type once only.
The following table describes the components of the On-Off task form.
The spreadsheet embedded below details the schedules which have been configured for loading
on the production environment. This package of schedules is provided as a reasonable starting
point for service provider to run the Singleview system. Service provider may need to create
additional schedules to meet their needs. The delivered schedules cover a number of functional
areas: event processing, billing, direct debit, partition maintenance, monitoring, etc. and support
the file transfer solution for batch (file based) interfaces.
The schedules provided are not set up to execute immediately. They are set up as ‘future dated’
so that they can be initiated as required to automate operational activities. In some cases, the
schedules will typically be executed manually, but the schedule is provided anyway for reference,
for correct parameters, etc.
Further details of the schedule types used can be found in section 5 of this document, and in the
Singleview Product Documentation.
Singleview Operations Guide
Note: in the examples shown below, attribute values are for illustrative purposes only.
Refer to the Reference Data Guide for additional information regarding reference data.
Reference data in Singleview generally refers to data for the following entities:
Product Offers
Derived Attribute Tables (Tables)
Reference Types (Lists)
GL Codes and GL Guidances
Configuration Items (Settings)
CSG has set up a reference data maintenance environment, specifically for the purpose of
maintaining reference data. In this environment, service provider will access Singleview via the
Business and Administration Tool in order to review, update and add reference data as required
(e.g. to roll out a new product, change pricing, add new items to lists, etc.)
A number of Singleview tools are used to export the updated reference data to target
environments:
rt_dump/rt_load: these tools are used to export and import reference type data (csv files)
da_dump/da_load: these tools are used to export and import DA data (csv files)
BAS: The GUI may be used to export and import product offers (in XML format)
5.2 Rating
Singleview will process pre-rated usage events received from the online charging system via
Mediation. Singleview does not calculate charges for such events, but will store the pre-charged
amount and other details, to support GL reporting, postpaid balance management, postpaid and
prepaid inquiry via the CRM GUI and invoice generation. This is referred to as ‘pass-through
rating’ in Singleview.
Note that the configuration item name should be no more than 22 characters long to ensure that
generated item names don't exceed the database constraint of 30 characters.
Configuration items are delivered to generate rating streams as required for the Service Providers
usage sources on production.
5.2.2.1Description
This schedule type processes inbound event files, validates the file and records, normalizes the
event and stores it in the Singleview database as a Normalised Event. It also generates a Charge
record for each successfully processes Normalised Event. Events which fail in rating as stored as
Normalised Error Events so errors may be investigated, resolved and events reprocessed as
required.
5.2.2.2Usage Sources
The following table lists the different sources of usage to be processed by Singleview and the
configuration item used by the event normalization process.
The Mediation system will place the usage file in HOME_DIR of below configuration items. The
schedule type “Multi Instance Rate Files” can be submitted manually as One-Off task to process
usage files in these directories. Typicaly, “Multi Instance Rate Files” will be scheduled to run
periodically, e.g. every hour, to process each stream.
Event Stream Config Item ENM Set File Type Event Type
E// Mobile CDRs A_MIBRS_EMM (B/C) MI EMM USAGE Wireless Mediation Wireless
E// Mobile TDRs A_MIBRS_TRX (B/C) MI EMM TRX Trx Event Mediation Trx Event
5.2.2.3Schedule Setup
Multi-instance Instance List Null or specifically the active SV node instance (ex SV1)
Name
ENM Set List The set of ENMs to process this event stream
File Pattern String The Unix file pattern to use to identify the input files
Event Source String Source from where event files are received (e.g. EMM_CDR).
ENM Timeout Period Integer The maximum time in seconds to allow for rating of each file before the
operation will time out. Value is defaulted to 3600 seconds
Singleview can have the below five active Multi Instance Rate Files schedules defined :-
Singleview Operations Guide
Click Save
e. If there is a count for Rating Error Event Count or Corrupt Event Count columns,
then double click on file to open
f. Click OK to proceed
Singleview Operations Guide
g. Click on the ‘Error Events’ tab. For each error event, the Details button can be
pressed to view the error message, or the row can be double clicked.
i. Alternatively, the following query (replacing the yellow highlighted filename with
the filename being researched) can be executed to get a list of all errors reported
for a particular file.
select NEF.FILENAME,NEE. C_PARTY_ID,NEE.CHARGE_START_DATE,
NEE.EVENT_SOURCE, NEE.CHARGE,NEF.TASK_QUEUE_ID,
NEF.RATED_EVENT_COUNT, NEF.RATING_ERROR_EVENT_COUNT,
NEE.ERROR_MESSAGE
from NORMALISED_EVENT_ERROR nee,
NORMALISED_EVENT_FILE nef
Singleview Operations Guide
Error ID <E00423>
Error Message tlm: Process for task 600000003603 terminated abnormally.
Error Cause Task completed with non-zero exit code, look at the task results if any
ORA error or any tuxedo error or any Internal rating error.
Action Consult with Platform Engineering team for initial look and PE shall
check with development support Level 3 team if any investigation
required and implementation bug found.
Error ID <E20031>
Error Message Invalid ENM process list specified. at
/syn/synxxxb1/rel/server/bin/rate_files line xxxx
Singleview Operations Guide
Error Cause Wrong ENM process used in the multi-instance rating scheduled task
Error ID <E02849>
Error Message Internal rating error
5.2.3.2Reference Documents
Reference Title
2 Singleview System Operations Guide
Multi-instance Instance List Null or specifically the active SV node instance (ex SV1)
Name
Normalized Event File Name String The name of the file that needs to be revoked
ENM Process List ENM with the home directory as the destination for the revoked
file.
Singleview Operations Guide
Click Save
5.2.3.5Error Handling
Error ID <E00423>
Error Message tlm: Process for task 600000003603 terminated abnormally.
Error Cause Task completed with non-zero exit code, look at the task results if any
ORA error or any tuxedo error or any Internal rating error.
Action Consult with Platform Engineering team for initial look and PE shall
check with development support Level 3 team if any investigation
required and implementation bug found.
Error Id <E06296>
Error Message The record for the file in NORMALISED_EVENT_FILE has a null
PROCESS_END_DATE.
Error Cause The file in the error is not rated successfully.
Action Wait till the file has completed processing. If the file must be revoked
without completing processing, set the PROCESS_END_DATE for the file
to a non-null value and try again.
Error Id <E06013>
Error Message Unable to move file <1:filename> to directory <2:Newdir>
Error Cause The file was unable to be moved since a file with the same name
already exists in the destination directory.
Action Either:
a) Do not move this file, OR
b) Remove or rename the file in the destination directory..
Singleview Operations Guide
5.2.4.2Reference Documents
Reference Title
2 Singleview System Operations Guide
Multi-instance Instance List Null or specifically the active SV node instance (ex SV1)
Name
Normalized Event File Name String The name of the file that needs to be revoked
Move back? List No/Yes indicator to determine if the file should be move the file back to the
appropriate input directory so it is available to be rated again
ENM Process List ENM with the home directory as the destination for the revoked file.
Singleview Operations Guide
Click Save
5.2.4.5Error Handling
Error ID <E00423>
Error Message tlm: Process for task 600000003603 terminated abnormally.
Error Cause Task completed with non-zero exit code, look at the task results if any
ORA error or any tuxedo error or any Internal rating error.
Action Consult with Platform Engineering team for initial look and PE shall
check with development support Level 3 team if any investigation
required and implementation bug found.
Error Id <E06296>
Error Message The record for the file in NORMALISED_EVENT_FILE has a null
PROCESS_END_DATE.
Error Cause The file in the error is not rated successfully.
Action Wait till the file has completed processing. If the file must be revoked
without completing processing, set the PROCESS_END_DATE for the file
to a non-null value and try again.
Error Id <E06013>
Error Message Unable to move file <1:filename> to directory <2:Newdir>
Error Cause The file was unable to be moved since a file with the same name
Singleview Operations Guide
This schedule type will reprocesses events in parallel streams for multi-instance cluster implementations,
allowing high volumes of events to be reprocessed in one operation, and supports rerating normalised events
that have rating subtotals associated with them.
Events are typically reprocessed in date order, but can be reprocessed out of order in certain
circumstances High Level Information
5.2.5.1Reference Documents
Reference Title
2 Singleview Systems Operation Guide
Multi-instance Instance Name List Null or specifically the active SV node instance (ex SV1)
ENM Set List Name of a set of ENM processes. ENM sets are configured in the
ENMSet derived attribute table. The ENM configuration item specifies
which set the ENM belongs to. The specified ENM set must contain at
least one ENM on each instance on which events will be reprocessed.
Default File Type List File format in which the events will be generated in the ENM's input
directory.
Example :-
CDR_Usage_Reprocess
File Process Start Date [Date] Start of the processing date range of normalised event files whose
events are to be reprocessed (inclusive).
File Process End Date [Date] End of the processing date range of normalised event files whose
events are to be reprocessed (inclusive).
Error Message Id [Text] Error message ID of the events to be reprocessed (if reprocessing error
events).
File Event Source [Text] Switch or mediation system that originated the events to be
reprocessed.
The ‘Where Clause’ statement can be used to improve refine the error
events for reprocessing therefore improving task performance.
Example :-
OR
normalised_event_id=36995430
Maximum Number of Events [Integer] Maximum number of events that can be reprocessed.
If the number of error events based on the selection criteria exceeds the
specified number, the schedule terminates and an exception is raised.
Event Adjust Function [Text] Name of function to call to modify or transform the events being
Singleview Operations Guide
reprocessed.
Cascade [List] If set to TRUE, events associated with the same customer hierarchies
as the specified events are reprocessed in addition to the specified
events.
Default is 1.
This option can only be set to FALSE if the Cascade option is also set to
FALSE.
Default is TRUE.
Default is FALSE.
For multi-instance clusters, events are processed on the relevant instance as determined by the
location of the associated customer partition. Processing is only performed on active instances
that contain customer partitions.
Reprocessing is parallelised by customer hierarchy. This schedule is unsuitable for reprocessing
large corporate customers or high volume services, unless the Reprocess in Order option can be
set to FALSE.
This schedule assumes that only the owning customer hierarchy is impacted by the reprocessing.
Inter-hierarchy configuration is not examined and hierarchies connected to the owning customer
hierarchy are not reprocessed.
The schedule fails if the set of events to reprocess includes events from normalised event files
associated with an export file.
It supports reprocessing normalised events that have rating subtotals associated with them, using
the Cascade option.
Events are reprocessed sequentially in CHARGE_START_DATE order in parallel processing sets;
therefore, this schedule is suitable for reprocessing large volumes of events.
Find and open the task related to the “Reprocess Error Events” schedule.
Verify that status of the task is ‘Success’ and that there are no errors reported in
the output.
2.Confirm event records processed by Reprocess Error Events task:
Select Server Tasks > Events > View Normalised Files and Events
Search Criteria: enter the reprocessed file name
Click the Search button.
Use the arrow key at the bottom of the window to scroll the data to the right so that
the columns Input Event Count, Normalised Error, Rating Errors and Corrupt Event
are displayed.
Multi-instance Instance List Null or specifically the active CB instance (ex SV1)
Name
Output File Path Text Directory where the extract will be generated.
Singleview Operations Guide
Click Save
5.2.6.4Error Handling
Error Id E00423
Error Cause The process for the specified task terminated in an abnormal manner
Action Use the task output to determine the cause of the abnormal termination, then correct
it. Example – SFTP target connection errors.
5.3 Billing
This section provides recommendations for managing billing in production. It outlines the order of
steps to be performed and some problem-solving guidance for each process.
The Service Provider can have multiple billing cycles to run each month (currently these can be
scehdueld to run for example on Month Day 14 and 28).
Processing of usage and transaction events and processing of SDP dump files should be complete
for the billing period, prior to executing the bill run for that period.
Singleview Operations Guide
There is no easy formula to use for streaming/tuning bill runs in production. The above factors
need to be assessed together to determine the best strategy for the day. Recommended values
will be provided by CSG as a starting point.
3. Check the task results and any obvious errors in the log.out file on the server associated with Billing
this QA bill run. Operations
4. Check the details of any failed customers in the QA run. Correct, revoke and rerun as Billing
necessary. Operations
5. View QA invoice images through the Singleview GUI. Revenue
Assurance
To view invoices online, go to the Accounts | Invoices menu item and perform a search on
the QA bill run ID. This will retrieve all invoices generated during the QA bill run.
6 Please ensure that QA Bill Runs are always revoked before Standard Bill Run. Billing
Operations
Singleview Operations Guide
Example:
When the pop up window is displayed; check all buttons and click Submit.
Singleview Operations Guide
5.3.3.2Pre-Billing Checks
Ste Details Responsibility
p
1. Ensure that any corrections needed as a result of the QA bill run (performed prior) have Billing
been done. Operations / QA
2. Ensure pricing tables are up to date. (recurring, activation, equipment, etc.) Reference Data
Management
A week before billing
3. Ensure that new phones sold via installment plan are configured and priced
correctly.
Refer to chapter 5.12.6.1 Sort Charge/Event Partitions. Verify that call CHARGE and
NORMALISED_EVENT partitions have been sorted up to previous day.
Validate RGP,BGP and IGP configuration item settings.
The following production setings are recommended but may change over time :-
Singleview Operations Guide
3. Ensure that new phones sold via installment plan are configured and priced
correctly.
3. Ensure that new phones sold via installment plan are configured and priced
correctly.
- The Backend Monitor Process (BMP) is used to start, stop and monitor other
Convergent Billing processes for a specified instance. Any number of different
types of processes can be monitored. The default types of processes
monitored in a minimal installation are:
- BKR - Event Rating Broker process that controls the rating engine.
- TLM - Task Launcher and Monitor process.
- STD - Scheduled Task Dispatcher process.
- sfm
- The Scheduled Function Monitor (SFM) process periodically queries the
SCHEDULED_FUNCTION table for EPM functions scheduled for execution and
executes them in the order that they are due. The SFM will update the
database to track the progress of a scheduled function’s evaluation and it will
re-schedule any retryable functions that failed.
- tlm
- The Task Launch Module (TLM) is utilised to run and monitor the completion of
scheduled tasks on a specified UNIX host.
- erb
- The Event Rating Broker (ERB) module manages the transmission of
normalised events from Event Normalisation (ENM) processes to Event Rating
(ERT) processes for rating, the transmission of normalised events from ENM
processes to an Event Rating Output (ERO) process, and the transmission of
charges from ERT processes to the same ERO process. The ERB module
provides a set of functions which are called by ENM, ERT and ERO processes
in order to perform these tasks.
- ero
- The event rating output (ERO) process is responsible for outputting file,
normalised event, normalised event error and charge information generated
by the event normalisation (ENM) process and the event rating (ERT) process.
It is also responsible for updating accounts and either inserting or updating
rating subtotals modified during the rating process.
- ert
- The ERT is responsible for receiving normalised events from the Event Rating
Broker (ERB) module and generating charge records which are sent back to
the ERB module. When an event is received, the ERT process uses the Event
Rating Module (ERM) to evaluate eligible rating tariffs and generate zero or
more charge records for that event.
- enm
- The ENM standalone process normalises events. A billable session or call can
be represented by multiple raw event data records (EDRs) that are produced
by the relevant network switch equipment (i.e. event records). Normalised
Singleview Operations Guide
3. Ensure that new phones sold via installment plan are configured and priced
correctly.
events will be produced to represent the billable components from these raw
EDRs.
- If these events require event-based billing, the normalised event format may not strictly
correspond to one event per call. The normalisation process may simply add a call identifier (that
is located in an initial raw EDR) to the following event records and each of these events will
become a normalised event
-
- These can be checked using the ataprocs command:
- ataprocs
Singleview Operations Guide
3. Ensure that new phones sold via installment plan are configured and priced
correctly.
> df -k
11.
The following validation check can be performed to ensure there are no missing rating
files to be processed.
The sql will perform a file sequence number check, across CDR, TDR and RR files:
3. Ensure that new phones sold via installment plan are configured and priced
correctly.
from
(
select
case when substr(filename,1,9)='CDR_VOICE' then substr(filename,1,9)
else case when substr(filename,1,3)='CDR' or substr(filename,1,3)='TDR' then
substr(filename,1,18)
when substr(filename,1,2)='RR' then substr(filename,1,5)
when substr(filename,-3)='OCC' then substr(filename,1,8)||'_'||substr(filename,-3)
else 'notfound' end
end prefix,
case when substr(filename,1,9)='CDR_VOICE' then to_number(substr(filename,11,6))
else case when substr(filename,1,3)='CDR' or substr(filename,1,3)='TDR' then
to_number(substr(filename,20,8))
when substr(filename,1,2)='RR' then to_number(substr(filename,22))
when substr(filename,-3)='OCC' then to_number(substr(filename,17,6))
else 0 end
end seq,filename
from normalised_event_file
where (filename like 'CDR%' or filename like 'TDR%' or filename like 'RR%' or filename
like '%OCC')
order by 1,2
)
)
where seq <> next_seq-1
and prefix=next_prefix
If there are no missing file sequences, then this query will return no results.
If there are missing sequences , then the results will look similar to this:
PREFIX SEQ NEXT_SEQ MISSING_FILES
Even if all RR files have been received from RAID roaming (i.e. there are no missing
sequences for RR* files), there is a possibility that some files may not have been
processed in RAID roaming, due to fallout.
The following query will check for gaps in the TAP file sequences:
3. Ensure that new phones sold via installment plan are configured and priced
correctly.
from
(
select substr(tapfile,3,5) partner,substr(tapfile,13)
seq,tapfile,sum(decode(source,'E',events,0))
errored_events,sum(decode(source,'N',events,0))
processed_events,sum(decode(source,'E',charge,0))
errored_charge,sum(decode(source,'N',charge,0)) processed_charge
from (
select substr(n.general_20,1,instr(n.general_20,';')-1) tapfile,'N' source,count(*)
events,sum(n.charge) charge
from normalised_event n, normalised_event_file f
where 1=1
and filename like 'RR%'
and n.normalised_event_file_id=f.normalised_event_file_id
group by substr(n.general_20,1,instr(n.general_20,';')-1)
union all
select substr(n.general_20,1,instr(n.general_20,';')-1) tapfile,'E' source,count(*)
events,sum(n.charge) charge
from normalised_event_error n, normalised_event_file f
where 1=1
and filename like 'RR%'
and reprocessed_file_id is null
and n.normalised_event_file_id=f.normalised_event_file_id
group by substr(n.general_20,1,instr(n.general_20,';')-1)
)
where tapfile like 'CD%'
group by substr(tapfile,3,5),substr(tapfile,13),tapfile
order by tapfile
)
)
where seq <> next_seq-1
and partner=next_partner
If there are no missing TAP file sequences, then this query will return no results.
If there are missing sequences , then the results will look similar to this:
PARTNER SEQ NEXT_SEQ MISSING_SEQUENCES
3. Ensure that new phones sold via installment plan are configured and priced
correctly.
It is recommended that Service Provider run the below SQL to analyse a defined bill
cycle (ie Bill_Cycle_1 or Bill_Cycle_2, refer to relevant SQL below).
The script will find all customers belong to that bill cycle and which have > 100,000
events or > 300 services per account in the most recent billing period.
The script will then reset its customer billing_priority to 1. This will ensure these
customers are processed first across the billing child processes.
declare
--This PL/SQL block is used to simplify setting the billing priority for the large customers
--to ensure that they are billed early in the bill run and not left until last,
--where they can affect the overall duration of the bill run
--It unsets any billing priorities which may be set, find the schedule id and effective date
--of the bill run and then sets the billing priority of customers with more than 100000
--or more than 300 services to a priority determined by their relative size
--It should be run using a database user with sufficient privileges to update the
customer_node_history table
--Will run for the most recent bill run effective date at the date/time of running
v_schedule_id number;
v_effective_date date;
begin
3. Ensure that new phones sold via installment plan are configured and priced
correctly.
and schedule_id=v_schedule_id;
--set priorities -- all customers with > 10000 unbilled events per account at the bill run
effective date
for v_customer in
(select account_id,rownum priority from (
select /*+ parallel 16 */ account_id,count(*),count(distinct c.service_id)
from charge c, customer_node_history h
where 1=1
--and invoice_id is null
and charge_date < v_effective_date
and charge_date >= add_months(v_effective_date,-1) -- limit it to the most recent
month, which should be sufficient to set priority
and c.account_id=h.prime_account_id
and c.charge_date between effective_start_date and effective_end_date
and h.schedule_id = v_schedule_id
group by account_id
having count(distinct c.service_id) > 300 or count(*) > 100000 -- customers with more
than 100000 events per account or more than 300 services per account will be billed
first and in separate batches when running the bill run with the -g option
order by 2 desc)
)
loop
update customer_node_history
set billing_priority = v_customer.priority
where prime_account_id = v_customer.account_id;
end loop;
commit;
end;
3. Ensure that new phones sold via installment plan are configured and priced
correctly.
order by 2 desc, 1;
For Bill_Cycle_2:
declare
--This PL/SQL block is used to simplify setting the billing priority for the large customers
--to ensure that they are billed early in the bill run and not left until last,
--where they can affect the overall duration of the bill run
--It unsets any billing priorities which may be set, find the schedule id and effective date
--of the bill run and then sets the billing priority of customers with more than 100000
--or more than 300 services to a priority determined by their relative size
--It should be run using a database user with sufficient privileges to update the
customer_node_history table
--Will run for the most recent bill run effective date at the date/time of running
v_schedule_id number;
v_effective_date date;
begin
--set priorities -- all customers with > 10000 unbilled events per account at the bill run
effective date
for v_customer in
(select account_id,rownum priority from (
select /*+ parallel 16 */ account_id,count(*),count(distinct c.service_id)
from charge c, customer_node_history h
Singleview Operations Guide
3. Ensure that new phones sold via installment plan are configured and priced
correctly.
where 1=1
--and invoice_id is null
and charge_date < v_effective_date
and charge_date >= add_months(v_effective_date,-1) -- limit it to the most recent
month, which should be sufficient to set priority
and c.account_id=h.prime_account_id
and c.charge_date between effective_start_date and effective_end_date
and h.schedule_id = v_schedule_id
group by account_id
having count(distinct c.service_id) > 300 or count(*) > 100000 -- customers with more
than 100000 events per account or more than 300 services per account will be billed
first and in separate batches when running the bill run with the -g option
order by 2 desc)
)
loop
update customer_node_history
set billing_priority = v_customer.priority
where prime_account_id = v_customer.account_id;
end loop;
commit;
end;
Note that the PL/SQL will take a few minutes to complete, since it need to query all the
Singleview Operations Guide
3. Ensure that new phones sold via installment plan are configured and priced
correctly.
From the Server Tasks|Schedules form, open the schedule for which the bill run is to be executed e.g.
Bill_Cycle_1.
Press the ‘Tasks’ button. Open the task with the required effective date (May 13 23:59:59).
On the task, select Update and check the Scheduled Start Date to the required bill run start time. (Set to
current date and time if the bill run should be executed now.)
Other Parameters:
Number of Child Processes may be increased based on the environment hardware specification (# of
CPUs). On the Production environment, 24 child processes may be executed.
To: should be Step 40. At Step 40, the bill run output can be validated and approved. (The bill run will
then be completed, by executing remaining steps.)
Error Threshold: Set as appropriate to allow the bill run task to complete even in case a number of
customers are not billed successfully. If value is 0, then any error/failed customer will cause the bill
run task to fail.
o Errored customers may be complete later, after errors are resolved, without need to revoke
the other customers billed.
Where Clause: may be used to exclude customers from the bill run.
Singleview Operations Guide
The duration of the bill run and how long it would take to revoke all need to be taken
into consideration when making the decision to stop a bill run.
2. Check the task results and any obvious errors in the log.out file on the server associated with Operations
this bill run.
3. Check the details of any failed customers in the bill run. Operations
4. View some invoice images through the Singleview GUI. Revenue
Assurance
To view invoices online, go to the Accounts | Invoices menu item and perform a search on
the bill run ID. This will retrieve all invoices generated during the bill run.
5. Bill Run Performance. Operations
To view the performance statistics of a specific bill run then run the following command:
ops_check_bill_run -b <bill_run_id>
The output will display bill run step statistics and large volume customer hierarchies
Singleview Operations Guide
Where possible, any failed customers within the bill run should be corrected and reprocessed
before committing or printing the invoices of the bill run.
If errors are encountered during the bill run, or bill run output needs to be corrected, it may be
necessary to revoke the bill run.
To revoke the entire bill run, select Step 10 in the From Operation and Step 70 in the To Operation
dropdown lists.
Click Save.
Singleview Operations Guide
If Step 70 has been executed for a bill run, only a complete revoke of the bill run, for all
customers, is possible. This is a constraint which is necessary to prevent gaps in invoice
sequence numbers. Refer to the Sequential Invoice Numbering feature in the FDD for further
details on revoking bill runs and sequential invoice numbering.
As long as the bill run has not reached Step 70, the bill run can be completely or partially revoked,
for all or a subset of customers.
To complete the bill run, on the Bill Run form, press the “Perform Operation” button, select
“Complete Bill Run” and complete the task parameters:
Save the task, to execute the remaining steps. The bill run should be monitored, as for the earlier
steps, and errors investigated and revoke or re-execution done if required, depending on the
errors encountered.
5.3.3.9Error Handling
When errors occur the task results will display the corresponding task error message to be
investigated. The task may been to be resubmitted, based on the nature of the failure.
The below table defines a sample set error failures, probable cause and operational action which
should be performed to resolve the issue:
Singleview Operations Guide
Error ID E84003
Error Message Charge Type is invalid for discount charge generation.
Error Cause Charge Type is invalid and it is not supported for discount feature.
Action Configure valid charge type.
Error ID E84000
Error Message No row found in DA table disc.dProductOfferDiscount for indexes.
Error Cause No row configured in DA table disc.dProductOfferDiscount for the
indexes.
Action Configure discount details in Da table disc.dProductOfferDiscount.
Error ID E80528
Error Message No Rows found in ‘tax.vat.dTaxRate’ for TaxTypeCode ‘NRC_TAX_TYPE’
and Tax Class Code ‘ZERO_RATED’.
Error Cause Missing row in TaxRateDerivation Table for the selected Tax Type Code
and Tax Class.
Action Insert row into "TaxRateDerivation" table to avoid error.
Error ID E107007
Error Message No valid entry in the DA table ‘Service Obligation GL Details’ for the
following Top Level Offer Id: ‘1005183’ and Transaction Ids ‘7’ Refer
"MTC_IFRS_TRANSACTIONS" Reference Type to get the list of possible
transactions.
Error Cause No Rows found in Derived Attribute Table for the Specified Top Level
Offer Id and Transaction Ids. Refer "MTC_IFRS_TRANSACTIONS"
Reference Type to get the list of possible transactions.
Action Provide a valid entry in the DA for the Top Level Offer and Transaction
Ids
Error ID E03268
Error Message Expression failed for tariff ‘prodprice.rec.tS_Feature_AdvanceMRC#{}’
at effective date ‘05/01/2020.’ Cause of expression failure: ‘No matching
row found in table 'prodprice.rec.dStatus_Category_Mapping' for index
values.’
Error Cause The evaluation of this expression failed.
Action Contact the system administrator.
Error ID E00423
Error Message tlm: Process for task ‘27067’ terminated abnormally.
Error Cause The process for the specified task terminated in an abnormal manner.
Action Use the task output to determine the cause of the abnormal
termination, then correct it.
Error ID E05493
Error Message No reference code with a code of ‘10002’ exists for reference type
'tax.cmn.TAX_ASSOCIATION'.
Error Cause An invalid reference code value was specified to the
ReferenceCodeAbbrev&(),
ReferenceCodeLabel$(), or ReferenceCodeAbbrevByLabel$() functions.
Action Specify a valid reference code for this reference type.
Error ID E03603
Error Message Tuxedo function ‘tpinit’ has failed with error ‘TPENOENT - no entry
found’
Error Cause The tuxedo API function specified has failed with the specified error.
Refer to the tuxedo documentation for more details.
Action Fix the error as per the tuxedo documentation.
Singleview Operations Guide
Error ID E05529
Error Message No records were found with the specified ‘ENTITLEMENT_TRE_V’ id of
‘300000001790’.
Error Cause No records exist in the database for ENTITLEMENT_TRE_V’ with the
given value of ‘300000001790’.
Action Fix client call to use the correct id.
Error ID E02552
Error Message Error encoding string field GENERAL_8 - maximum column length 255
characters.
Error Cause The length of the string field is longer than its underlying column.
Action Limit the length of string fields to that of the underlying column.
Error ID E06023
Error Message treCall to 'biBillRunExecute&' was unsuccessful: ‘E03287: Too many
rental event errors have occurred.’
Error Cause The number of errors that have occurred in the generation of rental
events or rental adjustment events have exceeded the specified
threshold. This has caused the processing of this bill run to be halted.
Action Correct the reported errors and then complete the bill run.
Error ID E00014
Error Message This record for ‘Entitlement '
'000012906305_20210210131553_SV1_14957' ' was updated by
another user. Close the form without saving and re-query to access the
current version.
Error Cause While you were updating this record another user has made changes
and saved the record to the database.
The record you are updating is now out of date and cannot be saved to
the database.
Action Close the form without saving and re-query to access the current
version of the record.
Check the detail of the current version and if necessary, make the
changes you require to this new instance of the record.
Error ID E11324
Error Message Insufficient amount available for entitlements with category
‘IFRS_INTEREST_RATE_ENTITLEMENT’ as at ’Thu Sep 16 10:33:48 2021’
for ‘811025152’.
Error Cause There is insufficient amount available as at the effective date/time for
entitlements that match the requested parameters.
Error ID E20628
Error Message <E20628> rgp: An entry for event file
RGP_SYNPRD1B_1_SV2.164815750493293000028724 has not appeared
in the NORMALISED_EVENT_FILE table after the maximum allowed
period of 60 seconds.
Error Cause The RGP was waiting for the rating of a file to complete before checking
its rating statistics. However, an entry for the file has not appeared in
the NORMALISED_EVENT_FILE table afer the maximum allowed period.
Action Determine the list of customers impacted by this error, revoke each of
Singleview Operations Guide
these failed customers from back to Step 10 (using the bill run operation
WHERE clause on customer_node_in in (X,Y) and complete bill run
individually up to Step 20 for each failed customer. Once done
complete bill run for the remaider on customers.
Error ID E03206
Error Message <E03206> igp: Internal Error in file igp_pipe.cc at line 383: Error writing
to pipe.
Error Cause Internal IGP error probably related to memory
Action Restart the igp tuxedo servers :-
tmshutdown -s treigp -g BILLING -i 950; tmboot -s treigp -g BILLING -i
950;
tmshutdown -s treigp -g BILLING -i 951; tmboot -s treigp -g BILLING -i
951;
tmshutdown -s treigp -g BILLING -i 952; tmboot -s treigp -g BILLING -i
952;
tmshutdown -s treigp -g BILLING -i 953;tmboot -s treigp -g BILLING -i
953;
tmshutdown -s treigp -g BILLING -i 954;tmboot -s treigp -g BILLING -i
954;
tmshutdown -s treigp -g BILLING -i 955;tmboot -s treigp -g BILLING -i
955;
tmshutdown -s treigp -g BILLING -i 956;tmboot -s treigp -g BILLING -i
956;
tmshutdown -s treigp -g BILLING -i 957;tmboot -s treigp -g BILLING -i
957;
tmshutdown -s treigp -g BILLING -i 958;tmboot -s treigp -g BILLING -i
958;
tmshutdown -s treigp -g BILLING -i 959;tmboot -s treigp -g BILLING -i
959;
tmshutdown -s treigp -g BILLING -i 960;tmboot -s treigp -g BILLING -i
960;
Error ID
Error Message
Error Cause
Action
Singleview Operations Guide
To facilitate this invoice file transfer this Singleview has configured two configuration items :
FTS_LOCATION_PRIORITY_INVOICE to define the SV Node 2 target environment and directory
FTS_INTERFACE_PRIORITY_INVOICE to define the transfer credentials of the FTS task to the SV Billing
Node (ie SV Node 1).
Singleview Operations Guide
Multi-instance Instance List Null or specifically the active CB instance (ex SV1)
Name
Click Save
Save the task, to execute outbound transfer. The task should be monitored, and errors
investigated and addressed if required, depending on the errors encountered.
5.3.4 Invoices
The directory path that images are written to and retrieved from is configured through the
INVOICE_IMAGE configuration item.
XML: the raw XML for the invoice content is generated at Step 40 and stored in the
Singleview database (INVOICE_IMAGE table)
PDF: generated at Step 70 for customers opted in for electronic invoice delivery.
PDF files are generated in directory $ATA_DATA_SERVER/output/printvendor
Singleview Operations Guide
5.3.4.3.1 Description
This schedule type generates invoice document packages (PS files) for both Nampost (for printing)
and E2Vault (electronic archiving and retrieval).
Only customers who opt for Invoice Delivery = Postal will have their invoices incorporated in the
concatenated ps file sent to the print vendor. All customers invoices (regardless of customer
invoice delivery preference) will have their invoices incorporated in the concatenated ps file sent
to E2Valut.
File transfers are controlled by FTS (Singleview File Transfer Subsystem) and are optional (with
separate FTS configuration items for Nampost and E2Vault).
This task will deliver invoices generated for scheduled monthly bills and immediate bills (e.g. in
case of change of ownership of a service).
Configuration item PRINTVENDOR1 will define the system attributes necessary to run the Print Vendor task.
Attribute RENDER_STREAMS can be used to improve the performance of the task, values null to
max value 24 should only be allowed
For E2Vault delivery, an accompanying JRN file is also generated by this task.
The following configuration items support the file transfer settings for this task:
E2Vault: FTS_INTERFACE_E2VAULT/FTS_LOCATION_SFTP2
NamPost: FTS_INTERFACE_NAMPOST/FTS_LOCATION_FTP_NAMPOST
Select Schedule Type ‘Printvendor Build Printjob’ from the dropdown list
Create the task as per the details below:
Multi-instance Instance List Null or specifically the active SV node instance (ex SV1)
Name
FTP To Remote Machine? Yes/No Initiate transfer to the printer (to the external system which will receive the
files).
Correspondence Type List ALL – All invoices excluding reprints and immediate invoices
Verify that the task ran successfully. If the task completes with non-success status, check the task
output for errors; resolve and resubmit the task to continue.
Note: FTP to remote machine option is set to ‘NO’ in this case, the files will be in the transmission
directory, if FTP to remote machine option is set to ‘YES’ then task will initiate the FTP to transfer
the files to external system.
To keep the transmission and print vendor file generation as a separate activity it is advisable to
use option to not initiate transfer and instead use the Initiate Outbound Transfer task.
For transferring the file to the remote system later, transmission can be initiated using the one-off
task “Initiate Outbound Transfer”.
5.3.4.4.1 Description
This schedule type is provided to support emailing of PDF invoices generated by bill runs and
invoice reprint requests, where the customer invoice delivery method is ‘Electronic’.
This task will process all pdf invoice email files procssed from directory as defined in config item
INVOICE_PDF_PRINT1 attribute EMAIL_DIRECTORY and move them to an archive or error directory
(as defined by config item PRINTVENDOR_EMAIL1).
If the processed invoice is associated to a customer with a valid contact email address then the
task will send a email based on a email template (as defined in ref data table ‘PDF Invoice Email
Templates’) else an error will be output to the taskout screen.
Multi-instance Instance List Null or specifically the active SV node instance (ex SV1)
Name
Save
Error ID E96555
Error Message The FTS daemon process is not running. No transfers are allowed..
Error Cause The FTS daemon process is not running.
Action Run a one-off task for schedule File Transfer Subsystem Control to start
the daemon.
Error ID E96509
Error Message Error connecting to '<1:host>'. Error was: <2:error>
Error Cause An error was encountered logging connecting to the remote machine.
Action Check connectivity with remote server.
Error ID E96599
Error Message Cannot perform file transfer for '<1:cfg_item>' on instance
<2:instance>. File transfers for this interface are only permitted on
instance <3:other_instance>.
Error Cause An attempt was made to execute a file transfer on the incorrect
instance.
Action Submit the file transfer task on the correct instance.
Error ID E78651
Singleview Operations Guide
General note :
In case the task fails in the middle, the files present in /working directory needs to be removed
and original files moved back to respective /printvendor source directories before re-submitting
the task.
In addition, in case of “Printvendor Build Email Printjob”, messages like below need to be
investigated:
A set of prepaid bill schedules will be delivered. These schedules will execute automatically and
will only execute Step 30. The tasks should be checked periodically to ensure they complete
successfully. The prepaid bill runs are technical bill runs which ensure that prepaid charges are
marked as processed from billing perspective, which allows efficient management of event and
charge volumes over time (allowing partitions to be marked as billed and hence closed and
eventually archived).
Prepaid bill runs do not generate invoice images and do not impact the customer account balance
in Singleview.
Singleview Operations Guide
5.4.1.1Description
This schedule type will find all accounts registered for Direct Debit auto-pay and will automatically
broadcast an Advance Payment SMS Notification for each direct debit request. The SMS is sent to
the mobile number of the primary contact (bill payer) associated to the customer account.
If the contact does not have a valid mobile number, the account will be skipped from sending
SMS. Once the task is successful completed, the task result will display statistics regarding
Schedule Type Create Autopay Payment SMS Frequency Once per direct debit payment run.
Notification
Operations Group Execution Scheduled or ad-hoc - before Create
Autopay ENDO Payments task
Prerequisites Conflicts None
5.4.1.2One-Off Task
Sign on to the environment with your credentials
Click on Server Tasks from the menu bar
From the dropdown menu select One-off Task
In the Inserting One-off Task form, select Create Autopay Payment SMS Notification as the
Schedule Type dropdown value and fill in the parameters as follows:
Parameters Tab:
Multi-instance Instance List Null or specifically the active SV node instance (ex SV1)
Name
Default Advance Period Integer Number of days in advance to find accounts which have a direct debit
payment due.
First Advance Period Integer Number of days in advance to find accounts which have a direct debit
payment due, where this is the first time a direct debit payment will be
created for the account.
Instance Partitions Only? Yes/No No. For multi-instance, this will generate the payments for all customers on
all instances.
Singleview Operations Guide
5.4.1.4SMS.Messages
This Derived table specifies the message that will be send to the contact via SMS.
The task uses SMS type ‘Direct Debit Advance Notification’ and fetches the corresponding
message. If required this message can be modified from this DA, as reference data.
Singleview Operations Guide
5.4.1.5Error Handling
When errors occur the task results will display the corresponding task error message to be
investigated. The task may been to be resubmitted, based on the nature of the failure.
The below table defines a sample set error failures, probable cause and operational action which
should be performed to resolve the issue:
Error ID E83283
Error No SMS details were found in the 'SMS.Messages' derived attribute table for SMS
Message type 'DIRECT_DEBIT_ADVANCE_NOTIFICATION' and language 'English' as on
'05/02/2020'
Error Cause Reference data issue
Action Consult with Reference Data Department to update derived attribute table
‘'SMS.Messages' to include missing SMS Type method
'DIRECT_DEBIT_ADVANCE_NOTIFICATION'.
Error ID E83282
Error The SMS requested to be sent is invalid (no text or too long). Msg =
Message '<message_content_here>'
Error Cause The system generated an invalid message.
Action Review the definition of the 'DIRECT_DEBIT_ADVANCE_NOTIFICATION' SMS
message text defined in the SMS.Messages DA to verify it is valid.
Error ID INVALID_PHONE_NUMBER
Error Phone number '1234567890' is not valid.
Message
Error Cause Singleview failed to send customer contact number a SMS message as its
number format does not align to Service Provider number format rules.
Action Review the associated customer contact details and request Call Centre to
resolve invalid customer contact data.
Error ID
Error
Message
Error Cause
Action
Singleview Operations Guide
5.4.2.1Description
This schedule type creates a payment in an Entered state which is a container for the information
we need to send out to the bank (see next schedule). This process looks ahead a configurable
number of days, accounting for Sundays and public holidays. It will create the Entered payment in
Singleview, corresponding the amount owed on the account (where the account is enabled for
autopay ENDO payment method).
Before your run the execute the task on Production validate the the payment external interfaces
have been successfully generated on SV1.
Via CB GUI , Select Main Menu – Server Tasks – Server - External Definition – and search for :
External Definition Name = payment.InsertPayment
If the ‘Generation Status Interface Generation’ status is not Generated then select ‘Generate
Interfaces’ button, they should take 5 seconds to regenerate. Only do this when necessary.
Singleview Operations Guide
Default Advance Period Integer Number of days in advance to find accounts which have a direct debit
payment due.
First Advance Period Integer Number of days in advance to find accounts which have a direct debit
payment due, where this is the first time a direct debit payment will be
created for the account.
Instance Partitions Only? Yes/No No. For multi-instance, this will generate the payments for all customers on
all instances.
Save
Singleview Operations Guide
Verify Batch Payments have been updated correct via the CB Client Menu ‘Accounts’, ‘Payments’,
‘Manage Batch Payments’. Search for batch paymemts with a Batch Date matching task start
date. Verify batch payment content, alter as appropriate.
Selecting a specific batch will allow the user to view individual batch payment details, the user
with sufficient access rights will be allowed to alter values before they are extracted to bank.
Singleview Operations Guide
5.4.2.4Error Handling
When errors occur the task results will display the corresponding task error message to be
investigated. The task may been to be resubmitted, based on the nature of the failure.
The below table defines a sample set error failures, probable cause and operational action which
should be performed to resolve the issue:
Error ID E71989
Error There are no rows for SEPA Payment Type in the
Message Payment.AutoPay.dConfiguration derived attribute table.
Error Cause Reference data issue
Action Consult with Reference Data Department to update derived attribute table
‘Payment.AutoPay.dConfiguration’ to include missing payment method ‘Auto-
Debit’.
Error ID E14065
Error <E14065> The external definition payment:payment.InsertPayment has either
Message not been generated or failed generation: <E00108> Function
payment:payment.InsertPayment.Insert& is not defined.[Account ID:
500039134723, Invoice ID: 500012608057, Amount:
2290.92, Payment Received Date: 14/11/2021 00:00:00, Payment Date: 12-11-
2021 00:00:00]
Error Cause The external definition ‘payment.InsertPayment’ is not generate
Action Via CB GUI , Select Main Menu – Server Tasks – Server - External Definition – and
search for :
External Definition Name = payment.InsertPayment
5.4.3.1Description
This schedule type extracts all unextracted payments created by the Create Autopay ENDO
Payments (5.4.2) task into a file for distribution the bank. The file transfer to the bank is
performed by a separate File Transfer System task.
Configuration item ENDO_PAYMENT.AUTOPAY1 supports configuring a number of system settings
utilised by this task.
The following query can be used to count the number of unextracted ENDO payments which have
a payment date <= a defined task effective date.
This will provide the user with an idea of the volume of payments that will be extracted (please
upate the date to the expected task effective date).
Multi-instance Instance List Null or specifically the active SV node instance (ex SV1)
Name
Instance Partitions Only? Yes/No No. For multi-instance, all partitions should be considered.
Save
Verify file content within the config item ENDO_PAYMENT.AUTOPAY1 attribute OUTPUT
_DIRECTORY fileserver directory.
Verfiy payment updates via the CB Client, Manage Batch Payments menu option.
5.4.3.4Error Handling
When errors occur the task results will display the corresponding task error message to be
investigated. The task may been to be resubmitted, based on the nature of the failure.
The below table defines a sample set error failures, probable cause and operational action which
should be performed to resolve the issue:
Error ID E05493
Error No reference code with a code of 9 exists for reference type 'MTC_BANK_BIC’
Message
Error Cause Reference data issue
Action Consult with Reference Data Department to update reference type
Singleview Operations Guide
Error ID E03082
Error One of the parameters used in the builtin function 'ReferenceCodeLabel$' was
Message not defined
Error Cause Reference data issue
Action Re-run task with debug mode to trace issue, and consult with support team on
the underlying issue.
Error ID E00014
Error This record for Payment 'P00002260891' was updated by another user. Close
Message the form without saving and re-query to access the current version.
Error Cause The task attempted to update a payment with an old last modified date.
Action Check if the schedule is being run in the past, update to run on current effective
date.
Error ID E71991
Error SEPA Creditor Information is missing in
Message ‘Payment.AutoPay.dMandateCreditorInfo’ derived attribute table.
Error Cause Reference data issue
Action Consult with Reference Data Department to update derived attribute table ‘P
‘Payment.AutoPay.dMandateCreditorInfo’ to include missing Creditor Debits
for the payment type ‘syn.pay.DirectDebit’.
Error ID
Error
Message
Error Cause
Action
Step 1
Identify the count of ‘Direct Debit’ payments created by the specific ‘Create Autopay ENDO
Payments‘ task that you wish to reverse out.
select count(1) from payment where payment_batch_id in (select payment_batch_id from
payment_batch where description like 'Payment Batch for Auto-pay payments with task identifier
<Task ID>.')
Example :-
select count(1) from payment where payment_batch_id in (select payment_batch_id from
payment_batch where description like 'Payment Batch for Auto-pay payments with task identifier
700000053622.')
Step 2
Identify the payment_batches that were created as part of the specific ‘Create Autopay ENDO
Payments‘ task that you wish to reverse out.
select payment_batch_id from payment_batch where description like 'Payment Batch for Auto-pay
payments with task identifier <Task ID>.'
Step 3
Only after validating you can remove the payments execute the below via Singleview CB GUI –
Main Menu - Expression Test Window.
{
var lSql$ := ' SELECT pb.payment_batch_id ' +
' FROM payment_batch pb ' +
' WHERE pb.description = :Description';
5.4.4.1Description
This schedule type processes the response file from the bank to reject failed payments, apply
successful payments or update pending/tracking payments.
Configuration item ENDO_DIRECT_DEBIT.REJECTIONS1 supports the system settings applied when
running this task.
Continue On Error? Yes/No Yes. Successful records will be committed, failed updates will be captured
in the task output and may require investigation and reprocessing.
Save
Singleview Operations Guide
Verify Batch Payments have been updated correct via the CB Client Menu ‘Accounts’, ‘Payments’,
‘Manage Batch Payments’. Select relevant batch payment and view sub payments details.
If errored records found then reprocess them after underlying issue resolved.
5.4.4.4Error Handling
When errors occur the task results will display the corresponding task error message to be
investigated. The task may been to be resubmitted, based on the nature of the failure.
The below table defines a sample set error failures, probable cause and operational action which
should be performed to resolve the issue:
Error ID E05494
Error Payment reject record Errored End To End Id :P00001006410
Message Reason :<E05494> No reference code with a code label of 'TR76' exists for
reference type 'Payment Rejected'
Error Cause Reference data issue
Action Consult with Reference Data Department to update reference type
PAYMENT_REJECTED to include missing payment rejection of Code Label value
'TR76'
Error ID E03082
Error Payment reject record Errored End To End Id :P00001005818
Message Reason :<E03082> One of the parameters used in the builtin function
'ReferenceCodeByLabel&' was not defined.
Error Cause Reference data issue
Singleview Operations Guide
Error ID E07511
Error Payment reject record Errored End To End Id :P00001023233
Message Reason :<E07511> Adjustment PR00001003425 amount of 10.000 is greater
than the maximum allowable adjustment amount of 0.000 in CURRENCY of
Dollars, for the user.
Error Cause A payment rejection has resulted in a payment rejection adjustment fee applied
to the customer account account, this adjustment exceeds the limit the task
user profile is allowed.
Action Review the Adjustment Limit associated to the user profile running the task.
Message
Error Cause Task Maximum Duration has been exceeded
Action Determine if the reason for the task running for slow long. Was it due to
High volume of payment transactions in the input file.
Oracle lock issues (ie oralock command)
Performance of sql update.
Determine if the xml should be reproessed with just the remaining number of
transactions included. Consider Maximum Duration of the task.
5.4.5.1Description
Only allowed if the response for a file is a group level rejection. This deletes all the created
autopay payments referenced by the file that is specified. Singleview verifies that these
payments have not actually been processed by the bank (as far as Singleview is aware i.e. if the
bank sends some rejects and approvals for a batch of payments and erroneously then sends a
reject for the entire file we won’t delete any payments already processed).
This allows the service provider to revoke, correct the problem which resulted in the rejection and
then run create and extract tasks again and resubmit to the bank without the need for manual
changes to files.
Multi-instance Instance List Null or specifically the active SV node instance (ex SV1)
Name
Instance Partitions Only? Yes/No No. For multi-instance, all partitions should be considered.
Continue On Error? Yes/No Yes. Successful records will be committed, failed updates will be captured
in the task output and may require investigation and reprocessing.
Save
Singleview Operations Guide
5.4.5.4Error Handling
When errors occur the task results will display the corresponding task error message to be
investigated. The task may been to be resubmitted, based on the nature of the failure.
The below table defines a sample set error failures, probable cause and operational action which
should be performed to resolve the issue:
Error Cause Direct Debit Tracking is enabled for one of the Payment ID and hence cannot be
revoked
Action The system cannot reject this payment as its marked for tracking, exclude or
Singleview Operations Guide
Error ID E05494
Error Payment reject record Errored End To End Id :P00001057421
Message Reason :<E05494> No reference code with a code label of '901060' exists for
reference type 'Payment Rejected'.
Error Cause Reference data issue
Action Consult with Reference Data Department to update reference type
PAYMENT_REJECTED to include missing payment rejection of Code Label value
'901060' or investigate if the structure of the input file is corrupted and '901060'
is positioned in the incorrect field record location.
Error ID E03082
Error Unexpected response : Payment status code received is not valid (SSSS).
Message
Payment reject record Errored End To End Id :P00001008028
Reason :<E90131> Invalid number of parameters passed to
biReferenceCodeAbbrevByLabel$(). Got 1 expected 2
Error Cause Reference data or configuration issue
Action Re-run task with debug mode to trace issue, and consult with support team on
the underlying issue.
Error ID E108010
Error Invalid msg id or payments not found for the msg id <1:msgid> .Hence, 0 files
Message revoked.
Error Cause The payment referenced by Msgid does not exist in Singleview
Action Investigate if incorrect information is passed to Singleivew and ensure the
correct payment Msgid is referenced in the revoke file.
Error ID
Error
Message
Error Cause
Action
5.4.6.3Reference Documents
Reference Title
2 System Operations Guide for Singleview
5.4.6.4Schedule Setup
Sign on to the environment with your credentials
Click on Server Tasks from the menu bar
From the dropdown menu select Schedule
Click on Create New Schedule radio button
Click on the New button
In the Inserting Schedule form, click on the Settings tab and fill in the parameters as
follows:
Settings Tab
Multi-instance Instance List Null or specifically the active SV node instance (ex SV1)
Name
Instance Partitions Only? Yes/No No. For multi-instance, all partitions should be considered.
Click Save
5.4.6.6Error Handling
If the number of failed transactions reaches the utility's default threshold (see the System
Reference Guide for Singleview)), the scheduled task fails. Depending on the nature of the error,
the issue may need to be resolved and the task resubmitted. (Otherwise, unprocessed payments
will be processed by the next scheduled task.)
The below table defines a sample set error failures, probable cause and operational action which
should be performed to resolve the issue:
Error ID E12760
Error GL codes ‘Cash at Bank’ and ‘WPC_BE_BUE_DEBIT_GL’ do not belong to the
Message same reporting entity as at 05/02/2020.
Error Cause Reference data issue.
In each pair of GL codes involved in a payment/adjustment, the GL codes must
belong to the same reporting entity.
Action Review the Reporting Entity for both the below GL codes.
Correct the GL codes used by the adjustment/payment type, or correct the GL
allocation function so that the GL codes in each pair belong to the same
reporting entity.
Error ID
Error
Message
Error Cause
Action
Singleview Operations Guide
Steps (3) and (4) operate per file that is needed to IFS:
1. FACT
2. COB
3. ADT
4. POS
5. ONACT which also generates a POS file for excess fee (if applicable)
Generation of the CSHUP file however happens separately and is not dependent on the steps
above. For this file, see Section 5.5.5 “GL CSHUP Extract” below.
Transfer of files to IFS is handled via separate file transfer tasks as setup using the Singleview File
Transfer System (FTS) – see Section 7.1 “File-based Interfaces”.
It is recommended that service provider run the following tasks to generate accounting periods for
the next calendar year at least 2 to 3 months before the end of the current calendar year.
However there is no impact to generating these periods well in advance so the accounting periods
could indeed be generated years in advance so as to minimize the likelihood of problems
occurring.
5.5.1.1Description
This schedule type creates an initial set of accounting periods, populating the ACCOUNTING_YEAR
and ACCOUNTING_PERIOD tables to span the period between specified start and end dates.
Accounting years are inserted starting from the start date in full years until an accounting year is
inserted with an end date greater than or equal to the specified end date. Therefore, the final
accounting year may exceed the specified end date.
Schedule Type Generate Accounting Periods Frequency Annual
Operations Group Execution Ad Hoc
Prerequisites None Conflicts None
5.5.1.2Reference Documents
Reference Title
2 Singleview System Operations Guide
Singleview Operations Guide
Multi-instance Instance List Null or specifically the active CB instance (ex SV1)
Name
Start Date Date Starting date of the period for which accounting years and accounting periods are
to be generated.
End Date Date End date of the period for which accounting years and accounting periods are to
be generated.
Accounting Period Type List Length of the accounting periods to be generated. Valid values are:
Calendar Month
Twelve periods of one month, each beginning on the first of the month
and finishing at the end of the month.
Calendar Quarter
Four periods of three months, each beginning on the first of the month
and finishing at the end of the month.
Four Weeks
Thirteen periods of four weeks, each beginning on any day of the week.
4-4-5 Weeks
Note:
Accounting Calendar [Text] The accounting calendar to which the generated accounting years and
accounting periods will belong.
Parameters Tab
Singleview Operations Guide
Click Save
5.5.2.1Description
The Sales Journal Posting Process posts financial transactions to the Sales Journal. Transactions
include invoices, payments, adjustments and normalized event files.
Note that once sales journal posting has happened that those transactions cannot be revoked.
For example once a bill run has been posted to the Sales Journal then the bill run cannot be
revoked. Similarly for rated usage. Hence it is recommended that this process be run allowing a
number of days to finalise underlying rating and billing. For example service provider may run
this task effective 3 days in the past to allow 3 days to finalise the underlying GL transactions but
this period will need to be determined based on operational practices.
Click Save
5.5.2.4Error Handling
Errors should be investigated and resolved. The failed task can be resubmitted. Failed sales
journal post tasks will impact the daily feed to the ERP system, as the extract files may not
contain up to date financial information.
Some common errors:
Error Action
If there are problems with the sales journal data, this is generally due to problems with the GL
details being written by billing, rating, orders and other GL-related tasks in Singleview and in such
cases those tasks need to be corrected. It may be necessary to revoke the sales journal process
as well if those underlying processes need to be revoked. See Section 5.5.7 “GL Sales Journal
Revoke” for how to revoke the sales journal posting.
5.5.3 GL Upload
5.5.3.1Description
Amounts posted to the Sales Journal may be aggregated for each GL code for later uploading to
an external financial system. A collection of such aggregations is known as a GL upload file and is
generated by the GL Upload File Generator process.
Note this process does not generate the actual files on the file system. This process collates the
information in a ‘staging table’ in the database. The data is extracted to files on the file system by
the next task (GL File Extract).
Singleview Operations Guide
The GL Upload File process uploads eligible postings from the Sales Journal that are relevant to a
particular file type and that are for a particular reporting entity. An eligible posting is one that has
not yet been uploaded by the GL Upload File process.
Schedules should be created for each file type, with appropriate effective date and periodicity i.e.
whether the files is required daily (e.g. POS file) or monthly (e.g. FACT file).
Note that once the GL Upload task has been run, the sales journal entries used may not be
revoked.
5.5.3.2One-Off Task
Sign on to the environment with your credentials
Click on Server Tasks from the menu bar
From the dropdown menu select One-off Task
In the Inserting One-off Task form, select GL Upload as the Schedule Type dropdown value
and fill in the parameters as follows:
Upload File Type List Upload file types are predefined. A task must be executed for each file
type.
Reporting Entity List Reporting entity for which sales journal entries are uploaded.
Click Save
2. Verify that status of the task is “Success” and that there are no errors reported in the
output.
5.5.3.4Error Handling
If the upload task fails, this will result in delayed reporting of financial information to ERP. Errors
should be investigated, resolved and upload re-submitted.
Errors may in particular be caused by lack of entries in various DA Tables. The table and
missing/erroneous data should be clear from the error message and in such cases the corrective
action necessary is to validate and correct the DA Table/s concerned.
5.5.4.1Description
The GL File Extract task creates physical GL extract files for sending to downstream financial
systems. The physical GL extract files will be generated from the GL Upload files.
A task must be executed for each extract file type and timing should be aligned to the GL Upload
schedules.
The extracted files will be transferred to the ERP system (IFS). A QA process is
required for file extract of type FACT. FACT files will be manually reviewed by the
service provider’s Finance team, prior to upload to the ERP system. Other extract
types will be automatically transferred to ERP via the Singleview File Transfer System.
Schedule Type GL File Extract Frequency Daily or Monthly, depending on file type
Operations Group Execution Ad Hoc
Prerequisites GL Upload Conflicts None
Extract File Type List Select the file type to extract: ADT, COB, FACT, ONACT-EXCESS FEE, POS
Name of the file (of the same file type specified in Extract File Type attribute) in the
GL Upload GL_FILE_UPLOAD table for which extraction is required.
List
Filename
Singleview Operations Guide
Click Save
5.5.4.4Error Handling
If the GL extract file generation failed, the underlying issue should be fixed and the task can be
resubmitted to generate the file.
5.5.5.1Description
The GL CSHUP Extract task creates physical GL files of type ‘CSHUP’ for sending to downstream
financial systems.
Instance Name
Click Save
5.5.5.4Error Handling
Issues will need to be investigated, resolved and the task re-submitted to generate the CSHUP
extract.
5.5.6.1Description
Only files in the GL_UPLOAD_FILE table that are not posted to an external system, can be revoked.
This schedule type revokes a previous GL Upload task. The revocation occurs at file level i.e. for a
specific file, of a specific file type.
5.5.6.2One-Off Task
In the Inserting One-off Task form, select GL Upload Revoke as the Schedule Type
dropdown value.
Click Save
5.5.7.1Description
This schedule type revokes a Sales Journal posting for a given posting type that has previously
been posted to the Sales Journal. The revoke process will reverse aggregations keyed on the task
ID by the GL Sales Journal Post schedule type.
Note that this is not possible if the postings have already been processed by a “GL Upload” task.
If there is then a need to revoke the sales journal, the “GL Upload” tasks need to be revoked first.
o Task ID: to the Task ID value that identifies the GL Sales Journal Post task that is to
be revoked.
Click Save
5.5.8.1Description
This schedule type closes the books on an accounting period. If no accounting period is specified,
the oldest open accounting period that has a close date less than or equal to the effective date is
closed.
Schedule Type Close Accounting Period Frequency Monthly
Operations Group Execution Scheduled/Held
Prerequisites Synergy GL Sales Journal Post Conflicts None
5.5.8.2Reference Documents
Reference Title
2 Singleview System Operations Guide
For example:
If month closing is July with “Aug 14th yyyy 12:00:00 AM” as Expected
Close Date, then effective date should be Aug 14th yyyy 12:00:00 AM
or later.
Note 1: The effective date of the Close Accounting period task does not have any relation
to the sales journal post as the user is selecting an accounting period to close or if not
provided it will close the oldest open accounting period.
Note 2: When accounting period to close is provided, it must have expected close date less
than or equal to the effective date of the task.
Note 3: Typically, accounts will have been verified in the ERP system before the accounting
period is closed in Singleview. For example, if there is a process to close the period
(calendar month) in the ERP system, then the Singleview accounting period can be closed
after ERP. Once the accounting period is closed, it is no longer possible to revoke the sales
journal postings for that period in Singleview.
Click Save
5.5.8.5Error Handling
When errors occur the task results will display the corresponding task error message to be
investigated. The task may been to be resubmitted, based on the nature of the failure.
The below table defines a sample set error failures, probable cause and operational action which
should be performed to resolve the issue:
Error ID E107013
Error Message No cashbox was found for the day.
Error Cause No cashbox entries were located.
Action Check if it is valid that no cashbox was found.
Error ID E08915
Error Message No accounting period exists as at <1:date/time> in accounting calendar
<2:calendar_name>.
Singleview Operations Guide
Error Cause No accounting period that spans the specified date/time exists in the
specified accounting calendar. The failed operation required an
accounting period to exist as at this date/time.
Action In the specified accounting calendar create an accounting period that
spans the specified date/time and retry the operation.
5.6.1.1Description
A bulk adjustment load facility is provided to load the adjustments into the system. This will be
achieved by a Singleview “Batch Load” schedule type.
The batch bulk loader interface will accept a CSV file containing adjustment details creating
account adjustments. This CSV file will be placed in a predefined input directory.
A Batch Load schedule can be configured to load adjustment files on a scheduled basis (e.g.
once per day) or the schedule type can be used to create a one off task to load files in an ad-
hoc manner.
5.6.1.3Error Handling
When errors occur the task results will display the corresponding task error message to be
investigated. The task may been to be resubmitted, based on the nature of the failure.
The below table defines a sample set error failures which were output in a Successfully submitted
task, probable cause and operational action which should be performed to resolve the issue:
Error ID E14062
Error E14062> External definition EVS call for CB entity ADJUSTMENT has failed with:
Message <E72863> Unable to find account with a ACCOUNT_NAME
of 000000000.
Error Cause Input csv file contains a invalid Singleview Account Name
Action Correct input file and resubmit just the failed records
Error ID E14062
Error <E14052> External definition element 'To_Account_Name' is mandatory for
Message external definition adj:adjust.AdjustmentInsert.
Error Cause Input csv file contains a null Singleview Account Name
Action Correct input file and resubmit just the failed records
Error ID E14062
Error <E14052> External definition element 'Currency' is mandatory for external
Message definition adj:adjust.AdjustmentInsert.
Error Cause Input csv file contains a null or invalid Singleview Currency value, it should be
$NAD
Action Correct input file and resubmit just the failed records
Error ID E14070
Error <E14070> The value 'XXX' passed for the list element Reason is not a valid
Message value in the list.
Error Cause Input csv file contains an invalid Singleview Adjustment Reason.
Action Correct input file and resubmit just the failed records
Error ID E14117
Error <E14117> Cannot convert the element Invoice_Number to the specified type.
Message
Error Cause Input csv file contains an invalid Singleview Invoice Number to which the
Singleview Operations Guide
Error ID E14062
Error <E14062> External definition EVS call for CB entity ADJUSTMENT has failed
Message with: <E72886> The value 11 specified for Amount is more than the configured
maximum value of 0.
Error Cause Input csv file contains debit adjustment record with a positive amount, it should
be negative.
Action Correct input file and resubmit just the failed records.
Error ID E21689
Error <E21689> Unable to move the file
Message '/syn/syndev1b/data/server/input/payment/input/asdfasfasdf.csv' to
'/syn/syndev1b/data/server/archive/asdfasfasdf.csv.20201103124148' due to an
unexpected error; '<E02799> Error moving file
"/syn/syndev1b/data/server/input/payment/input/asdfasfasdf.csv" to
"/syn/syndev1b/data/server/archive/asdfasfasdf.csv.20201103124148".
Error Cause Problem moving the processed file to the active directory.
Action Check the file and the target directory actually exist.
5.6.2.1Description
A payment load facility is provided to batch load EFT payments via a Singleview “Generic
Batch Loader” scheduled task. This process supports payments received from external
collection agencies.
The task will process all payment files from a predefined input directory and matching a
filename format. Singleview will process each record and create an applied EFT payment to
the customer’s account.
If a valid payment is received but a target customer account could not be identified then
Singleview will apply the payment to an interim Unidentified Account for manual processing
and application to the correct account.
The configuration item ‘EXTERNAL_AGENCY_PAYMENT’ defines the specific settings for the
batch payment load via Generic Batch Loader.
5.6.2.2Schedule Setup
Sign on to the environment with your credentials
Click on Server Tasks from the menu bar
From the dropdown menu select Schedule Type
Click on Create New Schedule radio button
Click on the New button
In the Inserting Schedule form, click on the Settings tab and fill in the parameters required
o Loader Configuration = ‘EXTERNAL_AGENCY_PAYMENT’
5.6.2.3Error Handling
When errors occur the task results will display the corresponding task error message to be
investigated. The task may been to be resubmitted, based on the nature of the failure.
Refer to table from within ‘Bulk Adjustment Load’ Error Handling for similar types of probable
error messages.
Singleview Operations Guide
5.7.1.1Description
This schedule type creates an anonymous contact, customer and pre-active prepaid service for
each complete and valid pre-active SIM record received. These services support prepaid
activation.
A separate schedule Prepaid Activation Load Outbound File Transfer transfers details of the
prepaid bulk load to Service Order Management.
Loader Configuration [List] Configuration items of type BULK_LOADER. This defines the input directory and
other loader behaviours.
Parameters Tab
Click Save
Singleview Operations Guide
5.7.1.3Error Handling
When errors occur the task results will display the corresponding task error message to be
investigated. The task may been to be resubmitted, based on the nature of the failure.
The below table defines a sample set error failures, probable cause and operational action which
should be performed to resolve the issue:
Error Id E90000
Error Message File '/syn/synprd1b/data/server/input/Ok4_pre-provisioning_XXXX.csv'
contains errors.
Or ERROR loading record on line #XXXX of input file
Error Cause An exception occurred within fCMN_TREProductInstanceCreate& while
calling EV_ProdInstInsert& (to insert companion product)
Error ID E104007
Action Resolve input record error and resubmit the request in a different filename.
Error ID E05643
Error ID E72130
Error ID E72327
Action The prepaid ICCID is already active, review the input record and determine
if it can be ignored.
Error ID E104010
Action Update the failed input record to define the pre-activation date in the
correct format.
SELECT
*
FROM
mtc_ocs_life_cycle_data
WHERE
--msisdn='814085255'
--and error_details is null
action = 'ACTIVE'
and processed_task in
(
SELECT
distinct task_queue_id
FROM
ops$synprd1b.task_queue_result
where
task_queue_id ='600000327240'
)
order by status_date desc;
a. Check for un-processed records i.e. records in the OCS table where extracted is NULL
b. Update ACTIVE records that are not processed, based on workaround
Singleview Operations Guide
a. Update the status date of the ACTIVE record that was not processed
UPDATE
mtc_ocs_life_cycle_data
SET STATUS_date = to_date(substr(error_details,110,19),'dd/mm/yy hh24:mi:ss') +
INTERVAL '1' MINUTE
WHERE
extracted is null and action='ACTIVE' and error_Details like '%is before the
current record effective date%'
;
COMMIT;
An Action Suite may contain 1 or more fulfilment actions which can include Order Qualification
Check or a Product Order request to trigger outbound provisioning. Where outbound provisioning
is triggered then Singleview will wait for its Completion response from SOM before it attempts
activation of the market offer instance in Singleview.
At various points in the order flow there may be order fallout errors, these errors are trapped and
displayed within the the below action types :-
productOrder
Manual Task
Service provicer can review the order failure message and determine how to address the issue,
this may involve a data fix to resolve this underlying issue and a push request to submit the order
for activation again. When determining the course of action Service provicer should review the
following order details
Order Status
Status of Order Fulfillment Actions
SOM Status within productOrder
Error Message contained within productOrder and Manual Task actions
Please review the below table and recommendation how to address the issue.
Error ID <E05523>
Error Message Error Message: <E05523> Expansion of record date range is
disallowed.
Error Cause Another Order or backend process has update the Market Offer product
instance with a later Effective Start Date than this order Effective Start
Date
Action Recommend updating the associated Order Effective Date (ex Alter
Order) or cancelling this order (ex Upate Product Details order) and
retrying with current date/time
Error ID <E03552>
Error Message Error Message: <E03552> SQL: Oracle error ORA-02049: timeout:
distributed transaction waiting for lock during operation SELECT
customer_node_id FROM customer_node WHERE customer_node_id
= :cnid FOR UPDATE.
Error Cause Multiple orders on the same customer created a lock forcing some of
the orders to wait.
Singleview Operations Guide
Error ID <E03622>
Error Message Error Message: CM-ERRMSGID=EpmRuntime1=<E03622> Tuxedo
function tpcall has failed with error "TPESYSTEM - internal system error"
while attempting to call function fCMN_TREProductInstanceCreate_R& in
service biFnEvaluateRW.
Error Cause Timeout issue
Error ID <E72401>
Error Message Error Message: <E72401> Unable to delete Product Offer 'ZTE Mf 79S
(NI)'. The operation is inconsistent with what exists.
Error Cause Usually a case when the intended purpose of the order was performed
by another order.
Action Verify if all the changes in the order got affected on the service.
o If Yes then run the accept_order.epm script through
expression test, and no further action needs to be taken
o If No , then the actual component (ZTE Mf 79S (NI)) with
all of its parent nodes needs to be removed from the
order tree, so that the actual order can be progressed.
Service provicer should raise a Remedy incident for
Limited Configuration Support to remove the invalid
component from the order and then Service provicer can
resubit the request.
Error ID <E05652>
Error Message Error Message: <E05652> Product instance 816978041 has an invalid
status of Moved as at 03/09/2022..
Error Cause Another Change of Ownership order has updated the service while this
order was being provisioned
Error ID <E05667>
Error Message Error Message: <E05667> The status of this product instance cannot be
updated.
Error Cause Another Change of Ownership order has updated the service while this
order was being provisioned
Error ID <E05739>
Error Message <E05739> A service with name "811404320" is already active between
03/18/2022 and 12/30/9999..
Error Cause The Service number referenced in the error message cannot be
activated in Singleview as it is already active under this or another
customer account
Action The original order which was provisioned on the network has an
incorrect Service Name, this service name cannot be used as its
associated to another customer. Recommend Service provicer identify
a different service name, update SOM with it details and supply CSG L2
Team with the Service Name, CSG will update the Order with the
revised service name and then attempt re-activation.
Error ID <E05865>
Error Message Error Message: <E05865> No instance of companion product Legacy
Device, which is mandatory for product offer Legacy Device -
Installments, exists as at 02/26/2022.
Error Cause Legacy Feature which was used only for migration purposes was set up
as mandatory. After moving it to optional, the orders will no longer face
this issue
Action The order needs to be reviewed, and whether the changes in the order
are still applicable, the order can be pushed to “Accepted “ via backend
or cancelled if there is nothing else to be updated in SingleView
Error ID <E72393>
Error Message <E72393> A non-cancelled product instance could not be found with
the ID of '100257153356' at 'Tue Mar 15 15:51:04 2022'.
Error Cause The referenced Service was updated by another order while this order
was inflight
Action Recommend that Service provicer review this order and determine if the
order request should be cancelled from SOM. If order is still required
then raise issue via Remedy to CSG Limited Configuration Support.
Error ID <E72826>
Error Message <E72826> The Equipment Serial Number field (column GENERAL_3) is
mandatory. Please specify a non-null value for this field..
Error Cause An order was created with physical equipment which requires a
mandatory Serial Number to be present at point of activation, this Serial
Number is not removed and must be populated in order to activate the
order.
Action Service provicer to review the order and determine what bundle serial
number is missing. CSG will then update the order to include the
missing data, Service provicer and then attempt to resubmit it.
Error ID <E72396>
Error Message <E72396> The OPERATION_IND or OPERATION_IND_CODE key/value is
mandatory for the companion product node in the update structure
within the Product Offer 'Mobiz Duet 900'.
Singleview Operations Guide
Error Cause This issue usually occurs from Offer Migration orders where the user has
not selected a valid target Market Offer instance to migrate too. A
configuration code fix was applied that should prevent for new orders
Action Manual data invention required, Service provicer can raise a Remedy
incident for Limited Configuration Support to resolve this issue.
Error ID <E72392>
Error Message <E72392> The companion product prodprice.contract.feature is not
compatible with the product offer One on One (1) in the node specified.
Error Cause The order contains an ordered component that is not compatiable in
target market offer structure
Error ID <E04250>
Error Message <E04250> Assertion "length(l_OfferDetails?
{'CHILD_PRODUCT_OFFERS'}[]) = length(lFound?[])" failed on line 354
in "fCM_OE_BundleAPOProdOffers&".
Error Cause Singleview has determine the order structure sent for activation
contains one or more invalid ordered component in target market offer
structure
Action Manual data invention required to obsolete the ‘rouge’ ordered
component feature and then resubmit the order for activation again.
Error ID <E21451>
Error Message <E21451> Offer 'Staff Discount' can be assigned at most 1 optional
child offers..
Error Cause Singleview product catalogue constraints stipulate that there must be at
most one staff discount offer sold
Error ID <E72401>
Error Message <E72401> Unable to delete Product Offer 'Voice Roaming'. The
operation is inconsistent with what exists.
Error Cause The order includes a request to remove a bundled offer which has
probably already been removed by a previous order activation.
Singleview Operations Guide
Error ID <CM-41543>
Error Message <CM-41543> Cannot start a new transaction for built-in EPM function
ObjectUpdate in triggered operation ET_OBJECT_PRE_COMMIT
o_Commit.
Error Cause This is a one off issue that cannot be reproduced, Singleview is attempt
to start a new transaction when already in flight with the current
transaction, this is not allowed
Action Recommend Service provider to resubmit the order again, or cancel if
required
Error ID
Error Message
Error Cause
Action
5.9.1.1Description
This schedule type loads the virtual vouchers defined in the file received from NGVS. The loaded
virtual vouchers (modelled using the Voucher equipment type entity in Singleview) are then
available for sale via Singleview CM.
Click Save
5.9.1.4Error Handling
Error Id E96559
Error Message The attempt to create a request for the FTS has failed
Error Id E96555
Error Message The FTS daemon process is not running. No transfers are allowed
5.9.2.1Description
This schedule type generates a stock level report on virtual vouchers available in Singleview.
Notifications are generated in case stock levels breach the defined thresholds. Configuration item
VOUCHERS defines the system settings for this report (threshold, email address, output directory,
etc.)
Click Save
5.9.2.4Error Handling
Error Id E14026
Singleview Operations Guide
5.10 Collections
Refer to section for details on Collections reports from Singleview. Also note the payment and
adjust load schedule types described in section 5.6 may be relevant for processing of customers
in collections or customers who are with a collection agency.
Refer to chapter Verifying Task Results for details on now to view and update Singleview
Scheduled Functions.
5.10.3 Treatment Entry
If a customer enters treatment, a treatment process scheduled function is inserted for that
customer with a schedule start date of when the first progression is due. An operation code is
used to signify the treatment process was initiated by treatment.
The following scheduled functions are executed to insert a customer into Treatment:
Treatment.mon.fProcess& - Initial Treatment monitor process
Treatment.act.fDoUpdate& - Insert a Customer into Treatment on a Specific Treatment
Step
fSC_TRT_UpdateCM& - If Treatment Monitor process requires CM interaction to create a
Treatment case, issue, query or action.
Singleview Operations Guide
5.10.8Monitor Logging
On a daily basis Singleivew will evaluate a number of customers for treatment entry/ progression
or exit. The evaluation of each treatment monitor process will be logged within a treatment.log
file stored in the fileserver data/log directory.
The log will include one or more rows per customer treatment process evaluation that will assist
backoffice teams in identifying how the customer progressed through the treatment evaluation
process. See sample file below
5.10.9.1 Description
This schedule retrieve all customers who have entered the ‘External Collection Agency’ process
step since the last time the task was generated and who qualify for agency inclusion.
The underlying selection logic is to retrieve all open ‘External Collection Agency’ customer queries
in Status = ‘Pending Agency Entry Extract’ and output them to a External Agency Extract file
record if they still have an outstanding collection amount due.
The below table defines a sample set information, alert and error messages which appear in the
/log/treatment.log monitor file. The probable cause and operational action which should be
performed to resolve the issue:
Message Action
Type
Error Cust 161589 Action: 900155907 - Treatment progress of query Id 148974 to a
Message level of Email
Error Cause Information Message to indication that a customer progressed successfully to
the next treatment step.
Action No Action Required.
Error ID Information
Error Info: 900162308 - Exit no action. Did not reach minimum treatment value
Message
Error Cause Customer outstanding balance did not meet minimum treatment threshold limit.
Action No Action Required.
Error ID Alert
Singleview Operations Guide
Error Cust 168350 Alert: 900162308 - Treatment exit. Query Id 132405 Closed
Message
Error Cause Customer has exited treatment successfully.
Action No Action Required.
Error ID Information
Error Cust 180389 Info: 900174727 - Exit no action. Amount owning -2010 did not
Message reach minimum treatment value 50
Error Cause Customer outstanding balance did not meet minimum treatment threshold limit.
Action No Action Required.
Error ID Information
Error Cust 178190 Warning: 900172527 - Treatment exempt, no process/action
Message taken
Error Cause Customer has been defined as Treatment Exempt and whose Treatment Exempt
Expiry Date is still Valid, customer is not eligible to enter Treatment.
Action No Action Required.
Message Error
Type
Error Cust 116824 Error: 900113464 - No email address was found for associated
Message person 118346
Error Cause The customer has transitioned to a Treatment Step where a email address was
required but none on the customer account
Action Consult with customer care to define a valid email address against this customer
account.
Error ID Error
Error Cust 120424 Error: 900116564 - <E07511> Adjustment AP00001265768
Message amount of -40001918.860 is greater than the maximum allowable adjustment
amount of 100000.000 in CURRENCY of Dollars, for the user. -
Treatment.act.fPenaltyFee& - 256
Error Cause Treatment Plan requires a penalty adjustment but the amount exceeds the
adjustment limit of the TREATMENT user profile
Action Refer to AR RACA Team to request their department to take the fee.
Error ID Error
Error Cust 179469 Error: 900173887 - <E100012> Phone number '123' is not valid. -
Message Treatment.act.fSendSMSBySMPP& - 240
Error Cause The customer has transitioned to a Treatment Step where a sms was required
but a non-valid Mobile Number from service provider was defined on the
associated customer contact.
Singleview Operations Guide
Action Consult with customer care to define a valid Mobile Nubmer against this Contact
entity on the associated customer account.
The below table defines a sample set of error messages which may present in the CB GUI –
Schedule Functions where Scheduled Function Category is ‘Treatment’. The probable cause and
operational action which should be performed to resolve the issue:
Message E77332
Type
Function Treatment.act.fDoUpdate&
Error <E77332> Customer Node Id 172129 had action function 172129 return (0)
Message indicating failure. Rollback all updates
Error Cause The customer transitions to a Treatment Plan Step which could not be
successfully executed.
Action Refer to the treatment.log for additional failure reasons.
Message E03678
Type
Function fSC_TRT_UpdateCM&
Error <E03678> Request failed with PE server message: "<GEN-45146> The new
Message Start Date entered (Tue May 4 12:10:20 2021), cannot be greater than the
current End Date (Tue May 4 12:10:19 2021)."
Error Cause Invalid Singleview Scheduled Function start date.
Action Investigate why the current end dae is defined and if you need to resubmit the
scheduled function with update date information
Message E100012
Type
Function SMS.SendBySMSType&
Error <E100012> Phone number '7656756454' is not valid.
Message
Error Cause Treatment Scheduled function attemped to send a customer SMS to a invalid
mobile number.
Action Consult with customer care to define a valid Mobile Number against the
customer contact entity.
If Mobile Number is 9 digits then it cannot start with a 0, else valid
Else if Mobile Number is 10 digits then first digit must be 0, else valid
Else if Number Prefix is +264 then replace +242 prefix with 0
Else if Number Prefix is 00264 then replace 00242 prefix with 0
Else else invalid
Message M13512
Singleview Operations Guide
Type
Function Treatment.act.fDoUpdate&
Error <M13512> Failed to evaluate scheduled function Treatment.act.fDoUpdate&.
Message The tuxedo service responsible for evaluating this function is not available.
Tuxedo error is '<E03622> Tuxedo function tpcall has failed with error
"TPENOENT - no entry found" while attempting to call function
fSC_TRT_CheckManualActionExists& in service cmFnEvaluate.'.
Error Cause Tuxedo execution issue
Action Check the tuxedo services to ensure they are running as expected.
Message E03678
Type
Function fSC_TRT_UpdateCM&
Error <E03678> Request failed with PE server message: "<E00014> This record for
Message customer query 'TRT00001469634' was updated by another user. Close the form
without saving and re-query to access the current version."
Error Cause Singleview is attempting to update the Treatment Query with an incorrect Last
Modified Date when another user (maybe treatment itself) has updated it with
since then.
Action Resubmit the failed process.
Message CM-40041
Type
Function mtc.sch.fSCUpdateOrderCreate&
Error <CM-40041> An error has occurred accessing the database. The error message
Message '<E03552> SQL: Oracle error ORA-01653: unable to extend table
OPS$SYNDEV1B.ORDER_VAL by 128 in tablespace DATA during operation insert
into ORDER_VAL (ObjKey,
rowkey ,i4,i9,i7,i8,i3,i6,i11,i5,i10,i1,i2,i12,i13,d6,d3,d7,d5,d4,d1,d2,t1,s5,s3,s2,s
4,s1,s6,s7,s8) values
( :objkey, :rowkey, :i4, :i9, :i7, :i8, :i3, :i6, :i11, :i5, :i10, :i1, :i2, :i12, :i13, :d6, :d3
, :d7, :d5, :d4, :d1, :d2, :t1, :s5, :s3, :s2, :s4, :s1, :s6, :s7, :s8).' was returned.
Error Cause Oracle database extend error
Action Consult with Oracle dba team to extend the database table.
Message E03622
Type
Function Treatment.mon.fProcesss&
Error "<E03733> "TPETIME - timeout occured" when processing incoming request
Message Treatment.mon.fProcess&. Request started at Fri Feb 25 14:28:02 2022 with an
automatic local transaction timeout of 30 seconds" while attempting to call
Singleview Operations Guide
Message E08250
Type
Function SMS.SendBySMSType&
Error <E08250> The treproxy received an error from the remote service:
Message com.adc.tre.srv.InvokeException: java.net.SocketException: Socket is closed -
Treatment.act.fSendSMSBySMPP& - 239
Error Cause SMS cannot be sent issue with SMS Gateway
Action Check if Singleview can communicate with the SMS Gateway, check
configuration setting of SMS Interface setup
Message E00162
Type
Function Treatment.act.fDoUpdate&
Error <E00162> Maximum array size of 10000 exceeded on line 199 in
Message "mtc.trt.actfSuspensionOutgoing&".
5.11.1 Description
The Credit Provider Report is an extract which is expected from all Credit Information Providers.
It is extracted from Singleview and sent to the Credit Bureau. It is used to build a history of
payments and behaviors of a specific account number for a specific customer.
An output file with successfully processed records is generated and will be transferred to the
Trans Union based on the connection and file path details mentioned in the configuration item
“FTS_LOCATION_SFTP”.
Sender, Recipient and File type attribute values shall used from configuration item –
“CPL_EXTRACT”.
Test Mode Indicator – Indicate that the report being generated is for testing/validation purpose.
File Name: File with the list of customer accounts for which data extract required.
5.11.3 CPL Extract One Off task set up for Daily and Monthly
Singleview Operations Guide
CPL Extract Type : Drop down to select to set up whether report being executed is for monthly or daily CPL
data extract schedule.
When errors occur the task results will display the corresponding task error message to be
investigated. The task may been to be resubmitted, based on the nature of the failure.
The below table defines a sample set error failures, probable cause and operational action which
should be performed to resolve the issue:
Error ID E90008
Error <E90008> SQL Error: ORA-01654: unable to extend index
Message OPS$SYNUST1B.P_MTC_CPL_EXTRACT_STATUS by 1024 in tablespace DATA_IND (DBD ERROR:
OCIStmtExecute).
Error Cause The system attempted to run an invalid SQL query.
Error Action Re-Run task in debug mode to trace the issue and consult support team on underlying issue.
Error ID E90008
Error <E90008> SQL Error: ORA-00054: resource busy and acquire with NOWAIT specified or timeout expired
Message (DBD ERROR: error possibly near <*> indicator at char 23 in ' TRUNCATE TABLE
<*>MTC_CPL_EXTRACT_STATUS
Error Cause The system attempted to run an invalid SQL query.
Error Action Re-Run task in debug mode to trace the issue and consult support team on underlying issue.
Error ID E90008
Error Message <E90008> SQL Error: ORA-01008: not all variables bound (DBD ERROR: OCIStmtExecute).
Error Cause The system attempted to run an invalid SQL query.
Error Action Re-Run task in debug mode to trace the issue and consult support team on underlying issue.
Error ID E90008
<E90008> SQL Error: ORA-30036: unable to extend segment by 8 in undo tablespace 'UNDO' (DBD
Error Message ERROR: OCIStmtExecute).
Error Cause The system attempted to run an invalid SQL query.
Error Action Re-Run task in debug mode to trace the issue and consult support team on underlying issue.
Error ID E06002
Error Message Unable to connect to database
Error Cause The perl script was unable to connect to the database using the user name and password given.
check that the database is still operational, and that the environment variables $ATASVRCONNECT
Error Action and $ATADBACONNECT are set correctly.
Error ID E00423
Error Message <E00423> tlm: Process for task 700000000691 terminated abnormally.
Error Cause The process for the specified task terminated in an abnormal manner.
Error Action Use the task output to determine the cause of the abnormal termination, then correct it.
Singleview Operations Guide
Error ID E00421
Error Message <E00421> tlm: Error executing command: mtc_cpl_extracts
Error Cause The SingleView system failed when attempting to execute the specified command.
Error Action Re-run task with debug mode to trace issue, and consult with support team on the underlying issue.
Please refer to section “Database Validation” within product documentation ‘System Operations
Guide for Singleview Convergent Billing 9.1’ (under section “Schedule Types and Descriptions”)
and ‘System Administration Guide for Singleview 11’ for more information.
Note: The DVP plays an important part in pro-active error management. The earlier errors are
detected, the less of an impact they will have on other Convergent Billing processes.
Partition List Comma-separated list of customer partition numbers. Only table partitions belonging to the
specified customer partitions are checked. The Partition List parameter must not be specified
if the Instance Partitions Only? Parameter is specified.
Instance Partitions only? Option indicating that processing is restricted to table partitions belonging to customer
partitions where the rating instance is the same as the instance where the task is running. The
Instance Partitions Only? Parameter must not be specified if the Partition List parameter is
specified.
Exclude Table List Comma-separated list of tables. Checks associated with these tables are omitted.
From Table Name String for comparing to tablenames. Only checks associated with tables whose name occurs
alphabetically after the string are processed.
Maximum Errors Maximum number of messages to output for each check. If more errors occur for an individual
check, a summary message is issued indicating the number of additional messages that have
been suppressed. If a table is marked as partitioned, the message limit is applied separately to
each partition.
Output file Name of the file used to record messages and the slowest queries summary.
Number of Child Number of child processes over which to distribute the checks.
Processes
Minimum Priority Integer identifying the lowest priority check processed. Only checks of this priority or higher
are performed. Higher priorities have a lower number.
Partition Start Date Earliest date-time of a partition that is checked. Partitions of date partitioned or entity and
date partitioned tables with a date partition column greater than or equal to the specified
date-time are checked.
Partition Maximum date Latest date-time of a partition that is checked. Partitions of date partitioned or entity and date
partitioned tables with a date partition column less than or equal to the specified date-time
are checked.
Report statistics Option to indicate if processing statistics are required. If set, statistics are maintained and
logged to the tremon process on completion.
Classification String identifying the class of tables or checks that are processed.
o On the task generation tab, fill in the parameter as follows:
Parameter Description
Baseline Duration 7200
Maximum Duration Nil
Purge Period Nil
Tasks Updated to Held Unchecked
status when ready to
run?
o On the prerequisites tab, fill in the parameter as follows:
Parameter Description
Prerequisite Schedule Nil
Name
Condition Nil
o Click Save
The output from the DVP is a listing of each table it has checked. Any validation errors found in a
table are listed after the table name in the output.
An extract from the DVP output is shown below. This is not the full output – just a portion of it.
Checking table CUSTOMER_NODE...
Checking table CUSTOMER_NODE_HISTORY...
Checking table CUSTOMER_NODE_INV_FORMAT...
Singleview Operations Guide
<E50460> The expression list in the EXPRESSION_LIST table with EXPRESSION_LIST_ID 80393
is not referenced by any rows in the EXPRESSION_LIST_VALUE table.
<E50461> The row in the EXPRESSION_LIST table with
EXPRESSION_LIST_ID 80393 is not referenced by any other entities.
- dvp.xml
The dvp.xml file is the product file that contains the SQL scripts that are run to identify each
DVP error. There are often additional notes on each error documented in the dvp.xml. The
Singleview Operations Guide
dvp.xml file can be found on the server in the $ATA_REL_SERVER_BIN directory. It is often
helpful to copy the relevant SQL statement from dvp.xml file that is being run by the DVP
check and run it in SQL to examine all the records with that error.
Change the Search Field value to Error Code. In the Search Criteria field enter the full error
code including the E, M or W character at the start of the code. If you just want to search on
the code without the alphabetical character, then change the Search Field value to Error
Message ID.
Each error message has details on the possible cause of the error and corrective action to take.
<E50080> The row in the ATLANTA_PROFILE table with Profile Name “_READ_ONLY”
has a primary group of _DATA but does not have insert privileges for that
group.
This error should be a warning only and is not a true error. It is reporting that there is a security
profile that does not have insert access into its default security group. This is what we want for
the _READ_ONLY profile as it is only meant to allow view only access to the application. No action
required for this error. Managing Client Customized Database Objects
Client has a requirement to create custom database objects in addition to the objects CSG
provides. CSG recommends the following solution to address this requirement:
Client should create their creation scripts with the following naming convention:
atai_Client<description>.sql
The script should then be put into the $ATA_DATA_SERVER_CONFIG directory to be picked up
and used by the atai_dbrebuild and atai_dbsync utilities.
It is also necessary that the Client will inform the CSG implementation team as to the exact
name of the database creation script so that a skeleton file can be included in a release.
The atai_dbsync and atai_dbrebuild scripts require that a file of the same name as any custom
script to first exist in either the ATA_REL_SERVER_CONFIG or ATAI_REL_SERVER_CONFIG
directories. To address this requirement an empty file of the same name must be installed in the
$ATAI_REL_SERVER_CONFIG directory by the releaser. Once Client has provided CSG with the
Singleview Operations Guide
filenames of the custom creation scripts they are free to modify the contents as often as they
wish without having to further inform CSG.
If sample scripts are required refer to the *.sql scripts in either of the $ATA_REL_SERVER_CONFIG
or ATAI_REL_SERVER_CONFIG directories as examples.
Note: To keep file transfer to Transunion and data extract file generation as a separate activity it
is advisable to use the Initiate Outbound Transfer task.
For transferring the file to the remote system, transmission can be initiated using the one-off task
“Initiate Outbound Transfer”.
Connection details mentioned in the configuraton item - FTS_LOCATION_CPL_EXTRACT and
FTS_INTERFACE_CPL_EXTRACT shall used for FTPing the files to TU.
The Singleview CB GUI provides forms to search, retrieve and view the status of scheduled
functions in the Singleview application.
To ensure that scheduled functions are processed at the time and date required, Singleview
provides a number of settings which can be changed by the operations team to tune throughput
and maintain overall server performance.
Singleview Operations Guide
The following sections describe how to manage scheduled functions. Further details can be found
in the Singleview product documentation [3].
Place a limit on the number of threads a particular category may use at any one time
The default setting is not to use any thread limits.
Whenever pending functions that are eligible to run are delayed by more than the Maximum
Delay Time as configured on the SFM1 interface definition, a warning message will appear in the
log.out.
<09809> Tue Sep 6 01:56:51 2016
<W> sfm 1: Scheduled functions have been delayed in the past 500.72 seconds such that the
acceptable maximum delay has been exceeded. The largest delay was 650.91 seconds.
errno = 0, pid = 8831, login = tpsysadm, process = sfm, user = , client =
This warning message indicates that scheduled functions are starting to back up as the rate of
scheduled functions that are becoming eligible to run are outpacing the rate of scheduled
functions that are processed. A warning message is logged every Warn Repeat Period if functions
continue to be delayed. Once resources are available, the delayed scheduled functions are
processed in the queued order without any need for manual intervention.
Note that warning messages could be acceptable depending on the functions that are being
delayed. For example, if a thread limit is configured for a particular category, functions could end
up being delayed. For more specific details on delays, getstats reports both an average and max
delay by category.
The below report will look-back over the last 7 days and per scheduled function category
determine the number of :
Pending
Running
Success
Fail
Failure Retry
8,'ENTITLEMENT_ALLOCATION',
9,'PURGE',
10,'BILLING',
11,'ENTITY_REPLICATION',
12,'WORKFLOW',
13,'EVS',
14,'BANNER_MESSAGE',
15,'ENTITY_REMAP',
16,'PURGE_CACHE',
17,'CLOSE_CASE',
18,'SY_NOTIFICATION',
19,'ALERTS',
20,'DEPOSIT',
21,'PORTING',
102,'SMPP_ACTION',
103,'OUTBOUND_API_STANDARD',
104,'CANCEL_CASE',
105,'CLOSE_ISSUE',
'other') category
, case status_code when 1 then 1 else 0 end pending
, case status_code when 2 then 1 else 0 end running
, case status_code when 3 then 1 else 0 end success
, case status_code when 4 then 1 else 0 end fail
, case status_code when 5 then 1 else 0 end fail_Retries_pending
, 1 nr
FROM scheduled_function s
WHERE scheduled_start_date BETWEEN sysdate-7 AND sysdate
)
WHERE 1=1
GROUP BY sched_dt,category
ORDER BY 2,1;
Functions can be searched for using different criteria or a combination of criteria. For
example, to find all failed functions in the last hour simply specify both the Failure status and
the From and To dates appropriately. If you want to further limit the search to functions that
failed with a specific error code, then also populate the Error Message ID (e.g., 95207) with the
code that you are interested in. Once the criteria have been set, press the Search button.
If there are any matches for the specified criteria, a summary of the results is displayed in a
new window.
Selecting a row and pressing the Bulk Update button allows bulk updating of scheduled
functions:
Double-clicking a row or selecting a row and pressing the View List button will display a list of
the individual functions for that summary row in the List tab.
Singleview Operations Guide
Double-clicking a row here or selecting a row and pressing the Details button will display the
details for a particular scheduled function.
If the status is not Success, the function may be updated to resubmit it, reschedule it, etc.
Note that functions with a status of Failures (Retries Pending) indicates that a function has
failed, but will be resubmitted automatically. The Retry Count indicates how many automatic
retries remain and the Retry Period (secs) indicates how long to wait between retries.
5.12.3.4 Resubmitting
To resubmit an individual function, simply search for the function, open the detail form, and
press the Update button.
Update the scheduled start date to the desired start date and press Save.
To resubmit a set of functions, simply search for the set of functions to be resubmitted and
press the Bulk Update button on the summary results tab. A detail form for one of the
functions is opened in update mode. Updating the scheduled start date to the desired start
date and pressing Save will update the entire set of selected functions.
Note that resubmitting failed functions that are eventually successful will not result in the
Error Message columns being cleared. Resubmitted failed functions that fail with a different
error will overwrite the Error Message columns with the new error message.
Singleview Operations Guide
5.12.3.5 Getstats
The sfm process collects statistics about the scheduled functions it runs. The statistics
provide a summarized view of success counts, error counts, delays and queuing by category.
These statistics can be used to identify potential changes to the SFM1 interface definition.
The following is a sample of the output that is most useful:
$ getstats -post SFM1
Version: 8.00.08.21; Current date & time: 2016-09-06 12:29:48; Pid: 5836
Uptime: 12:29:48 up 39 days, 14:07, 10 users, load average: 1.88, 1.94, 2.18
Run on machine: svwapp01c; Database SID: SVW1P; Command line was: << -post SFM1 >>
CB Server Version: 8.00.08.21 CB Client Version: 8.00.08.21 Number of CB clients : 90
Response received from all 1 servers.
WARNING[201]: Can't find Hash Key <ThreadsPool> Value=HASH in the detail table <sfm> (Key not
defined but in the event data);
Called from GetStats.zPrAll.zPrServer.ServerPrint.Details::CheckStats:300
Server: sfm (18373; 1) logged at date 2016-09-06 12:29:48; Server Version= 8.00.08.01
Process Start :Mon Sep 05 14:28:07 2016
Up Time : 79302 s
User Time : 938.84 s (User uptime:1.18%)
System Time : 482.10 s (System uptime:0.61%)
CPU Time : 1420.94 s (Cpu uptime:1.79%)
Process Memory : 588160 KB
Pages In : 0
Pages Out : 0
ProcessId : 18373
TUXEDO Requests : N/A
Socket In : 0
Socket Out : 0
Block In : 0
Block Out : 272
Instance : MASTER
HostId : 121.135.016.172
HostName : svwapp01c
CSV : 18410758
CSIV : 69600
Local Statistics:
Max Evaluation Threads : 10
Queue Size Threshold : 30000
Delay Time Threshold : 300 s
Warn Repeat : 60 s
Queue Warnings : 29
Delay Warnings : 35
SFM Functions Evaluated by Category:-
Category Success: Count Elapsed(s) Avg(ms); Error: Count Failures Retries Elapsed(s)
Avg(ms); Delay: Elapsed(s) Avg(s) Max(s); Queue: Current Max
ACCOUNT_MANAGEMENT 23293 2754.93 118.27 25 25 0 2.66
106.57 2570632.42 110.24 270.86 0 6000
NOTIFICATION 157882 788.19 4.99 0 0 0
0.00 0.00 36491683632.44 *******338191.79 0 6002
ENTITLEMENT_ALLOCAT% 22 3.12 141.84 11028 11028 0 321.03
29.11 19629.54 1.78 3.34 0 117
RECURRING 250422 20056.62 80.09 18 18 0 0.98
54.67 10512576.96 41.98 885.86 0 6000
ONEOFF 250499 1974.12 7.88 0 0 0
0.00 0.00 10514278.76 41.97 885.83 0 6000
PURGE_CACHE 252477 1417.82 5.62 4 4 0
0.00 0.00 144818596.82 573.58 1021.08 0 6000
The numbers reported by getstats are the volumes processed by the sfm process since it was
started.
5.12.3.6 Tuxservers
When there are reports of the system being slow, one of the first places to look is at the
Tuxedo servers that are busy and whether there is any queuing occurring.
$ tuxservers -b
Tuxedo server information for server 'svwapp01c' environment 'svw1p' at 2016-09-06 12:59:55.296782
Server Program Stat PID GEN QLen ReqQId RlyQId RqDone TrBgn TrCmt TrAbt
RqOut Curr Serv From S RTime RGp
---------------------------------------------------------------------------------------------------
---------------------------------------
RWDB.455 trerwdb ACT 23334 1 0 334169441 334202210 33106 32763 32761 1
176273 biMRCGenRW:T 17318 Y 0 112
RWDB.456 trerwdb ACT 23340 1 0 334267747 334300516 36910 36404 36400 3
197382 biMRCGenRW:T 17577 Y 0 112
Singleview Operations Guide
Refer to the Singleview Systems Operation Guide [2] for further information.
As well as freeing up disc space, moving unwanted files off the server also keeps the directories
less cluttered making it easier to find current files that are required.
Directory Details
/data/server/invoices/images - Invoice images created during a bill run are placed in the images
directory.
/data/server/output/printvendor
- Once the invoices have been FTP’d to their final destination, they are
no longer required by Singleview. The files should be retained for a
reasonable period of time in case the files need to be re-sent to their
destinations.
/data/server/error - These directories contain corrupt normalised event file records
- These files are not required for any further processing (or
reprocessing) in Singleview and can be moved off the server.
/data/server/archive - These directories contain the processed normalised event files. These
files are not required for any further processing once their contents
have been billed. They should be kept at least for the duration of the
billing period.
- Once their contents have been billed these files cannot be revoked in
CB and therefore can be moved off the server.
/data/server/log - Log files may be rotated via Singleview schedules. Old log archives can
also be deleted via Singleview schedules. If log file archives need to be
retained for longer, they should be move separate offline storage.
5.12.5
Singleview Operations Guide
Singleview Operations Guide
CHARGE
NORMALISED_EVENT
Before running Sort Paritions service provider should set all five active ‘Multi Instance Rate Files’
schedules to Completed, after sorting is finished these schedules can be reset to Active status.
Singleview Operations Guide
Singleview Operations Guide
It is recommended that the ‘Sort Charge/Event Partitions’ tasks are scheduled to run on a daily
basis with after business hours (ex 5pm).
Once the task has been verified that it executed successfully in non-commit mode (ie Commit
Only? = Yes) then the operator should
1. Identify all ‘Multi Instance Rate Files’ schedules, such as the below :
POSTPAI_AIR_Files
POSTPAI_DATA_Files
POSTPAI_RR_JULY_Files
POSTPAI_RR_JUNE_File
POSTPAI_SDP_Files
POSTPAI_SMS_File
POSTPAI_VOICE_Files
Open each Schedule and update its Schedule Status to Completed (this will prevent rating
from being executed during partition sorting process).
Singleview Operations Guide
Then select the last executed ‘Sort Charge/Event Partitions’ task for CHARGE and
NORMALISED_EVENT where ‘Confirm Only?’ = Yes, open task and select the ‘Update’ button and
reset ‘Confirm Only?’ = No, all other parameters should remain as is. Save the task.
Singlview will not resubmit the original ‘Sort Charge/Event Partitions’ task but with ‘Confirm Only?’
= No, this will start the partition sorting process.
Singleview Operations Guide
Once the tasks have executed success you must reset all the relevant ‘Multi Instance Rate Files’
schedules back to a Singleview Status from Complete to Active.
Singleview Operations Guide
POSTPAI_AIR_Files
POSTPAI_DATA_Files , POSTPAI_RR_JULY_Files
POSTPAI_RR_JUNE_File
POSTPAI_SDP_Files
POSTPAI_SMS_File
POSTPAI_VOICE_Files
Note :- Sort Partitions task should be run before QA Bill Run, service provider should run Sort
Partitions with an Effective Date of the QA bill run execution day and not the Invoice Effective
Date. If you use the future dated Invoice Effective Date then this would mean future dated
partitions are sorted with no usage content, this would lead to performance issues on bill run
night.
The schedule should initially be setup with 'Yes' in the 'Confirm Only?' field. This will run the
schedule in test mode and highlight any potential errors then rollback the changes. Once the
initial task is successful in test mode the schedule should be updated with 'Confirm Only?' set to
‘No’.
5.12.6.2.1 Add Date Partitions Schedule
In the examples in this document the last partition has a start date of 28/08/2021. To add a new
partition with start date 29/08/2021, create a schedule of type Add Date Partitions for each of
the tables similar to the below screenshot:
CHARGE
NORMALISED_EVENT
NORMALISED_EVENT_ERROR
SUBTOTAL_RATING_DELTA
SUBTOTAL_RATING_VALUE
Singleview Operations Guide
When errors occur the task results will display the corresponding task error message to be
investigated. The task may been to be resubmitted, based on the nature of the failure.
The below table defines a sample set error failures, probable cause and operational action which
should be performed to resolve the issue:
Error ID E12118
Error <E12118> Txuedo error 3552 occurred :-
Message
Singleview Operations Guide
Insufficient date partitions did not exist for the current time period for the upload /download
Error Cause document partition tables
Execute ‘Add Date Partitions’ for tables AUDIT_LOG_VAL, DOWNLOAD_AUDIT and
UPLOAD_AUDIT tables, Duration of each partition should be 1 , Units = Months, Confirm
Error Action Only = Yes and then reset to No when confirmed
SVSC collection framework executes the registered utilities based on a specifiable frequency and
interval, then logs the corresponding results to the file system.
The various teams involved with different phases of Singleview project will find SVSC useful, as it
provides the information required to work out why technical problems occur with the solution
reactively. SVSC is not intended to be used at a historical performance manager or a system
monitor.
Singleview Operations Guide
The intention is to provide an agile method to gather information required to resolve system
problems as they occur. A set of checks are provided out of box which provide metrics about the
different components of the Singleview software stack (Unix, Oracle, Tuxedo, etc). SVSC also
provides a mechanism to add custom, project specific checks as required.
includes the ability to package the log files created by SVSC and various other Singleview and
system logs.
A Configuration item called SVSC will exist for each active SV node and define the SVSC
charactertics,
The first way is to setup the SVSC to be managed by the BMP. To do this the ENABLED attribute
on the SVSC configuration must be true, so the BMP starts SVSC on startup.
The second way is to start the SVSC as a one off task. Until environments have stabilized, it is
recommended to allow the SVSC to be started each time Singleview is brought up
Singleview Operations Guide
Log files can be reviewed any time after SVSC has been started.
When creating SQL based logs the table being queried must have date columns that can
be filtered on start and end dates. Here are the contents of the DIAG_ALERT_EXT.sql file:
Refer to the referenced document below for further information on Singleview standard reports,
including how to execute and how to access the report output. All custom reports delivered with
the Synergy solution use the same approach as the standard Singleview reports i.e. a report is
executed as a one-off task or schedule and the output is available on the Report button on the
task results tab (from Singleview CB or BAS Ops GUI). The report output is also available on the
file system, in the $ATA_DATA_SERVER/reports directory.
See section 5.12.2 for a detailed example of how to run a report in Singleview.
Singleview Operations Guide
5.13.2.1 Description
The Invoice Report, when run as a task for a given bill run id, takes all the invoices and creates a
detailed or summary (specified as a parameter) report.
When executed for a specific account and invoice via the CM GUI, it creates a detailed or
summary report for that specific invoice.
The invoice report files are generated in the standard reports output directory
$ATA_DATA_SERVER/reports.
The ID of the bill run for which the report should be generated. The Bill Run ID is
Bill Run ID Text
available on the Bill Run form.
Parameters Tab
Singleview Operations Guide
Click Save
5.13.3.1 Description
The Invoices to Local Printer, when run as a task for a given bill run id, takes all the invoices and
creates a detailed or summary (specified as a parameter) report.
When executed for a specific account and invoice via the CM GUI, it creates a detailed or
summary report for that specific invoice and sent out PDFs generated after the standard bill run to
a local printer.
The invoice report files are sending PDFs to a printer hence install the printer on the Singleview
server, so that it can be selected by the "Invoices to Local Printer" job to send the PDFs to.
Parameters Tab
Click Save
Singleview Operations Guide
6 User Management
Log in to Singleview CM with a user with sufficient privileges (ie TPSYSADM / OPERATIONS
user)
Click on Contact under the Create Gadget on right of the Home screen
Singleview Operations Guide
Note that, the ‘Shop Identifier’ attribute is based on the reference type MTC_SHOPS
Select the appropriate code for the shop in question.
This shop will now be available in the list of available Locations to be associated with a User
User creation can be performed from the Unix server of the environment or from the Singleview
CM GUI. The Unix command for User creation is:
The parameter -fact Location=’Shop Name’ is required for the following profiles:
Dealer profiles
o DEALER_POP
o DEALER_MGT
Business Customer Support profiles
o KA_ADMINISTRATOR
o KA_ADVISOR
o KA_SUPERVISOR
Warehouse profile
o WAREHOUSE
CSR profile
o CC_CSR
Mobile Home profiles
o STORE_SUPERVISOR
o STORE_ASSISTANT
If a User’s name parameter contains more than 2 strings, they should be joined into one string for
First Name and one string for Last Name, separated by an empty space character.
Example :-
The First Name and Last Name of the User can be updated via CRM GUI after creation.
Singleview Operations Guide
Sample commands are provided below for Singleview security profiles user creation
Dealer profiles
Finance profile
Shop/Store profiles
Operations profile
CSR profile
Warehouse profile
A User can be created manually in the Customer Management GUI. In the top right corner in the
‘Create’ section of the CRM GUI Home page select ‘User’.
Singleview Operations Guide
Fill in the information regarding the new User and save the changes in the top right corner.
Note that, the ‘Dealership’ attribute is based on the reference type MTC_DEALER_CODE. Select
the appropriate code for the Dealership in question.
Singleview Operations Guide
Singleview Operations Guide
Note that, the ‘Dealership’ attribute is based on the reference type MTC_BACKOFFICE_DIVISIONS.
Select the appropriate code for the back office group in question.
The table below lists the file-based interfaces which are supported by Singleview.
A number of instances of each adapter type are configured, each supporting a defined set of APIs
on a particular host and port. The setup is summarised in the table below.
8.1 Architecture
There are three nodes defined in the Singleview cluster, named SV1, SV2 and SV3. All nodes are
active and will be performing operations.
A total of six customer database partitions are configured and assigned to default Singleview
instances (Partitions 1 and 4 to SV1, 2 and 5 to SV2, 3 and 6 to SV3).This configuration may
change depending on cluster state. Customer partitions are HA resources and as such, may move
to a new active location based on the status of the cluster. For example in case instance SV1
Singleview Operations Guide
becomes unavailable, partitions 1 and 4 will move to another active instance. The following
command can be used to check the current active location of a customer partition:
sv_ha_ctl active_location <partition_number>
Pacemaker is the cluster manager solution employed by Singleview. Pacemaker will perform the
necessary actions required during instance failures.
A Layer 7 Load Balancer is the load balancer for distributing the HTTP/HTTPS PE Web requests
between the three PE web servers. PE Web servers will be connected to the PE instance in the
cluster via the PE Virtual IP.
External Systems that are sending API requests (SOAP and REST APIs) will interact with Singleview
via the PE Virtual IP or Layer 4 Load balancer, see sections below.
External Systems that are transferring files to Singleview will do so via the Layer 4 Load balancer
or the PE Virtual IP.
With the STONITH method, Pacemaker will fence the node when one of the following occurs:
A node becomes unresponsive. This scenario would typically occur due to a hardware
failure causing a node to be unable to communicate with the other nodes in the cluster.
The corosync process monitors connectivity between nodes.
A resource on the node cannot be stopped. When a pacemaker CHECK action fails for a
resource and the failure is unrecoverable, pacemaker attempts to STOP the resource. If the
STOP action fails and cannot complete successfully, it will result in fencing of the node.
8.2.2 Quorum
Pacemaker Quorum defines the minimum number of nodes needed for the cluster. When
Pacemaker Dynamic Quorum is enabled, the quorum is calculated dynamically. The pacemaker
cluster can tolerate the loss of nodes down to one node under certain conditions. When node
failures are detected or when a failed node rejoins the cluster, the cluster quorum is re-calculated
automatically based on the latest votes.
A Singleview application running on multiple instances is often referred to as a cluster. There are
many commands that use this terminology such as:
"sv_status -cluster" which checks cluster status "Checking for Singleview cluster running..."
In addition, to deliver full high availability, a cluster manager software is deployed on top of the
SV cluster i.e. the Pacemaker cluster.
In Singleview context the Pacemaker cluster cannot run without SV cluster running. However, the
SV cluster can be run without the Pacemaker cluster.
Singleview Operations Guide
So when talking about 'starting the cluster' one needs to be very specific on what is expected to
be done.
There is an option to start SV as well and in this case the SV cluster is started first and then the
Pacemaker cluster.
sv_ha_ctl cluster_start -sv
The order of operation is important because shutting down the SV cluster before stopping the
Pacemaker cluster will lead to fencing and rebooting of servers.
The Pacemaker cluster monitors SV cluster and SV application. If it notices that SV application is
not running it will assume there is a problem and will evict the first node it discovers problems
with.
Customer entities can be created in any of the customer partitions. The partition selection is
driven by the PartitionUtilisation DA table. The system picks the least utilized partition and uses
that for deriving IDs for system entities. The utilization is updated by the “Calculate Partition
Utilisation” task, which should be run on a scheduled basis (typically daily) to ensure even
distribution of customer data across partitions. In the case of a daily update of the DA table all
customers created in a given day will most likely be created in the same customer partition.
Migrated customers will be evenly distributed across all available partitions, during the migration
data load.
High volume tables like normalised_event and charge tables are partitioned using ranges
specified in EventPartitionRange and have a partition_nr column which can be used for
partition elimination to help with performance.
9 Auditing
And can be viewed within the View Audit History menu item for the relevant business entity (ex
Customer) see below :-
Audit tables can grow rapidy there Singleivew provide a Schedule which can be run regularly to:
Archive out old audit records to a SQL file and
Provide capability to Purge the archived data from the Audit tables.
9.1.1.1Description
This schedule will archive the requested audit log records with the option of purging
the records from the database too.
CSG would recommend that service provider archive old user access audit information that is no longer
required, this will limit any potential performance read/write issues on the production environment.
9.1.1.2Using CB Schedule Type
Sign on to the environment with your credentials
Click on Server Tasks from the menu bar
From the dropdown menu select One-off Task
In the Inserting One-off Task form, select Archive/Purge PE Audit Logs as the Schedule
Type dropdown value.
Parameters include :
o Achive Period – Default Value = 90 days
o Archive Filename – Default output SQL file =
$ATA_DATA_SERVER_ARCHIVE/pe_audit_logs.sql
o Purge data? – Yes will remove the data from the AUDIT LOG db tables, No will retain
it.
database backups and test the successful restoration on regular basis. The information for
App/Web/DB servers is available below.
Application Server
Full file system backup. The directories/mountpoint dedicated to Singleview are:
/syn– SV application mount point
/u01 – Input/Output files
PE Web Server
Full file system backup. The directories/mountpoint dedicated to Singleview are:
/syn – SV application mount point
Database
Full file system backup. Oracle is using following mount points
o /oracle
o /archive
o /grid
Database backup as per Oracle standards.
11 Disaster Recovery
TBC
ecp “biWall&(‘Please do not rate or bill until we send another message. We need to bounce the
broker. Operations Team’)”
Note that the Singleview Process Engine servers can be stopped and
started without impacting the Convergent Billing processes:
sv_stop -pe
sv_start -nocb -peonly
Stop Tuxedo tmshutdown -y Make sure the Convergent Billing instance has been shutdown before
trying to shutdown TUXEDO.
Start PE peweb_start The PE Web server, which supports the CM application layer, is owned
Web server by the unix PE Web application user (e.g synprd1w)
Stop PE Web peweb_stop PE web application can be stopped and started independently of the
server Singleview server, but requires the Singleview server to be available to
support log ins and user activities from the CM GUI.
Stopping all sv_peweb_stop All the connected PE web servers can be stopped from SV application
PE Web node by running this command
Server
Starting all sv_peweb_start All the connected PE web servers can be started from SV application
PE Web node by running this command
Server
The Singleview instance must be put in to maintenance mode before stopping the
Singleview application.
An instance can be disabled to allow maintenance or administrative activities to be performed on
it. This applies if the instance or node requires the application of a patch or installation of
hardware that necessitates a reboot of the system.
Disabling an instance avoids any potential impact caused by the aforementioned activities to the
other nodes in the cluster.
To disable an instance
i) Stop all batch rating streams on the instance, if running.
ii) Run: sv_ha_ctl instance_disable
sv_stop
The SV application is typically shut down for maintenance purposes. The application must be shut
down prior to shutting down the database. The database does not have to be shut down unless
specifically required. The application can be cycled or bounced independently of the database.
The database should not be shut down, without first shutting down the Singleview application
instances.
sv_start
The Singleview application will not start unless its hosting database has been started and is ready
to accept connections. Verify this by running: sqlplus $ATADBACONNECT; If this command fails
investigate the status of the database.
BKR and any children (ENM, ecp ‘biBkrStart&(1)’ ecp ‘biBkrStop&(1)’ Broker process that monitors all of the
ERT and ERO) rating processes
ERO ecp ‘biEroStart&(n)’ ecp ‘biEroStop&(n)’ Event Rating Output takes the
normalized events from the ENM and
charges from the ERT and sends them
to a remote host, to the database, or to
SQL*Loader files
ERT ecp ‘biErtStart&(n)’ ecp ‘biErtStop&(n)’ Event Rating process is responsible for
applying tariffs to the normalized
events to generate charges
TLM ecp ‘biTlmStart&(1)’ ecp ‘biTlmStop&(1)’ Task Launch Monitor launches tasks
when instructed by STD
Note: Do not stop BKR while rating is in progress, as the ERT process will not shut down correctly.
Singleview Operations Guide
Command Description
ataprocs Usage: ataprocs [-p <proc ID>] [-a]
The default output of this command is to display all the CB processes running in
the environment. The processes are indented under one another to show the
hierarchy of the processes. Processes launched from another process are
indented under that parent process in the display.
The –a shows all details about a process. The –p allows you to specify any
process id. All processes associated with that process ID are displayed in the
output.
ecp ecp is a command line parser for the Singleview epm scripting language.
This command allows system administrators to send wall messages to all client
sessions. Mostly used to notify on-line users when the application is being
shutdown.
cberr Usage: cberr <error code> | <error ID>
Lists the attributes and their values assigned to the configuration item
specified. E.g.
cfg ENM 1
Other variations:
Command Description
erbclose Usage: erbclose
The correct way to shut down and clean out the broker and its associated
processes if they have died for some reason.
This will display statistics of the CB server process specified. It is very useful
when problem solving rating and billing processes. E.g.
getstats –s bkr
Dumps the image for the specified invoice ID to a file, naming it appropriately
for the type of invoice image.
Run from anywhere on the server will show the last 20 lines of the log.out file in
the $ATA_DATA_SERVER_LOG directory.
Eg. LOG 70 will display the last 70 lines of the log.out file.
LOG f will display the last few lines of the log file and update the display
whenever any new lines are written to the log. (Control + c will exit out of this
mode.)
Allows you to trace up the process tree from the given process ID.
Dumps the contents of the task results for the specified task.
The <type> indicates the type of output (stdout, spf, etc.) that you want to
output and should match a code label in the OUTPUT_TYPE reference type.
tuxprocs Lists all details about the tuxedo processes currently running.
tuxservers Lists all details about the tuxedo servers running in that environment.
tuxstatus Is the same as running the tuxedo command bbstat within the tuxedo admin
tool. Shows summary of total tuxedo servers, services, queues, etc.
Singleview Operations Guide
Command Description
tuxusers Lists all users logged into the CB client or processes running that are connected
to Tuxedo.
Run from anywhere on the server will show the last 20 lines of the active
Tuxedo ULOG file.
Eg. ULOG 70 will display the last 70 lines of the log.out file.
ULOG f will display the last few lines of the log file and update the display
whenever any new lines are written to the log. (Control + c will exit out of this
mode.)
Further information on these commands, and others, is available in the product documentation.
Singleview Operations Guide
Log files for PE Web server are written to the PE Web log directory.
Refer to the Singleview product documentation for details on the various log files and their typical
contents.
And
$PEWEB_DOMAIN_DATA/logs/catalina.out
SEVERE error message may lead to PE Client Crashes and often occurs when the PE Web Client
cannot determine which panel to focus on based on a client user action.
$PEWEB_DOMAIN_DATA/logs/security.log
$PEWEB_DOMAIN_DATA/logs/health.out
If the cache gets corrupted consider removing it but only after full environment performance
considerations and once environment is not running.
rm -r $PEWEB_DOMAIN_DATA/databases/embedded/peCache
Singleview Operations Guide
Reference Data (including offers, lists, tables, etc.) and Configuration Data are typically managed
via the reference data management and release management processes which are documented
elsewhere.
In case customer data needs to be extracted from or moved between Singleview databases, the
Singleview archive or production data archiver tools may be used.
Filesystem storage also needs to be monitored and files which are no longer required should be
moved to suitable offline storage.
Refer to the Singleview Operations Guide [2] for details on all Singleview schedule types.
13.1.1 Archive
The Singleview Archive tool may be run as a scheduled or one-off task via the Singleview
operations GUI. It is suitable for small volumes of database data.
The product documentation provides detail on how to use the archive tool.
The Singleview product documentation provides detail on how to use this schedule type.
Disk storage is a finite resource and must be managed via archiving and deletion of files that are
no longer relevant for Singleview processing.
/input directory: input files are delivered by external systems for processing
/error directory: files which were not successfully processed. Files can be moved to input directory
after they are corrected or errors resolved, for reprocessing.
/output directory: files which are created for delivery to users or external systems are created in the
output directory
/archive directory: files which have been successfully processed or transferred, are moved to the
/archive directory. Once in archive, there is no longer a need to retain the file from Singleview
perspective. However, files would typically be retained for a short time, in case issues are found which
require reprocessing of the files.
Based on above, it is key that the directories above have sufficient space available to handle to
storage requirement. If insufficient filesystem storage is available, Singleview processing will fail,
resulting in failed tasks.
The Singleview archive directories will need to be maintained. It will be necessary to move archive
files from the Singleview file system to offline storage, for longer term retention of data.
Singleview Operations Guide
The directories to which Singleview stores files after successful processing are :
/syn/synprd1b/data/server/archive
/syn/synprd1b/data/server/endo_collections/archive
/syn/synprd1b/data/server/gl_error/archive
/syn/synprd1b/data/server/gl_extracts/archive
/syn/synprd1b/data/server/prepaid_lifecycle/archive
/syn/synprd1b/data/server/prepaid_load/archive
/syn/synprd1b/data/server/sdp_dump/archive
It is advisable for the service provider’s billing operations team implement a process to move files
from the above directories and any other directories which are holding files which are no longer
required. service provider may wish to store these files in offline storage for a further period of
time, depending on service provider’s data retention requirements.
14 Health Check
A simple system health check should be run on a periodic basis, to help with prevention of
business-impacting issues.
No Commands/Log/File/
. Task Script Description
All systems All required SV applications
1 up? are up. Singleview CB, CM and BAS up and Running
Checking
Application This command provides pacemaker cluster and resource
cluster status.This also list the error or alarm related to any
2 Status sv_ha_ctl cluster_status resource.
This command helps the SV instance is running or
anything down or having issues.
pe_admin -rc
Checking sv_stop
for the SV sv_status / sv_status - sv_start
3 Status cluster
Checking
PEWEB It will provide the details related to connected PEWEB
4 Status sv_peweb_details server.
Usage: ataprocs [-p <proc
ID>] [-a] BMP, BKR, ENM, ERT, STD, TLM
The default output of this REST and SOAP adapters
command is to display all
the CB processes running in Note: Do not stop BKR while rating is in progress, as the
5 ataprocs the environment. ERT process will not shut down correctly.
What
versions of
software
6 are sv_version -a Software incompatibility?
Singleview Operations Guide
running?
Is there Disk partition full?
enough File system utilisation for application and database
7 disk space? df -h servers.
Is the
system Unbounded processes?
overloaded top Too many processes?
8 ? glance Too few processes?
Is Oracle
9 running? sqlplus / Oracle down?
tmadmin -r (psr)
Is Tuxedo ipcs -qa |grep -v "0 0"
10 running OK tuxusers | grep –v IDLE Tuxedo lock ups or deadlock
top or
prstat or
What glance
process is ps –ef | grep cbp1 Are all the processes running that you expect (compare
11 running? ataprocs against config and ubbconfig)
Are there
any core
12 files? find / -name '*core*' -print Something has crashed
server.
Free space
19 checking free -h Check how much free space available in 'free' column.
If f_rsp memory growth was found to exceed and agreed
threshold then the below command will perform a
controlled restart of idle f_rsp services, this should reset
memory utlisation.
f_rsp
Memory /syn/synprd1b/data/server/pe_bin/
20 Growth top bounce_excessive_mem
Alerts may be configured on any of these aspects, including configurable thresholds and alert
targets (email addresses, teams channels), for example:
High CPU use
High disk use
Oracle listener down
Oracle errors
Tablespace high usage
Failed Singleview tasks
Singleview Tuxedo queue errors
Application components are down