CREATE-TAPE-SET

Generate volume serial number set (tape set)

Component:	BS2000
Functional area:	File processing
Domain:	FILE
Privileges:	STD-PROCESSING
Routing code:	$ (with NBCONOPI=N) or E (with NBCONOPI=Y)

Function

The CREATE-TAPE-SET command is used to create a set of VSNs which can be used for producing tape files. The link with the tape files which are to be processed is set up by the ADD-FILE-LINK command (operand TAPE-SET-NAME). The set of VSNs is entered into the TST (TAPE SET TABLE). Within the TST, the TAPE-SET-NAME performs the same function as does the file link name within the TFT.
Information on TST entries can be obtained with the SHOW-FILE-LINK command.

Format

CREATE-TAPE-SET                                                                                                                                      

TAPE-SET-NAME = <alphanum-name 1..4>
,VOLUME = [*ANY](...) / list-poss(255): <alphanum-name 1..6>
	[*ANY](...)
		|	NUMBER-OF-DEVICES = 1 / <integer 1..9>
,DEVICE-TYPE = *TAPE / <device>

Operands

TAPE-SET-NAME = <alphanum-name 1..4>
The name of the tape set; this establishes the link to the TST with the specified name, or creates a new TST.

The tape set name must not be used simultaneously within the same task as a file link name.

VOLUME = *ANY(...) / list-poss(255): <alphanum-name 1..6>
VSNs of the tapes which are to be allocated to the tape set.

VOLUME = *ANY(...)
The operator, or MAREN if available, should mount any suitable tapes on the specified device type (no particular VSN is required).

NUMBER-OF-DEVICES = 1 / <integer 1..9>
The number of tapes which is required. 

DEVICE-TYPE = *TAPE / <structured-name 1..8>
The device type to which the tapes are assigned.
The value to be specified is the device type or volume type of the tapes, from which the Device Management System determines the device type which is to be made available for tape processing.
Only device types or volume types known in the system are accepted. In interactive mode, DEVICE-TYPE=? calls up a list of the available device and volume types.
The default value is TAPE, i.e. for tape processing the devices to be used should support a recording density of 1600 or 6250 bpi (bytes per inch). Other permitted specifications will be found in the table in section "Device types for DMS tape processing".

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command executed
	1	CMD0202	Syntactical or semantic error in command
	32	DMS0584	A state that does not allow the function to continue was reported during processing
	32	DMS05C7	Unexpected internal error in DMS
	64	DMS0586	It is not possible to access or reserve a volume at present
	64	DMS0587	Use of the specified command has been restricted by the system administrator
	64	DMS06FF	BCAM connection severed
	130	DMS0524	System address space exhausted
	130	DMS0586	It is not possible to access or reserve a volume at present
	130	DMS0594	Not enough virtual memory available

Example

Creation of a tape set with subsequent file processing

/cre-tape-set tape-set-name=tap1,vol=(d2312k,d2315k,d2322k),
              dev-type=tape-c4 ——————————————————————————————————————————   (1)
/show-file-link link=tap1,inf=(vol=*yes)                —————————————————   (2)

%
%-- LINK-NAME --------- FILE-NAME -----------------------------------------
% T TAP1                *DUMMY 
%  -------------------- VOLUME -------------------------------------------- 
%  NUM-OF-VOL = 3           NUM-OF-DEV = 0 
%  DEV-TYPE   = TAPE-C4     T-SET-NAME = TAP1 
%  T-SET-SHR  = 1           F-SET-ID   = D2312K 
%  VSN/DEV    = D2312K              D2315K              D2322K 
%  T-SET-VSN  = (D2312K)   D2315K    D2322K 

/cre-file max.tape-file.3,sup=*tape(vol=*no,dev-type=tape-c4,premount=0) —  (3)
/add-file-link link=dmcopy22,file-name=max.tape-file.3,
               number-of-premounts=0
               sup=*tape(vol-list=*tape-set(tap1)) ——————————————————————   (4)
/show-file-link link=dmcopy22,inf=(file-contr=*yes,vol=*yes)   ——————————   (5)

