· 9/98 i U0-8200 Engineering WEStation User’s Guide Section Title Page Westinghouse Proprietary...

Engineering WEStation User’s Guide

Section Title Page

1-2-3

2-12-3-6

-6-1115200248

30-33

3-1-2-3-4-579122

4-1-2

4-3-3-5

Section 1. Introduction

1-1. Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-11-2. Contents of this Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3. Additional Reference Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Section 2. Engineering WEStation Overview

2-1. Section Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2. Assumptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . -22-3. Definitions of Terms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-4. Accessing the Engineering WEStation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

2-4.1. Logging in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-4.2. Changing a Password. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-4.3. Logging out . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-

2-5. Configuring the Engineering WEStation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2-5.1. Using the WDPF Init Tool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-22-5.2. Accessing the WDPF Admin Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-22-5.3. Configuring WEStation Users Topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-22-5.4. WEStation Engineering Topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2

2-6. Engineering WEStation Menu Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2-7. Command Prompter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Section 3. Modifying and Downloading Configuration Files

3-1. Section Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2. WDPF Directory Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

3-2.1. Directory Tree Descriptions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33-2.2. Directory Hierarchy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

3-3. Configuration Control Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33-3.1. Reviewing Files in Read-Only Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3-3.2. Editing Files in Write Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3-3.3. Undoing the Last Edit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3-3.4. Displaying Revision Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1

Section 4. Software Server WEStation

4-1. Section Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2. Introduction to the Software Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44-3. Redundant Software Servers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4-3.1. Using the Software Server Access Function . . . . . . . . . . . . . . . . . . . . . . . . 44-3.2. Using the Backup Software Server Function. . . . . . . . . . . . . . . . . . . . . . . . 4

9/98 i U0-8200Westinghouse Proprietary Class 2C

Table of Contents, Cont’d

Section Title Page

-9925

5-1 5-2-2

5-61481249

32-37384142434-4848534

-70

6-16-21

11

-1245

Section 4. Software Server WEStation, (Cont’d)4-4. Software Server Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

4-4.1. Using the WDPF Init Tool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4-4.2. Accessing the WDPF Admin Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14-4.3. Configuring Software Server Topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1

Section 5. DPU Programming/MAC Utilities

5-1. Section Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2. Database Compare . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

5-2.1. Accessing the Database Compare window . . . . . . . . . . . . . . . . . . . . . . . . . 55-2.2. Setting the Database Compare Properties . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2.3. Performing a Single Point by Name Comparison . . . . . . . . . . . . . . . . . . . 5-15-2.4. Performing a Single Point by SID Comparison. . . . . . . . . . . . . . . . . . . . . 5-15-2.5. Performing a Comparison of One or More DPUs . . . . . . . . . . . . . . . . . . . 5-15-2.6. Performing a Comparison of All DPUs. . . . . . . . . . . . . . . . . . . . . . . . . . . 5-25-2.7. Output Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5-2.8. Source (DPU Object File/SHC/SPD) Inconsistencies . . . . . . . . . . . . . . . . 5-25-2.9. Errors and Informational Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-

5-3. BG Translate and BG Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55-3.1. Accessing the BG Translate and BG Print Programs . . . . . . . . . . . . . . . . 5-5-3.2. BG Translate Command Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5-3.3. BG Print Command Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5-3.4. Source File Format. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-

5-4. MAC Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-45-5. Sensor Calibrate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

5-5.1. Accessing the Sensor Calibrate Function . . . . . . . . . . . . . . . . . . . . . . . . . 5-5-5.2. Point Calibration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5-5.3. Manual Data Entry Calibration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-65-5.4. Error Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Section 6. File Transfer Utility

6-1. Section Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2. Using the File Transfer Program. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3. File Transfer Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1

6-3.1. Sample File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-6-3.2. Rules for Modifying ft_config . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-116-3.3. File Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

DEVICES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1REMOTE_HOST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

U0-8200 ii 9/98Westinghouse Proprietary Class 2C


Section Title Page

7-1

90

112

41518222-23-26

8-1-2-2-4

8-6-7

8-8-8-8-81415

Section 7. Data Highway and Hardware Utilities

7-1. Section Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2. ALTEST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-27-3. BUSLST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-8

7-3.1. BUSLST Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-Drop Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1Timekeeper Statements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-

7-3.2. Running the BUSLST Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-17-3. BUSLST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-12

7-3.3. BUSLST Command Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-17-3.4. BUSLST Errors and Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-

7-4. CHKLST. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-87-4.1. Running the CHKLST Program. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-17-4.2. CHKLST Command Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-27-4.3. CHKLST Errors and Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-

7-5. Record Hardware Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77-6. Data Highway Access. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Section 8. Administrative Functions

8-1. Section Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2. Adding/Removing a drop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88-3. Adding/Removing a User Name. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88-4. Adding/Removing a User Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88-5. Adding a Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-6. Engineering WEStation Menus. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88-7. Security Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

8-7.1. Protecting Engineering WEStation Command Files . . . . . . . . . . . . . . . . . . 88-7.2. Unsuccessful logins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88-7.3. BASE Security Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88-7.4. Detecting Idle Superuser Shells . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-

8-8. Controlling Access to WDPF Source Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-

9/98 iii U0-8200Westinghouse Proprietary Class 2C


Section Title Page

9-1-2-3-7-812356

19

-1-2

Section 9. Configuration File Reference

9-1. Section Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-2. Operating System Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

.cshrc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99-3. WDPF Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Command Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9databasefile.src . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-.login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-1.logout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-1sds_environ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-1set_sccs_admin Data Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-

Appendix A. Environment Variables

A-1. Section Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AA-2. WDPF Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A

Appendix B. Basic UNIX Commands

Glossary

Index

U0-8200 iv 9/98Westinghouse Proprietary Class 2C

Table of Contents, Cont’dList of Figures

Figure Title Page

2-6-71012-120331-33434535-36

-2-5-83-8

4-5-60


2-1. Engineering WEStation Screen at Start-up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2. Login Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 2-3. Top-level Engineering WEStation menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2- 2-4. Administration Menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2- 2-5. Change Password Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 2-6. Initialization Tool Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 2-7. WEStation Admin Tool Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 2-8. Top Level Menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2- 2-9. Tools Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 2-10. WDPF Drop Functions Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2- 2-11. WDPF DPU Functions Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2- 2-12. DPU Programming (MAC) Function Window . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3 2-13. Command Prompter Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2- 2-14. Command Prompter: Man Page Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Section 3. Modifying and Downloading Configuration Files

3-1. Relationship between Engineering WEStation and Software Server Disk Structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

3-2. Configuration Control Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 3-3. SCCS Revisions Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 3-4. SCCS Messages Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .


4-1. Software Server Access window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2. Backup Software Server Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 4-3. WDPF Init Tool Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1 4-4. WEStation Admin Tool Utility Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13

9/98 v U0-8200Westinghouse Proprietary Class 2C

Table of Contents, Cont’dList of Figures, Cont’d

Figure Title Page

5-75-87515253470

-625

-46-5

5-625


5-1. Database Compare Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2. Database Compare: Properties Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3. MAC Utilities Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4 5-4. Sensor Calibrate Initial Display. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5- 5-5. Choose Calibration Point Type Subwindow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5- 5-6. Point Directory Subwindow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5- 5-7. Point Calibration Subwindow and Calibration Point Data Entry Window . . . . . . 5-5 5-8. Calibration Menu Subwindow and Point Calibration Window . . . . . . . . . . . . . . . 5-5 5-9. RTD Calibration Subwindow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6 5-10. Enter Plot Scales Subwindow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 5-11. Choose Function Subwindow and Manual Entry Calibration Window. . . . . . . . . 5-6


