NEC Student Services Installation Guide

							NDA-30073   Revision 1Page 7
Student Services - Installation Guide SOFTWARE INSTALLATION
UNIX Subsystem 
Database UpdateThe SCO UNIX Subsystem database must be updated for Student Services. The 
databases are updated to accept the new Student Services Station Controller 
information.
At the UNIX prompt, login as the superuser (root) and execute the SCO UNIX 
Subsystem Database authorization checking program (/tcb/bin/authck -s) and 
password deletion program (passwd -d) as shown below.
- Answer yes when asked to fix the subsystem databases. This ensures that the 
SCO UNIX Subsystem Databases are left in a proper state. Deleting the 
password for the stactrl  login name causes the system to ask for new 
passwords when first logging on using these names.
This completes the software installation. Continue to Chapter 3 of this guide for 
software configuration.
\_WY^*
b__d@Qccg_bT* ,b__d `Qccg_bT.
 dSRRY^QedXS[ c
DXU V_\\_gY^W ecUbc XQfU @b_dUSdUT @Qccg_bT 4QdQRQcU U^dbYU
cdXQd T_ ^_d ]QdSX dXUYb CeRcicdU] 4QdQRQcU U^dbYUc*
cdQSdb\
DXUbU QbU Ubb_bc Y^ dXU TQdQRQcU
VYh dXU] i^/ I ,5>D5B.
 `QccgT T cdQSdb\
4U\UdY^W `Qccg_bT V_b ecUb cdQSdb\ 
						

							Page 8NDA-30073   Revision 1
SOFTWARE INSTALLATION Student Services - Installation Guide
EXCEPTIONS to Software Installation
This section describes the Exceptions to the Student Services software Install 
Procedure. An Exception is an alternate screen display that may be encountered 
during the installation process. An Exception may indicate an incorrect entry, an 
alternate selection choice, or a problem with the installation.
Exception 1:
During the application validation pro-
cess, if Student Services installation 
files are found to be inconsistent and/or 
corrupted, the error is displayed. This 
error indicates a serious problem with 
the Student Services installation files. 
Answer ‘x’ (exit) at the prompt to exit 
the installation and contact your NEC 
representative for assistance in correct-
ing this problem.
Exception 2:
A new installation was selected when 
Student Services is already installed on 
the UAP.
To continue will overwrite the existing 
database for the current installed Stu-
dent Services. If this is desired, type y 
(yes) at the prompt.
If this is an upgrade, type n (no) and re-
select Upgrade.
?19 @\QdV_b] Yc Qd bUfYcY_^ % V_b ]QSXY^U Y#(& =Qi !# !)) BU\ $
cdQSdb\ BUfYcY_^* % ]QSXY^U di`U* Y#(& FUbcY_^* !
@b_SUccY^W `\UQcU gQYd
FQ\YTQdY^W Y^cdQ\\UT VY\Uc

SXUS[ce] XQc VQY\UT di`U S d_ S_^dY^eU h d_ UhYd* 9^S_]`\UdU Y^cdQ\\QdY_^ _V c_VdgQbU  FQ\YTQdY_^ Ubb_b ?19 Y^cdQ\\QdY_^ VQY\UT 
KEM`WbQTU
>53 1]UbYSQ 9^S CdeTU^d CUbfYSUc =_^  :e^ # 
K9M^cdQ\\
K3MQ^SU\ 9^cdQ\\QdY_^
5^dUb ?`dY_^ Y
CdeTU^d CUbfYSUc Yc Q\bUQTi Y^cdQ\\UT 9^cdQ\\Y^W gY\\ _fUbgbYdU Q^i SebbU^d
TQdQRQcU U^dbYUc ?\T VY\Uc gY\\ RU ]_fUT d_ Q RQS[e` TYbUSd_bi
1bU i_e cebU i_e gQ^d d_ Y^cdQ\\/ i^ 
						

							NDA-30073   Revision 1Page 9
