ibm:hercules:userref:utilities
Table of Contents
Utilities
DASD Utilities
| Utility Name | Function |
| CCKDCDSK | CCKD DASD file integrity verification, recovery and repair utility |
| CCKDCOMP | CCKD DASD file compression utility |
| CCKDDIAG | CCKD DASD file diagnostics utility |
| CCKDSWAP | CCKD DASD file swap-endian program |
| DASDCAT | Display PDS datasets and members |
| DASDCONV | DASD image file conversion program |
| DASDCOPY | Copy DASD file to another DASD file |
| DASDINIT | DASD image file creation |
| DASDISUP | Fix XCTL tables in SVCLIB |
| DASDLOAD | DASD loader program |
| DASDLS | List datasets on a volume |
| DASDPDSU | PDS unload utility |
| DASDSEQ | Display sequential datasets |
TAPE Utilities
| Utility Name | Function |
| HETGET | Extract files from an AWS or HET tape file |
| HETINIT | Initialize an AWS or HET tape file |
| HETMAP | Show information about a HET or AWS tape file |
| HETUPD | Update and/or copy an AWS or HET tape file |
| TAPECOPY | Copy a SCSI tape to or from an AWSTAPE disk file |
| TAPEMAP | Show information about an AWS tape file |
| TAPESPLT | Split an AWS tape file |
| VMFPLC2 | VM formatted tape utility |
Miscellaneous Utilities
| Utility Name | Function |
| DMAP2HRC | P/390 DEVMAP conversion program |
CCKDCDSK (CCKD DASD file integrity verification, recovery and repair utility)
General Format
CCKDCDSK [-option [-option ... ]] filename
Options
-v (display version info and exit) -f (force check even if OPENED bit is on) -ro (open file read-only, no repairs) -level (level of checking, 1-4)
CCKDCOMP (CCKD DASD file compression utility)
General Format
CCKDCOMP [-option [-option ... ]] filename
Options
-v (display version info and exit) -f (force check even if OPENED bit is on) -level (level of checking, 1-4)
CCKDDIAG (CCKD DASD file diagnostics utility)
General Format
CCKDDIAG [-option [-option ... ]] filename
Options
-v (display version info and exit) -d (display DEVHDR) -c (display CDEVHDR) -1 (display L1TAB [l = numeric one]) -g (enable debug output)
CKD track related options:
-a cc hh (display absolute CCHH data) -r tt (display relative TT data) -2 (display L2TAB related to –a or –r) -t (display track data) -x (hex display track / key data) -ooo ll (hex display data at offset oo of length ll)
CCKDSWAP (CCKD DASD file swap-endian program)
General Format
CCKDSWAP filename
DASDCAT (Display PDS datasets and members)
General Format
DASDCAT -i image [SF=shadowfile] pdsname/spec:flags
DASDCONV (DASD image file conversion program)
General Format
DASDCONV [-option [-option ... ]] {infile | -} outfile
Options
-r (replace output file) -lfs (create single file even if > 2GB) -q (quiet option, suppress progress messages)
DASDCOPY (Copy DASD file to another DASD file)
General Format
DASDCOPY [-option [-option ... ]] infile[SF=shadowfile] outfile
Options
-v (display version info and help text) -h (display help text and quit) -q (quiet mode, suppress status) -r (replace output file) -z (compress using zlib (default)) -bz2 (compress using bzip2) -0 (do not compress output [0 = zero]) -blks n (size of output FBA file) -cyls n (size of output CKD file) -a (create output CKD file with alternatecylinders) -lfs (create single file even if > 2GB) -o type (output file type: CKD, CCKD, FBA,CFBA)
DASDINIT (DASD image file creation)
General Format
DASDINIT [-option [-option ... ]] filename
devtype[-model] volser [size]
Options
-v (display version info and help text)
-z (build compressed DASD using zlib)
-bz2 (build compressed DASD usng bzip2)
-0 (build image file with no compression [0 = zero])
-lfs (create single file even if > 2GB)
-a (include alternate cylinders)
-r (build raw DASD image file)
-b (make the wait PSW in the IPL1 record a BC-mode PSW.
If not specified the wait PSW will be an EC-mode PSW)
-m (enable the wait PSW in the IPL1 record for machine check
interruptions)-linux
\\
(null track images will look like linux DASDFMT’ed images)
DASDISUP (Fix XCTL tables in SVCLIB)
General Format
DASDISUP outfile [SF=shadowfile]
DASDLOAD (DASD loader program)
General Format
DASDLOAD [-option [-option ... ]] ctlfile outfile ,nsglevel
Options
-z (compress using zlib)
-bz2 (compress using bzip2)
-0 (do not compress output [0 = zero])
-lfs (create single file even if > 2GB)
-a (include alternate cylinders)
-b (for a volume without IPL text, make the wait PSW
written to the IPL1 record a BC-mode PSW.
If not specified the wait PSW will be an EC-mode PSW)
-m (for a volume without IPL text, make the wait PSW written to
the IPL1 record enabled for machine checks)
Control File
The control file is an ASCII text file consisting of a volume statement followed by one dataset statement for each dataset to be created.
Volume Statement
General Format
volser devtype[-model] [cyls [ipltext]]
Dataset Statement
General Format
dsname method units pri sec dir dsorg recfm lrecl ...... blksize keylen
DASDLS (List datasets on a volume)
General Format
DASDLS [-option [-option ... ]] filename [SF=shadowfile]
Options
-info (Show Format 1 DSCB information) -caldt (Display dates as YYYYMMMDD) -refdt (Display last-referenced date) -expdt (Display expiry date) -hdr (Display column headers) -dsnl[=n] (Reserve space for dataset names up to n characters) -yroffs[=n] (Add the year offset n to dates before displaying them)
DASDPDSU (PDS unload utility)
General Format
DASDPDSU filename [SF=shadowfile] pdsname [ASCII]
DASDSEQ (Display sequential datasets)
General Format
DASDSEQ [-DEBUG] [-EXPERT] [-ASCII] image [SF=shadowfile] filespec
HETGET (Extract files from an AWS or HET tape file)
General Format
HETGET tapefile outfile filenum
HETINIT (Initialize an AWS or HET tape file)
General Format
HETINIT [-option [-option ... ]] filename[volser] [owner]
Options
-d (disable compression, create AWSTAPE file) -h (display usage summary) -i (create IEHINITT formatted tape, default) -n (create NL (non labeled) tape
HETMAP (Show information about a HET or AWS tape file)
General Format
HETMAP [-option [-option ... ]] filename
Options
-a (print all label and file information, default) -bn (Print ‘n’ bytes per file, implies –s) -d (print only dataset information) -f (print only file information) -h (display usage summary) -l (print only label information) -s (print dump of each data file in SLANAL format) -t (print TAPEMAP-compatible format output)
HETUPD (Update and/or copy an AWS or HET tape file)
General Format
HETUPD [-option [-option ... ]] source [destination]
Options
-1...9 (compression level (1=fast, 9=best)) -b (use bzlib compression) -c n (set chunk size to n) -d (decompress source tape file) -h (display usage summary) -r (rechunk tape file) -s (strict AWSTAPE specification) -v (verbose information) -z (use zlib compression)
TAPECOPY (Copy a SCSI tape to or from an AWSTAPE disk file)
General Format
TAPECOPY [tapedrive] [awsfile]orTAPECOPY [awsfile] [tapedrive]
TAPEMAP (Show information about an AWS tape file)
General Format
TAPEMAP filename
TAPESPLT (Split an AWS tape file)
General Format
TAPESPLT infile outfile count
VMFPLC2 (VM formatted tape utility)
General Format
VMFPLC2 {DUMP controlfile outputfile | SCAN inputfile |LOAD inputfile}
Control File
Each line of the control file has the following format:
filename filetype filemode recfm lrecl type tapefile
DMAP2HRC (P/390 DEVMAP conversion program)
General Format
DMAP2HRC filename
Device Support
General Format
loc devnum devtype host[:port | :3990][:rem devnum] [COMP=n]
Set Buffer Address
Set Buffer Address to row x and column y.
@SBA x,y
Set Field
Set Field to highlight (“H”) and/or protected (“P”). @SF {H | P | HP }
New Line
Force a skip to a new line. @NL
===Align</wrap>**
Specify text alignment.
@ALIGN {NONE | LEFT | RIGHT | CENTER }
Variables
| $(VERSION) | The Hercules version. |
| $(HOSTNAME) | The host name, on which Hercules is running. |
| $(HOSTOS) | The host operating system. |
| $(HOSTOSREL) | The release of the host operating system. |
| $(HOSTOSVER) | The version of the host operating system. |
| $(HOSTARCH) | The host architecture. |
| $(HOSTNUMCPUS) | The number of host CPUs. UP (Uniprocessor for one CPU), or MP=n (Multiprocessor for more than one CPUs). |
| $(LPARNAME) | The LPAR name specified in the configuration file. |
| $(CSS) | The logical channel subsystem set or channel set for theterminal. |
| $(SUBCHAN) | The subchannel number for the terminal. |
| $(CCUU) $(ccuu) $(CUU) $(cuu) | Various forms of the device number of the terminal. |
ibm/hercules/userref/utilities.txt · Last modified: 2023/08/06 13:31 by Site Administrator