6-1. File Transfer Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 6-2. Properties Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .


7-1. Alarm Test (ALTEST) Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7- 7-2. Alarm Test Network Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 7-3. Shift Log Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-

U0-8200 vi 9/98Westinghouse Proprietary Class 2C

Table of Contents, Cont’dList of Tables

Table Title Page

1-3

-3-4

42629

416

-10-10

--36-70

12

7-9-1522


1-1. Reference Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .


2-1. Terms Specific to the Engineering WEStation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 2-2. Terms Used with the Window Manager and Mouse . . . . . . . . . . . . . . . . . . . . . . . . 2 2-3. Initialization Utility Window Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-21 2-4. WDPF Admin Tool Window Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 2-5. WEStation Users FIlter Topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2- 2-6. Engineering Filter Topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-


4-1. Initialization Utility Window Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10 4-2. WDPF Admin Tool Window Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1 4-3. Software Server Filter Topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-


5-1. Impact of Settings on Point-based Comparison. . . . . . . . . . . . . . . . . . . . . . . . . . . 5 5-2. Impact of Settings on DPU-based Comparison . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 5-3. Fatal Errors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-33 5-4. Serious Errors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533 5-5. Informational Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 5-6. Sensor Calibrate Error Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5


6-1. ft_config Keywords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-


7-1. BUSLST Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2. Errors and Messages for BUSLST. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 7-3. Errors and Messages for CHKLST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-

U0-8200 vii 9/98Westinghouse Proprietary Class 2C

Table of Contents, Cont’dList of Tables, Cont’d

Table Title Page

-10

-2

-2

Section 8. Administrative Functions

8-1. Base Software Filter Topics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Appendix A. Environment Variables

A-1. Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A

Appendix B. Basic UNIX Commands

B-1. UNIX Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B

9/98 viii U0-8200Westinghouse Proprietary Class 2C

9/98 Changes-1 U0-8200Westinghouse Proprietary Class 2C

Summary of Changes

This revision of “Engineering WEStation User’s Guide” (U0-8200) has beenupdated to include information related to software release 8.5. These changesinclude the following:

• Section 2 added to the Definition of Terms table, added a WEStation Usersection, and changed the Command Prompter example.

• Section 3 changed the WDPF Directory Structure and provided new figureexamples that reflect changes in the directory structures through theWDPF InitTool andWDPF Admin Tool. The Directory Navigator and theQuery/Download were deleted (Query/Download is now part of theWDPFAdmin Tool).

• Section4 added the Software Server Configuration and new figure examples toreflect the changes in the directory structures.

• Section 8 provided directory structure changes for adding/removing a username or a user level. TheWDPF Admin Tool will access and create/modify theusers’ menus. BASE Security Parameters were also added.

Miscellaneous clarifications and corrections have also been incorporated.

n

be

d forcess

rver

e


1-1. Overview

The Engineering WEStation (also known as the Software Development Statio(SDS)) provides an environment for the development and maintenance ofapplication and system software. Programs, data, and configuration files canretrieved from the Software Server WEStation for the purpose of creating andmaintaining the system configuration. Programs and files can also be retrievethe purpose of developing and maintaining software applications (such as prodiagrams created using the Graphics Builder) and software for other drops(Operator WEStation, Log Server WEStation, and so forth). The EngineeringWEStation (EWS) is often combined on the same WEStation as the Software Seto make up the SS/EWS drop (also known as the SS/SDS).

In its initial mode, the Engineering WEStation can be used as an OperatorWEStation. All of the functionality of an Operator WEStation is available on thEngineering WEStation. See“Operator WEStation User’s Guide” (U0-8100) formore information on Operator WEStation functions.

9/98 1-1 U0-8200Westinghouse Proprietary Class 2C

1-2. Contents of this Document

on

lso

n

fer

m

e

1-2. Contents of this Document

This document is organized as follows:

Section1. Intr oduction describes the organization of the Engineering WEStatiUser’s Guide.

Section2.EngineeringWEStation Overviewprovides information on new terms,drop access, and menu structure.

Section3.Modifying andDownloadingConfiguration Filesdescribes the WDPFdirectory structure and the programs needed to modify configuration files. It aprovides a step-by-step tutorial on the configuration process.

Section4. SoftwareServer WEStation discusses the Software Server WEStatiodrop.

Section 5. DPU Programming/MAC Utilities provides information on thefunctions that pertain to the DPU and MAC Utilities.

Section6.File Transfer Utility describes the procedures for using the File Transprogram.

Section 7. Data Highway and Hardware Utilities provides information onutilities that pertain to the Data Highway and hardware functions.

Section 8. Administrative Functions provides general information on systemadministration.

Section9. Configuration File Referencelists and describes the operating systeand WDPF configuration files that pertain to the Engineering WEStation andSoftware Server WEStation.

Appendix A. Envir onmentVariables lists the environment variables that must bset for correct operation of the Engineering WEStation.

Appendix B. Basic UNIX Commandsdescribes a basic set of commandsnecessary to navigate around a UNIX system.

U0-8200 1-2 9/98Westinghouse Proprietary Class 2C

1-3. Additional Reference Documentation

ons

y

.

of


This document is intended as an introduction to Engineering WEStation functiand also serves as a “pointer” to other reference manuals which describeconfiguration for other WDPF drops.Table1-1 suggests other manuals which mabe helpful while using this document.

Table 1-1. Reference Documents

DocumentNumber Title Description

M0-0003 Self-Test Diagnostics Provides information on the SystemStatus Diagrams and fault codes.

M0-8000 WDPF System Planning andHighway Installation Manual

Provides information on the SHCconfiguration files and describes theprocedures for creating a BusAllocation List (BAL).

M0-8005 Drop Installation Manual(WEStation Equipped)

Discusses hardware configuration forWEStation drops, Multibus-baseddrops, and standard peripheral devices

U0-0131 Record Types User’s Guide Provides information on point typesand record fields.

U0-0132 Custom and Non-Standard TextAlgorithm User’s Guide

Describes the procedures for creatingcustom DPU algorithms andprogramming them into PROMs.

U0-8001-x.x WEStation Software Load Kit Discusses loading the WDPF andoperating system software for theWEStation system (x.x = the revisionnumber of the operating system).

U0-8100 Operator WEStation User’s Guide Discusses the use of the OperatorWEStation drop.

U0-8110 Operator WEStation ConfigurationManual

Discusses configuration of theOperator WEStation drop.

U0-8205 System Point Directory User’s Guide Discusses the configuration and usethe System Point Directory.

U0-8210 WEStation Graphics Builder User’sGuide

Discusses the configuration and use ofthe Graphics Builder.


See Master Pages for applicable version of this document.


e

ting

the

In addition to the documents listed inTable 1-1 , this manual may refer to“applicable vendor documentation”, which is defined on a project basis. Thesdocuments may include:

• Operating system (UNIX/Solaris) manuals.• Window manager (OpenWindows) documentation.• Workstation hardware (Sun) documentation.• Peripheral device documentation.Man pages (standard UNIX on-line documentation) are also available for operasystem functions and certain WDPF functions.

