FCOPY Reference Manual HP 3000 MPE/iX Computer Systems Edition 3 Manufacturing Part Number: 32212-90008 E1290 U.S.A.
Notice The information contained in this document is subject to change without notice. Hewlett-Packard makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability or fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or for direct, indirect, special, incidental or consequential damages in connection with the furnishing or use of this material.
Contents 1. Introduction Before You Use FCOPY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 2. Using FCOPY Components of an FCOPY Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . "FROM" and "TO" Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FCOPY Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Copying Files to Labeled Tapes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39 Copying Files from Labeled Tapes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40 Deblocking Labeled Tapes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41 Copying Files Between HP 3000 Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . File Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents HEXO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .81 Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .81 File Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .81 Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 OCTAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 File Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .138 JIS/EBCDIK Conversion Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .148 Examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .148 ASCII/BCDIC Conversion Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Preface This manual is designed to serve a wide variety of users, from the occasional MPE V/E or MPE XL user to the experienced system operator. Because FCOPY runs in almost exactly the same way on MPE V/E and MPE XL, this manual is used for both systems. MPE V/E and XL systems both support a KSAM tofile that consists of a pair of key and data files. It is referred to on MPE V/E as KSAM V/E or KSAM/3000, and on MPE XL as CM KSAM. MPE XL also supports a single file format, called KSAM XL.
Manual Organization The information in the manual is presented as follows: Chapter 1 Introduction describes how to use the manual. Chapter 2 Using FCOPY gives an overview of the FCOPY command and lists the FCOPY functions. Chapter 3 FCOPY Applications and Examples provides instructions for using FCOPY and gives examples of typical transactions. Chapter 4 FCOPY Syntax summarizes the syntax of the FCOPY command and the FCOPY functions.
How to Use This Manual The manual is organized into three major parts. • Chapters 1 through 3 explain how to use FCOPY. Chapter 3 contains several examples, so you might look at chapter 3 when you have a specific task to perform, and follow an example before carrying out your task. Read these chapters first if you are a new FCOPY user. • Chapters 4 through 6 contain the FCOPY syntax and descriptions of all the FCOPY functions.
Additional Information You may also find the following manuals useful: • MPE V General User's Reference Manual for MPE V/E. • MPE V/E Commands Reference Manual or MPE XL Commands Reference Manual. • MPE Intrinsics Reference Manual for MPE V/E or MPE XL Intrinsics Reference Manual for MPE XL. • MPE File System Reference Manual for MPE V/E or Accessing Files Programmer's Guide ) for MPE XL. • KSAM/3000 Reference Manual for KSAM/3000 files on MPE V/E and for CM KSAM files on MPE XL.
Introduction 1 Introduction This manual describes the HP 3000 file copy utility, FCOPY/3000. FCOPY is a utility program within the HP 3000 multiprogramming executive operating systems (MPE V/E and MPE XL) that lets you copy data from one file to another. This manual covers the use of FCOPY on MPE V/E and on MPE XL, since FCOPY works the same way on both operating systems. Because MPE V/E and MPE XL treat devices as files, you can use FCOPY to copy data from any input device to any output device.
Introduction Before You Use FCOPY Before You Use FCOPY In order to use FCOPY you should have a working knowledge of the following aspects of MPE: • The MPE account structure. • File security. • How to specify and modify file characteristics. • File and device relationships. • How to run jobs and sessions.
Using FCOPY 2 Using FCOPY You use FCOPY by issuing commands that identify the files you want to copy and the way in which you want to copy them. This chapter describes the components of an FCOPY command, how to identify the files that you reference in a command, how to issue an FCOPY command, and the type of message you might see in response to a command.
Using FCOPY Components of an FCOPY Command Components of an FCOPY Command You can issue an FCOPY command in several ways, but, whichever method you choose, the command always has the same components. It identifies a fromfile, a tofile, and one or more functions that you want FCOPY to perform. You enter the FCOPY subsystem from MPE by typing FCOPY at the MPE colon prompt (:). At the FCOPY prompt (>), you set up the command.
Using FCOPY Components of an FCOPY Command You specify a tofile with the TO parameter. TO has the following format in MPE V/E: ;TO[={(datafile,keyfile) tofile * * }] The value that you assign to TO can be the names of data and key files for a new KSAM V/E file (datafile and keyfile); the name of the output file (tofile); an asterisk (*) plus a file name, if desired; an asterisk; or nothing at all ().
Using FCOPY Components of an FCOPY Command Table 2-1. FCOPY Functions Function 18 Description BCDICIN Translates from BCDIC to ASCII BCDICOUT Translates from ASCII to BCDIC CCTL Specifies the first character of each record as a carriage control character in tofile CHAR Displays the contents of a file as ASCII symbols CLEAR Displays the contents of a file as character codes COMPARE Compares two files COPYACD Copies an ACD associated with a file (available on MPE XL release 3.
Using FCOPY Components of an FCOPY Command Table 2-1.
Using FCOPY Defining Files Defining Files If you are copying files from or to devices other than disk, you must define the files and their associated devices with MPE FILE commands before you issue an FCOPY command. For example, to copy a file from magnetic tape to a line printer, you define two device files as follows: FILE TAPEFILE;DEV=TAPE;REC=-80,25,F,ASCII FILE PRINTER;DEV=LP TAPEFILE and PRINTER are the formal file designators you use in the FCOPY command.
Using FCOPY General Guidelines General Guidelines An FCOPY command must follow these general guidelines: Semicolons always separate the different components of a command. You can leave spaces between components. However, there can be no more than 70 characters between two semicolons. The three examples of an FCOPY command shown below are all valid.
Using FCOPY Issuing an FCOPY Command Issuing an FCOPY Command You can issue an FCOPY command directly from MPE, or you can enter the FCOPY subsystem and issue one or more commands before returning to MPE. Using FCOPY from MPE You can issue a single FCOPY command directly from MPE using either the RUN or FCOPY command. If you use the RUN command, include FROM, TO, and any functions you want in the INFO=" " parameter. For example: RUN FCOPY.PUB.
Using FCOPY Issuing an FCOPY Command type the MPE command. This feature of FCOPY is handy when you wish to use the FILE command to define the files you intend to copy. For example, >:FILE PRINTER;DEV=LP >FROM=A;TO=*PRINTER Using FCOPY in a Job You can use the MPE STREAM command to create jobs that contain FCOPY commands. Follow the instructions for streaming jobs in the MPE V/E Commands Reference Manual (32033-90006) or the MPE XL Commands Reference Manual (32650-90003).
Using FCOPY Customizing Commands Customizing Commands By combining FCOPY functions and using different forms of the functions, you can use FCOPY for many purposes. The examples in chapter 3 illustrate how to use FCOPY commands for several common situations. If you cannot find the task you need to perform in chapter 3, use the steps described below to find the information you need.
Using FCOPY FCOPY Messages FCOPY Messages FCOPY displays three types of messages: status, warning, and error messages. Status messages report on the progress of a copying operation. Warning messages warn you of problems that were not serious enough to cause an operation to terminate. Error messages report errors that caused an FCOPY command to terminate (in a session) or caused the FCOPY subsystem to terminate (in a job stream). For more information on FCOPY messages, refer to appendix A.
Using FCOPY FCOPY Messages 26 Chapter 2
FCOPY Applications and Examples 3 FCOPY Applications and Examples This chapter contains instructions for using FCOPY and its functions for several common purposes. It also provides examples of these operations. Although it explains the use of several FCOPY functions, it does not completely describe the characteristics of any function. Refer to chapter 5 for complete descriptions of FCOPY functions.
FCOPY Applications and Examples Copying Files Copying Files You can use FCOPY to create new files, append one or more files onto an existing file, or extract portions from files. New Disk Files To create a new disk file as you copy information to it, use the NEW function. For example, >FROM=OLDDATA;TO=NEWDATA;NEW In this example, the new file called NEWDATA has the default file characteristics described in appendix B and exists in the current account and group.
FCOPY Applications and Examples Copying Files Extracting Parts of Files Use the SUBSET function to extract portions of a file. You can define a subset as a set of continuous records or as a set of records with a certain pattern of characters or numbers. For example, a file may contain information about the employees in your company. Each record in the file describes one employee, and the employee's last name begins in column 1 of each record.
FCOPY Applications and Examples Displaying Disk Files Displaying Disk Files You display the contents of your files by copying them to your terminal. FCOPY displays files in the following formats: • Character. • Octal. • Hexadecimal. ASCII Files If you know that the file is an ASCII file, simply copy it to your terminal by leaving TO empty. For example, >FROM=ASCITEST;TO= This is an ASCII file. It contains two lines of text.
FCOPY Applications and Examples Displaying Disk Files Binary Files To display the contents of a binary disk file at your terminal, do the following: 1. Leave the TO parameter empty. 2. Use the HEX or OCTAL function to display the hexadecimal or octal representation of the file's contents. Use the CHAR function to display any ASCII characters that may exist. For example, you might use the commands below to display a file on your terminal.
FCOPY Applications and Examples Printing Files Printing Files You can print a file by copying it to a printer. For example, suppose you ran a program or utility that normally displays messages on your terminal, but you redirected the program's output to a disk file to save it for later study. To print such a file, use FCOPY to copy it to a printer. Printing an ASCII File: To print an ASCII file, follow these steps: 1. Use the MPE FILE command to define a file name for your printer.
FCOPY Applications and Examples Using Your Terminal as a Fromfile Using Your Terminal as a Fromfile You can enter a small amount of information into a file directly from your terminal keyboard. (You may enter a large amount if you want to, but that is easier with an editor). To copy information from your terminal: 1. Leave the FROM parameter empty. If the tofile is a new disk file, use the NEW function. For example, >FROM=;TO=NEWFILE;NEW 2. FCOPY waits for you to enter records at your terminal.
FCOPY Applications and Examples Copying Files of Varying Sizes Copying Files of Varying Sizes You can determine the block size of a file by multiplying its record size by its block factor. To copy a file when you do not know the block size or when the block size varies (as it could on a magnetic tape), use records of undefined length for both files. In the file equations, specify a record size at least as large as the largest record you expect.
FCOPY Applications and Examples Copying Tapes Copying Tapes The general methods for copying tapes described in this chapter apply to unlabeled magnetic tapes, serial disks, and cartridge tapes. If you need to copy files from or to labeled tapes, refer to the instructions for using labeled tapes later in this chapter. NOTE Labeled tapes must be used if the file being written will extend beyond one reel.
FCOPY Applications and Examples Copying Tapes terminate if it encounters more than five errors. >FROM=*TAPE;TO=DISC3;IGNERR=5 Comparing Files To compare the contents of two files without changing either file, use the COMPARE function. You can compare the contents of a disk file and a tape file or the contents of two files stored on tape. As with the IGNERR function, COMPARE lets you specify a number of errors after which it terminates. The default is 1.
FCOPY Applications and Examples Copying Tapes old blocking factor. For example, a block of ten 79-byte records would be represented as a 790-byte record with a blocking factor of 1: >:FILE TAPEFILE;REC=-790,1,U,ASCII 2. In the FCOPY command, set DEBLOCK equal to the original record length.
FCOPY Applications and Examples Copying Tapes >:FILE AMALGAM;ACC=APPEND;REC=-80,16,F,ASCII;DISC=5000 2. Use a second FILE command to describe the tape file. For example, >:FILE T;DEV=TAPE;REC=-80,1,F,ASCII 3. Copy the first tape file to the disk file. Precede the file names with asterisks to reference the two file commands. If you intend to copy only a subset of the tape file, use the SUBSET function. For example, the command below copies all records with the character "C" in column 1.
FCOPY Applications and Examples Copying Labeled Tapes Copying Labeled Tapes Instructions for copying to and from labeled tapes are given below, as well as an example of how to deblock a labeled tape. Copying Files to Labeled Tapes The default parameter NEXT specifies that a file is to be written to the current position on the tape. If this is a newly mounted tape, the position will be the beginning of the tape. To copy a single file starting at the beginning of the tape: 1.
FCOPY Applications and Examples Copying Labeled Tapes EOF FOUND IN FROMFILE AFTER RECORD 9 10 RECORDS PROCESSED * * * 0 ERRORS The parameter ADDF specifies that a file is to be written following all existing files on the tape. To add a new file to a tape without overwriting existing files, perform the following steps: 1. Use the ADDF parameter in the MPE FILE command. ADDF positions the tape drive after the last file on the tape. For example, >:FILE LT2=FILE4;DEV=TAPE;LABEL=TLABEL,ANS,,ADDF 2.
FCOPY Applications and Examples Copying Labeled Tapes >FROM=*LTNAME;TO=FILED;NEW EOF FOUND IN FROMFILE AFTER RECORD 9 10 RECORDS PROCESSED * * * 0 ERRORS Concatenating Files from a Labeled Tape You can concatenate files from a labeled tape into a single file, as follows: 1. Use the NEXT parameter in the MPE FILE command describing the tape. For example, >:FILE LTAPE;DEV=TAPE;LABEL=TLABEL,ANS,,NEXT;REC=-80,10,F,ASCII 2.
FCOPY Applications and Examples Copying Files Between HP 3000 Systems Copying Files Between HP 3000 Systems You can use magnetic tapes to copy disk files from one HP 3000 system to another. If all files on a single tape have the same record size and type, copy the files from the first system to tape. Then copy the tape files onto the second system, as follows: 1. Issue an MPE FILE command describing the tape to which you want to copy the disk files. You must specify the record size and structure.
FCOPY Applications and Examples Copying Files Between HP 3000 Systems 4. Copy the files from tape to disk. Use an asterisk to backreference the FILE command describing the tape drive. Use SKIPEOF=,+1 to position the tape at the beginning of the next file.
FCOPY Applications and Examples Copying Foreign Tapes Copying Foreign Tapes Tapes written on foreign machines often have to be read on HP 3000 systems. If you don't know the exact data format, here are some ideas that might help you determine what it is. 1. Mount the tape on your HP 3000 (without a write ring). The automatic volume recognition message tells you if it is labeled, and if so, what the label is.
FCOPY Applications and Examples Remote Copies Remote Copies The following example copies a local file to a line printer connected to a remote system. First, the line must be made available. 1. After you have logged on, at the MPE colon prompt (:) type DSLINE nodename to open the line. 2. Log on to the remote system by typing REMOTE HELLO user.account at the prompt, as follows: DSLINE nodename REMOTE HELLO user.account 3.
FCOPY Applications and Examples Copying KSAM Files Copying KSAM Files If your system supports the KSAM/3000 subsystem, you can use FCOPY to copy KSAM files. With some exceptions, you can copy KSAM files in the same way that you copy regular HP 3000 files. The functions SKIPEOF, IGNERR, and SUBSET do not apply to KSAM files. The KEY option applies to all KSAM files. The NOKSAM option applies only to KSAM V/E and CM KSAM files.
FCOPY Applications and Examples Copying KSAM Files For example, >FROM=OLDKSXL;TO=(NEWKSAM,NEWKSAMKEY) FCOPY estimates the size of the keyfile if you use the NEW option. Copying from CM KSAM Files to KSAM XL Files You can copy a CM KSAM file to a KSAM XL file on an MPE XL system using the FROM and TO parameters as described under "Copying to Existing KSAM Files" above, with these stipulations: • The tofile must be specified as an existing KSAM XL file, unless you are creating a new file.
FCOPY Applications and Examples Copying KSAM Files Copying to a Non-KSAM File To copy data in a particular key sequence from a KSAM file to a non-KSAM file, use the KEY function. For example, the command below copies the data file of the KSAM V/E file KSAM7 to the disk file DATA in the order determined by the key beginning in location 20 of the KSAM7 data file: >FROM=KSAM7;TO=DATA;KEY=20 To copy the data file of a KSAM V/E or CM KSAM file to a non-KSAM file, use the NOKSAM and NOUSERLABELS functions.
FCOPY Applications and Examples Copying Inactive Records Copying Inactive Records The file system marks inactive records in relative I/O (RIO) and in message files. Normally when you copy such a file, FCOPY does not copy inactive records. To copy exactly an RIO or message file, including inactive records, follow these steps: 1. Specify NOBUF and COPY in FILE commands describing both the fromfile and tofile. For example, >:FILE OLD;NOBUF;COPY >:FILE NEW;NOBUF;COPY 2.
FCOPY Applications and Examples Copying Files in Native Languages Copying Files in Native Languages You can use the LANG parameter with four FCOPY functions to copy files in a particular native language. The four functions are CHAR, EBCDICIN, EBCDICOUT, and UPSHIFT. You can use LANG to describe a language name or number in the form: LANG=language where language represents a language name or number. The language you specify must be installed on your system.
FCOPY Syntax 4 FCOPY Syntax This chapter summarizes the syntax of the FCOPY command and the FCOPY functions. The prompt in the FCOPY subsystem is >.
FCOPY Syntax FCOPY Command Syntax FCOPY Command Syntax This is the syntax for the FCOPY command. FROM [ = {fromfile * * } ];TO [ = { {(datafile,keyfile) (tofile) } tofile * * } ] [; functionlist ] where: fromfile Is the name of the input file. tofile Is the name of the output file. (tofile) Is the name of a KSAM XL file. (datafile,keyfile) Are the names of the data and key files of a new KSAM V/E or CM KSAM file.
FCOPY Syntax Syntax of FCOPY Functions Syntax of FCOPY Functions This section shows the syntax for each FCOPY function. For convenience, functions that share the same syntax (for example, HEX, HEXO, and OCTAL) are grouped together. For more information on a particular function, refer to chapter 5.
FCOPY Syntax Syntax of FCOPY Functions 54 Chapter 4
FCOPY Functions 5 FCOPY Functions This chapter describes each of the FCOPY functions in detail. It presents the functions in alphabetical order, so you can find information about a function quickly. If you do not know the name of the function you need to use, look up the task you want to perform in the index at the end of the manual. The description of each function includes its syntax, instructions for using it, with restrictions (if any) and examples for its use.
FCOPY Functions BCDICIN/BCDICOUT BCDICIN/BCDICOUT BCDICIN translates code from BCDIC to ASCII. BCDICOUT translates code from ASCII to BCDIC. Syntax ;{BCDICIN BCDICOUT} [={field (field[;field[;...] ] ) } [,EXCLUDE] ] Where: field Is a single unsigned integer or a pair of unsigned integers, representing column numbers within the records in the form a; a, b; or a:b. (The first column of a record is column #1.
FCOPY Functions BCDICIN/BCDICOUT Restrictions You cannot use BCDICOUT with CHAR, CLEAR, KANA, OCTAL, HEXO, or HEX. Notes When you use BCDICIN or BCDICOUT with the SUBSET function, the system makes conversions first. Five BCDIC character codes can be converted to ASCII in either of two ways. FCOPY translates them as shown in table 5-1: Table 5-1. BCDIC to ASCII Conversion BCDIC ASCII & and + + % and ( ( # and = = @ and ' ' Refer to appendix C for a complete list of conversion codes.
FCOPY Functions CCTL/NOCCTL CCTL/NOCCTL CCTL designates the first character of each record in the fromfile as a carriage control character in the tofile. NOCCTL specifies that the first character of each record in the fromfile is not to be used as a carriage control character in the tofile. Syntax ;{CCTL NOCCTL} Operation The effect of CCTL or NOCCTL depends upon whether or not the file equations or disk labels of the files you are copying specify carriage control.
FCOPY Functions CCTL/NOCCTL Table 5-3 shows the effect of using the CCTL function with files that have CCTL or NOCCTL specified. When an equation or disk file label for the tofile specifies NOCCTL (no carriage control) and an FCOPY command specifies CCTL, the NOCCTL specification in the file equation or disk label overrides the FCOPY command. NOTE Asterisks (***) show where a file equation or disk label overrides the FCOPY command in tables 5-3 and 5-4. Table 5-3.
FCOPY Functions CCTL/NOCCTL Examples ALPHA is a disk file, and its label specifies the CCTL option. BETA is a disk file created without CCTL.
FCOPY Functions CHAR CHAR Displays the contents of a file, record by record, in the form of character symbols in ASCII code. CHAR displays character codes not represented by symbols in ASCII code as decimal points. Syntax ;CHAR [;{HEX HEXO OCTAL} ] [;NORECNUM] [;TITLE=title] [;LANG=language] Where: OCTAL Displays octal codes. Refer to the description of OCTAL in this section. HEX Displays hexadecimal codes. Refer to the HEX description in this section.
FCOPY Functions CHAR The tofile can be a printer, terminal, or an intermediate disk file. If the tofile is a disk file, its records must be at least 60 bytes in length. If you do not specify NORECNUM and words are repeated in the file, FCOPY suppresses the duplicate lines and displays a message in the form SAME TO XXXX-1, where XXXX is in octal.
FCOPY Functions CHAR 00030: SAME: TO 000044-1 DISPL RECORD 2 (%2, #2) 00000: 015446 062104 052150 00010: 020165 067144 062562 00020: 020040 020040 020040 00030: SAME: TO 000044-1 EOF FOUND IN FROMFILE AFTER 064563 020154 064556 062440 064563 .&dBThis line is| 066151 067145 062056 015446 062100 underlined..
FCOPY Functions CLEAR CLEAR Displays the contents of a file, record by record, in the form of character symbols for all codes in the file. The graphic representation of each code depends upon how the displaying device interprets the code: whether as a command, a displayable character, or a nondisplayable character. If an output device interprets a code as a command, it displays nothing unless you have entered a "display functions" mode at a terminal that has such a mode.
FCOPY Functions CLEAR The tofile can be a printer, terminal, or an intermediate disk file. If the tofile is a disk file, it must be at least 60 bytes in length. If you do not specify NORECNUM and there are words repeated in the file, FCOPY suppresses the duplicate lines and displays a message in the form SAME TO XXXX-1, where XXXX is in octal. This is shown in the example below.
FCOPY Functions CLEAR 00010: 020165 067144 062562 066151 067145 062056 015446 062100 underlined..
FCOPY Functions COMPARE COMPARE Compares the contents of the fromfile with the contents of the tofile, record by record, without changing either file. Syntax ;COMPARE [=number-of-errors] Where: number-of-errors Is an integer designating the number of mismatches after which FCOPY should terminate. The default value is 1. File Attributes The fromfile and the tofile must both have read access.
FCOPY Functions COPYACD COPYACD Copies the access control definition (ACD) associated with a file when the file is being copied. NOTE COPYACD applies only to MPE V/E Delta 4 and subsequent releases. COPYACD is the default on MPE XL release 3.0 or later. Syntax ;COPYACD Operation If the fromfile has an access control definition (ACD) and the user is authorized to copy that file, both the fromfile and the ACD are copied to the tofile.
FCOPY Functions DEBLOCK DEBLOCK Lets you deblock blocked records. For example, you can use DEBLOCK to make smaller records from larger ones or to copy files from systems with records that are not aligned on two-byte word boundaries. Syntax ;DEBLOCK=logical-record-length Where: logical-record-length Is a signed integer representing the length of each logical record in the tofile. A positive integer represents the length in two-byte words, and a negative integer represents the length in bytes.
FCOPY Functions DEBLOCK If you deblock labeled tapes, you must specify "undefined" records in the FILE command describing the tape file. For example: FILE TAPEBYTE;DEV=TAPE;LABEL=TLABEL;REC=-6000,1,U,ASCII Example The example below copies a file from tape to disk. The original tape file, TAPEBYTE, is a foreign tape that has records grouped in 79-byte blocks, and its blocking factor is 10.
FCOPY Functions EBCDICIN/EBCDICOUT EBCDICIN/EBCDICOUT EBCDICIN translates code from EBCDIC to the character code specified in the translation table of the language you select. EBCDICOUT translates code from the character code specified in the translation table of the language you select to EBCDIC. When you do not specify a language, EBCDICIN translates code from EBCDIC to ASCII, and EBCDICOUT translates code from ASCII to EBCDIC. Syntax ;{EBCDICIN EBCDICOUT}[={field (field[;field [;...
FCOPY Functions EBCDICIN/EBCDICOUT You can select any language installed on your system. The default is NATIVE-3000. For more information, refer to the Native Language Support Reference Manual (32414-90001) for MPE V/E or the Native Language Programmer's Guide (32650-90022) for MPE XL. The field and EXCLUDE parameters let you select the portion of the file that you want to translate. If you do not specify fields or EXCLUDE, the system converts all data within each record in the file.
FCOPY Functions EBCDIKIN/EBCDIKOUT EBCDIKIN/EBCDIKOUT EBCDIKIN translates code from EBCDIK (IBM Standard) to JIS (Japanese Industrial Standard). EBCDIKOUT translates code from JIS to EBCDIK. Syntax ;{EBCDIKIN EBCDIKOUT} [={field (field[;field[;...] ]) }[,EXCLUDE] ] Where: field Is a single unsigned integer, or a pair of unsigned integers representing column numbers within the records in the form a; a, b; or a:b. (The first column of a record is column #1.
FCOPY Functions EBCDIKIN/EBCDIKOUT Restrictions You cannot combine EBCDIKOUT with the CHAR, CLEAR, KANA, OCTAL, HEX, or HEXO functions. Notes When you use EBCDIKIN with the SUBSET function, the system makes the conversions first. Refer to appendix C for a complete list of conversion codes. The maximum number of fields you can specify is 255. FCOPY does not translate user labels when translating a file.
FCOPY Functions FILES FILES Lets you copy multiple files from labeled and unlabeled magnetic tapes, serial disks, and cartridge tapes. FCOPY copies only one file if you do not use the FILES function. Syntax ;FILES={number-of-files ALL } Where: number-of-files Is an integer specifying the number of files to be copied. Specifies that all files from the current file to the end of the tape be copied.
FCOPY Functions FILES Figure 5-3. Copying Subsets of Files to Tape If you use the FILES function together with the SKIPEOF function, FCOPY positions the tape as specified with SKIPEOF first. If the fromfile is an unlabeled tape, there is no standard that defines the mark used at the end of the last file on the tape. If you copy such a tape with FILES=ALL, the copy proceeds until an error occurs from trying to read unrecorded media.
FCOPY Functions FILES Copying Files on Labeled Tape Unless you want to copy the same labeled tape file repeatedly, use NEXT as the sequence option for the LABEL parameter in the fromfile tape's file equation. For example, the commands below copy subsets of three files from labeled tape TAPEALFA to TAPEBETA, as shown in figure 5-4. >:FILE TAPEALFA;LABEL=,,,NEXT >:FILE TAPEBETA;LABEL=,,,NEXT >FROM=*TAPEALFA;TO=*TAPEBETA;FILES=3;SUBSET=11:25 Figure 5-4.
FCOPY Functions FILES Figure 5-5. Copying from a Single Labeled Tape File For more information on the sequence options of the FILE command, refer to the FILE command in the MPE V/E Commands Reference Manual (32033-90006) or the MPE XL Commands Reference Manual (32650-90003). Refer to chapter 3 for examples of using FCOPY with labeled tapes.
FCOPY Functions HEX HEX Displays the contents of a file, record by record, as character code numbers in hexadecimal form. Syntax ;HEX [;{CHAR CLEAR KANA} ] [;NORECNUM] [;TITLE=title] Where: CHAR Displays character symbols in ASCII code. Refer to the CHAR description in this chapter. CLEAR Displays all character symbols. Refer to the CLEAR description in this chapter. KANA Displays JIS character symbols. Refer to the KANA description in this chapter.
FCOPY Functions HEX The example displays the file TEXT3 in both hexadecimal and character format. Since it does not specify a language for the CHAR function, FCOPY uses the default, NATIVE-3000. (Refer to the CHAR description in this chapter.) FCOPY prints the title line described by the title parameter. >FROM=TEXT3;TO=*LP;HEX;CHAR; & TITLE="EXAMPLE OF CHAR/HEX DISPLAY" EXAMPLE OF CHAR/HEX DISPLAY TEXT3.PUB.
FCOPY Functions HEXO HEXO Displays the contents of a file, record by record, in the form of character code numbers. The data is in hexadecimal form and the record number is in octal form. Syntax ;HEXO [;{CHAR CLEAR KANA}] [;NORECNUM] [;TITLE=title] Where: CHAR Displays character symbols in ASCII code. Refer to the CHAR description in this chapter. CLEAR Displays all character symbols. Refer to the CLEAR description in this chapter. KANA Displays JIS character symbols.
FCOPY Functions HEXO Example In the example below, file TEXT3.PUB.ACCOUNT is an ASCII file created by using EDIT/3000. The octal word number at the beginning of each line of data specifies the sequential number within the record of the first word of data in the line. The example displays the file TEXT3 in both hexadecimal and character format. Because it does not specify a language for the CHAR function, FCOPY uses the default, NATIVE-3000 (refer to the CHAR description in this chapter).
FCOPY Functions IGNERR IGNERR Bypasses errors in a magnetic tape fromfile and counts ignored errors up to a specified maximum. Syntax ;IGNERR [=number-of-errors] Where: number-of-errors Is an integer specifying the maximum number of errors to be ignored. If the number of errors exceeds the maximum, the operation terminates. File Attributes The fromfile must be a magnetic tape unit with read access, and the tofile must have write access. Operation You can use IGNERR only with magnetic tape fromfiles.
FCOPY Functions KANA KANA Displays the contents of a file, record by record, in the form of JIS character symbols. KANA displays symbols not represented by characters in JIS code as decimal points. Syntax ;KANA [;{HEX HEXO OCTAL}] [;NORECNUM] [;TITLE=title] Where: OCTAL Displays octal codes. Refer to the OCTAL description in this chapter. HEX Displays hexadecimal codes. Refer to the HEX description in this chapter. HEXO Displays the data in hexadecimal and the record number in octal.
FCOPY Functions KEY KEY Lets you choose a key sequence in which to copy KSAM files. The KEY function works with KSAM V/E, CM KSAM, and KSAM XL fromfiles. Syntax ;KEY [=character-location] Where: character-location Is a positive integer that identifies the key by the location of its starting character in the data file. The key may be a primary or an alternate key. File Attributes The fromfile must be a KSAM file.
FCOPY Functions KEY which the records were written to the file: >FROM=KSAM1;TO=DUPL1;KEY=0 86 Chapter 5
FCOPY Functions NEW NEW Creates a new permanent disk file as the tofile. Syntax ;NEW Operation The new file is created in the account and group specified at the start of your job or session (unless otherwise specified). Its name is the name specified with the TO parameter. File Characteristics The default characteristics of the new disk file are summarized in appendix B.
FCOPY Functions NOACD NOACD Does not copy the access control definition (ACD) associated with a file when the file is being copied. NOTE NOACD applies only to MPE XL release 3.0 and subsequent releases. Syntax ;NOACD Operation If the fromfile has an access control definition (ACD) and the user is authorized to copy that file, only the fromfile is copied to the tofile. NOTE On MPE XL release 3.0 or later, COPYACD is the default parameter. To keep the ACD from copying, NOACD must be used.
FCOPY Functions NOKSAM NOKSAM Copies the data file of a KSAM V/E or CM KSAM file into another, non-KSAM file. This option is not valid for KSAM XL files. Syntax ;NOKSAM File Attributes The fromfile must be a KSAM V/E or CM KSAM file. The tofile cannot be a new KSAM file. Operation Use the NOUSERLABELS option together with NOKSAM to prevent FCOPY from copying KSAM user labels. Restrictions You cannot use NOKSAM with the KEY function.
FCOPY Functions NOUSERLABELS NOUSERLABELS Lets you omit user labels when copying from a tape or disk file to another file. Syntax ;NOUSERLABELS Operation If you do not specify NOUSERLABELS and both the fromfile and tofile are labeled, FCOPY copies the fromfile labels to the tofile labels. Use NOUSERLABELS when copying from tape to disk, or disk to tape, to prevent FCOPY from changing the user label. A disk file's user label is 256 bytes long, while a tape file's user label is 80 bytes long.
FCOPY Functions OCTAL OCTAL Displays the contents of a file, record by record, as character code numbers in octal form. Syntax ;OCTAL [;{CHAR CLEAR KANA}] [;NORECNUM] [;TITLE=title] Where: CHAR Displays character symbols in ASCII code. Refer to the CHAR description in this chapter. CLEAR Displays all character symbols. Refer to the CLEAR description in this chapter. KANA Displays JIS character symbols. Refer to the KANA description in this chapter.
FCOPY Functions OCTAL The command below produces the following display on an 80-column line printer: >FROM=TEXT3;TO=*LP;OCTAL TEXT3.PUB.
FCOPY Functions OCTAL The following example combines octal and character display. >FROM=TEXT3;TO=*LP;OCTAL; CHAR; & TITLE="EXAMPLE OF CHAR/OCTAL DISPLAY" The command produces the following display. The 8-digit numbers at the end of each record are text editor line numbers, starting at 1. EXAMPLE OF CHAR/OCTAL DISPLAY TEXT3.PUB.
FCOPY Functions SKIPEOF SKIPEOF Instructs FCOPY to skip end-of-file (EOF) markers on a serial storage device in order to position the device at the desired file before copying. Syntax ;SKIPEOF=[{+ -}from-eofs from-file-number][,{ {+ -}to-eofs to-file-number}] Where: +/− Specifies forward (+) or reverse (−) movement. from-eofs Is a positive integer specifying how many files to skip on the "from" device. from-file-number Is an integer specifying an absolute file number on the "from" device.
FCOPY Functions SKIPEOF Figure 5-6. Skipping Absolute File Numbers If you specify zero as a from-file-number or a to-file-number, FCOPY copies from or to the first file on the tape or serial disk. Relative File Numbers Both from-eofs and to-eofs represent the number of files to skip relative to the tape's current position. If you use a plus sign (+) to specify forward movement, the SKIPEOF function skips forward over the specified number of EOF marks. Figure 5-7 shows the effect of specifying SKIPEOF=+3.
FCOPY Functions SKIPEOF Figure 5-8. SKIPEOF=−3 If you specify +0 or −0 for either of these parameters, SKIPEOF positions the tape at the beginning of the current file, as illustrated in figure 5-9. Figure 5-9.
FCOPY Functions SKIPEOF where skipping begins on *TAPE2, FCOPY copies data to its seventh file: >FROM=*TAPES;TO=*TAPE2;SKIPEOF=+3,7 The FCOPY command below skips to the fifth file of *TAPEA and positions *TAPEB four files back from its current position. FCOPY copies file #5 of *TAPEA to the selected file on *TAPEB: >FROM=*TAPEA;TO=*TAPEB;SKIPEOF=5,-4 If you are copying several files from or to the same device, you can use an asterisk (*) to refer to the "from" or "to" device in the previous command.
FCOPY Functions SUBSET SUBSET Lets you copy only a specific portion, or subset, of a file. You can define the subset in one of two ways, either as all records with a certain character string or numeric pattern beginning in a specific column, or as a set or sets of continuous records. Syntax ;SUBSET[= "characterstring"[,column] [,EXCLUDE] = #patternlist #[,column] [,EXCLUDE] = (range[;range] [;...]) ] Where: characterstring Is a string of ASCII characters.
FCOPY Functions SUBSET A pattern list is a set of octal or decimal numbers, each representing one byte. A pattern list is delimited by number signs (#), and can contain no more than 35 integers. You can continue a pattern list from one line or record to the next, but you cannot specify the continuation between elements of an individual pattern. Each decimal integer must be within the range 0 through 255, and each octal integer must be within the range 0 through 377.
FCOPY Functions SUBSET Using SUBSET with DEBLOCK If you use SUBSET with DEBLOCK, FCOPY copies subsets from the deblocked records.
FCOPY Functions UPSHIFT UPSHIFT Converts lowercase Roman alphabetic characters to uppercase as part of the copying operation. Syntax ;UPSHIFT [;LANG=language] Where: language Is the name or number of a supported language. FCOPY uses the translation associated with that language. The default is NATIVE-3000. For more information, refer to the Native Language Support Reference Manual (32414-90001) for MPE V/E or the Native Language Programmer's Guide (32650-90022) for MPE XL.
FCOPY Functions VERIFY VERIFY Compares the contents of the tofile with the contents of the fromfile, record by record, immediately after a copy operation. The two files must reside on either disk or magnetic tape and must have identical record characteristics, that is, record size, format (fixed, variable, or undefined), and type (ASCII or binary).
Using FCOPY with Terminal Peripherals 6 Using FCOPY with Terminal Peripherals Some HP 3000 terminals have their own peripheral devices. Terminal peripheral devices include cartridge tape units, mini-tape units, floppy disk drives, and printers. If you are using a terminal with such peripherals, you can use FCOPY to copy files between system devices and the terminal peripherals.
Using FCOPY with Terminal Peripherals Using File Designators Using File Designators You specify a peripheral device in an FCOPY command by using its file designator as the fromfile or tofile. Table 6-1 lists terminal peripherals, their corresponding terminals, and their file designators: Table 6-1.
Using FCOPY with Terminal Peripherals Terminal Settings Terminal Settings In order to copy to or from terminal peripherals, your terminal type must be set to 10 or 12 (depending on your terminal), message reception must be turned off, and the parity toggle switch must be set to NONE. FCOPY checks these settings before it begins to copy the files you specified in a command that references a terminal peripheral device.
Using FCOPY with Terminal Peripherals Copying Between Terminal Peripheral Devices Copying Between Terminal Peripheral Devices Although you can use FCOPY to copy from one peripheral device to another, it is usually more efficient to use the local capabilities of the terminal. Refer to documentation describing your terminal for instructions for copying between local devices. Examples The following examples show how to use FCOPY to copy to and from terminal peripheral devices.
FCOPY Messages A FCOPY Messages FCOPY displays three types of messages: error messages, warning messages, and status messages. • Error messages terminate an FCOPY command during a session or the FCOPY subsystem during a job. • Warning messages do not terminate FCOPY but, during a job, they set the job control word (JCW) to WARN. • Status messages supply you with information while FCOPY is copying a file.
FCOPY Messages Display During Sessions Display During Sessions During a session, FCOPY displays messages and their reference numbers on your terminal. For example, *54* SYNTAX ERROR: UNKNOWN OPTION If the error involves a file, FCOPY asks you whether you want to display the file information.
FCOPY Messages Display During Jobs Display During Jobs During a job, FCOPY displays warning and error messages on the standard listing device. It does not give you the option of displaying file information. When FCOPY encounters a potential problem with a file, it assumes that the command was submitted as you intended and attempts to perform the requested operation.
FCOPY Messages Types of Message Types of Message This appendix lists, in numeric order, all FCOPY messages, their causes, and the actions you should take to correct them. Three types of messages may be received: error, warning, and status messages. • Errors encountered during a job stream cause FCOPY to terminate. However, only the command is terminated if the errors occur during a session. • Warnings do not cause an FCOPY command to terminate. In a job, they set the JCW to WARN.
FCOPY Messages Error, Warning, and Status Messages Error, Warning, and Status Messages These are the messages you are likely to encounter when you use the FCOPY subsystem. NOTE In the text, * indicates a WARNING message ** indicates a STATUS message Message < CONTROL Y > Cause Acknowledges receipt of a CTRL Y entered during a session. Action None. Message READ ERROR FROM COMMAND INPUTFILE Cause An error occurred while reading an FCOPY command from $STDIN. Action In a job, resubmit the job.
FCOPY Messages Error, Warning, and Status Messages 4 5 6 7 8 9 10 112 Message SYNTAX ERROR: IN TITLE OPTION Cause The "title" option of the DISPLAY function was not specified properly. Action In a job, correct the command and resubmit the job. In a session, reenter the command using the correct format. Message SYNTAX ERROR: IN IGNERR OPTION Cause The "ignore errors" function is not specified properly. Action In a job, correct the command and resubmit the job.
FCOPY Messages Error, Warning, and Status Messages 11 12 13 14 15 16 17 Appendix A Message SYNTAX ERROR: IN EBCDICOUT OPTION Cause The EBDICOUT character translation function was not specified properly. Action In a job, correct the command and resubmit the job. In a session, reenter the command using the correct format. Message SYNTAX ERROR: IN CHAR OPTION Cause The "display character" function was not specified properly. Action In a job, correct the command and resubmit the job.
FCOPY Messages Error, Warning, and Status Messages 18 19 51 52 53 54 114 Action In a job, correct the command and resubmit the job. In a session, reenter the command using the correct format. Message SYNTAX ERROR: IN BCDICOUT OPTION Cause The BCDICOUT character translation function was not specified properly Action In a job, correct the command and resubmit the job. In a session, reenter the command using the correct format.
FCOPY Messages Error, Warning, and Status Messages 55 56 57 58 59 60 62 Appendix A Message SYNTAX ERROR: IN FROMFILE SPECIFIER Cause The fromfile was not specified properly. Action In a job, correct the command and resubmit the job. In a session, reenter the command using the correct format. Message SYNTAX ERROR: IN TOFILE SPECIFIER Cause The tofile was not specified properly. Action In a job, correct the command and resubmit the job.
FCOPY Messages Error, Warning, and Status Messages with lockword. 102 103 104 105 116 Action In a job, correct the command and resubmit the job. In a session, reenter the command using the correct format. Message CANNOT CLOSE FROMFILE Cause MPE cannot close the fromfile. This message is followed by an MPE file information display containing (among other things) an error number.
FCOPY Messages Error, Warning, and Status Messages 106 107 108 109 110 111 Appendix A Message CANNOT OPEN TOFILE Cause MPE cannot open the tofile. This message is followed by an MPE file information display containing an error number. Action Look up the error number in the file system error table in the MPE V Intrinsics Reference Manual (30000-90010) or the MPE XL Error Message Manual Volumes 1 and 2 (32650-90066 and 32650-90152) and act accordingly.
FCOPY Messages Error, Warning, and Status Messages 112 113 114 115 118 Cause MPE cannot get read access to the fromfile. The read access specified by FCOPY has been overridden by an MPE FILE command containing ACC=APPEND, ACC=OUT, or ACC=OUTKEEP. Action Reset the FILE command (using the MPE RESET command) and retry the operation. Message CANNOT GET WRITE ACCESS TO TOFILE Cause MPE cannot get read access to the tofile.
FCOPY Messages Error, Warning, and Status Messages 116 117 118 119 120 123 Appendix A Message CANNOT GET LARGE ENOUGH BUFFER Cause There is not enough data space for the buffers needed by the operation you have requested. FCOPY uses the DL-DB area for variable sized buffers. Action Ask the system manager what size data area was specified when FCOPY was prepared, and rerun FCOPY specifying a larger MAXDATA= parameter.
FCOPY Messages Error, Warning, and Status Messages 124 125 126 127 128 120 Cause The specified subset requires backspacing in the fromfile, but the device for that file is not a disk or magnetic tape. Action Check the MPE FILE command associated with the fromfile and its backreference. Message READ ERROR IN FROMFILE AT RECORD RECNUM Cause An error occurred while spacing through the fromfile in search of the start of a subset. Action Check the syntax of your command and retry the operation.
FCOPY Messages Error, Warning, and Status Messages 129 130 131 132 133 134 Appendix A Message EOF FOUND WHILE SPACING IN TOFILE Cause An end-of-file mark was encountered while spacing through the tofile in search of the start of a subset during a "compare" or "verify" operation. Action In a compare operation, the fromfile and tofiles are not identical. Display the tofile to determine what it actually contains. In a verify operation, the copy operation was not performed correctly.
FCOPY Messages Error, Warning, and Status Messages commands) and retry the operation. To copy from one file to a smaller file, use SUBSET=. 135 136 137 * 138 139 122 Message WRITE ERROR TO TOFILE Cause An error occurred while writing to the tofile. Action Check the syntax of your command and retry the operation. Message READ ERROR FROM TOFILE Cause An error occurred while reading from the tofile during a "compare" or "verify" operation. Action In a compare operation, retry the operation.
FCOPY Messages Error, Warning, and Status Messages 140 141 ** 143 * 144 145 146 Appendix A Message COMPARE OR VERIFY OPTION: OPERATION FAILS; DIFFERENT FIXED RECSIZES Cause The "compare" or "verify" operation was not attempted because the record sizes of the tofile and fromfile are not identical. Action In a compare operation, none. The compare operation revealed that the fixed record sizes of the two files are not identical.
FCOPY Messages Error, Warning, and Status Messages 147 148 149 150 151 152 153 124 Message WRITE ERROR IN TEMPORARY LABEL FILE Cause An error occurred while writing to the temporary label file. Action Check the syntax of your command and retry the operation. Message READ ERROR IN TEMPORARY LABEL FILE Cause An error occurred while reading from the fromfile. Action Check the syntax of your command and retry the operation.
FCOPY Messages Error, Warning, and Status Messages 154 155 200 * Message ATTEMPT TO BACKSPACE OVER TOFILEBOF Cause The negative number specified in a "skip end-of-file" function for the tofile is too large. Action Change the number to a smaller one to avoid skipping too many files back. Message DEBLOCK OPTION: INVALID LOGICAL RECORD LENGTH Cause Specified logical record length is greater than the physical record length of the fromfile, or it is equal to zero.
FCOPY Messages Error, Warning, and Status Messages function to copy all of the file except the erroneous record. 302 303 304 601 800 Message VERIFY OPTION: RAN OUT OF VERIFY ERRORS AT FROMFILE RECORD recnum Cause The "verify" function was terminated because the specified maximum number of errors has been exceeded at the record number displayed (recnum). Action Specify a larger number-of-errors parameter and retry the operation.
FCOPY Messages Error, Warning, and Status Messages 801 * Message EOF IN TOFILE BUT NOT IN FROMFILE { AT AFTER BEFORE } RECORD X 802 * Cause The tofile is smaller than the fromfile to which it is being compared. Action None. Message READ ERROR IN FROMFILE { AT AFTER BEFORE } RECORD X 803 * Cause A read error occurred while verifying or comparing. Action Retry the operation and check the MPE file system error.
FCOPY Messages Error, Warning, and Status Messages 904 905 906 907 908 909 910 128 Cause The fromfile is not a KSAM file. Action Create a KSAM file before running FCOPY and copy to that file. Message KSAM ERROR 904 Cause Internal error. Action Notify your system manager. Message KSAM ERROR 905 Cause Internal error. Action Notify your system manager. Message KSAM ERROR 906 Cause Internal error. Action Notify your system manager. Message KSAM ERROR 907 Cause Internal error.
FCOPY Messages Error, Warning, and Status Messages 911 912 913 914 915 * 916 * 930 Appendix A Message ERROR DELETING TO FILE ACD Cause Internal error. Action Notify your system manager. Message USER CAN'T ACCESS FROMFILE ACD Cause COPYACD was specified for a file to which you have insufficient access rights. Action Retry without specifying COPYACD. Message USER CAN'T ACCESS FROMFILE ACD Cause COPYACD was specified for a file to which you have insufficient access rights.
FCOPY Messages Error, Warning, and Status Messages rights. 931 950 960 961 962 963 964 965 130 Message ERROR WHILE COPYING LABEL EXTENSION OF SPOOL FILES Cause Internal error. Action Notify your system manager. Message CTRANSLATE ERROR Cause Internal error. Action Notify your system manager. Message LANGUAGE NOT CONFIGURED Cause The language is not installed. Action Run LANGID.PUB.SYS to install it. Message NLS NOT CONFIGURED Cause NLS is not installed. Action Run LANGID.
FCOPY Messages Error, Warning, and Status Messages 966 970 971 Message WARNING: LANG OPTION NOT RELEVANT Cause The tofile doesn't need the language. Action Do not use the LANG option. Message NO EBCDIC TABLE FOR THIS LANGUAGE Cause Some languages do not support the EBCDIC function. Action Do not use the EBCDIC function. Message INVALID 16-BIT INPUT DATA FOR UPSHIFT Cause 16-bit character truncation. Action Check input data and try again.
FCOPY Messages Error, Warning, and Status Messages 132 Appendix A
File Definitions: Default Values B File Definitions: Default Values Appendix B summarizes the default file definition values that FCOPY uses to open a tofile or fromfile. It contains two tables: table B-1 shows default values for different types of fromfiles, and table B-2 shows default values for different types of tofiles. The information stored in the file label of an existing disk file always describes its characteristics.
File Definitions: Default Values Table B-1. Default "from" Device Values "From" Device $CTUL $CTUR Magnetic Tape Named Disk File $STDIN $STDINX Formal File Designator (empty) fromfile fromfile (empty) Default File Designator (empty) fromfile fromfile (empty) Domain new new+ old perm. or temp.
File Definitions: Default Values Table B-1. Default "from" Device Values "From" Device $CTUL $CTUR Magnetic Tape Named Disk File Initial Allocation N/A N/A as specified in the file label File Code 0 N/A as specified in the file label Allow FILE Command no yes yes $STDIN $STDINX N/A no Table B-2.
File Definitions: Default Values Table B-2.
Codes C Codes This appendix contains three tables showing conversions between the following sets of codes: • ASCII and EBCDIC • JIS and EBCDIK • ASCII and BCDIC Appendix C 137
Codes ASCII/EBCDIC Conversion Table ASCII/EBCDIC Conversion Table This table is sorted by character code, each code being represented by its decimal, octal, and hexadecimal equivalents. Each row of the table gives the ASCII and EBCDIC meaning of the character code, the ASCII/EBCDIC conversion code, and the Hollerith representation (punched card code) for the ASCII character. Examples The following examples illustrate how to use the table.
Codes ASCII/EBCDIC Conversion Table Table C-1.
Codes ASCII/EBCDIC Conversion Table Table C-1.
Codes ASCII/EBCDIC Conversion Table Table C-1.
Codes ASCII/EBCDIC Conversion Table Table C-1.
Codes ASCII/EBCDIC Conversion Table Table C-1.
Codes ASCII/EBCDIC Conversion Table Table C-1.
Codes ASCII/EBCDIC Conversion Table Table C-1.
Codes ASCII/EBCDIC Conversion Table Table C-1.
Codes ASCII/EBCDIC Conversion Table Table C-1.
Codes JIS/EBCDIK Conversion Table JIS/EBCDIK Conversion Table This table is sorted by character code, each code being represented by its decimal, octal, and hexadecimal equivalent. Each row of the table gives the JIS and EBCDIK meaning of the character code, the JIS <-> EBCDIK conversion code, and the Hollerith representation (punched card code) for the JIS and EBCDIK character. The Hollerith code given in this table is YHP Hollerith and is not equivalent to JIS Hollerith.
Codes JIS/EBCDIK Conversion Table Table C-2.
Codes JIS/EBCDIK Conversion Table Table C-2.
Codes JIS/EBCDIK Conversion Table Table C-2.
Codes JIS/EBCDIK Conversion Table Table C-2.
Codes JIS/EBCDIK Conversion Table Table C-2.
Codes JIS/EBCDIK Conversion Table Table C-2.
Codes JIS/EBCDIK Conversion Table Table C-2.
Codes JIS/EBCDIK Conversion Table Table C-2.
Codes JIS/EBCDIK Conversion Table Table C-2.
Codes ASCII/BCDIC Conversion Table ASCII/BCDIC Conversion Table In the Hollerith column in this table, there are dual entries for some of the punches. In such cases, the entry on the right side is for ASCII punches; the entry on the left is for BCDIC punches.
Codes ASCII/BCDIC Conversion Table Table C-3.
Codes ASCII/BCDIC Conversion Table Table C-3.
Codes ASCII/BCDIC Conversion Table Table C-3.
Codes ASCII/BCDIC Conversion Table Table C-3.
Codes ASCII/BCDIC Conversion Table Table C-3.
Codes ASCII/BCDIC Conversion Table Table C-3.
Codes ASCII/BCDIC Conversion Table Table C-3.
Codes ASCII/BCDIC Conversion Table Table C-3.
Codes ASCII/BCDIC Conversion Table Table C-3.
Codes ASCII/BCDIC Conversion Table 168 Appendix C
