HP 3000 Manuals

User Logging Error Codes [ User Logging Programmer's Guide ] MPE/iX 5.0 Documentation


User Logging Programmer's Guide

Appendix C  User Logging Error Codes 

Table C-1 lists the User Logging error codes and their meanings.  These
error codes are returned in the logstatus parameter of each of the User
Logging intrinsics.

          Table C-1.  User Logging Error Codes 

-----------------------------------------------------------------------------------------------
|          |                                       |                                          |
|   Code   |                Meaning                |            Corrective Action             |
|          |                                       |                                          |
-----------------------------------------------------------------------------------------------
|          |                                       |                                          |
|    0     | No error for this intrinsic call.     | None.                                    |
|          |                                       |                                          |
-----------------------------------------------------------------------------------------------
|          |                                       |                                          |
|    1     | User requested NOWAIT mode and the    | Retry the intrinsic call.                |
|          | logging process is busy.              |                                          |
|          |                                       |                                          |
-----------------------------------------------------------------------------------------------
|          |                                       |                                          |
|    2     | Parameter out of bounds in logging    | Check all parameters to be sure they are |
|          | intrinsic.  For example, the address  | correct and addressed properly.          |
|          | of data, for WRITELOG, and the length |                                          |
|          | given will go beyond the top of the   |                                          |
|          | stack.                                |                                          |
|          |                                       |                                          |
-----------------------------------------------------------------------------------------------
|          |                                       |                                          |
|    3     | A request to open or write to a       | Use the :SHOWLOGSTATUS command to        |
|          | logging process that is not running.  | determine which User Logging processes   |
|          |                                       | are running.  To start or restart a User |
|          |                                       | Logging process, the system supervisor   |
|          |                                       | can use the :LOG command.                |
|          |                                       |                                          |
-----------------------------------------------------------------------------------------------
|          |                                       |                                          |
|    4     | Incorrect index parameter passed to a | The index parameter must be a number     |
|          | User Logging intrinsic.               | that was returned by a successful call   |
|          |                                       | to the OPENLOG intrinsic.  Do not change |
|          |                                       | it.  It will not be valid after a call   |
|          |                                       | to CLOSELOG with that index parameter.   |
|          |                                       |                                          |
-----------------------------------------------------------------------------------------------
|          |                                       |                                          |
|    5     | Incorrect mode parameter passed to a  | For the WRITELOG intrinsic, valid mode   |
|          | user logging intrinsic.               | parameters are 0, 1, and 2.  For all     |
|          |                                       | other intrinsics, valid mode parameters  |
|          |                                       | are 0 and 1 only.                        |
|          |                                       |                                          |
-----------------------------------------------------------------------------------------------
|          |                                       |                                          |
|    6     | A request to open the logfile was     | The :SHOWLOGSTATUS command or the        |
|          | denied and the User Logging process   | LOGINFO intrinsic will give the current  |
|          | was suspended (the User Logging       | state of the User Logging process.  If   |
|          | process is stopping or attempting     | the process is stopped, it must be       |
|          | recovery from an exception condition, | restarted by the system supervisor       |
|          | for example, a power failure).        | before the user can open the file.       |
|          |                                       |                                          |
-----------------------------------------------------------------------------------------------
|          |                                       |                                          |
|    7     | Illegal capability.  The user must    | See your account or system manager to    |
|          | have LG or OP capabilities to use the | obtain the proper capabilities.          |
|          | User Logging intrinsics.              |                                          |
|          |                                       |                                          |
-----------------------------------------------------------------------------------------------

          Table C-1.  User Logging Error Codes (Cont.) 

-----------------------------------------------------------------------------------------------
|          |                                       |                                          |
|   Code   |                Meaning                |            Corrective Action             |
|          |                                       |                                          |
-----------------------------------------------------------------------------------------------
|          |                                       |                                          |
|    8     | Incorrect password was passed to a    | The creator of the logid can obtain the  |
|          | User Logging intrinsic.               | password by using the ;PASS option of    |
|          |                                       | the :LISTLOG command.                    |
|          |                                       |                                          |
-----------------------------------------------------------------------------------------------
|          |                                       |                                          |
|    9     | An error occurred while writing to    | Obtain the File System error from the    |
|          | the log file.  The File System error  | $STDLIST and take the appropriate        |
|          | message will be printed on $STDLIST.  | action.                                  |
|          |                                       |                                          |
-----------------------------------------------------------------------------------------------
|          |                                       |                                          |
|    12    | The system is out of disc space, the  | Take the usual action for obtaining disc |
|          | logging process cannot proceed.       | space, then restart the logging process. |
|          |                                       |                                          |
-----------------------------------------------------------------------------------------------
|          |                                       |                                          |
|    13    | OPENLOG failed.  The maximum number   | Temporary solution:  Wait for a user,    |
|          | of users that can access a User       | who is accessing the logfile, to finish. |
|          | Logging process at one time has been  |                                          |
|          | reached.  This number is configurable |                                          |
|          | at system startup only.               | Long term solution:  At the next system  |
|          |                                       | startup, have the number of users that   |
|          |                                       | can access a User Logging process        |
|          |                                       | increased.                               |
|          |                                       |                                          |
-----------------------------------------------------------------------------------------------
|          |                                       |                                          |
|    14    | Invalid access to a log file          | Each user wanting to access a User       |
|          | (security violation).  The user,      | Logging process, and its associated      |
|          | group, or account calling the         | logfile, must have obtained access to it |
|          | intrinsic does not match the user,    | through a call to OPENLOG.               |
|          | group, or account for the log index   |                                          |
|          | passed.                               |                                          |
|          |                                       |                                          |
-----------------------------------------------------------------------------------------------
|          |                                       |                                          |
|    15    | End-of-file on logfile (the logfile   | :RENAME the logfile and :BUILD a new one |
|          | is full and AUTO was not on to        | with the old name, type :LOG logid,START |
|          | automatically switch to a new         | to restart the logging process.          |
|          | logfile).                             |                                          |
|          |                                       | or                                       |
|          |                                       |                                          |
|          |                                       | :BUILD a new logfile with a new name,    |
|          |                                       | use the :ALTLOG command to point the     |
|          |                                       | logid to the new logfile, and use :LOG   |
|          |                                       | logid, START to restart the logging      |
|          |                                       | process.                                 |
|          |                                       |                                          |
-----------------------------------------------------------------------------------------------
|          |                                       |                                          |
|    16    | The logid does not exist.             | To see the logids that exist, use the    |
|          |                                       | :LISTLOG command.  To add a logid, use   |
|          |                                       | the :GETLOG command.                     |
|          |                                       |                                          |
-----------------------------------------------------------------------------------------------
|          |                                       |                                          |
|    17    | Parameter (either itemnum or itemval) | Check the LOGINFO parameters, the        |
|          | missing for the LOGINFO intrinsic.    | itemnum and itemval must occur in pairs. |
|          |                                       |                                          |
-----------------------------------------------------------------------------------------------
|          |                                       |                                          |
|    18    | Invalid item number passed to the     | Refer to the MPE XL Intrinsics Reference |
|          | LOGINFO itemnum parameter.            | Manual (32650-90028) for a complete list |
|          |                                       | of valid item numbers that can be        |
|          |                                       | returned to the itemnum parameter of the |
|          |                                       | LOGINFO intrinsic.                       |
|          |                                       |                                          |
-----------------------------------------------------------------------------------------------



MPE/iX 5.0 Documentation