DSM/Tape Catalog Management Programming Manual Abstract This manual describes the management programming interfaces to the Distributed Systems Management/Tape Catalog (DSM/TC) software system. Product Version DSM/TC G06 Supported Release Version Updates (RVUs) This manual supports G06.23 and all subsequent G-series RVUs until otherwise indicated in a new edition.
Document History Part Number Product Version Published 427024-001 N/A March 2001 429829-001 N/A April 2001 520481-001 N/A July 2001 520481-002 DSM/TC G06 August 2002 520481-003 DSM/TC G06 April 2004
DSM/Tape Catalog Management Programming Manual Index Tables What’s New in This Manual xvii Manual Information xvii New and Changed Information About This Manual xxi Notation Conventions xvii xxii 1. Introduction to DSM/TC The Advantages of Using DSM/TC 1-1 Programmatic Interface to DSM/TC Functions Application Management Functions 1-2 1-2 2.
3. SPI Programming Considerations (continued) Contents 3. SPI Programming Considerations (continued) A Command in Progress, Discontinuing 3-8 Response Buffers, Receiving and Decoding 3-8 Error Handling 3-9 Security 3-9 4.
. Commands and Responses (continued) Contents 5.
A. Errors (continued) Contents A.
A. Errors (continued) Contents A.
A. Errors (continued) Contents A.
A. Errors (continued) Contents A.
A. Errors (continued) Contents A.
A. Errors (continued) Contents A.
A. Errors (continued) Contents A.
A. Errors (continued) Contents A.
B. RPC Event Messages (continued) Contents B. RPC Event Messages (continued) 5 ZRPC-EVT-RPC-ERR B-11 6 ZRPC-EVT-CREATE-ERR B-13 7 ZRPC-EVT-CONN-LOST B-15 8 ZRPC-EVT-BKUP-FAIL B-16 9 ZRPC-EVT-BAD-VSN B-18 10 ZRPC-EVT-MEM-FULL B-19 11 ZRPC-EVT-PROG-ERR B-20 12 ZRPC-EVT-UNEXP-IO-CMPL B-22 13 ZRPC-EVT-MAX-ABENDS B-23 14 ZRPC-EVT-UNKWN-MSG-SRC B-25 15 ZRPC-EVT-UNEXP-SYS-MSG B-27 16 ZRPC-EVT-CLNT-STAT-ERR B-28 17 ZRPC-EVT-PORTMAP-ERR B-30 18 ZRPC-EVT-FUNC-CALL-FAIL B-32 C.
C. SSI Event Messages (continued) Contents C.
D. Tape Server Event Messages Contents D.
D. Tape Server Event Messages (continued) Contents D.
Tables (continued) Contents Tables (continued) Table A-11. Table A-12. Table C-1. Table C-2. Table C-3. Table C-4. Table C-5. Table C-6. Table C-7. Table C-8.
What’s New in This Manual Manual Information DSM/Tape Catalog Management Programming Manual Abstract This manual describes the management programming interfaces to the Distributed Systems Management/Tape Catalog (DSM/TC) software system. Product Version DSM/TC G06 Supported Release Version Updates (RVUs) This manual supports G06.23 and all subsequent G-series RVUs until otherwise indicated in a new edition.
What’s New in This Manual New and Changed Information This edition provides new material: • • • • • • Four MEDIADBM Errors were added: ° ° ° ° 635 ZMCS-ERR-INVALIDARCHIVE on page A-26 636 ZMCS-ERR-INVALIDLONGNAME on page A-26 637 ZMCS-ERR-INCONSISTENTLEVEL on page A-27 903 ZMCS-ERR-NEEDCATALOGUPGRADE2 on page A-28 Six MEDIASRV Syntax and Content Errors were added: ° ° ° ° ° ° 5204 ZMCS-ERR-TAPEVOLFORMATINVALID on page A-103 5205 ZMCS-ERR-TAPEVOLFORMATRESET on page A-103 5206 ZMCS-ERR-OUTCOMMAND
What’s New in This Manual • • • • • • ° ° ° ° ° ° New and Changed Information ZMCS-TKN-FCVERSION on page 4-8 ZMCS-TKN-INFILE on page 4-9 ZMCS-TKN-INFILE2 on page 4-9 ZMCS-TKN-OSSOBJECTNAME on page 4-11 ZMCS-TKN-OUTCOMMANDNAME on page 4-11 ZMCS-TKN-VCVERSION on page 4-17 One new ZMCS Maps was added: ° ZMCS-MAP-SQLMXOBJECTS on page 4-58 Eleven new Enumerated Type Values, Listed by Name were added to Table 4-4 on page 4-68. New command tokens were added to RECOVER DISKFILE Command on page 5-39.
What’s New in This Manual New and Changed Information DSM/Tape Catalog Management Programming Manual—520481-003 xx
About This Manual This manual contains information for programmers developing applications to manage a DSM/Tape Catalog (DSM/TC) system using the Subsystem Programmatic Interface (SPI): Section Description Section 1, Introduction to DSM/TC Summarizes both the DSM/TC system and the management functions that are controlled through SPI. Section 2, Communicating With MEDIASRV Describes how to start, open, and stop the DSM/TC server process, MEDIASRV.
Notation Conventions About This Manual Notation Conventions Hypertext Links Blue underline is used to indicate a hypertext link within text. By clicking a passage of text with a blue underline, you are taken to the location described. For example: This requirement is described under Backup DAM Volumes and Physical Disk Drives on page 3-2. General Syntax Notation This list summarizes the notation conventions for syntax presentation in this manual. UPPERCASE LETTERS.
General Syntax Notation About This Manual { } Braces. A group of items enclosed in braces is a list from which you are required to choose one item. The items in the list can be arranged either vertically, with aligned braces on each side of the list, or horizontally, enclosed in a pair of braces and separated by vertical lines. For example: LISTOPENS PROCESS { $appl-mgr-name } { $process-name } ALLOWSU { ON | OFF } | Vertical Line.
Notation for Messages About This Manual a blank line. This spacing distinguishes items in a continuation line from items in a vertical list of selections. For example: ALTER [ / OUT file-spec / ] LINE [ , attribute-spec ]… !i and !o. In procedure calls, the !i notation follows an input parameter (one that passes data to the called procedure); the !o notation follows an output parameter (one that returns data to the calling program).
Notation for Management Programming Interfaces About This Manual lowercase italic letters. Lowercase italic letters indicate variable items whose values are displayed or returned. For example: p-register process-name [ ] Brackets. Brackets enclose items that are sometimes, but not always, displayed.
Change Bar Notation About This Manual UPPERCASE LETTERS. Uppercase letters indicate names from definition files. Type 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. For example: token-type !r. The !r notation following a token or field name indicates that the token or field is required. For example: ZCOM-TKN-OBJNAME !o. token-type ZSPI-TYP-STRING.
1 Introduction to DSM/TC Distributed Systems Management/Tape Catalog (DSM/TC) is a software system that manages tape files and labeled magnetic tapes (open reel and cartridge) in a NonStop Kernel environment. The DSM/TC subsystem manages magnetic tapes and tape files by storing information about them in HP NonStop SQL/MP databases. The majority of information is entered and maintained automatically throughout the life of a tape file and tape.
Introduction to DSM/TC Programmatic Interface to DSM/TC Functions Programmatic Interface to DSM/TC Functions Management application control of the DSM/TC subsystem takes place by using Subsystem Programmatic Interface (SPI) procedures to communicate with the DSM/TC programmatic process, MEDIASRV. The application uses the SPI procedures to compose SPI command messages for the MEDIASRV process and to interpret the responses received from the MEDIASRV process.
2 Communicating With MEDIASRV To route commands to most subsystems, a management application must open a MEDIASRV server process. If no MEDIASRV process exists, the management application or an interactive user must start one. The management application opens the MEDIASRV process, specifying that messages be in SPI format. The management application and the MEDIASRV process then exchange SPI command and response messages using the operating-system WRITEREAD and READUPDATE procedures.
Communicating With MEDIASRV Starting a MEDIASRV Process Using the RUN Command Starting a MEDIASRV Process Using the RUN Command To start a MEDIASRV process from a command interpreter such as HP Tandem Advanced Command Language (TACL), issue a RUN command. Specify run options between the slashes and startup parameters following the run options. [RUN][$vol.][subvol.]MEDIASRV/NAME proc-name[run-option]...
Starting a MEDIASRV Process Using the RUN Command Communicating With MEDIASRV If the OUT option is missing, the command interpreter assigns a default logging file, usually the home terminal. If the OUT option is included but no value for filename is specified, logging is inhibited. If the OUT option is followed by a file name, logging output goes to that file. PRI priority specifies the execution priority of the process.
Communicating With MEDIASRV Starting a MEDIASRV Process Using the PROCESS_CREATE_ Procedure Starting a MEDIASRV Process Using the PROCESS_CREATE_ Procedure An application can create a MEDIASRV process by calling the operating system PROCESS_CREATE_ procedure. The sequence of events is: 1. The application starts the MEDIASRV process by calling the PROCESS_CREATE_ procedure. 2. The application uses the FILE_OPEN_ procedure to open the MEDIASRV process in order to send a startup message. 3.
Communicating With MEDIASRV Starting a MEDIASRV Process Using the PROCESS_CREATE_ Procedure swap-file:len is an optional string containing the name of the swap file for the MEDIASRV process data area. The length of the string follows the colon. ext-swap-file:len is an optional string containing the name of the swap file for the MEDIASRV process extended data segments. The length of the string follows the colon. priority specifies the priority of the process.
Communicating With MEDIASRV Starting a MEDIASRV Process Using the PROCESS_CREATE_ Procedure file-number contains a file number for use in subsequent references to the process, as in the FILE_OPEN_ and FILE_CLOSE_ procedure calls shown here. startup-message has the structure: [0] [1:8] [9:20] [21:32] [33:n] message-code (-1) subvol (blank) in (blank) out (blank) parameter [value] [;parameter [value]]… message-code contains -1. subvol is not used by MEDIASRV and should be blank.
Communicating With MEDIASRV Creating a High-PIN MEDIASRV Process BEGIN INT volume [0:3], subvol [0:3], filename [0:3]; END STRING param [0:n-1]; END; message-len is the length of the startup message. Creating a High-PIN MEDIASRV Process The MEDIASRV program distributed by HP has the HIGHPIN object-file attribute set to OFF so processes generated from it always run at a low PIN (a process identification number less than 255).
Communicating With MEDIASRV Opening a MEDIASRV Process FUP CREATE filename,TYPE E,REC 132, EXT (pri,sec) If you inhibit logging (by omitting the LOG parameter or its filename argument), emergency output—output that precedes the abnormal termination of the process—is sent to the home terminal. If the specified logging file cannot be accessed, the process does not start.
Communicating With MEDIASRV Sending Commands and Retrieving Responses Sending Commands and Retrieving Responses Management applications prepare SPI buffers by using the standard SPI procedures. After opening a MEDIASRV process for SPI-formatted messages, the applications use the WRITEREAD procedure to send the command buffers and retrieve the corresponding responses. For a description of this process, see the Distributed Systems Management (DSM) Manual.
Communicating With MEDIASRV Abnormal Process Termination DSM/Tape Catalog Management Programming Manual—520481-003 2- 10
3 SPI Programming Considerations The Subsystem Programmatic Interface (SPI) is used to build and decode commands and responses needed by the DSM/TC subsystem to communicate with management applications. The messages containing the commands and responses are transported by an application that communicates with the MEDIASRV process—not by SPI. Command numbers and object-type numbers, denoted in programs by names from HP’s definition files, are used to represent commands and object types.
Syntax Elements SPI Programming Considerations For a particular category of definitions (in this case, ZSPI or ZMCS), the languagespecific files are generated from one file containing definitions expressed in HP’s Data Definition Language. This file has a language code of DDL. Thus, the file ZMCSDDL is the source file for the definitions files ZMCSC, ZMCSCOB, ZMCSPAS, ZMCSTACL, and ZMCSTAL.
SPI Programming Considerations Object Types and Object Names Object Types and Object Names Objects within SPI are entities subject to independent reference and control by a subsystem. An object typically has a name (object name) and a type (object type). An object type is a category of objects to which a specific object belongs. The DSM/TC subsystem has its own set of object types. (They are 16-bit integers.
Tokens SPI Programming Considerations Token Types A token type is the combination of a token data type and token length. The token types used by the DSM/TC subsystem are represented by names having the form: subsys-TYP-name subsys is a 4-character abbreviation for a subsystem. For NonStop Kernel subsystems, the first character is always Z. name identifies a token type. Table 3-1.
SPI Programming Considerations Constructs Involving Multiple Tokens Extensible Structured Tokens An extensible structured token consists of a token map and a value that is an extensible structure. Extensible structured tokens let programs add a number of parameters or other items of information to a buffer in a single SPI call. They allow easy initialization of parameter values, and the subsystem can extend these structures in future releases to provide new features.
SPI Programming Considerations Components of a Command Buffer Components of a Command Buffer A command buffer consists of an SPI message header and zero or more tokens. These tokens in the command buffer can be parameter tokens, a maximum-response token, or a context token. SPI Message Header The header for a SPI command message indicates that the buffer is for a SPI command. The buffer header contains the command number and object-type number for the command.
SPI Programming Considerations The Command Buffer, Building Information Tokens The MEDIASRV process returns information tokens in some of the response buffers. For example, issuing an INFO MEDIADEFS command results in MEDIASRV returning the ZMCS-MAP-INFO-MEDIACATALOG token, which contains the requested information. Return Token The response buffer always contains the return token, ZSPI-TKN-RETCODE.
SPI Programming Considerations A Command in Progress, Discontinuing structured variable, then later you can add its contents to the buffer as the value of a structured token. A program can supply multiple occurrences of the same token in a command message for a MEDIASRV process. For example, a program can specify multiple ZMCS-TKNTAPEVOLUME tokens in an ALTER TAPEVOLUME command to name the files that will change status in the volume catalog or pool.
SPI Programming Considerations Error Handling An application determines that it has received the last of a series of response messages when it receives a message that does not contain a context token. There are no additional response records for retrieval if MEDIASRV does not return the ZSPI-TKN-CONTEXT token. The DSM/TC subsystem can return an empty response if an application returns a ZSPI-TKN-CONTEXT token to the MEDIASRV process and there are no more responses to be returned.
SPI Programming Considerations DSM/Tape Catalog Management Programming Manual—520481-003 3- 10 Security
4 Common Definitions This section describes data definitions relevant to the programmatic management of DSM/TC processes. Definition Category Token Page ZMCS Fundamental Data Structures ZMCS-DDL-... 4-1 ZMCS Token Types ZMCS-TYP-... 4-3 ZMCS Token Numbers ZMCS-TNM-... 4-4 ZMCS Tokens ZMCS-TKN-... 4-6 ZMCS Maps ZMCS-MAP-... 4-18 ZMCS Command Numbers ZMCS-CMD-... 4-66 ZSPI Error Numbers ZSPI-ERR-... 4-66 ZMCS Object Types ZMCS-OBJ-... 4-67 ZMCS Miscellaneous Values ZMCS-VAL-...
ZMCS Fundamental Data Structures Common Definitions ZMCS-DDL-SQLMXOBJECT DEFINITION ZMCS-DDL-SQLMXObject. 02 ZSQLMXType TYPE ZMCS-DDL-SQLMXType-ENM. 02 ZSQLMXLen TYPE ZSPI-DDL-Int SPI-NULL 255. 02 ZSQLMXName TYPE ZMCS-DDL-CHAR254. END. This definition defines a SQl/MX object which has SQL/MX object type (catalog, schema, table, tpart), size of SQL/MX object name and SQL/MX object name.
ZMCS Token Types Common Definitions ZMCS-DDL-MSG-MAXBUFFER def ZMCS-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 ZMCS-VAL-MAXBUFLEN times depending on Z-OCCURS end. ZMCS-DDL-MSG-MAXBUFFER defines the maximum buffer length. ZMCS-DDL-TAPELABEL def ZMCS-DDL-TAPELABEL type ZMCS-DDL-CHAR80 ZMCS-DDL-TAPELABEL defines an 80-character tape label.
ZMCS Token Numbers Common Definitions ZMCS Token Numbers Table 4-1 provides an alphabetical list of the symbolic names and the numeric values of the token numbers defined by ZMCS. Table 4-1.
ZMCS Token Numbers Common Definitions Table 4-1.
ZMCS Tokens Common Definitions Table 4-1.
ZMCS Tokens Common Definitions ZMCS-TKN-CATALOGSUBVOLUME token-code value token-type ssid heading ZMCS-TKN-CATALOGSUBVOLUME ZMCS-TNM-CATALOGSUBVOLUME ZSPI-TYP-STRING. ZMCS-VAL-EXT-SSID "CatalogSubvolume" This token appears in both command and response buffers of multiple commands. It identifies the physical location for the file catalog with a volume and subvolume name. ZMCS-TKN-COMMENT token-code value token-type ssid heading ZMCS-TKN-COMMENT ZMCS-TNM-COMMENT ZSPI-TYP-STRING.
ZMCS Tokens Common Definitions ZMCS-TKN-DISKFILENAME token-code value token-type ssid heading ZMCS-TKN-DISKFILENAME ZMCS-TNM-DISKFILENAME ZSPI-TYP-STRING. ZMCS-VAL-EXT-SSID "DiskFileName" This token appears in the command buffers of multiple commands and in responses to INFO DISKFILE commands. It specifies the name of the disk file written to tape by the BACKUP or BACKCOPY utilities. ZMCS-TKN-ERRORNUM token-code value token-type ssid heading ZMCS-TKN-ERRORNUM ZMCS-TNM-ERRORNUM ZSPI-TYP-INT.
ZMCS Tokens Common Definitions ZMCS-TKN-FILECATALOG token-code value token-type ssid heading ZMCS-TKN-FILECATALOG ZMCS-TNM-FILECATALOG ZSPI-TYP-STRING. ZMCS-VAL-EXT-SSID "FileCatalog" This token appears in both command buffers and response buffers of multiple commands. It specifies the logical name of the file catalog in which to create an entry. ZMCS-TKN-HOMETERMINAL token-code value token-type ssid heading ZMCS-TKN-HOMETERMINAL ZMCS-TNM-HOMETERMINAL ZSPI-TYP-STRING.
ZMCS Tokens Common Definitions ZMCS-TKN-LSMADDRESS token-code value token-type ssid heading ZMCS-TKN-LSMADDRESS ZMCS-TNM-LSMADDRESS ZMCS-TYP-INT-QUAD. ZMCS-VAL-EXT-SSID "LSMAddress" This token appears in the ALTER TAPEDRIVE response buffer. It contains the LSM tape drive address. ZMCS-TKN-LSMTAPEDRVPRESENT token-code value token-type ssid heading ZMCS-TKN-LSMTAPEDRVPRESENT ZMCS-TNM-LSMTAPEDRVPRESENT ZSPI-TYP-INT.
ZMCS Tokens Common Definitions ZMCS-TKN-NEWTAPEVOLUME token-code value token-type ssid heading ZMCS-TKN-NEWTAPEVOLUME ZMCS-TNM-NEWTAPEVOLUME ZSPI-TYP-STRING. ZMCS-VAL-EXT-SSID "NewTapeVolume" This token appears in the ADD TAPELABEL command buffer. It contains a new tape volume name, used to overwrite an existing label. ZMCS-TKN-OPERATORTERM token-code value token-type ssid heading ZMCS-TKN-OPERATORTERM ZMCS-TNM-OPERATORTERM ZSPI-TYP-STRING.
ZMCS Tokens Common Definitions ZMCS-TKN-OUTFILE token-code value token-type ssid heading ZMCS-TKN-OUTFILE ZMCS-TNM-OUTFILE ZSPI-TYP-STRING. ZMCS-VAL-EXT-SSID "OutFile" This token appears in the command buffer of multiple commands and the response buffer of the INFO CONSOLE command. It contains the name of the tape console. ZMCS-TKN-POOLNAME token-code value token-type ssid heading ZMCS-TKN-POOLNAME ZMCS-TNM-POOLNAME ZSPI-TYP-STRING.
ZMCS Tokens Common Definitions ZMCS-TKN-READLEN token-code value token-type ssid heading ZMCS-TKN-READLEN ZMCS-TNM-READLEN ZSPI-TYP-INT. ZMCS-VAL-EXT-SSID "ReadLen" This token is part of the response in message 6201, which indicates that a buffer sent to MEDIASRV was too long. It contains the allowable byte length of the buffer. See also ZMCS-TKN-USEDLEN on page 4-17. ZMCS-TKN-RESTOREOPTIONS token-code value token-type ssid heading ZMCS-TKN-RESTOREOPTIONS ZMCS-TNM-RESTOREOPTIONS ZSPI-TYP-STRING.
ZMCS Tokens Common Definitions ZMCS-TKN-SERVERVERSION token-code value token-type ssid heading ZMCS-TKN-SERVERVERSION ZMCS-TNM-SERVERVERSION ZSPI-TYP-UINT. ZMCS-VAL-EXT-SSID "ServerVersion" This token appears as part of the response to error 6203, which indicates MEDIASRV version incompatibility. It contains the version number of the server that is currently executing. See also ZMCS-TKN-MAXFIELDVERSION on page 4-10.
ZMCS Tokens Common Definitions ZMCS-TKN-SYSTEM token-code value token-type ssid heading ZMCS-TKN-SYSTEM ZMCS-TNM-SYSTEM ZSPI-TYP-STRING. ZMCS-VAL-EXT-SSID "System" This token appears in the command buffer of multiple commands and in the STATUS SERVER response buffer. It contains the name of the node to which the command changes apply. ZMCS-TKN-SYSTEMNUM token-code value token-type ssid heading ZMCS-TKN-SYSTEMNUM ZMCS-TNM-SYSTEMNUM ZSPI-TYP-INT2.
ZMCS Tokens Common Definitions ZMCS-TKN-TAPEVOLUME token-code value token-type ssid heading ZMCS-TKN-TAPEVOLUME ZMCS-TNM-TAPEVOLUME ZSPI-TYP-STRING. ZMCS-VAL-EXT-SSID "TapeVolume" This token appears in both command and response buffers of multiple commands. It contains the name of the tape as written in the tape label when using a tape with an existing label, the name that goes in the tape label when creating a labeled tape from an unlabeled tape.
ZMCS Tokens Common Definitions ZMCS-TKN-UNKNOWNTOKENCODE token-code value token-type ssid heading ZMCS-TKN-UNKNOWNTOKENCODE ZMCS-TNM-UNKNOWNTOKENCODE ZSPI-TYP-TOKENCODE. ZMCS-VAL-EXT-SSID "UnknownTokenCode" This token is part of a response to error 6204, which indicates that a token code was received that was unknown to MEDIASRV. The value for this token is itself a token code. ZMCS-TKN-USEDLEN token-code value token-type ssid heading ZMCS-TKN-USEDLEN ZMCS-TNM-USEDLEN ZSPI-TYP-INT.
ZMCS Maps Common Definitions ZMCS-TKN-VERSIONSTRING token-code value token-type ssid heading ZMCS-TKN-VERSIONSTRING ZMCS-TNM-VERSIONSTRING ZSPI-TYP-STRING. ZMCS-VAL-EXT-SSID "VersionString" This token appears in the STATUS SERVER response buffer. It contains the server product number, version number, and release date. ZMCS-TKN-VOLUMECATALOG token-code value token-type ssid heading ZMCS-TKN-VOLUMECATALOG ZMCS-TNM-VOLUMECATALOG ZSPI-TYP-STRING.
ZMCS Maps Common Definitions ZMCS-MAP-ADD-POOL MEDIASRV includes this extensible structured token in ADD POOL commands to describe the characteristics of tapes allowed in the pool. ZMCS-MAP-ADD-POOL is based on ZMCS-DDL-ADD-POOL, which is defined as: def ZMCS-DDL-ADD-POOL. 02 ZLABELTYPE 02 ZDENSITY 02 ZMEDIATYPE 02 ZAUTOSCRATCH 02 ZSEARCHSPACE 02 ZAPPEND end. type type type type type type ZMCS-DDL-LABELTYPE-ENM. ZMCS-DDL-DENSITY-ENM. ZMCS-DDL-MEDIATYPE-ENM. ZMCS-DDL-AUTOSCRATCH-ENM.
ZMCS Maps Common Definitions ZMEDIATYPE corresponds to the TYPE parameter of the MEDIACOM ADD POOL command. ZMEDIATYPE denotes the tape’s physical type. Valid values are: ZMCS-VAL-MEDIATYPE-UNSPECIFIED The tape type is unspecified. ZMCS-VAL-MEDIATYPE-OPEN The tape type is open reel. ZMCS-VAL-MEDIATYPE-NAPA The tape type is NAPA. ZMCS-VAL-MEDIATYPE-5180 The tape type is 5180 cartridge. ZMCS-VAL-MEDIATYPE-PYTHON The tape type is PYTHON. ZMCS-VAL-MEDIATYPE-3480 The tape type is 3480 cartridge.
ZMCS Maps Common Definitions ZAPPEND corresponds to the APPEND parameter of the MEDIACOM ADD POOL command. ON indicates that tape volumes known to the pool, of LABELS BACKUP, may contain multiple tape files. OFF (default) stipulates that tape volumes known to the pool can only contain a single tape file and the unspecified means the pool APPEND parameter is unspecified.
ZMCS Maps Common Definitions ZUNLOAD corresponds to the UNLOAD parameter of the MEDIACOM ADD TAPEFILE command. ZUNLOAD (ON or OFF) denotes what happens to the tape after this command is finished. ON (default) means the tape is unloaded. OFF means the tape stays loaded and online. ZPROMPT corresponds to the PROMPT parameter of the MEDIACOM ADD TAPEFILE command. ZPROMPT denotes when the tape drive begins checking (polling) that a tape is mounted.
ZMCS Maps Common Definitions ZMCS-MAP-ADD-TAPELABEL MEDIASRV includes this extensible structured token in ADD TAPELABEL commands to create or modify tape labels. ZMCS-MAP-ADD-TAPELABEL is based on ZMCS-DDLADD-TAPELABEL, which is defined as: def ZMCS-DDL-ADD-TAPELABEL. 02 ZOVERRIDE type 02 ZLABELTYPE type 02 ZDENSITY type 02 ZUNLOAD type 02 ZPROMPT type 02 ZSCRATCH type end. ZSPI-DDL-BOOLEAN. ZMCS-DDL-LABELTYPE-ENM. ZMCS-DDL-DENSITY-ENM. ZSPI-DDL-BOOLEAN. ZSPI-DDL-BOOLEAN. ZSPI-DDL-BOOLEAN.
ZMCS Maps Common Definitions ZDENSITY corresponds to the DENSITY parameter of the MEDIACOM ADD TAPELABEL command. ZDENSITY denotes the tape density. Valid values are: ZMCS-VAL-DENSITY-UNSPECIFIED The tape density is unspecified. ZMCS-VAL-DENSITY-800 The tape density is 800 BPI. ZMCS-VAL-DENSITY-1600 The tape density is 1600 BPI (default). ZMCS-VAL-DENSITY-6250 The tape density is 6250 BPI. ZMCS-VAL-DENSITY-ANY Any density is allowed. ZMCS-VAL-DENSITY-NONE No density is specified.
ZMCS Maps Common Definitions ZMCS-MAP-ADD-TAPEVOLUME MEDIASRV includes this extensible structured token in ADD TAPEVOLUME commands to describe the characteristics of tapes manually cataloged in a pool and volume catalog. The characteristics of the tapes must satisfy the pool’s attributes, and the tape name must not duplicate a name in the system search space. ZMCS-MAPADD-TAPEVOLUME is based on ZMCS-DDL-ADD-TAPEVOLUME, which is defined as: def ZMCS-DDL-ADD-TAPEVOLUME.
ZMCS Maps Common Definitions ZMCS-VAL-LABELTYPE-ANY All label types are permitted (default). ZMCS-VAL-LABELTYPE-BACKUP The tape label type indicates a BACKUP or BACKCOPY tape. ZMCS-VAL-LABELTYPE-TMF The tape label type is TMF. ZMCS-VAL-LABELTYPE-UNKNOWN The tape label type is unknown. ZMEDIATYPE corresponds to the TYPE parameter of the MEDIACOM ADD TAPEVOLUME command. ZMEDIATYPE denotes the tape’s physical type. Valid values are: ZMCS-VAL-MEDIATYPE-UNSPECIFIED The tape type is unspecified.
ZMCS Maps Common Definitions • • ON indicates that the label information is written or changed without checking for an existing tape label and without checking the available system search space for a duplicate name. OFF indicates that the label information is written after the label check completes and if no duplicate tape is in the available system search space.
ZMCS Maps Common Definitions ZLOGICALCOPY corresponds to the LOGICAL parameter of the MEDIACOM ALTER DISKFILE command. ZLOGICALCOPY refers to which copy of a tape set created from either a parallel BACKUP or a parallel BACKCOPY run to change. A number 1 or 2 denotes a change to the disk file entry for logical copy 1 or logical copy 2. The default is 1. A status of ALL denotes a change to the disk file entry for both logical copy 1 and logical copy 2.
ZMCS Maps Common Definitions ZMCS-VAL-SUPPLEVEL-UNSPECIFIED The level of tape support is unspecified. ZMCS-VAL-SUPPLEVEL-UNLABELED Only unlabeled tape processing is permitted. ZMCS-VAL-SUPPLEVEL-NOCATALOG Labeled and unlabeled tape processing is permitted. Only TAPE DEFINEs and TAPECATALOG DEFINEs with the CATALOG attribute set of OFF are allowed. ZMCS-VAL-SUPPLEVEL-COMPATIBLE Labeled and unlabeled tape processing is permitted.
ZMCS Maps Common Definitions A status of PERMANENT means to keep the entry until it is erased with a DELETE TAPEFILE command. A permanent entry can be subsequently given a retention period with an ALTER TAPEFILE command. ZRESETTIME corresponds to the RESET EXPIRATION parameter of the MEDIACOM ALTER MEDIADEFS command.
ZMCS Maps Common Definitions ZMCS-MAP-ALTER-POOL MEDIASRV includes this extensible structured token in ALTER POOL commands to describe changes made to attributes of an existing pool. ZMCS-MAP-ALTER-POOL is based on ZMCS-DDL-ALTER-POOL, which is defined as: def ZMCS-DDL-ALTER-POOL. 02 ZLABELTYPE 02 ZDENSITY 02 ZMEDIATYPE 02 ZAUTOSCRATCH 02 ZAPPEND end. type type type type type ZMCS-DDL-LABELTYPE-ENM. ZMCS-DDL-DENSITY-ENM. ZMCS-DDL-MEDIATYPE-ENM. ZMCS-DDL-AUTOSCRATCH-ENM. ZMCS-DDL-APPEND-ENM.
ZMCS Maps Common Definitions ZMEDIATYPE corresponds to the TYPE parameter of the MEDIACOM ALTER POOL command. ZMEDIATYPE denotes which kind of physical tape is allowed in the pool. Valid values are: ZMCS-VAL-MEDIATYPE-UNSPECIFIED The tape type is unspecified. ZMCS-VAL-MEDIATYPE-OPEN The tape type is open reel. ZMCS-VAL-MEDIATYPE-NAPA The tape type is NAPA. ZMCS-VAL-MEDIATYPE-5180 The tape type is 5180 cartridge. ZMCS-VAL-MEDIATYPE-PYTHON The tape type is PYTHON.
ZMCS Maps Common Definitions ZMCS-MAP-ALTER-TAPEDRIVE MEDIASRV includes this extensible structured token in ALTER TAPEDRIVE commands to describe the status of whether approval must be given for an application to use a tape drive for bypass label processing mode or no label processing mode. ZMCS-MAP-ALTER-TAPEDRIVE is based on ZMCS-DDL-ALTER-TAPEDRIVE, which is defined as: def ZMCS-DDL-ALTER-TAPEDRIVE.
ZMCS Maps Common Definitions ZLSMID corresponds to part of the drive address specified in the LSM parameter of the MEDIACOM ALTER TAPEDRIVE command. The value for ZLSMID is a number in the range 0 through 15 that identifies one LSM of the ACS. ZPANELID corresponds to part of the drive address specified in the LSM parameter of the MEDIACOM ALTER TAPEDRIVE command. The value for ZPANELID is a number in the range 0 through 19 that identifies which panel of the LSM contains the tape drive.
ZMCS Maps Common Definitions ZVERSION corresponds to the VERSION parameter of the MEDIACOM ALTER TAPEFILE command. With a number in the range 0 through 100, ZVERSION denotes which version of a generation to change from valid to invalid. ZPHYSICALCOPY corresponds to the PHYSICAL parameter of the MEDIACOM ALTER TAPEFILE command. ZPHYSICALCOPY refers to the sequential order in which backup tape sets were created by BACKUP and BACKCOPY.
ZMCS Maps Common Definitions ZMCS-VAL-STATUS-UNSPECIFIED The status of the tape file entry is unspecified. ZMCS-VAL-STATUS-VALID The status of the tape file entry is valid. ZMCS-VAL-STATUS-INVALID The status of the tape file entry is invalid. ZMCS-MAP-ALTER-TAPEMOUNT MEDIASRV includes this extensible structured token in ALTER TAPEMOUNT commands to determine the proper tape (alternate copy) to mount if a requested tape is not available when the mount message is issued.
ZMCS Maps Common Definitions ZMCS-MAP-ALTER-TAPEVOLUME MEDIASRV includes this extensible structured token in ALTER TAPEVOLUME commands to describe changes in the status of a tape in the volume catalog and its pool. ZMCS-MAP-ALTER-TAPEVOLUME is based on ZMCS-DDL-ALTER-TAPEVOLUME, which is defined as: def ZMCS-DDL-ALTER-TAPEVOLUME. 02 ZSTATUS type ZMCS-DDL-TAPEVOLSTATUS-ENM. 02 ZOVERRIDE type ZSPI-DDL-BOOLEAN. 02 ZBKUPFMT type ZMCS-DDL-BKUPFMT-ENM. end.
ZMCS Maps Common Definitions ZBKUPFMT denotes the type of tape format. Valid values are: ZMCS-ENM-BKUPFMT-ALL The backup status is All. ZMCS-ENM-BKUPFMT-BACKUP The backup status is Backup. ZMCS-ENM-BKUPFMT-ARCHIVE The backup status is Archive. ZMCS-ENM-BKUPFMT-LONGNAME The backup status is Longname. ZMCS-ENM-BKUPFMT-NONBACKUP There is no backup.
ZMCS Maps Common Definitions ZPHYSICALCOPY corresponds to the PHYSICAL parameter of the MEDIACOM DELETE TAPEFILE command. ZPHYSICALCOPY refers to the sequential order in which backup tape sets were created by BACKUP and BACKCOPY. A number from 1 through 99 denotes a physical copy number of a disk file entry to change. A status of ALL denotes a change to a disk file entry for all physical copies. ZLOGICALCOPY corresponds to the LOGICAL parameter of the MEDIACOM DELETE TAPEFILE command.
ZMCS Maps Common Definitions • • ON denotes that the label is removed even if unexpired files are on the tape. The label is removed without checking the available system search space for a matching name. OFF denotes that the label is removed only if the specified file on the tape is expired (default). ZUNLOAD corresponds to the UNLOAD parameter of the MEDIACOM DELETE TAPELABEL command. ZUNLOAD (ON or OFF) denotes what happens to the tape after this command is finished.
ZMCS Maps Common Definitions ZMCS-MAP-INFO-DISKFILE MEDIASRV includes this extensible structured token in INFO DISKFILE commands to describe information retrieved from disk file entries. Disk file entries are created when the CATALOGFILES option of BACKUP or BACKCOPY is selected, and are used mainly for recovery. ZMCS-MAP-INFO-DISKFILE is based on ZMCS-DDL-INFODISKFILE, which is defined as: def ZMCS-DDL-INFO-DISKFILE.
ZMCS Maps Common Definitions A negative number in the range -1 through -32768 denotes a relative value. The default is -1, which represents the most recent generation. ALL denotes that all generations are used in the report. ZGENISPRESENT contains a status of either TRUE or FALSE. ZGENISPRESENT must contain a TRUE status whenever an absolute value is present for ZGENERATION. ZTIMEDUMPED corresponds to the TIME parameter of the MEDIACOM INFO DISKFILE command.
ZMCS Maps Common Definitions ZEOF denotes the number of bytes of the disk file. ZLASTMODTIME denotes the date and time that the disk file was changed before it was written to the backup tape. ZOPEN denotes whether the disk file was open when it was backed up: • • FALSE means the disk file was not open. TRUE means the disk file was open. ZBROKEN denotes whether the disk file was broken when it was backed up: • • FALSE means the disk file was not broken. TRUE means the disk file was broken.
ZMCS Maps Common Definitions ZVOLINDEX applies if the disk file spans more than one tape. ZVOLINDEX denotes the sequence number of the tape name within the tape set used (1 for the first tape used, 2 for the second tape used, and so on). ZMCS-MAP-INFO-MEDIACATALOG MEDIASRV includes this extensible structured token in INFO MEDIADEFS commands to describe information retrieved about the DSM/TC environment on one node.
ZMCS Maps Common Definitions ZABENDRETENTION denotes the number of days past the creation date to keep a catalog entry for an incomplete tape file. A number in the range 0 through 9999 is valid for this field. ZSUSPICIOUSTIME due to a warning message received, ZSUSPICOUSTIME denotes that the system clock might need correcting: • • TRUE means that the clock needs correcting. FALSE means that the clock does not need correcting.
ZMCS Maps Common Definitions ZMCS-MAP-INFO-POOL MEDIASRV includes this extensible structured token in INFO POOL commands to describe attributes of a pool. ZMCS-MAP-INFO-POOL is based on ZMCS-DDL-INFOPOOL, which is defined as: def ZMCS-DDL-INFO-POOL. 02 ZLABELTYPE 02 ZDENSITY 02 ZMEDIATYPE 02 ZAUTOSCRATCH 02 ZSEARCHSPACE 02 ZAPPEND end. type type type type type type ZMCS-DDL-LABELTYPE-ENM. ZMCS-DDL-DENSITY-ENM. ZMCS-DDL-MEDIATYPE-ENM. ZMCS-DDL-AUTOSCRATCH-ENM. ZMCS-DDL-SEARCHSPACE-ENM.
ZMCS Maps Common Definitions ZMEDIATYPE denotes which kind of physical tape is allowed in the pool. Valid values are: ZMCS-VAL-MEDIATYPE-UNSPECIFIED The tape type is unspecified. ZMCS-VAL-MEDIATYPE-OPEN The tape type is open reel. ZMCS-VAL-MEDIATYPE-NAPA The tape type is NAPA. ZMCS-VAL-MEDIATYPE-5180 The tape type is 5180 cartridge. ZMCS-VAL-MEDIATYPE-PYTHON The tape type is PYTHON. ZMCS-VAL-MEDIATYPE-3480 The tape type is 3480 cartridge. ZMCS-VAL-MEDIATYPE-ANY Any tape type is allowed.
ZMCS Maps Common Definitions ZMCS-MAP-INFO-TAPEDRIVE MEDIASRV includes this extensible structured token in INFO TAPEDRIVE commands to describe the current setting of a tape drive regarding the BLPCHECK and NLCHECK options. ZMCS-MAP-INFO-TAPEDRIVE is based on ZMCS-DDL-INFOTAPEDRIVE, which is defined as: def ZMCS-DDL-INFO-TAPEDRIVE. 02 ZNOLABELCHECK type 02 ZBYPASSLABELCHECK type 02 ZACSID type 02 ZLSMID type 02 ZPANELID type 02 ZDRIVEID type end. ZSPI-DDL-BOOLEAN. ZSPI-DDL-BOOLEAN. ZSPI-DDL-INT.
ZMCS Maps Common Definitions ZDRIVEID denotes a number in the range 0 through 3 that identifies the tape drive in the panel. ZMCS-MAP-INFO-TAPEFILE MEDIASRV includes this extensible structured token in INFO TAPEFILE commands to describe attributes of a valid tape file entry. ZMCS-MAP-INFO-TAPEFILE is based on ZMCS-DDL-INFO-TAPEFILE, which is defined as: def ZMCS-DDL-INFO-TAPEFILE.
ZMCS Maps Common Definitions ZTAPEFILEMODE corresponds to the MODE parameter of the MEDIACOM INFO TAPEFILE command. ZTAPEFILEMODE denotes what type of file entry is used in the report. Valid values are: ZMCS-VAL-TAPEFILEMODE-UNSPECIF Type of file entry is unspecified. ZMCS-VAL-TAPEFILEMODE-ANY Use all entry types. ZMCS-VAL-TAPEFILEMODE-USER Use entries only for tape files created by a process other than BACKUP. ZMCS-VAL-TAPEFILEMODE-BFM Use entries only for backup tapes created in file-mode.
ZMCS Maps Common Definitions ZPHYSICALCOPY denotes the physical copy number of the tape file. ZLOGICALCOPY denotes the logical copy number of the tape file. ZFILESEQUENCE denotes the sequence number of the tape file within the tape set when the tape set contains more than one file (1 for the first file on the tape set, 2 for the second file, and so on). ZFILESECTION denotes the number of the section of the tape file on the tape (1 for the first or only section, 2 for the second section, and so on).
ZMCS Maps Common Definitions ZMCS-MAP-INFO-TAPELABEL MEDIASRV includes this extensible structured token in INFO TAPELABEL commands to describe the type of information on a tape label. ZMCS-MAP-INFO-TAPELABEL is based on ZMCS-DDL-INFO-TAPELABEL, which is defined as: def ZMCS-DDL-INFO-TAPELABEL. 02 ZUNLOAD type 02 ZPROMPT type 02 ZLABELTYPE type 02 ZSEQUENCENUMBER type 02 ZLABELDATA type end. ZSPI-DDL-BOOLEAN. ZSPI-DDL-BOOLEAN. ZMCS-DDL-LABELTYPE-ENM. ZSPI-DDL-INT. ZMCS-DDL-TAPELABEL.
ZMCS Maps Common Definitions ZMCS-VAL-LABELTYPE-UNLABELED The tape is unlabeled. ZMCS-VAL-LABELTYPE-BLP The tape label type is BLP. ZMCS-VAL-LABELTYPE-ANY All label types are permitted. ZMCS-VAL-LABELTYPE-BACKUP The tape label type indicates a BACKUP or BACKCOPY tape. ZMCS-VAL-LABELTYPE-TMF The tape label type is TMF. ZMCS-VAL-LABELTYPE-UNKNOWN The tape label type is unknown.
ZMCS Maps Common Definitions ZMCS-VAL-TAPEVOLSTAT-SCRATCH Display scratch tapes. ZMCS-VAL-TAPEVOLSTAT-SELECTED Display tapes requested for tape mounts. ZMCS-VAL-TAPEVOLSTAT-INUSE Display tapes currently mounted on tape drives. ZMCS-VAL-TAPEVOLSTAT-ANY Display tapes of any status (default). ZLABELTYPE denotes a type of tape label in the display. Valid values are: ZMCS-VAL-LABELTYPE-ANSI The tape label type is ANSI. ZMCS-VAL-LABELTYPE-IBM The tape label type is IBM-MVS.
ZMCS Maps Common Definitions ZBKUPFMT denotes the status of the backup. Valid values are: ZMCS-ENM-BKUPFMT-ALL The backup status is All. ZMCS-ENM-BKUPFMT-BACKUP The backup status is Backup. ZMCS-ENM-BKUPFMT-ARCHIVE The backup status is Archive. ZMCS-ENM-BKUPFMT-LONGNAME The backup status is Longname. ZMCS-ENM-BKUPFMT-NONBACKUP There is no backup. ZMCS-MAP-LABEL-TAPEVOLUME MEDIASRV includes this extensible structured token in LABEL TAPEVOLUME commands to describe tape label attributes.
ZMCS Maps Common Definitions number in the range 1 through 100. For more information, see the DSM/Tape Catalog Operator Interface (MEDIACOM) Manual. ZUNLOAD corresponds to the UNLOAD parameter of the MEDIACOM LABEL TAPEVOLUME command. ZUNLOAD (ON or OFF) denotes what happens to the tape after this command is finished. • • ON (default) means the tape is unloaded. OFF means the tape stays loaded and online. ZPROMPT corresponds to the PROMPT parameter of the MEDIACOM LABEL TAPEVOLUME command.
ZMCS Maps Common Definitions ZMCS-MAP-RECOVER-DISKFILE MEDIASRV includes this extensible structured token in RECOVER DISKFILE commands to describe parameters used when copying one or more disk files from one backup tape set to disk. ZMCS-MAP-RECOVER-DISKFILE is based on ZMCS-DDLRECOVER-DISKFILE, which is defined as: def ZMCS-DDL-RECOVER-DISKFILE. 02 ZGENERATION type 02 ZGENISPRESENT type 02 ZTIMEDUMPED type 02 ZOVERRIDE type end. ZMCS-DDL-GENERATION. ZSPI-DDL-BOOLEAN. ZSPI-DDL-BOOLEAN. ZSPI-DDL-BOOLEAN.
ZMCS Maps Common Definitions • OFF means approval is necessary. After RECOVER DISKFILE determines which backup tape or tapes to use, it displays the catalog information for you to approve before executing a RESTORE run command to copy the disk file or files from tape to disk. ZMCS-MAP-SQLMXOBJECTS MEDIASRV includes this extensible structured token in the RECOVER DISKFILE command to describe the SQL/MX object type, the length of object name, and SQL/MX object name information.
ZMCS Maps Common Definitions MAP-STATUS-MEDIASRV is based on ZMCS-DDL-STATUS-MEDIASRV, which is defined as: def ZMCS-DDL-STATUS-MEDIASRV. 02 ZDATETIME type 02 ZSYSTEMNUMBER type 02 ZPROCESSCPU type 02 ZPROCESSPIN type 02 ZCREATORUSERID type 02 ZCREATORUSERNAME type 02 ZPROCESSUSERID type 02 ZPROCESSUSERNAME type 02 ZPRIORITY type end. ZSPI-DDL-TIMESTAMP. ZSPI-DDL-INT2. ZSPI-DDL-INT. ZSPI-DDL-INT. ZSPI-DDL-USERID. ZSPI-DDL-USERNAME. ZSPI-DDL-USERID. ZSPI-DDL-USERNAME. ZSPI-DDL-INT.
ZMCS Maps Common Definitions ZMCS-MAP-STATUS-TAPEDRIVE MEDIASRV includes this extensible structured token in STATUS TAPEDRIVE commands to describe information pertaining to the current status of a tape drive. ZMCS-MAP-STATUS-TAPEDRIVE is based on ZMCS-DDL-STATUS-TAPEDRIVE, which is defined as: def ZMCS-DDL-STATUS-TAPEDRIVE.
ZMCS Maps Common Definitions ZTAPEVOLUMESTATUS denotes the status of the tape in the catalog. Valid values are: ZMCS-VAL-TAPEVOLSTAT-ASSIGNED The tape contains an unexpired file. ZMCS-VAL-TAPEVOLSTAT-BAD The tape is defective and should not be used. ZMCS-VAL-TAPEVOLSTAT-RELEASED All files on the tape are expired, but the tape cannot be used as a scratch tape. ZMCS-VAL-TAPEVOLSTAT-SCRATCH All files on the tape are expired, and the tape can be used as a scratch tape.
ZMCS Maps Common Definitions ZMCS-VAL-TAPEUSE-OUT Write data to tape. ZMCS-VAL-TAPEUSE-INOUT Read data from tape or write data to tape. ZMCS-VAL-TAPEUSE-EXTEND Add data to the last file on the tape. ZOPENEXCLUSION denotes the tape exclusion mode (taken from the OPEN flag of the opening process.
ZMCS Maps Common Definitions ZMCS-VAL-DEFINECLASS-TAPE CLASS TAPE DEFINE is used for this tape file. ZMCS-VAL-DEFINECLASS-TAPECAT CLASS TAPECATALOG DEFINE is used for this tape file. ZMCS-VAL-DEFINECLASS-NONE No DEFINE is used for this tape file. ZMCS-MAP-STATUS-TAPEMOUNT MEDIASRV includes this extensible structured token in STATUS TAPEMOUNT commands to describe information regarding outstanding tape mount requests on a node.
ZMCS Maps Common Definitions ZMCS-VAL-LABELTYPE-ANSI The label type is ANSI standard. ZMCS-VAL-LABELTYPE-IBM The label type is IBM-MVS standard. ZMCS-VAL-LABELTYPE-BACKUP The label type is BACKUP. ZMCS-VAL-LABELTYPE-TMF The label type is TMF. ZTAPEUSE denotes the tape’s input or output status. Valid values are: ZMCS-VAL-TAPEUSE-IN Read data from the tape. ZMCS-VAL-TAPEUSE-OUT Write data to tape. ZMCS-VAL-TAPEUSE-EXTEND Add data to the last file on the tape.
ZMCS Maps Common Definitions ZDENSITY corresponds to the DENSITY parameter of the MEDIACOM ADD TAPELABEL command. ZDENSITY denotes the tape density. Valid values are: ZMCS-VAL-DENSITY-UNSPECIFIED The tape density is unspecified. ZMCS-VAL-DENSITY-800 The tape density is 800 BPI. ZMCS-VAL-DENSITY-1600 The tape density is 1600 BPI (default). ZMCS-VAL-DENSITY-6250 The tape density is 6250 BPI. ZMCS-VAL-DENSITY-ANY Any density is allowed. ZMCS-VAL-DENSITY-NONE No density is specified.
ZMCS Command Numbers Common Definitions ZMCS Command Numbers Table 4-2 lists programmatic interface command definitions unique to DSM/TC. Table 4-2.
ZMCS Object Types Common Definitions ZMCS Object Types Table 4-3 lists programmatic interface object definitions unique to DSM/TC. Table 4-3.
Product Version Common Definitions Product Version ZMCS-VAL-VERSION defines the version of DSM/TC being used. ZMCS-VAL-VERSION constant 02 Z-FILLER 02 Z-OWNER 02 Z-NUMBER 02 Z-VERSION ZMCS-VAL-VERSIONvalue is VERSION "D10" type CHARACTER 8value is ZSPI-VAL-TANDEM type ZSPI-DDL-CHAR8redefines Z-FILLER type ZSPI-DDL-INTvalue is ZSPI-SSN-ZMCS type ZSPI-DDL-UINTvalue is ZMCS-VAL-VERSION Enumerated Type Values Enumerated type values.
Enumerated Type Values Common Definitions Table 4-4.
Enumerated Type Values Common Definitions Table 4-4.
Enumerated Type Values Common Definitions Table 4-4.
Buffer Length Values Common Definitions Buffer Length Values Table 4-5 lists buffer length values defined for the programmatic interface to DSM/TC. Table 4-5. Buffer Length Definitions CONSTANT VALUE ZMCS-VAL-MINBUFLEN 256 ZMCS-VAL-MINBUFLEN-W 128 ZMCS-VAL-BUFLEN 2048 ZMCS-VAL-BUFLEN-W 1024 ZMCS-VAL-MAXBUFLEN 8192 ZMCS-VAL-MAXBUFLEN-W 4096 Null, Reset, and Wild-Card Values The RESET option is supported by various ALTER commands.
5 Commands and Responses This section describes the MCS commands supported by the programmatic interface (MEDIASRV) to the DSM/TC user interface, MEDIACOM: Topic Page Common Command Tokens 5-2 Common Response Tokens 5-4 Commands and Responses 5-5 Table 5-1.
Common Command Tokens Commands and Responses Common Command Tokens These command-message tokens are common to most or all commands and are defined here only. Applicable tokens are listed with the commands but not defined again.
Commands and Responses Common Command Tokens ZMCS-TKN-POOLNAME specifies the name of a new pool. It cannot duplicate a pool name already in this volume catalog, but it can duplicate a pool name in another volume catalog. ZMCS-TKN-SECURITY specifies the new security level for the volume catalog. Specify the security level as a character string representing the operating system security levels for read, write, execute, and purge access. Enclose the string in quotation marks.
Common Response Tokens Commands and Responses Common Response Tokens These response tokens are common to most or all commands and are defined here only. Applicable tokens are listed with the commands but not defined again.
Commands and Responses Commands and Responses ZMCS-TKN-SECURITY contains the security level for the volume catalog as a character string representing the operating system security levels for read, write, execute, and purge access. ZMCS-TKN-TAPEDRIVE contains the tape drive name. ZMCS-TKN-TAPEFILEID contains the name of the tape file cataloged. If no name was specified, the file name in the tape’s label is found in this token.
ADD POOL Command Commands and Responses ADD POOL Command ZMCS-CMD-ADD (super-group only) ADD POOL creates a new pool in a volume catalog. Command ZMCS-CMD-ADD Object Type ZMCS-OBJ-POOL ADD POOL Command Tokens ZMCS-TKN-POOLNAME ZMCS-TKN-VOLUMECATALOG token-type ZSPI-TYP-STRING token-type ZSPI-TYP-STRING ZMCS-MAP-ADD-POOL ZMCS-MAP-ADD-POOL contains fields that correspond to the MEDIACOM ADD POOL command. For descriptions of these fields, see ZMCS Maps on page 4-18.
ADD TAPEFILE Command Commands and Responses ADD TAPEFILE Command ZMCS-CMD-ADD (super-group only) ADD TAPEFILE manually catalogs a tape file from a tape created by BACKUP, BACKCOPY, or other processes. The tape must belong to a pool and volume catalog before you execute ADD TAPEFILE. If it does not, add it to a pool with ADD TAPEVOLUME, specifying the tape’s status as SCRATCH. ADD TAPEFILE changes the tape’s status to assigned in the volume catalog as it catalogs the tape file in the file catalog.
ADD TAPELABEL Command Commands and Responses ADD TAPELABEL Command ZMCS-CMD-ADD (super-group only) ADD TAPELABEL performs these operations on a tape: • • • • • Creates a standard ANSI tape label Creates a standard IBM-MVS tape label Creates a tape label used by BACKUP and BACKCOPY Overwrites an existing label with new values (referred to as relabeling a tape) Changes an unexpired labeled tape’s status to SCRATCH Command ZMCS-CMD-ADD Object Type ZMCS-OBJ-TAPELABEL ADD TAPELABEL Command Tokens ZMCS-TKN-NE
ADD TAPEVOLUME Command Commands and Responses ZMCS-MAP-ADD-TAPELABEL contains fields that correspond to the MEDIACOM ADD TAPELABEL command. For descriptions of these fields, see ZMCS Maps on page 4-18.
ALTER CONSOLE Command Commands and Responses ALTER CONSOLE Command ZMCS-CMD-ALTER (super-group only) Messages from $ZSVR are displayed at the device designated as the tape console. Only one device at a time, usually a terminal, can be the tape console for a node. Use ALTER CONSOLE to designate a console when there is none or to change the current console to a different device. The console device remains in effect until another ALTER CONSOLE changes it, whether in the current session or a subsequent one.
ALTER FILECAT Command Commands and Responses status back to valid with a subsequent ALTER DISKFILE command as long as its tape file entry is still in the catalog.
ALTER MEDIADB Command Commands and Responses ALTER MEDIADB Command ZMCS-CMD-ALTER (super-group only) ALTER MEDIADB modifies volume and file catalog tables to contain information necessary to implement LONGNAME.
ALTER POOL Command Commands and Responses Command ZMCS-CMD-ALTER Object Type ZMCS-OBJ-MEDIACATALOG ALTER MEDIADEFS Command Tokens ZMCS-TKN-FILECATALOG ZMCS-TKN-POOLNAME ZMCS-TKN-SEARCHLISTSYSTEM ZMCS-TKN-SYSTEM ZMCS-TKN-VOLUMECATALOG token-type token-type token-type token-type token-type ZSPI-TYP-STRING ZSPI-TYP-STRING ZSPI-TYP-STRING ZSPI-TYP-STRING ZSPI-TYP-STRING ZMCS-MAP-ALTER-MEDIACATALOG ZMCS-TKN-SEARCHLISTSYSTEM specifies the name of the node on which the system search list is created.
Commands and Responses ALTER TAPEDRIVE Command Command ZMCS-CMD-ALTER Object Type ZMCS-OBJ-POOL ALTER POOL Command Tokens ZMCS-TKN-POOLNAME ZMCS-TKN-VOLUMECATALOG token-type ZSPI-TYP-STRING token-type ZSPI-TYP-STRING ZMCS-MAP-ALTER-POOL ZMCS-MAP-ALTER-POOL contains fields that correspond to the MEDIACOM ALTER POOL command. For descriptions of these fields, see ZMCS Maps on page 4-18.
ALTER TAPEDRIVE Command Commands and Responses Command ZMCS-CMD-ALTER Object Type ZMCS-OBJ-TAPEDRIVE ALTER TAPEDRIVE Command Tokens ZMCS-TKN-TAPEDRIVE token-type ZSPI-TYP-STRING ZMCS-MAP-ALTER-TAPEDRIVE ZMCS-MAP-ALTER-TAPEDRIVE contains fields that correspond to the MEDIACOM ALTER TAPEDRIVE command. For descriptions of these fields, see ZMCS Maps on page 4-18.
ALTER TAPEFILE Command Commands and Responses ALTER TAPEFILE Command ZMCS-CMD-ALTER (super-group only) ALTER TAPEFILE is used to change these attributes of a tape file entry: • • • The retention period of any unexpired entry The expiration date of any unexpired entry The status of an expired or accidentally deleted entry that represented a file in a multifile tape set Command ZMCS-CMD-ALTER Object Type ZMCS-OBJ-TAPEFILE ALTER TAPEFILE Command Tokens ZMCS-TKN-FILECATALOG ZMCS-TKN-TAPEFILEID token-type Z
ALTER TAPEMOUNT Command Commands and Responses ALTER TAPEMOUNT Command ZMCS-CMD-ALTER (super-group only) Sometimes a tape requested by a TAPECATALOG DEFINE is not available at the time the mount message is issued. Perhaps the tape is misplaced, damaged, or on loan to another group. If the unavailable tape has an alternate copy, you can use ALTER TAPEMOUNT to determine the proper tape to mount and to issue a new mount message for it.
ALTER TAPEVOLUME Command Commands and Responses ALTER TAPEVOLUME Command ZMCS-CMD-ALTER (super-group only) ALTER TAPEVOLUME changes the status of a tape in the volume catalog and its pool. It does not change the status if the tape is ASSIGNED (the tape has unexpired files on it), SELECTED (the tape is requested for use), or in USE (the tape is mounted on a tape drive and data is being written to it). This command does not change catalog information such as density, pool, volume catalog name, and so on.
ALTER VOLCAT Command Commands and Responses ALTER VOLCAT Command ZMCS-CMD-ALTER (super-group only) ALTER VOLCAT changes the owner or security level of a volume catalog.
CREATE VOLCAT Command Commands and Responses CREATE VOLCAT Command ZMCS-CMD-CREATE (super-group only) CREATE VOLCAT creates a volume catalog for the DSM/TC subsystem and assigns it a logical name. Only one volume catalog is allowed. However, you can have a file catalog and a volume catalog on the same subvolume if both catalogs have the same logical name. File and volume catalogs placed on different subvolumes must have different logical names.
DELETE POOL Command Commands and Responses DELETE POOL Command ZMCS-CMD-DELETE (super-group only) DELETE POOL removes a pool from a volume catalog. A pool can be deleted only after all the tapes cataloged in it are removed with DELETE TAPEVOLUME (for tapes of status BAD, RELEASED, or SCRATCH) or with DELETE TAPEFILE and then DELETE TAPEVOLUME (for tapes of status ASSIGNED).
DELETE TAPEFILE Command Commands and Responses DELETE TAPEFILE Command ZMCS-CMD-DELETE (super-group only) DELETE TAPEFILE removes an unexpired tape file entry from a file catalog. The volume and pool entries associated with the deleted entry are revised if the entry represented the only or last file on the tape set (in other words, if the tape’s status is changed from ASSIGNED to RELEASED or SCRATCH).
DELETE TAPELABEL Command Commands and Responses DELETE TAPELABEL Command ZMCS-CMD-DELETE (super-group only) DELETE TAPELABEL changes a standard labeled tape to an unlabeled tape. If the tape is cataloged in DSM/TC, you must first remove it from the catalog with DELETE TAPEVOLUME (for tapes with the status BAD, RELEASED, or SCRATCH) or with DELETE TAPEFILE and then DELETE TAPEVOLUME (for tapes of status ASSIGNED).
DELETE TAPEVOLUME Command Commands and Responses DELETE TAPEVOLUME Command ZMCS-CMD-DELETE (super-group only) DELETE TAPEVOLUME removes the volume catalog and pool entries for a tape with a status of BAD, RELEASED, or SCRATCH. For example, you must remove these entries when the tapes they represent are discarded, sent offsite for long-term storage, or moved to a different pool or volume catalog. Also use this command if a cataloged tape is going to be changed to an unlabeled tape.
Commands and Responses DROP FILECAT Command DROP FILECAT Command ZMCS-CMD-DROP (super-group only) DROP FILECAT removes a file catalog from the DSM/TC subsystem. A file catalog cannot be removed until all its file entries are deleted with DELETE TAPEFILE. DELETE TAPEFILE also changes the status of the volume entries associated with a deleted file entry to SCRATCH or RELEASED.
Commands and Responses DROP VOLCAT Command DROP VOLCAT Command ZMCS-CMD-DROP (super-group only) DROP VOLCAT removes a volume catalog from the DSM/TC subsystem. A volume catalog cannot be removed until all its pools are deleted with the DELETE POOL command. For descriptions of these fields, see ZMCS Maps on page 4-18. Delete a volume catalog when changing the configuration of your DSM/TC subsystem, such as changing the physical location of the volume catalog.
EXPIRE TAPEFILE Command Commands and Responses EXPIRE TAPEFILE Command ZMCS-CMD-EXPIRE (super-group only) DSM/TC automatically runs a cleanup process every 24 hours to permanently erase expired file catalog entries and revise the tape status in the volume catalog. (The tape status is changed to RELEASED or SCRATCH when all associated tape file entries either expire or are delete with DELETE TAPEFILE.) EXPIRE TAPEFILE runs the cleanup process at any time you need to run it.
INFO CONSOLE Command Commands and Responses INFO CONSOLE Command ZMCS-CMD-INFO INFO CONSOLE retrieves the device name of the tape console. Command ZMCS-CMD-INFO Object Type ZMCS-OBJ-CONSOLE INFO CONSOLE Command Tokens (None) INFO CONSOLE Response Tokens ZMCS-TKN-COUNT ZMCS-TKN-OUTFILE token-type ZSPI-TYP-INT2 token-type ZSPI-TYP-STRING ZMCS-TKN-OUTFILE contains the name of the tape console. The name can identify either a disk file or a device, such as a printer or terminal.
INFO DISKFILE Command Commands and Responses INFO DISKFILE Command ZMCS-CMD-INFO INFO DISKFILE retrieves information stored in disk file entries. Disk file entries are created when the CATALOGFILES option of BACKUP or BACKCOPY is used. These entries are mainly used for recovery operations. Disk file entries have a status of valid unless manually marked invalid by ALTER DISKFILE. All valid entries represent files eligible for a recovery operation.
INFO FILECAT Command Commands and Responses ZMCS-TKN-DISKFILENAME specifies the disk file name of the entry for which you are retrieving information. ZMCS-MAP-INFO-DISKFILE contains fields that correspond to the MEDIACOM INFO DISKFILE command. For descriptions of these fields, see ZMCS Maps on page 4-18.
INFO MEDIADEFS Command Commands and Responses INFO MEDIADEFS Command ZMCS-CMD-INFO INFO MEDIADEFS retrieves this information about the DSM/TC environment on one node: • • • • • • • • • The node names in the system search list The name of the system default file catalog The name of the system default volume catalog The name of the system default pool.
INFO POOL Command Commands and Responses INFO MEDIADEFS Response Tokens ZMCS-TKN-COUNT ZMCS-TKN-FILECATALOG ZMCS-TKN-POOLNAME ZMCS-TKN-SEARCHLISTSYSTEM ZMCS-TKN-VOLUMECATALOG token-type token-type token-type token-type token-type ZSPI-TYP-INT2 ZSPI-TYP-STRING ZSPI-TYP-STRING ZSPI-TYP-STRING ZSPI-TYP-STRING ZMCS-MAP-INFO-MEDIACATALOG ZMCS-TKN-SEARCHLISTSYSTEM contains the name of the node on which the system search list is created.
INFO TAPEDRIVE Command Commands and Responses INFO POOL Response Tokens ZMCS-TKN-COUNT ZMCS-TKN-POOLNAME ZMCS-TKN-VOLUMECATALOG token-type ZSPI-TYP-INT2 token-type ZSPI-TYP-STRING token-type ZSPI-TYP-STRING ZMCS-MAP-INFO-POOL ZMCS-MAP-INFO-POOL contains fields that correspond to the MEDIACOM INFO POOL command. For descriptions of these fields, see ZMCS Maps on page 4-18.
INFO TAPEFILE Command Commands and Responses INFO TAPEFILE Command ZMCS-CMD-INFO INFO TAPEFILE retrieves these attributes of a valid tape file entry: • • • • • • The file ID in the entry The generation number The version number The expiration date of the entry The type of application that created the tape file The date and time the entry was created Command ZMCS-CMD-INFO Object Type ZMCS-OBJ-TAPEFILE INFO TAPEFILE Command Tokens ZMCS-TKN-FILECATALOG ZMCS-TKN-TAPEFILEID token-type ZSPI-TYP-STRING token-
INFO TAPELABEL Command Commands and Responses ZMCS-MAP-INFO-TAPEFILE contains fields that correspond to the MEDIACOM INFO TAPEFILE command. For descriptions of these fields, see ZMCS Maps on page 4-18. INFO TAPELABEL Command ZMCS-CMD-INFO (Super-group only) INFO TAPELABEL identifies the type of label on a tape. It also retrieves the tape label information for a standard labeled tape and the first 80 bytes of data for an unlabeled tape or a tape with a nonstandard label.
INFO TAPEVOLUME Command Commands and Responses INFO TAPEVOLUME Command ZMCS-CMD-INFO INFO TAPEVOLUME retrieves these attributes of a tape: • • • • • • • • The tape name as written in the volume catalog The name of the volume catalog that owns the tape pool The name of the pool in which the tape is cataloged The label type The tape type The assigned density of the tape when it was labeled The tape status The tape format If the tape status is assigned because one or more of its files is unexpired, this f
INFO VOLCAT Command Commands and Responses ZMCS-MAP-INFO-TAPEVOLUME contains fields that correspond to the MEDIACOM INFO TAPEVOLUME command. For descriptions of these fields, see ZMCS Maps on page 4-18.
LABEL TAPEVOLUME Command Commands and Responses INFO VOLCAT Response Tokens ZMCS-TKN-CATALOGSUBVOLUME ZMCS-TKN-COUNT ZMCS-TKN-SECURITY ZMCS-TKN-USER ZMCS-TKN-VOLUMECATALOG ZMCS-TKN-VCVERSION token-type token-type token-type token-type token-type token-type ZSPI-TYP-STRING ZSPI-TYP-INT2 ZSPI-TYP-CHAR4 ZSPI-TYP-INT-PAIR ZSPI-TYP-STRING ZSPI-TYP-INT LABEL TAPEVOLUME Command ZMCS-CMD-LABEL (super-group only) LABEL TAPEVOLUME performs these operations on a tape managed by DSM/TC: • • Creates a standard AN
RECOVER DISKFILE Command Commands and Responses RECOVER DISKFILE Command ZMCS-CMD-RECOVER RECOVER DISKFILE copies one or more disk files from a backup tape set to disk.
STATUS SERVER Command Commands and Responses STATUS SERVER Command ZMCS-CMD-STATUS STATUS SERVER displays this information about the MEDIASRV server process for your session: • • • • • • • • • • • The local date and time on the node on which the server is running The name of the node on which the server is running The number of the node on which the server is running The process name and ID of the server The creator ID of the person who created the server The process ID of the person who started the ses
STATUS TAPEDRIVE Command Commands and Responses ZMCS-TKN-SWAPVOLUME contains the swap volume name. ZMCS-TKN-SYSTEM contains the server object program file name. ZMCS-TKN-VERSIONSTRING contains the server product number, version number, and release date. ZMCS-MAP-STATUS-MEDIASRV contains fields that correspond to the MEDIACOM STATUS SERVER command. For descriptions of these fields, see ZMCS Maps on page 4-18.
STATUS TAPEMOUNT Command Commands and Responses STATUS TAPEMOUNT Command ZMCS-CMD-STATUS STATUS TAPEMOUNT lists the outstanding tape mount requests on a node. Command ZMCS-CMD-STATUS Object Type ZMCS-OBJ-TAPEMOUNT STATUS TAPEMOUNT Command Tokens ZMCS-MAP-STATUS-TAPEMOUNT ZMCS-MAP-STATUS-TAPEMOUNT contains fields that correspond to the MEDIACOM STATUS TAPEMOUNT command. For descriptions of these fields, see ZMCS Maps on page 4-18.
A Errors This appendix describes ZMCS message types that can be received while executing MEDIASRV commands programmatically: Topic Page MEDIASRV Startup Messages A-1 SPI Error Descriptions A-3 MEDIADBM Errors A-4 MEDIASRV Syntax and Content Errors A-29 MEDIASRV Command Execution Errors A-106 MEDIASRV SPI Command Language Standard (CLS) Errors A-130 NonStop Kernel Tape Server Process ($ZSVR) Errors A-135 MEDIASRV/SPI Internal Errors A-144 MEDIASRV Startup Messages A MEDIASRV process gener
MEDIASRV Startup Messages Errors Could not retrieve CRTPID The MEDIASRV process could not obtain its own ID. Invalid startup parameter parameter-number A run option specified in a RUN command or startup message is invalid. Run options are numbered in the order they appear in the RUN command or startup message. The value for parameter-number indicates which run option is invalid.
SPI Error Descriptions Errors SPI Error Descriptions This subsection describes the error and informational messages issued by DSM/TC processes.
MEDIADBM Errors Errors MEDIADBM Errors The ZMCS errors documented in this subsection are returned from the DSM/TC catalog manager MEDIADBM. Table A-1.
MEDIADBM Errors Errors Table A-1.
MEDIADBM Errors Errors Table A-2.
100 ZMCS-ERR-NOROWSSELECTED Errors 100 ZMCS-ERR-NOROWSSELECTED This warning message indicates that the search pattern does not match anything in the SQL database. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message No records matched the search pattern. Cause. A command was specified that did not match any information in the SQL database. Effect. The command does not execute. Recovery.
303 ZMCS-ERR-NOFILECATALOG Errors 303 ZMCS-ERR-NOFILECATALOG An attempt was made to perform an action on a nonexistent file catalog. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message The file catalog specified does not exist. Cause. The file catalog you specified does not exist. Effect. The command does not execute. Recovery. Specify an existing file catalog.
305 ZMCS-ERR-NOVOLUMECATALOG Errors 305 ZMCS-ERR-NOVOLUMECATALOG An attempt was made to perform some action on a nonexistent volume catalog. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message The volume catalog specified does not exist. Cause. The volume catalog you specified does not exist. Effect. The command does not execute. Recovery. Specify an existing volume catalog.
307 ZMCS-ERR-VOLUMECATNOTEMPTY Errors 307 ZMCS-ERR-VOLUMECATNOTEMPTY The volume catalog could not be removed from DSM/TC because it still contains pools. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message The volume catalog contains pools. Use the DELETE POOL command to empty the volume catalog. Cause. You attempted to drop the volume catalog that contains existing pools. Effect. The drop fails. Recovery.
309 ZMCS-ERR-NOPOOL Errors 309 ZMCS-ERR-NOPOOL You have specified an action to a nonexistent pool. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message The pool specified does not exist. Cause. You specified a pool that does not exist. Effect. The command does not execute. Recovery. Specify an existing pool. 600 ZMCS-ERR-NOSYSTEMCATALOG An attempted command failed because no system SQL catalog exists.
601 ZMCS-ERR-NOTINSSLIST Errors 601 ZMCS-ERR-NOTINSSLIST An action affecting a node does not execute because the node is not included in the system search list. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message The system selected is not contained in the system search list. Use the SSLIST option of the ALTER MEDIADEFS command to add the system. Cause. The node you specified does not belong to the system search list. Effect.
605 ZMCS-ERR-UNABLETOBEGINTRAN Errors 605 ZMCS-ERR-UNABLETOBEGINTRAN A TMF operation could not be performed. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message Unable to begin a TMF transaction. Cause. An attempt to perform an operation requiring a TMF transaction failed. Effect. The command does not execute. Recovery. In general, recovery depends on the status of TMF. TMF must be running on your system.
607 ZMCS-ERR-TAPEFILENOTDELETED Errors 607 ZMCS-ERR-TAPEFILENOTDELETED A tape file entry could not be deleted. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-TAPEFILEID ZMCS-TKN-FILECATALOG ZMCS-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST ZMCS-MAP-DELETE-TAPEFILE ZSPI-TKN-ENDLIST token-type token-type token-type token-type token-type .Z-SSID .
609 ZMCS-ERR-NOTONLYVERSION Errors 609 ZMCS-ERR-NOTONLYVERSION An attempt to alter a tape file to valid status failed because a valid version of that generation already exists. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message Unable to alter the tape file because a valid version of that generation already exists. Cause.
611 ZMCS-ERR-UNABLETOACCESSFILEID Errors 611 ZMCS-ERR-UNABLETOACCESSFILEID A tape file entry could not be accessed because of a reported error. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-TAPEVOLUME ZMCS-TKN-POOLNAME ZMCS-TKN-VOLUMECATALOG ZMCS-TKN-FILECATALOG ZMCS-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST ZMCS-MAP-INFO-TAPEVOLUME ZSPI-TKN-ENDLIST token-type token-type token-type token-type token-type token-type token-type .Z-SSID .
613 ZMCS-ERR-TYPEVIOLATION Errors 613 ZMCS-ERR-TYPEVIOLATION An attempt to change the tape types in a pool failed. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message A pool constraint violation in the TYPE field has been detected. Cause. An attempt to change the pool to allow only a certain type of tape failed because tapes in the pool are of a different type. Effect. The command does not execute. Recovery. Execute a DELETE TAPEVOLUME command.
615 ZMCS-ERR-VOLUMEEXISTS Errors 615 ZMCS-ERR-VOLUMEEXISTS An attempt to add a tape volume failed because the tape volume already exists. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-POOLNAME ZMCS-TKN-VOLUMECATALOG ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-STRING token-type ZSPI-TYP-STRING Corresponding MEDIACOM Error Message The tape volume already exists in pool name1 of the volume catalog name2 Cause.
617 ZMCS-ERR-NOSCRATCHTAPES Errors 617 ZMCS-ERR-NOSCRATCHTAPES Automatic scratch tape allocation failed because no unused scratch tapes are in the pool. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message The pool has no scratch tapes. command to create more. Use the ADD/LABEL TAPEVOLUME Cause. An attempt to automatically allocate a scratch tape failed because no more scratch tapes are in the pool. (They are all being used.) Effect.
619 ZMCS-ERR-EXPIRATIONTOOOLD Errors 619 ZMCS-ERR-EXPIRATIONTOOOLD The expiration process has not run in the last three days. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message The EXPIRE process has not run in the past 3 days. The RESET EXPIRATION option of the ALTER MEDIADEFS command must be used to confirm that the system time is correct. Cause. The DSM/TC cleanup process has not run in the last three days. Effect.
621 ZMCS-ERR-PHANDLEMUSTMATCH Errors 621 ZMCS-ERR-PHANDLEMUSTMATCH An attempt to use a tape volume failed because the tape volume is reserved by another process. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message Volume SELECTED by a different user. Cause. The application process tried using a tape reserved by another process. Effect. The OPEN fails, and processing does not continue. Recovery.
623 ZMCS-ERR-CATALOGNAMEMISMATCH Errors 623 ZMCS-ERR-CATALOGNAMEMISMATCH A catalog is not added because either the logical or the physical name already has a catalog. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message Either the catalog name specified already exists, or the SUBVOL specified already has a file or volume catalog. Cause. An attempt to create a catalog failed because either the logical or physical name already has a catalog.
625 ZMCS-ERR-UNKNOWNREQUEST Errors 625 ZMCS-ERR-UNKNOWNREQUEST Due to an unknown request, no DSM/TC processing has occurred. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message The DSM/TC Manager has received an unknown request. Cause. The DSM/TC Manager has received an unknown request. Effect. The request does not process. Recovery. Contact your service provider.
627 ZMCS-ERR-UNABLETOACCESSPOOL Errors 627 ZMCS-ERR-UNABLETOACCESSPOOL Due to the reported file-system error, access to the CONFIG table failed. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-ERRORNUM ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-INT Corresponding MEDIACOM Error Message File system error error-number occurred while accessing the POOL table. Cause. A file-system error was received while trying to access the volume catalog. Effect. The command does not execute. Recovery.
629 ZMCS-ERR-INVALIDFILESEQUENCE Errors 629 ZMCS-ERR-INVALIDFILESEQUENCE The file sequence specified is invalid for the requested operation. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message File Sequence specified is invalid for requested operation. Cause. An invalid file sequence was specified in the DEFINE text. Effect. The requested operation terminates. Recovery. Correct the specified file sequence or remove it from the DEFINE text.
635 ZMCS-ERR-INVALIDARCHIVE Errors 635 ZMCS-ERR-INVALIDARCHIVE The tape volume already assigned to a ARCHIVE backup job was requested for a LONGNAME backup job. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message A tape volume already ASSIGNED to a ARCHIVE Backup job was requested for a LONGNAME backup job. Cause. An attempt was made to do a backup with the LONGNAME tapeformat to a tape volume was already assigned for the ARCHIVE tapeformat.
637 ZMCS-ERR-INCONSISTENTLEVEL Errors 637 ZMCS-ERR-INCONSISTENTLEVEL Backup Restore in undefined mode. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message Media Catalog tables are at inconsistent revision levels for this command; see the Support Note #03106 for a full description of the issue and an alternate upgrade procedure. Cause. You used the MEDIACOM command, ALTER MEDIADB, LONGNAME, in Backup Restore 2.
903 ZMCS-ERR-NEEDCATALOGUPGRADE2 Errors 903 ZMCS-ERR-NEEDCATALOGUPGRADE2 The Media Catalog tables need to be upgraded to support LONGNAME. See the ALTER MEDIADB, LONGNAME directive. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message Media Catalog tables need to be upgraded to support LONGNAME. Cause. A LONGNAME capable Media Catalog version is installed, but the underlying tables have not yet been upgraded. Effect.
MEDIASRV Syntax and Content Errors Errors Cause. The text of an SQL/MP warning message that explains the cause is returned. Effect. The MEDIASRV command completes. Recovery. Analyze the SQL warning message returned. This is an example of a SQL message returned. (The message includes the SQL message number and the DSM/TC file catalog name.) *** WARNING from SQL [1392]: The TRANSIDS or USAGES table of catalog *** \MACH.$DATA2.
MEDIASRV Syntax and Content Errors Errors Table A-3.
MEDIASRV Syntax and Content Errors Errors Table A-3.
MEDIASRV Syntax and Content Errors Errors Table A-3.
MEDIASRV Syntax and Content Errors Errors Table A-3.
MEDIASRV Syntax and Content Errors Errors Table A-3.
MEDIASRV Syntax and Content Errors Errors Table A-4.
MEDIASRV Syntax and Content Errors Errors Table A-4.
MEDIASRV Syntax and Content Errors Errors Table A-4.
MEDIASRV Syntax and Content Errors Errors Table A-4.
5001 ZMCS-ERR-AVRSYSTEMINVALID Errors Table A-4.
5002 ZMCS-ERR-AVRSYSTEMONLYONE Errors Recovery. Specify a valid node for AVRSYSTEM. 5002 ZMCS-ERR-AVRSYSTEMONLYONE Multiple systems were specified for the AVRSYSTEM attribute. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message Only one AVRSYSTEM can be specified. Cause. More than one AVRSYSTEM was specified in the TAPECATALOG DEFINE. Effect. The command does not execute. Recovery. Specify only one AVRSYSTEM in the TAPECATALOG DEFINE.
5005 ZMCS-ERR-BOTHTIMEGENINVALID Errors Recovery. Use the HELP command to see what is valid for AUTOSCRATCH, and then specify a valid value. 5005 ZMCS-ERR-BOTHTIMEGENINVALID This error indicates that the TIME option cannot be used with the GEN option. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message The TIME and GEN options are mutually exclusive. Cause. The TIME option was used with GEN. Effect. The command does not execute. Recovery.
5007 ZMCS-ERR-CANTUSESSLIST Errors 5007 ZMCS-ERR-CANTUSESSLIST The attempted command does not support checking the system search list. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message The FILECAT or VOLCAT does not support checking the system search list. Cause. This command does not support checking the system search list. Effect. The command does not execute. Recovery. Use a specific file catalog or use a wild-card character.
5009 ZMCS-ERR-CANTUSEWILDTAPEVOL Errors 5009 ZMCS-ERR-CANTUSEWILDTAPEVOL An attempt was made to use wild-card characters for a tape volume name. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message TAPEVOLUME cannot be wildcarded. Cause. Wild-card characters were specified for TAPEVOLUME. Effect. The command does not execute. Recovery. Do not specify wild-card characters.
5012 ZMCS-ERR-BOTHSYSDRIVINVALID Errors 5012 ZMCS-ERR-BOTHSYSDRIVINVALID An attempt was made to use the SYSTEM option with the TAPEDRIVE option. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message The SYSTEM and TAPEDRIVE options are mutually exclusive. Cause. The SYSTEM option was used with TAPEDRIVE. Effect. The command does not execute. Recovery. Do not use the SYSTEM option with TAPEDRIVE.
5014 ZMCS-ERR-APPENDRESET Errors 5014 ZMCS-ERR-APPENDRESET APPEND must be ON or OFF. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message APPEND must be ON or OFF. Cause. An attempt was made to add a pool specifying an APPEND attribute other than ON or OFF. Effect. The requested operation terminates. Recovery. Correct the syntax. 5015 ZMCS-ERR-CATSUBVOLINVALID An invalid name was used to name a subvolume.
5016 ZMCS-ERR-CATSUBVOLREQUIRED Errors 5016 ZMCS-ERR-CATSUBVOLREQUIRED An attempt was made to execute this command without specifying the SUBVOL option. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message SUBVOL is required. Cause. The SUBVOL option was not specified. Effect. The command does not execute. Recovery. Specify the SUBVOL option. 5017 ZMCS-ERR-CATSUBVOLRESET An attempt was made to reset the value for SUBVOL.
5019 ZMCS-ERR-COMMENTONLYONE Errors 5019 ZMCS-ERR-COMMENTONLYONE More than one COMMENT option and text was specified for this command. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message Only one COMMENT is allowed. Cause. More than one COMMENT option was specified. Effect. The command does not execute. Recovery. Specify one COMMENT option. 5020 ZMCS-ERR-COUNTINVALID The COUNT must be in the range 1 through 300.
5022 ZMCS-ERR-COUNTRESET Errors 5022 ZMCS-ERR-COUNTRESET An attempt was made to reset the value for COUNT. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message COUNT cannot be reset. Cause. An attempt was made to reset the COUNT option. Effect. The command does not execute. Recovery. Do not attempt to reset the COUNT option.
5024 ZMCS-ERR-DATEINVALID Errors 5024 ZMCS-ERR-DATEINVALID The value specified for the TIME option was invalid. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message TIME is invalid. Cause. An invalid TIME value was specified. Effect. The command does not execute. Recovery. Specify a valid TIME value. 5025 ZMCS-ERR-DENSITYINVALID A tape density value other than 1600 or 6250 was specified for the DENSITY option.
5027 ZMCS-ERR-DISKFILESTATUSINVALID Errors 5027 ZMCS-ERR-DISKFILESTATUSINVALID The value specified for the STATUS option was invalid. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message STATUS is invalid. Cause. The value specified for STATUS is invalid. Effect. The command does not execute. Recovery. Specify a valid STATUS value. 5028 ZMCS-ERR-DISKFILESTATUSRESET An attempt was made to reset the value for the STATUS option.
5030 ZMCS-ERR-FILECATALOGINVALID Errors 5030 ZMCS-ERR-FILECATALOGINVALID An invalid name was specified for the file catalog. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-FILECATALOG ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-STRING Corresponding MEDIACOM Error Message FILECAT file-catalog-name is invalid. Cause. The file catalog name specified was invalid. Effect. The command does not execute. Recovery. Specify a valid file catalog name.
5033 ZMCS-ERR-FILECATALOGRESET Errors 5033 ZMCS-ERR-FILECATALOGRESET An attempt was made to reset the file catalog specified in the SPI buffer. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message FILECAT cannot be reset. Cause. An attempt was made to reset the file catalog specified in the SPI buffer. Effect. The command does not execute. Recovery. Specify a valid value for the file catalog in the SPI buffer.
5035 ZMCS-ERR-RESERVEDRIVEINVALID Errors 5035 ZMCS-ERR-RESERVEDRIVEINVALID The RESERVE setting in an ALTER TAPEDRIVE command is invalid. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message RESERVE must be ON, OFF, or RESET. Cause. An ALTER TAPEDRIVE command was entered with an invalid RESERVE setting. Effect. The command does not execute. Recovery. Retry the command, either resetting RESERVE or setting it to ON or OFF.
5043 ZMCS-ERR-FILEIDONLYONE Errors 5043 ZMCS-ERR-FILEIDONLYONE More than one tape file was specified in the SPI buffer. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message Only one TAPEFILE is allowed. Cause. More than one tape file was specified in the SPI buffer. Effect. The command does not execute. Recovery. Specify only one tape file in the SPI buffer. 5044 ZMCS-ERR-FILEIDREQUIRED A tape file ID value is required for this command.
5046 ZMCS-ERR-FILEIDSTATUSINVALID Errors 5046 ZMCS-ERR-FILEIDSTATUSINVALID The value specified for the STATUS parameter was invalid. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message STATUS is invalid. Cause. An invalid STATUS value was specified. Effect. The command does not execute. Recovery. Specify a valid STATUS value. 5047 ZMCS-ERR-FILEIDTOOMANY Expecting a maximum of 90 File IDs.
5049 ZMCS-ERR-FILENAMEONLYONE Errors 5049 ZMCS-ERR-FILENAMEONLYONE Only one disk file name is allowed for this command. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message Only one DISKFILE is allowed. Cause. More than one disk file name was specified. Effect. The command does not execute. Recovery. Specify one disk file name in the SPI buffer. 5051 ZMCS-ERR-FILENAMEREQUIRED A disk file name is required for this command.
5053 ZMCS-ERR-FILENAMETOOMANY Errors 5053 ZMCS-ERR-FILENAMETOOMANY Expecting a maximum of 240 disk file names. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message Expecting a maximum of 240 disk file names. Cause. An attempt to add more than 240 disk files occurred. Effect. The requested operation terminates. Recovery. Correct the syntax. 5055 ZMCS-ERR-FILESTATUSINVALID An invalid file STATUS value was specified for this command.
5057 ZMCS-ERR-GENERATIONREQUIRED Errors 5057 ZMCS-ERR-GENERATIONREQUIRED A generation value for is required for this command. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message GEN is required. Cause. A GEN value was not specified. Effect. The command does not execute. Recovery. Specify a GEN value. 5058 ZMCS-ERR-GENERATIONRESET An attempt was made to reset the value for GEN.
5060 ZMCS-ERR-LSMDRIVEIDINVALID Errors 5060 ZMCS-ERR-LSMDRIVEIDINVALID The drive address specified for the Library Storage Module (LSM) is invalid. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message LSM is invalid. Cause. The drive address specified for the LSM is invalid. Effect. The command does not execute. Recovery. Attempt to correct the problem. If the problem persists, contact your service provider.
5062 ZMCS-ERR-LOGICALCOPYINVALID Errors 5062 ZMCS-ERR-LOGICALCOPYINVALID The value for LOGICAL must be 1 or 2 for this command. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message LOGICAL must be 1-2. Cause. The value for LOGICAL was not specified as 1 or 2. Effect. The command does not execute. Recovery. Specify a LOGICAL value of either 1 or 2. 5063 ZMCS-ERR-LOGICALCOPYRESET An attempt was made to reset the value for LOGICAL.
5065 ZMCS-ERR-MAXRESPRESET Errors 5065 ZMCS-ERR-MAXRESPRESET An attempt was made to reset the ZSPI^TKN^MaxResp token. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message The ZSPI^TKN^MaxResp token cannot be reset. Cause. An attempt was made to reset the ZSPI^TKN^MaxResp token. Effect. The command does not execute. Recovery. Specify a valid value for the ZSPI^TKN^MaxResp token.
5068 ZMCS-ERR-LSMINVALID Errors 5068 ZMCS-ERR-LSMINVALID The Library Storage Module (LSM) present flag is invalid. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message LSM Present flag is invalid. Cause. The LSM present flag is invalid. Effect. The command does not execute. Recovery. Use a valid value for the LSM present flag. 5073 ZMCS-ERR-MOUNTACTIONINVALID Only the ACCEPT TAPEMOUNT or REJECT TAPEMOUNT commands are valid in this situation.
5075 ZMCS-ERR-NEWTAPEVOLUMEINVALID Errors 5075 ZMCS-ERR-NEWTAPEVOLUMEINVALID The value specified for the NEWNAME option was invalid. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-TAPEVOLUME ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-STRING Corresponding MEDIACOM Error Message NEWNAME new-tape-name is invalid. Cause. An invalid NEWNAME value was specified. Effect. The command does not execute. Recovery. Specify a valid NEWNAME value.
5077 ZMCS-ERR-NEWTAPEVOLUMEONLYONE Errors 5077 ZMCS-ERR-NEWTAPEVOLUMEONLYONE More than one value for the NEWNAME option was specified for this command. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message Only one NEWNAME option and value is allowed. Cause. More than one NEWNAME was specified. Effect. The command does not execute. Recovery. Specify only one NEWNAME.
5080 ZMCS-ERR-OPERATORTERMREQUIRED Errors 5080 ZMCS-ERR-OPERATORTERMREQUIRED The ZMCS-TKN-OPERATORTERM token was not specified. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message OPERATORTERM is required. Cause. The OPERATORTERM token was not specified in the SPI buffer. Effect. The command does not execute. Recovery. Specify a valid OPERATORTERM token in the SPI buffer.
5082 ZMCS-ERR-INFILEINVALID Errors 5082 ZMCS-ERR-INFILEINVALID The value specified for the input file is invalid. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-INFILE ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-STRING Corresponding MEDIACOM Error Message INFILE in-file is invalid. Cause. An invalid input file value was specified. Effect. The command does not execute. Recovery. Specify a valid input file value.
5084 ZMCS-ERR-INFILERESET Errors 5084 ZMCS-ERR-INFILERESET There was an attempt to reset the INFILE in a command. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message INFILE cannot be RESET. Cause. There was an attempt to reset the INFILE in a command. Effect. The command does not execute. Recovery. INFILE is not a resettable command option. Retry the command without resetting INFILE.
5086 ZMCS-ERR-INFILEREAD Errors 5086 ZMCS-ERR-INFILEREAD An attempt to read an INFILE failed due to a file system error. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-ERRORNUM ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-INT Corresponding MEDIACOM Error Message READ from infile failed with File System error system-error. Cause. An attempt to read an input file failed due to the specified file system error. Effect. The command does not execute. Recovery.
5088 ZMCS-ERR-TEMPINFILEWRITE Errors 5088 ZMCS-ERR-TEMPINFILEWRITE An attempt to write to a temporary INFILE failed due to a file system error. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-ERRORNUM ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-INT Corresponding MEDIACOM Error Message WRITE to temporary infile failed, File System error systemerror. Cause. An attempt to write to a temporary input file failed due to the specified file system error. Effect. The command does not execute.
5091 ZMCS-ERR-OUTFILERESET Errors 5091 ZMCS-ERR-OUTFILERESET An attempt was made to reset the value for OUT file. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message OUTFILE cannot be RESET. Cause. An attempt was made to reset the output file value. Effect. The command does not execute. Recovery. Specify a valid output file value. 5092 ZMCS-ERR-OUTPUTONLYFIELDUSED An output-only field of a structure in the SPI buffer was used for input.
5094 ZMCS-ERR-OVERIDEINVALID Errors 5094 ZMCS-ERR-OVERIDEINVALID A value other than ON or OFF was specified for the OVERRIDE option. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message OVERRIDE must be ON or OFF. Cause. The value specified for OVERRIDE was not ON or OFF. Effect. The command does not execute. Recovery. Specify either ON or OFF as the OVERRIDE value.
5097 ZMCS-ERR-POOLNAMEINVALID Errors 5097 ZMCS-ERR-POOLNAMEINVALID The value specified for a pool name is invalid. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-POOLNAME ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-STRING Corresponding MEDIACOM Error Message POOL pool-name is invalid. Cause. An invalid POOL value was specified. Effect. The command does not execute. Recovery. Specify a valid POOL value. 5098 ZMCS-ERR-POOLNAMEONLYONE More than one value for POOL was specified.
5100 ZMCS-ERR-POOLNAMERESET Errors 5100 ZMCS-ERR-POOLNAMERESET An attempt was made to reset the value for POOL. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message POOL cannot be RESET. Cause. RESET with a reset value was specified for the POOL option. Effect. The command does not execute. Recovery. Use the HELP command to check what is valid for POOL, and specify a valid value. 5101 ZMCS-ERR-POOLNAMETOOMANY Too many POOLs were specified.
5102 ZMCS-ERR-POOLNAMEWILD Errors 5102 ZMCS-ERR-POOLNAMEWILD The pool name specified contained wild-card characters. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-POOLNAME ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-STRING Corresponding MEDIACOM Error Message POOL pool-name cannot be wildcarded. Cause. The pool name contained wild-card characters. Effect. The command does not execute. Recovery. Specify a pool name without wild-card characters.
5115 ZMCS-ERR-RETENTIONINVALID Errors 5115 ZMCS-ERR-RETENTIONINVALID An invalid RETENTION value was specified. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message RETENTION is invalid. Cause. An invalid RETENTION value was specified. Effect. The command does not execute. Recovery. Specify a valid RETENTION value. 5116 ZMCS-ERR-RETENTIONRESET An attempt was made to reset the value for RETENTION.
5117 ZMCS-ERR-SCRATCHCONFLICT Errors 5117 ZMCS-ERR-SCRATCHCONFLICT The SCRATCH option was specified with an option other than UNLOAD or TAPEDRIVE. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message If SCRATCH is specified, only UNLOAD and TAPEDRIVE are allowed. Cause. The SCRATCH option was specified with an option other than UNLOAD or TAPEDRIVE. Effect. The command does not execute. Recovery.
5119 ZMCS-ERR-SEARCHSPACEINVALID Errors 5119 ZMCS-ERR-SEARCHSPACEINVALID The value specified for SEARCHSPACE was not INCLUDED or EXCLUDED. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message SEARCHSPACE must be INCLUDED or EXCLUDED. Cause. The value specified for SEARCHSPACE was not INCLUDED or EXCLUDED. Effect. The command does not execute. Recovery. Specify either INCLUDED or EXCLUDED.
5122 ZMCS-ERR-SECURITYONLYONE Errors 5122 ZMCS-ERR-SECURITYONLYONE More than one value for SECURE was specified. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message Only one SECURITY is allowed. Cause. More than one value for SECURE was specified. Effect. The command does not execute. Recovery. Specify only one SECURE value. 5123 ZMCS-ERR-SECURITYREQUIRED A value for SECURE was not specified.
5125 ZMCS-ERR-SSLISTTOOMANY Errors 5125 ZMCS-ERR-SSLISTTOOMANY Too many SSLISTs were specified. The limit is 90. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message Too many SSLISTs were specified. The limit is 90. Cause. An attempt to add more than 90 SSLISTs occurred. Effect. The requested operation terminates. Recovery. Correct the syntax.
5128 ZMCS-ERR-SYSTEMINVALID Errors 5128 ZMCS-ERR-SYSTEMINVALID An invalid SYSTEM value was specified. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-SYSTEM ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-STRING Corresponding MEDIACOM Error Message SYSTEM \node is invalid. Cause. An invalid SYSTEM value was specified. Effect. The command does not execute. Recovery. Specify a valid SYSTEM value. 5129 ZMCS-ERR-SYSTEMONLYONE More than one system was specified.
5131 ZMCS-ERR-SYSTEMRESET Errors 5131 ZMCS-ERR-SYSTEMRESET An attempt was made to reset the value for SYSTEM. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message SYSTEM cannot be reset. Cause. RESET with a reset value was specified for the SYSTEM option. Effect. The command does not execute. Recovery. Use the HELP command to check what is valid for SYSTEM, and specify a valid value.
5143 ZMCS-ERR-TAPEDRIVEONLYONE Errors 5143 ZMCS-ERR-TAPEDRIVEONLYONE More than one TAPEDRIVE was specified. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message Only one TAPEDRIVE is allowed. Cause. More than one TAPEDRIVE was specified. Effect. The command does not execute. Recovery. Specify only one TAPEDRIVE. 5144 ZMCS-ERR-TAPEDRIVEREMOTE The tape drive specified in the SPI buffer is in a different node than that of MEDIASRV.
5145 ZMCS-ERR-TAPEDRIVEREQUIRED Errors 5145 ZMCS-ERR-TAPEDRIVEREQUIRED The TAPEDRIVE option was not specified. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message TAPEDRIVE is required. Cause. The TAPEDRIVE option was not specified. Effect. The command does not execute. Recovery. Specify the TAPEDRIVE option. 5146 ZMCS-ERR-TAPEDRIVERESET An attempt was made to reset the value for TAPEDRIVE.
5148 ZMCS-ERR-TAPEFILEMODEINVALID Errors 5148 ZMCS-ERR-TAPEFILEMODEINVALID An incorrect value was specified for MODE. The value must be ALL, USER, BACKFILE, or BACKVOLUME. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message MODE must be ALL, USER, BACKFILE, or BACKVOLUME. Cause. An incorrect value was specified for MODE. The value must be ALL, USER, BACKFILE, or BACKVOLUME. Effect. The command does not execute. Recovery.
5152 ZMCS-ERR-TAPEMOUNTIDINVALID Errors 5152 ZMCS-ERR-TAPEMOUNTIDINVALID An invalid TAPEMOUNT value was specified. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message TAPEMOUNT is invalid. Cause. An invalid TAPEMOUNT value was specified. Effect. The command does not execute. Recovery. Specify a valid TAPEMOUNT value. 5153 ZMCS-ERR-TAPEMOUNTIDRESET An attempt was made to reset the value for MODE.
5157 ZMCS-ERR-TAPEVOLOWNERONLYONE Errors 5157 ZMCS-ERR-TAPEVOLOWNERONLYONE More than one OWNER value was specified. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message Only one OWNER is allowed. Cause. More than one OWNER value was specified. Effect. The command does not execute. Recovery. Specify only one OWNER value. 5158 ZMCS-ERR-TAPEVOLSTATUSINVALID An invalid tape volume STATUS value was specified.
5160 ZMCS-ERR-TAPEVOLUMEINVALID Errors 5160 ZMCS-ERR-TAPEVOLUMEINVALID An invalid tape name was specified. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-TAPEVOLUME ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-STRING Corresponding MEDIACOM Error Message TAPEVOLUME tape-name is invalid. Cause. An invalid tape name was specified. Effect. The command does not execute. Recovery. Specify a valid tape name. 5161 ZMCS-ERR-TAPEVOLUMEONLYONE More than one TAPEVOLUME parameter was specified.
5163 ZMCS-ERR-TAPEVOLUMETOOMANY Errors 5163 ZMCS-ERR-TAPEVOLUMETOOMANY Too many TAPEVOLUMEs were specified. The limit is 300. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message Too many TAPEVOLUMEs were specified. The limit is 300. Cause. An attempt to add more than 300 tape volumes occurred. Effect. The requested operation terminates. Recovery. Correct the syntax. 5164 ZMCS-ERR-TIMESTAMPINVALID An invalid TIME value was specified.
5166 ZMCS-ERR-UNLOADINVALID Errors 5166 ZMCS-ERR-UNLOADINVALID An invalid UNLOAD value was specified. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message UNLOAD is invalid. Cause. An invalid UNLOAD value was specified. Effect. The command does not execute. Recovery. Specify a valid UNLOAD value. 5167 ZMCS-ERR-UNLOADRESET An attempt was made to reset the value for UNLOAD.
5169 ZMCS-ERR-OWNERINVALID Errors 5169 ZMCS-ERR-OWNERINVALID The value specified for OWNER is invalid. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message OWNER is invalid. Cause. The value specified for OWNER is invalid. Effect. The command does not execute. Recovery. Specify a valid value for OWNER. 5171 ZMCS-ERR-VERSIONINVALID An invalid VERSION value was specified.
5173 ZMCS-ERR-VOLSETCONFLICT Errors 5173 ZMCS-ERR-VOLSETCONFLICT The VOLUMESET option was used with STATUS VALID. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message VOLUMESET and STATUS VALID are mutually exclusive. Cause. The VOLUMESET option was used with STATUS VALID. Effect. The command does not execute. Recovery. Do not use the VOLUMESET option with STATUS VALID. 5174 ZMCS-ERR-VOLSETINVALID An invalid VOLUMESET value was specified.
5176 ZMCS-ERR-VOLUMECATALOGONLYONE Errors 5176 ZMCS-ERR-VOLUMECATALOGONLYONE More than one volume catalog was specified. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message Only one VOLCAT is allowed. Cause. More than one volume catalog was specified. Effect. The command does not execute. Recovery. Specify only one volume catalog. 5177 ZMCS-ERR-VOLUMECATALOGREQUIRED A volume catalog was not specified.
5179 ZMCS-ERR-VOLUMECATALOGRESET Errors 5179 ZMCS-ERR-VOLUMECATALOGRESET Wild-card characters were included in the volume catalog name. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-VOLUMECATALOG ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-STRING Corresponding MEDIACOM Error Message VOLCAT volume-catalog-name cannot be wildcarded. Cause. Wild-card characters were included in the volume catalog name. Effect. The command does not execute. Recovery.
5181 ZMCS-ERR-PROMPTINVALID Errors 5181 ZMCS-ERR-PROMPTINVALID An invalid PROMPT value was specified. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message PROMPT is invalid. Cause. An invalid PROMPT value was specified. Effect. The command does not execute. Recovery. Specify a valid PROMPT value. 5182 ZMCS-ERR-PROMPTRESET An attempt was made to reset the value for PROMPT.
5184 ZMCS-ERR-STATUSVERSIONCONFLICT Errors 5184 ZMCS-ERR-STATUSVERSIONCONFLICT STATUS was specified, but VERSION was not. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message VERSION is required with STATUS VALID. Cause. STATUS was specified, but VERSION was not. Effect. The command does not execute. Recovery. Specify VERSION with STATUS. 5185 ZMCS-ERR-STATUSPHYSICALCONF STATUS was used with PHYSICAL ALL.
5187 ZMCS-ERR-SSLISTNEEDLOCAL Errors 5187 ZMCS-ERR-SSLISTNEEDLOCAL The node being altered was not included in the system search list specified by the SSLIST. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message The system being altered must be included on the SSLIST. Cause. The node being altered was not included in the system search list specified by the SSLIST. Effect. The command does not execute. Recovery.
5189 ZMCS-ERR-FILEIDMISMATCH Errors 5189 ZMCS-ERR-FILEIDMISMATCH The tape file read from the tape does not match the tape file specified in the command line. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-TAPEVOLUME ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-STRING Corresponding MEDIACOM Error Message The tape file on the tape volume, tape-volume, does not match the tape file specified. Cause. The tape file read from the tape does not match the tape file specified in the command line.
5191 ZMCS-ERR-UNABLETOBEGINTRANS Errors 5191 ZMCS-ERR-UNABLETOBEGINTRANS A TMF transaction was unable to begin. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message Unable to begin a TMF transaction. Cause. A TMF transaction was unable to begin. Effect. The command does not execute. Recovery. Determine why TMF cannot be started and correct the situation.
5194 ZMCS-ERR-CARTRIDGEDENSITY Errors 5194 ZMCS-ERR-CARTRIDGEDENSITY DENSITY was specified as an option for cartridge tapes. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message DENSITY cannot be specified with cartridge tapes. Cause. DENSITY was specified as an option for cartridge tapes. Effect. The command does not execute. Recovery. Do not specify DENSITY for cartridge tapes.
5196 ZMCS-ERR-NEEDREMOTESYSTEMNAME Errors 5196 ZMCS-ERR-NEEDREMOTESYSTEMNAME UPDATESTATS is invalid ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message LOCALREMOTE \NODE is required if multiple DISKFILEs are specified and the DISKFILEs specified are from different nodes. Cause. A RECOVER DISKFILE command was issued specifying multiple disk files from different nodes, but the command did not include the LOCALREMOTE option. Effect.
5198 ZMCS-ERR-UPDATESTATSRESET Errors 5198 ZMCS-ERR-UPDATESTATSRESET UPDATESTATS must be ON or OFF. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message UPDATESTATS must be ON or OFF. Cause. An expire tape file directive was attempted specifying a value other than ON or OFF for the UPDATESTATS attribute. Effect. The requested operation terminates. Recovery. Correct the syntax. 5200 UNKNOWN-ERRORMESSAGE UPDATESTATS must be ON or OFF.
5201 ZMCS-ERR-REPOSITIONINVALID Errors 5201 ZMCS-ERR-REPOSITIONINVALID REPOSITION was used in an invalid manner. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message REPOSITION is invalid. Cause. A command was issued using REPOSITION when it is not valid. REPOSITION is an option of the INFO TAPELABEL command, and can be set only to ON or OFF. Effect. The command does not execute. Recovery. Retry the command, using REPOSITION only when valid.
5203 ZMCS-ERR-REPOSUNLOADCONFLICT Errors 5203 ZMCS-ERR-REPOSUNLOADCONFLICT REPOSITION and UNLOAD were both set to ON. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message REPOSITION is invalid. Cause. An INFO TAPELABEL command was issued that would result in both the REPOSITION and UNLOAD options being set to ON, which is invalid. Effect. The command does not execute. Recovery.
5206 ZMCS-ERR-OUTCOMMANDFILEINVALID Errors Recovery. Use the HELP command to check what is valid for TAPEFORMAT, and specify a valid TAPEFORMAT value. 5206 ZMCS-ERR-OUTCOMMANDFILEINVALID The OUTCOMMAND file is invalid. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message OUTCOMMAND file filename is invalid. Cause. An Invalid OUTCOMMAND file value was specified. Effect. The command does not execute. Recovery.
5209 ZMCS-ERR-OUTCOMMANDTERMOPEN Errors Effect. Nothing is output. Recovery. Analyze the error. (A FILE FULL condition is a common cause for this failure.) For descriptions of file-system errors, see the Guardian Procedure Errors and Messages Manual. 5209 ZMCS-ERR-OUTCOMMANDTERMOPEN OPEN of the OUTCOMMAND file failed. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message OPEN to the OUTCOMMAND file failed with file system error system-error.
MEDIASRV Command Execution Errors Errors MEDIASRV Command Execution Errors The ZMCS errors documented in this subsection are returned as a result of conditions that exist outside of MEDIASRV. Table A-5.
MEDIASRV Command Execution Errors Errors Table A-5.
MEDIASRV Command Execution Errors Errors Table A-6.
6001 ZMCS-ERR-ONEOPTIONREQUIRED Errors 6001 ZMCS-ERR-ONEOPTIONREQUIRED No options were specified for the command in the SPI buffer. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message At least one option is required. Cause. No options were specified for the command in the SPI buffer. Effect. The command does not execute. Recovery. Specify at least one option.
6004 ZMCS-ERR-ZSERVEROPEN Errors Cause. A WRITEREAD to ZSERVER failed with a file-system error. Effect. The command does not execute. Recovery. Analyze the file-system error. For descriptions of file-system errors, see the Guardian Procedure Errors and Messages Manual. 6004 ZMCS-ERR-ZSERVEROPEN An OPEN for ZSERVER failed with a file-system error.
6006 ZMCS-ERR-CATMANOPEN Errors 6006 ZMCS-ERR-CATMANOPEN The OPEN of MEDIADBM failed with a file-system error. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-ERRORTYPE ZMCS-TKN-COMMENT ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-INT token-type ZSPI-TYP-STRING Corresponding MEDIACOM Error Message OPEN of MEDIADBM failed because of error-number Cause. The OPEN of MEDIADBM failed with a file-system error. Effect. The command does not execute. Recovery. Analyze the file-system error.
6008 ZMCS-ERR-TMFNOTCONFIGURED Errors 6008 ZMCS-ERR-TMFNOTCONFIGURED TMF has not been configured on your system. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message TMF must be configured on your system. Cause. TMF has not been configured on your system. Effect. No DSM/TC command can execute. Recovery. You must configure TMF on your system. 6009 ZMCS-ERR-MUSTBESUPERGROUP You tried to execute a super-group command without authority.
6011 ZMCS-ERR-TAPESTRYNOTCONFIGURED Errors 6011 ZMCS-ERR-TAPESTRYNOTCONFIGURED TAPE_LABEL_PROCESSING ENABLED is not enabled on your system. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message Labeled Tape Support must be enabled on your system. Cause. TAPE_LABEL_PROCESSING ENABLED is not enabled on your system. Effect. Labeled tape operations will not work. Recovery.
6013 ZMCS-ERR-ADDDEFINE Errors 6013 ZMCS-ERR-ADDDEFINE An error was returned while you were trying to add a DEFINE. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-ERRORNUM ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-INT Corresponding MEDIACOM Error Message DEFINE add error error-number Cause. An error was returned while you were trying to add a DEFINE. Effect. The command does not execute. Recovery. Analyze the error.
6015 ZMCS-ERR-STOPENTERED Errors 6015 ZMCS-ERR-STOPENTERED The user stopped the execution of a command. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message Processing stopped by user. Cause. The user stopped the execution of a command. Effect. The command does not execute. Recovery. No recovery is necessary. The user stopped the command. 6016 ZMCS-ERR-NODATA The tape mounted is not a labeled tape or cannot be read.
6018 ZMCS-ERR-TAPEVOLUMEREAD Errors 6018 ZMCS-ERR-TAPEVOLUMEREAD An error was returned while you were trying to read the tape drive. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-ERRORNUM ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-INT Corresponding MEDIACOM Error Message Tape drive READ error, error-number Cause. An error was returned while you were trying to read the tape drive. Effect. The command does not execute. Recovery. Analyze the error.
6020 ZMCS-ERR-WRONGTAPEVOLUME Errors 6020 ZMCS-ERR-WRONGTAPEVOLUME The wrong tape was mounted. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-TAPEVOLUME ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-STRING Corresponding MEDIACOM Error Message Expecting tape volume name1 but name2 was mounted. Cause. The wrong tape was mounted. Effect. The command does not execute. Recovery. Mount the correct tape. 6021 ZMCS-ERR-TAPEVOLUMEUNLABELED A labeled tape was expected, but it was not mounted.
6023 ZMCS-ERR-TAPEVOLUMENOTEXPIRED Errors 6023 ZMCS-ERR-TAPEVOLUMENOTEXPIRED The tape mounted still has assigned files on it. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message The tape volume mounted is not expired. Cause. The tape mounted still has assigned files on it. Effect. The command does not execute. Recovery. If you want to use the mounted tape, you must expire the files on it. Otherwise, mount another, expired tape.
6025 ZMCS-ERR-TAPEDRIVECONTROL Errors 6025 ZMCS-ERR-TAPEDRIVECONTROL A CONTROL error was received. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-ERRORNUM ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-INT Corresponding MEDIACOM Error Message CONTROL error, error. Cause. A CONTROL error was received. Effect. The command does not execute. Recovery. Analyze the error. 6026 ZMCS-ERR-TAPEVOLUMELABELED A labeled tape was mounted when an unlabeled tape was expected.
6027 ZMCS-ERR-TAPEVOLUMEEXISTS Errors 6027 ZMCS-ERR-TAPEVOLUMEEXISTS A tape with a name you specified is already cataloged in DSM/TC. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message A tape with that name is already cataloged. Use the OVERRIDE option to allow the creation of a duplicate named tape volume outside DSM/TC control. Cause. A tape with a name you specified is already cataloged in DSM/TC. Effect.
6029 ZMCS-ERR-OUTTERMOPEN Errors 6029 ZMCS-ERR-OUTTERMOPEN A file-system error was returned while trying to open the OUT file. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-ERRORNUM ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-INT Corresponding MEDIACOM Error Message File system error error-number occurred on the OPEN of the out-file. Cause. A file-system error was returned while trying to open the OUT file. Effect. The command does not execute. Recovery. Analyze the file-system error.
6031 ZMCS-ERR-INCOMPLETEMEDIADEFS Errors 6031 ZMCS-ERR-INCOMPLETEMEDIADEFS ZSERVER was unable to access the ZSVRCONF file due to the returned file-system error.
6033 ZMCS-ERR-RESTORESTARTUP Errors 6033 ZMCS-ERR-RESTORESTARTUP The RESTORE operation cannot be started. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-ERRORNUM ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-INT Corresponding MEDIACOM Error Message The RESTORE process cannot be started because of file system error: error Cause. An attempt to start the RESTORE process failed due to a file-system error. Effect. The RESTORE process does not execute. Recovery. Analyze the error.
6035 ZMCS-ERR-BADRESTORESYNTAX Errors 6035 ZMCS-ERR-BADRESTORESYNTAX The RESTORE options you specified are invalid. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message Invalid RESTORE options specified Cause. The options specified for the RESTORE process are invalid. Effect. Files are not restored. Recovery. For the correct RESTORE options, see the Guardian Disk and Tape Utilities Reference Manual. Then retry the RESTORE process.
6037 ZMCS-ERR-OUTTERMWRITEREAD Errors 6037 ZMCS-ERR-OUTTERMWRITEREAD The WRITEREAD to your output terminal failed. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-ERRORNUM ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-INT Corresponding MEDIACOM Error Message WRITEREAD to output terminal failed with file system error: error Cause. The WRITEREAD to your output terminal failed with a file-system error. Effect. Nothing is output. Recovery. Analyze the error.
6039 ZMCS-ERR-TAPEDRIVEOPEN Errors 6039 ZMCS-ERR-TAPEDRIVEOPEN A file system error occurred when trying to execute an OPEN. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-ERRORNUM ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-INT Corresponding MEDIACOM Error Message OPEN error error Cause. When trying to execute a OPEN, the specified error occurred. Effect. The open fails. Recovery. Recovery actions vary based on the specified error number.
6041 ZMCS-ERR-TAPEDRIVESETPARAM Errors 6041 ZMCS-ERR-TAPEDRIVESETPARAM The expected and actual block sizes are different. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-ERRORNUM ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-INT Corresponding MEDIACOM Error Message SETPARAM returned file system error system-error. Cause. A SETPARAM resulted in the specified file-system error. Effect. The SETPARAM fails. Recovery. The file-system error indicates the problem that needs to be resolved.
6043 ZMCS-ERR-BRCOMCREATE Errors 6043 ZMCS-ERR-BRCOMCREATE The creation of the BRCOM process failed. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-ERRORNUM ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-INT Corresponding MEDIACOM Error Message The creation of the BRCOM process failed with file system error system-error. Cause. The RECOVER DISKFILE directive attempted to create a BRCOM process (to effect a Restore operation), but the attempt failed. Effect.
6045 ZMCS-ERR-BRCOMABENDED Errors 6045 ZMCS-ERR-BRCOMABENDED The BRCOM process abended. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message The BRCOM process abended. Cause. The BRCOM process, started by the RECOVER DISKFILE directive, abended. Effect. The RECOVER DISKFILE directive fails. Recovery. Check previous BRCOM messages to determine the cause. After determining the cause, retry the process.
MEDIASRV SPI Command Language Standard (CLS) Errors Errors MEDIASRV SPI Command Language Standard (CLS) Errors MEDIASRV returns the ZMCS errors documented in this subsection as a result of conditions that violate the SPI Command Language Standard (CLS). Table A-7.
6201 ZMCS-ERR-USEDLENTOOLARGE Errors 6201 ZMCS-ERR-USEDLENTOOLARGE A buffer sent to MEDIASRV is too large. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-USEDLEN ZMCS-TKN-READLEN ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-INT token-type ZSPI-TYP-INT Corresponding MEDIACOM Error Message The SPI buffer MEDIASRV used value1 bytes when only value2 bytes are allowed. Cause. A buffer sent to MEDIASRV is too large. Effect. MEDIASRV rejects the request. Recovery. Use a smaller buffer.
6203 ZMCS-ERR-NEEDNEWERSERVER Errors 6203 ZMCS-ERR-NEEDNEWERSERVER A buffer received by MEDIASRV cannot be processed due to version incompatibility. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR token-type ZSPI-TYP-ERROR ZMCS-TKN-MAXFIELDVERSION token-type ZSPI-TYP-UINT ZMCS-TKN-SERVERVERSION token-type ZSPI-TYP-UINT ZSPI-TKN-ENDLIST Corresponding MEDIACOM Error Message The SPI buffer received by MEDIASRV contained a minimum server version version1, that was greater than the server version version2 of MEDIASRV. Cause.
6205 ZMCS-ERR-UNKNOWNCOMMAND Errors 6205 ZMCS-ERR-UNKNOWNCOMMAND MEDIASRV received the SPI buffer with an unknown command. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-UNKNOWNCOMMAND ZMCS-TKN-UNKNOWNOBJECT ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-INT token-type ZSPI-TYP-INT Corresponding MEDIACOM Error Message The SPI buffer MEDIASRV received contained an unknown command: command, the object was: object Cause. MEDIASRV received the SPI buffer with an unknown command. Effect.
6207 ZMCS-ERR-EMPTYRESPONSE Errors 6207 ZMCS-ERR-EMPTYRESPONSE MEDIASRV has replied with an empty response. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message (None) Cause. No records matched the request. Effect. No data is changed. Recovery. Check the request. If it was invalid, correct the request and resend it. 6208 ZMCS-ERR-INVALIDCONTEXT An invalid context was sent to MEDIASRV.
NonStop Kernel Tape Server Process ($ZSVR) Errors Errors NonStop Kernel Tape Server Process ($ZSVR) Errors The NonStop Kernel Tape Server Process, $ZSVR, returns the ZMCS errors in this subsection. Table A-9.
6301 ZMCS-ERR-ZSVRERROR Errors Table A-10. ZMCS Tape Server Process Errors, Listed by Name Name Number ZMCS-ERR-ZSVRLABELREJECT 6313 ZMCS-ERR-ZSVRLEVELINVALID 6314 ZMCS-ERR-ZSVRLSMDRIVEINUSE 6309 ZMCS-ERR-ZSVRMOUNTIDERROR 6302 ZMCS-ERR-ZSVRNOALTDEFTABLE 6308 ZMCS-ERR-ZSVRNOXESSDEFTABLE 6307 ZMCS-ERR-ZSVROLDLSMIDWARNING 6306 ZMCS-ERR-ZSVRONLYSERIES 6310 ZMCS-ERR-ZSVRSUBSTITUTE 6311 ZMCS-ERR-ZSVRWRONGVERSION 6317 6301 ZMCS-ERR-ZSVRERROR The tape server returned a file-system error.
6302 ZMCS-ERR-ZSVRMOUNTIDERROR Errors 6302 ZMCS-ERR-ZSVRMOUNTIDERROR The mount ID you specified does not exist. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message The specified mount id does not exist. Cause. The mount ID you specified does not exist. Effect. The command does not execute. Recovery. Check the desired ID and re-execute the command. 6303 ZMCS-ERR-ZSVRACCEPTINVALID You specified ACCEPT TAPEMOUNT for a labeled tape request.
6305 ZMCS-ERR-ZSVRACTIVE Errors 6305 ZMCS-ERR-ZSVRACTIVE You attempted to alter the tape support level while outstanding tape requests still exist. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message The LEVEL cannot be lowered with outstanding tape requests. Cause. You attempted to alter the tape support level while outstanding tape requests still exist. Effect. The command does not execute. Recovery.
6307 ZMCS-ERR-ZSVRNOXESSDEFTABLE Errors 6307 ZMCS-ERR-ZSVRNOXESSDEFTABLE A file-system error occurred while accessing the default table. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-ERRORNUM ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-INT Corresponding MEDIACOM Error Message File system error error-number occurred while accessing the DEFAULT table. Cause. A file-system error occurred while accessing the default table. Effect. The command does not execute. Recovery.
6309 ZMCS-ERR-ZSVRLSMDRIVEINUSE Errors 6309 ZMCS-ERR-ZSVRLSMDRIVEINUSE You attempted to alter the LSM drive address while the LSM drive is in use. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message The LSM drive is in use, the drive address cannot be altered. Cause. You attempted to alter the LSM drive address while the LSM drive is in use. Effect. The command does not execute. Recovery.
6311 ZMCS-ERR-ZSVRSUBSTITUTE Errors 6311 ZMCS-ERR-ZSVRSUBSTITUTE The ALTER TAPEMOUNT request cannot be completed. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message Unable to complete ALTER TAPEMOUNT request. reason. See EMS log for Cause. The ALTER TAPEMOUNT request cannot be completed. Effect. The request is not completed. Recovery. Recovery depends on an analysis of the EMS message.
6313 ZMCS-ERR-ZSVRLABELREJECT Errors 6313 ZMCS-ERR-ZSVRLABELREJECT An error causes the third party tape manager to abort a tape operation. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZMCS-TKN-ERRORNUM ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-INT Corresponding MEDIACOM Error Message The operation has been aborted by the third party tapes manager with error error-number. Cause. The third party tape manager aborts a tape operation due to the specified error. Effect. The tape operation aborts.
6315 ZMCS-ERR-ZSVRCOMPRESSINVALID Errors 6315 ZMCS-ERR-ZSVRCOMPRESSINVALID The specified compression is invalid. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message The COMPRESSION specified is invalid. Cause. An ALTER MEDIADEFS command was entered with an invalid COMPRESSION setting. Effect. The command does not execute. Recovery. Re-enter the command, setting COMPRESSION to OFF, ON, or IDRC.
6317 ZMCS-ERR-ZSVRWRONGVERSION Errors 6317 ZMCS-ERR-ZSVRWRONGVERSION The current version of ZServer is incompatible. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message The ZServer VERSION is incompatible. Cause. The current version of ZServer is incompatible with other components. Effect. ZServer does not function properly. Recovery. Upgrade to the latest version of ZServer.
6701 ZMCS-ERR-MSINTERNALERROR Errors Table A-12.
6703 ZMCS-ERR-MSSHOTGUNPOSRESTORE Errors Effect. The command does not execute. Recovery. Contact your service provider. 6703 ZMCS-ERR-MSSHOTGUNPOSRESTORE The tape server returned a file-system error. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message MEDIASRV encountered SPI error, error-number, while restoring the saved buffer position. Cause. The tape server returned a file-system error. Effect. The command does not execute. Recovery.
6705 ZMCS-ERR-MSSHOTGUNSSNULL Errors 6705 ZMCS-ERR-MSSHOTGUNSSNULL The MEDIASRV process received an error while initializing the SPI buffer. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message MEDIASRV encountered error, error-number, while initializing the SPI buffer. Cause. The MEDIASRV process received an error while initializing the SPI buffer. Effect. The command does not execute. Recovery. Contact your service provider.
6707 ZMCS-ERR-MCSHOTGUNPOSRESTORE Errors 6707 ZMCS-ERR-MCSHOTGUNPOSRESTORE MEDIACOM received an error while restoring the saved buffer position. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message MEDIACOM encountered error, error-number, while restoring the saved buffer position. Cause. MEDIACOM received an error while restoring the saved buffer position. Effect. The command does not execute. Recovery. Contact your service provider.
6709 ZMCS-ERR-MCSHOTGUNSSNULL Errors 6709 ZMCS-ERR-MCSHOTGUNSSNULL MEDIACOM received an error while initializing the SPI buffer. ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-ERROR Corresponding MEDIACOM Error Message MEDIACOM encountered error, error-number, while initializing the SPI buffer. Cause. MEDIACOM received an error while initializing the SPI buffer. Effect. The command does not execute. Recovery. Contact your service provider.
Errors 6709 ZMCS-ERR-MCSHOTGUNSSNULL DSM/Tape Catalog Management Programming Manual—520481-003 A-150
B RPC Event Messages Remote Procedure Call Message Handling The Remote Procedure Call (RPC) facility on the NonStop Kernel system generates EMS events. Message text contains a prefix, followed by one or more lines of message text. The prefix contains the date and time of entry, standard-format EMS header name, and the request ID generated by RPC. For more information on RPC and the portmapper, see the Remote Procedure Call (RPC) Facility and running the portmapper in the DSM/Tape Catalog User’s Guide.
About the Event Descriptions RPC Event Messages About the Event Descriptions The ZRPC event descriptions are listed in order by event number. Each description includes: • • • • • • • The event number and name A list of tokens that appear in the event The event message text Descriptions of any listed tokens The probable cause of the event Possible effects of the event Recommended recovery actions ZRPC Events The events that follow are from -1 through 15.
RPC Event Messages -1 ZRPC-EVT-CPU-SWITCH ZEMS-TKN-EVENTNUMBER is a header token that contains the event number. Its value is ZRPC-EVT-CPUSWITCH (-1). ZEMS-TKN-SUBJECT-MARK is the standard EMS token that always immediately precedes the subject token; in this case, ZCOM-TKN-SUBJ-PROC. ZCOM-TKN-SUBJ-PROC is the only possible value that can be returned as the subject token. ZCOM-TKNSUBJ-PROC indicates the name of the portmapper process that switched CPUs.
1 ZRPC-EVT-PMAP-STARTED RPC Event Messages Cause. The processor in which the primary process was running failed. Effect. The object is running in the new CPU. Recovery. Recovery depends on the reason the primary processor was terminated: • • • If the primary processor stopped unexpectedly, report the problem to your service provider. The primary process should not stop unexpectedly during normal operations. If the primary process abended, report the problem to your service provider.
2 ZRPC-EVT-IO-ERR RPC Event Messages ZCOM-TKN-SUBJ-PROC is the only possible value that can be returned as the subject token. ZCOM-TKNSUBJ-PROC indicates the name of the portmapper process that has been started. ZEMS-TKN-EMPHASIS is a header token that contains the value ZSPI-VAL-FALSE, indicating that this event is not critical. ZSPI-TKN-SERVER-BANNER indicates the version of the RPC subsystem used by the portmapper process. In the message text, subjname corresponds to the value in ZCOM-TKN-SUBJ-PROC.
RPC Event Messages 2 ZRPC-EVT-IO-ERR ZEMS-TKN-SUBJECT-MARK is the standard EMS token that always immediately precedes the subject token; in this case, ZCOM-TKN-SUBJ-PROC. ZCOM-TKN-SUBJ-FILE is the only possible value that can be returned as the subject token. ZCOM-TKNSUBJ-FILE indicates the name of the file in which the I/O error occurred. ZEMS-TKN-EMPHASIS is a header token that contains the value ZSPI-VAL-TRUE, indicating that this event is critical.
3 ZRPC-EVT-INIT-FAIL RPC Event Messages 3 ZRPC-EVT-INIT-FAIL The portmapper process failed to initialize. Tokens in Event Message ZCOM-TKN-OBJTYPE ZEMS-TKN-EVENTNUMBER ZEMS-TKN-SUBJECT-MARK ZCOM-TKN-SUBJ-PROC ZEMS-TKN-EMPHASIS ZRPC-TKN-INIT-ERR ZRPC-TKN-BAD-ARG token-type token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-ENUM. ZSPI-TYP-MARK. ZSPI-TYP-STRING. ZSPI-TYP-BOOLEAN. <1> token-type ZSPI-TYP-INIT-ERR-NUM. <2> token-type ZSPI-TYP-STRING.
RPC Event Messages 3 ZRPC-EVT-INIT-FAIL ZRPC-VAL-INIT-ERR-ARGS indicates that an illegal argument list was specified. ZRPC-VAL-INIT-ERR-MULT-BCPU indicates that more than one BACKUPCPU value was specified. ZRPC-VAL-INIT-ERR-INV-BCPU indicates that an invalid BACKUPCPU value was specified. ZRPC-VAL-INIT-ERR-MULT-TCPIP indicates that more than one NonStop Kernel TCP/IP process was specified. ZRPC-VAL-INIT-ERR-INV-TCPIP indicates that an invalid NonStop Kernel TCP/IP process name was specified.
4 ZRPC-EVT-SLR-ERR RPC Event Messages Cause. The portmapper process failed to initialize for the reason indicated by the ZRPC-TKN-INIT-ERR token. The ZRPC-TKN-BAD-ARG token contains additional information, if available, such as the specific argument or process that caused the error. Effect. The portmapper process does not start. Recovery. Based on the values returned for the ZRPC-TKN-INIT-ERR and ZRPCTKN-BAD-ARG tokens, correct the problem and restart the portmapper process.
RPC Event Messages 4 ZRPC-EVT-SLR-ERR ZCOM-TKN-SUBJ-FILE is the only possible value that can be returned as the subject token. ZCOM-TKNSUBJ-FILE indicates the name of the socket file in which the error occurred. ZEMS-TKN-EMPHASIS is a header token that contains the value ZSPI-VAL-TRUE, indicating that this is a critical event. ZRPC-TKN-SOCK-TYPE indicates the type of socket that had the error. Possible values are: 1 indicates the socket was a TCP stream socket.
5 ZRPC-EVT-RPC-ERR RPC Event Messages • Values in the range 0 through 255 indicate a file-system error. File-system errors are defined in the ZFILDDL source file. Effect. A connection or a datagram might have been lost. If the NonStop Kernel TCP/IP process was inaccessible (file-system error 201 or 250), the portmapper process records the event, closes all open sockets, and then periodically tries to reestablish communications with the NonStop Kernel TCP/IP process for a configurable period of time.
RPC Event Messages 5 ZRPC-EVT-RPC-ERR ZCOM-TKN-SUBJ-FILE is the only possible value that can be returned as the subject token. ZCOM-TKNSUBJ-FILE indicates the name of the socket file in which the error occurred. ZEMS-TKN-EMPHASIS is a header token that contains the value ZSPI-VAL-TRUE, indicating that this event is critical. In the message text, sockfile corresponds to the value in ZCOM-TKN-SUBJ-FILE. rpc corresponds to the value in ZSPI-TKN-PROC-ERR within the error list.
6 ZRPC-EVT-CREATE-ERR RPC Event Messages 6 ZRPC-EVT-CREATE-ERR A call to the PROCESS_CREATE procedure failed to create the backup process or a remote process. The backup process is used for fault tolerance. A remote process is used to handle broadcast RPC requests. Tokens in Event Message ZCOM-TKN-OBJTYPE ZEMS-TKN-EVENTNUMBER ZEMS-TKN-SUBJECT-MARK ZCOM-TKN-SUBJ-FILE ZEMS-TKN-EMPHASIS token-type token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-ENUM. ZSPI-TYP-MARK. ZSPI-TYP-STRING.
RPC Event Messages 6 ZRPC-EVT-CREATE-ERR ZRPC-TKN-NEWPROC-TYPE indicates the type of process that the PROCESS_CREATE call was attempting to create: ZRPC-VAL-BACKUP indicates that the PROCESS_CREATE call was attempting to create a backup process for fault tolerance. ZRPC-VAL-REMOTE indicates that the PROCESS_CREATE call was attempting to create a remote process to handle RPC broadcast requests. ZRPC-VAL-PRIMARY indicates that the PROCESS_CREATE call was attempting to create a primary process.
7 ZRPC-EVT-CONN-LOST RPC Event Messages 7 ZRPC-EVT-CONN-LOST The portmapper process could not communicate with another process (most likely, the NonStop Kernel TCP/IP process). Tokens in Event Message ZCOM-TKN-OBJTYPE ZEMS-TKN-EVENTNUMBER ZEMS-TKN-SUBJECT-MARK ZCOM-TKN-SUBJ-PROC ZEMS-TKN-EMPHASIS token-type token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-ENUM. ZSPI-TYP-MARK. ZSPI-TYP-STRING. ZSPI-TYP-BOOLEAN. ZSPI-TKN-ERRLIST ... ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST.
8 ZRPC-EVT-BKUP-FAIL RPC Event Messages periodically tries to reestablish communications with the NonStop Kernel TCP/IP process for a configurable period of time. If communications are reestablished, the portmapper process reopens its sockets and proceeds as usual. If communication has not been reestablished after the configurable period of time, the portmapper process abends. Recovery.
RPC Event Messages 8 ZRPC-EVT-BKUP-FAIL ZCOM-TKN-SUBJ-PROC is the only possible value that can be returned as the subject token. ZCOM-TKNSUBJ-PROC indicates the name of the backup portmapper process that terminated. ZEMS-TKN-EMPHASIS is a header token that contains the value ZSPI-VAL-TRUE, indicating that this is a critical event. ZRPC-TKN-CPU indicates the number of the CPU in which the backup process was running. ZRPC-TKN-BKUP-FAIL-REASON indicates the reason the backup process terminated.
9 ZRPC-EVT-BAD-VSN RPC Event Messages 9 ZRPC-EVT-BAD-VSN The indicated portmapper process was initiated on an inappropriate system. The process terminates. Tokens in Event Message ZCOM-TKN-OBJTYPE ZEMS-TKN-EVENTNUMBER ZEMS-TKN-SUBJECT-MARK ZCOM-TKN-SUBJ-PROC ZEMS-TKN-EMPHASIS token-type token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-ENUM. ZSPI-TYP-MARK. ZSPI-TYP-STRING. ZSPI-TYP-BOOLEAN.
10 ZRPC-EVT-MEM-FULL RPC Event Messages 10 ZRPC-EVT-MEM-FULL Insufficient memory is available. If this error occurs at process startup, the affected process terminates. Otherwise, requests that cannot be handled while the problem exists are rejected with the appropriate error. Tokens in Event Message ZCOM-TKN-OBJTYPE ZEMS-TKN-EVENTNUMBER ZEMS-TKN-SUBJECT-MARK ZCOM-TKN-SUBJ-PROC ZEMS-TKN-EMPHASIS token-type token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-ENUM. ZSPI-TYP-MARK.
11 ZRPC-EVT-PROG-ERR RPC Event Messages Cause. Possible causes of this event are: • • • Insufficient configured memory. The process was initiated with a fixed amount of memory, and that memory was insufficient. Insufficient disk space. Even if an allowance was made for extensible memory, the swap volume does not have sufficient space to accommodate the needs of the process. Overload of CPU.
RPC Event Messages 11 ZRPC-EVT-PROG-ERR ZEMS-TKN-EVENTNUMBER is a header token that contains the event number. Its value is ZRPC-EVT-PROGERR (11). ZEMS-TKN-SUBJECT-MARK is the standard EMS token that always immediately precedes the subject token; in this case, ZCOM-TKN-SUBJ-PROC. ZCOM-TKN-SUBJ-PROC is the only possible value that can be returned as the subject token. ZCOM-TKNSUBJ-PROC indicates the name of the portmapper process that detected the error.
12 ZRPC-EVT-UNEXP-IO-CMPL RPC Event Messages Recovery.
13 ZRPC-EVT-MAX-ABENDS RPC Event Messages ZEMS-TKN-EMPHASIS is a header token that contains the value ZSPI-VAL-TRUE, indicating that this event is critical. In the message text, filename corresponds to the value in ZCOM-TKN-SUBJ-FILE. Cause. The portmapper process detected the unexpected completion of an I/O operation in the main processing loop. This situation indicates a serious internal programming error. This event should not occur during normal operation. Effect.
RPC Event Messages 13 ZRPC-EVT-MAX-ABENDS ZEMS-TKN-SUBJECT-MARK is the standard EMS token that always immediately precedes the subject token; in this case, ZCOM-TKN-SUBJ-PROC. ZCOM-TKN-SUBJ-PROC is the only possible value that can be returned as the subject token. ZCOM-TKNSUBJ-PROC indicates the name of the backup portmapper process that abended. ZEMS-TKN-EMPHASIS is a header token that contains the value ZSPI-VAL-TRUE, indicating that this is a critical event.
14 ZRPC-EVT-UNKWN-MSG-SRC RPC Event Messages 14 ZRPC-EVT-UNKWN-MSG-SRC An inbound message was received that originated from a process that did not have a current open of the portmapper process. Tokens in Event Message ZCOM-TKN-OBJTYPE ZEMS-TKN-EVENTNUMBER ZEMS-TKN-SUBJECT-MARK ZCOM-TKN-SUBJ-PROC ZEMS-TKN-EMPHASIS token-type token-type token-type token-type token-type ZRPC-MAP-RECV-INFO def ZRPC-DDL-RECV-INFO ZNODE type ZCPU type ZPIN type ZIOTYPE type ZPAID type end. ZSPI-TYP-ENUM. ZSPI-TYP-ENUM.
RPC Event Messages 14 ZRPC-EVT-UNKWN-MSG-SRC ZRPC-MAP-RECV-INFO is an extensible structured token that contains information about the process that issued the message. It has the token number ZRPC-TNM-RECV-INFO and the DDL definition ZRPC-DDL-RECV-INFO. The fields in ZRPC-MAP-RECV-INFO are defined as: ZNODE indicates the node number of the process that issued the message. ZCPU indicates the processor number of the process that issued the message.
15 ZRPC-EVT-UNEXP-SYS-MSG RPC Event Messages 15 ZRPC-EVT-UNEXP-SYS-MSG The portmapper process received a system message that it did not expect or does not recognize. Tokens in Event Message ZCOM-TKN-OBJTYPE ZEMS-TKN-EVENTNUMBER ZEMS-TKN-SUBJECT-MARK ZCOM-TKN-SUBJ-PROC ZEMS-TKN-EMPHASIS token-type token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-ENUM. ZSPI-TYP-MARK. ZSPI-TYP-STRING. ZSPI-TYP-BOOLEAN. ZRPC-TKN-SYS-MSGCODE <1> token-type ZSPI-TYP-INT.
16 ZRPC-EVT-CLNT-STAT-ERR RPC Event Messages Effect. The unexpected message probably has no effect on the operation of the portmapper process and is dropped. Recovery.
16 ZRPC-EVT-CLNT-STAT-ERR RPC Event Messages ZCOM-TKN-SUBJ-PROC is the only possible value that can be returned as the subject token. ZCOM-TKNSUBJ-PROC indicates the name of the portmapper process that has been started. ZEMS-TKN-EMPHASIS is a header token that contains the value ZSPI-VAL-FALSE, indicating that this event is not critical. ZRPC-TKN-CS-ERR indicates the client status error that occurred and the corresponding error text. Possible values are: # ZRPC-VAL-CSE-... Indicates...
17 ZRPC-EVT-PORTMAP-ERR RPC Event Messages ZRPC-TKN-IP-ADDR is the IP address, in dotted decimal notation (d.d.d.d), of the target of the remote RPC host that failed. Cause. The portmapper coprocess received a client status error from an RPC library routine, most likely because of an error in the RPC service being targeted. Effect. The RPC broadcast request that caused this error is dropped. Recovery. Informational message only; no corrective action is needed.
17 ZRPC-EVT-PORTMAP-ERR RPC Event Messages ZEMS-TKN-EMPHASIS is a header token that contains the value ZSPI-VAL-FALSE, indicating that this event is not critical.
18 ZRPC-EVT-FUNC-CALL-FAIL RPC Event Messages 18 ZRPC-EVT-FUNC-CALL-FAIL An error was returned by a function call. Tokens in Event Message ZCOM-TKN-OBJTYPE ZEMS-TKN-EVENTNUMBER ZEMS-TKN-SUBJECT-MARK ZCOM-TKN-SUBJ-PROC ZEMS-TKN-EMPHASIS ZRPC-TKN-FUNC-NAME ZRPC-TKN-RET-STATUS ZRPC-TKN-RESP-TEXT token-type token-type token-type token-type token-type ZSPI-TYP-ENUM. ZSPI-TYP-ENUM. ZSPI-TYP-MARK. ZSPI-TYP-STRING. ZSPI-TYP-BOOLEAN. <1> token-type ZSPI-TYP-STRING. <2> token-type ZSPI-TYP-INT2.
RPC Event Messages 18 ZRPC-EVT-FUNC-CALL-FAIL ZRPC-TKN-RESP-TEXT is a detailed description of the error of the failed function call. Cause. An error is returned by the specified function call. Examine the error details to know more about the cause of the error. Effect. The effect depends on the severity of the error. Recovery. If the error is not severe, the process recovers by itself. Otherwise, the process abends.
RPC Event Messages 18 ZRPC-EVT-FUNC-CALL-FAIL DSM/Tape Catalog Management Programming Manual—520481-003 B -34
C SSI Event Messages Storage Server Interface Message Handling The Storage Server Interface process ($ZSSI) generates EMS events. Event message text contains a prefix, followed by one or more lines of message text. The prefix contains the date and time of entry, standard-format EMS header name, and the request ID generated by $ZSSI. For more information on the Storage Server Interface, see Storage Server Interface (SSI) to the STK Control Path in the DSM/Tape Catalog User’s Guide.
SSI Event Messages SSI Example Output Undefined Host Name This example shows a series of EMS messages reporting a fatal fault because PARAM value for CSI^HOSTNAME was not specified: 92-11-30 17:17:16 \SYS1.$ZSSI TANDEM.SSI.G06 000001 SSI activated:Initiation Started; t_ssi_init(); 92-11-30 17:17:21 \SYS1.$ZSSI TANDEM.SSI.G06 000004 Fatal fault:STATUS_PROCESS_FAILURE: Undefined hostname:CSI^HOSTNAME; t_chk_init(); failed:getenv(); 92-11-30 17:17:22 \SYS1.$ZSSI TANDEM.SSI.
SSI Event Messages About the Event Descriptions About the Event Descriptions The ZSSI event descriptions are listed in order by event number. Each description includes: • The event number and name Because various versions of message 3 and message 4 appear, a value for the ZSSI-TKN-MSG token is also included with the event number and name to identify the version.
Tokens Found in All or Most SSI Events SSI Event Messages Table C-1.
Tokens Found in All or Most SSI Events SSI Event Messages Table C-1.
Tokens Found in All or Most SSI Events SSI Event Messages Table C-1.
Tokens Found in All or Most SSI Events SSI Event Messages Table C-1.
Tokens Found in All or Most SSI Events SSI Event Messages Table C-1.
SSI Event Messages Tokens Found in All or Most SSI Events Table C-2.
SSI Event Messages Tokens Found in All or Most SSI Events Table C-2.
SSI Event Messages Tokens Found in All or Most SSI Events Table C-2.
SSI Event Messages Tokens Found in All or Most SSI Events Table C-2.
SSI Event Messages Tokens Found in All or Most SSI Events Table C-2.
ZSSI Events 1 and 2 SSI Event Messages ZSSI Events 1 and 2 These are descriptions of the tokens contained in SSI event messages 1 and 2, and the cause, effect, and recovery actions for conditions that generate the messages. 1 ZSSI-EVT-ACTIVATED The SSI is establishing a connection with the Communications Server Interface (CSI) server. Tokens in Event Message ZSSI-TKN-PROC-CALLER ZSSI-TKN-MSG token-type ZSPI-TYP-STRING. token-type ZSSI-TYP-MSG. Message Text Initiation started. Cause. $ZSSI has started.
ZSSI Message 3 SSI Event Messages ZSSI Message 3 When the Storage Server Interface (SSI) encounters a transient error, various versions of event message 3 appear, with different reasons and recovery actions for each error condition. These three tables list all of the event message 3 variations detailed in this appendix. They are listed by number in Table C-3, by value in Table C-4 on page C-16, and by text in Table C-5 on page C-16. Table C-3.
ZSSI Message 3 SSI Event Messages Table C-4. Event Message 3 Variations, Listed by Value Value (ZSSI-VAL-MSG…) Number Message Text DEL-QMEMBER-FAIL 12 Can't delete Q-id ..., Member ... DUP-NI-PACKET 44 Duplicate packet from Network detected: discarded. Remote IP address: ..., Process-ID: ..., Sequence number: ..., ID: ... INV-COMM-SERVICE 34 Invalid communications service. INV-COMMAND 47 Invalid command, ... INV-CONNQ-AGE 49 Invalid connection queue aging time ..., default:...
ZSSI Message 3 SSI Event Messages Table C-5. Event Message 3 Variations, Listed by Message Text Message Text Value (ZSSI-VAL-MSG…) Number Can't locate queue Q_id ..., Member: ... LOC-QMEMBER-FAIL 11 Cannot decode to free memory allocated by XDR. RPC-CANT-FREE-ARGS 36 Cannot reply to RPC message. RPC-CANT-REPLY 16 Duplicate packet from Network detected: discarded. Remote IP address: ..., Process-ID: ..., Sequence number: ..., ID: ... DUP-NI-PACKET 44 Invalid command, ...
3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-RPC-CANT-FREE-ARGS (36) SSI Event Messages 3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-RPC-CANT-FREE-ARGS (36) The SSI cannot reply to an RPC message. Tokens in Event Message ZSSI-TKN-PROC-CALLER ZSSI-TKN-MSG ZSSI-TKN-STAT ZSSI-TKN-PROC-FAILED token-type token-type token-type token-type ZSPI-TYP-STRING. ZSSI-TYP-MSG. ZSSI-TYP-STAT ZSPI-TYP-STRING Message Text Cannot decode to free memory allocated by XDR. Cause. The call to the svc_sendreply() function failed.
3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-RPC-CANT-REPLY (16) SSI Event Messages 3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-RPC-CANT-REPLY (16) The SSI cannot reply to an RPC message. Tokens in Event Message ZSSI-TKN-PROC-CALLER ZSSI-TKN-MSG ZSSI-TKN-STAT ZSSI-TKN-PROC-FAILED token-type token-type token-type token-type ZSPI-TYP-STRING. ZSSI-TYP-MSG. ZSSI-TYP-STAT ZSPI-TYP-STRING Message Text Cannot reply to RPC message. Cause. The call to the svc_freeargs() function failed.
3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-DEL-QMEMBER-FAIL (12) SSI Event Messages Cause. $ZSSI could not put $ZSVR's return address or the CSI's return address on its queue. Possible causes are: • • • Insufficient configured memory. The process was initiated with a fixed amount of memory, and that memory was insufficient. Insufficient disk space. Even if an allowance was made for extensible memory, the swap volume does not have sufficient space to accommodate the needs of the process. Overload of CPU.
3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-Q-STATUS-FAIL (21) SSI Event Messages Cause. $ZSSI cannot delete a message in an internal queue. Effect. $ZSSI ignores the request. Recovery. This event should not occur during normal operation.
3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-LOC-QMEMBER-FAIL (11) SSI Event Messages • • Details of the 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 and versions of all related products as well.
3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-DUP-NI-PACKET (44) SSI Event Messages 3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-DUP-NI-PACKET (44) The SSI received and dropped a duplicate packet from the network. Tokens in Event Message ZSSI-TKN-PROC-CALLER ZSSI-TKN-MSG ZSSI-TKN-STAT ZSSI-TKN-PROC-FAILED ZSSI-TKN-ADDRESS ZSSI-TKN-PROC-ID ZSSI-TKN-SEQ-NUM ZSSI-TKN-NUMBER <1> <2> <3> <4> token-type token-type token-type token-type token-type token-type token-type token-type ZSPI-TYP-STRING. ZSSI-TYP-MSG.
3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-INV-COMMAND (47) SSI Event Messages 3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-INV-COMMAND (47) The SSI received a request packet from $ZSVR with an unrecognizable request number. Tokens in Event Message ZSSI-TKN-PROC-CALLER ZSSI-TKN-MSG ZSSI-TKN-STAT ZSSI-TKN-PROC-FAILED token-type token-type token-type token-type ZSPI-TYP-STRING. ZSSI-TYP-MSG. ZSSI-TYP-STAT ZSPI-TYP-STRING Message Text Invalid command, requestnum Cause.
3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-INV-CONNQ-AGE (49) SSI Event Messages 3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-INV-CONNQ-AGE (49) The time parameter used to start $ZSVR is not a usable number. Tokens in Event Message ZSSI-TKN-PROC-CALLER ZSSI-TKN-MSG ZSSI-TKN-SECONDS ZSSI-TKN-TIME token-type token-type <1> token-type <2> token-type ZSPI-TYP-STRING. ZSSI-TYP-MSG. ZSPI-TYP-INT2. ZSPI-TYP-STRING. Message Text Invalid connection queue aging time <2>, default: <1> seconds substituted.
3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-INVALID-PROTO (19) SSI Event Messages ZNUMBER-TKN-NUMBER contains the invalid value in the location type field. Cause. The CSI received a request packet from $ZSSI with an unrecognizable type specified in the message_data portion of the request. This error indicates a programming error of the client software that attempted communication with $ZSSI. Effect. $ZSSI ignores the request. Recovery.
3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-RPC-INV-PROC (14) SSI Event Messages 3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-RPC-INV-PROC (14) The SSI received a packet from the network interface, but it is not using one of two valid procedure numbers. Tokens in Event Message ZSSI-TKN-PROC-CALLER ZSSI-TKN-MSG ZSSI-TKN-STAT ZSSI-TKN-PROC-FAILED token-type token-type token-type token-type ZSPI-TYP-STRING. ZSSI-TYP-MSG. ZSSI-TYP-STAT ZSPI-TYP-STRING Message Text Invalid procedure number. Cause.
3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-INV-VERSION (52) SSI Event Messages Cause. The SSI received a packet from the network interface with either an unrecognizable type in the IPC_HEADER portion of the CSI REQUEST_HEADER or an unrecognizable IDENTIFIER type in the message packet. A problem exists with the server software that tried to communicate with the SSI. Effect. $ZSSI ignores the request. Recovery. If the error recurs, contact your network or UNIX-based server support representative.
3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-UNDEF-CLIENT (27) SSI Event Messages 3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-UNDEF-CLIENT (27) The SSI detected a message from the CSI for an invalid or unknown client. Tokens in Event Message ZSSI-TKN-PROC-CALLER ZSSI-TKN-MSG ZSSI-TKN-STAT ZSSI-TKN-PROC-FAILED token-type token-type token-type token-type ZSPI-TYP-STRING. ZSSI-TYP-MSG. ZSSI-TYP-STAT ZSPI-TYP-STRING Message Text Message for unknown client discarded. Cause.
3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-NON-SUCCESS (501) SSI Event Messages ZSSI-TKN-PORT contains the port number. Cause. $ZSSI cannot connect to the network. Effect. If this message occurs more than three times, $ZSSI automatically retries the communication. Recovery. Informational message only; no corrective action is needed. 3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-NON-SUCCESS (501) The CSI cannot successfully complete a request from the SSI.
3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-Q-CLEAN (23) SSI Event Messages 3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-Q-CLEAN (23) The SSI routinely purged a process from its connective queue. Tokens in Event Message ZSSI-TKN-PROC-CALLER ZSSI-TKN-MSG ZSSI-TKN-Q-ID ZSSI-TKN-Q-MEMBER token-type token-type <1> token-type <2> token-type ZSPI-TYP-STRING. ZSSI-TYP-MSG. ZSPI-TYP-INT. ZSPI-TYP-INT.
3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-UNEXP-FAIL (46) SSI Event Messages 3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-UNEXP-FAIL (46) The SSI received an unexpected error. Tokens in Event Message ZSSI-TKN-PROC-CALLER ZSSI-TKN-MSG ZSSI-TKN-STAT ZSSI-TKN-PROC-FAILED ZSSI-TKN-ERRNO token-type token-type token-type token-type <1> token-type ZSPI-TYP-STRING. ZSSI-TYP-MSG. ZSSI-TYP-STAT ZSPI-TYP-STRING ZSPI-TYP-INT. Message Text Unexpected failure detected: errno = <1>.
3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-PROTO-WARN (55) SSI Event Messages 3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-PROTO-WARN (55) The SSI notifies you that the CSI is not communicating using the Transmission Control Protocol (TCP) or the User Datagram Protocol (UDP). Tokens in Event Message ZSSI-TKN-PROC-CALLER ZSSI-TKN-MSG ZSSI-TKN-STAT ZSSI-TKN-PROC-FAILED token-type token-type token-type token-type ZSPI-TYP-STRING. ZSSI-TYP-MSG. ZSSI-TYP-STAT ZSPI-TYP-STRING Message Text Validation warning.
3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-XDR-XLATE-FAIL (35) SSI Event Messages 3 ZSSI-EVT-TRANSIENT-FAULT, zssi-val-msg-XDR-XLATE-FAIL (35) The SSI External Data Representation (XDR) translation routines cannot translate a message completely because the message has been damaged. Tokens in Event Message ZSSI-TKN-PROC-CALLER ZSSI-TKN-MSG ZSSI-TKN-STAT ZSSI-TKN-PROC-FAILED token-type token-type token-type token-type ZSPI-TYP-STRING. ZSSI-TYP-MSG.
ZSSI Event 4 SSI Event Messages ZSSI Event 4 When the Storage Server Interface (SSI) encounters a fatal error, various versions of event message 4 appear, with different reasons and recovery actions for each error condition. These tables list all of the event message 4 versions detailed in this appendix. They are listed by number in Table C-6, by value in Table C-7 on page C-36, and by text in Table C-8 on page C-37. Table C-6. Event Message 4 Variations, Listed by Number Number Value (ZSSI-VAL-MSG-...
ZSSI Event 4 SSI Event Messages Table C-7. Event Message 4 Variations, Listed by Value Value (ZSSI-VAL-MSG-...) Number Message Text CREATE-CONNECTQ-F 9 Creation of connect queue failed. CREATE-NI-OUTQ-F 10 Creation of network output queue failed. DEL-QMEMBER-FAIL 12 Can't delete Q-id ..., Member: ... INIT-FAIL 8 Initiation of ZSSI failed. INV-NI-TIMEOUT 43 Invalid network time-out value. INV-VERSION 52 Invalid version number, .... IPC-OPEN 205 Creating socket ... failed on ....
ZSSI Event 4 SSI Event Messages Table C-8. Event Message 4 Variations, Listed by Message Text Message Text Value (ZSSI-VAL-MSG-...) Number Can't delete Q-id ..., Member: ... DEL-QMEMBER-FAIL 12 Can't register RPC TCP service. TCP-REG-FAIL 3 Cannot send message to NI: discarded, Address: ..., Port: ... SEND-NI-FAIL 32 Create of RPC TCP service failed, Address: ..., Port: ... TCP-CREATE-FAIL 2 Creating socket ... failed on .... IPC-OPEN 205 Creation of connect queue failed.
4 ZSSI-EVT-FATAL-FAULT, zssi-val-msg-SEND-NI-FAIL (32) SSI Event Messages 4 ZSSI-EVT-FATAL-FAULT, zssi-val-msg-SEND-NI-FAIL (32) The communications mechanism of the Network Interface (NI) cannot accept a message from the SSI. Tokens in Event Message ZSSI-TKN-PROC-CALLER ZSSI-TKN-MSG ZSSI-TKN-STAT ZSSI-TKN-PROC-FAILED ZSSI-TKN-ADDRESS ZSSI-TKN-PORT token-type token-type token-type token-type <1> token-type <2> token-type ZSPI-TYP-STRING. ZSSI-TYP-MSG. ZSSI-TYP-STAT ZSPI-TYP-STRING ZRPC-TYP-IP-ADDR.
4 ZSSI-EVT-FATAL-FAULT, zssi-val-msg-DEL-QMEMBER-FAIL (12) SSI Event Messages 4 ZSSI-EVT-FATAL-FAULT, zssi-val-msg-DEL-QMEMBER-FAIL (12) The SSI cannot delete a message in an internal queue. Tokens in Event Message ZSSI-TKN-PROC-CALLER ZSSI-TKN-MSG ZSSI-TKN-STAT ZSSI-TKN-PROC-FAILED ZSSI-TKN-Q-ID ZSSI-TKN-Q-MEMBER token-type token-type token-type token-type <1> token-type <2> token-type ZSPI-TYP-STRING. ZSSI-TYP-MSG. ZSSI-TYP-STAT ZSPI-TYP-STRING ZSPI-TYP-INT. ZSPI-TYP-INT.
4 ZSSI-EVT-FATAL-FAULT, zssi-val-msg-TCP-REG-FAIL (3) SSI Event Messages 4 ZSSI-EVT-FATAL-FAULT, zssi-val-msg-TCP-REG-FAIL (3) The call to register RPC TCP services failed. Tokens in Event Message ZSSI-TKN-PROC-CALLER ZSSI-TKN-MSG ZSSI-TKN-STAT ZSSI-TKN-PROC-FAILED token-type token-type token-type token-type ZSPI-TYP-STRING. ZSSI-TYP-MSG. ZSSI-TYP-STAT ZSPI-TYP-STRING Message Text Can't register RPC TCP service. Cause. The call to the svc_register() function failed. Effect.
4 ZSSI-EVT-FATAL-FAULT, zssi-val-msg-IPC-OPEN (205) SSI Event Messages 4 ZSSI-EVT-FATAL-FAULT, zssi-val-msg-IPC-OPEN (205) The SSI cannot initialize the socket. Tokens in Event Message ZSSI-TKN-PROC-CALLER ZSSI-TKN-MSG ZSSI-TKN-STAT ZSSI-TKN-PROC-FAILED ZSSI-TKN-STRING ZSSI-TKN-ERRORNO token-type token-type token-type token-type <1> token-type <2> token-type ZSPI-TYP-STRING. ZSSI-TYP-MSG. ZSSI-TYP-STAT ZSPI-TYP-STRING ZSPI-TYP-STRING. ZSSI-TYP-INT. Message Text Creating socket <1> failed on <2>.
4 ZSSI-EVT-FATAL-FAULT, zssi-val-msg-CREATE-NI-OUTQ-F (10) SSI Event Messages • • Insufficient disk space—even if an allowance was made for extensible memory, the swap volume does not have sufficient space to accommodate the needs of the process. Overload of CPU—too many demands were made of the CPU, causing it to use up internal resources, such as memory allocated for time-list elements (TLEs). Effect. $ZSSI terminates. Recovery.
4 ZSSI-EVT-FATAL-FAULT, zssi-val-msg-INIT-FAIL (8) SSI Event Messages Recovery. Recovery depends on the cause of the error: • • • If the configured memory was insufficient, you might need to increase the PMAP_MAXENTRIES define attribute (default 1000) in the portmapper. If disk space was insufficient, move the data-swap volume to a disk with more available space.
4 ZSSI-EVT-FATAL-FAULT, zssi-val-msg-INV-VERSION (52) SSI Event Messages ZSSI-TKN-TIME contains the time-out value (in seconds). Cause. The calculated network time-out is not a usable number. The time-out is calculated by combining the figures assigned to the CSI^RETRY^TIMEOUT and CSI^RETRY^TRIES environment variables. Effect. $ZSSI terminates. Recovery. Check PARAM values in the command (OBEY) file used to start $ZSVR and make any necessary changes.
4 ZSSI-EVT-FATAL-FAULT, zssi-val-msg-SYSTEM-ERR (13) SSI Event Messages 4 ZSSI-EVT-FATAL-FAULT, zssi-val-msg-SYSTEM-ERR (13) The SSI encountered a file-system error. This message indicates a problem with the operation system itself, not with $ZSSI. Tokens in Event Message ZSSI-TKN-PROC-CALLER ZSSI-TKN-MSG ZSSI-TKN-STAT ZSSI-TKN-PROC-FAILED ZSSI-TKN-ERROR token-type token-type token-type token-type <1> token-type ZSPI-TYP-STRING. ZSSI-TYP-MSG. ZSSI-TYP-STAT ZSPI-TYP-STRING ZSPI-TYP-INT.
4 ZSSI-EVT-FATAL-FAULT, zssi-val-msg-TCP-CLNTCREATE (17) SSI Event Messages • Overload of CPU—too many demands were made of the CPU, causing it to use up internal resources (such as memory allocated for TLEs). Effect. $ZSSI terminates. Recovery. Recovery depends on the cause of the error: • • • If the configured memory was insufficient, you might need to increase the PMAP_MAXENTRIES define attribute (default 1000) in the portmapper.
4 ZSSI-EVT-FATAL-FAULT, zssi-val-msg-UNDEF-HOST (38) SSI Event Messages Effect. $ZSSI terminates. Recovery. Restart or reestablish communications with the NonStop Kernel TCP/IP service, the NonStop Kernel portmapper/RPC service, or both. 4 ZSSI-EVT-FATAL-FAULT, zssi-val-msg-UNDEF-HOST (38) The SSI encountered an undefined client host on startup.
4 ZSSI-EVT-FATAL-FAULT, zssi-val-msg-UNEXPECT-STAT (500) SSI Event Messages ZSSI-TKN-ERRNO contains the C run-time error number. Cause. $ZSSI received an error that it did not expect. Effect. $ZSSI terminates. Recovery. For an interpretation of the errno value, see the C/C++ Programmer’s Guide. 4 ZSSI-EVT-FATAL-FAULT, zssi-val-msg-UNEXPECT-STAT (500) The SSI received status information that it did not expect.
SSI Event Messages 4 ZSSI-EVT-FATAL-FAULT, zssi-val-msg-XDR-XLATE-FAIL (35) Effect. $ZSSI attempts to translate the message up to the point where the error was detected. If the header part of the message is translatable, the message is forwarded. Otherwise, it is dropped. Recovery. If the error is not caused by an error in the client network, connection to the RPC service is retried automatically.
ZSSI Events 5 Through 10 SSI Event Messages ZSSI Events 5 Through 10 These are descriptions of the tokens contained in SSI event messages 5 and 6, and the cause, effect, and recovery actions for conditions that generate each message. 5 ZSSI-EVT-DE-ACTIVATING Termination of the SSI started. Tokens in Event Message ZSSI-TKN-PROC-CALLER ZSSI-TKN-MSG token-type ZSPI-TYP-STRING. token-type ZSSI-TYP-MSG. Message Text Termination Started. Cause. $ZSSI termination started. Effect. None. Recovery.
7 ZSSI-EVT-IO-ERROR SSI Event Messages 7 ZSSI-EVT-IO-ERROR An input/output (I/O) error occurred. Tokens in Event Message ZSSI-TKN-PROC-CALLER ZSSI-TKN-MSG ZSSI-TKN-STAT token-type ZSPI-TYP-STRING. token-type ZSSI-TYP-MSG. token-type ZSSI-TYP-STAT Message Text error, filename: filename. Cause. An I/O error occurred. This is most likely due to an Open Error 12, which is a file-system error indicating that the specified file is in use. Effect. The specified file could not be opened. Recovery.
9 ZSSI-EVT-RPC-ERR SSI Event Messages 9 ZSSI-EVT-RPC-ERR An RPC error occurred. Tokens in Event Message ZSSI-TKN-PROC-CALLER ZSSI-TKN-MSG token-type ZSPI-TYP-STRING. token-type ZSSI-TYP-MSG. Message Text RPC error: message-details. Cause. An RPC error occurred. Effect. Depends on the message details. Recovery. Review the message details to see what action is needed. 10 ZSSI-EVT-SLR-ERR An SLR socket error occurred. Tokens in Event Message ZSSI-TKN-PROC-CALLER ZSSI-TKN-MSG token-type ZSPI-TYP-STRING.
D Tape Server Event Messages Tape Server Process Events This appendix contains descriptions of the NonStop Kernel tape server process ($ZSVR) event messages. For more information on EMS, see the EMS Manual. About the Event Descriptions The ZTAP event descriptions are listed in order by event number.
ZTAP Events Tape Server Event Messages ZTAP-TYP-ERRTAPEVOLUME token type ZTAP-TYP-ERRTAPEVOLUMEvalue is ZSPI-TDT-CHAR def is ZSPI-DDL-CHAR occurs 6 times ZTAP-TYP-ERRTAPEVOLUME is used to describe tape volume names that contain up to six characters. ZTAP-TYP-FILEID token type ZTAP-TYP-FILEID value is ZSPI-TDT-CHAR def is ZSPI-DDL-CHAR occurs 17 times ZTAP-TYP-FILEID is used to describe file IDs that contain up to seventeen characters.
662 ZTAP-EVT-CMWRITEREAD Tape Server Event Messages Cause. $ZSVR could not create the MEDIADBM process. Effect. No DSM/TC cataloging can be done. Recovery. Correct the error and $ZSVR will automatically create the MEDIADBM process when needed. For descriptions of file-system errors, see the Operator Messages Manual. 662 ZTAP-EVT-CMWRITEREAD When communicating with the DSM/TC database manager process, the tape server received a WRITEREAD error.
663 ZTAP-EVT-CMREPLY Tape Server Event Messages 663 ZTAP-EVT-CMREPLY The tape server received an error while communicating with the DSM/TC database manager process. Tokens in Event Message ZTAP-TKN-PROCESS ZTAP-TKN-ERRMSGNUMBER ZEMS-TKN-TEXT ZTAP-TKN-BADNUM token-type token-type token-type <1> token-type ZSPI-TYP-CRTPID. ZSPI-TYP-UINT. ZSPI-TYP-STRING. ZSPI-TYP-UINT. Message Text Error 1007 - DSM/TC REPLY error: <1> ZTAP-TKN-ERRMSGNUMBER contains the error message number for this tape server error.
665 ZTAP-EVT-CLEANUP Tape Server Event Messages ZTAP-TKN-ERRMSGNUMBER contains the error message number for this tape server error. The number for this error is 1008. ZTAP-TKN-FSERR contains the file-system error number reported in this message. Cause. $ZSVR was unable to create the MEDDEM process because of a file-system error. Effect. No DSM/TC cleanup can be done. No tape volumes will expire automatically. Recovery. Correct the error, and $ZSVR will automatically create the MEDDEM process the next day.
667 ZTAP-EVT-SSIOPEN Tape Server Event Messages 667 ZTAP-EVT-SSIOPEN The tape server cannot create the SSI process. Tokens in Event Message ZTAP-TKN-PROCESS ZTAP-TKN-ERRMSGNUMBER ZEMS-TKN-TEXT ZTAP-TKN-FSERR token-type token-type token-type <1> token-type ZSPI-TYP-CRTPID. ZSPI-TYP-UINT. ZSPI-TYP-STRING. ZSPI-TYP-ENUM. Message Text Error 1009 - Error creating SSI: <1> ZTAP-TKN-ERRMSGNUMBER contains the error message number for this tape server error. The number for this error is 1009.
669 ZTAP-EVT-SSIRETRY Tape Server Event Messages ZTAP-TKN-FSERR contains the file-system error number reported in this message. Cause. $ZSVR sent a message to the SSI process, but a file-system error was returned. Effect. $ZSVR automatically attempts to restart the SSI process and retries the request three times. Recovery. If the retry attempt is successful, no corrective action is necessary. If the retry fails, file-system error 595 is returned to the tape request.
670 ZTAP-EVT-SSINORETRY Tape Server Event Messages 670 ZTAP-EVT-SSINORETRY The tape server received a fatal error from the Storage Server Process. Tokens in Event Message ZTAP-TKN-PROCESS ZTAP-TKN-ERRMSGNUMBER ZEMS-TKN-TEXT ZTAP-TKN-BADNUM token-type ZSPI-TYP-CRTPID. token-type ZSPI-TYP-UINT. token-type ZSPI-TYP-STRING. <1> token-type ZSPI-TYP-UINT. Message Text Error 1012 - SSI non-retryable error: <1> ZTAP-TKN-ERRMSGNUMBER contains the error message number for this tape server error.
672 ZTAP-EVT-SSIMISMATCH Tape Server Event Messages Effect. $ZSVR retries the tape request when a tape drive in the StorageTek ACS becomes available. There is no retry limit. Recovery. If you do not want to retry the request, use the MEDIACOM/MEDIASRV REJECT TAPEMOUNT command. 672 ZTAP-EVT-SSIMISMATCH A tape is being ejected because the tape server detected a mismatched tape mounted by the StorageTek ACS.
673 ZTAP-EVT-SSIDISMOUNT Tape Server Event Messages 673 ZTAP-EVT-SSIDISMOUNT The tape server could not dismount a tape from a tape drive in the StorageTek ACS. Tokens in Event Message ZTAP-TKN-PROCESS ZTAP-TKN-ERRMSGNUMBER ZEMS-TKN-TEXT ZTAP-TKN-TAPE-VOLUME token-type ZSPI-TYP-CRTPID. token-type ZSPI-TYP-UINT. token-type ZSPI-TYP-STRING. <1> token-type ZTAP-TYP-TAPE-VOLUME.
675 ZTAP-EVT-CMEXCLUDEDPOOL Tape Server Event Messages ZTAP-TKN-TAPE-VOLUME contains the tape volume name. ZTAP-TKN-DEV-NAME contains the drive name. Cause. $ZSVR detected a mismatched tape type mounted by the StorageTek ACS. Effect. The application receives file-system error 595, and the tape volume is dismounted from the StorageTek ACS. (The name of the tape was correct, but the LABEL attribute was mismatched.
676 ZTAP-EVT-CMNOSCRATCH Tape Server Event Messages 676 ZTAP-EVT-CMNOSCRATCH A tape request is being retried because the pool specified in the TAPECATALOG DEFINE is out of scratch tape volumes that match the appropriate type. Tokens in Event Message ZTAP-TKN-PROCESS ZTAP-TKN-ERRMSGNUMBER ZEMS-TKN-TEXT token-type ZSPI-TYP-CRTPID. token-type ZSPI-TYP-UINT. <1> token-type ZSPI-TYP-STRING.
678 ZTAP-EVT-CMWRONGVOLUME Tape Server Event Messages Recovery. Correct the FILESECT attribute and retry the operation. For descriptions of file-system errors, see the Operator Messages Manual. 678 ZTAP-EVT-CMWRONGVOLUME The volume name specified in the TAPECATALOG DEFINE for an application READ request was not used for the specified file ID.
679 ZTAP-EVT-CMNOTSCRATCH Tape Server Event Messages 679 ZTAP-EVT-CMNOTSCRATCH DSM/TC is selecting an alternate tape volume for an output request because the volume name specified in the DEFINE cannot be used. Tokens in Event Message ZTAP-TKN-PROCESS ZTAP-TKN-ERRMSGNUMBER ZEMS-TKN-TEXT ZTAP-TKN-TAPE-VOLUME token-type token-type token-type <1> token-type ZSPI-TYP-CRTPID. ZSPI-TYP-UINT. ZSPI-TYP-STRING. ZTAP-TYP-TAPE-VOLUME.
681 ZTAP-EVT-CMNEEDVOLUME Tape Server Event Messages ZTAP-TKN-ERRMSGNUMBER contains the error message number for this tape server error. The number for this error is 1022. ZTAP-TKN-TAPE-VOLUME contains the name of the tape volume. Cause. The volume name specified in the DEFINE cannot be used. DSM/TC automatically selects an alternate tape volume. Effect. The operation continues automatically. Recovery. If the alternate tape cannot be used, reject the request.
682 ZTAP-EVT-CMWRONGFILESEQ Tape Server Event Messages 682 ZTAP-EVT-CMWRONGFILESEQ The application request failed because the FILESEQ attribute specified in the TAPECATALOG DEFINE for the file identification is incorrect. Tokens in Event Message ZTAP-TKN-PROCESS ZTAP-TKN-ERRMSGNUMBER ZEMS-TKN-TEXT ZTAP-TKN-FILEID token-type token-type token-type <1> token-type ZSPI-TYP-CRTPID. ZSPI-TYP-UINT. ZSPI-TYP-STRING. ZTAP-TYP-FILEID.
684 ZTAP-EVT-SSINOAVR Tape Server Event Messages ZTAP-TKN-ERRMSGNUMBER contains the error message number for this tape server error. The number for this error is 1025. ZTAP-TKN-FILEID contains the file identification name. Cause. An ALTER TAPEMOUNT request was attempted, and no alternate copy is available. Effect. The application continues to request that the original tape volume be mounted. Recovery.
685 ZTAP-EVT-CMCONSOLEWRITE Tape Server Event Messages • The LSM address assigned to the tape drive (using the MEDIACOM/ MEDIASRV ALTER TAPEDRIVE command) is the address of a different tape drive. Effect. The OPEN operation fails, and file-system error 595 is returned. Recovery. Correct the problem with the tape drive and retry the operation. If the problem cannot be corrected, issue a PUP DOWN command to stop the NonStop Kernel system from using the tape drive for automated cartridge system tapes.
686 ZTAP-EVT-LINKDOWN Tape Server Event Messages 686 ZTAP-EVT-LINKDOWN Communications between the tape server and a tape drive failed with a file-system error. Tokens in Event Message ZTAP-TKN-PROCESS ZTAP-TKN-ERRMSGNUMBER ZEMS-TKN-TEXT ZTAP-TKN-DEV-NAME ZTAP-TKN-FSERR token-type token-type token-type <1> token-type <2> token-type ZSPI-TYP-CRTPID. ZSPI-TYP-UINT. ZSPI-TYP-STRING. ZSPI-TYP-DEVICE. ZSPI-TYP-ENUM.
687 ZTAP-EVT-LINKUP Tape Server 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. 687 ZTAP-EVT-LINKUP A connection to a tape drive was reestablished. Tokens in Event Message ZTAP-TKN-PROCESS ZTAP-TKN-STSMSGNUMBER ZEMS-TKN-TEXT ZTAP-TKN-DEV-NAME token-type token-type token-type <1> token-type ZSPI-TYP-CRTPID. ZSPI-TYP-UINT. ZSPI-TYP-STRING.
689 ZTAP-EVT-TPTMUP Tape Server Event Messages ZTAP-TKN-FILEID contains the file identification name. ZTAP-TKN-DEV-NAME contains the name of the tape drive where the tape file was being written. Cause. An application using a tape drive terminated without calling the CLOSE routine. This message occurs only when processing DSM/TC controlled tape volumes. Effect. ABENDRETENTION is used instead of the normal retention. Recovery.
690 ZTAP-EVT-TPTMDOWN Tape Server Event Messages 690 ZTAP-EVT-TPTMDOWN Connection to the third-party tape management system (TPTM) failed. Tokens in Event Message ZTAP-TKN-PROCESS ZTAP-TKN-ERRMSGNUMBER ZEMS-TKN-TEXT ZTAP-TKN-FSERR token-type token-type token-type <1> token-type ZSPI-TYP-CRTPID. ZSPI-TYP-UINT. ZSPI-TYP-STRING. ZSPI-TYP-ENUM. Message Text Error 1030 - Connection to TPTM failed with error <1>. ZTAP-TKN-ERRMSGNUMBER contains the error message number for this tape server error.
692 ZTAP-EVT-TPTMREJECTED Tape Server Event Messages ZTAP-TKN-ERRMSGNUMBER contains the error message number for this tape server error. The number for this error is 1031. Cause. The MEDIADEFS support level value was changed from an option that supports a third-party tape management system (TPTM) to an option that does not support a TPTM. Effect. The MEDIADEFS support level is not set to an option (INTEGRATED, TPTM, or TPTMCOMPATIBLE) that supports a TPTM. Recovery. This is an informative message only.
693 ZTAP-EVT-TPTMREJECTEDLABEL Tape Server Event Messages 693 ZTAP-EVT-TPTMREJECTEDLABEL The third-party tape management system (TPTM) rejected a labeling request with an error. Tokens in Event Message ZTAP-TKN-PROCESS ZTAP-TKN-ERRMSGNUMBER ZEMS-TKN-TEXT ZTAP-TKN-FSERR token-type token-type token-type <1> token-type ZSPI-TYP-CRTPID. ZSPI-TYP-UINT. ZSPI-TYP-STRING. ZSPI-TYP-ENUM. Message Text Error 1033 - TPTM rejected labeling request with error <1>.
695 ZTAP-EVT-MEDIAMISMATCH Tape Server Event Messages ZTAP-TKN-FSERR contains the file-system error number reported in this message. Cause. The third-party tape management system (TPTM) returned an error after processing had already stopped. Effect. The error is logged but ignored. Recovery. Informational message only; no corrective action is needed. 695 ZTAP-EVT-MEDIAMISMATCH The mounted tape volume’s density and mode did not match the requested density and mode.
696 ZTAP-EVT-SSINOTAPE Tape Server Event Messages 696 ZTAP-EVT-SSINOTAPE No tape volume was found in the Automated Cartridge System for this request. Tokens in Event Message ZTAP-TKN-PROCESS ZEMS-TKN-TEXT ZTAP-TKN-ERRMSGNUMBER ZTAP-TKN-DEFINE-NAME token-type ZSPI-TYP-CRTPID. token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-UINT. <1> token-type ZTAP-TYP-DEFINE-NAME.
698 ZTAP-EVT-AUTOSUBSTITUTE Tape Server Event Messages ZTAP-TKN-ERRMSGNUMBER contains the error message number for this tape server error. The number for this error is 1036. ZTAP-TKN-MSGNUM contains the mount sequence number of the ALTER TAPEMOUNT command. ZTAP-TKN-BADNUM contains the error number received from the TMF catalog. Cause. An error was returned from the Transaction Management Facility (TMF) catalog when a MEDIACOM ALTER TAPEMOUNT mount sequence command was attempted.
699 ZTAP-EVT-TAPEINUSE Tape Server Event Messages ZTAP-TKN-DEFINE-NAME contains the define name. ZTAP-TKN-BADNUM contains the error number received from the DSM/TC subsystem. Cause. An error was returned from the TMF catalog while $ZSVR was automatically attempting to find a TMF in the appropriate ACS. errornum contains the error returned from the TMF catalog.
700 ZTAP-EVT-TAKEOVER Tape Server Event Messages ZTAP-TKN-TAPE-VOLUME contains the tape volume name. ZTAP-TKN-DEFINE-NAME contains the define name. ZTAP-TKN-DEV-NAME contains the drive name. ZTAP-TKN-SYSNAME contains the system name. ZTAP-TKN-CPU contains the application’s CPU number. ZTAP-TKN-PIN contains the application’s PIN number. Cause. A tape volume is now being used by the specified process. Effect. None. Recovery. This is an informative message only. No corrective action is needed.
701 ZTAP-EVT-SSIACCESSDENIED Tape Server Event Messages 1 Primary process abnormally ended 2 Primary process' processor failed 3 Primary called CHECKSWITCH Cause. The primary $ZSVR process stopped and the backup $ZSVR process successfully taken over. Effect. The backup $ZSVR process is now the primary $ZSVR process, and it creates a new backup $ZSVR process. Recovery. This is an informative message only. No corrective action is needed.
702 ZTAP-EVT-DOWNREVMDBM Tape Server Event Messages 702 ZTAP-EVT-DOWNREVMDBM The MEDIADBM program version is incompatible with the ZSERVER program version in the same subvolume. Tokens in Event Message ZTAP-TKN-PROCESS ZEMS-TKN-TEXT ZTAP-TKN-ERRMSGNUMBER token-type ZSPI-TYP-CRTPID. token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-UNIT. Message Text ERROR 1039 - LOCAL MEDIADBM VERSION IS INCOMPATIBLE WITH ZSERVER ZTAP-TKN-ERRMSGNUMBER contains the error message number for this tape server error.
704 ZTAP-EVT-ESM-ONLINE Tape Server Event Messages ZTAP-TKN-TAPE-VOLUME contains the substituted tape volume name. ZTAP-TKN-ERRTAPEVOLUME contains the original tape volume name. ZTAP-TKN-DEV-NAME contains the drive name. Cause. $ZSVR matched a request for volser2 to volser1 because volser1 is currently mounted on a tape drive and is an earlier volume in the volume set than the requested file. Effect. The application is about to open the tape drive where volser1 is mounted. Recovery.
705 ZTAP-EVT-MESMOUNT Tape Server Event Messages ZEMS-TKN-TEXT contains the complete ESM tape volume name. Cause. An ESM tape that was not requested is mounted because either: • • The operator mounted the tape before the request was made. The operator mounted the wrong tape. Effect. The tape can be used to satisfy subsequent mount requests. Recovery. Check that the correct tape is mounted and a mount request is issued.
706 ZTAP-EVT-MESMIN Tape Server Event Messages ZTAP-TKN-DEV-NAME if present, contains the tape device name specified in the define. ZTAP-TKN-REEL if present, contains the reel number. Cause. A tape file was opened for output for ESM processing, but the tape was not mounted. Effect. The operation waits for the tape with the requested ESM volser to be mounted (on drive if specified). Recovery.
707 ZTAP-EVT-TPTMWRITEREAD Tape Server Event Messages ZTAP-TKN-DENSITY if present, contains the density value specified in the define. ZTAP-TKN-DEV-NAME if present, contains the tape device name specified in the define. ZTAP-TKN-REEL if present, contains the reel number. Cause. A tape file was opened for input for ESM processing, but the tape was not mounted. Effect. The operation waits for the tape with the requested ESM volser to be mounted (on drive if specified). Recovery.
708 ZTAP-EVT-TPTMTIMEOUT Tape Server Event Messages Recovery. Verify that the TPTM process is running. For descriptions of file-system errors, see the Operator Messages Manual. 708 ZTAP-EVT-TPTMTIMEOUT The third-party tape management system (TPTM) application did not respond to a message before $ZSVR's timer expired. Tokens in Event Message ZTAP-TKN-PROCESS ZEMS-TKN-TEXT ZTAP-TKN-ERRMSGNUMBER ZTAP-TKN-DEV-NAME token-type token-type token-type <1> token-type ZSPI-TYP-CRTPID. ZSPI-TYP-STRING.
713 ZTAP-EVT-SSIDRIVEBUSY Tape Server Event Messages ZTAP-TKN-ERRMSGNUMBER contains the error message number for this tape server error. The number for this error is 1042. Cause. The cause of this error can be one or more of: • • • The MEDIADEFS level is incorrect. The TPTM process is not running. $ZSVR was started after the TPTM process. Effect. The application's request for TPTM services is aborted, and file-system error 751 is returned to the application. Recovery.
Tape Server Event Messages 713 ZTAP-EVT-SSIDRIVEBUSY ZEMS-TKN-ACTION-ID is the $ZSVR internal message number that identifies the request. This token contains a four-digit number ranging from 0000 through 9999. ZTAP-TKN-DEV-NAME is the subject token that specifies the device name. Cause. When DEVICE is specified in DEFINE, during a tape switch, BACKUP may reopen the DEFINE internally before the previous dismount operation is completed. Effect.
Index A ADD POOL command 5-6 ADD TAPEFILE command 5-7 ADD TAPELABEL command 5-8 ADD TAPEVOLUME command 5-9 ALTER CONSOLE command 5-10 ALTER DISKFILE command 5-10 ALTER FILECAT command 5-11 ALTER MEDIADB command 5-12 ALTER MEDIADEFS command 5-12 ALTER POOL command 5-13 ALTER TAPEDRIVE command 5-14 ALTER TAPEFILE command 5-16 ALTER TAPEMOUNT command 5-17 ALTER TAPEVOLUME command 5-18 ALTER VOLCAT command 5-19 Assigning a logical name to a file catalog 5-19 Assigning a logical name to a volume catalog 5-20 Ass
D Index Commands (continued) DELETE POOL 5-21 DELETE TAPEFILE 5-22 DELETE TAPELABEL 5-23 DELETE TAPEVOLUME 5-24 discontinuing 3-8 DROP FILECAT 5-25 DROP VOLCAT 5-26 EXPIRE TAPEFILE 5-27 INFO CONSOLE 5-28 INFO DISKFILE 5-29 INFO FILECAT 5-30 INFO MEDIADEFS 5-31 INFO POOL 5-32 INFO TAPEDRIVE 5-33 INFO TAPEFILE 5-34 INFO TAPELABEL 5-35 INFO TAPEVOLUME 5-36 INFO VOLCAT 5-37 LABEL TAPEVOLUME 5-38 MEDIASRV 5-5/5-42 naming 3-2 RECOVER DISKFILE 5-39 STATUS SERVER 5-40 STATUS TAPEDRIVE 5-41 STATUS TAPEMOUNT 5-42 C
E Index DSM/TC (continued) definition files 3-1 overview 1-1 programmatic interface 1-2 DSM/TC environment definitions, retrieving 5-31 DSM/TC server process, starting a MEDIASRV process 2-1 E Empty responses 3-9 Error handling 3-9 Error lists defined 3-5 structure 3-7 Error messages MEDIADBM A-4/A-29 MEDIASRV command execution A-106/A-127 MEDIASRV SPI CLS A-130/A-134 MEDIASRV startup A-1/A-2 MEDIASRV syntax/content A-29 MEDIASRV/SPI internal A-144/A-149 Tandem tape server process (ZSVR) A-135/A-144 Erro
M Index LOGFILE startup parameter, considerations for specifying 2-7 M Management applications communicating with a MEDIASRV process 2-8 Maps, ZMCS 4-18/4-65 Maximum response token 3-6 MEDIADBM error summary listed by name A-5/A-7 listed by number A-4/A-5 MEDIADBM errors ZMCS-ERRCATALOGNAMEMISMATCH A-22 ZMCS-ERRDENSITYVIOLATION A-17 ZMCS-ERREXPIRATIONTOOOLD A-20 ZMCS-ERREXPIRATIONTOOYOUNG A-19 ZMCS-ERRFILECATALOGEXISTS A-7 ZMCS-ERR-FILECATNOEMPTY A-9 ZMCS-ERRINVALIDFILESEQUENCE A-25 ZMCS-ERR-INVALIDVERSI
M Index MEDIASRV (continued) opening a MEDIASRV process 2-8 starting with PROCESS_CREATE_ procedure 2-4 starting with RUN command 2-2 startup message 2-6 sync depth 2-8, 2-9 MEDIASRV command execution error summary listed by name A-107 listed by number A-106/A-107 MEDIASRV command execution errors ZMCS-ERR-ADDDEFINE A-114 ZMCS-ERRBADRESTORESYNTAX A-124 ZMCS-ERR-BADTAPELABEL A-117 ZMCS-ERR-CATMANAWAITIO A-111 ZMCS-ERR-CATMANOPEN A-111 ZMCS-ERRCATMANWRITEREAD A-109 ZMCS-ERR-CREATEDEFINE A-113 ZMCS-ERR-DELET
M Index MEDIASRV SPI CLS errors ZMCS-ERR-BUFFERNOTMCS A-131 ZMCS-ERREMPTYRESPONSE A-134 ZMCS-ERR-INVALIDCONTEXT A-134 ZMCS-ERRNEEDNEWERSERVER A-132 ZMCS-ERRUNKNOWNCOMMAND A-133 ZMCS-ERRUNKNOWNOBJECT A-133 ZMCS-ERR-UNKNOWNTOKEN A-132 ZMCS-ERRUSEDLENTOOLARGE A-131 MEDIASRV syntax/content error summary listed by name A-34/A-39 listed by number A-29/A-34 MEDIASRV syntax/content errors UNKNOWN-ERRORMESSAGE A-101 ZMCS-ERR-ABENDINVALID A-42 ZMCS-ERR-APPENDINVALID A-44 ZMCS-ERR-APPENDRESET A-45 ZMCS-ERRAUTOMATEDI
M Index MEDIASRV syntax/content errors (continued) ZMCS-ERR-FILEIDRESET A-54 ZMCS-ERRFILEIDSTATUSINVALID A-55 ZMCS-ERR-FILEIDTOOMANY A-55 ZMCS-ERR-FILENAMEINVALID A-55 ZMCS-ERRFILENAMEONLYONE A-56 ZMCS-ERRFILENAMEREQUIRED A-56 ZMCS-ERR-FILENAMERESET A-56 ZMCS-ERRFILENAMETOOMANY A-57 ZMCS-ERRFILESTATUSINVALID A-57 ZMCS-ERRGENERATIONINVALID A-57 ZMCS-ERRGENERATIONREQUIRED A-58 ZMCS-ERRGENERATIONRESET A-58 ZMCS-ERR-INFILEINVALID A-66 ZMCS-ERR-INFILEONLYONE A-66, A-67 ZMCS-ERR-INFILEOPEN A-67 ZMCS-ERR-INFILER
M Index MEDIASRV syntax/content errors (continued) ZMCS-ERR-PROMPTRESET A-94 ZMCS-ERRREPOSITIONINVALID A-102 ZMCS-ERRREPOSITIONRESET A-102 ZMCS-ERRREPOSUNLOADCONFLICT A-103 ZMCS-ERRRESERVEDRIVEINVALID A-53 ZMCS-ERRRESETTIMEINVALID A-74 ZMCS-ERRRETENTIONCONFLICT A-74 ZMCS-ERRRETENTIONINVALID A-75 ZMCS-ERR-RETENTIONRESET A-75 ZMCS-ERRSCRATCHCONFLICT A-76 ZMCS-ERR-SCRATCHINVALID A-76 ZMCS-ERRSEARCHSPACEINVALID A-77 ZMCS-ERRSEARCHSPACERESET A-77 ZMCS-ERR-SECURITYINVALID A-77 ZMCS-ERRSECURITYONLYONE A-78 ZMCS-
N Index MEDIASRV syntax/content errors (continued) ZMCS-ERRTIMESTAMPINVALID A-88 ZMCS-ERRTOOMANYSTRUCTS A-88 ZMCS-ERRUNABLETOBEGINTRANS A-98 ZMCS-ERR-UNLOADINVALID A-89 ZMCS-ERR-UNLOADRESET A-89 ZMCS-ERRUPDATESTATSINVALID A-100 ZMCS-ERRUPDATESTATSRESET A-101 ZMCS-ERR-VERSIONINVALID A-90 ZMCS-ERR-VERSIONRESET A-90 ZMCS-ERR-VOLINDEXINVALID A-96 ZMCS-ERRVOLINDEXMISMATCH A-97 ZMCS-ERR-VOLSETCONFLICT A-91 ZMCS-ERR-VOLSETINVALID A-91 ZMCS-ERR-VOLSETNOTWILD A-98 ZMCS-ERR-VOLSETONLYONE A-98 ZMCS-ERRVOLUMECATALOGI
P Index P Parameter tokens 3-6 Parameters 3-3 Pool attributes, retrieving 5-32 Predefined value names 3-4 PRI process option 2-3 Priority See PRI process option Process options 2-2/2-3 supported by MEDIASRV 2-2 Process priority See PRI process option PROCESS_CREATE_ procedure 2-4 R Receiving response buffers 3-8 RECOVER DISKFILE command 5-39 Recovering disk files 5-39 Relabeling a tape 5-8 Removing file catalogs from the system 5-25 Removing volume catalogs from the system 5-26 Replies containing context
T Index Startup message (continued) structure 2-6 STATUS SERVER command 5-40 STATUS TAPEDRIVE command 5-41 STATUS TAPEMOUNT command 5-42 Stopping a MEDIASRV process See also AUTOSTOP startup parameter methods 2-9 SWAP process option 2-3 Swap volume See SWAP process option T Tandem tape server errors ZMCS-ERR-ZSVR A-140 ZMCS-ERRZSVRACCEPTINVALID A-137 ZMCS-ERR-ZSVRACTIVE A-138 ZMCS-ERRZSVRALTERINVALID A-137 ZMCS-ERRZSVRAUTOMATEDINVALID A-143, A-144 ZMCS-ERRZSVRCOMPRESSINVALID A-143 ZMCS-ERRZSVRCONSOLEINUS
Z Index ZMCS (continued) data structures 4-18/4-65 errors A-4/A-149 fundamental data structures 4-1/4-3 maps 4-18/4-65 miscellaneous values 4-67/4-72 object types 4-67 token numbers 4-4/4-6 token types 4-3 tokens 4-6/4-18 ZMCS data structures ZMCS-DDL-ADD-POOL 4-19 ZMCS-DDL-ADD-TAPEFILE 4-21 ZMCS-DDL-ADD-TAPELABEL 4-23 ZMCS-DDL-ADD-TAPEVOLUME 4-25 ZMCS-DDL-ALTER-DISKFILE 4-27 ZMCS-DDL-ALTERMEDIACATALOG 4-28 ZMCS-DDL-ALTER-POOL 4-31 ZMCS-DDL-ALTER-TAPEDRIVE 4-33 ZMCS-DDL-ALTER-TAPEFILE 4-34 ZMCS-DDL-ALTER-
Z Index ZMCS miscellaneous values buffer length 4-72 enumerated type 4-68 NULL 4-67, 4-72 product version 4-68 reset 4-72 wild-card 4-72 ZMCS tokens ZMCS-TKN-AVRSYSTEM 4-6 ZMCS-TKNCATALOGSUBVOLUME 4-7 ZMCS-TKN-COMMENT 4-7 ZMCS-TKN-COUNT 4-7 ZMCS-TKN-DEFINENAME 4-7 ZMCS-TKN-DISKFILENAME 4-8 ZMCS-TKN-ERRORNUM 4-8 ZMCS-TKN-ERRORTYPE 4-8 ZMCS-TKN-FILECATALOG 4-9 ZMCS-TKN-HOMETERMINAL 4-9 ZMCS-TKN-INFILE 4-9 ZMCS-TKN-INFILE2 4-9 ZMCS-TKN-LSMADDRESS 4-10 ZMCS-TKNLSMTAPEDRVPRESENT 4-10 ZMCS-TKN-MAXFIELDVERSION 4
Z Index ZRPC events (continued) ZRPC-EVT-PMAP-STARTED B-4 ZRPC-EVT-PORTMAP-ERR B-30 ZRPC-EVT-PROG-ERR B-20 ZRPC-EVT-RPC-ERR B-11 ZRPC-EVT-SLR-ERR B-9 ZRPC-EVT-UNEXP-IO-CMPL B-22 ZRPC-EVT-UNEXP-SYS-MSG B-27 ZRPC-EVT-UNKWN-MSG-SRC B-25 ZRPC message handling B-1 ZSPI error numbers 4-66 ZSPI qualifier, on MEDIASRV open 2-8 ZSPI-ERR-EMPTYRESPONSE 3-9 ZSPI-TKNCOMMAND 3-2 CONTEXT 3-6 MAXRESP 3-6, 3-8 OBJECT-TYPE 3-3 RETCODE in response buffer 3-7 indicating successful completion 3-9 non-zero values for 3-9 ZSPI-
Z Index ZSSI event 4 values (continued) ZSSI-VAL-MSG-Q-CREATE-FAIL C-45 ZSSI-VAL-MSG-SEND-NI-FAIL C-38 ZSSI-VAL-MSG-SYSTEM-ERR C-45 ZSSI-VAL-MSG-TCPCLNTCREATE C-46 ZSSI-VAL-MSG-TCP-CREATEFAIL C-40 ZSSI-VAL-MSG-TCP-REG-FAIL C-40 ZSSI-VAL-MSG-UNDEF-HOST C-47 ZSSI-VAL-MSG-UNEXPECTSTAT C-48 ZSSI-VAL-MSG-UNEXP-FAIL C-47 ZSSI-VAL-MSG-XDR-XLATEFAIL C-48 ZSSI event 4 variations, ZSSI-EVT-FATALFAULT C-35/C-49 ZSSI event 5, ZSSI-EVT-DEACTIVATING C-50 ZSSI event 6, ZSSI-EVT-NOTAVAILABLE C-50 ZSSI event 7, ZSSI-EVT-I
Special Characters Index ZTAP events (continued) ZTAP-EVT-EVTSSIWRONGTYPE D-10 ZTAP-EVT-EVTTAPEFILEABEND D-20 ZTAP-EVT-EVT-TPTMDOWN D-22 ZTAP-EVT-EVTTPTMREJECTED D-23 ZTAP-EVT-EVTTPTMREJECTEDLABEL D-24 ZTAP-EVT-EVT-TPTMSEVERED D-22 ZTAP-EVT-EVT-TPTMUP D-21 ZTAP token types D-1 Special Characters -CMD- 3-2 -OBJ- 3-3 -TKN- 3-3 -TYP- 3-4 -VAL- 3-4 DSM/Tape Catalog Management Programming Manual—520481-003 Index -16
