Copying Tapes for Distribution

This Appendix describes how to use the SLTCOPY tool that allows you to copy CSLTs for distribution to other sites. SLTCOPY is intended only for copying CSLT/STORE tapes generated by HPINSTAL.

This Appendix comprises the following parts:

Copying the CSLT from Tape to Tape
Copying the CSLT from Tape to Disk
Copying the CSLT from Disk to Tape
Copying to or from Remote Files
Copying to or from Remote Tape Drives
Overriding Defaults

Refer to Appendix H “Error Messages and Warnings” for a description of error messages that may occur while using SLTCOPY.

Considerations

You can use SLTCOPY to copy from tape directly to half-inch magnetic tape or DDS tape, or you can copy to a disk file that can later be copied to tape. If you have multiple tape drives configured to your system, you can make multiple copies simultaneously (up to nine).

Copying from tape to disk then from disk to tape is useful if you need to make more CSLT copies than the number of tape drives available on your system.




	NOTE: You cannot use `SLTCOPY` to concatenate multiple volumes onto a single volume (for example, you cannot combine a multiple volume set of half-inch magnetic tapes onto a single DDS tape) or change the number of volumes of an SLT (for example, you cannot take a one volume DDS tape and copy it to multiple 1/2 inch tapes).

You can set up tapes drives to be used with SLTCOPY using the AUTOREPLY option so they reply automatically to tape requests. To do this, you must set up a file equation for the master tape (MASTER) or the copy (COPY n) to point to a specific LDEV number (where the tape will be mounted) that is configured with AUTOREPLY.

Accessing SLTCOPY

You normally do not need to specifically install SLTCOPY to use it. It is automatically installed in the INSTALL.SYS group when you prepare to run HPINSTAL. If SLTCOPY is unavailable on your system, you can install it by mounting the current CD-ROM disks and running the ETUP script:

:SETUP.INSTUTIL

SLTCOPY and other programs and files are copied into the INSTALL.SYS group. This takes approximately 10 minutes. You will see a series of messages and finally the message:

SETUP IS COMPLETE

You can then run SLTCOPY.

Copying the CSLT from Tape to Tape

You can use SLTCOPY to copy the CSLT/STORE tapes created for distribution to another system. The number of tape volumes that make up the CSLT varies depending on the type of tape you are using and the size of the system. You have to copy each tape volume separately. Depending on the number of tape drives you have, you can make up to nine copies of each tape at a time.

When copying from tape to tape, you can copy magnetic and DDS tapes as follows:

Half-inch magnetic tapes to half-inch magnetic tapes
Half-inch magnetic tapes to DDS tapes
DDS tapes to DDS tapes

You can also copy a tape to or from a remote tape device or remote disk file. Refer to the sections "Copying to or from Remote Disk Files" or "Copying to or from a Remote Tape."

To copy each tape volume that makes up the CSLT:

Log on to the INSTALL group in the SYS account. For example:
:HELLO MANAGER.SYS,INSTALL
Load the tape volume you want to copy from. Start with the first tape volume of the CSLT if you have more than one. Be sure that the write enable ring is removed from the tape or that the tape is otherwise write-protected. Note the LDEV number of the tape drive.

Load the tape or tapes on which you want to make the copy. (You can make up to nine copies.) Be sure that the tapes you are copying to are write-enabled. Note the LDEV number (or numbers) of the tape drive (or drives).

NOTE: For half-inch magnetic tape only: When copying from a master tape to a copy, the copy tape must be the same length or longer than the master tape. Because magnetic tapes can vary in length by up to 200 feet, the following error may occur at the end of the tape copy process:

COPY# on LDEV # is bad. The tape may be too short or an I/O
error occurred.

You can consider recreating the master on a shorter tape. Otherwise, you can try the copy process using a different (longer) tape for the copy.