%
%-- LINK-NAME --------- FILE-NAME -----------------------------------------
% T DMCOPY22            :2OS2:$USER1.MAX.TAPE-FILE.3 
%  -------------------- FILE-CONTROL-BLOCK - GENERAL ATTRIBUTES ------------- 
%  ACC-METH   = *BY-PROG    OPEN-MODE  = *BY-PROG    REC-FORM   = *BY-PROG 
%  REC-SIZE   = *BY-PROG    BUF-LEN    = *BY-PROG    BLK-CONTR  = *BY-PROG 
%  F-CL-MSG   = STD         CLOSE-MODE = *BY-PROG 
%  -------------------- FILE-CONTROL-BLOCK - DISK FILE ATTRIBUTES ----------- 
%  SHARED-UPD = *BY-PROG    WR-CHECK   = *BY-PROG    IO(PERF)   = *BY-PROG 
%  IO(USAGE)  = *BY-PROG    LOCK-ENV   = *BY-PROG 
%  -------------------- FILE-CONTROL-BLOCK - TAPE FILE ATTRIBUTES ----------- 
%  LABEL      = *BY-PROG   (DIN-R-NUM  = *BY-PROG,   TAPE-MARK  = *BY-PROG) 
%  CODE       = *BY-PROG    EBCDIC-TR  = *BY-PROG    F-SEQ      = *BY-PROG 
%  CP-AT-BLIM = *BY-PROG    CP-AT-FEOV = *BY-PROG    BLOCK-LIM  = *BY-PROG 
%  REST-USAGE = *BY-PROG    BLOCK-OFF  = *BY-PROG    TAPE-WRITE = *BY-PROG 
%  STREAM     = *BY-PROG 
%  -------------------- FILE-CONTROL-BLOCK - ISAM FILE ATTRIBUTES ----------- 
%  KEY-POS    = *BY-PROG    KEY-LEN    = *BY-PROG    POOL-LINK  = *BY-PROG 
%  LOGIC-FLAG = *BY-PROG    VAL-FLAG   = *BY-PROG    PROPA-VAL  = *BY-PROG 
%  DUP-KEY    = *BY-PROG    PAD-FACT   = *BY-PROG    READ-I-ADV = *BY-PROG 
%  WR-IMMED   = *BY-PROG    POOL-SIZE  = *BY-PROG 
%  -------------------- VOLUME -------------------------------------------- 
%  NUM-OF-VOL = 3           NUM-OF-DEV = 1 
%  DEV-TYPE   = *NONE       T-SET-NAME = TAP1 
%  T-SET-SHR  = 2           F-SET-ID   = D2312K 
%  VSN/DEV    = D2312K              D2315K              D2322K 
%  T-SET-VSN  = (D2312K)   D2315K    D2322K 

/copy-file from=lst.bsp.2,to=max.tape-file.3 ————————————————————————————   (6) 
/show-file-attr max.tape-file.3,inf=(alloc=*yes) ————————————————————————   (7)

%         :2OS2:$USER1.MAX.TAPE-FILE.3 
%  ------------------------------- ALLOCATION   --------------------------- 
%  SUPPORT    = PVT                                  BLK-COUNT =  1 
%  EXTENTS     VOLUME     DEVICE-TYPE      EXTENTS     VOLUME     DEVICE-TYPE 
%              D2312K       TAPE-C4        (           D2315K       TAPE-C4 ) 
%  (           D2322K       TAPE-C4 ) 
%:2OS2: TAPE  :      1 FILE

(1)	Creates the tape set TAP1 containing the three magnetic tape cartridges (volume type TAPE-C6) with the volume IDs D2312K, D2315K, and D2322K.
(2)	Output of the TST entry with the command SHOW-FILE-LINK.
(3)	Creates a catalog entry for a tape file under the file name MAX.TAPE.FILE.3. No volume identifier has been defined as yet: TAPE-C6 is specified as the volume type. It is not necessary to reserve a magnetic tape cartridge in this case (NUMBER-OF-PREMOUNTS=0).
(4)	A TFT under the link name DMCOPY22 is created for the file MAX.TAPE.FILE, since the COPY-FILE command is to be used to copy data into this file. At the same time, the TFT entry is linked with the tape set TAP1 (VOLUME-LIST= *BY-TAPE-SET).
(5)	Output of the TFT entry with the link name DMCOPY22. The output includes relevant information on file processing and volumes.
(6)	The contents of file LST.BSP.2 are copied to the file MAX.FILE.3.
(7)	Returns information from the catalog entry of the file MAX.FILE.3 showing volume allocation attributes. The file was created on the magnetic tape cartridge D2312K. In this case, however, the volume IDs D2315K and D2322K (from the TST entry) are also entered into the volume list of the catalog entry. These volumes are to be used if the file MAX.TAPE.3 is extended and the tape cartridge D2312K does not have enough space for this purpose.