ELS 7.1 Syntax Quick Reference - Oracle · iv ELS 7.1 Syntax Quick Reference • October 2010...

Submit comments about this document by clicking the Feedback [+] link at: http://docs.sun.com

StorageTek Enterprise Library Software

Syntax Quick Reference

Version 7.1

October 2010Revision AA

ii October 2010 Revision AA

ELS 7.0 Syntax QuickReference

Copyright © 2009, 2010, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this is software or related software documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications which may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. UNIX is a registered trademark licensed through X/Open Company, Ltd.

This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

Revision AA iii

Contents

Preface xi

Related Documentation xii

Documentation, Support, and Training xiii

Oracle Welcomes Your Comments xiii

Additional Information xiv

1. SMC Commands and Control Statements 1

ALLOCDef 2

ALLOCJob 3

CMDDef 4

COMMtest 5

Display DRive 6

Display Volume 7

DRIVemap 8

Help 9

HTTP 10

IDAX 11

LIst 12

LOG 13

MONitor 14

MOUNTDef 15

MSGDef 16

MSGJob 17

POLicy 18

READ 19

iv ELS 7.1 Syntax Quick Reference • October 2010 Revision AA

RESYNChronize 19

Route 20

SERVer 21

SIMulate 22

SMSDef 23

STORMNGR 24

TAPEPlex 25

TCPip 26

TRace 27

TREQDef 28

TAPEREQ Control Statement 29

UEXit 30

UNITAttr 31

USERMsg 32

2. HSC and VTCS Commands and Control Statements 33

ACTIvities 34

ACTMVCGN 34

ARCHive 35

AUDit 36

BACKup 37

CANcel 37

CAPPref 38

CDs 38

CDSDAta 39

CDSDEF 39

CLean 40

COMMPath 41

CONFIg 42

CONFIg GLOBAL Statement 43

CONFIg RECLAIM Statement 43

CONFIg VTSS Statement 44

CONFIg RTD Statement 44

CONFIg VTD Statement 44

Revision AA Contents v

CONFIg CLUSTER Statement 44

CONFIg CLINK Statement 44

CONFIg HOST Statement 45

CONFIg TAPEPLEX Statement 45

CONSolid 46

DEComp 46

DELETSCR 47

DIRBLD 47

DISMount 48

Display Acs 48

Display ACTive 49

Display ALl 49

Display Cap 50

Display CDS 50

Display CLInk 51

Display CLUster 51

Display CMD 52

Display COMMPath 52

Display CONFIG 53

Display DRives 53

Display DRIVE_INFO 54

Display EXceptns 55

Display LMUPDEF 55

Display LOCKs 56

Display Lsm 56

Display Message 57

Display MGMTDEF 57

Display MIGrate 58

Display MNTD 58

Display MONitor 59

Display MVC 59

Display MVCPool 60

Display OPTion 60

vi ELS 7.1 Syntax Quick Reference • October 2010 Revision AA

Display PATH 61

Display Queue 61

Display REPlicat 62

Display Requests 62

Display RTD 63

Display SCRatch 63

Display SEN 64

Display SERVER 64

Display SRVlev 65

Display Status 65

Display STORCLas 66

Display STORMNGR 66

Display TASKs 67

Display THReshld 67

Display Volser 68

Display VOLUME_INFO 68

Display VSCRatch 69

Display VTD 69

Display VTSS 70

Display VTV 70

DRAin 71

DRTEST CREATE 72

DRTEST PRIMEprd 73

DRTEST RESET 74

DRTEST START 74

DRTEST STOP 75

EEXPORT 76

EJect 77

ENter 78

EXECParm 78

EXPORT 79

FMTLOG 80

IMPORT 81

Revision AA Contents vii

INITialize 82

INVENTRY 83

LIBGen 83

LMUPDEF 84

LMUPATH Control Statement 84

LOGUTIL 85

LOGUTIL FOR_LOSTMVC Statement 85

LOGUTIL GENAUDIT Statement 86

LOGUTIL LOCATE_VTV 86

LOGUTIL UNDELETE Statement 86

MERGEcds 87

SLSMERGE Control Statement 87

MERGMFST 88

MGMTDEF 88

MGMTclas Control Statement 89

MIGRSEL Control Statement 90

MIGRVTV Control Statement 90

MVCATTR Control Statement 90

STORclas Control Statement 91

STORLST Control Statement 91

STORSEL Control Statement 91

VTSSLST Control Statement 92

VTSSSEL Control Statement 92

MIGrate 93

Format 1 93

Format 2 93

MNTD 94

MODify 95

Mount 96

MOVe 97

MVCDRain 98

MVCMAINT 99

MVCPLRPT 100

viii ELS 7.1 Syntax Quick Reference • October 2010 Revision AA

MVCRPt 101

OFFload LOGFILE 101

OPTION TITLE Control Statement 102

OPTion 103

RECall 104

RECLaim 105

RECONcil 106

RECOVer 106

RELease 107

REPLaceall 107

RESTore 108

RTV Utility 108

SCRAtch 109

SCREdist 109

SENter 110

SET CLNPRFX 110

SET COMPRFX 111

SET DRVHOST 111

SET EJCTPAS 112

SET FREEZE 112

SET HOSTID 113

SET HSCLEVel 113

SET LOGFILE 114

SET MAJNAME 114

SET MIGOPT 115

SET NEWHOST 115

SET RMM 116

SET SCRLABL 116

SET SLIDRIVS 117

SET SLISTATN 117

SET SMF 118

SET TAPEPlex 118

SET TCHNIQE 119

Revision AA Contents ix

SET VAULT 120

SET VAULTVOL 120

SET VOLPARM 121

POOLPARM Control Statement 122

VOLPARM Control Statement 122

SRVlev 123

STOPMN 123

SWitch 124

TRace 124

TRACELKP 125

UEXIT 125

UNSCratch 126

UNSElect 126

Vary 127

VIew 128

VOLPCONV 129

VOLRpt 130

VTVMAINT 131

VTVRPt BASIC 132

VTVRPt COPIES 132

Warn 133

Revision AA xi

Preface

Oracle’s StorageTek Enterprise Library Software (ELS) is a solution consisting of the following base software:

■ Oracle’s StorageTek Storage Management Component (SMC) (includes the product formerly known as StorageTek HTTP Server)

■ Oracle’s StorageTek Host Software Component (HSC)

■ Oracle’s StorageTek Virtual Tape Control Software (VTCS)

■ Oracle’s StorageTek Concurrent Disaster Recovery Test (CDRT)

Additionally, the following software is provided with the ELS package:

■ Oracle’s StorageTek Library Content Manager (LCM). LCM includes an enhanced version of the product formerly known as Offsite Vault Feature.

■ Oracle’s StorageTek Client System Component for MVS Environments (MVS/CSC)

■ Oracle’s StorageTek LibraryStation

This publication provides syntax for commands, control statements, and utilities provided by ELS. It is intended for storage administrators, system programmers and operators responsible for configuring and maintaining ELS.

To perform the tasks described in this publication, you should already understand the following:

■ z/OS operating system■ JES2 or JES3■ Enterprise Library Software (ELS)

xii ELS 7.1 Syntax Quick Reference • October 2010 Revision AA

Related DocumentationThe following list contains the names of publications that provide additional information about ELS.

The documentation is available online at:

http://docs.sun.com

StorageTek Enterprise Library Software (ELS)■ Introducing ELS■ Installing ELS■ ELS Command, Control Statement, and Utility Reference■ ELS Messages and Codes■ ELS Programming Reference■ ELS Legacy Interfaces Reference■ Configuring HSC and VTCS■ Managing HSC and VTCS■ Configuring and Managing SMC■ ELS Disaster Recovery and Offsite Data Management Guide

StorageTek Library Content Manager (LCM)■ LCM User’s Guide■ LCM Messages and Codes■ LCM Quick Reference

