next up previous contents index
Next: Using the command Up: The FATMEN interactive Previous: The FATMEN interactive

Summary of commands

  The command line interface consists of a set of Unix-like commands and is based on the KUIP package[3]. 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
ALLOCATEALLOCATEPOOL LIBRARY GNAME DSN FFORM CPLEV HOSTN [COMM] [RECFM] [LRECL] [BLOCK] [FSIZE] [MEDIA]
POOL
Name of the TMS Pool from which the volume is to be allocated
LIBRARY
Name of the TMS Library containing the specified pool
GNAME
Generic file name for which the volume is to be allocated
DSN
Dataset name on the tape volume
FFORM
File format (FZ, FA, FX, RZ, EP, UN, AS)
CPLEV
Copy level or data representation
HOSTN
Host name (e.g. CERNVM)
COMM
Comment string
RECFM
record format (e.g. FB, VBS)
LRECL
record length (in words)
BLOCK
block length (in words)
FSIZE
file size (in megabytes)
MEDIA
media type (2=3480,3=3420,4=8200,...)
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. ADDDISKADD/DISKGNAME DSN FFORM CPLEV HOSTN [COMM] [RECFM] [LRECL] [BLOCK] [FSIZE] [LOCCOD] [USER1] [USER2] [USER3] [USER4] [USER5] [USER6] [USER7] [USER8] [USER9] [USER10]
GNAME
Generic file name for which the volume is to be allocated
DSN
Dataset name on the tape volume
FFORM
File format (FZ, FA, FX, RZ, EP, UN, AS)
CPLEV
Copy level or data representation
HOSTN
Host name (e.g. CERNVM)
COMM
Comment string
RECFM
record format (e.g. FB, VBS)
LRECL
record length (in words)
BLOCK
block length (in words)
FSIZE
file size (in megabytes)
LOCCOD
Location code
USER1
User word 1
USER2
User word 2
USER3
User word 3
USER4
User word 4
USER5
User word 5
USER6
User word 6
USER7
User word 7
USER8
User word 8
USER9
User word 9
USER10
User word 10
Use the ADD/DISK command to add a new disk file to the FATMEN catalogue ADDTAPEADD/TAPEVSN VID FSEQ GNAME DSN FFORM CPLEV HOSTN [COMM] [RECFM] [LRECL] [BLOCK] [FSIZE] [MEDIA] [LOCCOD] [USER1] [USER2] [USER3] [USER4] [USER5] [USER6] [USER7] [USER8] [USER9] [USER10]
VSN
volume serial number
VID
visual identifier
FSEQ
file sequence number
GNAME
Generic file name for which the volume is to be allocated
DSN
Dataset name on the tape volume
FFORM
File format (FZ, FA, FX, RZ, EP, UN, AS)
CPLEV
Copy level or data representation
HOSTN
Host name (e.g. CERNVM)
COMM
Comment string
RECFM
record format (e.g. FB, VBS)
LRECL
record length (in words)
BLOCK
block length (in words)
FSIZE
file size (in megabytes)
MEDIA
media type (2=3480,3=3420,4=8200,...)
LOCCOD
Location code
USER1
User word 1
USER2
User word 2
USER3
User word 3
USER4
User word 4
USER5
User word 5
USER6
User word 6
USER7
User word 7
USER8
User word 8
USER9
User word 9
USER10
User word 10
Use the ADD/TAPE command to add a new tape file to the FATMEN catalogue

CDCD[PATH] [CHOPT]

