background image

312651601 • Rev A

3

CH APT ER

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. 

TABLE 2-1 

VSM GUI Installation Summary and Checklist

Task

Mark when Completed

“Verify VSM GUI Hardware Prerequisites” on page 4

“Verify VSM GUI Software Prerequisites” on page 4

“Verify Installation Materials” on page 4

“Load VSM GUI from Tape or CD-ROM Media” on page 5

“Unload the VSM GUI SMP/E JCL Data Set” on page 12

“Set Up the SMP/E Environment and Install the Software” on page 13

“APF Authorize the VSM GUI Libraries” on page 18

“Customize the VSM GUI Startup Proc” on page 18

“Customize the VSM GUI Parameter File” on page 19

“Start the VSM GUI Server” on page 25

Summary of Contents for StorageTek VSM GUI

Page 1: ...Sun StorageTek VSM GUI Getting Started Guide 312651601 Version 6 2 Rev A ...

Page 2: ......

Page 3: ...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 ...

Page 4: ...e 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 km0ti0n gmail com et est disponible sous le Creative Commons Attribution ShareAlike License Ce produit emploie le...

Page 5: ...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 ...

Page 6: ...iv VSM GUI Getting Started Guide July 2007 Rev A 312651601 ...

Page 7: ... 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 Environm...

Page 8: ... 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 C...

Page 9: ...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 ...

Page 10: ...viii VSM GUI Getting Started Guide July 2007 Rev A 312651601 ...

Page 11: ...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 ...

Page 12: ...x VSM GUI Getting Started Guide July 2007 Rev A 312651601 ...

Page 13: ...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 ...

Page 14: ... 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 t...

Page 15: ...om 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 li...

Page 16: ...on 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 addres...

Page 17: ...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 Configu...

Page 18: ...xvi VSM GUI Getting Started Guide July 2007 Rev A 312651601 ...

Page 19: ... 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...

Page 20: ...2 VSM GUI Getting Started Guide July 2007 Rev A 312651601 FIGURE 1 1 VSM GUI Home Page ...

Page 21: ... Summary and Checklist Task Mark when Completed Verify VSM GUI Hardware Prerequisites on page 4 Verify VSM GUI Software Prerequisites on page 4 Verify Installation Materials on page 4 Load VSM GUI from Tape or CD ROM Media on page 5 Unload the VSM GUI SMP E JCL Data Set on page 12 Set Up the SMP E Environment and Install the Software on page 13 APF Authorize the VSM GUI Libraries on page 18 Custom...

Page 22: ...colors mouse Pentium IV 1024MB of memory 64K colors mouse CD ROM drive present present Monitor 1024 x 768 pixels with 256 colors 1280 x 1024 pixels with 64K colors network card present present TABLE 2 3 VSM GUI Software Requirements Software Description PC Windowing System Microsoft Windows XP or newer PC TCP IP for communications between the VSM GUI PC component and the MVS HTTP server The 32 bit...

Page 23: ...files included on the VSM GUI 6 2 0 product installation tape TABLE 2 4 VSM GUI 6 2 0 Product Installation Tape Contents File Data Set Name Description 1 SMPMCS VSM GUI SMP E control statements 2 SSKY500 F1 HTTPD server JCLIN 3 SSKY500 F2 HTTPD load modules 4 SSKY500 F3 HTTPD STKSAMP 5 SSKY500 F4 HTTPD icons 6 ASAR700 F1 SAS C component JCLIN 7 ASAR700 F2 SAS C linked LMODs 8 ASAR700 F3 SAS C link...

Page 24: ...SSKU620 F20 VSM GUI translations 31 SSKU620 F21 VSM GUI STK samples 32 PTF F1 PTFs for HTTPD and SAS C required 33 SMPE JCL HTTPD installation JCL optional TABLE 2 5 VSM GUI 6 2 0 Product Installation CD ROM Contents Directory File Name Description cdrom Start Here html CD ROM installation Web file cdrom VGUI62 pax MPNTS binary file cdrom Documents VGUI62logo png CD ROM installation Web file cdrom...

Page 25: ...L member cdrom Samples I8ACCEPT samp UNIX text file representation of sample JCL member cdrom Samples LOADSAMP samp UNIX text file representation of sample JCL member cdrom Samples NTSVGUI samp UNIX text file representation of sample JCL member cdrom Samples U1RCV samp UNIX text file representation of sample JCL member cdrom Samples U3ACCEPT samp UNIX text file representation of sample JCL member ...

Page 26: ... Samples win C3DDDEFS samp DOS text file representation of sample JCL member cdrom Samples win I2ALLOC samp DOS text file representation of sample JCL member cdrom Samples win I4RCV samp DOS text file representation of sample JCL member cdrom Samples win I6APPLY samp DOS text file representation of sample JCL member cdrom Samples win I8ACCEPT samp DOS text file representation of sample JCL member ...

