HP 3000 Manuals

The Maintenance Report File [ HP DeskManager Customization ] MPE/iX 5.0 Documentation


HP DeskManager Customization

The Maintenance Report File 

PASCAL File Layout for MSORTOUT 

FILENAME:        MSORTOUT.MAILDB.HPOFFICE

Record Length    = 120 bytes

Smallint range   = -32768...32767

Integer          = Pascal integer

Each record has a type, numbered in the range 0 - 19.  The type is
indicated in the first two bytes of each record.

Sorting uses the first forty six bytes as a sort key.

Type 0 

          COMPUTER IDENTIFICATION RECORD (one only) 

Column                    | Content 
                          |
----------------------------------------------------------------------------------------
                          |
001-002                   | Record type (value 0 - smallint)
                          |

003-010                   | Computer name (8 bytes)
                          |
011-120                   | (not used)
                          |

Type 1 

          ERROR QUEUE SUMMARY RECORD (one only) 

Column                    | Content 
                          |
----------------------------------------------------------------------------------------
                          |
001-002                   | Record type (value 1 - smallint)
                          |
003-046                   | (not used)
                          |
047-048                   | Number of items in error queue (smallint)
                          |
049-120                   | (not used)
                          |

Type 2 

          ERROR QUEUE DETAIL 

Column                    | Content 
                          |
----------------------------------------------------------------------------------------
                          |
001-002                   | Record type (value 2 - smallint)
                          |
003-046                   | (not used)
                          |
047-050                   | Item number (integer)
                          |
051-052                   | Error number (smallint)
                          |
                          | Refer to HP DeskManager Administration 
                          |
                          | 101 Message transmitted too many times
                          | 102 Destination database too small
                          | 103 Serialization fail
                          | 104 Invalid message
                          | 105 Message without Distribution List
                          | 106 Private message destroyed
                          | 108 Message corrupt
                          | 109 Undefined reason
                          |
053-054                   | Item displayable indicator (smallint)
                          | 0 = yes, 1 = No
                          |
055-120                   | (not used)
                          |

Type 3 

          ITEM SCAN SUMMARY RECORD (one only) 

Column                    | Content 
                          |
----------------------------------------------------------------------------------------
                          |
001-002                   | Record type (Value 3 - smallint)
                          |
003-046                   | (not used)
                          |
047-050                   | Total number of items to start
                          |
051-054                   | Basic items successfully deleted
                          |
055-058                   | Composite items successfully deleted
                          |
059-062                   | Basic items unsuccessfully deleted
                          |
063-066                   | Composite items unsuccessfully deleted
                          |
067-070                   | Items of unknown type successfully deleted
                          |
071-074                   | Basic items patched (IMAGE chain length did not equal HP
                          | Desk count)
                          |
075-078                   | Composite items patched (IMAGE chain length did not equal HP
                          | Desk item count)
                          |
079-082                   | Corrupt basic items (IMAGE intrinsic error)
                          |
083-086                   | Corrupt composite items (IMAGE intrinsic error)
                          |
087-090                   | Empty basic items
                          |
091-094                   | Good basic items
                          |
095-098                   | Good composite items
                          |
099-120                   | (not used)
                          |

Type 4 

          NODE SCAN SUMMARY RECORD (one only) 

Column                    | Content 
                          |
----------------------------------------------------------------------------------------
                          |
001-002                   | Record type (value 4 - smallint)
                          |
003-046                   | (not used)
                          |
047-048                   | Total number of nodes (smallint)
                          |
049-120                   | (not used)
                          |

Type 5 

          NODE SCAN DETAIL RECORD 

Column                    | Content 
                          |
----------------------------------------------------------------------------------------
                          |
001-002                   | Record type (value 5 - smallint)
                          |

003-010                   | Node name (8 bytes)
                          |
011=046                   | (not used)
                          |
047-050                   | Number of item headers in express mode
                          |
051-054                   | Number of item content sectors (express mode)
                          |
055-058                   | Number of item headers in urgent mode
                          |
060-062                   | Number of item content sectors in urgent mode
                          |
063-066                   | Number of item headers in normal mode
                          |
067-070                   | Number of item content sectors in normal mode
                          |
071-074                   | Number of item headers in deferred mode
                          |
075-078                   | Number of item content sectors (deferred mode)
                          |
079-082                   | Number of messages posted per mail node
                          |
