IBM Virtual Machine Facility/370: Operator's Guide 2
Page206(206 of 260)
EITERT=nnnn is the length of the voluae table of contents in tracks. The nuaber (deciaal) of entries per track for each type of device is given below. Device -2301 2314/2319 2311 2305-1 2305-2 3330-1,2 3330-11 3340 3350 (in 16 18 34 39 39 22 native .ode) 46 The IPtTIT state.ent separates service progra. control statements fro. IPt progra. text state.ents. It is required only when IPL=YES is coded on the DIDEr state.ent and 1Pt text is included. The stateaent consists of the characters IPLTIT, followed by blanks. When 1Pt text is included, the ERD state.ent .ust follow it and EBD .ust start in coluan 2. The EID stateaent denotes the end of the job. It appears after the last function-defining stateaent. The for.at of the EID statement is: • I[ naae] IEID I[user inforaation] , The tlSTCIRD statement is required only when a IBCDlSDI job or a series of stacked IBCDASDI jobs is followed bi other state.ents on the control statement input device. The tlSTCIRD statement must follow the last EBD statement applying to an IBCDISDI job. It consists of the operand tASTCARD, followed by blanks. 188 '8/370 Operator's Guide
ASSIGNING AN ALTERNATE TRACK (1) analyzes a track and, if necessary, assigns an alternate or (2) bypasses testing, and assigns an alternate. You .ust specify the tracks for which you wish alternates with a GETALT statement. an Alternate l!ack In alternate track (if available) -Is-assigned for a track specified for testing and found defective. If the defective track has had an alternate previously assigned, a new alternate track is assigned. If the defective track is an unassigned alternate track, it is flagged to prevent its future use and another alternate track is selected. The alternate track address is made known to the operator. If a track is tested and found to be "not defective," no alternate is assigned. The operator is notified by a aessage. The program's defective track checking feature can be bypassed, and an alternate track can be assigned for any track, whether it is permanently defective or not. If the specified track is an alternate, a new alternate track is assigned. If the specified track is an unassigned alternate, it is flagged to prevent its future use. For 3330, 3340, and 3350 minidisks you aust on the real disk. Any references thereafter to ainidisk are referred to the alternate track. assign the alternate that track on the Section 4. V8/370 Service Prograas 189
EITERT=nnnn is the length of the voluae table of contents in tracks. The nuaber (deciaal) of entries per track for each type of device is given below. Device -2301 2314/2319 2311 2305-1 2305-2 3330-1,2 3330-11 3340 3350 (in 16 18 34 39 39 22 native .ode) 46 The IPtTIT state.ent separates service progra. control statements fro. IPt progra. text state.ents. It is required only when IPL=YES is coded on the DIDEr state.ent and 1Pt text is included. The stateaent consists of the characters IPLTIT, followed by blanks. When 1Pt text is included, the ERD state.ent .ust follow it and EBD .ust start in coluan 2. The EID stateaent denotes the end of the job. It appears after the last function-defining stateaent. The for.at of the EID statement is: • I[ naae] IEID I[user inforaation] , The tlSTCIRD statement is required only when a IBCDlSDI job or a series of stacked IBCDASDI jobs is followed bi other state.ents on the control statement input device. The tlSTCIRD statement must follow the last EBD statement applying to an IBCDISDI job. It consists of the operand tASTCARD, followed by blanks. 188 '8/370 Operator's Guide
ASSIGNING AN ALTERNATE TRACK (1) analyzes a track and, if necessary, assigns an alternate or (2) bypasses testing, and assigns an alternate. You .ust specify the tracks for which you wish alternates with a GETALT statement. an Alternate l!ack In alternate track (if available) -Is-assigned for a track specified for testing and found defective. If the defective track has had an alternate previously assigned, a new alternate track is assigned. If the defective track is an unassigned alternate track, it is flagged to prevent its future use and another alternate track is selected. The alternate track address is made known to the operator. If a track is tested and found to be "not defective," no alternate is assigned. The operator is notified by a aessage. The program's defective track checking feature can be bypassed, and an alternate track can be assigned for any track, whether it is permanently defective or not. If the specified track is an alternate, a new alternate track is assigned. If the specified track is an unassigned alternate, it is flagged to prevent its future use. For 3330, 3340, and 3350 minidisks you aust on the real disk. Any references thereafter to ainidisk are referred to the alternate track. assign the alternate that track on the Section 4. V8/370 Service Prograas 189
IBM Virtual Machine Facility/370: Operator's Guide 2
Page204(204 of 260)
80DEL=n CYLHO=nnn is a decimal model number (lor 2). This operand is only for the 2305 and corresponds to the 2305-1 and 2305-2, respectively. is a decimal number that specifies the number of cylinders to be If the CYLIO parameter is omitted, IBCDASDI intializes the entire real volume specified. If aore cylinders are than are available on the minidisk, the message "Co.mand Reject" is returned. PLIGTEST=HO (applies to surface analysis) specifies that the program is not to check for previously flagged tracks before surface analysis is atteapted on this device. (FLIGTEST=IO applies only to 2314 and 2319 devices, and should be specified when the disk recording surface is initialized for the first time.) Note: Because no on-drua volumes, are initialized. check is made for previously flagged tracks PLAGTEST=NO is not coded when these devices P1SSES=n specifies the nuaber of passes per track to be aade in checking for defective tracks. PASSES is valid when surface analysis is to be performed or when a Quick DISDI is to be perforaed on a 3330, 3330-1, 3340, or 3350 volume. The value n can be 0 through 255. The 0 value indicates that a "Quick DASDI" is to be perforaed on a 3330, 3330-1, 3340, or 3350 volume. Por a 3330, 3330-1, 3340, or 3350 voluae, a value other than zero causes record 0 to be written on each track. PASSES=O should be specified for 3330, 3340, and 3350 (full disk or ainidisk) except when deliberately trying to free alternate areas assigned by GETALT in the prime data area, at which tiae P1SSES=1 would have to be specified. No check is made for defective tracks on a 3330, 3330-1, 3340, or 3350. A value of 1 through 255 indicates the number of passes to be aade per track for volumes other than a 3330, 3330-1, 3340, or 3350 volu.e. If PASSES is oaitted, one pass is made per track. BYP1SS=YES bypasses the rechecking flagged as defective. If are rechecked and those assigned alternates. Por is ignored and BYPASS=YES 186 V8/370 Operator's Guide of any tracks that are already BYPASS is omitted, flagged tracks found defective are automatically 3330 or 3350 devices, this operand is assumed.
The VLD statement labels the volume. is: The format of the VLD statement [name] VLD 1 NEiVOLID=serial 1 r , I I I I I, 11 I L .J I I [,ADDLABEL=ri] HEWVOLID=serial is a one-to-six character volume serial number. VOLPASS=l sets the volume security bit to 1. VOLPASS=O sets the volume security bit to O. If VOLPASS is oaitted, the volu.e security bit is set to O. OiBERID=xxxxxxxxxx ADDLABEL=n is a one-to-ten character field that identifies the owner of the volume. If OiBERID is omitted, no identification is given. The ownerid CP370 is reserved for use by DftKPftT and cannot be specified. is a number between one and seven number of additional labels for allocated. If ADDLABEL is omitted, 0 is assuaed. that indicates which space the total is to be The VTOCD statement contains information for controlling the location of the volume table of contents. The format of the VTOCD statement is: I i [name j I • iVToeD I jSTRTADR=nnnnn I,EXTElfT=nnnn STRTADR=nnnnn is the one to five byte track address, relative to the beginning of the ainidisk, at which the volume table of contents is to begin. The VTOC cannot occupy cylinder 0, track 00, or any alternate track. Section 4. V8/370 Service Prograas 187
IBM Virtual Machine Facility/370: Operator's Guide 2
Page208(208 of 260)
Any number of alternate tracks can be assigned in a single job by including one GETALT statement for each track. The GETALT statement can follow the MSG statement. The format of the GETALT statement is: [name] TODEV=xxxx TOADDR=cuu IGETALT I I I I I I I ITODEV=xxxx I,TOADDB=cuu I,TBICK=cccchhhh I,VOLID=serial I[,FLAGTEST=NO] 1[,PASSES=n] I[,BYPASS=YES] 1[,MODEL=n] is the device type of the direct access device. is the direct channel number (c) and unit number (uu) of the direct access device. TRACK=cccchhhh is the address of the track for which an alternate is requested, where cccc is the cylinder number and hhhh is the head number. These are hexadecimal numbers. YOLID=serial is the volume serial number of the disk or minidisk to which an alternate track is to be assigned. If serial matches the volume serial number found on this disk or minidisk, the alternate track assignment proceeds. If it does not match, the operator is notified. FLAGTEST=NO (used when testing before assigning an alternate) specifies that the program not check for a previously flagged track before a surface analysis is attempted on this track (disk storage devices only). PASSES=n (used when testing before assigning an alternate) specifies that the program's defective track checking feature is to make n number of passes (from 1 to 225j when performing a surface analysis. If PASSES is omitted, one pass is lade on this track. 190 VM/370 Operator's Guide
BYPASS=YES ftODEL=n is that the program's defective track checking feature is to be bypassed. If BYPASS is omitted, the program assigns an alternate only if it finds that the specified track is defective. is a decimal model number (lor 2). This operand is only for the 2305 and corresponds to the 2305-1 and 2305-2, respectively. !gte: A list of defective tracks (if any) is provided with new IBft disk storage volumes. Refer to this list when using the IBCDASDI prograa for the first time. After initialization, include the GETILT statement in an IBCDASDI job to assign an alternate track for each track on the list. Subsequent IBCDASDI jobs "remember" those defective tracks, unless the PLAGTEST=NO option is specified for those jobs. The example below shows the control statements that might be prepared to initialize a dedicated 3340 disk that is to be initialized by running IBCDASDI in a virtual machine. The disk is to be labeled VftRES and it is mounted on unit address 240. INIT240 JOB ftSG DADEP VLD YTOCD END TODEV=1052,TOADDB=009 TODEV=3340,TOADDB=240,VOLID=SCRATCa, FLAGTEST=NO,BYPISS=NO NEiYOLID=YftBES STRTADR=1,EXTENT=1 C Since the PASSES operand was not specified, it defaults to PISSES=l and a non-Quick DASDI function is perforaed. All tracks, including any that were previously flagged as defective, are tested. Plagged tracks that test okay are recovered (not flagged). lny tracks that do not pass the test are flagged and an alternate track is assigned. The example below shows the control statements that aight be used to explicitly assign alternate tracks to two tracks on the same disk shown in Example 1. It is assumed that these two tracks were found to be defective when the disk vas put into use, subsequent to its initialization in Exaaple 1. Once again the disk aust be dedicated to the virtual machine in which IBCD1SDI will be run. MOREALTS JOB ftSG GETALT GETILT TODEV=1052,TOADDR=009 BYPISS=YES,TRICK=00FB0003 TODEV=3340,TOADDR=240,VOLID=VftRES, BYP1SS=YES,TRICK=011C0005 c The TRACK operands specify the hexadeciaal ccaa addresses of the tvo tracks that get flagged as defective. Section 4. Yft/310 Service prograas 191