PATH
Name of directory
CHOPT
options
A
all of below
Q
show quota for new directory
S
show number of subdirectories
T
show creation and modification times
U
show usage information
Use the CD command to change the current default directory. Some examples of the CD command are given below: 

 
\lsb zfatal\rsb  > 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>
CLRCLR Use the CLR command to clear the screen CPCPFROM TO [KSN] [LOCCOD DATREP MEDTYP VSN VID FSEQ DSN HOST
FROM
Original file
TO
Target file
KSN
Key serial number to identify a particular source file if there is more than one entry for the specified generic name
LOCCOD
The location code for the output entry. If not specified, the location code of the input dataset will be used.
DATREP
The data representation of the output entry. If not specified, the data representation of the input dataset will be used.
MEDTYP
The media type of the output entry. If not specified, the media type of the input dataset will be used.
VSN
The VSN of the output entry.
VID
The VID of the output entry.
FSEQ
The file sequence number of the output entry.
DSN
The dataset name of the output entry.
HOST
The hostname of the output entry.
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. COPYCOPYGNAME [KS1] [KS2] [POOL] [LIBRARY] [VID] [FSEQ] [NODE] [FILE] [CHOPT]
GNAME
Generic name of the file to be copied
KS1
Key serial number of the input file. If not specified, the normal FATMEN selection mechanism will be used.
KS2
Key serial number of the output file. If specified the information on the output file will be taken from the corresponding catalogue entry.
POOL
Name of the TMS pool from which a volume is to be allocated for the copy. If neither the POOL nor VID are specified, the output file is assumed to be on disk.
LIBRARY
TMS Library containing the named pool from which a volume is to be allocated.
VID
Visual Identifier of the output tape, if automatic allocation from a named pool is not to be used.
FSEQ
File sequence number on the output tape volume.
NODE
Node name on which the file resides. The default is the current node. If a remote node is specified, the file will be copied using the CSPACK [5] routines.
FILE
File name for the output file
TRANSPORT
Transport mechanism in case of a remote copy
TCPIP
This is the default transport for making remote copies
DECnet
Between VAX/VMS systems only
CHEOPS
Queue for transfer via Olympus satellite. This option is only valid on nodes at sites participating in the CHEOPS project. At other sites such requests will automatically be rejected. The source and destination sites must previously have been set using the SETSOURCE and SETDESTINATION commands.
LOCCOD
The location code for the copied file
DATREP
The data representation for the copied file
MEDTYP
The medium type of the medium on which the copy resides
CHOPT
Options
C
perform copy using STAGE CHANGE
L
Lock output tape volume using TMS LOCK command
P
Perform a physical copy. This uses the VMS copy command on VAX/VMS systems, the cp command on Unix systems, and VMIO subroutine calls on VM/CMS systems.
S
STAGE IN the input file
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
DIRDIR[PATH] [OUTPUT] [CHOPT]
PATH
path-name
OUTPUT
output file name. If not specified the output will be directed to the terminal
CHOPT
options
T
list also subdirectory tree
Use the DIR command to issue a call to RZLDIR for the specified path. This command is normally used for debug purposes only. DUMPDUMPGENAM [KSN] [BYTES] [BLOCKS] [FILES] [CODE]      
GENAM
generic-name
KSN
Key serial number. If not specified, the default FATMEN selection will be used with the exception that disk entries will be ignored.
BYTES
Number of bytes per block to dump. The default is 320.
BLOCKS
Number of blocks per file to dump. The default is 1.
FILES
Number of files to dump. The default is 1.
CODE
Character code (EBCDIC or ASCII). If the volume is labelled, the character code used for the VOL1 label will be assumed. If unlabelled, this option can be used to override the default character code which is EBCDIC.
The DUMP command requests a TAPEDUMP of the VID corresponding to the specified generic name. ENDEND 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
EXITEXIT 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. EXTRACTEXTRACTGNAME OUTPUT [CHOPT]
GNAME
Generic name describing the entries to be extracted. The name may contain wild-cards.
OUTPUT
Output filename in which the information is to be written.
CHOPT
Options
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. FCFC[GNAME] [OUTPUT] [CHOPT]
GNAME
Generic name describing the entries to be counted. The name may contain wild-cards. The default is *, i.e. to count all files in the current directory.
OUTPUT
Output filename. If not specified, the output will be directed to the terminal.
CHOPT
Options
D
display number of subdirectories at each level
F
display number of files at each level
L
display lowest level only, i.e. directories with no subdirectories
Z
display only directories with no (zero) files
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>
FINDFINDGNAME LOGNAM
GNAME
Generic name of the file to be accessed
LOGNAM
Logical name (DDNAME, link etc.) to be associated with the file. A numeric value is converted according to the FORTRAN conventions on the local machine, unless the file is to be accessed using a special package.
VM/CMS
nn is converted to FTnnF001. If the logical format is EP, then it is converted to IOFILEnn.
MVS
nn is converted to FTnnF001. If the logical format is EP, then it is converted to IOFILEnn.
VAX/VMS
nn is converted to FOR0nn.
Unix
nn is converted to fort.nn
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 gif for the description of the format of the logical unit parameter). GIMEGIME Use the GIME command to reaccess the disk of the service machine which maintains the FATMEN catalogue. This command has no parameters. INITINITGROUP
GROUP
Group or Throng name
Use the INIT command to initialise the FATMEN system for the specified group or throng, e.g. ALEPH

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:

