Infor SunSystems Technical Reference Guide...SunSystems v4 Technical Reference Manual | 3 Contents About this guide ..... 19

Infor SunSystems Technical Reference Guide

Version 4.4.2

Copyright © 2018 Infor

Important Notices The material contained in this publication (including any supplementary information) constitutes and contains confidential and proprietary information of Infor. By gaining access to the attached, you acknowledge and agree that the material (including any modification, translation or adaptation of the material) and all copyright, trade secrets and all other right, title and interest therein, are the sole property of Infor and that you shall not gain right, title or interest in the material (including any modification, translation or adaptation of the material) by virtue of your review thereof other than the non-exclusive right to use the material solely in connection with and the furtherance of your license and use of software made available to your company from Infor pursuant to a separate agreement, the terms of which separate agreement shall govern your use of this material and all supplemental related materials ("Purpose"). In addition, by accessing the enclosed material, you acknowledge and agree that you are required to maintain such material in strict confidence and that your use of such material is limited to the Purpose described above. Although Infor has taken due care to ensure that the material included in this publication is accurate and complete, Infor cannot warrant that the information contained in this publication is complete, does not contain typographical or other errors, or will meet your specific requirements. As such, Infor does not assume and hereby disclaims all liability, consequential or otherwise, for any loss or damage to any person or entity which is caused by or relates to errors or omissions in this publication (including any supplementary information), whether such errors or omissions result from negligence, accident or any other cause. Without limitation, U.S. export control laws and other applicable export and import laws govern your use of this material and you will neither export or re-export, directly or indirectly, this material nor any related materials or supplemental information in violation of such laws, or use such materials for any purpose prohibited by such laws. Trademark Acknowledgements The word and design marks set forth herein are trademarks and/or registered trademarks of Infor and/or related affiliates and subsidiaries. All rights reserved. All other company, product, trade or service names referenced may be registered trademarks or trademarks of their respective owners. Publication Information Release: SunSystems v4 Publication date: March 6, 2018 Document version: v442

SunSystems v4 Technical Reference Manual | 3

Contents

About this guide ............................................................................................................................. 19

Intended audience ......................................................................................................................... 19

Related documents ........................................................................................................................ 20

Contacting Infor.............................................................................................................................. 20

Chapter 1 System Overview ......................................................................................................... 23

Chapter 2 Naming Conventions ................................................................................................... 29

Source files .................................................................................................................................... 30 Examples ................................................................................................................................. 30

Copy files ....................................................................................................................................... 30 Examples ................................................................................................................................. 31

Compiled program files .................................................................................................................. 31 Examples ................................................................................................................................. 32

System load files ............................................................................................................................ 32

Template file .................................................................................................................................. 32 Examples ................................................................................................................................. 33

Message files ................................................................................................................................. 33 Examples ................................................................................................................................. 33

Layout files ..................................................................................................................................... 33

Report heading files ....................................................................................................................... 34 Example ................................................................................................................................... 34

Run Time License .......................................................................................................................... 34

Indexed and non-indexed temporary work files ............................................................................ 35 Example ................................................................................................................................... 35 Example ................................................................................................................................... 35

Stored print files ............................................................................................................................. 35

Backup files .................................................................................................................................... 36

Contents

4 | SunSystems v4 Technical Reference Manual

Examples ................................................................................................................................. 36

Archive files .................................................................................................................................... 36 Examples ................................................................................................................................. 37

Transfer files .................................................................................................................................. 37 Examples ................................................................................................................................. 37

Audit files ....................................................................................................................................... 38 Examples ................................................................................................................................. 38

Chapter 3 Screens and Menus ..................................................................................................... 39

General format ............................................................................................................................... 39

Screen layout ................................................................................................................................. 40

Numbering of template fields ......................................................................................................... 40

How to use the Template Editor SZTE .......................................................................................... 41

P-Print ............................................................................................................................................ 42

B-Backup ....................................................................................................................................... 42

R-Restore ....................................................................................................................................... 42

N-New ............................................................................................................................................ 44

X-Exit .............................................................................................................................................. 44

D-Delete ......................................................................................................................................... 44

E-Edit ............................................................................................................................................. 45

E-End ............................................................................................................................................. 45

A-Abort ........................................................................................................................................... 45

T-Template ..................................................................................................................................... 45

R-Ruler ........................................................................................................................................... 45

I-Ids ................................................................................................................................................ 45

D-Display ....................................................................................................................................... 46

F-Field ............................................................................................................................................ 46

Q-Query ......................................................................................................................................... 47

W-Windows .................................................................................................................................... 48

Edit option S-Selections ................................................................................................................. 48 Example ................................................................................................................................... 49

Action numbers .............................................................................................................................. 49

Actions table .................................................................................................................................. 49

