README file for "SRBhello" sample programs

Last Update 9/4/97

What's here?


Documentation

The SRBhello suite contains 30 or more programs which demonstrate the Storage Resource Broker (SRB) client library and an argument parsing package for command-line program development. These programs can be executed by the script 'testsuite' to run a battery of validation tests on a SRB installation.

Documentation Notes:

The srbUserArgs argument parsing routines are required for all programs in this suite. See below for source code information.

Command line arguments or argument values listed in square brackets are optional.

Command line argument values listed in curly braces are exclusive choices.

The -help flag is valid for all programs. Use this flag to obtain usage information.

The -verbose flag is also valid for all programs. Specifying this flag will cause many comments to be output to stderr.

Some arguments allow the listing of multiple values e.g., -to srb_file_name [name2 ... nameN]. The absolute maximum number of values that may be supplied is given by SRB_USERARG_MAXC in srbUserArgs.h.


Index to client library routines

ROUTINE WHERE USED
clConnect (all)
clErrorMessage (all)
clFinish (all)
clStatus (all)
srbChkMdasAuth srbchkauth
srbClosedir srblsdir
srbCreateCollect srbmkcoll
srbDbLobjClose srbdbcreate srbdbget srbdbseek
srbDbLobjCreate srbdbcreate
srbDbLobjOpen srbdbget srbdbseek
srbDbLobjRead srbdbget srbdbseek
srbDbLobjSeek srbdbseek
srbDbLobjUnlink srbdbdel
srbDbLobjWrite srbdbcreate
srbFileChmod srbchmod
srbFileClose srbfcreate srbfget srbfseek
srbFileCreate srbfcreate
srbFileMkdir srbmkdir
srbFileOpen srbfget srbfseek
srbFileRead srbfget srbfseek
srbFileRmdir srbrmdir
srbFileSeek srbfseek
srbFileStat srbfget srbfseek srbfstat
srbFileSync srbfcreate srbfget srbfseek
srbFileUnlink srbfdel
srbFileWrite srbfcreate
srbFreeHostInfo srbhostinfo
srbFreeVaultInfo srbvaultinfo
srbGetDataDirInfo srboddinfo srboget
srbGetDatasetInfo srbodsinfo
srbHostConfig srbhostinfo
srbListCollect srblscoll
srbModifyCollect srbmodcoll
srbObjClose srbocreate srboget srboseek
srbObjCopy srbocopy
srbObjCreate srbocreate
srbObjMove srbomove
srbObjOpen srboget srboseek
srbObjRead srboget srboseek
srbObjSeek srboseek
srbObjUnlink srbodel
srbObjWrite srbocreate
srbOpendir srblsdir
srbPrintHostInfo srbhostinfo
srbPrintVaultInfo srbvaultinfo
srbReaddir srblsdir
srbSetAuditTrail srbaudittrail
srbSetStorAttr srbftpbrowse
srbVaultInfo srbvaultinfo


Index to individual source files

SOURCE ITEM DESCRIPTION
Makefile Example Makefile
testsuite Bourne shell script to run test battery. Provides example usage of all routines.
helpsuite Bourne shell script to output help information from all routines.
srbhello.c tests connection to SRB
srbchkauth.c tests user authentication
srbhostinfo.c retreives information on host
srbvaultinfo.c retreives information on host vaults
srbaudittrail.c tests audit trail toggle
srbftpbrowse.c performs ftp login and directory change
srblsdir.c lists the contents of an SRB directory
srbmkdir.c creates unix-like directories in the SRB
srbrmdir.c removes unix-like directories in the SRB
srbfcreate.c creates a SRB file
srbfchmod.c modifies file or directory mode
srbfstat.c gets unix-like file status
srbfget.c gets a SRB file
srbfseek.c retrieves bytes from a SRB file
srbfdel.c deletes unix-like files in the SRB
srbmkcoll.c creates directory-like collection in the SRB
srblscoll.c lists the contents of an SRB collection
srbmodcoll.c modifies directory-like collection in the SRB
srbocreate.c creates an object
srbodsinfo.c lists specific SRB object info
srboddinfo.c lists all SRB object info
srboget.c gets an object from the SRB
srboseek.c retrieves bytes from an object
srbomove.c moves an object between resources
srbocopy.c copies an object between resources
srbodel.c deletes objects in the SRB
srbdbcreate.c creates a DBMS LOBJ
srbdbget.c gets a DBMS LOBJ
srbdbseek.c retrieves bytes from a DBMS LOBJ
srbdbdel.c deletes DBMS LOBJ's