VAX/VMS
look in directories defined by the logical name FATPATH. If this logical name is not defined, a default search list of SYS$DISK:[],SYS$LOGIN is used. (i.e. current and home directories)
Unix
Look in directories defined in path variable FATPATH. If this variable is not defined, use current and home directories.
VM/CMS
check disks in global variable FATPATH. If not defined, only the A disk is searched.
MVS
The user prefix is prepended to the kumac name, e.g. R01JDS.FATUSER.KUMAC.

The following examples show how to define the search path on different systems.

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) LDLD[PATH] [OUTPUT] [NLEVEL] [CHOPT]

PATH
Directory name to be listed. If not specified, the directories below the current working directory are displayed. The directory name may contain wild cards.
OUTPUT
Output file name. If not specified, the output is directed to the terminal.
NLEVEL
Number of levels below the current directory to be displayed when option R is specified. The default is 1 level without option R and 100 levels with option R.
CHOPT
List of options
H
write header line in output file
R
list subdirectories recursively
V
'very wide' listing. As W, but 132 columns
W
'wide'. Subdirectories are displayed in multi-column (80) format
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>
LOCKLOCKGENAM [KSN] [CHOPT]    
GENAM
generic name of the entry to be processed.
KSN
Key serial number of the entry to be processed. If not specified, the default FATMEN selection is used with the exception that disk files are ignored.
CHOPT
Option string
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. LOGLEVELLOGLEVEL[LEVEL]
LEVEL
Loglevel to be set
-3
Suppress all log messages
-2
Error messages
-1
Terse logging
0
Normal (FMINIT, FMEND etc.)
1
Log calls to FATMEN routines (FORTRAN callable interface)
2
Log to monitor FATMEN internal decisions, such as selection of a dataset
3
Debug messages
Use the LOGLEVEL command to set the FATMEN loglevel. LNLNCHSRCE CHTRGT [CHCOMM] [IW1] [IW2] [IW3] [IW4] [IW5] [IW6] [IW7] [IW8] [IW9] [IW10] [CHOPT]
CHSRCE
Character variable of maximum length 255 to specify the generic name of the link to an existing object.
CHTRGT
Character variable of maximum length 255 specifying an existing generic name.
CHCOMM
Character variable of maximum length 80 specifying the comment to be associated to the link.
IW1
User word 1
IW2
User word 2
IW3
User word 3
IW4
User word 4
IW5
User word 5
IW6
User word 6
IW7
User word 7
IW8
User word 8
IW9
User word 9
IW10
User word 10
CHOPT
Character variable specifying the required options.
C
set the comment field to the string specified in CHCOMM
U
set the user words to the values in the vector IVECT
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. LSLS[GNAME] [KSN] [OUTPUT] [NAMES] [CHOPT]
GNAME
Generic name to be listed, containing wild-cards if required. If not specified, a * is used, i.e. all files in the current directory will be displayed.
KSN
Key serial number. If specified only the entry matching the generic name and key serial number combination will be displayed. This parameter is ignored if the specified generic name contains wild cards.
OUTPUT
Output file name. If not specified the output is directed to the terminal.
NAMES
Name of the names file (if the specified generic names starts with a %).
CHOPT
Option string
A
list all attributes, except DZSHOW (option Z).
B
brief (80) column listing
C
display comment field associated with file
D
to be used to generate a KUMAC file to remove (delete) the entry
E
extended (132) column listing
F
list file attributes, such as start/end record and block
G
list the full generic name of each file
H
write header line]useful in the case of output redirection
I
sort generic names in Increasing order
J
Just show entries that are accessible
K
list keys associated with this file (copy level, media type, location)
L
list logical attributes, such as FATMEN file format (ZEBRA exchange etc.)
M
list media attributes, such as VSN, VID, file sequence number for tape files, host type and operating system for disk files.
N
lists dataset name on disk/tape of this file
O
list owner, node and job of creator etc.
P
list physical attributes, such as record format etc.
Q
obtain volume information from Tape Management System (TMS) if the entry corresponds to a tape file, and if the TMS option is installed.
R
display where the data Reside.
Disk files
Displays if the file is accessible and the access method, if known. (e.g. local disk, NFS, AFS, DFS etc.)
Tape files
Displays if the associated volume is in an active library, i.e. not archived, whether it is staged, and whether a device of the appropriate type exists on the local node or is served.
S
lists security details of this file (protection)
T
list date and time of creation, last access etc.
U
list user words.
X
display only one entry per generic name (implies I)
W
list generic names across the page (default is one name per line)
Z
dump ZEBRA bank with DZSHOW.
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 gif 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>
MAKEMAKEGNAME LOGNAM
GNAME
Generic name of the file to be accessed
LOGNAM
Logical name (DDNAME, link etc.) to be associated with the file. A numeric value is converted according to the FORTRAN conventions on the local machine, unless the file is to be accessed using a special package.
VM/CMS
nn is converted to FTnnF001. If the logical format is EP, then it is converted to IOFILEnn.
MVS
nn is converted to FTnnF001. If the logical format is EP, then it is converted to IOFILEnn.
VAX/VMS
nn is converted to FOR0nn.
Unix
nn is converted to fort.nn
The MAKE command is similar to the FIND command, except that it is for write access. MEDIAMEDIAMEDIA [TYPE] [MODEL] [SIZE] [DENS] [MNTP] [LABEL]
MEDIA
FATMEN media type. This is an integer as used in the FATMEN keys (MKMTFA) and bank (MMTPFA).
TYPE
device type. This is the physical device type, e.g. 3480, 3420 etc.
MODEL
generic device type. This may be the same as the physical device type. However, on many systems it differs. For example, at CERN the generic device type for 3480 is CT1. This is the resource that is required to access a volume of the physical type TYPE.
SIZE
capacity in MB
DENS
density
MNTP
mount-type (M/R)
LABEL
label-type (SL/AL/NL)

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