Student Services - Installation Guide APPLICATION CONFIGURATION
Chapter 3 APPLICATION CONFIGURATION
This chapter describes specific field entries that must be made or verified to 
properly configure Student Services for operation. In addition to this chapter, use 
instructions found in the following manuals:
Applications Manager (APM) Installation Manual - Contains step-by-step 
instructions for installing the software from the release media.
Applications Manager (APM) Operations Manual - Explains how 
applications like SPA are configured in the APM environment and how the SPA 
database is created, using the entries and values provided in this chapter.
NEAX2400 System Manuals - Give very detailed explanations about the 
assignments that need to be made through the Maintenance Administration 
Terminal (MAT) commands on the NEAX2400.
Overall Configuration Requirements
As described in Chapter 1, Student Services consists of a user interface and three 
OAI application components that performs the Student Services functions. The 
OAI applications must be configured in the OAI environment using the 
Applications Manager (APM). The configuration settings for each of these four 
application components are described in this chapter.
Note:
BEFORE beginning this configuration, the software must be loaded onto the UAP 
as described in Chapter 2 of this guide. Ensure the software installation proce-
dure in Chapter 2 has been successfully completed.
Step :
Proceed through each section, following the Step indicators (shown at 
left) and instructions to configure each application component for Stu-
dent Services. 
						

							Page 10NDA-30073   Revision 1
APPLICATION CONFIGURATION Student Services - Installation Guide
Configuration for Administrator
The Administrator component of Student Services is the primary user interface. 
Two functions of the Administrator (Screen Saver and Report Printing) must be 
configured. These configurations are described in this section.
Screen SaverStudent Services incorporates a display screen saver function. This screen saver 
will blank the display after a predetermined period of time and optionally provide 
for messages and multiple logos to be displayed when the saver is active.
The screen saver is controlled through a configuration file located in the “/oai/app/
staCtrl/cfg” directory. The file logos.cfg contains the configuration variables and 
definitions for the screen saver. A basic template file is created during initial 
installation, but some unique definitions must be configured.
Screen Saver Key Variables & Definitions
The following are the key variables and definitions of the logos.cfg file for the 
screen saver:
SAVER_DELAYx
where x is the number of seconds the terminal must be idle before the screen 
saver is activated.
REFRESH_DELAYx
where x is the number of seconds a screen saver logo is displayed before it is 
refreshed.
LOGOS_COUNTx
where x is the number of logo definitions in this file.
ALL_LOGOSx
where x is the number which indicates the screen saver should cycle through all 
logos (x must be greater than LOGOS_COUNT).
WHICH_LOGOx
where x is the number of the logo to be displayed (number between 1 and the 
value of LOGOS_COUNT or ALL_LOGOS).
Example Settings
:
INTCONST SAVER_DELAY 300
INTCONST REFRESH_DELAY 3
INTCONST LOGOS_COUNT 3
INTCONST ALL_LOGS 4
INTCONST WHICH_LOGO ALL_LOGOS 
						

							NDA-30073   Revision 1Page 11
Student Services - Installation Guide APPLICATION CONFIGURATION
Configuration for Administrator (Cont)
Screen Saver Logo Definitions
Each logo definition contains logo color attributes and the logo text. These are 
defined by the following settings:
LOGO_x_CLR“FB_FGcolor_BGcolor”
where x is the number of the logo to be displayed (number between 1 and the 
value of LOGOS_COUNT) and FGcolor is foreground color and BGcolor is 
background color from one of the following:
BLACK WHITE BLUE GREEN YELLOW CYAN MAGENTA RED
LOGO_x_TXT
where x is the number of the logo to be displayed (number between 1 and the 
value of LOGOS_COUNT).
The example below shows a typically logo definition:
Step 1:
From the APM Main Menu, select U (UNIX). Locate the logos.cfg file 
and make changes as needed to this file to configure the screen saver for 
Student Services.
3
						

							Page 12NDA-30073   Revision 1
APPLICATION CONFIGURATION Student Services - Installation Guide
Configuration for Administrator (Cont)
Report PrintingThe Student Services Administrator uses a configuration file located in the “/oai/
app/staCtrl/cfg” directory for report printing. The reports.cfg file contains the key 
configuration variables and definitions for hardcopy reports. Report printing from 
Student Services uses the available UNIX print device, configured for the site 
UAP.
Report Printing Key Variables & Definitions
Key variables control the report printing and may be modified as needed. 
• STNS_LINESx
Variable specifies the number of lines per page for the printout where x is the 
number of lines per page.
Example:
INTCONST STNS_LINES 60
 STRCONST PRINT_CMD