ARGUMENT PARSING ROUTINES

srbUserArgs.h - C include file.
srbUserArgs.c - C source file.
API routines:
      srbUserArgs
      srbFreeArgs
Example Usage: testargs.c


HOST CONNECTIONS

srbhello.c : tests connection to SRB
Usage.
  srbhello
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
SRB API routines:
      clConnect                       (srbhello)
      clStatus                        (srbhello)
      clErrorMessage                  (srbhello)
      clFinish                        (srbhello)
srbchkauth.c : tests user authentication
Usage.
  srbchkauth
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
    -user user_name                         (string)     (Requires 1 values)
    -domain domain_name                     (string)     (Requires 1 values)
SRB API routines:
      clConnect                       (srbchkauth)
      clStatus                        (srbchkauth)
      clErrorMessage                  (srbchkauth)
      clFinish                        (srbchkauth)
      srbChkMdasAuth                  (srbchkauth)
srbhostinfo.c : retreives information on host
Usage.
  srbhostinfo
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
SRB API routines:
      clConnect                       (srbhostinfo)
      clStatus                        (srbhostinfo)
      clErrorMessage                  (srbhostinfo)
      clFinish                        (srbhostinfo)
      srbHostConfig                   (srbhostinfo)
      srbPrintHostInfo                (srbhostinfo)
      srbFreeHostInfo                 (srbhostinfo)
srbvaultinfo.c : retreives information on host vaults
Usage.
  srbvaultinfo
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
SRB API routines:
      clConnect                       (srbvaultinfo)
      clStatus                        (srbvaultinfo)
      clErrorMessage                  (srbvaultinfo)
      clFinish                        (srbvaultinfo)
      srbVaultInfo                    (srbvaultinfo)
      srbPrintVaultInfo               (srbvaultinfo)
      srbFreeVaultInfo                (srbvaultinfo)


AUDIT TRAIL INTERFACE

srbaudittrail.c : tests audit trail toggle
Usage.
  srbaudittrail
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
    -on                                     (null)       (Optional)
    -off                                    (null)       (Optional)
SRB API routines:
      clConnect                       (srbaudittrail)
      clStatus                        (srbaudittrail)
      clErrorMessage                  (srbaudittrail)
      clFinish                        (srbaudittrail)
      srbSetAuditTrail                (srbaudittrail)


FTP BROWSING

srbftpbrowse.c : performs ftp login and directory change
Usage.
  srbftpbrowse
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
    -rsrc resource_name                     (string)     (Requires 1 values)
    -dir dir1                               (string)     (Requires 1 values)
SRB API routines:
      clConnect                       (srbftpbrowse)
      clStatus                        (srbftpbrowse)
      clErrorMessage                  (srbftpbrowse)
      clFinish                        (srbftpbrowse)
      srbSetStorAttr                  (srbftpbrowse)


EXTENDED FILE INTERFACE

srblsdir.c : lists the contents of an SRB directory.
Usage.
  srblsdir
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
    -rsrc resource_name                     (string)     (Requires 1 values)
    -syst {unix,unicos,hpss,ftp}            (int)        (Requires 1 values)
    -dir srb_dir1 [dir2 ... dirN]           (string)     (Required)
Up to 128 values permitted for arguments allowing multiple values.
Possible "-syst" values:
    unix  unitree  hpss  ftp
Default is users home directory.
SRB API routines:
      clConnect                       (srblsdir)
      clStatus                        (srblsdir)
      clErrorMessage                  (srblsdir)
      clFinish                        (srblsdir)
      srbOpendir                      (srblsdir)
      srbReaddir                      (srblsdir)
      srbClosedir                     (srblsdir)
