Customer Service Center

This article describes the procedure for creating user accounts, in addition to those supplied as default by Spirent, on VMS Workstations

1. INTRODUCTION
To enable the use of multiple accounts on a VMS system (compatible with the STR2760 and STR4760/4780) the System Manager will have to create the required number of User Accounts.This document outlines the procedure to assist the System Manager in creating a new user account and enabling it to execute the GPS program.

2. OPERATING SYSTEM REQUIREMENTS
This document is designed to refer to VMS versions 6.2 and above, and for use with VAX and Alpha workstations only.

3. PROCEDURE

3.1 Initial Preparations
The System Manager must possess the SYSTEM password for the workstation. This password gives access to all facilities of the Operating System and it knowledge should therefore be kept to a minimum number of personnel. The Workstation must be powered on, and ready to accept LOGIN.

3.2 Account Creation
The System Manager should perform the following steps:

• Login to the SYSTEM account
• Open a DEC Term. This is achieved in the following manner:
      - If system is running Common Desktop Environment (CDE), click on the picture of the workstation on the left-hand side of the toolbar.
      - If system is running DEC Windows, click on the Applications menu, then DEC Term.
• From the DEC Term window execute the following commands, to enter the user account maintenance utility:
      $ SET DEF SYS$SYSTEM
      $ RUN AUTHORIZE
      UAF>

Note: The System Manager should confirm that the GPSSIM account has the required parameters, quotas and privilege in accordance with DGP00116AAA. User accounts may be created or modified using this utility.

• Choose a name and UIC for the new account. For this example the name GPSNEW, and the UIC [200,240] are used. Note: the UIC is in octal format.
• Check the name and UIC are not already specified on the workstation by entering the following commands. If the name or UIC have not been allocated the return "Bad User Specified" will be seen, and the name/UIC are safe to use. If this is not the case a new name or UIC must be chosen.
• If the workstation is configured for two hard disks i.e. a System and Data disk, the user account should be placed on the data disk. In this document both configurations are given, with the Data disk being referred to as DISK$DATA. (It may also be referred to by its device name e.g DKA100: Device name convention is not used for the examples given)
      UAF> SHOW NEWGPS
      UAF> SHOW [200,240]
• Now copy the GPSSIM account structure to the new account. You will need to set a new directory, a new password (in this example the password NICOLA is used) and use the UIC and name that were unused from above, the command is:
      UAF> COPY GPSSIM GPSNEW/UIC=[200,240]/PASS=NICOLA/DIRECT=[GPSNEW]
  Or for systems with accounts residing on a data disk:
      UAF> COPY GPSSIM GPSNEW/UIC=[200,240]/PASS=NICOLA/DEV=DISK$DATA/DIRECT=[GPSNEW]
      UAF> MOD GPSNEW/NOPWDEXPIRED
• The new account record has now been created and the new directory structure needs to be designed. Exit from the user account maintenance facility:
      UAF> EXIT
      $

3.3 Directory Structure Creation
Once the account record has been set up as in section 3.2 a number of directories must be created to ensure correct operation of the GPS software. Enter the following commands from a DEC Term:
    $ CREATE/DIR/OWNER=GPSNEW SYS$SYSDEVICE:[GPSNEW.DATA]
    $ CREATE/DIR/OWNER=GPSNEW SYS$SYSDEVICE:[GPSNEW.SCRATCH]
    $ CREATE/DIR/OWNER=GPSNEW SYS$SYSDEVICE:[GPSNEW.RESULTS]
    $ CREATE/DIR/OWNER=GPSNEW SYS$SYSDEVICE:[GPSNEW.TAPE_TEMP]
    $ CREATE/DIR/OWNER=GPSNEW SYS$SYSDEVICE:[GPSNEW.TEMP_BU]
    $ CREATE/DIR/OWNER=GPSNEW SYS$SYSDEVICE:[GPSNEW.4500_DATA]
    $ CREATE/DIR/OWNER=GPSNEW SYS$SYSDEVICE:[GPSNEW.EVTP_DATA]

For systems which use a data disk, replace the SYS$SYSDEVICE in the command strings above with DISK$DATA, for the second disk. (Again you may have to change DISK$DATA to the name or device specific to your system)

