[Contents] [Previous] [Next]

OD/390 Internet Access Feature Customization Tasks

The tasks described in this section will assist you with customizing the HTML and system default components of the OnDemand for OS/390 Internet Access Feature. The OD/390 Internet Access Feature distributed code base should not be modified.

The following table summarizes the optional customization tasks that can be performed for the OD/390 Internet Access Feature. Each task identified in the table will be discussed in detail in the next section of this document. For reference purposes, the OD/390 WEBHTML library member names are included in the table.

Task Description Member
1 HTML. IODWNWPS, IODWRTRY, IODWSGN, IODWWB01, IODWWB02, IODWWB03, IODWWB07, IODWWB0A, IODWWB53
2 OD/390 Internet Access System Concurrent User Counting  
3 OD/390 Internet Access System Inactive User Time out  
4 OD/390 Internet Access System Defaults. IODISDT
Table 1: OD/390 Internet Access Feature Customization Task List

TASK 01 -- HTML

The OD/390 Internet Access Feature uses the HTML source defined in members located in the WEBHTML library. Each source member corresponds to a particular Web feature program. Refer to Appendix D. OD/390 Internet Access Feature Quick Reference for a listing of the programs. Before a Web program returns control to the CICS Web Interface, it reads the HTML source member and builds an HTTP response containing a fully resolved HTML page.

There will be special reserved place holder variable names inside each HTML member. The names will be in the format of &SOME_NAME_SYM;. These names must not be deleted or renamed. The Web feature programs will replace these variables with HTML tags and elements specified within the application. All other HTML source may be modified.

Member Name Description
IODWNWPS Signon New Password Page. This HTML page is sent if a user password expires.
IODWRTRY Signon Retry Page. This HTML page is sent if a userid or password is entered in error.
IODWSGN Signon Page. This HTML page is sent for the initial signon.
IODWWB01 Folder List Page. This HTML page is sent to display a list of OD/390 folder names that the user is authorized to see.
IODWWB02 Key Search Page. This HTML page is sent to allow a folder key search.
IODWWB03 Document Search Results List Page. This HTML page is sent listing all documents that satisfied the search criteria.
IODWWB07 Annotations Page. This HTML page is sent to allow additions and viewing of annotations.
IODWWB0A Launch Page. This HTML page is sent to allow the Launching of Helper Applications when viewing a document.
IODWWB53 Document Search Results List Page - API. This HTML page is sent listing all documents that satisfied the search criteria.
Table 2: OD/390 Internet Access Feature HTML Member Descriptions

TASK 02 -- Concurrent User Counting

The Concurrent User Counting function of the OD/390 Internet Access Feature automatically monitors user access to the application. This function will provide a customer installation with information regarding the number of users that are currently logged on to the Internet Access Feature as well as historical statistics regarding the 'high watermark' of user access over the life of the application. These statistics are maintained in the OD/390 System Default Table and are updated automatically every thirty minutes.

Customers are required to establish basic control information in the OD/390 System Default Table to allow the application to accurately monitor the user counts. See TASK 04 -- OD/390 Internet Access System Default Definition for a complete description of the System Default records that were loaded in STEP 08 -- Load System Default Table.

The following is a brief description of the OD/390 System Default entries used by this feature:

  1. ODCULICN This record contains the number of OD/390 Internet Access Feature software licenses that were purchased. This record is distributed by IBM with a value of ten licenses. It is likely that this value will need to be modified. The following messages are written to the CWBO log when the value in the ODCULICN record is exceeded:
                                  
    	Maximum installation user count has been exceeded.
    	Installation maximum license value xxxxxx.
    	Concurrent user count value xxxxxx.
    
  2. ODCUCNTL
    This record contains the ODCU Start/Stop indicator. This indicator should normally contain the value START. The indicator can be changed to STOP if this function needs to be temporarily disabled. It is not necessary to disable this function prior to CICS shutdown.
  3. ODCUCNTS This record contains the count of users that are currently logged on as well as the maximum number of users that were logged on at any given point in time. Each count has an associated time stamp that indicates the date and time that the count was taken.

TASK 03 -- OD/390 Internet Access System Inactive User Time out

The Inactive User Time out function of the OD/390 Internet Access Feature provides a means for each installation to establish a time out value for inactive users. The specified time outwill be automatically enforced by the application.

Customers are required to establish the time out value in the OD/390 System Default Table. See TASK 04 -- OD/390 Internet Access System Default Definition for a complete description of the System Default records that were loaded in STEP 08 -- Load System Default Table.

