protax 2.1 installation manual

PROTAX (2.1) Installation Manual 4/10/2023

1 Database Server Setup

1.1 IRD Database

The following parameter values have been changed in initVATDB.ora to get an optimum performance.

Shared Pool size

Current Size 104857600 (100MB)Recommended Size O.K.

Large Pool size

Current Size 0Recommended Size 1048576 (1MB)

DB Buffer Cache size


Log Buffer size

Current Size 5242880 (5MB)Recommended Size 20971520 (20MB)

Sort Area size


Parameter JAVA_POOL_SIZE has been commented; it frees the memory area of SGA on database server, which was set for the purpose of Java objects.

1.2 IRO Database

Following parameter values have been changed in initVATDB.ora file;

Parameter JAVA_POOL_SIZE has been commented; it frees the memory area of SGA on database server, which was set for the purpose of Java objects.

Parameter DB_FILE_MULTIBLOCK_READ_COUNT has been commented if the parameter value for DB_BLOCK_SIZE found to be 8192 (8k). If the value of DB_BLOCK_SIZE found other than that, value for DB_FILE_MULTIBLOCK_READ_COUNT has been set as per the following table rule;

S.N. DB_BLOCK_SIZE DB_FILE_MULTIBLOCK_READ_COUNT1. 2048 42. 4096 2

/tt/file_convert/54fbd5a34a795937538b496b/document.doc 1


2 IRD Database Server Setup Script

Following script files will be required to setup the database at IRD. These script files will upgrade the Protax 2.0 to Protax 2.1. These script files will be executed once for the rollout purpose only. For the carsh recovery or general maintenance purpose these files are not required. Since backup of the databases is is taken centrally, we have to use our latest backup set for restoring our database.

S.N. Name Purpose Remarks

1. 1DeInstallProtax2.sql De-installs Database Replication support objects of Protax 2.0

User should connect as REPADMIN before running this script

2. 2DeInstallProtax2.sql De-installs Public Synonyms of Protax 2.0

User should connect as SYS/SYSTEM before running this script

3. 3DeInstallProtax2.sql De-installs snapshot logs of Protax 2.0

4. 4DeInstallProtax2.sql De-installs views of Protax 2.0

5. 5DeInstallProtax2.sql De-installs Tables of Protax 2.0

6. 6DeInstallProtax2.sql De-installs database procedures of Protax 2.0

7. 7DeInstallProtax2.sql De-installs database functions of Protax 2.0

8. 8DeInstallProtax2.sql De-installs database packages of Protax 2.0

User should connect as PROTAX before running this script

9. 1Protax21.sql Creates User/Roles and grants required system/object privileges of Protax 2.1

10. 2Protax21.sql Creates Tables of Protax 2.1

11. 3Protax21.sql Creates Indexes of Protax 2.1

12. 4Protax21.sql Creates Constraints of Protax 2.1

13. 5Protax21.sql Creates Views of Protax 2.1 Repeat this script



14. 6Protax21.sql Creates Snapshot logs of Protax 2.1

15. 7Protax21.sql Creates Functions of Protax 2.1

After completion of 10Protax21.sql repeat this script once again

16. 8Protax21.sql Creates Procedures of Protax 2.1

Repeat this script

17. 9Protax21.sql Creates Package specifications of Protax 2.1

Repeat this script

18. 10Protax21.sql Creates Package bodies of Protax 2.1

After completion of this script go back to 7Protax21.sql

19. 11Protax21.sql Creates Triggers of Protax 2.1

20. 12Protax21.sql Creates Synonyms of Protax 2.1 objects

21. 13Protax21.sql Grants Protax 2.1 objects to users/roles

22. 14Protax21.sql Creates Replication support objects at IRD database of Protax 2.1

23. 15Protax21.sql Creates Journal tables

24. 16Protax21.sql Grants snapshot logs to Proxyagent at IRD database of Protax 2.1

Security Setup

Following script files will be required for security setup at IRD database server. These script files will be required to upgrade Protax 2.0 to Protax 2.1.


