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.
Document History Part Number Product Version Published 128469 NonStop TM/MP D42 July 1997 137444 NonStop TM/MP D46 May 1998 422875-001 NonStop TM/MP D46 March 2001 522420-001 TMF G07 August 2002 522420-002 TMF G07 April 2004
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.
What’s New in This Manual New and Changed Information New and Changed Information This is the seventh edition of the HP NonStop™ TMF Management Programming Manual. It has been updated to support the G06.23 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 523 ZTMF-ERR-CTLGCANTCOMMUNICATE 9036 The SQL label for the target ZTMF-TKN-DR-FileName does not match the SQL label for the source ZTMF-TKN-DR-DumpFileName. 9037 File System error ZTMF-TKN-DR-FileError occurred attempting to retrieve the SQL file label for ZTMF-TKN-DR-FileName. 9038 Unable to retrieve the CreateTime and RedefTime for this object from disk. Using the values from the online dump instead.
What’s New in This Manual New and Changed Information HP NonStop TMF Management Programming Manual—522420-002 x
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—522420-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 an 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.
Pathway SCREEN COBOL Introduction to TMF Table 1-2. PATHCOM Commands for Configuring TMF Options Command Description SET PATHWAY Specifies a global transaction restart limit, defining the maximum number of times a failed transaction can be restarted automatically. SET PROGRAM Specifies whether TMF runs along with the program. ADD SERVER Defines server classes that can update database files audited by TMF. ALTER SERVER Redefines server classes that can update database files audited by TMF.
Operating System Procedure Calls Introduction to TMF Table 1-3. Pathway SCREEN COBOL Statements Statement Description ABORT-TRANSACTION Cancels the transaction of a terminal operating in transaction mode. All database updates made to audited files during the transaction are backed out and no attempt is made to restart the transaction. BEGIN-TRANSACTION Marks the beginning of a series of operations that are to be treated as a single transaction.
Operating System Procedure Calls Introduction to TMF Table 1-5. System Procedure Calls Procedure Call Description ABORTTRANSACTION Cancels a transaction. When a process calls this procedure, TMF backs out the database changes associated with the current transaction. ACTIVATERECEIVETRANSID Permits multithreaded servers to read requests from $RECEIVE before replying to previously read $RECEIVE requests.
TACL Introduction to TMF 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. Table 1-6 lists some of the functions that call operating system procedures for performing TMF operations. Table 1-6. TACL Built-In Functions Function Description #ABORTTRANSACTION Invokes the ABORTTRANSACTION system procedure.
TMF Commands Introduction to TMF 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 audited files Contro
TMF Commands Introduction to TMF Table 1-7.
TMF Commands Introduction to TMF Table 1-7.
TMF Event Messages Introduction to TMF 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. TMF sends these event messages, in SPI format, to the Event Management Service (EMS), which makes them available to management applications upon request. Section 6, Event Messages describes in detail the contents of the event messages.
Introduction to TMF TMF Event Messages HP NonStop TMF Management Programming Manual—522420-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—522420-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—522420-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.
Predefined Token and Field Values Common Definitions ZTMF-TYP-USERNAME defines the ZTMF-TKN-USERNAME token for the NonStop Kernel 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. Predefined Token and Field Values A predefined token or field is given a symbolic name in the TMF definitions file.
Extensible Structured Tokens Common Definitions Extensible Structured Tokens An extensible structured token has a token map and a value consisting of data fields whose number can be extended. This extensibility allows additon of new fields to the structure in later releases. Extensible structured tokens are defined by token maps. See Section 5, Commands and Responses for descriptions of the extensible structured tokens in a particular command or response.
Common Definitions Tokens in Event Messages HP NonStop TMF Management Programming Manual—522420-002 4- 10
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.
ABORT TRANSACTION Commands and Responses 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.
ABORT TRANSACTION Commands and Responses Tokens in Command Buffer 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. If you do not assign a value to this field, the default is ZSPI-VAL-FALSE.
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. ZTMF-TKN-TRANSID specifies the transaction identifier of the transaction to be aborted. Tokens in Response Buffer ZTMF-TKN-TRANSID specifies the transaction identifier for which the result code is in the ZSPI-TKNRETCODE token.
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 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 An auxiliary audit trail cannot be configured with ZAUDITDUMP set to ZSPI-VAL-TRUE unless the master audit trail is also configured with ZAUDITDUMP set to ZSPI-VAL-TRUE. A master audit trail cannot be configured with ZAUDITDUMP set to ZSPI-VAL-FALSE unless the auxiliary audit trails are also configured with ZAUDITDUMP set to ZSPI-VAL-FALSE.
Commands and Responses ADD AUDITTRAIL Usage Guidelines Only super-group users can issue this command. You only can issue ADD AUDITTRAIL commands under either of two conditions: 1. Before you start TMF for the first time by using the START TMF command. 2. After you stop TMF by using the STOP TMF command and purge the existing TMF configuration by using the DELETE TMF command but before you issue the next START TMF command. Under either of these conditions, you can issue multiple ADD AUDITTRAIL commands.
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. ZTMF-TKN-AUDITTRAILID contains the name of a volume that qualified for the command (it was not screened out by a ZTMF-TKN-NOTVOLUMENAME token). 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 Response Buffer ZSPI-TKN-RETCODE ZSPI-TKN-ERRLIST ... ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-LIST. token-type ZSPI-TYP-SSCTL. 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.
ADD DUMPS Commands and Responses ZMASTERSEQUENCE specifies the master audit trail sequence number that was active when the dump was made. This field is required if the value of ZDUMPTYPE is ZTMFVAL-ONLINEDUMP. 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.
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 !r ZTMF-MAP-ADD-MEDIA def ZTMF-DDL-ADD-MEDIA.
ADD MEDIA Commands and Responses Tokens in Command Buffer ZTMF-TKN-MEDIA specifies the name of the storage media. This token is required; multiple occurrences are allowed. 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-BAD specifies that the tape volume is defective and cannot be used later for dumping files or for file recovery. ZTMF-VAL-RELEASED specifies that the contents of the tape volume are not required for file recovery. 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.
Commands and Responses ADD MEDIA ZOPERATORDEVICE specifies the name of the device on which TAPECOM prompts are to be displayed. This field is required if the value of ZLABELMEDIA is ZSPI-VALTRUE. Usage Guidelines Only super-group users can issue this command. For more information about the ADD TAPEMEDIA command, see the TMF Reference Manual.
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.
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 !r ZTMF-TKN-ADDDISKMEDIA ZTMF-TKN-DELDISKMEDIA token-type ZSPI-TYP-ENUM. 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.
Commands and Responses ALTER AUDITTRAIL 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. Tokens in Response Buffer ZTMF-TKN-VOLUMENAME contains the name of a volume that was in error, if an error is returned. This token is not returned if no volume-related error is returned.
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 !r def ZTMF-DDL-ALTER-CATALOG. 02 ZRETAINDEPTH 02 ZRELEASED end.
Commands and Responses ALTER CATALOG same set of files, the first dump would constitute the first generation, the second dump would be the second generation, and so forth. The range of values for this field is from 1 through 99; the value of ZTMF-VALRESETWORD is 3. 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 ZTMF-VAL-FALSE, or to RELEASED if ZRELEASED is ZTMF-VAL-TRUE.
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 !r ZTMF-MAP-ALTER-DUMPS def ZTMF-DDL-ALTER-DUMPS. !r 02 ZSERIAL 02 ZDUMPINVALID 02 ZRELEASED end. ZSPI-TKN-COMMENT token-type ZSPI-TYP-STRING. 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 !r token-type ZTMF-TYP-MEDIA. ZTMF-MAP-ALTER-MEDIA def ZTMF-DDL-ALTER-MEDIA. 02 ZMEDIUM 02 ZMEDIASTATUS end. token-type ZSPI-DDL-ENUM.
ALTER MEDIA Commands and Responses ZMEDIUM specifies the type of storage media. The following value is valid: ZTMF-VAL-MEDIUMTAPE Tape storage 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.
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-PROCESS token-type ZSPI-TYP-CRTPID. ZTMF-MAP-ALTER-PROCESSES def ZTMF-DDL-ALTER-PROCESSES.
ALTER PROCESS Commands and Responses Tokens in Command Buffer ZTMF-TKN-PROCESS 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. If the value is ZTMF-VAL-RESETCPUSINFO, the CPUs for the process are reset to the CPUs selected by the CMON process or by TMF.
ALTER PROCESS Commands and Responses ZSPI-VAL-FALSE The process does not enter DEBUG or INSPECT 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 the TMF configuration volume to a specified volume. Command Syntax Refer to the SPI Programming Manual for tokens present in the command and response buffers but not described below. Command ZTMF-CMD-ALTER Object Type ZTMF-OBJ-TMF Tokens in Command Buffer ZTMF-TKN-VOLUMENAME token-type ZSPI-TYP-STRING. Tokens in Response Buffer ZSPI-TKN-RETCODE ZSPI-TKN-ERRLIST ... ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ENUM.
Commands and Responses ALTER TMF ZTMF-ERR-ONCONFIGVOL is returned when a file-system error occurs in accessing the configuration volume. The error number and the configuration volume name are returned in this error. ZTMF-ERR-INVALIDVOLUMESTRING is returned when an invalid volume name is specified in an ALTER TMF command. Usage Guidelines Only super-group users can issue this command. TMF must be stopped before you issue this command.
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 ZSPI-TKN-COMMENT token-type ZSPI-TYP-INT. !r token-type ZSPI-TYP-STRING.
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 Tokens in Command Buffer ZTMF-TKN-RMNAME specifies the name of the resource manager to be closed. This token must appear at least once in the command buffer, and can appear multiple times to close multiple resource managers. If multiple resource managers are being closed by a single command, the result of the operation is returned in a separate response record for each resource manager name. Resource manager names can have a maximum length of 128 characters.
Commands and Responses CLOSE RESOURCEMANAGER 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.
DELETE CATALOG Commands and Responses 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. !r 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 !r 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 !r 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.
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.
DELETE TMF Commands and Responses 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.
Commands and Responses DELETE TMF After a DELETE TMF command, the dump entries remain in the TMF catalog until the next START TMF command is entered.
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 ZSPI-TKN-COMMENT token-type ZSPI-TYP-TRANSID. token-type ZSPI-TYP-STRING. Tokens in Response Buffer ZSPI-TKN-RETCODE ZSPI-TKN-ERRLIST ...
Commands and Responses DELETE TRANSACTION for a long time. When the availability of these resources is more important than data integrity, consider forcibly deleting the transaction. Caution. DELETE TRANSACTION is a very dangerous command, because it can result in a corrupted database. Use this command only with extreme caution.
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-VAL-AUX02 Auxiliary audit trail #2 ... ZTMF-VAL-AUX015 Auxiliary audit trail #15 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.
DISABLE BEGINTRANS Commands and Responses 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 ZSPI-TKN-COMMENT token-type ZSPI-TYP-STRING. Tokens in Response Buffer ZSPI-TKN-RETCODE ZSPI-TKN-ERRLIST ...
Commands and Responses DISABLE BEGINTRANS The START TMF command also contains a ZTRANSALLOWOPTION field that disables transaction processing.
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 one or more audited files to be dumped to tape or disk. ZTMF-TKN-NOTFILESET specifies one or more audited files that are not to be dumped. 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.
Commands and Responses DUMP FILES When the disk resides on a home (local) node: • • • • The node name and the prefix are optional. If the node name is not specified, the node on which your TMFSERVE is running is assigned. You can specify any value for the prefix. If the prefix is not specified, the local-node default, ZT, is automatically assigned as the prefix. Optical discs are not supported for dump-to-disk operations.
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 ZSYSTEMNAME for dumps to tape, specifies the name of the system on which the audit dump process performs automatic volume recognition (AVR) on the first parallel copy. If you omit this field, the default value is the name of the local system. If you specify a remote node for dumps to tape, Guardian labeled-tape processing must be enabled on that node and must be running on RVU C30 or later of the NonStop Kernel.
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-ERRATNOTDUMPING error is returned.
ENABLE BEGINTRANS Commands and Responses 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 ZSPI-TKN-COMMENT token-type ZSPI-TYP-STRING. Tokens in Response Buffer ZSPI-TKN-RETCODE ZSPI-TKN-ERRLIST ...
Commands and Responses ENABLE BEGINTRANS If any of these conditions exist when you enter the ENABLE BEGINTRANS command, the subsystem generates an EMS event message. Before the ENABLE BEGINTRANS command takes effect, all these conditions must be corrected.
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 indicates 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 ZSPI-TKN-COMMENT token-type token-type token-type token-type ZSPI-TYP-ENUM.
INFO ATDUMPDM Commands and Responses Tokens in Command Buffer ZTMF-TKN-AUDITTRAILID specifies an audit trail for which disk media dump attributes are 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 ...
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 !r ZTMF-TKN-ATVOLUMETYPE ZSPI-TKN-MAXRESP ZSPI-TKN-CONTEXT ZSPI-TKN-COMMENT token-type ZSPI-TYP-ENUM.
INFO ATVOLUME Commands and Responses Tokens in Command Buffer ZTMF-TKN-AUDITTRAILID specifies an audit trail for which volume names are 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 ZTMF-TKN-ATVOLUMETYPE specifies the volume types for which the names are to be returned.
INFO ATVOLUME Commands and Responses ZTMF-TKN-ATVOLDELETING indicates whether the volume has been requested to be deleted from the configuration, despite the fact that it still holds audit-trail files required for the correct operation of TMF. The following values are possible: ZSPI-VAL-TRUE The volume returned in the response record is marked for deletion ZSPI-VAL-FALSE The volume returned in the response record is not marked for deletion Usage Guidelines Any user can issue this command.
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 ZSPI-TKN-MAXRESP ZSPI-TKN-CONTEXT ZSPI-TKN-COMMENT token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-INT.
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 indicates whether tape verification is performed after a tape is written. The following values are possible: ZTMF-VAL-TRUE Tapes are verified ZTMF-VAL-FALSE Tapes are not verified ZBLOCKSIZE indicates the length of tape data blocks. ZUNLOADMEDIA indicates 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 ... ZTMF-VAL-AUX015 Auxiliary audit trail #15 ZTMF-VAL-WILDAUDITTRAILID All audit trails If you omit this token, the default is all audit trails.
Commands and Responses INFO AUDITTRAIL ZOVERFLOWTHRESHOLD indicates the percentage of active audit-trail capacity above which TMF begins overflow copying. ZBEGINTRANSDISABLE indicates the percentage of active audit-trail capacity that can be consumed before new transactions are disabled.
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 ZSPI-TKN-COMMENT token-type ZSPI-TYP-STRING.
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 indicates 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 ZSPI-TKN-COMMENT token-type ZSPI-TYP-STRING. Tokens in Response Buffer ZTMF-MAP-INFO-CATALOG def ZTMF-DDL-INFO-CATALOG.
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 indicates the number of online dump generations retained in the catalog. ZRELEASED indicates 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 indicates 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-TKN-AUDITTRAILID contains the name of a volume that qualified for the command (it was not screened out by a ZTMF-TKN-NOTVOLUMENAME token). ZTMF-MAP-INFO-DATAVOLS-R is an extensible structured token containing the attributes of the specified data volume.
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-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. ZSPI-TKN-DATALIST ... ZSPI-TKN-ENDLIST ZSPI-TKN-RETCODE ZSPI-TKN-ERRLIST ...
INFO DUMPS Commands and Responses For audit dumps, the volume name $ZTMFAT is a pseudo or dummy name used to support TMF’s ability to spread audit-files across multiple disk volumes. ZSERIAL specifies the serial number of the dump for which information is to be returned. If you omit this field, the default is all serial numbers. ZDUMPTYPE specifies the type of dump for which information is to be returned.
INFO DUMPS Commands and Responses ZTIMESTAMP ZSYSTEMNUMBER ZMEDIA are not valid for command buffers. ZMEDIUM specifies the type of storage media. The following values are valid: ZTMF-VAL-MEDIUMTAPE Tape storage media ZTMF-VAL-MEDIUMMAGNETICDISK Magnetic disk storage media If you omit this field, the default is both values. ZDISKMEDIA This field is not valid for command buffers.
INFO DUMPS Commands and Responses ZDUMPSTATUS indicates the status of the dump file (assigned, released, or invalid). ZMEDIASTATUS indicates the status of the tape volume specified in the ZMEDIA field (assigned, released, or bad). ZSORTSELECT is not valid for response buffers. ZTIMESTAMP indicates the time (GMT) the dump was made. ZSYSTEMNUMBER indicates the number of the system where the online dump was made, and is used for converting the ZTIMESTAMP field.
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 used to select which tape volumes are to be returned. This token is required; only one occurrence is allowed.
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 is the name of the tape volume that met the selection criteria in the command buffer. The Z-PARTNUMBER and Z-COPYNUMBER fields are not used. ZMEDIUM indicates the type of storage media. The value of this field is ZTMF-VALMEDIUMTAPE for a tape volume.
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 ZSPI-TKN-MAXRESP ZSPI-TKN-CONTEXT ZSPI-TKN-COMMENT token-type token-type token-type token-type ZSPI-TYP-CRTPID. ZSPI-TYP-INT.
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 is 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 is 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 indicates 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 soon after starting If this field is null, the value is ZSPI-VAL-FALSE. ZINSPECT indicates 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.
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 Response Buffer ZSPI-TKN-VOLUMENAME STRING. ZSPI-TKN-RETCODE ZSPI-TKN-ERRLIST ... ZSPI-TKN-ENDLIST token-type ZSPI-TYPtoken-type ZSPI-TYP-ENUM.
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 ZSPI-TKN-COMMENT token-type ZSPI-TYP-STRING.
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.
Commands and Responses NEXT AUDITTRAIL Usage Guidelines Only super-group users can issue this command. TMF must be started. This command does not complete until new audit records are placed in a new audittrail file.
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 a file to be recovered. This token is required; multiple occurrences are allowed. ZTMF-TKN-FILESET 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 all files on the physical volume(s) designated by the ZTMF-TKN-TOPHYSVOL or ZTMF-TKN-WHEREPHYSVOLIS token are to be recovered.
Commands and Responses RECOVER FILES ZFROMARCHIVE directs TMF to recover all files requested, regardless of the flags set in the file labels, using the relevant online dumps and audit-trail dumps. The following values are valid: ZTMF-VAL-TRUE Files are recovered using dumps, regardless of the flags set in the file label. ZTMF-VAL-FALSE Only files having the REDONEEDED or UNDONEEDED flag set in the file label are recovered. If you omit this field, its default value is ZSPI-VAL-FALSE.
RECOVER FILES Commands and Responses ZTIMESTAMP directs that file recovery redo all transactions committed before the specified time. Transactions that began before the specified time but were not yet committed are backed out. The database is recovered to the time specified, rather than to the most recent consistent state. Be certain to enter the date and time for this option completely and accurately.
Commands and Responses RECOVER FILES The value of this field must not be TRUE if the ZTMF-TKN-MAPNAMESET token is specified. Also, if the value of this field is TRUE, the ZTMF-TKN-TOPHYSVOL token must also be specified. Caution. The ZRECOVERVDPPHASE1 field is intended for use with NonStop Storage Management Foundation (SMF) files only.
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.
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 used. This token is required; only one occurrence is allowed; a wild card value is allowed. 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.
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.
RESOLVE TRANSACTION Commands and Responses 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-TKN-TRANSID specifies the fully qualified identifier of the distributed transaction to be resolved. This token is required; only one occurrence is allowed. ZTMF-MAP-RESOLV-TRANSACTION is an extensible structured token describing the distributed transaction 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.
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 ZSPI-TKN-MAXRESP ZSPI-TKN-CONTEXT BYTESTRING. ZSPI-TKN-COMMENT token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-INT.
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 ZACTIVE indicates 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 audittrail file. ZSPI-VAL-FALSE The audit dump process is not currently dumping an audit-trail file. ZENABLED indicates whether the audit dump process is currently enabled. The following values are possible: ZSPI-VAL-TRUE The dump process is currently enabled.
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-TKN-RDFREQUESTERNAME is the name of the RDF environment that has the audit trail pinned. This token is present when RDF is the holding reason (ZHOLDINGRENAMEREASON contains the value HELDRSNRDF). ZTMF-MAP-STATUS-AUDITTRAIL is an extensible structured token containing information about the current state of the active audit trail.
STATUS AUDITTRAIL Commands and Responses Value (ZTMF-VAL- ) Description HELDRSNMATAUXPTR A master audit-trail file that must remain on the active or overflow volume contains references to audit records in this audit-trail file. This reason applies only to files in an auxiliary audit trail. HELDRSNTMPCTRLPTS This audit-trail file contains control information needed by TMF to restart after a system failure. The control information is normally written to the file within 10 minutes.
STATUS BEGINTRANS Commands and Responses 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 indicates 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 indicates 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 ZSPI-TKN-COMMENT token-type ZSPI-TYP-STRING. Tokens in Response Buffer ZTMF-MAP-STATUS-CATALOG def ZTMF-DDL-STATUS-CATALOG. 02 ZCATALOGSTATUS end.
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 indicates 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. !r 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-WRONGDISKMOUNTED 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 indicates the state of the data volume. ZRECOVERYMODE indicates 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-OPERATIIONNUM 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 token-type ZSPI-TYP-STRING. 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. ZSPI-TKN-DATALIST ... ZSPI-TKN-ENDLIST ZSPI-TKN-RETCODE ZSPI-TKN-ERRLIST ... ZSPI-TKN-ENDLIST ZSPI-TKN-CONTEXT token-type ZSPI-TYP-LIST. token-type ZSPI-TYP-SSCTL. token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-LIST. token-type ZSPI-TYP-SSCTL.
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 indicates 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 ZPROCESSHANDL specifies the process handle of the gateway process that currently has the resource manager open. If the resource manager is not open, then 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. 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 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-COMMITTED the transaction branch has committed, but not all subordinates have yet been notified of the commit. ZTMF-VAL-ABORTED the transaction branch has aborted, but the superior has not yet been notified of the abort. ZBRANCHNUMBER specifies the branch number. Each import and export of a transaction creates a new branch. The same transaction can be imported and exported (possibly multiple times) by the same resource manager.
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 ZSPI-TKN-COMMENT token-type ZSPI-TYP-STRING. 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 is the local system name. ZSYSTEMNUMBER is the number of the local system. ZSYSTEMTIME is the local system time (GMT). ZTMFSTATE indicates 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 indicates 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 indicates 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 indicates the current TMF transaction rate in hundredths of a transaction per second. For example, a value of 300 indicates 3 transactions per second. Usage Guidelines Any user can issue this command. You can enter this command at any time, whether or not TMF has been started.
STATUS TMFSERVER Commands and Responses 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 ZSPI-TKN-COMMENT token-type ZSPI-TYP-STRING. Tokens in Response Buffer ZTMF-MAP-STATUS-TMFSERVER def ZTMF-DDL-STATUS-TMFSERVER.
Commands and Responses STATUS TMFSERVER Tokens in Response Buffer ZTMF-MAP-STATUS-TMFSERVER is an extensible structured token containing the status information for the TMFSERVE process. This token contains the following fields: ZPROCESSNAME is the process name and process ID of the TMFSERVE process, obtained from the GETCRTPID procedure. ZCREATORACCESSID is the user ID of the person who created the TMFSERVE process. ZPROCESSACCESSID is the user ID of the person now using the TMFSERVE process.
STATUS TMFSERVER Commands and Responses ZCPU is the number of the CPU on which the TMFSERVE process is running. ZPINISPRESENT indicates 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 is the PIN of the TMFSERVE process. ZSERVERNAME is the process name of the TMFSERVE process. Usage Guidelines Any user can issue this command.
Commands and Responses STATUS TRANSACTION 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.
STATUS TRANSACTION Commands and Responses Tokens in Response Buffer ZTMF-TKN-TRANSID ZTMF-TKN-TIMESTAMP ZTMF-TKN-CHILDREN ZSPI-TKN-RMNAME ZSPI-TKN-CONTEXT token-type token-type token-type token-type token-type ZTMF-MAP-STATUS-TRANS-RSP def ZTMF-DDL-STATUS-TRANS-RSP. 02 ZSTATE token-type 02 ZDISTRIBUTED token-type 02 ZPROCESSPHANDL token-type 02 ZPARENTNAME token-type 02 ZPARENTNUMBER token-type 02 ZRETRYCOUNT token-type 02 ZSTARTINGMATNUM token-type 02 ZREASON token-type end. ZSPI-TKN-DATALIST ...
Commands and Responses STATUS TRANSACTION ZTMF-MAP-STATUS-TRANSACTION is an extensible structured token specifying attributes that are used to select the transaction for which information is to be returned. This token is optional; only one occurrence is allowed. If multiple attributes are specified, information is returned only for transactions that meet all the selection criteria (that is, the values are logically “and-ed”).
Commands and Responses STATUS TRANSACTION ZTMF-VAL-PREPARED specifies distributed transactions in the prepared state. A distributed transaction enters this state on a remote node after Phase 1 of the commitment is complete on that node; the transaction remains in this state until the remote node is informed by its parent of the transaction’s outcome. ZTMF-VAL-HUNG specifies transactions hung during backout. A transaction enters this state if the backout process attempts, but fails, to abort it.
STATUS TRANSACTION Commands and Responses ZTMF-TKN-TIMESTAMP is the date and time the status information was taken. ZTMF-TKN-CHILDREN indicates a network-distributed transaction. This token can be used in a subsequent STATUS TRANSACTIONCHILDREN command. ZTMF-TKN-RMNAME specifies the name of the resource manager that imported the transaction. If the transaction was not imported by a resource manager, this token is omitted from the response record.
Commands and Responses STATUS TRANSACTION ZRETRYCOUNT indicates the number of times an operation in the transaction is retried. ZSTARTINGMATNUM indicates the audit-trail file sequence number (for example, AA000001) of the first audit-trail file associated with this transaction. This field is valid only if ZSTATUSDETAIL has the value ZTMF-VAL-STATUS-DETAILED. ZREASON indicates the reason the transaction aborted.
Commands and Responses STATUS TRANSACTION ZTMF-VAL-TRANSABRTBYFILESYS The transaction was aborted by the file system. ZTMF-VAL-TRANSABRTBYTIMEOUT The transaction aborted because of a timeout. ZTMF-VAL-TRANSABRTSERVFAIL The transaction aborted because a server failed that was working on the transaction. ZTMF-VAL-TRANSABRTMISC The transaction aborted because of a reason other than those listed above. Usage Guidelines Anyone can issue this command.
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 Command Buffer ZTMF-TKN-CHILDREN specifies a network-distributed transaction. The value for this token is returned in the same token for the STATUS TRANSACTION command. This token is required, and multiple occurrences are not allowed. ZTMF-TKN-TRANSID specifies a transaction identifier for which status information is to be returned. This is a mandatory token in all buffers.
Commands and Responses STATUS TRANSACTIONCHILDREN Usage Guidelines Anyone can issue this command. 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.
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 indicates 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.
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-BACKOUT ZTMF-VAL-PROC-CATALOG 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 (ZTMF-EVT-) Description 149 STOPTMFPARAMETERS STOP TMF parameters 150 GLOBINFOFILEERR File-system error while accessing TMF configuration file 151 WRONGGLOBINFOFILEVER TMF configuration file has wrong version number 152 TMFPROCALLOCSEGFAILED Extended segment allocation on disk volume failed 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.
TMFMON Event Messages Event Messages Table 6-1.
TMFMON Event Messages Event Messages Table 6-2.
Recovery Event Messages Event Messages Recovery Event Messages The TMF event messages that are reported by the backout, volume recovery, file recovery, and file recovery list processes are listed and described in Table 6-3. Table 6-3.
Recovery Event Messages Event Messages Table 6-3.
TMF Dump/Restore Event Messages Event Messages TMF Dump/Restore Event Messages The TMF event messages that are reported by the TMF dump/restore processes are listed and described in Table 6-4. Table 6-4.
TMF Catalog Event Messages Event Messages TMF Catalog Event Messages The TMF event messages that are reported by the TMF catalog process are listed and described in Table 6-5. Table 6-5.
Event-Management Programming for TMF Event Messages Event-Management Programming for TMF Each TMF event is reported to the EMS collector process ($0) and displayed in text on the ViewPoint console. Although the EMS collector process ($0) is the recommended method for logging event messages, you can also use a process or disk file to log them. Note.
Event Filtering Event Messages Event Filtering You can design event-message filters based on specific tokens, token values, or ranges of token values: • • The SSID token (ZSPI-TKN-SSID) distinguishes events that are reported by TMF. The event number token (ZEMS-TKN-EVENTNUMBER) distinguishes event messages reported by the TMP, TMF monitor process (TMFMON), volume recovery processes, file recovery processes, and backout processes.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-TRANSID. Event-Message Text Aborting transaction ZTMF-TKN-TRANSID, the process that started the transaction failed. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE identifies the TMF process that generated the event.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-INT. 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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. token-type 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. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE ZTMF-TKN-AUDITTRAILID ZTMF-TKN-ATFILESPERVOL ZTMF-TKN-ATFILESIZE ZTMF-TKN-ATOVTHRESH ZTMF-TKN-ATBTDISABLE ZTMF-TKN-AUDITDUMP token-type token-type token-type token-type token-type token-type token-type ZSPI-TYP-ENUM.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-INT.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-INT.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-INT.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-ENUM. 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 token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-ENUM. ZSPI-TYP-STRING. ZSPI-TYP-ENUM.
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 token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-ENUM. ZSPI-TYP-STRING. ZSPI-TYP-ENUM.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-ENUM. Event-Message Text The ZTMF-TKN-AUDITTRAILID Audit Trail does not have any Overflow volumes configured. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE identifies the TMF process that generated the event.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-ENUM. Event-Message Text Found an available audit trail file for ZTMF-TKN-AUDITTRAILID Audit Trail.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-ENUM. Event-Message Text An available audit trail file for ZTMF-TKN-AUDITTRAILID Audit Trail has not yet been found, but TMF is stopping.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. 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 120: ZTMF-EVT-STARTINGTMF This message, generated when TMF is starting, states which configuration volume the subsystem is using. Additional Unconditional Tokens ZSPI-TKN-CONFIGVOL ZEMS-TKN-EMPHASIS 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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-BOOLEAN. Event-Message Text DISABLE DATAVOL command ZTMF-TKN-ABRUPT issued for ZTMF-TKN-VOLUMENAME.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. 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 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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. Event-Message Text Data volume ZTMF-TKN-VOLUMENAME started for transaction processing. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE identifies the TMF process that generated the event.
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 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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-INT. 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-DISABLED 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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. Event-Message Text Data Volume ZTMF-TKN-VOLUMENAME enabled.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-INT. Event-Message Text Data Volume ZTMF-TKN-VOLUMENAME failed to start for TMF 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.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. 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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. Event-Message Text Data Volume ZTMF-TKN-VOLUMENAME failed to start due to a fatal error during Volume Recovery. The volume will be disabled. See the previous Volume Recovery events for more information.
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 ZEMS-TKN-EMPHASIS token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-BOOLEAN. Event-Message Text File-System error ### occurred on the configuration file "###".
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 ZEMS-TKN-EMPHASIS token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-BOOLEAN. Event-Message Text Configuration file ### 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 token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-ENUM. ZSPI-TYP-STRING. ZSPI-TYP-STRING.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-INT. 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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING.
Descriptions of Event Messages Event Messages 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. ZTMF-TKN-RCOV-FILENAME-2 through ZTMF-TKN-RCOV-FILENAME-10 if present, contain the name of a file to be recovered. Effect None. Recommended Action Informative only; no corrective action is needed.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING.
Descriptions of Event Messages Event Messages 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. ZTMF-TKN-RCOV-FILENAME-2 through ZTMF-TKN-RCOV-FILENAME-10 if present, contain the name of a recovered file. Effect None. Recommended Action Informative only; no corrective action is needed.
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 token-type token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-STRING. ZSPI-TYP-INT. ZSPI-TYP-INT2. ZSPI-TYP-INT2.
Descriptions of Event Messages Event Messages Effect Because all TMF recovery operations use buffered writes, a disk process takeover means that some updates to data blocks in cache within the last 10 minutes might not have reached disk. Therefore, the recovery process backs up to a preceding location within the audit trail and resumes processing. The preceding location is specified in the event message. Recommended Action Informative message only; no corrective action is needed.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. 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-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 ZTMF-TKN-RCOV-ERROR-INDEX contains an integer specifying an audit-trail index value (zero indicates the master audit trail; one through 15 indicate auxiliary audit trails). ZTMF-TKN-RCOV-ERROR-SNO contains an integer specifying an audit-trail file sequence number.
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 token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-STRING. ZSPI-TYP-INT. ZSPI-TYP-ENUM.
Descriptions of Event Messages Event Messages ZTMF-VAL-RCOV-READ ZTMF-VAL-RCOV-POSITION 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 token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-STRING. ZSPI-TYP-INT. ZSPI-TYP-ENUM.
Descriptions of Event Messages Event Messages ZTMF-VAL-RCOV-READ ZTMF-VAL-RCOV-POSITION 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 token-type ZSPI-TYP-ENUM.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-ENUM.
Descriptions of Event Messages Event Messages Recommended Action To determine if the transaction is “hung,” issue a STATUS TRANSACTION command, specifying the particular transaction identifier. If the transaction is “hung,” refer to the Guardian Procedure Errors and Messages Manual to see if the file-system error can be corrected. If recovery is possible, perform the corrective action, then issue a ABORT TRANSACTION command, specifying the particular transaction identifier.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-INT. Event-Message Text Recovery process failed due to audit reading exception: ZTMF-TKN-AUDITREADEXCEPTION.
Descriptions of Event Messages Event Messages 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. If the error was transitory, the recovery operation continues to completion. If the error persists, the recovery process abends again and is restarted.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. Event-Message Text The number of attempts to retry a backout operation has been exceeded to transid: ZTMF-TKN-RCOV-TRANSID.
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. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE ZTMF-TKN-RCOV-FILENAME-1 ZTMF-TKN-RCOV-ERROR-INDEX ZTMF-TKN-RCOV-ERROR-SNO ZTMF-TKN-RCOV-ERROR-RBA token-type token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-STRING. ZSPI-TYP-INT. ZSPI-TYP-INT2.
Descriptions of Event Messages Event Messages Effect The specified file can only be recovered to a timestamp before the previous file recovery operation. All audit information for the specified file following the file hiatus record in the audit trail is inaccessible. Recommended Action After performing file recovery to a timestamp or to first purge, make an online dump of the file immediately.
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 token-type ZSPI-TYP-ENUM. Event-Message Text The TMP has stopped; recovery process now stopping. 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 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 token-type ZSPI-TYP-ENUM. Event-Message Text The PFS is too small for the number of files requiring recovery.
Event Messages Descriptions of Event Messages 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 token-type ZSPI-TYP-ENUM. Event-Message Text The recovery program files must be licensed to recover SQL objects. 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 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-ERROR-SNO ZTMF-TKN-RCOV-ERROR-RBA token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-INT2. token-type ZSPI-TYP-INT2.
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 token-type ZSPI-TYP-ENUM. Event-Message Text Beginning TMF Subsystem Crash due to TMP failure. 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 181: ZTMF-EVT-CRASHTMFEND A TMF crash just finished. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE token-type ZSPI-TYP-ENUM. 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. The value of this token for this event is ZTMF-VAL-PROCTMFMON2. Effect TMF is down.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-INT. 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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-INT. token-type ZSPI-TYP-INT. 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 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 token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-INT. ZSPI-TYP-INT. 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 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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-ENUM. Event-Message Text The ZTMF-TKN-AUDITTRAILID Audit Trail is critically full. The TM/MP subsystem will shortly quit responding to most requests until the problem is corrected.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-ENUM. Event-Message Text The ZTMF-TKN-AUDITTRAILID Audit Trail is no longer critically full.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. token-type 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. 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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. 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 token-type ZSPI-TYP-ENUM. 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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. 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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-INT.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. token-type 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.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-INT.
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 token-type ZSPI-TYP-ENUM. Event-Message Text Action completion event for TMF *0200*. 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 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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-INT2. 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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-INT2. 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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-INT2.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-INT2.
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 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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. Event-Message Text Options: MEDIUM ZTMF-TKN-DR-DUMPMEDIUM ZTMF-TKN-DR-MEDIALIST.
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 token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-INT. ZSPI-TYP-INT. ZSPI-TYP-BOOLEAN.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. Event-Message Text *WARNING* ZTMF-TKN-DR-OTHERERRORTEXT 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 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 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.
Descriptions of Event Messages Event Messages 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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. 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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-INT. 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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-INT. token-type ZSPI-TYP-STRING. Additional Conditional Tokens ZTMF-TKN-DR-FILENAME token-type ZSPI-TYP-STRING.
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 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.
Descriptions of Event Messages Event Messages 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. ZTMF-TKN-DR-FILETYPE for ENSCRIBE files, specifies the file type. The possible values are: ZTMF-VAL-FILETYPEUNSTRUCT ZTMF-VAL-FILETYPERELATIVE ZTMF-VAL-FILETYPEENTRYSEQ ZTMF-VAL-FILETYPEKEYSEQ ZTMF-TKN-DR-SQLTYPE for NonStop SQL entities, specifies the entity type.
Descriptions of Event Messages Event Messages 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. The value of this token for this event is ZTMF-VAL-PROCONLINEDUMP. ZTMF-TKN-DR-FILESDUMPED contains an integer specifying the number of database tables and files that were successfully dumped.
Descriptions of Event Messages Event Messages ZTMF-TKN-DR-FILENAME is the name of the missing file. ZTMF-TKN-DR-DUMPSERIALNUM is a dump serial number. ZEMS-TKN-EMPHASIS is set to TRUE for this event. Effect The file is not restored. Recommended Action Determine the correct dump serial number and then retry the restore operation.
Descriptions of Event Messages Event Messages ZTMF-TKN-DR-DUMPSERIALNUM is a dump serial number. ZEMS-TKN-EMPHASIS is set to TRUE for this event. Effect The file is not restored. Recommended Action Determine which archive tape error occurred, correct the error condition, and then retry the restore operation. 250: ZTMF-EVT-ADALTERCOPIES An operator or subsystem control program (SPI requester) issued an ALTER AUDITDUMP command, specifying a new COPIES attribute value.
Descriptions of Event Messages Event Messages ZTMF-VAL-AUX02 Auxiliary audit trail #2 ... ZTMF-VAL-AUX15 Auxiliary audit trail #15 ZTMF-TKN-ATDUMPCOPIES specifies the new value of the COPIES attribute for audit dumping by the designated audit trail. Effect The new attribute value takes effect immediately. Recommended Action Informative message only; no corrective action is needed.
Descriptions of Event Messages Event Messages ZTMF-TKN-AUDITTRAILID is the subject token of the event message, and it specifies which audit trail the message applies to. The possible 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-ATDUMPSERIES specifies the new value of the AUDITDUMP attribute for audit dumping by the designated audit trail.
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 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 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. Event-Message Text DISKMEDIA ZTMF-TKN-DISKMEDIASTRING deleted from the dump configuration for the ZTMF-TKN-AUDITTRAILID audit trail.
Descriptions of Event Messages Event Messages 261: ZTMF-EVT-ATDUMPDMADDED The specified 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 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 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 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 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 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 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 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 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 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 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 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. If that is the case, ensure that dump volumes are available and that there are overflow-audit volumes configured for the audit trail.
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 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 per 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 ZEMS-TKN-EMPHASIS token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-INT. ZSPI-TYP-INT. ZSPI-TYP-BOOLEAN. Event-Message Text File-system error ZTMF-TKN-FS-ERROR occurred attempting to perform a ZTMF-TKN-COMMAND operation to the Catalog Process.
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 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 The TMP 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.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-INT. 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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-FNAME32. token-type 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 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 token-type ZSPI-TYP-ENUM. token-type ZTMF-TYP-MEDIA. 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 token-type ZSPI-TYP-ENUM. token-type ZTMF-TYP-MEDIA. token-type 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 token-type ZSPI-TYP-ENUM. token-type ZTMF-TYP-MEDIA. Event-Message Text ZTMF-TKN-MEDIA altered in the TMF catalog.
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 token-type ZSPI-TYP-ENUM. token-type ZTMF-TYP-MEDIA. token-type 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.
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 token-type ZSPI-TYP-ENUM. token-type ZTMF-TYP-MEDIA. 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 token-type ZSPI-TYP-ENUM. token-type ZTMF-TYP-MEDIA. token-type 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.
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 token-type ZSPI-TYP-ENUM. token-type ZTMF-TYP-MEDIA. token-type ZTMF-TYP-INT.
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 token-type token-type token-type token-type ZSPI-TYP-ENUM. ZTMF-TYP-MEDIA. ZTMF-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.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-FNAME. token-type ZTMF-TYP-INT.
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 token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-FNAME. ZTMF-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.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-FNAME. token-type ZTMF-TYP-INT.
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 token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-FNAME. ZTMF-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.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-FNAME. token-type ZTMF-TYP-INT.
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 token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-FNAME.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-FNAME. token-type ZTMF-TYP-INT.
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. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE ZTMF-TKN-FILENAME ZTMF-TKN-DUMPSERIAL ZTMF-TKN-FS-ERROR token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-FNAME.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-INT2. token-type ZTMF-TYP-FNAME32.
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 token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-FNAME32. ZTMF-TYP-INT2.
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-NOCTLGENTRY 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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. 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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-USERID. Event-Message Text The Resource Manager ZTMF-TKN-RMNAME is successfully created by the user ZTMF-TKN-USER.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-USERID. Event-Message Text The Resource Manager ZTMF-TKN-RMNAME is successfully removed by the user ZTMF-TKN-USER.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-USERID. 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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-USERID. Event-Message Text The Resource Manager ZTMF-TKN-RMNAME is successfully closed by the user ZTMF-TKN-USER.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-USERID.
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.
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 token-type token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-STRING. ZSPI-TYP-INT. ZSPI-TYP-INT. 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 token-type ZSPI-TYP-ENUM. 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 way of 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 token-type ZSPI-TYP-ENUM. 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-AUXPTRINAUX ZTMF-VAL-AREXCP-AUXPTRMISMATCH ZEMS-TKN-EMPHASIS is set to TRUE for this event. Effect The START TMF operation is terminated. TMF does not start. Recommended Action Try to correct the problem identified in the message and restart TMF.
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 token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-STRING. ZSPI-TYP-TRANSID. 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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. token-type 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. 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 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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-STRING.
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 token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-STRING. ZSPI-TYP-STRING. ZSPI-TYP-STRING.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. token-type 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-VAL-RCOV-LOGICALUNDO ZTMF-VAL-RCOV-PHYSICALUNDO ZTMF-VAL-RCOV-FLABMODREDO 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 ZTMF-TKN-RCOV-ERROR-INDEX contains an integer specifying an audit-trail index value (zero indicates the master audit trail; one through 15 indicate auxiliary audit trails).
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 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-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 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.
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 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 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 token-type ZSPI-TYP-ENUM.
Descriptions of Event Messages Event Messages 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. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE ZTMF-TKN-RCOV-FILENAME-1 ZTMF-TKN-RCOV-FILENAME-1 ZTMF-TKN-RCOV-ERROR-INDEX ZTMF-TKN-RCOV-ERROR-SNO ZTMF-TKN-RCOV-ERROR-RBA token-type token-type token-type token-type token-type token-type ZSPI-TYP-ENUM.
Descriptions of Event Messages Event Messages Effect The specified file can only be recovered to a timestamp before the previous file recovery operation. All audit information for the specified file following the file hiatus record in the audit trail is inaccessible. Recommended Action After performing file recovery to a timestamp or to first purge, make an online dump of the file immediately.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-INT. Event-Message Text The maximum RM branch slot array size set during START TMF has been exceeded. The new maximum size is ZTMF-TKN-RMSLOTARRAYSIZE.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-INT.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. Event-Message Text The resource manager ZTMF-TKN-RMNAME is successfully closed. An operator closed the resource manager. There are no indoubt transaction branches.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. Event-Message Text The resource manager ZTMF-TKN-RMNAME is successfully closed. An operator closed the resource manager.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. Event-Message Text The resource manager ZTMF-TKN-RMNAME is successfully closed because of a CPU failure. There are no in-doubt transaction branches.
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 token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-STRING. Event-Message Text The resource manager ZTMF-TKN-RMNAME is successfully closed because of a CPU failure.
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-ERROR-SNO ZTMF-TKN-RCOV-ERROR-RBA token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-INT2. token-type ZSPI-TYP-INT2.
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-ERROR-SNO ZTMF-TKN-RCOV-ERROR-RBA token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-INT2. token-type ZSPI-TYP-INT2. Event-Message Text Phase 1 of recovery completed at at seqno #ZTMF-TKN-RCOVERROR-SNO RBA #ZTMF-TKN-RCOV-ERROR-RBA.
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-ERROR-SNO ZTMF-TKN-RCOV-ERROR-RBA token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-INT2. token-type ZSPI-TYP-INT2. Event-Message Text Phase 2 of file recovery completed at at seqno #ZTMF-TKNRCOV-ERROR-SNO RBA #ZTMF-TKN-RCOV-ERROR-RBA.
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-ERROR-SNO ZTMF-TKN-RCOV-ERROR-RBA token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-INT2. token-type ZSPI-TYP-INT2. Event-Message Text Phase 3 of recovery completed at at seqno #ZTMF-TKN-RCOVERROR-SNO RBA #ZTMF-TKN-RCOV-ERROR-RBA.
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 possible 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-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 token-type ZSPI-TYP-ENUM. Event-Message Text File Recovery in DR mode could not find a Node name in the Audit Trail. Additional Unconditional Tokens ZTMF-TKN-EVTHDR-PROCESSTYPE identifies the TMF process that generated the event.
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 possible 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 ZTMF-TKN-RCOV-ERROR-INDEX contains an integer specifying an audit-trail index value (zero indicates the master audit trail; 1 through 15 indicate auxiliary audit trails). 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 file. Effect This event message is accompanied by event 358.
Event Messages Descriptions of Event Messages HP NonStop TMF Management Programming Manual—522420-002 6 -392
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. 501 ZTMF-ERR-USEDLENTOOLARGE The USEDLEN of the SPI buffer (received by the TMFSERVE process) indicated a buffer larger than the buffer actually read.
Error and Warning Messages 506 Errors 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. 507 ZTMF-ERR-EMPTYRESPONSE This is an empty response as defined in the Distributed Systems Management (DSM) Programming Manual. 508 ZTMF-ERR-INVALIDCONTEXT The context token received by the TMFSERVE process was not valid.
Error and Warning Messages 514 Errors ZTMF-ERR-BADTMPMEMTHRESH The low value of the TMPMEMTHRESHOLD 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. 515 ZTMF-ERR-BADTRANSPERCPU Either value of the TRANSPERCPU token is less than 1 or greater than 1,073,741,824. No error list is included in the response. 516 ZTMF-ERR-BADAUTOABORT The value of the ZAUTOABORT token is less than zero or greater than 21,474,836.
Error and Warning Messages 566 Errors ZTMF-ERR-TOOMANYSTRUCTTOKENS An SPI message contains more than one structured token. No error list is included in the response. 603 ZTMF-ERR-NOSUCHTRANSACTIONS Nonexistent transaction identifiers supplied. No error list is included in the response. 604 ZTMF-ERR-NOSUCHDISKMEDIAVOLUME Nonexistent disk volume names supplied in disk media list. The ZTMF-TKN-DISKMEDIA token supplied within the error list provides additional information.
Archive Tape Errors and Warnings Error and Warning Messages 950 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 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.
Error and Warning Messages Archive Tape Errors and Warnings 8004 File names for the two parallel tape copies are not unique. One of two parallel copies of a tape dump is labeled, but the other is not. 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 8011 The tape DEFINE ZART-TKN-DEFINENAME specifies labeled tape processing and labeled tape support is not configured. The local system does not have labeled tape support configured. 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.
Error and Warning Messages Archive Tape Errors and Warnings 8028 Tape record type is unknown. The tape record type 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. 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.
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. 9150 An audit dump of audit trail file ZTMF-TKN-DR-TRAILFILENAME was not found in the TMF Catalog. The specified audit dump file must be restored to perform a RECOVER FILES operation, but could not be found in the TMF catalog.
Error and Warning Messages Dump/Restore Errors and Warnings 9250 Disk volume ZTMF-TKN-DR-DUMPFILENAME.could not be used for a dump file due to file-system error ZTMF-TKN-DR-FILEERROR. A file-system error occurred while a dump process was attempting to use a disk volume. The ZEMS-TKN-EMPHASIS token is set to TRUE. 9251 Disk volume ZTMF-TKN-DR-DUMPFILENAME.could not be used for a dump file because it is under a pre-C10 operating system.
Error and Warning Messages Dump/Restore Errors and Warnings 9257 The file was aborted in the middle of the disk dump; it should not be in the TMF Catalog. A file cancellation record was found during a dump restore operation, indicating that the dump of the file was aborted in the middle. This could have been caused by an erroneous ADD DUMPS command. The ZEMS-TKN-EMPHASIS token is set to TRUE.
Error and Warning Messages Dump/Restore Errors and Warnings 9262 Disk audit-dump labels file ZTMF-TKN-DR-DUMPFILENAME.is not file code 133. The file code of the disk audit dump labels file was not 133. The ZEMS-TKN-EMPHASIS token is set to TRUE. 9263 Disk audit-dump labels file ZTMF-TKN-DR-DUMPFILENAME.is not file code 134. The file code of the disk audit dump labels file was not 134. The ZEMS-TKN-EMPHASIS token is set to TRUE. 9264 Disk audit-dump file ZTMF-TKN-DR-DUMPFILENAME.is broken.
Error and Warning Messages Dump/Restore Errors and Warnings 9268 Unexpected end-of-file encountered on disk dump file ZTMF-TKNDR-DUMPFILENAME. While restoring an audit dump, an audit restore process detected that the disk audit dump file has been corrupted. The ZEMS-TKN-EMPHASIS token is set to TRUE. 9269 TMF disk audit-dump file ASCII identifier is bad in ZTMF-TKN-DRDUMPFILENAME. While restoring an audit dump, an audit restore process detected that the disk audit dump file has been corrupted.
Audit Reading Exceptions Error and Warning Messages Audit Reading Exceptions The audit reading exceptions returned by the TMF recovery processes in the token ZTMF-TKN-AUDITREADEXCEPTION by TMF event message 173 are listed and described in this section. Some of the audit reading exception strings include tokens, others do not.
Audit Reading Exceptions Error and Warning Messages ZTMF-VAL-AREXCPEOFFIXUPNEEDED Audit trail file ZTMF-TKN-AUDITFILENAME requires EOF fixup. The specified audit-trail file requires end-of-file fixup. GETCURRENTEOF Failed to obtain current EOF from TMP for audit trail ZTMF-TKN-AUDITFILENAME. Error ZTMF-TKNFS-ERROR was returned. A file-system error was returned while attempting to obtain the current end-of-file for an audit-trail file from the TMP.
Audit Reading Exceptions Error and Warning Messages ZTMF-VAL-AREXCPINVFILECODE Invalid file code ZTMF-TKN-ARET-FILECODE for audit file ZTMF-TKN-AUDITFILENAME. The file code of the specified audit-trail file is invalid. INVRECORDLEN Audit record has invalid length ZTMF-TKN-ARETLENGTH at RBA ZTMF-TKN-ARET-RBA in audit file ZTMF-TKN-AUDITFILENAME. The specified audit record has an invalid length. OPEN Unable to OPEN audit file ZTMF-TKNAUDITFILENAME, error ZTMF-TKN-FS-ERROR, open flags.
Audit Reading Exceptions Error and Warning Messages ZTMF-VAL-AREXCPSETMODE SETMODE operation % ZTMF-TKN-ARETOPERATION on audit file ZTMF-TKNAUDITFILENAME failed with error.ZTMF-TKN-FSERROR. A SETMODE operation on the specified audit-trail file failed due to a file-system error. WRITE WRITE to RBA ZTMF-TKN-ARET-RBA of audit file ZTMF-TKN-AUDITFILENAME failed with error.ZTMFTKN-FS-ERROR. A WRITE operation to the specified relative byte address failed due to a file-system error.
Error and Warning Messages Audit Reading Exceptions HP NonStop TMF Management Programming Manual—522420-002 7- 78
A TMF Configuration Limits and Defaults The tables in this appendix summarize various limits and defaults for TMF. Caution. Some of the limits and defaults described in this appendix may have changed since this manual was published with RVU G06.23. If such changes were made, they will be described in TMF Supplement for Limits and Defaults Changed after RVU G06.23. If that Supplement currently exists, please read it for new information about limits and defaults.
TMF Configuration Limits and Defaults Table A-2. Audit Trail Limits and Defaults Parameter Limits Default Active-audit volumes per audit trail 1 through 16 None Audit dumping feature On Audit-trail files per active-audit volume 1 through 100. Active-audit volumes multiplied by files per active-audit volume must be 2 or greater.
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 Number of processes Extended segment size Default 0 if not needed; 1 or more as needed 0.5 through 128 MB (127.5 MB actual) 0.5 MB Backout process type Number of processes Extended segment size Always 4 5 through 128 MB (127.
TMF Configuration Limits and Defaults Table A-6. Process Limits and Defaults (page 3 of 3) Parameter Extended segment size Limits Default Always 0.25 MB 0.25 MB TMP process type Number of processes Extended segment size 1 primary and 1 backup process See discussion, “EXTENDEDSEGSIZE Option Considerations for the TMP” in TMF Reference Manual. Volume recovery process type Number of processes 0 through 8. (If the system has fewer than 8 processors, the upper limit is the number of processors.
TMF Configuration Limits and Defaults HP NonStop TMF Management Programming Manual—522420-002 A- 6
Index A A bad standard… (error 8162) 7-58 A good copy of tape… (error 9007) 7-60 A parity error occurred… (error 8156 & 8157) 7-58 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-24 ALTER AUDITDUMP command 5-27 ALTER AUDITTRAIL command 5-32 ALTER BEGINTRANS command 5-37 ALTER CATALOG command 5-41 ALTER DATAVOLS command 5-43 ALTER DUMPS command 5-45 ALTER MEDIA co
C Index Both archive begin volume… (error 8102) 7-55 Buffer declarations 4-5/4-6 Buffer size for event messages 3-9 minimum for event messages 6-17 Buffer sizes 3-5 C CANCEL OPERATION command 5-56 CANCEL procedure 3-6 Cancelling commands in progress 3-6 CANCELREQ procedure 3-6 Cannot read the disk… (error 9103) 7-67 Cannot recover an SQL… (error 9203) 7-69 Catalog messages 6-16 CATALOG objects ALTER command 5-41 DELETE command 5-60 INFO command 5-105 STATUS command 5-158 Checksum error occurred… (error 9
E Index DISABLE BEGINTRANS command 5-76 DISABLE DATAVOLS command 5-78 Discontinuing commands 3-6 Disk audit-dump file… (error 9264 & 9265) 7-72 Disk audit-dump labels… (error 9262 & 9263) 7-72 Disk dump file… (error 9267) 7-72 Disk volume…could not… (error messages) 7-70 Distributors, starting 3-8 DSM facilities 1-1/1-2 Dump and restore errors and warnings 7-58/7-73 DUMP FILES command 5-80 Dump process messages 6-15 DUMPS objects ADD command 5-17 ALTER command 5-45 DELETE command 5-63 INFO command 5-110 D
G Index File-system error… (error 9030) 7-64 File-system error… (error 9032) 7-64 File-system error… (error 9110) 7-68 File-system error… (error 9260) 7-71 File-system error… (error 9266) 7-72 Filters, EMS 6-18 compiling and using 3-10 loading 3-8 Found a pre-C00… (error 8108) 7-56 Found a regular… (error 8107) 7-56 FUP (File Utility Program) 1-7 Internal error… (error 9004 & 9005) 7-59 Internal error… (error 9056 & 9057) 7-66 Internal error… (error messages) 7-69 G M GETEVENT command 6-4 GETEVENT com
N Index Messages, event buffer size 3-9 retrieving and decoding 3-8 templates 3-10 Messages, receiving and decoding response 3-6/3-7 Multiple occurrences of tokens 3-6, 3-7 Multiple response records 3-7 Must begin with tape… (error 9029) 7-63 N Naming guidelines (Zxxx) 3-11 NEXT AUDITTRAIL command 5-127 No audited files matched… (error 9115) 7-69 Nonsensitive commands 3-8 NonStop SQL error… (error 9033) 7-64 NonStop SQL error… (error 9050) 7-66 Noticed TMF was shutting… (error 9025) 7-63 O Objects numbe
S Index Restore audit volume, definition 1-4 Restore process messages 6-15 Return token 3-7 S SCREEN COBOL programming language 1-8/1-9 Security 3-8 Sensitive commands 3-8 Simple tokens 4-2, 4-8, 5-4 Skipping non-audited… (error 9111) 7-68 SOURCE statements 3-2 Special tokens 4-2 SPI See Subsystem Programmatic Interface (SPI) SPI (Subsystem Programmatic Interface) programming elements 3-3/3-4 SSGET and SSGETTKN procedures 3-6, 3-9 SSGETTKN command 6-17 SSINIT procedure 3-5 SSMOVE and SSMOVETKN procedures
T Index Templates, EMS and objects 3-10 The attribute… (error 8014) 7-50 The data read from… (error 8150) 7-57 The DEVICE attribute… (error message) 7-49 The dump has the wrong… (error 9250) 7-71 The file was aborted… (error 9015) 7-61 The file was aborted… (error 9257) 7-71 The startup message version… (error 9003) 7-59 The SYSTEM attribute… (error message) 7-49 The tape has the wrong… (error 9011 & 9012) 7-60 The tape is not a TMF… (error 9027 & 9028) 7-63 The tape was not positioned… (error 8103) 7-55
U Index TRANSACTION objects ABORT command 5-5 DELETE command 5-72 RESOLVE command 5-138 STATUS command 5-185 TRANSACTIONCHILDREN objects STATUS command 5-192 Transactions committed 5-73 hung 5-73 Transactions, definition 1-3 U Unable to complete… (error 9259) 7-71 Unable to create file… (error 9026) 7-63 Unable to get TMF… (error 9105& 9106) 7-67 Unable to obtain disk… (error 9000) 7-59 Unable to obtain SQL… (error 9002) 7-59 Unable to open disk… (error 9261) 7-71 Unable to recognize… (error 8104 & 8106)
Z Index ZDISABLETMPMEM field 5-157 ZDISABLETXCOUNT field 5-156 ZDISTRIBUTED field 5-189 ZDUMPINVALID field 5-46 ZDUMPSTATUS field 5-112 ZDUMPTYPE field 5-18, 5-112 ZEMSDDL file 4-4 ZEMS-TKN- tokens ACTION-ID 6-77 ACTION-NEEDED 6-77 CONSOLE-PRINT 6-17 CPU 6-2 data-portion 4-4 EMPHASIS 3-10, 6-2, 6-19, 6-21, 6-22, 6-23, 6-26, 6-28, 6-30, 6-31, 6-33, 6-35, 6-36, 6-38, 6-42, 6-44, 6-46, 6-48, 6-50, 6-52, 6-54, 6-67, 6-69, 6-72, 6-73, 6-75, 6-77, 6-83, 6-84, 6-86, 6-87, 6-89, 6-91, 6-92, 6-93, 6-94, 6-96, 6-98
Z Index ZPROCESSACCESSID field 5-183 ZPROCESSNAME field 5-183 ZPROCESSPHANDL field 5-189 ZPROCESSTIME field 5-183 ZPROGRAMFILENAME field 5-183 ZRECOVERYMODE field 5-15, 5-44, 5-108 ZRELEASED field 5-42, 5-46, 5-106 ZRETAINDEPTH field 5-41, 5-106 ZRETRYCOUNT field 5-190 ZROUNDROBIN field 5-106 ZSERIAL field 5-18, 5-46, 5-64, 5-112 ZSERIESCOPIES field 5-29, 5-97 ZSERVERNAME field 5-184 ZSORTSELECT field 5-112 ZSPIDDL file 4-1 ZSPIDEF.
Z Index ATCANTDELETECURRVOL (error 336) 7-32 ATCANTDELETENEXTVOL (error 337) 7-32 ATDOESNOTEXIST (error 339) 7-32 ATNOACTIVEVOLS (error 325) 7-29 ATNORESTOREVOLS (error 326) 7-29 ATNOTDUMPING (error 364) 7-37 ATTOOFEWACTIVEFILES (error 360) 7-36 ATVOLALREADYACTIVE (error 327) 7-29 ATVOLHASINVALIDFILES (error 338) 7-32 ATVOLNONEXISTENT (error 357) 7-35 ATVOLNOTCONFIGASTYPE (error 334) 7-31 AUDINFOERROR (error 329) 7-30 AUDITDUMPONEFILEONLY (error 70) 7-8 AUXATISDUMPING (error 359) 7-36 BACKUPTMPCANTHANDLE
Z Index CTLGCOUNTTRAILCOPIES (error 309) 7-27 CTLGDELETEDUMPFILE2 (error 311) 7-28 CTLGGETCATALOGSTATUS (error 296) 7-26 CTLGGETDUMP (error 306) 7-27 CTLGLOCATEFILE (error 305) 7-27 CTLGMEDIAASSIGNMENT (error 307) 7-27 CTLGMEDIAINUSE (error 300) 7-27 CTLGNOSCRATCHREELS (error 297) 7-26 CTLGNOTRUNNING (error 295) 7-26 CTLGREELSTATUS (error 304) 7-27 CURSORREUSED (error 105) 7-11 DATAVOLALREADYCONFIGD (error 393) 7-40 DATAVOLINACCESSIBLE (error 390) 7-39 DATAVOLNEEDSATDUMP (error 372) 7-38 DATAVOLNOTSELECTE
Z Index INTERNALERROR (error 950) 7-48 INVABRUPTFLAG (error 96) 7-10 INVACTIVEVOLUME (error 127) 7-13 INVADDACTIVEVOLUME (error 121) 7-12 INVADDOVERFLOWVOLUME (error 122) 7-12 INVADDRESTOREVOLUME (error 123) 7-12 INVALIDABRUPT (error 385) 7-39 INVALIDADDDUMPS (error 276) 7-25 INVALIDBEGINTIME (error 112) 7-11 INVALIDBLOCKSIZE (error 42) 7-6 INVALIDCONTEXT (error 508) 7-45 INVALIDCOPIES (error 33) 7-5 INVALIDCPU (error 36) 7-5 INVALIDDENSITY (error 37) 7-5 INVALIDDISKMEDIA (error 77) 7-8 INVALIDDISKMEDIAST
Z Index INVAUTOABORTOPT (error 236) 7-22 INVBEGINTRANSDISABLE (error 137) 7-14 INVBRANCHESPERRM (error 169) 7-18 INVDATAVOLSTATE (error 94) 7-10 INVDEBUG (error 443) 7-42 INVDELACTIVEVOLUME (error 124) 7-12 INVDELOVERFLOWVOLUME (error 125) 7-12 INVDELRESTOREVOLUME (error 126) 7-12 INVEXTENDEDSEGSIZE (error 448) 7-43 INVFILESIZE (error 135) 7-14 INVFILESPERVOLUME (error 134) 7-13 INVIGNOREDATAERRORS (error 89) 7-9 INVIGNOREHANGING (error 104) 7-10 INVIGNOREPREVCFLAG (error 93) 7-10 INVINSPECT (error 444) 7
Z Index MEDIAREQUIRED (error 59) 7-7 MEDIAWRONGMEDIUM (error 265) 7-24 MISSINGOPERNUMTKN (error 145) 7-15 MISSINGSTRUCTTOKEN (error 565) 7-46 MUSTBECONFIGOWNER (error 256) 7-23 MUSTBEONLYVOLUME (error 452) 7-43 MUSTBESPECIFICUSER (error 257) 7-23 MUSTBESTARTED (error 361) 7-36 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 MUSTSPECIFYDUMPSERIAL (error 14
Z Index OPERATIONDOESNOTEXIST (error 425) 7-41 OPTIONNEEDED (error 157) 7-16 OUTPUTONLYFIELDUSED (error 13) 7-4 PARTOUTOFSEQUENCE (error 279) 7-25 PREVATNOTCONFIG (error 324) 7-29 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
Z Index WARNNODUMPSRELOCATED (error 155) 7-16 WILDCARDTRANSID (error 11) 7-4 WILDORNAMENOTBOTH (error 90) 7-9 WILDORRMNAMENOTBOTH (error 173) 7-19 WRONGTRANSSTATE (error 386) 7-39 ZTMF-EVT- event messages ABORTDUETOAUDOVFLOW (event 289) 6-291 ADALTERBLOCKSIZE (event 253) 6-241 ADALTERCOPIES (event 250) 6-236 ADALTERMEDIUM (event 255) 6-243 ADALTERSERIES (event 251) 6-237 ADALTERSYSTEMNAME (event 256) 6-245 ADALTERSYSTEMNAME2 (event 257) 6-246 ADALTERUNLOADMEDIA (event 254) 6-242 ADALTERVERIFYTAPE (event 2
Z Index ATRESTOREFAILED (event 274) 6-271 ATRESTOREMEDERR (event 272) 6-267 ATRESTORESUCCESS (event 275) 6-273 ATRESTORETARGETERR (event 273) 6-269 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 (event 102) 6-65 ATVOLHASEXTRAFILES (event 103) 6-67 ATVOLHASINVFILE (event 104) 6-69 ATVOLISDOWN (event 117) 6-89 ATVOLWENTDOWN (event 114) 6-84 AudinfoErr (event 87) 6-39 AuditRead-Error (event 332) 6-346 BACKUP
Z Index CTGALTERRE (event 282) 6-283 CtgAlterRR (event 430) 6-379, 6-383 CTGPROCESSERR (event 283) 6-284 DELETECTG (event 284) 6-286 DELETINGTMF (event 141) 6-119 DISABLECOMMAND (event 128) 6-103 DOWNNODE (event 297) 6-301 DR-ARCHTAPEERR (event 204) 6-201 DR-ARCHTAPEMOUNTERR (event 206) 6-205 DR-ARCHTAPEMOUNTWARN (event 207) 6-207 DR-ARCHTAPEWARN (event 205) 6-203 DR-BEGINDISK (event 224) 6-229 DR-BEGINTAPE (event 222) 6-226 DR-DISKAUDITDUMP (event 210) 6-212 DR-DISKONLINEDUMP (event 212) 6-214 DR-ENDINGD
Z Index FRList-ErrFromDatavol (event 351) 6-352 FRLIST-ErrFromTmp (event 350) 6-350 FRLIST-EXCEPTERROR3 (event 192) 6-188 FRLIST-EXCEPTNOMATCH (event 191) 6-187 FRLIST-EXCEPTVOLERR (event 190) 6-185 FRLIST-FILEERROR (event 197) 6-192 FRLIST-FILENOTFOUND (event 353) 6-355 FRLIST-INVALCTLGENTRY (event 193) 6-189 FRLIST-LOGICALNOTUNDO (event 354) 6-356 FRLIST-NOCATALOGENTRY (event 352) 6-354 FRLIST-NOCTLGENTRY (event 319) 6-333 FRLIST-NOTSCTLGENTRY (event 321) 6-335 FRLIST-NOTUNDONEEDED (event 194) 6-190 FRL
Z Index RCOV-PFS-TOO-SMALL (event 177) 6-167 Rcov-Restart1 (event 166) 6-148 Rcov-Restart2 (event 167) 6-150 RCOV-STOPABRUPT (event 176) 6-166 Rcov-StopObjectRcov (event 171) 6-157 RCOV-STOPOBJECTRCOV2 (event 358) 6-363 RCOV-TORBA-TOO-LOW (event 179) 6-170 RDFPREVENTSTOP (event 186) 6-181 READMIGRATEFILEERR (event 291) 6-294 RMATISCRITICALLYFULL (event 188) 6-184 RMUNABLETOCREATEMON2 (event 184) 6-177 RM-CLOSED (event 325) 6-339 RM-CpuDownClosed (event 394) 6-371 RM-CpuDownCrashed (event 395) 6-372 RM-CRA
Z Index ZTMF-MAP- extensible tokens (continued) DELETE-DATAVOLS 5-62 DELETE-DUMPS 5-64 DELETE-MEDIA 5-66 DISABLE-AUDITDUMP 5-75 DISABLE-DATAVOLS 5-79 DUMP-FILES 5-82/5-84 INFO-AUDITDUMP 5-97/5-98 INFO-AUDITTRAIL 5-100/5-101 INFO-BEGINTRANS 5-103 INFO-CATALOG 5-106 INFO-DATAVOLS 5-108 INFO-DATAVOLS-R 5-109 INFO-DUMPS 5-111/5-113, 5-113/5-114 INFO-MEDIA 5-116, 5-117 INFO-PROCESSES 5-120/5-121 RECOVER-FILES 5-130 RESOLV-TRANSACTION 5-139 START-TMF 5-141 STATUS-AUDITDUMP 5-149 STATUS-AUDITTRAIL 5-153 STATUS-B
Z Index ZTMF-TKN- tokens (continued) CTGRELEASED 6-283 CTGRETAINDEPTH 6-282 DELRESTOREVOLUME 5-34 DISASTERRECOVERY 6-128 DISKMEDIA 5-18, 5-81 DISKMEDIASTRING 5-31, 5-92, 6-249 DR-DATAATSEQNUM 6-232 DR-DISKAUDDUMPFNAME 6-212 DR-DUMPBLOCKSIZE 6-222 DR-DUMPCOPIES 6-222, 6-227 DR-DUMPENDTIME 6-232 DR-DUMPINITEOF 6-233 DR-DUMPMEDIUM 6-221 DR-DUMPSERIALNUM 6-212 DR-ERROR 6-199, 7-58 DR-FILENAMESUPPLIED 6-197, 6-199 DR-FILESDUMPED 6-234 DR-FILESET 6-219 DR-FILESNOTDUMPED 6-234 DR-FILETYPE 6-233 DR-FIRSTTAPE 6-22
Z Index ZTMF-TKN- tokens (continued) RCOV-RESTART-RBA 6-148 RCOV-RESTART-SNO 6-148 RCOV-SUCCESSNUM 6-147 RCOV-TRANSID 6-159, 6-163 RCOV-TXSTATUS 6-159 RCOV-VOLUMENAME-1 6-157, 6-363 RESTOREVOLUME 5-10, 5-94 RETCODE 5-125 SWAP 5-52, 5-120 TERM 5-53, 5-120 TIMESTAMP 5-189 TMPFRFILENAME 6-139 TOPHYSVOL 5-130 TRANSALLOWOPTION 6-128 TRANSID 5-7, 5-72, 6-25 VOLUMENAME 5-11, 5-14, 5-36, 5-43, 5-108, 5-109, 5-125, 6-19 WHEREPHYSVOLIS 5-130 ZTMF-TYP- token types CHILDREN 4-6 DISKMEDIA 4-7 MEDIA 4-7 USERNAME 4-8 ZT
Special Characters Index ZTMF-VAL- values (continued) MEDIUMTAPE 5-21, 5-30, 5-48, 5-98 MINBUFLEN 3-5, 4-6 MINBUFLEN-W 4-6 nnnnBPI 5-22 ONLINEDUMP 5-18, 5-112 OPER-nnn 5-167 OVERFLOWVOL 5-94 predefined values, list of 4-5 PREPARED 5-188 PROC-nnn 5-50, 5-119, 6-97 PURGE 6-50 RECOVERFILES 6-3 RECOVMODE-ARCHIVE 5-15, 5-44, 5-108 RECOVMODE-ONLINE 5-15, 5-44, 5-108 RELEASED 5-22, 5-48, 5-112 RENAME 6-50 RESETMEDIUM 5-30 RESTOREVOL 5-94 SCRATCH 5-22, 5-48 SSID 4-8 STARTING-nnn 5-180 STARTSTOP 5-22 STARTTMF 6-3
Special Characters Index HP NonStop TMF Management Programming Manual—522420-002 Index -26