TASK 04 -- OD/390 Internet Access System Default Definition

System Defaults are provided to allow each installation the flexibility of customizing run time parameters for certain processes within the OD/390 Internet Access Feature. Specifying system defaults is completely optional. The OD/390 Internet Access application will use standard default values for all parameters that are not specifically customized for your installation. You may use the OD/390 Administration System to modify the system default values as described below.

1. Type SDT for the Table Id on the Administration System Main Menu and press Enter.


          ******      ******      *     *******     *******        ******     
        **     *     **    *     *     **     **   **     **     **     *        
      ***     **    **    **    *           ***    **    ***    **     **         
     **       **   **     **   *         ***        *******    **     **         
    **       **   **     **   *            **           **    **     **       
    **     **    **    **    *     **     **           **    **     **          
    *******     *******     *      *******            **     *******            
   OnDemand for OS/390                                         Date:   1998-11-10       
                                                               Time:   13:43:52           
                        Administration System                  Lterm:  NDCMC024   
     
   Enter Table Id           >  SDT      ACT AUD FCT FDT PRT SDT SRT UPT VCT      
          Enter Appropriate Values:            Valid For Tables:                       
                                           ACT AUD FCT PRT SDT SRT UPT VCT FDT          
      Report Id             >            Y   Y       Y       Y       Y           
      Report Version        >            Y                           Y            
      Start Date (YYYYMMDD) >                Y       Y       Y                    
      End Date   (YYYYMMDD) >                Y       Y       Y                    
      Userid                >                Y       Y           Y                
      Form Name             >                    Y                              
      System Default Id     >                            Y                       
      Folder Name           >                                            Y                                                                                       
   Enter=Search  F1=Help  F3=End  PF4=SRPT                      Clear=Exit    

2. Select the WEBDFLT identifier from the list and press Enter.

 
                                OnDemand for OS/390               
                                SDT Search Results                Page 001 of 001
     Default Id:           Change Default Id to generate a new list               
   A  Default                                                                     
   C    Id    Value...                                                            
   - -------- -----------------------------------------------------------------   
     ODCUCNTL START  
     ODCUCNTS 000000 0001-01-01-00.00.00    000000 0001-01-01-00.00.00
     ODCULICN 000010  
     ODSDFLT  SMNU      OSSR OSSE OSSU                                      
     POBJDFLT N   0000 Y    Y    Y                                                
     RADMDFLT N                                                                   
     RAPLBOBP //RDAR0XBT JOB (ACCT#),,REGION=64M,NOTIFY=RDAR0X,                   
     RASLBDEL //RDAR0XDL JOB (ACCT#),,REGION=64M,NOTIFY=RDAR0X,                     
     RASLBPRT //RDAR0XBP JOB (ACCT#),,REGION=64M,NOTIFY=RDAR0X,                   
     SRPTDFLT 00000200 0000 N    N    00000000       MM/DD/YY 00000200 0001 N 0
     WEBAPI   RDARADM 32.225.97.97                                              
   S WEBDFLT  N 0003 0200 0090 
     WEBTMOUT 060                                                                                
                                                                                  
   Enter Actions Above -- S=Select                                                  
   Enter=Action  F1=Help  F2=Jump      F3=End  F7=Pg Bkwd  F8=Pg Fwd  CLEAR=Main 

3. Modify the default parameters. Save the changes by typing UPD in the Action Code field and press Enter. The WEBDFLT values are described below.

       
                                 OnDemand for OS/390                               
                                 SDT Maintenance                   Page 001 of 001 
    Action Code  >     (CREate, RETrieve, UPDate, DELete, CANcel)   Col  01 to  04
    Default Id: WEBDFLT                                                         
    Seq                                                                            
    # Value....                                                                   
    -- ----+----1----+----2----+----3----+----4----+----5----+----6----+----7----  
    01 N 0003 0200 0090 N
    02 WB01 WB02 WB03 WB04 WB05 WB06 WB07 WB0A   
    03 WBSS WB53 WB54  
                                                                               
    IOD02014I ENTER/UPDATE VALUES AND PRESS APPROPRIATE KEY                        
    Enter=Action  F1=Help  F2=Jump      F3=End  F7/F8=Bkwd/Fwd  F11/F12=Left/Right 

Web Defaults 

Description Position Length OD/390 Internet Access Default
Archive Index Search Enabled

01

