Sun Microsystems Sun StorageTek VSM GUI User manual

Sun StorageTek™
VSM GUI
Getting Started Guide
312651601
Version 6.2
Rev A

Sun Microsystems, Inc.
www.sun.com
Submit comments about this document at: http://www.sun.com/hwdocs/feedback
Sun StorageTek™ VSM GUI
Getting Started Guide
Version 6.2.0
Part No. 312651601
July 2007, Revision A

Copyright © 2007 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. All rights reserved.
U.S. Government Rights - Commercial software. Government users are subject to the Sun Microsystems, Inc. standard license
agreement and applicable provisions of the FAR and its supplements.
Use is subject to license terms.
This distribution may include materials developed by third parties.
Sun, Sun Microsystems, the Sun logo, Sun StorageTek and StorageTek are trademarks or registered trademarks of Sun Microsystems,
Inc. in the U.S. and other countries.
This product uses the mozXPath JavaScript code created by [e-mail]. The mozXPath is available under the Creative
Commons Attribution-ShareAlike License.
This product uses the tigra menu JavaScript code created by Soft Complex. The tigra menu is available under the Soft Complex license
and royalty terms and conditions.
This product uses the IFRAME scroller DHTML scripts code created by Dynamic Drive. The IFRAME scroller is available under the
Dynamic Drive DHTML scripts- Terms of Use.
This product is covered and controlled by U.S. Export Control laws and may be subject to the export or import laws in other countries.
Nuclear, missile, chemical biological weapons or nuclear maritime end uses or end users, whether direct or indirect, are strictly
prohibited. Export or reexport to countries subject to U.S. embargo or to entities identified on U.S. export exclusion lists, including, but
not limited to, the denied persons and specially designated nationals lists is strictly prohibited.
Copyright © 2007 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, Etats-Unis. Tous droits réservés.
L'utilisation est soumise aux termes de la Licence.
Cette distribution peut comprendre des composants développés par des tierces parties.
Sun, Sun Microsystems, le logo Sun, Sun StorageTek et StorageTek sont des marques de fabrique ou des marques déposées de Sun
Microsystems, Inc. aux Etats-Unis et dans d'autres pays.
Ce produit emploie le code de mozXPath JavaScript cree par [email protected] et est disponible sous le Creative Commons
Attribution-ShareAlike License.
Ce produit emploie le code de tigra menu JavaScript cree par Soft Complex et est disponible sous le Soft Complex license and royalty
terms and conditions.
Ce produit emploie le code de IFRAME scroller DHTML scripts cree par Dynamic Drive et est disponible sous le Dynamic Drive
DHTML scripts- Terms of Use.
Ce produit est soumis à la législation américaine en matière de contrôle des exportations et peut être soumis à la règlementation en
vigueur dans d'autres pays dans le domaine des exportations et importations. Les utilisations, ou utilisateurs finaux, pour des armes
nucléaires,des missiles, des armes biologiques et chimiques ou du nucléaire maritime, directement ou indirectement, sont strictement
interdites. Les exportations ou réexportations vers les pays sous embargo américain, ou vers des entités figurant sur les listes
d'exclusion d'exportation américaines, y compris, mais de manière non exhaustive, la liste de personnes qui font objet d'un ordre de ne
pas participer, d'une façon directe ou indirecte, aux exportations des produits ou des services qui sont régis par la législation
américaine en matière de contrôle des exportations et la liste de ressortissants spécifiquement désignés, sont rigoureusement
interdites.
We welcome your feedback. Please contact the Sun Learning Services Feedback System at:
[email protected]
or
Sun Learning Services
Sun Microsystems, Inc.
One StorageTek Drive
Louisville, CO 80028-3256
USA
Please include the publication name, part number, and edition number in your correspondence if they are
available. This will expedite our response.

312651601 • Rev A Revision History iii
Revision History
Short
Name EC Part Number Rev Date Comments
VSM GUI 132812 312651601 Rev A July 2007 VSM GUI 6.2.0 Getting Started Guide

iv VSM GUI Getting Started Guide • July 2007 Rev A • 312651601

312651601 • Rev A v
Contents
Preface xi
Audience xi
Prerequisites xi
What’s New in this Release xi
How this Guide is Organized xii
Additional Information xii
Related Publications xv
1. What is the VSM GUI? 1
2. Installing and Configuring the VSM GUI 3
VSM GUI Installation Summary and Checklist 3
Verify VSM GUI Hardware Prerequisites 4
Verify VSM GUI Software Prerequisites 4
Verify Installation Materials 4
Load VSM GUI from Tape or CD-ROM Media 5
Product Installation Tape Contents 5
Product Installation CD-ROM Contents 6
VSM GUI FMIDs 11
Unload the VSM GUI SMP/E JCL Data Set 12
Unloading VSM GUI SMP/E JCL Data Set from Tape 12
Unloading VSM GUI SMP/E JCL Data Set from CD-ROM 12
Set Up the SMP/E Environment and Install the Software 13
APF Authorize the VSM GUI Libraries 18
Customize the VSM GUI Startup Proc 18