Contents


Local actions .................................................................................................................................. 55

Routing selections ......................................................................................................................... 55 Routing Selection Number ...................................................................................................... 55 Routing Selection Mnemonic ................................................................................................... 55 Program Id ............................................................................................................................... 55 Permission Type ...................................................................................................................... 56 Action Permission Indicator ..................................................................................................... 56 Process Mode .......................................................................................................................... 56 System Id ................................................................................................................................. 56 Reference Maintenance Record Type .................................................................................... 56 Template Suffix ........................................................................................................................ 56 Module Number ....................................................................................................................... 57 Sub Menu ................................................................................................................................ 57 Permission Slot Number .......................................................................................................... 57 Type of Selection ..................................................................................................................... 57 Menu Number .......................................................................................................................... 57 Sub-Menu Type ....................................................................................................................... 57 Sub-Menu Menu ...................................................................................................................... 57

Other ways to run SZTE ................................................................................................................ 58

Introduction .................................................................................................................................... 58

UI Hint impact ................................................................................................................................ 59

Template targets ............................................................................................................................ 59

Applying UI Hints to the Template File .......................................................................................... 60

Standard Template data practices ................................................................................................. 60

UI Hint data principles .................................................................................................................... 60

Backing up UI Hints ....................................................................................................................... 61

Common Return String maintenance ............................................................................................ 61 How to access ......................................................................................................................... 61 How to maintain ....................................................................................................................... 61 Validation limitations ................................................................................................................ 61 Held in Template file (.dat/.idx) as ........................................................................................... 62 Recorded in Template Backup file (.BAK) as .......................................................................... 62 Parsed to the New UI as ......................................................................................................... 62

Common ComboBox content maintenance ................................................................................... 62 How to access ......................................................................................................................... 62 How to maintain ....................................................................................................................... 62

Contents


Validation limitations ................................................................................................................ 63 Held in Template file (.dat/.idx) as ........................................................................................... 63 Recorded in Template Backup file (.BAK) as .......................................................................... 63 Parsed to the New UI as ......................................................................................................... 63

Field associated Hint maintenance ................................................................................................ 64 How to access ......................................................................................................................... 64 How to maintain ....................................................................................................................... 64 Validation limitations ................................................................................................................ 64 Held in Template file (.dat/.idx) as: .......................................................................................... 65 Recorded in Template Backup file (.BAK) as: ......................................................................... 65 Parsed to the New UI as ......................................................................................................... 65

UI Text String Hint maintenance .................................................................................................... 65 How to access ......................................................................................................................... 66 How to maintain ....................................................................................................................... 66 Held in Template file (.dat/.idx) as ........................................................................................... 67 Recorded in Template Backup file (.BAK) as .......................................................................... 67 Parsed to the New UI as ......................................................................................................... 67

Hint Error Reporting ....................................................................................................................... 67 Parsed Template data ............................................................................................................. 68

Form/Field Hint/Control qualification Checklist.............................................................................. 69 Modified/New field ................................................................................................................... 69 Calendar Check ....................................................................................................................... 69 CheckBox Check ..................................................................................................................... 69 ComboBox Check .................................................................................................................... 70 Maintenance ............................................................................................................................ 70

Impact on Form Layout .................................................................................................................. 70 Low Risk .................................................................................................................................. 70 Minimal Risk ............................................................................................................................ 70

Translation Considerations ............................................................................................................ 71

Data File Format ............................................................................................................................ 76 Owner ...................................................................................................................................... 76 System ..................................................................................................................................... 76 Function ................................................................................................................................... 77 Action ....................................................................................................................................... 77 Menu Item ................................................................................................................................ 78

XML Schema ................................................................................................................................. 78

MenuIcon Types ............................................................................................................................ 82

Contents


Index of Categories ........................................................................................................................ 82

Menu Tables .................................................................................................................................. 85

Chapter 4 Reference Maintenance ............................................................................................... 89 Record Type Code .................................................................................................................. 90 Template .................................................................................................................................. 90 Routing Parameters ................................................................................................................. 90 Layout Definition ...................................................................................................................... 90

Record information ........................................................................................................................ 96 Character ................................................................................................................................. 96

Field information ............................................................................................................................ 96 Character ................................................................................................................................. 96

Type 1 ............................................................................................................................................ 97

Type 2 ............................................................................................................................................ 97

Type 3 ............................................................................................................................................ 98

Type 4 ............................................................................................................................................ 98

Type 5 ............................................................................................................................................ 98

Type 6 ............................................................................................................................................ 99

Report information ......................................................................................................................... 99 Character ................................................................................................................................. 99 Example ................................................................................................................................. 100 Example ................................................................................................................................. 101 Example A) NDF .................................................................................................................... 104 Example B) CDF .................................................................................................................... 104