srbmkdir.c : creates unix-like directories in the SRB
Usage.
  srbmkdir
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
    -rsrc resource_name                     (string)     (Requires 1 values)
    -syst {unix,unicos,hpss,ftp}            (int)        (Requires 1 values)
    -dir srb_dir1 [dir2 ... dirN]           (string)     (Required)
    -mode unix_like_mode                    (int)        (Requires 1 values)
Up to 128 values permitted for arguments allowing multiple values.
Possible "-syst" values:
    unix  unitree  hpss  ftp
SRB API routines:
      clConnect                       (srbmkdir)
      clStatus                        (srbmkdir)
      clErrorMessage                  (srbmkdir)
      clFinish                        (srbmkdir)
      srbFileMkdir                    (srbmkdir)
srbrmdir.c : removes unix-like directories in the SRB.
Usage.
  srbrmdir
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
    -rsrc resource_name                     (string)     (Requires 1 values)
    -syst {unix,unicos,hpss,ftp}            (int)        (Requires 1 values)
    -dir srb_dir1 [dir2 ... dirN]           (string)     (Required)
Up to 128 values permitted for arguments allowing multiple values.
Possible "-syst" values:
    unix  unitree  hpss  ftp
SRB API routines:
      clConnect                       (srbrmdir)
      clStatus                        (srbrmdir)
      clErrorMessage                  (srbrmdir)
      clFinish                        (srbrmdir)
      srbFileRmdir                    (srbrmdir)
srbfcreate.c : creates a unix-like file in the SRB from existing file on local system. Sync's SRB file after close.
Usage.
  srbfcreate
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -rsrc resource_name                     (string)     (Requires 1 values)
    -syst {unix,unicos,hpss,ftp}            (int)        (Requires 1 values)
    -from local_file1 [file2 ... fileN]     (string)     (Required)
    -file srb_file1 [file2 ... fileN]       (string)     (Optional)
    -dir srb_dir1 [dir2 ... dirN]           (string)     (Optional)
    -mode unix_like_mode                    (int)        (Requires 1 values)
    -bufsize i/o_buffer_size                (int)        (Optional)
Up to 128 values permitted for arguments allowing multiple values.
Possible "-syst" values:
    unix  unitree  hpss  ftp
SRB API routines:
      clConnect                       (srbfcreate)
      clStatus                        (srbfcreate)
      clErrorMessage                  (srbfcreate)
      clFinish                        (srbfcreate)
      srbFileCreate                   (srbfcreate)
      srbFileWrite                    (srbfcreate)
      srbFileClose                    (srbfcreate)
      srbFileSync                     (srbfcreate)
srbfchmod.c : modifies file or directory mode
Usage.
  srbfchmod
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
    -rsrc resource_name                     (string)     (Requires 1 values)
    -syst {unix,unicos,hpss,ftp}            (int)        (Requires 1 values)
    -file srb_file1 [file2 ... fileN]       (string)     (Required)
    -mode unix_like_mode                    (int)        (Requires 1 values)
Up to 128 values permitted for arguments allowing multiple values.
Possible "-syst" values:
    unix  unitree  hpss  ftp
SRB API routines:
      clConnect                       (srbchmod)
      clStatus                        (srbchmod)
      clErrorMessage                  (srbchmod)
      clFinish                        (srbchmod)
      srbFileChmod                    (srbchmod)
srbfstat.c : gets unix-like file status
Usage.
  srbfstat
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
    -rsrc resource_name                     (string)     (Requires 1 values)
    -syst {unix,unicos,hpss,ftp}            (int)        (Requires 1 values)
    -file srb_file1 [file2 ... fileN]       (string)     (Required)
Up to 128 values permitted for arguments allowing multiple values.
Possible "-syst" values:
    unix  unitree  hpss  ftp
SRB API routines:
      clConnect                       (srbfstat)
      clStatus                        (srbfstat)
      clErrorMessage                  (srbfstat)
      clFinish                        (srbfstat)
      srbFileStat                     (srbfstat)