Invoke SLTCOPY on any terminal. You do not need to be on the system console. However, you may need to answer tape requests at the system console.
:SLTCOPY
The SLTCOPY menu is displayed:
Select mode (? = help): 1 Copy tape to disk file 2 Copy disk file to tape 3 Copy tape to tape Which option do you wish to use < Enter 'E' to exit>?
Type 3 in response to the prompt about which option you want to use:
Which option do you wish to use < Enter 'E' to exit>? 3
SLTCOPY asks for the number of copies. Type the number of copies you are making at this time.
Enter the number of copies (1-9):
You need to have more than one tape drive on the system to make more than one copy at a time. So to make six tape copies, you need to have seven tape drives connected to the system.
You will see the following message on the terminal where you ran SLTCOPY:
Reply for MASTER is needed.
On the system console, you need to reply with the PIN number and the LDEV number of the device from which you are copying.
Following is an example tape reply performed at the system console. In the example, the PIN is 74 and the LDEV number is 7.
?15:19/#S2/74/LDEV# FOR "MASTER" ON TAPE (NUM)? CTRL A =reply 74,7
Next you will see the following message on the terminal where you ran SLTCOPY:
Reply for COPY1 is needed.
On the system console, you need to reply with the PIN number and the LDEV number of the device to which you are copying.
Following is an example tape reply performed at the system console. In the example, the PIN is 74 and the LDEV number is 8.
?15:19/#S2/74/LDEV# FOR "COPY1" ON TAPE (NUM)? CTRL A =reply 74,8 Reading tape.
If you are making more than one copy at a time, you need to respond with the LDEV numbers of the rest of the tape devices as the messages appear. The copies will be named consecutively COPY1, COPY2, COPY3, etc. up to COPYn. Where n is the number of copies you are making.

When it finishes copying the tapes, SLTCOPY informs you how long it took to copy the tapes and provides other information about the tapes. It then redisplays the main SLTCOPY menu.

CPU seconds 238
Elapsed time 7:15
 
Number of records 9877
Number of tape marks 135
 
Select mode (? = help)
1 Copy tape to disk file
2 Copy disk file to tape
3 Copy tape to tape
Which option do you wish to use < Enter 'E' to exit>?

To copy another tape, select 3. If you are finished, type E to exit the program.

You need to repeat the above procedure for each tape volume that makes up the CSLT you want to copy.

Copying the CSLT from Tape to Disk

You can use SLTCOPY to copy the CSLT/STORE tape volumes to disk. You have to copy each tape volume to a separate disk file. You can only name the disk files using traditional MPE file names. SLTCOPY does not recognize HFS file names (such as /SYS/PUB/CSLTRel55).

You can also copy each tape to a remote disk file. Refer to the section "Copying to or from Remote Disk Files" on page E-16.

Before you start to copy the CSLT to disk be sure to log on to the INSTALL group in the SYS account. For example:

:HELLO MANAGER.SYS,INSTALL

To copy each CSLT tape volume into a separate disk file:

Load the tape you want to copy from. Start with the first tape volume of the CSLT if you have more than one. Be sure that the write enable ring is removed from the tape or that the tape is otherwise write-protected. Note the LDEV number of the tape drive.
Invoke SLTCOPY on any terminal. You do not need to be on the system console. However, you will need to answer tape requests at the system console.
:SLTCOPY
The SLTCOPY menu is displayed:
Select mode (? = help): 1 Copy tape to disk file 2 Copy disk file to tape 3 Copy tape to tape Which option do you wish to use < Enter 'E' to exit>?
Type 1 in response to the prompt about which option you want to use:
Which option do you wish to use < Enter 'E' to exit>? 1
SLTCOPY requests the name of the disk file to which you want to copy the tape. You can specify any valid file name that conforms to MPE syntax.
New disk file name? TAPE1R55
You can then specify a phrased description of the file and a version number. You can use these fields to best suit your particular needs.
After you enter the information, you are able to verify that it is correct.
Enter file description: FILE CONTAINS TAPE 1 RELEASE 5.5 CSLT. Enter version number: 1 Description: FILE CONTAINS TAPE 1 RELEASE 5.5 CSLT. Version: 1 Correct [YES]? [RETURN]
You will see the following message on the terminal where you ran SLTCOPY:
Reply for MASTER is needed.
On the system console, you need to reply with the PIN number and the LDEV number of the device from which you are copying.
Following is an example tape reply performed at the system console. In the example, the PIN is 74 and the LDEV number is 7. SLTCOPY then begins to read the tape. It displays the create date of the CSLT tape.
?15:19/#S2/74/LDEV# FOR "MASTER" ON TAPE (NUM)? CTRL A =reply 74,7 Reading tape. Create date: FRI, MAR 25, 1994, 5:58 PM MPE/iX SLT TAPE
It takes approximately 8-10 minutes to copy each 2400 ft. half-inch magnetic tape to a disk file; it takes approximately one hour to copy a DDS tape. SLTCOPY informs you how long it actually took to make the file. It then redisplays the main SLTCOPY menu.
When you finish making a separate disk file for each tape volume in the CSLT tape set, you can copy each file to tape, making as many copies as you need to support additional systems.
CPU seconds 238 Elapsed time 7:15 Select mode (? = help) 1 Copy tape to disk file 2 Copy disk file to tape 3 Copy tape to tape Which option do you wish to use < Enter 'E' to exit>?

To make another disk file, select 1. To copy a disk file to tape, select 2. If you are finished, type E to exit the program.

