Maintenance › VLS Utility (VLSUTIL) › How to Submit VLSUTIL Functions

How to Submit VLSUTIL Functions

To execute VLSUTIL functions, use the following sample JCL:

//     JOBCARD
// EXEC PGM=VLSUTIL
//STEPLIB DD DSN=LOAD,DISP=SHR
//        DD DSN=LOAD,DISP=SHR
//        DD DSN=LOAD,DISP=SHR
//SYSPRINT DD SYSOUT=*
//AUXPRINT DD SYSOUT=*
//VLSFILE DD DSN=dsname,DISP=SHR (VLS library)
//SYSIN DD *
at least one VLSUTIL control card
/*

The utility control cards are read from SYSIN. You can place the first character on each card in any column, including column 1. If the command has an operand, you must use at least one blank to separate the command from the operand. If there are multiple operands, you must use a blank or a comma to separate one operand from another. Because each utility operation is treated independently of any other, you can use the VLSUTIL functions in any logical order.

Optionally, you can specify a parameter to indicate the number of lines per page on the report output:

// EXEC PGM=VLSUTIL,PARM='99'

A 2-digit number is the only valid parameter value. If the PARM parameter is not supplied, the default of 55 lines per page is used for all report output.

Optionally, you can supply comment control cards (with an asterisk in column one) as desired in stream with the control cards that perform a function. For example, your comments might describe the purpose of the function that follows or simply document that a change has been made and what was changed.

Example: Comment Control Cards

//SYSIN    DD *
*
* PERFORM A SELECTIVE RESTORE OF THE DDOL SIGN/SIGNOFF PANELS TO ADRPNL
*
 HEX +
 SELREST #SCDDOF+4040404040404040404040+001$
 SELREST #SCDDOH+4040404040404040404040+001$
 SELREST #SCDDON+4040404040404040404040+001$
*
* OBTAIN A COMPLETE DIRECTORY LISTING OF THE MEMBERS IN THIS VLS FILE
*
 LIBRARY
/*

VLSUTIL functions include:

• ADD
• DELETE
• DUMP
• FORMAT
• LIBRARY
• LIST
• PUNCH
• RENAME
• SCAN

To use the BACKUP and RESTORE functions, use the INSTJCL member VQNEW02 or VQUPG02 as an example. You can edit these members to use the SELBKUP and SELREST functions. You can also edit these members to create new files.

The VLSUTIL functions are described in VLSUTIL Function Descriptions Listings from the LIBRARY, LIST, and DUMP commands are written to the AUXPRINT file. All other listings are written to the SYSPRINT file.