Sun Microsystems Sun StorageTek VSM GUI Getting Started Manual
  1. Manuals
  2. Brands
  3. Sun Microsystems Manuals
  4. Software
  5. Sun StorageTek VSM GUI
  6. Getting started manual
Sun Microsystems Sun StorageTek VSM GUI Getting Started Manual

Sun Microsystems Sun StorageTek VSM GUI Getting Started Manual

Hide thumbs
Table of Contents

Advertisement

Quick Links

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

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Sun StorageTek VSM GUI and is the answer not in the manual?

Questions and answers

Related Manuals for Sun Microsystems Sun StorageTek VSM GUI

Summary of Contents for Sun Microsystems Sun StorageTek VSM GUI

  • Page 1 Sun StorageTek™ VSM GUI Getting Started Guide 312651601 Rev A Version 6.2...
  • Page 3 Sun StorageTek™ VSM GUI Getting Started Guide Version 6.2.0 Sun Microsystems, Inc. www.sun.com Part No. 312651601 July 2007, Revision A Submit comments about this document at: http://www.sun.com/hwdocs/feedback...
  • Page 4 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.

  • Page 5: Revision History

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

  • Page 7: Table Of Contents

    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 What is the VSM GUI? 1 Installing and Configuring the VSM GUI 3 VSM GUI Installation Summary and Checklist Verify VSM GUI Hardware Prerequisites Verify VSM GUI Software Prerequisites Verify Installation Materials 4...
  • Page 8 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 Installing PTFs for VSM GUI 27 Installing the PTFs 27 Installing Service Tapes for VSM GUI 29...
  • Page 9 List of Figures VSM GUI Home Page 2 FIGURE 1-1 JCL to Unload the VSM GUI 6.2.0 SMP/E JCL 12 FIGURE 2-1 JCL to Unload the VSM GUI Service Tape SMP/E JCL 31 FIGURE 4-1 312651601 • Rev A List of Figures vii...
  • Page 10 viii VSM GUI Getting Started Guide • July 2007 Rev A • 312651601...
  • Page 11 List of Tables VSM GUI Installation Summary and Checklist 3 TABLE 2-1 VSM GUI PC Hardware Requirements 4 TABLE 2-2 VSM GUI Software Requirements 4 TABLE 2-3 VSM GUI 6.2.0 Product Installation Tape Contents 5 TABLE 2-4 VSM GUI 6.2.0 Product Installation CD-ROM Contents 6 TABLE 2-5 SMP/E Target Library Contents 15 TABLE 2-6...
  • Page 12 x VSM GUI Getting Started Guide • July 2007 Rev A • 312651601...

  • Page 13: Preface

    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.

  • Page 14: How This Guide Is Organized

    ■ 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.

  • Page 15: Customer Support

    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.
  • Page 16 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)

  • Page 17: Related Publications

    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 ■...
  • Page 18 xvi VSM GUI Getting Started Guide • July 2007 Rev A • 312651601...

  • Page 19: What Is The Vsm Gui

    C H A P T E R 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.
  • Page 20 VSM GUI Home Page FIGURE 1-1 2 VSM GUI Getting Started Guide • July 2007 Rev A • 312651601...

  • Page 21: Installing And Configuring The Vsm Gui

    C H A P T E R Installing and Configuring the VSM To plan and verify completion of the installation, use the checklist below. VSM GUI Installation Summary and Checklist Use the checklist in to help plan and complete your VSM GUI installation and TABLE 2-1 configuration tasks.

  • Page 22: Verify Vsm Gui Hardware Prerequisites

    Verify VSM GUI Hardware Prerequisites Verify the VSM GUI PC hardware requirements in TABLE 2-2 VSM GUI PC Hardware Requirements TABLE 2-2 Hardware Description Minimum Requirement Recommended System System unit Pentium III, 512MB of memory, 256 colors, mouse Pentium IV, 1024MB of memory, 64K colors, mouse CD-ROM drive present...

  • Page 23: Load Vsm Gui From Tape Or Cd-Rom Media

    Load VSM GUI from Tape or CD-ROM Media The installation process is the same for each media except for the actual loading of the software from the product installation tape or CD-ROM: Tape: Follow the instructions below to load and SMP/E install VSM GUI. ■...

  • Page 24: Product Installation Cd-Rom Contents

    VSM GUI 6.2.0 Product Installation Tape Contents TABLE 2-4 File Data Set Name Description SSKU620.F10 VSM GUI www modules SSKU620.F11 VSM GUI www modules SSKU620.F12 VSM GUI www modules SSKU620.F13 VSM GUI www modules SSKU620.F14 VSM GUI www modules SSKU620.F15 VSM GUI www modules SSKU620.F16 VSM GUI www modules...
  • Page 25 VSM GUI 6.2.0 Product Installation CD-ROM Contents TABLE 2-5 Directory File Name Description /cdrom/Documents fromnetwork.html CD-ROM installation Web file /cdrom/Documents index.html CD-ROM installation Web file /cdrom/Documents logoab8.gif CD-ROM installation Web file /cdrom/Documents pax.html CD-ROM installation Web file /cdrom/Samples @@NOTES.samp UNIX text file representation of sample JCL member /cdrom/Samples @SKUEDIT.samp...
  • Page 26 VSM GUI 6.2.0 Product Installation CD-ROM Contents TABLE 2-5 Directory File Name Description /cdrom/Samples I7APPLY.samp UNIX text file representation of sample JCL member /cdrom/Samples I9ACCEPT.samp UNIX text file representation of sample JCL member /cdrom/Samples NETVGUI.samp UNIX text file representation of sample JCL member /cdrom/Samples S1COPY.samp...
  • Page 27 VSM GUI 6.2.0 Product Installation CD-ROM Contents TABLE 2-5 Directory File Name Description /cdrom/Samples.win C2ZONES.samp DOS text file representation of sample JCL member /cdrom/Samples.win I1DDDEFS.samp DOS text file representation of sample JCL member /cdrom/Samples.win I3ALLOC.samp DOS text file representation of sample JCL member /cdrom/Samples.win I5RCV.samp...
  • Page 28 VSM GUI 6.2.0 Product Installation CD-ROM Contents TABLE 2-5 Directory File Name Description /cdrom/VGUI62.gimzip/SMPPTFIN SMPNTS binary file of HTTPD Storage.Tek0037.L1K0003.SMPPTFIN.pax.Z PTF control statements /cdrom/VGUI62.gimzip/SMPPTFIN Storage.Tek0040.L1K0006.SMPPTFIN.pax.Z SMPNTS binary file of HTTPD PTF control statements /cdrom/VGUI62.gimzip/SMPRELF Storage.Tek.SSKY500.F1.pax.Z SMPNTS binary file of HTTPD server JCLIN /cdrom/VGUI62.gimzip/SMPRELF Storage.Tek.SSKY500.F2.pax.Z...

  • Page 29: Vsm Gui Fmids

    VSM GUI 6.2.0 Product Installation CD-ROM Contents TABLE 2-5 Directory File Name Description /cdrom/VGUI62.gimzip/SMPRELF Storage.Tek.SSKU620.F12.pax.Z SMPNTS binary file of VSM GUI www modules /cdrom/VGUI62.gimzip/SMPRELF Storage.Tek.SSKU620.F13.pax.Z SMPNTS binary file of VSM GUI www modules /cdrom/VGUI62.gimzip/SMPRELF Storage.Tek.SSKU620.F14.pax.Z SMPNTS binary file of VSM GUI www modules /cdrom/VGUI62.gimzip/SMPRELF Storage.Tek.SSKU620.F15.pax.Z...

  • Page 30: Unload The Vsm Gui Smp/E Jcl Data Set

    Unload the VSM GUI SMP/E JCL Data Set Unloading VSM GUI SMP/E JCL Data Set from Tape The VSM GUI SMP/E JCL Data Set contains sample JCL members for the VSM GUI; see for more information. Use the JCL in to create a copy of the SMP/E TABLE 2-4 FIGURE 2-1...

  • Page 31: Set Up The Smp/E Environment And Install The Software

    ICSF available; CD-ROM not on FTP server ■ Receive from Local Host ICSF not available ■ Receive from NTS Set Up the SMP/E Environment and Install the Software Caution – Do not install the VSM GUI and its supporting SAS/C functions in an SMP/E CSI containing other Sun StorageTek products with SAS/C functions you want to preserve.
  • Page 32 To set up the SMP/E environment and install the software: ▼ 1. Customize the installation jobs. You can do this manually with an editor, but it is recommended that you use the provided ISPF edit macro @SKUEDIT and @SKURUN REXX exec for automated updates of an individual member or all members.

  • Page 33: Table 2-6 Smp/E Target Library Contents

    CD-ROM ONLY: Run customized member NTSVGUI to RECIEVE from an SMPNTS ■ hierarchy the HTTPD, SAS/C, required PTFs for HTTPD and SAS/C and VSM GUI FMIDs. Modify this job to exclude the SSKY500 and ASAR700 FMIDs if you already have the HTTPD server and SAS/C run time received in your SMP/E environment.
  • Page 34 SMP/E Target Library Contents TABLE 2-6 Data Set Name Contents ENSAMP VSM GUI sample material TRANS web content file translations VSM.EN.ABOUT web content VSM.COMMS web content VSM.COMMS.W3C web content VSM.EN.CONFIG web content VSM.EN.CONFIG.W3C web content VSM.EN.DOCS web content VSM.EN.DOCS.WHDATA web content VSM.EN.DOCS.WHGDATA web content VSM.EN.DOCS.WHXDATA...
  • Page 35 9. Run customized member I9ACCEPT to ACCEPT the VSM GUI FMID. When the ACCEPT is successful, the SMP/E distribution libraries contain the following data sets: SMP/E Distribution Library Contents TABLE 2-7 Data Set Name Contents AENABT web content AENCFG web content AENCFGW web content AENCMS...

  • Page 36: Apf Authorize The Vsm Gui Libraries

    10. Run the customized member S1COPY to copy the customizable members to a non- SMP/E controlled data set. Important: You must modify the S1COPY JCL line that contains step "//IN1" for the DSN parameter. Change the default sample data set STKSAMP to the VSM GUI sample data set ENSAMP.

  • Page 37: Customize The Vsm Gui Parameter File

    Customize the VSM GUI Parameter File The VSM GUI sample startup proc SKUPROC calls the sample parameter file SKUPRM00 from the STKPARM data set. See the following sections for more information and modify the values in SKUPRM00 for your site’s needs from the STKPARM data set. The HTTP server parameter file is formatted with one parameter setting per line, continuation onto following lines is not supported.

  • Page 38: Security Parameters

    serverdomain domain The server domain name reported in responses; for example, yourcompany.com. The default is all blanks. port pppp The IP network port the server listens on for connections. The default is port 80, the standard HTTP port. The effective IP network port must be accessible for use by the server and it must not be reserved for use by another jobname (that is, by the TCP/IP PORT or PORTRANGE configuration statements).

  • Page 39: Table 2-8 Vsm Gui Authorization Levels And Commands

    The target data set can be a sequential data set or a PDS/PDSE member. The default is DDN:SKYPSWD which, in the sample startup proc SKYPROC, references the sample userlist in STKPARM. security {file | saf} Specifies the userid verification method: file Userid information is verified against the entries in the specified text file.

  • Page 40: Content Parameters

    VSM GUI Authorization Levels and Commands TABLE 2-8 Commands Authorization Level Config Alter Decom Alter Set Migration Options Alter Content Parameters updated date The date and time (gmt) when the web content was last updated in an installation or PTF update. This parameter is required. For example: fri, 06 dec 2002 3:54:00 gmt translationfile file Specifies the data set containing the GUI data set name translations.
  • Page 41 cgionly yes|no Only allow CGI processing, default is no. Caution that this parameter MUST NOT be set to yes if using any GUI application as it will disable the GUI. closetimeout period Sets the request timeout (in seconds) on a client connection. The allowed range is 5 to 60 seconds, default is 30 seconds.
  • Page 42 loadmodule module Preloads the specified CGI module. The default is to dynamically load and unload such modules as required. maxclients number Specifies the maximum number of worker tasks that can run. maxrequestsperchild number Sets the maximum number of requests to be serviced by a worker task before it is restarted.

  • Page 43: Start The Vsm Gui Server

    Startservers number Specifies the default number of running worker tasks. Serveradmin admin Identifies the server administrator e-mail address on directory listings. secure level Specifies the directory levels under which security verification is required. It can be specified for each application but for efficiency it is recommended to have as few as possible.

  • Page 44: Connect To The Vsm Gui Server

    Connect to the VSM GUI Server Specify the URL of the server in the browser window. For example, to connect to the web server running on the MVS system lstcrmvs in the production domain on port 8888 the URL is: http://lstcrmvs.stortek.com:8888/ To connect to this server using default port 80: http://lstcrmvs.stortek.com/...

  • Page 45: Installing Ptfs For Vsm Gui

    C H A P T E R Installing PTFs for VSM GUI This chapter describes how to install the corrective service PTFs for VSM GUI, which you can download from the Sun StorageTek Customer Resource Center at: http://www.support.storagetek.com. Note – Before you install PTFs, you must install VSM GUI as described in “Installing and Configuring the VSM GUI”...
  • Page 46 Note – Expect a return code of 04 with SMP/E message GIM23903W for link-edit processing of VSM GUI modules into the SKYRTNS and SKURTNS libraries. The Binder message IEW2454W is generated for each routine linked into these libraries. The link- edit processing of modules into the STKLOAD library should complete with a return code 6.

  • Page 47: Installing Service Tapes For Vsm Gui

    C H A P T E R Installing Service Tapes for VSM GUI This chapter describes tells how to install service tapes for VSM GUI. Note that you can also receive service via PTFs downloaded from the Storage CRC as described in “Installing PTFs for VSM GUI”...

  • Page 48: Service Tape Contents

    Service Tape Contents Table 4-1 lists the file names contained in a service tape. File Names for VSM GUI Service Tapes TABLE 4-1 File Number Data Set Name Description SMPPTFIN Corrective Service PTFs. For a PUT, these are the PTFs for the current PUT level. PTFLIST List of Corrective Service PTFs contained on file 1 SMPEJCL...

  • Page 49: Installing A Service Tape

    //jobcard JOB ‘accounting information’ EXEC PGM=IEBCOPY //SYSPRINT DD SYSOUT=* //SYSIN DD DUMMY //SYSUT1 DD DSN=SMPEJCL,DISP=(OLD,KEEP), UNIT=3480, LABEL=(3,SL,EXPDT=98000),VOL=SER=VTyynn //SYSUT2 DD DSN=hlq.SMPE.JCL,DISP=(,CATLG), UNIT=SYSALLDA,SPACE=(TRK,(10,2,10)), DCB=(RECFM=FB,LRECL=80,BLKSIZE=23440) JCL to Unload the VSM GUI Service Tape SMP/E JCL FIGURE 4-1 Installing a Service Tape Install the contents of a service tape using the following procedure. 1.
  • Page 50 Note – Expect a return code of 04 with SMP/E message GIM23903W for link-edit processing of VSM GUI modules into the SKYRTNS and SKURTNS libraries. The Binder message IEW2454W is generated for each routine linked into these libraries. The link- edit processing of modules into the STKLOAD library should complete with a return code 6.

  • Page 51: Vsm Gui Messages And Codes

    A P P E N D I X VSM GUI Messages and Codes VSM GUI Messages SKY001I name Server version starting on system running MVS level httpd server startup message SKY002E Error binding server socket ss, errno=nnn: mmm - terminating The server cannot bind to the specified network port ss due to the error indicated by the errno code nnn and error message mmm.
  • Page 52 SKY006I TCP/IP connection terminated The client connection was terminated. SKY007E Accept error - shutting down There was an error in network connection accept processing. The server shuts down. SKY008E Error reading request There was a network error whilst reading a client request. SKY013I Shutdown command from operator acknowledged The server has received a console command to shutdown.
  • Page 53 SKY026I Task: t Requests: n Client: xxx.xxx.xxx.xxx : pppp Response to a console display client console command. Task t has serviced n requests from the client at IP address xxx.xxx.xxx.xxx port pppp. SKY027I No active client connections The response to a display client command when there are no client connections. SKY030E Missing to/from translation string The data set file name translation is incorrect.
  • Page 54 SKY045E SAF authentication requested but not APF authorized SAF authentication requires caller to be APF authorized but server is not APF authorized. The server will shut down. SKY046E Supplied parm is too long The length of the parameter string parm exceeds the allowed length. SKY047E Unable to open dsname The httpd server was unable to open the data set dsname in response to a client...
  • Page 55 SKY053I Current active worker tasks: t The current number of worker tasks for servicing requests. SKY053E Fatal error in main task, commencing forced shutdown The server has suffered a fatal error in tis main task and was not able to do an orderly shutdown.
  • Page 56 SKY062E Invalid update date: ssss The string ssss is in not a valid date format. SKY064W Dynamic allocation for dataset: ddd error rc=nn reason=rrr info=iii Details the dynamic allocation error codes for a file allocation failure of dataset ddd. SKY065W Unable to open dataset ddd: rrr Shows the reason code rrr why the data set ddd could not be opened.
  • Page 57 SKY072I Loaded module <module> Module <module> was loaded as requested by a LOADMODULE parameter. SKY073E Connection socket <nn> out of range The connection socket exceeds the supported range of sockets. The connection will be dropped and server operation continues. SKY074W Unable to allocate <dsn>...
  • Page 58 SKY103E Cannot open parameter file dsname, terminating The httpd server was unable to open the parameter file dsname. The server shuts down. SKY104E Parameter ppp invalid The parameter ppp is not known. SKY105E Unexpected character c encountered, skipping line When parsing the parameter file an unexpected character was encountered. The parameter is skipped by moving onto the next line.
  • Page 59 SKY112E Cannot create tbl, terminating During initialization the memory table tbl cannot be allocated and the server stops. SKY113E Cannot start task tttt, terminating During initialization, the task tttt could not be started and the server stops. SKY114I Task tttt completed, rc = nn The task tttt completed with return code nn.
  • Page 60 The worker task t was unable to allocate a memory buffer needed for a directory listing SKY121E Task t unable to open directory readme The worker task t encountered an error when attempting to open a directory readme file whilst listing a directory. SKY122E Task ttconnection error with xxx.xxx.xxx.xxx errno error_text The worker task t had a connection error (error number errno, text error_text) with the...
  • Page 61 SKY128E Task t request error nnn msg: description For worker task t, there was an http protocol error for the client request. Code nnn, message msg and description dddd SKY129E ppp out of valid range min ñ max The numeric parameter ppp is outside the allowed range. SKY130I hhh handler ready The handler hhh task has finished initializing and is ready for work.
  • Page 62 SKY136W Out of memory for stack space, requested nnnn bytes A httpd server task was unable to allocate stack memory. SKY138W No free worker tasks, at maximum limit A request has been received but there are no idle worker tasks and the number of tasks is at the maximum limit.

  • Page 63: Vtcs Pgmi Return Codes

    VTCS PGMI Return Codes VTCS PGMI Return Codes TABLE A-1 Return Code Reason Code Description Non-zero POST code from SWSPGMIS - probable abend Attach for SWSPGMIS task failed PGMI interface area not present or not valid Request area not present or length not between 0 and 32000. Required user exits not available Unknown command No matching categories...
  • Page 64 46 VSM GUI Getting Started Guide • July 2007 Rev A • 312651601...
  • Page 65 Index APF Authorize the VSM GUI Libraries, 18 Network Parameters, 19 Authorize the VSM GUI Libraries, 18 Parameter File, 19 Configuring the VSM GUI, 3 PTFs for VSM GUI, 27 Connect to the VSM GUI Server, 26 Content Parameters, 22 Security Parameters, 20 contents, CUM tape, 30 Server Configuration Parameters, 19...
  • Page 66 VSM GUI Hardware Prerequisites, 4 VSM GUI home page, 1 VSM GUI Library Authorization, 18 VSM GUI Messages and Codes, 33 VSM GUI Server Configuration Parameters, 19 VSM GUI Software Prerequisites, 4 VSM GUI Startup Proc, 18 VTCS installation summary and checklist, 3 verifying installation materials, 4 VTCS PGMI Return Codes, 45 VTCS versions supported, 1...
  • Page 67 ORLDWIDE : 1-650-960-1300 EADQUARTERS THE NETWORK IS THE COMPUTER Sun Microsystems, Inc. All rights reserved. Sun, Sun Microsystems, and the Sun logo are trademarks or registered trademarks of Sun Microsystems, Inc. in the SUN™ ©2006 United States and other countries.

This manual is also suitable for:

Storagetek vsm gui

Table of Contents