Introduction .................................................................................................................................. 105

Audit Control flag location ............................................................................................................ 105

AUC Record Layout ..................................................................................................................... 106

AUC Record maintenance ........................................................................................................... 106

AUC flag access .......................................................................................................................... 106

Reference Maintenance Audit Control Function Layout.............................................................. 107

Audit Control flag Copy facility ..................................................................................................... 107

Audit Control management checklist ........................................................................................... 107 New AC flag preparation ....................................................................................................... 107 Map new AC flag(s) ............................................................................................................... 108 Test the new AC flag(s) ......................................................................................................... 109

Contents


Add-on Product - Suggested slot assignment/layout format ....................................................... 109

Chapter 5 Printed Output ............................................................................................................ 111

Chapter 6 User Hooks ................................................................................................................. 113

Overview ...................................................................................................................................... 134 Standard User Hook Definition .............................................................................................. 134 Report Definition User Hooks ................................................................................................ 134

Entries – Standard User Hook Definition ..................................................................................... 135 Description ............................................................................................................................. 135 Number .................................................................................................................................. 135 User Hook Program ............................................................................................................... 135 Start of Session ..................................................................................................................... 135 Actions ................................................................................................................................... 135 End of Session ...................................................................................................................... 135 Actions ................................................................................................................................... 136 Calling Points 1-4 .................................................................................................................. 136 Actions ................................................................................................................................... 136 Retain in Memory .................................................................................................................. 136 Data Items 1-4 ....................................................................................................................... 136 Values 1-4 .............................................................................................................................. 136 Indicators 1-4 ......................................................................................................................... 136 Data Type .............................................................................................................................. 136

Entries – Report Definition user hooks ........................................................................................ 137 Calling Program ..................................................................................................................... 137 Description ............................................................................................................................. 137 Number .................................................................................................................................. 137 User Hook Program ............................................................................................................... 137 Format Code .......................................................................................................................... 137 UHD ....................................................................................................................................... 137

User hook calling points ............................................................................................................... 137 Journal Entry - SAJE ............................................................................................................. 137 Journal Import - SATF ........................................................................................................... 138 Sales Order Entry – Header Level - SBTE ............................................................................ 138 Sales Order Entry – Detail Level - SBTD .............................................................................. 138 Sales Order Import - SOSI .................................................................................................... 138 SOP Print Invoices - SBPI ..................................................................................................... 139 SOP Print Dispatch Notes - SBPS ........................................................................................ 139

Contents


Purchase Order/Invoice Entry – Header Level - SPPE......................................................... 139 Purchase Order/Invoice Entry – Detail Level - SPPD ........................................................... 139 Purchase Import - SPPI ......................................................................................................... 139 Report Formatter – SSRF ..................................................................................................... 140

Chapter 7 Hidden Functions ....................................................................................................... 141 Import or Export ..................................................................................................................... 141 Transfer Filename ................................................................................................................. 141 Transfer Profile From/To ....................................................................................................... 141 Companion Verification ......................................................................................................... 142 UVRULES Directory .............................................................................................................. 142 Companion Bank Reconciliation ........................................................................................... 143 Database Code ...................................................................................................................... 143 Ledger .................................................................................................................................... 143 Suspense Account ................................................................................................................. 143 Backup Directory ................................................................................................................... 143 Ledger Export Set-Up ............................................................................................................ 143 Database Code ...................................................................................................................... 143 Conversion ............................................................................................................................. 143 Language Code ..................................................................................................................... 144 Module ................................................................................................................................... 144 Function ................................................................................................................................. 144 Description ............................................................................................................................. 145 Menu Group ........................................................................................................................... 145 Profile Codes 1-20 ................................................................................................................. 145 Transfer ................................................................................................................................. 145

Transfer Screen ........................................................................................................................... 145 Import or Export ..................................................................................................................... 145 Transfer File Name ................................................................................................................ 145 Language Code ..................................................................................................................... 145 Module ................................................................................................................................... 145 Process Transfer ................................................................................................................... 146 Database Code ...................................................................................................................... 146 File Code ............................................................................................................................... 146 Record Type .......................................................................................................................... 146 Record Key ............................................................................................................................ 146 Lock On ................................................................................................................................. 146 Pick ........................................................................................................................................ 152 Keybd ..................................................................................................................................... 152

Contents


Close ...................................................................................................................................... 152 Date ....................................................................................................................................... 152 IR (Item Record) .................................................................................................................... 152 Progs ..................................................................................................................................... 152 Archv (Archive) ...................................................................................................................... 153 Locks ..................................................................................................................................... 153 Sort ........................................................................................................................................ 153 VAT ........................................................................................................................................ 153