MKDIRMKDIRPATH

PATH
Path name of the directory to be created.
Use the MKDIR command to create a directory or directory tree. MODIFYMODIFYGNAME [KSN] [LOCCOD] [DATREP] [MEDTYP] [FFORM] [RECFM] [RECL] [BLOCK] [FSIZE] [COMM]
FROM
Original file
TO
Target file
KSN
Key serial number to identify a particular source file if there is more than one entry for the specified generic name
LOCCOD
The location code for the output entry.
DATREP
The data representation of the output entry.
MEDTYP
The media type of the output entry.
FFORM
File format (FZ, FA, FX, RZ, EP, UN, AS)
RECFM
record format (e.g. FB, VBS)
LRECL
record length (in words)
BLOCK
block length (in words)
FSIZE
file size (in megabytes)
COMM
Comment string

MVMVFROM TO [KSN] [LOCCOD DATREP MEDTYP VSN VID FSEQ DSN HOST

FROM
Original file
TO
Target file
KSN
Key serial number to identify a particular source file if there is more than one entry for the specified generic name
LOCCOD
The location code for the output entry. If not specified, the location code of the input dataset will be used.
DATREP
The data representation of the output entry. If not specified, the data representation of the input dataset will be used.
MEDTYP
The media type of the output entry. If not specified, the media type of the input dataset will be used.
VSN
The VSN of the output entry.
VID
The VID of the output entry.
FSEQ
The file sequence number of the output entry.
DSN
The dataset name of the output entry.
HOST
The hostname of the output entry.
Use the MV command to ``move'' or rename a file. NICKNICKNICKNAME CHFILE CHOPT
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.

PWDPWD Use the PWD command to print the current (working) directory. QUITQUIT Use the QUIT command to leave the FATMEN shell. Any outstanding catalogue updates will be purged. See also the description of the EXIT command. RMRMGNAME [KSN] [DSN] [HOST] [VID] [USER] [POOL] [PROT] [CHOPT]

GNAME
File to be removed
KSN
Key serial number. Must be specified if more than one entry exists for the given generic name and the A option is not given.
DSN
Fileid/DSN. Only entries with the specified fileid will be deleted.
HOST
Hostname. Only entries with the specified hostname will be deleted.
VID
VID. Only entries with the specified VID will be deleted.
USER
Username. Only entries with the specified username will be deleted.
POOL
Pool into which the tape volume corresponding to the specified entry is returned to, if option F is given. If not specified, a pool name gg_FAT1 will be used, e.g. WS\_FAT1.
PROT
Protection group to be applied to the freed volume. The protection group will be set as follows:
Unchanged
G
Set to the value specified by PROT or *None if no value is specified.
GP
Set to the value specified by PROT or the value of POOL if no value of PROT is specified.
CHOPT
Options
A
remove all occurances of this generic name
E
erase disk file
I
prompt before removing each matching entry
F
free tape associated with specified entry
G
Set protection group
P
when used with option F, allows privileged TMS user to free anyones tapes (within a group)
U
'unlock' or write-enable tape
D
delete TMS tag
B
binary TMS tag
T
text TMS tag
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

RMDIRRMDIRPATH

PATH
Name of the directory to be removed. The directory must contain no files and no subdirectories.
Use the RMDIR command to remove an empty directory from the catalogue.

RMTREERMTREEPATH

PATH
Name of the directory tree to be removed. The tree must contain no files.
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.

RMLNRMLNCHLINK [LUN] [CHFILE] [CHOPT]

CHLINK
Character variable specifying the path to be searched for dangling links, containing wild-cards as necessary
LUN
Unit number on which the file CHFILE is written, with option F
CHFILE
Character variable specifying the name of the file to be written, with option F.
CHOPT
Character variable specifying the required options.
P
Print the names of dangling links
D
Write the names of dangling links in the form rm generic-name ksn
R
Remote dangling links
F
Redirect output to the file CHFILE on the unit LUN
SEARCHSEARCHGNAME [DSN] [HOST] [VID] [USER] [OUTPUT] [NMATCH] [CREATED] [CATALOGED] [ACCESSED] [UFORM] [COMMENT] [OUTPUT] [CHOPT]
GNAME
Generic name specifying the files to be searched
DSN
String containing wild cards, if required. If not specified, no match is made on this field.
HOST
String containing wild cards, if required. If not specified, no match is made on this field.
VID
String containing wild cards, if required. If not specified, no match is made on this field.
USER
String containing wild cards, if required. If not specified, no match is made on this field.
NMATCH
Instruct search to stop after NMATCH matches. If not specified, the entire catalogue will be searched.
CREATED
date range
CATALOGED
date range
ACCESSED
date range
UFORM
String containing wild cards, if required. If not specified, no match is made on this field.
COMMENT
String containing wild cards, if required. If not specified, no match is made on this field.
OUTPUT
Output filename. If not specified the output will be sent to the terminal.
CHOPT
Options
A
list all attributes, except DZSHOW (option Z).
B
brief (80) column listing
C
display comment field associated with file
D
to be used to generate a KUMAC file to remove (delete) the entry
E
extended (132) column listing
F
list file attributes, such as start/end record and block
G
list the full generic name of each file
H
write header line]useful in the case of output redirection
I
sort generic names in Increasing order
J
Just show entries that are accessible
K
list keys associated with this file (copy level, media type, location)
L
list logical attributes, such as FATMEN file format (ZEBRA exchange etc.)
M
list media attributes, such as VSN, VID, file sequence number for tape files, host type and operating system for disk files.
N
lists dataset name on disk/tape of this file
O
list owner, node and job of creator etc.
P
list physical attributes, such as record format etc.
Q
obtain volume information from Tape Management System (TMS) if the entry corresponds to a tape file, and if the TMS option is installed.
R
display where the data Reside.
Disk files
Displays if the file is accessible and the access method, if known. (e.g. local disk, NFS, AFS, DFS etc.)
Tape files
Displays if the associated volume is in an active library, i.e. not archived, whether it is staged, and whether a device of the appropriate type exists on the local node or is served.
S
lists security details of this file (protection)
T
list date and time of creation, last access etc.
U
list user words.
X
display only one entry per generic name (implies I)
W
list generic names across the page (default is one name per line)
Z
dump ZEBRA bank with DZSHOW.
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 from\_date\_and\_time-to\_date\_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>

