Instructions for Installing the R12.1 CICS Web Interface Changes 1. Preparation and requirements Back up the SYSTEM 2000 CICS interface SOURCE and LOAD libraries. Apply this set of changes to your CICS interface library. This web-enabled CICS package does not affect your existing 3270 applications. Changes to existing macros only allow SCF on the web and do not affect either existing SCF or PLEX modules. Please refer to the SYSTEM 2000 Web Interface to CICS Administrator's Guide, Chapter 2, for CICS installation requirements that must precede this installation. 2. Run job JCLUPDTE to update your CICS interface source library. //JCLUPDTE JOB () //* -------------- MODIFY JOB CARD AS NEEDED ----------------- //* //* INSTALL R12.1 WEB INTERFACE CHANGES //* //********************************************************** //* UPDATE EXISTING MACROS //********************************************************** //UPDATE EXEC PGM=IEBUPDTE //SYSPRINT DD SYSOUT=* //SYSUT1 DD DSNAME=S2K.R121.SOURCE,DISP=SHR //SYSUT2 DD DSNAME=S2K.R121.SOURCE,DISP=SHR //SYSIN DD DSN=S2K.R121WEB.INSTALL(R121WEB),DISP=SHR //* //********************************************************** //* COPY NEW MEMBERS TO THE CICS INTERFACE LIBRARY //********************************************************** //COPYALL EXEC PGM=IEBCOPY //SYSPRINT DD SYSOUT=* //SYSUT3 DD UNIT=SYSDA,SPACE=(CYL,(1,1)) //SYSUT4 DD UNIT=SYSDA,SPACE=(CYL,(1,1)) //INFIL DD DSN=S2K.R121WEB.INSTALL,DISP=SHR //OTFIL DD DSN=S2K.R121.SOURCE,DISP=SHR //SYSIN DD * COPY INDD=INFIL,OUTDD=OTFIL S M=((CSDWEB,,R)) S M=((S2KWCOM,,R)) S M=((S2KWCOMC,,R)) S M=((S2KWEBD,,R)) S M=((S2KWEBTO,,R)) S M=((S2KWERR,,R)) S M=((S2KWEXIT,,R)) S M=((S2KWFOOT,,R)) S M=((S2KWFORM,,R)) S M=((S2KWHEAD,,R)) S M=((S2KWLGF,,R)) S M=((S2KWLGH,,R)) S M=((S2KWMENU,,R)) S M=((S2KWOPER,,R)) S M=((S2KWOPRF,,R)) S M=((S2KWSIGN,,R)) S M=((S2KWSTAA,,R)) S M=((S2KWSTAD,,R)) S M=((S2KWSTAF,,R)) S M=((S2KWSTAH,,R)) S M=((S2KWSTAT,,R)) /* The first step of job JCLUPDTE applies IEBUPDTE source member R121WEB to change existing CICS interface source macros. The second step of job JCLUPDTE copies the CSD entries, programs and HTML document templates to your CICS interface source library. Existing members changed ------------------------ DSTACE - macro DS2KCUSE - macro DURB - macro MACCSCF - macro S2KUGEN - macro New members created ------------------- CSDWEB - CSD entries S2KWCOM - macro S2KWCOMC - macro S2KWEBD - program S2KWEBTO - program S2KWERR - html S2KWEXIT - html S2KWFOOT - html S2KWFORM - html S2KWHEAD - html S2KWLGF - html S2KWLGH - html S2KWMENU - html S2KWOPER - html S2KWOPRF - html S2KWSIGN - html S2KWSTAA - html S2KWSTAD - html S2KWSTAF - html S2KWSTAH - html S2KWSTAT - program 3. Assemble affected source modules Installation macros have been changed to add assembly steps for the new programs. If you do not want to re-run job JCLS2KIV to generate all installation jobs again, these instructions include changes you can add manually. New parameters S2KWTIM and S2KWMLN control web timeout and maximum output lines. The defaults are 30 minutes and 2000 lines. You can override these defaults when you assemble S2KCUSE. These new parameters are described in more detail in the SYSTEM 2000 Web Interface to CICS Administrator's Guide for Release 12.1. Run job JCLCL01 and assemble module S2KCUSE. Make the following modifications to member JCLCSCF to assemble modules S2KWEBD, S2KWEBTO and S2KWSTAT. //SCF10 EXEC CLTPASM,S=S2KWEBD,A=31,R=ANY, // PARM.CICSEIP='SP' //SCF11 EXEC CLTPASM,S=S2KWEBTO,A=31,R=ANY, // PARM.CICSEIP='SP' //SCF12 EXEC CLTPASM,S=S2KWSTAT,A=31,R=ANY, // PARM.CICSEIP='SP' Run job JCLCSCF to assemble modules S2KWEBTO, S2KWEBD and S2KWSTAT. 4. Update your S2KCSD table with CSDWEB and set up URL Member CSDWEB defines new web-aware programs and HTML templates to your CICS. Apply the CSDWEB member to your CSD. Add the DDNAME of DFHHTML to your CICS JCL and point DFHHTML at your CICS interface library. Your site may require a separate library containing only HTML members. Installation is now complete. The new web-aware program S2KWEBD can now be referenced from a web browser. Set up a URL that points to this CICS program by following the instructions in the SYSTEM 2000 Web Interface to CICS Administrator's Guide for Release 12.1. 5. Validate proper function of the R12.1 CICS Web interface Enter the URL for the installed R12.1 CICS Web interface. From the initial Web interface sign-on screen, test the three new Web applications: Sign-on SYSTEM 2000, Operator Communication and User Status. Sign-on SYSTEM 2000 (S2KU): Enter password and database name and open a database. Submit query commands to query your database. Select the Prior Commands button and verify that previous commands can be selected from the resulting window. After a database has been opened, add an "X" character to the address bar to verify that the error page is displayed when an invalid URL is entered. To test inactive users being timed out, open a database and leave the window idle for the timeout period you specified in S2KWTIM. The error page should be displayed with the next access and the user will be required to begin from the initial Application Menu sign-on screen again. Operator Communication (S2OP): Display all users in Multi-User. Additional operator commands may be entered after the default "D A,S" command executes. From the Application Menu pull-down return to an SCF session or display user status via the LALL transaction. User Status (LALL): This displays all CICS users with a default "LALL" transaction. From the Application Menu pull-down return to an SCF session or display Operator Communication via the S2OP transaction. In Case of Problems If you have any questions about installation please call the SYSTEM 2000 Technical Support hotline at (512) 250-9170 or email the Technical Support group at s2k@sas.com.