z/OS Host Configuration › Configure CA GMI for CA Vtape

Configure CA GMI for CA Vtape

To configure the CA GMI for CA Vtape

Note: Some steps in this procedure involve setting security access authority, see your security administrator to confirm or establish the proper access authorities for those steps. For more information about security, see the section Actions Against Tape Related Objects in the topic "Security Topics" in the CA Vantage Reference Guide.

1. Ensure that CA Vtape and CA Vantage are running on the same z/OS image.

   They must be on the z/OS image because CA Vantage uses cross memory services to obtain data from the VCAT Dataspace of CA Vtape.

2. Ensure that CA Vtape is started before CA Vantage, and shutdown after CA Vantage.

   This order ensures that CA Vtape is always available when CA Vantage requests information. If CA Vtape is shutdown at the exact time CA Vantage is collecting data, abends may occur.

3. Ensure that DSN=your.ca.vtape.loadlib is available to CA Vantage when it starts.

   If this library is in your system linklist, there is nothing more to do. If it is not in the linklist, then edit the SAMS JCL procedure and concatenate it to the //STEPLIB DD statement.

   CA Vantage can now find the API to query CA Vtape for information.

   Note: When an API is not available, CA Vantage customarily intercepts the 806 abend and issues appropriate messages. z/OS usually issues the message: CSV003I REQUESTED MODULE <pgmname> NOT FOUND.

4. Use the CA Vantage Config Client to set appropriate values for the following system parameters:

   VTAPNTVL

   Specify the number of minutes to wait for the collection of new CA Vtape statistics, valid values are 1-9999. The default is value is (30).

   VTASUPP

   Specify (Y) to activate support for CA Vtape.

   VTPDSNCK

   The default value of Yes (Y) allows users with ALTER access to a Data Set the ability to RECALL the data set from CA Vtape. Specify a value of No (N) if you want the RECALL ability to be controlled solely by sysparm TAPADMIN, which requires ALTER access to the TAPADMIN resource name.

   Note: For more information, see the description of system parameter TAPADMIN in the Configuration Guide.

   These system parameter values take effect the next time the CA Vtape component within CA Vantage is started.

   Note: For more information about the CA Vantage Config Client, see the chapter "Configure CA GMI" in the CA Vantage Configuration Guide.

5. Allow CA Vantage to create objects for Virtual Volumes and Virtual Volume Data Sets.

   To do this, give the user ID associated with the CA Vantage started task read access to the Global VCAT for CA Vtape.

   CA Vantage now has the required security access to build these two objects.

6. Allow appropriate users access to the CA Vtape Free Queue information.

   To do this, give the appropriate user IDs read access to the BSDS1 data set.

   Users that have been given this access can now work with the CA Vtape Free Queue object.

7. Allow appropriate users to perform Actions on the CA Vtape objects.

   To do this, give the appropriate user IDs read access to the TAPADMIN resource facility.

   Note: For more information, see the description of system parameter TAPADMIN in the CA Vantage Configuration Guide.

   Users that have been given this access can now perform Actions on the CA Vtape objects.

8. Enable the CA Vtape component within CA Vantage.

   To do this, edit the CONFIG member of your PARMLIB and uncomment the COMP=VTAPE statement.

   The CA Vtape component within CA Vantage will now be activated whenever CA Vantage is started.

   Configuration of the CA Vtape component within CA Vantage is now complete. The CA Vtape objects and services are now available whenever you start CA Vantage.

9. Stop and Restart CA Vantage.

   The CA GMI is up and running.

Return to the section Install and Configure CA GMI and continue the rest of the setup. The instructions tell you how to start the Windows Client and create host definitions so that you can work with CA Vtape objects as described in the chapter "Using CA Vtape Objects".