INITIALIZE-VOLUMES Initialize and release tapes

Privilege                 ADA, DA, administrator without domains

This statement is used to initialize and then release tapes which have been included in the output file of tapes to be initialized (INIT-FILE operand) on release with the FREE-VOLUMES statement. An existing archive number can be modified.

Format

INITIALIZE-VOLUMES                                                         Alias: INV

INIT-FILE = MARENADM.INIT-FILE / <filename 1..54 without-gen-vers>(...) / *NONE(...)
	<filename 1..54 without-gen-vers>(...)
		|	INIT-LOCATION = *ANY / <alphanum-name 1..8>
		|	,USER-IDENTIFICATION = SYSMAREN / *ANY / <name 1..8>
		|	,ACCOUNT = *ANY / <alphanum-name 1..8>
	*NONE(...)
		|	VOLUME = <vsn> (...)
		|		<vsn> (...)
		|			|	VOLUME-OWNER = *NO / *YES
		|	,OLD-VSN = *SAME / <vsn>
,UCON-USER-ID = *NONE / <name 4..4> 1
,DEVICE-TYPE = *STD / <structured-name 1..8>
,ERASE = *NO / *YES
,NEW-VOLUMES = *NO / *YES
,FORMAT-VOLUMES = *NO / *YES
,LABEL-FORMAT = *EBCDIC / *ISO7
,MESSAGE-DESTINATION = *CONSOLE / *SYSOUT / *BOTH / *NONE

¹The Operand value <name 4..4> is obsolete. It can still be specified for compatibility reasons.

Operands

INIT-FILE =
Name of the file containing the catalog entries for the tapes to be initialized. This file must be created with the FREE-VOLUMES statement.

INIT-FILE = MARENADM.INIT-FILE
The catalog entries are taken from the file MARENADM.INIT-FILE.

INIT-FILE = <filename 1..54 without-gen-vers>(...)
Name of the input file.

INIT-LOCATION =
Location or symbolic location name entered in the catalog entry field HOME-LOCATION during the release run. The location name for an archive system must always be specified.

INIT-LOCATION = *ANY
The tape location is not checked.

INIT-LOCATION = <alphanum-name 1..8>
The tapes must belong to the specified location.

USER-IDENTIFICATION =
User ID assigned to the tape during the release run.

USER-IDENTIFICATION = SYSMAREN
The tapes must be assigned to the user ID SYSMAREN.

USER-IDENTIFICATION = *ANY
The user ID of the tapes is not checked.

USER-IDENTIFICATION = <name 1..8>
The tapes must be assigned to the specified user ID.

ACCOUNT =
Account number assigned to the tape during the release run.

ACCOUNT = *ANY
The account number of the volumes is not checked.

ACCOUNT = <alphanum-name 1..8>
The volumes must have the specified account number.

INIT-FILE = *NONE(...)
An input file is not evaluated. This operand can also be used to change an archive number during initialization.

VOLUME = <vsn>(...)
Only the specified tapes are initialized. The device type specified in the subsequent DEVICE-TYPE operand is not evaluated. Private tapes can also be initialized if the EXPIRATION-DATE in the catalog entry has elapsed.

VOLUME-OWNER =
Specifies if an owner will be entered in the tape label.

VOLUME-OWNER = *NO
An owner is not entered in the tape label.

VOLUME-OWNER = *YES
The owner is entered in the tape label. The statement is only executed for reserved or private tapes.

OLD-VSN =
Specifies the archive number with which the tape was last initialized.

OLD-VSN = *SAME
The tape was last initialized with the same archive number. If there is a VOL1 label, the archive number must be the same.

OLD-VSN = <vsn>
The specified archive number must be in the VOL1 label.

UCON-USER-ID = *NONE
A connection to UCON is set up without authorization name.

The connection to UCON is set up automatically under any user ID for which the TAPE-ADMINISTRATION privilege and the operator role entered in the system-specific MAREN parameters (default: SYSMAREN) have been defined.

The SYSMAREN user ID which is configured with the TAPE-ADMINISTRATION privilege must be assigned the operator role to permit this.

DEVICE-TYPE =
Device type.

DEVICE-TYPE = *STD
The tapes are of the default device type (DEFAULT-DEVICE-TYPE) whose value was specified with the MODIFY-MAREN-PARAMETERS statement.

