Example 12: Save, parallel processing

Saving files and job variables in parallel with a directory file.

Figure 15: Save, parallel processing

/START-ARCHIVE

%  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

*FILES NAME=(FILE.,OUTPUT.),NAME=(PROG.,TEST.) ————————————————————————  (1)
*JOBVAR NAME=JV1.,NAME=(JV2.,JV3.) ————————————————————————————————————  (2)
*SAVE DIRECTORY=DIR.SAVEP,NEW,TAPES=(QE0798,QE0799),DEVICE=TAPE-C4,
      DRIVES=2,LIST=SYSOUT ————————————————————————————————————————————  (3) 

*         S A V E   C O M M A N D   L I S T I N G ***
 
PARAMETER VALUES:-
CNS     = YES
UNLOAD  = NO
RESTART = YES
OPERATOR= NO
OLS     = NO
CATID   = NO
STREAM  = YES
 
FILES NAME=(FILE.,OUTPUT.),NAME=(PROG.,TEST.) 
JOBVAR NAME=JV1.,NAME=(JV2.,JV3.) 
SAVE DIRECTORY=DIR.SAVEP,NEW,TAPES=(QE0798,QE0799),DEVICE=TAPE-C4,
     DRIVES=2,LIST=SYSOUT
%  ARC0002 STATEMENT ACCEPTED. ARCHIVE SEQUENCE NUMBER 'A.100818.160451',
           VERSION '12.0A'
%  ARC0033 ARCHIVE SUBTASK TSN '0RJ2' GENERATED ———————————————————————  (4) 
%  ARC0033 ARCHIVE SUBTASK TSN '0RJ3' GENERATED
%  MARM127 VOLUME 'QE0798' RESERVED FOR USER ID 'TSOS'
%  MARM127 VOLUME 'QE0799' RESERVED FOR USER ID 'TSOS'
%  ARC0815 SUBTASK '0' HAS TRANSFERRED '241' PAM PAGES FOR '5' FILES 
           AND '2' JVS IN '3' SECONDS
%  ARC0815 SUBTASK '1' HAS TRANSFERRED '1004' PAM PAGES FOR '5' FILES 
           AND '3' JVS IN '3' SECONDS

%  ARC0003 ARCHIVE STATEMENT COMPLETED

*END

%  ARC0009 ARCHIVE TERMINATED

(1)	The NAME operand in the FILES statement specifies the files to be processed by ARCHIVE.
(2)	The NAME operand in the JOBVAR statement specifies the job variables to be processed by ARCHIVE.
(3)	The SAVE statement defines a save to tape. DIRECTORY=DIR.SAVEP,NEW ARCHIVE is to write the information on the save run to the directory file. The NEW operand must be specified here, as the directory file is created as a new file. NEW must also be specified if the file has already been cataloged but as yet contains no ARCHIVE entries. TAPES=(QE0798,QE0799) ARCHIVE is to save the files and job variables specified in the FILES and JOBVAR statements to the corresponding MT cartridge. DEVICE=TAPE-C4 This operand specifies the device type for the MT cartridge. DRIVES=2 Two parallel runs are defined for this run. This speeds up the save run. LIST=SYSOUT ARCHIVE is to output the report of the run to SYSOUT. By default the report is output to SYSLST.
(4)	ARCHIVE initiates two subtasks for input/output with their own TSNs.
(5)	Report of the save run. The processed files and job variables are listed. The meanings of the columns are explained in section "ARCHIVE report".The report shows that ARCHIVE splits up the files specified in the NAME operand into packets for the respective parallel runs. For runs with PARAM CATID=YES, ARCHIVE does not always split the files as specified in the FILES statement. Instead, ARCHIVE attempts to save the files and job variables of one catalog to one magnetic tape or MT cartridge.