How to create a DUCS section

If you are not the DUCS czar its easy, just send a note to the DUCS czar, currently Gary Bower.

If you arethe DUCS czar, then you have problems. Proceed as follows:

Step 1

Decide whether the section needs to exist on both VM and VMS, or just one or the other. Also decide if it needs to be distributed outside of SLAC. If the section needs to exist on VM then you need to decide what minidisk the DEV section will live on. It can

Share a disk with another DEV section, in which case you don't need to do anything special, or
Live on its own minidisk, in which case you will need to create the new minidisk and configure it for DUCS. To do this you need to:
1. Ask the VM minidisk czar (currently Karen) to create a new SLD minidisk. She will tell you its password and address (something like SLD 123).
2. Format the minidisk using the commands:
```
          LINK SLD <vaddr> <vaddr> Z <password>
          FORMAT <vaddr> Z 
```
  Where <vaddr> and <password> are the address and password you got from the minidisk czar. After the second command you will be asked to provide a suitable label for the minidisk. Choose some meaningful label (maximum six characters).
3. Add an appropriate entry to the GIMEGRP NAMES file,defining a suitable nickname for the disk (maximumu eight characters). A typical entry would be: :nick.mcdev :userid.SLD :addr.241 :name.MC generator development disk :czar.Tony Johnson Install the GIMEGRP NAMES file back onto the G disk using the command:
```
          INSTALL PUBSLD REP GIMEGRP NAMES
```
4. Configure the minidisk using the DUCSACC EXEC on the TONYJ 191 disk. Use the command:
```
          DUCSACC <nickname> SLDSERVE <password>
```

Step 2

Add the new entries to the DUCSNAME DEFINE file, in section UDUC. Note that there is only one version of this file, for both VM and VMS, and that it always lives in PROD. You need to:

Change the comment
Add an entry for the new section to the list of sections near the top of the file.
Add an entry for PROD and DEV sections on both VAX and VM (if appropriate). Model your neew entries on the copious examples already in the file. Note that for the DEV VM entry you must use the nickname of the (new) disk as the entry.

Now install the command back into PROD using the TODUCS command.

Step 3

Create the directories on VMS and VM (as appropriate). To do this log on to SLACVX and issue these commands:

         TODUCS DISK$SLD_USR0:[TONYJ.UDUC.MAINTAINANCE]MAKEDIR.DUCSCOM 
         TODUCS DISK$SLD_USR0:[TONYJ.UDUC.MAINTAINANCE]USETUP.DUCSEXEC

Step 4

If the section is not to go to all nodes (the default), then log on to the SLDTEST machine on SLACVM and edit the SITE DATABASE file. The format is (hopefully) transparent.

Step 5

Don't forget to authorize at least one person as a STAFF member for this section.