Control File
The Sunaccess control file (sunacces.ini) contains information that allows the user to tailor the operations of the Sunaccess routines.
Sunaccess supports the following keywords. The operational description for the keywords are the same as described in the PL/B Runtime Reference Manual.
Keywords for Sunaccess can be placed in the [Environment] section of the control file. In addition, a function named SA_CONFIG allows settings to be changed under program control.
A Sunaccess Error Code indicates a bad keyword has been encountered:
|
Value |
Meaning |
|
-101 |
Invalid keyword encountered. |
The PLB keywords available for Sunaccess are:
|
Keyword |
|
PLB_AAMUPPER |
|
PLB_CHECKFILE2GB |
|
PLB_CHKDRN |
|
PLB_COPYFILEBUFFSZ |
|
PLB_DPTFILENAME |
|
PLB_EOR |
|
PLB_DMALTIP |
|
PLB_FNC |
|
PLB_LOCKIO |
|
PLB_NDUP |
|
PLB_OPENABS |
|
PLB_OPENUSEIP |
|
PLB_PATH |
|
PLB_PREPUSEIP |
|
PLB_PREP87 |
|
PLB_RDCLR |
|
PLBWIN_XPIO |
|
PLBWIN_W33RETRY |
In addition, SunAccess supports a new keyword:
SA_PRE87B={on|off}
This keyword controls whether the output buffer for Sunaccess read functions is pre-initialized to a null string or not. Prior to the 8.7B Sunaacess version, the output buffer was never pre-initialized. Starting with version 8.7B, the output buffer is always pre-initialized to a null string. When this keyword is set to 'ON', then the output buffer is not pre-initialized. If this keyword is not specified, the output buffer is pre-initialized by default the same as when the keyword is set to 'OFF'.
This keyword affects the following Sunaccess functions:
|
Instruction |
|
SA_AamRead |
|
SA_AamReadLast |
|
SA_AamReadKG |
|
SA_AamReadKGP |
|
SA_IsiRead |
|
SA_IsiReadKS |
|
SA_IsiReadKP |
|
SA_TxtRead |
![]() |