I/A Series Workstation Configuration: April 1, 1992
I/A Series Workstation Configuration: April 1, 1992
I/A Series Workstation Configuration: April 1, 1992
REV B
I/A Series®
Workstation Configuration
April 1, 1992
Proc_Eng_Env
Proc_OP_Env
Maint_Env
Plant_Mgmt_Env
Softw_Eng_Env
Init_Env
BPM_Env
Passwd_EnvCfg
NEW
ENVIRONMENT CONFIGURATOR
Environment: Envmnt_Name
Description: sample screen
Password:
Label Path
1 Sys /usr/fox/sys
2 keep
3 keep
4
5
6
7
8
9 keep SAVE EXIT SELECT DELETE
10 keep
B0193AG – Rev B
ii
Contents
Preface............................................................................................................................... v
Revision Information .......................................................................................................... v
1. Introduction ................................................................................................................ 1
Index .............................................................................................................................. 19
iii
B0193AG – Rev B Contents
iv
Preface
This document provides procedures for setting up and configuring workstations, workstation
access, and operating environments. It is designed for use by the system administrator, and
system or process control engineer.
♦ Chapter 1 “Introduction”, explains the Password Environment Configurator and
the use of this document.
♦ Chapter 2 “Accessing the Password Environment Configurator”, describes the I/A
Series screens seen while accessing the configurator and explains how to use the
configurator.
♦ Chapter 3 “Coordinated Display Configurator”, describes the Coordinated Dis-
play Configurator and provides information for configuring display sets for a
multi-screen cluster.
Revision Information
For System Release 3.0:
♦ General editorial changes throughout.
♦ “Display-Area Protection in Environments” on page 10 – Added information for
50 Series Applications Processors and Workstations.
v
B0193AG – Rev B Preface
vi
1. Introduction
An environment is any collection of programs, utilities, and displays grouped according to
users and the tasks they perform. The programs, utilities, and displays are accessed from a top
menu bar that is different for each environment.
The Password Environment Configurator has two applications:
♦ Environment menu bars: The configurator enables you to create, edit, and delete
environments (top menu bars) as an aid to organizing plant functions. It also
allows you to configure each environment’s top menu bar to contain different
tasks, functions, or pull-down menus.
♦ Environment passwords: The configurator enables you to assign passwords to each
environment, thus securing them against unauthorized access.
Document conventions are as follows:
♦ CAPITALIZED text indicates either an action taken with an input device or text
found in the Password Environment Configurator.
♦ Initial Caps indicate text found in the Configurators. For example, Initial Envi-
ronment, AlarmHist, or BPMSys.
♦ Soft key is a term used to describe simulated keys on the display such as OK, CAN-
CEL, CLOSE, and CONTINUE.
1
B0193AG – Rev B 1. Introduction
2
2. Accessing the Password
Environment Configurator
To access the Password Environment Configurator, make the following selections from the
initial I/A display screen:
Select – SYS from the top menu bar. A submenu appears with additional selections.
Select – Change_Env, to change environments. A submenu appears listing the existing envi-
ronments.
Select – PassWd_EnvCfg. Change to the configurator’s environment.
Select – UtlCfg from the top menu bar.
Select – PassWd_Env_Cfg.
You can now select an existing environment to edit or delete, or create a new environment.
Proc_Eng_Env The green triangles at the bottom enable you to scroll the menu
Proc_OP_Env when there are more than 12 items in the list.
Maint_Env
Plant_Mgmt_Env When you select an environment, this menu disappears and
Softw_Eng_Env the new environment’s configurator screen appears.
Init_Env
BPM_Env You can now edit the top menu bar for the new environment.
Passwd_EnvCfg
NEW
ENVIRONMENT CONFIGURATOR
Environment: Envmnt_Name
Description: sample screen
Password:
Label Path
1 Sys /usr/fox/sys
2 keep
3 keep
4
5
6
7
8
9 keep SAVE EXIT SELECT DELETE
10 keep
3
B0193AG – Rev B 2. Accessing the Password Environment Configurator
NOTES: 1. Two environments cannot share the same name. If you attempt to create
an environment when its name already exists, you access the already-existing environ-
ment.
2. The configurator automatically places the new environment name in the environ-
ment field of the configurator screen.
3. You cannot edit the environment name. If you must change an environment
name, note the contents of each field and delete the whole environment. Then recre-
ate the old configurator screen by selecting NEW. Refer to your notes and rename the
environment.
4. The configurator automatically places the new environment name on two menus:
the Change_Env submenu and the configurator menu.
Deleting an Environment
You can delete any environment except the Initial Environment. Deleting an environment is
the only way to change the environment’s name. Since you cannot rename an environment,
you must delete it and start over.
♦ Select the environment name you wish to delete from the configurator menu. The
configurator screen appears for that environment.
♦ Select the DELETE soft key. The soft key turns yellow and a dialog box appears. Its
warning message confirms the environment's name and offers you two selections,
YES or CANCEL.
If you decide not to delete it, select CANCEL. You return to the configurator
screen originally selected.
4
2. Accessing the Password Environment Configurator B0193AG – Rev B
♦ Select YES from the dialog box. When the YES box changes color, the deletion is
completed and the configurator menu reappears.
Editing an Environment
Either adding text to or deleting text from the configurator screen is considered an edit. More
than just editing the top menu bar entries, you are also editing the functions performed when
these entries are selected.
Use the following general procedure to edit environments. Additions and exceptions are noted
in the section for each field.
♦ Select a field to the right of the field name. The red box that appears is the size of
the field. It changes to yellow when you select it.
♦ Type text into the blank field. You can type over text already in the field or you can
delete it using the BACKSPACE and DELETE keys.
♦ Press RETURN when you have finished typing or deleting. The field returns to
red. You can select another field or exit the configurator.
♦ Select EXIT; a dialog box appears prompting you to save this configuration before
exiting.
If you want to configure more than one environment, select the SAVE key before
selecting another environment.
♦ Select YES from the dialog box. The configurator saves the environment and
returns you to the Initial Environment.
Depending on what environment you are configuring, the configurator screen fields may or
may not need editing.
♦ Default environments come with the top menu bars configured by Foxboro. You
can use them immediately or edit them to better suit your applications.
♦ New environments have only basic applications until edited. The configurator
automatically inserts the Initial Environment into a new environment using the
KEEP command.
Except for SAVE, the soft keys at the bottom of the screen work after selecting an environ-
ment from the configurator menu. Soft keys change color, from blue to yellow, when you
select them and perform the following functions:
SAVE Is not active until you edit the environment.
EXIT Leaves the configurator, returning you to where you were when you
entered the configurator. If you have not saved your edits, a dialog box
appears asking you to do so.
SELECT Displays the configurator menu so you can select another environment.
DELETE Deletes any environment, except the initial one.
Editing an Environment 5
B0193AG – Rev B 2. Accessing the Password Environment Configurator
Entering a Password
The password field holds a password of up to 10 characters: letters, numbers, or symbols. Use
the underscore character between words instead of spaces.
If no password is associated with an environment, as when you first receive the default envi-
ronments, the dialog box does not appear on your screen. The default environments are acces-
sible to everyone.
If this field is not blank, changing to the environment brings up a dialog box requesting you
to type in the password.
♦ When you enter the correct password, the environment “opens up” by displaying
the environment’s top menu bar.
♦ If you enter an incorrect password, a message asks you to try again. It repeats the
request this until it gets the correct password.
♦ If you select CANCEL it returns to the previous environment.
If the initial environment is password-protected, cancelling after a reboot locks
you out. You must reboot the station again and enter the correct password. If it is
not after a reboot, cancelling on the initial environment just brings up the previous
environment.
♦ Do not forget your password!
6
2. Accessing the Password Environment Configurator B0193AG – Rev B
Changing an existing label does not change the field’s function – only its name on the menu
bar. To change a field’s function, you must also change the path associated with it.
To change a label, retype (or delete and replace) the label name. If you leave the label blank,
the field appears blank on the menu bar when you access the environment.
CAUTION: If you delete SYS from the Initial Environment, you are disabled from
using any SYS function after a reboot. If you cannot select SYS after a reboot, you
cannot change to an environment that has it. The Change_Env function must be
available in the initial environment.
When you create a new label, you must also list the path to the program, function, or menu
that this label is to activate.
NOTE: Except for the KEEP command, if there is no path associated with a label
name, the name does not appear on the menu bar.
There are two ways to link a label with a program, function, or menu:
1. Enter the path name of the program, function, or menu in the path field to the
right of the label name.
2. Type KEEP in the label field.
The KEEP command keeps a label on the menu bar from the previous environment. “Previ-
ous” means the last environment you were in. This could be different from time to time. For
example:
Initial Environment Environment 2 Environment 3
SYS HELP KEEP
LABEL1 KEEP KEEP
LABEL2 LABEL4 KEEP
LABEL3 KEEP KEEP
If you change from the initial environment to Environment 3, the labels read:
SYS LABEL1 LABEL2 LABEL3
If you then change to Environment 2 and back to Environment 3 again, the labels read:
HELP LABEL1 LABEL4 LABEL3
Environment 3 has different third fields, because the different “previous” environments had
different third fields.
If you do not want to use this feature, you can put a KEEP in the same field in all environ-
ments (except the initial one) for labels you want to keep the same in all environments. Then
you need only change the Initial Environment’s field to change the label in all environments.
Of course, you can always type a label and path wherever you want.
When you create a new environment, the configurator automatically places the KEEP com-
mand in the same field locations as the Initial Environment. The KEEP command, then,
Editing an Environment 7
B0193AG – Rev B 2. Accessing the Password Environment Configurator
ensures that the new environment has the SYS, ALARM, HELP, and SELECT functions on
the menu bar.
If your new environment does not require all of the Initial Environment’s functions, delete or
edit them. Again, do not delete SYS from the initial environment. If your new environment
requires functions not included in the Initial Environment, add them.
If the previous menu bar was blank, then the KEEP command in the next selected environ-
ment’s field will be blank too.
8
2. Accessing the Password Environment Configurator B0193AG – Rev B
Display files do not have to be in the /usr/disp sub-directory unless they are to be called from
an annunciator key (which expects to find its displays there). The environment software can
determine whether a file is a display or executable file.
ENVIRONMENT CONFIGURATOR
Environment: Brewery_2
Description: EXAMPLE
Password:
Label Path
1 Sys
/usr/fox/sys When you select Brew2 from the menu
2 keep
bar, the 2nd brew display appears.
3 keep
4
5 Brew2 /usr/disp/brew2
6 Boiler dmcmd almhist
When you select Boiler from the menu
7
bar, the alarm history for the boiler appears.
8
See Display Manager Commands.
9 keep
10
The configurator checks to see whether the path you specified is legal. If the path is incorrect
or a file does not exist, a dialog box appears notifying you to enter the correct file and path.
The dmcmd (Display-Manager) command is covered in “Display Manager Commands” on
page 11.
Security
In systems as shipped from Foxboro, any user can establish security by configuring environ-
ments. The Password Environment Configurator offers you three basic procedures for design-
ing system security:
♦Configure menu bars to contain only choices you want accessible from that
environment.
♦ Assign passwords to each environment.
♦ Use the setacl Display-Manager command to make pickable areas in displays
accessible only to certain environments.
When you receive the I/A Series software, the environments are categorized and configured by
personnel type: Process Operator, Software Engineer, and so forth. Only certain functions are
available on the top menu bar in each environment.
Setting the labels in different environments and establishing passwords was covered in “Delet-
ing an Environment” on page 4. The next section, “Coordinated Display Configurator” on
page 13, contains more information on using the setacl command to set protection (access
control) levels in graphics.
After building a graphic display, use the Display Configurator to establish pickable areas of
the display and set the action that results when a user selects that area. You can also assign each
pickable area a “protection class” number from 0 to 255.
Security 9
B0193AG – Rev B 2. Accessing the Password Environment Configurator
For each environment you can have some protection class numbers enabled and others dis-
abled. A pickable area in a display is only pickable in environments where its protection class
number is enabled. A single display can have many different pickable areas, each with a differ-
ent number.
Protection class zero is the default and is accessible to all environments.
NOTE: Both the ice and vi editors are available for AP20 and WP20 or WP30.
However, vi is the only editor available for AP50 and WP50.
1. In the VT100 mode, create a new sub-directory, such as /usr/fox/env2, for exam-
ple. Type:
cd /usr/fox
mkdir env2
cd env2
2. Move the environment data file into the new directory and change the name.
(Move it back when you want to use the Password Environment Configurator,
which expects it to be there.) Use the new name. Type:
mv /usr/fox/sys/Change_Env/Proc_Op_Env ProcessOpr
This moves the data file to the new sub-directory (which you are in when you type
this command) and changes the name.
3. Replace the environment data file in the /Change_Env sub-directory with a script
file that sets the protection levels and then calls the moved and renamed environ-
ment data file.
For example: Replace the /usr/fox/sys/Change_Env/Proc_Op_Env data file with
the following script of the same name:
dmcmd script
= P2 $ENV
/usr/fox/env2/ProcessOpr
!= $P2 $ENV dmcmd setacl 13 -++
NOTE: If you are configuring environments for 50 Series workstations (WP50s), this
is the last step. If you are configuring environments for WP20s or WP30s, perform
Step 4.
10
2. Accessing the Password Environment Configurator B0193AG – Rev B
The previous script sets some Display Manager globals and invokes the environ-
ment from its new home with protection classes set with the setacl command.
The setacl command turns access to a pickable display object on or off in every
display called up from the environment.
In the example, dmcmd setacl 13 -++ means “Starting at protection class 13, dis-
able 13, and enable 14 and 15.”
dmcmd setacl 50 ++--.- means “Starting at class 50, enable classes 50 and 51, dis-
able 52, 53, and 55 and leave 54 unchanged from its current setting (same as the
last environment used).”
You can use the ice editor from the VT100 mode, but if you want to use vi to create the script
file use the station terminal unless you are on a PW.
Note that the mkmact and allmact utilities, and the New_Menus menu pick are not avail-
able for AP50 or WP50 stations. Directories are read directly by the Display Manager when
displaying menu data.
12
3. Coordinated Display
Configurator
The multi-screen workstation feature allows you to configure a group of workstations having
the same host Application Processor to form a multi-screen cluster.
The Coordinated Display Configurator is used to configure display sets for a multi-screen
cluster. To access the configurator:
1. From within the Process Engineer’s Environment, select Config in the top menu
bar.
2. From the Config pull-down menu, select Coord_Disp_Cfg.
Within the Coordinated Display Configurator, the following menus appear:
Cluster Menu:
If there is more than one cluster within the host AP, this is the first menu when the
configurator is accessed. It can also be called up by a soft key pick.
When a cluster is selected, a graphic representation of the selected cluster is presented
on the screen.
File Menu:
This menu alphabetically lists the files in the current directory. The default directory is
/usr/disp.
Executable files and sub-directories are not selectable; all other file types are selectable
and become highlighted when selected.
Sub-directories have a down triangle marker next to them which, when selected,
causes that directory to be the current directory.
The up triangle marker at the bottom of the menu changes the current directory to the
parent of the current directory.
The up and down arrow markers at the bottom of the menu are used to page through
the directory listing.
Informational Fields
Informational fields, where labels are in red and the contents are in yellow, are as follows:
CLUSTER Name of the current cluster.
FILE Name of the coordinated display set file being edited.
LINK Path name which is connected to the currently selected screen icon.
PATH Current directory.
13
B0193AG – Rev B 3. Coordinated Display Configurator
Input Areas
Input areas are as follows:
New Path Allows you to change the directory to any path by keying in the full path
name (e.g., /usr/menus/d1). The full path name always begins with a “/”
indicating the root directory.
The new directory path appears in the Path field, and the new directory list
appears in the file menu.
You can directly display any page within the current directory listing by
keying in a “.” and a letter or letters. For example, keying in “.m” causes
the first directory entry lexicographically greater than “m” to be the first
item in the menu list.
Enter Appears when the Enter Command is selected. You can link a Display
Command Manager built-in command to a screen in a Coordinated Display file. This
input area is also used to enter a path name if you do not wish to use the
file menu selections or if the path is known, but the file does not currently
exist.
File Name Appears when the SAVE soft key is selected. The default string is the cur-
rent file being edited (if one has been selected). Valid entries are as follows:
a. no entry – If there is a default string, the file is saved to the file currently
being edited. If there is no default string, no action takes place.
b. full path name – A path beginning with a “/”; the file is saved to the
full path name.
c. filename – A valid file name without the prefix “/”; the file is saved to
the current directory.
Screen Icons
Screen icons are the graphic objects that appear when a cluster is selected. They appear origi-
nally in a dark grey (inactive/unlinked) color. They represent the physical layout of the cur-
rently selected cluster.
These icons are selectable; a yellow entry box appears. When a “link” is made between a
screen icon and a menu item, the screen portion of the icon changes from a dark to a light
grey color. This indicates that this screen has been configured.
Soft Keys
Soft Keys are as follows:
END Ends the program. A Save dialog box appears if the current set has been
changed. This is always active.
NEW CLUSTER Brings up the original cluster menu, allowing you to edit a new cluster. This
key is always active.
14
3. Coordinated Display Configurator B0193AG – Rev B
EDIT FILE Allows you to edit the currently selected coordinated display set in the file
menu. Only a file in the right format can be edited. This is active only when
a file in the file menu has been selected.
SHOW Allows you to view the currently selected file. If the selected file is a script
FILE file or a text file, a partial window is opened in the upper left of the screen
and the contents of the file are displayed.
Files larger than 17 lines scroll. Scrolling can be halted by holding down the
left mouse button. The display can be cancelled by holding down the left
and right mouse buttons and then releasing them. When the file is com-
plete, click in the file window to restore the main window.
When the file is a display file, a quarter screen overlay is opened in the upper
left quadrant and a scaled down version of the display is presented (minus
text and markers). Click on the overlay to close it. This button is active
when a file has been selected.
ENTER When this soft key is selected, an input area appears with the prompt Enter
COMMAND Command:. This text line is executed when the coordinated display is
called. This allows a coordinated display file to execute any of the Display
Manager built-in functions directly without using other script files. Pressing
RETURN with no text entered cancels the action. This soft key is active
when an unconnected screen is selected.
BREAK LINK Allows you to break the link between the selected screen and its con-
nected file. This screen remains selected but unconnected. This soft
key is active when a connected screen is selected.
MAKE LINK Allows you to create a link between the selected unconnected screen
and the selected file.
SAVE Saves the current coordinated display file. When selected, an input
area appears with the prompt Enter File Name:. If a known file is
being edited, then its path appears as the default. Pressing RETURN
at this point causes the script to be saved to the default name.
Any other file name can be entered either as a full path (begin the file
name with “/”) or as a relative path (the file name does not begin with
“/”). A relative path entry defaults to the current path. Pressing
RETURN with no path in the input area cancels the action.
DELETE FILE Deletes the currently selected file. This action is only valid for display
files or display manager script files.
Soft Keys 15
B0193AG – Rev B 3. Coordinated Display Configurator
16
4. Peripherals in a Multi-Screen
Cluster
Peripherals in multi-screen clusters may be “moved” around the cluster in a number of ways:
♦ You may use the standard multiscreen overlay.
♦ You may use the buttons on the mouse. To jump to the WP configured “to the
right” of the WP currently hosting the mouse, press and hold the left mouse but-
ton, press and release the right mouse button. Reverse the procedure to jump “to
the left.”
♦ The Display Manager command sdjump allows re-assignment to either a specified
WP letterbug, or to a WP “+x” or “-x” positions away in the cluster configuration.
See the Display Manager Calls document for more information. This call can be
accessed through any of the standard paths: display button pick, script file, HIxc-
file, annunciator pick, etc.
Examples of this command are:
sdjump WP0001 Jumps the peripheral to WP0001.
sdjump +1 Jumps the peripheral to the next WP ahead in the configuration.
sdjump -2 Jumps the peripheral to the second WP back in the configuration.
17
B0193AG – Rev B 4. Peripherals in a Multi-Screen Cluster
18
Index
A
Accessing the password environment configurator 3
ackmsg 12
Alarm 8, 12
allmact 11
almhist 12
B
Break link 15
C
Change_Env 7, 10
Cluster 13
Cluster menu 13
Config 13
Coord_Disp_Cfg 13
Coordinated display configurator 13
Create a new environment 4
D
Delete Environment 5
Delete file 15
Deleting an environment 4
Display Manager commands 11
Display-Area protection in environments 10
dmcmd 11
do_lia 12
E
Edit an environment 5
Edit file 15
End 14
Enter command 14, 15
Environment 1
Environment description 6
Environment menu bars 1
Environment name 6
Exit 5
19
B0193AG – Rev B Index
F
File 13, 15
File menu 13
File name 14
H
Help 8, 12
I
Informational fields 13
Input areas 14
Introduction 1
K
Keep 4, 5, 7
L
Link 13
M
Make link 15
mkmact 10, 11
N
New 14
New path 14
P
Password 6
Password environment configurator 10
Password-protection 6
Path 13
Path names 8
Previous 7
Protection class 9
R
rcntalms 12
S
Save 5, 15
20
Index B0193AG – Rev B
Screen icons 14
Security 9
Security schemes 11
Select 5, 8, 12
Select an existing environment to edit 3
setacl 9, 11, 12
Show 15
Soft keys 14
break link 15
cluster 14
delete file 15
edit file 15
end 14
enter command 14, 15
file 13, 15
make link 15
new 14
save 15
show 15
stddisp 12
SYS 7, 8
T
Top-Menu-Bar labels 6
21
B0193AG – Rev B Index