NetCOBOL for SPARC Architecture SAF Subroutines User's Guide
NetCOBOL for SPARC Architecture SAF Subroutines User's Guide
NetCOBOL for SPARC Architecture SAF Subroutines User's Guide
You also want an ePaper? Increase the reach of your titles
YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.
Chapter 3. How to Use <strong>SAF</strong> <strong>Subroutines</strong> 65<br />
• COBW3_<strong>SAF</strong>_GET_PARM_NN<br />
Searches <strong>for</strong> an NES parameter name consisting of a national character string,<br />
and returns the corresponding NES parameter value in a national character<br />
string.<br />
Padding characters <strong>for</strong> storing the obtained NES parameter value are blank.<br />
Note: As the NES parameter name is case-sensitive, the ALPHAL (WORD) or<br />
NOALPHAL compiler option must be used if necessary.<br />
Formats:<br />
•<br />
•<br />
CALL "COBW3_<strong>SAF</strong>_GET_PARM" USING COBW3<strong>SAF</strong>.<br />
CALL "COBW3_<strong>SAF</strong>_GET_PARM_XX" USING COBW3<strong>SAF</strong>.<br />
CALL "COBW3_<strong>SAF</strong>_GET_PARM_NX" USING COBW3<strong>SAF</strong>.<br />
CALL "COBW3_<strong>SAF</strong>_GET_PARM_XN" USING COBW3<strong>SAF</strong>.<br />
CALL "COBW3_<strong>SAF</strong>_GET_PARM_NN" USING COBW3<strong>SAF</strong>.<br />
COBW3 Data <strong>for</strong> Calls:COBW3-<strong>SAF</strong>-PARM-NAME, COBW3-<strong>SAF</strong>-PARM-NAME-N<br />
Set a NES parameter name to be located.<br />
Specify the NES parameter name in COBW3-<strong>SAF</strong>-PARM-NAME <strong>for</strong><br />
COBW3_<strong>SAF</strong>_GET_PARM, COBW3_<strong>SAF</strong>_GET_PARM_XX or<br />
COBW3_<strong>SAF</strong>_GET_PARM_XN.<br />
Specify it in COBW3-<strong>SAF</strong>-PARM-NAME-N <strong>for</strong> COBW3_<strong>SAF</strong>_GET_PARM_NX or<br />
COBW3_<strong>SAF</strong>_GET_PARM_NN.<br />
COBW3-<strong>SAF</strong>-PARM-NAME-LENGTH [Optional]<br />
Sets a length of NES parameter character string (in bytes) <strong>for</strong> search of a NES<br />
parameter name if it ends with a valid space.<br />
Value Meaning<br />
0 The NES parameter name of the entire length of character string except <strong>for</strong><br />
spaces. However, if the COBW3-<strong>SAF</strong>-PARM-NAME or COBW3-<strong>SAF</strong>-PARM-<br />
NAME-N is only spaces, the length of character string is considered to be zero.<br />
1 to 64 The specified length of NES parameter name is searched.
Change language