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

 

 



Sunaccess Reference Sample Visual Basic Program Sunaccess Errors