Chapter 8 Data Dictionary and Report Definition ..................................................................... 155 Template Id SSRU32 .......................................................................................................... 155 Record Id DDS .................................................................................................................... 155 Language Code ..................................................................................................................... 156 Report Type ........................................................................................................................... 156 System ................................................................................................................................... 156 Description ............................................................................................................................. 156 File Code ............................................................................................................................... 156 Record Type .......................................................................................................................... 156 Occurrence ............................................................................................................................ 156 Record Code .......................................................................................................................... 156 Record Description ................................................................................................................ 157 Template Id SSRU30 .......................................................................................................... 157 Record Id DDR ................................................................................................................... 157 Language Code ..................................................................................................................... 157 File Code ............................................................................................................................... 157 Data Record Type ................................................................................................................. 158 Description ............................................................................................................................. 158 Template Id SSRU28 .......................................................................................................... 158 Record Id DDD ................................................................................................................... 158 File Code ............................................................................................................................... 158 Data Record Type ................................................................................................................. 158 Item Number .......................................................................................................................... 158 Item Name ............................................................................................................................. 158 Entity ID ................................................................................................................................. 158 Offset ..................................................................................................................................... 159 COBOL Name........................................................................................................................ 159 Omit From Query ................................................................................................................... 159 Template Id SSRU29 .......................................................................................................... 159 Record Id DDT .................................................................................................................... 159

Contents


Language Code ..................................................................................................................... 159 File Code ............................................................................................................................... 159 Data Record Type ................................................................................................................. 159 Item Number .......................................................................................................................... 159 Description ............................................................................................................................. 160 Long Heading ........................................................................................................................ 160 Short Heading ........................................................................................................................ 160 Lookup Description ................................................................................................................ 160 Template Id SSRU25 .......................................................................................................... 160 Record Id DDE .................................................................................................................... 160 Database Code ...................................................................................................................... 160 Entity Id .................................................................................................................................. 160 Length on File ........................................................................................................................ 161 Input/Output Length ............................................................................................................... 161 Data Type .............................................................................................................................. 161 Numeric Type ........................................................................................................................ 161 Numeric Sign ......................................................................................................................... 161 Justification ............................................................................................................................ 161 Case Conversion ................................................................................................................... 161 Template Id SSRU26 .......................................................................................................... 162 Record Id DDL .................................................................................................................... 162 Language Code ..................................................................................................................... 162 Entity Id .................................................................................................................................. 162 Description ............................................................................................................................. 162 Long Heading ........................................................................................................................ 162 Short Heading ........................................................................................................................ 162 Template Id SSRU34 .......................................................................................................... 162 Record Id DDF .................................................................................................................... 162 Language Code ..................................................................................................................... 162 Report Type ........................................................................................................................... 163 Sub-Headings and Sub-Footings .......................................................................................... 163 Template Id SSRU27 .......................................................................................................... 163 Record Id DDK .................................................................................................................... 163 File Code ............................................................................................................................... 163 Data Record Type ................................................................................................................. 163 Relationship Number ............................................................................................................. 163 Element Data ......................................................................................................................... 163 File Code ............................................................................................................................... 163

Contents


Record Type .......................................................................................................................... 163 Item Number .......................................................................................................................... 164

Chapter 9 Associating Images with SunSystems v4 Modules ............................................... 165

Chapter 10 Appendix A – SunSystems v4 Data Tables and Files ............................................ 169

Chapter 11 Appendix B - Master Data Files ................................................................................ 173

Description ................................................................................................................................... 173

Summary of record types ............................................................................................................. 173 Cobol File Description (FD) ................................................................................................... 173

Reference file record descriptions ............................................................................................... 174

Description ................................................................................................................................... 498


Ledger file record descriptions .................................................................................................... 500

Description ................................................................................................................................... 508 Summary of record types ...................................................................................................... 508 Cobol File Description (FD) ................................................................................................... 508

Ledger archive file record ............................................................................................................ 508

Description ................................................................................................................................... 509

Indexing of balance file ................................................................................................................ 509

Summary of record types ............................................................................................................. 510 Cobol File Description ........................................................................................................... 510

Description ................................................................................................................................... 518 Cobol File Description (FD) ................................................................................................... 518

Sales Order File record descriptions ........................................................................................... 519

Description ................................................................................................................................... 536


Movement File record descriptions .............................................................................................. 538

Description ................................................................................................................................... 544


Stock Take File record descriptions ............................................................................................ 545

Description ................................................................................................................................... 553

Contents



Purchase Order File record descriptions ..................................................................................... 555

Description ................................................................................................................................... 619


Sales History file record descriptions .......................................................................................... 620

Description ................................................................................................................................... 625


Purchase History file record descriptions .................................................................................... 626

Description ................................................................................................................................... 631 Cobol File Description (FD) ................................................................................................... 631

