The command line interface consists of a set of Unix-like commands and is based on the KUIP package[bib-KUIP]. The command line interface is activated by typing FM at the command level ($ prompt on VMS, VM READ on VM etc). For instance, to obtain a directory listing of //cern/electra/rawdata/p1b90/run1 enter the command:
FM
FM> ls //cern/electra/rawdata/p1b90/run1
------------------------------------
+-------------------------------------------------------------------------------------------------+
| ALLOCATE POOL LIBRARY GNAME DSN FFORM CPLEV HOSTN [COMM] [RECFM] [LRECL] [BLOCK] [FSIZE] [MEDIA] |
+-------------------------------------------------------------------------------------------------+
Use the ALLOCATE comand to add a new tape file to the FATMEN catalogue. A tape is allocated from the specified pool. The file sequence number is always set to 1.
+-------------------------------------------------------------------------------------------------+
| ADD/DISK GNAME DSN FFORM CPLEV HOSTN [COMM] [RECFM] [LRECL] [BLOCK] [FSIZE] [LOCCOD] [USERWORDS] |
+-------------------------------------------------------------------------------------------------+
Use the ADD/DISK command to add a new disk file to the FATMEN catalogue
+-------------------------------------------------------------------------------------------------+
| ADD/TAPE VSN VID FSEQ GNAME DSN FFORM CPLEV HOSTN [COMM] [RECFM] [LRECL] [BLOCK] [FSIZE] [MEDIA] |
+-------------------------------------------------------------------------------------------------+
Use the ADD/TAPE command to add a new tape file to the FATMEN catalogue
+------------------+
| CD [PATH] [CHOPT] |
+------------------+
Use the CD command to change the current default directory. Some examples of the CD command are given below:
[ zfatal] > fm
FATMEN.KUMAC not found
Type INIT to initialise FATMEN> init cndiv
FMINIT. Initialisation of FATMEN package
FATMEN 1.38 910218 15:00 CERN PROGRAM LIBRARY FATMEN=Q123
This version created on 910218 at 1514
Current Working Directory = //CERN/CNDIV
FM> cd jamie/dsts
Current Working Directory = //CERN/CNDIV/JAMIE/DSTS
FM> cd ..
Current Working Directory = //CERN/CNDIV/JAMIE
FM> cd $HOME
Current Working Directory = //CERN/CNDIV
FM> cd jamie/dsts
Current Working Directory = //CERN/CNDIV/JAMIE/DSTS
FM> cd \
Current Working Directory = //CERN/CNDIV/JAMIE
FM>
+------+
| CLR |
+------+
Use the CLR command to clear the screen
+--------------------------------------------------------------+
| CP FROM TO [KSN] [LOCCOD DATREP MEDTYP VSN VID FSEQ DSN HOST |
+--------------------------------------------------------------+
Use the CP command to copy a file. Note that this command makes a copy of the catalogue entry. It does not initiate a physical file copy.
+---------------------------------------------------------------------------+
| COPY GNAME [KS1] [KS2] [POOL] [LIBRARY] [VID] [FSEQ] [NODE] [FILE] [CHOPT] |
+---------------------------------------------------------------------------+
Use the COPY command to copy the data referenced by a generic name. A dataset may be copied by specifying existing catalogue entries (KS1 and KS2), a target VID, a TMS pool and library from which the output tape should be allocated, or a remote node and file name.
An example of a copy request where the copy should be performed using CHEOPS is shown below.
Requesting a copy via CHEOPS
set/source cern set/dest helsinki copy gname=//CERN/CNDIV/JAMIE/TEST node=HEL1 transport=CHEOPS vid=QQ1234
+----------------------------+
| DIR [PATH] [OUTPUT] [CHOPT] |
+----------------------------+
Use the DIR command to issue a call to RZLDIR for the specified path. This command is normally used for debug purposes only.
+--------------------------------------------------+
| DUMP GENAM [KSN] [BYTES] [BLOCKS] [FILES] [CODE] |
+--------------------------------------------------+
The DUMP command requests a TAPEDUMP of the VID corresponding to the specified generic name.
+------+
| END |
+------+
The END command closes the current FATMEN catalogue. After this command has been issued, the INIT command may be re-issued to look at a different FATMEN catalogue.
[zfatal] (543) fm
FATMEN.KUMAC not found
Type INIT to initialise FATMEN> init l3
FMINIT. Initialisation of FATMEN package
FATMEN 1.51/07 910924 11:00 CERN PROGRAM LIBRARY FATMEN=Q123
This version created on 910924 at 1114
Current Working Directory = //CERN/L3
FM> fc */*
Total of 10926 matches ( 10926 files) in 43 directories
FM> end
FMEND. Terminating FATMEN package
FM> init opal
FMINIT. Initialisation of FATMEN package
FATMEN 1.51/07 910924 11:00 CERN PROGRAM LIBRARY FATMEN=Q123
This version created on 910924 at 1114
Current Working Directory = //CERN/OPAL
+--------+
| EXIT |
+--------+
Use the EXIT command to leave the FATMEN shell. Any outstanding catalogue updates will be sent to the server. See also the description of the QUIT command.
+------------------------------+
| EXTRACT GNAME OUTPUT [CHOPT] |
+------------------------------+
Use the EXTRACT command to extract all or part of a FATMEN catalogue. The select subset will be stored in the file specified in a format suitable for processing by the standard FATMEN catalogue server. (i.e. FZ exchange format, alpha mapping). Only entries that match the current key selection, as defined by the commands SETLOCATION, SETMEDIATYPE and SETCOPYLEVEL will be processed.
+----------------------------+
| FC [GNAME] [OUTPUT] [CHOPT] |
+----------------------------+
Use the FC comand to count the number of files in a directory. FC will also count the number of files which match the specified pattern
Examples of using the FC command
FM> init delphi
FMINIT. Initialisation of FATMEN package
FATMEN 1.64/07 920520 16:45 CERN PROGRAM LIBRARY FATMEN=Q123
This version created on 920520 at 1645
Current Working Directory = //CERN/DELPHI
FM> fc */*
Total of 95141 matches ( 95141 files) in 394 directories
FM> ...
FM> cd $HOME
Current Working Directory = //FNAL/D0
FM> fc clmc/*/*
Total of 41 matches ( 41 files) in 22 directories
FM> fc */*
Total of 2333 matches ( 2333 files) in 41 directories
FM>
+------------------+
| FIND GNAME LOGNAM |
+------------------+
Use the FIND command to FIND the specified file and associate it with the specified logical unit. If required, the file is first staged to disk (See on Page [more info] for the description of the format of the logical unit parameter).
+--------+
| GIME |
+--------+
Use the GIME command to reaccess the disk of the service machine which maintains the FATMEN catalogue. This command has no parameters.
+------------+
| INIT GROUP |
+------------+
If the file system name is not //CERN, this should also be given.
Examples of file system names
INIT //FNAL/D0 INIT //DESY/H1 INIT //CERN/DELPHI or INIT DELPHI
FATMEN automatically looks for and executes the files FATSYS.KUMAC, FATGRP.KUMAC, FATUSER.KUMAC and FATLOGON.KUMAC
The search will be made as follows:
Defining the search path on VAX/VMS systems
$! $! Look for macros in current directory, default directory and $! public fatmen directory $! $ define fatpath sys$disk:[],sys$login,disk$fatmen:[public]
Defining a search path on Unix systems
export FATPATH=.:~:/fatmen/public echo $FATPATH .:/u/cp/jamie:/fatmen/public
Defining a search order on VM/CMS systems
setenv FATPATH a,d,g,q,p,s
For a transition period, the following scheme will also be supported for backword compatibility purposes.
If a file FATMEN.KUMAC (fatmen.kumac on Unix systems) is found in the current directory, it will be automatically executed. On VM/CMS systems, this file must reside on the disk accessed at mode A or G, or an extension of one of these disks. (e.g. in HEPVM batch, your 191 disk is accessed as a read-only extension of the 191 disk of the batch worker in which the job is executing, i.e. B/A)
+------------------------------------+
| LD [PATH] [OUTPUT] [NLEVEL] [CHOPT] |
+------------------------------------+
Use the LD command to display the contents of a directory The output of the command may be redirected to a file, e.g.
ld * output=subdirs.lis
Example of LD command
[zfatal] (796) fm
FATMEN.KUMAC not found
Type INIT to initialise FATMEN> init delphi
FMINIT. Initialisation of FATMEN package
FATMEN 1.51/04 910918 17:00 CERN PROGRAM LIBRARY FATMEN=Q123
This version created on 910918 at 1649
Current Working Directory = //CERN/DELPHI
FM> ld -w
List of subdirectories...
Directory: //CERN/DELPHI
P01_ALLD P01_UNKN P01_TECH P01_COSM MEOLA
Total of 5 subdirectories of which 5 match
FM>
+--------------------------+
| LOCK GENAM [KSN] [CHOPT] |
+--------------------------+
Use the LOCK command to disable WRITE access to the tape on which the file specified resides. If a negative key serial number is given, all entries matching the specified generic name will be locked.
+------------------+
| LOGLEVEL [LEVEL] |
+------------------+
Use the LOGLEVEL command to set the FATMEN loglevel.
+-----------------------------------------------------------------------------------------------+
| LN CHSRCE CHTRGT [CHCOMM] [IW1] [IW2] [IW3] [IW4] [IW5] [IW6] [IW7] [IW8] [IW9] [IW10] [CHOPT] |
+-----------------------------------------------------------------------------------------------+
Use the LN command to make a link to an existing catalogue entry. If the existing entry is itself a link, the link will point to the target of that link.
+------------------------------------------+
| LS [GNAME] [KSN] [OUTPUT] [NAMES] [CHOPT] |
+------------------------------------------+
Use the LS command to display the contents of a directory or display information on a given file within the current or specified directory.
If the generic name begins with a $ then it is assumed to be an environmental variable and is translated using the CERNLIB routine GETENVF.
If the generic name begins with a % then it is assumed to be a nick name defined in a names file. If no names file is specified then a default names file is used. This names file resides in the same directory or on the same minidisk as the current FATMEN catalogue and is named FMgroup.NAMES. e.g. for the group L3 the name would be fml3.names. Note that the filename specified may include wildcards, such as ls t*, to list all files starting with the letter t or ls %%% to list all files with three character filenames. The syntax (mm:nn) may be used in the filename to specify ranges, such as P(3:45). See on page [more info] for more details.
If the filename begins with a %, then the file name is first expanded using the FMNICK routine.
If the filename begins with a $, then it is treated as an environmental variable and translated using GETENVF.
Examples of using the LS command
FM> ls -w Directory ://FNAL/CDF/FATMEN/8MM R19570AB R19570AC R19573AB R19573AC R19573AD R19573AE R19573AF R19573AG R19573AH R19573AI R19575AB R19575AC R19575AD R19575AE R19575AF R19575AG R19575AH R19575AI R19576AB R19576AC R19576AD R19579AA R19579AB R19579AC R19579AD R19579AE R19580AA R19580AB R19581AA R19581AC R19581AD R19581AE R19581AF R19581AG R19581AH R19581AI R19581AK R19581AM R19581AO R19581AP R19583AA R19583AB R19583AC R19587AB R19587AC R19599AA R19599AB R19599AC R19599AD R19602AA R19602AB R19603AA R19604AA R19604AB R19604AC R19604AD R19604AE R19604AF R19604AG R19604AH R19604AI R19604AJ R19604AK R19604AL R19604AM R19604AN R19604AO R19604AP R19604AQ R19604AR R19604AU R19604AZ R19614AD R19570AA Total of 74 files in 1 directories FM> ls r19(570:575)* -iw Directory ://FNAL/CDF/FATMEN/8MM R19570AA R19570AB R19570AC R19573AB R19573AC R19573AD R19573AE R19573AF R19573AG R19573AH R19573AI R19575AB R19575AC R19575AD R19575AE R19575AF R19575AG R19575AH R19575AI Total of 19 files in 1 directories FM> ls r19(570:575)ae -kmop Directory: //FNAL/CDF/FATMEN/8MM Generic filename: R19573AE Copy level: 0 Media type: 4 Location code: 1 File serial number: 8 VSN: CC2010 VID: CC2010 FSEQ: 7 Created by: CDF_FATM ACCT: E741CD_C on node: FNALE by job: CDF_FATM RECFM: F LRECL: 2048 BLKSIZE: 43200 Filesize: 2000 Use count: 0 Generic filename: R19575AE Copy level: 0 Media type: 4 Location code: 1 File serial number: 16 VSN: CC2010 VID: CC2010 FSEQ: 15 Created by: CDF_FATM ACCT: E741CD_C on node: FNALE by job: CDF_FATM RECFM: F LRECL: 2048 BLKSIZE: 43200 Filesize: 2000 Use count: 0 Files: 2 Total of 2 files in 1 directories FM>
+------------------+
| MAKE GNAME LOGNAM |
+------------------+
The MAKE command is similar to the FIND command, except that it is for write access.
+--------------------------------------------------------+
| MEDIA MEDIA [TYPE] [MODEL] [SIZE] [DENS] [MNTP] [LABEL] |
+--------------------------------------------------------+
Use the MEDIA command to set or list attributes of a given type of media.
Example of using the MEDIA command
MEDIA 2 3480 CT1 200 38K M SL would set the attributes of FATMEN media type 2 to model: 3480 generic device type: CT1 (used on STAGE/SETUP requests) capacity: 200 MB (maximum size on STAGE command) density: 38K mount type: M label : SL MEDIA with no arguments lists the current settings MEDIA 3 lists the settings for media type 3
+------------+
| MKDIR PATH |
+------------+
Use the MKDIR command to create a directory or directory tree.
+--------------------------------------------------------------------------------------------+
| MODIFY GNAME [KSN] [LOCCOD] [DATREP] [MEDTYP] [FFORM] [RECFM] [RECL] [BLOCK] [FSIZE] [COMM] |
+--------------------------------------------------------------------------------------------+
+--------------------------------------------------------------+
| MV FROM TO [KSN] [LOCCOD DATREP MEDTYP VSN VID FSEQ DSN HOST |
+--------------------------------------------------------------+
Use the MV command to ``move'' or rename a file.
+----------------------------+
| NICK NICKNAME CHFILE CHOPT |
+----------------------------+
Use the NICK command to display the generic name and description corresponding to the specified nickname. See the description of the FMNICK routine for further information.
+------+
| PWD |
+------+
Use the PWD command to print the current (working) directory.
+--------+
| QUIT |
+--------+
Use the QUIT command to leave the FATMEN shell. Any outstanding catalogue updates will be purged. See also the description of the EXIT command.
+----------------------------------------------------------------+
| RM GNAME [KSN] [DSN] [HOST] [VID] [USER] [POOL] [PROT] [CHOPT] |
+----------------------------------------------------------------+
Use the RM command to remove a file from the catalogue. When multiple entries of the same generic name exist, the key serial number, as displayed by LS using the K option, should be specified. Alternatively, one can select which entry should be removed by specifying the DSN, HOST, VID and/or USER. Any of these fields may contain wild-cards.
Example of using the RM command
rm run123 -a vid=i* | Remove all entries for run123 for which
| the VID begins with an I.
Example of freeing a tape volume
rm //cern/l3/prod/data/pdreqq/cc00ws46 90 ! ! ! ! xvprod ! fugp
The following example shows how an entry may be removed from the catalogue, and the corresponding tape freed at the TMS level. In this example, the tape volume associated with the specified catalogue entry is write enabled (option U), freed (option F). Option G specifies that the protection group for the volume is to be set. By default, the protection group has the same name as the TMS pool into which the volume is returned. Option P allows suitably privileged users to free any tapes within their group.
The command is repeated twice: the first form is currently required if issued from a KUMAC file as named parameters are not currently supported in macros. The second form may be used if the command is entered interactively.
Removing a catalogue entry and freeing a tape volume
RM //CERN/L3/PROD/DATA/PDREQQ/CC00WS46 90 ! ! ! ! XVPROD ! FUGP RM //CERN/L3/PROD/DATA/PDREQQ/CC00WS46 ksn=90 pool=XVPROD -FUGP
+------------+
| RMDIR PATH |
+------------+
Use the RMDIR command to remove an empty directory from the catalogue.
+------------+
| RMTREE PATH |
+------------+
Use the RMTREE command to remove a complete directory tree from the catalogue. If any files are found in the directory tree, the command will be refused.
+------------------------------------+
| RMLN CHLINK [LUN] [CHFILE] [CHOPT] |
+------------------------------------+
+-----------------------------------------------------------------------------------------------------------------------------+
| SEARCH GNAME [DSN] [HOST] [VID] [USER] [OUTPUT] [NMATCH] [CREATED] [CATALOGED] [ACCESSED] [UFORM] [COMMENT] [OUTPUT] [CHOPT] |
+-----------------------------------------------------------------------------------------------------------------------------+
Use the search command to print the generic names of files which match the specified criteria. Character fields may include the * or % wild cards. e.g. SEARCH * VID=I* # search current working directory for entries # with VID's beginning with I.
Options are passed to FMSHOW. If NMATCH is non-zero, SEARCH will stop after NMATCH matches have been found.
Set the loglevel to <0 to stop the printing of the names of files and directories searched.
Date and time ranges may be given, as in the following example: which searches for files in the current directory that have been accessed between 31st January, 1991 and midday on 30th June 1991
To make selections on the user words, use the SETUSERWORDS command. This allows you to set values or ranges for each of the 10 user words. Once these values have been set, SEARCH will only display entries where the userwords match these values or ranges. Currently, only 0 or positive integers are accepted as values.
SEARCH * accessed=910131-910630.1200
The format of the date and time fields is fromdate-and-time-todate-and-time.
Dates and times are specified as YYMMDD.HHMM.
Examples of valid date and time ranges
910125.1230-910227.1630 # Explicit range 910125-910227 # Time fields default to 0000 910125- # To date and time default to NOW -910125 # From date and time default to 000000.0000 ACCESSED=-910125 # gives files accessed prior to 910125 ACCESSED=910125 # gives files accessed on or after 910125 ACCESSED=910125-910127 # gives files accessed on 910125 or 910126.
An example of a search command is given below. This example looks file files KS09, KS10, KS11 in all subdirectories matching 88%/MIN* for files where the host name is CERNVM, the VID starts with KR and the username is HAG. The output is sent to the screen and the LS options M (media details), G (generic name) and O (owner details) are used.
Example of SEARCH command
FM > sea 88%/min*/ks(09:11) host=cernvm vid=kr* user=hag -mgo output=tty Searching directory //CERN/NA31/883/MIN8 //CERN/NA31/883/MIN8/KS09 VSN: KR5822 VID: KR5822 FSEQ: 1 Created by: HAG ACCT: HAG$VH on node: CERNVM by job: HAG //CERN/NA31/883/MIN8/KS10 VSN: KR5823 VID: KR5823 FSEQ: 1 Created by: HAG ACCT: HAG$VH on node: CERNVM by job: HAG //CERN/NA31/883/MIN8/KS11 VSN: KR5832 VID: KR5832 FSEQ: 1 Created by: HAG ACCT: HAG$VH on node: CERNVM by job: HAG Searching directory //CERN/NA31/885/MIN8 Searching directory //CERN/NA31/886/MIN8 //CERN/NA31/886/MIN8/KS09 VSN: KR5847 VID: KR5847 FSEQ: 1 Created by: HAG ACCT: HAG$VH on node: CERNVM by job: HAG //CERN/NA31/886/MIN8/KS10 VSN: KR5849 VID: KR5849 FSEQ: 1 Created by: HAG ACCT: HAG$VH on node: CERNVM by job: HAG //CERN/NA31/886/MIN8/KS11 VSN: KR5851 VID: KR5851 FSEQ: 1 Created by: HAG ACCT: HAG$VH on node: CERNVM by job: HAG Matches: 6 FM>
+------------------------------------------------------------------------------------------------------------------------------- --------------+
| SCAN GNAME [NLEVELS] [DSN] [HOST] [VID] [USER] [OUTPUT] [NMATCH] [CREATED] [CATALOGED] [ACCESSED] [UFORM] [COMMENT] [OUTPUT] [S RING] [CHOPT] |
+----------------------------------------------------------------------------------------------------------------------------------------------+
Use the scan command to print the generic names of files which match the specified criteria. Character fields may include the * or % wild cards. e.g. SEARCH * VID=I* # search current working directory for entries # with VID's beginning with I.
Options are passed to FMSHOW.
If NMATCH is non-zero, SCAN will stop after NMATCH matches have been found.
Set the loglevel to <0 to stop the printing of the names of files and directories searched.
Date and time ranges may be given, as in the following example: which searches for files in the current directory that have been accessed between 31st January, 1991 and midday on 30th June 1991
To make selections on the user words, use the SETUSERWORDS command. This allows you to set values or ranges for each of the 10 user words. Once these values have been set, SEARCH will only display entries where the userwords match these values or ranges. Currently, only 0 or positive integers are accepted as values.
SCAN * accessed=910131-910630.1200
The format of the date and time fields is fromdate-and-time-todate-and-time.
Dates and times are specified as YYMMDD.HHMM.
Examples of valid date and time ranges
910125.1230-910227.1630 # Explicit range 910125-910227 # Time fields default to 0000 910125- # To date and time default to NOW -910125 # From date and time default to 000000.0000 ACCESSED=-910125 # gives files accessed prior to 910125 ACCESSED=910125 # gives files accessed on or after 910125 ACCESSED=910125-910127 # gives files accessed on 910125 or 910126.
+----------------------+
| SET/COPYLEVEL [RANGE] |
+----------------------+
Use the SETCOPYLEVEL command to set the copylevel, or range of copylevels that will be applied to subsequent catalogue searches.
Example of valid copy level ranges
FM>set/copy 1,3,5-7 | Set copy levels 1,3 and 5 to 7 inclusive FM>set/copy -1 | No check on copy level will be made
+--------------------+
| SET/DATAREP [RANGE] |
+--------------------+
Use the SETDATAREP command to set the data representation, or range of data representation values that will be applied to subsequent catalogue searches.
+----------------------------------+
| SET/DESTINATION DESTINATION-SITE |
+----------------------------------+
Use the SETDESTINATION command to set the name of the destination site for CHEOPS transfer. The current list of destination sites is
If a name that is not in this list is specified, then a warning message will be issued.
+----------------------+
| SET/LOCATION [RANGE] |
+----------------------+
Use the SETLOCATION command to set the location code, or range of location codes that will be applied to subsequent catalogue searches.
Example of valid location code ranges
FM>set/loc 1,3,5-7 | Set location codes 1,3 and 5 to 7 inclusive FM>set/loc -1 | No check on location code will be made
+--------------------+
| SET/LOCCODES [FILE] |
+--------------------+
+----------------------+
| SET/MEDIATYPE [RANGE] |
+----------------------+
Use the SETMEDIATYPE command to set the media type, or range of media types that will be applied to subsequent catalogue searches.
Example of valid media type ranges
FM>set/media 1,3,5-7 | Set media types 1,3 and 5 to 7 inclusive FM>set/media -1 | No check on media type will be made
+------------------------+
| SET/SOURCE SOURCE-SITE |
+------------------------+
Use the SETSOURCE command to set the name of the source site for CHEOPS transfer. The current list of source sites is
If a name that is not in this list is specified, then a warning message will be issued.
+---------------------------------------------------------------------------------------------------------+
| SET/USERWORDS [UWORD1] [UWORD2] [UWORD3] [UWORD4] [UWORD5] [UWORD6] [UWORD7] [UWORD8] [UWORD9] [UWORD10] |
+---------------------------------------------------------------------------------------------------------+
Use the SETUSERWORDS command to set the values or ranges for the 10 user words that will be used in subsequent search commands. Values are 0 or positive integers, ranges are delimited by a minus sign. To indicate that no check is to be made on a given user word, specify -1.
Example of setting userwords
FM>set/userwords 0 3-5 77 -1 99
With the above settings, entries must have userword 1 be 0, userword 2 must be in the range 3 to 5 inclusive, userword 3 must be 77, no check is made on userword 4 and userword 5 must be 99. No change is made to the acceptable values for userwords 6 to 10, which are set at initialisation time to -1.
+----------------------+
| SHOW/COPYLEVEL RANGE |
+----------------------+
Use the SHOWCOPYLEVEL command to display the list of COPYLEVEL codes currently in effect (see SETCOPYLEVEL command).
+--------------------+
| SHOW/DATAREP RANGE |
+--------------------+
Use the SHOWDATAREP command to display the list of DATAREP codes currently in effect (see SETDATAREP command).
+------------------+
| SHOW/DESTINATION |
+------------------+
Use the SHOWDESTINATION command to display the current destination site for CHEOPS transfers.
+--------------------+
| SHOW/LOCATION RANGE |
+--------------------+
Use the SHOW LOCATION command to display the list of LOCATION codes currently in effect (see SETLOCATION command).
+----------------+
| SHOW/LOCCODES |
+----------------+
Use the SHOWLOCCODES command to display the current location code
definitions, as defined in the fatmen.loccodes file.
+----------------------+
| SHOW/MEDIATYPE RANGE |
+----------------------+
Use the SHOWMEDIATYPE command to display the list of MEDIATYPE codes currently in effect (see SETMEDIATYPE command).
+--------------+
| SHOW/SOURCE |
+--------------+
Use the SHOWSOURCE command to display the current source site for CHEOPS transfers.
+------------------+
| SHOW/USERWORDS |
+------------------+
Use the SHOWUSERWORDS command to display the list of USERWORD values or ranges currently in effect (see SETUSERWORDS command).
+------------------------------+
| TAG GNAME [KSN] [TAG] [CHOPT] |
+------------------------------+
Use the TAG command to get, set or delete the TMS TAG associated with the a tape volume that corresponds to the specified generic name.
+--------------------------+
| TOUCH GNAME [KSN] [CHOPT] |
+--------------------------+
Use the TOUCH command to reinsert an existing entry in the catalogue. If a negative key serial number is given, all matching entries will be updated.
+------------------------------+
| TREE [PATH] [NLEVEL] [OUTPUT] |
+------------------------------+
Use the TREE command to draw a directory tree starting at the specified directory down NLEVEL levels.
Example of using the TREE command
FM>pwd
Current working directory = //CERN/L3
FM>tree
FMTREK. directory tree structure below //CERN/L3 down 99 levels
/DRE
/JUNK
/CDREMM
/DREMM
/PROD
/DATA
/LDRE
/SDSUJK
/SDREJK
/SDSUCR
/SDSUBG
/SDRECR
/SDREBG
/SDREQQ
/SDSUQQ
/SDRESG
/SDSUTK
/SDSUSG
/SDRETK
/SDRETT
/SDSUTT
/SDREMM
/SDSUMM
/SDSUMX
/SDREMX
/SDREEM
/SDSUEM
/SDSUEE
/SDRENP
/SDREEE
/SDSUNP
/MDSU
/PDRE
/HESMRY
/MDRE
/SDREHG
/SDSUBH
/SDREGG
/SDREBH
/SDSUHG
/SDSUGG
/LEBRUN
/TEST4
44 subdirectories found
FM>
+----------------------------+
| UNLOCK GENAM [KSN] [CHOPT] |
+----------------------------+
ENAM generic name SN Key serial number. If not specified, the default FATMEN selection will be used. HOPT Options
Use the UNLOCK command to enable WRITE access to the tape on which the file specified resides. If a negative key serial number is given, all entries for the specified generic name will be unlocked.
+------------------------+
| UPDATE MAX NGROUP IFLAG |
+------------------------+
Use the UPDATE command to control the updating mode of the FATMEN package. (See on Page [more info] for details).
N.B. if updates are grouped together, care must be taken to leave the FATMEN shell with the exit command.
+----------+
| VERSION |
+----------+
Use the VERSION command to display the version of the FATMEN package. This information is also displayed at initialisation time.
+------------------+
| VIEW GNAME [KSN] |
+------------------+
Use the VIEW command to edit a local disk file. This command will be extended to support tape and remote files.
+----------+
| ZOOM PATH |
+----------+
Use the ZOOM command to move to the first directory matching the specified path name that contains no subdirectories and one or more files.
Example of the ZOOM command
Current Working Directory = //CERN/DELPHI FM> zoom Current Working Directory = //CERN/DELPHI/P01_ALLD/CDST/PHYS/Y90V03/E093.3/L0312 FMZOOM. files: 30 ... Current Working Directory = //CERN/OPAL FM> ld List of subdirectories... //CERN/OPAL/PLAY //CERN/OPAL/PROD //CERN/OPAL/EVKI //CERN/OPAL/SIMD //CERN/OPAL/MDST //CERN/OPAL/STEST //CERN/OPAL/RAWD //CERN/OPAL/DDST //CERN/OPAL/JAMIE Total of 9 subdirectories of which 9 match FM> zoom prod/*/p1* Current Working Directory = //CERN/OPAL/PROD/PASS3/FILT/P1R1033L039 FMZOOM. files: 4