MPE/iX Intrinsics Reference Manual (32650-90875)

570 Chapter9
Command Definitions (MAIL-PUTJCW)
OPENLOG
OPENLOG
NM and CM callable.
Provides access to the user logging facility.
Syntax
I32 CA CA I16 I16
OPENLOG(
index,logid,pass,mode,logstatus );
Parameters
index 32-bit signed integer by reference (required)
Returns the user logging access. The User Logging facility uses the value
of the
index parameter to check the validity of subsequent calls to the
other user logging intrinsics. The value returned is valid only for the
process that made the OPENLOG call.
logid character array (required)
Passes the user logging identifier. Contains up to eight alphanumeric
characters. Arrays < 8-characters must be terminated with a
nonalphanumeric character.
pass character array (required)
Passes the password associated with the user logging identifier by the
GETLOG command.
mode 16-bit signed integer by reference (required)
Passes a value indicating whether the user logging facility suspends the
process if it cannot complete the request for service immediately:
Value Meaning
0 Wait
1 Nowait
If it is not possible to log the transaction and
mode is set to nowait,
logstatus indicates that it could not complete the request.
logstatus 16-bit signed integer by reference (required)
Returns one of the following values, indicating the success/failure of the
call:
Value Meaning
0
Successful
1 Nowait mode requested; user logging process busy
2 Parameter out of bounds