HP 3000 Manuals HP 3000 Manuals
OPENLOG
NM and CM callable.
Provides access to the user logging facility. User logging (LG) or
system supervisor (OP) capability is required.
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
3 Request to open or write to a user logging process not
running
5 Incorrect mode parameter passed
6 Request denied; user logging process suspended
7 Illegal capability; user logging (LG) or system
supervisor (OP) capability required
8 Incorrect password passed
9 Error while writing to the user logging file
12 System out of disk space; user logging cannot proceed
13 Out of user logging entries
15 End-of-file on user logging file
16 Invalid user logging identifier
Operation Notes
The user logging facility establishes a logging buffer (LOGBUFF) entry
for every active process and increments the user count only at the first
OPENLOG call. Other counters keep track of the number of times OPENLOG
and CLOSELOG are called for each user; the counter is incremented for
every OPENLOG and decremented for every CLOSELOG for each user. This
ensures that the entry in LOGBUFF is released only if it is the last
CLOSELOG call (that is, call counter = 0). The number of users and log
entries are independent of the number of times the OPENLOG/CLOSELOG
intrinsics are called within an application.
Related Information
Intrinsics None
Commands LOG
Manuals User Logging Programmer's Guide (32650-90027)