Page 27: ...le cdrom VGUI62 gimzip SMPPTFIN SMPNTS control file cdrom VGUI62 gimzip SMPRELF SMPNTS control file cdrom VGUI62 gimzip SMPHOLD Storage Tek0001 EMPTY F80 pax Z SMPNTS binary file of SMPHOLD cdrom VGUI62 gimzip SMPPTFIN Storage Tek0002 ASAR700 SMPPTFIN pax Z SMPNTS binary file of SAS C control statements cdrom VGUI62 gimzip SMPPTFIN Storage Tek0035 L1K0001 SMPPTFIN pax Z SMPNTS binary file of HTTPD...

Page 28: ... VGUI62 gimzip SMPRELF Storage Tek ASAR700 F5 pax Z SMPNTS binary file of SAS C transient LMODs cdrom VGUI62 gimzip SMPRELF Storage Tek SSKU620 F1 pax Z SMPNTS binary file of VSM GUI www JCLIN cdrom VGUI62 gimzip SMPRELF Storage Tek SSKU620 F2 pax Z SMPNTS binary file of VSM GUI load modules cdrom VGUI62 gimzip SMPRELF Storage Tek SSKU620 F3 pax Z SMPNTS binary file of VSM GUI www modules cdrom VG...

Page 29: ... 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 SMPNTS binary file of VSM GUI www modules cdrom VGUI62 gimzip SMPRELF Storage Tek SSKU620 F16 pax Z SMPNTS binary file of VSM GUI www modules cdrom VGUI62 gimzip SMPRELF Storage Tek SSKU620 F17 pax Z SMPNTS binary file of VSM GUI www modules cdrom...

Page 30: ...t contains sample JCL members for the VSM GUI Follow the instructions in the file named Start here html on the CD ROM to transfer the VGUI JCL Samples file using one of the following three methods CD ROM on FTP server and ICSF available Receive FROMNETWORK Note This also works without ICSF if SMP E is at v3r4 0 or better and the Java SHA 1 support is available jobcard JOB accounting information LO...

Page 31: ...exist with previous VSM GUI versions in the same SMP E CSI because of data set conflicts Caution Co existing with ExPR GUI for the same SMP E environment will require the relevant ExPR GUI maintenance patches PTF for the HTTPD server base function and SAS C function Caution The High Level Qualifiers you will use for the SMP E data set is restricted to no more than 23 characters This is to ensure t...

Page 32: ...l be changed to an Add command automatically 3 Define DDDEFs and allocate the target and distribution data sets Run the following customized members I1DDDEFS Define the DDDEFs This job may end with return code 4 SMP E warning code of GIM27701W is normal and expected for new SMP E environments where there is no definition yet defined The SMP E Replace command will be changed to an Add command autom...

Page 33: ...y applied in your SMP E environment Notes By default this job will fail with return code 12 due to STOP instructions in the PTFs due to DELETE statements in the SMP E commands You will need to modify the job to allow the PTF DELETE commands to be processed with a BYPASS statement This job will end with return code 4 SMP E warning code of GIM24701W is normal and expected due to the LINK EDIT parame...

Page 34: ...mal and expected due to BYPASS instruction in the SMP E statement SMP E warning code of GIM61903W is normal and expected due to the previous APPLY statements having removed load modules from the DLIB 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 ...

Page 35: ...FG web content AENCFGW web content AENCMS web content AENCMSW web content AENDOC web content AENDOW web content AENDOG web content AENDOX web content AENHME web content AENIMG web content AENRPT web content AENRPTW web content AENSCP web content AENTPL web content AENUTL web content AENUTLW web content ASAMP VSM GUI sample material ASAROBM LMODs ASAROMM LMODs ASAROSM LMOD ASARRTNS load modules ASK...

Page 36: ...y any of the following methods Dynamically authorize the load library by using the MVS SETPROG APF ADD DSNAME operator command Dynamically authorize the load library by Adding the load library to the MVS parameter library PROGxx member For example SYS1 PARMLIB PROG00 Issuing the MVS SET PROG xx operator command Recommended Permanently authorize the load library by Adding the VSM GUI load libraries...

Page 37: ...vel level The logging message level Valid values are error warning info and the default is warning For example if you specify info you log only information messages If you specify error you log error warning and information messages serverbase hlq The high level qualifier of the server data sets in the form hlq This should be the same as the hlq used during the SMP E install This parameter is requ...

