Page 1 This manual describes the command syntax and error messages for the File Utility Program (FUP). Product Version T6553 D45, G08, H01, and H02. Supported Release Version Updates (RVUs) This publication supports J06.14 and all subsequent J-series RVUs, H06.25 and all subsequent H-series RVUs, G06.23 and all subsequent G-series RVUs, and D46.00...
Page 2 FUP D45, G08, and H01 July 2006 523323-010 FUP D45, G08, and H01 November 2006 523323-012 FUP D45, G08, and H01 October 2009 523323-013 FUP D45, G08, and H01 February 2011 523323-014 T6553 D45, G08, H01, and H02 August 2012...
Page 3: Legal Notices
Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.
Page 5: Table Of Contents
File Utility Program (FUP) Reference Manual Glossary Index Examples Tables Legal Notices What’s New in This Manual Manual Information New and Changed Information About This Manual xiii Organization of This Manual xiii Additional Information Notation Conventions 1. FUP Overview Starting a FUP Process At the TACL Prompt Interactively From a Command File...
Page 6 Contents 1. FUP Overview (continued) 1. FUP Overview (continued) Partitioning Files 1-20 Examples of Partitioning Files 1-20 Using DEFINEs With FUP 1-21 SPOOL DEFINEs 1-21 MAP DEFINEs 1-22 TAPE DEFINEs 1-22 Handling Different Types of Files 1-22 Handling File Formats 1-22 Moving Format 1 File Contents to Format 2 1-23...
Page 7 Contents 2. FUP Commands (continued) 2. FUP Commands (continued) Commands Related to BUILDKEYRECORDS 2-23 CHECKSUM 2-24 CHECKSUM Guidelines 2-24 CHECKSUM Examples 2-25 CONFIG[URE] 2-26 CONFIG[URE] Guidelines 2-31 CONFIG[URE] Examples 2-33 Commands Related to CONFIG[URE] 2-35 COPY: Copy Form 2-36 COPY: Copy Form Guidelines 2-51 COPY: Copy Form Examples 2-53...
Page 8 Contents 2. FUP Commands (continued) 2. FUP Commands (continued) Commands Related to FILENAMES 2-74 FILES 2-75 FILES Guidelines 2-76 FILES Examples 2-76 Commands Related to FILES 2-76 GIVE 2-77 GIVE Guidelines 2-77 GIVE Examples 2-78 HELP 2-79 HELP Examples 2-79 HISTORY 2-80 HISTORY Guidelines...
Page 9 Contents 2. FUP Commands (continued) 2. FUP Commands (continued) LOAD Guidelines 2-134 LOAD Examples 2-136 Commands Related to LOAD 2-137 LOADALTFILE 2-137 LOADALTFILE Guidelines 2-138 LOADALTFILE Example 2-139 Commands Related to LOADALTFILE 2-139 OBEY 2-139 OBEY Guidelines 2-139 OBEY Example 2-140 PURGE 2-140...
Page 10 Contents 2. FUP Commands (continued) 2. FUP Commands (continued) REVOKE (Super ID) Guidelines 2-161 REVOKE (Super ID) Examples 2-161 Commands Related to REVOKE (Super ID) 2-161 SECURE 2-162 SECURE Guidelines 2-164 SECURE Examples 2-165 Commands Related to SECURE 2-165 2-166 SET Parameters for All File Types 2-167 SET Parameters for All Structured Files...
Page 11 Contents 2. FUP Commands (continued) 2. FUP Commands (continued) TRUST Examples 2-192 VOLS 2-193 VOLS Example 2-193 VOLUME 2-193 VOLUME Guidelines 2-194 VOLUME Examples 2-194 Commands Related to VOLUME 2-195 3. FUP Messages A. DEFINE Tables B. FUP Command Summary C.
Page 12 Contents Tables (continued) Tables (continued) Table 2-3. Extent-Size Rounding 2-179 Table A-1. How FUP Input Options Work With TAPE DEFINEs Table A-2. How FUP Output Options Work With TAPE DEFINEs Table B-1. FUP Control Commands Table B-2. FUP Informational Commands Table B-3.
Page 13: What's New In This Manual
This manual describes the command syntax and error messages for the File Utility Program (FUP). Product Version T6553 D45, G08, H01, and H02. Supported Release Version Updates (RVUs) This publication supports J06.14 and all subsequent J-series RVUs, H06.25 and all subsequent H-series RVUs, G06.23 and all subsequent G-series RVUs, and D46.00...
Page 14 What’s New in This Manual New and Changed Information  Updated the section DUP[LICATE] General Guidelines on page 2-70.  Updated the section GIVE Guidelines on page 2-78.  Updated the section RELOAD Guidelines on page 2-152.  Updated the syntax for RESET on page 2-158.
Page 15 What’s New in This Manual Changes to the H06.08 Manual  Added the COMPACT option to the RELOAD command on page 2-152.  Updated the syntax for SET command for Key sequences files on page 2-171.  Added the option LOCKLENGTH to SET Parameters for Key-Sequenced Files on page 2-177.
Page 16 What’s New in This Manual Changes to the G06.29 Manual Changes to the G06.29 Manual  Added a new note on page 2-89 about the appearance of plus sign (+) when an OSS file is protected by POSIX access control list (ACL) . ...
Page 17 What’s New in This Manual Changes to the H06.05 Manual  LISTOPENS command on page  RELOAD command on page File Utility Program (FUP) Reference Manual—523323-014 xiii...
Page 18 What’s New in This Manual Changes to the H06.05 Manual File Utility Program (FUP) Reference Manual—523323-014...
Page 19: About This Manual
This manual will help you manage disk files, nondisk devices (printers, terminals, and tape drives), and processes (programs) running on an HP NonStop™ server. As a reader of this manual, you should be familiar with the Guardian file-system terminology.
Page 20: Additional Information
About This Manual Additional Information Additional Information For more information about FUP and its associated components, see: Manual Description 5200 Optical Storage Facility Describes the FUP commands that require special (OSF) Reference Manual considerations when used with the 5200 OSF (for D- series RVUs only) Enscribe Programmer’s Guide Provides descriptions of structured disk files and the file...
Page 21 About This Manual General Syntax Notation UPPERCASE LETTERS. Uppercase letters indicate keywords and reserved words. Type these items exactly as shown. Items not enclosed in brackets are required. For example: MAXATTACH lowercase italic letters. Lowercase italic letters indicate variable items that you supply. Items not enclosed in brackets are required.
Page 22: Notation For Messages
About This Manual Notation for Messages … Ellipsis. An ellipsis immediately following a pair of brackets or braces indicates that you can repeat the enclosed sequence of syntax items any number of times. For example: … M address [ , new-value ] …...
Page 23 About This Manual Notation for Messages Nonitalic text. Nonitalic letters, numbers, and punctuation indicate text that is displayed or returned exactly as shown. For example: Backup Up. lowercase italic letters. Lowercase italic letters indicate variable items whose values are displayed or returned. For example: p-register process-name [ ] Brackets.
Page 24: Notation For Management Programming Interfaces
About This Manual Notation for Management Programming Interfaces Notation for Management Programming Interfaces This list summarizes the notation conventions used in the boxed descriptions of programmatic commands, event messages, and error lists in this manual. UPPERCASE LETTERS. Uppercase letters indicate names from definition files. Type these names exactly as shown.
Page 25: Fup Overview
FUP supports these types of Enscribe disk files:  Key sequenced  Entry sequenced  Relative  Unstructured (including text files) FUP provides information about these types of HP NonStop Open System Services (OSS), SQL/MX, and SQL/MP files:  Tables  Indexes  Partitions ...
Page 26: Starting A Fup Process
Handling Different Types of Files 1-22 Starting a FUP Process Access to FUP is available through the HP Tandem Advanced Command Language (TACL), the standard command interface in the Guardian environment. To start a FUP process, use any of these methods: ...
Page 27: Interactively
FUP Overview Interactively Interactively Entering FUP commands within FUP (interactively) saves time if you are going to enter a series of commands. Type the term FUP (without any commands or options) at the TACL prompt, and press the RETURN key to start an interactive FUP process: 1>...
Page 28: Run Options
FUP Overview Run Options Run Options The TACL environment includes a set of predefined commands—including the TACL RUN command. You must use a run option when you start a FUP process with a command file. The two run options that FUP uses most often are IN (for specifying an input file) and OUT (for an output file).
Page 29: Fup Custom File Example
FUP Overview FUP Custom File Example  By default, FUP does not echo the commands for either file. To start echoing, specify CONFIGURE ECHO OBEY in either file.  If there are no existing custom files when FUP begins, default custom files are automatically created for your security.
Page 30: Fup Overview (Continued)
FUP Overview Entering a FUP Command run-options are any of the available options for the TACL RUN command. They must be separated from each other by commas, and enclosed on the command line with slashes (/). Although each option is available when you run FUP from the TACL prompt, only one (the OUT run option) is also available within FUP.
Page 31: Fup Command Guideline
FUP Overview FUP Command Guideline If you type FUP without command, you must terminate the FUP process using the EXIT command after you finish your FUP activity. FUP Command Guideline If you enter conflicting options, FUP scans the options and uses the last one entered: DUP A, B, OLD, NEW, SOURCEDATE, SAVEID The FUP process uses the NEW option (not the OLD option) and the SAVEID option (not the SOURCEDATE option).
Page 32: Specifying Files
FUP Overview Specifying Files Specifying Files FUP commands make it easy to:  Create, display, and duplicate files  Load data into files  Alter file characteristics  Purge files Before you use FUP to create or manage files, become familiar with the various file types and the methods used to specify them.
Page 33: Fileset-List Parameter
FUP Overview Fileset-list Parameter If a list file does not exist, FUP creates it as an EDIT file with a maximum record length of 132 characters. If a list file does exist, FUP appends output to it. If the list file is an unstructured disk file, each of its records is 132 characters long, and any partial lines are blank-filled to column 132.
Page 34: Wild-Card Option
FUP Overview Wild-Card Option node is the name of a node in an Expand network. If you omit node, FUP uses the current default node: either the node that was in effect when you started FUP or the node you specified during the last FUP SYSTEM or VOLUME command. volume is the name of a volume (disk drive).
Page 35: Qualified File Sets
FUP Overview Qualified File Sets  You cannot use more than eight characters (including wild-card characters) in any portion of the file name (volume, subvolume, or file identifier).  The only valid use of the wild-card option in a destination file-set specification is a single asterisk (*) in the subvolume or file ID position.
Page 36 FUP Overview Qualified File Sets The form for qualified-expr is: qualifier [ ,qualifier ] ... qualifier is: EXCLUDE fileset FROM CATALOG[S] catalog-list START file-id WHERE expression catalog-list is: [ \node.]$volume [.subvol ] | subvol expression is: ( expression ) expression AND expression expression OR expression NOT expression file-attribute...
Page 37 FUP Overview Qualified File Sets file-attribute is: ALTKEY AUDITED BROKEN COLLATION CORRUPT CRASHOPEN ENSCRIBE ENTRYSEQUENCED FORMAT1|FORMAT2 INDEX [ SHORTHAND | PROTECTION ] VIEW KEYSEQUENCED LICENSED OPEN PROGID RELATIVE [ PRIMARY | SECONDARY ] PARTITION ROLLFORWARDNEEDED SAFEGUARD SQLPROGRAM TABLE UNSTRUCTURED user-id is: group-name.user-name group-name.* group-number, user-number...
Page 38 FUP Overview Qualified File Sets time-value is: [ date ] time [ time ] date time is: hh:mm[:ss] date is: dd mmm yyyy mmm dd yyyy qualifier is qualifying criteria that you can specify to include files or objects in a file set. You can specify qualifiers in any order, but use each qualifier only once per file-set list.
Page 39 Qualified File Sets ALTKEY adds, replaces, or alters an alternate-key specification. AUDITED specifies files that are audited by the HP NonStop Transaction Management Facility (TMF). BROKEN specifies files that are broken. The file needs media recovery because an I/O or consistency check failure occurred the last time it was open. A good example of its use is: WHERE NOT BROKEN.
Page 40 PROGID flag set. RELATIVE specifies relative files. ROLLFORWARDNEEDED specifies any files that need an HP Transaction Management Facility (TMF) rollforward process. A good example is: WHERE NOT ROLLFORWARDNEEDED. SAFEGUARD specifies files protected by Safeguard at the file level.
Page 41 FUP Overview Qualified File Sets UNSTRUCTURED specifies unstructured disk files. [ SHORTHAND | PROTECTION ] VIEW specifies the shorthand SQL views, the protection SQL views, or all the SQL views (if neither shorthand nor protection are specified). OWNER = user-id specifies user identification for the form specified.
Page 42 FUP Overview Qualified File Sets hh:mm[:ss] hh is the hour. mm is the minutes. ss is the seconds. date is: dd mmm yyyy mmm dd yyyy mmm is always the first three characters in the name of the month. yyyy must be four digits for the year. Valid examples are: 1 JAN 2001 06:30 JAN 1 2001 06:30 6:30 1 JAN 2001...
Page 43: Creating Files
FUP Overview Creating Files Note. Qualifiers appear immediately after the file set they are qualifying. This does not have to be the end of the FUP command. Qualified File Set Examples  To obtain information about all EDIT files that begin with the letter S: INFO S* WHERE FILECODE=101 ...
Page 44: Partitioning Files
FUP Overview Partitioning Files -SET TYPE K -SET CODE 1001 -SET EXT (32,8) -SET REC 54 -SET BLOCK 4096 -SET KEYLEN 2 -SET ALTKEY ("LO", KEYOFF 42, KEYLEN 4) -SET ALTKEY ("VN", KEYOFF 46, KEYLEN 8) -SET ALTFILE (0,invalt) -SET PART (1, $ade001,5,5) -CREATE INV CREATED- $STORE1.SVOL1.INV CREATED- $STORE1.SVOL1.INVALT...
Page 45: Using Defines With Fup
FUP Overview Using DEFINEs With FUP Related Commands COMMAND Function CREATE Creates a file using the current file-creation parameter values that have been defined with a SET command PURGE Deletes a file LOADALTFILE Creates an alternate-key file from a primary file LISTOPENS Lists all processes that now have one or more designated files open Using DEFINEs With FUP...
Page 46: Map Defines
FUP Overview MAP DEFINEs MAP DEFINEs You can specify a MAP DEFINE wherever FUP permits a file name. It is sometimes easier to use a DEFINE name such as =CUSTOMERS than an actual file name such as \SF.$ACCNTS.CURRNT.CUSTNMES. MAP DEFINEs Example DUP cereal,=MY_DEFINE INFO =MY_DEFINE TAPE DEFINEs...
Page 47: Moving Format 1 File Contents To Format 2
FUP Overview Moving Format 1 File Contents to Format 2 Table 1-1. File Format Codes Format Maximum Block Maximum Record Size (in Maximum Partition Size Code Size (in Bytes) Bytes) (in Bytes) 4096 Determined by system Determined by system 4096 Block size - 34 (key sequenced) 2 GB - 1 KB Block size - 24 (relative and...
Page 48: Handling Oss Files
FUP Overview Handling OSS Files You likely need to change existing applications to access Format 2 files over 4 GB in size that are not key-sequenced. These files require the use of a 64-bit primary key, and system interfaces preceding G06.00 or D46.00 support only 32-bit primary keys. Applications are unlikely to require any changes to access key-sequenced Format 2 files.
Page 49: Table 1-2. Fup Commands And Sql/Mp Files
FUP Overview Handling SQL/MP Files Table 1-2 shows the FUP commands that do not apply to all the different types of SQL/MP files and lists any alternative methods for manipulating the files. Table 1-2. FUP Commands and SQL/MP Files (page 1 of 2) Applicable to SQL/MP File Type SQLCI FUP Command...
Page 50 FUP Overview Handling SQL/MP Files Table 1-2. FUP Commands and SQL/MP Files (page 2 of 2) Applicable to SQL/MP File Type SQLCI FUP Command Table View Index Partition Catalog Equivalent RENAME REVOKE SECURE ALTER command SECURE utility SUBVOLS 1 = Yes for protection views; No for shorthand views SQL/MP File Guidelines ...
Page 51: Handling Sql/Mx Files
FUP Overview Handling SQL/MX Files indexes that depend on the table are loaded automatically. No SQL/MP commands load indexes directly.  For compatibility with the FUP PURGE command, substitute the keyword PURGE for DROP in the SQL/MP DROP utility. Handling SQL/MX Files SQL/MX is a relational database management system that promotes efficient online access to large distributed databases.
Page 52: Handling Smf Files
FUP Overview Handling SMF Files SQL/MX File Guidelines  Although you can use FUP commands to provide information about SQL/MX files, the commands cannot manipulate or duplicate the SQL/MX files.  To display information for SQL/MX files, use the FUP FILES, FILENAMES, INFO, LISTOPENS, and SUBVOLS commands.
Page 53 FUP Commands This section describes each FUP command, including:  A summary of the command function  The command syntax, including its parameters and variables  The format of the command output (if applicable)  Guidelines for using the command ...
Page 54 FUP Commands FUP Command Description Page (page 2 of 3) DISPLAYBITS Lets COPY, INFO, and SHOW display 8-bit 2-63 characters DUP[LICATE] Copies Enscribe disk files 2-64 EXIT Stops FUP and returns you to the 2-72 command interpreter Lets you modify and reexecute an existing 2-73 command FILENAMES...
Page 55 FUP Commands FUP Command Description Page (page 3 of 3) RESET Restores file-creation attributes to the 2-158 default settings RESTART Restarts a RESTARTABLE DUP operation 2-160 REVOKE (Super ID) Revokes a license for a privileged program 2-163 file or resets security attributes of files and programs SECURE Sets or changes the security attributes of a...
Page 56: Guidelines
FUP Commands Executes an existing command again. ! [ -num | num | string | "quoted" ] -num executes a command that appears before the current command. For example, use !-3 to execute the third command prior to the current one. is the number of a command line.
Page 57: Commands Related To
FUP Commands Commands Related to ! Commands Related to ! COMMAND Function Page HISTORY Displays previous FUP commands 2-81 Modifies a previous command 2-73 Displays a previous FUP command Displays a specific command. ? [ -num | num | string | "quoted" ] -num displays a command that appears before the current command.
Page 58: Commands Related To
FUP Commands Commands Related to ? Commands Related to ? COMMAND Function Page HISTORY Displays previous FUP commands 2-81 Modifies a previous FUP command 2-73 Reexecutes a previous FUP command ALLOCATE Allocates file extents for a disk file. This command applies only to Enscribe files. ALLOCATE fileset-list , num-extents [ , PARTONLY ] fileset-list is a list of disk files for which extents are to be allocated.
Page 59: Allocate Examples
FUP Commands ALLOCATE Examples For nonpartitioned files and partitioned files that are not key sequenced, it is the total number of extents to be allocated to the file. An example is trying to allocate 12 additional extents to a nonpartitioned file that already has four extents allocated and trying to allocate 12 additional extents for the primary partition of a key-sequenced file that already has four extents allocated.
Page 60: Commands Related To Allocate
FUP Commands Commands Related to ALLOCATE EOF 0 (0.0 % USED) FILE LABEL: 214 (5.2 % USED) EXTENTS ALLOCATED: 0 This display indicates it is a DP2 file because:  The listing includes the MAXEXTENTS, BUFFERSIZE, CREATION DATE, and LAST OPEN attributes. ...
Page 61: Allow
FUP Commands ALLOW ALLOW Sets the number of errors and warnings that FUP allows before it stops executing FUP commands. If this number is exceeded, the current FUP command is aborted. If you reach the error or warning limit while entering FUP commands interactively, FUP terminates the current command, displays a warning message, displays its hyphen prompt, and continues to accept commands.
Page 62: Alter Parameters For All File Types
FUP Commands ALTER Parameters for All File Types For files with alternate-key fields: ALTFILE ( key-file-number , filename ) ALTKEY ( key-specifier { , altkey-param }... ) DELALTFILE key-file-number DELALTKEY key-specifier For partitioned files: PART ( sec-partition-num , [ \node.]$volume [ , pri-extent-size [ , sec-extent-size ]] ) PARTONLY For unstructured files:...
Page 63 FUP Commands ALTER Parameters for All File Types CODE file-code alters the file code. Specify file-code as an integer from 0 through 65,535. The default file-code is zero. File codes 100 through 999 are reserved for use by Note. For a list of reserved file codes, see Table 2-2, System File Code Definitions, page 2-90.
Page 64 FUP Commands ALTER Parameters for All File Types NOPURGEUNTIL [ timestamp ] lets you change the expiration date of a file. timestamp is: [ date ] [ , ] [ time ] where date is specified as: { dd mmm yyyy | mmm dd yyyy } where dd (day) is an integer from 1 through 31, and mmm (month) is one of: JAN, FEB, MAR, APR, MAY, JUN,...
Page 65: Alter Parameters For Files With Alternate-Key Fields
FUP Commands ALTER Parameters for Files With Alternate-Key Fields [ NO ] SERIALWRITES sets the mode of writes to the mirror: serial or parallel. The default is NO SERIALWRITES. [ NO ] VERIFIEDWRITES sets the mode of file writes: verified or unverified. The default is NO VERIFIEDWRITES.
Page 66 FUP Commands ALTER Parameters for Files With Alternate-Key Fields You can use any characters for key-specifier except zero. If you omit c1, then c1 is treated as a zero. Note. If you add a new key specifier that references an undefined key-file number, you must include the ALTFILE option to define the alternate-key file.
Page 67: Alter Parameters For Partitioned Files
FUP Commands ALTER Parameters for Partitioned Files [ NO ] UNIQUE specifies whether to set key-specifier as a unique key. The default is NO UNIQUE. [ NO ] UPDATE specifies whether to set automatic updating for the alternate-key file represented by key-specifier. The NO UPDATE option prevents the file system from automatically updating the specified alternate-key file when you write to the main file.
Page 68 FUP Commands ALTER Parameters for Partitioned Files PART ( sec-partition-num , [\node.]$volume [ , pri-extent-size [ , sec-extent-size ] ] ) PART alters secondary partition specifications for partitioned files. You can specify extent sizes if you are adding a new partition or if you are altering an existing partition of a key-sequenced file.
Page 69 FUP Commands ALTER Parameters for Partitioned Files extent-size for all partitions and the same sec-extent-size for all partitions. You can specify these values for pri-extent-size and sec-extent-size: 0:maximum [ PAGE[S] ] specifies the extent size in pages (2,048-byte units). Possible values are: Format 1 Format 2 0:65,535 [ PAGE[S] ]...
Page 70: Alter Parameter For Unstructured Files
FUP Commands ALTER Parameter for Unstructured Files PARTONLY specifies that any changes you make with the ALTER command apply only to the indicated file partition. If you reference a primary partition name, the extents are altered only in the primary partition. ALTER Parameter for Unstructured Files These alter-option parameters are available for unstructured files: BUFFERSIZE unstructured-buffer-size...
Page 71 FUP Commands ALTER Guidelines  If you use the AUDIT option and the volume containing the primary file, or any of its secondary partitions or alternate-key files containing at least one automatically updated alternate key, is not audited, the request fails. You receive file-system error 80 (invalid operation on audited file or nonaudited disk volume).
Page 72: Alter Examples
FUP Commands ALTER Examples  All partitions of a file are created with the same format version. For files that are not key-sequenced, a partition created independently must have the same format as all other partitions of the file. Caution. If you use the ALTER command to change a partition to a different format from the rest of the partitions, the file system reports errors.
Page 73: Buildkeyrecords
FUP Commands BUILDKEYRECORDS BUILDKEYRECORDS Generates the alternate-key records for specified key fields of a structured disk file and writes those records to a designated file. This command applies only to Enscribe files. Although the output of BUILDKEYRECORDS can be the actual destination alternate- key file, it is more efficient to use a LOADALTFILE command to load alternate-keys.
Page 74: Buildkeyrecords Guidelines
FUP Commands BUILDKEYRECORDS Guidelines If out-filename (the destination file) contains existing data, it is never overwritten during a BUILDKEYRECORDS operation. key-specifier-list names one or more alternate-key fields of the primary file whose corresponding alternate-key records are to be generated. key-specifier is a 2-byte value that identifies the alternate-key field.
Page 75: Buildkeyrecords Example
FUP Commands BUILDKEYRECORDS Example  BUILDKEYRECORDS honors any NULL specification defined for a key field. Alternate-key records are not generated for any fields that consist only of a null character.  BUILDKEYRECORDS ignores NO UPDATE specifications.  BUILDKEYRECORDS ignores UNIQUE specifications. Duplicate unique-key values are detected when the LOADALTFILE command loads the alternate-key file.
Page 76: Checksum
FUP Commands CHECKSUM CHECKSUM Recomputes the checksum value for blocks of data in disk files. Use this command when recovering from a software-detected checksum error. CHECKSUM fileset-list [ , PARTONLY ] fileset-list is a list of files whose checksum values are to be recomputed. fileset-list can include Enscribe files (structured or unstructured) and SQL files.
Page 77: Checksum Examples
FUP Commands CHECKSUM Examples CHECKSUM Examples  To recompute checksum values for all the files on volume $TEST1 (except secondary partitions of partitioned files): -CHECKSUM $TEST1.*.* If partitioned files exist on $TEST1, FUP skips the secondary partitions because the wild-card character (*) is specified for the files in fileset-list, and the PARTONLY option is not included in the command.
Page 78: Config[Ure]
FUP Commands CONFIG[URE] CONFIG[URE] Customizes your FUP configuration information. You can use the CONFIG abbreviation for this command. The COPY, DUP[LICATE], LOAD, LOADALTFILE, and RELOAD configuration commands modify the defaults of their corresponding FUP commands. These modified defaults become applicable when the corresponding command is executed.
Page 79 FUP Commands CONFIG[URE] DUP[LICATE] dup-option [, dup-option ]... specifies any of the DUP[LICATE] options (except SOURCE or TARGET file names); for example, PURGE, SOURCEDATE. By default, no DUP[LICATE] options are configured. For more information, see DUP[LICATE] on page 2-64. LOAD load-option [, load-option ]... specifies any LOAD option (except SOURCE or TARGET file names);...
Page 80: Table 2-1. Response To Allow Abends On Or Off
FUP Commands CONFIG[URE] num SEVERE ERRORS sets both the severe and nonsevere error counts to num. num WARNINGS sets the number of warnings that FUP allows while executing FUP commands. ABENDS [ ON | OFF ] specifies whether FUP should terminate abnormally (ABEND) when it encounters an error and the allowed count for the error was exceeded.
Page 81 FUP Commands CONFIG[URE] Table 2-1. Response to ALLOW ABENDS ON or OFF Type of Error ALLOW ABENDS OFF ALLOW ABENDS ON Severe error Severe error allow count is Severe error allow count is decremented. decremented. If allow count > 0, FUP continues If allow count >...
Page 82 FUP Commands CONFIG[URE] [ NO ] DISPLAYALLNUM specifies the way you want to display the key values. If DISPLAYALLNUM is not configured, the key values are displayed as characters if they are all printable, else they are displayed as a mixture of characters and numbers if there is any non-printable character.
Page 83: Config[Ure] Guidelines
FUP Commands CONFIG[URE] Guidelines the interval is 30 seconds for disk transfers and 10 seconds for optical transfers. The time you specify must be a positive number; 0 specifies the FUP defaults. Because each update to the RESTART file requires a synchronized update to the TARGET file, smaller values can slow down a DUP[LICATE] process.
Page 84 FUP Commands CONFIG[URE] Guidelines save configuration values, use the SHOW command. You can set configuration values from the FUPCSTM or FUPLOCL files or from a file with an OBEY command.  FUP uses the current configuration options wherever applicable. You can set or change the configuration options in the FUPLOCL file or the FUPCSTM file or do so interactively with the CONFIGURE or RESET commands.
Page 85: Config[Ure] Examples
FUP Commands CONFIG[URE] Examples than %177. When bitcount is 8, COPY displays the character for any byte with an octal value of %40 or greater.  When bitcount is 7, the ALTKEY key specifier of INFO, DETAIL, and SHOW displays for any character with an octal value greater than %177. When bitcount is 8, the ALTKEY key specifier is displayed for all characters with an octal value greater than %40.
Page 86 FUP Commands CONFIG[URE] Examples  To explicitly override a configured option: -CONFIGURE DUP PURGE, SAVEID -DUP A, B, SOURCEDATE The SOURCEDATE option in the DUP[LICATE] command overrides the configured SAVEID option.  To display and reset CONFIGURE options: -RESET CONFIGURE DUP -SHOW CONFIGURE DUP -CONFIGURE DUP PURGE, SAVEID -SHOW CONFIGURE DUP...
Page 87: Commands Related To Config[Ure]
FUP Commands Commands Related to CONFIG[URE]  To change the number of columns to 80: -CONFIGURE REPORTWIDTH 80  To declare a translation table name (my_encrypt) that is contained in the MYCRYPT.ENCRYPT file: -CONFIGURE XLATE my_encrypt TEXT IN mycrypt.encrypt The MYCRYPT.ENCRYPT file is expected to contain two translation tables (256 bytes each) in one record.
Page 88: Copy: Copy Form
FUP Commands COPY: Copy Form COPY: Copy Form Makes a record-by-record copy from one file to another (the Copy Form of the COPY command) or displays the contents of a file (the Display Form). The COPY command functions apply to Enscribe files and SPOOLER files (code 129). Note.
Page 89 FUP Commands COPY: Copy Form in-option is: BLOCKIN in-block-length [ NO ] COMPACT EBCDICIN RECIN in-record-length REELS num-reels [ NO ] REWINDIN SHARE SKIPIN num-eofs TRIM [ trim-character ] [ NO ] UNLOADIN VARIN out-option is: BLOCKOUT out-block-length DENSITYOUT density EBCDICOUT FOLD PAD [ pad-character ]...
Page 90 FUP Commands COPY: Copy Form out-filename is the name of the file that is the destination of the copy. This file can be a nondisk device, a process, an existing disk file, or a tape or spool DEFINE name. The file can also be any type of file that FUP handles, including structured files, EDIT files, or SPOOLER (file code 129) files.
Page 91 FUP Commands COPY: Copy Form KEY { record-spec | key-value } specifies the primary-key value for the starting record of a disk file. FUP begins reading the input file at the record you name with KEY. Specify record-spec as an integer in the range 0 through 4,294,967,295. ...
Page 92 FUP Commands COPY: Copy Form [ NO ] TITLE directs FUP to write a title line that includes the name of the file, the time of the COPY process, and the last modification time of the file. The title line is the first line of the OUT file, followed by a blank line.
Page 93 FUP Commands COPY: Copy Form If BLOCKLEN does not match BLOCKIN, this error message appears: ERROR - TAPE DEFINE VALUE FOR BLOCKLEN CONFLICTS WITH BLOCKIN The value of in-block-length is set to the BLOCKLEN DEFINE value if you omit the BLOCKIN option and in-filename is a tape DEFINE with these attributes: ...
Page 94 FUP Commands COPY: Copy Form If you specify EBCDICIN and in-filename is a tape DEFINE, the EBCDIC attribute of the DEFINE must be ON or unspecified. FUP sets the EBCDIC attribute of the DEFINE to OFF for the life of the FUP command. If you specify EBCDICIN, FUP translates the data.
Page 95 FUP Commands COPY: Copy Form REELS num-reels indicates the use of multiple reels and sets the number of reels that make up in-filename (for unlabeled magnetic tape only). You cannot specify this option if in-filename is a tape DEFINE with LABELS set for labeled tape processing.
Page 96 FUP Commands COPY: Copy Form SKIPIN num-eofs moves the tape past num-eofs end-of-file (EOF) marks before the data transfer begins (for magnetic tape only). You cannot specify this option if in-filename is a tape DEFINE with LABELS set for labeled tape processing. You must use the appropriate tape DEFINE attribute to skip files on a labeled tape.
Page 97 FUP Commands COPY: Copy Form Each variable-length, blocked record begins with a word that contains the length of the record, and the read count equals the value of that length indicator. You cannot use the TRIM option with VARIN, and this option works only with tapes written by FUP.
Page 98 FUP Commands COPY: Copy Form  USE set to OUT (or not specified)  BLOCKLEN specified If these are not the attribute settings, FUP uses the write-count value for out-block-length and writes each output record in a separate physical operation. Record blocking does not occur. DENSITYOUT density indicates the recording density for the output tape file.
Page 99 FUP Commands COPY: Copy Form If you include the EBCDICOUT option, FUP performs the translation. If you omit the EBCDICOUT option and a tape DEFINE is set so that translation is requested, the translation is performed by labeled tape processing. Note.
Page 100 FUP Commands COPY: Copy Form If you specify the RECOUT option and out-filename is a tape DEFINE with these attributes, you must not specify the RECLEN attribute of the DEFINE, or RECLEN must match out-record-length:  LABELS set for labeled tape processing ...
Page 101 FUP Commands COPY: Copy Form If you include the SKIPOUT option (and out-filename is a tape DEFINE), FUP displays this error message: ERROR - SKIPOUT PARAMETER NOT ALLOWED FOR LABELED TAPES Specify num-eofs as an integer in the range –255 through 255. ...
Page 102 FUP Commands COPY: Copy Form The write count and the record-length word of a record are equal—even if the record is truncated. Truncation occurs if the record is either longer than RECOUT or longer than BLOCKOUT subtracted by two. (The record-length word requires two extra bytes.) If the next record with its record-length word does not fit in the current block, VAROUT terminates the current block and begins a new block because the...
Page 103: Copy: Copy Form Guidelines
FUP Commands COPY: Copy Form Guidelines table. Every character in the IN file is translated using the specified table before it is written to the OUT file. Note. A warning occurs if you specify EBCDICOUT and an XLATE option (and FUP uses the XLATE option).
Page 104 FUP Commands COPY: Copy Form Guidelines  A COBOL program can read multireel tape files created by FUP COPY. Note. For more information, see these manuals:  COBOL85 for NonStop(TM) Himalaya Systems Manual (D-series RVUs)  COBOL85 for NonStop Systems Manual (G-series RVUs) ...
Page 105 FUP Commands COPY: Copy Form Guidelines  The [NO] COMPACT option affects copy operations for relative IN files only. If you specify NO COMPACT when you are copying another type of file, this message appears: WARNING - COMPACT OPTION IGNORED FOR NONRELATIVE FILES ...
Page 106: Copy: Copy Form Examples
FUP Commands COPY: Copy Form Examples COPY: Copy Form Examples These examples demonstrate using the COPY command without tape DEFINES. Note. For examples of using the COPY command with tape DEFINEs, see the Guardian User’s Guide .  To copy the first 500 records of MYFILE to YOURFILE (two unstructured files in the current default subvolume), where input records are 80 bytes and the data is copied in 800-byte physical reads: -COPY MYFILE, YOURFILE, COUNT 500, RECIN 80, BLOCKIN 800...
Page 107: Commands Related To Copy: Copy Form
FUP Commands Commands Related to Copy: Copy Form After you enter the command, the terminal displays: $BASE.SAMPLE.FILEZ 12MAY01 DATA MODIF: 26APR2001 14:19 This is a sample file to show how the TITLE option within FUP COPY works. 4 RECORDS TRANSFERRED Commands Related to Copy: Copy Form COMMAND Function...
Page 108: Copy: Display Form
FUP Commands COPY: Display Form COPY: Display Form Displays the contents of a file (the Display Form of the COPY command) or makes a record-by-record copy from one file to another (the Copy Form). The COPY command functions apply to Enscribe files and SPOOLER files (code 129). This subsection describes the Display Form.
Page 109: Copy: Display Form Listing Format
FUP Commands Copy: Display Form Listing Format BYTE displays in byte and ASCII format. The two bytes of each word are converted separately.  If you do not specify BYTE, a word is treated as a single value and converted accordingly. ...
Page 110: Copy: Display Form Examples
FUP Commands Copy: Display Form Examples is the current date (displayed for the first record only). mm/dd/yy is the current time (displayed for the first record only). hh:mm is the offset from the beginning of the word 0 record. offset is a block of n contiguous words of filename.
Page 111: Create
FUP Commands CREATE CREATE Creates a disk file with the current file-creation attributes defined by the SET command. To override the current file-creation attributes defined by the SET command, include create-param in the CREATE command. CREATE filename [ , create-param ] ... filename is the name of the file to be created.
Page 112: Create Examples
FUP Commands CREATE Examples  If FUP terminates because an error occurs while CREATE is automatically creating alternate-key files, the primary-key file and any alternate-key files already created are not deleted. You must purge these files manually.  CREATE cannot create SQL files that are not SQL object files. You must use SQLCI CREATE instead.
Page 113 FUP Commands CREATE Examples  If you include create-param in the CREATE command, the values you specify override the current file-creation attributes. (For more information, see page 2-171.) To override the current attributes and create a relative file with a record length of 10, define an alternate key on the first five bytes of the record and have the alternate key reside in the alternate-key file SECFILE: -CREATE MYFILE, TYPE R, REC 10, ALTKEY ("AA", FILE 0, &...
Page 114: Commands Related To Create
FUP Commands Commands Related to CREATE -set rec 54 -set block 4096 -set keylen 2 -set altkey ("LO",keyoff 42,keylen 4) -set altkey ("VN",keyoff 46,keylen 8) -set altfile (0,invalt) -set part (1,$ade001,5,5) -create inv CREATED - $STORE1.SVOL1.INV CREATED - $STORE1.SVOL1.INVALT Commands Related to CREATE COMMAND Function Page...
Page 115: Deallocate Example
FUP Commands DEALLOCATE Example trail files are rejected with file-system error 2 (operation not allowed on this type of file). To let FUP continue after receiving such errors, use the FUP ALLOW ERRORS command.  DEALLOCATE works only with SQL files that are SQL object files. On other SQL files, you must use SQLCI ALTER instead.
Page 116: Dup[Licate]
FUP Commands DUP[LICATE] DUP[LICATE] Copies disk files. This command applies only to Enscribe files. You need to understand when to use the COPY, DUP[LICATE], and LOAD commands: COPY To change file attributes or copy files to or from nondisk devices DUP[LICATE] To create identical copies of disk files LOAD...
Page 117 FUP Commands DUP[LICATE]  If you use a wild-card character or qualified-fileset option to specify the name of a file in from-fileset-list, you must specify the file name part of to-fileset with the (*) wild-card character.  If you specify the file name part of to-fileset as an asterisk (*), each output file is given the disk file name of its corresponding input file.
Page 118 FUP Commands DUP[LICATE] rename-option renames the secondary-partition volume and alternate-key files when they are duplicated. FUP creates the destination file with new names for the secondary- partition volumes and alternate-key files. If you do not specify rename-option, FUP creates alternate-key files and partitions with names specified by the primary partition.
Page 119 FUP Commands DUP[LICATE] KEEP does not duplicate any files that exist in both to-fileset and from-fileset-list. If a file specified in to-fileset already exists, the corresponding file in from-fileset-list is not duplicated. FUP lists the names of the files that are not duplicated. Checking is by name only. No file attributes are checked.
Page 120 FUP Commands DUP[LICATE] If you omit PARTONLY and define a primary partition in from-fileset-list, FUP duplicates the entire partitioned file (all partitions). If PARTONLY is not specified, it is an error to specify a secondary partition in from-fileset. PHYSVOL [ physvol ] specifies the physical volume where a file should be created.
Page 121: Dup[Licate] General Guidelines
FUP Commands DUP[LICATE] General Guidelines DUP[LICATE] General Guidelines  The DUP command opens the file to be duplicated with read-only access and with protected exclusion mode. Note. For information about file access and exclusion modes, see the Enscribe Programmer’s Guide. ...
Page 122: Dup[Licate] Guidelines For Safeguard Files
FUP Commands DUP[LICATE] Guidelines for Safeguard Files  Transfer the CLEARONPURGE attribute (for more information, see SECURE on page 2-166) to a local or remote target file. The target file does not need to be on the node where FUP is running. To restore the CLEARONPURGE attribute, use a SECURE command.
Page 123: Dup[Licate] Examples
FUP Commands DUP[LICATE] Examples  DUP command supports queue files. For example: -DUP oldqueuefile, newqueuefile [EXT (pri-extent-size, sec- extent-size)] [SAVEALL] MAXEXTENTS cannot be increased by DUP. Use FUP ALTER to alter the MAXEXTENTS of the file. DUP[LICATE] Examples  To duplicate all the files in the current default subvolume (and in the MYSVOL subvolume) and place copies of the files (using the same file names) in the NEWSVOL subvolume: -DUP (MYSVOL.*, *), NEWSVOL.*...
Page 124: Commands Related To Dup[Licate]
FUP Commands Commands Related to DUP[LICATE]  To duplicate all the EDIT files (that begin with an S) from one subvolume to another and purge any old copies (if they exist): -DUP S* WHERE FILECODE=101, NEWSVOL.*, PURGE Note. Qualifiers occur before the to-fileset specification. ...
Page 125: Exit Example
FUP Commands EXIT Example EXIT Example To terminate FUP and return control of the terminal to the command interpreter: -EXIT 10> Modifies and reexecutes a specific command. FC [ -num | num | string | quoted ] -num displays a command previous to the current command. For example, to modify and execute the third command prior to the current command, specify -3.
Page 126: Fc Guidelines
FUP Commands FC Guidelines deletes the character above the D. Repeat to delete more characters. FC Guidelines  If you do not use parameters, FC displays the last command line entered.  When you finish editing the line or have no changes to make, press RETURN to execute the modified command.
Page 127: Commands Related To Fc
FUP Commands Commands Related to FC Commands Related to FC COMMAND Function Page HISTORY Displays previous FUP commands 2-81 Reexecutes a previous FUP command without modification Displays a previous FUP command FILENAMES Lists the names of files that match the specified wild-card option. The FILENAMES command is similar to the FILES command, but the FILES command lists all the files in the specified subvolumes.
Page 128: Files
FUP Commands FILES FILES Displays all file names associated with one or more subvolumes. The FILES command is similar to the FILENAMES command, which displays subsets of files within a subvolume. FILES [ / OUT listfile / ] [ subvolset ] subvolset: [[[ \node.]$volume.] subvolume | * ] OUT listfile...
Page 129: Files Guidelines
FUP Commands FILES Guidelines FILES Guidelines  If you request information for all the subvolumes on a volume, FUP displays the file names in each subvolume (by object name within the subvolume name).  The FILES command applies to all types of Enscribe and SQL files. File names are displayed for unstructured and structured Enscribe files and for all types of SQL files (tables, indexes, views, catalog tables, the indexes on SQL catalog tables, and SQL object program files).
Page 130: Give
FUP Commands GIVE GIVE Changes the owner of a file. This command applies only to Enscribe files. Only the current owner of the file (or the super ID, (255,255)) can execute the GIVE command for a file. GIVE fileset-list , {groupnum , usernum | groupname.username } [ , PARTONLY ] fileset-list...
Page 131: Give Examples
FUP Commands GIVE Examples  User other than owner in the same group can alter the ownership of a Safeguard protected file if the OWNERSHIP (O) permission is given to the user while adding to safeguard protection using SAFECOM.  FUP returns the error message "SAFEGUARD IS NOT LICENSED", if the safeguard object is not licensed.
Page 132: Help
FUP Commands HELP HELP Lists the syntax of the FUP commands. HELP [ / OUT listfile / ] [ command | ALL [, SYNTAX ] | NEWS OUT listfile names a file to receive the output of the HELP command. If you omit this option, the output is sent to the OUT listfile that is enabled for the current FUP session—usually your home terminal.
Page 133: History
FUP Commands HISTORY  To display the syntax of the FUP CREATE command: -HELP CREATE CREATE filename [ , create param ] ... create param -- see SET  To display the syntax of the FUP PURGE command: -HELP PUR PURGE { [ ! ] fileset [, fileset ] ...
Page 134: History Example
FUP Commands HISTORY Example HISTORY Example To display the last four commands entered: -HISTORY 4 8:INFO, DETAIL 9:CREATE NEWFILE 10:DUP OLDFILE, NEWFILE 11:HISTORY 4 Commands Related to HISTORY COMMAND Function Page Modifies a previous FUP command 2-73 Reexecutes a previous FUP command Displays a previous FUP command INFO Displays disk file characteristics of Enscribe files;...
Page 135 FUP Commands INFO a standard file name or a spool DEFINE name as the OUT listfile. If listfile is an existing file, FUP appends output to that file. Note. For more information, see Specifying Files on page 1-8. fileset-list is a list of disk files for which the file characteristics are displayed. The fileset-list can include Enscribe files, OSS files, and all types of SQL/MP and SQL/MX files (tables, indexes, views, catalog tables, and indexes on SQL/MP and SQL/MX catalog tables).
Page 136 FUP Commands INFO SQL-identifier is a name used by SQL/MX to identify tables, views, columns, and other SQL entities. SQL identifiers can be either regular or delimited and can contain up to 258 characters in external form, or equivalently up to 128 characters in internal format.
Page 137: Info Guidelines
FUP Commands INFO Guidelines PARTONLY is implied (for Enscribe files) if you specify a secondary partition because secondary partitions do not contain information about other partitions. If you omit PARTONLY and specify the primary partition of an Enscribe file (or specify any partition of an SQL/MP and SQL/MX object), the STAT[ISTICS] option provides information about all partitions of the file.
Page 138: Info Listing Format
FUP Commands INFO Listing Format updated concurrently, causing a transient structure problem that FUP encounters because it is reading large blocks.  INFO with the STAT option does not detect each instance of a corrupted file.  INFO with the STAT,PARTIAL option provides information without reading the entire file.
Page 139: Example 2-2. Info Listing Format
FUP Commands INFO Listing Format Example 2-2. INFO Listing Format CODE EOF LAST MODIF OWNER RWEP TYPE REC BL [\node.] $volume.subvolume name open- code owner sec type rec bl state name is the disk file name of the file whose characteristics are being displayed. A question mark (?) after the file name might appear for an OSS file entry for which FUP cannot read the last modification time.
Page 140 FUP Commands INFO Listing Format Letters and symbols that appear after the code indicate: TMF audits the file. The file is licensed. For more information, see LICENSE (Super ID) on page 2-117. The PROGID attribute of the file is on. For more information, see SECURE page 2-166.
Page 141 FUP Commands INFO Listing Format Member of owner's community—member of owner's group (local or remote) Any user (local or remote) *SQL SQL/MX object Note. For an OSS file, a 10-character OSS security vector appears in the RWEP column. (The vector extends into the TYPE column.) For more information, see the Open System Services User’s Guide.
Page 142: Table 2-2. System File Code Definitions
FUP Commands INFO Listing Format Table 2-2. System File Code Definitions (page 1 of 9) File Code Definition OSS file TMDS CLIP code dump file MIS Batch file MIS Batch file not yet determined PRS employee file PRS systems file PRS product file TTSI control file TNS object file or OSS data file...
Page 143 FUP Commands INFO Listing Format Table 2-2. System File Code Definitions (page 2 of 9) File Code Definition QDDL/QRW FILEDESC file 161-169 Workload Measurement System files XRAYSCAN structured output files for Enform reports Measure data file SQL/MP table file for Surveyor 178-179 ONGUARD control files C data file...
Page 144 FUP Commands INFO Listing Format Table 2-2. System File Code Definitions (page 3 of 9) File Code Definition Transfer name file Transfer DIN file Transfer alias file Transfer trace file Transfer queue file Transfer inverted attachment file Transfer external objects file TRANSFER (interest group) file Transfer WORDLINK and Translator format name file Transfer WORDLINK and Translator character map file...
Page 145: Oss Files
FUP Commands INFO Listing Format Table 2-2. System File Code Definitions (page 4 of 9) File Code Definition 310-399 TPS (Pathway) PATHMON stack dump file Tape simulator control file Tape simulator data file Consolidated Collected Performance Data file Psuedo Measure Structured file Performance Reporting Data file Kernel-Managed Swap Facility file Tape IOP trace dump file...
Page 146 FUP Commands INFO Listing Format Table 2-2. System File Code Definitions (page 5 of 9) File Code Definition Cyclone microcode file Cyclone microcode file Himalaya IOS microcode file NonStop VLX processor microcode file 530-536 NFS Configuration files 537-539 links SAFEGUARD logical user file SAFEGUARD user audit file SAFEGUARD security database SAFEGUARD object audit file...
Page 147 FUP Commands INFO Listing Format Table 2-2. System File Code Definitions (page 6 of 9) File Code Definition MUMPS global file MUMPS routine file MUMPS global directory file 603-620 MUMPS files (NS-SOG) Service Object file (NS-SOG) Service Object Element file (NS-SOG) Application file (NS-SOG) Application Service Object file (NS-SOG) Run-time Server Object file...
Page 148 FUP Commands INFO Listing Format Table 2-2. System File Code Definitions (page 7 of 9) File Code Definition Sierra ZSYSCONF Config file COUP IOP Configuration Database File EMS formatter template (NLS capable) SNAX utility output file COUP database file COUP process image file EMS logger file EMS formatter template EMS compiled filter...
Page 149 FUP Commands INFO Listing Format Table 2-2. System File Code Definitions (page 8 of 9) File Code Definition DSM/TC tape catalog file SQL table filecode for DELPHI Exchange trace file SQL Collation object DSM/SCM (DELPHI) audit snapshot data DSM/SCM (DELPHI) activation packages DSM/SCM (DELPHI) dist file DSM/SCM (DELPHI) SIT &...
Page 150: Info Listing Format Example
FUP Commands INFO Listing Format Example Table 2-2. System File Code Definitions (page 9 of 9) File Code Definition 5304 TTSI ERAD definition file 5305 TTSI ERAD detail text file 5306 TTSI ERAD log file 5307 TTSI ERAD repair procedure file 7878 TTSI Help file 9613...
Page 151: Info Detail Listing Format
FUP Commands INFO DETAIL Listing Format Example 2-5. Short INFO for OSS Files With POSIX ACL $SYSTEM SYSTEM 1> fup info \OCTOPUS.$OSS.ZYQ00001.Z0000010 CODE EOF LAST MODIF OWNER RWEP TYPE REC BL $OSS.ZYQ00001 Z0000010 OSS 0 13:48 -1 -rw-rw-rw-+ INFO DETAIL Listing Format A DETAIL listing has two formats: ...
Page 152 FUP Commands INFO DETAIL Listing Format Example 2-6. DETAIL Format for SQL Tables and Indexes and for Enscribe and OSS Files filename date-and-time object-type CATALOG catalog-name VERSION number BASE TABLE base-table-name PHYSICAL FILENAME VIRTUAL FILENAME ANSI NAME ansi-name RESOURCE FORK resource-fork-location SYSTEM METADATA system-metadata-location TYPE file-type FORMAT format-code...
Page 153 FUP Commands INFO DETAIL Listing Format 18- EXTENTS ALLOCATED: num-ext 19- INDEX LEVELS: num-index-levels 20- PARTITION ARRAY {EXTENDED | STANDARD | FORMAT2ENABLED} Note. If you do not have access privileges to a file and you issue the INFO DETAIL command, UNAVAILABLE is displayed as the pathname.
Page 154 FUP Commands INFO DETAIL Listing Format File codes in the range 100 through 999 refer to specific types of files and are reserved by HP. For a description of these codes, see Table 2-2, System File Code Definitions, on page 2-90.
Page 155 FUP Commands INFO DETAIL Listing Format  ICOMPRESS indicates keys in index blocks are compressed. 10. Describes indexes of an SQL table or alternate-key files of an Enscribe file:  The key-spec parameter is the key specifier stored in every index row. ...
Page 156 FUP Commands INFO DETAIL Listing Format security were removed. For more information, see the Safeguard Reference Manual. 14. SECONDARY PARTITION indicates the file is a secondary partition of an Enscribe file. 15. Lists dates and times of file activity. DATA MODIF indicates when the data in the file was last modified and one of the open states (if applicable).
Page 157: Example 2-7. Detail Format For Sql/Mp View
FUP Commands INFO DETAIL Listing Format 17. FILE LABEL is the number of bytes currently used for the file label and the percentage of the maximum file label it uses. If this is close to 100 percent full, the file cannot add any new extents. 18.
Page 158: Info Detail Listing Format Examples
FUP Commands INFO DETAIL Listing Format Examples  The location of system metadata tables associated with the object.  Clustering key information for the objects.  Partitioning information for objects that can be partitioned.  Indexes associated with tables. INFO DETAIL Listing Format Examples The listing examples in this section are for Enscribe files.
Page 159 FUP Commands INFO DETAIL Listing Format Examples SECURITY (RWEP): AAAA DATA MODIF: 11 May 1999, 11:20 CREATION DATE: 10 Apr 1997, 16:00 LAST OPEN: 14 Apr 2000, 18:00 EOF 3072 ( 9.4% USED) FILE LABEL: 298 (7.3 % USED) EXTENTS ALLOCATED: 2 FREE BLOCKS 1 INDEX LEVELS: 1 ...
Page 160 FUP Commands INFO DETAIL Listing Format Examples  To show the FUP INFO, DETAIL listing for a logical file by its physical name: -INFO $HEAT.ZYS00000.Z00057I0, DETAIL $HEAT.ZYS00000.A00057I0 3 Jul 2000, 16:50 ENSCRIBE VIRTUAL FILENAME: \SMSDEV.$BALL.CAROLS.FILE TYPE U FORMAT 1 EXT ( 2 PAGES, 2 PAGES ) MAXEXTENTS 16 BUFFERSIZE 4096 OWNER -1...
Page 161 FUP Commands INFO DETAIL Listing Format Examples REC 80 BLOCK 4096 IBLOCK 4096 KEYLEN 2 KEYOFF 0 ALTKEY ("AA",FILE 0,KEYOFF 0,KEYLEN 2,INSERTIONORDER) ALTFILE ( 0, $DATAA.DCDTEST.ALT0 ) MAXEXTENTS 16 OWNER 1, 164 SECURITY (RWEP): CUCU DATA MODIF: 17 Dec 2000, 16:45 CREATION DATE: 17 Dec 1997, 16:45 LAST OPEN: NEVER OPENED...
Page 162 FUP Commands INFO DETAIL Listing Format Examples TYPE K FORMAT 1 EXT (2 PAGES, 2 PAGES ) REC 14 BLOCK 4096 IBLOCK 4096 KEYLEN 14 KEYOFF 0 MAXEXTENTS 16 OWNER 1,164 SECURITY (RWEP): CUCU DATA MODIF: 17 Dec 2000, 16:45 CREATION DATE: 17 Dec 1997, 16:45 LAST OPEN:...
Page 163 FUP Commands INFO DETAIL Listing Format Examples FILE LABEL: 214 (5.2 % USED) EXTENTS ALLOCATED: $GUEST.ERNIE.ABEND 13 Aug 2000, 14:04 ENSCRIBE TYPE U CODE 100 FORMAT 1 EXT ( 4 PAGES, 2 PAGES ) ODDUNSTR MAXEXTENTS 16 BUFFERSIZE 4096 BUFFERED OWNER 64,5 SECURITY (RWEP): UUUU DATA MODIF:...
Page 164 FUP Commands INFO DETAIL Listing Format Examples  To request detailed information for a partitioned SQL/MX table using ANSI names: FUP INFO 'TABLE CAT_ANSINAME01.SCH_ANSINAME01.TAB1',DETAIL $DATA05.ZSDHKPKT.CGJC4500 16 Nov 2005, 0:38 SQL ANSI TABLE ANSI NAME CAT_ANSINAME01.SCH_ANSINAME01.TAB1 RESOURCE FORK \DRP42.$DATA05.ZSDHKPKT.CGJC4501 SYSTEM METADATA \DRP42.$DATA05.ZSD0 VERSION 1200 TYPE K FORMAT 2...
Page 165: Info Statistics Listing Format
FUP Commands INFO STATISTICS Listing Format INFO STATISTICS Listing Format Example 2-8 shows the format that the FUP INFO command (with the STATISTICS option) uses to display file information. It reads the specified file to gather the statistics and requires more time to complete than the other INFO commands. You must have read-access to the file.
Page 166: Info Statistics Listing Format Examples
FUP Commands INFO STATISTICS Listing Format Examples name is shown only if the file has extra partitions. It is the volume name of the partition associated with the entry. FREE t-blocks is the total number of unused blocks in the file between the beginning of the file and the current EOF (for key-sequenced files).
Page 167 FUP Commands INFO STATISTICS Listing Format Examples 14.0 3760 75.0 2054 DATA 4840 29.2 1363 FREE BITMAP  To display the FUP INFO, STATISTICS, PARTIAL listing for a partitioned SQL/MX table: -INFO WWVL3T00, STAT, PARTIAL 30 (DETAIL option listing displays first, followed by this) ***** PARTIAL STATISTICS: 30% OF FILE ***** AVG # AVG %...
Page 168: Info Extents Listing Format
FUP Commands INFO EXTENTS Listing Format BUFFERED AUDITCOMPRESS OWNER -1 SECURITY (RWEP): *SQL DATA MODIF: 27 Oct 2005, 23:34 CREATION DATE: 16 Oct 2005, 20:31 REDEFINITION DATE: 16 Oct 2005, 20:31 LAST OPEN: 16 Nov 2005, 0:38 EOF: 12288 (0.1% USED) EXTENTS ALLOCATED: 1 PARTITION ARRAY FORMAT2ENABLED TOTAL...
Page 169: Commands Related To Info
FUP Commands Commands Related to INFO $VOL2  To show the FUP INFO, EXTENTS listing for a partitioned SQL/MX table: -INFO J4XL3T00, EXTENTS $D1103.ZSDL2BDF.J4XL3T00 27 Jan 2004, 13:39 EXTENT # OF PAGES STARTING PAGE PART 176539 \SURYA.$D1103.ZSDL2BDF.WWVL3T00 167595 \SURYA.$D1103.ZSDL2BDF.J4XL3T00  To show FUP INFO, EXTENTS listing for a partitioned SQL/MX table using ANSI names: -INFO 'TABLE CAT_ANSINAME01.SCH_ANSINAME01.TAB1',EXTENTS...
Page 170: License (Super Id) Guidelines
FUP Commands LICENSE (Super ID) Guidelines privileged program. To license files protected by the Safeguard product, use the Safeguard command interpreter (SAFECOM). LICENSE fileset-list fileset-list is a list of files to be licensed for use by nonprivileged users. You can use wild-card characters and specify qualified-fileset for fileset-list.
Page 171 FUP Commands LISTLOCKS By default, locks on all partitions of a partitioned Enscribe file are displayed. Use LISTLOCKS to clarify lock situations. This command does not provide instantaneous views of the locks. LISTLOCKS [ / OUT listfile / ] fileset-list / ansiname-list [ , GRANTED ] [ , DETAIL ] [ , PARTONLY ] OUT listfile names a file or device to receive the listing output of the LISTLOCKS command.
Page 172: Listlocks Listing Format
FUP Commands LISTLOCKS Listing Format SQL-identifier is a name used by SQL/MX to identify tables, views, columns, and other SQL entities. SQL identifiers can be either regular or delimited and can contain up to 258 characters in external form, or equivalently up to 128 characters in internal format.
Page 173: Example 2-10. Fup Listlocks Detail Listing Format
FUP Commands LISTLOCKS Listing Format Example 2-10. FUP LISTLOCKS DETAIL Listing Format \node.$volume.subvolume.file-id LOCK REQUESTER TYPE STATE KEY/RECORD ADDRESS \FOXII.$:3:52:17484380 LOCK STATE = LK^X LOCK TYPE is the type of lock: File Record Generic record STATE is the state of the lock: Granted Internally generated intent lock Waiting...
Page 174: Listlocks Guidelines
FUP Commands LISTLOCKS Guidelines LOCK STATE specifies the size and range of the lock. LK^IS Intent shared. This lock is acquired for the table only. You can upgrade it to LK^S when escalation to a table lock is required. LK^IX Intent exclusive.
Page 175: Listlocks Example
FUP Commands LISTLOCKS Example  An intent lock is internally generated by a disk process to control combinations of record and file locks on a file. When a disk process receives a requester for a record lock, it requests and receives an intent lock on the file. If the requested record is not already locked, the record lock is granted.
Page 176: Listopens
FUP Commands LISTOPENS \MYSYS(1):14:3342 "values" ?0 ?11 ?6 \MYSYS.$DATA.SUBVOL.ENTFILE LOCK REQUESTER TYPE STATE KEY/RECORD ADDRESS \MYSYS.$MYPROG 477184 \MYSYS(162):15:002314 2502656 \MYSYS.01,044 11264000 \MYSYS.$MYPROG The locks in this example are grouped by locked resource. A locked resource occurs when the locks on a file are grouped together, and the locks on a record in that file are also grouped together.
Page 177: Listopens Listing Format
FUP Commands LISTOPENS Listing Format OUT listfile names a file or device to receive the listing output of the LISTOPENS command. You can use either a Guardian file name or a spool DEFINE name as the OUT listfile. If listfile is an existing file, FUP appends output to that file. Note.
Page 178: Example 2-11. Fup Listopens Listing Format
FUP Commands LISTOPENS Listing Format Example 2-11. FUP LISTOPENS Listing Format [ \node.]$volume.subvolume.file-id MODE USERID MYTERM PROGRAM FILE NAME s,c,p -pa -e term prog-name is the network node number of the node running the process that has the specified file open in the command. is the processor number and process number of the process.
Page 179: Listopens Guidelines
FUP Commands LISTOPENS Guidelines prog-name is the program file name of the program that has the specified file open as it appears for a user process: $volume.subvolume.file-id It appears for a system process as: $SYSTEM.SYSnn.OSIMAGE $SYSTEM.SYSnn is the subvolume containing the operating system image that is currently in use (and nn is a two-digit octal integer.) Note.
Page 180 FUP Commands LISTOPENS Guidelines against all protection views on the SQL base table of interest. To list the protection views for a base table, use the command SQLCI DISPLAY USE OF tablename.  The only device processes that currently give LISTOPENS information are disks, terminals, and X.25 lines.
Page 181: Listopens Examples
FUP Commands LISTOPENS Examples LISTOPENS Examples  To display a list of all processes that currently have open the file MYFILE (a file in the current default volume and subvolume): -LISTOPENS MYFILE  To list all the opens of terminal $TERM: 5>FUP LISTOPENS $TERM ...
Page 182 FUP Commands LISTOPENS Examples 042,02,0432 -S 255,255 15 $ZTNT.#PTUJKRM $SYSTEM.SYSTEM.MXCI $DATA3.ZSDHKPKT.L9G93500 ANSI NAME CAT_ANSINAME01.SCH_ANSINAME01.TAB1 MODE USERID MYTERM PROGRAM FILE NAME 042,02,0432 -S 255,255 15 $ZTNT.#PTUJKRM $SYSTEM.SYSTEM.MXCI $DATA3.ZSDHKPKT.SVS83500 ANSI NAME CAT_ANSINAME01.SCH_ANSINAME01.TAB1 MODE USERID MYTERM PROGRAM FILE NAME 042,02,0432 -S 255,255 15 $ZTNT.#PTUJKRM $SYSTEM.SYSTEM.MXCI $DATA4.ZSDHKPKT.NQW83500...
Page 183: Load
FUP Commands LOAD LOAD Loads data into a structured disk file without affecting any associated alternate-key files. Data in the file being loaded is overwritten. This command applies only to Enscribe files. To load any alternate-key files, use the command LOADALTFILE on page 2-138 after you complete a LOAD command.
Page 184 FUP Commands LOAD You need to understand when to use the COPY, DUP[LICATE], and LOAD commands: COPY To change file attributes or copy files to or from nondisk devices DUP[LICATE] To create identical copies of disk files LOAD To create a structured disk file from scratch (much faster than COPY) in-filename names the file containing the records to be loaded.
Page 185 FUP Commands LOAD KEY { record-spec | key-value } specifies the primary-key value for the starting record of a disk file. FUP begins reading the input file at the record you name with KEY. Specify record-spec as an integer in the range 0 through (512000000 * 2,048) -1.
Page 186 FUP Commands LOAD PAD [ pad-character ] specifies that records containing fewer than in-record-length bytes are padded with pad-character up to the record length specified in the file label. Specify pad-character as a single ASCII character inside quotation marks: "c" or as an integer in the range 0 through 255, specifying a byte value: { 0:255 } Note.
Page 187: Load Guidelines
FUP Commands LOAD Guidelines PARTOF $volume loads only the partition named in destination-filename. This option is for key-sequenced, partitioned files only. The $volume is the volume containing the primary partition of the destination file. Note. For more information about the PARTOF option, see LOAD Guidelines page 2-135.
Page 188 FUP Commands LOAD Guidelines  The FUP LOAD command reads the source file directly using large buffers unless you specify SHARE, in which case the Enscribe file system performs the reads.  You can use a SORT DEFINE with the LOAD command. You must define it before starting FUP.
Page 189 FUP Commands LOAD Guidelines  The NO COMPACT option affects only relative files. If you include NO COMPACT in a LOAD command to load data from a nonrelative file, this message appears: WARNING - COMPACT OPTION IGNORED FOR NONRELATIVE FILES ...
Page 190: Load Examples
FUP Commands LOAD Examples LOAD Examples  To load data from a relative file (RELFILE) to DFILE, causing zero-length records and data records to be transferred: -LOAD RELFILE, DFILE, NO COMPACT  This example loads data from the tape device ($TAPE) into the key-sequenced disk file (KSFILE).
Page 191: Loadaltfile Guidelines
FUP Commands LOADALTFILE Guidelines key-file-number selects the alternate-key file to load. Specify key-file-number as an integer in the range 0 through 255 to indicate an alternate-key file of the primary file. The alternate-key file must already exist. You can display the key-file number with the FUP INFO command on the primary file.
Page 192: Loadaltfile Example
FUP Commands LOADALTFILE Example LOADALTFILE honors any NULL specification defined for a key field, but an alternate-key record is not generated for a field consisting entirely of null characters (if such a null character was defined).  A sort operation is performed when you execute LOADALTFILE. The primary file is read sequentially according to its primary-key field.
Page 193: Obey Guidelines
FUP Commands OBEY Guidelines After FUP reads an EOF in the command file, it returns you to the FUP command prompt. If the command file causes a change in status (by executing VOLUME or CONFIGURE commands), the new status remains enabled after the completion of the OBEY command.
Page 194: Purge
FUP Commands PURGE PURGE Deletes a single disk file, a set of files, many sets of files, or an entire subvolume of files. This command applies only to Enscribe files. PURGE [ ! ] fileset-list [ , [ NO ] LISTALL ] [ ! ] in either or both of the displayed positions, indicates to purge the files without prompting for permission.
Page 195: Purge Guidelines
FUP Commands PURGE Guidelines  If you enter any other response, FUP ignores your response and redisplays the file set prompt. Note. For different responses to the file-set prompt, see PURGE Examples page 2-144. fileset-list names a file, a set of files, or many sets of files to purge. Partial file names are expanded using the current default node, volume, and subvolume.
Page 196: Purge Examples
FUP Commands PURGE Examples  PURGE cannot dispose of SQL files that are not SQL object files. Instead, you must use SQLCI PURGE.  For objects compiled by SQL, PURGE displays error 197 (an SQL error has occurred).  You can purge a file only if it is not in use (that is, it cannot be open, running, or undergoing a backup process).
Page 197 FUP Commands PURGE Examples  To display the FUP INFO listing for each file in the specified file set and prompt for permission to purge each file: -PURGE WKLYRPRT, MONTHEND, REQTOTAL CODE LAST MODIF OWNER RWEP TYPE BLOCK $MYVOL.RECDS WKLYRPRT 2048 29MAR87 11:46 8,44 AOAO...
Page 198: Commands Related To Purge
FUP Commands Commands Related to PURGE If you type S (or press Return), the FUP INFO listing appears for each file in the file set, followed by the PURGE? prompt: ( Y[ES], N[ONE], S[ELECT], F[ILES] )? S CODE LAST MODIF OWNER RWEP TYPE...
Page 199: Purgedata Guidelines
FUP Commands PURGEDATA Guidelines PARTONLY purges data in any primary or secondary extents of partitioned files that reside in fileset-list. If you omit PARTONLY, data is purged from all partitions of partitioned files—but only if the primary partitions of the files reside in fileset-list.
Page 200: Reload
FUP Commands RELOAD RELOAD Physically reorganizes a key-sequenced file or SQL object (table or index only) while allowing shared read and write access to the file or object. FUP RELOAD supports key-sequenced file reorganization of volume directories, TMF- audited files and SQL tables, and nonaudited files and SQL tables. A reload operation improves access time and use of space for a key-sequenced file or SQL object that has undergone many insertions, deletions, and updates with length changes.
Page 201 FUP Commands RELOAD SQL-name is used to name base SQL base objects (such as tables or indexes) in addition to their SQL containers: catalogs and schemas. The names (called 3-part names) for SQL base objects such as tables, indexes, or modules are composed of three SQL identifiers separated by two dot characters (for example, CAT.SCH.T).
Page 202 FUP Commands RELOAD PARTOF $volume specifies the volume where the primary partition resides if filename is an Enscribe secondary partition. If you specify a secondary partition but do not specify the PARTOF option, the system returns an error message. The PARTOF option is not required for an SQL object. If you specify this option for an SQL object, FUP ignores it.
Page 203 FUP Commands RELOAD By default, a RELOAD operation cannot be performed if the user initiating the operation does not have write access to a file whether the SHARE option is specified or not. If the user does not have write access, error 48 is returned. To perform a RELOAD operation, a user who does not have write access to the file can use the SHARE option by configuring ORSERV (online reload server): Note.
Page 204: Reload Guidelines
FUP Commands RELOAD Guidelines The RECLAIM option directs DP2 to mark data blocks vacated due to a DDL "move partition boundary" or "one-way split" operation as FREE blocks. The RECLAIM completes very quickly, but the EOF of the file may not be reduced after a RECLAIM.
Page 205 FUP Commands RELOAD Guidelines  To monitor the status of a reload operation, use the STATUS command.  To temporarily stop the reload, use the SUSPEND command.  Access to filename by an application (during the reload) requires shared access. ...
Page 206: Reload Example
FUP Commands RELOAD Example  The above explanation can be used to explain both an error 8551 from ANSI names or error 48 from the file system, depending on the command that was used.  RELOAD supports SQL/MX objects, TABLE PARTITION, and INDEX PARTITION. ...
Page 207: Relocate Guidelines
FUP Commands RELOCATE Guidelines files on a virtual drive without the SOURCEDATE option, the original time stamps are not retained. Note. This option was added in the T6553H01^ACS SPR. RELOCATE Guidelines  If multiple files are specified in the logical-set, FUP relocates them one at a time (waited).
Page 208: Rename Guidelines
FUP Commands RENAME Guidelines old-fileset-list specifies the files to be renamed. You can use wild-card characters and can specify qualified-fileset for fileset-list. For example, *SF finds all the files that end with SF. You can use ?SF to find all files that start with one character and are followed by SF.
Page 209: Reportwidth
FUP Commands REPORTWIDTH REPORTWIDTH Sets the maximum length (in columns) for FUP to format its output. This command changes the normal (default) 132-character output format of these FUP commands to a smaller output format:  COPY with a DUMP option ...
Page 210: Reset
FUP Commands RESET RESET Restores one or more file-creation attributes to the default settings. For a list of file- creation attributes and their default values, see on page 2-171. RESET [ reset-opts | CONFIG[URE] config-simple-opts ] reset-opts is: create-spec [ , create-spec ] ... create-spec is: ALTCREATE ALTFILE [ key-file-number ]...
Page 211: Reset Guidelines
FUP Commands RESET Guidelines config-simple-opts config-simple-option [ , config-simple-option ] config-simple-option is: ALLOW DISPLAYBITS DISPLAYALLNUM ECHO [CONFIG[URE] | OBEY IOTIMEOUT NETBLOCKSIZE PROMPT [ PURGE ] REPORTWIDTH RESTARTUPDATE STATONLY XLATE [ xlate-table-name ] XLATEIN [ xlate-table-name ] XLATEOUT [ xlate-table-name ] COPY [ copy-option ] DUP[LICATE] [ dup-option ] LOAD [ load-option ]...
Page 212: Commands Related To Reset
FUP Commands Commands Related to RESET ALTCREATE MAXEXTENTS 16 Reset the record size file-creation attribute to the default value of 80 bytes: -RESET REC After you complete the reset, the FUP SHOW command includes this line in its display: REC 80 ...
Page 213: Restart Guidelines
FUP Commands RESTART Guidelines RESTART Guidelines  FUP (DUP) updates the restart file periodically. This causes a RESTART operation to start from the last update, which is not necessarily from the last record written.  The RESTART operation fails if any of these conditions exist: ...
Page 214: Commands Related To Restart
FUP Commands Commands Related to RESTART Commands Related to RESTART COMMAND Function Page DUP[LICATE] Creates an identical copy of a disk file 2-64 File Utility Program (FUP) Reference Manual—523323-014 2-162...
Page 215: Revoke (Super Id)
FUP Commands REVOKE (Super ID) REVOKE (Super ID) Revokes a license for a privileged program file, or resets the security attributes of files and programs that have standard security codes. REVOKE command privileges are determined by your user ID:  If your user ID identifies you as the owner of a file, you can reset the CLEARONPURGE and PROGID security attributes of the file by including the file in fileset-list and specifying the attribute you want to reset.
Page 216: Revoke (Super Id) Guidelines
FUP Commands REVOKE (Super ID) Guidelines PROGID sets the process accessor ID to the owner ID of the program file when the program file is run (for program files only). Including PROGID in a REVOKE command revokes the PROGID option for the file. The process accessor ID is set to the ID that corresponds to the creator of the process when the program is run.
Page 217: Revoke (Super Id) Examples
FUP Commands REVOKE (Super ID) Examples  REVOKE cannot work with SQL files other than SQL object files. REVOKE (Super ID) Examples  To revoke the CLEARONPURGE attribute (for the primary partition only), you must own the partitioned file PARTFILE (in the current default volume and subvolume): -REVOKE PARTFILE, PARTONLY, CLEARONPURGE ...
Page 218: Secure
FUP Commands SECURE SECURE Sets or changes the standard security attributes of a file. To execute the SECURE command, you must be the owner of the file you want to secure, or you must log on as the super ID (255,255). SECURE fileset-list [ , [ security ] [ , secure-option ]...
Page 219 FUP Commands SECURE You can use these characters in security-string: Local super ID (255,255) only (use security-num to set in r position) Owner only (local only) Group member or owner (local only) Any local user Member of owner's user class (local or remote user with the same user ID as the owner of the file) Member of owner's community (local or remote user with the same group ID as the owner of the file)
Page 220: Secure Guidelines
FUP Commands SECURE Guidelines A standard user can secure a file (by using security-num) to allow only super ID (255,255) access (%7777). After doing this, the user does not have access to the file and must ask the super ID to change the security of the file. Note.
Page 221: Secure Examples
FUP Commands SECURE Examples 3. The new owner has ownership permission as per the underlying persistent protection record.  User other than owner in the same group can set the PROGID and CLEARONPURGE security attributes of a Safeguard protected file if the OWNERSHIP (O) permission is given to the user while adding to safeguard protection using SAFECOM.
Page 222: Commands Related To Secure
FUP Commands Commands Related to SECURE  To change the security for MYFILE to let any local or remote user read the file, but keep all the remaining security attributes: -SECURE MYFILE, N???  To secure MYPROG, permit only the owner to read, write, and purge it (although any local user can execute it), and set the PROGID bit so the owner ID of MYPROG is used as the process accessor ID when the program is run: -SECURE MYPROG, OOAO, PROGID...
Page 223: Set
FUP Commands Changes one or more file-creation default attributes before you create files. You can specify parameter values explicitly or set them to match those of an existing file. To display the current file-creation attributes (the values for create-param), use the SHOW command.
Page 224: Set Parameters For All File Types
FUP Commands SET Parameters for All File Types create-param for files with alternate-key fields is: [ NO ] ALTCREATE ALTFILE ( key-file-number , filename ) ALTKEY ( key-specifier { , altkey-param }... ) where altkey-param is: FILE key-file-number [ NO ] INSERTIONORDER KEYLEN key-length key-offset KEYOFF...
Page 225 Specify file-code as an integer in the range 0 through 65,535. The default is zero. File codes 100 through 999 are reserved for use by HP. Note. For a list of the reserved file codes, see Table 2-2 on page 2-90.
Page 226 FUP Commands SET Parameters for All File Types 0:maximum BYTE[S] specifies the extent size in bytes. Possible values of maximum are: Format 1 Format 2 0:134,215,680 BYTE[S] 0:2,147,483,647 BYTE[S] The FUP process rounds the extent size up to the next full page. If you specify 2,047 bytes, FUP allocates one page.
Page 227 FUP Commands SET Parameters for All File Types MAXEXTENTS maximum-extents sets the maximum number of extents to be allocated (for nonpartitioned files or key-sequenced partitioned files). Specify maximum-extents as an integer from 16 through n, where n is a maximum value determined by the amount of free space in the file label.
Page 228: Set Parameters For All Structured Files
FUP Commands SET Parameters for All Structured Files SET Parameters for All Structured Files The create-param available depends on the type of file you want to create. These options are available for all structured files: BLOCK data-block-length sets the data-block length. Specify data-block-length as an integer that is a power of 2 from 512 bytes through 4096 bytes (512, 1024, 2048, 4096).
Page 229: Set Parameters For Partitioned Files
FUP Commands SET Parameters for Partitioned Files [ NO ] DCOMPRESS sets or clears key compression for data blocks. The default setting is NO DCOMPRESS. The key offset must be 0 for key compression, and the maximum record size is reduced by one byte. [ NO ] ICOMPRESS sets or clears key compression in index blocks.
Page 230 FUP Commands SET Parameters for Partitioned Files PART ( sec-partition-num , [\node.]$volume [ , pri-extent-size [ , [ sec-extent-size ] [ , partial-key-value ] ] ] ) PART sets secondary partition specifications for partitioned files. Specify each secondary partition separately. sec-partition-num , \node.$volume names the volume where this secondary partition is to reside.
Page 231 FUP Commands SET Parameters for Partitioned Files Because the minimum extent size is one page (2,048 bytes), one page is also allocated if you specify zero extents. 0:maximum BYTE[S] specifies the extent size in bytes. Possible values are: Format 1 Format 2 0:134,215,680 BYTE[S] 0:2,147,483,647 BYTE[S]...
Page 232: Set Parameters For Files With Alternate-Key Fields
FUP Commands SET Parameters for Files With Alternate-Key Fields  Integers representing byte values from 0 through 255 enclosed in brackets: [ 5, 8, 220 ] To specify partial-key-value correctly:  If the partial-key values are a string of alphabetic characters, enclose them in quotation marks.
Page 233 FUP Commands SET Parameters for Files With Alternate-Key Fields ALTFILE ( key-file-number, filename ) adds or replaces the file name of an alternate-key file. You must include this parameter for any undefined key file number that is referenced by an ALTKEY specification.
Page 234 FUP Commands SET Parameters for Files With Alternate-Key Fields [ NO ] INSERTIONORDER specifies whether or not insertion-ordered alternate-key sequencing is to be used. The default is NO INSERTIONORDER. The default specifies alternate key records of files with duplicate key values ordered by their primary key sequence and not their order of insertion.
Page 235: Set Parameters For Unstructured Files
FUP Commands SET Parameters for Unstructured Files SET Parameters for Unstructured Files The create-param set available depends on the type of file you want to create. These options are available for unstructured files: BUFFERSIZE unstructured-buffer-size is the internal buffer size to use when accessing the specified file (for unstructured files only).
Page 236: Set Parameter For Files On Smf Virtual Disks
FUP Commands SET Parameter for Files on SMF Virtual Disks SET Parameter for Files on SMF Virtual Disks This option is available only for SMF files (all other parameters are valid for SMF files): PHYSVOL [ physvol ] specifies the physical volume where a file should be created. This option overrides any SMF parameters after the CREATE command creates a file on the virtual disk.
Page 237: Set Examples
FUP Commands SET Examples Table 2-3. Extent-Size Rounding Type of File EXT Parameter Value Extent Size Created DP2 Files Unstructured File Any N (N, N) With BUFFERSIZE <= 4096 Even N (N, N) With BUFFERSIZE > 4096 Odd N (N+1, N+1) With BUFFERSIZE >...
Page 238: Commands Related To Set
FUP Commands Commands Related to SET FORMAT 1 EXT ( 1 PAGES, 1 PAGES ) MAXEXTENTS 16 BUFFERSIZE 512  To set file-creation attributes for a key-sequenced file with 50-byte records and a primary-key length of 36 bytes: -SET TYPE K, REC 50, KEYLEN 36 ...
Page 239: Show
FUP Commands SHOW SHOW Displays the current settings of the file-creation attributes. Use the FUP SET and FUP RESET commands to set and reset these attributes. SHOW [ / OUT listfile / ] [ show-opts ] [ configure-opts ] show-opts is: create-spec [ , create-spec ] ...
Page 240 FUP Commands SHOW config-simple-opts config-simple-option [ , config-simple-option ] config-simple-option is: ALLOW DISPLAYBITS DISPLAYALLNUM ECHO [CONFIG[URE] | OBEY IOTIMEOUT NETBLOCKSIZE PROMPT [ PURGE ] REPORTWIDTH RESTARTUPDATE STATONLY XLATE [ xlate-table-name ] XLATEIN [ xlate-table-name ] XLATEOUT [ xlate-table-name ] COPY [ copy-option ] DUP[LICATE] [ dup-option ] LOAD [ load-option ] LOADALTFILE [ loadaltfile-option ]...
Page 241: Show Guidelines
FUP Commands SHOW Guidelines SHOW Guidelines  You cannot use show-opts and configure-opts in the same command. You must use separate SHOW commands.  If you issue the SHOW command with a create-spec that is not currently set (or is not applicable to the current value of TYPE), FUP returns only a prompt. ...
Page 242: Commands Related To Show
FUP Commands Commands Related to SHOW REC 80 BLOCK 4096 KEYLEN 2 KEYOFF 0 ALTKEY ( "aa", FILE 0, KEYOFF 0, KEYLEN 2, INSERTIONORDER) ALTFILE ( 0, $DATAA.DCDTEST.ALT0) ALTCREATE MAXEXTENTS 16 -EXIT  Suppose these CONFIG[URE] commands are enabled: CONFIGURE NETBLOCKSIZE 28 CONFIGURE DUP SOURCEDATE A SHOW CONFIG[URE] command provides this result: ALLOW ABENDS OFF...
Page 243: Status Guidelines
FUP Commands STATUS Guidelines filename is the name of a key-sequenced file or SQL object reorganized by a reload operation. You cannot use wild-card characters in filename or specify qualified-fileset. Note. When using SPI interface, pass the filename in uppercase. DETAIL gives complete information on the status of the file you want listed.
Page 244: Status Examples
FUP Commands STATUS Examples STATUS Examples  To display the status of a RELOAD process while it is in progress: -STATUS PAYFILE $BASE.FUPTESTL.PAYFILE RELOAD IN PROGRESS RELOAD INITIATED: 10 Aug 2000, 15:35 DSLACK: 20% ISLACK: 20% RATE: 10% PCT COMPLETED: 45% DEALLOCATE: YES ...
Page 245: Subvols Examples
FUP Commands SUBVOLS Examples listfile for the SUBVOLS command. If listfile is an existing file, FUP appends the output to that file. Note. For more information about listfile, see Specifying Files on page 1-8. subvolset is a pattern describing the subvolume names you want to see. The subvolset parameter defaults to the current volume.
Page 246: Suspend Guidelines
FUP Commands SUSPEND Guidelines name as the OUT listfile for a SUSPEND command. If listfile is an existing file, FUP appends the output to that file. Note. For more information about listfile, see Specifying Files on page 1-8. filename is the name of a key-sequenced file or SQL object (table or index) being reorganized.
Page 247: System Guidelines
FUP Commands SYSTEM Guidelines volume names the new current default volume. subvolume names the new current default subvolume. SYSTEM Guidelines  The initial SYSTEM setting is the node enabled when you start FUP.  You can use the SYSTEM command only to reference nodes that have a name; for example, a node that is part of a network.
Page 248: Commands Related To System
FUP Commands Commands Related to SYSTEM Commands Related to SYSTEM COMMAND Function Page VOLUME Changes the FUP default volume and subvolume 2-198 TRUST Changes the state of Trust flag to TRUST ME, TRUST SHARED or TRUST OFF. Only a super ID (255, 255) user can set the FLTTrustFlags flag to TRUST ME or TRUST SHARED.
Page 249: Trust Guidelines
FUP Commands TRUST Guidelines trust-flag is one of: SHARED resets Trust flag. sets Trust flag to TRUST ME state. SHARED sets Trust flags to TRUST SHARED state. TRUST Guidelines  The code of the files must be 100 or 800. If a files has another file code, error 2 occurs.
Page 250: Vols
FUP Commands VOLS VOLS Displays information about volumes on a system. The VOLS command lists the names, capacities, and current usage for all specified volumes in a format that is similar to the Disk Space Analysis Program (DSAP) utility. VOLS [ / OUT listfile / ] [ volset ] volset is: [ \node.] $volume OUT listfile...
Page 251: Volume Guidelines
FUP Commands VOLUME Guidelines node sets the current default node for FUP. You can set the default node only in a named node; for example, a node that is part of a network. volume sets the current default volume name for FUP operations. subvol sets the current default subvolume name for FUP operations.
Page 252: Commands Related To Volume
FUP Commands Commands Related to VOLUME Commands Related to VOLUME COMMAND Function Page SYSTEM Changes the FUP default node name 2-194 File Utility Program (FUP) Reference Manual—523323-014 2-200...
Page 253: Fup Messages
FUP Messages This section describes the text messages that FUP might generate. Each description includes an explanation of what caused the message to be generated, explains the effect the erroneous activity has on the system process, and provides a suggested mode of recovery.
Page 254 FUP Messages ALTERNATE KEY FILE CANNOT BE AN SQL OBJECT Cause. An ALTFILE option specified an SQL object as an alternate-key file. Effect. The operation terminates. Recovery. Retry the command by specifying a valid alternate-key file. AN ALTERNATE KEY FILE HAS NO CORRESPONDING ALTERNATE KEY Cause.
Page 255 FUP Messages Effect. The ASSUMEID attribute is not preserved. Recovery. Use the ALTER command to change the attribute. You might have to use remote logon. ATTEMPT TO RENAME A NONEXISTENT ALTFILE Cause. An attempt was made in DUP rename-options to rename a nonexistent alternate file.
Page 256 FUP Messages Recovery. Variable-length blocks must contain at least two bytes at the beginning of the block. BAD CASE NUMBER Cause. An error occurred in the program logic. Effect. FUP ends abnormally. Recovery. Call your service provider and describe the circumstances under which the error occurred.
Page 257 FUP Messages Effect. The command is not performed on the file. Recovery. Turn off auditing if possible. This command cannot be performed on audited files. CAN'T OPEN TAPE FILE FOR READ ACCESS IF DEFINE VALUE FOR USE IS EXTEND Cause. A TAPE DEFINE was specified with USE set to EXTEND, but the DEFINE name was specified as an input file in either a FUP COPY or LOAD command.
Page 258 FUP Messages Recovery. Informational message; no corrective action is needed. CONSISTENCY CHECK Cause. A check was made of some internal structures. Effect. The command might not finish. Recovery. This message should never appear. If it does, contact your service provider. COULD NOT FIND DEFINE.
Page 259 FUP Messages Recovery. Informational message only; no corrective action is needed. DEFINE DOES NOT MATCH TAPE LABEL OR TAPE LABEL IS BAD Cause. An attempt to open a labeled-tape file failed with file-system error 196 (tape label record missing or incorrect). Effect.
Page 260 FUP Messages Recovery. Retry the LISTLOCKS operation. DRIVE DOES NOT SUPPORT TAPEMODE SELECTION Cause. The TAPEMODE parameter was used for a tape drive that does not support the setting. Effect. The COPY or BUILDKEYRECORDS command continues without trying to set the tape mode.
Page 261 FUP Messages Effect. If the COMPACT option is selected in a COPY or LOAD command, this message indicates that the target file will have fewer records than the source file. The message is issued only when the first empty record is encountered. Recovery.
Page 262 FUP Messages Recovery. Retry the command after correcting the errors. If the file was being updated concurrently, the error might be only a transient structure problem FUP encountered while reading large blocks. ERROR - filename: ERR nnn Cause. A file-system error occurred. filename indicates the name of the file that FUP was attempting to process.
Page 263 FUP Messages Recovery. You cannot use the OLD option for incompatible files. However, you can purge the old file and retry the DUP command. filename : FILE IS BROKEN Cause. An attempt was made to duplicate a broken file. Effect. The indicated file is duplicated, and the broken flag is set. Recovery.
Page 264 FUP Messages Recovery. Write down the complete description and contact your service provider. ILLEGAL CHARACTER Cause. An illegal character was used in the attempted command or ANSI Name is entered specifying an invalid SQL identifier character. Effect. The command fails. Recovery.
Page 265 FUP Messages Cause. A syntax error occurred in the qualified file-set expression. The additional text should describe the specific error. Effect. The command fails. Recovery. Retry the command after correcting the syntax. ILLEGAL SYNTAX Cause. A syntax error occurred in the attempted command. Effect.
Page 266 FUP Messages Recovery. Note the internal load error indicated by nnn, and contact your service provider. INVALID SPI MESSAGE RETURNED BY SERVER Cause. A RELOAD, STATUS, or SUSPEND command received an invalid SPI message from the reload server process. Effect. The command fails. Recovery.
Page 267 FUP Messages Cause. A BUILDKEYRECORDS command contained a key-specifier that is not defined for the file. Effect. The BUILDKEYRECORDS command fails. Recovery. Retry the command with key tags properly defined for the file. LABELED-TAPE SERVER IS NOT AVAILABLE Cause. An attempt to open a tape file failed with file-system error 195 (operation requires use of $ZSVR, but it is not running).
Page 268 FUP Messages Effect. None. Recovery. Informational message only; no corrective action is needed. MISSING KEYWORD Cause. A syntax error occurred. FUP required a keyword but found nothing or something other than a keyword. Effect. The command fails. Recovery. Retype the command, correcting the syntax error. MISSING NUMBER Cause.
Page 269 FUP Messages Cause. An attempt was made to duplicate a partition PARTONLY. FUP detected that the partition data would be reshuffled among the partitions. Effect. The command fails. Recovery. Reissue the command without the PARTONLY option, and convert the file as a whole.
Page 270 FUP Messages Cause. The specified text for the HISTORY, !, or ? command was not found in the buffer. Effect. None. Recovery. Enter the correct text and try the command again. NO SUCH SYSTEM Cause. The attempted command specified a nonexistent node. Effect.
Page 271 FUP Messages Recovery. Retry the command after deleting the character that follows the continuation character. NOT ALLOWED IN BATCH MODE Cause. An operation was attempted in batch mode that can be performed only from a terminal. Effect. None. Recovery. Perform the operation in interactive mode from a terminal. NOT PRIMARY PARTITION Cause.
Page 272 FUP Messages filename : OPEN ERR : nnn Cause. A file-system error was encountered while attempting to open the indicated file. Effect. The command fails. Recovery. For corrective action for the file-system error number indicated by nnn, see the Guardian Procedure Errors and Messages Manual. OPERATION NOT ALLOWED ON SQL OBJECT Cause.
Page 273 FUP Messages OVERFLOW OF TABLE Cause. FUP ran out of internal memory space while trying to execute the command. Effect. FUP ends abnormally. Recovery. Restart FUP, and retry the command. If the same error occurs, call your service provider. OWNER NOT PRESERVED AT DESTINATION Cause.
Page 274 FUP Messages Cause. A DUP operation that did not specify PARTONLY was attempted on a partitioned file, and one of the partitions is an SQL object. Effect. None of the file is duplicated. The DUP operation continues executing on the next file in the file set.
Page 275 FUP Messages Recovery. If the error is not apparent, try using INFO on a file with a similar file set without using a qualified file set. QUALIFIED FILESETS NOT PERMITTED Cause. Qualified file set is either not permitted in this command, or it was used in an incorrect position.
Page 276 FUP Messages Cause. An attempt was made to use the REELS parameter when in-file for the operation was a TAPE DEFINE name with LABELS set to label processing. Effect. The command fails. Recovery. Use the REELS and VOLUME TAPE DEFINE attributes with multiple labeled tapes.
Page 277 FUP Messages Effect. The RESTART operation terminates. Recovery. When you retry the operation, use a valid restart file that has file code 855 or perform an ordinary DUP operation. RESTART FILE NOT ALLOWED ON OPTICAL DISK Cause. For a RESTARTABLE DUP operation or a RESTART operation, the restart file was named explicitly or implicitly (that is, as a default) on an optical disk volume.
Page 278 FUP Messages Recovery. Use the FILESEQ TAPE DEFINE attribute to skip files on a labeled tape. SKIPOUT PARAMETER NOT ALLOWED FOR LABELED TAPES Cause. An attempt was made to use the SKIPOUT parameter when the out-file for the operation was a TAPE DEFINE name with LABELS set to label processing. Effect.
Page 279 FUP Messages Recovery. This is an internal error. Note the error and contact your service provider. SQL RECOMPILATION REQUIRED Cause. A DUP command duplicated an SQL sensitive file. Effect. This is only a warning. The DUP operation proceeds. Recovery. The newly created file should be SQL compiled. TABLE OVERFLOW Cause.
Page 280 FUP Messages Cause. The value of in-file was a TAPE DEFINE name, and the BLOCKLEN value in the DEFINE did not equal the value of the BLOCKOUT FUP parameter. Effect. The command fails. Recovery. Change the BLOCKLEN or BLOCKOUT value and retry the command. TAPE DEFINE VALUE FOR DENSITY CONFLICTS WITH DENSITYOUT Cause.
Page 281 FUP Messages Recovery. Change the RECLEN or RECOUT value and retry the command. TAPE DEFINE VALUE FOR TAPEMODE CONFLICTS WITH FUP PARAMETER Cause. The TAPE DEFINE attribute for TAPEMODE and the FUP parameter for TAPEMODE were both specified, and they conflict. Effect.
Page 282 FUP Messages Recovery. Determine why the tape mount request was rejected, resolve the problem, and retry the command. For the corrective action for file-system error 194, see the Guardian Procedure Errors and Messages Manual. THERE IS NO SUCH ALTERNATE FILE Cause.
Page 283 FUP Messages Recovery. Check the BLOCKIN, RECIN, or input record length values. If truncation is intended, ignore the warning. TRUNCATION OF LAST VARIABLE LENGTH RECORD IN BLOCK Cause. This is a warning message. The VARIN option was used with the COPY or LOAD command, and the last variable-length record in the block was truncated because the record, as indicated by the record length at the beginning of the record, extended beyond the end of the block.
Page 284 FUP Messages Recovery. Check that what you are trying can be done using FUP. If it can, retry the command after correcting any errors in typing. UNIMPLEMENTED FUNCTION Cause. An attempt was made to use a function that is not available. Effect.
Page 285 FUP Messages Recovery. For corrective action, see the Guardian Procedure Errors and Messages Manual. AN ANSI NAME KEYWORD IS EXPECTED LIKE CATALOG, SCHEMA, TABLE OR INDEX Cause. ANSI Name is entered without specifying an ANSI Name keyword. Effect. The command fails. Recovery.
Page 286 FUP Messages Recovery. Retry the command by entering the fully qualified ANSI Name. BAD SQL IDENTIFIER; IDENTIFIER MUST CONTAIN AT LEAST ONE CHARACTER Cause. ANSI Name is entered with a missing SQL identifier. Effect. The command fails. Recovery. Retry the command after adding the required SQL identifiers. BAD SQL IDENTIFIER;...
Page 287 FUP Messages Recovery. None. COMMAND ONLY SUPPORTS TABLE PARTITION and INDEX PARTITION Cause. ANSI Name is entered with TABLE or INDEX in the RELOAD command. Effect. The command fails. Recovery. None. DUPLICATE REQUEST, AN ANSP WAS ACTIVE Cause. Returned when FUP tries to launch one more ANSI Name Server Process (ANSP) when it already has one active ANSP.
Page 288 FUP Messages Cause. ANSI Name is entered without specifying a required starting single quote or if guardian file name is entered after the first ANSI Name. Effect. The command fails. Recovery. Retry the command after adding the required missing single quote. If you have entered the Guardian name along with the ANSI Name in the same command, then retry the command by entering either the ANSI Name or the Guardian name.
Page 289 FUP Messages Recovery. Install the SQL/MX ANSI Names SPR on the system. VERSION MISMATCH BETWEEN SQL/MX MAPPING SOFTWARE AND FUP Cause. There is a version mismatch between FUP and the SQL/MX MAPPING SOFTWARE (SQL/MX ANSI Names mapping service - ANMS). Effect.
Page 290 FUP Messages File Utility Program (FUP) Reference Manual—523323-014 3-38...
Page 291: Table A-1. How Fup Input Options Work With Tape Defines
DEFINE Tables You can use SPOOL, TAPE, or MAP DEFINEs to specify information for a FUP process before you start it:  Use SPOOL DEFINEs to send command output to a spooler.  Use TAPE DEFINEs to send command output to a tape file or receive a tape file as input.
Page 292: Table A-2. How Fup Output Options Work With Tape Defines
DEFINE Tables Table A-2. How FUP Output Options Work With TAPE DEFINEs FUP Parameter FUP Parameter DEFINE FUP Parameter Only and DEFINE Only DEFINE BLOCKOUT BLOCKLEN is FUP quits with BLOCKOUT is BLOCKLEN set to an error if set to BLOCKOUT values conflict BLOCKLEN...
Page 293: Fup Command Summary
FUP Command Summary For a description of the individual function and structure of each FUP command, see Section 2, FUP Commands. Each command fits into one of four distinct command groups: control, information, security, and file management. The FUP commands in this appendix are categorized according to their function.
Page 294: Table B-2. Fup Informational Commands
FUP Command Summary Table B-2. FUP Informational Commands Command Function FILENAMES Displays the names of files. FILES Displays the names of all files in a given subvolume or volume. INFO Displays the file characteristics of one or more files. LISTLOCKS Displays information on all locks (granted or waiting) for a specified file set.
Page 295 FUP Command Summary Table B-4. FUP File Management Commands (page 2 of 2) Command Function DEALLOCATE Deallocates any extents past the end-of-file extent for one or more disk files. DUP[LICATE] Makes a copy of one or more disk files. There are special considerations for duplicating Safeguard protected files.
Page 296 FUP Command Summary File Utility Program (FUP) Reference Manual—523323-014...
Page 297: Fup Command Syntax Summary
FUP Command Syntax Summary To run FUP: FUP [ / run-options / ] [ command ] To specify files, you can use fileset or fileset-list. fileset is: [[[ \node.]$volume.]subvolume.| *.]{file-id | *} fileset-list is: { fileset | ( fileset [ , fileset ] ... ) } ! [ -num | num | string | "quoted"...
Page 298 FUP Command Syntax Summary ALTER filename { , alter-option }... alter-option for all file types is: [ NO ] AUDIT [ NO ] AUDITCOMPRESS [ NO ] BUFFERED BUFFERSIZE unstructured-buffer-size CODE file-code LOCKLENGTH genric-lock-key-length MAXEXTENTS maximum-extents NOPURGEUNTIL timestamp [ NO ] REFRESH RESETBROKEN RESETCORRUPT [ NO ] SERIALWRITES...
Page 299 FUP Command Syntax Summary BUILDKEYRECORDS primary-filename , out-filename , key-specifier-list [ , out-option ] ...key-specifier-list is: { key-specifier { ( key-specifier [ , key-specifier ] ... ) } out-option is: BLOCKOUT out-block-length DENSITYOUT density EBCDICOUT PAD [ pad-character ] RECOUT out-record-length [ NO ] REWINDOUT SKIPOUT num-eofs TAPEMODE mode...
Page 300 FUP Command Syntax Summary COPY in-filename [ ,[ out-filename ] [,copy-option ] ... ] copy-option is: control-option out-option display-option control-option is: COUNT num-records FIRST { ordinal-record-num { KEY { record-spec | key-value } { KEY64 { record-spec } { key-specifier ALTKEY key-value UNSTRUCTURED UPSHIFT in-option is:...
Page 301 FUP Command Syntax Summary COPY continued ... display-option is: O[CTAL] D[ECIMAL] H[EX] BYTE A[SCII] NO HEAD [ NO ] TITLE CREATE filename [ , create-param ] ... (For a description of create-param, see the SET command.) DEALLOCATE fileset-list [ , PARTONLY ] DUP[LICATE] from-fileset-list , to-fileset [ , RESTARTABLE [ restart-filename ] } [ , rename-option ] ...
Page 302 FUP Command Syntax Summary GIVE fileset-list , { groupnum , usernum | groupname.username } [ , PARTONLY ] HELP [ / OUT listfile / ] [ command | ALL [, SYNTAX ] | NEWS ] HISTORY [ / OUT listfile / ] [ num INFO [ / OUT listfile / ] [ fileset-list / ansiname-list ] [ , DETAIL [ , EXTENTS...
Page 303 FUP Command Syntax Summary LOAD in-filename , destination-filename [, load-option]... load-option is: EMPTYOK FIRST PAD [ pad-character ] in-option key-seq-option in-option is: BLOCKIN in-block-length [ NO ] COMPACT EBCDICIN RECIN in-record-length REELS num-reels [ NO ] REWINDIN SHARE SKIPIN num-eofs TRIM [ trim-character ] [ NO ] UNLOADIN VARIN...
Page 304 FUP Command Syntax Summary RELOAD [ / OUT listfile / ] filename / ‘ansiname’ [ [ NO ] DEALLOCATE ] [ , NEW [ , PARTOF $volume [ , RATE percentage ] [ DSLACK percentage ] [ ISLACK percentage ] [ SLACK percentage [ RECLAIM RELOCATE logical-set [ ,physvol ] [ , [ NO ] MIRRORED ]...
Page 305 FUP Command Syntax Summary SET create-param [ , create-param ] ... create-param for all file types is: [ NO ] AUDIT CODE file-code EXT { extent-size { ( pri-extent-size , sec-extent-size ) } FORMAT formatcode LIKE filename [ NO ] REFRESH TYPE file-type create-param for all structured files is: BLOCK data-block-length...
Page 306 FUP Command Syntax Summary (continued from previous page) create-param for files with alternate-key fields is: [ NO ] ALTCREATE ALTFILE ( key-file-number , filename ) ALTKEY ( key-specifier { , altkey-param }... ) where altkey-param is any one of: FILE key-file-number [ NO ] INSERTIONORDER KEYLEN key-length KEYOFF key-offset...
Page 307 FUP Command Syntax Summary (continued from previous page) show-opts is: ALTCREATE ALTFILE [ key-file-number ] ALTFILES ALTKEY [ key-specifier ] ALTKEYS AUDIT AUDITCOMPRESS BLOCK BUFFERED BUFFERSIZE CODE COMPRESS DCOMPRESS FORMAT ICOMPRESS KEYLEN KEYOFF MAXEXTENTS ODDUNSTR PARTONLY PART [ partition-num ] PARTS REFRESH SERIALWRITES...
Page 308 FUP Command Syntax Summary VOLUME [ [\node.]$volume [.subvol ] ] [ subvol FILESET LIST { fileset | ( fileset [ , fileset ] ... ) } FILESET filename [ qualexpr ] where filename can have wild-card characters. SUBVOLSET [ \node.] $volume [.subvol ] | subvol VOLSET [ \node.] $volume FILELIST filename [ , filename ] ...
Page 309 FUP Command Syntax Summary ENTRYSEQUENCED FORMAT1|FORMAT2 INDEX [ SHORTHAND | PROTECTION ] VIEW KEYSEQUENCED LICENSED OPEN PROGID RELATIVE [ PRIMARY | SECONDARY ] PARTITION ROLLFORWARDNEEDED SAFEGUARD SQLPROGRAM TABLE TRUSTED TRUSTME TRUSTSHARED UNSTRUCTURED user-id is: group-name.user-name group-name.* group-number, user-number group-number,* timestamp-field is: CREATIONTIME EXPIRATIONTIME LASTOPENTIME...
Page 310 FUP Command Syntax Summary File Utility Program (FUP) Reference Manual—523323-014 C-14...
Page 311 Glossary abend. The abnormal end of a task or process, or an error condition that can result in the termination of a program. The FUP process terminates with an abend message if it encounters an error in a command. access mode. A specification that determines the different types of operations (read-write, read-only, or write-only) that a process can perform against a file.
Page 312 Glossary byte device to another, or (3) a temporary or dynamic storage facility. It carries both logical (use within a program) and physical connotations. byte. An 8-bit storage unit; the smallest addressable unit of memory representing one alphanumeric character. cache. A portion of memory that temporarily stores an entire directory, a set of names, or a set of files.
Page 313 Glossary Disk Process 2 (DP2) Disk Process 2 (DP2). The portion of the operating system software that performs read, write, and lock operations on disk volumes. The disk process also implements Enscribe and SQL/MP file types; creates TMF audit-trail records; performs logical REDO operations for Remote Duplicate Database Facility (RDF);...
Page 314 The node name is preceded by a backslash (\); for example, \WEST. nonaudited file. A disk file that is not flagged for auditing by the HP NonStop Transaction Management Facility (TMF).
Page 315 Glossary parameter parameter. A name specified in a prepared command for which the user substitutes a value when executing the command. partition. The portion of a partitioned table, index, or physical file that resides on a particular disk volume. physical disk process. A DP2 process. physical file name.
Page 316 To move a logically named file from one physical location on disk to another without changing its logical name. Offline relocation does not preserve opens. rollforward. An HP NonStop Transaction Management Facility (TMF) recovery mechanism that returns a rollforward SQL table, a file, or entire database to its most recent consistent state following a media failure (such as a disk failure).
Page 317 ID 255,255. timestamp. An identifier that indicates when a file was created or modified. HP NonStop Transaction Management Facility (TMF). A product that provides transaction protection and database consistency in demanding online transaction processing (OLTP) and decision-support environments. It gives full protection to transactions that access distributed SQL and Enscribe databases, as well as recovery capabilities for transactions, online disk volumes, and entire databases.
Page 318 Glossary virtual volume process virtual volume process. The SMF process managing a logical volume. This is a process pair. Also known as virtual disk process. volume. A physical storage device (disk) for files on a NonStop system. Volume names always begin with a dollar sign ($). It is the part of the designation that identifies where users store a document.
Page 319 Index Asterisk wild-card character 1-10 AUDIT attribute, restrictions on renaming ALLOCATE command file 2-155 ALLOW command AUDIT option ALTCREATE option, FUP SET 2-175 FUP ALTER ALTER command all file types 2-10 Alternate-key files unstructured files 2-18 attributes not passed when you create FUP COPY 2-53 the primary-key file...
Page 320 Index BYTE format in FUP COPY display 2-56 Defaults BYTE option, FUP ALTER 2-17, 2-169, setting with VOLUME 2-193 2-173 system, changing 2-189 DEFINE attribute 1-21 BLOCKIN option, FUP COPY 2-41 Cache configuration (DP2 volumes), with BUFFERED option 2-167 DELALTFILE option, FUP ALTER 2-15 CHECKSUM command 2-24...
Page 321 Index File (continued) FUP LOAD 2-130 EBCDICIN option FUP RELOAD 2-147 FUP COPY 2-41 loading empty 2-131 FUP LOAD 2-133 partitioned EBCDICOUT option See Partitioned files FUP BUILDKEYRECORDS 2-22 relative FUP COPY 2-46 See Relative file Empty records, copied with FUP Safeguard protected COPY 2-41, 2-52...
Page 322 Index Format 2 (files) KEYOFF option, FUP SET 2-14, 2-172, 2-177 description 1-22 Key-sequenced files example, INFO output 2-108 changing extent sizes 2-16 INFO DETAIL option 2-100 loading data partitioned files 2-17 LOAD example 2-136 qualified file sets 1-15 LOAD option 2-133 SET option 2-168, 2-169...
Page 323 Index MEGABYTE option, FUP ALTER 2-17, Parallel mirror writes 2-170 2-169, 2-174 PART option Messages, FUP runtime FUP DUP 2-65, 2-70 FUP SET 2-172 PARTIAL option, FUP INFO 2-84 Partitioned files NEW option allocating extents, FUP ALLOCATE FUP DUP 2-66 attributes FUP RELOAD 2-148...
Page 324 Index Primary-key files (continued) Record lock, FUP LISTLOCKS display 2-120 specifying for LOADALTFILE 2-137 Records, loading empty 2-131 specifying key value, FUP COPY 2-39 RECOUT option specifying key value, FUP LOAD 2-132 FUP BUILDKEYRECORDS 2-22 Privileged programs FUP COPY licensed with FUP LICENSE 2-116 copy form 2-47...
Page 325 2-40 specifying with LOADALTFILE 2-138 display form 2-56 SORTED option, FUP LOAD 2-134 SOURCEDATE option, FUP DUP 2-67 See HP NonStop Transaction SQL/MP files, handling 1-24 Management Facility (TMF) SQL/MX files, handling 1-27 File Utility Program (FUP) Reference Manual—523323-014 Index-7...
Page 326 Index TRIM option VOLUME command 2-193 FUP COPY 2-44 Volume, changing current default 2-193 cautions on use 2-53 with RECIN option 2-42 FUP LOAD 2-133 Wild-card characters (*, ?) 1-10 TYPE option, FUP SET 2-170 XLATE option UNIQUE option FUP BUILDKEYRECORDS 2-22 effect of altering 2-19...

This manual is also suitable for:

G08 H01 H02

HP T6553 D45 Reference Manual

FUP Overview

1 FUP Overview (Continued)

Tables

2 FUP Commands

2 FUP Commands (Continued)

Examples

2 FUP Commands (Continued)

2 FUP Commands (Continued)

2 FUP Commands (Continued)

Tables (Continued)

2 FUP Commands (Continued)

FUP Messages

A. DEFINE Tables

FUP Command Summary

FUP Command Syntax Summary

Quick Links

Related Manuals for HP T6553 D45

Summary of Contents for HP T6553 D45