1. 1REMOVEDATA.sql Removes security related data

2. 2SECURITYDATA.sql

Populates security related data

3. 3roleandgrants.sql Grants required privileges

Note: - At the end of server setup, please run all the script files kept in the folder “Changes”



3 IRO Database Server Setup

There are two sets of script files available for to setup the IRO database server. First set will be required for upgrading Protax 2.0 to Protax 2.1 and the next set is for crash recovery. IROs do not have the backup /recovery facility in place therefore in case of system failure data have to be pulled from IRD database. IRO to IRD database connectivity will be required for IRO database server setup. These files should be executed sequentially with SQL*PLUS.

3.1 IRO Database Server Setup (Upgrade)


1. 1DeInstallProtax1.sql De-install the Public Synonyms of Protax 2.0

2. 2DeInstallProtax1.sql De-install views of Protax 2.0

3. 3DeInstallProtax1.sql De-install tables

4. 4DeInstallProtax1.sql De-install database procedures of Protax 2.0

5. 5DeInstallProtax1.sql De-installs database functions of Protax 2.0

6. 6DeInstallProtax1.sql De-installs database packages of Protax 2.0

7. 7DeInstallProtax1.sql De-install database Replication objects at IRO database

User should connect as PROTAX before running this script

8. 8DeInstallProtax1.sql De-install JN Tables at IRO database

10. 1Protax21.sql Creates User/Roles and grants required system of Protax 2.1

11. 2Protax21.sql Creates tables/snapshots of Protax 2.1

User should connection to IRD through dial-up (RAS)


13. 4Protax21.sql Creates Constraints/sets default values for table columns

14. 5Protax21.sql Creates Views of Protax 2.1 After completion of 9Protax21.sql



repeat this script


Repeat the script twice






After completion of this script repeat 5Protax21.sql




22. 13Protax21.sql Creates JN Tables

Security Setup

Following script files will be required for security setup at IRO database server. These script files will be required to upgrade Protax 2.0 to Protax 2.1.


1. 1REMOVEDATA.sql Removes security related data

2. 2SECURITYDATA.sql

Populates security related data

3. 3roleandgrants.sql Grants required privileges

Note:- At the end of server setup, please run all the script files kept in folder “Changes”

3.2 IRO Database Server Setup (New)


1. 1Protax21.sql Creates Tablespaces for application data, indexes and temporary segments



2. 2Protax21.sql Creates User/Roles and grants required system/object privileges of Protax 2.1

3. 3Protax21.sql Creates tables/snapshots of Protax 2.1

User should connection to IRD through dial-up (RAS)


5. 5Protax21.sql Creates Constraints/sets default values for table columns

6. 6Protax21.sql Creates Views of Protax 2.1 After completion of 10Protax21.sql script repeat this script








After completion of this script repeat 6Protax21.sql




14. 14Protax21.sql Creates JN Tables

Security Setup

Following script files will be required for security setup at IRO database server. These script files will be required to install the security system for Protax 2.1.


1. 1SecurityProtax21.sql Creates Security Tables for Protax 2.0



2. 2SecurityProtax21.sql Creates Security Table Indexes for Protax 2.0

3. 3SecurityProtax21.sql Creates Security Table constraints for Protax 2.0

4. 4SecurityProtax21.sql Creates Security Views for Protax 2.0

Repeat this script twice

5 5SecurityProtax21.sql Creates Security Procedures for Protax 2.0

6 6SecurityProtax21.sql Creates Security Package Specifications for Protax 2.0

7 7SecurityProtax21.sql Creates Security Package Bodies for Protax 2.0

8 8SecurityProtax21.sql Creates Security Triggers for Protax 2.0

9 9SecurityProtax21.sql Creates Security Synonyms for Protax 2.0

10 10SecurityProtax21.sql Grants required system/object privileges to roles of Protax 2.0

11 11SecurityProtax21.sql

12 1SecurityData21

13 2SecurityData21

Note:- At the end of server setup, please run all the script files kept in folder “Changes”

4 Application Setup