Page 38: ...p is the name of the server started task procedure userid is the RACF userid to be associated with the started task groupname is the RACF group associated 2 Create a RACF userid with an OMVS segment and UID for the server started task ADDUSER userid DFLTGRP groupname OMVS UID uid Security Parameters Security is enabled by the security parameter described below Note If you want to use the GUI to ru...

Page 39: ...er the user has to log out and log back in again for the change to take effect saf The specified system security package which verifies userid and password information and that valid users have access to the profile STKHTTPD in class FACILITY The level of access in that profile is the user s access level for server functions The access level permits the GUI operations as shown in TABLE 2 8 TABLE 2...

Page 40: ... It may be specified more than once for multiple GUI applications Miscellaneous Parameters allow xxx xxx xxx xxx mm Specifies the ip address range allowed to connect to the server xxx xxx xxx xxx is the base ip address in dotted decimal notation and mm are the significant bits For example 10 117 186 0 24 specifies that connections are allowed from addresses 10 117 186 authenicateexpiry period The ...

Page 41: ...efaults to yes expiry period Specifies the default static content expiry period in seconds Default is 21600 six hours home url string Specifies the default home page for the server and is relative to the document root For example home vsm en home index html interface address For multihomed hosts specifies the IP address of the network interface on which the server is to listen Keepalive yes no Ena...

Page 42: ...es the order in which a connection source ip address is checked against any allow and or deny parameters Allowable sequences allow deny Allow directives are checked before deny directives Unmatched requests are denied deny allow Deny directives are checked before allow directives Unmatched requests are allowed mutual exclusion Only requests that are allowed by an allow directive and are not forbid...

Page 43: ...nv name text Sets an environment variable accessible to cgi modules serversignature yes no Specifies whether the server identification line should be included at the bottom of server generated pages such as directory listings or error pages Default yes tcpipprefix high_level_qualifier Sets the system TCPIP high level qualifier Default is TCPIP Suggest also allocating the tcpipprefix TCPIP DATA dat...

Page 44: ...er the following MVS command F SKUPROC D S The following shows a display status response SKY016I HTTPD Server 6 2 0 started at Fri Jan 24 06 51 35 2003 requests received 85 tasks default 20 active 20 limit 40 SKY053I Current active worker tasks 0 This response shows an idle system with the default number of worker tasks which handle client connections idle waiting for work At times of peak demand ...

Page 45: ...rocedure 1 Ensure that you have customized the installation jobs as described in Set Up the SMP E Environment and Install the Software on page 13 2 If necessary modify member V1RCV Change the SMPPTFIN and SMPHOLD DDs to point to the downloaded data set names If there was no HOLDDATA downloaded then remove the SMPHOLD DD and only receive SYSMODS 3 Run member V1RCV to RECEIVE the VSM GUI PTFs 4 If n...

Page 46: ... 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 Use the ACCEPT CHECK option as often as necessary to identify SMP E processing problems before the actual ACCEPT process Note Expect a return code of 04 with SMP E message GIM24701W This message is normal when SMP E accepts ...

Page 47: ... base tape was created For more information see Customer Support on page xiii and Customer initiated Maintenance on page xiv The VSM GUI service tape contains both the current PUT level PTFs and a file containing all cumulative PTFs available for the product up to that PUT level Each PTF on the file is assigned a source identifier of PUTyynn where yy is the year and nn is the sequence number This ...

Page 48: ...rvice tape contents Obtain the actual volume serial VTyynn of the tape from the tape cartridge external label and make other modifications as necessary 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 S...

Page 49: ... tape cartridge external label If there was no HOLDDATA downloaded then remove the SMPHOLD DD and only receive SYSMODS 3 Run member U1RCV to RECEIVE the VSM GUI service 4 If necessary modify member U2APPLY Before running the apply job review the output from the receive job for HOLDDATA and follow the instructions given for each held PTF When the requirements are met bypass the hold condition for t...

Page 50: ... 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 Use the ACCEPT CHECK option as often as necessary to identify SMP E processing problems before the actual ACCEPT process Note Expect a return code of 04 with SMP E message GIM24701W This message is normal when SMP E accepts new element...

Page 51: ...o 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 SKY004E Error opening server socket errno nnn mmm terminating The server cannot open a socket connection to its configured port due to the error indicated by the errno code nnn and error message mmm The server shuts down SKY005E...

Page 52: ... Server ver started at tttt requests received nnn tasks default dd active aa limit ll Response to an operator display status command and indicates the server name version start date and the total number of requests received It also details the worker task settings the default number of idle tasks the maximum limit of dynamically started tasks and the current number of active tasks SKY018I Request ...

Page 53: ... name translation is incorrect SKY031I Connections total nn max mm min Response to a console display client command there have been a total of nn connections at a maximum rate of mm per minute SKY032I Connections rates nn min mm hour Response to a console display client command the connection rates are nn per minute and mm per hour SKY031W Not APF authorized some facilities not available The httpd...