StorageTek Client System Component for MVS Environments (MVS/CSC)■ MVS/CSC Configuration Guide■ MVS/CSC Messages and Codes Guide■ MVS/CSC Operator’s Guide ■ MVS/CSC Syntax Quick Reference■ MVS/CSC System Programmer’s Guide

StorageTek LibraryStation■ LibraryStation Configuration and Administration Guide■ LibraryStation Syntax Quick Reference

http://docs.sun.com

Revision AA Preface xiii

Documentation, Support, and Training

Oracle Welcomes Your CommentsOracle is interested in improving its documentation and welcomes your comments and suggestions. Submit your comments by clicking the Feedback link at:

http://docs.sun.com

Function URL

Oracle Home http://oracle.com

Documentation http://docs.sun.com

Support http://www.sun.com/support

Training http://www.oracle.com/global/us/education/sun_select_country.html

http://docs.sun.com

http://www.sun.com/support

http://docs.sun.com

http://www.oracle.com/global/us/education/sun_select_country.html

http://oracle.com

xiv ELS 7.1 Syntax Quick Reference • October 2010 Revision AA

Additional Information

Customer-initiated Maintenance Customer-initiated maintenance begins with a telephone call from you to Oracle StorageTek Support. You receive immediate attention from qualified Oracle personnel, who record problem information and respond with the appropriate level of support.

To contact Oracle StorageTek Support about a problem:

1. Use the telephone and call:

☎ 800.872.4786 (1.800.USA.4SUN) (inside the United States)

☎ 800.722.4786 (Canada)

For international locations:

http://www.sun.com/contact/support.jsp

2. Describe the problem to the call taker. The call taker will ask several questions and will either route your call to or dispatch a support representative.

If you have the following information when you place a service call, the process will be much easier:

Account name

Site location number

Contact name

Telephone number

Equipment model number

Device address

Device serial number (if known)

Urgency of problem

Fault Symptom Code (FSC)

Problem description

http://www.sun.com/contact/support.jsp

Revision AA Preface xv

Conventions for Reader Usability

Typographic

Some JCL examples in this guide include italic type. Italic type is used to indicate a variable. You must substitute an actual value for these variables.

The use of mixed upper and lower case characters for commands, control statements, and parameters indicates that lower case letters may be omitted to form abbreviations. For example, you may simply enter POL when executing the POLicy command.

Syntax Flow Diagrams

Syntax flow diagramming conventions include the following:

Flow Lines

Syntax diagrams consist of a horizontal base line, horizontal and vertical branch lines, and the text for a command, control statement, macro, or utility. Diagrams are read left to right, and top to bottom. Arrows indicate flow and direction.

Single Required Choice

Branch lines (without repeat arrows) indicate that a single choice must be made. If one of the items to choose from is positioned on the baseline of the diagram, one item must be selected.

COMMAND/MACRO/UTILITY Item 1Item 2Item 3

Item 1Item 2Item 3

xvi ELS 7.1 Syntax Quick Reference • October 2010 Revision AA

Single Optional Choice

If the first item is positioned on the line below the baseline, one item may be optionally selected.

Defaults

Default values and parameters appear above the baseline.

Some keyword parameters provide a choice of values in a stack. When the stack contains a default value, the keyword and the value choices are placed below the base line to indicate that they are optional, and the default value appears above the keyword line.

Repeat Symbol

A repeat symbol indicates that more than one choice can be made or that a single choice can be made more than once. The following example indicates that a comma is required as the repeat delimiter.

Item 1Item 2Item 3

Default

KeywordValue3

Default ValueValue2

,variable

Revision AA Preface xvii

Keywords

All command keywords are shown in all upper case or in mixed case. When commands are not case sensitive, mixed case implies that the lowercase letters may be omitted to form an abbreviation.

Variables

Italic type is used to indicate a variable.

Alternatives

A bar ( | ) is used to separate alternative parameter values.

Optional

Brackets [ ] are used to indicate that a command parameter is optional.

Delimiters

If a comma (,), a semicolon (;), or other delimiter is shown with an element of the syntax diagram, it must be entered as part of the statement.

Ranges

An inclusive range is indicated by a pair of elements of the same length and data type, joined by a dash. The first element must be strictly less than the second element.

A hexadecimal range consists of a pair of hexadecimal numbers (for example, 0A2-0AD, or 000-0FC).

A decimal range consists of a pair of decimal numbers (i.e., 1-9, or 010-094). Leading zeros are not required. The decimal portion is referred to as an incremental range. The character positions of the incremental portion of both range elements must match, and the non incremental characters of the first element must be identical to those of the second element.

A numeric VOLSER range (vol-range) consists of a pair of VOLSER elements containing a decimal numeric portion of 1 to 6 digits (for example, ABC012-ABC025, or X123CB-X277CB). The decimal portion is referred to as an incremental range. The following additional restrictions apply:

■ The character positions of the incremental portion of both range elements must match.

■ The non incremental characters of the first element must be identical to those of the second element.

■ You cannot increment two portions of a range element. If 111AAA is the first element, you cannot specify 112AAB for the second element.

xviii ELS 7.1 Syntax Quick Reference • October 2010 Revision AA

■ If a VOLSER range contains more than one decimal portion, any portion is valid as the incremental range. For example:

An alphabetic VOLSER range (vol-range) consists of a pair of VOLSER elements containing an incremental portion of 1 to 6 characters (for example, 000AAA-000ZZZ, or 9AAA55-9ZZZ55). This portion is referred to as an incremental range. The following additional restrictions apply:

■ The character positions of the incremental portion of both range elements must match.

■ The non incremental characters of the first element must be identical to those of the second element.

■ You cannot increment two portions of a range element. If 111AAA is the first element, you cannot specify 112AAB for the second element.

■ The alphabetic portion of the VOLSER range is defined as being from character A to Z. To increment multi-character sequences, each character increments to Z. For instance, ACZ is part of the AAA-AMM range. Examples are:

A00B00 the largest range that can be specified is A00B00 through A99B99.

A0B0CC the largest range that can be specified is A0B0CC through A9B9CC.

000XXX the largest range that can be specified is 000XXX through 999XXX.

A00A0-A99A0 increments VOLSERs A00A0 through A09A0, then A10A0 through A99A0.

9AA9A-9ZZ9A increments VOLSERs 9AA9A through 9AZ9A, then 9BA9A through 9ZZ9A.

111AAA-111ZZZ increments VOLSERs 111AAA through 111AAZ, then 111ABA through 111ZZZ

999AM8-999CM8 increments VOLSERs 999AM8 through 999AZ8, then 999BA8 through 999CM8

A3BZZ9-A3CDE9 increments VOLSERs A3BZZ9 through A3CAA9, then A3CAB9 through A3CDE9

AAAAAA-AAACCC increments VOLSERs AAAAAA through AAAAAZ, then AAAABA through AAACCC

CCCNNN-DDDNNN increments VOLSERs CCCNNN through CCCNNZ, then CCCNOA through DDDNNN *

* Caution: This is a very large range.

Revision AA Preface xix

The number of volumes in an alphabetic VOLSER range depends on the number of elements in the incrementing portion of the VOLSER range. For an A to Z range in each character position, the number of volumes can be calculated by 26 to the power of the number of positions that are being incremented.

Lists

A list consists of one or more elements. If more than one element is specified, the elements must be separated by a comma or a blank space, and the entire list must be enclosed in parentheses.

Blanks

Keyword parameters and values may be separated by any number of blanks.

Control Statements

The standard syntax conventions for control statements are as follows:

■ The only valid control statement information area is from column 1 to column 72. Columns 73-80 are ignored.

■ Parameters may be separated by one or more blanks or a comma.

■ A value is associated with a parameter by an equal (=) sign or by enclosing the value in parentheses, and concatenating it immediately after the parameter.

■ Case (upper or lower) is ignored in actual control statements.

■ Continuations are supported by including a plus (+) sign at the end of the line to be continued. A control statement is terminated if the statement is not continued.

■ /* and */ can be used to enclose comments in the job stream. Comments can be continued over multiple lines, but cannot be nested.

