LCLS Controls:  SLC Development Help for SLC-Aware IOC Testing

SCP Panels

Node Name VMS Global Section

Proxy Information

BSAC Testing

      To Calibrate

      To change the DGRP

SCP Panels

Description

Getting There

Send a Custom Message

Index->NETWRK->Micro Diag->Custom Mesage

Restart or Stop

Index->NETWRK
(Select micro than select "IPL MICRO" or "RESET MICRO")

Turn On/Off Async Functions

Index->NETWRK->Micro Diag->LLS Clustr Status

Async Function Displays

Index->NETWRK->Micro Diag->LCLS Clustr Status->Auto Check Disply

PNET Timing Diags (single micro)

Index->Beam Option Contrl->PNET Disply 1 Micr

PNET Timing Diags (all micros)

Index->NETWRK->Micro Diag-nostic->PNET Read AllMic

LCLS BPM Panel

Index->LCLS Index->BSA&C Panel
(Select "LCLS on MCCDEV")

LCLS BGRP Names

Index->LCLS Index->Beam Option Control->BGRP Control Panel | Display BGRP Names

Fetch, Store, and Activate BGRP

Index->LCLS Index->Beam Option Control->BGRP Control Panel | Fetch BGRP Names
(Enter: SLC_DATA:[BGRP_SCRATCH]LCLS.BGRP on MCCDEV)
Store BGRP, Activate BGRP)
(Refer to Help for BGRP Space button on same panel)

Turn Micro Online

Index->NETWRK->BIVSC POLL
(Select micro than select "ONLINE DEL MICRO")

Dev Magnets

Index->User Dev->DEV MAGNET &ANLG->LCLS MGNT Index
(Select micro)

Node Name VMS Global Section

The following instructions allow the user to inspect or change the global section mapping of  nodename to micro.  Additional information in the global section can be modified as well.
 
To inspect:

1. Log onto MCCDEV or MCC
2. On the VMS command line type

 MCCDEV>dump_gs <4-char microname>

For help type:
MCCDEV>dump_gs

The example below will display the global mapping for micro XL02.

MCCDEV> dump_gs  XL02

We are searching microname global section for string: XL02.

Results follow:
Id    Name  SSA  Type   Timeout    Node_ip    Proxy_ip        unused unused
    rawNODE_NAME         NET_TYPE  nsNODE_NAME              nsPROXY_NAME
-----------------------------------------------------------


122   XL02  222  IPDB         0    864F5B19    864F3327       0
    LCLS-IOC03            XXIPXXXX nd= lcls-ioc03           px= px01

The Type field may have several values (e.g. DB for slcnet, IPDB for tcp/ip)

To change:

<>1. Log onto MCCDEV.  If a chane to production is required, please contact Nancy Spencer. DO NOT attempt to do this yourself ! .
2. On the VMS command line type the following to view the mapping of micro XL02.

MCCDEV> mod_gs XL02

The following text will appear. A series of other questions will be asked one of which will be to enter the bitid of the micro, which can be found in the file ref_dbsfile:microname.dat.  The next question to answer is the nodename used for the IP address. For all other questions enter return to accept the default.  This change will remain until the next DBINSTALL. If the change is to be permanent, edit file ref_dbsfile:microname.dat.   This example changes the microname XL02 nodename mapping in the global section to noric02

WARNING!  THIS PROCEDURE CAN SERIOUSLY HARM THE CONTROL SYSTEM.
DO NOT RUN THIS PROCEDURE UNLESS YOU KNOW WHAT YOU ARE DOING.
IF YOU THINK YOU KNOW WHAT YOU ARE DOING, HELP WILL BE OFFERED.

Do you want to continue? [y]/n:
Do you want help? y/[n]:

Do you want to reset a micro? y/[n]:

Enter bitid (integer) whose values you want to change (c/r=>exit):122

These are the global section values currently

*BID  NAME  SSA  TYPE       TMO    NODE_IP     PROXY_IP  COUNTSEMI  MAPPEDFROM
   rawNODE_NAME          NET_TYPE  nsNODE_NAME  nsPROXY_NAME
---------------------------------------------------------------------
122   XL02  222  IPDB         0    864F5B19    864F3327       0
    LCLS-IOC03            XXIPXXXX nd= lcls-ioc03           px= px01


Do you want to restore production values for this micro? y/[n]:n

Enter NAME of micro (4 chars) [XL02]:

Enter SSA (integer, nnn) [ 222]:

Enter micro TYPE (4 chars max eg. IPDB, DB) [IPDB]:

Enter TIMEOUT (integer, nnnnnn) [       0]:

Enter PROXY NAME or NONE: [px01                ]:

Enter NODE NAME or NONE: (used for ip addr) [lcls-ioc03          ]: noric02

Enter NET TYPE: (8 chars max.)[XXIPXXXX]:

These are the computed values (not stored yet):