SCANSCANGNAME [NLEVELS] [DSN] [HOST] [VID] [USER] [OUTPUT] [NMATCH] [CREATED] [CATALOGED] [ACCESSED] [UFORM] [COMMENT] [OUTPUT] [STRING] [CHOPT]

GNAME
Generic name specifying the files to be searched
NLEVELS
Number of levels down to be scanned
DSN
String containing wild cards, if required. If not specified, no match is made on this field.
HOST
String containing wild cards, if required. If not specified, no match is made on this field.
VID
String containing wild cards, if required. If not specified, no match is made on this field.
USER
String containing wild cards, if required. If not specified, no match is made on this field.
NMATCH
Instruct search to stop after NMATCH matches. If not specified, the entire catalogue will be searched.
CREATED
date range
CATALOGED
date range
ACCESSED
date range
UFORM
String containing wild cards, if required. If not specified, no match is made on this field.
COMMENT
String containing wild cards, if required. If not specified, no match is made on this field.
OUTPUT
Output filename. If not specified the output will be sent to the terminal.
STRING
String to be appended to the RM command, in case of option D.
CHOPT
Options
A
list all attributes, except DZSHOW (option Z).
B
brief (80) column listing
C
display comment field associated with file
D
to be used to generate a KUMAC file to remove (delete) the entry In this case files within a directory will be scanned backwards.
E
extended (132) column listing
F
list file attributes, such as start/end record and block
G
list the full generic name of each file
H
write header line]useful in the case of output redirection
I
sort generic names in Increasing order
J
Just show entries that are accessible
K
list keys associated with this file (copy level, media type, location)
L
list logical attributes, such as FATMEN file format (ZEBRA exchange etc.)
M
list media attributes, such as VSN, VID, file sequence number for tape files, host type and operating system for disk files.
N
lists dataset name on disk/tape of this file
O
list owner, node and job of creator etc.
P
list physical attributes, such as record format etc.
Q
obtain volume information from Tape Management System (TMS) if the entry corresponds to a tape file, and if the TMS option is installed.
R
display where the data Reside.
Disk files
Displays if the file is accessible and the access method, if known. (e.g. local disk, NFS, AFS, DFS etc.)
Tape files
Displays if the associated volume is in an active library, i.e. not archived, whether it is staged, and whether a device of the appropriate type exists on the local node or is served.
S
lists security details of this file (protection)
T
list date and time of creation, last access etc.
U
list user words.
X
display only one entry per generic name (implies I)
W
list generic names across the page (default is one name per line)
Z
dump ZEBRA bank with DZSHOW.
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 from\_date\_and\_time-to\_date\_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.

