POOL Manage volume pool

Using this statement the user can add/remove tapes or MT cartridges to/from the volume pool of his directory file.

The ADD and REMOVE operands may be specified concurrently, but at least one of them must always be specified.
All messages are output via SYSOUT; no report is produced.

If the volumes are managed via MAREN, they should not be assigned by means of the POOL statement (see section "ARCHIVE and MAREN").

PO[OL]

DIR[ECTORY] = ARCHIVE.DIR[,NEW] / filename[,NEW]

[,ADD = vsn / (vsn,...) ,DEVICE = TAPE-C4 / device type]
[,REM[OVE] = vsn / (vsn,...)]

,NOW = YES / NO[,TIME = sec]
[,P[ASSWORD] = password]

DIRECTORY = filename / filename,NEW
This specifies the directory file that is processed with the POOL statement.If NEW is specified, a file with the specified name is initialized.

ADD = vsn / (vsn,...)
This operand adds VSNs of volumes to the pool of the specified directory file.

DEVICE = TAPE-C4 / device type
This operand is used to define the device type for the VSNs of volumes which are added to the pool.

The “type” entry must conform to the DMS specifications. A volume specified with a certain recording density is used as an output volume even if a different recording density is specified in a SAVE or EXPORT statement.

REMOVE = vsn / (vsn,...)
This operand removes the volume serial numbers of volumes from the pool of the specified directory file. The volumes may not be reserved by any save version at the time of removal.

NOW =
This operand specifies when the POOL statement is to be executed.

NOW = YES
The POOL statement is executed immediately. 

NOW = NO
The POOL statement is checked for correct syntax and then written to the queue file ARCHIVE.LATER. This process is given the ARCHIVE identifier L.yymmdd.hhmmss. The identifier is only allocated if no LATER job exists in the same task at the time. If this is not the case, then the process is stored under the existing identifier.
The LATER job can be started by means of a PROCESS statement or deleted by means of a DELETE statement.

NOW = NO,TIME=sec
The number of CPU seconds that are available to this process when it is started. This entry corresponds to the operand CPU-LIMIT in /START-(EXECUTABLE-)PROGRAM.

PASSWORD = password / (password,...)
If you specify the NOW=NO operand, you must enter here the passwords for

• the directory file, if it is protected by a write password and is not under TSOS.

• magnetic tapes and MT cartridges that are protected by a password (up to 4 characters) under MAREN.

In all other cases, you should enter the passwords with the /ADD-PASSWORD command before ARCHIVE is called. Only in this case are the passwords also valid for the subsequent ARCHIVE runs of the same user job.

The system support must specify the password for the directory file if this file is assigned under another user ID.

Example

/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

*POOL DIRECTORY=ARCHIVE.DIR,NEW,ADD=(OS0230,OS0231),DEVICE=TAPE-C4 ———————  (1)

%  ARC0002 STATEMENT ACCEPTED. ARCHIVE SEQUENCE NUMBER 'A.200813.141905', 
           VERSION='12.0A' —————————————————————————————————————————————  (2) 
%  MARM121 MAREN CATALOG ENTRY 'OS0230'/'0001' MODIFIED
%  ARC0010 VOLUME OF TYPE 'TAPE-C4' WITH VSN 'OS0230' ADDED TO THE POOL   (3) 
%  MARM121 MAREN CATALOG ENTRY 'OS0230'/'0001' MODIFIED
%  MARM121 MAREN CATALOG ENTRY 'OS0231'/'0001' MODIFIED
%  ARC0010 VOLUME OF TYPE 'TAPE-C4' WITH VSN 'OS0231' ADDED TO THE POOL   (4) 
%  ARC0003 ARCHIVE STATEMENT COMPLETED

*END

%  ARC0009 ARCHIVE TERMINATED

(1)	The directory file ARCHIVE.DIR is created. The named MT cartridges should be entered in the volume pool of the directory file.
(2)	ARCHIVE confirms that the entered statement was syntactically correct. The ARCHIVE run is given an ARCHIVE sequence number.
(3)	ARCHIVE reports that MT cartridge OS0230 has been added to the volume pool of the directory file.
(4)	ARCHIVE reports that MT cartridge OS0231 has been added to the volume pool of the directory file.