NetCOBOL for SPARC Architecture SAF Subroutines User's Guide

More documents

Recommendations

Info

24 Chapter 3. How to Use SAF Subroutines Example: Calling COBW3_INIT by the parent program and calling COBW3_FREE by the child program B. Parent program IDENTIFICATION DIVISION. PROGRAM-ID. "MainProc". DATA DIVISION. WORKING-STORAGE SECTION. COPY COBW3. LINKAGE SECTION. 01 SAFCTX POINTER. PROCEDURE DIVISION USING SAFCTX. MOVE LOW-VALUE TO COBW3. MOVE SAFCTX TO COBW3-CONTEXT. CALL "COBW3_INIT" USING COBW3. : CALL "B" USING COBW3 * EXIT PROGRAM. Child program IDENTIFICATION DIVISION. PROGRAM-ID. B. DATA DIVISION. LINKAGE SECTION. COPY COBW3 PROCEDURE DIVISION USING COBW3. : CALL "COBW3_FREE" USING COBW3. EXIT PROGRAM. Set the Work Environment and Acquire Web Parameter COBW3_INIT Set the work environment for SAF subroutines. Get a Web parameter and set it to the work area to be used by SAF subroutines. Note: Initialize COBW3 in the interface area with LOW-VALUE before calling COBW3_INIT. Format: CALL "COBW3_INIT" USING COBW3. COBW3 Data for Call: • • COBW3-CONTEXT [required] Specify the Linkage Section pointer to the data work area with the SAF director. Do not change the specified value. COBW3-DMODE [optional] Specify error message output of SAF subroutines. COBW3-DMODE is valid only when the operation code is ASCII.
Condition-name Value Meaning Chapter 3. How to Use SAF Subroutines 25 COBW3-DMODE-NODBG LOW-VALUE No error message is output. COBW3-DMODE-DBG "1" An error message is output to the browser. Processing Result Data: None. Note: If COBW3_INIT is called more than once per connection, the Web data area obtained may be reinitialized and subsequent operations may fail. Manipulate Web Parameters COBW3_GET_VALUE, COBW3_GET_VALUE_XX, COBW3_GET_VALUE_NX, COBW3_GET_VALUE_XN, COBW3_GET_VALUE_NN Search a field name (NAME) from the Web parameter obtained in COBW3_INIT and return the value (VALUE) corresponding to the name. ASCII environment: • COBW3_GET_VALUE Search the name (NAME) of an alphanumeric character-string and return the value (VALUE) corresponding to the name as an alphanumeric character-string. Unicode environment: • COBW3_GET_VALUE_XX Search the name (NAME) of an alphanumeric character-string and return the value (VALUE) corresponding to the name as an alphanumeric character-string. • COBW3_GET_VALUE_NX Search the name (NAME) of a national character-string and return the value (VALUE) corresponding to the name as an alphanumeric character-string. • COBW3_GET_VALUE_XN Search the name (NAME) of a alphanumeric character-string and return the value (VALUE) corresponding to the name as a national character-string. • COBW3_GET_VALUE_NN Search the name (NAME) of a national character-string and return the value (VALUE) corresponding to the name as a national character-string. Padding characters for storing the obtained value (VALUE) are blank. Format: CALL "COBW3_GET_VALUE" USING COBW3.
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 and 22: Session Management Functions Chapte
Page 23: SAF Subroutines Interface Chapter 3
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

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?