Previous Topic: Inquiry on Control RecordsNext Topic: Update the TMC Using the CA 1 ISPF Utility Functions


Build New TMC Records

Note: The security profile (password) entered on the CA 1 PRIMARY OPTION MENU must provide update authority for all TMC volume and DSNB fields.

In the following example, TMC information is built for a multivolume, multi-data set volume set. The volumes defined are AIVS volumes. The first file (file sequence one) is contained on three volumes (AAAAAA, BBBBBB, and CCCCCC). File two is contained on the third volume (CCCCCC). File three starts on the third volume and is continued on the fourth and fifth volumes (DDDDDD and EEEEEE). File four is contained on the fifth volume. All of the files are cataloged.

The Build new TMC record option is set to YES.

----------------------- CA 1 INQUIRY/UPDATE TMC MENU -------------------- COMMAND ===> Inquire/update TMC record by volume serial number Volser number ===> to Inquire/update TMC record by DSNB number DSNB number ===> to Inquire/update TMC record by Data Set Name Data Set Name ===> Cataloged ===> YES (Yes or No) Inquire TMC control record Yes/No ===> NO Build new TMC record Yes/No ===> YES

The CA 1 ISPF Build New TMC Record display shown on the following page is generated as a result of the request.

----------------------------- BUILD NEW TMC RECORD ---------------------------- COMMAND ===> DATE: MMMDD YYYY 99.340 General Media Location Base volume = TRTCH = Vlt/Area= Label type = Density = Slot = Outdate = AIVS = NO Foreign = NO (implies AIVS) Actual volume = (For AIVS (required) or foreign (optional)) User acctg = First File Information File name = Expiration date = Record format = Record length = Catalog file = NO Block size = UCBTYP = Optional Override Creation jobname= Enter V for multiple volumes or enter F for multiple files. Enter SAVE to accept and prepare to enter a new volume set. Press END to return to previous level. Enter CANCEL to ignore changes and return to previous level.

For individual field definitions and restrictions, press PF HELP while this screen is shown.

Data for the base volume is filled in. Enter a V on the command line to indicate that additional volume(s) for the first file are needed.

----------------------------- BUILD NEW TMC RECORD ---------------------------- COMMAND ===> DATE: MMMDD YYYY 99.340 General Media Location Base volume &coA. = 001812 TRTCH = 18TK Vlt/Area= Label type = SL Density = 38K Slot = Outdate = AIVS &coB. = YES Foreign = NO (implies AIVS) Actual volume = AAAAAA (For AIVS (required) or foreign (optional)) User acctg = USER.ACCTG First File Information File name = YURID01.TEST.FILE1 Expiration date = MMMDD YYYY Record format = FB Record length = 80 Catalog file = YES Block size = 3120 UCBTYP = Optional Override Creation jobname= CJBO Enter V for multiple volumes or enter F for multiple files. Enter SAVE to accept and prepare to enter a new volume set. Press END to return to previous level. Enter CANCEL to ignore changes and return to previous level.

Note: Two fields, Base Volume A and Actual Volume B, have special rules based on the values given to AIVS and Foreign.

If AIVS and Foreign are both set to NO (not an AIVS volume), then the Base Volume is assumed to be both the internal and external volume serial number for the tape being added. The requirement for Base Volume is that it must be a valid volser in the TMC and must be in delete status. The Actual Volume field is not used.

If AVIS=YES and Foreign=NO, then the Base Volume is the external volser that is assigned to the new volume being added. This volser should be in delete status. If the specified volume is not in delete status, a sequential search of the TMC begins, starting at the specified volser, until a record in delete status is found. Only volumes in delete status may be built or added to the TMC through this facility.

Actual Volume is the actual internal volser found on the VOL1 record of the tape being added. This volser will not be used by the OS catalog and should not be used in JCL. It will only be used by CA 1 at OPEN/Input to ensure the correct tape is mounted.