vi VSM GUI Getting Started Guide • July 2007 Rev A • 312651601
Customize the VSM GUI Parameter File 19
VSM GUI Server Configuration Parameters 19
Network Parameters 19
Security Parameters 20
Content Parameters 22
Miscellaneous Parameters 22
Start the VSM GUI Server 25
Connect to the VSM GUI Server 26
Control the VSM GUI Server 26
3. Installing PTFs for VSM GUI 27
Installing the PTFs 27
4. Installing Service Tapes for VSM GUI 29
Service Tape Contents 30
Unload the SMP/E JCL Data Set from the Service Tape 30
Installing a Service Tape 31
A. VSM GUI Messages and Codes 33
VSM GUI Messages 33
VTCS PGMI Return Codes 45

312651601 • Rev A List of Figures vii
List of Figures
FIGURE 1-1 VSM GUI Home Page 2
FIGURE 2-1 JCL to Unload the VSM GUI 6.2.0 SMP/E JCL 12
FIGURE 4-1 JCL to Unload the VSM GUI Service Tape SMP/E JCL 31

viii VSM GUI Getting Started Guide • July 2007 Rev A • 312651601

312651601 • Rev A List of Tables ix
List of Tables
TABLE 2-1 VSM GUI Installation Summary and Checklist 3
TABLE 2-2 VSM GUI PC Hardware Requirements 4
TABLE 2-3 VSM GUI Software Requirements 4
TABLE 2-4 VSM GUI 6.2.0 Product Installation Tape Contents 5
TABLE 2-5 VSM GUI 6.2.0 Product Installation CD-ROM Contents 6
TABLE 2-6 SMP/E Target Library Contents 15
TABLE 2-7 SMP/E Distribution Library Contents 17
TABLE 2-8 VSM GUI Authorization Levels and Commands 21
TABLE 4-1 File Names for VSM GUI Service Tapes 30

xVSM GUI Getting Started Guide • July 2007 Rev A • 312651601

312651601 • Rev A xi
Preface
The Virtual Storage Manager Graphical User Interface (VSM GUI) is a Web-based GUI
which communicates with the Sun StorageTek MVS HTTP server to provide a point-
and-click alternative interface to the mainframe VTCS commands and utilities.
Audience
This guide is for Sun StorageTek or customer personnel who are responsible for
installing and configuring the VSM GUI.
Prerequisites
To perform the tasks described in this guide, you should already understand the
following:
■MVS or OS/390 operating system
■JES2 or JES3
■System Modification Program Extended (SMP/E)
■Nearline Control Solution (NCS)
■Virtual Tape Control System (VTCS)
■PC hardware, operating systems, and Internet browsers.
What’s New in this Release
VSM GUI 6.2.0 is graphical interface that supports all VTCS 6.0, 6.1, and 6.2 commands
and functions. No other VTCS releases are supported. Refer to the VTCS 6.0, 6.1, and
6.2 documentation for details about “what’s new” for a specific release of VTCS.

xii VSM GUI Getting Started Guide • July 2007 Rev A • 312651601
How this Guide is Organized
This guide contains the following sections:
■Chapter 1, “What is the VSM GUI?”
■Chapter 2, “Installing and Configuring the VSM GUI”
■Chapter 3, “Installing PTFs for VSM GUI”
■Chapter 4, “Installing Service Tapes for VSM GUI”
■Appendix A, “VSM GUI Messages and Codes”
Additional Information
Sun Microsystems, Inc. (Sun) offers several methods for you to obtain additional
information.
Sun’s External Web Site
Sun’s external Web site provides marketing, product, event, corporate, and service
information. The external Web site is accessible to anyone with a Web browser and
an Internet connection.
■The URL for the Sun external Web site is: http://www.sun.com
■The URL for Sun StorageTek brand-specific information is:
http://www.storagetek.com
Customer Resource Center
The Sun StorageTek product Customer Resource Center (CRC) is a Web site that
enables members to resolve technical issues by searching code fixes and technical
documentation for StorageTek brand products. CRC membership entitles you to
other proactive services, such as HIPER subscriptions, technical tips, answers to
frequently asked questions, addenda to product documentation books, and online
product support contact information.