3.4 Copy Login File
To enable the GPS software to function correctly within the new account, a file must be copied from the existing GPSSIM account. This file will set up all of the Logical Names and settings required. It is called USER_LOGIN.COM and is the default file for setting up additional user accounts. It can be copied with the following command, and its name will be changed to LOGIN.COM:
    $ COPY GPS$DEFS:USER_LOGIN.COM SYS$SYSDEVICE:[GPSNEW]LOGIN.COM

For systems utilising a second disk:
    $ COPY GPS$DEFS:USER_LOGIN.COM DISK$DATA:[GPSNEW]LOGIN.COM

3.5 Copy MCAL.DEF File
To enable the phase calibration program to function correctly a calibration defaults file must be copied to the new account home directory:
    $ COPY GPS$DEFS:MCAL.DEF SYS$SYSDEVICE:[GPSNEW]MCAL.DEF

For systems utilising a second disk:
    $ COPY GPS$DEFS:MCAL.DEF DISK$DATA:[GPSNEW]MCAL.DEF

3.6 Test New Account
The new account has now been set up, and prepared for use. LOGOUT from the SYSTEM account, and LOGIN to the new account. The GPS software can now be executed from a DEC Term in the normal way:
    $ GPS

4. OPTIONAL CONFIGURATION

4.1 Setting Up The GPS Icons With Common Desktop Enviroment
There are two icons that can be set up onto the Personal Applications toolbar. This toolbar is raised with the arrow, just above the workstation picture on the left-hand side of the main front panel.These icons can be used to launch the GPS application, and the secondary GPS Single Channel Utility.To configure the Personal Applications toolbar for this, the following procedure should be followed:

• Open the APPLICATION MANAGER window, by clicking on the Application Manager Front Panel Control Icon. (This is the open file drawer icon on the right-hand side of the main front panel)
• Double click on the DESKTOP APPS Icon, to access the Desktop Applications window.
• Double click on the CREATE ACTION icon to access the Create Action window utility.
• Configure the GPS application as below:
      - Enter GPS in the Action Name text entry box.
      - Enter $GPS in the Command when Actioned text entry box.
      - Click the File menu, and Save. This will save the new action in your Home or LOGIN directory.
      - Open the Home directory window. (This is the open file drawer icon on the left-hand side of the main front panel)
      - Use the scroll bar until the new GPS icon is seen.
      - Click on the small arrow above the workstation icon on the main front panel to raise the Personal Applications toolbar. The GPS icon in the home directory window can now be dragged to the INSTALL ICON area of the Personal Applications toolbar
      - The GPS application is now configured to be executed, from the Personal Applications toolbar.
• Configure the GPS Single Channel Utility as below:
      - Close the home directory window. The Application Manager  - Desktop Apps window should still be visible, if not open this as before. Double click on the CREATE ACTION icon to access the utility again.
      - Enter GPS SINGLE CHANNEL UTILITY in the Action Name text box.
      - Enter $RUN GPS$TOOLS:SINGLE_CHAN_$P639.EXE in the Command when Actioned text entry box.
      - Save, as previously described.
      - Open the Home directory window as before and locate the GPS SINGLE CHANNEL UTILITY icon. Open the Personal Applications toolbar, and drag the GPS SINGLE CHANNEL UTILITY onto the INSTALL ICON area.
      - The GPS Single Channel Utility is now configured to be executed from the Personal Applications toolbar.

Either application can now be "run" from the toolbar for convenience.

4.2 Setting Up DEC Windows For A GPS Menu Option
The DEC Windows Session Manager can be configured so that the GPS and GPS Single Channel utility can be options on the Applications menu. The procedure for this is as follows:

• From the session manager menu bar, select Options, then Menus
• With the Applications menu name highlighted, type GPS in the text box above the words DCL Command.
• TAB to the DCL Command text entry box and type @GPS$DEFS:GPSV5_START.COM
• A  small arrow will appear under the Item Name list, which when clicked will transfer the GPS application command (as GPS) to this list.
• A further arrow will appear, next to the item name list, pointing left. Click this to transfer GPS to the Applications list.
• Click Apply and the configuration for GPS is complete.
• To configure the GPS Single Channel Utility, the same process is carried out with the application name being GPS Single Channel Utility, and the DCL command being RUN GPS$TOOLS:SINGLE_CHAN_$P639.EXE

DEC Windows will now show GPS and GPS Single Channel utility on the Applications menu, and the programs can be executed.