Appendix B contains a table of basic UNIX commands.

U0-8300 Defining and ConfiguringWEStations

Provides information on configuringWEStations using the Init and AdminTools.

U0-8400 WEStation Log Server User’s Guide Discusses configuration and use ofLog Server WEStation drop.

U0-8500 WEStation Historian (HSR)User’sGuide

Discusses configuration and use of theHistorian WEStation drop.

U0-8600 Computation Server WEStationUser’s Guide

Discusses configuration and use of theComputation Server WEStation drop.

U0-8700 WEStation Data Link Server User’sGuide

Discusses configuration and use of theWEStation Data Link Server.

Table 1-1. Reference Documents (Cont’d)

DocumentNumber Title Description


cture.

Section 2. Engineering WEStationOverview

2-1. Section Overview

This section provides information on new terms, drop access, and menu struThe following topics are included:

• Assumptions (Section 2-2).• Definitions of Terms (Section 2-3).• Accessing the Engineering WEStation (Section 2-4).

• Logging in (Section 2-4.1).• Changing a password (Section 2-4.2).• Logging out (Section 2-4.3).• Engineering WEStation access configuration (Section 2-5).• WEstation Users Topics (Section 2-5.3).• WEStation Engineering Topics (Section 2-5.4).

• Engineering WEStation menu structure (Section 2-6).• Command Prompter (Section 2-7).


2-2. Assumptions

nobuilt”se,

2-2. Assumptions

This document assumes that the appropriate operating system and applicatiosoftware have been properly loaded on the Software Server WEStation. It alsassumes that the Software Server and the Engineering WEStation have been “with the appropriate downloading and modification of files. If this is not the casee“WEStation Software Load Kit” (U0-8001-x.x), or contact a Westinghouserepresentative.



2-3. Definitions of Terms

re

afied

le

o

ed

tedget

n a

red

ach


Table 2-1 defines terms and phrases specific to this manual.Table 2-2 lists termsthat describe window manager and mouse functions. General WDPF terms adefined in the Glossary. For detailed information on the window manager oroperating system functions, refer to the applicable vendor manuals.

Table 2-1. Terms Specific to the Engineering WEStation

Term Definition

Directory A special file used to logically group files and other directories.

Download Process by which a file is copied from the primary Software Server totarget drop and is then assigned the permissions and ownership speciby a queryfile.

File The basic unit in the data organization that resides on tape or diskstorage. A file is identified by its path name and can contain for exampdata, source, or executable programs.

File server A computer that provides users of a local area network with access tshared data and program files. For the WDPF system, the SoftwareServer WEStation is the file server.

File system A collection of files and directories that, when set into a logicalhierarchy, compose an organized, structured set of information.

Mounted filesystem

A file system that exists on a remote file server’s disk but can be accessas though its files are on the user’s local workstation’s disk.

Query Process by which files on a Primary Software Server that are designaby queryfiles for a target drop are compared against the files on the tardrop’s disk.

Queryfile File that describes what source files on a Software Server should be otarget drop. This file describes the destination for a file and itspermissions and ownership download.

Path name A fully specified file name that tells the executing command whichdirectories or, in some cases, which device to search to find the desifile or directory.

To list a path name in a command entry, the user enters the name of edirectory within the path in descending hierarchical order. Eachdirectory must be separated by a slash (/). The following exampledescribes a file,config.dat, contained in directory,lab, whose parentdirectory isusr1 that is the top-most (or root) directory.

/usr1/lab/config.dat



ed.

ell

e

to

e

ired

e.

m

eft.

Path name(Cont’d)

Once the user creates a new file or directory, its path name remains fixunless the user renames or moves that file or directory to a new path

Script File A text file that contains a sequence of operating system commands. Shscript files are used to simplify repetitive tasks and the execution ofsyntactically sensitive commands.

Software ServerBackup

The process of the Primary Software Server’s files being copied to thBackup Software Server. SeeSection 4 for more information onredundant Software Servers.

Software ServerDisk Reconciliation

The process of newer files on a Backup Software Server being copiedthe Primary Software Server upon the initialization of the BackupSoftware Server. SeeSection 4 for more information on redundantSoftware Servers.

Target Directory Destination for a file on the target drop.

Target Drop Drop to which files are being downloaded. Also, it is the drop on which thuser has performed a query.

Table 2-2. Terms Used with the Window Manager and Mouse

Term Definition

Apply button Button located on many data entry WEStation windows. Verifies thedata, enters information into the database, and may also start a desoperation.

Close Action that requires a user to close a window to an icon.

Double click Action that requires a user to rapidly click the left mouse button twic

Drag and Drop Window manager function that allows the user to “drag” data from onewindow and “drop” it into the entry field in another window.

Grayed out Color of a button or entry field that indicates that a function or menu iteis not available to the user.

Icon Graphical representation of a window.

Left click Action that requires a user to click the left mouse button once. The lmouse button is used to select a window or an item inside a window

Table 2-1. Terms Specific to the Engineering WEStation (Cont’d)

Term Definition



ms.

e

ht

Middle click Action that requires user to click the middle mouse button once. Themiddle mouse button is used to deselect an item or select additional ite

Open Double click on an icon to open it to a window.

Pushpin Symbol used to “pin” the menu or window to workspace. Remove thpushpin to close the menu or window.

Right click Action that requires a user to click the right mouse button once. The rigmouse button is used to open a menu.

Workspace Graphical environment where menus and diagrams are located.

Table 2-2. Terms Used with the Window Manager and Mouse (Cont’d)


2-4. Accessing the Engineering WEStation

tion

2-4. Accessing the Engineering WEStationThe initial Engineering WEStation display is the same as an Operator WEStadisplay with the addition of one icon (seeFigure 2-1). Selecting the EngineeringWEStation login icon opens aLogin window through which the user may log in tothe Engineering WEStation environment (seeSection 2-4.1).

2-4.1. Logging in

Use the following procedure to login and access the Engineering WEStationfunction:

1. Open the Engineering WEStation login icon (seeFigure 2-1).

2. The Login window appears (seeFigure 2-2).

Figure 2-1. Engineering WEStation Screen at Start-up

Engineering WEStation login icon

WESlogin