SETCOPYLEVELSET/COPYLEVEL[RANGE]

RANGE
range of copy levels codes. If a range or list is not specified, a value of -1 is used, indicating that no check on the copy level should be made.
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

SETDATAREPSET/DATAREP[RANGE]

RANGE
range of data representation codes. If a range or list is not specified, a value of -1 is used, indicating that no check on the data representation code should be made.
Use the SETDATAREP command to set the data representation, or range of data representation values that will be applied to subsequent catalogue searches.

SETDESTINATIONSET/DESTINATIONDESTINATION-SITE

DESTINATION
Destination site for CHEOPS transfer
Use the SETDESTINATION command to set the name of the destination site for CHEOPS transfer. The current list of destination sites is

CERN
HELSINKI
LISBON
SARDINIA
ATHENS

If a name that is not in this list is specified, then a warning message will be issued.

SETLOCATIONSET/LOCATION[RANGE]

RANGE
range of location codes. If a range or list is not specified, a value of -1 is used, indicating that no check on the location code should be made.

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

SETLOCCODESSET/LOCCODES[FILE]

FILE
Name of the file containing the location code definitions. See the description of the FMLCOD routine for an example of the file format.

SETMEDIATYPESET/MEDIATYPE[RANGE]

RANGE
range of media types. If a range or list is not specified, a value of -1 is used, indicating that no check on the media type should be made.

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

SETSOURCESET/SOURCESOURCE-SITE

SOURCE
Source site for CHEOPS transfer
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.