Reference Audit file record descriptions ...................................................................................... 632

Description ................................................................................................................................... 633


Transfer file record descriptions .................................................................................................. 634

Description ................................................................................................................................... 642

Summary of record types ............................................................................................................. 642 Cobol Select...Assign Statement ........................................................................................... 642 Cobol File Description (FD) ................................................................................................... 642

Bank Payments file record description ........................................................................................ 643

Description ................................................................................................................................... 645


Description ................................................................................................................................... 657


Journal hold file record descriptions ............................................................................................ 659

Description ................................................................................................................................... 697

Summary of record ...................................................................................................................... 697

Chapter 12 Appendix C – SunSystems v4 Backup Files ........................................................... 719

Contents


Description ................................................................................................................................... 719

Summary of record types ............................................................................................................. 719

Reference backup file record descriptions .................................................................................. 719

Description ................................................................................................................................... 719


Ledger backup file record descriptions ........................................................................................ 720

Transaction Backup record .......................................................................................................... 721

Control Backup record ................................................................................................................. 723

Version 4.0 ................................................................................................................................... 724

The Control Backup record .......................................................................................................... 726

Description ................................................................................................................................... 728


Sales order backup file record descriptions ................................................................................ 728

Sales Order/Invoice Header Backup record ................................................................................ 728

Sales Order Detail Backup record ............................................................................................... 731

Sales Order Detail Extra Backup record ..................................................................................... 736

Description ................................................................................................................................... 737


Movement backup file record descriptions .................................................................................. 737


Movement Backup record ............................................................................................................ 738

Description ................................................................................................................................... 741

Stock take backup file record descriptions .................................................................................. 741


Stock Take Header Backup record .............................................................................................. 741

Stock Take Detail Backup record ................................................................................................ 743

Description ................................................................................................................................... 746


Purchase order backup file record descriptions .......................................................................... 746


Purchase Order Header Backup record ...................................................................................... 747

Goods Received Note Header Backup record ............................................................................ 750

Contents


Purchase Invoice Header Backup record .................................................................................... 752

Purchase Order Detail Backup record ......................................................................................... 755

Description ................................................................................................................................... 761


Sales history backup file record descriptions .............................................................................. 761

Sales History Usage Backup record ............................................................................................ 762

Description ................................................................................................................................... 764


Purchase history backup file record descriptions ........................................................................ 764

Balance Backup record ................................................................................................................ 764

Description ................................................................................................................................... 767


Journal hold file record descriptions ............................................................................................ 767

Standard Backup record .............................................................................................................. 767

Journal Control Backup record .................................................................................................... 768

Analysis Backup record ............................................................................................................... 773

Transaction Control Backup record ............................................................................................. 774

Transaction Line record ............................................................................................................... 776

Period Backup record .................................................................................................................. 779

Journal Hold Version Backup record ........................................................................................... 780

Journal Hold Control Backup record............................................................................................ 780

Journal Hold Journal Backup record ........................................................................................... 781

Chapter 13 Appendix D – Import Records .................................................................................. 783

Movement Import Batch Control record ...................................................................................... 783

Movement Import Detail record ................................................................................................... 783

Purchase Import Header/Detail/Text records .............................................................................. 786 Purchase Order Entry Header record - OENTH ................................................................... 786 Purchase Order Entry Item Lines - OENTI ............................................................................ 790 Order Entry Text Lines - OENTT ........................................................................................... 795

Goods Received Header/Detail records ...................................................................................... 797 GRN Match Item Header - OGRNH ...................................................................................... 797 GRN Match Item Lines - OGRNI ........................................................................................... 798

Purchase Invoice Header/Detail records ..................................................................................... 800

Contents


Invoice Match Item Header - OINVH ..................................................................................... 800 Invoice Match Item Lines - OINVI .......................................................................................... 802

Direct Purchase Import Header/Detail/Text records ................................................................... 806 Direct Invoice Header - DINVH ............................................................................................. 806 Direct Invoice Item Line - DINVI ............................................................................................ 809 Direct Invoice Text Line - DINVT ........................................................................................... 816

Sales Import Batch Control record .............................................................................................. 817

Sales Import Header record ........................................................................................................ 819

Sales Import Detail record ........................................................................................................... 822

Sales Import Description record .................................................................................................. 826

Journal Import record ................................................................................................................... 829 Control record ........................................................................................................................ 829 Accounting transaction .......................................................................................................... 830

Chapter 14 Appendix E - Installation File Records for version 4.4 DataLink .......................... 835

ODN records ................................................................................................................................ 835 SUN_DATA definition ............................................................................................................ 835

GDN records ................................................................................................................................ 837

Data and Miscellaneous Restrictions (ACP) ............................................................................... 838 ACP records .......................................................................................................................... 838