Char(1) N
Maximum number of Archived Indexes that can be searched

03

Char(4) 0003
Directory Hit List Limit

08

Char(4) 0200
Folder Number of Days in Search Range

13

Char(4) 0090
Trace Indicator

18

Char(1) N
Table 3: System Default Identifier - WEBDFLT 01 Defaults

Description Position Length OD/390 Internet Access Default
Folder List Transaction

01

Char(4) WB01
Directory Search List Transaction

06

Char(4) WB02
Search Results List Transaction

11

Char(4) WB03
View Document (Binary)Transaction

16

Char(4) WB04
View Document (Text)Transaction

21

Char(4) WB05
Host Print Transaction

26

Char(4) WB06
Annotations Transaction

31

Char(4) WB07
Launch Document Transaction

36

Char(4) WB0A
Table 4: System Default Identifier - WEBDFLT 02 Defaults

Description Position Length OD/390 Internet Access Default
API - Search Results List Transaction

01

Char(4) WBSS
API - View Document (Binary) Transaction

06

Char(4) WB54
API - View Document (Text) Transaction

11

Char(4) WB55
Table 5: System Default Identifier - WEBDFLT 03 Defaults

4. Select the WEBAPI identifier from the list and press Enter. This step is only necessary if you have implemented the API component of the OD/390 Internet Access Feature.

 
                                OnDemand for OS/390               
                                SDT Search Results                Page 001 of 001
     Default Id:           Change Default Id to generate a new list               
   A  Default                                                                     
   C    Id    Value...                                                            
   - -------- -----------------------------------------------------------------   
     ODCUCNTL START
     ODCUCNTS 000000 0001-01-01-00.00.00    000000 0001-01-01-00.00.00
     ODCULICN 000010  
     ODSDFLT  SMNU      OSSR OSSE OSSU                                      
     POBJDFLT N   0000 Y    Y    Y                                                
     RADMDFLT N                                                                   
     RAPLBOBP //RDAR0XBT JOB (ACCT#),,REGION=64M,NOTIFY=RDAR0X,                   
     RASLBDEL //RDAR0XDL JOB (ACCT#),,REGION=64M,NOTIFY=RDAR0X,                     
     RASLBPRT //RDAR0XBP JOB (ACCT#),,REGION=64M,NOTIFY=RDAR0X,                   
     SRPTDFLT 00000200 0000 N    N    00000000       MM/DD/YY 00000200 0001 N 0
   S WEBAPI   RDARADM 32.225.97.97                                              
     WEBDFLT  N 0003 0200 0090 
     WEBTMOUT 060                                                                                
                                                                                  
   Enter Actions Above -- S=Select                                                  
   Enter=Action  F1=Help  F2=Jump      F3=End  F7=Pg Bkwd  F8=Pg Fwd  CLEAR=Main 

5. Modify the default parameters. Save the changes by typing UPD in the Action Code field and press Enter. The WEBAPI values are described below.

Description Position Length OD/390 Internet Access Default
Honored Token

01

Char(8) RDARADM
IP Address or IP Address Name

17

Char(50) 32.225.97.97
Table 6: System Default Identifier - WEBAPI 01 Defaults

6. Select the WEBTMOUT identifier from the list and press Enter. OD/390 will timeout Internet Access Feature users in sixty minutes unless the inactivity timeout value is changed.

 
                                OnDemand for OS/390               
                                SDT Search Results                Page 001 of 001
     Default Id:           Change Default Id to generate a new list               
   A  Default                                                                     
   C    Id    Value...                                                            
   - -------- -----------------------------------------------------------------   
     ODCUCNTL START 
     ODCUCNTS 000000 0001-01-01-00.00.00    000000 0001-01-01-00.00.00
     ODCULICN 000010  
     ODSDFLT  SMNU      OSSR OSSE OSSU                                      
     POBJDFLT N   0000 Y    Y    Y                                                
     RADMDFLT N                                                                   
     RAPLBOBP //RDAR0XBT JOB (ACCT#),,REGION=64M,NOTIFY=RDAR0X,                   
     RASLBDEL //RDAR0XDL JOB (ACCT#),,REGION=64M,NOTIFY=RDAR0X,                     
     RASLBPRT //RDAR0XBP JOB (ACCT#),,REGION=64M,NOTIFY=RDAR0X,                   
     SRPTDFLT 00000200 0000 N    N    00000000       MM/DD/YY 00000200 0001 N 0
     WEBAPI   RDARADM 32.225.97.97                                              
     WEBDFLT  N 0003 0200 0090 
   S WEBTMOUT 060                                                                                
                                                                                  
   Enter Actions Above -- S=Select                                                  
   Enter=Action  F1=Help  F2=Jump      F3=End  F7=Pg Bkwd  F8=Pg Fwd  CLEAR=Main 