The following application files should be copied in existing ‘I’ directory on IRD and IROs file (application) server. Location of the files must be maintained as per the directory structure mentioned below. The files, IT_MAIN.FMX, PROTAX.FMX, VAT_MAIN.FMX, VSF_SYS_USER.FMX and VAT_SYS_USER.FMX should be backed up before replacing these with new ones. The backup should be taken under new “BACKUP” folder. The existing folder “I:\Protax” should be renamed to “I:\Protax2.0” to backup Protax 2.0. A new folder “I:\Protax” should be created. The following application files should be copied to the locations specified with the file names.

Forms- These files should be kept under I:\Protax\Forms



ACCESSORIES_MAIN.FMXSUPERVISOR_MAIN.FMXCOLLECTION_MAIN.FMXCALENDAR.FMXCONVERT_DATE.FMXCHARMAP.EXENOTEPAD.EXECALC.EXEICL_DOWNLOAD_DOC.FMXISF_CHANGE_PASSWORD.FMXICL_BANK_OFFICES.FMXICL_REVENUE_ACCOUNTS.FMXICL_ADJUST_REASON.FMXICL_WITHHOLDEE_TYPE.FMXICL_AUDIT_FACTOR.FMXICL_ASSESSING_OFFICER.FMXICL_CHARGE_PENALTY.FMXICL_CHA_AME_RULE.FMXICL_CHA_PEN_TYP_USA.FMXICL_FISCAL_YEAR.FMXICL_OFFICE.FMXICL_INCOME_SOURCE.FMXICL_ORDER_DEL_MODE.FMXICL_MEDICAL_SERVICE.FMXICL_SUSPENSION.FMXISF_USER.FMXISF_ROLE.FMXISF_USER_ROLE.FMXISF_ROLE_MODULE.FMXISF_USER_MODULE.FMXVAT_SYS_USER.FMXICS_PARAMETER.FMXICT_COLL_TARGET.FMXICL_UPLOAD_DOC.FMXICB_INSTALMENT_RETURN.FMXICB_INSTALMENT_REVISION_RETURN.FMXICB_INSTALMENT_REVISION_NOTICE.FMXICB_SELF_ASSESSMENT_RETURN.FMXICB_AMENDED_ASSESSMENT.FMXICB_ORD_DEL_DATE.FMXICB_CHARGE_ASSESSMENT.FMXICB_AME_CHA_INT_ASSESSMENT.FMXICB_REV_APPLICATION.FMXICB_APP_NOTIFICATION.FMXICB_REV_DECISION.FMXICB_APP_DECISION.FMXICB_TDS_RETURN.FMXICB_MB.FMXICB_BOUNCED_CHEQUE_DRAFT.FMXICB_CT_TRANSFER.FMXICB_EXCESS_TAX_CREDIT_TRANS.FMX



ICB_TAX_CREDIT_AMEND.FMXICB_MEDICAL_TAX_AMEND.FMXICB_TAX_CREDIT_CLAIM.FMXICT_BATCH_POST.FMXICB_AUTHORIZE_UPDATE.FMXTR_BANK_VOUCHER.FMXTR_OLD_DEBIT.FMXTR_AUDIT_SELECTION.FMX

Reports- These files should be kept under I:\Protax\Reports