Menu Restrictions (OPA, DOP) ................................................................................................... 848 OPA records .......................................................................................................................... 848 SunSystems v4 functions (user input *** in database code) ................................................. 850 SunAccount functions (user input – System = “LA”, System Code=”SA”) ............................ 851 Commitment Inquiry .............................................................................................................. 852 Corporate Allocation functions (user input – System = “CO”, System Code=”SC”) ............. 855 Asset Register (user input – System = “AR”, System Code = “SF”) ..................................... 856 Inventory Control (user input – System = “IC”, System Code = “SM”) ................................. 859 Sales Order Processing (user input – System = “SO”, System Code = “SO”) ..................... 860 Purchase Order Processing (user input – System = “PO”, System Code = “SP”) ............... 863

DOP records ................................................................................................................................ 866

Transfer Manager Restrictions (TDA).......................................................................................... 867 TDA record ............................................................................................................................ 867

DAG records ................................................................................................................................ 870

System Code = SS (user input – database code = ***)............................................................... 876

System Code = SA (user input LA) ............................................................................................. 878

Contents


System Code = SC (user input CO) ............................................................................................ 880

System Code = SF (user input AR) ............................................................................................. 882

System Code = SO (user input SO) ............................................................................................ 884

System Code = SP (user input PO) ............................................................................................. 886

System Code = SM (user input IC) .............................................................................................. 888

System Code = SG (user input MM) ........................................................................................... 890

System Code = SX (user input SX) ............................................................................................. 892

Chapter 15 Appendix F – Limits in SunSystems v4 ................................................................... 895

Btrieve .......................................................................................................................................... 896

UNIX ............................................................................................................................................. 896

Chapter 16 Appendix G – Process Manager Commands and Call Points ............................... 897

Contents



About this guide The SunSystems v4 Technical Reference Manual is designed to assist you in the following ways: It explains the internal workings of SunSystems v4, so you can gain an understanding of the

flexibility of the software, and so ensure more efficient trouble shooting It explains how to establish interfaces to other systems by reading and writing to backup and

transfer files It enables you to customise SunSystems v4, particularly by modifying screens and print

formats, and by storing your own data items on reference files The manual is written for technical users of SunSystems v4. It assumes familiarity with standard computing procedures and techniques and uses computer terminology. It covers all SunSystems v4 hardware environments and operating systems. Where relevant, there are references to specific hardware environments.

Note: The information in this manual can be used to enhance SunSystems v4. If you are not careful, the information could also render your system unusable.

Types and versions of COBOL SunSystems v4 is written in ANSI (American National Standards Institute) COBOL: Micro Focus COBOL NetExpress

If you write additional programs to interface directly with SunSystems v4 you must use the same version of the COBOL language as used by your current version of SunSystems v4. Please contact your supplier to determine which COBOL version you should use.

Making changes References are made throughout this manual to ‘making amendments to text files’. For example: To COBOL program source files (see the section Printed Output) To backup data files (see the appendices) To screen layouts (see the section Screens and Menus).

Changes can be made to text files using any text editor as long as it does not insert special control characters. You are advised to document all file amendments. This is not just good practice, it is an essential source of information if you upgrade to a new version of SunSystems v4, when your amendments will have to be reapplied.

Intended audience This document is intended for System Administrators, SunSystems Consultants and Channel Partner Consultants involved in deploying and maintaining SunSystems.


Related documents In addition to this Technical Reference Manual, SunSystems v4 is accompanied by the following. These files, apart from the Help and Technical Reference Manual, are available on the installation CD, and can also be accessed from the Windows Start menu after installation, via Programs >> Infor SunSystems v4 >> Online Documentation. Readme User Note Installation Guide Upgrade Guide Implementation and Appreciation Guide Help

An interconnected suite of Help files is provided in HTML Help format. These are structured as follows: SunSystems v4 Basics SunSystems v4 Modules SunSystems v4 Administration

Note: The table of contents within the Help is designed to mirror SunSystems v4 when serialised for all modules. As such, the same help topic is displayed by multiple table of contents entries when the associated function can be launched from multiple module-level groups. For example, the SunSystems v4 Modules >> SunAccount >> Ledger Accounting >> Journal Import >> Overview, and the SunSystems v4 Modules >> SunAccount >> Corporate Allocations >> Journal Import >> Overview table of contents entries, both display the same topic. Accessing Help The Help files are accessed in the following ways: From the Start menu, via Programs >> Infor SunSystems v4 >> Online Documentation. The main Help file, System Basics, can be accessed from within the application via Help >>

Contents. Specific, context sensitive, Help topics can be accessed within a screen or function, via Help

>> Function Help.