7. Modify the default parameters. Save the changes by typing UPD in the Action Code field and press Enter. The WEBTMOUT values are described below. 

Description Position Length OD/390 Internet Access Default
Inactivity Time out Value (Measured in Minutes)

01

Char(3) 060
Table 7: System Default Identifier - WEBTMOUT 01 Defaults

8. Select the ODCUCNTL identifier from the list and press Enter. This step is necessary to customize the Concurrent User startup value for OD/390 Internet Access Feature users.

 
                                OnDemand for OS/390               
                                SDT Search Results                Page 001 of 001
     Default Id:           Change Default Id to generate a new list               
   A  Default                                                                     
   C    Id    Value...                                                            
   - -------- -----------------------------------------------------------------   
   S ODCUCNTL START   
     ODCUCNTS 000000 0001-01-01-00.00.00    000000 0001-01-01-00.00.00
     ODCULICN 000010  
     ODSDFLT  SMNU      OSSR OSSE OSSU                                      
     POBJDFLT N   0000 Y    Y    Y                                                
     RADMDFLT N                                                                   
     RAPLBOBP //RDAR0XBT JOB (ACCT#),,REGION=64M,NOTIFY=RDAR0X,                   
     RASLBDEL //RDAR0XDL JOB (ACCT#),,REGION=64M,NOTIFY=RDAR0X,                     
     RASLBPRT //RDAR0XBP JOB (ACCT#),,REGION=64M,NOTIFY=RDAR0X,                   
     SRPTDFLT 00000200 0000 N    N    00000000       MM/DD/YY 00000200 0001 N 0
     WEBAPI   RDARADM 32.225.97.97                                              
     WEBDFLT  N 0003 0200 0090 
     WEBTMOUT 060                                                                                
                                                                                  
   Enter Actions Above -- S=Select                                                  
   Enter=Action  F1=Help  F2=Jump      F3=End  F7=Pg Bkwd  F8=Pg Fwd  CLEAR=Main 

9. Modify the default parameters. Save the changes by typing UPD in the Action Code field and press Enter. The ODCUCNTL values are described below.

Description Position Length OD/390 Internet Access Default
Concurrent User Start/Stop Option

01

Char(5) START
Table 8: System Default Identifier - ODCUCNTL 01 Defaults

10. The ODCUCNTS identifier appears on the SDT Results Screen. You should not customize Concurrent User Count value for OD/390 Internet Access Feature users; this record should only be viewed from the SDT Results Screen.

 
                                OnDemand for OS/390               
                                SDT Search Results                Page 001 of 001
     Default Id:           Change Default Id to generate a new list               
   A  Default                                                                     
   C    Id    Value...                                                            
   - -------- -----------------------------------------------------------------   
     ODCUCNTL START
   S ODCUCNTS 000000 0001-01-01-00.00.00    000000 0001-01-01-00.00.00
     ODCULICN 000010  
     ODSDFLT  SMNU      OSSR OSSE OSSU                                      
     POBJDFLT N   0000 Y    Y    Y                                                
     RADMDFLT N                                                                   
     RAPLBOBP //RDAR0XBT JOB (ACCT#),,REGION=64M,NOTIFY=RDAR0X,                   
     RASLBDEL //RDAR0XDL JOB (ACCT#),,REGION=64M,NOTIFY=RDAR0X,                     
     RASLBPRT //RDAR0XBP JOB (ACCT#),,REGION=64M,NOTIFY=RDAR0X,                   
     SRPTDFLT 00000200 0000 N    N    00000000       MM/DD/YY 00000200 0001 N 0
     WEBAPI   RDARADM 32.225.97.97                                              
     WEBDFLT  N 0003 0200 0090 
     WEBTMOUT 060                                                                                
                                                                                  
   Enter Actions Above -- S=Select                                                  
   Enter=Action  F1=Help  F2=Jump      F3=End  F7=Pg Bkwd  F8=Pg Fwd  CLEAR=Main 

11. The following table describes the ODCUCNTS default record.

Description Position Length OD/390 Internet Access Default  
Concurrent User Count (Active Users)

01

