ADD-FREE-VOLUMES Enter archive numbers of free tapes in the MAREN catalog

Privilege                 ADA, administrator without domains

This statement adds free tapes to the MAREN catalog. Some catalog entry fields can be set at the same time. When domains are used, free tapes are also assigned to the specified domain.

Format

ADD-FREE-VOLUMES                                                                                                                          Alias: ADFV

VOLUME = *INTERVAL(...) / list-poss(10): <vsn>
	*INTERVAL(...)
		|	FROM = <vsn>
		|	,TO = <vsn>
		|	,INCREMENT = 1 / <integer 1..999>
,FREE-LOCATION = CENTRAL / <alphanum-name 1..8>
,DEVICE-TYPE = *STD / <structured-name 1..8>
,FREE-POOL = *NO / *GLOBAL / *TSOS / <filename 1..54 without-gen-vers> / <text 2..32 without-sep>
,DOMAIN = *STD-DOMAIN / *OWN / <alphanum-name 1..8>
,INITIALIZATION = *NO / *YES(...
	*YES(...)
		|	,INIT-FILE = MARENADM.INIT-FILE / *NONE / <filename 1..54 without-gen-vers>(...)
		|		<filename 1..54 without-gen-vers>(...)
		|			|	INIT-LOCATION = *NONE / <alphanum-name 1..8>
		|			|	,USER-IDENTIFICATION = SYSMAREN / <name 1..8>
		|			|	,ACCOUNT = *NONE / <alphanum-name 1..8>
,OVERFLOW-CONTROL = *BY-PROGRAM / *BY-SYSTEM

Operands

VOLUME =
Archive numbers of the free tapes to be added to the MAREN catalog.

VOLUME = *INTERVAL(...)
The archive numbers of the free tapes are defined by the following operands:

FROM = <vsn>
Archive number defining the lower interval limit. This operand must contain at least one number.

TO = <vsn>
Archive number defining the upper interval limit. This operand must contain at least one number.

INCREMENT = 1 / <integer 1..999>
Increment. The archive numbers to be added are formed by adding the increment to the numerical part, beginning with the lower interval limit (FROM operand), until the upper interval limit (TO operand) is reached.

VOLUME = list-poss(10): <vsn>
Up to ten archive numbers may be specified.

FREE-LOCATION =
Location where the tapes to be added are to be found.

FREE-LOCATION = CENTRAL
Indicates that the tapes are in the central archive.

FREE-LOCATION = <alphanum-name 1..8>
Location name or symbolic location name.

DEVICE-TYPE =
Device type.

DEVICE-TYPE = *STD
Tapes of the standard device type specified with the MODIFY-MAREN-PARAMETERS statement (DEFAULT-DEVICE-TYPE operand) are involved.

DEVICE-TYPE = <structured-name 1..8>
Device type. For a list of possible entries (depending on the BS2000 version), see manual “System Installation” [6].

FREE-POOL =
Specifies whether the tapes are already assigned to a free tape pool. If this is the case, the relevant pool must be specified.

FREE-POOL = *NO
The tapes are assigned to the free tape pool with the name *NO.

FREE-POOL = *GLOBAL
The tapes are prereserved for general HSMS/ARCHIVE applications under any user ID.

FREE-POOL = *TSOS
The tapes are prereserved for HSMS/ARCHIVE applications under the user ID TSOS.

If aliases are specified for the *NO, *GLOBAL or *TSOS values, then these operand values will be expanded to their full length for compatibility reasons (e.g. *GL is expanded to *GLOBAL).

FREE-POOL = <filename 1..54 without-gen-vers>
The tapes are allocated to the directory specified here. If this directory is located under a remote user ID, both the user ID and the catalog ID must be entered. The user's own user ID and standard catalog ID can be omitted.

FREE-POOL = <text 2..32 without-sep>
Specifies the name of a free tape pool.

The free tape pool name must begin with *. This must be followed by at least one character from A-Z or 0-9. The characters “.”, “-” and “_” are permitted, but not at the end and not next to each other. If the relevant free tape pool does not yet exist, it will be created. Otherwise, it is extended to include the specified tapes.

The values *STD and *SAME may not be specified.

DOMAIN =
Specifies which domain the free tapes are assigned to.

DOMAIN = *STD-DOMAIN
The free tapes are assigned to the standard domain.

DOMAIN = *OWN
The free tapes are assigned to the user’s own domain. The user’s own domain is the domain of the system on which the ADA is currently working.

DOMAIN = <alphanum-name 1..8>
The free tapes are assigned to the specified domain.

INITIALIZATION = *NO / *YES(...)
Specifies whether the tapes must be initialized before being used for the first time (e.g. brand new tapes). The default is *NO, i.e. no initialization is required.

INITIALIZATION = *YES(...)
The tapes must be initialized. An output file with preset values for initialization can be created using the INIT-FILE operand. The actual initialization must be performed using the INITIALIZE-VOLUMES statement.

INIT-FILE =
Specifies the file to which the settings for initialization are to be written (output file). The file type is SAM. This file is created only if at least one tape needs to be initialized.

INIT-FILE = MARENADM.INIT-FILE
The initialization file with the default name is generated. This name is also used as the default name for the INITIALIZE-VOLUMES statement.

INIT-FILE = *NONE
No initialization file is generated. In this case the initialization file must be created using the FREE-VOLUMES statement before INIT-VOLUMES is called.

INIT-FILE = <filename 1..54 without-gen-vers>(...)
Name of the output file to be created.

INIT-LOCATION =
Location name or symbolic location name.

INIT-LOCATION = *NONE
The catalog entry field HOME-LOCATION is not modified.

INIT-LOCATION = <alphanum-name 1..8>
This location name is stored in the catalog entry field HOME-LOCATION. After successful initialization and release, the HOME-LOCATION catalog entry field is filled with the content of the FREE-LOCATION catalog entry field.

USER-IDENTIFICATION = SYSMAREN / <name 1..8>
Specifies the user ID to which the tapes in the MAREN catalog are to be assigned until they have been initialized and subsequently released.

ACCOUNT = *NONE / <alphanum-name 1..8>
Account number of the specified user ID.

OVERFLOW-CONTROL =
Type of screen overflow control in interactive mode.

OVERFLOW-CONTROL = *BY-PROGRAM
Control by the program: after eighteen catalog entries have been processed, a message is displayed inquiring whether the current operation is to be continued or aborted.

OVERFLOW-CONTROL = *BY-SYSTEM
Control by BS2000: screen overflow control is based entirely on the system parameter TCHOFLO or the value set in the MODIFY-TERMINAL-OPTIONS command.

Notes

• When entering an interval for the archive numbers, you must ensure that the numeric parts within the two interval limits have the same length and position. The following entries will be rejected:

  Entry	Reason for error
  *INT(AAA3AA,AA9AAA)	Positions not identical
  *INT(AAA3AA,AA99AA)	Lengths not identical
  *INT(A3AAA3,A9AAA9)	Positions not clearly defined due to a number of numerical parts
  *INT(AAA9AA,AAA3AA)	FROM operand > TO operand
  *INT(AAA3AA,BAA9AA)	Non-numeric parts not identical

• The numeric part may be up to six digits in length. The two interval limits may be identical.

• VSNs with less than six characters are padded with trailing blanks.

• If a archive number to be added already exists in the MAREN catalog, a message to this effect is issued and processing is continued with the next archive number.

• Each archive number added is logged.

• When processing has ended, the total number of VSNs added is output.

• To keep administration requirements to a minimum, directory-specific free tape pools should only be configured for a few important directories.

• If tapes which have to be initialized before being used (e.g. brand new tapes) are entered in the MAREN catalog, the parameter INITIALIZATION =*YES must be specified. The tapes are then not identified as free tapes. The catalog entry fields have the following default settings:

  VOL-STATUS = *RESERVED
INIT = *YES
USER-ID = SYSMAREN
ACCOUNT = *NONE
USER-ACC = *OWNER-ONLY
PASSWORD = *YES

• The date on which the free tape was entered in the MAREN catalog for the first time is stored in the catalog entry field REGISTRATION-DATE. The statement MODIFY-VOLUME-ATTRIBUTES enables the MAREN administrator to update the date. The date is output using the SHOW-/PRINT-VOLUME-ATTRIBUTES statement.

Examples

//add-free-volume volume=tape01
%	MARM108 MAREN CATALOG ENTRY TAPE01/0001 ADDED The archive number tape01 has been added to the MAREN catalog as a free tape stored. The location is the central archive. The value set in the system-specific MAREN parameter DEFAULT-DEVICE-TYPE (e.g. TAPE-C4) is entered as the device type.

//add-free-vol vol=(corrtp,id0001,id0002),free-loc=system3,dev-type=tape-c4

%  MARM108 MAREN CATALOG ENTRY CORRTP/0001 ADDED
%  MARM108 MAREN CATALOG ENTRY ID0001/0001 ADDED
%  MARM108 MAREN CATALOG ENTRY ID0002/0002 ADDED
%  MARM170 STATEMENT '//ADD-FREE-VOLUMES' PROCESSED

Three free tapes for the device type TAPE-C4 have been added and assigned to the location SYSTEM3.

//add-free-vol vol=*int(id0001,id0015),dev-type=tape-c4

%  MARM107 MAREN CATALOG ENTRY 'ID0001'/'0001' ALREADY EXISTS
%  MARM107 MAREN CATALOG ENTRY 'ID0002'/'0001' ALREADY EXISTS
%  MARM108 MAREN CATALOG ENTRY 'ID0003'/'0001' ADDED
%  MARM108 MAREN CATALOG ENTRY 'ID0004'/'0001' ADDED
%  MARM108 MAREN CATALOG ENTRY 'ID0005'/'0001' ADDED
%  MARM108 MAREN CATALOG ENTRY 'ID0006'/'0001' ADDED
%  MARM108 MAREN CATALOG ENTRY 'ID0007'/'0001' ADDED
%  MARM108 MAREN CATALOG ENTRY 'ID0008'/'0001' ADDED
%  MARM108 MAREN CATALOG ENTRY 'ID0009'/'0001' ADDED
%  MARM108 MAREN CATALOG ENTRY 'ID0010'/'0001' ADDED
%  MARM108 MAREN CATALOG ENTRY 'ID0011'/'0001' ADDED
%  MARM108 MAREN CATALOG ENTRY 'ID0012'/'0001' ADDED
%  MARM108 MAREN CATALOG ENTRY 'ID0013'/'0001' ADDED
%  MARM108 MAREN CATALOG ENTRY 'ID0014'/'0001' ADDED
%  MARM108 MAREN CATALOG ENTRY 'ID0015'/'0001' ADDED
%  MARM120 TOTAL OF 13 MAREN CATALOG ENTRIES PROCESSED
%  MARM171 PROCESSING OF STATEMENT '//ADD-FREE-VOLUMES' TERMINATED WITH ERRORS

Of the 15 specified VSNs, only 13 were added since the VSNs id0001 and id0002 already existed in the MAREN catalog.