083-084                   | Node type (0 = remote, 1 = local)
                          |
085-120                   | (not used)
                          |

Type 6 

          USER SCAN SUMMARY RECORD (one only) 

Column                    | Content 
                          |
----------------------------------------------------------------------------------------
                          |
001-002                   | Record type (value 6 - smallint)
                          |
003-046                   | (not used)
                          |
047-048                   | Number of local users (smallint)
                          |
049-120                   | (not used)
                          |

Type 7 

          USER SCAN DETAIL RECORD 
          (number dependent on content of Type 6 record) 
Column                    | Content 
                          |
----------------------------------------------------------------------------------------
                          |
001-002                   | Record type (value 7 - smallint)
                          |
003-010                   | Node name for user node (8 bytes)
                          |
011-046                   | User name (36 bytes)
                          |
047-094                   | Disk space usage counts (all integers)
                          |
                          | Array of 12 elements, 4 bytes each:
                          |

047-050                   | Number of item headers in In Tray
                          |
050-054                   | Number of item content sectors in In Tray
                          |
055-058                   | Number of item headers in Out Tray
                          |
059-062                   | Number of item content sectors in Out Tray
                          |
063-066                   | Number of item headers in Pending Tray
                          |
067-070                   | Number of item content sectors in Pending Tray
                          |
071-074                   | Number of item headers in Filing Cabinet
                          |
075-078                   | Number of item content sectors in Filing Cabinet
                          |
079-082                   | Number of item headers in Work Area
                          |
083-086                   | Number of item content sectors in Work Area
                          |
087-090                   | Number of item headers in List Area
                          |
091-094                   | Number of item content sectors in List Area
                          |
095-099                   | Number of messages reposted during maintenance (from User's
                          | Out Tray)
                          |
100-120                   | (not used)
                          |

Type 8 

          USER STATISTICS REPORT RECORD 
          (number dependent on content of Type 6 record) 
Column                    | Content 
                          |
----------------------------------------------------------------------------------------
                          |
001-002                   | Record type (value 8 - smallint)
                          |
003-010                   | Node name for user node (8 bytes)
                          |
011-046                   | User name (36 bytes)
                          |
047-094                   | Sort user counts (all integers)
                          |
                          | Array of 6 elements of 4 bytes each:
                          |
047-050                   | Messages received since last maintenance run
                          |
051-054                   | Cumulative total messages received
                          |
055-058                   | Messages sent since last maintenance run
                          |
059-062                   | Cumulative total messages sent
                          |
063-066                   | Total number of sign-ons
                          |
067-070                   | Last sign-on date and time, in seconds since 00:00 on 1/1/61
                          |
071-120                   | (not used)
                          |

Type 9 

          USER DIARY USAGE REPORT RECORD 
          (Number depends on the content of Type 6 record) 
Column                    | Content 
                          |
----------------------------------------------------------------------------------------
                          |
001-002                   | Record type (value 9 - smallint)
                          |
003-046                   | (not used)
                          |
047-094                   | Sort user counts
                          |
                          | Array of 12 elements, 4 bytes each:
                          |
047-050                   | Number of single diary entries per user
                          |
051-054                   | Number of multiple diary entries (insertions)
                          |
055-058                   | Maximum date in days since 1/1/1900 inclusive
                          |
059-063                   | Minimum date in days since 1/1/1900 inclusive
                          | (if maximum is less than minimum, then the diary is not
                          | used)
                          |
064-120                   | (not used)
                          |

Type 10 

          ARCHIVE SUMMARY RECORD (one only) 

Column                    | Content 
                          |
----------------------------------------------------------------------------------------
                          |
001-002                   | Record type (value 10 - smallint)
                          |
003-046                   | (not used)
                          |
047-094                   | Summary status (used internally by HP Desk - smallint)
                          |
049-050                   | Primary pending archive requests - smallint
                          |
051-052                   | Secondary pending archive requests - smallint
                          |
053-054                   | Deferred pending archive requests - smallint
                          |
055-056                   | Pending retrieve requests - smallint
                          |
057-058                   | Tape count - smallint
                          |

Type 11 

          ARCHIVE DETAIL RECORD 
          (number depends on tape count in Type 10 record) 
Column                    | Content 
                          |
----------------------------------------------------------------------------------------
                          |
001-002                   | Record type (value 11 - smallint)
                          |

