MAREN also supports tape types which cannot be processed in BS2000. It is therefore possible to store administrative data on these tapes in the MAREN catalog.
For these foreign tape types MAREN supports all functions which do not perform tape processing. The catalog entry fields are assigned suitable values. The MAREN user is responsible for entering meaningful values.
The following statements are available to the MAREN administrator for administering the foreign tape types:
- ADD-FOREIGN-DEVICE-TYPE
- REMOVE-FOREIGN-DEVICE-TYPE
- RENAME-FOREIGN-DEVICE-TYPE
- SHOW-FOREIGN-DEVICE-TYPES
When domains are used, the MARENADM statements ADD-FOREIGN-DEVICE-TYPE, REMOVE-FOREIGN-DEVICE-TYPE and RENAME-FOREIGN-DEVICE-TYPE are available only to the Domain Administrator, SHOW-FOREIGN-DEVICE-TYPES also to the Domain Administrator.
Up to 16 foreign tape types can be included in the MAREN catalog. MAREN internally assigns the following values to the series: In the catalog entry field DEVICE, the first entry is assigned the value X'0001', the second X'0002', the tenth X'000A' and the sixteenth the value X'0010'.
Restrictions
When working with foreign tape types the following restrictions must be taken into consideration:
- Only names which are not known to BS2000 may be used for the foreign tape types. Abbreviations must also be taken into account.
- The MARENADM statement FREE-VOLUMES does not evaluate the INIT flag.
- The MARENADM statement FREE-VOLUMES releases tapes after the expiration date has been reached without any further check.
- The free tape administrator MARENUCP does not support foreign tape types.
- The MARENADM statement INIT-VOLUME rejects a foreign tape type in the case of the DEVICE-TYPE operand.
Example
CDs are to be added to the MAREN catalog. The user ID MAINT administers the CDs and the service stores them. The MAREN administrator proceeds as follows:
- Load MARENADM. If (as in this example) domains are being used, the administrator then switches to the role of the ADA (here without entering a password).
/START-MARENADM
% MARM100 MARENADM VERSION '<version>' STARTED
% MARM091 MARENADM is working in 'DOMAIN-MODE'
//MODIFY-ADMINISTRATION-SCOPE DOMAIN=*ALL
% MARM091 MARENADM is working in 'ALL-DOMAIN-MODE' - Add tape type CD:
//ADD-FOREIGN-DEVICE-TYPE DEVICE-TYPE=CD
% MARM030 The foreign-device-type 'CD' is announced to MAREN with the
volume-type x'0001'. - Permit tapes type CD for reservations:
//MODIFY-MAREN-PARAMETERS
RESERVE-DEVICE-TYPES=*PARAMETERS(DEVICE-TYPE=CD)
% MARM170 STATEMENT '//MODIFY-MAREN-PARAMETERS' PROCESSED - Add free tapes of the type CD to the catalog:
//ADD-FREE-VOLUMES VOLUME=*INTERVAL(FROM=CD0001,TO=CD0003),
FREE-LOCATION=PCSERVIC,DEVICE-TYPE=CD
% MARM108 MAREN CATALOG ENTRY 'CD0001'/'0001' ADDED
% MARM108 MAREN CATALOG ENTRY 'CD0002'/'0001' ADDED
% MARM108 MAREN CATALOG ENTRY 'CD0003'/'0001' ADDED
% MARM120 TOTAL OF 3 MAREN CATALOG ENTRIES PROCESSED - Reserve two tapes of the type CD: Here a non-existent file name START-CD is stored. This can be used later to ascertain all such CDs in the MAREN catalog simply and efficiently. Furthermore, two additional remarks are entered.
//RESERVE-FREE-VOLUME USER-IDENTIFICATION=MAINT,
NUMBER-OF-VOLUMES=2,SELECT=*BY-ATTRIBUTES(VOLUME=*ALL,
DEVICE-TYPE=CD,HOME-LOCATION=PCSERVIC),FILE-NAME=
START-CD,REMARK=C'WINDOWS REGISTRY',REMARK-2=C'PC-NAME'
% MARM127 VOLUME 'CD0001' RESERVERD FOR USERID 'MAINT'
% MARM127 VOLUME 'CD0002' RESERVERD FOR USERID 'MAINT' - Modify the attributes of the tapes, for instance by entering information in the USERFIELD operand:
//MODIFY-VOLUME-ATTRIBUTES VOLUME=CD0001,USER-FIELD=C'BACKUP'
% MARM121 MAREN CATALOG ENTRY 'CD0001'/'0001' MODIFIED - Display the attributes of tape CD0001
//SHOW-VOLUME-ATTRIBUTES VOLUME=CD0001,INFORMATION=*NORMAL
VOLUME = CD0001 FILE-SEQ = 0001 DEV-TYPE = CD
USER-ID = MAINT HOME-LOCATION = PCSERVIC RESERV-DATE = <date>
ACCOUNT = FREE-LOCATION = PCSERVIC FREE-DATE = <date>
USER-ACC = OWNER-ONLY TEMP-LOCATION = PCSERVIC EXPORT-DATE =
PASSWORD = NONE
REMARK = C'WINDOWS REGISTRY '
EXPORT-AD = C' '
USER-FIELD= C'BACKUP '
FILE-NAME = START-CD
FREE-POOL = *NO
OPEN-MODE = CR-DATE = LAST-ACC-DATE =
DEV-NAME = CR-TIME = LAST-ACC-TIME =
VOL-SEQ = 0001 CR-CAT-ID = LAST-ACC-USER-ID =
FIRST-VOL = CR-USER-ID = LAST-ACC-ACCOUNT =
CLOSE-IND = CR-JOB-NAME = LAST-ACC-JOB-NAME=
EXPIR-DATE= LAST-CL-DATE = LAST-ACC-TSN =
AUDIT = NO LAST-CL-TIME = LAST-ACC-SNO =
VOL-STATUS= RESERVED RESERV-COUNT = 0002 LAST-ACC-HOSTNAME=
INIT = NO ACCESS-COUNT = 00000000 LAST-ACC-FUN-NAME= MODIFY1
ADM-FIELD = C' 'CHECK-COUNT = 06 LAST-ACC-FUN-FLAG= 23