If AVIS and Foreign are both set to YES, then the same rules apply as above except that in addition to being in delete status, the Base Volume must also have the TMNRS indicator turned on in FLAG4. If not, the TMC is searched sequentially looking for a volume record in delete status that also has the TMNRS indicator turned on.

Enter the first additional volume on the line provided. If more volumes are needed, enter an A in the command column to provide space for adding the next volume.

For AIVS volumes, the volume serial entered here is the actual volume serial of the tape, and may not be the same as the CA 1 assigned external volser. Volumes are assigned by CA 1 from those in delete status starting at or following the base volume given.

For foreign volumes (Foreign=YES), volumes are assigned by CA 1 from those in delete status starting at or near the base volume given. The nonresident indicator (TMNRS bit of TMFLAG4) must also be on.

For volumes that are non-AIVS and non-foreign, the exact volumes must be present in the TMC and in delete status. No searching for substitutes is done.

------------------------- ENTER TMC ADDITIONAL VOLUMES ------ ROW 1 TO 2 OF 2 COMMAND ===> SCROLL ===> CSR DATE: DDMMM YYYY File name = USER001.TEST.FILE1 96.053 File sequence = 0001 First volume = 001812 A = Add a new volume D = Delete a volume Volume Cmd Serial _ BBBBBB _ CCCCCC ******************************* BOTTOM OF DATA ********************************

Enter all additional volumes for the first file before continuing to define additional files.

For individual field definitions and restrictions, press PF HELP while this screen is shown.

When finished entering additional volumes, press PF END to return to the previous screen.

Enter an F in the command line to indicate that additional files are to be defined.

----------------------------- BUILD NEW TMC RECORD ---------------------------- COMMAND ===> F DATE: DDMMMYYYY 96.053 General Media Location Base volume = 001812 TRTCH = 18TK Vlt/Area= Label type = SL Density = 38K Slot = Outdate = AIVS = YES Foreign = NO (implies AIVS) Actual volume = AAAAAA (For AIVS (required) or foreign (optional)) User acctg = USER.ACCTG First File Information File name = USER001.TEST.FILE1 Expiration date = DDMMMYYYY Record format = FB Record length = 80 Catalog file = YES Block size = 3120 Creation jobname= CJOB Enter V for multiple volumes or enter F for multiple files. Enter SAVE to accept and prepare to enter a new volume set. Press END to return to previous level. Enter CANCEL to ignore changes.

The screen shown below is used to enter information for additional file(s).

Space is provided to enter information for the first additional file. To create space for another file, enter A in the command column.

The file sequence number and first volume (volume where this file starts) are provided and may not be modified.

For individual field definitions and restrictions, press PF HELP while this screen is shown.

-------------------------- ENTER TMC ADDITIONAL FILES ------- ROW 1 TO 1 OF 1 COMMAND ===> SCROLL ===> CSR DATE: DDMMMYYYY Base volume = 001812 96.053 Cmd (A = Add a new file D = Delete a file V = additional volume(s)) _ File name = File sequence = 0002 First volume = CCCCCC Record format = Record length = Block size = Creation jobname = Expiration date = Catalog file = NO - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ******************************* BOTTOM OF DATA ********************************

After entering information for files two and three, type V in the command column to specify additional volume(s) for file three.

-------------------------- ENTER TMC ADDITIONAL FILES ------- ROW 1 TO 2 OF 2 COMMAND ===> SCROLL ===> CSR DATE: DDMMMYYYY Base volume = 001812 96.053 Cmd (A = Add a new file D = Delete a file V = additional volume(s)) _ File name = USER001.TEST.FILE2 File sequence = 0002 First volume = CCCCCC Record format = FB Record length = 82 Block size = 820 Creation jobname = CJF2 Expiration date = DDMMMYYYY Catalog file = YES - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - V File name = USER001.TEST.FILE3 File sequence = 0003 First volume = CCCCCC Record format = FB Record length = 83 Block size = 830 Creation jobname = CJF3 Expiration date = DDMMMYYYY Catalog file = YES - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Enter the volume serial number for the second and third volumes containing file three.

