Sun StorageTek™ VSM GUI Getting Started Guide 312651601 Rev A Version 6.
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.
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.
Revision History Short Name EC Part Number Rev Date Comments VSM GUI 132812 312651601 Rev A July 2007 VSM GUI 6.2.
iv VSM GUI Getting Started Guide • July 2007 Rev A • 312651601
Contents Preface Audience xi xi Prerequisites xi What’s New in this Release xi How this Guide is Organized Additional Information Related Publications xii xii xv 1. What is the VSM GUI? 1 2.
Customize the VSM GUI Parameter File 19 VSM GUI Server Configuration Parameters Network Parameters Security Parameters Content Parameters 19 20 22 Miscellaneous Parameters Start the VSM GUI Server 22 25 Connect to the VSM GUI Server Control the VSM GUI Server 3. 4. 26 26 Installing PTFs for VSM GUI Installing the PTFs 19 27 27 Installing Service Tapes for VSM GUI Service Tape Contents 29 30 Unload the SMP/E JCL Data Set from the Service Tape Installing a Service Tape A.
List of Figures FIGURE 1-1 VSM GUI Home Page 2 FIGURE 2-1 JCL to Unload the VSM GUI 6.2.
viii VSM GUI Getting Started Guide • July 2007 Rev A • 312651601
List of Tables TABLE 2-1 VSM GUI Installation Summary and Checklist 3 TABLE 2-2 VSM GUI PC Hardware Requirements TABLE 2-3 VSM GUI Software Requirements TABLE 2-4 VSM GUI 6.2.0 Product Installation Tape Contents TABLE 2-5 VSM GUI 6.2.
x VSM GUI Getting Started Guide • July 2007 Rev A • 312651601
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 pointand-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.
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.
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.
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.
Related Publications The following publications provide additional information about VSM and Sun StorageTek Automated Cartridge System software and hardware.
xvi VSM GUI Getting Started Guide • July 2007 Rev A • 312651601
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.
FIGURE 1-1 VSM GUI Home Page 2 VSM GUI Getting Started Guide • July 2007 Rev A • 312651601
CHAPTER 2 Installing and Configuring the VSM GUI To plan and verify completion of the installation, use the checklist below. VSM GUI Installation Summary and Checklist Use the checklist in TABLE 2-1 to help plan and complete your VSM GUI installation and configuration tasks.
Verify VSM GUI Hardware Prerequisites Verify the VSM GUI PC hardware requirements in TABLE 2-2.
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. CD-ROM: Insert the CD-ROM and open the file named “Start here.html” for procedures that load the VSM GUI files from the CD-ROM and then refer you back to this chapter to continue the SMP/E installation.
TABLE 2-4 VSM GUI 6.2.0 Product Installation Tape Contents File Data Set Name Description 20 SSKU620.F10 VSM GUI www modules 21 SSKU620.F11 VSM GUI www modules 22 SSKU620.F12 VSM GUI www modules 23 SSKU620.F13 VSM GUI www modules 24 SSKU620.F14 VSM GUI www modules 25 SSKU620.F15 VSM GUI www modules 26 SSKU620.F16 VSM GUI www modules 27 SSKU620.F17 VSM GUI www modules 28 SSKU620.F18 VSM GUI www modules 29 SSKU620.F19 VSM GUI www modules 30 SSKU620.
TABLE 2-5 VSM GUI 6.2.0 Product Installation CD-ROM Contents 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.
TABLE 2-5 VSM GUI 6.2.0 Product Installation CD-ROM Contents 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 UNIX text file representation of sample JCL member /cdrom/Samples U2APPLY.
TABLE 2-5 VSM GUI 6.2.0 Product Installation CD-ROM Contents 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 DOS text file representation of sample JCL member /cdrom/Samples.win I7APPLY.
TABLE 2-5 VSM GUI 6.2.0 Product Installation CD-ROM Contents Directory File Name Description /cdrom/VGUI62.gimzip/SMPPTFIN Storage.Tek0037.L1K0003.SMPPTFIN.pax.Z SMPNTS binary file of HTTPD 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.
TABLE 2-5 VSM GUI 6.2.0 Product Installation CD-ROM Contents 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.
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 TABLE 2-4 for more information. Use the JCL in FIGURE 2-1 to create a copy of the SMP/E JCL from file 33 of the product installation tape to help install the VSM GUI. jobcard JOB 'accounting information' //* //* //* LOAD PDS FROM UNLOADED DATASET //* //LOAD EXEC PGM=IEBCOPY //SYSUT3 DD UNIT=VIO,SPACE=(CYL,(20,3)) //IN1 DD DSN=SMPE.
■ 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. Otherwise, unpredictable results may occur.
▼ 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. Before use, first copy these two members to a library in your SYSPROC concatenation, then change the job settings in @SKUEDIT to the appropriate settings for the site.
■ 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. Modify this job to exclude the PTFs already applied in your SMP/E environment. 5. TAPE ONLY: Run customized member I5RCV to RECEIVE the PTFs required for HTTPD and SAS/C FMIDs.
TABLE 2-6 SMP/E Target Library Contents Data Set Name ENSAMP Contents 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 web content VSM.EN.HOME web content VSM.EN.IMAGES web content VSM.EN.REPORTS web content VSM.EN.REPORTS.
9. Run customized member I9ACCEPT to ACCEPT the VSM GUI FMID.
10. Run the customized member S1COPY to copy the customizable members to a nonSMP/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. When the copy has successfully completed, there will be a new data set, STKPARM, to which you can apply your site customization. Refer to the data set members SKUPROC and SKUPRM00 for sample templates to use.
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. Comment lines start with a hash character (#).
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).
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. The file entries take the format: userid userid_name password [access_level] access_level is read, update, control or alter. The default access level is read.
TABLE 2-8 VSM GUI Authorization Levels and Commands 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.
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. Cookieexpires time Specifies the period after which browser cookies expire. dirlists yes|no Enables generation of virtual directory listings, default is yes. deny xxx.xxx.xxx.
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. The default is no limit. maxpasswordlength number Sets the maximum allowed length of a password. Defaults to 8 characters.
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. Default is /. sendbuffersize value Changes the TCP send buffer size if authorized. Valid range is 4096 to 65536.
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/ Control the VSM GUI Server By default, when the VSM GUI server is started, it uses the SKYPRM00 member in STKPARM.
CHAPTER 3 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” on page 3. For information on accessing the CRC, see “Customer Resource Center” on page xii.
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 linkedit processing of modules into the STKLOAD library should complete with a return code 0. 6. Run member V3ACCEPT to ACCEPT the VSM GUI FMIDs. Use the same BYPASS parameters that were used in the APPLY job.
CHAPTER 4 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” on page 27. Before you install a service tape, VSM GUI must be installed as described in “Installing and Configuring the VSM GUI” on page 3.
Service Tape Contents Table 4-1 lists the file names contained in a service tape. TABLE 4-1 File Names for VSM GUI Service Tapes File Number Data Set Name Description 1 SMPPTFIN Corrective Service PTFs. For a PUT, these are the PTFs for the current PUT level. 2 PTFLIST List of Corrective Service PTFs contained on file 1 3 SMPEJCL Service Tape Installation JCL (Optional) 4 SMPHOLD SMP/E external hold statements 5 JCLIN SMP/E JCLIN 6 UCLIN SMP/E UCLIN 7 PUTCUM Cumulative Service PTFs.
//jobcard //* // //SYSPRINT //SYSIN //* //SYSUT1 // // //* //SYSUT2 // // //* FIGURE 4-1 JOB ‘accounting information’ EXEC PGM=IEBCOPY DD SYSOUT=* DD DUMMY DD DSN=SMPEJCL,DISP=(OLD,KEEP), UNIT=3480, LABEL=(3,SL,EXPDT=98000),VOL=SER=VTyynn 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 Installing a Service Tape Install the contents of a service tape using the following procedure. 1.
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 linkedit processing of modules into the STKLOAD library should complete with a return code 0. 6. Run member U3ACCEPT to ACCEPT the SYSMODs. Use the same BYPASS parameters that were used in the APPLY job.
APPENDIX A 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. The server shuts down. SKY003I name ready to accept requests The server name is ready for normal operation.
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.
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.
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 request. SKY048E abend_message_line Message number for abend reporting messages.
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. SKY054E Fatal error in main task, attempting orderly shutdown The server has suffered a fatal error in its main task and is attempting to do an orderly shutdown SKY055I Forcibly terminating task t The task t will be forcibly terminated.
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. SKY067I Buffer pool limit: nn current: mm Shows request buffer pool utilization, pool limit and current values.
SKY072I Loaded module Module was loaded as requested by a LOADMODULE parameter. SKY073E Connection socket 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 Reason: rc= code= The dataset could not be allocated due to reason , dynamic allocation return code and code .
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.
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. SKY115I Commencing server shutdown The server has started shutting down.
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 client at ip address xxx.xxx.xxx.xxx SKY123E Task t, connection eof from xxx.xxx.xxx.
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. SKY131I hhh handler shutting down The handler hhh task has started shutting down.
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. A server busy request is returned to the client. If this condition occurs frequently consider increasing the maximum limit of worker tasks to a value where this is a rare occurrence.
VTCS PGMI Return Codes TABLE A-1 VTCS PGMI Return Codes Return Code Reason Code Description 16 36 Non-zero POST code from SWSPGMIS - probable abend 16 48 Attach for SWSPGMIS task failed 32 0 PGMI interface area not present or not valid 32 4 Request area not present or length not between 0 and 32000.
46 VSM GUI Getting Started Guide • July 2007 Rev A • 312651601
Index A N APF Authorize the VSM GUI Libraries, 18 Authorize the VSM GUI Libraries, 18 Network Parameters, 19 C Parameter File, 19 PTFs for VSM GUI, 27 Configuring the VSM GUI, 3 Connect to the VSM GUI Server, 26 Content Parameters, 22 contents, CUM tape, 30 Control the VSM GUI Server, 26 CUM tape contents, 30 Customize the VSM GUI Parameter File, 19 Customize the VSM GUI Startup Proc, 18 D Distribution Library Contents, 17 F FMIDs, 11 H Hardware Prerequisites, 4 I Install the Software, 13 installa
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 W What is the VSM GUI?, 1 48 VSM GUI Getting Started Guide • July 2007 Rev A • 312651601
Sun Microsystems, Inc. 4150 Network Circle, Santa Clara, CA 95054 USA Phone 1-650-960-1300 or 1-800-555-9SUN Web sun.
