The OPTION statement is used to activate and deactivate optional functions; the setting remains valid for all subsequent INIT or LIST operations. The options are enforced until the program is ended or until reset.
Format
OPTION |
CONS / PROT / DIN / NOHDR / NONE |
Operands
CONS
Diverts inputs/outputs to the console once the program has been started from the console by means of the ENTER job.
CONS is valid only within an ENTER job and is rejected in interactive mode.
PROT
Aborts initialization of a volume if the read-before-write check discovers an access restriction.
Each of the following criteria is a valid access restriction:
The access flag in the VOL1 volume label permits access to the volume only by the owner (byte 11 in the VOL1 label contains neither “0” nor “ ” (space)).
The access flag in the file label of the first file permits access to the file only by the owner (byte 54 in the HDR1 label contains neither “0” nor “ ” (space)).
The expiration date of the first file is not yet reached (bytes 48-53 in the HDR1 label).
The first file is protected by a read and/or write password (bytes 57-64 in the HDR3 label).
The first file is write-protected (byte 69 in the HDR3 label contains a “1”).
In all the cases listed above, the labels are read and output, followed by a message defining the situation and a prompt calling for another statement.
If the user wants to initialize the volume despite the access restriction, the OPTION NONE statement must be used to revoke the restriction.
DIN
Excludes special characters that do not conform to DIN 66003 from being used in labels. If the user wants to employ special characters (#, $, @) in labels nevertheless, OPTION NONE must be used to revoke the restriction.
NOHDR
Initializes a volume with the VOL1 volume label only. Once this option is activated, all subsequent initializations are implemented without HDR labels until the option is reset. In order to resume initialization with the HDR1 and HDR2 labels, OPTION NONE must be used to revoke the NOHDR setting.
NONE
Resets all options.
Option CONS cannot be reset.
Examples
OPTION PROT
(OUT) % NVI0001 ENTER COMMAND (END = TERMINATE INIT) (IN) OPTION PROT a) (OUT) % NVI0001 ENTER COMMAND (END = TERMINATE INIT) (IN) INIT TAPE-C4,VSN=TEST01 b) (OUT) % NVI0003 LABELS ON TAPE : c) (OUT) % NVI0004 VOL1 LABEL: 'VOL1DAR15K ' ' 1' (OUT) % NVI0004 HDR1 LABEL: 'HDR1V11.TEST-R.TXT.TEDAR15K0001000100010' '0 92104 92107 000000BS2000 ' (OUT) % NVI0101 EXPIRATION DATE OF FIRST FILE NOT YET REACHED d) (OUT) % NVI0004 HDR2 LABEL: 'HDR2V8000102044 0 P ' ' .C..04 ' (OUT) % NVI0004 HDR3 LABEL: 'HDR3TSOS V11.TEST-R.TXT.TESTFILE.T-C' '4 ............00 ' (OUT) % NVI0201 TAPE PROTECTED. e) INITIALIZATION REQUEST REJECTED (OUT) % NVI0001 ENTER COMMAND (END = TERMINATE INIT)OPTION PROT is set.
A volume of type TAPE-C4 is to be initialized.
The labels of the volume are output. The expiration date of the first file on the volume has not yet been reached (bytes 48-53 of the HDR1 label).
A message to this effect is output.
No new labels are written. Initialization is aborted.
OPTION DIN
(OUT) % NVI0001 ENTER COMMAND (END = TERMINATE INIT) (IN) OPTION DIN a) (OUT) % NVI0001 ENTER COMMAND (END = TERMINATE INIT) (IN) LIST TAPE-C4,VSN=T#$@ b) (OUT) % NVI0405 INVALID OPERAND VALUE ',VSN=T#' (OUT) % NVI0001 ENTER COMMAND (END = TERMINATE INIT) (IN) INIT TAPE-C4,VSN=DAR10A,OWN=TEST#$@ c) (OUT) % NVI0405 INVALID VALUE ',OWN=TEST#' (OUT) % NVI0001 ENTER COMMAND (END = TERMINATE INIT)
OPTION DIN is set.
The labels of a volume of type TAPE-C4, whose volume serial number contains special characters, are to be output. This statement is rejected.
A volume of type TAPE-C4 is to be initialized and the owner’s name entered in the VOL1 label. The name in question includes special characters. This statement is rejected.
OPTION NOHDR
(OUT) % NVI0001 ENTER COMMAND (END = TERMINATE INIT) (IN) OPTION NOHDR a). (OUT) % NVI0001 ENTER COMMAND (END = TERMINATE INIT) (IN) INIT TAPE-C4,VSN=TAPE01,CHECK=TAPE01 b) (OUT) % NVI0003 LABELS ON TAPE c) (OUT) % NVI0004 VOL1 LABEL: 'VOL1TAPE01... (OUT) % NVI0004 HDR1 LABEL: 'HDR1 ... (OUT) % NVI0004 HDR2 LABEL: 'HDR2U00001... (OUT) % NVI0007 OVERWRITE TAPE ? d) REPLY (YES=YES N=NO) (IN) YES (OUT) % NVI0010 INITIALIZATION OF TAPE 'TAPE01' ON DEVICE 'TA' COMPLETED (OUT) % NVI0001 ENTER COMMAND (END = TERMINATE INIT) (IN) LIST TAPE-C4,VSN=TAPE01 e) (OUT) % NVI0003 LABELS ON TAPE : f) (OUT) % NVI0004 VOL1 LABEL: 'VOL1TAPE01... (OUT) % NVI0001 ENTER COMMAND (END = TERMINATE INIT)OPTION NOHDR is set.
A volume is to be initialized.
The VOL1, HDR1 and HDR2 labels on the volume are output.
The volume is re-initialized.
The labels are to be output.
The volume is initialized with a VOL1 label and no others.