003-046                   | (not used)
                          |
047-048                   | Summary status (used internally by HP Desk - smallint)
                          |
049-050                   | Number of copies - smallint
                          |
051-054                   | HP Desk internal archive identifier - integer
                          |
055-058                   | Created date/time - integer (seconds since 00:00 on 1/1/61)
                          |
059-064                   | ANSI tape identifier (6 bytes)
                          |
065-072                   | User tape identifier (8 bytes)
                          |
073-120                   | (not used)
                          |

Type 12 

          CATALOG SUMMARY RECORD (one only) 

Column                    | Content 
                          |
----------------------------------------------------------------------------------------
                          |
001-002                   | Record type (value 12 - smallint)
                          |
003-046                   | (not used)
                          |
047-048                   | Summary status (used internally by HP Desk - smallint)
                          |
049-050                   | Pending catalog delete requests - smallint
                          |
051-052                   | Pending catalog entry delete requests - smallint
                          |
053-054                   | Catalog count - smallint
                          |
055-120                   | (not used)
                          |

Type 13 

          CATALOG DETAIL RECORD 
          (number depends on catalog count in Type 12 record) 
Column                    | Content 
                          |
----------------------------------------------------------------------------------------
                          |
001-002                   | Record type (value 13 - smallint)
                          |
003-010                   | (not used)
                          |
011-046                   | Name of catalog manager (36 bytes)
                          |
047-048                   | Detail status
                          | (used internally by HP Desk - smallint)
                          |
049-050                   | Number of items in catalog - smallint
                          |
051-054                   | HP Desk internal catalog identifier - integer
                          |

055-058                   | Catalog creation date/time - integer
                          | (seconds since 00:00 on 1/1/61)
                          |
059-113                   | Catalog label (55 bytes)
                          |
114-120                   | (not used)
                          |

Type 14 

          NODE STATISTICS REPORT 
          (number depends on content of Type 6 record) 
Column                    | Content 
                          |
----------------------------------------------------------------------------------------
                          |
001-002                   | Record type (value 14 - smallint)
                          |
003-046                   | (not used)
                          |
047-078                   | Sort node counts (messages on queues)
                          | Array of 8 elements, 4 bytes each - integers:
                          |
047-050                   | Count of Express messages since last MAILMAINT
                          |
051-054                   | Cumulative total of Express messages
                          |
055-058                   | Count of Urgent messages since last MAILMAINT
                          |
059-062                   | Cumulative total of Urgent messages
                          |
063-066                   | Count of Normal messages since last MAILMAINT
                          |
067-070                   | Cumulative total of Normal messages
                          |
071-074                   | Count of Deferred messages since last MAILMAINT
                          |
075-078                   | Cumulative total of Deferred messages
                          |
079-120                   | (not used)
                          |

Type 15 

          LOCAL DATA SET SUMMARY RECORD (one only) 

Column                    | Content 
                          |
----------------------------------------------------------------------------------------
                          |
001-002                   | Record type (value 15 - smallint)
                          |
003-046                   | (not used)
                          |
047-048                   | Number of data sets - smallint
                          |
049-058                   | Date of last maintenance run
                          | (10 bytes - in format DD.MM.YY)
                          |
059-064                   | Time of last maintenance run
                          | (6 bytes - in format HH.MM)
                          |

065-074                   | Date of this maintenance run
                          | (10 bytes - in format DD.MM.YY)
                          |
075-080                   | Time of this maintenance run
                          | (6 bytes - in format HH.MM)
                          |
081-082                   | ILR warning flag - smallint
                          | (if -1, IMAGE ILR not enabled on this database)
                          |

Type 16 

          LOCAL DATA SET DETAIL RECORD 
          (number dependent on Data Set count in 
          Type 15 record, now 22) 
Column                    | Content 
                          |
----------------------------------------------------------------------------------------
                          |
001-002                   | Record type (value 16 - smallint)
                          |
003-046                   | (not used)
                          |
047-062                   | Set name (16 bytes)
                          |
063-066                   | Last set size - integer (if -1, not known)
                          |
067-070                   | Current set size - integer
                          |
071-074                   | Maximum set size - integer
                          |
075-076                   | Set warning flag - smallint
                          | (if -1, indicates that the set is over 85% full)
                          |
077-120                   | (not used)
                          |

Type 17 

          GLOBAL DATA SET SUMMARY RECORD (one only) 

