IBM 2 Computer Hardware User Manual


 
Logon_Control CCA Release 2.54
Logon_Control (CSUALCT)
Platform/
Product
OS/2 AIX Win NT/
2000
OS/400
IBM 4758-2/23 X X X X
Use the Logon_Control verb to perform the following services:
Log on to the Coprocessor, using your access-control profile
Log off of the Coprocessor
Save or restore logon content information.
Select the service to perform by specifying the corresponding keyword in the input
rule-array. Only one service is performed for each call to this verb.
If you log on to the adapter when you are already logged on, the existing logon
session is replaced with a new session.
Restrictions
None
Format
CSUALCT
return_code Output Integer
reason_code Output Integer
exit_data_length In/Output Integer
exit_data In/Output String exit_data_length
rule_array_count Input Integer one or two
rule_array Input String
array
rule_array_count * 8 bytes
user_id Input String 8 bytes
auth_parms_length Input Integer
auth_parms Input String auth_parms_length bytes
auth_data_length In/Output Integer
auth_data Input String auth_data_length bytes
Parameters
For the definitions of the return_code, reason_code, exit_data_length, and exit_data
parameters, see “Parameters Common to All Verbs” on page 1-11.
rule_array_count
The rule_array_count parameter is a pointer to an integer variable containing
the number of elements in the rule_array variable. The value must be one or
two for this verb.
rule_array
The rule_array parameter is a pointer to a string variable containing an array of
keywords. The keywords are eight bytes in length, and must be left-justified
and padded on the right with space characters. The rule_array keywords are
shown below:
2-52 IBM 4758 CCA Basic Services, Release 2.54, February 2005