Program name
JYTCMAIN
Function
Scans the volumes in the specified scope of device numbers, volume serial numbers, or SMS storage groups, and then stores information about the detected volumes in the disk configuration definition file. Use the SYSIN parameters to specify the scan scope. If a disk configuration definition file with the same name already exists, information about the scanned volumes will be merged into the existing disk configuration definition file.
Syntax
//EXEC PGM=JYTCMAIN,PARM='[VOLUME(volser)][,SPACE(quantity,increment)]'
Parameters
If you omit the VOLUME parameter, the volume where the disk configuration definition file is stored will be automatically determined. If you omit the SPACE parameter, the size that is allocated to the disk configuration definition file will be automatically determined.
- VOLUME(volser) ~ <6 or fewer alphanumeric characters>
-
Volume where the disk configuration definition file to be allocated. The VOLUME parameter is enabled only when the disk configuration definition file is not managed by SMS. You can specify only one volume.
- SPACE(quantity,increment) ~ <numeric character>((1 to 16777215))
-
Size of the primary and secondary allocation amounts that are to be allocated to the disk configuration definition file. Specify the size in units of blocks (4,096 bytes). Specify the SPACE parameter when you want to, for example, minimize the primary allocation size and then compensate for the shortage by using the secondary allocation size.
Return codes
The following table describes the return codes of the disk configuration acquisition program.
|
Return codes |
Meaning |
|---|---|
|
0 |
Successfully completed. Information about the volumes that were successfully detected was output to the disk configuration definition file. |
|
4 |
The volumes for which I/O paths could not be used were skipped. Information about the volumes that were successfully detected was output to the disk configuration definition file. |
|
8 |
|
|
16 |
|
|
64 |
An internal error occurred. |
Example of the JCL for the disk configuration acquisition program
//USERIDA JOB CLASS=A,MSGCLASS=A,NOTIFY=&SYSUID,REGION=0M //********************************************************************* //* //* All Rights Reserved. //* Copyright (C) 2024, 2026, Hitachi Vantara, Ltd. //* //********************************************************************* //JYTCMAIN EXEC PGM=JYTCMAIN,PARM='VOLUME(VOL010)' //SYSEXEC DD DSN=HITACHI.Vnnnnnn.HDSREXET,DISP=SHR //SYSABEND DD SYSOUT=* //RSLOG01 DD DSN=USER01.RSLOG01,DISP=OLD,VOL=SER=WKVL01,UNIT=DASD //RSLOG02 DD DSN=USER01.RSLOG01,DISP=OLD,VOL=SER=WKVL01,UNIT=DASD //SYSTSPRT DD SYSOUT=* //SYSTSIN DD DUMMY //SYSIN DD * PREFIX(YUKON.PREF1) DEVN(0000,0002,0005:0007,0009) /* DEVN specification */ VOLSER(VOL001,VOL003,VOL007:VOL009) /* VOLSER specification */ /*
- For the SYSEXEC DD statement, specify the EXEC library.
- Specify the statements SYSTSIN DD and SYSTSPRT DD. For the SYSTSIN DD statement, specify DUMMY.
- For SYSIN, specify the range of devices to be scanned.
SYSIN dataset format
- RECFM: F|FB
- LRECL: 80 bytes
- BLKSIZE: Multiple of LRECL