Hp XP Command View Advanced Edition Software Manuel d'utilisateur

HP XP7 Smart Manager for MainframeUser GuidePart number: TK916-96001First edition: April 2014

FiguresAutomatic data relocation across tiers according to the access frequency ... 151Locating data in a specified tier according

Procedure1. Perform either of the following operations to acquire information about the tiering policies fromthe storage system.• To acquire informati

2. Execute either of the following commands.• To acquire the page relocation status of each volume:Execute the KTQRYTPG command.• To acquire the progr

Tiering Policy Group Name: TPG1Volumes POOL Devn,Volser,SN ,CU,CCA, ID,TLv,RelocateStatus ,LocatedPage/ TotalPage 000

Tiering Policy Group Name : TPG1Monitor Interval Time(sec): 600Volume I/O statistics ------------------------------------------------------- 11:23

Related topics• KTACTTPG, page 142• KTACTTPG, page 142• KTIMPORT, page 148• KTLOAD, page 150• KTQRYTPG, page 157• Format of tiering policy information

TIP:You can also update the disk configuration definition file by executing the KTIMPORT command withthe SCAN parameter specified, instead of executin

Reference scriptsRefer to the sample script KTDEMO05 for details on how to create scripts for changing the tieringpolicy of volumes back to the defaul

5 ISPF panelsThis chapter describes transition, operation methods, and displayed items of the ISPF panel in SmartManager for Mainframe.Panel relations

Figure 24 Panel relationships of Smart Manager for MainframeCommon items in the panelThis section describes the common items between the panels for Sm

About the action barThe action bar of the Smart Manager for Mainframe panel contains the Goto, Commands, and Helpmenus.GotoThe Goto pull-down menu dis

TablesRelationship between tiering policy levels and tiers in which data will be located ... 201Values that can be used to specify the new-pa

Figure 26 Commands pull-down menu (Tiering Policy Group Pool List panel)HelpThe Help pull-down menu displays the name of the Help panels that can be r

The following figure show an example of actions panels when / is specified to AC or COMMANDfield.About point-and-shoot fieldWhen you place the cursor

The following explains the actions that are executed when you select a point-and-shoot field.Table 10 Actions that are executed when you select a poin

• FieldThe following is a representative example of an action executed by selecting a point-and-shootfield.Action that is executedPoint-and-shoot fiel

Related topics• Highlighting available point-and-shoot fields, page 89About the display unitFor the panels that have a capacity or used capacity displ

Device Scan Scope panelIn this panel, you can scan a storage system volumes that are connected to a host. Specify a scantarget with an SMS storage gro

After scanning, press the Exit function key to create or update disk configuration definition files withthe following name, and save the configuration

DescriptionItemDisplays the type of errors.Type of errorException Message List panelThis pop-up window displays warnings and error messages of a reque

Related topics• Error Code Help panel , page 116Main panelThis section explains the Main panel and the areas in the panel.Main panel (common)The panel

Related topics• Installation Management area, page 119• Set Defaults area , page 119• Storage System List area, page 120• Policy CSV List area, page 1

Output items of the KTINSCHK command ... 17332Return codes generated by the KTSLEEP comm

DescriptionItemSelect the <Edit> point-and-shoot field to display the Edit Defaults pop-up window where you can edit basic settings.<Edit>

DescriptionItemSelect the <Scan> point-and-shoot field to go to the Device Scan Scope panel to scanstorage systems.<Scan>The action to be

DescriptionItemSelect the <Create> point-and-shoot field to display the Policy ID Entrypop-up window for creating tiering policy information CSV

DescriptionItemThe action to be executed for the selected tiering policy group.You can specify the following actions:• S: Goes to the Tiering Policy G

DescriptionItemDisplays the license name.• Smart Manager for MF: Smart Manager for Mainframe licenseIf a license key for Business Continuity Manager i

Pool Selection List panelThis panel displays a list of pools in a storage system.DescriptionItemSpecify the action to be executed for the selected poo

Current Relocation InformationDisplays the current relocation status and capacity and usage information for each tier.DescriptionItemDisplays the moni

DescriptionItemDisplays the expected number of migrated pages.ExpectedDisplays the migrated pages.MigratedBasic InformationDisplays the basic informat

DescriptionItemSpecify the action to be executed for the selected volume.You can specify the following actions:• V: Goes to the Tiering Policy Group V

The following figure shows the right-hand panel of the Tiering Policy Group Pool List panel:DescriptionItemSpecify the action to be executed for the s

PrefaceThis document describes how to use the following program product:- HP XP7 Smart Manager for MainframeHereafter, the above product is simply cal

Current Relocation InformationDisplays the current relocation status and the capacity and usage information for each tier.DescriptionItemDisplays the

DescriptionItemDisplays the expected number of migrated pages.ExpectedDisplays the migrated pages.MigratedBasic InformationDisplays the basic informat

Tiering Policy Group Summary panelThis panel displays the following information about a tiering policy group: capacity information, pagerelocation sta