Press PF END when finished entering additional volumes.

------------------------- ENTER TMC ADDITIONAL VOLUMES ------ ROW 1 TO 2 OF 2 COMMAND ===> SCROLL ===> CSR DATE: DDMMMYYYY File name = USER001.TEST.FILE3 96.053 File sequence = 0003 First volume = CCCCCC A = Add a new volume D = Delete a volume Volume Cmd Serial _ DDDDDD _ EEEEEE ******************************* BOTTOM OF DATA ********************************

To create space for another file, enter A in the command column.

-------------------------- ENTER TMC ADDITIONAL FILES ------- ROW 2 TO 2 OF 2 COMMAND ===> SCROLL ===> CSR DATE: DDMMMYYYY Base volume = 001812 96.053 Cmd (A = Add a new file D = Delete a file V = additional volume(s)) A File name = USER001.TEST.FILE3 File sequence = 0003 First volume = CCCCCC Record format = FB Record length = 83 Block size = 830 Creation jobname = CJF3 Expiration date = DDMMMYYYY Catalog file = YES - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ******************************* BOTTOM OF DATA ********************************

The first volume for file four is automatically filled in with the last volume of the previous file (EEEEEE).

Press PF END when finished entering additional file information.

-------------------------- ENTER TMC ADDITIONAL FILES ------- ROW 2 TO 3 OF 3 COMMAND ===> SCROLL ===> CSR DATE: DDMMMYYYY Base volume = 001812 96.053 Cmd (A = Add a new file D = Delete a file V = additional volume(s)) _ File name = USER001.TEST.FILE3 File sequence = 0003 First volume = CCCCCC Record format = FB Record length = 83 Block size = 830 Creation jobname = CJF3 Expiration date = DDMMMYYYY Catalog file = YES - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - _ File name = USER001.TEST.FILE4 File sequence = 0004 First volume = EEEEEE Record format = FB Record length = 84 Block size = 840 Creation jobname = CJF4 Expiration date = DDMMMYYYY Catalog file = YES - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Enter SAVE on the command line to indicate that the definitions for this volume set are done.

----------------------------- BUILD NEW TMC RECORD ---------------------------- COMMAND ===> SAVE DATE: DDMMMYYYY 96.053 General Media Location Base volume = 001812 TRTCH = 18TK Vlt/Area= Label type = SL Density = 38K Slot = Outdate = AIVS = YES Foreign = NO (implies AIVS) Actual volume = AAAAAA (For AIVS (required) or foreign (optional)) User acctg = USER.ACCTG First File Information File name = USER001.TEST.FILE1 Expiration date = DDMMMYYYY Record format = FB Record length = 80 Catalog file = YES Block size = 3120 Creation jobname= CJOB Enter V for multiple volumes or enter F for multiple files. Enter SAVE to accept and prepare to enter a new volume set. Press END to return to previous level. Enter CANCEL to ignore changes.

If AIVS was set to YES on the Build New TMC Record screen, the following confirmation screen is displayed. It shows the actual and corresponding external volume serial numbers. Press ENTER to perform the update.

--------------------------------- CONFIRM AIVS ------------------ Using 001837 COMMAND ===> SCROLL ===> CSR B017 Volume 001837 assigned in place of 001812 96.053 Press ENTER to CONFIRM update, END or CANCEL to return to previous panel Actual Volume : External Volume AAAAAA : 001837 BBBBBB : 001838 CCCCCC : 001839 DDDDDD : 001840 EEEEEE : 001841 ******************************* BOTTOM OF DATA ********************************

If AIVS was set to NO on the Build New TMC Record screen, the TMC update takes place without a confirmation screen.

The Build New TMC Record screen is displayed again with most of the fields cleared. If another volume set is to be defined, you can do it now. Otherwise, press PF END to return to the previous menu.