NetCOBOL for SPARC Architecture SAF Subroutines User's Guide

66 Chapter 3. How to Use SAF Subroutines
Process Result Data:
• COBW3-SAF-SEARCH-FLAG
•
•
Condition-name Value Meaning
COBW3-SAF-PARM–FLAG-NON “0” The specified NES name is not found.
COBW3-SAF-PARM–FLAG-EXIST “1” The specified NES name has been found.
COBW3-SAF-PARM-VALUE, COBW3-SAF-PARM-VALUE-N
Set an NES parameter value corresponding to the NES parameter name to be
located.
The NES parameter value is set in COBW3-SAF-PARM-VALUE for
COBW3_SAF_GET_PARM, COBW3_SAF_GET_PARM_XX or
COBW3_SAF_GET_PARM_NX.
Set it in COBW3-SAF-PARM-VALUE-N for COBW3_SAF_GET_PARM_XN or
COBW3_SAF_GET_PARM_NN.
COBW3-SAF-PARM-LENGTH
Sets a length of character string of NES parameter value (in bytes)
corresponding to the NES parameter name to be searched.
COBW3_SAF_GET_BASENAME
Gets an application name to be set in the URL.
Note: As an application is identified by its MIME type (extender) in NES, the
application name can be used as part of input data for process switching. The
application name can contain any character. However, the operations are unreliable
if a character other than “a” to “z,” “A” to “Z,” “0” to “9,” “-“ (hyphen) or “_”
(underscore) is included.
Format:
CALL "COBW3_SAF_GET_BASENAME " USING COBW3SAF.
COBW3 Data for Calls:
None
Process Result Data:
• COBW3-SAF-BASENAME
Gets an application name.
•
COBW3-SAF-BASENAME-LENGTH
Gets the length the application name (in bytes).