IBM WAVV 2004 manual

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

Go to page of

A good user manual

The rules should oblige the seller to give the purchaser an operating instrucion of IBM WAVV 2004, along with an item. The lack of an instruction or false information given to customer shall constitute grounds to apply for a complaint because of nonconformity of goods with the contract. In accordance with the law, a customer can receive an instruction in non-paper form; lately graphic and electronic forms of the manuals, as well as instructional videos have been majorly used. A necessary precondition for this is the unmistakable, legible character of an instruction.

What is an instruction?

The term originates from the Latin word „instructio”, which means organizing. Therefore, in an instruction of IBM WAVV 2004 one could find a process description. An instruction's purpose is to teach, to ease the start-up and an item's use or performance of certain activities. An instruction is a compilation of information about an item/a service, it is a clue.

Unfortunately, only a few customers devote their time to read an instruction of IBM WAVV 2004. A good user manual introduces us to a number of additional functionalities of the purchased item, and also helps us to avoid the formation of most of the defects.

What should a perfect user manual contain?

First and foremost, an user manual of IBM WAVV 2004 should contain:
- informations concerning technical data of IBM WAVV 2004
- name of the manufacturer and a year of construction of the IBM WAVV 2004 item
- rules of operation, control and maintenance of the IBM WAVV 2004 item
- safety signs and mark certificates which confirm compatibility with appropriate standards

Why don't we read the manuals?

Usually it results from the lack of time and certainty about functionalities of purchased items. Unfortunately, networking and start-up of IBM WAVV 2004 alone are not enough. An instruction contains a number of clues concerning respective functionalities, safety rules, maintenance methods (what means should be used), eventual defects of IBM WAVV 2004, and methods of problem resolution. Eventually, when one still can't find the answer to his problems, he will be directed to the IBM service. Lately animated manuals and instructional videos are quite popular among customers. These kinds of user manuals are effective; they assure that a customer will familiarize himself with the whole material, and won't skip complicated, technical information of IBM WAVV 2004.

Why one should read the manuals?

It is mostly in the manuals where we will find the details concerning construction and possibility of the IBM WAVV 2004 item, and its use of respective accessory, as well as information concerning all the functions and facilities.

After a successful purchase of an item one should find a moment and get to know with every part of an instruction. Currently the manuals are carefully prearranged and translated, so they could be fully understood by its users. The manuals will serve as an informational aid.

