HP NonStop TMF Management Programming Manual Abstract This manual is for system and application programmers. It provides system-specific information about the management programming interfaces to the HP NonStop™ Transaction Management Facility (TMF). These interfaces are based on the Subsystem Programmatic Interface (SPI) and the Event Management Service (EMS). They allow applications to send commands to, and monitor events reported by, TMF 3.3.
Document History Part Number Product Version Published 540140-001 TMF H01 July 2005 540140-002 TMF H01 February 2006
HP NonStop TMF Management Programming Manual Index Tables What’s New in This Manual vii Manual Information vii New and Changed Information viii About This Manual xi Who Should Read This Manual xii How This Manual is Organized xii TMF Documentation xiii Other Documentation xiv Notation Conventions xiv 1.
2. Communicating With the TMFSERVE Process Contents TMF Commands 1-12 TMF Event Messages 1-15 2. Communicating With the TMFSERVE Process Communicating With the TMFSERVE Process Starting and Opening TMFSERVE 2-2 Starting TMFSERVE 2-2 Startup Message 2-2 Opening TMFSERVE 2-2 Naming TMFSERVE 2-3 Closing TMFSERVE 2-3 Running an EMS Consumer Distributor 2-3 2-1 3.
. Commands and Responses Contents Buffer Declarations 4-5 Private Token and Field Types 4-6 Predefined Token and Field Values 4-8 Simple Tokens 4-8 Extensible Structured Tokens 4-9 Tokens in Event Messages 4-9 5.
. Event Messages Contents ENABLE BEGINTRANS 5-87 ENABLE DATAVOLS 5-89 INFO ATDUMPDM 5-91 INFO ATVOLUME 5-93 INFO AUDITDUMP 5-96 INFO AUDITTRAIL 5-99 INFO BEGINTRANS 5-102 INFO CATALOG 5-105 INFO DATAVOLS 5-107 INFO DUMPS 5-110 INFO MEDIA 5-115 INFO PROCESS 5-118 INFO RESOURCEMANAGER 5-122 INFO TMF 5-125 LIST AUDITTRAIL 5-126 NEXT AUDITTRAIL 5-127 RECOVER FILES 5-129 RELOCATE DISKDUMPS 5-135 RESOLVE TRANSACTION 5-138 START TMF 5-140 STATUS ATFILE 5-143 STATUS AUDITDUMP 5-148 STATUS AUDITTRAIL 5-151 STATUS
. Error and Warning Messages Contents Obtaining TMF Event Messages 6-4 Sources of TMF Event Messages 6-4 TMP Event Messages 6-5 TMFMON Event Messages 6-11 Recovery Event Messages 6-13 TMF Dump/Restore Event Messages 6-15 TMF Catalog Event Messages 6-16 Event-Management Programming for TMF 6-17 Console Printing 6-17 Subsystem ID 6-17 Action Events 6-17 Buffer Size 6-17 Event Filtering 6-18 Descriptions of Event Messages 6-18 7.
Contents Table 4-6. Table 4-7. Table 4-8. Table 4-9. Table 4-10. Table 4-11. Table 5-1. Table 5-2. Table 6-1. Table 6-2. Table 6-3. Table 6-4. Table 6-5. Table A-1. Table A-2. Table A-3. Table A-4. Table A-5. Table A-6. Table A-7.
What’s New in This Manual Manual Information HP NonStop TMF Management Programming Manual Abstract This manual is for system and application programmers. It provides system-specific information about the management programming interfaces to the HP NonStop™ Transaction Management Facility (TMF). These interfaces are based on the Subsystem Programmatic Interface (SPI) and the Event Management Service (EMS). They allow applications to send commands to, and monitor events reported by, TMF 3.3.
What’s New in This Manual New and Changed Information New and Changed Information This is the second edition of the HP NonStop TMF Management Programming Manual. It has been updated to support the H06.05 release version update (RVU) of the TMF product and to correct and clarify elements in the previous edition.
What’s New in This Manual New and Changed Information 466: ZTMF-EVT-ZLTCHTimeOut 467: ZTMF-EVT-ZLTCHChngStateError 468: ZTMF-EVT-ZLTCHChngVolState 469: ZTMF-EVT-ZLTCHChngTrailState 470: ZTMF-EVT-ZLTCHChngTmpState 471: ZTMF-EVT-ZLTCHAlterConfig 472: ZTMF-EVT-ZLTCHCheckError 473: ZTMF-EVT-ZLTCHGetError Altered the following event message descriptions: 150: ZTMF-EVT-GlobInfoFileErr 151: ZTMF-EVT-WrongGlobInfoFileVer 166: ZTMF-EVT-Rcov-Restart1 168: ZTMF-EVT-Rcov-FsError1 173: ZTMF-EVT-Rcov-AuditTrailError 17
What’s New in This Manual New and Changed Information 661 ZTMF-ERR-CommitHoldMatOnly 662 ZTMF-ERR-CommitHoldTimer 663 ZTMF-ERR-MustSetMatFirst 664 ZTMF-ERR-MustResetAuxFirst 665 ZTMF-ERR-CommitHoldNullTime 666 ZTMF-ERR-CommitHoldAction 667 ZTMF-ERR-CantAltTimeWithoutOn 668 ZTMF-ERR-NotZLTCHActive 669 ZTMF-ERR-ZLTCHNotSupported 670 ZTMF-ERR-ZLTCHChangeFSError 9116 Failed to obtain current EOF from TMP for audit trail ZTMF-TKN-DRFILENAME. Error ZTMF-TKN-DR-FileERROR was returned.
About This Manual This manual provides subsystem-specific information about the management programming interfaces to the HP NonStop Transaction Management Facility (TMF) on HP NonStop servers. These interfaces are based on the Subsystem Programmatic Interface (SPI) and the Event Management Service (EMS). They allow applications to send commands to, and monitor events reported by, TMF. This manual serves as both a reference manual and a programmer’s guide.
Who Should Read This Manual About This Manual Who Should Read This Manual You should read this manual if you are an experienced application programmer in one of the following categories: • • A Transaction Application Language (TAL), C, C++, or COBOL85 programmer writing applications that need to control or monitor TMF A TACL user writing macros or routines that control or monitor TMF To use this manual effectively, you should be familiar with the following subjects: • • • • • • Basic NonStop system a
TMF Documentation About This Manual • • Detailed descriptions of all event messages than can be returned by TMF (Section 6) Detailed descriptions of all error and warning messages than can be returned by TMF (Section 7) Appendix A, TMF Configuration Limits and Defaults provides summarizes various TMF limits. TMF Documentation Readers of this manual might also wish to refer to documentation describing the TMF product and other related products.
Other Documentation About This Manual • • TMF Reference Manual Refer to this manual for information about how to use the TMFCOM command interface to TMF. This manual includes syntax, cautionary considerations, and command examples for TMFCOM. 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.
Notation for Management Programming Interfaces About This Manual Notation for Management Programming Interfaces UPPERCASE LETTERS. Uppercase letters indicate names from definition files; enter these names exactly as shown. For example: ZCOM-TKN-SUBJ-SERV lowercase letters. Words in lowercase letters are words that are part of the notation, including Data Definition Language (DDL) keywords.
Change Bar Notation About This Manual HP NonStop TMF Management Programming Manual—540140-002 xvi
1 Introduction to TMF TMF protects databases in online transaction processing (OLTP) environments. It does this by managing database transactions, keeping track of database activity through the use of audit trails, and providing database recovery methods. TMF performs its functions while sustaining high performance in a high-volume, distributed OLTP application environment.
How Does Management Programming Apply to TMF? Introduction to TMF An event-management task retrieves information about important events that occur in a system and takes appropriate action in response to those events. Event messages provide a one-way interface: • Information flows from the subsystem to the operator or application program, but no information flows in the other direction. The programs that perform these functions are called management applications or programmed operators.
TMF Basic Concepts Introduction to TMF capability to write your own management applications allows you to tailor them to the needs and configuration of your system.
Audit Trails Introduction to TMF information. Together, TMF control records constitute a chronological record of all transaction-related activities. If the database is distributed over a network, separate audit trails are maintained on each node where the database resides. Before-images and after-images are written to the audit trail on the same node as reside the rows or records changed by the transaction. The Master Audit Trail There is one master audit trail (MAT) in each TMF system.
Database Tables and Files Introduction to TMF Database Tables and Files You can use TMF to protect NonStop SQL/MP tables and Enscribe files. Data Volumes When configuring your TMF environment, you must identify all disk volumes that will contain audited tables or files. These are referred to as data volumes. To generate audit information, a database operation must occur within the bounds of a TMF transaction and the table or file being manipulated must reside on a configured TMF data volume.
Management Interfaces Introduction to TMF unnecessary; however, file recovery would be required, for example, if a media failure involves a nonmirrored volume, or both volumes of a mirrored pair. File recovery is not invoked automatically; you have to issue a RECOVER FILES command, specifying the tables or files you want recovered.
FUP Introduction to TMF FUP The File Utility Program (FUP) also provides an interactive management interface. It performs operations on files stored on disk drives and tape volumes. With FUP, for example, you can create, purge, duplicate, and display files, alter file characteristics, and load data into files. Through FUP commands, you can request several TMF operations. In particular, you can designate files to be audited by TMF or you can change such a designation.
PATHCOM Introduction to TMF PATHCOM The Pathway transaction processing system enables you to create and manage online transaction processing applications. In particular, Pathway controls the flow of transactions between the input/output devices and the database used by an application. Pathway systems that use audited files must be configured to define how TMF works with server classes and terminals, and how failures are treated.
Pathway SCREEN COBOL Introduction to TMF Pathway SCREEN COBOL The SCREEN COBOL programming language allows programmers to write client processes that communicate with operator terminals and intelligent input/output devices, and that send data to server processes that manage application databases, all under the control of Pathway. SCREEN COBOL programmers use special statements and registers for accessing TMF.
Operating System Procedure Calls Introduction to TMF Operating System Procedure Calls Through its Guardian application program interface (API), the NonStop operating system provides procedure calls you can include in application programs written in any of the following languages: C, C++, COBOL, FORTRAN, Pascal, and the native Transaction Application Language (TAL). In most cases, the code for the procedures is made available through external declaration files provided with the compiler.
TACL Introduction to TMF For further information about system procedure calls, see the Guardian Procedure Calls Reference Manual. For information about how to issue these calls from the language you are using, see that language’s reference manual. TACL The Tandem Advanced Command Language (TACL) provides the Guardian environment’s command interface to the operating system. TACL features built-in functions that can be used for constructing programmatic routines and macros.
TMF Commands Introduction to TMF DUMPS MEDIA PROCESS RESOURCEMANAGER (or RM) TMF TMFSERVER TRANSACTION TRANSACTIONCHILDREN TMF Commands Your management application can perform the following functions by sending commands to the TMFSERVE process: • • • • • • • • • Add and delete audit trails, data volumes, dump files, and tape volumes in a TMF system Start and stop TMF Start and stop transaction processing Display the status of TMF and related objects Configure audit trails for dumping Dump audite
TMF Commands Introduction to TMF Table 1-7.
TMF Commands Introduction to TMF Table 1-7.
TMF Event Messages Introduction to TMF Section 5, Commands and Responses in this manual, describes in detail the SPI-format programmatic commands that management applications can direct to the TMFSERVE process, and the SPI-format responses that TMF returns. TMF Event Messages TMF generates event messages when it detects significant events, such as a trap caused by a hardware or software error, a management counter reaching a threshold, or a transaction failure.
Introduction to TMF TMF Event Messages HP NonStop TMF Management Programming Manual—540140-002 1- 16
2 Communicating With the TMFSERVE Process A management application communicates with TMF through the Subsystem Programmatic Interface (SPI). It retrieves event messages from TMF through the Event Management Service (EMS).
Communicating With the TMFSERVE Process Starting and Opening TMFSERVE TMFSERVE is a context-free server; that is, a requester can freely divide a series of commands among a number of copies of TMFSERVE. A requester need not always communicate with the same copy of TMFSERVE. Users that can issue TMFCOM commands can issue the corresponding programmatic commands.
Communicating With the TMFSERVE Process Naming TMFSERVE Naming TMFSERVE The name of a TMFSERVE process has the following form: $process.#ZSPI $process is the name of a TMFSERVE process and begins with a dollar sign ($) followed by a letter. If the name of the TMFSERVE process is not to be used in a network it can include up to 5 alphanumeric characters after the dollar sign; otherwise it can include 4 alphanumeric characters after the dollar sign.
Communicating With the TMFSERVE Process Running an EMS Consumer Distributor HP NonStop TMF Management Programming Manual—540140-002 2 -4
3 SPI Programming Considerations for TMF Once your subsystem and EMS processes are running and your management application has established communication with the TMFSERVE process, the main business of your management application is to format and send commands, decode responses and act on the results, and interpret event messages and act on their information. This section provides some summary information and discusses SPI programming considerations that are specific to TMF.
SPI Programming Considerations for TMF Definition Files file are grouped into sections to enable COBOL85 programs to declare multiple copies of structures in the definition file. TAL programs can source either the entire definition file or just the sections they need. The TACL command interpreter always loads the entire definition file. For further information about how definition files are used by an application, see the SPI Programming Manual.
Message Elements for TMF SPI Programming Considerations for TMF For information about the SPI, EMS, extended SPI definitions, operating system, and file-system definitions, see the SPI Programming Manual, the EMS Manual, and the Guardian Procedure Errors and Messages Manual, respectively. The TMF definitions are described in this manual. Message Elements for TMF The following subsections provide subsystem-specific information about elements of TMF commands, responses, and event messages.
SPI Programming Considerations for TMF Object Names All commands and responses contain an object-type token in the header. For TMF, object types are identified in programs by symbolic names of the form ZTMF-OBJname, where name identifies the object type. For example, the MEDIA object type is represented by the name ZTMF-OBJ-MEDIA. The object-type header token, ZSPITKN-OBJECT-TYPE, always has one of these values.
SPI Programming Considerations for TMF Using SPI to Build Commands and Decode Responses Using SPI to Build Commands and Decode Responses The following subsections summarize the steps your application must take to create, send, retrieve, and decode SPI messages. These summaries are followed by subsystem-specific programming considerations for TMF. For more information about creating, sending, retrieving and decoding SPI commands and responses, see the SPI Programming Manual.
SPI Programming Considerations for TMF Discontinuing a Command in Progress TMF does not support multiple commands in a single request message. However, many of the TMF commands accept multiple object names in one command (as many as will fit in the buffer), so a single command can operate on a number of objects.
SPI Programming Considerations for TMF Error Handling TMF can return an empty response if an application returns a ZSPI-TKNCONTEXT token to the TMFSERVE process and there are no more responses to be returned. The return token ZSPI-TKN-RETCODE in an empty response record always has the value ZTMF-ERR-EMPTYRESPONSE. 6. Take action appropriate to the information in the response. The response buffer always contains the return token, ZSPI-TKN-RETCODE.
SPI Programming Considerations for TMF Security The TMFSERVE process does not provide support for continuing—despite errors— through the use of the SPI standard token ZSPI-TKN-ALLOW-TYPE. The SPI standard token ZSPI-TKN-RETCODE contains a nonzero value if the TMFSERVE process detects an error in a command message—or in attempting to perform a command. TMF can also return file-system errors. These errors are listed in Table 3-1. Table 3-1.
SPI Programming Considerations for TMF Event-Management Considerations for TMF desired. Send the CONTROL command to the consumer distributor using the mechanism appropriate to your programming language (for example, a WRITEREAD call in TAL). 4. Read the response from the distributor using the mechanism appropriate to your programming language (for example, a WRITEREAD call in TAL). 5. Repeat the following steps in a loop: a.
SPI Programming Considerations for TMF Critical Events Some TMF event messages contain extensible structured tokens providing information for use by your application. In addition, some TMF event messages contain error lists. Some of these error lists provide information for use by your application; others contain information you should report to your service provider. The descriptions of individual event messages in Section 6, Event Messages explain what to do with each error list.
SPI Programming Considerations for TMF Naming Guidelines for Applications Naming Guidelines for Applications By convention, HP uses names beginning with the letter Z (lowercase z in C) for all definitions and all component fields of structures in its definition files. To avoid present and future conflicts with names defined by HP, it is best not to begin any of your own names with uppercase or lowercase Z.
SPI Programming Considerations for TMF Naming Guidelines for Applications HP NonStop TMF Management Programming Manual—540140-002 3- 12
4 Common Definitions This section discusses SPI standard definitions, EMS standard definitions, and TMF definitions used in the token-oriented programmatic interface to TMF. The information in this section is general information that applies to all uses of the definitions in the interface to TMF. Information about a definition that is specific to a particular command, response, event message, or error list appears in the description of that command, response, event message, or error list.
SPI Standard Definitions Common Definitions Table 4-1. SPI Standard Definitions for Header Tokens ZSPI-TKN-BUFLEN ZSPI-TKN-CHECKSUM ZSPI-TKN-COMMAND ZSPI-TKN-HDRTYPE ZSPI-TKN-LASTERR ZSPI-TKN-LASTERRCODE ZSPI-TKNLASTPOSITION ZSPI-TKN-MAX-FIELD-VERSION ZSPI-TKN-MAXRESP ZSPI-TKN-OBJECT-TYPE ZSPI-TKN-POSITION ZSPI-TKN-SERVER-VERSION ZSPI-TKN-SSID ZSPI-TKN-USEDLEN Table 4-2.
Information Specific to TMF Common Definitions Table 4-5. SPI Standard Definitions for Structures ZSPI-DDL-BOOLEAN ZSPI-DDL-BYTE ZSPI-DDL-CHAR-PAIR ZSPI-DDL-CHAR6 ZSPI-DDL-CHAR8 ZSPI-DDL-CRTPID ZSPI-DDL-DEVICE ZSPI-DDL-DISCNAME ZSPI-DDL-ENUM ZSPI-DDL-FNAME ZSPI-DDL-INT ZSPI-DDL-INT2 ZSPI-DDL-INT2-PAIR ZSPI-DDL-TIMESTAMP ZSPI-DDL-TRANSID ZSPI-DDL-UINT ZSPI-DDL-USERID Table 4-6.
EMS Standard Definitions Common Definitions ZSPI-SSN-ZTMF is the subsystem number assigned to TMF. EMS Standard Definitions Definitions whose names begin with ZEMS- are EMS standard definitions. These definitions are available to all subsystems that support EMS; they are provided in the EMS DDL file, ZSPIDEF.ZEMSDDL, and in the corresponding files for other languages. Table 4-7 and Table 4-8 list the EMS standard definitions used in the management programming interface to TMF.
Buffer Declarations Common Definitions Table 4-9. TMF Buffer Declarations ZTMF-DDL-MSG-BUFFER ZTMF-DDL-MSG-MINBUFFER ZTMF-DDL-MSG-MAXBUFFER ZTMF-VAL-BUFLEN ZTMF-VAL-BUFLEN-W ZTMF-VAL-MAXBUFLEN ZTMF-VAL-MAXBUFLEN-W ZTMF-VAL-MINBUFLEN ZTMF-VAL-MINBUFLEN-W Table 4-10. TMF Private Token and Field Types ZTMF-TYP-CHILDREN ZTMF-TYP-MEDIA ZTMF-TYP-DISKMEDIA ZTMF-TYP-USERNAME Table 4-11.
Private Token and Field Types Common Definitions ZTMF-DDL-MSG-MAXBUFFER is a message buffer of the maximum size for use with the SPI procedures—TACL does not accept a buffer of this size. def ZTMF-DDL-MSG-MAXBUFFER. 02 Z-MSGCODE type ZSPI-DDL-INT. 02 Z-BUFLEN type ZSPI-DDL-UINT. 02 Z-OCCURS type ZSPI-DDL-UINT. 02 Z-FILLER type ZSPI-DDL-BYTE Occurs 0 to ZTMF-VAL-MAXBUFLEN times depending on Z-OCCURS. end. ZTMF-VAL-BUFLEN is the recommended buffer size (in bytes) for commands sent to TMF.
Private Token and Field Types Common Definitions ZTMF-TYP-MEDIA defines a piece of TMF tape media and the part and copy number of the dump it contains. def ZTMF-DDL-MEDIA. 02 Z-NAME 02 Z-PARTNUMBER 02 Z-COPYNUMBER end. type ZSPI-DDL-CHAR6. type ZSPI-DDL-INT. type ZSPI-DDL-INT. Z-NAME is the name of the tape volume. If the first character is numeric, up to 5 numeric characters can follow. If the first character is alphabetic, up to 5 numeric or alphabetic characters (in any combination) can follow.
Private Token and Field Types Common Definitions ZTMF-TYP-UserName defines the ZTMF-TKN-UserName token for the NonStop OS group and user name. def ZTMF-DDL-UserName. 02 Z-GroupName 02 Z-UserName end. type ZSPI-DDL-Char8. type ZSPI-DDL-Char8. Z-GroupName is the 8-character group name of the user. Z-UserName is the 8-character user name of the user. ZTMF-TYP-CpusInfo defines the processor(s) in which to run a process. def ZTMF-DDL-CpusInfo. 02 Z-Count 02 Z-Int end. type ZSPI-DDL-Int. type ZSPI-DDL-Int.
Private Token and Field Types Common Definitions ZMaxPioPerBuffer is the maximum number of LBEs that will be held in a transport buffer before the buffer content is sent. The specified number can range from 1 to 200. The default is 1 (no PIO buffering). When set to 1, the ZPioBufferSize and ZPioDelayTimer token values are not relevant. The default is 1. ZPioDelayTimer is the length of time, in microseconds, TMF waits before forwarding the PIO transport buffer. The value can range from 10000 to 2000000.
Private Token and Field Types Common Definitions ZTMF-TYP-MemHeapUsage defines attributes of memory heap usage. def ZTMF-DDL-MemHeapUsage. 02 ZLib. 03 ZCpuHeapSize type 03 ZCpuHeapPercent type 02 ZTmp. 03 ZTmpHeapSize type 03 ZCpu type 03 ZHeapPercent type end. ZSPI-DDL-Int2. ZSPI-DDL-Int OCCURS 16 TIMES. ZSPI-DDL-Int2. ZSPI-DDL-Int-Pair. ZSPI-DDL-Int-Pair. ZZCpuHeapSize is the TMFLIB heap size. ZZCpuHeapPercent is the TMFLIB heap usage by CPU in percent. This field occurs 16 times.
Predefined Token and Field Values Common Definitions Predefined Token and Field Values A predefined token or field is given a symbolic name in the TMF definitions file. TMF defines the following token and field values: ZTMF-VAL-SSID is the subsystem ID of TMF. For information about the structure of this value, see the description of the ZTMF-VAL-SSID token in SPI Standard Definitions on page 4-1. ZTMF-VAL-VERSION is the product version number of TMF. This value is a 16-bit unsigned integer.
Common Definitions Tokens in Event Messages HP NonStop TMF Management Programming Manual—540140-002 4- 12
5 Commands and Responses This section describes the programmatic commands you can issue to the TMFSERVE process—and the responses returned by each command. Each command and response description contains usage guidelines, including which user types are allowed to issue it. See Section 4, Common Definitions for a description of the common tokens used in more than one command. Note.
Command Summary Commands and Responses Command Summary Table 5-1 lists all TMF programmatic commands for management applications. These commands are described, in alphabetic order by command, in this section. Table 5-1.
Command Summary Commands and Responses Table 5-2 lists the same commands shown in Table 5-1, but in alphabetical order by object type. Table 5-2.
Commands and Responses Command Descriptions Command Descriptions Each command description contains a box that shows the symbolic name of the command number (such as ZTMF-CMD-Abort), the symbolic name for the object type of the command (such as ZTMF-OBJ-Transaction), a list of tokens that the command buffer can contain, and a list of tokens that the response buffer can contain.
Commands and Responses ABORT TRANSACTION ABORT TRANSACTION The ABORT TRANSACTION command cancels the effects of an active transaction, or reattempts to cancel an aborting or hung transaction, and releases the locks held by that transaction. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below. Command ZTMF-CMD-Abort Object Type ZTMF-OBJ-Transaction Tokens in Command Buffer ZTMF-TKN-TransID token-type ZSPI-TYP-TransID.
ABORT TRANSACTION Commands and Responses Tokens in Command Buffer ZTMF-TKN-TransID specifies the transaction identifier of the transaction to be aborted. ZTMF-MAP-Abort-Transaction is an extensible structured token that contains fields for aborting a transaction. Only one occurrence of this token is allowed. This token contains the following fields: ZIgnoreDataErrors specifies whether or not data-related errors are to be ignored while the specified transactions are being undone. This field is optional.
Commands and Responses ABORT TRANSACTION ZSPI-VAL-False The backout process does not abort the transaction but instead leaves it in the hung state. This field is optional. If you do not assign a value to this field, the default is ZSPI-VAL-False. Usage Guidelines Only members of the super user group can issue this command. TMF must be started. The buffer that receives the results should be large enough to hold the results for all transactions.
ADD AUDITTRAIL Commands and Responses ADD AUDITTRAIL 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). Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below.
ADD AUDITTRAIL Commands and Responses Tokens in Command Buffer ZTMF-TKN-AuditTrailId specifies an audit trail to add to the TMF configuration. This token is required; only one occurrence is 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 . . .
ADD AUDITTRAIL Commands and Responses ZTMF-TKN-RestoreVolume specifies the disk volume used when restoring audit dumps. If audit dumping is configured for the audit trail, you must specify at least one volume for this purpose. This token can occur from 1 to 16 times. You cannot specify the same restoreaudit volume twice in the same command. Restore-audit volumes can be the same volumes as the active-audit volumes; they can also be data volumes or any volumes not configured for other TMF purposes.
ADD AUDITTRAIL Commands and Responses configured with ZAuditDump set to ZSPI-VAL-True regardless of the ZAuditDump value for the auxiliary audit trails.
ADD AUDITTRAIL Commands and Responses Tokens in Response Buffer ZTMF-TKN-VolumeName contains the name of a volume that was in error, if an error is returned. ZTMF-TKN-ATVolumeType contains the type of the volume specified in ZTMF-TKN-VolumeName. This token is only present if ZTMF-TKN-VolumeName is present. The following values are valid: ZTMF-VAL-ActiveVol The disk volume that holds the audit trail files. ZTMF-VAL-OverflowVol The disk volume used as overflow space for the audit trail.
ADD DATAVOLS Commands and Responses ADD DATAVOLS The ADD DATAVOLS command adds data volumes to the TMF configuration, including management attributes such as the audit trail to receive audit records from these volumes. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below.
ADD DATAVOLS Commands and Responses Tokens in Command Buffer ZTMF-TKN-VolumeName specifies the name of a disk volume to be added to the TMF configuration as a data volume. This token must occur at least once; multiple occurrences are allowed. ZTMF-TKN-VolumeName can also contain a wild card (value “*”, length 1). If the wild card is specified, it must be the only instance of this token in the command buffer.
Commands and Responses ADD DATAVOLS ZRecoveryMode specifies whether audit trail files are held on disk until they are no longer required for volume recovery. The following values are valid: ZTMF-VAL-RecovMode-Online directs TMF to retain sufficient audit trail files on disk so that volume recovery does not need to restore audit information from an archived audit dump.
Commands and Responses ADD DATAVOLS Tokens in Response Buffer ZTMF-TKN-VolumeName contains the name of the volume(s) specified in the command buffer. Usage Guidelines Only super-group users can issue this command. TMF must be started. For more information about the ADD DATAVOLS command, see the TMF Reference Manual.
ADD DUMPS Commands and Responses ADD DUMPS The ADD DUMPS command adds dump entries to the TMF catalog. This command is used to reenter online and audit dump entries accidentally deleted from the catalog, or to recover a destroyed catalog. Use the ADD DUMPS command only under one of these conditions: • • • • The catalog files residing in the $System.ZTMFCONF subvolume have been damaged or lost. Entries for dumps have been mistakenly deleted from the catalog through a DELETE DUMPS command.
ADD DUMPS Commands and Responses Tokens in Command Buffer ZTMF-TKN-FileName specifies the audit trail file to be added to the catalog. This token is required; multiple occurrences are allowed. ZTMF-TKN-Media for dumps to tape, specifies the name of the tape volume on which the dump is stored. Specify the identifier magnetically encoded in the tape volume label and registered in the TMF catalog. Either ZTMF-TKN-Media or ZTMF-TKN-DiskMedia is required; multiple occurrences are allowed.
ADD DUMPS Commands and Responses ZDataSequence specifies the auxiliary audit trail sequence number that was active when the dump was made. This field is required if the value of ZDumpType is ZTMF-VAL-OnlineDump. Note. If only a master audit trail is configured, the values for ZMasterSequence and ZDataSequence are identical. ZMedium specifies the type of storage media used to make this dump. This field is required.
ADD MEDIA Commands and Responses ADD MEDIA The ADD MEDIA command adds one or more tape volumes to the TMF catalog. It also labels tape volumes. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below. Command ZTMF-CMD-Add Object Type ZTMF-OBJ-Media Tokens in Command Buffer ZTMF-TKN-Media token-type ZTMF-TYP-Media. ZTMF-MAP-Add-Media def ZTMF-DDL-Add-Media.
ADD MEDIA Commands and Responses ZTMF-MAP-Add-Media is an extensible structured token specifying the attributes of the media to be added to the TMF catalog. This token is required; only one occurrence is allowed. This token contains the following fields: ZMedium specifies the type of storage media. This field is required.
ADD MEDIA Commands and Responses ZTMF-VAL-Scratch specifies that the tape volume can be used for dumping files. ZDensity specifies the density at which the tapes are written. This field is only valid if ZLabelMedia is ZSPI-VAL-True. The following values are valid: ZTMF-VAL-Default If this field is null, the default value depends upon the tape drive. ZTMF-VAL-800BPI The density is 800 bits per inch. ZTMF-VAL-1600BPI The density is 1600 bits per inch.
ADD RESOURCEMANAGER Commands and Responses ADD RESOURCEMANAGER The ADD RESOURCEMANAGER command adds one or more recoverable resource managers to the resource manager directory. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below. Command ZTMF-CMD-Add Object Type ZTMF-OBJ-Rm Tokens in Command Buffer ZTMF-TKN-RmName ZTMF-TKN-RmOwnerID ZSPI-TKN-MaxResp ZSPI-TKN-Context token-type token-type token-type token-type ZSPI-TYP-String.
Commands and Responses ADD RESOURCEMANAGER Tokens in Command Buffer ZTMF-TKN-RmName specifies the name of a resource manager to be added to the resource manager directory. This token must appear at least once in the command buffer, and can appear multiple times to add multiple resource managers. If multiple resource managers are being added by a single command, the result of the operation is returned in a separate response record for each resource manager name.
Commands and Responses ADD RESOURCEMANAGER If no ZTMF-TKN-RmName tokens are supplied in the request, the error returned is ZTMF-ERR-MustSupplyRmName. If the value specified for the ZSPI-TKN-Context token is not valid, the error returned is ZTMF-ERR-InvalidContext. It is possible for TMF to discard the results of a command while they are still being retrieved by multiple requests with context. If that occurs, the error returned is ZTMFERR-ContextOutOfDate.
ALTER AUDITDUMP Commands and Responses ALTER AUDITDUMP The ALTER AUDITDUMP command changes the configured attribute values of an audit dump process. 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-AuditDump Tokens in Command Buffer ZTMF-TKN-AuditTrailId ZTMF-TKN-AddDiskMedia ZTMF-TKN-DelDiskMedia token-type ZSPI-TYP-Enum. token-type ZTMF-TYP-String. token-type ZTMF-TYP-String.
ALTER AUDITDUMP Commands and Responses Tokens in Command Buffer ZTMF-TKN-AuditTrailId specifies the audit trail associated with the audit dump process whose attributes are to be altered. This token is required; only one occurrence is 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 . . .
ALTER AUDITDUMP Commands and Responses ZTMF-MAP-Alter-AuditDump is an extensible structured token specifying the attributes of the audit dump process to be changed. This token is required; only one occurrence is allowed. This token contains the following fields: ZCopies for dumps to tape, specifies the number of copies made of each audit dump. The following values are valid: • • • If the value of ZCopies is ZTMF-VAL-ResetWord, the number of copies made is reset to 1.
ALTER AUDITDUMP Commands and Responses ZBlockSize for dumps to tape, sets the tape data block length, when multiplied by 1024 bytes. It is more efficient to use large data block lengths, but this is limited by the density in bits per inch (bpi) at which the tape drive writes tapes. The following values are valid; the default is 8: 4 Tape data block length of 4096 bytes (800 bpi); recommended. 8 Tape data block length of 8192 bytes (1600 bpi); recommended. 12 Tape data block length of 12288 bytes.
Commands and Responses ALTER AUDITDUMP ZSystemName2 for dumps to tape, specifies the name of the system on which the audit dump process performs automatic volume recognition (AVR) for the second parallel copy. If the value of ZSystemName2 is ZTMF-VAL-ResetSystemName2, the audit dump process performs AVR on the same system specified for ZSystemName. Tokens in Response Buffer ZTMF-TKN-DiskMediaString contains the name of the disk media in error. This token is returned only if an error is returned.
ALTER AUDITTRAIL Commands and Responses ALTER AUDITTRAIL 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 Commands and Responses Tokens in Command Buffer ZTMF-TKN-AuditTrailId specifies the audit trail to be altered. This token is required and must only appear once in the buffer. 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 . . . ZTMF-VAL-Aux015 Auxiliary audit trail #15 ZTMF-TKN-AddActiveVolume specifies a volume to be added to the active-audit volumes.
Commands and Responses ALTER AUDITTRAIL ZTMF-TKN-AddOverflowVolume specifies a volume to be added as an overflow volume for the audit trail. This token is optional; multiple occurrences are allowed but the total number of overflow volumes configured must not exceed 16. ZTMF-TKN-DelOverflowVolume specifies an overflow volume to be deleted. This token is optional; multiple occurrences are allowed.
ALTER AUDITTRAIL Commands and Responses If the number of files is decreased, the action taken varies. Any preallocated files on the active-audit volume are purged up to the point where each active volume contains the new number of files per volume. If an active-audit volume contains more files than allowed by the new value specified for this field, TMF purges them (rather than renaming them) when they are no longer needed.
ALTER AUDITTRAIL Commands and Responses ZMaxRetainedATFiles specifies the maximum number of restored audit-trail files to retain on disk in the RestoreVols for the specified audit trail after the restored audit-trail files are no longer being used by a recovery process. The minimum value is 1, the maximum 9999. ZFileSize32 specifies the size of the audit-trail files, in megabytes (MB).
ALTER AUDITTRAIL Commands and Responses ZTimeoutAction specifies the desired timeout action. The following values are valid: ZTMF-VAL-ZLTCH-ActionSuspend Suspend commit-hold mode for TMF. ZTMF-VAL-ZLTCH-ActionCrash Crash TMF. This field can only be specified for the MAT. This field is not valid if the ZCommitHoldTimer value is -1. Tokens in Response Buffer ZTMF-TKN-VolumeName contains the name of a volume that was in error, if an error is returned.
Commands and Responses ALTER AUDITTRAIL Usage Guidelines Only super-group users can issue this command. You can enter the ALTER AUDITTRAIL command at any time, whether or not TMF has been started, with the following exceptions: • • After TMF is configured and started for the first time, you can add or delete activeaudit volumes or alter AUDITDUMP to OFF only while TMF is started. You can issue the ALTER AUDITTRAIL, COMMITHOLDMODE SUSPEND command only while TMF is started.
ALTER BEGINTRANS Commands and Responses ALTER BEGINTRANS The ALTER BEGINTRANS command changes various options related to the automatic disabling and reenabling of transaction processing. 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-BeginTrans Tokens in Command Buffer ZTMF-MAP-Alter-BeginTrans def ZTMF-DDL-Alter-BeginTrans.
Commands and Responses ALTER BEGINTRANS Tokens in Command Buffer ZTMF-MAP-Alter-BeginTrans is an extensible structured token that contains fields for specifying the attributes of the BEGINTRANS object to be altered. Although this token is required, it can contain all null values; only one occurrence is allowed.
Commands and Responses ALTER BEGINTRANS ZTmpMemThresh specifies the lower and upper limits of the percentage of CPU memory allocated to the TMP’s extended segment at which TMF automatically disables and reenables new transactions. The first value is the lower limit. When the percent of CPU memory allocated to the TMP’s extended segment falls below this value, new transactions are reenabled. This value must be less than the second value.
Commands and Responses ALTER BEGINTRANS ZRecRmCount specifies the maximum number of recoverable resource managers that can be registered for the entire TMF system, which spans a single Expand node. The default value is 256. The minimum value is 16. The maximum value is 16384. The value specified is rounded up to the nearest multiple of 16. ZRmOpenPerCpu specifies the maximum number of resource managers, both recoverable and volatile, that can be opened per CPU. The default value is 128.
ALTER CATALOG Commands and Responses ALTER CATALOG The ALTER CATALOG command changes the configured attribute values of the catalog process that affect the management of online and audit dumps. 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-Catalog Tokens in Command Buffer ZTMF-MAP-Alter-Catalog def ZTMF-DDL-Alter-Catalog. 02 ZRetainDepth 02 ZReleased 02 ZRoundRobin end.
Commands and Responses ALTER CATALOG When the number of generations specified by ZRetainDepth is reached for all the files in an online dump, the status of the tape volume is changed to scratch if ZReleased is ZSPI-VAL-False, or to released if ZReleased is ZTMF-VALTrue. Increasing the value for ZRetainDepth causes the number of tape volumes required by TMF to increase, because more online dump generations are retained in the TMF catalog.
ALTER DATAVOLS Commands and Responses ALTER DATAVOLS The ALTER DATAVOLS command changes the configured attribute values of a data 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-DataVols Tokens in Command Buffer ZTMF-TKN-VolumeName ZSPI-TKN-MaxResp ZSPI-TKN-Context token-type ZSPI-TYP-String. token-type ZSPI-TYP-Int. token-type ZSPI-TYP-ByteString.
Commands and Responses ALTER DATAVOLS ZTMF-MAP-Alter-DataVols is an extensible structured token specifying the data volume attributes to be altered. This token is required; only one occurrence is allowed. This token contains the following field: ZRecoveryMode specifies whether audit trail files are held on disk until they are no longer required for volume recovery.
ALTER DUMPS Commands and Responses ALTER DUMPS The ALTER DUMPS command changes dump entries in the TMF catalog. 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-Dumps Tokens in Command Buffer ZTMF-TKN-FileName token-type ZSPI-TYP-String. ZTMF-MAP-Alter-Dumps def ZTMF-DDL-Alter-Dumps. 02 ZSerial 02 ZDumpInvalid 02 ZReleased end. token-type ZSPI-DDL-Int2.
ALTER DUMPS Commands and Responses ZTMF-MAP-Alter-Dumps is an extensible structured token specifying the attributes of the dump to be changed. This token is required; only one occurrence is allowed. This token contains the following fields: ZSerial specifies the dump serial number of the online dump to be changed. If this token is omitted, all generations of the dump are changed. ZDumpInvalid specifies whether a dump file is available for file recovery.
ALTER MEDIA Commands and Responses ALTER MEDIA The ALTER MEDIA command changes the configured attribute values of tape volumes. 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-Media Tokens in Command Buffer ZTMF-TKN-Media token-type ZTMF-TYP-MEDIA. ZTMF-MAP-Alter-Media def ZTMF-DDL-Alter-Media. 02 ZMedium 02 ZMediaStatus end. token-type ZSPI-DDL-Enum. token-type ZSPI-DDL-Enum.
Commands and Responses ALTER MEDIA ZMediaStatus specifies the status assigned to the media in the media catalog. The following values are valid: ZTMF-VAL-Assigned specifies that the tape volume contains valid dumps. Any tape volume specified becomes available for file recovery, provided that the file dumps contained on that volume have not been removed from the catalog. ZTMF-VAL-Bad specifies that the tape volume is defective and cannot be used later for dumping files or for file recovery.
ALTER PROCESS Commands and Responses ALTER PROCESS The ALTER PROCESS command changes the configured attribute values of various TMF processes. 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-Process Tokens in Command Buffer ZTMF-TKN-ProcessType ZTMF-TKN-Swap ZTMF-TKN-ExtFilename ZTMF-TKN-Term token-type token-type token-type token-type ZSPI-TYP-CrtPid. ZSPI-TYP-String.
ALTER PROCESS Commands and Responses Tokens in Command Buffer ZTMF-TKN-ProcessType specifies the TMF process for which the configuration attributes are to be changed. This token is optional; multiple occurrences are allowed. If this token is not present, all process types are altered.
ALTER PROCESS Commands and Responses ZTMF-MAP-Alter-Processes is an extensible structured token specifying the attributes of the process configuration that are to be changed. This token is optional; only one occurrence is allowed. This token contains the following fields: ZCpusInfo specifies from 1 to 16 different processors in which to run the process. See the struct ZTMF-TYP-CpusInfo under Private Token and Field Types in Section 4 of this manual.
ALTER PROCESS Commands and Responses ZSPI-VAL-False The process does not enter the DEBUG or INSPECT program soon after starting (unless other events cause this to happen). ZInspect determines which debugger the process enters soon after it starts. This field is only valid if ZDebug is ZSPI-VAL-True. The following value is valid: ZSPI-VAL-True The process enters the INSPECT program. ZSPI-VAL-False The process enters the DEBUG program.
Commands and Responses ALTER PROCESS ZTMF-TKN-ExtFilename specifies the name of the program file that runs for the process type. You must specify a local file name. This token is optional; only one occurrence is allowed. If the token is supplied and the length of the string is zero, the program file name is reset to the default program file, which is the normal program file from the current $System.SYSnn subvolume. ZTMF-TKN-Term specifies the name of the home terminal for the process.
ALTER TMF Commands and Responses ALTER TMF The ALTER TMF command changes configured attribute values of TMF. 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. ZTMF-MAP-Alter-Tmf def ZTMF-DDL-Alter-Tmf.
ALTER TMF Commands and Responses ZTMF-MAP-Alter-Tmf is an extensible structured token containing ALTER TMF command token values. This token contains the following fields: ZGoRemote specifies the method used to send GoRemote requests to the TMP to establish distributed transactions. The following values are valid: ZTMF-VAL-GoRemote-Pio Use PIOs. ZTMF-VAL-GoRemote-PioPri Use PIOs and put those requests ahead of transaction completions in the TMP queue. ZTMF-VAL-GoRemote-Msg Use the Message System.
ALTER TMF Commands and Responses ZTransProtocol determines the protocol that TMF uses to flush transactions upon their completion. The following values are valid: ZTMF-VAL-TransProto-MMI Specifies a potentially more efficient flush protocol than the standard protocol. For MMI, only the processors that are participating in a transaction are contacted during the transaction’s completion.
Commands and Responses CANCEL OPERATION CANCEL OPERATION The CANCEL OPERATION command cancels a specific TMF operation. Only dumpfile and recover-file operations can be cancelled. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below. Command ZTMF-CMD-Cancel Object Type ZTMF-OBJ-Operation Tokens in Command Buffer ZTMF-TKN-OperationNum token-type ZSPI-TYP-Int. Tokens in Response Buffer None.
CLOSE RESOURCEMANAGER Commands and Responses CLOSE RESOURCEMANAGER The CLOSE RESOURCEMANAGER command is an operator-initiated close (through TMFCOM) of a recoverable resource manager. After this command completes, the file system returns error 66 (FeDevDown) if a gateway process attempts to use the file number associated with the previous open of any of the closed resource managers.
Commands and Responses CLOSE RESOURCEMANAGER Names beginning with the string ZZ-VOLATILE- are reserved, and therefore not allowed for this command. Names containing adjoining hyphens (--) are not allowed, although names using multiple hyphens separated by one or more intervening characters are legal. Thus, the name “ALPHA--1” is not permitted, but “ALPHA-N-1” is allowed.
Commands and Responses DELETE CATALOG DELETE CATALOG The DELETE CATALOG command clears from the TMF catalog all online dump, audit dump, and media entries and resets to 64 the counter used for assigning dump serial numbers. Caution. Use extreme caution when issuing the DELETE CATALOG command, because this command removes TMF’s ability to recover your database from previously dumped files.
DELETE DATAVOLS Commands and Responses DELETE DATAVOLS The DELETE DATAVOLS command removes one or more data volumes from the TMF configuration. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below. Command ZTMF-CMD-Delete Object Type ZTMF-OBJ-DataVols Tokens in Command Buffer ZTMF-TKN-VolumeName ZSPI-TKN-MaxResp ZSPI-TKN-Context token-type ZSPI-TYP-String. token-type ZSPI-TYP-Int. token-type ZSPI-TYP-ByteString.
DELETE DATAVOLS Commands and Responses ZTMF-MAP-Delete-DataVols is an extensible structured token that modifies the behavior of the command. This token is required; only one occurrence is allowed. This token contains the following field: ZAllowInconsistency specifies whether the data volumes are to be deleted even if it is uncertain that they contain only consistent data. The following values are valid: ZSPI-VAL-True Potentially inconsistent data volumes are deleted.
DELETE DUMPS Commands and Responses DELETE DUMPS The DELETE DUMPS command removes dump entries from the TMF catalog and attempts to delete the associated dump files from disk. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below. Command ZTMF-CMD-Delete Object Type ZTMF-OBJ-Dumps Tokens in Command Buffer ZTMF-TKN-FileName token-type ZSPI-TYP-String. ZTMF-MAP-Delete-Dumps def ZTMF-DDL-Delete-Dumps.
DELETE DUMPS Commands and Responses Tokens in Command Buffer ZTMF-TKN-FileName specifies the name of the dump to be deleted from the catalog. This token is required; multiple occurrences and wild cards are allowed. ZTMF-MAP-Delete-Dumps is an extensible structured token specifying the serial numbers of the dumps to be changed. This token is required; only one occurrence is allowed. This token contains the following fields: ZSerial specifies the dump serial number of the dumps to be deleted.
DELETE MEDIA Commands and Responses DELETE MEDIA The DELETE MEDIA command removes tape-volume entries from the TMF catalog and also deletes the entries for dumps stored on the removed tape volumes. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below. Command ZTMF-CMD-Delete Object Type ZTMF-OBJ-Media Tokens in Command Buffer ZTMF-TKN-Media token-type ZTMF-TYP-Media. ZTMF-MAP-Delete-Media def ZTMF-DDL-Delete-Media.
DELETE MEDIA Commands and Responses Tokens in Command Buffer ZTMF-TKN-Media specifies the tape volume whose entries are to be deleted from the catalog; use the name magnetically encoded on the tape volume. ZTMF-MAP-Delete-Media is an extensible structured token specifying the type medium to be deleted. This token is required; only one occurrence is allowed. This token contains the following field: ZMedium specifies the type of storage media.
DELETE RESOURCEMANAGER Commands and Responses DELETE RESOURCEMANAGER The DELETE RESOURCEMANAGER command deletes a closed recoverable resource manager from the resource manager directory. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below. Command ZTMF-CMD-Delete Object Type ZTMF-OBJ-Rm Tokens in Command Buffer ZTMF-TKN-RmName ZSPI-TKN-Context token-type ZSPI-TYP-String. token-type ZSPI-TYP-ByteString.
Commands and Responses DELETE RESOURCEMANAGER Tokens in Command Buffer ZTMF-TKN-RmName specifies the name of the resource manager to be deleted. This token must appear at least once in the command buffer, and can appear multiple times to delete multiple resource managers. If multiple resource managers are being deleted by a single command, the result of the operation is returned in a separate response record for each resource manager name.
Commands and Responses DELETE RESOURCEMANAGER If the value specified for ZSPI-TKN-Context token is not valid, the error returned is ZTMF-ERR-InvalidContext. It is possible for TMF to discard the results of a command while they are still being retrieved by multiple requests with context. If that occurs, the error returned is ZTMFERR-ContextOutOfDate. In such a situation, it is possible that the command actually succeeded, but TMF discarded the results.
Commands and Responses DELETE TMF DELETE TMF The DELETE TMF command purges the entire TMF configuration, including volume and file recovery information for the database. Only tape media names are retained in the TMF catalog. This command, entered only when TMF is stopped, produces an empty configuration that has no audit trails and has default values for other configuration information. DELETE TMF is typically used to make major configuration changes.
DELETE TRANSACTION Commands and Responses DELETE TRANSACTION The DELETE TRANSACTION command forcibly removes a transaction from the system. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below. Command ZTMF-CMD-Delete Object Type ZTMF-OBJ-Transaction Tokens in Command Buffer ZTMF-TKN-TransID token-type ZSPI-TYP-TransID.
Commands and Responses DELETE TRANSACTION attempted to abort but could not; a committed transaction is one that successfully completed its changes to the database. (More about these and other transaction states appears in the STATUS TRANSACTIONS command description.) As an example, you can use a DELETE TRANSACTION command to remove a transaction that was hung by the backout process because of audit reading errors; in fact, you can only eliminate this transaction by forcibly removing it.
DISABLE AUDITDUMP Commands and Responses DISABLE AUDITDUMP The DISABLE AUDITDUMP command suspends an audit-dump process, preventing the dumping of audit trail files. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below. Command ZTMF-CMD-Disable Object Type ZTMF-OBJ-AuditDump Tokens in Command Buffer ZTMF-TKN-AuditTrailId token-type ZSPI-TYP-Enum. ZTMF-MAP-Disable-AuditDump def ZTMF-DDL-Disable-AuditDump.
DISABLE AUDITDUMP Commands and Responses ZTMF-MAP-Disable-AuditDump is an extensible structured token that modifies the behavior of the command. This token is required; only one occurrence is allowed. This token contains the following field: ZAbrupt specifies whether, when an audit-dump process is currently running, TMF aborts that process and discards the dump it is preparing. The following values are valid: ZSPI-VAL-True The audit-dump process is stopped before completion.
Commands and Responses DISABLE BEGINTRANS DISABLE BEGINTRANS The DISABLE BEGINTRANS command suspends transaction processing throughout the TMF system. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below. Command ZTMF-CMD-Disable Object Type ZTMF-OBJ-BeginTrans Tokens in Command Buffer None Tokens in Response Buffer None Usage Guidelines Only super-group users can issue this command. TMF must be started.
DISABLE DATAVOLS Commands and Responses DISABLE DATAVOLS The DISABLE DATAVOLS command shuts down transaction processing (audited updates) for the specified data volume and places this volume in the disabled state so that it is not automatically restarted by TMF. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below.
Commands and Responses DISABLE DATAVOLS Tokens in Command Buffer ZTMF-TKN-VolumeName specifies a data volume for which transaction processing is to be disabled. This token is required; multiple occurrences are allowed. ZTMF-MAP-Disable-DataVols is an extensible structured token that modifies the behavior of the command. This token is required; only one occurrence is allowed.
DUMP FILES Commands and Responses DUMP FILES The DUMP FILES command copies audited files to either tape or disk, producing online dumps. These online dumps might be used later if file recovery is initiated through a RECOVER FILES command. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below.
Commands and Responses DUMP FILES Tokens in Command Buffer ZTMF-TKN-Fileset specifies the name of an audited file to be dumped to tape or disk, or the name of a file of filenames (each filename in the specified file being the name of an audited file to be dumped). The name of a file of filenames must be enclosed within angle brackets (< and >), and it cannot contain wildcards. Each line in a file of filenames contains a vol-pattern.subvol-pattern.filenamepattern starting in the first column.
Commands and Responses DUMP FILES ZTMF-TKN-Media for dumps to tape, specifies the name of the tape volume on which the dump is to be stored. Specify the identifier magnetically encoded in the tape volume label and registered in the TMF catalog. Either ZTMF-TKN-Media or ZTMF-TKN-DiskMedia is required; multiple occurrences are allowed.
Commands and Responses DUMP FILES ZTMF-TKN-ExtFileName specifies the file at which the online dump begins. You can specify a wild card (*) in the file-name or subvolume fields, but not in the volume field. If you specify an asterisk in the file-name field, the dump starts at the beginning of the subvolume. If you specify an asterisk in the subvolume field, the dump starts at the beginning of the volume. To avoid dumping the entire database, you should specify a fully qualified file name.
DUMP FILES Commands and Responses ZBlockSize for dumps to tape, sets the tape data block length, when multiplied by 1024 bytes. It is more efficient to use large data block lengths, but this is limited by the density in bits per inch (bpi) at which the tape drive writes tapes. The following values are valid; the default is 8: 4 Tape data block length of 4096 bytes (800 bpi); recommended. 8 Tape data block length of 8192 bytes (1600 bpi); recommended. 12 Tape data block length of 12288 bytes.
DUMP FILES Commands and Responses ZMedium specifies the type of storage media on which this dump is recorded. This field is required. The following values are valid: ZTMF-VAL-MediumTape Tape storage media. ZTMF-VAL-MediumMagneticDisk Magnetic disk storage media. ZMaxDumpSize for dumps to disk, specifies the maximum size of the dump. Valid are in the range from 20x1024 bytes to 10x1024x1024 bytes. If this field is null, the default value is determined at run time by TMF.
ENABLE AUDITDUMP Commands and Responses ENABLE AUDITDUMP The ENABLE AUDITDUMP command permits an audit dump process to resume execution after it has been suspended by the DISABLE AUDITDUMP command, allowing the process to dump audit trail files once again. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below.
Commands and Responses ENABLE AUDITDUMP Usage Guidelines Only super-group users can issue this command. This command can be issued at any time, whether or not TMF has been started. However, the audit trail associated with the dump must be configured for dumping. If the specified audit trail is not configured for dumping, the ZTMF-ERR-ATNotDumping error is returned.
Commands and Responses ENABLE BEGINTRANS ENABLE BEGINTRANS The ENABLE BEGINTRANS command resumes transaction processing after it has been suspended by the DISABLE BEGINTRANS command. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below. Command ZTMF-CMD-Enable Object Type ZTMF-OBJ-BeginTrans Tokens in Command Buffer None. Tokens in Response Buffer None. Usage Guidelines Only super-group users can issue this command.
ENABLE DATAVOLS Commands and Responses ENABLE DATAVOLS The ENABLE DATAVOLS command reenables transaction processing (audited updates) for the specified data volumes, and makes them subject to automatic restart by TMF. If the data volumes specified are accessible, they are restarted immediately. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below.
Commands and Responses ENABLE DATAVOLS ZTMF-TKN-NotVolumeName specifies the name of a disk volume that is not to be added to the TMF configuration as a data volume. This token is optional; multiple occurrences are allowed. This token is often used with a wild-card value for ZTMF-TKN-VolumeName to exclude certain volumes from being reenabled. It can also be used with an explicit list of volumes. Tokens in Response Buffer ZTMF-TKN-VolumeName specifies the data volume(s) specified in the command buffer.
INFO ATDUMPDM Commands and Responses 5 Commands and Responses INFO ATDUMPDM The INFO ATDUMPDM command returns all the disk media attributes for an audit dump process. 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-ATDumpDM Tokens in Command Buffer ZTMF-TKN-AuditTrailId ZSPI-TKN-MaxResp ZSPI-TKN-Context token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Int.
Commands and Responses INFO ATDUMPDM Tokens in Response Buffer ZTMF-TKN-AuditTrailId specifies the audit trail for which the disk media attributes are returned in ZTMFTKN-DiskMediaString. ZTMF-TKN-DiskMediaString contains one disk media attribute. If multiple disk media attributes are configured for the audit trail, they are each returned in a separate response record. Usage Guidelines Any user can issue this command. You can enter this command at any time, whether or not TMF has been started.
INFO ATVOLUME Commands and Responses INFO ATVOLUME The INFO ATVOLUME command returns the volumes configured for a specific audit trail. 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-ATVolume Tokens in Command Buffer ZTMF-TKN-AuditTrailId ZSPI-TKN-ATVolumeType ZSPI-TKN-MaxResp ZSPI-TKN-Context token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum.
INFO ATVOLUME Commands and Responses ZTMF-TKN-ATVolumeType specifies the volume types for which the names are to be returned. This is an optional token; multiple occurrences are allowed. If null, then volumes of all types are returned. If specified multiple times using different values, volumes of all the types specified are returned.
Commands and Responses INFO ATVOLUME Usage Guidelines Any user can issue this command. You can enter this command at any time, whether or not TMF has been started. Multiple response records are allowed to enable the command to return all the requested information.
INFO AUDITDUMP Commands and Responses INFO AUDITDUMP The INFO AUDITDUMP command returns the configured attribute values of audit dump processes. 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-AuditDump Tokens in Command Buffer ZTMF-TKN-AuditTrailId token-type ZSPI-TYP-Enum. Tokens in Response Buffer ZTMF-TKN-AuditTrailId token-type ZSPI-TYP-Enum.
INFO AUDITDUMP Commands and Responses Tokens in Command Buffer ZTMF-TKN-AuditTrailId specifies the audit trail associated with the audit dump process whose attributes are 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 AUDITDUMP Commands and Responses ZVerifyTape specifies whether tape verification is performed after a tape is written. The following values are possible: ZSPI-VAL-True Tapes are verified ZSPI-VAL-False Tapes are not verified ZBlockSize specifies the length of tape data blocks. ZUnloadMedia specifies whether the tape is unloaded after the dump process finishes writing to the tape.
INFO AUDITTRAIL Commands and Responses INFO AUDITTRAIL 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.
INFO AUDITTRAIL Commands and Responses 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 Commands and Responses ZAuditDump specifies 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 specifies the percentage of active audit-trail capacity above which TMF begins overflow copying. ZBeginTransDisable specifies the percentage of active audit-trail capacity that can be consumed before new transactions are disabled.
INFO AUDITTRAIL Commands and Responses ZCommitHoldTimer specifies the maximum time to stay in activated commit-hold mode, in seconds. This field contains a nonzero value only for the MAT; for auxilliary audit trails it is always NULL. Values can range from 5 to 86400. The value -1 specifies infinite. ZTimeoutAction specifies the action to take when the commit-hold timer expires. The following values are valid: ZTMF-VAL-ZLTCH-ActionSuspend Suspend commit-hold condition.
INFO BEGINTRANS Commands and Responses INFO BEGINTRANS The INFO BEGINTRANS command returns the configured attribute values for the BEGINTRANS object that disables and reenables transaction processing. 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-BeginTrans Tokens in Command Buffer None. Tokens in Response Buffer ZTMF-MAP-Info-BeginTrans def ZTMF-DDL-Info-BeginTrans.
Commands and Responses INFO BEGINTRANS Tokens in Response Buffer ZTMF-MAP-Info-BeginTrans is an extensible structured token containing the attributes of the BeginTrans object. This token contains the following fields: ZTransCountThresh specifies the upper and lower limits at which the number of active transactions in the system automatically disables or reenables new transactions. The first number is the lower limit, below which new transactions are reenabled.
Commands and Responses INFO BEGINTRANS ZRecRmCountCurr specifies the maximum number of recoverable resource managers that can be registered for the entire TMF system, which spans a single Expand node. This value is the current value under which the subsystem is running. ZRecRmCountConfig specifies the maximum number of recoverable resource managers that can be registered for the entire TMF system, which spans a single Expand node.
INFO CATALOG Commands and Responses INFO CATALOG The INFO CATALOG command returns the configured attribute values for the catalog process. 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-Catalog Tokens in Command Buffer None. Tokens in Response Buffer ZTMF-MAP-Info-Catalog def ZTMF-DDL-Info-Catalog. 02 ZRetainDepth 02 ZReleased 02 ZRoundRobin 02 ZLastReel end.
INFO CATALOG Commands and Responses Tokens in Response Buffer ZTMF-MAP-Info-Catalog is an extensible structured token containing the attributes of the catalog process. This token contains the following fields: ZRetainDepth specifies the number of online dump generations retained in the catalog. ZReleased specifies the status to which online or audit tape volumes are set after all dumps on the volumes are marked for deletion.
INFO DATAVOLS Commands and Responses INFO DATAVOLS The INFO DATAVOLS command returns the configured attribute values of data volumes, and can also filter and then return volumes based on selected configuration attributes. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below.
INFO DATAVOLS Commands and Responses Tokens in Command Buffer ZTMF-TKN-VolumeName specifies the data volume whose attribute values are to be displayed. This token must occur at least once; multiple occurrences are allowed. ZTMF-TKN-VolumeName can also contain a wild card (value “*”, length 1). If the wild card is specified, it must be the only instance of this token in the command buffer. The wild card specifies that configuration information is returned for all data volumes.
Commands and Responses INFO DATAVOLS Tokens in Response Buffer ZTMF-TKN-VolumeName specifies the name of the data volume. This token can appear multiple times. Each occurrence is included in a data list with ZTMF-MAP-Info-DataVols-R. ZTMF-MAP-Info-DataVols-R is an extensible structured token containing the attributes of the specified data volume. This token contains the following fields: ZAuditTrailId specifies the audit trail for which the disk volumes are configured to send audits.
INFO DUMPS Commands and Responses INFO DUMPS The INFO DUMPS command returns online and audit dump entries in the TMF catalog. 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-Dumps Tokens in Command Buffer ZTMF-TKN-Fileset ZTMF-TKN-NotFileset ZTMF-TKN-ExtFilename ZTMF-TKN-VolumeName ZTMF-TKN-FilesetDefault ZTMF-MAP-Info-Dumps def ZTMF-DDL-Info-Dumps.
INFO DUMPS Commands and Responses Tokens in Response Buffer ZTMF-MAP-Info-Dumps def ZTMF-DDL-Info-Dumps. 02 ZName 02 ZSerial 02 ZDumpType 02 ZMasterSequence 02 ZDataSequence 02 ZDumpStatus 02 ZMediaStatus 02 ZSortSelect 02 ZTimeStamp 02 ZSystemNumber 02 ZMedia 02 ZMedium 02 ZDiskMedia end. token-type token-type token-type token-type token-type token-type token-type token-type token-type token-type token-type token-type token-type ZSPI-DDL-DiscName. ZSPI-DDL-Int2. ZSPI-DDL-Enum. ZSPI-DDL-Int2.
Commands and Responses INFO DUMPS ZTMF-TKN-NotFileset specifies the name of an audited file for which information is not desired, or the name of a file of filenames (each filename in the specified file being the name of an audited file for which information is not desired). The name of a file of filenames must be enclosed within angle brackets (< and >), and it cannot contain wildcards. Each line in a file of filenames contains a vol-pattern.subvol-pattern.filenamepattern starting in the first column.
INFO DUMPS Commands and Responses ZTMF-MAP-Info-Dumps is an extensible structured token specifying the selection criteria for the dumped files you want to retrieve. This token is required; only one occurrence is allowed. One record is returned for each dump media entry in the dump catalog. This token contains the following fields: ZName specifies the file name to search for; wildcards are allowed. If ZTMF-TKNFileSet is present, then ZName must be Null.
INFO DUMPS Commands and Responses ZDumpStatus specifies the dump status to search for. The following values are valid: ZTMF-VAL-Assigned The tape volume contains valid dumps ZTMF-VAL-Released The contents of the tape volume is not required for file recovery ZTMF-VAL-Invalid The tape volume cannot be used for file recovery If you omit this field, the default is all three. ZMediaStatus This field is not valid for command buffers.
Commands and Responses INFO DUMPS Tokens in Response Buffer ZTMF-MAP-Info-Dumps is an extensible structured token containing the attributes of the selected dumps. This token contains the following fields: ZName specifies the file name of the online dump or audit dump that met the selection criteria in the command buffer. ZSerial specifies the serial number of the dump. ZDumpType specifies the type of dump (online or audit).
INFO DUMPS Commands and Responses ZSystemNumber specifies the number of the system where the online dump was made, and is used for converting the ZTimeStamp field. ZMedia specifies the name of the tape volume on which the dump is located. See the struct ZTMF-DDL-Media under Private Token and Field Types in Section 4 of this manual. The Z-PartNumber and Z-CopyNumber fields are used. ZMedium specifies the type of storage media used for the dump.
INFO MEDIA Commands and Responses INFO MEDIA The INFO MEDIA command returns the configured attribute values of tape volumes. 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-Media Tokens in Command Buffer ZTMF-TKN-Media token-type ZTMF-TYP-Media. ZTMF-MAP-Info-Media def ZTMF-DDL-Info-Media. 02 ZMediaName 02 ZMedium 02 ZMediaStatus end. token-type ZTMF-DDL-Media.
INFO MEDIA Commands and Responses Tokens in Command Buffer ZTMF-TKN-Media specifies the name of a tape volume for which the configured values are to be returned. To specify all media, set name to “* “ (that is, an asterisk followed by four spaces), partnumber to -1, and copynumber to -1. ZTMF-MAP-Info-Media is an extensible structured token specifying the attributes that are to be used in selecting the tape volumes about which information is to be returned.
Commands and Responses INFO MEDIA Tokens in Response Buffer ZTMF-MAP-Info-Media is an extensible structured token containing the attributes of the selected tape volumes. This token contains the following fields: ZMediaName specifies the name of the tape volume that met the selection criteria in the command buffer. See the struct ZTMF-DDL-Media under Private Token and Field Types in Section 4 of this manual. The Z-PartNumber and Z-CopyNumber fields are not used. ZMedium specifies the type of storage media.
INFO PROCESS Commands and Responses INFO PROCESS The INFO PROCESS command returns the configured attribute values for the major TMF processes. 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-Process Tokens in Command Buffer ZTMF-TKN-ProcessType token-type ZSPI-TYP-CRTPID. Tokens in Response Buffer ZTMF-TKN-Swap ZTMF-TKN-ExtFilename ZTMF-TKN-Term token-type ZSPI-TYP-String.
INFO PROCESS Commands and Responses Tokens in Command Buffer ZTMF-TKN-ProcessType specifies the TMF process for which the configuration attributes are to be returned. This token is optional; multiple occurrences are allowed. If this token is not present, information about all process types is returned.
INFO PROCESS Commands and Responses Tokens in Response Buffer ZTMF-TKN-Swap specifies the swap volume for the data and extended segments of the process. This token is optional; multiple occurrences are possible. If it appears multiple times, each instance is included within a data list for the process type. ZTMF-TKN-ExtFilename specifies the name of the program file that runs for the process type. This token is optional; multiple occurrences are possible.
INFO PROCESS Commands and Responses ZDebug specifies whether the process enters the DEBUG or INSPECT program soon after it starts. The following values are possible: ZSPI-VAL-True The process enters DEBUG or INSPECT soon after starting ZSPI-VAL-False The process does not enter DEBUG or INSPECT If this field is null, the value is ZSPI-VAL-False. ZInspect specifies which debugger the process enters soon after it starts. This field is only valid if ZDebug is ZSPI-VAL-True.
INFO RESOURCEMANAGER Commands and Responses INFO RESOURCEMANAGER The INFO RESOURCEMANAGER command returns the entries for recoverable resource managers currently registered in the resource manager directory. 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-Rm Tokens in Command Buffer ZTMF-TKN-RmName ZSPI-TKN-MaxResp ZSPI-TKN-Context token-type ZSPI-TYP-String.
Commands and Responses INFO RESOURCEMANAGER Tokens in Command Buffer ZTMF-TKN-RmName specifies the name of a resource manager for which information is to be returned from the resource manager directory. This token can appear multiple times in the command buffer to obtain information for multiple resource managers. If this token is omitted from the command buffer, information is returned for all resource managers that are currently registered.
Commands and Responses INFO RESOURCEMANAGER Usage Guidelines Anyone can issue this command. TMF must be started for this command to execute successfully. If TMF has not been started, the error returned is ZTMF-ERR-TmfNotStarted. If the value specified for ZTMF-TKN-RmName is not a valid resource manager name, the error returned is ZTMF-ERR-InvRmName. If the specified resource manager name is not registered in the directory, the error returned is ZTMF-ERR-RmNameNotFound.
INFO TMF Commands and Responses INFO TMF 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 Command Buffer None. Tokens in Response Buffer ZSPI-TKN-VolumeName ZSPI-TKN-ATFileFormat token-type ZSPI-TYP-String. token-type ZSPI-TYP-Int.
INFO TMF Commands and Responses Tokens in Response Buffer ZTMF-TKN-VolumeName specifies the current TMF configuration volume. ZTMF-TKN-ATFileFormat specifies the current audit-trail file format. A value of 1 indicates format 1. A value of 2 indicates format 2. ZTMF-MAP-Info-Tmf is an extensible structured token containing INFO TMF command token values.
Commands and Responses INFO TMF 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.
LIST AUDITTRAIL Commands and Responses LIST AUDITTRAIL The LIST AUDITTRAIL command returns a list of all the configured audit-trail identifiers in a single, simplified request—without all the detail for each audit-trail. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below. Command ZTMF-CMD-List Object Type ZTMF-OBJ-AuditTrail Tokens in Command Buffer None.
Commands and Responses LIST AUDITTRAIL Usage Guidelines Any user can issue this command. You can enter this command at any time, whether or not TMF has been started. All ZTMF-TKN-AuditTrailId tokens are returned in a single response record. The number of tokens returned depends upon the number of audit trails configured.
NEXT AUDITTRAIL Commands and Responses NEXT AUDITTRAIL The NEXT AUDITTRAIL command changes audit-trail files for a specified audit trail; it stops new audit records from being added to the current audit-trail file and establishes the next file in the audit-trail sequence as the current audit-trail file. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below.
RECOVER FILES Commands and Responses RECOVER FILES The RECOVER FILES command initiates file recovery: restoring a database to a consistent state by means of online dumps and audit dumps. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below.
Commands and Responses RECOVER FILES Tokens in Command Buffer ZTMF-TKN-Fileset specifies the name of an audited file to be recovered, or the name of a file of filenames (each filename in the specified file being the name of an audited file to be recovered). This token can also contain a wild card (value asterisk (*), length 1). If the wild card is specified, the token must be the only instance of this token in the command buffer.
Commands and Responses RECOVER FILES ZTMF-TKN-MapNameSet specifies the map-names list exactly as it would be presented to TMFCOM in a RECOVER FILES command, including the “MAP NAMES”. For example, this token might contain: “MAP NAMES ($TMF.*.* TO $DATA.*.*)” This token is optional; only one occurrence is allowed.
Commands and Responses RECOVER FILES ZTMF-TKN-FilesetDefault contains the defaults to be used if any entry within a file of filenames is not fully qualified. This token is required if either the ZTMF-TKN-Fileset or ZTMF-TKN-NotFileset token contains the name of a file of filenames. ZTMF-MAP-Recover-Files is an extensible structured token that contains parameters for performing file recovery. This token is required; only one occurrence is allowed.
Commands and Responses RECOVER FILES ZToFirstPurge specifies at what point the recovery operation should end. ZSPI-VAL-True File recovery terminates when the first audit record for purging any file in the specified file sets is encountered; the purge record is not reapplied. ZSPI-VAL-False File recovery does not terminate early based on a purge record. If you omit this field, its default value is ZSPI-VAL-False.
RECOVER FILES Commands and Responses ZUnloadMedia specifies whether the tape volume is unloaded after it has been used. The following values are valid: ZSPI-VAL-True Tapes are unloaded after use ZSPI-VAL-False Tapes are not unloaded after use If you omit this field, the default is ZSPI-VAL-True.
Commands and Responses RECOVER FILES ZRecoverToRba For use in Recover Files ToMatPosition. The rba at which the recover files will end. If you include ZRecoverToRba, you must make new online dumps of the database files recovered; this prevents subsequent file recovery from using the unwanted audit records generated after the specified time. If the ZRecoverToSeq field is specified, the value of the ZRecoverToRba field must not be null. ZSerial The dumpserial number from which to select dumps.
RELOCATE DISKDUMPS Commands and Responses RELOCATE DISKDUMPS The RELOCATE DISKDUMPS command changes the disk media locations for TMF catalog entries. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below. Command ZTMF-CMD-Relocate Object Type ZTMF-OBJ-DiskDumps Tokens in Command Buffer ZTMF-TKN-DumpSerial ZTMF-TKN-OldDmLoc ZTMF-TKN-NewDmLoc token-type ZSPI-DDL-Int2. token-type ZTMF-TYP-String. token-type ZTMF-TYP-String.
Commands and Responses RELOCATE DISKDUMPS ZTMF-TKN-NEWDMLOC specifies the new system name and volume name of the disk media to be stored in the TMF catalog. The system name is optional; if it is not included, the local system name is used. This token is required; only one occurrence is allowed; a wild card value is allowed. Tokens in Response Buffer ZSPI-TKN-RetCode is the standard SPI return token described in the SPI Programming Manual. ZSPI-TKN-ErrList specifies the reason RELOCATE DISKDUMPS failed.
Commands and Responses RELOCATE DISKDUMPS ZTMF-ERR-InvalidDumpSerial The command failed because the value specified for DumpSerial was neither the wild value nor a value higher than 63. ZTMF-ERR-OnlyOneOldDmLoc The command failed because there was more than one occurrence of the ZTMF-TKN-OldDMLoc token in the input buffer. ZTMF-ERR-OnlyOneNewDmLoc The command failed because there was more than one occurrence of the ZTMF-TKN-NewDmLoc token in the input buffer.
Commands and Responses RESOLVE TRANSACTION RESOLVE TRANSACTION The RESOLVE TRANSACTION command causes an unresolved distributed transaction to either commit or back out its changes. To fully resolve the transaction, this command must be issued on all nodes on which the transaction resides, except for the transaction’s home node. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below.
RESOLVE TRANSACTION Commands and Responses Tokens in Command Buffer ZTMF-MAP-Resolve-Transaction is an extensible structured token describing how the distributed transaction is to be resolved. This token is required; only one occurrence is allowed. This token contains the following field: ZState specifies the target state for the unresolved transaction. This field is required.
START TMF Commands and Responses START TMF The START TMF command starts TMF transaction processing. Specifically, START TMF starts audit-trail service and data volumes, resolves network transactions, cleans up transactions that were active when TMF last went down, and initiates new transactions. The command returns a response as soon as TMF has accepted it, but probably not before the operation has finished. The state of TMF can be checked by using the Status TMF command.
START TMF Commands and Responses Tokens in Command Buffer ZTMF-MAP-Start-Tmf is an extensible structured token that modifies the behavior of the command. This token is required; only one occurrence is allowed. This token contains the following field: ZTransAllowOption specifies whether new transactions are allowed immediately after TMF is started.
Commands and Responses • START TMF The START TMF command fails if one of the following conditions occur: • • • • • • • • The master audit trail is not configured. A wild card audit trail is not configured. An audit trail has not been defined for a disk process. An audit trail requires an audit dump process that has not been configured. An audit dump process is configured but is not required by any audit trail.
STATUS ATFILE Commands and Responses STATUS ATFILE The STATUS ATFILE command returns the current status of audit-trail files. This command is designed for use with the STATUS AUDITTRAIL command to get the complete status of an audit trail. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below.
STATUS ATFILE Commands and Responses Tokens in Command Buffer ZTMF-TKN-AuditTrailId specifies an audit trail for which status information about all of its files is to be returned. This token is required; only one occurrence is 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 . . . ZTMF-VAL-Aux015 Auxiliary audit trail #15 The value ZTMF-VAL-WildAuditTrailId is not valid in this command.
Commands and Responses STATUS ATFILE ZTMF-VAL-ATFilePreallocated specifies preallocated files. These files are placeholders used to guarantee that disk space configured for the audit trail is not consumed by other applications. Preallocated files are made into active files as audit-trail space is consumed. Preallocated files are used in preference to available files when a new audit file is needed in the audit trail. ZTMF-VAL-ATFileOverflow specifies overflow files.
Commands and Responses STATUS ATFILE ZTMF-VAL-DumpStatusDumping specifies a file in the process of being copied to archive media by the AUDITDUMP process, or a file that is next to be dumped. ZTMF-VAL-DumpStatusDumped specifies a file that has been copied to archive media by the AUDITDUMP process. ZTMF-VAL-DumpStatusNotDumped specifies a file that is not the current file: therefore, no additional audit trails can be written to it.
Commands and Responses STATUS ATFILE Usage Guidelines Any user can issue this command. TMF must be started. Multiple response records are allowed to enable the command to return all the requested information. If an audit trail is altered to turn AUDITDUMP on after some audit-trail files have been filled, those files are never dumped. When AUDITDUMP is turned on, the first file to be dumped is the one that is current at the time of the ALTER command.
Commands and Responses STATUS AUDITDUMP STATUS AUDITDUMP The STATUS AUDITDUMP command returns the current status of audit dump processes. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below. Command ZTMF-CMD-Status Object Type ZTMF-OBJ-AuditDump Tokens in Command Buffer ZTMF-TKN-AuditTrailId token-type ZSPI-TYP-Enum.
STATUS AUDITDUMP Commands and Responses Tokens in Command Buffer ZTMF-TKN-AuditTrailId specifies the audit trail associated with the audit dump process whose status 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 . . .
STATUS AUDITDUMP Commands and Responses ZTMF-MAP-Status-AuditDump is an extensible structured token containing the status of the audit dump process. This token contains the following fields: ZActive specifies whether the dump process is currently dumping an audit-trail file. The following values are possible: ZSPI-VAL-True The audit dump process is currently dumping an audit-trail file. ZSPI-VAL-False The audit dump process is not currently dumping an audit-trail file.
STATUS AUDITTRAIL Commands and Responses STATUS AUDITTRAIL The STATUS AUDITTRAIL command returns the current status of audit trails. This command is designed for use with the STATUS ATFILE command to get the complete status of an audit trail. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below.
STATUS AUDITTRAIL Commands and Responses Tokens in Command Buffer ZTMF-TKN-AuditTrailId specifies the audit trail about which status 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 . . .
STATUS AUDITTRAIL Commands and Responses ZTMF-MAP-Status-AuditTrail is an extensible structured token containing information about the current state of the active audit trail. This token contains the following fields: ZOverflowInUse specifies whether the overflow space for the audit trail is currently in use. The following values are possible: ZSPI-VAL-True The overflow space is currently in use. ZSPI-VAL-False The overflow space is currently not in use.
STATUS AUDITTRAIL Commands and Responses Value (ZTMF-VAL- ) Description HeldRsnOldTransExists At least one active transaction might have sent an audit record to this audit-trail file. The audittrail file remains on the active or overflow-audit volume in case the transaction aborts, in which case the file is needed by the backout process. HeldRsnVolumeDown The volume on which the audit-trail file resides is down, so TMF cannot perform the operation needed to release the file.
STATUS AUDITTRAIL Commands and Responses ZCommitHoldTime This value is valid only when ZCommitHold is “activate” or “reviving.” The value specifies the time at which the specified audit trail went into its current state. ZCommitHoldVol This value is valid only when ZCommitHold is “activate” or “reviving.” The value specifies the name of the audit-trail volume that encountered the problem causing the audit trail to go into this state.
Commands and Responses STATUS BEGINTRANS STATUS BEGINTRANS The STATUS BEGINTRANS command returns the current status of TMF transaction processing, indicating whether this feature is enabled or disabled. If transaction processing is disabled, STATUS BEGINTRANS reports all reasons why the disability exists. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below.
STATUS BEGINTRANS Commands and Responses Tokens in Response Buffer ZTMF-MAP-Status-BeginTrans is an extensible structured token describing why BEGINTRANSACTION is currently disabled. This token appears once in each response record. This token contains the following fields: ZDisableCount specifies the number of reasons BEGINTRANSACTION is currently disabled. If this value is 0, BEGINTRANSACTION is enabled.
STATUS BEGINTRANS Commands and Responses ZDisableLibMem is an array of Booleans that can occur 16 times. The ith element of the array specifies whether BEGINTRANSACTION is disabled because TMFLIB in the CPU is running out of memory. The following values are possible: ZSPI-VAL-True The reason for the disable is true. ZSPI-VAL-False The reason for the disable is false. ZDisableTmpMem is an array of Booleans that can occur 16 times.
STATUS CATALOG Commands and Responses STATUS CATALOG The STATUS CATALOG command returns the current activity of the catalog process. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below. Command ZTMF-CMD-Status Object Type ZTMF-OBJ-Catalog Tokens in Command Buffer None. Tokens in Response Buffer ZTMF-MAP-Status-Catalog def ZTMF-DDL-Status-Catalog. 02 ZCatalogStatus end. token-type ZSPI-DDL-Enum.
STATUS CATALOG Commands and Responses Tokens in Response Buffer ZTMF-MAP-Status-Catalog is an extensible structured token containing the current activity of the catalog process. This token contains the following field: ZCatalogStatus specifies the current state of the catalog. The following values are possible: ZTMF-VAL-Down The catalog is down and unavailable. ZTMF-VAL-Active TMF is working on the catalog, perhaps adding, altering, or deleting entries; the catalog is temporarily unavailable.
STATUS DATAVOLS Commands and Responses STATUS DATAVOLS The STATUS DATAVOLS command returns the current status of data volumes. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below. Command ZTMF-CMD-Status Object Type ZTMF-OBJ-DataVols Tokens in Command Buffer ZTMF-TKN-VolumeName ZSPI-TKN-MaxResp ZSPI-TKN-Context token-type ZSPI-TYP-String. token-type ZSPI-TYP-Int. token-type ZSPI-TYP-ByteString.
Commands and Responses STATUS DATAVOLS Tokens in Command Buffer ZTMF-TKN-VolumeName specifies the data volume for which status information is to be returned. This token must occur at least once; multiple occurrences are allowed. ZTMF-TKN-VolumeName can also contain a wild card (value “*”, length 1). If the wild card is specified, it must be the only instance of this token in the command buffer. The wild card specifies that status information is to be returned for all data volumes.
Commands and Responses STATUS DATAVOLS ZTMF-VAL-DVS-AwaitTransResolve specifies configured data volumes that are being restarted, where the restart is waiting for the resolution of transactions that may have modified data on the volume. The subsystem must be notified of the outcome (commit or abort) of these transactions before these volumes can take part in recovery.
Commands and Responses STATUS DATAVOLS ZTMF-VAL-DVS-Down-Dirty specifies configured volumes that are inaccessible, perhaps because of device or process problems, but for which normal shutdown processing did not complete successfully. A volume enters the downdirty state if it is down (or goes down) during shutdown, or if data volume startup fails for any reason. When TMF cannot determine whether a volume is clean, the subsystem assumes that it is dirty.
STATUS DATAVOLS Commands and Responses ZTMF-VAL-DVS-WrongDiskMuted specifies volumes for which the physical disk does not match the one configured for TMF (even though the volume name is the same). ZAuditTrailId specifies the audit trail associated with the data volumes for which status information is to be returned. 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 . . .
Commands and Responses STATUS DATAVOLS ZTMF-MAP-Status-DataVols-R is an extensible structured token containing status information for the specified data volume. This token contains the following fields: ZState specifies the state of the data volume. ZRecoveryMode specifies the recovery mode setting (either online or archive). Usage Guidelines Any user can issue this command. TMF must be started or in the process of stopping.
STATUS OPERATION Commands and Responses STATUS OPERATION The STATUS OPERATION command returns the status of TMF operations that were recently completed or are now in progress. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below. Command ZTMF-CMD-Status Object Type ZTMF-OBJ-Operation Tokens in Command Buffer ZTMF-TKN-OperationNum token-type ZSPI-TYP-Int. ZTMF-MAP-Status-Operations def ZTMF-DDL-Status-Operations.
STATUS OPERATION Commands and Responses Tokens in Command Buffer ZTMF-TKN-OperationNum specifies an integer that uniquely identifies the operation for which status information is to be displayed. This is an optional token; multiple occurrences are allowed. If null, then status information about all operations is returned.
STATUS OPERATION Commands and Responses ZState specifies the state of operations for which information is to be returned. The following values are valid: ZTMF-VAL-InProgress Operations in progress ZTMF-VAL-Finished Completed operations ZTMF-VAL-All All operations, whether in progress or completed If null, the default is ZTMF-VAL-InProgress. ZBeginTime specifies the earliest start time (GMT) of the operations to display.
Commands and Responses STATUS OPERATION Usage Guidelines Any user can issue this command. You can enter this command at any time, whether or not TMF has been started. The operation numbers generated are re-used, to keep the number of digits to just one or two as an aid in remembering these numbers; after the highest number allowed (100) is assigned, the subsystem returns to the lowest possible number (1) to identify the next operation.
STATUS RESOURCEMANAGER Commands and Responses STATUS RESOURCEMANAGER The STATUS RESOURCEMANAGER command returns the current status of recoverable and volatile resource managers that are present in TMF. To specify particular resource managers by name, include one or more RmName tokens (wildcards are not permitted). To specify resource managers opened by particular gateway processes, include one or more ZTMF-TKN-ProcessName or ZTMF-TKN-CPUPIN tokens.
Commands and Responses STATUS RESOURCEMANAGER Tokens in Response Buffer ZTMF-TKN-RmName ZSPI-TKN-Context token-type ZSPI-TYP-String. token-type ZSPI-TYP-ByteString. ZTMF-MAP-Status-Rm-Rsp def ZTMF-DDL-Status-Rm-Rsp 02 ZState 02 ZProcessPhandl end. token-type ZSPI-DDL-Enum. token-type ZSPI-DDL-Phandle. Tokens in Command Buffer ZTMF-TKN-RmName specifies the name of the resource manager for which status is to be returned.
Commands and Responses STATUS RESOURCEMANAGER ZTMF-TKN-CPUPIN specifies the CPU number and process identification number (PIN) of the gateway process that currently has the resource manager open. This is an optional token. Multiple occurrences in the command buffer are allowed. If the value of this token is null, TMF returns status for all resource managers that are currently opened by any gateway process.
Commands and Responses STATUS RESOURCEMANAGER Tokens in Response Buffer ZTMF-TKN-RmName specifies a resource manager name that was specified in the command buffer. ZTMF-MAP-Status-Rm-Rsp is an extensible structured token containing the current status of the resource manager. This is an optional token. This token contains the following fields: ZState specifies the status of the resource manager.
Commands and Responses STATUS RESOURCEMANAGER ZProcessPhandl specifies the process handle of the gateway process that currently has the resource manager open. If the resource manager is not open, recovering, or volatile, this field has a null value. Usage Guidelines Anyone can issue this command. There is no requirement that TMF be started for this command to execute successfully. If TMF is not started, however, status information is returned only for volatile resource managers.
STATUS RMTRANSBRANCHES Commands and Responses STATUS RMTRANSBRANCHES The STATUS RMTRANSBRANCHES command returns data about each of the outstanding transaction branches handled for the specified recoverable resource managers. This programmatic command provides the same functionality as the DETAIL option of the TMFCOM STATUS RESOURCEMANAGER command. One ZTMF-TKN-RmName token and ZTMF-TKN-TransID token is returned for each transaction branch.
Commands and Responses STATUS RMTRANSBRANCHES Tokens in Command Buffer ZTMF-TKN-RmName specifies the name of the resource manager whose status is to be returned. This token must appear only once in the command buffer. Resource manager names can have a maximum length of 128 characters.
Commands and Responses STATUS RMTRANSBRANCHES ZTMF-VAL-RmTrBrStatePrepared the transaction branch is prepared for commitment, but the final commit or abort decision has not yet been made or has not yet been communicated to the child. ZTMF-VAL-RmTrBrStateReadOnly the transaction branch is read-only. ZTMF-VAL-RmTrBrStateIrrelev the transaction branch is irrelevant. ZTMF-VAL-RmTrBrStateCommitted the transaction branch has committed, but not all subordinates have yet been notified of the commit.
Commands and Responses STATUS RMTRANSBRANCHES If the value specified for the ZSPI-TKN-Context token is not valid, the error returned is ZTMF-ERR-InvalidContext. It is possible for TMF to discard the results of a command while they are still being retrieved by multiple requests with context. If that occurs, the error returned is ZTMFERR-ContextOutOfDate. In such a situation, it is possible that the command actually succeeded, but TMF discarded the results.
STATUS TMF Commands and Responses STATUS TMF The STATUS TMF command returns the current activity of TMF. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below. Command ZTMF-CMD-Status Object Type ZTMF-OBJ-Tmf Tokens in Command Buffer None. Tokens in Response Buffer ZTMF-MAP-Status-Tmf def ZTMF-DDL-Status-Tmf.
Commands and Responses STATUS TMF Tokens in Response Buffer ZTMF-MAP-Status-Tmf is an extensible structured token containing the status information for TMF. This token contains the following fields: ZSystemName specifies the local system name. ZSystemNumber specifies the number of the local system. ZSystemTime specifies the local system time (GMT). ZTmfState specifies the state of TMF.
STATUS TMF Commands and Responses ZTMF-VAL-TmfState-Deleting TMF is purging its current configuration, audit trails, and volume and file recovery information for the database in response to a DELETE TMF command. ZStartingState specifies detailed starting state information. The following values are possible: ZTMF-VAL-Starting-Services TMF is starting audit-trail service and other services. ZTMF-VAL-Starting-DataVol TMF is starting data volumes.
STATUS TMF Commands and Responses ZHungTrans specifies whether a hung transaction exists. The following values are possible: ZSPI-VAL-True Hung transactions exist. ZSPI-VAL-False There are no hung transactions. ZTransactionRate specifies the current TMF transaction rate in hundredths of a transaction per second. For example, a value of 300 specifies 3 transactions per second. ZCommitHold specifies the current status of commit-hold for TMF.
Commands and Responses STATUS TMF Usage Guidelines Any user can issue this command. You can enter this command at any time, whether or not TMF has been started.
Commands and Responses STATUS TMFSERVER STATUS TMFSERVER The STATUS TMFSERVER command returns status and other information about the currently open TMFSERVE process. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below. Command ZTMF-CMD-Status Object Type ZTMF-OBJ-TmfServer Tokens in Command Buffer None. Tokens in Response Buffer ZTMF-MAP-Status-TmfServer def ZTMF-DDL-Status-TmfServer.
Commands and Responses STATUS TMFSERVER ZProcessName specifies the process name and process ID of the TMFSERVE process, obtained from the GETCRTPID procedure. Only used when communicatng with an unenlightened server. ZCreatorAccessID specifies the user ID of the person who created the TMFSERVE process. ZProcessAccessID specifies the user ID of the person now using the TMFSERVE process. ZTimeStamp specifies the current GMT timestamp on the node on which the TMFSERVE process is running.
STATUS TMFSERVER Commands and Responses ZPinIsPresent specifies whether the value of ZPIN is valid for the system issuing the Status TMFSERVER command. The following values are possible: ZSPI-VAL-True The value of ZPIN is valid. ZSPI-VAL-False The value of ZPIN is not valid. ZPIN specifies the PIN of the TMFSERVE process. Used when communicating with an enlightened server. ZServerName specifies the process name of the TMFSERVE process. Used when communicating with an enlightened server.
STATUS TRANSACTION Commands and Responses STATUS TRANSACTION The STATUS TRANSACTION command returns transaction identifiers and status. This command and the STATUS TRANSACTIONCHILDREN command are together equivalent to the TMFCOM STATUS TRANSACTION command. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below.
Commands and Responses STATUS TRANSACTION Tokens in Command Buffer ZTMF-TKN-TransID specifies the transaction identifier for which status information is to be returned. This is an optional token; multiple occurrences are allowed. If null, then all transactions are returned. If specified multiple times with different values, the specified transactions are returned. ZTMF-TKN-ProcessName specifies the name of the process that originated (executed the BEGIN TRANSACTION statement for) the transaction.
Commands and Responses STATUS TRANSACTION ZTMF-VAL-Aborted specifies transactions that have been aborted. A transaction enters this state when all of its effects are undone and the ABORTTRANSACTION record is written to the audit trail. A transaction normally stays in this state only briefly.
STATUS TRANSACTION Commands and Responses ZTMF-VAL-Status-TransIDOnly Only the transaction identifier of the selected transactions is returned. This option is useful when you only need to list the transactions that match your selection criteria. ZTMF-VAL-Status-Normal Normal information is returned. If you omit this field, normal information is returned. Tokens in Response Buffer ZTMF-TKN-TransID specifies the transaction identifier. Each transaction is returned in a separate response record.
Commands and Responses STATUS TRANSACTION ZProcessPhandl specifies the ID of the process where the transaction began. This field is valid only if ZState has the value ZTMF-VAL-Active or ZTMF-VAL-Ending. If ZDistributed has the value ZSPI-VAL-True, then this field is returned only for the home system of the transaction (if it is in an active or ending state). ZParentName specifies the Expand node name of the parent node for a distributed transaction.
Commands and Responses STATUS TRANSACTION ZTMF-VAL-TransAbrtDpInterr The transaction aborted because of an internal disk process error. ZTMF-VAL-TransAbrtDoubleCpu The transaction aborted because of a double-CPU failure. ZTMF-VAL-TransAbrtByNetwork The transaction aborted because of a network failure. ZTMF-VAL-TransAbrtBySql The transaction was aborted by the NonStop SQL/MP subsystem. ZTMF-VAL-TransAbrtByOper The transaction aborted because an operator issued an ABORT Transaction command.
Commands and Responses STATUS TRANSACTION TMF must be started for this command to execute successfully. If TMF is not started, the error returned is ZTMF-ERR-TmfNotStarted. Multiple response records are allowed to enable the command to return all the requested information. For more information about the STATUS TRANSACTION command, see the TMF Reference Manual.
STATUS TRANSACTIONCHILDREN Commands and Responses STATUS TRANSACTIONCHILDREN The STATUS TRANSACTIONCHILDREN command returns the nodes in a network that participate in a network-distributed transaction. This command and the STATUS TRANSACTION command are together equivalent to the TMFCOM STATUS TRANSACTION command. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below.
Commands and Responses STATUS TRANSACTIONCHILDREN Tokens in Response Buffer ZTMF-TKN-RmName specifies the name of the resource manager to which the transaction branch was exported. If the transaction branch was not exported to a resource manager, this token is omitted from the response record. ZTMF-TKN-ChildBranchNum specifies the branch number of the export. Note that the branch number is only unique during the lifetime of a START TMF or an individual gateway process’ open of the resource manager.
STOP TMF Commands and Responses STOP TMF The STOP TMF command shuts down TMF, terminating transaction processing and issuing EMS event messages for the stop operation as it progresses. The command returns as soon as TMF has accepted it, but probably not before the operation has finished. Caution. If multiple users are managing your TMF system, be sure to communicate your intentions to stop or restart the subsystem.
Commands and Responses STOP TMF Tokens in Command Buffer ZTMF-MAP-Stop-Tmf is an extensible structured token that modifies the behavior of the command. This token is required; only one occurrence is allowed. This token contains the following field: ZAbrupt specifies whether the TMF system is shut down immediately. The following values are valid: ZSPI-VAL-True Terminates all TMF activities immediately, basically causing the subsystem to crash.
Commands and Responses HP NonStop TMF Management Programming Manual—540140-002 5 -204 STOP TMF
6 Event Messages The Event Management Service (EMS) receives and logs information about important events that occur in a system or network, and it distributes this information to allow operations personnel or software to respond to the events.
Unconditional Tokens Event Messages Unconditional Tokens The following unconditional tokens are always present in an event message and are described below. Additional TMF-specific unconditional tokens are described in the message in which they appear.
Conditional Tokens Event Messages ZEMS-TKN-PROC-DESC is a standard EMS token. See the EMS Manual for a description of this token. ZEMS-TKN-NodeName is a standard EMS token. See the EMS Manual for a description of this token. ZEMS-TKN-NODENUM is a standard EMS token. See the EMS Manual for a description of this token. ZEMS-TKN-USERID is a standard EMS token. See the EMS Manual for a description of this token. ZTMF-TKN-EVTHDR is a dummy token present in all TMF events.
Obtaining TMF Event Messages Event Messages ZTMF-VAL-STOPTMF ZTMF-VAL-VOLUMERECOVERY ZTMF-TKN-EVTHDR-OPERATIONNUM if present, contains an integer uniquely associated with the specified operation type. This token is present only when the ZTMF-TKN-EVTHDROPERATIONTYPE token is also present. ZTMF-TKN-EVTHDR-PROCINSTNUM if present, contains an integer identifying, in the case of multiple occurrences of the specified process, which particular process generated the event.
TMP Event Messages Event Messages ZTMF-VAL-PROC-COPYAUDITOVFLOW ZTMF-VAL-PROC-FILERECOVERY ZTMF-VAL-PROC-FILERECOVLIST ZTMF-VAL-PROC-ONLINEDUMP ZTMF-VAL-PROC-ONLINERESTORE ZTMF-VAL-PROC-RESMON ZTMF-VAL-PROC-TMFLIB ZTMF-VAL-PROC-TMFMON2 ZTMF-VAL-PROC-TMP ZTMF-VAL-PROC-VOLUMERECOVERY TMP Event Messages The TMF event messages that are reported by the transaction management process (TMP) are listed and described in Table 6-1. Table 6-1.
TMP Event Messages Event Messages Table 6-1.
TMP Event Messages Event Messages Table 6-1.
TMP Event Messages Event Messages Table 6-1. TMP Event Messages (page 4 of 7) Event # Symbolic Name (ZTMFEVT-) 153 ATOvSameVolErr Audit trail overflow failed because a preallocated file could not be created.
TMP Event Messages Event Messages Table 6-1.
TMP Event Messages Event Messages Table 6-1. TMP Event Messages (page 6 of 7) Event # Symbolic Name (ZTMFEVT-) 297 DownNode Network transaction aborted because there was no reply from the remote node. 298 AlterDisconnect Operator attempted to set the autoabort timer value lower than the configured disconnect timer interval. 299 AlterDisconnectTimer Operator used SNOOP to set a new disconnect timer value.
TMP Event Messages Event Messages Table 6-1.
TMFMON Event Messages Event Messages TMFMON Event Messages The TMF event messages that are reported by the TMF monitor processes (RESMON and TMFMON2) are listed and described in Table 6-2. Table 6-2.
Recovery Event Messages Event Messages Table 6-3.
Recovery Event Messages Event Messages Table 6-3.
TMF Dump/Restore Event Messages Event Messages Table 6-3.
TMF Catalog Event Messages Event Messages Table 6-4.
Event-Management Programming for TMF Event Messages Table 6-5.
Console Printing Event Messages SSGETTKN procedure with the ZSPI-TKN-USEDLEN token. Event messages always begin on a word boundary for odd unstructured files. Note. Information in TMF event messages is encoded in individual tokens; TMF event messages do not use structured tokens. Console Printing TMF uses the CONSOLE-PRINT token (ZEMS-TKN-CONSOLE-PRINT), which recommends that the event message be processed by the compatibility distributor. For more information about this token, see the EMS Manual.
Descriptions of Event Messages Event Messages 74: ZTMF-EVT-TmpWhenCanIAuditErr The TMF management process (TMP) was ready to write audit information to the specified active-audit volume, but could not because a file-system error occurred. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-VolumeName ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number. Try to restart TMF.
Descriptions of Event Messages Event Messages 75: ZTMF-EVT-MatWriteAdpBadState TMF attempted to write audit information to the specified active-audit volume, but could not because the volume is in an invalid state. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-VolumeName ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean. Event-Message Text ADP volume ZTMF-TKN-VolumeName is in an invalid state for receiving audit. Crashing TMF.
Descriptions of Event Messages Event Messages 76: ZTMF-EVT-TmfShutdown TMF has shut down. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text TMF Shutdown Timestamp ZEMS-TKN-GENTIME. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType identifies the TMF process that generated the event. For this event, the value of this token is ZTMF-VAL-PROC-TMP. ZEMS-TKN-Emphasis is set to True for this event.
Descriptions of Event Messages Event Messages 77: ZTMF-EVT-TmpFlushAdpError TMF tried to flush audit information from a buffer to the specified active-audit volume, but could not because a file-system error occurred. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-VolumeName ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number. Try to restart TMF.
Descriptions of Event Messages Event Messages 78: ZTMF-EVT-Tx-Abort-ProcFail The process that started the specified transaction failed. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-TransID ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-TransID. token-type ZSPI-TYP-Boolean. Event-Message Text Aborting transaction ZTMF-TKN-TransID, the process that started the transaction failed.
Descriptions of Event Messages Event Messages 79: ZTMF-EVT-TmpSendAuditError TMF tried to write audit information to the specified active-audit volume, but could not because a file-system error occurred. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-VolumeName ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number. Try to restart TMF.
Descriptions of Event Messages Event Messages 80: ZTMF-EVT-ATFileFixupError As part of subsystem startup, TMF attempted to repair the end of file (EOF) marker of the specified audit trail file, but could not because a file-system error occurred. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditFileName ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number. Try to restart TMF.
Descriptions of Event Messages Event Messages 81: ZTMF-EVT-ATDisallowStartup An operator or subsystem control program (SPI requester) issued a Start TMF command, but TMF cannot start because of problems with an audit trail. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text TMF cannot be started due to problems with the audit trails.
Descriptions of Event Messages Event Messages 82: ZTMF-EVT-ATFileAndVolDontMatch While attempting to access the specified audit trail file, TMF detected that the status code in the file label is inconsistent with the type of TMF volume on which the file resides. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditFileName ZTMF-TKN-ATFileStatus ZTMF-TKN-VolumeName ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Enum.
Descriptions of Event Messages Event Messages Effect TMF crashes.
Descriptions of Event Messages Event Messages 83: ZTMF-EVT-ATFileAttrInvalid While attempting to access the specified audit trail file, TMF detected that the specified file attribute, stored in the file label, is invalid. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditFileName ZTMF-TKN-FileAttrCode ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Enum. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Recommended Action Contact your service provider and provide all relevant information as follows: • • • Descriptions of the problem and accompanying symptoms Details from the message(s) generated Supporting documentation such as Event Management Service (EMS) logs, trace files, and a CPU dump, if applicable If your local operating procedures require contacting the Global Customer Support Center (GCSC), supply your system number and the numbers and versions
Descriptions of Event Messages Event Messages 84: ZTMF-EVT-ATFileCorrupt While attempting to access the specified audit trail file, TMF detected that the file is corrupt. 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-Message Text Audit Trail File ZTMF-TKN-AuditFileName is corrupt.
Descriptions of Event Messages Event Messages 85: ZTMF-EVT-ATFileFsError A file-system error prevented TMF from accessing the specified audit trail file. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditFileName ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int. ZSPI-TYP-Boolean. Event-Message Text File System Error ZTMF-TKN-Fs-Error occurred when accessing audit trail file ZTMF-TKN-AuditFileName.
Descriptions of Event Messages Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number. Try to resolve the problem and restart TMF.
Descriptions of Event Messages Event Messages 86: ZTMF-EVT-ATFileInitSeqnumInv While attempting to access an audit trail file, TMF detected that the audit trail file has an invalid initialization sequence number in its file label. 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.
Descriptions of Event Messages Event Messages 87: ZTMF-EVT-AudInfoErr A file-system error prevented TMF from accessing the audit information (AUDINFO) file, which is located in the $SYSTEM.ZTMFCONF subvolume. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Int. token-type ZSPI-TYP-Boolean. Event-Message Text File System Error ZTMF-TKN-Fs-Error occurred accessing the AUDINFO file.
Descriptions of Event Messages Event Messages 88: ZTMF-EVT-CantAdjustFilesPerVol An operator or subsystem control program (SPI requester) issued an ALTER AUDITTRAIL command changing the number of files-per-volume, but TMF could not do so on the specified volume because a file-system error occurred. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-VolumeName ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int.
Descriptions of Event Messages Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number. Try to resolve the problem and reissue the command.
Descriptions of Event Messages Event Messages 89: ZTMF-EVT-CantOpenAuditFile While TMF was attempting to open an audit trail file, a file-system error occurred. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditFileName ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int. ZSPI-TYP-Boolean. Event-Message Text Audit Trail File ZTMF-TKN-AuditFileName cannot be opened due to File System Error ZTMF-TKN-Fs-Error.
Descriptions of Event Messages Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number. Try to resolve the problem and restart TMF.
Descriptions of Event Messages Event Messages 90: ZTMF-EVT-CantTalkToAdp A file-system error prevented TMF from performing an operation to the disk process for the specified active-audit volume. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-VolumeName ZTMF-TKN-Fs-Error ZTMF-TKN-AdpOpCode ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int. ZSPI-TYP-Enum. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Effect TMF crashes. Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number. Try to resolve the problem and restart TMF.
Descriptions of Event Messages Event Messages 91: ZTMF-EVT-CantUndoAddAT An operator or subsystem control program (SPI requester) issued an ADD AUDITTRAIL command, but the command failed and some of its effects could not be undone. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Recommended Action Attempt to determine why the command failed. Delete TMF and add all the audit trails again.
Descriptions of Event Messages Event Messages 92: ZTMF-EVT-CantUndoAlterAT An operator or subsystem control program (SPI requester) issued an ALTER AUDITTRAIL command, but the command failed and some of its effects could not be undone. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Recommended Action Issue an INFO AUDITTRAIL command to determine the content of the current configuration. If you can ascertain what the problem is, issue an ALTER AUDITTRAIL command to fix it.
Descriptions of Event Messages Event Messages 93: ZTMF-EVT-FileTransitionErr A file-system error prevented TMF from performing an operation on the specified audittrail file. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditFileName ZTMF-TKN-Fs-Error ZTMF-TKN-ATFileTRANS ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int. ZSPI-TYP-Enum. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Effect TMF crashes. Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number. Try to resolve the problem and restart TMF.
Descriptions of Event Messages Event Messages 94: ZTMF-EVT-NoActiveATFiles As part of subsystem startup, TMF could not find any audit-trail files on the configured active-audit volume(s) for the specified audit trail. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text TMF could not find any Active audit trail files for the ZTMF-TKN-AuditTrailID Audit Trail.
Descriptions of Event Messages Event Messages Recommended Action Contact your service provider and provide all relevant information as follows: • • • Descriptions of the problem and accompanying symptoms Details from the message(s) generated Supporting documentation such as Event Management Service (EMS) logs, trace files, and a CPU dump, if applicable If your local operating procedures require contacting the Global Customer Support Center (GCSC), supply your system number and the numbers and versions
Descriptions of Event Messages Event Messages 95: ZTMF-EVT-NoATRestoreVols As part of subsystem startup, the specified audit trail is configured for audit dumping, but has no configured restore-audit volumes. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Effect TMF does not start. Recommended Action Configure at least one restore-audit volume for the specified audit trail and then try to restart TMF.
Descriptions of Event Messages Event Messages 96: ZTMF-EVT-ATAdded An operator or subsystem control program (SPI requester) issued an ADD AUDITTRAIL command, defining the specified audit trail as indicated in the message.
Descriptions of Event Messages Event Messages ZTMF-TKN-ATOvThresh is the configured OVERFLOWTHRESHOLD attribute value. ZTMF-TKN-ATBTDisable is the configured BEGINTRANSDISABLE attribute value. ZTMF-TKN-AuditDump is the configured AUDITDUMP attribute value. Possible values for this token are: ZSPI-VAL-True ZSPI-VAL-False Effect None. Recommended Action Informative message only; no corrective action is needed.
Descriptions of Event Messages Event Messages 97: ZTMF-EVT-ATAlterFPV An operator or subsystem control program (SPI requester) issued an ALTER AUDITTRAIL command, redefining the FILESPERVolume attribute as shown in the message. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-ATFilesPerVol ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 98: ZTMF-EVT-ATAlterOvThresh An operator or subsystem control program (SPI requester) issued an ALTER AUDITTRAIL command, redefining the OVERFLOWTHRESHOLD attribute as indicated in the message. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-ATOvThresh ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 99: ZTMF-EVT-ATAlterBTDisable An operator or subsystem control program (SPI requester) issued an ALTER AUDITTRAIL command, redefining the BEGINTRANSDISABLE attribute as indicated in the message. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-ATBTDisable ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 100: ZTMF-EVT-ATAlterAuditDump An operator or subsystem control program (SPI requester) issued an ALTER AUDITTRAIL command, redefining the AUDITDUMP attribute as indicated in the message. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-AuditDump ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Effect The new AUDITDUMP attribute value takes effect immediately. Recommended Action Informative message only; no corrective action is needed.
Descriptions of Event Messages Event Messages 101: ZTMF-EVT-ATVolAdd An operator or subsystem control program (SPI requester) issued an ALTER AUDITTRAIL command, adding the specified disk volume to the specified audit trail as indicated in the message. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-VolumeName ZTMF-TKN-ATVolumeType ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-String.
Descriptions of Event Messages Event Messages Effect The disk volume is added to the audit trail as the specified type. Recommended Action Informative message only; no corrective action is needed.
Descriptions of Event Messages Event Messages 102: ZTMF-EVT-ATVolDel An operator or subsystem control program (SPI requester) issued an ALTER AUDITTRAIL command, deleting the specified disk volume from the specified audit trail as indicated in the message. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-VolumeName ZTMF-TKN-ATVolumeType ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-String.
Descriptions of Event Messages Event Messages Effect The disk volume is deleted from the audit trail as the specified type. Recommended Action Informative message only; no corrective action is needed.
Descriptions of Event Messages Event Messages 103: ZTMF-EVT-ATVolHasExtraFiles A file-system error occurred while TMF was purging one or more files on the specified active-audit volume. As a result, the volume might have unwanted audit-trail files on it. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-VolumeName ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number.
Descriptions of Event Messages Event Messages 104: ZTMF-EVT-ATVolHasInvFile TMF detected an invalid type of file in the ZTMFAT subvolume on the designated active-audit volume. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-VolumeName ZTMF-TKN-AuditFileName ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-String. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Recommended Action Try moving or deleting the offending file from the ZTMFAT subvolume. Alternatively, choose a different volume to hold audit-trail files.
Descriptions of Event Messages Event Messages 105: ZTMF-EVT-ATNoOvVols The designated audit trail has no overflow-audit volumes. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text The ZTMF-TKN-AuditTrailID Audit Trail does not have any Overflow volumes configured.
Descriptions of Event Messages Event Messages 106: ZTMF-EVT-NoATConfigured An operator or subsystem control program (SPI requester) issued a Start TMF command without having configured any audit trails. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text There are no audit trails configured.
Descriptions of Event Messages Event Messages 107: ZTMF-EVT-ATFsFindStartErr A file-system error prevented TMF from performing a FIND_Start_ operation for the designated file. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditFileName ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number. Try to resolve the problem and restart TMF.
Descriptions of Event Messages Event Messages 108: ZTMF-EVT-ATFSFindNextErr A file-system error prevented TMF from performing a FIND_NExt_ operation for the designated file. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditFileName ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number. Try to resolve the problem and restart TMF.
Descriptions of Event Messages Event Messages 109: ZTMF-EVT-ATCantRoll TMF was attempting to prepare the next audit-trail file for a rollover, but could not because there were no available files. This message begins an action event that is completed by ZTMF-EVT-ATROLLOK (110). Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Effect Transaction processing eventually stops if an audit-trail file does not become available. Recommended Action If the audit-trail files are pinned on the disk because audit dumping is disabled, you could reenable audit dumping to free up some files. You also could issue an ALTER AUDITTRAIL command to add another active-audit volume or to increase the FILESPERVolume attribute value.
Descriptions of Event Messages Event Messages 110: ZTMF-EVT-ATRollOK TMF found an available audit-trail file, and the rollover was successful. This message completes the action event initiated by a preceding ZTMF-EVT-ATCANTROLL (109) message. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Effect Transaction processing continues. Recommended Action Informative message only; no corrective action is needed.
Descriptions of Event Messages Event Messages 111: ZTMF-EVT-ATRollStopped While TMF was waiting for an audit-trail file to become available, an operator or subsystem control program (SPI requester) issued a STOP TMF command. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 112: ZTMF-EVT-ATRollover The audit trail rolled over from the previous audit-trail file to the designated one. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-AuditFileName ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Boolean. Event-Message Text The ZTMF-TKN-AuditTrailID Audit Trail rolled over into file ZTMF-TKN-AuditFileName.
Descriptions of Event Messages Event Messages 113: ZTMF-EVT-ATVolCameUp The designated audit-trail volume, which was down, has come back up. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-VolumeName ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean. Event-Message Text Volume ZTMF-TKN-VolumeName, which is configured for an Audit Trail, has come up.
Descriptions of Event Messages Event Messages 114: ZTMF-EVT-ATVolWentDown The designated audit-trail volume is down. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-VolumeName ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean. Event-Message Text Volume ZTMF-TKN-VolumeName, which is configured for an Audit Trail, has gone down.
Descriptions of Event Messages Event Messages Recommended Action If you can, bring the volume back up. If the volume contains no files, or is a restoreaudit volume, try deleting it from the TMF configuration and adding another disk volume in its place.
Descriptions of Event Messages Event Messages 115: ZTMF-EVT-ATFileNotFound When its volume came up, the specified audit-trail file was missing. 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-Message Text The Audit Trail File ZTMF-TKN-AuditFileName was expected to exist when its volume came up, but it does not.
Descriptions of Event Messages Event Messages 116: ZTMF-EVT-ATFilesOutOfOrder While attempting to start TMF, or when a configured active-audit volume comes up, a series of audit-trail files (beginning with the designated file) was out of sequence. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-AuditFileName ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Recommended Action Contact your service provider and provide all relevant information as follows: • • • Descriptions of the problem and accompanying symptoms Details from the message(s) generated Supporting documentation such as Event Management Service (EMS) logs, trace files, and a CPU dump, if applicable If your local operating procedures require contacting the Global Customer Support Center (GCSC), supply your system number and the numbers and versions
Descriptions of Event Messages Event Messages 117: ZTMF-EVT-ATVolisDown The designated audit-trail volume is down. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-VolumeName ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean. Event-Message Text The Audit Trail Volume ZTMF-TKN-VolumeName is currently down and may be adversely affecting audit trail performance.
Descriptions of Event Messages Event Messages Recommended Action If you can, bring the volume back up. If the volume contains no files, or is a restoreaudit volume, try deleting it from the TMF configuration and adding another disk volume in its place.
Descriptions of Event Messages Event Messages 118: ZTMF-EVT-TmpFormat2ATFile 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-Message Text Audit Trail File ZTMF-TKN-AuditFileName is a Format 2 file.
Descriptions of Event Messages Event Messages 120: ZTMF-EVT-StartingTmf This message, generated when TMF is starting, states which configuration volume the subsystem is using. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZSPI-TKN-ConfigVol ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean. Event-Message Text Starting TMF, using ZSPI-TKN-ConfigVol as the configuration volume.
Descriptions of Event Messages Event Messages 121: ZTMF-EVT-TmfStarted An operator or subsystem control program (SPI requester) issued a Start TMF command. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text TMF is started. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType is the subject token of the event message, and it identifies the TMF process that generated the event.
Descriptions of Event Messages Event Messages 122: ZTMF-EVT-StoppingTmf An operator or subsystem control program (SPI requester) issued a STOP TMF command. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text Stopping TMF. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType is the subject token of the event message, and it identifies the TMF process that generated the event.
Descriptions of Event Messages Event Messages 123: ZTMF-EVT-TmfStopped An operator or subsystem control program (SPI requester) issued a STOP TMF command. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text TMF Stopped. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType is the subject token of the event message, and it identifies the TMF process that generated the event.
Descriptions of Event Messages Event Messages 124: ZTMF-EVT-ProcConfigFsError A file-system error prevented TMF from performing the designated operation on the specified configuration file. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-ProcConfigFileName ZTMF-TKN-Command ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int. ZSPI-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages ZTMF-TKN-Fs-Error contains an integer identifying the file-system error that occurred. ZEMS-TKN-Emphasis is set to True for this event. Effect The TMF management process (TMP) cannot be created. If the error occurs after the TMP is started, the TMP abends because it cannot create other TMF processes. Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number.
Descriptions of Event Messages Event Messages 125: ZTMF-EVT-ProcFailActionAttn The specified TMF process could not be started, or it failed, because a file-system error occurred. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-ProcessName ZTMF-TKN-ProcessType ZTMF-TKN-ProcCompCode ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Enum. ZSPI-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages ZEMS-TKN-Emphasis is set to True for this event. Effect The TMF management process (TMP) attempts to recreate the TMF process, at incremental time intervals of up to five minutes, until the process is successfully started. Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number.
Descriptions of Event Messages Event Messages 126: ZTMF-EVT-ProcFailActionCmpl This is an action completion event associated with event message 125. It is generated each time the TMF management process (TMP) attempts to recreate the failed TMF process. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-ProcessName ZTMF-TKN-ProcessType ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Enum. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Effect The TMP attempts to recreate the TMF process, at incremental time intervals of up to five minutes, until the process is successfully started. Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the file-system error number specified in the preceding 125 message.
Descriptions of Event Messages Event Messages 127: ZTMF-EVT-WrongProcConfigVerNum While attempting to start the specified process, TMF found that the configuration record for the process had the wrong version number. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-ProcConfigFileName ZTMF-TKN-ProcessType ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Enum. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Effect The process cannot be started.
Descriptions of Event Messages Event Messages 128: ZTMF-EVT-DV-DisableCommand An operator or subsystem control program (SPI requester) issued a DISABLE DATAVOL command, disabling the specified data volume for transaction processing. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-VolumeName ZTMF-TKN-Abrupt ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Boolean. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 129: ZTMF-EVT-DV-DisableDownForTmf The specified data volume went down for TMF transaction processing. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-VolumeName ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean. Event-Message Text Data volume ZTMF-TKN-VolumeName unexpectedly went bad-down for TMF. The volume will be disabled. See the DP2 Event (5012) for more information.
Descriptions of Event Messages Event Messages 130: ZTMF-EVT-DV-Added An operator or subsystem control program (SPI requester) issued an ADD DATAVOL command, successfully adding the specified volume to the TMF configuration as a data volume. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-VolumeName ZTMF-TKN-AuditTrailID ZTMF-TKN-RecoveryMode ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Enum. ZSPI-TYP-Enum.
Descriptions of Event Messages Event Messages Effect The volume is configured as a TMF data volume and remains as such until it is explicitly deleted (DELETE DATAVOL command) or until the entire TMF configuration is deleted (DELETE TMF command). Recommended Action Informative message only; no corrective action is needed.
Descriptions of Event Messages Event Messages 131: ZTMF-EVT-DV-Started The specified data volume has been started for transaction processing. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-VolumeName ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean. Event-Message Text Data volume ZTMF-TKN-VolumeName started for transaction processing.
Descriptions of Event Messages Event Messages 132: ZTMF-EVT-DV-Altered An operator or subsystem control program (SPI requester) issued an ALTER DATAVOL command, changing the specified data volume’s attribute values as indicated in the message. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-VolumeName ZTMF-TKN-AuditTrailID ZTMF-TKN-RecoveryMode ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Enum. ZSPI-TYP-Enum.
Descriptions of Event Messages Event Messages Effect The new attribute values take effect immediately. Recommended Action Informative message only; no corrective action is needed.
Descriptions of Event Messages Event Messages 133: ZTMF-EVT-DV-Shutdown The specified data volume was shut down along with stopping TMF. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-VolumeName ZTMF-TKN-DVDirtyFlag ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int. ZSPI-TYP-Boolean. Event-Message Text Data Volume ZTMF-TKN-VolumeName shut down ZTMF-TKNDVDirtyFlag as part of STOP TMF.
Descriptions of Event Messages Event Messages 134: ZTMF-EVT-DV-C The specified data volume has been disabled by an operator or subsystem control program (SPI requester) issuing a DISABLE DATAVOL command or by an unexpected failure. This event message is always preceded in the EMS log by another event (128, 129, 137, or 139), which specifies why the volume was disabled. A separate event is generated for each volume specified in a DISABLE DATAVOL command.
Descriptions of Event Messages Event Messages 135: ZTMF-EVT-DV-Enabled An operator or subsystem control program (SPI requester) issued an ENABLE DATAVOL command, enabling the specified data volume. A separate event is generated for each volume specified in an ENABLE DATAVOL command. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-VolumeName ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 136: ZTMF-EVT-DV-Deleted An operator or subsystem control program (SPI requester) issued a DELETE DATAVOL command, successfully deleting the specified data volume from the TMF configuration. A separate event is generated for each volume specified in a DELETE DATAVOL command. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-VolumeName ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 137: ZTMF-EVT-DV-StartRejected The specified data volume could not be started for transaction processing because a file-system error occurred. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-VolumeName ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number.
Descriptions of Event Messages Event Messages 138: ZTMF-EVT-DV-WrongVolisUp The physical disk drive is not the one TMF expected to find with the specified volume name. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-VolumeName ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean. Event-Message Text The version or mirror of Data Volume ZTMF-TKN-VolumeName that is currently mounted conflicts with the TMF configuration.
Descriptions of Event Messages Event Messages 139: ZTMF-EVT-DV-DisableRecovFail The specified data volume failed to start due to a fatal error during volume recovery. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-VolumeName ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean. Event-Message Text Data Volume ZTMF-TKN-VolumeName failed to start due to a fatal error during Volume Recovery. The volume will be disabled.
Descriptions of Event Messages Event Messages 140: ZTMF-EVT-StartTmfFailed An operator or subsystem control program (SPI requester) issued a Start TMF command, but TMF would not start. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text Start TMF failed. Executing a STOP TMF, Abrupt.
Descriptions of Event Messages Event Messages 141: ZTMF-EVT-DeletingTmf An operator or subsystem control program (SPI requester) issued a DELETE TMF command. The current TMF configuration is being deleted. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text Deleting the TMF configuration.
Descriptions of Event Messages Event Messages 142: ZTMF-EVT-TakeoverKillsStart An operator or subsystem control program (SPI requester) issued a Start TMF command, but TMF would not start because the primary TMF management process (TMP) failed. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text Start TMF terminated by failure of the Primary TMP. Executing a STOP TMF, Abrupt.
Descriptions of Event Messages Event Messages 143: ZTMF-EVT-TmfDeleted An operator or subsystem control program (SPI requester) issued a DELETE TMF command. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text DELETE TMF has been performed. The TMF configuration, all audit trails, and all audit-dumps and online-dumps have been deleted.
Descriptions of Event Messages Event Messages 144: ZTMF-EVT-BackupTmpFailed The primary TMF management process (TMP) failed, and the backup TMP either could not be started or also failed. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-ProcCompCode ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Int. token-type ZSPI-TYP-Boolean. Additional Conditional Tokens ZTMF-TKN-Fs-Error ZTMF-TKN-PROCCOMPTExt token-type ZSPI-TYP-Int. token-type ZSPI-TYP-String.
Descriptions of Event Messages Event Messages Effect There is no backup TMP. Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number. Examine the preceding error messages in the EMS log and try to diagnose what happened. If the situation is caused by a CPU failure, for example, then the backup TMP is started after the CPU has been reloaded.
Descriptions of Event Messages Event Messages 145: ZTMF-EVT-PrimaryTmpFailed The primary TMF management process (TMP) failed. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-ProcCompCode ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Int. token-type ZSPI-TYP-Boolean. Additional Conditional Tokens ZTMF-TKN-Fs-Error ZTMF-TKN-PROCCOMPTExt token-type ZSPI-TYP-Int. token-type ZSPI-TYP-String. Event-Message Text The primary $TMP has failed.
Descriptions of Event Messages Event Messages Recommended Action Informative message only; if the backup TMP successfully takes over, no corrective action is needed. Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number. If the primary TMP terminated abnormally, an internal error has occurred.
Descriptions of Event Messages Event Messages 146: ZTMF-EVT-BackupNotCapable An operator or subsystem control program (SPI requester) issued a Start TMF command, but TMF would not start because the primary TMF management process (TMP) failed and the backup TMP was not yet able to take over. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 147: ZTMF-EVT-BackupTakingOver The primary TMF management process (TMP) failed, and the backup TMP has successfully taken over. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text Backup TMP is taking over since the Primary TMP failed.
Descriptions of Event Messages Event Messages 148: ZTMF-EVT-StartTmfParameters An operator or subsystem control program (SPI requester) issued a Start TMF command. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Additional Conditional Tokens ZTMF-TKN-TRANSALLOWOPTION ZTMF-TKN-DISASTERRECOVERY token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum.
Descriptions of Event Messages Event Messages Effect TMF starts. Recommended Action Informative message only; no corrective action is needed.
Descriptions of Event Messages Event Messages 149: ZTMF-EVT-StopTmfParameters An operator or subsystem control program (SPI requester) issued a STOP TMF or STOP TMF, Abrupt command. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Additional Conditional Tokens ZTMF-TKN-Abrupt token-type ZSPI-TYP-Boolean. Event-Message Text STOP TMF parameters: Abrupt. or Start TMF parameters: None.
Descriptions of Event Messages Event Messages 150: ZTMF-EVT-GlobInfoFileErr While TMF was attempting to start, a file-system error occurred for the specified configuration file. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-Fs-Error ZTMF-TKN-FileName ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Int. ZSPI-TYP-FName. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number.
Descriptions of Event Messages Event Messages 151: ZTMF-EVT-WrongGlobInfoFileVer 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 ZTMF-TKN-FileName ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-FName. token-type ZSPI-TYP-Boolean. Event-Message Text Configuration file ZTMF-TKN-FileName has the wrong version number.
Descriptions of Event Messages Event Messages 152: ZTMF-EVT-TmfProcAllocSegFailed A file-system error prevented TMF from allocating an extended segment on the specified disk volume. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-VolumeName ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages ZEMS-TKN-Emphasis is set to True for this event. Effect The TMF process abends. Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number.
Descriptions of Event Messages Event Messages 153: ZTMF-EVT-ATOVSameVolErr TMF was attempting to prepare the next preallocated audit-trail file in anticipation of a rollover, but could not. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-AuditFileName ZTMF-TKN-VolumeName ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-String. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Effect The file-creation operation is retried, and transaction processing continues. When the active audit trail becomes too full, however, transaction processing with that audit trail ceases until a rollover can be performed successfully. Recommended Action Determine why the preallocated file could not be created (look at some of the preceding messages in the EMS log for clues), and then correct the problem.
Descriptions of Event Messages Event Messages 155: ZTMF-EVT-BeginOperation A preceding operation listed in the EMS log has begun. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text Begin operation. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType is the subject token of the event message, and it identifies the TMF process that generated the event.
Descriptions of Event Messages Event Messages 156: ZTMF-EVT-EndOperation A preceding operation listed in the EMS log has finished. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text End operation. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType is the subject token of the event message, and it identifies the TMF process that generated the event.
Descriptions of Event Messages Event Messages 157: ZTMF-EVT-TmpFileOpError During a file recovery operation, a file-system error occurred while the TMF management process (TMP) was attempting to execute the specified command. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-TMPFRFileName ZTMF-TKN-COMMAND ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int. ZSPI-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages ZTMF-TKN-Fs-Error contains an integer identifying the file-system error that occurred. ZEMS-TKN-Emphasis is set to True for this event. Effect The TMP abends. Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number.
Descriptions of Event Messages Event Messages 158: ZTMF-EVT-OprCancelled The requested operation has been cancelled. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text This operation has been cancelled. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType is the subject token of the event message, and it identifies the TMF process that generated the event.
Descriptions of Event Messages Event Messages 159: ZTMF-EVT-DV-ShutdownRejected The TMP received an unexpected error from a disk process. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-VolumeName ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int. ZSPI-TYP-Boolean. Event-Message Text Data volume ZTMF-TKN-VolumeName rejected a shutdown request with file-system error ZTMF-TKN-Fs-Error.
Descriptions of Event Messages Event Messages 163: ZTMF-EVT-Rcov-FR-FileList The file recovery list process has selected these files to be recovered. Up to 10 files are listed in each event. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-RCOV-FileName-1 ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Additional Conditional Tokens ZTMF-TKN-RCOV-FNAME-DMY1 if present, indicates that token ZTMF-TKN-RCOV-FileName-2 is present and that tokens ZTMF-TKN-RCOV-FileName-3 through ZTMF-TKN-RCOV-FileName-5 might be present. ZTMF-TKN-RCOV-FNAME-DMY2 if present, indicates that token ZTMF-TKN-RCOV-FileName-6 is present and that tokens ZTMF-TKN-RCOV-FileName-7 through ZTMF-TKN-RCOV-FileName-10 might be present.
Descriptions of Event Messages Event Messages 164: ZTMF-EVT-Rcov-FR-SuccessList The file recovery process has successfully recovered the listed files. Up to 10 files are listed in each event. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-RCOV-FileName-1 ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Additional Conditional Tokens ZTMF-TKN-RCOV-FNAME-DMY1 if present, indicates that token ZTMF-TKN-RCOV-FileName-2 is present and that tokens ZTMF-TKN-RCOV-FileName-3 through ZTMF-TKN-RCOV-FileName-5 might be present. ZTMF-TKN-RCOV-FNAME-DMY2 if present, indicates that token ZTMF-TKN-RCOV-FileName-6 is present and that tokens ZTMF-TKN-RCOV-FileName-7 through ZTMF-TKN-RCOV-FileName-10 might be present.
Descriptions of Event Messages Event Messages 165: ZTMF-EVT-Rcov-FR-Summary This is a summary message specifying how many database tables or files were successfully recovered, and how many were not. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-RCOV-SuccessNum ZTMF-TKN-RCOV-NumFailed ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Int2. ZSPI-TYP-Int2. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 166: ZTMF-EVT-Rcov-Restart1 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 ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String.
Descriptions of Event Messages Event Messages 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). ZTMF-TKN-RCOV-Restart-Rba2 contains an integer specifying a relative byte address (rba) within the audit-trail file.
Descriptions of Event Messages Event Messages 167: ZTMF-EVT-Rcov-Restart2 A backout operation was interrupted by a disk process takeover for the specified volume. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-RCOV-FileName-1 ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean. Event-Message Text Restart condition encountered on audited volume ZTMF-TKN-RCOV-FileName-1.
Descriptions of Event Messages Event Messages 168: ZTMF-EVT-Rcov-FsError1 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.
Descriptions of Event Messages Event Messages ZTMF-TKN-RCOV-Op-of-Error specifies the operation that was being attempted.
Descriptions of Event Messages 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.
Descriptions of Event Messages Event Messages 169: ZTMF-EVT-Rcov-FsError2 A file-system error occurred for the specified file while a recovery process was attempting the specified operation. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-RCOV-FileName-1 ZTMF-TKN-RCOV-FsError ZTMF-TKN-RCOV-Op-of-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int. ZSPI-TYP-Enum. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages ZTMF-VAL-RCOV-READ ZTMF-VAL-RCOV-POSITION ZEMS-TKN-Emphasis is set to False for this event. 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.
Descriptions of Event Messages Event Messages 170: ZTMF-EVT-Rcov-FsError3 A file-system error affecting the entire volume occurred while a recovery process was attempting the specified operation. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-RCOV-FileName-1 ZTMF-TKN-RCOV-FsError ZTMF-TKN-RCOV-Op-of-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int. ZSPI-TYP-Enum. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages ZTMF-VAL-RCOV-CLEARFLAGS ZTMF-VAL-RCOV-READ ZTMF-VAL-RCOV-POSITION ZEMS-TKN-Emphasis is set to False for this event. Effect The recovery process immediately terminates any further operations on the specified volume. The volume is not available for transaction processing. If the volume is subsequently specified in a ENABLE DATAVOL command, the volume recovery process automatically attempts to recover the volume.
Descriptions of Event Messages Event Messages 171: ZTMF-EVT-Rcov-StopObjectRcov A recovery process has encountered an error for the specified file or volume and has terminated recovery. The preceding event message in the EMS log generated by the recovery process (event 168 or 169) specifies the particular error and other related information. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Recommended Action See the recommended action text associated with the preceding event message generated by the particular recovery process (168 or 169).
Descriptions of Event Messages Event Messages 172: ZTMF-EVT-Rcov-ErrorOnTx The backout process encountered an error while attempting to undo the transaction. This error message is always preceded by either event message 168 or 169, which lists the error. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-RCOV-TransID ZTMF-TKN-RCOV-TxStatus ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Enum. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Effect The transaction is retried or ignored, as indicated in the message. If the status is “retried,” then the backout process terminates work on this transaction and the TMF management process (TMP) resubmits the transaction identifier to the backout process to try again to undo the transaction. If the TMP has already submitted the transaction identifier to the backout process three times, then the TMP hangs the transaction.
Descriptions of Event Messages Event Messages 173: ZTMF-EVT-Rcov-AuditTrailError 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 ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Int. token-type ZSPI-TYP-Boolean. Event-Message Text Recovery process failed due to audit reading exception: ZTMF-TKN-AuditReadException.
Descriptions of Event Messages Event Messages ZTMF-VAL-ARExcp-AuxPtrMismatch ZTMF-VAL-ARExcp-Format2File ZTMF-VAL-ARExcp-Format2Rec ZEMS-TKN-Emphasis is set to False for this event. Effect The recovery process abends. 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.
Descriptions of Event Messages Event Messages 174: ZTMF-EVT-RCOV-BO-RetryExceeded The backout process could not back out the specified transaction, and stopped after retrying the maximum number of times. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-RCOV-TransID ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 175: ZTMF-EVT-RCOV-EndAtFileHiatus 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.
Descriptions of Event Messages 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.
Descriptions of Event Messages Event Messages 176: ZTMF-EVT-RCOV-StopAbrupt While a recovery operation was in progress, the TMF management process (TMP) stopped. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text The TMP has stopped; recovery process now stopping.
Descriptions of Event Messages Event Messages 177: ZTMF-EVT-RCOV-PFS-Too-Small The configured process file segment (PFS) size is too small to enable the recovery process to recover all files. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text The PFS is too small for the number of files requiring recovery.
Event Messages • Descriptions of Event Messages For the file recovery process, issue two or more RECOVER FILES commands, specifying fewer files with each command than you did in the RECOVER FILES command that failed. Alternatively, disable one or more data volumes. While file recovery on the remaining data volumes is in progress, reenable the data volumes and a second file recovery process will recover the files on them.
Descriptions of Event Messages Event Messages 178: ZTMF-EVT-RCOV-Not-Licensed The TMF recovery program files are not licensed to recover NonStop SQL/MP objects. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text The recovery program files must be licensed to recover SQL objects.
Descriptions of Event Messages Event Messages 179: ZTMF-EVT-RCOV-ToRba-Too-Low 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 ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Int2. ZSPI-TYP-Int2. ZSPI-TYP-Int4. ZSPI-TYP-Boolean.
Descriptions of Event Messages 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.
Descriptions of Event Messages Event Messages 180: ZTMF-EVT-CrashTmfStart The TMF management process (TMP) failed, and its backup could not successfully take over. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text Beginning TMF Subsystem Crash due to TMP failure.
Descriptions of Event Messages Event Messages 181: ZTMF-EVT-CrashTmfEnd A TMF crash just finished. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text TMF Subsystem Crash completed. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType is the subject token of the event message, and it identifies the TMF process that generated the event.
Descriptions of Event Messages Event Messages 182: ZTMF-EVT-UnableToCreateTmp The TMF management process (TMP) failed or could not be started because a filesystem error occurred. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-ProcCompCode ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Int. token-type ZSPI-TYP-Boolean. Additional Conditional Tokens ZTMF-TKN-Fs-Error ZTMF-TKN-ProcCompText token-type ZSPI-TYP-Int. token-type ZSPI-TYP-String.
Descriptions of Event Messages Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated process create error number. Try to resolve the problem. The subsystem periodically attempts to restart the TMP.
Descriptions of Event Messages Event Messages 183: ZTMF-EVT-UnableToCreateMon2 The designated TMFMON2 process failed or could not be started because a filesystem error occurred. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-ProcCompCode ZTMF-TKN-CpuNum ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Int. ZSPI-TYP-Int. ZSPI-TYP-Boolean. Additional Conditional Tokens ZTMF-TKN-Fs-Error ZTMF-TKN-ProcCompText token-type ZSPI-TYP-Int.
Descriptions of Event Messages Event Messages Effect The CPU being reloaded fails. Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated process create error number. Try to resolve the problem.
Descriptions of Event Messages Event Messages 184: ZTMF-EVT-RmUnableToCreateMon2 A file-system error occurred while TMF was attempting to create a TMFMON2 process in the specified CPU. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-ProcCompCode ZTMF-TKN-Fs-Error ZTMF-TKN-CpuNum ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Int. ZSPI-TYP-Int. ZSPI-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated process create error number.
Descriptions of Event Messages Event Messages 185: ZTMF-EVT-ATHeldReason The specified audit-trail file is pinned on the disk. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-AuditFileName ZTMF-TKN-ATHeldReason ZTMF-TKN-RdfRequesterName ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages ZTMF-TKN-ZTMF-TKN-AuditFileName contains the name of the pinned audit-trail file. ZTMF-TKN-ATHeldReason identifies why the file is pinned on disk.
Descriptions of Event Messages Event Messages 186: ZTMF-EVT-RdfPreventStop TMF is trying to stop, but there is a Remote Duplicate Database Facility (RDF) process running which has requested that TMF not stop until either RDF or the particular RDF process stops. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text TMF is waiting for RDF to stop before completing TMF shutdown.
Descriptions of Event Messages Event Messages 187: ZTMF-EVT-ATIsCriticallyFull The audit disk process (ADP) is suspending audit generation requests because the audit trail is so full. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text The ZTMF-TKN-AuditTrailID Audit Trail is critically full.
Descriptions of Event Messages Event Messages Recommended Action Try to determine why the oldest audit-trail file is pinned on disk. If the problem cannot be resolved, configure an overflow volume for the audit trail. The oldest audit-trail files can then be copied to the overflow-audit volume, freeing space in the audit trail. Alternatively, increase the size of the audit trail by either increasing the FILESPERVolume attribute or adding an active-audit volume.
Descriptions of Event Messages Event Messages 188: ZTMF-EVT-RmATIsCriticallyFull This message is generated as a compensating event for the action event ZTMF-EVTATISCRITICALLYFULL when space is made available in the audit trail and auditgenerating requests are again being processed. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 190: ZTMF-EVT-FRList-ExceptVolErr The specified file was included in a RECOVER FILES command, but a file-system error occurred while TMF was searching for an appropriate entry in the TMF catalog. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-FRlist-FileName ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number. Determine how to resolve the file-system error and reissue the RECOVER FILES command.
Descriptions of Event Messages Event Messages 191: ZTMF-EVT-FRList-ExceptNoMatch The specified file was included in a RECOVER FILES command, but could not be found in the TMF catalog. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-FRlist-FileName ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean. Event-Message Text A program exception occurred. ZTMF-TKN-FRlist-FileName.
Descriptions of Event Messages Event Messages 192: ZTMF-EVT-FRList-ExceptError3 The specified files were included in a RECOVER FILES command, but TMF could not find valid entries for them in the TMF catalog. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text A program exception occurred. No matches were found for files ZTMF-TKN-FRlist-FileName.
Descriptions of Event Messages Event Messages 193: ZTMF-EVT-FRList-InvalCtlgEntry The specified file was included in a RECOVER FILES command, but TMF could not find a valid entry for it in the TMF catalog. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-FRlist-FileName ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean. Event-Message Text The file ZTMF-TKN-FRlist-FileName has no valid entries in the Catalog.
Descriptions of Event Messages Event Messages 194: ZTMF-EVT-FRList-NotUndoNeeded An operator or subsystem control program (SPI requester) issued a RECOVER FILES command without including either the FROMARCHIVE attribute or the TIME attribute (which automatically invokes FROMARCHIVE). Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-FRlist-FileName ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 196: ZTMF-EVT-FRList-CantRecovFile The specified file was included in a RECOVER FILES command, but it is currently being recovered by another instance of the file recovery process. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-FRlist-FileName ZTMF-TKN-FRlist-OperNum ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 197: ZTMF-EVT-FRList-FileError The TMF file recovery list (TMFFRLS) process tried to add the specified file name to the file recovery list file, but could not because a file-system error occurred. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-FRlist-FileName ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number.
Descriptions of Event Messages Event Messages 198: ZTMF-EVT-FRList-VolNotConfig TMF could not search the specified volume during a RECOVER FILES operation. The volume is either not configured or not started as a TMF data volume. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-FRlist-FileName ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 200: ZTMF-EVT-DR-MakeScrTape The TMF catalog shows that there are no more scratch tapes available. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text Out of scratch tapes in the TMF catalog -make more.
Descriptions of Event Messages Event Messages 201: ZTMF-EVT-DR-MakeScrTapeComp Scratch tapes have been added to, or made available within, the TMF catalog. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text Action completion event for TMF *0200*.
Descriptions of Event Messages Event Messages 202: ZTMF-EVT-DR-Error The TMF dump/restore process generates this event in response to dump/restore error messages whose numbers are within the range 9000-9999. The dump/restore messages are listed in Section 7, Error and Warning Messages of this manual. For the cause, effect, and recovery text, see the “TMF Messages” section of the Operator Messages Manual.
Descriptions of Event Messages Event Messages ZEMS-TKN-Emphasis is set to True for most of the dump/restore messages (see the individual message summaries in Section 7, Error and Warning Messages of this manual). Dump/Restore Tokens Some of the dump/restore messages include tokens, others do not.
Descriptions of Event Messages Event Messages 203: ZTMF-EVT-DR-Warning The TMF dump/restore process generates this event in response to dump/restore warning messages whose numbers are within the range 9000-9999. The dump/restore messages are listed in Section 7, Error and Warning Messages of this manual. For the cause, effect, and recovery text, see the “TMF Messages” section of the Operator Messages Manual.
Descriptions of Event Messages Event Messages ZEMS-TKN-Emphasis is set to True for most of the dump/restore messages (see the individual message summaries in Section 7, Error and Warning Messages of this manual). Dump/Restore Tokens Some of the dump/restore messages include tokens, others do not.
Descriptions of Event Messages Event Messages 204: ZTMF-EVT-DR-ArchTapeErr The TMF dump/restore process generates this event in response to archive tape error messages whose numbers are within the range 8000-8999. The archive tape messages are listed in Section 7, Error and Warning Messages of this manual. For the cause, effect, and recovery text, see the “TMF Messages” section of the Operator Messages Manual.
Descriptions of Event Messages Event Messages Archive Tape Tokens Some of the archive tape messages include tokens, others do not.
Descriptions of Event Messages Event Messages 205: ZTMF-EVT-DR-ArchTapeWarn The TMF dump/restore process generates this event in response to archive tape warning messages whose numbers are within the range 8000-8999. The archive tape messages are listed in Section 7, Error and Warning Messages of this manual. For the cause, effect, and recovery text, see the “TMF Messages” section of the Operator Messages Manual.
Descriptions of Event Messages Event Messages Archive Tape Tokens Some of the archive tape messages include tokens, others do not.
Descriptions of Event Messages Event Messages 206: ZTMF-EVT-DR-ArchTapeMountErr The TMF dump/restore process generates this event in response to archive tape mount error messages whose numbers are within the range 8000-8999. For the message text, and the cause, effect, and recovery text of those messages, see the “TMF Messages” section of the Operator Messages Manual. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZART-TKN-ArchTapeErrorMess ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum.
Descriptions of Event Messages Event Messages Archive Tape Tokens Some of the archive tape mount error messages include tokens, others do not.
Descriptions of Event Messages Event Messages 207: ZTMF-EVT-DR-ArchTapeMountWarn The TMF dump/restore process generates this event in response to archive tape mount warning messages whose numbers are within the range 8000-8999. For the message text, and the cause, effect, and recovery text of those messages, see the “TMF Messages” section of the Operator Messages Manual. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZART-TKN-ArchTapeErrorMess ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum.
Descriptions of Event Messages Event Messages Archive Tape Tokens Some of the archive tape warning messages include tokens, others do not.
Descriptions of Event Messages Event Messages 208: ZTMF-EVT-DR-TapeAuditDump The specified audit-trail file has been dumped to tape. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-DR-FileName ZTMF-TKN-DR-DumpSerialNum ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int2. ZSPI-TYP-Boolean. Event-Message Text Audit trail ZTMF-TKN-FileName dumped to tape. Dump serial number: ZTMF-TKN-DR-DumpSerialNum.
Descriptions of Event Messages Event Messages 209: ZTMF-EVT-DR-OtherError A dump/restore process encountered an error. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-DR-OtherErrorText ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean. Event-Message Text *ERROR* ZTMF-TKN-DR-OtherErrorText.
Descriptions of Event Messages Event Messages Recommended Action Referring to the supplied text and to preceding messages in the EMS log, try to diagnose what happened.
Descriptions of Event Messages Event Messages 210: ZTMF-EVT-DR-DiskAuditDump The specified audit-trail file has been dumped to disk. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-DR-FileName ZTMF-TKN-DR-DiskAudDumpFName ZTMF-TKN-DR-DumpSerialNum ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-String. ZSPI-TYP-Int2. ZSPI-TYP-Boolean. Event-Message Text Audit trail ZTMF-TKN-DR-FileName dumped to disk.
Descriptions of Event Messages Event Messages 211: ZTMF-EVT-DR-TapeOnlineDump The online dump with the specified dump serial number has been dumped successfully to tape. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-DR-DumpSerialNum ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Int2. token-type ZSPI-TYP-Boolean. Event-Message Text Completed Online Dump to tape. Dump serial number: ZTMF-TKN-DR-DumpSerialNum.
Descriptions of Event Messages Event Messages 212: ZTMF-EVT-DR-DiskOnlineDump The online dump with the specified dump serial number has been dumped successfully to disk. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-DR-DumpSerialNum ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Int2. token-type ZSPI-TYP-Boolean. Event-Message Text Completed Online Dump to disk. Dump serial number: ZTMF-TKN-DR-DumpSerialNum.
Descriptions of Event Messages Event Messages 213: ZTMF-EVT-DR-FindOnlineDump TMF could not locate the specified disk online dump file for a RECOVER FILES operation. This error message is reissued every 10 minutes until the file is available. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-DR-DumpFileName ZTMF-TKN-DR-DumpSerialNum ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int2. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 214: ZTMF-EVT-DR-FindAuditDump TMF could not locate the specified disk audit dump file for a RECOVER FILES operation. This error message is reissued every 10 minutes until the file is available. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-DR-DumpFileName ZTMF-TKN-DR-DumpSerialNum ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int2. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 215: ZTMF-EVT-DR-FindOnlineDumpComp This is an action completion event associated with event 213. It is issued 10 minutes after the preceding event 213. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-DR-DumpFileName ZTMF-TKN-DR-DumpSerialNum ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int2. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 216: ZTMF-EVT-DR-FindAuditDumpComp This is an action completion event associated with event 214. It is issued 10 minutes after the preceding event 214. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-DR-DumpFileName ZTMF-TKN-DR-DumpSerialNum ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int2. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 217: ZTMF-EVT-DR-OnlineParams The specified files are to be dumped. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-FileSet ZTMF-TKN-DR-DumpSerialNum ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int2. ZSPI-TYP-Boolean. Additional Conditional Tokens ZTMF-TKN-NotFileSet token-type ZSPI-TYP-String.
Descriptions of Event Messages Event Messages Effect None. Recommended Action Informative message only; no corrective action is needed.
Descriptions of Event Messages Event Messages 218: ZTMF-EVT-DR-MediaOptions An operator or subsystem control program (SPI requester) issued a DUMP FILES command, specifying the DISKMEDIA attribute and a list of disk volume names. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-DR-DumpMedium ZTMF-TKN-DR-MediaList ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 219: ZTMF-EVT-DR-TapeOptions An operator or subsystem control program (SPI requester) issued a DUMP FILES command, specifying the TAPEMEDIA attribute, plus new BLOCKSIZE, COPIES, SYSTEM, and VERIFYTAPE attribute values. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-DR-DumpBlockSize ZTMF-TKN-DR-DumpCopies ZTMF-TKN-DR-VerifyTape ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Int.
Descriptions of Event Messages Event Messages Additional Conditional Tokens ZTMF-TKN-DR-SystemNames if present, contains the name(s) of the remote system(s) to which tape dumps are to be directed. Effect None. Recommended Action Informative message only; no corrective action is needed.
Descriptions of Event Messages Event Messages 220: ZTMF-EVT-DR-EndingTape The dump of the specified audit-trail file (for audit dumping) or database table or file (for online dumping) must be continued onto another tape. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-DR-FileName ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 221: ZTMF-EVT-DR-OtherWarning Dump/restore warning message. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-DR-OtherErrorText ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 222: ZTMF-EVT-DR-BeginTape The dump process has begun dumping to the specified tape drive. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-DR-FirstTape ZTMF-TKN-DR-TapeNum ZART-TKN-VolumeID ZART-TKN-DriveName ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Boolean. ZSPI-TYP-Int. ZART-TYP-Volume. ZSPI-TYP-String. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages ZART-TKN-DriveName contains the name of a tape drive. ZEMS-TKN-Emphasis is set to False for this event. Additional Conditional Tokens ZART-TKN-FileName if present, contains the name the file that is being dumped. ZTMF-TKN-DR-DumpCopies if present, contains an integer specifying how many copies are to be made of the dump. Effect None. Recommended Action Informative message only; no corrective action is needed.
Descriptions of Event Messages Event Messages 223: ZTMF-EVT-DR-TapeVolsUsed The dump process has begun dumping to the specified tape volume(s). Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-DR-MediaList ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean. Additional Conditional Tokens ZTMF-TKN-DR-DumpCopies token-type ZSPI-TYP-Int. Event-Message Text Tape volume IDs used for copy #ZTMF-TKN-DR-DumpCopies: ZTMF-TKN-DR-MediaList.
Descriptions of Event Messages Event Messages 224: ZTMF-EVT-DR-BeginDisk The dump process has begun dumping to the specified disk dump file. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-DR-DumpFileNum ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Int. token-type ZSPI-TYP-Boolean. Event-Message Text Begin dumping to disk dump file #ZTMF-TKN-DR-DumpFileNum.
Descriptions of Event Messages Event Messages 225: ZTMF-EVT-DR-NextDisk The dump of the specified file is being continued on the next disk dump file. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-DR-FileName ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 226: ZTMF-EVT-DR-EndingDisk A dump to disk is finished. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-DR-DumpFileNum ZTMF-TKN-DR-DumpFileName ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Int. ZSPI-TYP-String. ZSPI-TYP-Boolean. Additional Conditional Tokens ZTMF-TKN-DR-FileName token-type ZSPI-TYP-String.
Descriptions of Event Messages Event Messages Effect None. Recommended Action Informative message only; no corrective action is needed.
Descriptions of Event Messages Event Messages 227: ZTMF-EVT-DR-OnlineFileInfo An online dump has completed. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-DR-FileName ZTMF-TKN-DR-DumpEndTime ZTMF-TKN-DR-MatSeqNum ZTMF-TKN-DR-DataATSeqNum ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-String. ZSPI-TYP-Int2. ZSPI-TYP-Int2. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages ZTMF-TKN-DR-DataATSeqNum contains an integer specifying an audit-trail sequence number. If this token contains the same value as ZTMF-TKN-DR-MatSEQNUM, then the data file is audited to an auxiliary audit trail. ZEMS-TKN-Emphasis is set to False for this event. Additional Conditional Tokens ZTMF-TKN-DR-DumpInitEof contains an integer specifying the location of the end-of-file on tape when the dump was begun.
Descriptions of Event Messages Event Messages 228: ZTMF-EVT-DR-OnlineStatistics Informational message stating how many database tables and files were successfully dumped and how many were not. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-DR-FilesDumped ZTMF-TKN-DR-FilesNotDumped ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Int2. ZSPI-TYP-Int2. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 229: ZTMF-EVT-DR-ORFileNotFound During the online restore phase of a file recovery operation, the specified audited file could not be found in the specified online dump. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-DR-FileName ZTMF-TKN-DR-DumpSerialNum ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int2. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 230: ZTMF-EVT-DR-ORFileNotRestored During the online restore phase of a file recovery operation, the specified audited file could not be restored because an archive tape error occurred. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-DR-FileName ZTMF-TKN-DR-DumpSerialNum ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int2. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 250: ZTMF-EVT-ADAlterCopies An operator or subsystem control program (SPI requester) issued an ALTER AUDITDUMP command, specifying a new COPIES attribute value. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-ATDumpCopies token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Int. Event-Message Text AuditDump COPIES value for the ZTMF-TKN-AuditTrailID Audit Trail altered to ZTMF-TKN-ATDumpCopies.
Descriptions of Event Messages Event Messages 251: ZTMF-EVT-ADAlterSeries An operator or subsystem control program (SPI requester) issued an ALTER AUDITDUMP command, specifying a new SERIES/PARALLEL attribute value. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-ATDumpSeries token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Effect The new attribute value takes effect immediately. Recommended Action Informative message only; no corrective action is needed.
Descriptions of Event Messages Event Messages 252: ZTMF-EVT-ADAlterVerifyTape An operator or subsystem control program (SPI requester) issued an ALTER AUDITDUMP command, specifying a new VERIFYTAPE attribute value. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-ATDumpBoolean token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Effect The new attribute value takes effect immediately. Recommended Action Informative message only; no corrective action is needed.
Descriptions of Event Messages Event Messages 253: ZTMF-EVT-ADAlterBlockSize An operator or subsystem control program (SPI requester) issued an ALTER AUDITDUMP command, specifying a new BLOCKSIZE attribute value. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-ATDumpBlockSize token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Int.
Descriptions of Event Messages Event Messages 254: ZTMF-EVT-ADAlterUnloadMedia A SPI Alter-AuditDump command was executed, specifying a new UNLOAD value. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-ATDumpBoolean token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text AuditDump UNLOADMEDIA value for the ZTMF-TKN-AuditTrailID Audit Trail altered to ZTMF-TKN-ATDumpBoolean.
Descriptions of Event Messages Event Messages 255: ZTMF-EVT-ADAlterMedium An operator or subsystem control program (SPI requester) issued an ALTER AUDITDUMP command, specifying a new MEDIUM attribute value. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-ATDumpMedium token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. Event-Message Text AuditDump MEDIUM value for the ZTMF-TKN-AuditTrailID Audit Trail altered to ZTMF-TKN-ATDumpMedium.
Descriptions of Event Messages Event Messages Effect The new attribute value takes effect immediately. Recommended Action Informative message only; no corrective action is needed.
Descriptions of Event Messages Event Messages 256: ZTMF-EVT-ADAlterSystemName An operator or subsystem control program (SPI requester) issued an ALTER AUDITDUMP command, specifying a new first node value for the SYSTEM attribute. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-ATDumpSystemName token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-CHAR8.
Descriptions of Event Messages Event Messages 257: ZTMF-EVT-ADAlterSystemName2 An operator or subsystem control program (SPI requester) issued an ALTER AUDITDUMP command, specifying a new first node value for the SYSTEM attribute. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-ATDumpSystemName token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-CHAR8.
Descriptions of Event Messages Event Messages 258: ZTMF-EVT-ATDumpDisabled An operator or subsystem control program (SPI requester) issued a DISABLE AUDITDUMP command. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. Event-Message Text AuditDump DISABLED for the ZTMF-TKN-AuditTrailID Audit Trail. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType identifies the TMF process that generated the event.
Descriptions of Event Messages Event Messages 259: ZTMF-EVT-ATDumpEnabled An operator or subsystem control program (SPI requester) issued an ENABLE AUDITDUMP command. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. Event-Message Text AuditDump enabled for the ZTMF-TKN-AuditTrailID Audit Trail. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType identifies the TMF process that generated the event.
Descriptions of Event Messages Event Messages 260: ZTMF-EVT-ATDumpDMDeleted The specified dump disk medium (disk volume) was deleted from the dump configuration for the designated audit trail. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-DiskMediaString token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String.
Descriptions of Event Messages Event Messages 261: ZTMF-EVT-ATDumpDMAdded The specified dump disk medium (disk volume) was added to the dump configuration for the designated audit trail. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-DiskMediaString token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. Event-Message Text DISKMEDIA ZTMF-TKN-DiskMediaString added to the dump configuration for the ZTMF-TKN-AuditTrailID audit trail.
Descriptions of Event Messages Event Messages 263: ZTMF-EVT-ATDumpCopiesFailed Something prevented all requested copies of an audit dump from being made. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-AuditFileName ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Effect The dump is retried. Recommended Action Informative message only; no corrective action is needed.
Descriptions of Event Messages Event Messages 264: ZTMF-EVT-ATDumpFailed TMF attempted to dump the specified audit-trail file, but could not. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-AuditFileName ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Boolean. Event-Message Text Dump of ZTMF-TKN-AuditTrailID Audit Trail file ZTMF-TKN-AuditFileName failed.
Descriptions of Event Messages Event Messages Effect The dump is retried. Recommended Action Examine preceding error messages in the EMS log and try to determine why the dump failed.
Descriptions of Event Messages Event Messages 265: ZTMF-EVT-ATDumpSuccess An audit dump of the specified audit-trail file finished successfully. 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 Dump of ZTMF-TKN-AuditTrailID Audit Trail file ZTMF-TKN-AuditFileName completed successfully.
Descriptions of Event Messages Event Messages 266: ZTMF-EVT-ATOvSourceErr TMF attempted to copy the specified audit-trail file to an overflow-audit volume, but could not because of an error on the source file. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-AuditFileName ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Effect The overflow operation is retried. Recommended Action Examine preceding error messages in the EMS log and try to determine why the overflow operation failed.
Descriptions of Event Messages Event Messages 267: ZTMF-EVT-ATOvTargetErr TMF attempted to copy the specified audit-trail file to an overflow-audit volume, but could not because of an error on the destination file. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-AuditFileName ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Effect The overflow operation is retried. Recommended Action Examine preceding error messages in the EMS log and try to determine why the overflow operation failed.
Descriptions of Event Messages Event Messages 268: ZTMF-EVT-ATOvFailed TMF attempted to copy the specified audit-trail file to an overflow-audit volume, but could not. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-AuditFileName ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Boolean. Event-Message Text Overflow of ZTMF-TKN-AuditTrailID Audit Trail file ZTMF-TKN-AuditFileName failed.
Descriptions of Event Messages Event Messages Effect The overflow operation is retried. Recommended Action Examine preceding error messages in the EMS log and try to determine why the overflow operation failed.
Descriptions of Event Messages Event Messages 269: ZTMF-EVT-ATOvSuccess The specified audit-trail file was successfully copied to an overflow-audit volume. 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 Overflow of ZTMF-TKN-AuditTrailID Audit Trail file ZTMF-TKN-AuditFileName to file ZTMF-TKN-AuditFileName completed successfully.
Descriptions of Event Messages Event Messages 270: ZTMF-EVT-ATOvVolsNeeded TMF attempted to copy the specified audit-trail file to an overflow-audit volume, but could not. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-AuditFileName ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Effect The overflow operation is retried. Recommended Action If the configured overflow-audit volume is down, bring it back up; otherwise, issue an ALTER AUDITRAIL command to configure another overflow-audit volume for the audit trail or do an audit dump.
Descriptions of Event Messages Event Messages 271: ZTMF-EVT-ATOvAllVolsTried TMF attempted to copy the specified audit-trail file to an overflow-audit volume, but could not. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-AuditFileName ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Effect The overflow operation is retried. Recommended Action Try to determine why the overflow operation failed on all configured overflow-audit volumes and, if possible, correct the problem. If it is not apparent why the operation failed, issue an ALTER AUDITRAIL command to configure another overflow-audit volume for the audit trail or do an audit dump.
Descriptions of Event Messages Event Messages 272: ZTMF-EVT-ATRestoreMedErr TMF attempted to restore the specified audit-trail file for a file recovery operation, but could not do so because of a media error. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-AuditFileName ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Effect The restore operation fails, causing the file recovery operation to fail. Recommended Action Reissue the RECOVER FILES command and try using a backup copy of the tape, if one is available.
Descriptions of Event Messages Event Messages 273: ZTMF-EVT-ATRestoreTargetErr TMF attempted to restore the specified audit-trail file for a file recovery operation, but could not do so because of an error on the file. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-AuditFileName ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Effect The restore operation is retried on another restore-audit volume, if configured. If there are no more restore-audit volumes, TMF issues event message 276, waits 30 seconds, then retries the restore operation. Recommended Action Add another restore-audit volume to the configuration.
Descriptions of Event Messages Event Messages 274: ZTMF-EVT-ATRestoreFailed TMF attempted to restore the specified audit-trail file for a file recovery operation, but could not. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-AuditFileName ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Effect The restore operation fails, causing the file recovery operation to fail. Recommended Action Try to determine why the restore operation failed on all configured restore-audit volumes and, if possible, correct the problem. Try adding another restore-audit volume to the configuration.
Descriptions of Event Messages Event Messages 275: ZTMF-EVT-ATRestoreSuccess An operator or subsystem control program (SPI requester) issued a RECOVER FILES command, causing the restoration of the specified audit-trail file. 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.
Descriptions of Event Messages Event Messages 276: ZTMF-EVT-ATRestoreAllVolsTried TMF attempted to restore the specified audit-trail file for a file recovery operation, but could not do so. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-AuditFileName ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Effect TMF waits for 30 seconds and then retries the restore operation. Recommended Action Try to determine why the restore operation failed on all configured restore-audit volumes and, if possible, correct the problem. Try adding another restore-audit volume to the configuration.
Descriptions of Event Messages Event Messages 277: ZTMF-EVT-BTDisabled TMF has exceeded a configured threshold, or an operator or a SPI requester issued a DISABLE BEGINTRANS command. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-BTStatus ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Effect Current transaction processing continues, but new transactions cannot be started. Recommended Action If you did not issue a DISABLE BEGINTRANS command, examine the message text and try to ascertain the problem. If possible, correct the situation. This problem most often occurs because there is no available audit-trail file.
Descriptions of Event Messages Event Messages 278: ZTMF-EVT-BTEnabled TMF is once again beneath the threshold that had been temporarily exceeded, or an operator or subsystem control program (SPI requester) issued a Start TMF or ENABLE BEGINTRANS command. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-BTStatus ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Effect New transactions can once again be started, unless otherwise indicated by the message text. Recommended Action If the message indicates that new transactions are still disabled for other reasons, try to ascertain the problem by examining status displays and preceding event messages in the EMS log. If possible, correct the situation.
Descriptions of Event Messages Event Messages 279: ZTMF-EVT-AlterBeginTrans An operator or subsystem control program (SPI requester) issued an ALTER BEGINTRANS command, changing the value of the specified attribute(s). Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-BTAttribute token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum.
Descriptions of Event Messages Event Messages Conditional Tokens The following conditional tokens are included based upon the value of ZTMF-TKNBTATTRIBUTE. ZTMF-TKN-OldRecRmCount if present, contains an integer identifying the old recoverable resource manager count. ZTMF-TKN-NewRecRmCount if present, contains an integer identifying the new recoverable resource manager count. ZTMF-TKN-OldRmOpenPerCpu if present, contains an integer identifying the old resource manager opens for each CPU.
Descriptions of Event Messages Event Messages 281: ZTMF-EVT-CtgAlterRD An operator or subsystem control program (SPI requester) issued an ALTER CATALOG command, specifying a new RETAINDEPTH attribute value. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-CtgRetainDepth ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Int. token-type ZSPI-TYP-Boolean. Event-Message Text RetainDepth attribute of the Catalog altered to ZTMF-TKN-CtgRetainDepth.
Descriptions of Event Messages Event Messages 282: ZTMF-EVT-CtgAlterRe An operator or subsystem control program (SPI requester) issued an ALTER CATALOG command, specifying a new RELEASED attribute value. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-CtgReleased ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. token-type ZSPI-TYP-Boolean. Event-Message Text Released attribute of the Catalog altered to ZTMF-TKN-CtgReleased.
Descriptions of Event Messages Event Messages 283: ZTMF-EVT-CtgProcessErr The TMP encountered an error accessing the TMF catalog process. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-Command ZTMF-TKN-Fs-Error ZTMF-TKN-ProcessName ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Int. ZSPI-TYP-Int. ZSPI-TYP-String. ZSPI-TYP-Boolean.
Descriptions of Event Messages 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.
Descriptions of Event Messages Event Messages 284: ZTMF-EVT-DeleteCtg An operator or subsystem control program (SPI requester) issued a DELETE CATALOG command. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text The Catalog is deleted. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType is the subject token of the event message, and it identifies the TMF process that generated the event.
Descriptions of Event Messages Event Messages 285: ZTMF-EVT-ConfigVolAltered The configuration volume has successfully been changed. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZSPI-TKN-FromConfigVol ZSPI-TKN-ToConfigVol ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-String. ZSPI-TYP-Boolean. Event-Message Text The TMF configuration volume has been changed from ZSPI-TKN-FromConfigVol to ZSPI-TKN-ToConfigVol.
Descriptions of Event Messages Event Messages 286: ZTMF-EVT-CONFVOLFileFsError A file-system error occurred when the TMFMON2 process tried to access the CONFVOL file. Additional Unconditional Token ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-Fs-Error token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Int. Event-Message Text File-system error ZTMF-TKN-Fs-Error occurred in accessing the file $SYSTEM.ZTMFCONF.CONVOL.
Descriptions of Event Messages Event Messages 287: ZTMF-EVT-ConfigVolFsError A file-system error occurred when the TMFMON2 process tried to access the configuration volume. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZSPI-TKN-VolumeName ZTMF-TKN-Fs-Error token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Int. Event-Message Text File-system error ZTMF-TKN-Fs-Error occurred in accessing the configuration volume ZSPI-TKN-VolumeName.
Descriptions of Event Messages Event Messages 288: ZTMF-EVT-TransAutoAborted A transaction reached the time limit set by the AUTOABORT attribute of the BEGINTRANS object. Additional Unconditional Token ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-TransID ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-TransID. token-type ZSPI-TYP-Boolean. Event-Message Text The transaction ZTMF-TKN-TransID was aborted because it exceeded the AutoAbort timeout duration.
Descriptions of Event Messages Event Messages 289: ZTMF-EVT-AbortDueToAudOvflow TMF aborted the transaction because audit information filled 45% of the master audit trail since the transaction started. To maintain the consistency of the database, TMF writes audit records when backing out a transaction. Because 45% of the audit trail has been consumed, TMF might need up to an additional 45% to undo the transaction; 90% of the audit trail could fill before this transaction is completely backed out.
Descriptions of Event Messages Event Messages 290: ZTMF-EVT-OpenMigrateFileErr A file-system error occurred while attempting to open the migrate file during migration from a pre-D30 TMF environment to a D30 or later TMF environment. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-ExtFileName ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Enum. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for a description of and recovery actions for the file-system error.
Descriptions of Event Messages Event Messages 291: ZTMF-EVT-ReadMigrateFileErr A file-system error occurred while attempting to read the migrate file during migration from a pre-D30 TMF environment to a D30 or later TMF environment. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-ExtFileName ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Enum. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for a description of and recovery actions for the file-system error.
Descriptions of Event Messages Event Messages 292: ZTMF-EVT-IncmplteMigToTmf3Err Migration from a pre-D30 TMF environment to a D30 or later TMF environment is not complete. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text Migration to TMF3 has not been completed.
Descriptions of Event Messages Event Messages 293: ZTMF-EVT-BackupTakeSwitch The backup TMP has taken over control because an operator issued an ALTER TMF, SWITCHPROCESS TMP command on either a D-series or G-series RVU. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text Backup process has taken control from the primary process due to user request.
Descriptions of Event Messages Event Messages 294: ZTMF-EVT-NoTLEAvailable 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. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType is the subject token of the event message, and identifies the TMF process that generated the event.
Event Messages Descriptions of 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.
Descriptions of Event Messages Event Messages 295: ZTMF-EVT-TransHung The Backout process failed for the specified transaction, causing the transaction to be declared as hung for abort. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-TransID ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-TransID. token-type ZSPI-TYP-Boolean. Event-Message Text The transaction ZTMF-TKN-TransID is hung due to backout failure.
Descriptions of Event Messages Event Messages 296: ZTMF-EVT-TransAbort TMF aborted the specified network transaction because it exceeded the configured disconnect timer interval. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-TransID ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-TransID. token-type ZSPI-TYP-Boolean. Event-Message Text The transaction ZTMF-TKN-TransID was aborted due to exceeding the disconnect timer duration.
Descriptions of Event Messages Event Messages 297: ZTMF-EVT-DownNode TMF aborted a network transaction to the specified node because there was no reply from the node within the configured disconnect timer interval. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-NodeName ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 298: ZTMF-EVT-AlterDisconnect Using a TMFCOM ALTER BEGINTRANS, AUTOABORT command, an operator attempted to set the autoabort timer value lower than the configured disconnect timer value. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-DisconnTimer ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Int. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 299: ZTMF-EVT-AlterDisconnectTimer An operator issued a SNOOP SETDISCONNECTTMR command specifying a new disconnect timer value. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-DisconnTimer ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Int. token-type ZSPI-TYP-Boolean. Event-Message Text The disconnect timer has been altered to ZTMF-TKN-DisconnTimer seconds.
Descriptions of Event Messages Event Messages 300: ZTMF-EVT-CAT-DiskDumpPurgeErr The TMF catalog process was unable to purge the specified disk dump file because a file-system error occurred. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-CAT-DiskDumpFName32 ZTMF-TKN-CAT-FileError ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-FNAME32. ZSPI-TYP-Int. ZSPI-TYP-Boolean.
Event Messages Descriptions of 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.
Descriptions of Event Messages Event Messages 301: ZTMF-EVT-Cat-MediaAdded An operator or subsystem control program (SPI requester) issued an ADD TAPEMEDIA command. The specified tape volumes were added to the TMF catalog. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-Media ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZTMF-TYP-Media. token-type ZSPI-TYP-Boolean. Event-Message Text ZTMF-TKN-Media added to the TMF catalog.
Descriptions of Event Messages Event Messages 302: ZTMF-EVT-Cat-MediaNotAdded An operator or subsystem control program (SPI requester) issued an ADD TAPEMEDIA command. One or more of the specified tape volumes could not, however, be added to the catalog because a file-system error occurred. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-Media ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZTMF-TYP-Media. ZSPI-TYP-Int.
Event Messages Descriptions of 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.
Descriptions of Event Messages Event Messages 303: ZTMF-EVT-Cat-MediaAltered An operator or subsystem control program (SPI requester) issued an ALTER TAPEMEDIA command, specifying one or more tape volume names. The status of the specified tape volumes in the TMF catalog has been changed as requested. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-Media ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZTMF-TYP-Media. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 304: ZTMF-EVT-Cat-MediaNotAltered An operator or subsystem control program (SPI requester) issued an ALTER TAPEMEDIA command, specifying one or more tape volume names. The status of the specified tape volumes in the TMF catalog could not be changed because a file-system error occurred. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-Media ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum.
Descriptions of Event Messages Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number.
Descriptions of Event Messages Event Messages 305: ZTMF-EVT-Cat-MediaDeleted An operator or subsystem control program (SPI requester) issued a DELETE TAPEMEDIA command. The specified tape volumes have been deleted from the TMF catalog. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-Media ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZTMF-TYP-Media. token-type ZSPI-TYP-Boolean. Event-Message Text ZTMF-TKN-Media deleted from the TMF catalog.
Descriptions of Event Messages Event Messages 306: ZTMF-EVT-Cat-MediaNotDeleted An operator or subsystem control program (SPI requester) issued a DELETE TAPEMEDIA command, specifying one or more tape volume names. The specified tape volumes could not be deleted from the TMF catalog because a file-system error occurred. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-Media ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZTMF-TYP-Media.
Descriptions of Event Messages Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number.
Descriptions of Event Messages Event Messages 307: ZTMF-EVT-Cat-TapeDumpAdded An operator or subsystem control program (SPI requester) issued an ADD DUMPS command. The specified tape dumps with the specified serial number have been added to the TMF catalog. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-Media ZTMF-TKN-DumpSerial ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZTMF-TYP-Media. ZTMF-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 308: ZTMF-EVT-Cat-TapeDumpNotAdded An operator or subsystem control program (SPI requester) issued an ADD DUMPS command. The specified tape dumps with the specified serial number were not added to the TMF catalog because a file-system error occurred. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-Media ZTMF-TKN-DumpSerial ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum.
Descriptions of Event Messages Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number.
Descriptions of Event Messages Event Messages 309: ZTMF-EVT-Cat-DiskDumpAdded An operator or subsystem control program (SPI requester) issued an ADD DUMPS command. The specified disk dumps with the specified serial number have been added to the TMF catalog. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-FileName ZTMF-TKN-DumpSerial ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-FNAME. ZTMF-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 310: ZTMF-EVT-Cat-DiskDumpNotAdded An operator or subsystem control program (SPI requester) issued an ADD DUMPS command. The specified disk dumps with the specified serial number were not added to the TMF catalog because a file-system error occurred. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-FileName ZTMF-TKN-DumpSerial ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum.
Descriptions of Event Messages Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number.
Descriptions of Event Messages Event Messages 311: ZTMF-EVT-Cat-DumpFileAdded An operator or subsystem control program (SPI requester) issued an ADD DUMPS command. The specified dump files with the specified serial number have been added to the TMF catalog. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-FileName ZTMF-TKN-DumpSerial ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-FNAME. ZTMF-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 312: ZTMF-EVT-Cat-DumpFileNotAdded An operator or subsystem control program (SPI requester) issued an ADD DUMPS command. The specified dump files with the specified serial number were not added to the TMF catalog because a file-system error occurred. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-FileName ZTMF-TKN-DumpSerial ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum.
Descriptions of Event Messages Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number.
Descriptions of Event Messages Event Messages 313: ZTMF-EVT-Cat-DumpAltered An operator or subsystem control program (SPI requester) issued an ALTER DUMPS command. The dump entries for the specified file names and serial number have been altered in the TMF catalog. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-FileName ZTMF-TKN-DumpSerial ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-FNAME. ZTMF-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 314: ZTMF-EVT-Cat-DumpNotAltered An operator or subsystem control program (SPI requester) issued an ALTER DUMPS command. The dump entries for the specified file names and serial number were not altered in the TMF catalog because a file-system error occurred. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-FileName ZTMF-TKN-DumpSerial ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum.
Descriptions of Event Messages Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number.
Descriptions of Event Messages Event Messages 315: ZTMF-EVT-Cat-DumpDeleted An operator or subsystem control program (SPI requester) issued a DELETE DUMPS command. The dump entries for the specified file names and serial number have been deleted from the TMF catalog. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-FileName ZTMF-TKN-DumpSerial ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-FNAME. ZTMF-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 316: ZTMF-EVT-Cat-DumpNotDeleted An operator or subsystem control program (SPI requester) issued a DELETE DUMPS command. The dump entries for the specified file names and serial number were not deleted from the TMF catalog because a file-system error occurred.
Descriptions of Event Messages Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number.
Descriptions of Event Messages Event Messages 317: ZTMF-EVT-Cat-DMLocAltered An operator or subsystem control program (SPI requester) issued a RELOCATE DISKDUMPS command. The disk media location for the specified dump has been successfully changed in the TMF catalog. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-DumpSerial ZTMF-TKN-CAT-DiskDumpFName32 ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Int2. ZTMF-TYP-FNAME32. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 318: ZTMF-EVT-Cat-DMLocNotAltered An operator or subsystem control program (SPI requester) issued a RELOCATE DISKDUMPS command. The disk media location of the specified dump was not altered in the TMF catalog because a file-system error occurred. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-DiskDumpFName32 ZTMF-TKN-DumpSerial ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum.
Descriptions of Event Messages Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number.
Descriptions of Event Messages Event Messages 319: ZTMF-EVT-FRlist-NoCatalogEntry The specified file was included in the file list of a RECOVER FILES command but has no entries in the TMF Catalog. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-FRlist-FileName ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean. Event-Message Text The file ZTMF-TKN-FRlist-FileName has no entries in the Catalog.
Descriptions of Event Messages Event Messages 320: ZTMF-EVT-FRlist-NoValTCtgEntry The specified file was included in the file list of a RECOVER FILES command, it was found in the TMF Catalog (but with an error), and has no valid entries in the TMF Catalog prior to the designated timestamp. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-FRlist-FileName ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 321: ZTMF-EVT-FRlist-NoTSCtlgEntry The specified file was included in the file list of a RECOVER FILES command, but it was not found in the TMF Catalog, the WHEREPHYSVOLIS option was not specified in the command, and the file name was not found on disk. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-FRlist-FileName ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 322: ZTMF-EVT-Rm-Created An operator issued an ADD RESOURCEMANAGER command or a gateway process programmatically created a recoverable resource manager. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-RmName ZTMF-TKN-User ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-USERID. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 323: ZTMF-EVT-Rm-Removed An operator issued a DELETE RESOURCEMANAGER command or a gateway process programmatically deleted a recoverable resource manager. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-RmName ZTMF-TKN-User ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-USERID. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 324: ZTMF-EVT-Rm-Opened A gateway process programmatically opened a recoverable resource manager. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-RmName ZTMF-TKN-User ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-USERID. ZSPI-TYP-Boolean. Event-Message Text The Resource Manager ZTMF-TKN-RmName is successfully opened by the user ZTMF-TKN-User.
Descriptions of Event Messages Event Messages 325: ZTMF-EVT-Rm-Closed A gateway process programmatically closed a recoverable resource manager and there were no unresolved transaction branches against the resource manager. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-RmName ZTMF-TKN-User ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-USERID. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 326: ZTMF-EVT-Rm-Crashed A gateway process programmatically closed a recoverable resource manager, but there was at least one unresolved transaction branch against the resource manager. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-RmName ZTMF-TKN-User ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-USERID. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 327: ZTMF-EVT-OperatorReason If TMVIEW is installed, this event is generated whenever an operator uses TMVIEW to initiate an operation for which TMVIEW requires that a reason be entered for doing so. This event is useful in reconstructing the sequence of operator actions involved in a particular situation. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-Obj ZTMF-TKN-Cmd ZTMF-TKN-Reason ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum.
Descriptions of Event Messages Event Messages 328: ZTMF-EVT-LateDpCheckin This event message is informational only. Its purpose is to help identify the application or SQL component that is causing late checkins. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-VolumeName ZTMF-TKN-CpuPair ZTMF-TKN-CpuPair ZTMF-TKN-TransID ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Int. token-type ZSPI-TYP-Int. token-type ZSPI-TYP-TransID.
Descriptions of Event Messages Event Messages 329: ZTMF-EVT-GiveSwitchRefused A PUP PRIMARY or a TMFCOM ALTER TMF, SWITCHPROCESS TMP command was attempted while TMF was writing to the audit trails, and audit writing has been disabled because an audit trail is full. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text Operation Cannot Complete Until Audit Writing is Allowed.
Descriptions of Event Messages Event Messages 330: ZTMF-EVT-AlterSessionIdleTimer This event is issued whenever the session idle timer is set to a new value by using the SNOOP SetSessionIdleTmr command. A transaction that spans two or more network nodes causes the establishment of a peer-to-peer session between the $TMP processes on each node.
Descriptions of Event Messages Event Messages 331: ZTMF-EVT-Rcov-ExtSeg-Too-Small A TMF recovery process, usually backout, has insufficient extended memory to perform the required recovery. This occurs when a large number of data volumes (over 200) have been accessed by the recovery process. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text Process abending because of insufficient extended segment size.
Descriptions of Event Messages Event Messages 332: ZTMF-EVT-AuditRead-Error 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. Event-Message Text The Start TMF failed due to audit read error: ZTMF-TKNAuditReadException ****** Contact your Support representative.
Descriptions of Event Messages Event Messages 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. Recommended Action If the audit read exception is ZTMF-VAL-ARExcp-Format2File or ZTMF-VAL-ARExcpFormat2Rec, the current version of TMF supports only Format 1 audit trail files but the TMP encountered a Format 2 file or record.
Descriptions of Event Messages Event Messages 333: ZTMF-EVT-NetGramTimeout A NetGram send timer to a remote node was exceeded. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-NodeName ZTMF-TKN-TransID ZTMF-TKN-NetGramInReqBuff ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-TransID. ZSPI-TYP-Boolean. ZSPI-TYP-Boolean. Event-Message Text A request was resent to ZTMF-TKN-NodeName for transaction ZTMF-TKN-TransID.
Event Messages • Descriptions of Event Messages Supporting documentation such as Event Management Service (EMS) logs, trace files, and a CPU dump, if applicable 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.
Descriptions of Event Messages Event Messages 350: ZTMF-EVT-FRlist-ErrFromTmp A file-system error was returned by the TMP while the File Recovery List process was attempting to retrieve information about the specified physical data volume. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-FRlist-PhysicalVName ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Int. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number. Determine how to resolve the file-system error and reissue the RECOVER FILES command.
Descriptions of Event Messages Event Messages 351: ZTMF-EVT-FRlist-ErrFromDatavol A file-system error was returned while the File Recovery List process was attempting to retrieve file-related information from the specified physical data volume.
Descriptions of Event Messages Event Messages ZEMS-TKN-Emphasis is set to False for this event. Effect Recovery is not attempted on the specified volume. Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated file-system error number. Determine how to resolve the file-system error and reissue the RECOVER FILES command.
Descriptions of Event Messages Event Messages 352: ZTMF-EVT-FRlist-NoCatalogEntry The FROMARCHIVE option was specified in a RECOVER FILES command, but no entry was found in the TMF Catalog for the specified database table or file. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-FRlist-LogicalFName ZTMF-TKN-FRlist-PhysicalFName ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-String. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 353: ZTMF-EVT-FRlist-FileNotFound Although the virtual disk process (VDP) identified the specified database table or file, no match was found on the specified database volume. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-FRlist-LogicalFName ZTMF-TKN-FRlist-PhysicalFName ZTMF-TKN-FRlist-PhysicalVName ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-String.
Descriptions of Event Messages Event Messages Effect Recovery is not attempted on the specified database table or file. Recommended Action Issue another RECOVER FILES command specifying the proper physical volume name.
Descriptions of Event Messages Event Messages 354: ZTMF-EVT-FRlist-LogicalNotUndo The operator did not specify the FROMARCHIVE option. The File Recovery List process expected that the specified database table or file would have its UNDONEEDED flag set, but it did not. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-FRlist-LogicalFName ZTMF-TKN-FRlist-PhysicalFName ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-String.
Descriptions of Event Messages Event Messages 355: ZTMF-EVT-Rcov-FsError4 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.
Descriptions of Event Messages 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.
Descriptions of Event Messages 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.
Descriptions of Event Messages Event Messages 356: ZTMF-EVT-Rcov-FsError5 A file-system error occurred for the specified file while a recovery process was attempting the specified operation. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-RCOV-FileName-1 ZTMF-TKN-RCOV-FileName-2 ZTMF-TKN-RCOV-FsError ZTMF-TKN-RCOV-Op-of-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-String. ZSPI-TYP-Int.
Descriptions of Event Messages Event Messages ZTMF-VAL-RCOV-CHANGEFLAB ZTMF-VAL-RCOV-OPEN ZTMF-VAL-RCOV-FLUSHFILES ZTMF-VAL-RCOV-FLUSHAUDIT ZTMF-VAL-RCOV-CLEARFLAGS ZTMF-VAL-RCOV-READ ZTMF-VAL-RCOV-POSITION ZEMS-TKN-Emphasis is set to False for this event. 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.
Descriptions of Event Messages Event Messages 357: ZTMF-EVT-Rcov-FsError6 A file-system error occurred while performing the specified operation on the specified database table or file. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-RCOV-FileName-1 ZTMF-TKN-RCOV-FileName-2 ZTMF-TKN-RCOV-FsError ZTMF-TKN-RCOV-Op-of-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-String. ZSPI-TYP-Int. ZSPI-TYP-Enum.
Descriptions of Event Messages Event Messages ZTMF-VAL-RCOV-FLABMODUNDO ZTMF-VAL-RCOV-CHANGEFLAB ZTMF-VAL-RCOV-OPEN ZTMF-VAL-RCOV-FLUSHFILES ZTMF-VAL-RCOV-FLUSHAUDIT ZTMF-VAL-RCOV-CLEARFLAGS ZTMF-VAL-RCOV-READ ZTMF-VAL-RCOV-POSITION ZEMS-TKN-Emphasis is set to False for this event. Effect The recovery process immediately terminates any further operations on the specified volume. The volume is not available for transaction processing.
Descriptions of Event Messages Event Messages 358: ZTMF-EVT-Rcov-StopObjectRcov2 A recovery process has encountered an error for the specified file or volume and has terminated recovery. The preceding event message in the EMS log generated by the recovery process (event 168 or 169) specifies the particular error and other related information. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages ZTMF-TKN-RCOV-VolumeName-1 if present, is the subject token of the event message, and it contains the name of the disk volume that was being recovered. Effect See the effect text associated with the preceding event message generated by the particular recovery process (168 or 169). Recommended Action See the recommended action text associated with the preceding event message generated by the particular recovery process (168 or 169).
Descriptions of Event Messages Event Messages 359: ZTMF-EVT-Rcov-EndAtFileHiatus2 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.
Descriptions of Event Messages 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).
Descriptions of Event Messages Event Messages 390: ZTMF-EVT-Rm-SetRmSlotArrayFail The maximum resource manager slot array size set during Start TMF was exceeded. A new resource manager slot array size is generated. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-RM-SlotArraySize ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Int. token-type ZSPI-TYP-Boolean. Event-Message Text The maximum RM branch slot array size set during Start TMF has been exceeded.
Descriptions of Event Messages Event Messages 391: ZTMF-EVT-Rm-SetBrSlotArrayFail The maximum resource manager branch slot array size was exceeded while reinstating in-doubt transaction branches. A new resource manager branch slot array size is generated. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-RM-SlotArraySize ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Int. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 392: ZTMF-EVT-Rm-OpClosedClosed An operator issued a CLOSE RESOURCEMANAGER command and there were no unresolved transaction branches against the resource manager. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-RmName ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean. Event-Message Text The resource manager ZTMF-TKN-RmName is successfully closed. An operator closed the resource manager.
Descriptions of Event Messages Event Messages 393: ZTMF-EVT-Rm-OpClosedCrashed An operator issued a CLOSE RESOURCEMANAGER command, but there was at least one unresolved transaction branch against the resource manager. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-RmName ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean. Event-Message Text The resource manager ZTMF-TKN-RmName is successfully closed.
Descriptions of Event Messages Event Messages 394: ZTMF-EVT-Rm-CpuDownClosed A recoverable resource manager has been closed because of a CPU failure and there were no unresolved transaction branches against the resource manager. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-RmName ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 395: ZTMF-EVT-Rm-CpuDownCrashed A recoverable resource manager has been closed because of a CPU failure and there is at least one unresolved transaction branch against the resource manager. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-RmName ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-String. token-type ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 400: ZTMF-EVT-FRToMatPosition 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 ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Int2. ZSPI-TYP-Int2. ZSPI-TYP-Int4.
Descriptions of Event Messages 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.
Descriptions of Event Messages Event Messages 401: ZTMF-EVT-FRRedoPassComplete 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 ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Int2. ZSPI-TYP-Int2. ZSPI-TYP-Int4. ZSPI-TYP-Boolean.
Descriptions of Event Messages 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.
Descriptions of Event Messages Event Messages 402: ZTMF-EVT-FRFilTrnsPassComplete 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 ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Int2. ZSPI-TYP-Int2. ZSPI-TYP-Int4. ZSPI-TYP-Boolean.
Descriptions of Event Messages 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.
Descriptions of Event Messages Event Messages 403: ZTMF-EVT-FRUndoPassComplete 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 ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Int2. ZSPI-TYP-Int2. ZSPI-TYP-Int4. ZSPI-TYP-Boolean.
Descriptions of Event Messages 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.
Descriptions of Event Messages Event Messages 404: ZTMF-EVT-NoUnDumpedATFiles TMF was starting and did not find an undumped audit trail. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text TMF could not find any undumped audit trail files for the ZTMF-TKN-AuditTrailID Audit Trail during startup.
Descriptions of Event Messages Event Messages If the problem persists, contact your service provider and provide all relevant information as follows: • • • Description of the problem and accompanying symptoms Details from the message or messages generated Supporting documentation such as Event Management Service (EMS) logs, trace files, and a CPU dump, if applicable If your local operating procedures require contacting the Global Customer Support Center (GCSC), supply your system number and the numbers
Descriptions of Event Messages Event Messages 430: ZTMF-EVT-CtgAlterRR The operator enabled or disabled round-robin mode for the TMF Catalog. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-CtgRoundRobin ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. token-type ZSPI-TYP-Boolean. Event-Message Text Round robin attribute of the Catalog altered to ZTMF-TKNCtgRoundRobin.
Descriptions of Event Messages Event Messages 431: ZTMF-EVT-ATAlterMaxRetainedATF The operator altered the value of the MAXRETAINEDATFileS attribute of the master audit trail (MAT). Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-MAXRETAINEDATFileS ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Int. token-type ZSPI-TYP-Boolean. Event-Message Text MaxRetainedATFiles attribute of MASTER Audit Trail altered to ZTMF-TKN-MAXRETAINEDATFileS.
Descriptions of Event Messages Event Messages 432: ZTMF-EVT-ATRestoreDMDSuccess This event is used for disk-media dumps to indicate successful completion of a restore. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZART-TKN-SEQNUM ZTMF-TKN-AuditFileName ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-Int. ZSPI-TYP-String. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Effect None. Recommended Action Informative message only; no corrective action is needed.
Descriptions of Event Messages Event Messages 433: ZTMF-EVT-ComponentStatus This event tracks the progress of each of the sixteen TMP components. This message can be used to determine the state of the TMP if TMF fails to start. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-ComponentOwnership ZTMF-TKN-ComponentType ZTMF-TKN-ComponentStatus ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-Enum.
Descriptions of Event Messages Event Messages ZTMF-TKN-ComponentType specifies the component for which status is being reported. The values are: 1 AuditTrailMgmt 2 DataVolMgmt 3 FileRecovMgmt 4 ProcessMgmt 5 OnlineDumpMgmt 6 ResourceManager 8 TmpTip 11 BackoutMgmt 12 CatalogMgmt 13 ControlPtMgmt 14 MatWriteMgmt 15 ScanTrailsMgmt 16 TmpNetMgmt 17 TranCtrlMgmt 18 TranEventMgmt 19 VolRcovMgmt ZTMF-TKN-ComponentStatus specifies the status for the designated component.
Descriptions of Event Messages Event Messages Effect The designated TMP component is in the specified start/stop state. Recommended Action Informative message only; no corrective action is needed.
Descriptions of Event Messages Event Messages 434: ZTMF-EVT-Rcov-NoNodeNameInAt This event describes a problem in the audit trails that are being used to recover files when the SETDRMODE flag has been set on. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text File Recovery in DR mode could not find a Node name in the Audit Trail.
Descriptions of Event Messages Event Messages 435: ZTMF-EVT-FRlist-CantRecovFile2 This event indicates that two files are being mapped to the same target file from the mapping specified. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-RCOV-FileName-1 ZTMF-TKN-RCOV-FileName-2 ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-String. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages 436: ZTMF-EVT-FRlist-CantRecovFile3 This event indicates that the specified file could not be recovered because it is now being audited to a different audit trail than it was when it was dumped.. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-RCOV-FileName-1 ZTMF-TKN-AuditTrailID ZTMF-TKN-AuditTrailID2 ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Enum. ZSPI-TYP-Enum.
Descriptions of Event Messages Event Messages ZTMF-TKN-AuditTrailID2 specifies which audit trail the file is now being audited to. The values are: ZTMF-VAL-Mat Master audit trail ZTMF-VAL-Aux01 Auxiliary audit trail #1 ZTMF-VAL-Aux02 Auxiliary audit trail #2 ... ZTMF-VAL-Aux15 Auxiliary audit trail #15 ZEMS-TKN-Emphasis is set to False for this event. Effect Recovery of the specified file is terminated.
Descriptions of Event Messages Event Messages 437: ZTMF-EVT-Rcov-FsErrorPurge 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.
Descriptions of Event Messages Event Messages Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType identifies the TMF process that generated the event. The value of this token for this event is ZTMF-VAL-PROC-FILERECOVERY. ZTMF-TKN-RCOV-FileName-1 is the subject token of the event message, and it contains the name of the database table or file that was being recovered. ZTMF-TKN-RCOV-FileName-2 contains the logical name of the database table or file.
Descriptions of Event Messages Event Messages Effect This event message is accompanied by event 358. The file is marked either “redoneeded” or “undo-needed” and is no longer available for transaction processing. Recommended Action The event is serious and file recovery is needed. When TMF is recovering a file to a new location and encounters a purge audit record for the source object, unintended consequences can result if TMF queues the audit record to the disk process.
Descriptions of Event Messages Event Messages 438: ZTMF-EVT-AtMaxImpending The audit-trail sequence number is approaching the maximum of 999999. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-AuditFileName ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Boolean. Event-Message Text The ZTMF-TKN-AuditTrailID Audit Trail Sequence Number is Critically High.
Descriptions of Event Messages Event Messages Effect Transaction processing continues. Recommended Action This warning message is critical. If the audit generation fills to 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.
Descriptions of Event Messages Event Messages 440: ZTMF-EVT-ATAlterFilesize An operator or subsystem control program (SPI requester) changed the audit-trail file size. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-ATFileSize32 ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-Int2. ZSPI-TYP-Boolean. Event-Message Text Filesize attribute of ZTMF-TKN-AuditTrailID Audit Trail altered to ZTMF-TKN-ATFileSize32.
Descriptions of Event Messages Event Messages Effect The file size of the specified audit trail is now the specified value. Recommended Action Informative message only; no corrective action is needed.
Descriptions of Event Messages Event Messages 441: ZTMF-EVT-ATAlterATFormat An operator or subsystem control program (SPI requester) changed the audit-trail file format. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-ATFileFormat ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Int. token-type ZSPI-TYP-Boolean. Event-Message Text The TMF audittrail file format has been altered to format ZTMF-TKN-ATFileFormat.
Descriptions of Event Messages Event Messages 442: ZTMF-EVT-ATCantCreateNewFile An operator or subsystem control program (SPI requester) changed the audit-trail file size 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.
Descriptions of Event Messages Event Messages ZEMS-TKN-Emphasis is set to True for this event. Effect The create operation fails and the file is not replaced. Recommended Action Correct the problem so that future attempts to create files that have the proper format and file size succeed.
Descriptions of Event Messages Event Messages 445: ZTMF-EVT-NoTLEDelayOccurring The Backout process is delaying, waiting to 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 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.
Descriptions of Event Messages Event Messages 450: ZTMF-EVT-AlterTmpWaitTimer An operator or subsystem control program (SPI requester) issued an ALTER TMF TMPWAITTIMER command, changing the TMPWAITTIMER attribute value. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType token-type ZSPI-TYP-Enum. ZTMF-TMA-TmpWaitTimer token-type ZTMF-DDL-TmpWaitTimer. ZEMS-TKN-Emphasis token-type ZSPI-TYP-Boolean. Additional Conditional Tokens ZTMF-TMA-TmpWaitTimer-Prev token-type ZTMF-DDL-TmpWaitTimer.
Descriptions of Event Messages Event Messages Additional Conditional Tokens ZTMF-TMA-TmpWaitTimer-Prev if present, is also a subject token of the event message, and it specifies the old TmpWaitTimer attribute(s). This structure contains the ZTMF-DDLTmpWaitTimer.ZType field, which has one of the following values: ZTMF-VAL-TmpWaitTimer-Off ZTMF-VAL-TmpWaitTimer-Auto ZTMF-VAL-TmpWaitTimer-Man If the value is ZTMF-VAL-TmpWaitTimer-Man, the ZTMF-DDLTmpWaitTimer.
Descriptions of Event Messages Event Messages 451: ZTMF-EVT-AlterTransProtocol An operator or subsystem control program (SPI requester) issued an ALTER TMF TRANSACTIONPROTOCOL command, changing the TRANSACTIONPROTOCOL attribute value. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-TransProtocol ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Int. token-type ZSPI-TYP-Boolean. Additional Conditional Tokens ZTMF-TKN-TransProtocol-Prev token-type ZSPI-TYP-Int.
Descriptions of Event Messages Event Messages Effect The new attribute value takes effect immediately. Recommended Action Informative message only; no corrective action is needed.
Descriptions of Event Messages Event Messages 455: ZTMF-EVT-AlterPioBuffer An operator or subsystem control program (SPI requester) issued an ALTER TMF PIOBUFFER command, changing the PIOBUFFER attribute value. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TMA-PioBuffer ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZTMF-DDL-PioBuffer. token-type ZSPI-TYP-Boolean. Additional Conditional Tokens ZTMF-TMA-PioBuffer-Prev token-type ZTMF-DDL-PioBuffer.
Descriptions of Event Messages Event Messages ZTMF-DDL-PioBuffer.ZPioDelayTimer specifies the new piodelaytimer attribute value ZEMS-TKN-Emphasis is set to False for this event. Additional Conditional Tokens ZTMF-TMA-PioBuffer-Prev if present, is also a subject token of the event message, and contains the following fields: ZTMF-DDL-PioBuffer.ZPioBufferSize specifies the old piobuffersize attribute value ZTMF-DDL-PioBuffer.
Descriptions of Event Messages Event Messages 456: ZTMF-EVT-AlterGoRemote An operator or subsystem control program (SPI requester) successfully changed the GOREMOTE attribute by using an ALTER TMF command. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-GoRemote ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Int. token-type ZSPI-TYP-Boolean. Additional Conditional Tokens ZTMF-TKN-GoRemote-Prev token-type ZSPI-TYP-Int.
Descriptions of Event Messages Event Messages Effect The GOREMOTE attribute is set to the new value. Recommended Action Informative message only; no corrective action is needed.
Descriptions of Event Messages Event Messages 460: ZTMF-EVT-FileSetScanErr Problems were encountered while scanning the file-sets specified by the user (either directly in the command or within the file containing filenames). Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text The FRList process encountered invalid conditions while scanning the file-set-list or the not-file-set-list.
Descriptions of Event Messages Event Messages 461: ZTMF-EVT-DefaultTmpWaitTimer The current TmpWaitTimer value was automatically changed from AUTO to OFF as part of migration to TMF 3.3. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text The Current TmpWaitTimer value has been automatically changed from AUTO to OFF as part of migration to this release.
Descriptions of Event Messages Event Messages 465: ZTMF-EVT-ZLTCHNotSupported The specified active audit-trail volume does not support commit-hold processing. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-EVTHDR-OperationType ZTMF-TKN-AuditTrailID ZTMF-TKN-VolumeName ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages ZTMF-TKN-AuditTrailID is the subject token of the event message, and specifies which audit trail the message applies to. The values are: ZTMF-VAL-Mat Master audit trail ZTMF-VAL-Aux01 Auxiliary audit trail #1 ZTMF-VAL-Aux02 Auxiliary audit trail #2 . . . ZTMF-VAL-Aux15 Auxiliary audit trail #15 ZTMF-TKN-VolumeName specifies the name of the active audit-trail volume that cannot support commit-hold processing.
Descriptions of Event Messages Event Messages 466: ZTMF-EVT-ZLTCHTimeOut The commit-hold timer timed out. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-ZLTCHTimeoutAction ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Boolean. Event-Message Text The CommitHold Timer has expired causing TMF to ZTMF-TKNZLTCHTimeoutAction. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType identifies the TMF process that generated the event.
Descriptions of Event Messages Event Messages 467: ZTMF-EVT-ZLTCHChngStateError An audit disk process returned a file-system error while the operator or a subsystem control program (SPI requester) was attempting to change the commit-hold state of an active audit trail volume.
Descriptions of Event Messages Event Messages ZTMF-TKN-ZLTCH-State specifies the new commit-hold state that could not be set. The values are: ZTMF-VAL-ZLTCH-Unconfigured Unconfigured. ZTMF-VAL-ZLTCH-On On. ZTMF-VAL-ZLTCH-Off Off. ZTMF-VAL-ZLTCH-Activate Activated. ZTMF-VAL-ZLTCH-Suspend Suspended. ZTMF-VAL-ZLTCH-Reviving Reviving. ZTMF-VAL-ZLTCH-Unsupported Unsupported. ZEMS-TKN-Emphasis is set to True for this event.
Descriptions of Event Messages Event Messages 468: ZTMF-EVT-ZLTCHChngVolState The operator or a subsystem control program (SPI requester) changed the commithold state of the specified active audit-trail volume. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-VolumeName ZTMF-TKN-ZLTCH-State ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages ZTMF-TKN-ZLTCH-State This token occurs twice. The first occurrence specifies the new (current) commithold state while the second occurrence specifies the old (previous) commit-hold state. The values are: ZTMF-VAL-ZLTCH-Unconfigured Unconfigured. ZTMF-VAL-ZLTCH-On On. ZTMF-VAL-ZLTCH-Off Off. ZTMF-VAL-ZLTCH-Activate Activated. ZTMF-VAL-ZLTCH-Suspend Suspended. ZTMF-VAL-ZLTCH-Reviving Reviving. ZTMF-VAL-ZLTCH-Unsupported Unsupported.
Descriptions of Event Messages Event Messages 469: ZTMF-EVT-ZLTCHChngTrailState The operator or a subsystem control program (SPI requester) changed the commithold state of the specified audit trail. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-ZLTCH-State ZEMS-TKN-Emphasis token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages ZTMF-TKN-ZLTCH-State This token occurs twice. The first occurrence specifies the new (current) commithold state while the second occurrence specifies the old (previous) commit-hold state. The values are: ZTMF-VAL-ZLTCH-Unconfigured Unconfigured. ZTMF-VAL-ZLTCH-On On. ZTMF-VAL-ZLTCH-Off Off. ZTMF-VAL-ZLTCH-Activate Activated. ZTMF-VAL-ZLTCH-Suspend Suspended. ZTMF-VAL-ZLTCH-Reviving Reviving. ZTMF-VAL-ZLTCH-Unsupported Unsupported.
Descriptions of Event Messages Event Messages 470: ZTMF-EVT-ZLTCHChngTmpState The operator or a subsystem control program (SPI requester) changed the commithold state. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-ZLTCH-State ZEMS-TKN-Emphasis token-type ZSPI-TYP-Enum. token-type ZSPI-TYP-Int. token-type ZSPI-TYP-Boolean. Event-Message Text The CommitHold state has changed from ZTMF-TKN-ZLTCH-State(2) to ZTMF-TKN-ZLTCH-State(1).
Descriptions of Event Messages Event Messages Effect The commit-hold state is changed as specified. Recommended Action Informative message only; no corrective action is needed.
Descriptions of Event Messages Event Messages 471: ZTMF-EVT-ZLTCHAlterConfig An operator or subsystem control program (SPI requester) successfully changed the commit-hold mode, commit-hold timer (for the Mat only), or the timeout action attribute of an audit trail.
Descriptions of Event Messages Event Messages ZTMF-TKN-AuditTrailID is the subject token of the event message, and specifies which audit trail the message applies to. The values are: ZTMF-VAL-Mat Master audit trail ZTMF-VAL-Aux01 Auxiliary audit trail #1 ZTMF-VAL-Aux02 Auxiliary audit trail #2 . . . ZTMF-VAL-Aux15 Auxiliary audit trail #15 ZTMF-TKN-ZLTCH-State This token occurs twice.
Descriptions of Event Messages Event Messages Effect The new attribute value(s) take effect immediately. Recommended Action Informative message only; no corrective action is needed.
Descriptions of Event Messages Event Messages 472: ZTMF-EVT-ZLTCHCheckError An audit disk process returned a file-system error while the TMP was checking to see if commit-hold mode is supported by the specified active audit-trail volume. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-VolumeName ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int.
Descriptions of Event Messages Event Messages Effect The TMP does not ascertain whether commit-hold mode is supported by the specified active audit-trail volume. Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated error number. Try to resolve the problem. The subsystem periodically attempts to restart the TMP.
Descriptions of Event Messages Event Messages 473: ZTMF-EVT-ZLTCHGetError A file-system error occurred while the TMP was getting the current ZLTCH state from an audit-trail volume disk process. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-ProcessType ZTMF-TKN-AuditTrailID ZTMF-TKN-VolumeName ZTMF-TKN-Fs-Error ZEMS-TKN-Emphasis token-type token-type token-type token-type token-type ZSPI-TYP-Enum. ZSPI-TYP-Enum. ZSPI-TYP-String. ZSPI-TYP-Int. ZSPI-TYP-Boolean.
Descriptions of Event Messages Event Messages Effect The TMP does not ascertain the current ZLTCH state for the specified active audit-trail volume. Recommended Action Refer to the Guardian Procedure Errors and Messages Manual for corrective action for the indicated error number. Try to resolve the problem. The subsystem periodically attempts to restart the TMP.
Event Messages Descriptions of Event Messages HP NonStop TMF Management Programming Manual—540140-002 6 -442
7 Error and Warning Messages This section provides a description for each TMF subsystem error (including command syntax and execution errors, SPI errors and warnings, TMF dump/restore errors and warnings, and archive tape errors and warnings). The SPI standard token ZSPI-TKNRETCODE contains a nonzero value if the TMFSERVE process detects an error in a command message—or while attempting to perform a command.
Error and Warning Messages Error Information and Failure Data Capture Error Information and Failure Data Capture If a TMF subsystem internal error or a software or hardware failure occurs, capture as much information about the problem as possible. Then, contact the Global Customer Support Center (GCSC) or your service provider and provide all the relevant information.
Error and Warning Messages Errors Errors The errors returned by the TMF subsystem are listed and described in this section. 01 ZTMF-ERR-INVALIDMEDIANAME The specification for a TAPEMEDIA attribute is invalid. If the tape volume name begins with a digit, all characters must be digits. If the tape volume name begins with a letter, the characters can be alphanumeric. Also, part:copy might be required for this particular command.
Error and Warning Messages 09 Errors ZTMF-ERR-ONETRANSIDREQUIRED Exactly one transaction identifier is required (within this context). 10 ZTMF-ERR-INVALIDTRANSID An invalid transaction identifier was specified. The ZTMF-TKN-TRANSID token supplied within the error list provides additional information. 11 ZTMF-ERR-WILDCARDTRANSID A transaction identifier cannot contain any wildcard (*) syntax (within this context).
Error and Warning Messages 30 Errors ZTMF-ERR-INVALIDVOLUME The specified volume name is invalid. The ZTMF-TKN-VOLUME token supplied within the error list provides additional information. 31 ZTMF-ERR-VOLUMEREMOTE In this context, a volume name may not be remote. The ZTMF-TKN-VOLUME token supplied within the error list provides additional information. 33 ZTMF-ERR-INVALIDCOPIES The COPIES attribute must specify a value of 1 or 2 for PARALLEL copies—or a value between 1 and 3 for SERIES copies.
Error and Warning Messages 40 Errors ZTMF-ERR-INVALIDSERIESCOPIES The specified SERIES attribute is invalid. 41 ZTMF-ERR-INVALIDVERIFYTAPE The specified VERIFYTAPE attribute is invalid. 42 ZTMF-ERR-INVALIDBLOCKSIZE The specified BLOCKSIZE attribute is invalid. 43 ZTMF-ERR-STRUCTREQUIRED A structure must be supplied with this command. 44 ZTMF-ERR-VOLUMEWILD A volume name cannot be specified with the wildcard (*) syntax (within this context).
Error and Warning Messages 54 Errors ZTMF-ERR-INVALIDLABELMEDIA The specified LABEL attribute is invalid or not present. 55 ZTMF-ERR-INVALIDUNLOADMEDIA The specified UNLOAD attribute is invalid. 56 ZTMF-ERR-INVALIDMATSNFATSN One (or both) audit-trail sequence number(s) is/are invalid. 57 ZTMF-ERR-NOMATSNFATSN An audit-trail sequence number must be specified with this command. 58 ZTMF-ERR-FILENAMEWILD A filename cannot be specified with the wildcard (*) syntax (within this context).
Error and Warning Messages 67 Errors ZTMF-ERR-ADDMEDIAINCONSISTENT The combination of attributes specified for the ADD TAPEMEDIA command is inconsistent. The LABEL attribute must always be present. If LABEL OFF is specified, the STATUS attribute must be present. If LABEL ON is specified, the DRIVE attribute must be present. 69 ZTMF-ERR-INVALIDRESOLVESTATE The specified STATE value is invalid or not present. ABORTED or ENDED are valid values.
Error and Warning Messages 78 Errors ZTMF-ERR-DISKMEDIARESET You cannot change a DISKMEDIA attribute with a RESET command (within this context). 79 ZTMF-ERR-DISKMEDIAWILD Attributes for DISKMEDIA cannot contain wildcard (*) syntax (within this context). 80 ZTMF-ERR-MEDIANOTALLOWED The TAPEMEDIA attribute is only allowed with the MEDIUM TAPE attribute. 81 ZTMF-ERR-DISKMEDIAREQUIRED At least one DISKMEDIA attribute entry is required with the MEDIUM DISK attribute.
Error and Warning Messages 92 Errors ZTMF-ERR-INVRECOVERYMODE The value supplied for the RecoveryMode attribute is invalid. 93 ZTMF-ERR-INVIGNOREPREVCFLAG The value supplied for the IGNOREPREVIOUSCONFIG flag is invalid. 94 ZTMF-ERR-INVDATAVOLSTATE The value supplied for the data volume state specifier is invalid. 95 ZTMF-ERR-INVALLOWINCONSISTFLAG The value supplied for the ALLOWINCONSISTENCY flag is invalid. 96 ZTMF-ERR-INVABRUPTFLAG The value supplied for the ABRUPT flag is invalid.
Error and Warning Messages 105 Errors ZTMF-ERR-CURSORREUSED The TMF ran out of resources to process the command. 106 ZTMF-ERR-EMPTYCHILDREN Empty children were encountered. 108 ZTMF-ERR-INVSTATUSDETAIL A STATUS TRANSACTION command specified the STATUS DETAIL option with an illegal value. 110 ZTMF-ERR-INVALIDOPERSTATE The command specified an erroneous STATE value. 111 ZTMF-ERR-INVALIDOPERTYPE The command specified an erroneous TYPE value.
Error and Warning Messages 118 Errors ZTMF-ERR-INVAUTOABORT The ALTER BEGINTRANS command specified an erroneous ZAUTOABORT token value. 119 ZTMF-ERR-INVALIDDISKMEDIASTR The specified DISKMEDIA string is not correctly formed. The ZTMF-TKN-ADDDISKMEDIA or ZTMF-TKN-DELDISKMEDIA token supplied within the error list provides additional information. 120 ZTMF-ERR-DISKMEDIASTRNWINVAL The command specified an invalid DISKMEDIA name for a remote disk volume.
Error and Warning Messages 127 Errors ZTMF-ERR-INVACTIVEVOLUME An invalid disk volume name was supplied with the ACTIVEVOL attribute of an ADD AUDITTRAIL command. 128 ZTMF-ERR-INVOVERFLOWVOLUME An invalid disk volume name was supplied with the OVERFLOWVOL attribute of an ADD AUDITTRAIL command. 129 ZTMF-ERR-INVRESTOREVOLUME An invalid disk volume name was supplied with the RESTOREVOL attribute of an ADD AUDITTRAIL command.
Error and Warning Messages 135 Errors ZTMF-ERR-INVFILESIZE This error is returned by an ADD AUDITTRAIL command if the value specified for the ZFILESIZE field in the extensible structured token is invalid. Valid values are 1 through 2047, inclusive. 136 ZTMF-ERR-INVOVERFLOWTHRESHOLD This error is returned by an ADD and ALTER AUDITTRAIL command if the value specified for the ZOVERFLOWTHRESHOLD field in the extensible structured token is invalid. Valid values are 50 through 100, inclusive.
Error and Warning Messages 141 Errors ZTMF-ERR-NOSTATEWITHOPERNUM A STATUS OPERATIONS command that specified the STATE parameter also specified an operation number. The ZTMF-TKN-OPERATIONNUM token supplied within the error list provides additional information. 142 ZTMF-ERR-NOTIMEWITHOPERNUM A STATUS OPERATIONS command that specified the BEGINTIME parameter also specified an operation number. The ZTMF-TKN-OPERATIONNUM token supplied within the error list provides additional information.
Error and Warning Messages 149 Errors ZTMF-ERR-INVALIDOLDDMLOC The command failed because the OLDDMLOC parameter did not contain a valid volume name. 150 ZTMF-ERR-MUSTSPECIFYNEWDMLOC The command expected the token ZTMF-TKN-NEWDMLOC, but it wasn’t present. 151 ZTMF-ERR-INVALIDNEWDMLOC The command failed because the NEWDMLOC parameter did not contain a valid volume name.
Error and Warning Messages 158 Errors ZTMF-ERR-TOOMANYPROCESSTYPE This error is returned if a command contained more than one ZTMF-TKN-PROCESSTYPE token. No error list is included in the response. 160 ZTMF-ERR-INVWHEREPHYSVOLIS This error is returned if the System Managed Storage (SMS) volume name supplied in the ZTMF-TKN-WHEREPHYSVOLIS token of a RECOVER FILES command is invalid. No error list is included in the response.
Error and Warning Messages 166 Errors ZTMF-ERR-TOPHYSVOLISREQUIRED This error is returned if a RECOVER FILES command included a ZRECOVERVDPHASE1 token, but no TOPHYSVOL token. No error list is included in the response. 168 ZTMF-ERR-INVRMOPENPERCPU This error is returned if the specified RMOPENPERCPU value in an ALTER BEGINTRANS command was invalid. No error list is included in the response.
Error and Warning Messages 173 Errors ZTMF-ERR-WILDORRMNAMENOTBOTH This error is returned if an INFO RESOURCEMANAGER or STATUS RESOURCEMANAGER command request included both a wild-card character (*) and a resource manager name to identify the resource managers for which to display information. You can include either of these entries, but not both in the same request. No error list is included in the response.
Error and Warning Messages 179 Errors ZTMF-ERR-TOOMANYMAPNAMES This error is returned if there is more than one ZTMF-TKN-MAPNAMESET token in the message. No error list is included in the response. 180 ZTMF-ERR-INVMAPNAMESDEFAULT This error is returned if the ZTMF-TKN-MAPNAMESDEFAULT token is badly formed. No error list is included in the response. 181 ZTMF-ERR-TOOMANYMAPNAMESDEFAUL This error is returned if there is more than one ZTMF-TKNMAPNAMESDEFAULT token in the message.
Error and Warning Messages 186 Errors ZTMF-ERR-INVNM-TOEXPECTED This error is returned if the keyword “TO” is missing from the ZTMF-TKNMAPNAMESET token. No error list is included in the response. 187 ZTMF-ERR-INVNM-FILESET This error is returned if an improperly formed file set is encountered in the ZTMF-TKN-MAPNAMESET token. No error list is included in the response. 188 ZTMF-ERR-INVNM-RESTRICTFSEXPT This error is returned if you used partial wildcarding in the new file set.
Error and Warning Messages 201 Errors ZTMF-ERR-ABORTTRANSACTION An error was returned from the TMP in response to the ABORT TRANSACTION command. The ZSPI-TKN-ERROR token returned within the error list provides additional information. 202 ZTMF-ERR-DUPLICATEMEDIANAME There is already a TAPEMEDIA attribute entry listed in the TAPEMEDIA specification. The ZTMF-TKN-MEDIA token supplied within the error list provides additional information.
Error and Warning Messages 255 Errors ZTMF-ERR-MUSTBESUPERGROUP A user ID in the SUPER group (255,*) must be used to execute this command. The ZTMF-TKN-USER token supplied within the error list provides additional information. 256 ZTMF-ERR-MUSTBECONFIGOWNER The user ID of the owner of the TMF configuration files—or the user ID SUPER.SUPER (255,255)—must be used to execute this command.
Error and Warning Messages 263 Errors ZTMF-ERR-MEDIAALREADYEXISTS The TAPEMEDIA attribute entry already exists in the TMF catalog. The ZTMF-TKN-MEDIA token supplied within the error list provides additional information. 264 ZTMF-ERR-NOSUCHMEDIA The TMF catalog has no tape media entry that matches the specified TAPEMEDIA attribute. The ZTMF-TKN-MEDIA token supplied within the error list provides additional information.
Error and Warning Messages 272 Errors ZTMF-ERR-RESOLVETRANSACTION The TMP returned an error in response to the RESOLVE TRANSACTION command. The ZSPI-TKN-ERROR token supplied within the error list provides additional information. 275 ZTMF-ERR-DUMPTYPEMISMATCH While dump entries were being added to an existing dump in the TMF catalog the dump type (ONLINE or AUDITDUMP) did not match that of the existing dump. 276 ZTMF-ERR-INVALIDADDDUMPS You cannot add dump entries to an existing audit dump.
Error and Warning Messages 282 ZTMF-ERR-FILEALREADYINCATALOG The file is already recorded as being part of this dump. The ZTMF-TKN-FILENAME token supplied within the error list provides additional information. 283 ZTMF-ERR-FILEVOLUMEUNKNOWN The volume that the file resides on is not known to the VOLINFO file. The ZTMF-TKN-FILENAME token supplied within the error list provides additional information. 285 ZTMF-ERR-NOFILESMATCHFILESET The TMF catalog has no files that match the fileset of this command.
Error and Warning Messages 299 Errors ZTMF-ERR-CTLGCANTINITIALIZE An error was received when the INITIALIZE CATALOG command was entered. Refer to the operator log for further information. 300 ZTMF-ERR-CTLGMEDIAINUSE The catalog process is unable to acquire the specified TAPEMEDIA entry. 301 ZTMF-ERR-CTLGCANTENDDUMP The catalog process is unable to end the specified dump. 302 ZTMF-ERR-CTLGCANTENTERMEDIA The catalog process is unable to add the specified TAPEMEDIA entry.
Error and Warning Messages 311 Errors ZTMF-ERR-CTLGDELETEDUMPFILE2 The catalog process is unable to delete the specified dump. 314 ZTMF-ERR-CTLGCANTENTERDISK The catalog process is unable to add the specified DISKMEDIA entry. 315 ZTMF-ERR-DUMPMEDIAMISMATCH While adding to an existing dump in the TMF catalog, you did not match the tape or disk dump medium to the existing dump. 316 ZTMF-ERR-CTLGCANTDELETEALLTAPE The catalog process is unable to delete the tape media entries specified by (*.*.*).
Error and Warning Messages 324 Errors ZTMF-ERR-PREVATNOTCONFIG This is returned by an ADD AUDITTRAIL command when the specified ZTMFTKN-AUDITTRAILID is not one greater than the last audit trail currently configured. The trails must be added in order, starting with ZTMF-VAL-MAT, then ZTMF-VAL-AUX01, ZTMF-VAL-AUX02, and through to ZTMF-VALAUX15. The response record includes a ZTMF-TKN-AUDITTRAILID token containing the offending value. There is no error list.
Error and Warning Messages 328 Errors ZTMF-ERR-ACTIVEATVOLHASFILES This is returned from an ADD AUDITTRAIL command if one of the volumes specified as a ZTMF-TKN-ACTIVEVOL has files residing in the ZTMFAT subvolume. The volume is not allowed to have files on the subvolume. Files with the name ZTMFnnnn, which is the format for pre-allocated audit-trail files, will be purged if they are found on the volume.
Error and Warning Messages 332 Errors ZTMF-ERR-TOOMANYATVOLS This error is returned from ADD and ALTER AUDITTRAIL commands if the command would result in more than 16 volumes being configured as a given type, either active, overflow, or restore. An error list is included in the response with ZTMF-TKN-VOLUMENAME specifying the first offending volume and ZTMF-TKN-ATVOLUMETYPE specifying the volume type for which too many volumes would be configured if the command completed.
Error and Warning Messages 336 Errors ZTMF-ERR-ATCANTDELETECURRVOL This error is returned from an ALTER AUDITTRAIL command if one of the ZTMF-TKN-DELACTIVEVOLUME tokens specifies the volume which holds the current audit-trail file. An error list is included in the response with ZTMF-TKN-VOLUMENAME specifying the offending volume name and ZTMF-TKN-ATVOLUMETYPE specifying the volume type, which is ZTMF-VAL-ACTIVEVOL.
Error and Warning Messages 340 Errors ZTMF-ERR-MUSTDUMPMAT This is error is returned by an ADD and ALTER AUDITTRAIL command if adding or altering an auxiliary audit trail and the value of ZAUDITDUMP is set to ZTMF-VAL-TRUE, and the master audit trail has not been configured for dumping. It does not make sense to dump an auxiliary trail if the MAT is not also dumped. No error list is included in the response.
Error and Warning Messages 347 Errors ZTMF-ERR-RMNAMENOTFOUND This error is returned if the specified resource manager name does not exist in the resource manager directory. An error list is included in the response with ZTMF-TKN-RMNAME specifying the nonexistent resource manager name. 348 ZTMF-ERR-RMNAMEOPEN This error is returned if the specified resource manager name is already open. An error list is included in the response with ZTMF-TKN-RMNAME specifying the opened resource manager name.
Error and Warning Messages 353 Errors ZTMF-ERR-LOWERAUTOABORT This error is returned if the value of the ZAUTOABORT token in an ALTER BEGINTRANS command request is lower than the current disconnect timer value. No error list is included in the response. 354 ZTMF-ERR-CANTTALKTOTMP This error is returned if the TMFSERVE process cannot communicate with the TMP process.
Error and Warning Messages 358 Errors ZTMF-ERR-DUPLICATEATVOLUME This error is returned if the same volume name is specified as the same volume type twice in the same command. That is, the same volume name is specified twice as ZTMF-TKN-ACTIVEVOLUME, ZTMF-TKNOVERFLOWVOLUME, or ZTMF-TKN-RESTOREVOLUME.
Error and Warning Messages 362 Errors ZTMF-ERR-INVATFILESTATUS This error is returned if a specified value for ZTMF-TKN-ATFILESTATUS is invalid. Valid values are ZTMF-VAL-ATFILEPREALLOCATED, -ATFILEACTIVE, -ATFILEOVERFLOW, -ATFILERESTORE, ATFILEOVERFLOWING, -ATFILERESTORING, and -ATFILEAVAILABLE. No error list is returned in the response. 363 ZTMF-ERR-INVATFILEDUMPSTATUS This error is returned if a specified value for ZTMF-TKNATFILEDUMPSTATUS is invalid.
Error and Warning Messages 367 Errors ZTMF-ERR-DISKMEDIAEXISTS This error is returned when the disk media value specified for the ZTMF-TKNADDDISKMEDIA token in an ALTER AUDITDUMP command is already configured. The ZTMF-TKN-DISKMEDIASTRING token supplied within the error list specifies the disk media value in question. 370 ZTMF-ERR-BACKUPTMPCANTHANDLE The backup TMP cannot handle the request. No error list is returned in the response.
Error and Warning Messages 383 Errors ZTMF-ERR-NOTSTARTEDFORSTOPTMF A STOP TMF command was rejected because the TMF subsystem is not started. No error list is returned in the response. 385 ZTMF-ERR-INVALIDABRUPT A STOP TMF command specified the ABRUPT option with an illegal value. No error list is returned in the response. 386 ZTMF-ERR-WRONGTRANSSTATE The state of the specified transaction (ZTMF-TKN-TRANSID in the response buffer) does not permit the attempted operation.
Error and Warning Messages 393 Errors ZTMF-ERR-DATAVOLALREADYCONFIGD The specified volume is already configured as a data volume. The ZTMF-TKN-VOLUMENAME token supplied within the error list provides additional information. 394 ZTMF-ERR-ATCANTBEDATAVOL The specified volume is already configured as an active-audit volume, and thus cannot be configured as a data volume. The ZTMF-TKN-VOLUMENAME token supplied within the error list provides additional information.
Error and Warning Messages 400 Errors ZTMF-ERR-DIRTYREQUIRESALLOWINC An attempt was made to delete a data volume whose state was disabled-dirty. However, the ALLOWINCONSISTENCY flag, which is required when a volume is dirty (possibly inconsistent), was not supplied—or was set to FALSE. The ZTMF-TKN-VOLUMENAME token supplied within the error list provides additional information. 420 ZTMF-ERR-DELETEOPERATIONBEGUN Delete TMF operation begun. No error list is returned in the response.
Error and Warning Messages 427 Errors ZTMF-ERR-TOOLATETOCANCELOPER A CANCEL OPERATIONS command was issued for an operation that has been completed. No error list is returned in the response. 440 ZTMF-ERR-OPERATIONBEGUN The requested operation has begun. The ZTMF-TKN-OPERATIONNUM token supplied within the error list provides additional information. 441 ZTMF-ERR-INVPROCESSTYPE The command specified an invalid process-type parameter. No error list is returned in the response.
Error and Warning Messages 447 Errors ZTMF-ERR-INVTERM An ALTER PROCESS command specified an erroneous TERM value. No error list is returned in the response. 448 ZTMF-ERR-INVEXTENDEDSEGSIZE An ALTER PROCESS command specified an erroneous EXTENDEDSEGSIZE value. No error list is returned in the response. 449 ZTMF-ERR-INVPFCSIZE An ALTER PROCESS command specified an erroneous PFSIZE value. No error list is returned in the response.
Error and Warning Messages 454 Errors ZTMF-ERR-CONFIGVOLFILE-FS-ERR During execution of an INFO PROCESS or ALTER PROCESS command, a file system error occurred while accessing the $SYSTEM.ZTMFCONF.CONFVOL file. The ZSPI-TKN-ERROR token supplied within the error list provides additional information. 481 ZTMF-ERR-InvTmpCommitTimer The ZValue field within the ZTmpWaitTimer token of an ALTER TMF command contained an invalid value. TMFCOM was expecting an integer in the range 1000 to 1000000.
Error and Warning Messages 486 Errors ZTMF-ERR-TooManyFSetDefaults For a DUMP FILES, INFO DUMPS, or RECOVER FILES command, the user included more than one ZTMF-TKN-FileSetDefault token in the command buffer. No error list is returned in the response. 487 ZTMF-ERR-InvMaxPioBufValue The ZMaxPioPerBuffer field within the ZPioBuffer token of an ALTER TMF command contained an invalid value. TMFCOM was expecting an integer in the range 1 to 200. No error list is returned in the response.
Error and Warning Messages 494 Errors ZTMF-ERR-SystemInFileSet One of the entries within the specified file of filenames contains a system name. No error list is returned in the response. 495 ZTMF-ERR-MustBeFullyQualified An entry within the specified filename file is not fully qualified, and no defaults are specified. No error list is returned in the response.
Error and Warning Messages 505 Errors ZTMF-ERR-UNKNOWNCOMMAND The SPI buffer received by the TMFSERVE process contained an unknown command. The ZTMF-TKN-UNKNOWNCOMMAND and ZTMF-TKNUNKNOWNOBJECT tokens supplied within the error list provide additional information. 506 ZTMF-ERR-UNKNOWNOBJECT The SPI buffer received by the TMFSERVE process contained an unknown object-type. The ZTMF-TKN-UNKNOWNOBJECT and ZTMF-TKNUNKNOWNCOMMAND tokens supplied within the error list provide additional information.
Error and Warning Messages 512 Errors ZTMF-ERR-BADTRANSCOUNTTHRESH The low value of the TRANSCOUNTTHRESHOLD token is less than 1, or the high value of the token is less than the low value. No error list is included in the response. 513 ZTMF-ERR-BADTMFLIBMEMTHRESH The low value of the TMFLIBMEMTHRESHOLD token is less than 1, or the high value of the token is less than the low value or greater than 99. No error list is included in the response.
Error and Warning Messages 523 Errors ZTMF-ERR-CTLGCANTCOMMUNICATE This error is returned if TMF cannot communicate with the $XCAT process during the execution of an ALTER CATALOG command when TMF is started. No error list is included in the response. 565 ZTMF-ERR-MISSINGSTRUCTTOKEN A required structured token is missing from an SPI message. No error list is included in the response. 566 ZTMF-ERR-TOOMANYSTRUCTTOKENS An SPI message contains more than one structured token.
Error and Warning Messages 607 Errors ZTMF-ERR-WARNCOULDNTCLEARCONFG Although a data volume was deleted from the configuration successfully, the TMF subsystem was unable to clear the configuration information from the volume label. The next time this volume is added to a TMF configuration, the IGNOREPREVIOUSCONFIG option may be required. The ZTMF-TKN-VOLUMENAME token supplied within the error list provides additional information.
Error and Warning Messages 664 Errors ZTMF-ERR-MustResetAuxFirst This error is returned if an ALTER AUDITTRAIL command request reset commit-hold for the MAT before first having done so for all auxiliary audit trails. Before you can turn COMMITHOLDMODE to OFF for the master audit trail, you must first turn it OFF for all auxiliary audit trails. No error list is included in the response.
Error and Warning Messages 950 Errors ZTMF-ERR-INTERNALERROR The TMFSERVE process encountered an internal error. The ZSPI-TKN-ERROR token supplied within the error list provides additional information.
Archive Tape Errors and Warnings Error and Warning Messages Archive Tape Errors and Warnings The archive tape errors and warnings returned by the TMF dump/restore processes in the token ZART-TKN-ARCHTAPEERRORMESS by TMF events 204, 205, 206, and 207 are listed and described in this section. Some of the archive tape messages include tokens, others do not.
Error and Warning Messages Archive Tape Errors and Warnings 8005 The SYSTEM attribute of the tape DEFINE ZART-TKN-DEFINENAME specifies a system, ZART-TKN-SYSTEMNAME, that either does not exist or is inaccessible because all paths to it are down. A system was specified with a DEFINE that either does not exist or is unavailable.
Error and Warning Messages Archive Tape Errors and Warnings 8012 Duplicate volume ID found in the VOLUME attribute of the tape DEFINE ZART-TKN-DEFINENAME. The VOLUME attribute of the specified tape DEFINE clause contains a duplicate volume name. 8013 Tape volume IDs for the two parallel copies are not different. The tape volume IDs for two parallel copies specified in a tape DEFINE clause are not unique.
Error and Warning Messages Archive Tape Errors and Warnings 8029 Tape record header length is bad (Record length in header: ZARTTKN-HEADERRECORDLEN, actual record length: ZART-TKNRECORDLEN). The record length specified in the tape header record differs from the actual record length. This could be caused by corruption of the tape, dirty tape drive heads, faulty tape drives, or a software bug in the dump or restore program. 8030 Tape record is out of sequence.
Error and Warning Messages Archive Tape Errors and Warnings 8050 Tape format is bad (Unexpected tape record type found. Expected record type: ZART-TKN-EXPECTEDRECORDKIND, actual record type: ZART-TKN-RECORDKIND). The actual record type differs from the expected record type. This could be caused by corruption of the tape, dirty tape drive heads, faulty tape drives, or a software bug in the dump or restore program. 8051 Tape format is bad (File encountered is not from the same tape set).
Error and Warning Messages Archive Tape Errors and Warnings 8057 Tape format is bad (File label sequence number in end volume label is incorrect. Expected sequence number: ZART-TKNEXPECTEDSEQNUM, actual sequence number: ZART-TKNSEQNUM). The end volume label is invalid. This could be caused by corruption of the tape, dirty tape drive heads, faulty tape drives, or a software bug in the dump or restore program. 8058 Tape format is bad (File continuation mismatch in end volume label).
Error and Warning Messages Archive Tape Errors and Warnings 8063 Tape format is bad (An EOF mark was found where an end volume label was expected). The tape format is invalid. This could be caused by corruption of the tape, dirty tape drive heads, faulty tape drives, or a software bug in the dump or restore program. 8064 Tape format is bad (An EOF mark was found where a file label or an end volume label was expected). The tape format is invalid.
Error and Warning Messages Archive Tape Errors and Warnings 8070 Tape format is bad (An end volume label was found where a file label was expected). The tape format is invalid. This could be caused by corruption of the tape, dirty tape drive heads, faulty tape drives, or a software bug in the dump or restore program. 8071 Tape format is bad (A file label was not found). The tape format is invalid.
Error and Warning Messages Archive Tape Errors and Warnings 8107 Found a regular labeled tape. The tape is a labeled tape, but not a TMF archive tape. 8108 Found a pre-C00 TMF tape. The tape is a pre-C00 TMF archive tape. 8109 Tape is not a TMF Archive tape. The tape is not a TMF archive tape. 8113 Wrong tape mounted (Found tape # ZART-TKN-TAPENUM, expected tape #ZART-TKN-EXPECTEDTAPENUM). The mounted tape is not the one that was expected.
Error and Warning Messages Archive Tape Errors and Warnings 8122 Tape parity error(s) and/or tape record checksum error(s) occurred on the beginning volume labels. Error recovery was able to recognize the tape. Parity or checksum errors occurred on some of the beginning volume labels. Such errors might be caused by the beginning of the tape being worn out, or to dirty tape drive heads. 8123 An EOF mark was found where begin volume labels were expected. The tape format is invalid.
Dump/Restore Errors and Warnings Error and Warning Messages 8156 A parity error occurred on the first end volume label. A parity error was detected on one of the two end volume labels. The end of tape is particularly vulnerable to parity errors (the reflective strip, for example, can cause a bump in the tape, or sudden stopping at the end can cause tape stretching). The tape format has duplicate end volume labels so that at least one of them is readable.
Dump/Restore Errors and Warnings Error and Warning Messages ZTMF-TKN-DR-VOLUMEERROR ZTMF-TKN-DR-AUDITTRAILINDEX ZART-TKN-VOLUMEID ZTMF-TKN-DR-DUMPFILENAME ZTMF-TKN-DR-DISKAUDDUMPVER ZEMS-TKN-EMPHASIS token-type token-type token-type token-type token-type token-type ZSPI-TYP-INT. ZSPI-TYP-INT. ZART-TYP-VOLUME. ZSPI-TYP-STRING. ZSPI-TYP-INT. ZSPI-TYP-BOOLEAN. 9000 Unable to obtain disk file label due to file-system error ZTMF-TKNDR-FILEERROR.
Error and Warning Messages Dump/Restore Errors and Warnings 9006 Unable to write SQL label group due to file-system error ZTMF-TKNDR-FILEERROR. A file-system error occurred while an online restore process was attempting to write the NonStop SQL/MP label group into a disk directory. The ZEMS-TKN-EMPHASIS token is set to TRUE. 9007 A good copy of tape # ZTMF-TKN-DR-TAPELNUM was not found for dump serial ZTMF-TKN-DR-DUMPSERIALNUM in the TMF Catalog.
Error and Warning Messages Dump/Restore Errors and Warnings 9012 The tape has the wrong Archive tape version (Expected version name: ZTMF-TKN-DR-EXPECTEDTAPEVERNAME, actual version name: ZTMF-TKN-DR-ARCHTAPEVERNAME). The tape mounted for a dump restore operation had the wrong archive tape version. The ZEMS-TKN-EMPHASIS token is set to TRUE. 9013 Parity error occurred on a tape data block. A parity error occurred in a tape data block. The ZEMS-TKN-EMPHASIS token is set to TRUE.
Error and Warning Messages Dump/Restore Errors and Warnings 9018 The wrong kind of TMF dump was mounted (Expected kind: ZTMFTKN-DR-EXPECTEDDUMPKIND, actual kind: ZTMF-TKN-DRDUMPKIND). The tape mounted for a dump restore operation contained the wrong type of dump. The ZEMS-TKN-EMPHASIS token is set to TRUE. 9019 Audit dump contains the wrong audit trail file (Expected name: ZTMF-TKN-DR-EXPECTEDTRAILFILENAME, actual name: ZTMF-TKNDR-TRAILFILENAME). The TMF Catalog has incorrect information.
Error and Warning Messages Dump/Restore Errors and Warnings 9023 TMF tape format is bad. While attempting to restore one or more dump files, a restore process found that the tape format is invalid. The ZEMS-TKN-EMPHASIS token is set to TRUE. 9025 Noticed TMF was shutting down while waiting for a scratch tape to be made. While waiting for an operator to make a scratch tape (see message 200), the TMF audit dump process terminated because TMF was shutting down.
Error and Warning Messages Dump/Restore Errors and Warnings 9030 File-system error ZTMF-TKN-DR-FILEERROR occurred on file. ZTMF-TKN-DR-FILENAME. A file-system error occurred for the specified file. The ZEMS-TKN-EMPHASIS token is set to TRUE. 9031 Operator requested termination. The operator requested the termination of a dump or restore operation. The ZEMS-TKN-EMPHASIS token is set to TRUE. 9032 File-system error ZTMF-TKN-DR-FILEERROR from the TMF Catalog.
Error and Warning Messages Dump/Restore Errors and Warnings 9036 The SQL label for the target ZTMF-TKN-DR-FileName does not match the SQL label for the source ZTMF-TKN-DR-DumpFileName. This error is returned if there is a mismatch between the source and target files during online restore to a new location (for example, one file is a format 2 file and the other file is not, or one file has partitions and/or indexes and the other file does not).
Error and Warning Messages Dump/Restore Errors and Warnings 9050 Audit trail block header 0 is too short. An audit dump process read the first audit-trail header and found it was shorter than expected. The ZEMS-TKN-EMPHASIS token is set to TRUE. 9051 Audit trail file is not file code 134. The file code of the audit-trail file was not 134. The ZEMS-TKN-EMPHASIS token is set to TRUE. 9052 Audit trail file is not an unstructured file. The audit-trail file was not an unstructured file.
Error and Warning Messages Dump/Restore Errors and Warnings 9101 File is marked broken. An attempt was made to make an online dump of an audited database file that was marked “broken.” The ZEMS-TKN-EMPHASIS token is set to TRUE. 9102 File is corrupt. An attempt was made to make an online dump of an audited database file that was found to be corrupted. The ZEMS-TKN-EMPHASIS token is set to TRUE.
Error and Warning Messages Dump/Restore Errors and Warnings 9107 Volume ZTMF-TKN-DR-VOLUMENAME is not in the current TMF volume configuration. An attempt was made to make an online dump of an audited file on a volume that was not known to TMF. The ZEMS-TKN-EMPHASIS token is set to TRUE. 9110 File-system error ZTMF-TKN-DR-FILEERROR trying to get TMF audit trail configuration information (Audit trail file = ZTMF-TKN-DRFILENAME).
Error and Warning Messages Dump/Restore Errors and Warnings 9115 No audited files matched ZTMF-TKN-DR-FILENAME. An online dump process did not find the audited file specified by the operator in a DUMP FILES command. The ZEMS-TKN-EMPHASIS token is set to TRUE. 9116 Failed to obtain current EOF from TMP for audit trail ZTMF-TKN-DRFILENAME. Error ZTMF-TKN-DR-FILEERROR was returned. An online dump process did not receive the current end-of-file from the TMP for the specified audited file.
Error and Warning Messages Dump/Restore Errors and Warnings 9202 Internal error (Unknown media kind was found in FRList list). An online restore process detected an internal error. The ZEMS-TKN-EMPHASIS token is set to TRUE. 9203 Cannot recover an SQL RVU 3 (or beyond) object on an SQL R1 or R2 system. On a NonStop SQL/MP RVU 1 or 2 system, an RVU 3 (or later) object was specified in a RECOVER FILES command. The ZEMS-TKN-EMPHASIS token is set to TRUE.
Error and Warning Messages Dump/Restore Errors and Warnings 9254 Sub volume ZTMF-TKN-DR-DUMPFILENAME.is not empty, so the disk could not be used for a dump file. A nonempty subvolume was specified for an audit dump or online dump to disk. The ZEMS-TKN-EMPHASIS token is set to TRUE. 9255 Unable to rename temporary disk dump file to ZTMF-TKN-DRDUMPFILENAME.could not be used for a dump file due to file-system error ZTMF-TKN-DR-FILEERROR.
Error and Warning Messages Dump/Restore Errors and Warnings 9259 Unable to complete the dump because the DISKMEDIA list has been used up. All the disks in the DISKMEDIA list were either full or could not be used. For each disk that could not be used, a warning message was previously listed in the EMS log (warning messages 9250 through 9254). The ZEMS-TKN-EMPHASIS token is set to TRUE. 9260 File-system error ZTMF-TKN-DR-FILEERROR occurred on Write operation on ZTMF-TKN-DR-DUMPFILENAME.
Error and Warning Messages Dump/Restore Errors and Warnings 9265 Disk audit-dump file ZTMF-TKN-DR-DUMPFILENAME.is corrupt. While restoring an audit dump from disk, an audit restore process detected that the disk audit dump file has been corrupted. The ZEMS-TKN-EMPHASIS token is set to TRUE. 9266 File-system error ZTMF-TKN-DR-FILEERROR occurred on Read operation on ZTMF-TKN-DR-DUMPFILENAME. A file-system error occurred while an audit restore process was reading a disk dump file.
Audit Reading Exceptions Error and Warning Messages 9271 Insufficient temporary magnetic disk space. There is not enough disk space available to perform an online dump to disk. The ZEMS-TKN-EMPHASIS token is set to TRUE. 9272 Bad end-of-file for ZTMF-TKN-DR-DUMPFILENAME. An audit restore process determined that the specified audit dump file has been corrupted.
Audit Reading Exceptions Error and Warning Messages ZTMF-VAL-AREXCPCONTROL CONTROL operation % ZTMF-TKN-ARETOPERATION on audit file ZTMF-TKNAUDITFILENAME failed with error ZTMF-TKN-FSERROR. A file-system error prevented the specified CONTROL operation from being performed on an audit-trail file. EOFFIXUPNEEDED Audit trail file ZTMF-TKN-AUDITFILENAME requires EOF fixup. The specified audit-trail file requires end-of-file fixup.
Audit Reading Exceptions Error and Warning Messages ZTMF-VAL-AREXCPINVBLOCKHEADER Invalid audit block header in file ZTMF-TKNAUDITFILENAME at RBA ZTMF-TKN-ARET-RBA. The specified audit block header is invalid. INVEOF Invalid EOF ZTMF-TKN-ARET-EOF for audit file ZTMF-TKN-AUDITFILENAME. The end-of-file for the specified audit-trail file is invalid. INVFILECODE Invalid file code ZTMF-TKN-ARET-FILECODE for audit file ZTMF-TKN-AUDITFILENAME. The file code of the specified audit-trail file is invalid.
Audit Reading Exceptions Error and Warning Messages ZTMF-VAL-AREXCPPOSITION POSITION to RBA ZTMF-TKN-ARET-RBA in audit file ZTMF-TKN-AUDITFILENAME failed with error.ZTMF-TKN-FS-ERROR. A POSITION operation to the specified relative byte address failed due to a file-system error. READ READ at RBA ZTMF-TKN-ARET-RBA in audit file ZTMF-TKN-AUDITFILENAME failed with error.ZTMFTKN-FS-ERROR. A READ operation at the specified relative byte address failed due to a file-system error.
A TMF Configuration Limits and Defaults The tables in this appendix summarize various limits and defaults for TMF. The following types of limits and defaults are included: Topic Page TMF Global Limits and Defaults A-1 Audit Trail Limits and Defaults A-1 Transaction Limits and Defaults A-2 Audit Dump and Online Dump Limits and Defaults A-3 Resource Manager Limits and Defaults A-3 Process Limits and Defaults A-3 Default Program File Names for Processes A-5 Table A-1.
TMF Configuration Limits and Defaults Table A-2. Audit Trail Limits and Defaults (page 2 of 2) Parameter Limits Default Audit-trail file size For format 1 files: 1 through 2047 MB for each audit-trail file, or the maximum disk size (if less than 2047 MB). For format 1 files: 100 MB each For format 2 files: 1 through 1048575 MB for each audit-trail file, or the maximum disk size (if less than 1048575 MB).
TMF Configuration Limits and Defaults Table A-4. Audit Dump and Online Dump Limits and Defaults Parameter Limits Default Number of parallel audit dump copies 1 through 2 1 Number of serial audit dump copies 1 through 3 1 Number of disk volumes that can be added to an audit dump configuration when audit dumping is directed to disk media 1 through 16 None Number of tape or disk volumes in a DUMP FILES command 1 through 16 None Table A-5.
TMF Configuration Limits and Defaults Table A-6. Process Limits and Defaults (page 2 of 3) Parameter Limits Default Number of processes Not applicable 0 if not needed; 1 or more as needed Extended segment size 0.5 through 128 MB (127.5 MB actual) 0.5 MB Number of processes 4 Always 4 Extended segment size 5 through 128 MB (127.
TMF Configuration Limits and Defaults Table A-6. Process Limits and Defaults (page 3 of 3) Parameter Limits Default Number of processes 1 per processor 1 per processor Extended segment size 12 through 128 MB (127.5 actual) 12 MB Number of processes 1 per processor 1 per processor Extended segment size Always 0.25 MB 0.
TMF Configuration Limits and Defaults Table A-7. Default Program File Names for Processes (page 2 of 2) TMF Process Default Program File Name Online restore $SYSTEM.SYSnn.TMFDR TMFMON2 $SYSTEM.SYSnn.TMFMON2 TMP $SYSTEM.SYSnn.TMFTMP Volume recovery $SYSTEM.SYSnn.
Index A ABORT TRANSACTION command 5-5 Active audit volume, definition 1-4 ADD AUDITTRAIL command 5-8 ADD DATAVOLS command 5-13 ADD DUMPS command 5-17 ADD MEDIA command 5-20 ADD RESOURCEMANAGER command 5-23 ALTER AUDITDUMP command 5-26 ALTER AUDITTRAIL command 5-31 ALTER BEGINTRANS command 5-38 ALTER CATALOG command 5-42 ALTER DATAVOLS command 5-44 ALTER DUMPS command 5-46 ALTER MEDIA command 5-48 ALTER PROCESS command 5-50 ALTER TMF command 5-55 Application program interface (API), Guardian 1-10 ATDUMPDM ob
D Index Commands building and sending 3-5/3-6 cancelling 3-6 format of descriptions 5-4 numbers and symbolic names for 3-3 See also individual commands sensitive and nonsensitive 3-8 summary 5-2/5-3 COMMIT WORK statement 1-3 Committed transaction 5-72 Common definitions EMS standard 4-4 SPI standard 4-1/4-4 TMF 4-4/4-11 Compatibility distributor 6-18 Compiling EMS filters 3-10 Conditional tokens 6-3 Consumer distributors, EMS 6-4 Consumer distributors, starting 3-8 Context token 3-6 Continuation 3-6 CONTR
F Index END-TRANSACTION statement 1-3 Error handling 3-7/3-8 Error lists 3-4, 5-4 Errors ignore data-related 5-6 indicated by return token 3-7 returned by TMFSERVE 3-8 Event Management Service (EMS) consumer distributors 6-4 definition 1-2, 1-6 description of 6-4 event templates 3-10 filters 6-18 overview 1-15 programming for TMF 6-17/6-18 retrieving events 3-8 running distributors 2-3 sources of messages 6-4 standard definitions 4-4 Extensible structured tokens caution on initializing 3-5 description of
N Index Management programming events, retrieving 3-9 Zxxx naming convention 3-11 Management programming concepts 1-1/1-2 Master audit trail, definition 1-4 MAT See Master audit trail Measure subsystem 1-11 MEDIA objects ADD command 5-20 ALTER command 5-48 DELETE command 5-66 INFO command 5-117 Message elements for management programs 3-3/3-4 Messages archive tape errors and warnings 7-53/7-63 audit reading exceptions 7-79/7-82 dump/restore errors and warnings 7-63/7-79 error (ZTMF-ERR-nnn) 7-3/7-52 event
S Index RESOURCEMANAGER objects ADD command 5-23 CLOSE command 5-59 DELETE command 5-68 INFO command 5-124 STATUS command 5-176 Response buffers See individual commands Response records, multiple 3-7 Responses, receiving and decoding 3-6/3-7 Restore audit volume, definition 1-4 Restore process messages 6-15 Return token 3-7 S SCREEN COBOL programming language 1-9 Security 3-8 Sensitive commands 3-8 Simple tokens description of 4-11 notation 5-4 standard definitions 4-2 SOURCE statements 3-2 Special token
U Index TMDS 6-17 TMF basic concepts 1-3 commands, list of 1-12 management interfaces 1-6/1-11 management programming concepts 1-1/1-2 object types 1-11 private token and field types 4-6/4-8 purpose 1-1 subsystem number 4-4 TMF objects DELETE command 5-71 START command 5-145 STATUS command 5-185 STOP command 5-202 TMF (Transaction Management Facility) configuration limits and defaults A-1/A-5 TMFCOM commands, equivalent list 1-12 overview 1-6 TMFMON messages 6-12 TMFSERVE commands and responses See indivi
Z Index ZART-TKN- tokens ARCHTAPEERRORMESS 6-205, 6-207, 6-209 DRIVENAME 6-231 in errors, list of 7-53 SeqNum 6-394 VOLUMEID 6-230 ZAUDITDUMP field 5-10, 5-34, 5-100 ZAuditHold field 5-159 ZAUDITTRAILID field 5-14, 5-108 ZAUTOABORT field 5-40, 5-103 ZAVOIDHANGING field 5-6 ZBEGINTIME field 5-174 ZBEGINTRANSDISABLE field 5-11, 5-34, 5-100 ZBLOCKSIZE field 5-29, 5-97 ZBlockSize field 5-83 ZCannotRollover field 5-159 ZCapacityInUse field 5-158 ZCATALOGSTATUS field 5-165 ZCHILDSYSTEMNAME field 5-201 ZCHILDSYS
Z Index ZHOMETERM field 5-191 ZHUNGTRANS field 5-188 ZIGNOREDATAERRORS field 5-6 ZIGNOREPREVIOUSCONFIG field 5-15 ZINSPECT field 5-53, 5-123 ZLABELMEDIA field 5-21 ZLASTREEL field 5-106 ZMAKESAVEABEND field 5-52, 5-122 ZMASTERSEQUENCE field 5-18, 5-113 ZMaxDumpSize field 5-84 ZMAXRETAINEDATFILES field 5-35, 5-100 ZMEDIASTATUS field 5-21, 5-49, 5-114, 5-118 ZMEDIUM field ADD DUMPS command 5-19 ADD MEDIA command 5-21 ALTER AUDITDUMP command 5-29 ALTER MEDIA command 5-48 DELETE MEDIA command 5-67 INFO AUDITD
Z Index ZSTOPPINGSTATE field 5-187 ZSUBVOLPRESENT field 5-187 ZSuspendReason field 5-188 ZSWAPVOLUM field 5-191 ZSYSTEMNAME field 5-29, 5-97, 5-186, 5-191 ZSystemName field 5-84 ZSYSTEMNAME2 field 5-30, 5-97 ZSystemName2 field 5-84 ZSYSTEMNUMBER field 5-186, 5-191 ZSYSTEMTIME field 5-186 ZTAPEDRIVE field 5-22 ZTAPEMODE field 5-22 ZTimeoutAction field 5-36, 5-101, 5-160 ZTIMESTAMP field 5-19, 5-137, 5-191 ZTMFDDL file 4-4 ZTMFLIBMEMTHRESH field 5-39, 5-103 ZTMFSTATE field 5-186 ZTMF-CMD-nnn tokens 6-96 ZTM
Z Index ZTMF-ERR- error messages (continued) CANTCANCELOPERNUM (error 144) 7-15 CANTDELETEATVOLUME (error 356) 7-35 CANTOPCLOSEVOLRM (error 352) 7-34 CANTTALKTOTMP (error 354) 7-35 CommitHoldAction (error 666) 7-51 CommitHoldMatOnly (error 661) 7-50 CommitHoldNullTime (error 665) 7-51 CommitHoldTimer (error 662) 7-50 CONFIGFILENOTCREATED (error 280) 7-25 CONFIGVERSIONMISMATCH (error 270) 7-24 CONFIGVOLFILE-FS-ERR (error 454) 7-44 ContextOutOfDate (error 509) 7-47 CREATEPROCESSNAME (error 261) 7-23 CTLGALT
Z Index ZTMF-ERR- error messages (continued) DELETEOPERATIONBEGUN (error 420) 7-41 DIRTYREQUIRESALLOWINC (error 400) 7-41 DISKMEDIAEXISTS (error 367) 7-38 DISKMEDIANETWORKINVAL (error 82) 7-9 DISKMEDIANOTALLOWED (error 75) 7-8 DISKMEDIANOTFOUND (error 366) 7-37 DISKMEDIAREQUIRED (error 81) 7-9 DISKMEDIARESET (error 78) 7-9 DISKMEDIASTRNWINVAL (error 120) 7-12 DISKMEDIAWILD (error 79) 7-9 DISKPARTOUTOFSEQUENCE (error 320) 7-28 DUMPMEDIAMISMATCH (error 315) 7-28 DUMPTYPEMISMATCH (error 275) 7-25 DUPLICATEAT
Z Index ZTMF-ERR- error messages (continued) INVALIDFROMARCHIVE (error 101) 7-10 INVALIDGENERICPROCESS (error 49) 7-6 INVALIDLABELMEDIA (error 54) 7-7 INVALIDMATSNFATSN (error 56) 7-7 INVALIDMAXRESP (error 61) 7-7 INVALIDMEDIANAME (error 01) 7-3 INVALIDMEDIASTATUS (error 52) 7-6 INVALIDMEDIUMRESET (error 83) 7-9 INVALIDMEDIUMTYPE (error 63) 7-7 INVALIDNEWDMLOC (error 151) 7-16 INVALIDOLDDMLOC (error 149) 7-16 INVALIDOPERNUM (error 113) 7-11 INVALIDOPERSTATE (error 110) 7-11 INVALIDOPERTYPE (error 111) 7-1
Z Index ZTMF-ERR- error messages (continued) INVIGNOREPREVCFLAG (error 93) 7-10 INVINSPECT (error 444) 7-42 INVMAKESAVEABEND (error 442) 7-42 INVMAPNAMESDEFAULT (error 180) 7-20 InvMaxPioBufValue (error 487) 7-45 INVMAXRETAINEDATFILES (error 177) 7-19 INVNM-COMMAORRPRENEXP (error 189) 7-21 INVNM-ENDOFINPUT (error 183) 7-20 INVNM-FILESET (error 187) 7-21 INVNM-MAPEXPECTED (error 184) 7-20 INVNM-NAMESEXPECTED (error 185) 7-20 INVNM-RESTRICTFSEXPT (error 188) 7-21 INVNM-TOEXPECTED (error 186) 7-21 INVNM-UNEX
Z Index ZTMF-ERR- error messages (continued) MUSTBESTARTEDSTOPPING (error 371) 7-38 MUSTBESUPERGROUP (error 255) 7-23 MUSTBESUPERSUPER (error 254) 7-22 MUSTDELETETMF (error 342) 7-33 MUSTDUMPMAT (error 340) 7-33 MUSTHAVESYSTEMNAME (error 87) 7-9 MustResetAuxFirst (error 664) 7-51 MustSetMatFirst (error 663) 7-50 MUSTSPECIFYDUMPSERIAL (error 146) 7-15 MUSTSPECIFYNEWDMLOC (error 150) 7-16 MUSTSPECIFYOLDDMLOC (error 148) 7-15 MUSTSUPPLYRMNAME (error 171) 7-18 MUSTSUPPLYRMOWNERID (error 174) 7-19 MUSTSUPPLYVO
Z Index ZTMF-ERR- error messages (continued) PROCESSNAMEREMOTE (error 15) 7-4 RESOLVETRANSACTION (error 272) 7-25 RMArchiveNeedsAudDump (error 395) 7-40 RMARCHIVENEEDSMATDUMP (error 396) 7-40 RMNAMECRASHED (error 349) 7-34 RMNAMEDUPLICATE (error 346) 7-33 RMNAMENOTFOUND (error 347) 7-34 RMNAMENOTOPEN (error 350) 7-34 RMNAMENOTSELECTED (error 351) 7-34 RMNAMEOPEN (error 348) 7-34 RMNAMEWILD (error 172) 7-18 STARTOPERATIONBEGUN (error 380) 7-38 STARTUPNEWPROCESS (error 258) 7-23 STARTUPOPEN (error 259) 7-23
Z Index ZTMF-ERR- error messages (continued) WILDORNAMENOTBOTH (error 90) 7-9 WILDORRMNAMENOTBOTH (error 173) 7-19 WRONGTRANSSTATE (error 386) 7-39 ZLTCHChangeFSError (error 670) 7-51 ZLTCHNotSupported (error 669) 7-51 ZTMF-EVT- event messages ABORTDUETOAUDOVFLOW (event 289) 6-297 ADALTERBLOCKSIZE (event 253) 6-247 ADALTERCOPIES (event 250) 6-242 ADALTERMEDIUM (event 255) 6-249 ADALTERSERIES (event 251) 6-243 ADALTERSYSTEMNAME (event 256) 6-251 ADALTERSYSTEMNAME2 (event 257) 6-252 ADALTERUNLOADMEDIA (even
Z Index ZTMF-EVT- event messages (continued) ATOVSUCCESS (event 269) 6-268 ATOVTARGETERR (event 267) 6-264 ATOVVOLSNEEDED (event 270) 6-269 ATRESTOREALLVOLSTRIED (event 276) 6-280 ATRestoreDMDSuccess (event 432) 6-394 ATRESTOREFAILED (event 274) 6-277 ATRESTOREMEDERR (event 272) 6-273 ATRESTORESUCCESS (event 275) 6-279 ATRESTORETARGETERR (event 273) 6-275 ATRollOK (event 110) 6-79 ATRollover (event 112) 6-82 ATRollStopped (event 111) 6-81 ATVolAdd (event 101) 6-63 ATVolCameUp (event 113) 6-83 ATVolDel (ev
Z Index ZTMF-EVT- event messages (continued) CONFIGVOLALTERED (event 285) 6-293 CONFIGVOLFSERROR (event 287) 6-295 CONFVOLFILEFSERROR (event 286) 6-294 CRASHTMFEND (event 181) 6-176 CRASHTMFSTART (event 180) 6-175 CTGALTERRD (event 281) 6-288 CTGALTERRE (event 282) 6-289 CtgAlterRR (event 430) 6-392 CTGPROCESSERR (event 283) 6-290 DefaultTmpWaitTimer(event 461) 6-423 DELETECTG (event 284) 6-292 DeletingTmf (event 141) 6-120 DOWNNODE (event 297) 6-308 DR-ARCHTAPEERR (event 204) 6-205 DR-ARCHTAPEMOUNTERR (e
Z Index ZTMF-EVT- event messages (continued) DV-Started (event 131) 6-108 DV-StartRejected (event 137) 6-115 DV-WrongVolisUp (event 138) 6-117 EndOperation (event 156) 6-140 FileSetScanErr (event 460) 6-422 FileTransitionErr (event 93) 6-50 FRFilTrnsPassComplete (event 402) 6-386 FRLIST-CANTRECOVFILE (event 196) 6-195 Frlist-CantRecovFile2 (event 435) 6-400 Frlist-CantRecovFile3 (event 432) 6-401 FRList-ErrFromDatavol (event 351) 6-359 FRLIST-ErrFromTmp (event 350) 6-357 FRLIST-EXCEPTERROR3 (event 192) 6-
Z Index ZTMF-EVT- event messages (continued) Rcov-ErrorOnTx (event 172) 6-162 RCOV-ExtSeg-Too-Small (event 331) 6-352 Rcov-FR-FileList (event 163) 6-145 Rcov-FR-SuccessList (event 164) 6-147 Rcov-FR-Summary (event 165) 6-149 Rcov-FsError1 (event 168) 6-153 Rcov-FsError2 (event 169) 6-156 Rcov-FsError3 (event 170) 6-158 RCOV-FSERROR4 (event 355) 6-365 RCOV-FSERROR5 (event 356) 6-368 RCOV-FSERROR6 (event 357) 6-370 RCOV-NOT-LICENSED (event 178) 6-172 RCOV-PFS-TOO-SMALL (event 177) 6-170 Rcov-Restart1 (event
Z Index ZTMF-EVT- event messages (continued) WrongProcConfigVerNum (event 127) 6-102 ZLTCHAlterConfig(event 471) 6-435 ZLTCHCheckError(event 472) 6-438 ZLTCHChngStateError(event 467) 6-427, 6-438, 6-440 ZLTCHChngTmpState(event 470) 6-433 ZLTCHChngTrailState(event 469) 6-431, 6-433 ZLTCHChngVolState(event 468) 6-429 ZLTCHGetError(event 473) 6-440 ZLTCHNotSupported(event 465) 6-424 ZLTCHTimeOut(event 461) 6-426 ZTMF-EVT-event 6-403 ZTMF-MAP- extensible tokens ABORT-TRANSACTION 5-6/5-7 ADD-AUDITTRAIL 5-10 AD
Z Index ZTMF-TKN- tokens (continued) ATDUMPBLOCKSIZE 6-247 ATDUMPBOOLEAN 6-245 ATDUMPCOPIES 6-242 ATDUMPSERIES 6-243 ATDUMPSYSTEMNAME 6-251 ATDUMPSYSTEMNAME2 6-252 ATFILEDUMPSTATUS 5-150, 5-151 ATFILEFORMAT 5-128 ATFileFormat 6-410 ATFILESIZE 6-56 ATFileSize32 6-408 ATFILESPERVOL 6-56, 6-58 ATFILESTATUS 5-149, 5-151, 6-31 ATFILETRANS 6-50 ATHELDREASON 6-184 ATOVTHRESH 6-57, 6-59 ATVOLDELETING 5-93 ATVOLUMETYPE 5-12, 5-36, 5-93, 6-63 AUDITDUMP 6-57 AuditFileName 5-151, 5-157, 6-28, 6-91, 6-184, 6-394, 6-40
Z Index ZTMF-TKN- tokens (continued) DUMPSERIAL 6-322 DVDIRTYFLAG 6-111 EVTHDR 6-3 EVTHDR-COMPONENTTYPE 6-4 EVTHDR-OPERATIONNUM 6-4 EVTHDR-OPERATIONTYPE 6-3 EVTHDR-OperationType 6-424 EVTHDR-PROCINSTNUM 6-4 EXTFILENAME 5-54, 5-112, 5-122 ExtFileName 5-82 FILEATTRCODE 6-33 FILESET 5-18, 5-65 Fileset 5-80, 5-111, 5-134 FilesetDefault 5-82, 5-112, 5-136 FRLIST-FILENAME 6-189, 6-340, 6-341, 6-342 FRLIST-LogicalFName 6-359, 6-361, 6-362, 6-364 FRLIST-LogicalVName 6-359 FRLIST-OPERNUM 6-195 FRLIST-PhysicalFName
Z Index ZTMF-TKN- tokens (continued) RCOV-TRANSID 6-162, 6-166 RCOV-TXSTATUS 6-162 RCOV-VOLUMENAME-1 6-160 RCOV-VolumeName-1 6-373 Reason 6-348 RESTOREVOLUME 5-10, 5-93 RmName 6-343, 6-344, 6-345, 6-346, 6-347, 6-378, 6-379, 6-380, 6-381 RM-SlotArraySize 6-376, 6-377 SessIdleTimer 6-351 SWAP 5-53, 5-122 TERM 5-54, 5-122 TIMESTAMP 5-196 TMPFRFILENAME 6-141 TOPHYSVOL 5-135 TRANSALLOWOPTION 6-129 TRANSID 5-6, 5-72, 6-25 TransID 6-349, 6-355 TransProtocol 6-416 TransProtocol-Prev 6-416 User 6-343, 6-344, 6-34
Z Index ZTMF-VAL- values (continued) DELETETMF 6-3 DOWN 5-165 DUMPFILES 6-3 DUMPSTATUSCURRENT 5-150 DUMPSTATUSDUMPED 5-151 DUMPSTATUSDUMPING 5-151 DUMPSTATUSNOTDUMPED 5-151 DUMPSTATUSNOTDUMPING 5-151 DVS-nnn 5-167/5-170 FILEATTRnnn 6-33 FINISHED 5-174 HELDRSNnnn 5-158, 6-184 HUNG 5-195 INPROGRESS 5-174 INVALID 5-114 MAXBUFLEN 3-5, 4-6 MAXBUFLEN-W 4-6 MEDIUMMAGNETICDISK 5-21, 5-29, 5-97 MEDIUMTAPE 5-21, 5-29, 5-48, 5-97 MINBUFLEN 3-5, 4-6 MINBUFLEN-W 4-6 nnnnBPI 5-22 ONLINEDUMP 5-18, 5-113 OPER-nnn 5-173 O
Special Characters Index ZVERIFYTAPE field 5-28, 5-97 ZVerifyTape field 5-83 Z-COPYNUMBER field 4-7 Z-Count field 4-8, 4-10 Z-GROUPNAME field 4-8 Z-Int field 4-8, 4-9, 4-10 Z-NAME field 4-7 Z-PARTNUMBER field 4-7 Z-PRIORITYORDER field 4-7 Z-SYSTEMFILENAME field 4-7 Special Characters $0 collector process 6-17 … (ellipsis) 5-4 HP NonStop TMF Management Programming Manual—540140-002 Index -26