RSC/MP 7.2 Programming Manual

Access Control Server

HP NonStop Remote Server Call (RSC/MP) Programming Manual—522360-004

9-4

Configuring a Workstation for an ACS

Use the RscSetOption function call to set these options:

ACS_BINARY_AREA Used in place of the ACS_MESSAGE_AREA option

(shown on page 9-4) to set the contents of the

message to be passed to (or retrieve the message

received from) the ACS process on the host to a binary

string up to 128 bytes long. Because the value set by

the ACS_BINARY_AREA option can contain any bit

combination (potentially illegal values for an ASCII file),

it cannot be used in the RSC.INI file. It can only be set

through RscSetOption. The message area referred to

by the ACS_BINARY_AREA is the same space used

with the ACS_MESSAGE_AREA option.

The RscSetOption and RscGetOption calls operate

differently when used with the ACS_BINARY_AREA

option than with other options. When either

RscSetOption or RscGetOption is called, both the

pcOptionString and the nOptionValue parameters are

significant. pcOptionString is a pointer to the binary

message and nOptionValue is the byte count to send or

retrieve. For example:

retval=RscSetOption (OptionsHandle,

"ACS_BINARY_AREA", pvBinaryMessage,

sizeof(BinaryMessage));

ACS_MESSAGE_AREA RSC/MP passes this optional message to the ACS on

the host when you issue an RscBeginSession function.

The message (ASCII) can use up to 128 bytes. When

stored in an RSC/MP configuration file, if the message

contains spaces, you must enclosed it in double quotes

("). The value supplied to set this option, regardless

whether it is set via an RscSetOption call or in the

RSC.INI file, must contain only printable characters.

The ACS_BINARY_AREA option allows passing and

retrieving any binary sequence.

You can retrieve a reply from the user-written ACS by

issuing an RscGetOption call for the

ACS_MESSAGE_AREA option after the return from the

RscBeginSession call.