DEVICE-TYPE = <structured-name 1..8>
Device type to be used during initialization (for a list of possible entries, see also manual “System Installation” [6]).

Special features of the individual types:

TAPE-C4	Tapes of type TAPE-C4 are initialized. The current type is retained.
TAPE-C5,-C6	Tapes of type TAPE-C5 and C6 are initialized. The current type is retained.

ERASE = *NO / *YES  

Specifies whether all tapes are to be erased through to the end of the tape.

NEW-VOLUMES = *NO / *YES
Specifies whether error handling is to be suppressed when the labels are read. This function is intended for use with new tapes.

FORMAT-VOLUMES =
Specifies whether the tape is to be formatted during initialization, i.e. provided with servo tracks. Normally tapes are supplied with servo tracks anyway, so that formatting is necessary only after a corresponding error (“Servo tracks defective”).

FORMAT-VOLUMES = *NO
No formatting is carried out.

FORMAT-VOLUMES = *YES
Tapes are formatted simultaneously.

LABEL-FORMAT = *EBCDIC / *ISO7
Specifies which code is to be used when writing the labels on the tapes.

LABEL-FORMAT = *EBCDIC
The labels are written in EBCIDIC code.

LABEL-FORMAT = *ISO7
The labels are written in ISO7 code.

MESSAGE-DESTINATION = *CONSOLE / *SYSOUT / *BOTH / *NONE
Specifies the output medium for messages. If *BOTH is specified, messages are output to both SYSOUT and the console. The response to the message MARM1I0 is expected from SYSOUT if MESSAGE-DESTINATION=*SYSOUT is specified, and from the console if *CONSOLE and *BOTH are specified.

Notes

• The statement evaluates the input file INIT-FILE. It checks whether the file was created using the FREE-VOLUMES or ADD-FREE-VOLUMES statement. If this is not the case, initialization is aborted. The parameters INIT-LOCATION, USER-ID, and ACCOUNT are checked for each tape. The following values which are set by the release run are also checked to ensure that they have not changed:

  USER-ACCESS = *OWNER-ONLY
INITIALIZATION = *YES
LAST-ACC-FUN-NAME = FREE

  When a check is negative, the statement is aborted for safety’s sake.

• The operator is requested by messages to mount the tapes on free tape devices which correspond to the specified device type.

  He/She can mount one tape after another or several simultaneously. The order is arbitrary. The system automatically recognizes which tapes have been mounted. These tapes are initialized and released in the MAREN catalog.

• The tape device is unloaded after initialization and the operator is requested to mount the rest of the tapes. As long as no tape is mounted, this request is repeated periodically.

• Tapes containing no default labels are not recognized. The operator is requested to enter the archive number of the tape.

  The subsequent message NKVT013 must be acknowledged by the operator with tsn.mn if the correct tape is still mounted on the tape device.

• When tapes of an archive system are to be initialized, the information in the section “Initializing tapes in an archive system” must be observed.

• If tapes are provided in a magazine, the magazine must be set to automatic mode.

• If device errors occur during initialization, the relevant BS2000 messages must be dealt with.

• If initialization is unsuccessful, analysis of the console dialog (CONSLOG) frequently helps to determine the reason for this.

• Processing of the statement can be terminated properly prematurely.

  • Processing in a dialog task can be terminated after the program interrupt using the /INFORM-PROGRAM MSG='STOP-INIT' command.

  • Processing as a batch job can be terminated by systems support from another task using the /INFORM-PROGRAM MSG='STOP-INIT',JOB-ID= *TSN(TSN=<tsn>) command.

  Neither of these options affects the current initialization process.

• Up to 20,000 tapes can be initialized by this statement. If the input file contains more than 20,000 catalog entries, any additional catalog entries are ignored.

• If ERASE=*YES and/or FORMAT-VOLUME=*YES is/are specified, the connection to UCON is interrupted because processing takes longer.

• The tapes are also erased when ERASE = *NO is specified if the INITIALIZATION = ERASE parameter had already been set in the MODIFY-TAPE-SET-ATTRIBUTES or MODIFY-VOLUME-ATTRIBUTES statement.

Example

The following ENTER file contains a release run with subsequent initialization:

/.marenini set-logon-parameters user-id=tsos
/start-marenadm
//free-volumes init-file=maren.initfile
//init-volumes init-file=maren.initfile
//end
/exit-job