NetCOBOL for SPARC Architecture SAF Subroutines User's Guide

64 Chapter 3. How to Use SAF Subroutines
Condition-name Value Meaning
COBW3-SESSION-DATA–GROUPITEM “0” A group item is used as the session
data.
COBW3-SESSION–DATA-OBJECT “1” An object reference item is used as the
session data.
• COBW3-SESSION-STATUS
Sets the current session status.
Condition-name Value Meaning
COBW3-SESSION-STATUS-NON “0” The session is not started yet or
already ended.
COBW3-SESSION–STATUS-STARTED “1” The session has been started up.
SAF-Specific Subroutines
COBW3_SAF_GET_PARM, COBW3_SAF_GET_PARM_XX,
COBW3_SAF_GET_PARM_NX, COBW3_SAF_GET_PARM_XN,
COBW3_SAF_GET_PARM_NN
Search for an NES parameter name in the NES parameter information and get the
parameter value corresponding to the NES parameter name.
Each subroutine has the following meaning.
ASCII environment:
• COBW3_SAF_GET_PARM
Searches for an NES parameter name consisting of an alphanumeric character
string, and returns the corresponding NES parameter value in an alphanumeric
character string.
Unicode environment:
• COBW3_SAF_GET_PARM_XX
Searches for an NES parameter name consisting of an alphanumeric character
string, and returns the corresponding NES parameter value in an alphanumeric
character string.
• COBW3_SAF_GET_PARM_NX
Searches for an NES parameter name consisting of a national character string,
and returns the corresponding NES parameter value in an alphanumeric
character string.
• COBW3_SAF_GET_PARM_XN
Searches for an NES parameter name consisting of an alphanumeric character
string, and returns the corresponding NES parameter value in a national
character string.