A storage administrator usually performs most of the steps in the following procedure. To find the exceptions, tasks typically done by a system programmer, look for items starting with (SYSPROG).
Some steps in the following 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 SRM Reference Guide.
To configure CA Vantage GMI for CATLMS
This job copies system SCRIPT, JCLLIB, and PARMLIB members for CATLMS to the SCRIPT, JCLLIB, and PARMLIB data sets. This job is located in the CCTUSAMP library, customize it to your needs as instructed in the comments at the beginning of the member, and run it now.
This product's Disk Interval service enhances system performance for vendor objects in which the vendor APIs are considered too slow for retrieving a large number of records. Tape management (volume and file) objects are in this group.
Disk Interval data sets are dynamically allocated and written with the aid of scripts. Sample scripts are distributed in the CA Vantage CCTUSAMP library.
CTSXUTIL performs the following tasks:
When you request these objects from any of this product's clients, View Mode=DI is automatically used (it is the default), and the data is read from the Disk Interval data set at a much higher speed. If you choose View Mode=RT, the slower native API is used to get the data in Real-Time. You will have to wait considerably longer to get the data.
Proper configuration involves scheduling the Disk Interval scripts to run just frequently enough to allow normal analysis Disk Interval data.
The J05TLMS job copies the following scripts from the CCTUSAMP library to your system-script library, as named by system parameter SYSTSCR. It is recommended that you enable these scripts. The header of each sample contains information on how to activate the script.
Object: Files and Volumes
Type: DI
Object: Files
Type: DI
Object: Volumes
Type: DI
This product provides several tape summary reports for CATLMS. To enable these reports do the following:
Edit PARMLIB member SUMMARY to activate the reports. If this member does not exist, copy it from the CCTUSAMP library. The following is an example of part of the SUMMARY member:
********************************************************************** * * TAPE MANAGEMENT SYSTEMS SUPPORTED: * ********************************************************************** *%%INCLUDE MEMBER=SUMRVIS * SUMMARY DEFS FOR CA 1 - TMC SUMMARIES *%%INCLUDE MEMBER=SUMRTLMS * SUMMARY DEFS FOR CA TLMS SUMMARIES *%%INCLUDE MEMBER=SUMRRMM * SUMMARY DEFS FOR DFSMSRMM SUMMARIES *%%INCLUDE MEMBER=SUMRZAR * SUMMARY DEFS FOR ASG‑ZARA SUMMARIES
To activate the summaries for CATLMS, delete the asterisk in column 1 in the following line:
*%%INCLUDE MEMBER=SUMRTLMS * SUMMARY DEFS FOR CA TLMS SUMMARIES
Note: Additional configuration is required to complete the configuration of Summary Reports for CATLMS as described in subsequent steps.
The VMF file is identified by the TLMSVMF system parameter and the extract files are identified by the CTSTLMSF (files/data sets) and CTSTLMSV (volumes) system parameters.
Before submitting the job, carefully review the second job-step in J05TLMS that pre-allocates the CTSDSN and CTSVOL data sets. The comments in the job give you a method to calculate the size of the data sets.
Note: The execution parameter value of VMF must be specified on the EXEC statement of the JCLLIB member. For example:
//stepname EXEC PGM=CTSXUTIL,PARM=’VMF’
CTSTLMSF (%%DSNPFX%%.CTSDSN) CTSTLMSV (%%DSNPFX%%.CTSVOL)
Automate the TLMSDSKU job to extract the data by using the system script DSKTLMSU, distributed with the system, to schedule and run the TLMSDSKU job when necessary.
If DSKTLMSU is not in your system-script library, copy it from the CCTUSAMP library.
To enable this script do the following:
SUBSTITUTE_JCL=DSN=%%DSNPFX%%.JCLLIB,MEMBER=TLMSDSKU
Ensure that the CTSTDB parameter points to the data set that contains your VMF input dataset and the CTSDSN and CTSVOL data set names specify the correct output dataset names.
To maximize efficiency the DCB parameters, BLKSIZE= and BUFNO= parameters for the CTSDSN and CTSVOL disk interval files should specify using the following general guidelines:
- BLKSIZE should be set to a relatively high-value (in multiples of the VMF LRECL of 500 bytes) to minimize I/O and pass more records to the object creator program.
- BUFNO should be set equal to the multiple of the BLKSIZE and is calculated by dividing the BLKSIZE by 500. For example a BLKSIZE of 27500 would result in the specification of 55 buffers.
This DSKTLMSU script is configured to be fired immediately after the CA Vantage SRM system is (re)started. This will build the CA TLMS Disk Interval data sets.
This script will automatically FIRE every six hours to refresh the CA TLMS Disk Interval Datasets. To change the frequency, alter the following script statement to meet your needs:
PERFORM_FVT_PROC=INTERVAL=mmmm
Or use the System Script Builder wizard in the Windows Client to set these values. To use this wizard, click z/OS Menu, Object Scripting, System Scripts, and then select the DSKTLMSU script.
F SAMS,AUTO,REFRESH=SYSTEM,DSKTLMSU
F SAMS,AUTO,FIRE=SYSTEM,DSKTLMSU
Or use the Fire Script action from the object displays on one of the clients.
Note: All the FILTTLxx members must be created and customized for tape volume summaries to work properly. If these members do not exist in your PARMLIB yet, copy them from the CCTUSAMP library.
The following PARMLIB members are for the CATLMS Tape Volume Summaries:
Used to qualify active tapes (those not in scratch status) into groups depending on the number of MB written to the tape.
Used to qualify active tapes (those not in scratch status) into groups based on the first data set name written to the tape.
Used to qualify active tapes (those not in scratch status) into groups based upon the last job name that used the tape.
Used to qualify tapes into groups depending on the SMS management class of the tape.
* SET_SUM_LABEL=GRP PSS.A300./ SET_SUM_FILTER=VBSCRTCH = N AND 'DATA SET NAME' INCL 'PSS.A300./' * SET_SUM_LABEL=GRP2 DMSOS./ SET_SUM_FILTER=VBSCRTCH = N AND 'DATA SET NAME' INCL 'DMS0S./' * SET_SUM_LABEL=G3 SYS4S.MVSS./ SET_SUM_FILTER=VBSCRTCH = N AND 'DATA SET NAME' INCL 'SYS4S.MVSS./'
SET_SUM_LABEL= SET_SUM_FILTER=
A maximum of 1000 such groups is allowed.
Gives the grouping its group name. In the example above, the group name for the first group is GRP PSS.A300./. A maximum of 16 characters can be used to describe the group name.
Qualifies the tapes into the different groups you create. Use the VBSCRTCH = N filter to select only active tapes in the group (not tapes with scratch status). For a list of other field variables that can be used in the filter, run the GENMAP utility for object VISTLMSV. See member MAPPINGS in the CCTUSAMP library for this utility. All the substitution variables (without the enclosing %% signs) can be used within the filter.
The SET_SUM_FILTER= statement has the following general syntax:
SET_SUM_FILTER=('field name' comparator value) AND|OR
('field name' comparator value)
Observe the following SET_SUM_FILTER syntax rules:
- This statement must begin in column one. Comment statements are indicated by an asterisk in column one.
- You can use as many field name comparator value criteria as necessary, connected through any combination of logical AND and OR operators. Parentheses are needed only to clarify the desired logic when multiple AND and OR operations are specified.
- Do not go beyond position 72 in a definition line. If the definition extends to a second line, split the text between words (not in the middle of a word). Leaving a blank in position one of the new line is recommended.
- When a field name contains a blank, it must be contained within single quotes. If the field name does not contain a blank, the quotes are not needed.
- For numeric fields, the comparator can be any of the common LE, LT, EQ, NE, GE, or GT comparison operators.
- For character fields, use the INCL or EXCL operators to indicate that the following list of test values are to be either included or excluded respectively. Parentheses can be used around a list of test values, and are recommended for clarity when more than one value is given. However the parentheses are not required. Items in a list can be separated by commas or blanks. For example:
'DATA SET NAME' INCL (PSS.A300./,SYS4/,DB2/)
- Test values for character fields can be either exact character strings, or pattern strings. For patterns, use the question mark (?) to represent any variable character, and the forward slash (/) to match any characters that follow. For example, TSO?5/ accepts any character after TSO and any suffix after the digit 5.
Note: For more information on wildcard characters, using quotes, and filtering, see the section Global Concepts, Functions, and Features in the CA Vantage SRM User Guide.
Note: For information regarding syntax rules, see the topic "Filter Syntax Rules" in the CA Vantage SRM Reference Guide for more information.
The system invokes CATLMS service programs, such as TLMSCMD, which require access to the CATLMS parameter library. Therefore, update the SAMS JCL procedure and add a //TLMSOPTS DD statement that points to your CATLMS CAI.CTAPOPTN data set. The DD name must be TLMSOPTS, for example:
//TLMSOPTS DD DISP=SHR,DSN=your.TLMS.ctapoptn.dataset
To allow CA Vantage SRM users the ability to perform actions on objects residing in the Volume Master File (VMF), you must give them authority within your security system to update the VMF data set.
Note: For more information, see the topic "Security Topics" in the CA Vantage SRM Reference Guide.
CA Vantage GMI is up and running.
|
Copyright © 2014 CA.
All rights reserved.
|
|