“command”
Specifies the UNIX print command used by the Administrator where command 
is the UNIX print command for the site UAP configuration.
Example:
STRCONST PRINT_CMD
“lpr -c”
 STRCONST CMD_OUT
“> /dev/null 2>&1”
Variable specifies the destination for UNIX print command output where
“> /dev/null 2>&1” is the default value to route standard output and error output 
to a null device.
Example:
STRCONST CMD_OUT
“> /dev/null 2>&1” 
						

							NDA-30073   Revision 1Page 13
Student Services - Installation Guide APPLICATION CONFIGURATION
Configuration for StationControl
This section describes the configuration for the StationControl component of 
Student Services. The StationControl component is an OAI application that 
operates under control of the APM. The following sections describe the 
configuration and database requirements for the StationControl component.
Primary 
ParametersThis section contains the information that you should enter into the configuration 
file for StationControl. For specific instructions on what these parameters mean 
and how to make these entries, refer to the APM Operations Manual.
Step 3:
On the APM Configuration Entry screen, verify installation (or make 
an entry if needed) for each StationControl parameter shown in the table. 
If the parameter is followed by an asterisks (*) in the table, you must 
make the entry exactly as shown.
Note:These parameters are done automatically during installation if you answer 
YES 
to the autoconfig prompt. 
Parameter Default Entry Description
Application Name StationControl Specifies the name to be displayed in 
the APM menus. This name is 
displayed however it is entered here 
(i.e., capital letters, lower case, etc.)
Executable Filename* /oai/app/staCtrl/bin/controller Indicates the path and name of the 
executable file.
Group* STUDENT_SERVICE Indicates the group to which 
StationControl is associated.
Response Mode* I Indicates the action that the APM is to 
take with StationControl should a 
member of the group terminate, such as 
I(gnore).
Initialization Batch N Indicates whether or not (Yes or No) 
StationControl is to be initialized 
automatically when the OAI system is 
initialized.
Termination Mode*  M Indicates how the APM is to notify 
StationControl to terminate (e.g., 
message).
Standard Output /dev/null Designates the file into which 
StationControl output is redirected.
Number of Restarts 0 Indicates how many times the APM 
may restart StationControl after it 
terminates erroneously. 
						

							Page 14NDA-30073   Revision 1
APPLICATION CONFIGURATION Student Services - Installation Guide
Configuration for StationControl (Cont)
APM DatabasesThe StationControl component of Student Services uses multiple databases 
administered both by the APM and by the Student Services Administrator. 
Databases administered by the Student Services Administrator are configured at 
software installation and require no additional user configuration. The following 
database administered by the APM may require configuration.
Tenant Number Database
The Tenant Database is an APM database used by the StationControl application 
and other OAI applications. It provides a mechanism for retrieving the tenant 
number of an extension. Since the Tenant Database may be used by other OAI 
applications installed under the APM, it is configured using the APM and can not 
be modified by the Student Services Administrator program.
Define Master Database file name is tenant_m
The following table defines the Tenant Number master database fields:
Specify Application Database file name is tenants
The following table defines the Tenant Number application database:
The Tenant Number field contains the Tenant Number that is used by one or more 
extensions. Tenant Numbers are associated with extensions using the following 
methods:
-  A Tenant Number may be associated with a set of extensions defined by the 
First and Last Extension fields. The First Extension field contains the 
smallest extension number in the set, and the Last Extension field contains 
the largest extension number in the set.
-  A Tenant Number may be associated with a single extension by setting the 
First and Last Extension fields to the same extension value.
-  A Tenant Number may be associated with a single extension that contains a 
non-numeric character such as ’*’ or ’#’. The First Extension field contains 
the extension value, and the Last Extension field is left blank.Field Description Type Size Minimum 
Va l u eMaximum 
Va l u e
First Extension ASCII 10
Last Extension ASCII 10
Tenant Number Numeric 3 1 255
Field Description Data Type
First Extension ASCII
Last Extension ASCII
Tenant Number Short Integer