DescriptionItemDisplays the number of volumes for which some pages in the volume are not assigned to the tiersspecified by tiering policy level due to

The following figure shows the right-hand panel of the Tiering Policy Group Volume List panel:DescriptionItemSpecify the action to be executed for the

DescriptionItemDisplays the amount of space used on each tier by the volume.Tier1, Tier2, Tier3Displays the distribution ratio (%) of the usage of eac

DescriptionItemDisplays the relocation status of the volume.• In range: All pages are assigned to the tiers specified by tiering policy level.• Out of

DescriptionItemSpecify the action to be executed for the selected volume.You can specify the following actions:• V: Goes to the Volume Status Detail p

Tiering Policy InformationDisplays the tiering policy of the current status in the storage system.DescriptionItemDisplays the relocation status of the

6 CLI commandsThis chapter describes the command functions that can be used in the Smart Manager for MainframeCLI.List of CLI CommandsThe CLI commands

Preface14

DescriptionCommand nameScans the operation-target volumes for Smart Manager for Mainframe to acquire theinformation necessary to identify the volumes,

CLI command coding formatThis section describes the CLI command coding format for each command type.REXX external routine coding formatREXX external r

Use the RC variable to acquire the return code of a TSO/E command in the REXX script.OS console command coding formatTo execute a CLI command categori

Return codesThe following table lists and describes the codes returned when the KTACTTPG command terminates.If the commands do not terminate normally,