BID NAME SSA TYPE          TMO   PROXY  NODENAME    NET_TYPE
---------------------------------------------------------------------
122 XL02 222 IPDB            0    px01      NORIC02   XXIPXXXX


Do you want to store in global section? [y]/n:y

These are the global section values currently

*BID  NAME  SSA  TYPE       TMO    NODE_IP     PROXY_IP  COUNTSEMI  MAPPEDFROM
   rawNODE_NAME          NET_TYPE  nsNODE_NAME  nsPROXY_NAME
---------------------------------------------------------------------
122   XL02  222  IPDB         0    864F5634    864F3327       0
    NORIC02               XXIPXXXX nd= noric02              px= px01

V195  Microname global section was changed. Bitid =      122
MCCDEV>

Proxy Information

BSAC Testing

It is necessary for the SCP to have cal tables (either private to that SCP or public for all SCPS) associated with each LCLS BPMD before it allows any type of meas def. Since cal will not be controlled via the SCP for LCLS,  the slc ioc sends dummy cal tables to SCP to fake it out and allow measurements to proceed. Since the SCP uses itself the tables for bpms (looks at the stat bits returned during cal), the slc ioc sends back stat of GOOD in the data reply for bpms for the BPMO_CALB_PREP; all other data is set to "1". GADCs are also calibrated via the BPMO_CALB_PREP, so dummy data is sent for them. Toroids are calibrated via a completely different message, BPMO_TORCAL_PREP?,  which the SCP itself doesn't consult, so dummy tables were not necessary in  response to this message.

 To Calibrate:

 1)  Make sure you have the desired iocs in the LCLS DGRP running. Currently the LCLS DGRP contains XL01-XL05.

      See below to change the DGRP.

 2)  For each ioc, ensure that all of its GADC, DUGADC, BPMP and BPMS units are online;

      or for BPMS, place in MAINTENANCE.

      To do this, go to BPMS DIAG Panel

      Select BPMP, type in XL0x unit return

      Select BPMP HSTA ; type in reason, ie "LCLS testing", OK

      Select BPMS, type in XL0x unit (1) return  

         select MAINTENANCE (was off-line); reason, ie "LCLS testing", OK

      Cycle through all the BPMS belonging to that BPMP, if more than 1:

       Select BPMS, next (return) repeat MAINTENANCE, reason (up arrow repeats previous)

       Cycle through all the BPMPs/associated BPMS for this ioc

       Select GADC, type in XL0x unit (1) return

       Selct GADC HSTA; type in reason (up arrow) return

       Select DUGADC, select ARRY return; enter MICRO XL0x, unit return, etc

       Select ARRY HSTA...

 3)  To initiate cal for all running iocs: 

       Go to LCLS Index | BSAC Panel |:   

        Push LCLS on MCCDEV button to choose BPMD

       Create Meas Def, click on empty button; look at MESSAGES_DEV panel

 4)   To view (this private) calibration on GRAPHICS_DEV : 

        Index | Pep II Index | BPM | BPM Cal | Cal Dsply; Disply Next Page

 5)    To make private cal table public for all SCPs, ACCEPT PUBLIC

         This makes possible future meas defs for all iocs involved in cal proceed without first calibrating (for every new SCP).

        

To remove public file on mccdev, at mccdev prompt, type Delete slcbpm:calb$52.*;*

To remove public file on mcc, at mcc prompt, type Delete slcbpm:calb$51.*;*

                                           

To change the DGRP:

To make XL01 the only micro in the DGRP

MCCDEV> dbedit xl01$dgrp.dbs

DATABASE EDIT

 

MIKE, Why are You doing this?

Data:   LCLS testing

EDIT FILE: USER_DISK_SLC:[MIKE]XL01$DGRP.DBS; (Y/N)? [Y]:

DEFAULTS FILE: REF_:[DBSFILE]DEFAULTS.DBS; (Y/N)? [Y]:

 

    Checking the input file for forbidden database edits!

 

DBEDIT which database (MCCDEV,MCC)? [MCCDEV,MCC]: MCCDEV

 

[snip]

 

To restore the full DGRP

MCCDEV> dbedit xlall$dgrp.dbs

DATABASE EDIT

 

MIKE, Why are You doing this?

Data:   LCLS testing

EDIT FILE: USER_DISK_SLC:[MIKE]XLALL$DGRP.DBS; (Y/N)? [Y]:

DEFAULTS FILE: REF_:[DBSFILE]DEFAULTS.DBS; (Y/N)? [Y]:

 

    Checking the input file for forbidden database edits!

 

DBEDIT which database (MCCDEV,MCC)? [MCCDEV,MCC]: MCCDEV

 

 [snip]

NOTE: The files xl01$dgrp.dbs and xlall$dgrp.dbs exist in your home directory on VMS.

SLC-Aware IOC Home Page | LCLS Controls | EPICS at SLAC | SLAC Computing | SLAC Home

Contact: lcls-slc
Last Modified: Jan 23, 2008