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 |
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. |
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:
Maximum installation user count has been exceeded. Installation maximum license value xxxxxx. Concurrent user count value xxxxxx.
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.
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
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 |
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 |
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 |
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 |
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=Main7. 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 |
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 |
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
|
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 |
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=Main15 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 |