ICR_BATCH_REPORT.RDFICR_REGISTYPE_IN_ASSESSMENT.RDFICR_REGISTYPE_SELF_ASSESSMENT.RDFICR_BATCH_ASS.RDFICR_ASSESSMENT_STATISTICS.RDFICR_STAT_MANAGEMENT_ADJ.RDFICR_NON_FILERS_LIST.RDFICR_LARGE_TAXPAYER.RDFICR_DEBTORS_LIST.RDFICR_DEBTOR_CREDITOR.RDFICR_TAX_CREDIT.RDFICR_COLLECTION.RDFICR_CREDITORS_LIST.RDFICR_SUSPENDED_RECORDS.RDFICR_ASSESSMENT_SUSP.RDFICR_TAXPAYER_LEDGER.RDFICR_TAXPAYER_PROFILE.RDFICR_MANAGEMENT_ADJ.RDFICR_ASSESSMENT_SUSP.RDFICR_DOCUMENT_LIST.RDFICR_TAX_CRE_CLA_AME_SUSP.RDFICR_MED_TAX_CLA_AME_SUSP.RDFICR_TAX_CREDIT_CLAIM_SUSP.RDFICR_TAX_CREDIT_TRANSFER_SUSP.RDFICR_TDS_RETURN_SUSP.RDFICR_AMENDED_CHARGE_SUSP.RDFICR_CT_TRANSFER_SUSP.RDFICR_MANUAL_CHARGE_SUSP.RDFICR_ORDER_DELIVERY_DATE_SUSP.RDFICR_BOUNCED_CHEQUE_SUSP.RDFICR_REVIEW_APPLICATION_SUSP.RDFICR_REVIEW_DECISION_SUSP.RDFICR_APPEAL_NOTIFICATION_SUSP.RDFICR_APPEAL_DECISION_SUSP.RDFICR_AMEN_ASSE_ORDER.RDFICR_REV_NOT_ORDER.RDFICR_CHARGE_ORDER.RDFICR_AMENDED_CHARGE_ORDER.RDFICR_BOUN_CHEQ_ORDER.RDFICR_TAX_CRE_CLA_AME_ORDER.RDFICR_MED_TAX_CRE_CLA_AME_ORDER.RDFICR_TAX_INC_RET.RDFICR_COM_INC_RET.RDF



ICR_AUD_SEL_AME.RDFICR_APP.RDFICR_ADM_REV.RDF

ICR_ASS_TAX_INC.RDFICR_DET_BUS_ACT.RDFICR_MON_AUD_SEL_AME.RDFICR_MON_APP.RDFICR_MON_ADM_REV.RDFICR_MON_TAX_INC_RET.RDFICR_MISMATCH_LIST.RDFICR_MISMATCH_DETAIL.RDFICR_MISMATCH_LATE_FILING.RDFICR_RETURN_MISMATCH_LIST.RDF

Library- These files should be kept under I:\Protax\Library

1. I:\Protax\Library\BIN2HEX.EXE

2. I:\Protax\Library\CallSDK32.dll

3. I:\Protax\Library\d2kwut32.dll

4. I:\Protax\Library\d2kwut60.dll

5. I:\Protax\Library\D2KWUTIL.plx

6. I:\Protax\Library\HEX2BIN.EXE

7. I:\Protax\Library\library.plx

8. I:\Protax\Library\library_i.plx

9. I:\Protax\Library\OFGBSL.plx

10. I:\Protax\Library\Ofghpl.plx

11. I:\Protax\Library\Ofgmes.plx

12. I:\Protax\Library\Ofgnavl.plx

13. I:\Protax\Library\Ofgtel.plx

14. I:\Protax\Library\PROTAX_Library.plx

Icons- These files should be kept under I:\Protax\Icons

1. I:\Protax\Icons\123.ico

2. I:\Protax\Icons\addr123.ico



3. I:\Protax\Icons\adr1.ico

4. I:\Protax\Icons\adr2.ico

5. I:\Protax\Icons\AFFLDDWN.ICO

6. I:\Protax\Icons\AFFLDUP.ICO

7. I:\Protax\Icons\batch_complete.ico

8. I:\Protax\Icons\batch_report.ico

9. I:\Protax\Icons\Close1.ico

10. I:\Protax\Icons\CRDFLE13.ICO

11. I:\Protax\Icons\FOLDER05.ICO

12. I:\Protax\Icons\GRAPH12.ICO

13. I:\Protax\Icons\home.ico

14. I:\Protax\Icons\ready_for_post.ico

15. I:\Protax\Icons\rt_lock.ico

16. I:\Protax\Icons\rt_ulock.ico

17. I:\Protax\Icons\TRANS.ICO

18. I:\Protax\Icons\VAT11.bmp

-End of Installation Manual-


protax 2.1 installation manual

Documents