Char(6) 000000
Concurrent User Timestamp (Active Users)

08

Char(19) 0001-01-01-00.00.00
Concurrent User Count (Highwater Mark)

31

Char(6) 000000
Concurrent User Timestamp (Highwater Users)

38

Char(19) 0001-01-01-00.00.00
Table 9: System Default Identifier - ODCUCNTS 01 Defaults

12. Select the ODCULICN identifier from the list and press Enter. This step is necessary to customize the number of Internet Access Feature Concurrent User licenses purchased by your installation.

 
                                OnDemand for OS/390               
                                SDT Search Results                Page 001 of 001
     Default Id:           Change Default Id to generate a new list               
   A  Default                                                                     
   C    Id    Value...                                                            
   - -------- -----------------------------------------------------------------   
     ODCUCNTL START   
     ODCUCNTS 000000 0001-01-01-00.00.00    000000 0001-01-01-00.00.00
   S ODCULICN 000010  
     ODSDFLT  SMNU      OSSR OSSE OSSU                                      
     POBJDFLT N   0000 Y    Y    Y                                                
     RADMDFLT N                                                                   
     RAPLBOBP //RDAR0XBT JOB (ACCT#),,REGION=64M,NOTIFY=RDAR0X,                   
     RASLBDEL //RDAR0XDL JOB (ACCT#),,REGION=64M,NOTIFY=RDAR0X,                     
     RASLBPRT //RDAR0XBP JOB (ACCT#),,REGION=64M,NOTIFY=RDAR0X,                   
     SRPTDFLT 00000200 0000 N    N    00000000       MM/DD/YY 00000200 0001 N 0
     WEBAPI   RDARADM 32.225.97.97                                              
     WEBDFLT  N 0003 0200 0090 
     WEBTMOUT 060                                                                                
                                                                                  
   Enter Actions Above -- S=Select                                                  
   Enter=Action  F1=Help  F2=Jump      F3=End  F7=Pg Bkwd  F8=Pg Fwd  CLEAR=Main 

13. Modify the default parameters. Save the changes by typing UPD in the Action Code field and press Enter. The ODCULICN values are described below.

Description Position Length OD/390 Internet Access Default
Concurrent User License Count

01

Char(6) 000010
Table 10: System Default Identifier - ODCULICN 01 Defaults

14. Select the IODXDOCG identifier from the list and press Enter. This step is necessary to enable the use of the optional Pre-View Exit. Please see the OnDemand for OS/390 Installation Guide V2R1 - OD/390 Customization Tasks for more information on the Pre-View Exit.

 
                                OnDemand for OS/390               
                                SDT Search Results                Page 001 of 001
     Default Id:           Change Default Id to generate a new list               
   A  Default                                                                     
   C    Id    Value...                                                            
   - -------- -----------------------------------------------------------------
   S IODXDOCG N         
     ODCUCNTL START   
     ODCUCNTS 000000 0001-01-01-00.00.00    000000 0001-01-01-00.00.00
     ODCULICN 000010  
     ODSDFLT  SMNU      OSSR OSSE OSSU                                      
     POBJDFLT N   0000 Y    Y    Y                                                
     RADMDFLT N                                                                   
     RAPLBOBP //RDAR0XBT JOB (ACCT#),,REGION=64M,NOTIFY=RDAR0X,                   
     RASLBDEL //RDAR0XDL JOB (ACCT#),,REGION=64M,NOTIFY=RDAR0X,                     
     RASLBPRT //RDAR0XBP JOB (ACCT#),,REGION=64M,NOTIFY=RDAR0X,                   
     SRPTDFLT 00000200 0000 N    N    00000000       MM/DD/YY 00000200 0001 N 0
     WEBAPI   RDARADM 32.225.97.97                                              
     WEBDFLT  N 0003 0200 0090 
     WEBTMOUT 060                                                                                
                                                                                  
   Enter Actions Above -- S=Select                                                  
   Enter=Action  F1=Help  F2=Jump      F3=End  F7=Pg Bkwd  F8=Pg Fwd  CLEAR=Main 

15 Modify the default parameters. Save the changes by typing UPD in the Action Code field and press Enter. The IODXDOCG value is described below.

Description Position Length OD/390 Internet Access Default
Invoke the Pre-View Exit?

01

Char(1) N
Table 11: System Default Identifier - IODXDOCG 01 Defaults


[Contents] [Previous] [Next]


Copyright © IBM Corporation - 1998, 2000