srbfget.c : gets a unix-like file from the SRB. Sync's file prior to open. The number of arguments given in the optional -to argument must match the number given in -file.
Usage.
  srbfget
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
    -rsrc resource_name                     (string)     (Requires 1 values)
    -syst {unix,unicos,hpss,ftp}            (int)        (Requires 1 values)
    -file srb_file1 [file2 ... fileN]       (string)     (Required)
    -to local_file1 [file2 ... fileN]       (string)     (Optional)
    -bufsize i/o_buffer_size                (int)        (Optional)
Up to 128 values permitted for arguments allowing multiple values.
Possible "-syst" values:
    unix  unitree  hpss  ftp
SRB API routines:
      clConnect                       (srbfget)
      clStatus                        (srbfget)
      clErrorMessage                  (srbfget)
      clFinish                        (srbfget)
      srbFileStat                     (srbfget)
      srbFileSync                     (srbfget)
      srbFileOpen                     (srbfget)
      srbFileRead                     (srbfget)
      srbFileClose                    (srbfget)
srbfseek.c : retrieves bytes from a specified offset in a SRB file and sends data to stdout.
Usage.
  srbfseek
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
    -rsrc resource_name                     (string)     (Requires 1 values)
    -syst {unix,unicos,hpss,ftp}            (int)        (Requires 1 values)
    -file srb_file1                         (string)     (Requires 1 values)
    -seek seek_location (in bytes)          (int)        (Required)
    -to local_file1 [file2 ... fileN]       (string)     (Optional)
    -bytes #bytes                           (int)        (Required)
Possible "-syst" values:
    unix  unitree  hpss  ftp
SRB API routines:
      clConnect                       (srbfseek)
      clStatus                        (srbfseek)
      clErrorMessage                  (srbfseek)
      clFinish                        (srbfseek)
      srbFileStat                     (srbfseek)
      srbFileSync                     (srbfseek)
      srbFileOpen                     (srbfseek)
      srbFileSeek                     (srbfseek)
      srbFileRead                     (srbfseek)
      srbFileClose                    (srbfseek)