Table of contents for the manual

  • Page 1

    IBM IT Education Servi ces © 2004 IBM Corporation WAVV 2004 Setup of VSAM Redirector VSE Connectors Workshop[...]

  • Page 2

    Wilhelm Mild, Ingo Franzki VSEESA@de.ibm.com WAVV 2004 Connectors Setup of VSAM Redirector VSE Connectors Workshop © Copyright IBM Corporation 200 4[...]

  • Page 3

    VSE/ESA 2.6/2.7 VSAM Redirector The VSAM Redirector is a new VSE/ESA connector, introduced with VSE/ESA 2.6. The VSAM Redirector allows y ou t o redirect all requ ests to a cert ain VSAM file into any other file system or dat abase on any other (Java- enabled) platform. VSE/ESA is the client, while the s erver part runs on any other J av a-enabled [...]

  • Page 4

    Initial state: Î You have a VSAM file that contains data ( FLIGHT.ORDERING.ORDERS ) Î You have applications that wo rk with that VSAM file (i.e. batch applications, CICS Ap plication, tools like Ditto ) Goal: Î Redirect all VSAM INSERT r equests to a HTML page on Windows Î This operation can be done with ex isting applications (without changing[...]

  • Page 5

    Chapter1: Steps for installation of VSAM Redirector server on Windows STEP1.1: Navigate to VSE Redirector Server home page Open the VSE Homepage with a web bro wser: http://www-1.ibm.com/server s/eserver/zseries/os/vse/ Click on "Service and Support" on the left side and then on "e-business connectors and utilities". The page yo[...]

  • Page 6

    Steps for installation on a workstation STEP1.2: Verification if Java environment installed To install the VSAM Redirector a Java Virtual Machine must be installed on Windows. y To just run Java programs, t he JRE 1.3.x or later is needed (Java Runtime Environment), y to develop/compile Java programs, JDK 1.3.x or later is needed (Java Developer Ki[...]

  • Page 7

    Steps for installation on a workstation STEP1.4: Download VSE Redirector server Code With Java installed, navigate on VSAM Redirector S erver -> Details and Download to: Download latest Code via HTML and click on: redir270-pq 74694.zip (VSE 2.6 and 2.7). The file name may vary since it cont ains an APAR number. Please make sure you have applied [...]

  • Page 8

    Steps for installation on a workstation STEP1.5: Install VSE Redirector Server To install the VSAM Redirector se rver, open a Windows command line and change current directory to the one where install.class resides. Type: java install or start the install program install.bat This will guide you troug h t he installation pr oc ess of the VSAM Redire[...]

  • Page 9

    STEP1.6: Verify Redirector server Documentation To verify that the VSAM Redirector Server is installed properly, open the HTML Documentation (For Windows: START -> Programs -> V SAM Redirector -> Online Help The Help HTML page will be opened. STEP1.7: Start VSE Redirector server To start the VSAM Redir ec tor Server, e xecute: run.bat in t[...]

  • Page 10

    STEP1.8: Redirector Server -> Handler To be able to work with VSAM data on another platform (ASCII), the most important component is the Handler . The handler is responsible for data ma nipulation and conversion. Therefor e it must know the st ructure (map ping) of the VSAM record. The handler used in the workshop is the HtmlHandler.class stored[...]

  • Page 11

    STEP2.1: Configuration for Redirector Client on VSEESA To redirect requests for the: • VSAM cluste r: FL IGHT. ORDERING. ORDERS .TEAMxx • in VSAM catalog: VSESP.USER.CATALOG We have to setup the Configuration phase ( IES RDCFG. PHASE ). In this phase we have to def ine which VSAM cluster should be redirected to which remote location, and event[...]

  • Page 12

    In your skeleton SKRDCFG consider: – let the job load IESRDCFG int o t he SVA (Step 2) – let the job copy IESVEX 01 to IK QVEX01 in PRD2.C ONFIG (Step 3) – let the job load IK QVEX01 into the SVA (Step 4) – do NOT let the job load IESRDANC int o the SVA, because it has already be done (Step 5) – let the job execute IESRDL DA to register t[...]

  • Page 13

    STEP3.1: Change Handler to read VSAM record as string Exit Ditto on VSE and stop the Redirec tor server on Windows using command qui t. The handler on Windows should be changed to be able to use string fields only. The handler is stored in <redir>comibmvsehtm lhandler as HtmlHandler.java Edit the file and make following changes: 1. Change[...]

  • Page 14

    Summary Major Steps to install VSAM Redirector Server on a Java Platform 9 install Java Runtime Environment (JRE) or 9 Java Developer Kit (JDK) 9 free download from SUN or IBM 9 version 1.3.x or later http://www.ibm .com/devel operworks/java/ 9 download VSAM Redirector Server http://www-1.ibm. com/serve rs/eserver/zseries/os/vse/ support/vseconn/ r[...]

  • Page 15

    Initial state: Î You have a VSAM file that contains data (i.e. FFSTORES.DEMO.CLUSTER) Î You have applications that work with that VSAM file (i.e. FFST CICS Application) Goal: Î Redirect all VSAM requests to DB2 UDB on Windows Î Access the data with existing app lications (without changing them) NOTE: The VSAM Redirector Server does NOT require [...]

  • Page 16

    Mapping of FFSTORES.DEMO.CLUSTER: Field name Type Offset Length STOREID STRING 0 6 STORENA ME STRING 6 25 LOCSTREET STRING 31 25 LOCCITY STRING 56 25 LOCZIP STRING 81 10 LOCCOUNTRY STRING 91 25 LOCREP STRING 116 20 STOREN1 UNSIGN ED 136 4 STOREN2 UNSIGN ED 140 4 LDATE STRING 144 10 WEBPIC1 STRING 154 20 WEBPIC2 STRING 174 20 ACODE STRING 194 10 To [...]

  • Page 17

    STEP4.3 : Create the tables in the database To continue with the next steps – you must have installed a databas e management system (i.e. DB2). – you must have a JDBC Driver for it (i.e. db2java.zip in <db2>java). – you must be able to connect to the database (userid/password) Make sure the JDBC driver is in the CLASSPATH. You may hav[...]

  • Page 18

    Before we can work with the data in the database, we have to load the data from VSAM into the databas e. To do t his we define a second clus ter, redirect this cluster and copy (repro) the original cluster into the redirected one. STEP4.4: Define clus ter F F STORES .REPRO.CLUS TER with the same attributes as FFSTORES.DE MO.CLUSTER: – KSDS – Ma[...]

  • Page 19

    STEP4.6: Copy FFSTORES.DEMO .CLUSTER into FFSTORES.REPRO.CLUSTER : Use the I DCA MS REPR O function to copy the contents of FFSTORES.DEMO.CLUSTER into the redirected FFSTORES.REPRO.CLUSTER: * $$ JOB JNM=R EPRO,CLASS =A,DISP=L // JOB REPRO C OPY FILE // DLBL COPYIN ,'FFSTORES .DEMO.CLUST ER' ,,VSAM,CAT =VSESPUC // DLBL COPYOU T,'FFSTO[...]

  • Page 20

    STEP4.7: Configure the Redirector for FFSTORES.DEMO.CLU STER: Edit skeleton SKRDCFG: Change the previously created entry in the configuration table. Enter case m in the command line to switch to mixed case mode before editing. Change FFSTORES. REPRO .CLUSTER to FFSTORES. DEM O .CLUSTER IESRDENT CATALOG='VSESP.USER. CATALOG', X CLUSTER=&ap[...]

  • Page 21

    Additional Information z VSE/ESA Home Page http://www.ibm.com/servers /eserver/zseries/os/vse/ z e-business Connectors User's Guide SC33-6719 http://www-1.ibm.com/servers/eserver/zseries/os/vse/pdf/ieswue21.pdf z e-business connectors tools z http://www.ibm.com/servers/eserver /zseries/os/vse/ebus/home.html z e-business Connectivity for VSE/ES[...]