Demonstration database A fully operational demonstration database, in multiple languages, is provided to allow you to familiarise yourself with the system before using your live database(s). Instructions for restoring the demonstration database are given in the SunSystems v4 Installation Guide.

Contacting Infor If you have questions about Infor products, go to the Infor Xtreme Support portal at www.infor.com/inforxtreme. If we update this document after the product release, we will post the new version on this Web site. We recommend that you check this Web site periodically for updated documentation.


If you have comments about Infor documentation, contact [email protected].


Structure of SunSystems v4 This section describes the structure of SunSystems v4 and the way the system works. The system may be divided into the following areas: The control program The kernel programs The utility programs The application programs.

The following diagrams represent the relationship between these areas.

Kernel programs Utilities Application programs

These programs will be loaded into main memory by SSMM.

Exceptions are sub-modules not required in a particular system.

For example: Inventory Movement File Handler is not used by Asset Register.

A suite of programs

that perform miscellaneo

us tasks throughout the system.

These programs are cancelled on program exit. They are not memory

resident.

Control programs Control programs are the driving programs of the system: SunSystems.v4.exe

This displays the SunSystems v4 menu and controls all calls to other functions on that menu. This is the only program loaded directly from the operating system.

Chapter 1 System Overview 1


Application programs There is an application program for each function you can select in SunSystems v4. The application program is called by the control program. For example, SALR.GNT is the application program that provides LR=Ledger Revaluation in SunAccount. The naming conventions for these programs are described in the section Naming Conventions.

Kernel programs When an operator invokes SunSystems v4, kernel programs are loaded by the control program SSMM. They act as service programs to the rest of SunSystems v4. Once loaded, they remain in memory until SunSystems v4 is closed down. The .NET Screen Handler handles user input to the display and acceptance of data within

the SunSystems application. The File Handler (SSFH) and its sub-modules control all access to SunSystems v4

permanent data and print files. An access can be any file statement, for example OPEN, READ ON KEY or START. Though the file handler does not control file access to temporary, local work files, it can supply a name for these files. Should an error occur during the processing of such a work file, the file handler can provide a suitable error message.

The Report Handler (SSRH) controls production of reports by providing report headings and report text.

File handler submodules The File Handler (SSFH) is used for access to all SunSystems v4 permanent data files and print files. There is a separate file handler module for each type of data file. The file handler is also used for naming temporary work files, and for formatting standard error messages: The File Handler Common Routines (SSFHCR) is invoked by SSFH when a work filename

is required, an error message is to be formatted, or a file is to be cleared. It is also used to check that a file or program exists

Specific File Handler modules (SSFH??) are invoked by SSFH when a program requires access to one of the SunSystems v4 permanent data files. The module is named according to the data file it uses. There is one module for each data file. The last two characters of the module name depend on the data file that the module uses. The following modules exist: – SSFHDD Data Dictionary File Handler – SSFHIN Installation File Handler – SSFHKF Stock Take File Handler – SSFHLB Balance File Handler – SSFHLF Ledger File Handler – SSFHLH Archive File Handler – SSFHLP Print File Handler – SSFHMF Movement File Handler – SSFHOF Sales Order File Handler – SSFHPC Purchase Order File Handler (for “C” record types) – SSFHPF Purchase Order File Handler (for entire P.O.P file) – SSFHPJ Purchase Order File Handler (for “J” record types) – SSFHPK Purchase Order File Handler (for “K” record types) – SSFHPL Purchase Order File Handler (for “L” record types) – SSFHPM Purchase Order File Handler (for “M” record types) – SSFHPN Purchase Order File Handler (for “N” record types)


– SSFHPO Purchase Order File Handler (for “O” record types) – SSFHPP Purchase Order File Handler (for “P” record types) – SSFHPS Purchase Order File Handler (for “S” record types) – SSFHQF Journal Hold File Handler – SSFHRA Reference Audit File Handler – SSFHRE Report File Handler – SSFHRF Reference File Handler – SSFHTR SunBusiness Transfer File Handler

The following file handler modules can only be found in the SQL server version of SunSystems v4:

– SSFHHF Sales Order History File – SSFHPY Payment File Handler – SSFHPU Purchase Order History File Handler

Utility programs The utility programs perform a number of miscellaneous tasks: The Special Functions program (SSSF) controls the CP=Change Printer, CD=Change

Database, and terminal functions. It switches file logging on and off, and performs various other housekeeping functions. It also validates passwords when logging in and sets up some system parameters.

The Reference Maintenance programs (SSRU, SSRR, SSRT and SSRA) control the updating, reporting, auditing and transfer of master data on the reference file. The Reference Maintenance section of this manual gives more details on these programs.

The Report Handling programs (SSRD and SSRF) provide a standard means of report design and production.

The Database Management programs (SSFC, SSFB and SSFB??) control the creation, backup and recovery of files.

