Example 7: Importing files

Reading in files and job variables belonging to your own ID and a foreign user ID from magnetic tape or MT cartridge.

/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.,$USERID2.FILE.,RENAME=ID2.FILE.) ———————————————————  (1)
*JOBVAR NAME=(JV.,$USERID2.JV.,RENAME=ID2.JV.) ————————————————————————  (2)
*IMPORT FROM=(QE0830),DEVICE=TAPE-C4,LIST=SYSOUT ——————————————————————  (3)

*     I M P O R T   C O M M A N D   L I S T I N G ***
 
PARAMETER VALUES:-
UNLOAD  = NO
RESTART = YES
OPERATOR= NO
SNR     = YES
CATID   = NO
STREAM  = YES
 
FILES NAME=(FILE.,$USERID2.FILE.,RENAME=ID2.FILE.) 
JOBVAR NAME=(JV.,$USERID2.JV.,RENAME=ID2.JV.) 
IMPORT FROM=(QE0830),DEVICE=TAPE-C4,LIST=SYSOUT
%  ARC0002 STATEMENT ACCEPTED. ARCHIVE SEQUENCE NUMBER 'A.100824.132654',
           VERSION '12.0A'
%  ARC0033 ARCHIVE SUBTASK TSN '0A4W' GENERATED

%  ARC0003 ARCHIVE STATEMENT COMPLETED

*END

%  ARC0009 ARCHIVE TERMINATED

(1)	The NAME operand in the FILES statement identifies the files that are to be processed by ARCHIVE; the NAME operand in the JOBVAR statement specifies the job variables. The RENAME operand is necessary since the files and job variables are to be read in from the user ID USERID2 to the foreign user ID USERID1. If the TO operand is not specified in the FILES statement, ARCHIVE writes all files in an IMPORT run to public volumes by default. This applies even if the files were saved from private volumes.
(2)	The IMPORT statement reads in files and job variables that were previously saved in an EXPORT run. If the files are read in using a different BS2000 system, the catalog entry in TSOSCAT is created for them. FROM=(QE0830) ARCHIVE is to write back the files and job variables specified in the FILES and JOBVAR statement from the MT cartridge with the corresponding VSN. The FROM operand is mandatory for an IMPORT run. If the EXPORT run was performed with a directory file and the directory file was saved (DIRSAVE=YES), then this must be read in first with a separate IMPORT run using DIRECTORY=NONE, if the save needs to be read in using a different BS2000 system. The required files and job variables can then be read in in an IMPORT run using the directory file. DEVICE=TAPE-C4 This operand specifies the device type for the MT cartridge. LIST=SYSOUT ARCHIVE is to output the report of the run to SYSOUT. The report is output to SYSLST by default.
(3)	Report of the IMPORT run. The processed files and job variables are listed. The meanings of the columns are explained in section "ARCHIVE report".