![]() |
![]() |
You can write Tivoli Storage Manager scripts that include return
codes. Use the return code to determine how script processing
proceeds. The return codes can be one of three severities: OK,
WARNING, ERROR. Tivoli Storage Manager scripts use the symbolic return
code for processing, not the numeric value. The administrative client
displays the numeric values when a command is run. The return codes are
shown in the following table.
Table 298. Return Code Checking
Return code | Severity | Numeric value | Description |
---|---|---|---|
RC_OK | OK | 0 | Command completed successfully |
RC_NOTFOUND | WARNING | 11 | Returned by a QUERY or SQL SELECT command when no objects are found that match specifications |
RC_UNKNOWN | ERROR | 2 | Command is not found; not a known command |
RC_SYNTAX | ERROR | 3 | Command is valid, but one or more parameters were not specified correctly |
RC_ERROR | ERROR | 4 | An internal server error prevented the command from successfully completing |
RC_NOMEMORY | ERROR | 5 | The command could not be completed because of insufficient memory on the server |
RC_NOLOG | ERROR | 6 | The command could not be completed because of insufficient recovery log space on the server |
RC_NODB | ERROR | 7 | The command could not be completed because of insufficient database space on the server |
RC_NOSTORAGE | ERROR | 8 | The command could not be completed because of insufficient storage space on the server |
RC_NOAUTH | ERROR | 9 | The administrator is not authorized to issue the command |
RC_EXISTS | ERROR | 10 | The command failed because the specified object already exists on the server |
RC_INUSE | ERROR | 12 | The command failed because the object to be operated upon was in use |
RC_ISREFERENCED | ERROR | 13 | The command failed because the object to be operated upon is still referenced by some other server construct |
RC_NOTAVAILABLE | ERROR | 14 | The command failed because the object to be operated upon is not available |
RC_IOERROR | ERROR | 15 | The command failed because an input/output (I/O) error was encountered on the server |
RC_NOTXN | ERROR | 16 | The command failed because a database transaction failed on the server |
RC_NOLOCK | ERROR | 17 | The command failed because a lock conflict was encountered in the server database |
RC_NOTHREAD | ERROR | 19 | The command could not be completed because of insufficient memory on the server |
RC_LICENSE | ERROR | 20 | The command failed because the server is not in compliance with licensing |
RC_INVDEST | ERROR | 21 | The command failed because a destination value was invalid |
RC_IFILEOPEN | ERROR | 22 | The command failed because an input file that was needed could not be opened |
RC_OFILEOPEN | ERROR | 23 | The command failed because it could not open a required output file |
RC_OFILEWRITE | ERROR | 24 | The command failed because it could not successfully write to a required output file |
RC_INVADMIN | ERROR | 25 | The command failed because the administrator was not defined |
RC_SQLERROR | ERROR | 26 | An SQL error was encountered during a SELECT statement query |