srbfdel.c : deletes unix-like files in the SRB.
Usage.
  srbfdel
    -verbose                                (null)       (Optional)
    -file srb_file1 [file2 ... fileN]       (string)     (Required)
    -rsrc resource_name                     (string)     (Requires 1 values)
    -host host_name                         (string)     (Requires 1 values)
    -syst {unix,unicos,hpss,ftp}            (int)        (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
Up to 128 values permitted for arguments allowing multiple values.
Possible "-syst" values:
    unix  unitree  hpss  ftp
SRB API routines:
      clConnect                       (srbfdel)
      clStatus                        (srbfdel)
      clErrorMessage                  (srbfdel)
      clFinish                        (srbfdel)
      srbFileUnlink                   (srbfdel)


OBJECT INTERFACE

srbmkcoll.c : creates directory-like collection in the SRB.
Usage.
  srbmkcoll
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
    -cattype catalog_type                   (int)        (Requires 1 values)
    -parent parent_collection               (string)     (Requires 1 values)
    -coll collection_name                   (string)     (Required)
Up to 128 values permitted for arguments allowing multiple values.
Possible "-cattype" values:
    MDAS  LDAP  FILE
SRB API routines:
      clConnect                       (srbmkcoll)
      clStatus                        (srbmkcoll)
      clErrorMessage                  (srbmkcoll)
      clFinish                        (srbmkcoll)
      srbCreateCollect                (srbmkcoll)
srblscoll.c : lists the contents of an SRB collection.
Usage.
  srblscoll
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
    -cattype catalog_type                   (int)        (Requires 1 values)
    -coll collection_name                   (string)     (Required)
Up to 128 values permitted for arguments allowing multiple values.
Possible "-cattype" values:
    MDAS  LDAP  FILE
SRB API routines:
      clConnect                       (srblscoll)
      clStatus                        (srblscoll)
      clErrorMessage                  (srblscoll)
      clFinish                        (srblscoll)
      srbListCollect                  (srblscoll)
srbmodcoll.c : modifies directory-like collection in the SRB.
Usage.
  srbmodcoll
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
    -cattype catalog_type                   (int)        (Requires 1 values)
    -coll collection_name                   (string)     (Requires 1 values)
    -op operation                           (int)        (Required)
    -a1 attribute1                          (string)     (Optional)
    -a2 attribute2                          (string)     (Optional)
    -a3 attribute3                          (string)     (Optional)
Up to 128 values permitted for arguments allowing multiple values.
Possible "-cattype" values:
    MDAS  LDAP  FILE
Possible "-op" values:
    D_DELETE_ONE  D_DELETE_DOMN  D_INSERT_DOMN  D_CHANGE_SIZE
    D_CHANGE_TYPE  D_CHANGE_GROUP  D_CHANGE_SCHEMA  D_INSERT_ACCS
    D_DELETE_ACCS  D_DELETE_ALIAS  D_INSERT_ALIAS  D_DELETE_COMMENTS
    D_INSERT_COMMENTS  D_INSERT_AUDIT  D_CHANGE_OWNER
    U_CHANGE_PASSWORD  U_DELETE  U_DELETE_DOMN  U_INSERT_DOMN
    U_DELETE_GROUP  U_INSERT_GROUP  U_CHANGE_TYPE  U_DELETE_ALIAS
    U_INSERT_ALIAS  U_CHANGE_VERKEY  U_CHANGE_ENCKEY
    D_INSERT_COLL_ACCS  D_DELETE_COLL_ACCS  D_CHANGE_DNAME
    D_CHANGE_COLL_NAME  D_DELETE_COLL
SRB API routines:
      clConnect                       (srbmodcoll)
      clStatus                        (srbmodcoll)
      clErrorMessage                  (srbmodcoll)
      clFinish                        (srbmodcoll)
      srbModifyCollect                (srbmodcoll)
srbocreate.c : creates an object in the SRB from existing file on local system. The number of values given in the optional -obj argument must match the number given in -from. An obj_id is required for each new object.
Usage.
  srbocreate
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
    -rsrc resource_name                     (string)     (Requires 1 values)
    -cattype catalog_type                   (int)        (Requires 1 values)
    -coll collection_name                   (string)     (Requires 1 values)
    -from local_file1 [file2 ... fileN]     (string)     (Required)
    -obj srb_obj1 [obj2 ... objN]           (string)     (Optional)
    -id obj_id (user supplied string)       (string)     (Required)
    -type data_type_name                    (string)     (Requires 1 values)
    -bufsize i/o_buffer_size                (int)        (Optional)
Up to 128 values permitted for arguments allowing multiple values.
Possible "-cattype" values:
    MDAS  LDAP  FILE
SRB API routines:
      clConnect                       (srbocreate)
      clStatus                        (srbocreate)
      clErrorMessage                  (srbocreate)
      clFinish                        (srbocreate)
      srbObjCreate                    (srbocreate)
      srbObjWrite                     (srbocreate)
      srbObjClose                     (srbocreate)
srbodsinfo.c : lists SRB object info.
Usage.
  srbodsinfo
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
    -rsrc resource_name                     (string)     (Requires 1 values)
    -coll collection_name                   (string)     (Requires 1 values)
    -id obj_id (user supplied string)       (string)     (Required)
Up to 128 values permitted for arguments allowing multiple values.
SRB API routines:
      clConnect                       (srbodsinfo)
      clStatus                        (srbodsinfo)
      clErrorMessage                  (srbodsinfo)
      clFinish                        (srbodsinfo)
      srbGetDatasetInfo               (srbodsinfo)
srboddinfo.c : lists SRB object info.
Usage.
  srboddinfo
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
    -rsrc resource_name                     (string)     (Requires 1 values)
    -coll collection_name                   (string)     (Requires 1 values)
    -id obj_id (user supplied string)       (string)     (Required)
Up to 128 values permitted for arguments allowing multiple values.
SRB API routines:
      clConnect                       (srboddinfo)
      clStatus                        (srboddinfo)
      clErrorMessage                  (srboddinfo)
      clFinish                        (srboddinfo)
      srbGetDataDirInfo               (srboddinfo)
srboget.c : gets an object from the SRB. The number of arguments given in the optional -to argument must match the number given in -id.
Usage.
  srboget
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
    -rsrc resource_name                     (string)     (Requires 1 values)
    -coll collection_name                   (string)     (Requires 1 values)
    -id obj_id (user supplied string)       (string)     (Required)
    -to local_file1 [file2 ... fileN]       (string)     (Optional)
    -bufsize i/o_buffer_size                (int)        (Optional)
Up to 128 values permitted for arguments allowing multiple values.
SRB API routines:
      clConnect                       (srboget)
      clStatus                        (srboget)
      clErrorMessage                  (srboget)
      clFinish                        (srboget)
      srbGetDataDirInfo               (srboget)
      srbObjOpen                      (srboget)
      srbObjRead                      (srboget)
      srbObjClose                     (srboget)
srboseek.c : retrieves bytes from a specified offset in a SRB object.
Usage.
  srboseek
    -verbose                                (null)       (Optional)
    -rsrc resource_name                     (string)     (Requires 1 values)
    -host host_name                         (string)     (Requires 1 values)
    -bufsize i/o_buffer_size                (int)        (Optional)
    -auth authentication_key                (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -seek seek_location (in bytes)          (int)        (Required)
    -coll collection_name                   (string)     (Requires 1 values)
    -id obj_id (user supplied string)       (string)     (Required)
    -to local_file1 [file2 ... fileN]       (string)     (Optional)
    -bytes #bytes                           (int)        (Required)
Up to 128 values permitted for arguments allowing multiple values.
SRB API routines:
      clConnect                       (srboseek)
      clStatus                        (srboseek)
      clErrorMessage                  (srboseek)
      clFinish                        (srboseek)
      srbObjOpen                      (srboseek)
      srbObjSeek                      (srboseek)
      srbObjRead                      (srboseek)
      srbObjClose                     (srboseek)
srbomove.c : moves an object between resources
  srbomove
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
    -rsrc resource_name1 resource_name2     (string)     (Requires 2 values)
    -cattype catalog_type                   (int)        (Requires 1 values)
    -coll collection_name                   (string)     (Requires 1 values)
    -obj srb_obj1 srb_obj2                  (string)     (Requires 2 values)
    -id obj_id (user supplied string)       (string)     (Requires 1 values)
Possible "-cattype" values:
    MDAS  LDAP  FILE
SRB API routines:
      clConnect                       (srbomove)
      clStatus                        (srbomove)
      clErrorMessage                  (srbomove)
      clFinish                        (srbomove)
      srbObjMove                      (srbomove)
srbocopy.c : copies an object between resources
Usage.
  srbocopy
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
    -rsrc resource_name1 resource_name2     (string)     (Requires 2 values)
    -cattype catalog_type                   (int)        (Requires 1 values)
    -coll collection_name                   (string)     (Requires 1 values)
    -obj srb_obj1 srb_obj2                  (string)     (Requires 2 values)
    -id obj_id (user supplied string)       (string)     (Requires 1 values)
Possible "-cattype" values:
    MDAS  LDAP  FILE
SRB API routines:
      clConnect                       (srbocopy)
      clStatus                        (srbocopy)
      clErrorMessage                  (srbocopy)
      clFinish                        (srbocopy)
      srbObjCopy                      (srbocopy)
srbodel.c : deletes objects in the SRB.
  srbodel
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
    -coll collection_name                   (string)     (Requires 1 values)
    -id obj_id (user supplied string)       (string)     (Required)
Up to 128 values permitted for arguments allowing multiple values.
SRB API routines:
      clConnect                       (srbodel)
      clStatus                        (srbodel)
      clErrorMessage                  (srbodel)
      clFinish                        (srbodel)
      srbObjUnlink                    (srbodel)


DBMS LOBJ INTERFACE

srbdbcreate.c : creates a DBMS LOBJ from existing file on local system.
Usage.
  srbdbcreate
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
    -rsrc resource_name                     (string)     (Requires 1 values)
    -dbms {db2,illustra}                    (int)        (Requires 1 values)
    -from local_file1 [file2 ... fileN]     (string)     (Required)
    -table table_name                       (string)     (Optional)
    -id obj_id (user supplied string)       (string)     (Required)
    -mode unix_like_mode                    (int)        (Requires 1 values)
    -bufsize i/o_buffer_size                (int)        (Optional)
Up to 128 values permitted for arguments allowing multiple values.
Possible "-dbms" values:
    db2  illustra
SRB API routines:
      clConnect                       (srbdbcreate)
      clStatus                        (srbdbcreate)
      clErrorMessage                  (srbdbcreate)
      clFinish                        (srbdbcreate)
      srbDbLobjCreate                 (srbdbcreate)
      srbDbLobjWrite                  (srbdbcreate)
      srbDbLobjClose                  (srbdbcreate)
srbdbget.c : gets a DBMS LOBJ
Usage.
  srbdbget
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
    -rsrc resource_name                     (string)     (Requires 1 values)
    -dbms {db2,illustra}                    (int)        (Requires 1 values)
    -table table_name                       (string)     (Optional)
    -id obj_id (user supplied string)       (string)     (Required)
    -mode unix_like_mode                    (int)        (Requires 1 values)
    -to local_file1 [file2 ... fileN]       (string)     (Optional)
    -bufsize i/o_buffer_size                (int)        (Optional)
Up to 128 values permitted for arguments allowing multiple values.
Possible "-dbms" values:
    db2  illustra
SRB API routines:
      clConnect                       (srbdbget)
      clStatus                        (srbdbget)
      clErrorMessage                  (srbdbget)
      clFinish                        (srbdbget)
      srbDbLobjOpen                   (srbdbget)
      srbDbLobjRead                   (srbdbget)
      srbDbLobjClose                  (srbdbget)
srbdbseek.c : retrieves bytes from a specified offset in a DBMS LOBJ.
Usage.
  srbdbseek
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
    -rsrc resource_name                     (string)     (Requires 1 values)
    -dbms {db2,illustra}                    (int)        (Requires 1 values)
    -table table_name                       (string)     (Optional)
    -id obj_id (user supplied string)       (string)     (Required)
    -mode unix_like_mode                    (int)        (Requires 1 values)
    -seek seek_location (in bytes)          (int)        (Requires 1 values)
    -bytes #bytes                           (int)        (Requires 1 values)
    -to local_file1 [file2 ... fileN]       (string)     (Optional)
    -bufsize i/o_buffer_size                (int)        (Optional)
Up to 128 values permitted for arguments allowing multiple values.
Possible "-dbms" values:
    db2  illustra
SRB API routines:
      clConnect                       (srbdbseek)
      clStatus                        (srbdbseek)
      clErrorMessage                  (srbdbseek)
      clFinish                        (srbdbseek)
      srbDbLobjOpen                   (srbdbseek)
      srbDbLobjSeek                   (srbdbseek)
      srbDbLobjRead                   (srbdbseek)
      srbDbLobjClose                  (srbdbseek)
srbdbdel.c : deletes DBMS LOBJ's.
Usage.
  srbdbdel
    -verbose                                (null)       (Optional)
    -host host_name                         (string)     (Requires 1 values)
    -port port#                             (string)     (Requires 1 values)
    -auth authentication_key                (string)     (Requires 1 values)
    -rsrc resource_name                     (string)     (Requires 1 values)
    -dbms {db2,illustra}                    (int)        (Requires 1 values)
    -table table_name                       (string)     (Optional)
    -id obj_id (user supplied string)       (string)     (Required)
Up to 128 values permitted for arguments allowing multiple values.
Possible "-dbms" values:
    db2  illustra
SRB API routines:
      clConnect                       (srbdbdel)
      clStatus                        (srbdbdel)
      clErrorMessage                  (srbdbdel)
      clFinish                        (srbdbdel)
      srbDbLobjUnlink                 (srbdbdel)