Page 1

PRODUCT INFORMATION

Product name	Product number
Backup Manager for ND-500/5000	211226C

DESCRIPTION OF PRODUCT

Backup Manager is a program system for backup and restoring on ND-500 and ND-5000 computers. Backup Manager consists of four modules:

• BM-Definition
  To predefine sets for backup and restore.

• BM-Operator
  To run predefined sets, do occasional copying and service functions.

• BM-Scheduler
  To schedule backup sets and ordinary SINTRAN batch-jobs in a COSMOS network.

• BM-FileRestore
  To restore single files from image (device) backups stored in volume format on tape or disk.

REASON(S) FOR NEW PRODUCT OR VERSION

• Handling Unix TAR (Tape ARchive) format on sequential media
• All known errors from previous versions have been corrected
• Improved stability and robustness

TABLE OF CONTENTS

Topic	Page
Prerequisites	2
Dependencies	4
Documentation	5
Installation procedure	5
Errors corrected since version B05	9
Errors known but not corrected	13
Limitations	13
Information and hints	14
Handling TAR tapes with Backup Manager C01	15

ND-895055.3A EN

Scanned by Jonny Oddene for Sintran Data © 2020

---

Page 2

Date	Comma Data Service	Page 2 of 22
Product name		Product number
Backup Manager for ND-500/5000		211226C

1 Prerequisites

In order to use this product, the following is required.

1.1 Hardware prerequisites

CPU type (any of the following):

• 500
• 5000

Floating format: Any

1.2 Software prerequisites

The following software must be available on the system before the product is installed:

Operating system:

Name	Version/Revision
SINTRAN III VSX for ND-500/5000	210576L

Other software:

Product name	Product number
ND LINKER	211224B01
Backup System for SINTRAN III	210337I05

Backup System is used during installation, and the DMA-SERVER is used when doing image-copying to/from devices connected to the ND-100 bus.

NOTE: Two modification patches to the DMA-SERVER-C01 must be run for handling DOMINO/SCSI-disks and the 155MB Archive streamer. These patches are run automatically during installation of Backup Manager C01. (See file BM-DMAPTC:MODE).

ND-895055.3A EN

---

Page 3

Product Information

Date	Comma Data Service	Page 3 of 22
93.11.02	PRODUCT INFORMATION

Product name	Product number
Backup Manager for ND-500/5000	. 211226C

1.3 Other Prerequisites

Minimum Permanent Mass Storage:

User	Space (pages)	Number of files
SYSTEM	230
ND-OPERATIONS	34	2
BACKUP-MANAGER	3000	25

Minimum	Maximum
Number of segments (ND-100)	1
Number of RT descriptions	1
Requirements regarding batch processors:	0

BM-Scheduler requires that batch processes exist to be able to start jobs for periodic execution.

---

ND-895055.3A EN

---

Page 4

Product Information

Date	Comma Data Service	Page 4 of 22
Product name	Product number
Backup Manager for ND-500/5000	211226C

2 Dependencies

In addition, the following dependencies exist between this and other products. The hardware and software listed here, may for example be necessary to make full use of the product.

2.1 Hardware Dependencies

Product name

DOMINO/SCSI System

Nature of dependency

• Automatic handling of mirrors require that DOMINO/SCSI hardware for MF-bus is installed.

2.2 Software Dependencies

Product name	Product number
Disk Restore	211187B
DOMINO/SCSI Software Package	211478A
SIBAS

Nature of dependency

• Disk Restore version B is required to restore a system disk when SINTRAN III is not running.
• DOMINO/SCSI Software Package is required to make use of, for instance, integrated mirror handling.

• The following SIBAS versions may be linked in order to make BM able to perform integrated database backups:

  • SIBAS/R-B (211212B)
  • SIBAS/R-A (211212A)
  • SIBAS-F (210340)
  • SIBAS/R-B is the SIBAS version required by the installation program (see the sections 4.1 and 4.4)

ND-895055.3A EN

---

Page 5

Product Information

Date	Comma Data Service	Page 5 of 22
Product name	Backup Manager for ND-500/5000	Product number
		211226C

3 Documentation

Included with the product:

Title	Number
Backup Manager User Guide	860276 EN3
Product Information (this paper)

Optional:

Title	Number
DOMINO SCSI Operator Guide	814009.1 EN

4 Installation Procedure

4.1 Automatic Installation

• Before you start installing Backup Manager, check that the prerequisites listed in Chapter 1 are fulfilled.

• Note that it is possible to install Backup Manager without an interface to SIBAS. This is selected during the installation procedure.

  If an interface from Backup Manager to SIBAS is wanted the following three possibilities exist:

  • SIBAS/R-B interface (new domain format-automatic inst. proc.)
  • SIBAS/R-A interface (old domain format-manual inst. procedure)
  • SIBAS-F interface (old domain format-manual inst. procedure)

  In any case, Backup Manager should be installed the standard way by use of the installation program. For the two latter possibilities (old domain format) the standard installation should be performed with NO SIBAS interface. Thereafter the BM-Operator domain should be reinstalled in the old domain format with link to the correct SIBAS version as described in section 4.4. The 2 floppies 211226C01-XX-06D and 211226C01-XX-07D are exclusively delivered for this purpose and are therefore not requested by the installation program. For the manual reinstallation of the BM-Operator domain in old domain format in order to interface SIBAS/R-A or SIBAS-F see section 4.4.

• Log in on user area: SYSTEM.

ND-895055.3A EN

---

Page 6

Product Information

Date	Comma Data Service	Page 6 of 22
Product name	Backup Manager for ND-500/5000	Product number
		.211226C

• If Backup Manager A02 is previously installed, then stop the BM-Scheduler server program by using the SUPERVISE/STOP-SERVER command in BM-Scheduler.

• Insert the diskette 211226C-XX-01D in the floppy drive.

• Enter the floppy directory as usual by typing:

  @ENTER-DIRECTORY 211226C<rev>-XX-01D <device name> <device number>~
  

• Start the installation program by typing:

  @(211226C<rev>-XX-01D:FLOPPY-USER)IN-BCKMAN-XX-B<rev>:PROG~
  

  Backup Manager will then be installed.

Note that only the following floppies will be copied:

211226C<rev>-XX-01D  (floppy no. 1)
211226C<rev>-XX-02D  (floppy no. 2)
211226C<rev>-XX-03D  (floppy no. 3)
211226C<rev>-XX-04D  (floppy no. 4)
211226C<rev>-EN-01D  (floppy no. 8)

The two extra floppies are for loading BM-OPERATOR in old domain format in order to interface older SIBAS versions than SIBAS/R-B (see above).

• If you already have an earlier B-revision installed (B01/B02/B03/B04/B05) the old file (which is not deleted by the installation program in order to keep the old SET and JOB definitions)

  (ND-OPERATION)BM-JOBDB-B<rev>:DATA
  

  has to be converted due to the new storage format of the SET and JOB definitions. See section 10.4.

If upgrading from A02 to C01 the old SET and JOB definitions MAY NOT BE USED. The file (ND-OPERATION)BM-JOBDB-A02:DATA must be deleted and the SETs defined once more.

ND-895055.3A EN

---

Page 7

Product Information

Date	Comma Data Service	Page 7 of 22
Product name		Product number
Backup Manager for ND-500/5000		.211226C

4.2 Updates to the system operation files

If you are not installing on a ND tpServer:

• Remember to update the (SYSTEM)HENT-MODE (or corresponding) file with the following command:

  @MODE (BACKUP-MANAGER)BM-SERVER-<crev>:MODE,,,  
  @MODE (BACKUP-MANAGER)BM-DUMP-<crev>:MODE,,,  
  

• Remember also to update the (SYSTEM)LOAD-MODE (or corresponding) file with the following command to start the BM-Scheduler server:

  @MODE (BACKUP-MANAGER)BM-START-<crev>:MODE,,,  
  

• The load-file for the DMA-server segment (BACKUP-LOAD-I:MODE), should be updated with the patch-file

  @MODE (BACKUP-MANAGER)BM-DMAPTC:MODE,,,  
  

4.3 Defining new backup/restore jobs

When installing Backup Manager C, the file BM-JOBDB-C:DATA is copied to user ND-OPERATION. This file includes some SET examples which can be modified to your needs. (This gives you the opportunity to implement the new features offered by the C-version.)

Due to changes in the internal format of the Backup Manager database from the B to C version (BM-JOBDB-B:DATA -> BM-JOBDB-C:DATA), all your previously defined SETs must be converted. So if you already have a B-version installed (B01/B02/B03/B04/B05) and you want to keep the old SET and JOB definitions, the file (ND-OPERATION)BM-JOBDB-C:DATA must be deleted and the SET conversion program (BM-JOB-CONVERT-C:DOM) must be run. See section 10.4.

4.4 Non-automatic installation

• Backup Manager may only be installed by use of the automatic installation procedure.

• If a link against SIBAS-F or SIBAS/R-A is wanted the following installation procedure is to be followed:

  • Log in as user SYSTEM
  • Install Backup Manager with no link against SIBAS (see sec. 4.1)

ND-895055.3A EN

---

Page 8

Product Information

Date	Comma Data Service	Page 8 of 22
Date 93.11.02	Product Information	Product number
Product name	Backup Manager for ND-500/5000	211226C

• Delete the standard-domain BM-OPERATOR:

  @ND
  N500: DELETE-STANDARD-DOMAIN BM-OPERATOR
  N500: EXIT
  

• Log in as user BACKUP-MANAGER

• Insert floppy no 6 (211226C01-XX-06D) in FLOPPY-DISC-1 unit 0 and enter it:

  @ENTER-DIR,,FLOPPY-DISC-1,0
  

• Copy the file BM-OLD-IN-C01-1:MODE from the floppy:

  @COPY-FILE "BM-OLD-IN-C01-1:MODE" (21:FL-US)BM-OLD-IN-C01-1:MODE
  

• Run the :MODE file with output to file (may take some minutes):

  @MODE BM-OLD-IN-C01-1:MODE "BM-OLD-IN-C01-1:OUT"
  

• Check the output-file to ensure everything went OK

• Remove the floppy, insert floppy no 7 (211226C01-XX-07D) in FLOPPY-DISC-1 unit 0 and enter it:

  @ENTER-DIR,,FLOPPY-DISC-1,0
  

• Run the second :MODE file with output to file (may take some minutes):

  @MODE BM-OLD-IN-C01-2:MODE "BM-OLD-IN-C01-2:OUT"
  

• Check the output-file to ensure everything went OK

• Remove the floppy

• Run one of the following two :MODE-jobs:

  • if SIBAS-F interface is wanted:

    @MODE BM-DESIB-OLD-C01:MODE "BM-DESIB-OLD-C01:OUT"
    

  • if SIBAS/R-A interface is wanted:

    @MODE BM-DRSIB-OLD-C01:MODE "BM-DRSIB-OLD-C01:OUT"
    

• Check the output file to ensure everything went OK

• Define BM-OPERATOR as a standard domain:

  ND-895055.3A EN
  

---

Page 9

Product Information

Date	Comma Data Service	Page 9 of 22
Product Name	Backup Manager for ND-500/5000	Product Number
		.211226C

As user SYSTEM:

@ND-500
N500: DEF-ST-DOM BM-OPERATOR (BA-MAN)BM-OPERAT-C01
N500: EXIT
@

Errors Corrected Since Version B05

• All errors reported for the B05 version have been corrected. This includes:

• Implementation of all existing patches for the B05 version:

SIS Ref.

4) 033561B: Error while trying to connect to DMASERVER
000147B: Device unit reserved for special use
From routine: ConnectDMA.7

5) 033503B: End of medium detected
The error occur during COMPARE and at a page number near the end of an 'IMAGE-NO-COMPARE-FILE'

6) Missing display of 'From' parameters in backup jobs and 'To' parameters in restore jobs during editing.

7) Moving to wrong field when leaving the 'Computer Name' field in backwards direction during definition of restore job to restore directory from volume to disk.

10) 104134B: Pool not found
From routine: GetPool.2

12) 036511B: Unable to set SIBAS in correct state
022676B: No contact with SIBAS process
From routine: Initdatabase.1/2

13) 000311B: The specified device is not a terminal or:
033604B: Unable to log out all users

ND-895055.3A EN

[Scanned by Jonny Oddene for Sintran Data © 2020]

---

Page 10

Product Information

Date	Comma Data Service	Page
93.11.02	PRODUCT INFORMATION	10 of 22

Product name	Product number
Backup Manager for ND-500/5000	211226C

14) Scheduled SET is not started on batch. On error device:
Batch output error
0B.21B: Illegal character in parameter

15) The scheduled SET executes OK but is not properly terminated due to rubbish lines at the end of the batch input file.

16) When restoring a file spliced on 2 streamer tapes not using the DMA-Server, the second part of the file (from the second streamer tape) is not restored.

17) 033515B: Device error when reading from device
000171B: Device error

18) The computed next schedule time will be about one month late

19) 000075B: No more pages available for this user
(<dir.name>:<user name>)<file name>
From routine: PrepareFile.13

20) 033515B: Device error when reading from device
104705B: Local timeout
From routine: bmSpaceEof.1

22) Immediately after backup of the R-log file(s), BM-Op says:
'Database () copied Time used: hh:mm:ss without having copied the db.

23) Message on error device at startup time:
YYYY-MM-DD HH:MM:SS Backup Manager Scheduler
(nothing more)

25) Error when listing SETs

26) Searched objects not found on volume
(End of volume detected)

27) On Error device:
'Wrong password - disconnected' when DMAServer is started

---

ND-895055.3A EN

---

Page 11

Product Information

Date	Comma Data Service	Page 11 of 22
Product name	Product number
Backup Manager for ND-500/5000	211226C

Other errors corrected:

• Improved checking on db-owner (dir:user) information fetched from SIBAS.
  Symptom: 036512B: Unable to get database file names from SIBAS (:)
  000046B: No such user name

• 'Waittime left' is not displayed in batch output file.

• Batch 11 and upwards will be logged out when reserving directory.

• Improved logout mechanism in connection with reservation of directory

• Scheduling of Restore-SET is made possible

• The maximum number of (contiguous) 'Image-no-compare'-files which may be specified is increased from 5 to 12

• Improved page searching mechanism in BM-FileRestore on Domino-coupled devices (larger buffers)

---

• In addition, some minor errors have been corrected.

• New UE-ERMSG-EN-D15:NEW delivered together with the product

ND-895055.3A EN

---

Page 12

Product Information

Date 93.11.02	Comma Data Service
Page 12 of 22

Product name
Backup Manager for ND-500/5000

Product number
.211226C

6 New Functionality Since Version B05

• The C01-version of Backup Manager handles (read/write/list) UNIX TAR (Tape ARchive) format on sequential media (magtape and streamer).

• SINTRAN files (not indexed files containing 'holes') may be copied in TAR format on magtape/streamer. The Unix file names (path names) may be given explicitly or generated automatically from the SINTRAN filenames.

• All previous file selection specifications may be used.

• Files stored in Unix TAR format on magtape/streamer may be copied to a SINTRAN system. File selections may be used.

• See chapter 10 for a detailed description of how to handle TAR tapes from Backup Manager.

---

ND-895055.3A EN

Scanned by Jonny Oddene for Sintran Data © 2020

---

Page 13

PRODUCT INFORMATION

Date	Comma Data Service	Page 13 of 22
Product name		Product number
Backup Manager for ND-500/5000		.211226C

7 ERRORS KNOWN BUT NOT CORRECTED

• When Backup Manager creates a temporary mirror to perform an image copy of a directory on a DOMINO/SCSI disk, the error message 'NO MORE TO COPY' will be written on the error device when the backup procedure is finished. THIS MESSAGE CAN BE IGNORED!.

8 LIMITATIONS

• When performing image copying in batch mode (for example, via BM-Scheduler) you cannot reserve the directory where the input and output batch files for this job are located (normally the directory where user area SYSTEM and ND-OPERATIONS are located).

• You cannot copy TO a DOMINO/SCSI tape-device from a remote computer.

• It is NOT possible to do image copying of disks connected to the ND-100 bus to a DOMINO/SCSI tape device. (They must be copied to a ND-100 connected device.)

ND-895055.3A EN

Scanned by Jonny Oddene for Sintran Data © 2020

---

Page 14

Product Information

Date	Comma Data Service	Page 14 of 22
93.11.02	PRODUCT INFORMATION

Product name	Product number
Backup Manager for ND-500/5000	211226C

9 Information and Hints

• When doing image backup, it is possible to skip compare of selected CONTIGUOUS files (for example, Segfile and Swapfiles). These file names must be registered in the (ND-OPERATIONS)BM-PARAMETER file! The maximum number of contiguous files that may be specified to be excluded from the compare operation is 12.

  Example:

  IMAGE-NO-COMPARE-FILE = (SYSTEM)SWAP-FILE-0:SWAP
  IMAGE-NO-COMPARE-FILE = (SYSTEM)SEGFILEIO:DATA
  

• To maximize performance:

  NEVER specify the 'Computer name' field when copying files between local devices.

  When copying to/from/between remote computers, try to specify as much selection information (directory, user area, file name, etc.) as possible to speed up file searching.

• To recognize backup devices connected to the ND-100 bus, Backup Manager must have access to the peripheral files for the devices. The peripheral files are created via the SINTRAN III command: ØSET-PERIPHERAL-FILE. The relationship between peripheral file names, device numbers and device names is:

  Peripheral file name	Device number used in peripheral file	Device name used in BM
  Streamer-1	2226B	Streamer-1
  Streamer-2	2227B	Streamer-2
  Mag-Tape-0	40B	Mag-Tape-1
  Mag-Tape-4	32B	Mag-Tape-2
  Mag-Tape-8	1232B	Mag-Tape-3
  Mag-Tape-12	1225B	Mag-Tape-4

• Devices connected to the DOMINO/SCSI adapter are defined via the program DP-SERVICE. (See the manual, DOMINO SCSI Operator Guide, ND-814009 for further information.)

No peripheral files are necessary in SINTRAN III for these devices. They can be given any name.

ND-895055.3A EN

---

Page 15

Product Information

Product name
Backup Manager for ND-500/5000

Product number
.211226C

---

10 Handling TAR Tapes

10.1 Copying files to TAR format

When copying SINTRAN files to magtape/streamer, there exist 2 ways of specifying which files to copy:

1. By specifying FILE as 'Copy method' and giving appropriate 'From' and INCLUDE/EXCLUDE selection parameters. The destination Unix file names (stored in the TAR header blocks on the tape) will be generated by a standard file name conversion algorithm from the SINTRAN filename and filetype.

2. By specifying SELECTION FILE as 'Copy method'. The name of a selection file will be prompted. All files named in the selection file will be copied. If a selection does not give exact match, all matching files are selected. In the case of an exact match, a distinct destination Unix file name may also be given. Otherwise the standard file name conversion algorithm will be used.

10.1.1 Selecting files by use of 'From' and 'Include/Exclude' selections

Example:

Object	Copy method	Incremental
SINTRAN	FILE	NO

From	Computer name	Directory Name	User area	Control
DIRECTORY	PACK-TWO	A

To	Computer name	Device name	U S	Mode
TAR	STREAMER-1		O	Ov, Sm

Selection	File name	Selection date
INCLUDE	:TEXT
	:SYMB

---

ND-895055.3A EN

[Scanned by Jonny Oddene for Sintran Data © 2020]

---

Page 16

Product Information

Date	Page
93.11.02	16 of 22

Product name	Product number
Backup Manager for ND-500/5000	211226C

Comments:

• 'Object': The objects to be copied are still 'SINTRAN'

• 'From' fields: Copy from all users starting with 'A' on PACK-TWO

• 'To': Select TAR instead of VOLUME (the volume concept does not exist in the TAR format, i.e., Volume name is not prompted).

• 'Mode': Available mode parameters:
  • Ov: Overwrite tape
  • Oe: Overwrite if blank tape or if the tape contains files in TAR format already (prevents overwrite of SINTRAN volumes or other data)
  • Re: Retension
  • U1: Unload tape after copy
  • Sm: Shrinking mode; the file is copied according to the maximum bytecount of the file (default)
  • Ns: No shrinking; the file is copied according to the number of pages in the file
  • (Ap): Append; this option is not implemented

• 'Selection':
  • INCLUDE: Include all files matching the specifications in the 'From' fields AND the specification in at least one of the INCLUDE lines (max 5).
  • EXCLUDE: Include all files matching the specifications in the 'From' fields AND NOT ANY of the specifications in the EXCLUDE lines (max 5).

In the example above, all :TEXT and :SYMB files from all user areas on PACK-TWO with 'A' as the first character will be copied.

---

ND-895055.3A EN

Scanned by Jonny Oddene for Sintran Data © 2020

---

Page 17

Product Information

Date: 93.11.02
Comma Data Service
Page 17 of 22

Product Name: Backup Manager for ND-500/5000
Product Number: 211226C

10.1.2 Selecting Files by Use of Selection File

Example

Object	Copy Method	Incremental
SINTRAN	SELECTION FILE	NO

From	Computer Name	Directory Name	User Area	Control
DIRECTORY	PACK-TWO	A

To	Computer Name	Device Name	U	S Mode
TAR		STREAMER-1	O	Ov, Sm

Selection	Selection File Name
INCLUDE	FILE-SELECT:SEL

Comments

The format of the selection file is mainly unchanged, i.e., each line to be accepted as a selection has to include a '(' (left bracket) from where the actual selection starts (start of possible directory and user name).

A date selection may be specified (see existing manual).

Behind the optional date selection, an explicit UNIX path name may be specified to give the destination path name exactly as wished. This must, if wanted, be specified on each selection file input line. No checking of the specified path name is done.

If this destination path is not specified, BM-Op will generate the path name to be written on the tape from the SINTRAN file name by simply adding ./ (period and slash) in front, skipping all non-Unix characters, and replacing the ':' (colon) with '.' (period) as the separation character between the object name and the file type (default file name conversion).

NB! If a selection line, containing a destination Unix file (path) name, does not give exact match on the SINTRAN specified file name (source), the destination Unix file (path) name will be generated from the expanded SINTRAN file name and the specified path name will be ignored.

ND-895055.3A EN

---

Page 18

Product Information

Date: 93.11.02	Comma Data Service
Page: 18 of 22

Product Details

Product name	Product number
Backup Manager for ND-500/5000	211226C

---

Examples

FILE 28  : (PACK-TWO:ASM)TEST-02:TEST;1 W>93-05-20  ./JOKER02.TST
FILE 46  : (PACK-TWO:ASM)TEST-03:TEST;1
FILE 87  : (PACK-TWO:ASM)TEST-04:TEST;1 W>93-05-20
FILE 154 : (PACK-TWO:ASM)TEST:TEST;1            ./JOKER01.TST
          (PACK-TWO:ALL)TAR-INFO:TEXT : ./USR/ASM/TAR-INFOR.TXT
          (PACK-TWO:SYSTEM)LP3-SOURCE:SYMB

Comments

The selection file may often most easily be generated by listing (@IL-FI) the actual files with output to file and editing this file afterwards. All characters before the leftmost left parenthesis are ignored.

The first file will be copied if it has been opened for write later than May 20, 1993. On the TAR tape it will get the name ./JOKER02.TST.

The second file will be copied regardless of file dates. On the TAR tape it will get the name ./TEST-03.TEST by default file name conversion.

The third file: As for the first file, but with default generated Unix file name: ./TEST-04.TEST

The 4. and 5. files: as for the second file, but with explicit given destination Unix file (path) names: ./JOKER01.TST and ./USR/ASM/TAR-INFOR.TXT.

The last file will NOT be copied since the user area where it resides does not start with 'A'.

---

ND-895055.3A EN

---

Page 19

Product Information

Date	Comma Data Service	Page 19 of 22
Product name	Product number
Backup Manager for ND-500/5000	.211226C

10.2 Restoring files FROM TAR format

When copying SINTRAN files from a magtape/streamer containing files stored in TAR format, there exist 2 ways of specifying which files to copy:

1. By specifying FILE as 'Copy method' and giving appropriate 'From' and INCLUDE/EXCLUDE selection parameters. The destination SINTRAN file names will be generated by a standard file name conversion algorithm from the UNIX filename and type as found on the TAR tape.

2. By specifying SELECTION FILE as 'Copy method'. The name of a selection file will be prompted. All files named in the selection file will be copied. A distinct destination SINTRAN file name may also be given for each file. Otherwise the standard file name conversion algorithm will be used.

ND-895055.3A EN

---

Page 20

Product Information

Date	Comma Data Service	Page 20 of 22
Product name	Backup Manager for ND-500/5000
Product number	.211226C

10.2.1 Selecting Files by Use of 'From' and 'Include/Exclude' Selections

Example:

Object	Copy method	Incremental
SINTRAN	FILE	NO

From	Computer name	Device name	U S Control
TAR		STREAMER-1	O

To	Computer name	Directory name	User area	Mode
DIRECTORY		PACK-TWO	ASM	Of

Selection	File name	Selection date
INCLUDE	./usr/

Comments:

In the above example all files with a path name starting with './usr/' will be copied. If the copy operation is performed interactively in manual mode, each selected file is displayed and a confirmation to copy it is prompted.

10.2.2 Selecting Files by Use of a Selection File

When restoring files from TAR tapes you may also use a selection file. Each line in this file has to start with a selection path name. It may be followed by an optional date selection (W is the only valid selection letter) and finally an optional destination SINTRAN file name. If no destination file name is given, BM-Op will generate a SINTRAN filename from the UNIX file name. This filename conversion is done by replacing all non-SINTRAN characters with a hyphen (-). All file name characters from position 16 and outwards are skipped. Likewise, only the first 4 characters of the file extension are kept. The delimiter character is of course changed from '.' (period) to ';' (colon). The logged in user (and its default directory) is used as destination user area.

ND-895055.3A EN

---

Page 21

Product Information

Date	Comma Data Service	Page 21 of 22
93.11.02

Product name	Product number
Backup Manager for ND-500/5000	211226C

Example

Object	Copy method	Incremental
SINTRAN	SELECTION FILE	NO

From	Computer name	Device name	U S Control
TAR		STREAMER-1	0

To	Computer name	Directory name	User area	Mode
DIRECTORY		PACK-TWO	ASM	Of

Selection	Selection file name
INCLUDE	(SYSTEM)SEL-FILE:SEL

Example on selection file contents

./usr/asm/test-01.tst     (PACK-TWO:ASM)TEST-01:TEST
./usr/asm/test-02.tst     (PACK-TWO:ASM)TEST-02:TEST
./usr/asm/test-03.tst     (PACK-TWO:ASM)TEST-03:TEST
./usr/asm/test-04.tst     (PACK-TWO:ASM)TEST-04:TEST
./usr/asm/tar.info        (PACK-TWO:ASM)TAR-INFO:TEXT
./usr/asm/info            W>93-05-20

Comments

The first five files will be copied to the respective file names given. The last selection will include all files with a path name starting with ./usr/asm/info and written later than 20th May 1993 (information in the TAR file headers on the tape). The destination file names will be generated by BM-OPERATOR since the selection matches more files on the TAR tape and an eventually given destination SINTRAN file name would have led to an overwriting of this file for each matching file on the tape.

A selection file is often most easily generated by listing the TAR tape with output written to a file and editing this file afterwards.

---

Page 22

Product Information

Date	Comma Data Service	Page 22 of 22
Product name	Product number
Backup Manager for ND-500/5000	.211226C

10.3 Listing a TAR tape

The listing of a TAR tape is done exactly as when listing Backup Manager volumes. Any volume name given will be ignored.

10.4 New format of the BM Job database

The structure of the BM-JOBDB database (containing the predefined backup and restore SETs) has changed from earlier versions. This means that the file (ND-OPERATIONS)BM-JOBDB-B:DATA must be regenerated. This may be done by either deleting the old BM-JOBDB file and defining all the SETs using BM-DEFINITION-C01 once again or by running a conversion program (BM-JOB-CONVERT-C:DOM). This program is delivered together with Backup Manager C. It takes the file (ND-OPERATIONS)BM-JOBDB-B:DATA as input, reads all the SET, JOB and SUBJOB records, converts them to the new format and writes them back to the file (ND-OPERATIONS)BM-JOBDB-C01:DATA.

ND-895055.3A EN

---