NetCOBOL for SPARC Architecture SAF Subroutines User's Guide

More documents

Recommendations

Info

22 Chapter 3. How to Use SAF Subroutines WWW Browser WWW Server Screen1 Screen2 Note: If multiple Web applications using the session are started by double-clicking a button for which SUBMIT is specified as the TYPE attribute of the INPUT tag, the applications will not operate properly. The programmer should prevent the inadvertent starting of multiple applications by using JavaScript in the WWW browser. See "NetCOBOL Web Guide" for general notes on WWW browser operation. SAF-Specific Functions After a long time passes, access to the Web application Web Application 1 TIMEOUT Web Application 2 SAF specific functions enable getting information specifically related to NES . Listed below are SAF specific subroutines. Function Subroutine name Usage Getting NES setting COBW3_SAF_GET_PARM Getting the parameter specified to COBW3_SAF_GET_PARM_XX COBW3_SAF_GET_PARM_NX COBW3_SAF_GET_PARM_XN COBW3_SAF_GET_PARM_NN the SAF director Getting request COBW3_SAF_GET_BASENAME Getting the application name information specified to the URL Note: Use the following subroutine in an ASCII environment: COBW3_SAF_GET_PARAM Session start Timeout processing Session data is forced Session data cannot be inherited
SAF Subroutines Interface Chapter 3. How to Use SAF Subroutines 23 This section explains the calling interface for using the SAF subroutines. Note: It is possible to check errors and warning in the SAF subroutines by referring to COBW3-STATUS, and those in SAF specific subroutines by referring to COBW3- SAF-STATUS. Value Meaning 0 Normal end Not zero Error number See Appendix B "Error Recovery Processing" for error numbers. Library The library file is a COPY member for use as a SAF data area. When calling SAF subroutines, include the following library file in the Working-Storage Section with a COPY statement. This library file is stored in the folder in which Fujitsu NetCOBOL has been installed. Library name: COBW3.cbl Format: Specify as follows: WORKING-STORAGE SECTION. COPY COBW3. To call SAF specific subroutines, include the SAF specific data area using the COPY statement. This library is also stored in the folder to which Fujitsu NetCOBOL has been installed. Library name: COBW3SAF.cbl Format: Specify as follows: WORKING-STORAGE SECTION. COPY COBW3. COPY COBW3SAF. *> Interface with a SAF specific subroutine Note: Do not specify REPLACING in the COPY statement of a SAF data area or write a REPLACE statement that might make the COPY statement a target for replacing. If names in the SAF data area are changed, the operation is not guaranteed. Calling SAF Subroutines In order to initialize the environment of the SAF subroutines and to get the Web page parameter list, it is necessary to call COBW3_INIT before calling any other SAF function. When terminating the processing for SAF subroutines, COBW3_FREE must be called to release resources acquired by the SAF subroutines. When calling other subroutines from a program that is not the one which called COBW3_INIT, the interface area (COBW3) defined in the program which called COBW3_INIT is shared among programs.
Page 1 and 2: SAF Subroutines User’s Guide
Page 3 and 4: Preface This manual explains how to
Page 5 and 6: Contents Chapter 1. NetCOBOL SAF Su
Page 7 and 8: Chapter 1. NetCOBOL SAF Subroutines
Page 9 and 10: Chapter 2. Creating Web Application
Page 11 and 12: WORKING-STORAGE SECTION. COPY COBW3
Page 13 and 14: • • • • • Chapter 2. Crea
Page 15 and 16: Chapter 3. How to Use SAF Subroutin
Page 17 and 18: • In the Unicode environment, use
Page 19 and 20: Web page for invoking the applicati
Page 21: Session Management Functions Chapte
Page 25 and 26: Condition-name Value Meaning Chapte
Page 27 and 28: • • Chapter 3. How to Use SAF S
Page 31 and 32: Application example: [a.htm (Web pa
Page 33 and 34: [COBOL program] Chapter 3. How to U
Page 35 and 36: CALL "COBW3_SET_CNV_NN" USING COBW3
Page 41 and 42: • COBW3_SANITIZE_CNV [Optional] C
Page 43 and 44: Format: CALL "COBW3_DEL_REPEAT" USI
Page 45 and 46: Application example: [COBOL program
Page 47 and 48: Condition-name Value Meaning COBW3-
Page 49 and 50: Manipulate Cookie Data Chapter 3. H
Page 51 and 52: - COBW3-COOKIE-EXPIRES-HOUR (Hours)
Page 53 and 54: Process result data: None COBW3_INI
Page 55 and 56: Process Result Data: • COBW3-SEAR
Page 57 and 58: • • • • Chapter 3. How to U
Page 59 and 60: Value Meaning Chapter 3. How to Use
Page 61 and 62: COBW3_END_SESSION Chapter 3. How to
Page 63 and 64: COBW3_ALTER_SESSION_TIMEOUT Chapter
Page 67 and 68: Data Length Restrictions of SAF Sub
Page 69 and 70: Chapter 4. Generating and Executing
Page 71 and 72: NES Settings Chapter 4. Generating
Page 73 and 74:
MIME Type Setup Chapter 4. Generati
Page 75 and 76:
Chapter 4. Generating and Executing
Page 77 and 78:
Executing a Web Application Chapter
Page 79 and 80:
Format: Chapter 4. Generating and E
Page 81 and 82:
Chapter 5. Debugging a SAF Applicat
Page 83 and 84:
Starting the Debugger To start debu
Page 85 and 86:
Chapter 5. Debugging a SAF Applicat
Page 87 and 88:
Chapter 6. Samples This chapter exp
Page 89 and 90:
Environment Setup Chapter 6. Sample
Page 91 and 92:
COBOL program (SAFMAIN.cob) Chapter
Page 93 and 94:
Chapter 6. Samples 93 001360 comput
Page 95 and 96:
Getting Request Information Chapter
Page 97 and 98:
Appendix A. Frequently Asked Questi
Page 99 and 100:
Page 101 and 102:
Page 103 and 104:
Page 105 and 106:
Appendix B. Error Recovery Processi
Page 107 and 108:
Page 109 and 110:
Page 111 and 112:
Page 113 and 114:
Appendix C. Architecture of a NetCO
Page 115 and 116:
Appendix D. CGI To SAF Subroutines
Page 117 and 118:
Application Form Appendix D. CGI To
Page 119 and 120:
Compilation Method Appendix D. CGI
Page 121 and 122:
Modified contents of a SAF applicat
Page 123 and 124:
Modify Cookie operation as shown be
show all

NetCOBOL for SPARC Architecture SAF Subroutines User's Guide

Create successful ePaper yourself

Delete template?

Save as template?