PARMLIB members must include a /*...*/ comment as the first control statement. Otherwise, the old format is assumed. Comments in the old format must begin with an asterisk (*) in column 1.

For definition data sets (e.g., VOLATTRs, UNITATTRs and TAPEREQs), comments must be in the new format (/*...*/).

■ Asterisk (*) comments are not allowed.

■ A /*...*/ comment in the first line is not required.

■ The maximum length for a control statement is 1024 characters.

A-Z 261 26

AA-ZZ 262 676

AAA-ZZZ 263 17,576

AAAA-ZZZZ 264 456,976

AAAAA-ZZZZZ 265 11,881,376

AAAAAA-ZZZZZZ 266 308,915,776

Revision AA 1

CHAPTER

1

SMC Commands and Control Statements

This chapter contains syntax for SMC commands and control statements. Interface and subsystem requirement information is included with each command.

Control statements that are loaded by an operator command are described along with that command.

Note – For detailed information about the commands and control statements included in this publication, and the interfaces used to issue them, refer to the ELS Command, Control Statement, and Utility Reference.

ALLOCDef

2 ELS 7.1 Syntax Quick Reference • October 2010 Revision AA

ALLOCDefInterfaces:

Console, utility, or SMCCMDS/SMCPARMS data set UUI: Yes (No XML/CSV output)

Subsystem Requirements:

Active SMC required, or may be input to the SMCUSIM utility

ALLOCDef

SEPLvl(seplevel

MAXMIN

OFF

)MINLvl(2

)minlevel

MIAcompat( )OFFON

SMS(OFFON )

OFFFAILnoinfo( ALL )

SPECIFIC

CA1rts( )OFFON DEFer(

ONJES3OFF

) FETCHmsg(OFFONNONLIB

)

EXTVOLesot(

OFF

)esoteric [,

ZEROscr(

ALL ]USEREXIT

LIst

Optional Parameters

Optional Parameters:

LIst

LIst

OFF,OUtside

INside

ON,OUtside

INside

)

CAVTAPe(OFFON )

ALLOCJob

Revision AA Chapter 1 SMC Commands and Control Statements 3

ALLOCJobInterfaces:




SEPLvl(seplevel

MAXMIN

JOBname(jobname)

BYPass)MINLvl(

2)minlevel

STEPname(stepname)PROCstep(procstep)

Note: BYPass cannot be specified with the MINLvl or SEPLvl parameter. It is only valid when JOBname is also specified.

ALLOCJobLIst

Optional Parameters


LIst

OFF

CMDDef


CMDDefInterfaces:

Console, utility, or SMCPARMS data set UUI: Yes (No XML/CSV output)


Active SMC required

CMDDefLIst

PREFix(command-prefix)

COMMtest


COMMtestInterfaces:




Note – Only HSC TapePlexes or VLEs are eligible for the COMMtest command.

LOCalpath

COMMtestTAPEPlex(name)

SERVer(name)

ALLpaths

PORTrange(nnnnnnnn-nnnn

)

ANYSTATus

Note: PORTrange cannot be specified with the LOCalpath or ALLpaths parameter.

STORMNGR(name)SERVer(name)ALLpaths

ANYSTATus

Display DRive


Display DRiveInterfaces:




( devnumdevnum range

)

,devnum list

TAPEPlex(name)ALL

Virtual

Real and Virtual(No Nonlib)

VirtualNonlib

DRiveACTive

Real

Real

ALL

DisplayQuery

Display Volume


Display VolumeInterfaces:




volservolser-range

)ALLtapeplex