• Tiering policy level: 0• New-page assignment tier: MIDDLE• Whether to execute tier relocation: YCommand typeREXX external routineFormatKTDCTDEV1MSG(

REXX variables that are updated by the KTDCTDEV command• All variables in the message structureRelated topics• Message structure, page 193• KTDEMO05 (

MeaningReturn codeThe command ended due to an invalid REXX variable structure.36An error occurred during writing of the REXX variables.40The command e

1PREFIX(prefix)1SN(serial-number)ParametersSTEM(stem-name-1)~<REXX prefix consisting of 64 or fewer characters>Specify the prefix (any value) of

REXX variables that are updated by the KTGETHDA command• All variables in the message structure• All variables in the host-discovered array index stru

Prerequisites• If the SCAN parameter is not specified, volumes to be defined as a tiering policy group must bedefined in the disk configuration defini

1 Overview of Smart Manager forMainframeThis chapter provides an overview of Smart Manager for Mainframe.About Smart Manager for MainframeSmart Manage

Return codesThe following table lists and describes the codes returned when the KTIMPORT command terminates.If the commands do not terminate normally,

• Loads the disk configuration definition file to the host-discovered array structure and host-discoveredarray index structure.Command typeREXX extern

MeaningReturn codeThe command ended due to an invalid parameter. The possible cause is asfollows:• The parameters were specified incorrectly.48The com

• TPG.VOL.n.SSID• TPG.VOL.n.TierLevel• TPG.VOL.n.TierRelocationRelated topics• Message structure, page 193• Host-discovered array index structure, pag

Return codesThe following table lists and describes the codes returned when the KTQRYDEV command terminates.If the commands do not terminate normally,

• LOCAL.SNnnnnn.POOLxx.NAME• LOCAL.SNnnnnn.POOLxx.Type• LOCAL.SNnnnnn.POOLxx.PageSize• LOCAL.SNnnnnn.POOLxx.Tier.0• LOCAL.SNnnnnn.POOLxx.Tier.n.Media•

FormatKTQRYRLC1STEM(stem-name-1)1MSG(stem-name-2)ParametersSTEM(stem-name-1)~<REXX prefix consisting of 64 or fewer characters>Specify the prefi

• In the host-discovered array structure, the following variables related to the Smart Tiers Z pool towhich the volumes in the specified tiering polic

MeaningReturn codeAn unsupported device was skipped.12An I/O error occurred.32The command ended due to an invalid REXX variable structure.36An error o

Command typeREXX external routineFormatKTQSTATS1STEM(stem-name-1)1MSG(stem-name-2)ParametersSTEM(stem-name-1)~<REXX prefix consisting of 64 or fewe

Figure 2 Locating data in a specified tier according to performance requirementsIf only Smart Tiers Z is being used, a storage administrator uses eith

REXX variables that are updated by the KTQSTATS command• All variables in the message structure• The following variables in the host-discovered array

1{FROM(nnnn)1TO(nnnn)|FROMVSN(volser)1TOVSN(volser)|STORGRP(SMS-storage-group-name)}[1ARRAYS(stem-name-3)]ParametersSTEM(stem-name-1)~<REXX prefix

• If information about the volumes in the detection range already exists in the host-discovered arraystructure specified for the STEM parameter, the e

• LOCAL.SNnnnnn.CUxx.CCAxx.Volser• LOCAL.SNnnnnn.CUxx.CCAxx.STORGRP (set only when the STORGRP parameter is specified)• LOCAL.SNnnnnn.CUxx.CCAxx.SSID•

Specify the prefix of the target REXX variable structure. If the host-discovered array structure hasbeen created by executing the KTSCAN command, spec

TIP:If the configuration file already exists when you execute the KTSTORE command, the existingconfiguration file information and the information stor

REXX variables saved in the configuration file by the KTSTORE command• If the disk configuration definition file is specified for saving the REXX vari

KTWTOMSGFunctionOutputs the specified message ID and message text to the console.Command typeREXX external routineFormatTo output a single-line messag

NoteA maximum of ten lines can be output in a multi-line message text.Return codesThe following table lists and describes the codes returned when the

Specify the processing type.• OPENEstablish an EMCS console interface for monitoring messages. When the command with theOPEN parameter specified ends

Figure 3 Tier management using Smart Manager for MainframeOverview of the Smart Manager for Mainframe functionalityThe functionality provided by Smart

MeaningReturn codeClose processing ended normally.6An invalid parameter was specified.8A system error occurred.9KTENVFunctionOutputs the program produ

DescriptionOutput itemPrefix of the license information datasetLicense info DSN prefix• LOGR: Event logs are output by using the system logger service

KTERCODEFunctionOutputs the information for the specified error code and the cause of the error to the TSO/E terminal.Command typeTSO/E commandFormatK

READYKTERCODE 6A13 Error details: The command could not be executed because a remote command was executed while the command device was not d

DescriptionOutput item• OK: There are no problems with registration of the user SVC.• FAULTY: There are problems with registration of the user SVC.Use

Directions The current setup is listed above. An unregistered profile is listed as N/A. The RACF settings are necessary in order

YKK001I KTINSCHK completed. RC=00,V/R=v.r.m-nn(zz),2013/04/15 09:56:30KTSLEEPFunctionSuspends the execution of the script for the specified period of

KTALCSVCFunctionUse this command to register or delete a user SVC.Command typeOS console commandFormatSTART1KTALCSVC[,PARM='{SVC-number|DELETE}&a

Command typeOS console commandFormatSTART1KTDSPENV[,PARM='[{SUMMARY|DETAIL}]']ParametersSUMMARY is assumed if the PARM part of the command w

START KTDSPENV,PARM='DETAIL'KTA403I HP XP7 Smart Manager for MainframeKTA400I Environment variables (v.r.m-nn(zz))KTA401I License info DSN p

TIP:There are two methods of operation for Smart Manager for Mainframe using ISPF panels and usingCLI commands. Use the method that suits the state of

• SAMEvent logs are output to a sequential dataset without using the system logger service.To remove the value of the environment variable LOGPUT, spe

7 Files used by Smart Manager forMainframeThis chapter describes the files used by Smart Manager for Mainframe.File naming conventions used by Smart M

The following table shows the maximum length and the permitted characters for items in the filenamesused by Smart Manager for Mainframe.Table 38 Maxim

Format of tiering policy information CSV filesThis section describes the format of tiering policy CSV files.Descriptive conventions of tiering policy

prefix.TPG.tiering-policy-group-ID is used as the name of a tiering policy groupdefinition file. The maximum length of a tiering policy group ID that

Value of the new-page assignment tier settingTieringpolicy levelDescriptionLOWMIDDLEHIGHIf LOW is set, Tier 2 is given higher prioritythan Tier 1.2>

Examples• Example of defining multiple volumes for different tiering policies#TYPE ,DEVICE,TPGID,TierLvl,Entry,RelocDEVN ,1101 ,TPG1 ,1DEVN ,110

Figure 28 Configuration example of tiering policy groupsThe following provides details about the tiering policy groups in the configuration example.Ti

Specification in the tiering policy information CSV file#TYPE ,DEVICE,TPGID,TierLvl,Entry,RelocSTORGRP,SG1 ,TPG1 ,2 ,HIGHDEVN ,1101 ,TPG1 ,

When changing the tiering policy back to the defaultKeep the record, but delete the tiering policy parameters.Before the change:#TYPE ,DEVICE,TPGID,T

Figure 5 Overview of tiering policiesA tiering policy can be specified by using a tiering policy information CSV file. In a tiering policyinformation

When deleting tiering policies assigned individually to volumes in the SMS storage group sothat they match the settings on the SMS storage groupThis e

When adding a volume that does not belong to the SMS storage groupAdd the record of the volume to be added to the tiering policy information CSV file.

Delete the record of the volume from the tiering policy information CSV file.Before the change:#TYPE ,DEVICE,TPGID,TierLvl,Entry,RelocSTORGRP,SG1 ,

8 REXX variable structuresThis chapter describes the REXX variable structures used by Smart Manager for Mainframe.List of REXX variable structuresREXX

REXX variable names and contentsThe following table lists and describes the REXX variables in the message structure. A REXX variablename is preceded b

DescriptionREXX variablenameInformation for each storage system is stored in lower-level REXX variables.n.Serial number of the scanned storage systemS

REXX variable names and contentsThe following table lists and describes the REXX variables in the host-discovered array structure. AREXX variable name

DescriptionREXX variable nameStorage system IDSSIDPool ID (decimal number)POOLIDVolume capacity (number of cylinders)CylsExternal volume information•

DescriptionREXX variable nameUpper-variable nameLOCAL.SNnnnnn.POOLxx.Pool nameNAMEPool type• DT: Smart Tiers Z pool• DP: Thin Provisioning Z pool• OTH

DescriptionREXX variable nameUsed tier capacityUsedUnit of the total tier capacity and used tier capacityUnitFree area ratio for new-page assignment (

Legal and notice information© Copyright 2014 Hewlett-Packard Development Company, L.P.Confidential computer software. Valid license from HP required f

Figure 6 When the tiering policy level of 1 is specified for a three-tier volumeIf the tiering policy level of 2 is specified for a volume that has th

Tiering policy group structureThe values to be set for the storage system for the volumes belonging to a tiering policy group arestored in the tiering

DescriptionREXX variable nameWhether to execute tier relocation• Y: Executes tier relocation.• N (other than Y): Does not execute tier relocation.Tier

REXX variable structures202

9 Collecting trace information and logsThis chapter describes collecting trace information and logs for Smart Manager for Mainframe.Information that c

Procedure1. Log on to the TSO/E terminal.2. Enter the following commands.• To output an ABEND dump to the spool:ALLOC DD(SYSABEND) SYSOUT(SYSOUT-class

Collecting event logsThis section describes how to collect event logs.How to collect event logsTwo methods are available for collecting event logs. Us

Figure 29 overview of event log outputFor details about log streams, see the manual MVS Programming: Assembler Services Reference.Related topics• Coll

Related topics• Setting LOGR couple data sets, page 207• Defining the SMS for the system logger service, page 207• Defining a log stream, page 207• Se

Related topics• Parameters specified when a log stream is defined, page 208Setting access privileges for system logger resourcesIf the System Authoriz

to form the log stream name. If a system name starts with a number, the last five characters usedfor the log stream name must be unique within the sys

For the tiers with a specified tiering policy level, the priority assigned to new pages is determined bythe combination of the values specified for th

Specify the name of the SMS storage class used for allocating a log dataset. Specify this para-meter when using an SMS definition.AUTODELETE(YES)Speci

Procedure• If a log dataset is full, execution of a CLI command will continue, but event log data will no longerbe output. Use either of the following

Procedure1. Enter the FORCE IXGLOGR,ARM command to stop the system logger service.2. Enter the S IXGLOGRS command to restart the system logger service

Estimating the dataset (OUTLOG) to which logs are output from the log streamEstimate the disk capacity based on the amount of offloaded event log data

Related topics• Control statements for the event log data output tool, page 214• Output format of the event log data output tool, page 215Control stat

• Each control statement must be completely specified on one line. A control statement cannot extendover two or more lines.Control statement examplesT

Procedure1. Estimate the log dataset capacity.Estimate the amount of log data based on the frequency at which CLI commands are issued andthe frequency

Writing to a log dataset without using the system logger serviceThis subsection describes how to write data to a log dataset without using the system

Disk space requirements for the event log when the system logger service is notusedThe following table shows the amount of log data when the event log

Procedure1. When you start using ISPF, delete the ISPF log information from the ISPF log dataset.2. When you perform an operation in the Smart Manager

CAUTION:The following volumes are not supported:• Volumes of a remote storage system• Volumes without a host device number assignedPrerequisite progra

3. In the panel showing SYSLOG, enter the SDSF command to extract SYSLOG data for the desiredperiod to the dataset you created in step 1.To extract in

5. Execute the CLI command-execution log output procedure to extract the CLI command-executionlog to the dataset you created in step 2.If the procedur

Collecting trace information and logs222

10 Support and other resourcesNumerous support options are available.Contacting HPHP technical supportFor worldwide technical support information, see

ConventionsThis guide follows the conventions shown in Table 56 to refer to HP XP7 products.Table 56 Product reference conventionsFull name or meaning

Full name or meaningProduct referenceLogical DEViceLDEVLogical RECord LengthLRECLMissing Interrupt HandlerMIHOperating SystemOSResource Access Control

Support and other resources226

A XML document type definitions forconfiguration filesThis appendix describes the XML document type definitions for configuration files used by SmartM

SSID CDATA#REQUIRED CCA CDATA#REQUIRED POOLID CDATA#IMPLIED Cyls CDATA#IMPLIED External (Y|N)#IMPLIED>The following

DescriptionAttribute nameUsed by the system.NGDADIDEnableSerial number of the scanned storage systemSerialNumModel of the storage systemModelMicrocode

Figure 9 System configuration of Smart Manager for MainframeCAUTION:The storage system must be connected to the z/OS host.About files used by Smart Ma

DescriptionAttribute namePool type information:DT: Smart Tiers Z poolDP: Thin Provisioning Z poolOTHER: Other poolsTypePage sizePageSizePoolTier eleme

Volser CDATA#IMPLIED STORGRP CDATA#IMPLIED>The following lists and describes the attributes of this element.DescriptionAttribute nameDevice n

DescriptionAttribute nameTiering policy levelLevelNew-page assignment tier• HIGH: The new page is assigned from the higher tier of tiers set in the ti

Example of a disk configuration definition file that is generated<?xml version="1.0" encoding="ebcdic-cp-us"?><APIInfo Le

XML document type definitions for configuration files234

B Commands that can be used in the ISPFpanelsThis appendix describes the commands that can be used in the ISPF panels of Smart Manager forMainframe.ER

RESETCancels the filter.TIP:The filtered results will be sorted in ascending order.Specification examples• Character string specificationSpecify as fo

ParametersIf you omit the parameter, the Find Options panel appears to allow you to enter parameter values.search-stringSpecifies the search string.Re

TIP:If the FIND command has not been executed, the Find Options panel appears.SELECTFunctionSets or cancels an action in the AC field of a line that s

SEL Volser VOL* D• Range specificationSpecify as follows to cancel the actions set in the AC fields for the volumes having device numbersfrom 0F10 to

A file that defines a tiering policy group. This file is created by importing a tiering policy informationCSV file and a disk configuration definition

TIP:If you execute the SORT command when the list is filtered, the filtered information is sorted.How to specify the search or filter conditions in IS

Yes: Can be specified--: Cannot be specified#If you want to specify a string in the command line, specify it as follows:• To specify a string that con

Commands that can be used in the ISPF panels242

C Sample scriptsThis appendix provides sample scripts for Smart Manager for Mainframe.List of sample scriptsSample scripts for each CLI command are st

Relevant REXX variablestructureDD name specification or parameterCommand to beexecutedPurposeSample scriptnameHost-discovered array structureTiering p

/* DEVN 0000 00FF */ /* VOLSER VOL001 VOL009

SAY 'Executing KTSCAN STORGRP= 'scan_from; CALL KTSCAN "STEM(DEMO_STEM.) MSG(DEMO_MSG.) ARRAYS

KTDEMO01 (Display the contents of the disk configuration definition file)/* REXX */

/* Display storage system information. */ SAY '';

hex_CU = D2X(pos_CU-1, 2); sym_CU = 'CU'||hex_CU;

Figure 11 workflow for using Smart Manager for MainframeRelated topics• Workflow for when defining and checking tiering policy groups when using the I

ARG mediaTypeValue; IF mediaTypeValue = '0000' THEN

PARSE UPPER ARG @options PARSE UPPER VALUE @options 'POLICY()' with 'POLICY(&a

/* displays information in the TPG configuration dataset. */ /*

/* * Generate symbol which is part of the DSK structure REXX variable

/* displays storage information of the target volume's DKC.*/ /*

SAY 'Pool'; SAY ' ID, Type,Pool Name ,&ap

*/ printErrorMessage: procedure expose DEMO_MSG.

/* 1) Device number of target (want to reset tiering policy to */ /* default) volume is specified in the DEVN() option value

/* */ /*********************************************************************

IF RESULT /= 0 THEN DO CALL printErrorMessage "KTACTTPG" RESULT;

Overview of Smart Manager for Mainframe26

/* * Check option values in the argument.

* Get information values about the volume * from DSK structure REXX variables.

/* 1) TPG and DSK configuration dataset is already created. */ /* 2) The TPG and DSK dataset name's prefix is PREFIX() option

SAY ' POOL'; SAY ' Devn,Volser,SN ,CU,CCA, ID,TLv,Cylinders,&apos

DO x = 1 to DEMO_MSG.0; SAY "Severity = " || DEMO_MSG.x.Severity;

*/ CALL KTLOAD "STEM(DEMO_STEM.) MSG(DEMO_MSG.)",

*/ val_Devn = DEMO_STEM.LOCAL.sym_SN.sym_CU.sym_CCA.Devn;

TierRangePageCt = TierRangePageCt , + DEMO_STEM.LOCAL.sym_SN.sym_CU.sym_CCA.Tier.t.Used;

IF TierRangeUsed >= TierRangeCapacity - TierRangeReserved THEN relocateStatus = 'capacity shortage ';

/* * Display pool tier information.

2 Installation and setupThis chapter describes procedures for installing and setting up Smart Manager for Mainframe.Overview of installation and setup

/* Find next pool from POOLMap. */ pos_POOLID = POS('1', val_POOLMap, pos_POOLID+1);

/* All Rights Reserved. Copyright (C) 2013, Hitachi, Ltd. */ /*

/* * Display header information.

/DEMO_STEM.TPG.VOL.IO.Interval; IF TRUNC(val_iops.j) /= val_iops.j THEN DO;

Sample scripts274

D Upgrading Smart Manager for MainframeThis appendix describes how to upgrade Smart Manager for Mainframe.Workflow for upgrading Smart Manager for Mai

Preparation for upgrading Smart Manager for MainframeThe following describes the tasks that must be performed before upgrading Smart Manager forMainfr

TIP:When you back up and rename files, make sure that you change only the prefix of the file names.Because a file name contains information such as ti

2. If this version is older than the prerequisite user SVC version of Smart Manager for Mainframeafter upgrading, disable (comment out) the SYMDEF sta

3. If the user SVC has been registered by using the IEASVCxx parmlib member, remove the linkageof the HPQYLPAT load library for LPALIB. (This step is

If you are not using SMP/E for the installation, you do not need to create a backup in the distri-bution library.Related topics• Installing Smart Mana

Upgrading Smart Manager for Mainframe280

E Modifying the sample JCLThis appendix provides examples of how to modify the sample JCL.Values used in the sample JCL modification examplesPrefixes

//*********************************************************************//*//* All Rights Reserved. Copyright (C) 2013, 2014, Hitachi, Ltd.//*//*******

// DCB=(DSORG=PS,RECFM=FB,LRECL=80,BLKSIZE=3120),// DISP=(,CATLG,DELETE)//F3 DD DSN=&PFX..&VRM..F3.XMIT,//

//* All Rights Reserved. Copyright (C) 2013, 2014, Hitachi, Ltd.//*//*********************************************************************//*//* This

RECEIVE INDSN(CHKLnnn.F5.XMIT) DSNAME('HP.CHKLnnn.F5') + -----(24) VOLUME(#tso01)

// SET IPFX=HP Prefix of distribution data sets -----(4)// SET IVRM=CHKLnnn Version of distribution data sets// SET TPFX=HP

COPYMOD OUTDD=OUTF2,INDD=INF2 COPYMOD OUTDD=OUTF3,INDD=INF3 COPY OUTDD=OUTF4,INDD=INF4 COPY OUTDD=OUTF5,INDD=INF5 COPY O

NAME(HPQKT.SMPCSI.CSI) - -----(7) FREESPACE(10 5) - KEYS(24 0)

// DISP=(NEW,CATLG,DELETE),// UNIT=SYSDA,VOL=SER=&VSN,// SPACE=(CYL,(1,5)),// DCB=(BLKSIZE=32720,L

Transferring the load module to a host machineTransfer the load module for Smart Manager for Mainframe provided on the installation media to ahost mac

// DISP=(NEW,CATLG,DELETE),// UNIT=3390,VOL=SER=&TVSN,// SPACE=(TRK,(75,1,20)),// DCB=(BLKSIZE=614

//HPQKEXED DD DSN=&PFX..&VRM..HPQKEXED, EXEC(F) LIBRARY// DISP=(NEW,CATLG,DELETE),// UNIT=3390,VOL=SER=&DVSN

//*//*********************************************************************//*//* This JCL executes SMP/E DDDEF for the distribution libraries and//* t

(DLIB1,HPQKT.SMPCSI.CSI,DLIB), -----(5) (TGT1,HPQKT.SMPCSI.CSI,TARGET)) -----(6)

DA(HPQKT.Vnnnnnn.HPQKLPAT) -----(23) OLD.ADD DDDEF(HPQKPRCT) DA(HPQKT.Vnnnnnn.HPQKPRCT)

HPQKT3RC (SMP/E RECEIVE processing)The method for modifying HPQKT3RC, which performs SMP/E RECEIVE processing, is explainedbelow.The following numbers

// SPACE=(3120,(0364,0380,500)), // DCB=(RECFM=FB,LRECL=80,BLKSIZE=3120) //SMPWRK2

//HPQKT4AP JOB (ACCT#),'APPLY SMART MGR Z', -----(1)// REGION=0M,CLASS=A, -----(

//GLOBAL DD DISP=SHR,DSN=&PFX..SMPCSI.CSI //TGT1 DD DISP=SHR,DSN=&PFX..SMPCSI.CSI //

//* //* 3) Submit the JCL and make sure that no error occurs. //* 4) Remov

ContentsPreface ... 131 Overview of Smart Manager for Mainf

3. Edit the JCLs transferred in accordance with your installation environment.Details are provided at the beginning of each JCL.4. Create datasets use

Modifying the sample JCL300

F Command syntax descriptionsThis chapter describes the command syntax conventions used in this document.Command syntax descriptionsThe following tabl

ConventionSymbolIndicates a syntax element that must be used when specifying the item.< >Indicates a default value used by the system if the ite

GlossaryThis glossary describes the terms used in this manual.AC field An entry field used to specify an action in an ISPF panel. The action specified

event log The log in which operations of Smart Manager for Mainframe are logged. Thelogged data includes messages, information about parameters used w

SMP/E An IBM installer.SMS storage group An aggregate of the volumes that constitute the storage pool managed by DFSMS(storage management environment

Glossary306

IndexAAC field, 303ALLOUPLD (sample JCL), 281ARRAYS parameter [KTSCAN command], 161ARRAYS parameter [KTSTORE command], 164attributes of the distributi

HPQKT1AL [sample JCL], 289HPQKT2DF [sample JCL], 291HPQKT3RC [sample JCL], 295HPQKT4AP [sample JCL], 296HPQKT5AC [sample JCL], 298Iinstallation and se

PREFIX parameter [KTGETHDA command], 147PREFIX parameter [KTIMPORT command], 149PREFIX parameter [KTLOAD command], 151PREFIX parameter [KTSTORE comman

PostrequisitesPerform either of the following:• Performing an installation using SMP/E• Installing directly from the provided datasets in the target l

tiering policy, 305applying (CLI commands), 98applying (ISPF panels), 65changing (CLI commands), 103changing (ISPF panels), 81verifying (CLI commands)

8. Re-execute HPQKT4AP after the CHECK operand is deleted.SMP/E APPLY is executed and the provided datasets are installed in the target library.Run th

Library datasets to be registered after the installationThis section describes the attributes of the library datasets (target libraries) to be registe

Registering the load library for LINKLIB and the KTQRYSMS command forauthenticationTo register the load library for LINKLIB and the KTQRYSMS command f

Postrequisites• Setting RACF security for CLI commandsRelated topics• Example of dynamically linking the LINKLIB load library to LNKLST, page 35• Sett

SETPROG LNKLST,UNDEFINE,NAME=LNKLST99For details on the SETPROG command, see the manual MVS System Commands.Setting RACF security for CLI commandsTo u

TIP:Users can use the following commands without access permissions:KTCONMSG, KTENV, KTERCODE, KTGETHDA, KTINSCHK, KTLOAD, KTSLEEP, KTSTORE,KTWTOMSGPo

Postrequisites• Registering a user SVCRelated topics• Settings required for using CLI commands (registration for authentication), page 33• Registering

CAUTION:• If you used the KTALCSVC command to register a user SVC while Smart Manager for Mainframewas running, the execution of the CLI command conti

Workflow for registering a license ... 47Creating a license infor

4. Define the following SVCPARM statement in the IEASVCxx parmlib member:SVCPARM SVC-number,REPLACE,TYPE(3),EPNAME(JYUASVC),APF(NO),NPRMPT(NO),AR(NO)F

Related topics• Setting the operating environment by using environment variables, page 41• Setting the operating environment by using system symbols,

Procedure1. Execute the following KTSETENV command.START KTSETENV,PARM='parameter=parameter-value' 2. Use the KTDSPENV command as follows to

TIP:The license (name of the license information dataset) for Smart Manager for Mainframe takes effectwhen the KTLOAD command is first executed after

2. After an IPL is performed again, use the KTDSPENV command to confirm that the system symbolshave been specified correctly.START KTDSPENV,PARM=&apos

Settings required to use Smart Manager for Mainframe on theISPF panelYou need to execute the KTSTART command in the ISPF panel to use Smart Manager fo

CAUTION:To concatenate a dataset to libraries, make sure that the attributes of the target libraries are the sameas the attributes of the dataset. For

Sample REXX scriptWhile ISPF is running, you can execute the following REXX script to concatenate the libraries to theDD names (SYSEXEC, ISPPLIB, ISPM

• Registering a license by entering a license key, page 50Creating a license information datasetCreate a license information dataset for installing a

Related topics• Setting the operating environment by using environment variables, page 41• Setting the operating environment by using system symbols,

Customizing the ISPF panels ... 88Setting the comm

2. Transfer the license key file to the host machine.Use the following format to transfer the license key file to the license key dataset:• ASCII mode

The following figure provides the procedure for registering a license by directly entering a licensekey.Figure 17 Procedure for registering a license

Postrequisites• Verifying the setup informationRelated topics• Creating a license information dataset, page 48• Verifying the setup information, page

/* // For details about the example of the command outpu

Backing up Smart Manager for Mainframe to the distribution libraryIf SMP/E was used when installing Smart Manager for Mainframe in the target library

BLKSIZE(bytes)LRECL(bytes)RECFMDSORGLibrary type (DD name#)6,16080FBPOISPF message library(HPQKMSGD)6,16080FBPOISPF table library(HPQKTABD)#The DD nam

TIP:• For details on the YKINSCHK command, see the HP XP7 for Business Continuity Manager SoftwareReference Guide.• For details on how to delete the u

Prerequisite user SVC versions for Smart Manager forMainframeThe following table shows the prerequisite user SVC versions for Smart Manager for Mainfr

Installation and setup58

3 Smart Manager for Mainframe operationswhen using the ISPF panelThis chapter describes how to use the ISPF panels to operate Smart Manager for Mainfr

Volume Status Detail panel ... 1376 CLI commands .

Figure 18 Procedure for defining and verifying a tiering policy group (ISPF panels)Related topics• Overview of files used by Smart Manager for Mainfra

Starting Smart Manager for Mainframe and displaying themain panelThis section describes how to start Smart Manager for Mainframe and display the main

3. Enter values for the items, and then press Enter.The setting is saved.TIP:In each panel, press the DispConf function key (F17) to display the basic

3. Do either of the following:• To specify an SMS storage group to be scanned:Enter a slash (/) in the Storage Group field and specify the name of the

Procedure1. In the main panel, select the Policy CSV List 'Policy' point-and-shoot field.The Policy CSV List area appears.2. Select the <

2. Enter a slash (/) in the AC field for the tiering policy information CSV file.The Policy CSV List Actions panel appears.3. Enter 4 in the entry fie

Verification after scanning storage systems when using the ISPFpanelThe following describes how to verify information about the volumes and pools afte

5. Enter 1 in the entry field or select the Volume Status Detail 'V' point-and-shoot field.The Volume Status Detail panel displays details a

3. Enter 2 in the entry field or select the Pool Selection 'P' point-and-shoot field.The Pool Selection List panel displays a list of pools

5. Enter 1 in the entry field or select the Pool Status Detail 'P' point-and-shoot field.The Pool Status Detail panel displays details about

Information that can be used for troubleshooting ... 203Collecting trace informa

Procedure1. In the main panel, select the Tiering Policy Group List 'TPG' point-and-shoot field.The Tiering Policy Group List area appears.2

3. Enter 1 in the entry field or select the Summary 'S' point-and-shoot field.The Tiering Policy Group Summary panel displays storage system

3. Enter 4 in the entry field or select the Storage Groups 'SG' point-and-shoot field.The Select Storage Group List panel appears.4. Select

2. Enter a slash (/) in the COMMAND field for the tiering policy group whose information you wantto view.The Tiering Policy Group List Actions panel a

6. Enter 1 in the entry field or select the TPG Volume Status Detail 'V' point-and-shoot field.The Tiering Policy Group Volume Status Detail

3. Enter 6 in the entry field or select the Pools 'P' point-and-shoot field.The Select Pool List panel appears.4. Select 1 to display a list

6. Enter 1 in the entry field or select the TPG Pool Status Detail 'P' point-and-shoot field.The Tiering Policy Group Pool Status Detail pan

Procedure1. In the main panel, select the Tiering Policy Group List 'TPG' point-and-shoot field.The Tiering Policy Group List area appears.2

5. To check the tiering policies for a specific volume, enter a slash (/) in the AC field.The Tiering Policy Group Volume List Actions panel appears.T

Procedure1. In the main panel, select the Tiering Policy Group List 'TPG' point-and-shoot field.The Tiering Policy Group List area appears.2

HostAddressedDisk element ... 230Elements in the tiering p

4. To check the volumes for each relocation status, select the In range, Out of range, or Shortagepoint-and-shoot fields.The Tiering Policy Group Volu

3. Enter 1 in the entry field or select the Summary 'S' point-and-shoot field.In the Tiering Policy Group Summary panel, the number of pools

2. In the main panel, select the Policy CSV List 'Policy' point-and-shoot field to update the definitionof the tiering policy group.The Poli

2. If the volume to be added has not been scanned, scan that volume to update the disk configurationdefinition file.Information about the volume to be

TIP:You can change the tiering policy of the volume to be deleted back to the default by changing thepanel display from the Storage System List area t

4. Modify the contents of the tiering policy information CSV file.5. Press the Exit function key.The modifications are saved, and the Policy CSV List

2. Specify the filter conditions.The following is an example specification. The displayed items vary depending on the panel thatcalled this panel.3. P

Positioning the cursor at a specific line in a sorted fieldTo position the cursor at a specific line in a sorted field, use the Locate Options panel t

2. Specify the AC fields for which the action is to be set or canceled by specifying the target fields,the condition character string for the fields,

Procedure1. Enter PFSHOW TAILOR in the command line of the ISPF panel.The ISPF Settings panel appears.2. Enter 1 (12) or 2 (24) in the Number of keys

HPQKT4AP (creating target libraries) ... 296HPQKT5AC (creating d

Smart Manager for Mainframe operations when using the ISPF panel90

4 Smart Manager for Mainframe operationswhen using the CLIThis chapter describes how to use CLI commands to operate Smart Manager for Mainframe.Defini

Figure 19 Workflow for defining and verifying a tiering policy group (CLI commands)Related topics• Overview of files used by Smart Manager for Mainfra

Checking volume information when using the CLI commandsBefore defining a tiering policy group, acquire volume information from the storage system by e

Postrequisites• Scanning the storage systemRelated topics• Scanning the storage system when using the CLI commands, page 94• KTQRYDEV, page 153• KTDEM

TIP:If the disk configuration changes significantly after the scan (for example, because the storage systemis replaced or device numbers of volumes ch

• KTDEMO00 (Create a disk configuration definition file), page 244• KTDEMO01 (Display the contents of the disk configuration definition file), page 24

Figure 22 Defining tiering policy groups (CLI commands)Prerequisites• Scanning the storage system• Creating a tiering policy information CSV file• Var

Example 2:The code in this example imports a tiering policy information CSV file whose policy ID is POLICY1,and creates a disk configuration definitio

Procedure1. Execute the KTLOAD command.Target volume information and information about the tiering policies defined in configurationfiles is loaded fr