Copying the CSLT Files from Disk to Tape

The disk files created by SLTCOPY can now be copied onto tape. You can make up to nine copies of each disk file at a time (depending on the number of tape drives attached to your system). Each disk file must be copied to a separate tape.

You can also copy a disk file to or from a remote tape device. Refer to the section "Copying to or from Remote Disk Files."

To copy each file that represents a volume of the CSLT:

Log on to the INSTALL group of the SYS account. For example:
:HELLO MANAGER.SYS

Load the tape or tapes on which you want to make the copy. Be sure that the tapes you are copying to are write-enabled. Note the LDEV number or numbers of the tape drive or drives.

NOTE: For half-inch magnetic tapes only: When copying from a master CSLT tape to a disk file then to another tape, the copy tape must be the same length or greater than the original master tape from which the disk file was made. Because magnetic tapes can vary in length by up to 200 feet, the following error may occur at the end of the copy process:

COPY# on LDEV # is bad. The tape may be too short or an I/O
error occurred

You can consider recreating the master on a shorter tape. Otherwise, you can try the copy process again using a different (longer) tape for the copy.

Invoke SLTCOPY on any terminal. You do not need to be on the system console. However, you will need to answer tape requests at the system console.
:SLTCOPY
The SLTCOPY menu is displayed:
Select mode (? = help): 1 Copy tape to disk file 2 Copy disk file to tape 3 Copy tape to tape Which option do you wish to use < Enter 'E' to exit>?
Type 2 in response to the prompt about which option you want to use:
Which option do you wish to use < Enter 'E' to exit>? 2
SLTCOPY asks the name of the disk file you want to copy onto tape. In the following example text, the file name TAPE1R55 is used. In its place, specify the name you assigned to the disk file that you now want to copy to tape. The file description is then displayed.
Old disk file name? TAPE1R55 Description: File contains tape 1 Release 5.5 CSLT. Version: 1 Create date: FRI, MAR 25, 1994, 5:58 PM MPE/iX SLT TAPE Correct [YES]? [RETURN]
If you press [RETURN] in response to "Old disk file name?", you will return to the main SLTCOPY menu.
SLTCOPY then asks for the number of copies. Type the number of copies you are making at this time. (This number must correspond to the number of tapes you have mounted on tape drives.)
Enter the number of copies (1-9):
You need to have more than one tape drive on the system to make more than one copy at a time. So to make six tape copies, you need to have six tape drives connected to the system.
You will see the following message on the terminal where you ran SLTCOPY:
Reply for COPY1 is needed.
On the system console, you need to reply with the PIN number and the LDEV number of the device to which you are copying.
Following is an example tape reply performed at the system console.
In the example, the PIN is 74 and the LDEV number is 8.
?15:19/#S2/49/LDEV# FOR "COPY1" ON TAPE (NUM)? CTRL A =reply 49,7 Writing tape.
If you are making more than one copy at a time, you need to respond with the LDEV numbers of the rest of the tape devices as the messages appear. The copies will be named consecutively COPY1, COPY2, COPY3, etc. up to COPY n where n is the number of copies you are making.

When it finishes making the tape, SLTCOPY informs you how long it took to make the tape and provides other information about the tape. It then redisplays the main SLTCOPY menu.

CPU seconds 238
Elapsed time 7:15
 
Number of records 9877
Number of tape marks 135
 
Select mode (? = help)
1 Copy tape to disk file
2 Copy disk file to tape
3 Copy tape to tape
Which option do you wish to use < Enter 'E' to exit>?

To copy another disk file to tape, select 2. If you are finished, type E to exit the program.

You need to repeat the above procedure for all of the disk files that make up the CSLT that you want to copy.

Copying to or from Remote Disk Files

You can use the procedures described in the sections "Copying the CSLT from Tape to Disk" and "Copying from Disk to Tape" when copying to or from a remote disk file. Your system must have access to networking software (such as NS 3000) to connect remotely with other systems. You need to know the nodename of the remote system on which the disk file is or will be placed.

To copy to a remote file, set up a file equation to point to the name of the remote file:

:FILE filename1 = filename2:nodename

where:

filename1: The name following an asterisk to specify to SLTCOPY.
filename2: The name of the file on the remote system.
nodename: The name used to specify the remote system.

The following example shows how to create a remote disk file called CSLTVOL1 on a remote system called REMSYS. Only the part of the procedure that differs from the normal procedure for copying a tape into a disk file is shown.

