Optional: Setting up Tivoli Storage Manager for IBM Content Manager

You must configure a value in the ICMRMCONTROL table and complete additional configuration steps to set up a z/OS® resource manager that uses Object Access Method (OAM) with Tivoli® Storage Manager to manage the storage and retrieval of objects.

1. In the table ICMRMCONTROL, set the TSMENABLED flag to one of the following values. This value indicates what storage method the resource manager uses.

   Value	Storage Method
   0	Object Access Method only
   1	Both Object Access Method and Tivoli Storage Manager
   2	Tivoli Storage Manager only

2. Define the Tivoli Storage Manager in IBM® Content Manager.
3. For each management class entity that is defined in theTivoli Storage Manager server is used, you must define a matching entity in the ICMRMMGMTCLASS table for the resource manager database.
   Restriction: Only one Tivoli Storage Manager server is allowed per resource manager instance. Therefore, only one row in the ICMRMSERVER table represents the Tivoli Storage Manager server instance. Each server can have more than one collection assigned to it, and each collection is associated with a management class in the resource manager collection table. The record in the resource manager collection table indicates with which Tivoli Storage Manager management class an item is stored when storing this resource manager collection. The management class table holds the defined management classes in your Tivoli Storage Manager server.

   The fields and default values for the ICMRMMGMTCLASS table are:

   MGMTCODE (SHORT 2): 1

   A numeric value that increments for each new management class created.

   MGMTCLASS (CHAR 15): DISK

   Indicates the management class that was defined for the Tivoli Storage Manager server. You can indicate DISK, DEFAULT, TAPE, or OPTICAL for this value.

   For each Tivoli Storage Manager server, there are also collections defined. Each collection entity is associated with a Tivoli Storage Manager server and management class entity.

   COLLCODE (LONG 4): 1

   Numeric values that increment with each new collection defined.

   TSMCOLLNAME (CHAR 44): TSM000

   The Tivoli Storage Manager server collection name and must be the same as what was defined in IBM Content Manager through the system administration client for the associated resource manager.

   TSMCOLLMGMTCLASS (CHAR 15): DISK

   This value is determined by the ICMRMMGMTCLASS table and is the link between an IBM Content Manager defined collection and a Tivoli Storage Manager defined management class and policy domain.

   COLLSRVID (LONG 4): 1

   This numeric value must be the same as in the ICMRMSERVER table. This value also determines how the collection is associated with the server.

   The previous IBM Content Manager constructs are combined to form the Tivoli Storage Manager file space where objects within Tivoli Storage Manager are stored.

4. For each collection that is used, you must insert a row into the ICMRMCOLLECTIONS table. The collection entity does not have a direct mapping within Tivoli Storage Manager. A Tivoli Storage Manager server entity is defined as a row in the resource manager database ICMRMSERVER table. Contained in this table are all the parameters that are required to connect to the Tivoli Storage Manager server from the resource manager.
5. Set the following parameters according to your system setup:

   SRVID (LONG 4): 1

   Integer value with starting value of (1).

   SRVTYPE (CHAR 128): TSM

   Character value that indicates the type of server.

   SRVNAME (CHAR 128): IMWEBSR1

   This value is the name given to the resource manager (defined through the system administration client) that is associated with the Tivoli Storage Manager server.

   SRVRPROTOCOL (CHAR 128): HTTP

   Indicates the transport method.

   SRVRUSERID (CHAR 128): SYSADM

   The user ID that is used to connect to the Tivoli Storage Manager server.

   SRVRPASSWORD (CHAR 128): compl1pass

   The password that is associated with your Tivoli Storage Manager server connection user ID.

   SRVRHOSTNAME (CHAR 128): tsm.server.ibm.com

   The fully qualified host name where the Tivoli Storage Manager server resides and is required only for the location of the Tivoli Storage Manager server.

   SRVRPORT (CHAR 128): 1580

   The port number where the Tivoli Storage Manager server is listening.

   SRVSCHEMA (CHAR 128): IBMSCHA

   The database schema name of the resource manager database.

   SRVPATH (CHAR 128): /usr/lpp/Tivoli/tsm/client/api/bin/

   The absolute path to the libApiDS.a Tivoli Storage Manager client API in an IBM z/OS UNIX System Services system.

   SRVPLATFORM (CHAR 128): Linux or other operating systems

   The operating system that the Tivoli Storage Manager server is running and is used to determine the type of path delimiters. Set this value to Linux, AIX® or Solaris for setup with a z/OS UNIX System Services system.

   TSMOPTFILENAME (VARCHAR 128): /usr/lpp/Tivoli/tsm/client/api/bin/dsm.opt

   The fully qualified path of the Tivoli Storage Manager option file.

   TSMOUNTWAIT (SHORT 2): 1

   A flag that indicates the Tivoli Storage Manager APIs wait for the mount of a device or return if it is not mounted within a preset time. Set this value to 1 to wait for the device or set to 0 if you do not want the API to wait for the device.

   TSMBUFFERSIZE (LONG 4): 32768

   A numeric value that specifies the size of the buffer of data that is sent to the Tivoli Storage Manager server. The maximum value is 32768 bytes.

   TSMCOMPRESSION (LONG 4): 0

   Indicates whether the Tivoli Storage Manager internally compresses the data that it stores. Set this value to 1 if you want to compress data or 0 if you do not want to compress data.

   TSMMODE (SHORT 2):

   This field is not currently used.

   TSMNODENAME (CHAR 128): TSMNODE1

   Groups the Tivoli Storage Manager file spaces within Tivoli Storage Manager.

   TSMAPPTYPE (CHAR 128): ZOSRM

   An optional identifier of the application that connects to the Tivoli Storage Manager server.

   TSMOPTFILE (CHAR 128):

   This field is not currently used.

   TSMFILESPACETYPE (CHAR 128):

   This field is not currently used.

   TSMARCHIVE (SHORT 2): 1

   A flag that indicates to the resource manager whether the Tivoli Storage Manager server is set up in the Backup or Data Retention (archive/Centera) mode. Set this value to 1 for the Data Retention mode or 0 for the Backup mode.

   TSMOPTIONS (SHORT 2):

   This field is not currently used.

   TSMLOGFILENAME (VARCHAR 200): tsmlog.log

   A log file name that you can specify to rename the Tivoli Storage Manager log file.

   TSMACCESSFILE (VARCHAR 200): /user/tsm/tsmaccess.arg

   The fully qualified path location to the tsmaccess.arg file. This file must be configured when the Tivoli Storage Manager server is running in the Password Access: Generate mode.