Page 54: ...abend_message_line Message number for abend reporting messages SKY049E Not APF authorized cannot continue The server is not APF authorized but APF authorization is required The server will shut down SKY050E Task shutdown time expired terminating tasks During httpd server shutdown some tasks have not stopped before the shutdown timeout was exceeded These task will be forcibly terminated SKY051E Can...

Page 55: ...ating task t The task t will be forcibly terminated SKY056I Disable abend handling option specified handling disabled The httpd server abend handlers will not be enabled so any abends can cause dumps and may also crash the server SKY059E Error initializing translation tables There was an error initializing the server file name translation table SKY060E SERVERBASE not set shutting down The required...

Page 56: ...alues SKY068E CGI api call error for function reason There was an error calling the CGI function function for reason reason SKY069E task nnn clientConnect taksocket error err reason The worker task nnn encountered an error obtaining the connection socket with error code err and error message reason SKY070E Passrequest givesocket error err reason The main task encountered an error passing a connect...

Page 57: ... SKY075I Socket nnn settings linger spec sndBuf sss rcvBuf rrr Server connection listener socket nnn has the following attributes linger spec is the socket time out on close either default or 1 time in seconds the socket is unavailable for reuse SKY076E Cannot allocate dsn dynamic allocation error rc rc error err info inf A dataset cannot be dynamically allocated dairfail return and information co...

Page 58: ... encountered The parameter is skipped by moving onto the next line SKY106E Expected number but non numeric ssss When parsing the parameter file a non numeric item was found when a number was expected SKY107I parm set to vvvv The parameter parm is set to value vvvv SKY108E Expected string sss skipping When parsing the parameter file the string ssss was expected but not found Parsing skips on the ne...

Page 59: ...nn The task tttt completed with return code nn SKY115I Commencing server shutdown The server has started shutting down SKY116E Task tttt unable to get client id An error occurred when passing a socket connection to the work task tttt SKY117E Spurious wakeup work to do ECB not posted This is an internal error and should not occur SKY118I Task t waiting for work The worker task t is now idle after f...

Page 60: ...e connection to client at IP address xxx xxx xxx xxx ended SKY124I Task t connection terminated by peer adr The network connection to worker task t was terminated by the client with ip address adr SKY125E Task t cmp abend aaa caught The abend handler for task t in component cmp intercepted a type aaa abend Task t will be shutdown and a replacement task created SKY126E Task t cmp illegal instructio...

Page 61: ...ady for work SKY131I hhh handler shutting down The handler hhh task has started shutting down SKY132E hhh handler startup timeout terminating The startup timeout for the handler task hhh has been exceeded The handler will be terminated SKY133E Unable to start hhh handler terminating The httpd server was unable to start it handler task hhh The server shuts down SKY134E Unable to allocate mmm memory...

Page 62: ... 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 SKY139E Request token nnn Text ttttt Debugging message issued for each token in an invalid request SKY140E Request has nnnn tokens Debuggin...

Page 63: ...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 32 8 Required user exits not available 32 12 Unknown command 32 16 No matching categories 32 24 Not authorized 32 28 HSC at the wrong level 32 32 Advanced Management Feature required and not enabled 32 40 Error detected in the XML structure ...

Page 64: ...46 VSM GUI Getting Started Guide July 2007 Rev A 312651601 ...

Page 65: ... Installing the PTFs 27 M Messages and Codes 33 Miscellaneous Parameters 22 N Network Parameters 19 P Parameter File 19 PTFs for VSM GUI 27 S Security Parameters 20 Server Configuration Parameters 19 Service Tape Contents 30 Service Tapes 29 Set Up the SMP E Environment and Install the Software 13 SMP E Distribution Library Contents 17 SMP E Environment 13 SMP E Target Library Contents 15 21 Softw...

Page 66: ...SM 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 ...

Page 67: ...6188101 HONG KONG 852 2877 7077 HUNGARY 361 202 4415 INDIA 91 80 229 8989 INDONESIA 65 216 8333 IRELAND 353 1 668 4377 ISRAEL 972 9 9710500 ITALY 39 02 9259511 JAPAN 81 3 5779 1820 KOREA 82 2 3453 6602 MALAYSIA 603 2116 1887 MIDDLE EAST 00 9714 3366333 MEXICO 525 261 0344 NETHERLANDS 31 33 4515200 NEW ZEALAND 0800 786 338 NORTH WEST AFRICA 00 9714 3366333 NORWAY FROM NORWAY 47 22023950 TO NORWAY 4...

Page 68: ......

Reviews: