Example 1: Saving files

Saving files with a directory file from a public volume to magnetic tape or MT cartridge.

Figure 6: Saving files

/START-ARCHIVE ————————————————————————————————————————————————————————  (1)

%  BLS0990 PROCESSING OF REP FILE ':SBZ3:$TSOS.SYSREP.ARCHIVE.120' STARTED
%  ARCLOAD Program 'ARCHIVE', version '12.0A' of '2018-06-04' loaded 
           from file ':1OSH:$TSOS.SYSLNK.ARCHIVE.120'
%  ARCCOPY Copyright (C) FUJITSU TECHNOLOGY SOLUTIONS 2018. 
            All rights reserved 
%  ARC0001 ARCHIVE READY ——————————————————————————————————————————————  (2)

*FILES NAME=FILE. —————————————————————————————————————————————————————  (3)
*SAVE DIRECTORY=DIR.SAVE.FILE,NEW,VOLUME=QE0829,
      DEVICE=TAPE-C4,LIST=BOTH ————————————————————————————————————————  (4)

*         S A V E   C O M M A N D   L I S T I N G *** —————————————————  (5)
   
PARAMETER VALUES:-
CNS     = YES
UNLOAD  = NO
RESTART = YES
OPERATOR= NO
OLS     = NO
CATID   = NO
STREAM  = YES
 
FILES NAME=FILE. 
SAVE DIRECTORY=DIR.SAVE.FILE,NEW,VOLUME=QE0829,DEVICE=TAPE-C4,LIST=BOTH
%  ARC0002 STATEMENT ACCEPTED. ARCHIVE SEQUENCE NUMBER 'A.100817.142326',
           VERSION '12.0A' ————————————————————————————————————————————  (6) 
%  ARC0033 ARCHIVE SUBTASK TSN '0GKZ' GENERATED ———————————————————————  (7) 
%  MARM121 MAREN CATALOG ENTRY 'QE0829'/'0001' MODIFIED ———————————————  (8) 
%  ARC0815 SUBTASK '0' HAS TRANSFERRED '3646' PAM PAGES FOR '6' FILES 
           AND '0' JVS IN '5' SECONDS —————————————————————————————————  (9)

%  ARC0003 ARCHIVE STATEMENT COMPLETED ———————————————————————————————— (11)

*END —————————————————————————————————————————————————————————————————— (12)

%  ARC0009 ARCHIVE TERMINATED ————————————————————————————————————————— (13)

(1)	ARCHIVE is called.
(2)	ARCHIVE is loaded and ready.
(3)	The NAME operand in the FILES statements specifies the files to be processed by ARCHIVE.
(4)	The SAVE statement defines a save to MT cartridge (German abbreviation: MBK): DIRECTORY=DIR.SAVE.FILE,NEW ARCHIVE should write the information about the save run to the directory file. The NEW operand must be specified in order that the directory file is created. NEW must also be specified if the directory file has already been cataloged but does not have an entry in ARCHIVE. VOLUME=QE0829 The MT cartridge with the specified VSN is defined as the save volume and added to the volume pool. DEVICE=TAPE-C4 This operand specifies the device type for the MT cartridge. LIST=BOTH ARCHIVE is to output the report of the run to SYSLST and SYSOUT.
(5)	For verification purposes ARCHIVE outputs a list containing the operand values valid for the run and the sequences of statements input.
(6)	ARCHIVE confirms that the statements input are syntactically correct. The ARCHIVE run is assigned a unique ARCHIVE sequence number.
(7)	ARCHIVE initiates a subtask for input/output with its own TSN.
(8)	A MAREN subsystem message.
(9)	ARCHIVE reports the total number of transferred files.
(10)	Report of the save run. The processed files are listed. The meanings of the columns are explained in section "ARCHIVE report".
(11)	ARCHIVE reports that the save run was terminated without errors.
(12)	Termination of ARCHIVE is requested.
(13)	The ARCHIVE run is terminated.