Volume(DisplayQuery

volser-list

DRIVemap


DRIVemapInterfaces:




LIst

CLient( devnumdevnum-range

devnum-list

)SErver( devnum

devnum-range

devnum-list

,,

)

Optional ParametersDRIVemap


LIstOFF

Help


HelpInterfaces:




Helpcommand-namennnnnnnn-nnnnSMCnnnnSMCnnnn-SMCnnnn

HTTP


HTTPInterfaces:



Active SMC required

HTTPLIst

DETailSTArt

PORT(8080nnnn )

Tuning Parameters LIst

STOp

Tuning ParametersLIst

Tuning Parameters:

Note: May be included with STArt or after HTTP startup

100

WQUELEN(200nnnnSQUELEN(

500nnnn )

HSIOtasks(4n ) MAXClients( nnn )

FORCE

IDAX


IDAXInterfaces:




POLicy( )ONOFF

SEQuence( )FIRSTLAST

MOD( )ONOFF

IDAXOFF

LIst

Optional Parameters

LIst


VTVMAXvol( )ONOFF

LIst


LIstInterfaces:




LIst Address(address) Length(CB(control-block-name)

100length )

TASKsFUNIT( uuuu

uuuu uuuu)

LOG


LOGInterfaces:



Active SMC required

LOGList

OFFLIst

Optional ParametersList


Type( record-type ),

LRECL(OFFlrecl ) EOFREstart(

OFFON )

STart

STOpAPPend

MONitor


MONitorInterfaces:



■ Active SMC required

■ Cannot be input to the SMCUSIM utility

MONitorLIst

OFFMonitor Parameters

LIst

Monitor Parameters:

INTerval( )60nnnnOFF

ACTivecheck( )180nnnnOFF

LOWscratch(0nnnnOFF

)

PREFprimary(ON

OFF)

MOUNTDef


MOUNTDefInterfaces:




)OFFON

)ONOFFAUTOPendmount(

ROLLmsg( )ONOFFVOLWatch(

)OFFONDISMSCRReal(

)OFFONDISMSCRVirt(

LIst

MOUNTDefOFF

LIst

Optional Parameters

LIst


OFFVTVCompletemsg( ON )

SWAPAutoreply(ONOFF ) SWAPLimit(

3nnOFF

) SWAPReuse(OFFON )

MSGDef


MSGDefInterfaces:




CASE(UPPERMIXED ) LVl( level

8) ECHOmnterr(

OFF)

ON

SMCWtorpfx(ON

)OFF

VERBOSE( )OFF

ON

MSGDefOFF

LIst

Optional Parameters

LIst


LIst

MSGJob


MSGJobInterfaces:




MSGJobLIst

OFF

level

8JOBname(jobname)

STEPname(stepname)PROCstep(procstep)

LVL( )

LIst

Optional Parameters


POLicy


POLicyInterfaces:




POLicyLIst

NAme(name) DETailTERse

ERRor VOLType(SpecificScratchNonspec

)

VALidateNAme(name) VOLType(

SpecificScratchNonspec

) LIst

NAme(name)NOnePolicy Parameters

LIst VALidate

Policy Parameters:

VOLType(SCratchSPecificNonspec

) MEDia( media type )

RECtech(

MODel(

recording-technique

model-type

)

)

SUBPool(subpool-name)

ESOTeric(esoteric-list) PREFer( LocationEsotericCount

)

MGMTclas(mgmt-class-name) TAPEPlex(tapeplex-name)NOTAPEPlex

IDAXESOTeric(esoteric-name) IDAXEXPDT(yyyyddd)IDAXRETPD(nnnn)

IDAXVOLcnt(volume-count)

IDAXSUBsys(subsystem-name)IDAXPROGram(program-name)

EXTVOLesot(esoteric-list)SPLITvolref(

OFF

ON)

READ


READInterfaces:




RESYNChronizeInterfaces:




SMCCMDsDSN(dsn)

VOLume(volser)

READ

UNIT(unitname)

HOST(hostname)

RESYNChronize

Route


RouteInterfaces:



Active SMC required

tapeplex-nameRoute command-stringstormngr-name

SERVer


SERVerInterfaces:




SERVerLIst

LIst

NAme(name)

NAme(name)ENAble

DISable TAPEPlex(name)

Added Server Parameters:

HOst(hostname)IPaddress(ipaddress)

POrt(80)

POrt(nnnn)

Note: TAPEPlex(name) or STORMNGR(name) is required when the SERVer NAME is first defined.

LIstAdded Server Parms

HSCSUB(ssss)

STORMNGR(name)

SIMulate


SIMulateInterfaces:




JOBname(jobname) STEPname(stepname)

{PGMname|PROGram}(pgmname) DDName(ddname)

{DSN|DATASET}(dsname) VOLSer(volser)

ESOTeric(esoteric-name) RETPD(EXPDT(expiration-date)

0retention-period

SIMulate

LABEL(label-type)

)

SMSDef


SMSDefInterfaces:




VTVmgmt(ON

OFF) IGDACSXT(

OFF

ON)MGMTPol( )

OFF

SMSDefLIst


Optional Parameters LIst

ONIDAXALL

TEMPdsn(ON

OFF)

STORMNGR


STORMNGRInterfaces:




STORMNGRLIst

LIstNAme(name)

NAme(name)ENAble

DISable

SERVerlist

STATus

NAme(name)

NAme(name)

TAPEPlex


TAPEPlexInterfaces:




TAPEPlexLIst

LIst

NAme(name)

NAme(name)DIsable Local Subsys Parms

SERVerlistNAme(name)

Local Subsys Parameters:

STATusNAme(name)

TapePlex Parms

LOCSUBsys(subsysname) LOCDISable

LOCENAble

ENable

TapePlex Parameters:

Server

Client)WTORdest( ALIAShost(

OFF

hostname)

TCPip


TCPipInterfaces:




TCPipList

OFFTCPIP Parameters

LIst

TCPIP Parameters:

TCPname(nonename ) ADSname(

nonename ) PORTrange(

OFFllll-hhhh )

TRace


TRaceInterfaces:




TRaceLIst

OFFLIst

Jobname/Component ParametersLIst

Jobname/Component Parameters:

SUbsys

JOBname

ALLProc

AScommCGiCMdHTtpINitterm

(jobname)ALLProc

OptionalParms

,

,ALLOcMSghandlerPOlicyREmoteUTility


STEPname(stepname)PROCstep(procstep) SNAPdump( BEFOre

AFTErBOTH

)

TREQDef


TREQDefInterfaces:




TREQDefLIst

DATASET(dsn)DSN(dsn)

HOSTID(hostid)

RELOAD

VOLume(volser)UNIT(unitname)

TREQDef


TAPEREQ Control Statement

JOBname( jobname*

) STEPname( stepname*

)

TAPEREQ

PROGram( program-name*

PGMname(program-name)DATASET( dataset-name

*

DSN(dataset-name)

RETPD( GE ,retention-periodEQNEGTLTLE

EXPDT( GE ,expiration-dateEQNEGTLTLE

POLicy(policy-name)

VOLSer(*volser )

DDname( DD-name*

)

LABEL(*label-type )

JCLESOT(*esoteric-name ) ACTRECT( rectech-list )

*

) )

)

)

UEXit


UEXitInterfaces:




UEXit

FORMat(HSCCSC )NAME(name)

LIst

number

ENAbleDISable

ENAble

DISableLOAD

LIst

UNITAttr


UNITAttrInterfaces:

Console or SMCCMDS data set UUI: Yes (No XML/CSV output)



UNITAttr

devnum-range

devnum-list

ADDRess( devnumdevnum-range

)

,

TAPEPlex(NONEtapeplex-name )

LIst

Device AttributesOFF

LIst

ESOTeric(esoteric-name)Device AttributesOFF

LIst

Device Attributes:

MODEL(model-type)

NOTAPEPlex

Note: TAPEPlex is required when MOdel(VIRTUAL) is specified.

USERMsg


USERMsgInterfaces:

Console or SMCPARMS data set UUI: Yes (No XML/CSV output)



USERMsgID(msgid)

LIst

Revision AA 33

CHAPTER

2

HSC and VTCS Commands and Control Statements

This chapter contains syntax for HSC commands and control statements. Interface and subsystem requirement information is included with each command.

Control statements that are loaded by an operator command are described along with that command.

Note – ■ For detailed information about the commands and control statements included in

this publication, and the interfaces used to issue them, refer to the ELS Command, Control Statement, and Utility Reference.

■ Certain HSC and VTCS commands are described in the ELS Legacy Interfaces Guide. These commands were introduced in a pre-ELS 7.0 software release and their functionality has been replaced.

ACTIvities


ACTIvitiesInterfaces:

SLUADMIN utility only UUI: No


Active HSC not required

ACTMVCGNInterfaces:

SLUADMIN utility only UUI: Yes


Active HSC required only when specifying the MVCPOOL parameter

ACTIvities

BEGIN(TODAYbegin-date ,

00:00:00begin-time )

END(TODAYend-date ,

00:00:00end-time )

ACTMVCGN

ACS(,acs-id ) MVCPOOL(

,)

STORMNGR( stormngr,

)

mvcpool-name

ARCHive

Revision AA Chapter 2 HSC and VTCS Commands and Control Statements 35

ARCHiveInterfaces:

Utility only UUI: Yes



ARCHiveMGMTclas(mgmt-class-name1...mgmt-class-namen)VTV(vtv-list | vtv-range)

MAXMVC(nn) CONMVC(nn) ELAPSE(nnnn) POLICYdd(ddname)MOVEVTV

AUDit


AUDitInterfaces:

Utility only UUI: Yes, when MVC or VTSS is specified


■ Active HSC/VTCS (AUDit MVC, VTSS, or INVLDMIR)

■ Active HSC at FULL service level (all others)

Optional Parameters APPLy(YESNO )


LSM(lsm-list)PANel(panel-list)

ROW(row-list)COLumn(column-list)

CAP(cap-id) EMPTYCel DIAGScan( ONLYALSO

) INTRANs

VTSS( vtss-name

vtss-list,

)

MVC( volservol-range

vol-list,

)

INVLDMIR

AUDit ALLACS(acs-id)

BACKup


BACKupInterfaces:




CANcelInterfaces:

Console or utility UUI: Yes


Active HSC/VTCS

BACKup

CANcel ID(process-id)Type( ALL

MIGrateRECAllRECLaim

)

CAPPref


CAPPrefInterfaces:

Console or PARMLIB UUI: No


Active HSC at FULL service level

CDsInterfaces:



Active HSC at BASE or FULL service level

CAPPref prefvlue lsm-idcap-idcap-range

(,cap-list )

host-id AUTOMANual

CDs Enable DSn(dsn)NEWLoc NEWVol(volser),NEWUnit(unitname)

Disable DSn(dsn)PrimarySEcndrySTandby

EXpand

CDSDAta


CDSDAtaInterfaces:




CDSDEFInterfaces:

PARMLIB only UUI: No


None

CDSDAtaVOLPOOLMVCPOOLSCRPOOL

TYPE( )

CDSCAPLSMDRV

DSN1(dataset-name),VOL1(volser),UNIT1(unitname)

CDSDEF

,DSN2(dataset-name),VOL2(volser),UNIT2(unitname)

,DSN3(dataset-name),VOL3(volser),UNIT3(unitname) ,DISABLE

CLean


CLeanInterfaces:




CLeandev-rangedev-id

( dev-list,

)

host-id

COMMPath


COMMPathInterfaces:

Console or PARMLIB only UUI: No



COMMPath HOSTid(host-id)

METHod( CDSLMULMU,acs-idVTAM

)LMUpath( acs-id

acs_range,acs-list

) VTAMpath(name)

LMUpath( acs-idacs_range,acs-list

)VTAMpath(name)

VTAMpath(name)DELete

LMUpath( acs-idacs_range,acs-list

)VTAMpath

(name)

VTAMpath(name)

CONFIg


CONFIgInterfaces:



Active HSC not required, and must be down on all hosts when running CONFIG RESET.

CONFIgRESET CDSLEVEL( V6ABOVE

V61ABOVEV62ABOVE

) NOUPDATE

V71ABOVE

CONFIg


CONFIg GLOBAL Statement

CONFIg RECLAIM Statement

GLOBALMAXVTV=nnnnnn MVCFREE=nnnn

VTVattr=SCRATCH

ALLmount

RECALWER=YES

NO

LOCKSTR=structure-nameREPlicat=

ALWAYS

CHANGED

VTVPAGE=STANDard

LARGENLIBDRNR=

YES

NONLIBMIGR=

YES

NO

NLIBRECL=YES

NO

MVCMNTTO=nn

SYNCHREP=NO

YES

MAXRTDS= 1632 FASTMIGR=

NO

YES

LOGPOL=OPTional

REQuired

INITMVC=NO

YES

MAXVTVSZ=400

80020004000

RECLAIMTHRESHLD=nn MAXMVC=nn START=nn

CONMVC=nn INPLACE= YESNO INPTHRSH=nn

VLTHRES=nn

CONFIg


CONFIg VTSS Statement

CONFIg RTD Statement

CONFIg VTD Statement

CONFIg CLUSTER Statement

CONFIg CLINK Statement

VTSS NAME=xxxxxxxxDEFLTACS=acs-id LOW=nn HIGH=nn

MAXMIG=n MINMIG=n RETAIN=nn

RTD NAME=xxxxxxxxSTORMNGR=stormngr

IPIF=nn:nDEVNO=nnnnCHANIF=ci|ci:p

VTD LOW=xxxx HIGH=xxxxCUADDR=xx NOVERIFY

CLUSTER NAME=nnnnnnnn VTSSs(vtss-list)

CLINK CHANIF=ci|ci:pVTSS=name REMPlex=name

PARTner=name

IPIF=nn:n

CONFIg


CONFIg HOST Statement

CONFIg TAPEPLEX Statement

HOST NAME=xxxxNOMIGRAT NORECLAM

TAPEPLEXRECVPLEX(tapeplex-list)

THISPLEX=name

STORMNGR(stormngr-list)

CONSolid


CONSolidInterfaces:



Active HSC/VTCS

DECompInterfaces:




CONSolidVTV(

vol-rangevolser

vol-list,

)

MGMTclas( mgmt-class-name ),mgmt-class-list

RECALWER(YES

NO)

DECompFLATdd(ddname) LISTDELR

DELETSCR


DELETSCRInterfaces:



Active HSC/VTCS

DIRBLDInterfaces:

Utility only UUI: No



DELETSCRVTVid(

vol-list

vol-range,

volser )

MGMTclas(,mgmt-clas-name )

SCRPool(,scrpool )

NOTREF(days)MAXVTV(nnn) DETail

VTSS(vtss-name)

DIRBLD

DISMount


DISMountInterfaces:




Display AcsInterfaces:




DISMountvolser, devaddr

host-id FORCE

Acsacs-idacs-range

(,acs-list )

DisplayQuery

Display ACTive


Display ACTiveInterfaces:



Active HSC/VTCS

Display ALlInterfaces:




ACTiveDETail

VTSS(vtss-name)

DisplayQuery

ALlDisplayQuery

Display Cap


Display CapInterfaces:




Display CDSInterfaces:




Cap(all CAPs)

acs-idlsm-idcap-id

DisplayQuery

CDSDisplayQuery

Display CLInk


Display CLInkInterfaces:



Active HSC/VTCS

Display CLUsterInterfaces:



Active HSC/VTCS

CLInkDisplayQuery

CLUsterDisplayQuery

Display CMD


Display CMDInterfaces:




Display COMMPathInterfaces:




CMDCOmmand command-name

DisplayQuery

COMMPath

HOSTid(*ALLhost-id

host-list

)

DisplayQuery

Display CONFIG


Display CONFIGInterfaces:




Display DRivesInterfaces:




CONFIGDisplayQuery

DRivesLibraryACS(acs-id)LSM(lsm-id)

ACtiveIdleALl

BYDrive

BYLoc DETail

MEDia(media-type) RECtech(recording-technique)MODel(model-type)

Unit( unit-addressunit-address range

)

DisplayQuery

IDEntity

Display DRIVE_INFO


Display DRIVE_INFOInterfaces:



Active HSC/VTCS

DRIVE_INFODisplayQuery DRV_Info

LIBRARYLSMloc(lsm-id)

LSMloc(lsm-id)

DEVADDR(device-address)

ACtive

DRVLOC(drive-location)LIBLOC(drive-id)

MODel(

RECTech(

model-type )

recording-technique )

MODel( model-type )

RECTech( )recording-technique

MODel(

RECTech(

model-type )

recording-technique )VIRTual

Display EXceptns


Display EXceptnsInterfaces:




Display LMUPDEFInterfaces:




EXceptnsX

DisplayQuery

LMUPDEFDisplayQuery

Display LOCKs


Display LOCKsInterfaces:



Active HSC/VTCS

Display LsmInterfaces:




LOCKsDisplayQuery

Lsmlsm-idlsm-range

)(,lsm-list

DisplayQuery

Display Message


Display MessageInterfaces:




Display MGMTDEFInterfaces:




MessageMsg

msgnumDisplayQuery msg-range

msg-list

Note: msg-range and msg-list are only valid when the Display Message command is issued from a utility or programmatic interface.

MGMTDEFDisplayQuery

Display MIGrate


Display MIGrateInterfaces:



Active HSC/VTCS

Display MNTDInterfaces:




MIGrateDisplayQuery

AUTO(stor-clas-name)

VTSS(vtss-name)

VTSS(vtss-name) LISTVTVS

DETailDETail

DELAY(stor-clas-name)

MNTDDisplayQuery

Display MONitor


Display MONitorInterfaces:




Display MVCInterfaces:



Active HSC/VTCS

MONitor,PGMI ,L( cc

name)

DisplayQuery

MVC(volser)DisplayQuery

Display MVCPool


Display MVCPoolInterfaces:



Active HSC/VTCS

Display OPTionInterfaces:




MVCPoolNAME(poolname)

DisplayQuery STORCLAS(stor-clas-name)

OPTionDisplayQuery

Display PATH


Display PATHInterfaces:



Active HSC/VTCS

Display QueueInterfaces:



Active HSC/VTCS

PATHDisplayQuery ( rtd-name

rtdname-list

)

VTSS(vtss-name)

CLINK

QueueDETail

VTSS(vtss-name)

DisplayQuery

Display REPlicat


Display REPlicatInterfaces:



Active HSC/VTCS

Display RequestsInterfaces:

Console or PARMLIB UUI: Yes



REPlicatDisplayQuery

RequestsDisplayQuery

Display RTD


Display RTDInterfaces:



Active HSC/VTCS

Display SCRatchInterfaces:




RTD(rtd)(rtd-range)

(rtd-list)

QUeuedDisplayQuery

SCRatchacs-idlsm-idVSM

SUBpool(subpool-name)HOSTid(name)

MEDia(media-type) RECtech(recording-technique) ALLDETail

DisplayQuery

Display SEN


Display SENInterfaces:




Display SERVERInterfaces:



Active HSC/VTCS

SENREQNAME= LNRNAME=

DisplayQuery

SERVERDisplayQuery

Display SRVlev


Display SRVlevInterfaces:




Display StatusInterfaces:




SRVlevDisplayQuery

StatusDisplayQuery

Display STORCLas


Display STORCLasInterfaces:



Active HSC/VTCS

Display STORMNGRInterfaces:



Active HSC/VTCS

STORCLas(name)DETail MAXvtv(nnnn)

DisplayQuery

STORMNGR(name)DisplayQuery

Display TASKs


Display TASKsInterfaces:




Display THReshldInterfaces:




TASKsDisplayQuery

THReshldacs-idlsm-idVSM

SUBpool(subpool-name)HOSTid(name)

DETailMEDia(media-type) RECtech(recording-technique) ALL

DisplayQuery

Display Volser


Display VolserInterfaces:




Display VOLUME_INFOInterfaces:



Active HSC/VTCS

vol-range

)(,vol-list

VolserVolume

volserDETail

DisplayQuery

VOLume_InfoDisplayQuery VOLser

ALL

vol-range

)(,vol-list

volser

Display VSCRatch


Display VSCRatchInterfaces:



Active HSC/VTCS

Display VTDInterfaces:



Active HSC/VTCS

VSCRatchDisplayQuery (subpool-name)

VTDACtive

VTSS(vtssname) ALlDisplayQuery

Display VTSS


Display VTSSInterfaces:



Active HSC/VTCS

Display VTVInterfaces:



Active HSC/VTCS

VTSSDETail

DisplayQuery VTSS(vtss-name)

VTV(vtv-id)DisplayQuery

DRAin


DRAinInterfaces:




DRAinENter

EJectcap-id

(,cap-list )

DRTEST CREATE


DRTEST CREATEInterfaces:




DRTEST

DRVTSS(vtss1,vtss2,...vtssn)SPARE(vtss1,vtss2,...vtssn)

DRACS(acsid1,acsid2,...acsid16)

CREATE |Options|

Options:

HOSTID(hostid1,hostid2,...hostidn)

Note: CREATE is not valid when DRTEST is issued from the console.

NOUPDprd


DRTEST PRIMEprd


DRTEST PRIMEprdInterfaces:




DRTEST PRIMEprd

DRVTSS(vtss1,vtss2,...vtssn)SPARE(vtss1,vtss2,...vtssn)

DRACS(acsid1,acsid2,...acsid16)

Options:

HOSTID(hostid1,hostid2,...hostidn)

|Options|

Note: PRIMEprd is not valid when DRTEST is issued from the console.


DRTEST RESET


DRTEST RESETInterfaces:




DRTEST STARTInterfaces:




DRTEST RESET

Note: RESET is not valid when DRTEST is issued from the console.

DRTEST START

DRTEST STOP


DRTEST STOPInterfaces:




DRTEST STOP

EEXPORT


EEXPORTInterfaces:




EEXPORT VTV( volservol-range

vol-list

)

MGMTclas( mgmt-class-name,mgmt-class-list

)

,

RECALWER(YES

NO)

TOPlex(name)

FORCE(NO

)

REJECTED(NO

ULINKMVC(volser)

YES

YES)

EJect


EJectInterfaces:




acs-idlsm-idcap-id

EJectOption2Option1

text

Option 1:

volservol-range

( vol-list )

( cap-list ),

WAITcap(NO

YES)

SEQ( NOYES

)

acs-idlsm-idcap-id

Option 2:

( cap-list ),

WAITcap(NO

YES)

SCRTCHSUBpool(subpool-name) VOLCNT(count)

MEDia(media-type) RECtech(recording-technique)

ENter


ENterInterfaces:




EXECParmInterfaces:

PARMLIB only UUI: No


None

ENter00

acs-idlsm-idcap-id

TLSM(lsm-id) SCRatch

EXECParm

MSGPRFX(YesNo )

,Eid(gtfeid) ,Fid(gtffid)

,HOSTID(host-id)

EXPORT


EXPORTInterfaces:



■ Active HSC/VTCS at FULL service level required when specifying the VTV, MGMTCLAS, or STORclas parameter.

■ Active HSC/VTCS not required when specifying the MVC parameter.

EXPORT VTV( volservol-range

vol-list

)

MGMTclas( mgmt-class-name,mgmt-class-list

)

MVC(volservol-range

vol-list

)

STORclas( storclas-name

storclas-list

)

,

,

MANIFEST(ddname)RECALWER(

YES

NO)

FMTLOG


FMTLOGInterfaces:




FMTLOG

IMPORT


IMPORTInterfaces:



Active HSC/VTCS not required

IMPORT

vol-range

MVC( volservol-range

vol-list

IMMDRAIN( NOYES

)

VTV( volser

vol-list

)

)

,

,

REPLACE( NONEALL

)

MANIFEST(dd-name) NOUPDATE

INACTCDS OWNRPLEX(name)SETOWNER

INITialize


INITializeInterfaces:




INITializeOptional Parameters

CAP(cap-id)PROGram( prog-name

IEHINITT) VERIFY(parameter-name)

CNTLDD(SYSINdd-name )

OPTION( EJEctSCRatch

)


INVENTRY


INVENTRYInterfaces:



Active HSC/VTCS

LIBGenInterfaces:




INVENTRY MVCid( volservol-range,vol-list

CDScheck(NoneMvcFull

)

STOPleot(NOYES ) TERMerr(

NOYES )

)

LIBGen

LMUPDEF


LMUPDEFInterfaces:




LMUPATH Control Statement

LMUPATH ACS(aa) LMUADDR(lmu_hostnamennn.nnn.nnn.nnn

,) PARTID(00n) PING(tt)

LMUPATH ACS(aa) LMUADDR(lmu_hostnamennn.nnn.nnn.nnn

,) PARTID(00n) PING(tt)

LOGUTIL


LOGUTILInterfaces:

SLUADMIN utility only UUI: Yes



LOGUTIL FOR_LOSTMVC Statement

LOGUTIL LOGDD(ddname)

FROMDATE(yyyy-mm-dd)

COMMANDS(ddname)

FROMTIME( hh:mm:ss00:00:01

)

TODATE(yyyy-mm-dd)

TOTIME( hh:mm:ss00:00:01

)

SCRATCH

FOR_LOSTMVC

COMMANDS(ddname)

MVC( volservolser-range

)

volser-list

VTV( volservolser-range

)

volser-list

LOGUTIL


LOGUTIL GENAUDIT Statement

LOGUTIL LOCATE_VTV

LOGUTIL UNDELETE Statement

GENAUDITCOMMANDS(ddname)

LOCATE_VTV

COMMANDS(ddname)

VTV( volservolser-range

)

volser-list

-1

-nnVERSION( )

DATE(yyy-mm-dd) TIME(hh:mm:ss)

UNDELETE VTV( volservolser-range

volser-list

)COMMANDS(ddname)

MERGEcds


MERGEcdsInterfaces:



Active HSC at BASE service level only

SLSMERGE Control Statement

MERGEcdsVALIDate ALL NOMSG

Note: If ALL is not specified, MERGEcds reads the parameters specified in the SLSMERGE DD statement.

DELVirt

MERGE

MERGE

FLSM(lsm-id)

FVTSS(vtss-name)

TLSM(lsm-id)

TVTSS(vtss-name)

FVAULT(vault-name) TVAULT(vault-name)

ALLREAL

ALLVIRT

ALLVALT

NOREAL

NOVIRT

NOVALT

For REAL volumes:

If the CDS contains VIRTUAL data:

If the CDS contains VAULT data:

MERGE FACS(acs-id) TACS(acs-id)

MERGMFST


MERGMFSTInterfaces:




MGMTDEF Interfaces:




MERGMFST MERGEIN(manifin) MERGEOUT(manifout)

MGMTDEFDSN(dataset-name)DATASET(dataset-name)

VOLume(volser) UNIT(unitname)

HOSTID(host-id)

MGMTDEF


MGMTclas Control Statement

MGMTclas NAME(mgmt-class-name)ACSlist(acs-id | acs-id,acs-id)

DUPLEX(NOYES )

MAXVtvsz(400 | 800 | 2000 | 4000)

VTVPAGE(STANDard | LARGE)

DISCARD=9999nnnn

IMMDELAY=9999nnnn

NOMIGRAT

MIGpol(s1 | s1,s2 | s1,s2,s3 | s1,s2,s3,s4)

ARCHAge(nnn) ARCHPol(s1 | s1,s2 | s1,s2,s3 | s1,s2,s3,s4)

RESTIME(nnn)

CONSRC(stor-class-name) CONTGT(stor-class-name)DELSCR(

NOYES )

REPlicat(NOYESYES_SYNC

)

EEXpol(s1|s1,s2)

MGMTDEF


MIGRSEL Control Statement

MIGRVTV Control Statement

MVCATTR Control Statement

MIGRSELSTORclas(stor-clas-name) VTSS(vtssname)

HOST( host-id, FUNCtion(IMMED|AUTO|RECLAIM|DEMAND)

IMMWAIT( nnn999

) SCHPREF( n0

) SCHLIMIT( nn99

)

MIGRVTV

STORclas(stor-clas-name)

VTSS(vtssname)MGMTclas(mgmt-clas-name)

IMMDELAY(9999nnnn )

MVCATTR MEDIA(media-name) SWAPTO(device-type)

MGMTDEF


STORclas Control Statement

STORLST Control Statement

STORSEL Control Statement

STORclas NAME(stor-clas-name)

ACS(acs-id)

TAPEPLEX(name)SYNC( NO

YES)

MEDIA(list) MVCPOOL(poolname) MIGRATE( SENDERRECEIVEREITHER

)

FROMLST(vtss-list-name) INPLACE( YESNO

)

STORMNGR(name)

STORLST NAME(stor-list-name) STORclas( stor-class-name )

,PRIority(

5order )

,

STORSELFUNCtion(function)

HOST( host-id ),

MGMTclas(mgmt-class-name) VTSS(vtss-name)STORLST(stor-list-name)

MGMTDEF


VTSSLST Control Statement

VTSSSEL Control Statement

VTSSLST NAME(vtss-list-name) VTSS( vtss-name )

PRIority( order5

,

,

)

VTSSSELFUNCtion(function)

HOST( host-id,

)

MGMTclas(mgmt-class-name) PREVvtss(vtss-name)

STORclas(stor-class-name) MVCpool(pool-name)

VTSSLST(vtss-list-name)

MIGrate


MIGrateInterfaces:



Active HSC/VTCS

Format 1

Format 2

MIGrate VTVid(,volser )

DSN(,name )

MGMTclas(,name )

DELETE(YESNO )

NOWAITvol-range

vol-list,

MIGrate

VTSS(,name )

THRESHLD(value)

MNTD


MNTDInterfaces:




MNTD,AUTocln( OFf

ON)

Dismount( AutoManual

)

Ejctauto(

Float(

MAXclean(count)

MMount(

PASSTHRU(count)

Scratch(

SCRDISM(

ONMSgOFf

)

ONOFf

DeleteReply

)

ManualAuto

CURRENTARCHIVE

)

)

ACS(acs-id)

ACS(acs-id)

HOSTID(host-id)

)

MODify


MODifyInterfaces:




MODify

lsm-range

)(,lsm-list

F

CONFIGRESET

CAP cap-idlsm-id

ONlineOFFline

LSMlsm-id ONline

OFFlineFORCE

ADD ACSType(SL3000SL8500 )

DELete ACS(acs-id)UPDate ACS(acs-id)

Mount


MountInterfaces:




Mount volser devaddr

host-id,

Readonly

Mount

SCRTCHPRIVAT

devaddrhost-id SUBpool(subpool-name) MEDia(media-type)

Mount volserSCRTCH

devaddrMGMTclas(mgmt-clas-name)

To mount a specific Nearline volume on a transport:

To mount a scratch volume on a transport:

To mount a VTV on a VTD and optionally, assign a management class to the VTV:

MOVe


MOVeInterfaces:




MOVe

TLsm(lsm-list)TPanel(panel)

| Parameters |

Parameters:

Flsm(lsm-id) Panel(panel-list)Row(row-list)

Column(column-list)

Volume(vol-list)

MVCDRain


MVCDRainInterfaces:



Active HSC/VTCS

vol-range,vol-list

)volserMVCDRain MVCid(

MVCPOOL(poolname)STORCLAS(stor-clas-name)

EJect

RECALWER(YES

NO)

NOWAIT WARRANTY RETIRED

DATACHK

CONMVC(nn)

ERROR

MVCMAINT


MVCMAINTInterfaces:



■ Active HSC/VTCS required if RENVTSS is specified

■ Can run in batch-only mode when there are no hosts active (on any LPAR) using the CDS that is to be updated

MVCMAINT

vol-range,vol-list

)volserMANIFEST(ddname)MVC( READONLY( ON )

LOST( ON ) ERROR( ON ) EJECT( )

INVLDMIR( ONOFF

)RETIRED( ) WARRANTY( ONOFF

)

REPLACED( NONEMEDIA

)

OFF

OFF OFF OFFON

ONOFF

RENVTSS(vtss-name)

MVCPLRPT


MVCPLRPTInterfaces:




MVCPOOL(poolname) STORCLAS(stor-clas-name)

DETail

SUMmaryMVCPLRPT

MVCRPt


MVCRPtInterfaces:




OFFload LOGFILEInterfaces:




MVCRPt

vol-range,vol-list

DETail

MVCid( volser )

CHECK WRITABLE

STORclas(storage-clas-name)ALLMANIFEST(ddname)

OFFLOAD LOGFILERESTARTLOGDSN(primary-log-file-dsn)

OPTION TITLE Control Statement


OPTION TITLE Control Statement

OPTION TITLE(identifying-string)TRACETRACEF

OPTion


OPTionInterfaces:




OPTion

,

Dialog(OffBothConsoleLog

)

DISCmsg( SHowSUppress

)ACS(acs-id)

HOSTID(host-id)

DUPOFL(OFFON )

EJLimit(count)

ENTdup( ManualAuto

)

Output( UpperMixed

)

Repath( YesNoReply

)

SEN( ONOFF

)

Viewtime(count)

Warnmsg(minutes)

RECall


RECallInterfaces:



Active HSC/VTCS

DSN(

MGMTCLAS(

name,

)

name,

)

RECALWER(YES

NO)

RECall

VTSS(,name )

NOWAIT

VTVid(,volser )vol-range

vol-list,

RECLaim


RECLaimInterfaces:



Active HSC/VTCS

RECLaimMVCPOOL(poolname)STORCLAS(stor-clas-name)ACSid(acs-id)MVC( volser

vol-range

vol-list,

MAXMVC(nn) THRESH(nn)

ELAPSE(nnnn) NOWAITCONMVC(nn)

)

INPTHRSH(nn)

RECONcil


RECONcilInterfaces:



Active HSC/VTCS

RECOVerInterfaces:




RECONcil

CONMVC(nn) ELAPSE(nnnn)MAXMVC(nn)

STORclas(stor-class-name1...stor-clas-namen)MVC(mvc-list | mvc-range)

MGMTclas(mgmt-class-name1...mgmt-clas-namen)VTV(vtv-list | vtv-range)

POLICYdd(ddname)MOVEVTV

RECOVer host-idFORCE

RELease


RELeaseInterfaces:




REPLaceallInterfaces:




RELease cap-id

REPLaceall

VOLser( vol-list,

)

RESTore


RESToreInterfaces:



HSC must be down (inactive)

RTV Utility

Note – This VTCS utility is a standalone utility executed using the SWSRTV program.

RESTore

RTV

VTVid( vol-list,

OUTUNIT(name)

)

MVCid(volser) INUNIT(name)

vol-rangevolser

ALLVTVS CPYVOLID LISTONLY BLOCKid(nnn) FILEnum(nnn)

DUMP VALIDATE

SCRAtch


SCRAtchInterfaces:




SCREdistInterfaces:




SCRAtch VOLser(,vol-list )

ACS(acs-id)

LSM( lsm-list,

)SUBpool(subpool-name)

SCREdist

BALtol(tolerance-value) MEDia(media-type)

RECtech(recording-technique)

SENter


SENterInterfaces:




SET CLNPRFX

Note – HSC must be shut down on all systems before changing the cleaning prefix.

Interfaces:




SENter cap-id

SET CLNPRFX(prefix)

SET COMPRFX


SET COMPRFXInterfaces:




SET DRVHOSTInterfaces:




SET COMPRFX(cmdhex)

SET DRVHOST( OFF )host-id

SET EJCTPAS


SET EJCTPASInterfaces:




SET FREEZEInterfaces:




SET EJCTPAS( )newpswd ,OLDPASS(oldpswd)

SET FREEZE( )ONOFf

FORLSMID(lsm-id),FORPANEL(panel)

SET HOSTID


SET HOSTIDInterfaces:




SET HSCLEVelInterfaces:




SET HOSTID(newhost),FORHOST(oldhost)

SET HSCLEVel(OFF),FORHOST(host-id)

SET LOGFILE


SET LOGFILEInterfaces:




SET MAJNAME

Note – HSC must be shut down on all systems before changing the QNAME.

Interfaces:



■ Active HSC not required

■ HSC must be shut down on all systems before changing the QNAME.

SET LOGFILE(,secondary-log-file-dsnOFF

primary-log-file-dsn

,OFF

)

IMMED

SET MAJNAME(qname)

SET MIGOPT


SET MIGOPTInterfaces:



Active HSC/VTCS

SET NEWHOSTInterfaces:




SET MIGOPTVTSS(vtssname) MAXmig(nn) MINMIG(nn)

HIGHthld(nn) LOWthld(nn)

SET NEWHOST(newhost),LIKEHOST(model-host)

SET RMM


SET RMMInterfaces:



Active HSC/VTCS

SET SCRLABLInterfaces:




SET RMMENableDISable

SET SCRLABL( )SLALNLNSL

SET SLIDRIVS


SET SLIDRIVS

Caution – For 9310 and 9740 libraries, Sun recommends you bring the HSC down on all hosts before specifying this parameter, and recycle the HSC after every SET SLIDRIVS operation.

Interfaces:




SET SLISTATNInterfaces:




SLIDRIVS(addr0

,...addr31

),FORLSMID(lsm-id) ,FORPANEL(panel)

,FORHOST(host-id)

SET

,MODEL(model-type)

SLISTATN(stat1,…,stat16

),FORACS(acs-id),FORHOST(host-id)

SET

SET SMF


SET SMFInterfaces:




SET TAPEPlexInterfaces:




SMF(libtype)SET

SET TAPEPlex(tapeplex-name)

SET TCHNIQE


SET TCHNIQEInterfaces:




TCHNIQE( NONEJOURNALSHADOWBOTHSTANDBYALL

)SET

SET VAULT


SET VAULTInterfaces:




SET VAULTVOLInterfaces:




VAULTADD NAME(cccc) SLOTS(nnnn)

DESC(aaaa) TMSNAME(bbbb)

MOD NAME(cccc)SLOTS(nnnn) DESC(aaaa) TMSNAME(bbbb) NEWNAME(cccc)

DEL NAME(cccc)

SET

VAULTVOL NBRVOLS (nnnnnn)SET

SET VOLPARM


SET VOLPARMInterfaces:




VOLPARM

APPLY(NO

YES)

SET

SET VOLPARM


POOLPARM Control Statement

VOLPARM Control Statement

POOLPARM

TYPE Parameters:

| TYPE Parameters |

TYPE(SCRATCH) NAME(nnnn)

HOSTid( hostid

TYPE(CLEAN)MAXclean(nn)

TYPE(MVC)NAME(nnnn)

NORECLAM

, DRTEST

DRTEST

LABEL(SLNLALNSL

)

NOMIGRAT

MVCFREE(nn) MAXMVC(nn) START(nn) THRESH(nn)

INITMVC( YESNO

)

TYPE(EXTERNAL)OWNRPLEX(tapeplex-name)

NAME(nnnn)

INPTHRSH(nn)

VOLPARMvol-range,vol-list

volser )MEDia(media-type)

RECtech(recording-technique)

VOLSER(

INITSCR DRTEST

SRVlev


SRVlevInterfaces:




STOPMNInterfaces:




SRVlev BASEFULL

STOPMNPM

PGMI,L(

ccname

)

SWitch


SWitchInterfaces:




TRaceInterfaces:




SWitchAcs acs-id

Note: ACS acs-id is optional in a single ACS environment; it is required in a multi-ACS environment.

TRace comp-name

comp-list,OFF

TRACELKP


TRACELKPInterfaces:




UEXITInterfaces:




TRACELKP

table-list

table-name,

OFF table-name

UEXIT nn

nn

Load(name

SLSUXnn)

,Enable

,DisableEnableDisable

nn-range

( nn-list,

)

Query

UNSCratch


UNSCratchInterfaces:




UNSElectInterfaces:




UNSCratch VOLser( vol-list,

)

UNSElect VOLser(volser),FORCE

Vary


VaryInterfaces:

■ Console or PARMLIB (Vary ACS)

■ Console or utility, UUI All (Vary CLINK, RTD, or VTSS)

UUI: Yes


■ Active HSC at FULL service level (Vary ACS)

■ Active HSC/VTCS (Vary CLINK, RTD, or VTSS)

Vary ACS acs-idacs-range

( acs-list )

STationdev-iddev-range

( dev-list )

OFFlineONline

FORCE

CLInk(clink-id) VTSS(vtssname) ONlineOFFline

RTD( rtd-idrtd-range

rtd-list,

) ONlineOFFlineMAINt

VTSS(name) OFFLineONlineQUIESCED

PATH( rtdname

rtdname-list

ONlineOFFlineMAINt

)

VIew


VIewInterfaces:




VIew CApCAPID(00:00:00)

CAPID(cap-id)Lsm(lsm-id)

Row(00)

Row(rr)

Column(00)

Column(cc)

CEllLsm(00:00)

Lsm(lsm-id)

Panel(00:00)

Panel(pp)

Row(00:00)

Row(rr)

Column(00:00)

Column(cc)

DRive Address(xxx)Host(host-id)

PLaygrnd

PTp

Lsm(00:00)

Lsm(lsm-id)

Column(00:00)

Column(cc)

Lsm(00:00)

Lsm(lsm-id) Xlsm(ll)

Column(0)

Column(c)

Time(ttt)

VOLPCONV


VOLPCONVInterfaces:




VOLPCONV

CLNPRFX(CLNprefix )

VOLRpt


VOLRptInterfaces:




VOLRpt

vol-range,vol-list

ACS(acs-id)

LSM( lsm-list )

VOLser( volser

VOLume(vol-range

,vol-list

)volser

SORT(VOLINSLOCSEL

)ASCend

NOSORT

INCLude(

,*SCRNONSCRERRNONERRSELNONSELREADableUNREADableMEDEQUALNONMEDEQ

NOEXTernal

EXCLude(,

SCRNONSCRERRNONERRSELNONSELREADableUNREADableMEDEQUALNONMEDEQ

NOEXTernal

))

NOVOL SUMMary( TOTalSUBpoolTOTal,SUBpool

)

)

,

MAXclean(nnnn)

USEMWL

VAULT

MWLNAMWLGE nnn

MWLNAMWLGE nnn

DEScend

VTVMAINT


VTVMAINTInterfaces:




VTVMAINT

MGMTclas(mgmt-clas-name)

VTVid(

vol-list

vol-rangevolser

,

)ULINKMVC

(volser)

DISMOUNT VTSSid(name)

OWNRPLEX(name) DELEXpot(name) ADDEXpot(name)

RENVTSS(vtss-name)

VTVRPt BASIC


VTVRPt BASICInterfaces:




VTVRPt COPIESInterfaces:




VTVRPtVTVid( volser

vol-range

vol-list,

)

MANIFEST(ddname)

ALLOPTION(UNAVAIL)SUPEMPTY

BASIC

VTVRPtVTVid( volser

vol-range

vol-list,

)

MANIFEST(ddname)

COPIESALLOPTION(UNAVAIL)SUPEMPTY

Warn


WarnInterfaces:




WarnSUBpool(subpool-name)

SCRatch acs-idlsm-idVSM

THReshld(threshold-value)

MEDia(media-type) RECtech( recording-technique )

Date post:	24-May-2020
Category:	Documents
Upload:	others
View:	31 times
Download:	0 times

ELS 7.1 Syntax Quick Reference - Oracle · iv ELS 7.1 Syntax Quick Reference • October 2010...

Documents