312651601 • Rev A Preface xiii
Customers who have a current warranty or a current maintenance service agreement
may apply for membership by clicking on the Request Password button on the CRC
home page. Sun employees may enter the CRC through the SunWeb PowerPort.
The URL for the CRC is http://www.support.storagetek.com
Partners Site
The StorageTek Partners site is a Web site for partners with a StorageTek Partner
Agreement. This site provides information about products, services, customer support,
upcoming events, training programs, and sales tools to support StorageTek Partners.
Access to this site, beyond the Partners Login page, is restricted. On the Partners Login
page, Sun employees and current partners who do not have access can request a login
ID and password and prospective partners can apply to become StorageTek resellers.
The URL for the StorageTek Partners site is: http://members.storagetek.com
The URL for partners with a Sun Partner Agreement is:
http://www.sun.com/partners/
Third-Party Web Sites
Sun is not responsible for the availability of third-party web sites mentioned in this
document. Sun does not endorse and is not responsible or liable for any content,
advertising, products, or other materials that are available on or through such sites or
resources. Sun will not be responsible or liable for any actual or alleged damage or loss
caused by or in connection with the use of or reliance on any such content, goods, or
services that are available on or through such sites or resources.
Hardcopy Publications
Contact a Sun sales or marketing representative to order additional paper copies of this
publication or to order other StorageTek brand product customer publications in paper
format.
Customer Support
Customer support is available 24 hours a day, seven days a week, to customers with
Sun or StorageTek maintenance contracts and to Sun employees. You can find
additional information about customer support on the Customer Resource Center
(CRC) Web site at: http://www.support.storagetek.com

xiv VSM GUI Getting Started Guide • July 2007 Rev A • 312651601
Customer-initiated Maintenance
Customer-initiated maintenance begins with a telephone call from you to Sun
Microsystems StorageTek Support. You receive immediate attention from qualified
personnel, who record problem information and respond with the appropriate level of
support.
To contact Sun Microsystems StorageTek Support about a
problem:
1. Use the telephone and call:
800.872.4786 (1.800.USA.4Sun)
800.722.4786 (Canada)
For international locations, go to
http://www.sun.com/service/contacting/solution.html
for the appropriate telephone number
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
Sun’s Worldwide Offices
You may contact any of Sun’s worldwide offices to discuss complete storage, service,
and support solutions for your organization. You can find address and telephone
number information on Sun’s external Web site at:
http://www.sun.com/worldwide/

312651601 • Rev A Preface xv
Related Publications
The following publications provide additional information about VSM and Sun
StorageTek Automated Cartridge System software and hardware.
NCS/VTCS
■Introducing VSM
■NCS/VTCS XML Guide
■NCS Installation Guide
VTCS and VSM
The VTCS and VSM documentation set consists of the following:
■Installing and Configuring VTCS
■Managing VTCS
■Beyond the Basics: VTCS Leading Edge Techniques
■VTCS Command and Utility Reference
■VTCS Messages and Codes
■VTCS Quick Reference
■The VTCS Information CD-ROM, containing PDF file formats of the preceding
publications
VTSS
■Virtual Storage Manager Planning, Implementation, and Usage Guide
■Virtual Storage Manager Physical Planning Guide
■VTSS Installation Guide
HSC
■Configuration Guide
■Operators Guide
■System Programmers Guide
■Messages and Codes
■System Programmers Reference Summary
■Operators Reference Summary

xvi VSM GUI Getting Started Guide • July 2007 Rev A • 312651601

312651601 • Rev A 1
CHAPTER 1
What is the VSM GUI?
The VSM GUI is a Web-based tool that lets you “point and click” instead of entering
VTCS commands or running VTCS utilities. The VSM GUI consists of a World Wide
Web (WWW) application and a web server to provide network connectivity for WWW
browsers. The server component is a multitasking MVS HTTP content server that runs
as an MVS started task.
The VSM GUI 6.2.0 supports all VTCS 6.0.0, 6.1.0 and 6.2.0 commands and utilities,
including the CONFIG utility. It does not support the standalone RTV utility or the
HSC commands and utilities.
The VSM GUI also lets you drive VTCS functions from the output of a command or
utility. For example, you can run an MVC or VTV report, sort it by any column, then
run VTCS operations against a selected MVC or VTV.
Similarly, you can run Query RTD, then right click on any of the RTDs listed on the
response to bring up a menu that displays the Audit, Config, Decom, Query Config,
Query RTD, and Vary RTD commands. You can then select a command and a web
page for that command appears with the RTD field filled in with information for the
RTD you selected.
FIGURE 1-1 shows the VSM GUI home page.

2VSM GUI Getting Started Guide • July 2007 Rev A • 312651601
FIGURE 1-1 VSM GUI Home Page