SETUSERWORDSSET/USERWORDS[UWORD1] [UWORD2] [UWORD3] [UWORD4] [UWORD5] [UWORD6] [UWORD7] [UWORD8] [UWORD9] [UWORD10]

UWORD1
range or value for user word 1
UWORD2
range or value for user word 2
UWORD3
range or value for user word 3
UWORD4
range or value for user word 4
UWORD5
range or value for user word 5
UWORD6
range or value for user word 6
UWORD7
range or value for user word 7
UWORD8
range or value for user word 8
UWORD9
range or value for user word 9
UWORD10
range or value for user word 10
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.

SHOWCOPYLEVELSHOW/COPYLEVELRANGE

Use the SHOWCOPYLEVEL command to display the list of COPYLEVEL codes currently in effect (see SETCOPYLEVEL command).

SHOWDATAREPSHOW/DATAREPRANGE

Use the SHOWDATAREP command to display the list of DATAREP codes currently in effect (see SETDATAREP command).

SHOWDESTINATIONSHOW/DESTINATION

Use the SHOWDESTINATION command to display the current destination site for CHEOPS transfers.

SHOWLOCATIONSHOW/LOCATIONRANGE

Use the SHOWLOCATION command to display the list of LOCATION codes currently in effect (see SETLOCATION command).

SHOWLOCCODESSHOW/LOCCODES  

Use the SHOWLOCCODES command to display the current location code definitions, as defined in the fatmen.loccodes file.

SHOWMEDIATYPESHOW/MEDIATYPERANGE

Use the SHOWMEDIATYPE command to display the list of MEDIATYPE codes currently in effect (see SETMEDIATYPE command).

SHOWSOURCESHOW/SOURCE

Use the SHOWSOURCE command to display the current source site for CHEOPS transfers.

SHOWUSERWORDSSHOW/USERWORDS

Use the SHOWUSERWORDS command to display the list of USERWORD values or ranges currently in effect (see SETUSERWORDS command).

TAGTAGGNAME [KSN] [TAG] [CHOPT]

GNAME
Generic name of the entry to be tagged
KSN
Key serial number. If not specified, the default FATMEN selection will be used.
TAG
Tag
CHOPT
Options
D
delete the tag
G
get and display the tag
S
set the tag
B
to select the BINARY tag (stored as CHARACTER*255)
T
to select the TEXT tag (default)
V
to select the VOLINFO tag
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.

TOUCHTOUCHGNAME [KSN] [CHOPT]

GNAME
Generic name of the entry to be touched
KSN
Key serial number. If not specified, the default FATMEN selection will be used.
CHOPT
Options
O
reset owner, node and job of creator etc.
T
update date and time of last access
U
zero use count
A
set account field
C
clear comment field
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.

TREETREE[PATH] [NLEVEL] [OUTPUT]

PATH
Path name
NLEVEL
number of levels to be displayed
OUTPUT
Output filename. If not specified, the output will be displayed on the terminal.
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>

UNLOCKUNLOCKGENAM [KSN] [CHOPT] 

\item[GENAM]generic name
\item[KSN]Key serial number. If not specified, the default FATMEN
selection will be used.
\item[CHOPT]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.

UPDATEUPDATEMAX NGROUP IFLAG

MAX
Maximum number of updates. If not specified, a default value of 999 is used.
NGROUP
Number of updates to be grouped together. The default is to send each update individually. This value is ignored except on VM/CMS systems
IFLAG
Flag controlling the option required
-1
Reset to defaults
0
Send any outstanding updates
1
Purge any outstanding updates

Use the UPDATE command to control the updating mode of the FATMEN package. (See on Page gif for details).

N.B. if updates are grouped together, care must be taken to leave the FATMEN shell with the exit command.

VERSIONVERSION Use the VERSION command to display the version of the FATMEN package. This information is also displayed at initialisation time.

VIEWVIEWGNAME [KSN]

GNAME
Generic name of the file to be editted.
KSN
Key serial number. If not specified, the default FATMEN selection will be used.
Use the VIEW command to edit a local disk file. This command will be extended to support tape and remote files.

ZOOMZOOMPATH

PATH
Path name to be followed
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


next up previous contents index
Next: Using the command Up: The FATMEN interactive Previous: The FATMEN interactive

Janne Saarela
Mon May 15 09:59:59 METDST 1995