Column                    | Content 
                          |
----------------------------------------------------------------------------------------
                          |
001-002                   | Record type (value 17 - smallint)
                          |
003-046                   | (not used)
                          |
047-048                   | Number of global datasets - smallint
                          |
049-050                   | ILR warning flag - smallint
                          | (-1 if IMAGE ILR not enabled on this database)
                          |
051-120                   | (not used)
                          |

Type 18 

          GLOBAL DATA SET DETAIL RECORD 
          (number dependent on data set count in 
          Type 17 record, currently 13) 

Column                    | Content 
                          |
----------------------------------------------------------------------------------------
                          |
001-002                   | Record type (value 18 - smallint)
                          |
003-046                   | (not used)
                          |
047-062                   | Data set name (16 bytes)
                          |
063-066                   | Last data set size - integer (if -1, not known)
                          |
067-070                   | Current data set size - integer
                          |
071-074                   | Maximum data set size - integer
                          |
075-076                   | Set warning flag - smallint
                          | (if -1, indicates that the set is over 85% full)
                          |
077-120                   | (not used)
                          |

Type 19 

          PROGRESS MESSAGES FOR MAINTENANCE RUN RECORD 

Column                    | Content 
                          |
----------------------------------------------------------------------------------------
                          |
001-002                   | Record type (value 19 - smallint)
                          |
003-010                   | Sort key (8 bytes, for internal use by HP Desk)
                          |
011-046                   | (not used)
                          |
047-048                   | Progress message number - smallint
                          |
049-050                   | Short integer value (S) parameter - smallint
                          | (value dependent on Progress Message number)
                          |
051-054                   | Integer value (I) parameter - integer
                          | (value dependent on Progress Message number)
                          |
055-056                   | Data set name length - smallint
                          | (use dependent on Progress Message number
                          |
057-074                   | Data set name
                          | (16 bytes, use dependent on Progress Message number)
                          |
075-077                   | Capacity of data set
                          | (3 bytes, in format nnn, as percentage of maximum.  Use
                          | dependent on Progress Message number)
                          |

The following is a list of those progress messages conveying counts of
items deleted, dataset capacities, etc.

-----------------------------------------------------------------------------------------------
|                   |                                    |                                    |
| Message           | Meaning                            | Value of subsequent fields         |
| Number            |                                    |                                    |
|                   |                                    |                                    |
-----------------------------------------------------------------------------------------------
|                   |                                    |                                    |
| 20051             | Error queue processing done        | Shortint (S) = number of messages  |
|                   |                                    | on Error Queue                     |
|                   |                                    |                                    |
| 20052             | Database structure checking done   | Integer parameter (I)              |
|                   |                                    |                                    |
| number of corrupt |                                    |                                    |
| items             |                                    |                                    |
|                   |                                    |                                    |
| 20053             | Garbage collection done            | Integer parameter (I) = number of  |
|                   |                                    | items deleted                      |
|                   |                                    |                                    |
| 20054             | Mail node processing done          | Shortint parameter (S) = number of |
|                   |                                    | mailnodes processed                |
|                   |                                    |                                    |
| 20055             | User processing done               | Shortint parameter (S) = number of |
|                   |                                    | users processed                    |
|                   |                                    |                                    |
| 20058             | Warning that a local dataset is    | Two fields:  Name of dataset;      |
|                   | more than 85% full                 | Capacity as a percentage of the    |
|                   |                                    | maximum                            |
|                   |                                    |                                    |
| 20059             | Warning that a global dataset is   | Two fields, as above               |
|                   | more than 85% full                 |                                    |
|                   |                                    |                                    |
| 20064             | Machine summary done               | Shortint parameter (S) = number of |
|                   |                                    | tapes found                        |
|                   |                                    |                                    |
| 20065             | Catalog summary done               | Shortint parameter (S) = number of |
|                   |                                    | catalogs found                     |
|                   |                                    |                                    |
| 20068             | User waste bin processing done     | Integer parameter (I) = number of  |
|                   |                                    | Waste Baskets emptied              |
|                   |                                    |                                    |
| 20069             | Orphan item queue processing done  | Integer parameter (I) = number of  |
|                   |                                    | items cleared from orphan queue    |
|                   |                                    |                                    |
-----------------------------------------------------------------------------------------------



MPE/iX 5.0 Documentation