The View Report program (SSVR) enables the operator to look at reports that have been Stored on Disk, rather than printed directly. See the section View Stored Reports in the SunAccount and SunBusiness Help.

The Analysis Category Length program (SSNL) enables the operator to amend the lengths of analysis codes within database code and category. These lengths are maintained in the data dictionary.

Naming Conventions


File types Broadly speaking there are two file types: Program files that hold instructions or parameters governing the way the system operates.

These files are not updated by SunSystems v4 but have read only access. Data files that hold data such as transactions or account details. These files have

read/write access. Each of these categories can be divided further into the following file types: SunSystems v4 uses the following types of program files: Source files Copy files Compiled program files System load files Template file Message files Layout files Report heading files Run time system files Transfer layout files.

The first two characters of a program file are: SA - SunAccount specific programs SF - Asset Register specific programs SC - Corporate Allocations specific programs SO - Sales Order Processing specific programs SM - Inventory Control specific programs SP - Purchase Order Processing specific programs SB - Sales Order Processing, Inventory Control and Purchase Order Processing programs SS - SunSystems v4 specific programs SZ - Utility programs.

Some ‘SA’ files may also be used by AR=Asset Register and CO=Corporate Allocations. SunSystems v4 data files can be divided into the following types: Permanent indexed files Permanent non-indexed files Temporary indexed work files Temporary non-indexed work files Stored print files Backup files Archive files Transfer files Audit files FreeFormat macro files.

Chapter 2 Naming Conventions 2

Naming Conventions


Program file naming Source files

Program source files contain the COBOL code, as written by the authors of SunSystems v4. These files must be compiled before they can be used to perform their respective functions. They are named Sxyyzz.CBL where: x is the system from the following list:

– S=SunSystems v4 – A=Ledger Accounting – F=Asset Register – C=Corporate Allocations – O=Sales Order Processing – M=Inventory Control – P=Purchase Order Processing – B=Common to SunBusiness – Z=SunSystems v4 Utilities.

yy usually reflects the program function code, for example, SAJL is the program name for the function JL=Journal Listing.

zz are optional characters used to distinguish between variants of the same program.

Examples SAJL.CBL SunAccount Journal Listing

SBIA.CBL SunBusiness Inventory Allocation

SSFH.CBL SunSystems v4 File Handler

SSFBQF.CBL SunSystems v4 Journal Hold File Backup/Restore.

Copy files

Copy files contain COBOL code, which is used throughout SunSystems v4. They can contain different types of code. For example: File Record Layouts Standard working-storage section Standard linkage section Common processing (e.g. date conversion).

Copy files are named Sxcccccc.CPY where: x is the system from the following list:

– S=SunSystems v4 – A=Ledger Accounting – F=Asset Register – C=Corporate Allocations – O=Sales Order Processing – M=Inventory Control – P=Purchase Order Processing – B=Common to SunBusiness.

Naming Conventions


cccccc is a meaningful name for the COPY statements contained therein.

Examples SALBKPRC.CPY Ledger Backup Record Layout

SALDGRRC.CPY Ledger File Record Layout

SAPAYRC.CPY Payment File Record Layout

SFSPRRC.CPY Spread Ratio Reference Record Layout

SFFDRRC.CPY Asset Diary Reference Record Layout

SFFVRRC.CPY Asset Value Reference Record Layout

SMMFBKRC.CPY Inventory Movements Backup Record Layout

SMMFRC.CPY Inventory Movements File Record Layout

SMMVDRC.CPY Movement Definitions Reference Record Layout

SOHFBKRC.CPY SOP History Backup Record Layout

SOHFRC.CPY SOP History File Record Layout

SOMFBKRC.CPY SOP Transactions Backup Record Layout

SOMFRC.CPY SOP Current Data Master File Record Layout

SOOPIRC.CPY SOP Order Detail Presets Reference Record Layout

SPHFBKRC.CPY POP History File Backup Record Layout

SPHFRC.CPY POP History File Record Layout

SPMFBKRC.CPY POP Transactions Backup Record Layout

SPMFRC.CPY POP Current Data Master File Record Layout

SPPUCRC.CPY Unit Conversion Table Reference Record Layout

SSINSRC.CPY Install File Record Layouts

SSANDRC.CPY Analysis Definitions Reference Record Layout.

Compiled program files

The source files are compiled by a COBOL language compiler to produce object files. Depending on the version of the COBOL language used, the object code may be

Naming Conventions


intermediate code or native code (or Unlinked Object and Linked Object). Native code is closer to the natural language of the computer hardware, and consequently will run faster.

Documents

Infor SunSystems Technical Reference Guide...SunSystems v4 Technical Reference Manual | 3 Contents About this guide ..... 19