rator)
3. Enter the user name (the name that was assigned by the System Administin theName: entry field.
Note

A trailing space after a username isnot validfor software release 8.4 and later (forexample, “user4 ” is valid for Solaris, butnotfor a WEStation username).

Usernames are identified via the WDPF Admin Tool (seeSection 8).

4. Enter the user’s password in thePassword: entry field. For security reasons, thepassword is not echoed (does not appear in the field).

Note

It is recommended that the password be at least sixcharacters long and combine upper-case letters,lower-case letters and possibly numbers and specialcharacters (for example, # or ~). However, only thefirst eight characters of a password are read; anyremaining characters are ignored. See the applicableoperating system documentation for moreinformation on password rules.

Figure 2-2. Login Window



em’swithnuser

at

e

5. Select theApply button (or press theReturn key on the keyboard toautomatically selectApply ).

The message “Attempt Login Request” displays in the footer of theLoginwindow. The entered user name and password are verified against the systusername password data. If the login is successful, the login icon is replacedanother icon that, when opened, presents a menu of Engineering WEStatiofunctions (see figure below). The menu is based on the group to which the belongs. SeeSection 8 for information on adding user groups and menus.

Note

An operator event message is sent to the Operator EventLogger indicating which user logged in. See“WEStationHistorian User’s Guide” (U0-8500) for information onOperator Event messages.

If a .login file was defined for the user, any commands added to thfile will execute upon login (an example may include starting an operatingsystem shelltool at login). The.login file is commonly used to grant auser access to functionality controlled by the$WDPF_HOME/mmi/config/lockout.dat file. If so, the.logoutfile should reset thelockout.dat fileupon logout. SeeSection 8 for more information on the.login and.logout files.

See“OperatorWEStationConfigurationManual”(U0-8110) for information onthe lockout function.This file is constructed from the WDPF Admin Tool in thfollowing displays:

Function: Define Software ConfigurationFilter: OperatorTopic: Function Lockout Configuration



Notes

If the message, “Login attempt failure” displays in thefooter of theLogin window, it could indicate one ofseveral problems: the wrong password was entered;the username is unknown to the system; the user maybelong to a group not granted access to the window; orthe username could be disabled due to too manyinvalid login attempts. Before contacting the SystemAdministrator, select theReset button to clear thePassword: field and then re-enter the password.

For security reasons, the number of login attempts islimited (seeSection 8).

Engineering WEStation login icon

WESlogin



lays

cal

ser isr levelated

oupsser

erget

hed in

g

When the new icon is selected, the top-level Engineering WEStation menu dispas shown inFigure 2-3.

The Engineering WEStation menus are configurable by the project, but a typiconfiguration (as shown in the examples in this manual) is supplied with thestandard release. Menu access is determined by the user’s group when the uadded to the system. Users should be segregated into groups according to theiof access to functionality. One Engineering WEStation menu should then be crefor each group. The System Administrator determines whether or not these grare hierarchical. SeeSection 8 for more information on adding a username, a ulevel, and user menus to the system.

The Download Configuration to Drops function allows the user to download thconfiguration files and the data files (located on the Software Server) onto the tadrops. (The “Query /Download” function is now contained in the “DownloadConfiguration to Drops” function.)

The software configured for the drop determines which icons will display on tEngineering WEStation at start-up. The Engineering WEStation icon is definethelogin.iconfile that was created in the OpenWindows icon editor (thelogin.iconfile is configurable by the user and is found in the /export/wdpf/ rel/data/sds/wesusr/config/icon[.drop###]/ directory on the Software Server and in the/usr/wdpf/sds/config/icondirectory on the target drop). For more information on usinthe icon editor, see the applicable OpenWindows documentation.

Figure 2-3. Top-level Engineering WEStation menu



al

on a

For information on Engineering WEStation hardware configuration and optionperipheral devices, see “Drop Installation Manual” (M0-8005).

2-4.2. Changing a Password

The Change Password function allows users to change their system passwordlocal Engineering WEStation.

To change a password, follow the steps below:

1. SelectAdministration on the top-level Engineering WEStation menu (seefigure below).



TheAdministration menu appear as shown inFigure 2-4.

2. SelectChange Password from theAdministration menu.

TheChange Password window appears (seeFigure 2-5).

Figure 2-4. Administration Menu

Figure 2-5. Change Password Window



3. Select theApply button on theChange Password window to display theOld password: prompt (see figure below):

Note

If there is no password to start with, there is no “Oldpassword” prompt. The user will start with the “Newpassword”.

4. Enter the old password at theOld password: prompt, and press theReturn keyon the keyboard (see“Drop InstallationManual”(M0-8005) for information onstandard peripheral devices).TheNew password: prompt displays.

Enter the new password at theNew password: prompt, and press theReturnkey on the keyboard.



.

in thee

Note

It is recommended that the new password be at leastsix characters long and combine upper-case letters,lower-case letters and possibly numbers and specialcharacters (for example, # or ~). However, only thefirst eight characters are read; any remainingcharacters will be ignored. See applicable operatingsystem documentation for more information onpassword rules.

TheRe-enter new password: prompt displays (see figure below):

5. Enter the new password again at theRe-enter new password: prompt andpress theReturn key on the keyboard. This step verifies the new password

6. Select theApply button.

If the change was successful, the message “Password changed” appearsfooter of theChange Password window. If the change was unsuccessful, thmessage “Password not changed” appears.



,

Note

As a security precaution against leaving a passwordaccount open for another user to change thepassword, the Change Password function has a timelimit assigned to it by the System Administrator. Ifthe user is changing a password and time expires, theChange Password process must be redone. SeeSection 2-5 for more information on the ChangePassword time limit.

2-4.3. Logging out

When finished working with the Engineering WEStation functions, it isrecommended that the user log out. To log out of the Engineering WEStationfollow the steps below:

1. Select theAdministration button from the top-level Engineering WEStationmenu (see figure below).



TheAdministration menu displays (see figure below).

2. SelectLogout on theAdministration menu.



the

nce ofges

When theLogout button is selected, a confirmation window appears askinguser to verify the logout (see figure below).

3. Select one of the following buttons on theAcknowledge window:

Proceed to logout.

OR

Cancel to cancel the logout request.

Applications that are still running when the user logs out are given the chato exit while either saving the data or discarding it, depending on the typeapplication running. For example, a text editor may write all unsaved chanto a file. An application such as the calculator will simply exit.



he

ge

on

Note

Processes are terminated based on generations.When a user logs out, all remaining applicationsdirectly started from the user menu are terminated.Next, any remaining “children” processes startedfrom that first generation are terminated. Thiscontinues until all generations have been examinedand terminated.

Caution

It is not recommended that the user shutdown hisprocesses by simply logging out. It is recommendedthat the user orderly quit each application prior tologging out since the time limit given by the logoutprocess may not always accommodate the shutdowntime needed by an application. In addition, not allapplications may gracefully exit when terminated inthis manner.

If a user opens a shelltool window, runs anapplication in the background, and then logs out, thebackground process will be terminated. However, ifthe user opens a shelltool, runs an application in thebackground, and then exits the shelltool beforelogging out, the process will not be terminated. Seethe applicable operating system documentation formore information on running background tasks.

If a .logoutfile is defined for the user, any commands contained in tfile will be executed when the user logs out. SeeSection 2-4.1 for moreinformation on the.logout file.

An operator event message is sent to the Operator Event Logger indicatinwhich user logged off. In addition to the normal message format, one of thfollowing reasons will be given as to why the user logged out:

• Reason: Normal logout — The user simply logged out.• Reason: Hide login request — Used with the membrane keyboard to

indicate that the system is not in CONFIG mode. For more informationthe membrane keyboard, see “Operator WEStation User’s Guide”(U0-8100).



n

• Reason: Shutdown — The system shutdown. The user was not given achance to properly log out.

• Reason: Menu failed— The menu program failed. The user was not givea chance to properly log out.

See “WEStation Historian User’s Guide” (U0-8500) for information onOperator Event messages.


2-5. Configuring the Engineering WEStation

ies a

em


The Engineering WEStation configuration will be performed through two utilitthat are provided with the WDPF release and appear initially as two icons onWEStation screen. These are theWDPF Init Tool and theWDPF Admin Tool.

Refer to the following sections for instructions on configuring EngineeringWEStations. Refer to “Defining and Configuring WEStations” (U0-8300) foradditional information on using the Init and Admin Tool.

2-5.1. Using the WDPF Init Tool

Use the following procedure to enter and use the WDPF Initialization Tool.

1. Use the mouse to select the WDPF Init Tool icon from the EngineeringWEStation screen.

2. Figure 2-6 provides an example of the WEStation Initialization Tool mainwindow that will display on the screen. This window’s contents will actuallydepend upon the software packages selected in the system.Table 2-3 definesbriefly the functions available through this window. Access the Help menu it“Defining Configuration” for additional information on window functions.

3. Perform the desired functions (described inTable 2-3 )

Figure 2-6. Initialization Tool Window



.

-

p

ne

ta-

n,

4. Select theSave Configuration to Disk button to save the changes to the disk

The main window of the Init Tool contains the following functions.

Table 2-3. Initialization Utility Window Functions

Function Description

Help Button Displays a pull right menu that displays informationHelp pages forthe Initialization Utility.

Properties Button Accesses apop-up window that displays the paths where the releasesoftware and the project software are located.

Modify /Add /DeleteDrop Types Button

Accesses apop-up window that allows the user to specify the soft-ware packages for each drop type, and to define new drop types.

Drop Configuration Scrolling list that shows thedrops that are currently defined in theproject’s configuration. Selecting a drop in this scrolling list will determine the drop type that is initially displayed when selecting theModify/Add/Delete Drop Types function.

Selected DropNumber

Displays thedrop number for the drop that is selected in the DropConfiguration list.

Drop Type Displays thedrop type for the drop that is selected in the Drop Con-figuration list. Also allows user to change selected drop’s drop type.

Shared DropNumber

Displays theshared drop number for the drop that is selected in theDrop Configuration list. Redundant WEStations and DPU’s with TDMSavings require three drop numbers: one for each drop and one drothat they share.

Ethernet IP Address Displays the Internet Protocol (IP) address for the drop that isselected in the Drop Configuration list. If an address is not entered, owill be assigned automatically. For example, 192.9.200.157. Do notuse leading zeros.

Ethernet EthersAddress

Displays theunique hardware address for each Ethernet port forthe drop that is selected in the Drop Configuration list. Format is sixtwo-digit hexadecimal numbers separated by colons. For example,8:80:3f:f4:7:a9. To determine the Ethers address of a running WEStion, log in as root and enter the following:ifconfig -a

Processor Hostid Displays theunique hardware address for each processor for thedrop that is selected in the Drop Configuration list. Currently notrequired. To determine the Processor Hostid of a running WEStatioenter the following:hostid



isk.

n

Note

Initialization Utility functions can be disabled bythe System Administrator for security purposes.This will prevent unauthorized users from havingwrite access to the configurable parameters (refertoU0-8300) for information on disablingfunctions).

2-5.2. Accessing the WDPF Admin Tool

Use the following procedure to enter the WDPF Admin Tool.

1. Use the mouse to select theWDPF Admin Tool icon from the EngineeringWEStation screen.

Architecture Displays thehardware platform for the drop that is selected in theDrop Configuration list.

Disk Partitioning Displays thedisk partitioning for the drop that is selected in the DropConfiguration list.

Insert Drop Button Adds anew drop to the configuration.

Delete Drop Button Removes a drop from the configuration.

Show DropContents Button

Accesses apop-up window that lists the software packages that areincluded on the drop that is selected in the Drop Configuration list.

Save Configuration toDisk Button

Writes theConfiguration changes to the disk. This button is grayedout if there are no changes to be made to the configuration.

Reset Configurationfrom Disk Button

Erases configuration changes to the selected drop, and restores thelast configuration for the selected drop that was to be saved to the d

VerifyConfigurationButton

Verifies that the system configuration is valid. Any errors are shown ia pop-up window.

Apply Button Moves data from the bottom of the window into the scrolling list.

Table 2-3. Initialization Utility Window Functions (Cont’d)




won

ng

Figure 2-7 provides an example of the WEStation Admin Tool main windothat will display on the screen.The window’s contents will actually depend upthe software packages selected in the system.Table 2-4 defines briefly thefunctions available through this window. Access the Help menu item “DefiniConfiguration” for additional information on window functions.

2. Refer toSection 2-5.3 andSection 2-5.4 for instructions on configuring theEngineering WEStation.

Figure 2-7. WEStation Admin Tool Window



The main window of the Admin Tool contains the following functions.

2-5.3. Configuring WEStation Users Topics

Use the following procedure to configure the WEStation Users topics:


2. Select theDefine Software Configuration from the pulldown Function menu.

Table 2-4. WDPF Admin Tool Window Functions


Help Button Displays a pull right menu that displays informationHelp pages for theAdmin Tool.

Properties Button Accesses apop-up window that displays the paths where the releasesoftware, configuration files, and project software are located. Also providesoptions to preview files before downloading, and whether the “Install” buttonmodifies files, or just checks if the files would be modified.

Function Button Displays a pull right menu that provides these options:Define Software ConfigurationInstall Configuration on Software ServerMaintain Project DataDownload Configuration to Drops

Each option enables the user to perform different configuration tasks, andprovides the applicable windows and buttons to perform these tasks.

Filter ScrollingList

A scrolling list that allows the user to limit the number of items shown in theTopic scrolling list. Selecting items from the Filter Scrolling list will displaythe corresponding configuration parameters in the Topic scrolling list. Theconfiguration parameters will appear in a GUI window when selected in theTopic scrolling list. If no items are selected in the Filter scrolling list, no itemswill appear in the Topic scrolling list.

Topic ScrollingList

A scrolling list of configurable topics that correspond to specific GUIwindows. Selecting a topic displays a GUI window that corresponds to theTopic selected.



be

ed

3. SelectWEStation Users from the Filter scrolling list.

4. Select the desired Topic from the Topic scrolling list.Table 2-5 defines theavailable topics.

5. After the desired configuration changes are complete, the following must done before the changes will take effect:

• Use the “Install Configuration on the Software Server” function (describin the “Defining and Configuring WEStations” (U0-8300)) to install thechanges on the Software Server.

• Use the “Download Configuration to Drops” function (described in“Defining and Configuring WEStations” (U0-8300)) to download themodified files from the Software Server to the appropriate drops.



Table 2-5. WEStation Users FIlter Topics

Topic Item Description

EWS WEStation UserParameters

Configuration For DropNumber

SelectAll drops or select from a listof drops to apply the Topicchanges.

Shutdown Cleanup Delay(secs)

Defines time between shutdownrequest and actual shutdown.

Login Disable Time (secs) Defines time between login beingdisabled (invalid login attemptsexceeded allowed number) and thelogin account being re-enabled.

Login Failure Attempts Defines number of invalid loginattempts allowed before login isdisabled.

EWS WEStation UserGroups

Configuration For DropNumber


WEStation User Groups Scrolling list of groups that havevalid system logins.

WEStation User Groups Entry field to enter group name.

Unix Group ID Numerical identifier for group.

Group Members User names assigned to a group.



EWS WEStation Users Configuration For DropNumber


Unix User Name Scrolling list of case-sensitive textuser name.

Unix User Name Entry field for case-sensitive textuser name.

Full Name Entry field for free-format text username.

Default Shell Defines the command line editorfor the user name.

User ID Numerical identifier for user name.

Group Name Identifier for user’s default group(not the numerical ID).

Home Directory Full path to user’s home directory.

Home DirectoryPermissions

Defines permissions for user’shome directory.

Permissions are encoded in 3groups of 3 characters each(indicatingread,write, execute) rwx rwx rwxwhere first rwx = owner second rwx = group third rwx = world

If more than one user is to share thesame home directory, world-writepermission must be enabled on thatdirectory. (This is NOTrecommended. Instead createunique home directories andgroup-writable work directories.)

Table 2-5. WEStation Users FIlter Topics (Cont’d)



2-5.4. WEStation Engineering Topics

Use the following procedure to configure the WEStation Engineering topics:


2. Select theDefine Software Configuration from the pulldown Function menu.

3. SelectEngineering from the Filter scrolling list.



t be

ed

4. Select the desired topics from the Topic scrolling list.Table2-6 defines theavailable topics.

5. After the desired configuration changes are complete, the following musdone before the changes will take effect:

• Use the “Install Configuration on the Software Server” function (describin “Defining and Configuring WEStations” (U0-8300)) to download themodified files from the Software Server to the appropriate drops.

• Use the “Download Configuration to Drops” function (described in“Defining and Configuring WEStations” (U0-8300)) to download themodified files from the Software Server to the appropriate drops.

Table 2-6. Engineering Filter Topics

Topic Item Description

LS Report Builder Parameters Configuration For DropNumber

SelectAll drops or select froma list of drops to apply theTopic changes.

Report Builder Base Directory Defines the default directoryused by the Report Builder forthe creation of report files.


2-6. Engineering WEStation Menu Structure

easy, and

ss is

Foreroms the

nu.

u.

ring


The Engineering WEStation menus and windows are designed to give users access to such WDPF functions as drop configuration, system administrationhighway control.

The Engineering WEStation menus are configurable by the project. Menu accedetermined by the user’s group when the user is added to the system. SeeSection8for information on adding a username and a user level.

A typical menu configuration is supplied with the standard WEStation release.all procedures described in this manual, the examples use the menus from thtypical configuration. Even though user-defined menus may differ in content fthe Westinghouse-supplied menus, the basic use of the menu system remainsame. To describe the menu levels, three terms are used:

• Top-level Menu defines the first level (or page) of the menu system.• Parent Menudefines the menu which is one level higher than the current me• Child Menu defines a menu which is one level lower than the current menSee “Operator WEStation Configuration Manual” (U0-8110) for information oncreating menus.

The top-level menu appears after the user successfully logs in to the EngineeWEStation (seeSection 2-4.1 for more information on login procedures).



t thesed

terhen

This

Note

On the top-level menu, theTop Level Menu andParent Menu buttons are inactive (grayed out).

Lower level menus (Child menus) and higher level menus (Parent menus) direcuser to various Engineering WEStation functions. These functions will be discusin greater detail throughout this document.

As part of the standard configuration, menu buttons display either a “>” or “...” afthe name on the button. The caret (>) indicates that another menu will display wthe button is selected. The three dots (...) indicate that a window will display. button naming convention is only meant as a cue to the user. A project mayconfigure the menus as it chooses.

Figure 2-8. Top Level Menu



enur and

ing

intsto the

Depending on how the menus are configured, one Engineering WEStation mmay provide access to the operating system functions (such as the text editocommand tool) and other third-party vendor programs. On the standardWestinghouse menus, this access is gained by selecting theTools button on thetop-level menu (seeFigure 2-8).

To gain access to a command line, select theCommand Line Access button on theTools menu (seeFigure2-9). Depending on the user’s software revision, accessa command tool may take the SHC off the highway (software releases prior to8.3.5). If the SHC is taken off the highway, the current drop cannot receive poor broadcast points. This is done to prevent erroneous data from being sent onhighway.

Note

See the applicable vendor documentation for moreinformation on using the operating system and third-party software.

Figure 2-9. Tools Menu


2-7. Command Prompter

ng a of

an thist be on a


The Command Prompter window allows the user to define arguments for runnicommand. The Command Prompter displays a command’s name and the listarguments that apply to that command. A command may still be executed fromoperating system command tool; however, the Command Prompter simplifiesprocess since the user may not know the proper syntax or options or may nogranted access to a command line. The user can also request the man pagescommand from the Command Prompter. See applicable operating systemdocumentation for more information on man pages.

Note

The Command Prompter is found on severalEngineering WEStation menus. For illustrationpurposes, the steps below show one example of howthe Command Prompter may be used.

1. SelectDrop Functions from the top-level menu (see figure below).



TheDrop Functions menu displays (seeFigure 2-10).

2. SelectDPU from theDrop Functions menu.

TheDPU menu displays (seeFigure 2-11).

Figure 2-10. WDPF Drop Functions Menu

Figure 2-11. WDPF DPU Functions Menu



3. Select theDPU Programming (MAC) function from theDPU menu.

TheDPU Programming (MAC) menu displays (seeFigure 2-12).

4. Select theBG Translate function from theDPU Programming (MAC) menu.

A Command Prompter window displays with thebgdesc_translatecommandlisted at theCommand: prompt (seeFigure 2-13).

Figure 2-12. DPU Programming (MAC) Function Window

Figure 2-13. Command Prompter Window



on

5. InFigure2-13 notice the??? button next to theCommand: bgdesc_translate

entry. Select the??? button, and a man page appears providing informationthebgdesc_translatecommand (seeFigure2-14). Scroll through the text usingthe scrollbar.

Figure 2-14. Command Prompter: Man Page Viewer



in the

e

are

rte:

ck ite

ing

Arguments and Options

The Command Prompter presents the arguments and options for a commandfollowing way:

Check box = Only used with command options. Allows the user to chooswhether or not to select the option. Selecting the check boxtoggles the active/inactive state of the option. Check boxesnot used with required command arguments.

Option = Text preceded by a hyphen.

Optionentryfield

= Entry field following an option label and colon. Allows the useto enter parameters for the option (such as file names). (NoNot all options have an entry field.)

Requiredargument

= Text that is required for the command (does not have a chebox beside it). If a??? button appears beside the argument,will display a man page for the argument when selected (seapplicable operating system document for information on usman pages).

Applybutton

= Executes the command.



of the

o,es.

with

To illustrate how these arguments and options are used, examine the syntax bgdesc_translate command as shown below:

bgdesc_translate [-f source_filename] [-o output_filename][-p SPD] [-v] [-h]

The Command Prompter inFigure 2-13 displays the options,-f source_filename,-o output_filename, -p SPD, -v, and-h each preceded by a check box. The -f, -and -p options have an entry field for the user to enter the appropriate file namThe user can modify all of the default values shown inFigure 2-13.

If the user were to run the bgdesc.translate command from the command linethe -f and -o options, the command might read:

bgdesc_translate -f /usr/wdpf/shc/config/bgdesc.src-o /usr/wdpf/shc/config/bgdesc.bin

The same command can be executed from theCommand Prompter as shown inthe following example:

1. Based on the illustration shown inFigure 2-13, select the check boxes for the-f and-o options on theCommand Prompter window.

2. Enter /usr/wdpf/shc/config/bgdesc.srcon the-f line’s entry field and/usr/wdpf/shc/config/bgdesc.binon the-o line’s entry field.

3. Select theApply button.



The results of running the command are displayed in aCommand Promptersubwindow.

The subwindow is read-only except for theAbort button. When theAbortbutton is selected, the executing command is interrupted. The messageCommand aborted displays in the footer of the display window.

Note

If a command starts a windowed application, thatwindow opens instead, and the Command Prompterwindow terminates.


g aandethe

areee

e

Section 3. Modifying and DownloadingConfiguration Files


The Engineering WEStation is the plant engineer’s primary tool for configurinWDPF system. It provides an environment for the development, maintenance,installation of configuration files. Programs, data, and configuration files can bretrieved from the Software Server for the purpose of creating and maintainingsystem configuration and WDPF applications. Most interaction with the SoftwServer’s files is done through the WDPF Init Tool and the WDPF Admin Tool (s“Defining and Configuring WEStations” (U0-8300).

Note

The Query/Download function is now part ofthe WDPF Admin Tool (see“Defining andConfiguring WEStations” (U0-8300)).

This section provides an overview of the programs and procedures needed tomodify configuration files on the Engineering WEStation. Before discussing thprograms, an explanation of the WDPF directory structure is given.

The following topics are included in this section:

• WDPF directory structure (Section 3-2).• Configuration Control function (Section 3-3).

Note

Since the design of the Engineering WEStationallows direct access to the applicable operatingsystem, other drops, and the Westnet II DataHighway, it is assumed that the user has a thoroughunderstanding of the functionality of the WDPFsystem and the operating system commands.


3-2. WDPF Directory Structure

ssed

. TheFS,

ortslocal

n in


To understand the WDPF software directory structure, two drops must be discu— the Engineering WEStation and the Software Server.

The Engineering WEStation and the Software Server have a direct relationshipSoftware Server provides storage (in the form of exported filesystems via the NThe Network File System) for the archived application software and systemsoftware, and associated configuration files. The Engineering WEStation imp(that is, mounts) these Software Server filesystems and provides the tools anddisk space for modifying these files during development. Mounted filesystemsappear to the user as files and directories on the local workstation’s disk, whefact, the files and directories are on a remote Software Server’s disk.

Figure 3-1 shows the relationship of the Engineering WEStation and SoftwareServer disk structures.Section 3-2.1 describes the directories in the tree.

Figure 3-1. Relationship between Engineering WEStation and Software ServerDisk Structures

EngineeringWEStation

Software ServerWEStation

/export/wdpf/wdpf

sccsrel

ssw data data

config



r, ite

ource

s

userer be

ol,

ect

ded

3-2.1. Directory Tree Descriptions

The sections below describe the WDPF directories that are shown inFigure 3-1.

/export/wdpf

This directory contains all of the Software Server files. On the Software Serveexists as a disk partition, named/export/wdpf by the system load procedures (se“WEStation Software Load Kit” (U0-8001-x.x) for more information).

/wdpf

On the Engineering WEStation orSS/EWSdroptype,/wdpf should be used tonavigate the mounted Software Server’s files.

/export/wdpf/rel/ssw

This directory contains a snapshot of the released system software and is the sof the initial download to all drops. It is also the source of the periodic revisionquery of all drops.

The data in the/rel directory is either loaded directly from a release media, or iloaded after modifications to the release are verified to be operational in adevelopment directory. To ensure integrity of the Software Server’s/wdpf/rel/sswdirectory, the Engineering WEStations should have read-only access to thisdirectory (seeSection 4-4). Therefore, changes to/wdpf/rel must be made by the“superuser” who is logged-in on the Software Server. To make a modification torel,the System Administrator should tightly control who has login access and superaccess to the Software Server. It is highly recommended that only the superusallowed write-access to/rel/ssw (see the applicable operating systemdocumentation for more information on superuser).

This directory may be accessed on the Engineering WEStations via /wdpf/rel/ssw.

/export/wdpf/rel/data

This directory tree contains all of a project’s configuration data, including itsSystem Point Directory (SPD), the drop definitions entered on the WDPF Init Tothe subsystem customizatons performed via the WDPF Admin Tool’s “DefineSoftware Configuration” screens, and the WDPF Admin Tool’s “Maintain ProjData” screens, such as graphics, reports, and DPU source files.

As such, a project should undertake procedures toback up the directory treefrequently. Should disk corruption occur, the WEStation Software can be reloafrom CD, but the user is responsible for creating a backup of this data area.




in’sby

ntroles

m

dingt are

) are

/export/wdpf/rel/config

This directory tree is populated during the “install” operation on the WDPF AdmTool. Information entered in the WDPF Init Tool and in the WDPF Admin Tool“define” windows is retrieved and formatted into configuration files understoodthe WEStation online subsystems. Once these files are created, they may bedownloaded to the target WEStations via the WDPF Admin Tool.

This directory may be accessed on the Engineering WEStation’s via/wdpf/rel /config.

/export/wdpf/sccs

This directory houses WDPF files for the operating system SCCS (source cocontrol system) function. This directory structure “mirrors” the directory structurin /export/wdpf/rel/data, such that a user can check out, modify, and check inSCCS files via eitherrel or a development directory tree while maintaining systesoftware integrity. File checkout/checkin is done via the WDPF Admin Tool’s“Maintain Project Data” screen.

This directory may be accessed on Engineering WEStation via/wdpf/sccs.

Note

Modifying files under SCCS control should beperformed by using either the Configuration Controlwindow or thewdpf_sccscommand line (seeSection3-3 orwdpf_sccs man pages for additionalinformation).

3-2.2. Directory Hierarchy

Based on the directory structure shown inFigure3-1 and described inSection3-2.1,WEStation software and configuration files are arranged into directories depenon whether or not the files may be configured on a per-project basis. Files thanot to be configured for a project are contained within a directory tree namedssw(standardsoftware), subdirectory of /export/wdpf/rel , and /export/wdpf/sccs.Most executables, software libraries, and man pages fall into this category.

Project data (SPD, graphics, reports, trend groups, etc.) and configurationinformation (alarm colors, HSR subsystem sizes, Printer Manager printers, etc.all kept under/export/wdpf/rel/data.


3-3. Configuration Control Function

ion

user- a


Most SCCS interaction is performed via the WDPF Admin Tool.The ConfiguratControl Utility described in this section would be most useful in configurationcontrol of items not under the framework of the WDPF Admin Tool.

The Source Code Control System (SCCS) is a utility that is provided with thestandard operating system. It is used to maintain software version control overmodifiable files, thus preserving system integrity. The WDPF system providesuser interface to SCCS through theConfiguration Control window (seeFigure 3-2).

Notes

This utility only provides an interface to SCCS. Formore information on SCCS, see the applicableoperating system documentation.

Modifying files under SCCS control should beperformed by using either the Configuration Controlwindow or thewdpf_sccscommand line (seeSection3-3 orwdpf_sccs man page for additionalinformation).

Figure 3-2. Configuration Control Window



l,n

rcentrol.

akeation

CCSen a ae

CSrver.able

esn.

When using the command line to invoke SCCScommands, those users with redundant SoftwareServersmust use the$WDPF_HOME/sds/bin/wdpf_sccs command. Upon startup of anEngineering WEStation, this command is designedto work on both Software Servers, if a redundantconfiguration is used.

TheConfiguration Control window allows users to take files out of source controedit them, and then place them back in source control with an updated revisionumber. Files can be retrieved from SCCS in one of two ways:

• Read-only mode — allows the user to view the contents of the file, but nochanges can be made. With this option, the file is not “checked out” of soucontrol so it does not need to be saved and checked back in to source coSeeSection 3-3.1.

• Write mode — the file is “checked out” of source control, and the user can mchanges to the file in a system text editor (see applicable vendor documentfor more information on the system text editor). SeeSection 3-3.2.

Once changes have been made to the file, it is “checked in” to SCCS. The Sutility saves the changes and assigns a new revision number to the file. Whrelease tape is made of the system software, the most current version (orspecified version known to work) of the files can be taken from source codcontrol.

Interaction with Software Servers

If redundant Software Servers are available (on-line) in the system, theConfiguration Control utility will keep the primary and secondary SoftwareServers’ SCCS information identical. For example, if a file is checked out of SCon one Software Server, it will also be checked out of the backup Software SeIf the Software Server then swaps primary and backup modes, the user will beto check in any changes made, although the check in will occur on a differentprimary Software Server. If and when the other primary Software Server comback on-line in secondary mode, its disk will be updated to reflect the check-i

Note

The Configuration Control window or the wdpf_sccscommand shouldalways be used when redundantSoftware Servers are being used (refer to wdpf_sccsman page for additional information).



tes

s as

theary

re

an

There is a danger tonot using the Configuration Control utility or thewdpf_sccscommand line with redundant Software Servers. The following example illustrathis danger:

• The system has redundant Software Servers.• A file is signed out of SCCS via thesccs command instead of via the

Configuration Control utility or thewdpf_sccscommand.

• The periodic backup of the primary Software Server’s disk to backup occurdescribed inSection 4.

• The user signs the file back in via thesccs command on the primary SoftwareServer. The file is still signed out on the backup Software Server’s disk.

• A failover of the Software Servers occurs before the next periodic backup ofprimary Software Server to the backup Software Server. Now the new primSoftware Server will show the file as being signed out of SCCS. If the oldprimary Software Service is “healthy” enough to become a backup SoftwaServer, the disk reconcile will not solve the problem. The user will notunderstand why a file was checked-in is still seen as out-for-edit.

3-3.1. Reviewing Files in Read-Only Mode

1. Invoke the Configuration Control Utility. (The released user menus provide“SCCS...” button on the Tools submenu.)

TheConfiguration Control window appears.

2. Enter the pathname of the file to be modified.



nu.

ore

3. Select theGET button on theConfiguration Control window.

TheSCCS Revisions window displays a list of the revisions for the file.(SeeFigure 3-3).

4. Select the desired revision to review from the list. The entry highlights.

5. Select theSelect revision button.

TheSCCS Messages window appears (seeFigure 3-4).

6. To view the file in a text editor, start up a text editor from the Tools subme

A text editor displays. See applicable operating system documentation for minformation on using the system text editor.

Figure 3-3. SCCS Revisions Window

Figure 3-4. SCCS Messages Window



an

3-3.2. Editing Files in Write Mode

1. Invoke the Configuration Control Utility. (The released user menus provide“SCCS” button on the Tools Submenu.)



3. Select theEDIT button on theConfiguration Control window.

TheSCCS Revisions window displays with a list of the revisions for the file(see figure below).

4. Select the desired revision to edit from the list. The entry highlights.

5. Select theSelect revision button.



ore

enlect

TheSCCS Messages window appears.(see figure below).

6. To edit the file in a text editor, move the pointer back to a Tools submenuwindow, and select theEdit ... button.

A text editor displays. See applicable operating system documentation for minformation on using the system text editor.

Note

When editing is complete, be sure to save thechanges in the text editor.

7. After the file has been saved in the text editor and the modification has betested to be operational, place the file back in source control. To do this, setheDELTA (or DELGET) button on theConfiguration Control window. (IfDELGET is selected the file will be retrieved read-only;DELTA removes the fileafter signing it into SCCS.)



ereCS.

al

ge

file.

A comment field displays on theConfiguration Control window (see figurebelow). This allows the user to add a message describing what changes wmade, the reason for the changes, and so on, before it is saved under SC

8. Enter a message in theEnter Comment entry field that is associated with thenew revision of the file. A maximum of 180 characters can be used. Thiscomment will appear in the SCCS Revisions window with the new revisionnumber.

9. After typing in the comment, press theReturn key on the keyboard (see“DropInstallation Manual” (M0-8005) for more information on standard peripherdevices).

TheSCCS Messages window displays (see figure below). Notice the messathat appears in the window.

In the figure above,1.5 is the new revision number. The lines66 inserted 0deletedmeans that 66 lines were inserted and zero lines were deleted in the



ngerwill

st

an

3-3.3. Undoing the Last Edit

If the user has checked out a file for edit and decides that the changes are no loneeded, the edit function can be cancelled. The last saved version of the file remain in source control. To do this, follow the steps below.

Note

A file must be checked out for edit to use theUNEDITbutton. SeeSection 3-3.2.

1. Select theUNEDIT button on theConfiguration Control window.

TheSCCS Messages window displays (see figure below).

3-3.4. Displaying Revision Information

The user can display revision information for a file to see when the file was larevised. To do this, follow the steps below:

1. Invoke the Configuration Control Utility. (The released user menus provide“SCCS” button on the Tools submenu.)





3. Select theRevision Info button on theConfiguration Control window.

TheSCCS Revisions window displays (see figure below). Notice that theSelect revision button is grayed out (inactive).


pics



This section discusses the Software Server WEStation drop. The following toare included:

• Introduction to the Software Server (Section 4-2).• Redundant Software Servers (Section 4-3).• Software Server Configuration (Section 4-4).


4-2. Introduction to the Software Server

les

e

the

eachsionlesn toy

r

t file.

4-2. Introduction to the Software Server

The purpose of the Software Server WEStation is to maintain and distribute fi(software and data) to all drops throughout a WDPF system. In addition toexecutable, configuration, and data files, the Software Server may maintainconfiguration control of source files. Modifications to the source files should bcontrolled and tracked through the WDPF Admin Tool,Configuration Controlwindow or thewdpf_sccscommand (used with redundant Software Servers) onEngineering WEStation to the operating system source code control tool. SeeSection 3 for more information on theConfiguration Control window.

The Software Server contains a list of the software and data that should be on drop within the system. Periodically, the Software Server can perform a file reviquery, which identifies mismatches between its “officially endorsed” versions of fiand what is actually on the system’s drops. Through the Download ConfiguratioDrops function on the WDPF Admin Tool, files can be downloaded to correct anidentified mismatches. See“Defining and Configuring WEStations” (U0-8300) fomore information on the Query/Download operation.

The Software Server can perform in either a single unit configuration or as aredundant pair. A redundant pair provides an additional level of assurance thaintegrity is maintained. SeeSection4-3 for more

· 9/98 i U0-8200 Engineering WEStation User’s Guide Section Title Page Westinghouse Proprietary...

Documents

Transcript of · 9/98 i U0-8200 Engineering WEStation User’s Guide Section Title Page Westinghouse Proprietary...