HP NonStop TMF Supplement for Large Audit-Trail Files Abstract This manual supplement describes features and operations related to large audit-trail files provided by the HP NonStop™ Transaction Management Facility (TMF). This supplement is intended for system managers, system operators, and application programmers using TMF. This supplement complements, but does not replace, the other manuals in the TMF Manual Library.
Document History Part Number Product Version 527391-001 TMF G08 Published August 2004
HP NonStop TMF Supplement for Large Audit-Trail Files Index Tables What’s New in This Manual iii Manual Information iii New and Changed Information iii About This Manual v Who Should Read This Manual Supplement vi How This Manual Supplement Is Organized vi TMF Manual Library vii Other Documentation viii Notation Conventions ix 1. Introduction 2. TMF Glossary 3.
5. TMF Reference Manual (continued) Contents 5. TMF Reference Manual (continued) INFO AUDITTRAIL (Pages 3-152 through 3-155) 5-25 INFO TMF (Pages 3-182 through 3-188) 5-29 RESET AUDITTRAIL (Pages 3-219 through 3-221) 5-36 SET AUDITTRAIL (Pages 3-232 through 3-235) 5-39 STATUS AUDITTRAIL (Pages 3-261 through 3-267) 5-43 Message Descriptions (New Discussion) 5-50 6.
What’s New in This Manual Manual Information HP NonStop TMF Supplement for Large Audit-Trail Files Abstract This manual supplement describes features and operations related to large audit-trail files provided by the HP NonStop™ Transaction Management Facility (TMF). This supplement is intended for system managers, system operators, and application programmers using TMF. This supplement complements, but does not replace, the other manuals in the TMF Manual Library.
What’s New in This Manual New and Changed Information HP NonStop TMF Supplement for Large Audit-Trail Files —527391-001 iv
About This Manual This manual supplement describes the features and operations related to the large audit-trail files provided by the HP NonStop™ Transaction Management Facility (TMF). These operations allow you to create and work with dramatically larger audit-trail files than earlier TMF configurations allowed.
Who Should Read This Manual Supplement About This Manual To learn more about this manual supplement, read the following topics: Topic Page Who Should Read This Manual Supplement vi How This Manual Supplement Is Organized vi TMF Manual Library vii Other Documentation vii Notation Conventions ix Who Should Read This Manual Supplement This manual supplement is intended for • • System managers and operators responsible for configuring, maintaining, and overseeing the use of TMF on NonStop server
TMF Manual Library About This Manual Note. The other manual in the TMF Manual Library, the TMF Introduction, presents high-level, general information. Thus, that manual will not discuss TMF large audit-trail operations and will not include information from this manual supplement.
Other Documentation About This Manual • • TMF Application Programmer’s Guide Read this guide for information about how to design requester and server modules to run in the TMF programming environment. Also read it for information about a set of procedures that can help in examining the content of TMF audit trails. TMF Management Programming Manual Read this manual for information about how to use the Subsystem Programmatic Interface (SPI) to communicate programmatically with the TMF software.
Notation Conventions About This Manual Notation Conventions Hypertext Links Blue underline is used to indicate a hypertext link within text. By clicking a passage of text with a blue underline, you are taken to the location described. For example: This requirement is described under Backup DAM Volumes and Physical Disk Drives on page 3-2. General Syntax Notation This list summarizes the notation conventions for syntax presentation in this manual. UPPERCASE LETTERS.
General Syntax Notation About This Manual | Vertical Line. A vertical line separates alternatives in a horizontal list that is enclosed in brackets or braces. For example: INSPECT { OFF | ON | SAVEABEND } … Ellipsis. An ellipsis immediately following a pair of brackets or braces indicates that you can repeat the enclosed sequence of syntax items any number of times.
Notation for Messages About This Manual !i,o. In procedure calls, the !i,o notation follows an input/output parameter (one that both passes data to the called procedure and returns data to the calling program). For example: error := COMPRESSEDIT ( filenum ) ; !i:i. !i,o In procedure calls, the !i:i notation follows an input string parameter that has a corresponding parameter specifying the length of the string in bytes.
Notation for Management Programming Interfaces About This Manual horizontally, enclosed in a pair of brackets and separated by vertical lines. For example: proc-name trapped [ in SQL | in SQL file system ] { } Braces. A group of items enclosed in braces is a list of all possible items that can be displayed, of which one is actually displayed.
Change Bar Notation About This Manual !o. The !o notation following a token or field name indicates that the token or field is optional. For example: ZSPI-TKN-MANAGER token-type ZSPI-TYP-FNAME32. !o Change Bar Notation Change bars are used to indicate substantive differences between this manual supplement and the existing TMF manuals which it modifies. Change bars are vertical rules placed in the right margin of changed portions of text, figures, tables, examples, and so on.
About This Manual Change Bar Notation HP NonStop TMF Supplement for Large Audit-Trail Files —527391-001 xiv
1 Introduction This manual supplement adds new information and updates existing information in the TMF manuals published with RVU G06.23. This section summarizes the new and changed information included in this supplement. Table 1-1 shows, for each manual, the new or changed discussions. The Pages Where Discussion Appears in G06.23 Manual column indicates: • • For a completely new discussion, the entry NEW. For a discussion that exists in the G06.
Introduction Table 1-1. Summary of New and Changed Information (continued) Manual Changes TMF Reference Manual Changed Command Descriptions: Pages Where Discussion Appears in G06.
Introduction Table 1-1. Summary of New and Changed Information (continued) Manual Changes TMF Application Programmer’s Guide Pages Where Discussion Appears in G06.
Introduction HP NonStop TMF Supplement for Large Audit-Trail Files —527391-001 1 -4
2 TMF Glossary format 2 audit-trail file. A TMF audit-trail file that is formatted to contain up to 1048575 megabytes (1 terabyte minus 1 megabyte) of audit-trail data, if the disk drive is large enough. These files are sometimes referred to as large audit-trail files. format 2 file. An Enscribe file that is formatted to contain partitions up to 1024 gigabytes (1 terabyte) in size. large audit-trail file. See format 2 audit-trail file.
TMF Glossary HP NonStop TMF Supplement for Large Audit-Trail Files —527391-001 2 -2
3 TMF Planning and Configuration Guide This section presents new and revised information for the discussions documented in the TMF Planning and Configuration Guide. Topic Page Why Start Over? 3-2 Audit-Trail File Size 3-2 Increasing Audit-Trail Capacity 3-3 Fallback From a Format 2 Audit-Trail Environment to a Format 1 Audit-Trail Environment 3-4 A complete summary of all new and revised discussions for the TMF manuals appears in Table 1-1, Summary of New and Changed Information, on page 1-1.
TMF Planning and Configuration Guide Why Start Over? (Page 1-9) Why Start Over? (Page 1-9) You should delete TMF in a production environment only after careful consideration, because all audit dumps and online dumps are lost, and new dumps must be taken.
Increasing Audit-Trail Capacity (Pages 3-6 through 3-7) TMF Planning and Configuration Guide Table 3-1. Audit-Trail File Size File Size Value Recommended Minimum 300 megabytes. Recommended Maximum The daily audit-generation rate. To change the audit-trail file size after TMF is started, issue an ALTER AUDITTRAIL command containing the desired FILESIZE parameter.
TMF Planning and Configuration Guide Fallback From a Format 2 Audit-Trail Environment to a Format 1 Audit-Trail Environment (Appendix A) If there is more room on the active-audit volume, increase the number of files per active-audit volume. If the active-audit volume is fully allocated, add another activeaudit volume. Note that when you add an active-audit volume, the audit-trail capacity is increased by the current configured number of files per active-audit volume.
TMF Planning and Configuration Guide Fallback From Phase B RVU Migration Transition to Point Format 2 Audit | | --------------------------------|--------------------------------- -------|---------------------------------------> A | B | C Fallback From Phase B If the file-size attribute has not been altered for any audit trail, there are no TMF issues for fallback. The TMF audit-trail configuration remains compatible with older format 1 configurations.
TMF Planning and Configuration Guide Fallback From Phase C Because prior RVUs of TMF do not support multiple file sizes for a given audit trail, some of the old algorithms do not lend themselves to handling multiple file sizes. In the best case, values for overflow locations and abort transaction locations would be incorrect (potentially hurting system performance).
TMF Planning and Configuration Guide Fallback Plan for Phase C Fallback Plan for Phase C Note that this plan preserves the changes to data made during Phase C: 1. Do a clean TMF shutdown (all audited disks must be available); otherwise your HP field service representative must hand patch to restore consistency to all audited files. 2. Back up all audited files by using Backup/Restore (because TMF protection is lost during this process, and the files on disk are the only copies). 3.
TMF Planning and Configuration Guide Alternative Fallback Plan for Phase C 7. Issue the following FUP RENAME command: FUP RENAME $.ZTMFCONF.*, OLDCONF.* 8. Restore the previously-saved TMF catalog and configuration files: RESTORE $, $.ZTMFCONF.*, OPEN 9.
4 TMF Operations and Recovery Guide This section presents new and revised information for the discussions documented in the TMF Operations and Recovery Guide. Topic Page Large Audit Trails 4-1 Reason: Required by RDF environment 4-1 A complete summary of all new and revised discussions for the TMF manuals appears in Table 1-1, Summary of New and Changed Information, on page 1-1.
TMF Operations and Recovery Guide Reason: Required by RDF environment (Pages 2-6 through 2-7) When you subsequently issue the START RDF command, RDFCOM asks TMF to restore any necessary audit files from the archive media. However, if any of those audit files are no longer available (because the online dumps that required them were deleted by TMF RETAINDEPTH processing), RDF will be unable to start. In this case, you must resynchronize the database protected by RDF.
5 TMF Reference Manual This section presents new and revised information for the commands and messages documented in the TMF Reference Manual. Topic Page ADD AUDITTRAIL 5-2 ALTER AUDITTRAIL 5-10 ALTER TMF 5-22 INFO AUDITTRAIL 5-25 INFO TMF 5-29 RESET AUDITTRAIL 5-36 SET AUDITTRAIL 5-39 STATUS AUDITTRAIL 5-43 Message Descriptions 5-50 A complete summary of all new and revised discussions for all TMF manuals appears in Table 1-1, Summary of New and Changed Information, on page 1-1.
ADD AUDITTRAIL (Pages 3-14 through 3-19) TMF Reference Manual ADD AUDITTRAIL (Pages 3-14 through 3-19) The ADD AUDITTRAIL command adds an audit trail to the TMF configuration. ADD AUDITTRAIL {MASTER | MAT {AUX[ILIARY]nn [,AUDITDUMP {ON | OFF [,FILESIZE integer [,ACTIVEVOL[S] {volume {(volume [,volume]...) [,FILESPERVOLUME integer } } }] ] } }] ] [,OVERFLOWVOL[S] {volume } {(volume [,volume]...)}] [,OVERFLOWTHRESHOLD integer [,RESTOREVOL[S] ] {volume } {(volume [,volume]...
ADD AUDITTRAIL (Pages 3-14 through 3-19) TMF Reference Manual If AUDITDUMP is ON, use the ALTER AUDITDUMP command to modify other parameters relating to audit dumping. These parameters are explained in the ALTER AUDITDUMP command description.
TMF Reference Manual ADD AUDITTRAIL (Pages 3-14 through 3-19) ACTIVEVOL[S] specifies the disk volume that holds the audit-trail files. If ACTIVEVOL[S] was specified in a previous SET AUDITTRAIL command in this session, this parameter is optional in the ADD AUDITTRAIL command; otherwise, this parameter is required. You must specify at least one volume; up to 16 are allowed. A single volume cannot be configured as an active volume for more than one audit trail.
TMF Reference Manual ADD AUDITTRAIL (Pages 3-14 through 3-19) volumes not configured for other TMF purposes. To change the overflow-audit volumes later, you can use the ALTER AUDITTRAIL command. For the START TMF command to execute successfully, all overflow-audit volumes must be up. OVERFLOWTHRESHOLD integer specifies the percentage of audit trail capacity that can be consumed before TMF begins overflow copying. This is an optional parameter. The minimum value is 50 and the maximum is 100.
TMF Reference Manual ADD AUDITTRAIL (Pages 3-14 through 3-19) Usage Guidelines There must be exactly one master audit trail in a TMF system. In addition, there can be up to 15 optional auxiliary audit trails. Auxiliary audit trails receive the audit information generated by a specified set of data volumes; they do not contain TMF control information.
TMF Reference Manual ADD AUDITTRAIL (Pages 3-14 through 3-19) specific audit trail, the ATFORMAT value entered through the ALTER TMF command applies to your entire TMF configuration.). Note. You should ensure that enough disk space exists to accommodate files of the size specified in FILESIZE and the number specified in FILESPERVOLUME.
TMF Reference Manual ADD AUDITTRAIL (Pages 3-14 through 3-19) RESTOREVOL Option Considerations Restore-audit volumes are used to receive audit-trail files restored from an audit dump as part of a recovery procedure. You can specify the restore-audit volumes associated with the audit trail through the RESTOREVOLS parameter. Configuring an active-audit volume as an overflow- or restore-audit volume might result in contention for the disk, adversely impacting performance.
TMF Reference Manual ADD AUDITTRAIL (Pages 3-14 through 3-19) The next ADD AUDITTRAIL command adds an auxiliary audit trail identified as AUX01, using the disk volume $AUX1 for the active-audit volume and $DATA3 for the overflow and restore locations: TMF 11> ADD AUDITTRAIL AUX01, FILESPERVOLUME 6, ACTIVEVOLS & >>>$AUX1, OVERFLOWVOLS $DATA3, RESTOREVOLS $DATA3, AUDITDUMP ON HP NonStop TMF Supplement for Large Audit-Trail Files —527391-001 5 -9
TMF Reference Manual ALTER AUDITTRAIL (Pages 3-51 through 3-60) ALTER AUDITTRAIL (Pages 3-51 through 3-60) The ALTER AUDITTRAIL command changes the configured attribute values of an audit trail and can execute while TMF is running. ALTER AUDITTRAIL {MASTER | MAT } {AUX[ILIARY]nn} [,AUDITDUMP {ON | OFF}] [,ADDACTIVEVOL[S] {volume {(volume [,volume]...) [,DELETEACTIVEVOL[S] {volume {(volume [,volume]...
TMF Reference Manual ALTER AUDITTRAIL (Pages 3-51 through 3-60) AUDITDUMP {ON | OFF} determines whether audit dumping is performed for the audit trail. ON specifies that audit dumping takes place, and OFF prevents audit dumping.
TMF Reference Manual ALTER AUDITTRAIL (Pages 3-51 through 3-60) FILESPERVOLUME. If the volume has insufficient space for these files, it cannot be added to the configuration. Active-audit volumes are added to the end of the list of available volumes maintained by TMF; therefore, they might not be used immediately. Audit-trail files are written to active-audit volumes sequentially, but TMF tries to avoid writing two audit-trail files in succession to the same volume.
TMF Reference Manual ALTER AUDITTRAIL (Pages 3-51 through 3-60) Increasing the FILESPERVOLUME value is the recommended way of increasing the audit trail capacity, if there is sufficient space on the currently configured activeaudit volumes. Using this technique evenly distributes the new files among all volumes, rather than concentrating them on any added volumes. RESET FILESPERVOLUME resets the FILESPERVOLUME attribute to the originally assigned default, which is 5.
TMF Reference Manual ALTER AUDITTRAIL (Pages 3-51 through 3-60) from tape only. The minimum value is 1, and the maximum is 9999. The originally assigned default is 0 (no files are retained). RESET MAXRETAINEDATFILES resets the MAXRETAINEDATEFILES attribute to the originally assigned default, which is 0. BEGINTRANSDISABLE integer specifies the percentage of audit trail capacity that can be consumed before TMF disables new transactions.
TMF Reference Manual ALTER AUDITTRAIL (Pages 3-51 through 3-60) Security Restrictions You can issue the ALTER AUDITTRAIL command only if you are a member of the super user group. TMF State Requirement You can enter the ALTER AUDITTRAIL command at any time, whether or not TMF has been started. However, after TMF is configured and started for the first time, you can add or delete active-audit volumes or alter AUDITDUMP to OFF only while TMF is up and running.
TMF Reference Manual ALTER AUDITTRAIL (Pages 3-51 through 3-60) When you issue an ALTER AUDITTRAIL command that sets AUDITDUMP to OFF, TMF displays a confirmation message that allows you to either verify that you want to take this action or to indicate that you do not.
TMF Reference Manual ALTER AUDITTRAIL (Pages 3-51 through 3-60) The integer value specifies the total number of audit-trail files retained across the entire set of restore-audit volumes. In other words, whether you have one restoreaudit volume or five restore-audit volumes, setting the value to 50 would give you a maximum of 50 retained audit-trail files in either case.
TMF Reference Manual ALTER AUDITTRAIL (Pages 3-51 through 3-60) If you specify RESET MAXRETAINEDATFILES, any retained audit-trail files presently on disk will be purged immediately after they are no longer needed. Note. You cannot use the ADD AUDITTRAIL command to set the MAXRETAINEDATFILES value; the MAXRETAINEDATFILES option is only available with ALTER AUDITTRAIL. Each time TMF is started, all audit-trail files on restore-audit volumes are purged automatically.
TMF Reference Manual ALTER AUDITTRAIL (Pages 3-51 through 3-60) specific audit trail, the ATFORMAT value entered through the ALTER TMF command applies to your entire TMF configuration.) Note. You should ensure that enough disk space exists to accommodate files of the size specified in FILESIZE and the number specified in FILESPERVOLUME.
TMF Reference Manual ALTER AUDITTRAIL (Pages 3-51 through 3-60) command are not undone; to get the configuration to the desired state, use the INFO AUDITTRAIL command to check the configuration and then enter ALTER AUDITTRAIL commands to compensate for the changes needed. If the ALTER AUDITTRAIL command returns an error, files that were preallocated when active volumes were added might not be purged from the volumes; this occurs if the TMP loses access to these volumes.
TMF Reference Manual ALTER AUDITTRAIL (Pages 3-51 through 3-60) This command both creates a restore-audit volume on $TMF02 and deletes the one on $TMF01: TMF 24> ALTER AUDITTRAIL MAT, ADDRESTOREVOL $TMF02, >>>DELETERESTOREVOL $TMF01 & The following ALTER AUDITTRAIL command requests TMF to retain up to the last 50 highest-numbered MAT audit-trail files in the restore-audit volumes, even after all recovery processes are finished: TMF 25> ALTER AUDITTRAIL MAT, MAXRETAINEDATFILES 50 The next ALTER AUDITTRAI
TMF Reference Manual ALTER TMF (Pages 3-94 through 3-95) ALTER TMF (Pages 3-94 through 3-95) The ALTER TMF command changes the TMF configuration volume, switches the functions of the TMP’s primary and backup processes, or changes the audit-trail files from format 1 to format 2 or from format 2 to format 1. ALTER TMF, {CONFIGVOL volume } {SWITCHPROCESS TMP} {ATFORMAT format } CONFIGVOL volume specifies the name of the volume that contains the configuration files to be used in the next TMF startup.
TMF Reference Manual ALTER TMF (Pages 3-94 through 3-95) Changing the TMF Configuration Volume With the CONFIGVOL option, the ALTER TMF command causes the TMP process to change the TMF configuration volume and then stop itself. The new TMP process, recreated automatically, uses the new configuration volume. If there are no configuration files located in the ZTMFCONF subvolume on that volume, the TMP creates new ones. You can restart TMF with a START TMF command. Caution.
TMF Reference Manual ALTER TMF (Pages 3-94 through 3-95) generally required only once, because the format change is typically a one-time operation done only to move from format 1 to format 2 files. Caution. Changing from format 1 to format 2 audit-trail files may make falling back to an earlier TMF RVU difficult; prior TMF releases cannot read format 2 audit-trail files. Thus, you should not move to format 2 files until you are confident of the stability of this RVU in your system environment.
TMF Reference Manual INFO AUDITTRAIL (Pages 3-152 through 3-155) INFO AUDITTRAIL (Pages 3-152 through 3-155) The INFO AUDITTRAIL command displays the configured attribute values of audit trails. INFO AUDITTRAIL [MASTER | MAT ] [AUX[ILIARY]nn ] [(MASTER | MAT [,AUX[ILIARY]nn ])] [(AUX[ILIARY]nn [,MASTER | MAT ])] [(AUX[ILIARY]nn [,AUX[ILIARY]nn])] [ * ] [,OBEYFORM] MASTER | MAT AUX[ILIARY]nn identifies the audit trail for which attributes are to be displayed. MASTER or MAT specifies the master audit trail.
INFO AUDITTRAIL (Pages 3-152 through 3-155) TMF Reference Manual TMF State Requirement You can enter the INFO AUDITTRAIL command at any time, whether or not TMF has been started. Usage Guideline The INFO AUDITTRAIL command displays a subset of the information presented by the INFO TMF command. Output Displayed The INFO AUDITTRAIL command displays the attributes configured for the audit trails by ADD AUDITTRAIL and ALTER AUDITTRAIL commands entered previously.
INFO AUDITTRAIL (Pages 3-152 through 3-155) TMF Reference Manual Examples The following INFO AUDITTRAIL command displays information for the master audit trail: TMF >77 INFO AUDITTRAIL MASTER AuditTrail Configuration: Master ActiveVols: $MAT1, $MAT2 Subvolume ZTMFAT, Prefix AA, filesize 1000000, filespervolume 3, auditdump on, overflowthreshold 75%, begintransdisable 90%, MaxRetainedATFiles 1 OverflowVols: $DATA1 RestoreVols: $DATA2 The next INFO AUDITTRAIL command formats the configuration of the master
TMF Reference Manual INFO AUDITTRAIL (Pages 3-152 through 3-155) The following INFO AUDITTRAIL command displays information for all audit trails: TMF 79> INFO AUDITTRAIL * AuditTrail Configuration: Master ActiveVols: $MAT Subvolume ZTMFAT, Prefix AA, filesize 1000000, filespervolume 5, auditdump on, overflowthreshold 80%, begintransdisable 90%, MaxRetainedATFiles 0 OverflowVols: None RestoreVols: $SPARE Auxiliary01: ActiveVols: $AUX Subvolume ZTMFAT, Prefix BB, filesize 20, filespervolume 3 auditdump off,
TMF Reference Manual INFO TMF (Pages 3-182 through 3-188) INFO TMF (Pages 3-182 through 3-188) The INFO TMF command displays the configured attribute values of TMF. INFO TMF [,{CNFGFORM | OBEYFORM}] CNFGFORM formats the INFO TMF output as command file text that can be executed by TMFCOM. TMF saves this output in the file designated by the OUT option available with all commands. Subsequently executing this command file produces a running system that exactly matches your present TMF configuration.
TMF Reference Manual INFO TMF (Pages 3-182 through 3-188) TMF State Requirement You can enter the INFO TMF command at any time, whether or not TMF has been started. Usage Guidelines The INFO TMF command displays the current TMF configuration volume and combines the information presented by the INFO commands for the following objects: AUDITDUMP, AUDITTRAIL, BEGINTRANS (only when TMF is running), and CATALOG.
TMF Reference Manual INFO TMF (Pages 3-182 through 3-188) require TMF to be running will not be executed unless you modify the file by adding a START TMF command preceding these commands. Note. To augment the information captured through the INFO TMF, CNFG command, you can capture current information about TMF online and audit dumps by using the INFO DUMPS, OBEYFORM command. For more information about this step, see “INFO DUMPS” on page 3-170 of the TMF Reference Manual.
TMF Reference Manual INFO TMF (Pages 3-182 through 3-188) After the next START TMF, the BeginTrans Configuration will be: TransPerCpu (1024, 1024) RecRMCount 256 RMOpenPerCpu 96 BranchesPerRM 128 The following INFO TMF command generates CNFGFORM output: TMF 41> INFO /OUT CNFILE/ TMF, CNFGFORM Alter TMF, ConfigVol $SYSTEM Alter TMF, ATFormat 2 Alter Process AuditDump, & Pri 149, & RESET CPUS, & MakeSaveAbend On , & Debug Off , & Inspect On , & Reset ExtendedSegSize, & PFSSize 1048576, & Reset ProgramFile,
INFO TMF (Pages 3-182 through 3-188) TMF Reference Manual Alter Process . . . Alter Process . . . Alter Process . . . Alter Process . . . Alter Process . . . Alter Process . . .
TMF Reference Manual INFO TMF (Pages 3-182 through 3-188) released Off, & roundrobin Off START TMF, DISABLE BEGINTRANS ALTER BEGINTRANS, & transcountthresh (1500,1600) ,& tmflibmemthresh (90,95) , & tmpmemthresh (90,95) , & transpercpu (1024,1024) , & autoabort 7200 Seconds , & recrmcount 256 , & rmopenpercpu 96 , & branchesperrm 128 STOP TMF START TMF, DISABLE BEGINTRANS Add Datavol $AEGEAN, AuditTrail Mat, RecoveryMode Online, & IGNOREPREVIOUSCONFIG Add Datavol $ALGAE, AuditTrail Mat, RecoveryMode Onlin
TMF Reference Manual INFO TMF (Pages 3-182 through 3-188) SET AUDITTRAIL FILESPERVOLUME 3 SET AUDITTRAIL OVERFLOWTHRESHOLD 80 SET AUDITTRAIL BEGINTRANSDISABLE 90 SET AUDITTRAIL ACTIVEVOL ( & $AUDIT & ) SET AUDITTRAIL OVERFLOWVOL ( & $MEZRPT & , $OPR & ) SET AUDITTRAIL RESTOREVOL ( & $MEZRPT & ) ADD AUDITTRAIL Master ALTER AUDITDUMP Master, medium tape ALTER AUDITDUMP Master, copies 1 ALTER AUDITDUMP Master, verifytape Off ALTER AUDITDUMP Master, blocksize 28 ALTER AUDITDUMP Master, system \CYCLONE ALTER C
TMF Reference Manual RESET AUDITTRAIL (Pages 3-219 through 3-221) RESET AUDITTRAIL (Pages 3-219 through 3-221) The RESET AUDITTRAIL command resets audit trail attributes to their default values, canceling the effects of any previous SET AUDITTRAIL commands. Values changed by RESET AUDITTRAIL are local to your current session and only apply to ADD AUDITTRAIL commands subsequently issued within this session. RESET AUDITTRAIL {attribute [,attribute]...
TMF Reference Manual RESET AUDITTRAIL (Pages 3-219 through 3-221) parameter of a new ADD AUDITTRAIL or SET AUDITTRAIL command, TMF generates an EMS warning event message when you add the audit trail. OVERFLOWTHRESHOLD resets the OVERFLOWTHRESHOLD attribute to 80 (if an overflow volume is configured), indicating that overflow copying begins when the audit trail capacity in use exceeds 80%.
TMF Reference Manual RESET AUDITTRAIL (Pages 3-219 through 3-221) Examples The following RESET AUDITTRAIL command resets the BEGINTRANSDISABLE attribute to 90%, overriding an earlier SET command that established a different value for this attribute: TMF 81> RESET AUDITTRAIL BEGINTRANSDISABLE Now, all subsequent ADD AUDITTRAIL commands that do not include the BEGINTRANSDISABLE parameter will use this 90% value for that attribute.
TMF Reference Manual SET AUDITTRAIL (Pages 3-232 through 3-235) SET AUDITTRAIL (Pages 3-232 through 3-235) The SET AUDITTRAIL command establishes attribute values for audit trails created by subsequent ADD AUDITTRAIL commands issued during the same TMFCOM session. SET AUDITTRAIL attribute [,attribute]... where attribute is any of the following: [AUDITDUMP {ON | OFF}] [FILESIZE integer ] [ACTIVEVOL[S] {volume } {(volume [,volume] ...
TMF Reference Manual SET AUDITTRAIL (Pages 3-232 through 3-235) FILESIZE integer specifies the size of the audit-trail files, in megabytes (MB). The minimum value for FILESIZE is 1 and the maximum depends on the format of the audit-trail files, as follows: • • For format 1 files: 2047 or the maximum disk size (if less than 2047 MB). For format 2 files: 1048575 or the maximum disk size (if less than 1048575 MB). (Note that 1048575 equals 1 terabyte (TB) minus 1 megabyte (MB).) Caution.
TMF Reference Manual SET AUDITTRAIL (Pages 3-232 through 3-235) The FILESPERVOLUME value can be altered later, even while TMF is running, by using the ALTER AUDITTRAIL command. OVERFLOWVOL[S] specifies the volumes to be used as overflow space for the audit trail, if required (this attribute is not required by TMF, but if you omit it, TMF issues a warning event message at TMF startup, indicating that an overflow-audit volume should be configured). You can specify from 1 to 16 overflow volumes.
TMF Reference Manual SET AUDITTRAIL (Pages 3-232 through 3-235) Usage Guidelines The values specified in SET AUDITTRAIL are local to your current session only and are not propagated to TMFSERVE. These values take effect when you issue subsequent ADD AUDITTRAIL commands within your session and cease to apply when your session ends.
TMF Reference Manual STATUS AUDITTRAIL (Pages 3-261 through 3-267) STATUS AUDITTRAIL (Pages 3-261 through 3-267) The STATUS AUDITTRAIL command displays the current audit trail activity. STATUS AUDITTRAIL [MASTER | MAT ] [AUX[ILIARY]nn ] [(MASTER | MAT [,AUX[ILIARY]nn]) ] [(AUX[ILIARY]nn [,MASTER | MAT]) ] [(AUX[ILIARY]nn [,AUX[ILIARY]nn])] [* ] [,DETAIL] MASTER | MAT AUX[ILIARY]nn identifies the audit trail whose activity is to be displayed. MASTER or MAT specifies the master audit trail.
TMF Reference Manual STATUS AUDITTRAIL (Pages 3-261 through 3-267) Usage Guideline The STATUS AUDITTRAIL command displays the following items: • • • • • The name of the audit trail The percentage of audit trail capacity in use The name of the oldest audit-trail file that is not yet ready to be reused or purged by TMF The reason a file is pinned (retained) on disk One or more audit-trail file names, and an indication of their status These items are explained next under “Output Displayed.
STATUS AUDITTRAIL (Pages 3-261 through 3-267) TMF Reference Manual Adding an active-audit volume to the audit trail increases audit trail capacity by the number of files specified in the FILESPERVOLUME attribute. You can use this option only if you have a volume that is not already configured as an active-audit volume or a data volume.
STATUS AUDITTRAIL (Pages 3-261 through 3-267) TMF Reference Manual Table 5-2. STATUS AUDITTRAIL Output (page 2 of 4) Heading or Item Description Reason The reason the file named under “First Pinned File” is pinned, which is one of the following entries. (In the following list, each entry is followed by an explanation of its meaning.) Active transaction(s) An active transaction might have sent an audit record to this audit-trail file.
STATUS AUDITTRAIL (Pages 3-261 through 3-267) TMF Reference Manual Table 5-2. STATUS AUDITTRAIL Output (page 3 of 4) Heading or Item Description Files Names of one or more audit-trail files, followed in parentheses by an indication of their status. If the DETAIL option is not specified, only the current audit file is displayed.
STATUS AUDITTRAIL (Pages 3-261 through 3-267) TMF Reference Manual Table 5-2. STATUS AUDITTRAIL Output (page 4 of 4) Heading or Item Description Files (continued) overflowing The file is the target of an overflow operation, currently in progress. When this operation is done, this file’s status changes to OVERFLOW. preallocated Preallocated files are “placeholders” that are used to guarantee that disk space configured for the audit trail is not consumed by other applications.
TMF Reference Manual Files: $AUX1.ZTMFAT.BB000001 $AUX1.ZTMFAT.BB000002 $AUX1.ZTMFAT.BB000003 $AUX1.ZTMFAT.BB000004 $AUX1.ZTMFAT.BB000005 $AUX1.ZTMFAT.BB000006 $AUX1.ZTMFAT.
TMF Reference Manual Message Descriptions (New Discussion) Message Descriptions (New Discussion) The following messages are new, although some replace existing messages as noted. 107 Expecting audit trail RBA number between 0 and 1048575 Megabytes (in bytes). Cause. A TMF error occurred. Effect. The command fails. Recovery. This message should never appear in TMFCOM. Make a note of the command entered and the circumstances. Then, contact the GCSC or your service provider.
TMF Reference Manual Message Descriptions (New Discussion) 472 ALTER TMF cannot specify more than one ATFormat token. Cause. A Subsystem Programmatic Interface (SPI) error occurred. Effect. The command fails. Recovery. This message should never appear in TMFCOM. Make a note of the command entered and the circumstances. Then, contact the GCSC or your service provider. 473 The ATFormat specified is invalid. Only 1 or 2 is allowed. Cause. A Subsystem Programmatic Interface (SPI) error occurred. Effect.
TMF Reference Manual Message Descriptions (New Discussion) 7301 Expecting AUDITDUMP, ADDACTIVEVOL[S], DELETEACTIVEVOLS[S], FILESPERVOLUME, FILESIZE, ADDOVERFLOWVOL[S], DELETEOVERFLOWVOL[S], OVERFLOWTHRESHOLD, ADDRESTOREVOL[S], DELETERESTOREVOL[S], BEGINTRANSDISABLE, MAXRETAINEDATFILES, or RESET. Cause. An ALTER AUDITTRAIL command did not specify the correct keyword where TMFCOM expected one of those listed in the message. Effect. The command fails. Recovery.
TMF Reference Manual Message Descriptions (New Discussion) 7304 Expecting audit trail RBA number between 0 and 1048575 MB (in bytes). Cause. A RECOVER FILES command specified a relative byte address (rba) that exceeded the maximum value allowed in the TOMATPOSITION parameter. Effect. The command fails. Recovery. Re-enter the command, using a valid rba. Note. This message replaces TMFCOM Message 7015. 7305 The value specified for ATFORMAT is invalid. Expecting 1 or 2. Cause.
TMF Reference Manual Message Descriptions (New Discussion) HP NonStop TMF Supplement for Large Audit-Trail Files —527391-001 5- 54
6 TMF Management Programming Manual This section presents new and revised information for the commands and responses and event messages documented in the TMF Management Programming Manual.
TMF Management Programming Manual Topic Page 441: ZTMF-EVT-ATAlterATFormat 6-61 442: ZTMF-EVT-ATCantCreateNewFile 6-62 445: ZTMF-EVT-NoTLEDelayOccurring 6-64 A complete summary of all new and revised discussions for the TMF manuals appears in Table 1-1, Summary of New and Changed Information, on page 1-1. Within this section: • • Each new discussion is completely bracketed by change bars, and shows the notation “New Discussion” beneath the heading.
Commands and Responses TMF Management Programming Manual Commands and Responses ADD AUDITTRAIL (Pages 5-8 through 5-12) The ADD AUDITTRAIL command adds an audit trail to the TMF configuration by specifying the audit trail identifier and the attributes associated with that audit trail (such as volumes to hold the files, the size of the files, and the number of files allocated per active volume).
ADD AUDITTRAIL (Pages 5-8 through 5-12) TMF Management Programming Manual Tokens in Response Buffer ZTMF-TKN-VOLUMENAME ZTMF-TKN-ATVOLUMETYPE ZTMF-TKN-FS-ERROR token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-INT. ZSPI-TKN-RETCODE ZSPI-TKN-DATALIST ... ZSPI-TKN-ENDLIST ZSPI-TKN-ERRLIST ... ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-LIST. token-type ZSPI-TYP-SSCTL. token-type ZSPI-TYP-LIST. token-type ZSPI-TYP-SSCTL.
ADD AUDITTRAIL (Pages 5-8 through 5-12) TMF Management Programming Manual ZTMF-TKN-OVERFLOWVOLUME specifies the disk volume used as overflow space for the audit trail. This token can occur from 1 to 16 times. Although this token is optional, it is recommended that you specify at least one overflow-audit volume. You cannot specify the same overflow-audit volume twice in the same command.
ADD AUDITTRAIL (Pages 5-8 through 5-12) TMF Management Programming Manual The default is ZSPI-VAL-TRUE. An auxiliary audit trail cannot be configured with ZAUDITDUMP set to ZSPI-VAL-TRUE unless the master audit trail is also configured with ZAUDITDUMP set to ZSPI-VAL-TRUE. A master audit trail cannot be configured with ZAUDITDUMP set to ZSPI-VAL-FALSE unless the auxiliary audit trails are also configured with ZAUDITDUMP set to ZSPI-VAL-FALSE.
TMF Management Programming Manual ADD AUDITTRAIL (Pages 5-8 through 5-12) For format 1 files the default file size is 100, resulting in files of 100 MB (100 x 1024 x 1024 bytes) each. For format 2 files the default file size is 1024, resulting in files of 1024 MB (1024 x 1024 x 1024 bytes) each. At any point after the FILESIZE attribute value is set, you can change it with the ALTER AUDITTRAIL command.
TMF Management Programming Manual ALTER AUDITTRAIL (Pages 5-32 through 5-36) ALTER AUDITTRAIL (Pages 5-32 through 5-36) The ALTER AUDITTRAIL command changes the configured attribute values of an audit trail and can execute while TMF is running. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below.
ALTER AUDITTRAIL (Pages 5-32 through 5-36) TMF Management Programming Manual Tokens in Response Buffer ZSPI-TKN-RETCODE ZSPI-TKN-DATALIST ... ZSPI-TKN-ENDLIST ZSPI-TKN-ERRLIST ... ZSPI-TKN-ENDLIST ZTMF-TKN-VOLUMENAME ZTMF-TKN-ATVOLUMETYPE ZTMF-TKN-FS-ERROR token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-LIST. token-type ZSPI-TYP-SSCTL. token-type ZSPI-TYP-LIST. token-type token-type token-type token-type ZSPI-TYP-SSCTL. ZSPI-TYP-STRING. ZSPI-TYP-ENUM. ZSPI-TYP-INT.
TMF Management Programming Manual ALTER AUDITTRAIL (Pages 5-32 through 5-36) ZTMF-TKN-DELACTIVEVOLUME specifies a volume to be deleted from the active volume list. The volume containing the audit file that is currently receiving audit information cannot be deleted. The volume holding the “Next” file (if it has been prepared) can also not be deleted. If the volume holds active files that are still needed by TMF, it is not removed from the active list immediately, but no new files are allocated to it.
TMF Management Programming Manual ALTER AUDITTRAIL (Pages 5-32 through 5-36) ZTMF-MAP-ALTER-AUDITTRAIL is an extensible structured token specifying the attributes of the audit trail that are to be changed. This token is required; only one occurrence is allowed. This token contains the following fields: ZFILESPERVOLUME specifies the number of audit trail files that reside on each active-audit volume configured. The minimum value is 1 and the maximum value is 100; the value of ZTMF-VAL-RESETWORD is 5.
ALTER AUDITTRAIL (Pages 5-32 through 5-36) TMF Management Programming Manual ZAUDITDUMP specifies whether or not audit dumping is performed for the audit trail. During audit dumping, TMF automatically copies to tape or disk an audit trail file that has become full. The following values are valid: ZSPI-VAL-TRUE Audit dumping is enabled. ZSPI-VAL-FALSE Audit dumping is prevented.
TMF Management Programming Manual ALTER AUDITTRAIL (Pages 5-32 through 5-36) ZTMF-TKN-FS-ERROR contains the file-system error that may have caused the command to fail. Its presence depends on the value of ZSPI-RET-CODE. Usage Guidelines Only super-group users can issue this command. You can issue this command when TMF is started or stopped. After TMF is started for the first time (with a specific configuration), you can only add or delete active volumes when TMF is started.
TMF Management Programming Manual ALTER TMF (Pages 5-54 through 5-55) ALTER TMF (Pages 5-54 through 5-55) The ALTER TMF command changes the TMF configuration volume to a specified volume. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below. Command ZTMF-CMD-ALTER Object Type ZTMF-OBJ-TMF Tokens in Command Buffer ZTMF-TKN-VOLUMENAME ZTKN-TKN-ATFILEFORMAT token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-INT.
TMF Management Programming Manual ALTER TMF (Pages 5-54 through 5-55) Tokens in Response Buffer ZTMF-TKN-RETCODE is the standard SPI return token described in the SPI Programming Manual. ZTMF-TKN-ERRLIST is a standard SPI error list described in the SPI Programming Manual. The error list ends with the token ZSPI-TKN-ENDLIST. The following errors can appear in this field: ZTMF-ERR-ONCONFIGVOL is returned when a file-system error occurs in accessing the configuration volume.
TMF Management Programming Manual INFO AUDITTRAIL (Pages 5-98 through 5-100) INFO AUDITTRAIL (Pages 5-98 through 5-100) The INFO AUDITTRAIL command returns the configured attribute values of audit trails. The list of volumes configured for audit trails is not returned by this command; to obtain the list of volumes use the INFO ATVOLUME command. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below.
TMF Management Programming Manual INFO AUDITTRAIL (Pages 5-98 through 5-100) Tokens in Command Buffer ZTMF-TKN-AUDITTRAILID specifies the audit trail for which information is to be returned. This token is optional; multiple occurrences are allowed. The following values are valid: ZTMF-VAL-MAT Master audit trail ZTMF-VAL-AUX01 Auxiliary audit trail #1 ZTMF-VAL-AUX02 Auxiliary audit trail #2 ...
INFO AUDITTRAIL (Pages 5-98 through 5-100) TMF Management Programming Manual ZAUDITDUMP indicates whether audit dumping is performed for the audit trail. The following values are possible: ZSPI-VAL-TRUE Audit dumping is performed ZSPI-VAL-FALSE Audit dumping is not performed ZOVERFLOWTHRESHOLD indicates the percentage of active-audit-trail capacity above which TMF begins overflow copying.
INFO TMF (Page 5-124) TMF Management Programming Manual INFO TMF (Page 5-124) The INFO TMF command returns the configured attribute values of TMF, including the current configuration volume. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below. Command ZTMF-CMD-INFO Object Type ZTMF-OBJ-TMF Tokens in Response Buffer ZSPI-TKN-VOLUMENAME ZSPI-TKN-ATFILEFORMAT ZSPI-TKN-RETCODE ZSPI-TKN-ERRLIST ...
TMF Management Programming Manual INFO TMF (Page 5-124) Usage Guidelines Anyone can issue this command. You can issue this command at any time, whether or not TMF is started. For more information about the INFO TMF command, see the TMF Reference Manual.
Event Messages TMF Management Programming Manual Event Messages 118: ZTMF-EVT-TMPFormat2ATFile (New Discussion) While starting a version of TMF that only supports Format 1 audit trail files, the TMP detected that the specified audit trail file is a Format 2 file. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE ZTMF-TKN-AUDITFILENAME ZEMS-TKN-EMPHASIS token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-BOOLEAN.
Event Messages TMF Management Programming Manual 150: ZTMF-EVT-GlobInfoFileErr (Page 6-131) While TMF was attempting to start, a file-system error occurred for the specified configuration file. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE ZEMS-TKN-EMPHASIS ZTMF-TKN-FS-ERROR ZTMF-TKN-FILENAME token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-BOOLEAN. ZSPI-TYP-INT. ZSPI-TYP-FNAME.
TMF Management Programming Manual Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number.
Event Messages TMF Management Programming Manual 151: ZTMF-EVT-WrongGlobInfoFileVer (Page 6-132) The specified configuration file has a version number that is not consistent with the version number of the installed TMF software. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE ZEMS-TKN-EMPHASIS ZTMF-TKN-FILENAME token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-BOOLEAN. token-type ZSPI-TYP-FNAME. Event-Message Text Configuration file ZTMF-TKN-FILENAME has the wrong version number.
Event Messages TMF Management Programming Manual 166: ZTMF-EVT-Rcov-Restart1 (Pages 6-148 through 6-149) A volume or file recovery operation was interrupted by a disk process takeover for the specified volume. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE ZTMF-TKN-RCOV-FILENAME-1 ZTMF-TKN-RCOV-RESTART-INDEX ZTMF-TKN-RCOV-RESTART-SNO ZTMF-TKN-RCOV-RESTART-RBA ZTMF-TKN-RCOV-RESTART-RBA2 token-type token-type token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-STRING.
TMF Management Programming Manual Event Messages ZTMF-TKN-RCOV-RESTART-SNO contains an integer specifying an audit-trail file sequence number. ZTMF-TKN-RCOV-RESTART-RBA contains an integer specifying a relative byte address (rba) within the audit-trail file. If the rba is less than 2,147,483,647, this token contains the actual rba. If the rba is 2,147,483,647 or greater, this token contains 2,147,483,647 (and the RBA2 token contains the actual rba).
Event Messages TMF Management Programming Manual 168: ZTMF-EVT-Rcov-FsError1 (Pages 6-151 through 6-152) A file-system error occurred against the specified file while a recovery process was attempting the specified operation. The affected audit record is located at the position specified in the error message.
TMF Management Programming Manual Event Messages ZTMF-TKN-RCOV-OP-OF-ERROR specifies the operation that was being attempted.
TMF Management Programming Manual Event Messages Recommended Action If the backout process was involved and the event message is accompanied by event 172, then some type of recovery action may be required, depending upon the status indicated by event 172. If the status is “ignored,” then no recovery action is needed immediately (although the affected file is no longer consistent). If the status is “retried,” then no recovery action is needed unless the transaction becomes “hung.
Event Messages TMF Management Programming Manual 173: ZTMF-EVT-Rcov-AuditTrailError (Pages 6-161 through 6-162) One of the TMF recovery processes encountered a problem while attempting to read an audit-trail file. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE ZTMF-TKN-AUDITREADEXCEPTION token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-INT. Event-Message Text Recovery process failed due to audit reading exception: ZTMF-TKN-AUDITREADEXCEPTION.
TMF Management Programming Manual Event Messages ZTMF-VAL-ARExcp-AuxPtrMismatch ZTMF-VAL-ARExcp-Format2File ZTMF-VAL-ARExcp-Format2Rec Effect The recovery fails. In the case of volume recovery, the process is not restarted. The affected data volume is flagged as needing recovery and is disabled for transaction processing. In the case of backout or file recovery, the TMF management process (TMP) restarts the process. If the error was transitory, the recovery operation continues to completion.
Event Messages TMF Management Programming Manual 175: ZTMF-EVT-Rcov-EndAtFileHiatus (Pages 6-164 through 6-165) File recovery to a timestamp, or to the first purge record, was performed on the specified file, and an online dump was not made immediately afterwards.
TMF Management Programming Manual Event Messages ZTMF-TKN-RCOV-ERROR-RBA contains an integer specifying a relative byte address (rba) within the audit-trail file. If the rba is less than 2,147,483,647, this token contains the actual rba. If the rba is 2,147,483,647 or greater, this token contains 2,147,483,647 (and the RBA2 token contains the actual rba). ZTMF-TKN-RCOV-ERROR-RBA2 contains an integer specifying a relative byte address (rba) within the audit-trail file.
Event Messages TMF Management Programming Manual 179: ZTMF-EVT-Rcov-ToRba-Too-Low (Page 6-170) Either the sno or rba entered with the TOMATPOSITION option of a FILE RECOVERY command falls below the sno or rba of the online dump. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE ZTMF-TKN-RCOV-STATUS-SNO ZTMF-TKN-RCOV-STATUS-RBA ZTMF-TKN-RCOV-STATUS-RBA2 token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-INT2. ZSPI-TYP-INT2. ZSPI-TYP-INT4.
TMF Management Programming Manual Event Messages Effect The specified file can only be recovered to an audit trail and rba position after the end of the online dump. No files will be recovered. Recommended Action Change the audit-trail sequence number or rba in the TOMATPOSITION option of the RECOVER FILES command and reexecute the command.
Event Messages TMF Management Programming Manual 283: ZTMF-EVT-CtgProcessErr (Pages 6-284 through 6-285) The TMP encountered an error accessing the TMF catalog process. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE ZTMF-TKN-COMMAND ZTMF-TKN-FS-ERROR ZEMS-TKN-EMPHASIS ZTMF-TKN-PROCESSNAME token-type token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-INT. ZSPI-TYP-INT. ZSPI-TYP-BOOLEAN. ZSPI-TYP-STRING.
TMF Management Programming Manual Event Messages Effect The specified operation is not performed. Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for a description of and recovery actions for the file-system error.
Event Messages TMF Management Programming Manual 294: ZTMF-EVT-NoTLEAvailable (Page 6-298) A TMF process could not obtain a timer list element (TLE). Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE ZEMS-TKN-EMPHASIS token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-BOOLEAN. Event-Message Text Process failing due to inability to allocate a TLE.
TMF Management Programming Manual Event Messages If your local operating procedures require contacting the Global Customer Support Center (GCSC), supply your system number and the numbers and versions of all related products as well.
Event Messages TMF Management Programming Manual 332: ZTMF-EVT-AuditRead-Error (Pages 6-346 through 6-347) During START TMF operation the TMP encountered a problem while attempting to read an audit-trail file. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE ZTMF-TKN-AUDITREADEXCEPTION ZEMS-TKN-EMPHASIS token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-INT. token-type ZSPI-TYP-BOOLEAN.
TMF Management Programming Manual Event Messages ZTMF-VAL-ARExcp-AuxPtrInAux ZTMF-VAL-ARExcp-AuxPtrMismatch ZTMF-VAL-ARExcp-Format2File ZTMF-VAL-ARExcp-Format2Rec ZEMS-TKN-EMPHASIS is set to TRUE for this event. Effect The START TMF operation is terminated. TMF does not start.
Event Messages TMF Management Programming Manual 355: ZTMF-EVT-Rcov-FsError4 (Pages 6-357 through 6-358) A file-system error occurred against the specified file while a recovery process was attempting the specified operation. The affected audit record is located at the position specified in the error message.
TMF Management Programming Manual Event Messages ZTMF-TKN-RCOV-FSERROR contains an integer identifying the file-system error that occurred. ZTMF-TKN-RCOV-OP-OF-ERROR specifies the operation that was being attempted.
TMF Management Programming Manual Event Messages Effect The effect of this event depends on which recovery process was used. For backout, this event message is accompanied by a second event (171 or 172) that indicates the effect. For volume or file recovery, this event message is accompanied by event 171. The file is marked either “redo-needed” or “undo-needed” and is no longer available for transaction processing.
Event Messages TMF Management Programming Manual 359: ZTMF-EVT-Rcov-EndAtFileHiatus2 (Pages 6-365 through 6-366) File recovery to a timestamp, or to the first purge record, was performed on the specified file, and an online dump was not made immediately afterwards.
TMF Management Programming Manual Event Messages ZTMF-TKN-RCOV-ERROR-SNO contains an integer specifying an audit-trail file sequence number. ZTMF-TKN-RCOV-ERROR-RBA contains an integer specifying a relative byte address (rba) within the audit-trail file. If the rba is less than 2,147,483,647, this token contains the actual rba. If the rba is 2,147,483,647 or greater, this token contains 2,147,483,647 (and the RBA2 token contains the actual rba).
Event Messages TMF Management Programming Manual 400: ZTMF-EVT-FRToMatPosition (Page 6-373) The TOMATPOSITION option of the RECOVER FILES command is being used, and the recovery operation will terminate at the location identified by the atseqno and rba. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE ZTMF-TKN-RCOV-STATUS-SNO ZTMF-TKN-RCOV-STATUS-RBA ZTMF-TKN-RCOV-STATUS-RBA2 token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-INT2. ZSPI-TYP-INT2. ZSPI-TYP-INT4.
TMF Management Programming Manual Event Messages Effect The file recovery will terminate at the audit-trail position reported by this message. Recommended Action Informative message only; no corrective action is needed.
Event Messages TMF Management Programming Manual 401: ZTMF-EVT-FRRedoPassComplete (Page 6-374) File recovery or volume recovery has completed the redo pass. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE ZTMF-TKN-RCOV-STATUS-SNO ZTMF-TKN-RCOV-STATUS-RBA ZTMF-TKN-RCOV-STATUS-RBA2 token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-INT2. ZSPI-TYP-INT2. ZSPI-TYP-INT4.
TMF Management Programming Manual Event Messages Effect File recovery or volume recovery has completed the first phase of recovery. Recommended Action Informative message only; no corrective action is needed.
Event Messages TMF Management Programming Manual 402: ZTMF-EVT-FRFilTrnsPassComplete (Page 6-375) File recovery or volume recovery has completed the build file transaction pass. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE ZTMF-TKN-RCOV-STATUS-SNO ZTMF-TKN-RCOV-STATUS-RBA ZTMF-TKN-RCOV-STATUS-RBA2 token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-INT2. ZSPI-TYP-INT2. ZSPI-TYP-INT4.
TMF Management Programming Manual Event Messages Effect File recovery or volume recovery has completed the second phase of recovery. Recommended Action Informative message only; no corrective action is needed.
Event Messages TMF Management Programming Manual 403: ZTMF-EVT-FRUndoPassComplete (Page 6-376) File recovery or volume recovery has completed the undo pass. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE ZTMF-TKN-RCOV-STATUS-SNO ZTMF-TKN-RCOV-STATUS-RBA ZTMF-TKN-RCOV-STATUS-RBA2 token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-INT2. ZSPI-TYP-INT2. ZSPI-TYP-INT4.
TMF Management Programming Manual Event Messages Effect File recovery or volume recovery has completed the third phase of recovery. After the third phase of recovery has completed, there may be a long duration (up to 10 minutes) before the recovery process completes. This delay is caused by the TMF subsystem waiting for the disk process to complete all processing of the audit trails involved in the recovery operation. Recommended Action Informative message only; no corrective action is needed.
Event Messages TMF Management Programming Manual 437: ZTMF-EVT-Rcov-FSErrorPurge (Pages 6-390 through 6-391) This event indicates that the recovery process encountered a purge record for the specified file while attempting the specified operation. The affected audit record is located at the position specified in the error message. The message appears only if the file in question is being recovered to a different location than the location reflected by the online dump.
TMF Management Programming Manual Event Messages ZTMF-TKN-RCOV-FILENAME-2 contains the logical name of the database table or file. ZTMF-TKN-RCOV-OP-OF-ERROR specifies the operation that was being attempted. The possible values are: ZTMF-VAL-RCOV-FLABMODREDO ZTMF-VAL-RCOV-FLABMODUNDO ZTMF-TKN-RCOV-ERROR-INDEX contains an integer specifying an audit-trail index value (zero indicates the master audit trail; 1 through 15 indicate auxiliary audit trails).
TMF Management Programming Manual Event Messages To avoid this purge, TMF does not queue the record to the disk process and instead terminates the recovery. To recover from this error, issue the RECOVER FILES command again for this object, specifying either the TOFIRSTPURGE option or a TIME OR TOMATPOSITION location before this record in the audit trail. This action will retrieve a consistent copy of the object.
Event Messages TMF Management Programming Manual 438: ZTMF-EVT-AtMaxImpending (New Discussion) The audit-trail sequence number is approaching the maximum of 999999. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE ZTMF-TKN-AUDITTRAILID ZTMF-TKN-AUDITFILENAME token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. Event-Message Text The ZTMF-TKN-AUDITTRAILID Audit Trail Sequence Number is Critically High. Audit Trail File ZTMF-TKN-AUDITFILENAME.
TMF Management Programming Manual Event Messages Recommended Action This is a critical warning message. If the audit generation fills up the maximum trail number 999999, TMF attempts to roll over to 1000000, TMF stops, and recovery is impossible. All online dumps are unusable. When this message is received, you must stop TMF, delete TMF, and reconfigure TMF to restart the audit-trail sequence numbers at 1.
Event Messages TMF Management Programming Manual 440: ZTMF-EVT-ATAlterFilesize (New Discussion) The operator changed the audit-trail file size. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE ZTMF-TKN-AUDITTRAILID ZTMF-TKN-ATFILESIZE32 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-INT2. Event-Message Text Filesize attribute of ZTMF-TKN-AUDITTRAILID Audit Trail altered to ZTMF-TKN-ATFILESIZE32.
Event Messages TMF Management Programming Manual 441: ZTMF-EVT-ATAlterATFormat (New Discussion) The operator changed the audit-trail file format. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE ZTMF-TKN-ATFILEFORMAT token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-INT. Event-Message Text The TMF audittrail file format has been altered to format ZTMF-TKN-ATFILEFORMAT. The transition to the new audittrail files will begin upon the next START TMF.
Event Messages TMF Management Programming Manual 442: ZTMF-EVT-ATCantCreateNewFile (New Discussion) The operator changed the audit-trail filesize or format and the specified audit-trail file has an old size or format. The specified file-system error occurred during a create operation to replace the file. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE ZTMF-TKN-AUDITTRAILID ZTMF-TKN-AUDITFILENAME ZTMF-TKN-FS-ERROR token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-ENUM.
TMF Management Programming Manual Event Messages Effect The create operation fails and the file is not replaced. Recommended Action Correct the problem so that future attempts to create files with the proper format and filesize succeed.
Event Messages TMF Management Programming Manual 445: ZTMF-EVT-NoTLEDelayOccurring (New Discussion) The Backout process is delaying, waiting to obtain a timer list element (TLE). Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE token-type ZSPI-TYP-ENUM. Event-Message Text Process is delayed due to shortage of TLEs. Process will again try to get TLE. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE identifies the TMF process that generated the event.
7 TMF Application Programmer’s Guide The following caution will appear in Section 5 of the next edition of the HP NonStop TMF Application Programmer’s Guide: Caution. Relative byte address (rba) values for audit-trail files might exceed the size allowed by C INT or pTAL INT(32) data types.
TMF Application Programmer’s Guide ARGETAUDRECHEADERINFO (New Discussion) ARGETAUDRECHEADERINFO (New Discussion) This procedure returns certain information from the audit-record header. CALL ARGETAUDRECHEADERINFO [ , , , , ( return-code file-format blocksize rsn-rbn recnum-offset ] ) EXTENSIBLE; return-code ! ! ! ! ! o o o o o output INT .EXT:ref:1 indicates the outcome of the call. file-format output INT:value indicates the file format (0 = format-1 files, 1 = format-2 files).
How to Include Audit Reading in an Application (Page 5-95) TMF Application Programmer’s Guide How to Include Audit Reading in an Application (Page 5-95) The TMF audit-reading procedures are contained in a set of files that are delivered with the TMF product. Table 7-1 summarizes the audit-reading procedure files. Because TMFARLB2 is a native object file, NLD must be used to build the executable object file.
TMF Application Programmer’s Guide How to Include Audit Reading in an Application (Page 5-95) HP NonStop TMF Supplement for Large Audit-Trail Files —527391-001 7 -4
Index A ACTIVEVOLS parameter ADD AUDITTRAIL command 5-4 RESET AUDITTRAIL command 5-36 SET AUDITTRAIL command 5-40 Active-audit volumes 3-3, 5-4, 5-12, 5-36, 5-40 ADD AUDITTRAIL command 5-2/5-9, 6-3 ADDACTIVEVOLS parameter, ALTER AUDITTRAIL command 5-11/5-12 Adding audit trails 5-2/5-9 ADDOVERFLOWVOLS parameter, ALTER AUDITTRAIL command 5-13 ADDRESTOREVOLS parameter, ALTER AUDITTRAIL command 5-13 ALTER AUDITTRAIL command 5-10/5-20, 6-8 ALTER TMF command 5-22/5-24, 6-14 Applications, including audit-reading p
B Index B BEGINTRANSDISABLE parameter ADD AUDITTRAIL command 5-5 ALTER AUDITTRAIL command 5-14 RESET AUDITTRAIL command 5-37 SET AUDITTRAIL command 5-41 C Capacity of audit trail, increasing 3-3/3-4 Changing audit trail attributes 5-10/5-20 Changing the configuration volume 5-23 CNFGFORM parameter, INFO TMF command 5-29 Command files, formatting output for 5-25, 5-29 CONFIG parameter, ALTER TMF command 5-22 Configuration volume, changing 5-23 Cursor, closing 7-2 D DELETEACTIVEVOLS parameter, ALTER AUDIT
P Index OVERFLOWTHRESHOLD parameter (continued) RESET AUDITTRAIL command 5-37 SET AUDITTRAIL command 5-41 OVERFLOWVOLS parameter ADD AUDITTRAIL command 5-4 RESET AUDITTRAIL command 5-36 SET AUDITTRAIL command 5-41 Overflow-audit volumes 5-4, 5-7, 5-13, 5-36, 5-41 T P UNPINAUDIT command, RDFCOM 4-1 Performance, improving by increasing audit trail capacity 3-3/3-4 Z R RDFCOM UNPINAUDIT command 4-1 Remote Duplicate Database Facility pinning audit- trail files 4-1 UNPINAUDIT command 4-1 RESET AUDITTRAIL
Z Index ZTMF-EVT- event messages (continued) GlobInfoFileErr (event 150) 6-22 NoTLEAvailable (event 294) 6-38 Rcov-AuditTrailError (event 173) 6-30 RCOV-ENDATFILEHIATUS (event 175) 6-32 RCOV-ENDATFILEHIATUS2 (event 359) 6-45 Rcov-FsError1 (event 168) 6-27 RCOV-FSERROR4 (event 355) 6-42 Rcov-Restart1 (event 166) 6-25 RCOV-TORBA-TOO-LOW (event 179) 6-34 WrongGlobInfoFileVer (event 151) 6-24 ZTMF-EVT-event 6-55 ZTMF-MAP- extensible tokens ADD-AUDITTRAIL 6-5 ALTER-AUDITTRAIL 6-11/6-12 INFO-AUDITTRAIL 6-17/6-1