:DSLINE REMSYS
:REMOTE HELLO USERNAME.ACCOUNT,GROUP
:FILE CSLTVOL1=CSLTVOL1:REMSYS
...
:SLTCOPY
Select mode (? = help)
1 Copy tape to disk file
2 Copy disk file to tape
3 Copy tape to tape
Which option do you wish to use < Enter 'E' to exit>? 1
New disk file name? *CSLTVOL1
...

Notice that the remote disk file name must be preceded with an asterisk (*).

Copying to or from a Remote Tape

Your system must have access to networking software (such as NS 3000/iX) to copy tapes to or from other systems. You need to know the nodename where the tape or tapes are mounted.

To copy to or from a remote tape drive, set up a file equation to point to the nodename of the remote tape drive.

If the master tape is on the remote system, you need to copy from the remote system. Set up the following file equation:

:FILE MASTER=MASTER:nodename; DEV=TAPE

where nodename is the specification for the remote system.

The following example shows how to copy to a local tape drive from a master CSLT on a remote tape drive on a system called REMSYS. Only the part of the procedure that differs from the normal procedure for copying is shown.

:DSLINE REMSYS
:REMOTE HELLO username.account,group
:FILE MASTER=MASTER:REMSYS;DEV=TAPE
:SLTCOPY
Select mode (? = help) Select mode 1 or 3
1 Copy tape to disk file
2 Copy disk file to tape
3 Copy tape to tape
Which option do you wish to use < Enter 'E' to exit>? 3
...
SLTCOPY redirects MASTER according to the file equation.

If you are copying to the remote system, the master tape is on the local system. Set up a file equation for each copy you are making as follows:

:FILE COPYn =COPYn:nodename;DEV=TAPE

where:

n: number of copies.
nodename: name used to specify the remote system.




	NOTE: You can only copy to multiple remote tapes if you invoke `SLTCOPY` with the `WAITIO` option. Refer to "Overriding Defaults."

The following example shows how to copy from a master CSLT on a local tape drive to a remote tape drive on a system called REMSYS. Only the part of the procedure that differs from the normal procedure for copying is shown.

:DSLINE REMSYS
:REMOTE HELLO username.account,group
:FILE COPY1=COPY1:REMSYS;DEV=TAPE
:SLTCOPY
Select mode (? = help) Select mode 2 or 3
1 Copy tape to disk file
2 Copy disk file to tape
3 Copy tape to tape
Which option do you wish to use < Enter 'E' to exit>? 3

Copying CSLT Volumes in Batch Mode

You can also run SLTCOPY in batch mode. To do this, you must build a job stream that:

Logs in to a group with the appropriate capabilities (PM, ND, and SF)
Sets any required file equations
Invokes SLTCOPY
Provides responses to the SLTCOPY prompts for information. The responses will vary depending on which option is chosen. Each response must appear on a separate line in the job stream.

When you run the job stream, replies for the tape devices will still be required at the console. If an error occurs, SLTCOPY will write the cause of the error to the spoolfile, and the job will abort. The following is an example job stream called COPYJOB used for copying tape to tape:

!JOB COPYJOB, MANAGER.SYS,INSTALL
!COMMENT On the next two lines, 3 is the option (tape to tape)
!COMMENT and 2 is the number of tapes
!SLTCOPY
3
2
E
!EOJ

Overriding Defaults

Two options for SLTCOPY are provided to allow additional control over the utility. The options are INFO=NOWAITIO and INFO=WAITIO. You only need to use these options if you want to override the SLTCOPY defaults. Refer to Table E-1 “SLTCOPY Defaults” for SLTCOPY defaults.

Table E-1 SLTCOPY Defaults

No. of Copies	Default Option
1	WAITIO
2-9	NOWAITIO

To override the defaults, you should be very familiar with MPE/iX I/O operations.

WAITIO causes SLTCOPY to wait to send the next buffer until it receives an acknowledgment from the system that the last buffer has been written to tape. NOWAITIO tells SLTCOPY not to wait for the acknowledgment before sending the next buffer. This option is useful (and is the default) when creating multiple output tapes. It allows SLTCOPY to create multiple tapes virtually simultaneously.

To override the defaults listed in Table E-1 “SLTCOPY Defaults”, you invoke SLTCOPY as follows.

If making one copy and wanting to use the NOWAITIO option, invoke SLTCOPY as follows:

:RUN SLTCOPY;INFO="NOWAITIO"

You then respond 1 when SLTCOPY requests the number of copies.

If making multiple copies all at once and wanting to use the WAITIO option, invoke SLTCOPY as follows:

:RUN SLTCOPY;INFO="WAITIO"

You then specify the number of copies you want to make when SLTCOPY requests the number of copies.




	NOTE: Remote file access is not permitted for output tapes if the `NOWAITIO` option is in effect.