27.12.2012 Views

z/VM: CP Commands and Utilities Reference - z/VM - IBM

z/VM: CP Commands and Utilities Reference - z/VM - IBM

z/VM: CP Commands and Utilities Reference - z/VM - IBM

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

UTILITY<br />

►►<br />

UTILITY<br />

Purpose<br />

Oper<strong>and</strong>s<br />

DTYPE devno<br />

UTILTAPE ALL<br />

DSF<br />

DDRXA<br />

VTYPE devtype<br />

Use the UTILITY utility to provide occasionally-used installation utility functions:<br />

v Issuing DIAGNOSE code X'24' <strong>and</strong> X'210' for a virtual device<br />

v Creating a st<strong>and</strong>-alone service utility tape for either or both ICKDSF <strong>and</strong> DDRXA.<br />

DTYPE devno<br />

issues a DIAGNOSE code X'24' <strong>and</strong> X'210' for the specified virtual address,<br />

uses the returned information to look up the DASD type in the $DASD$<br />

CONSTS file, <strong>and</strong> returns that information to the terminal (if UTILITY DTYPE is<br />

issued from the terminal) or to the program stack (if UTILITY DTYPE is called<br />

by an exec).<br />

The information returned is a single line consisting of three fields:<br />

v DASD type, model, or both<br />

v The capacity of the device in cylinders<br />

v The proper representation of the given DASD model to the <strong>CP</strong>FMTXA<br />

program.<br />

If the virtual device address is incorrect, nonexistent, or addresses an<br />

unsupported device type, a nonzero return code is displayed.<br />

The UTILITY DTYPE function is intended primarily for use by installation-related<br />

utilities.<br />

UTILTAPE<br />

creates a tape containing either or both of the following st<strong>and</strong>-alone utility<br />

programs:<br />

DSF: Device Support Facility (ICKDSFSA COREIMAG)<br />

DDRXA:<br />

DASD Dump/Restore program (IPL DDRXA)<br />

UTILITY<br />

on a tape drive at virtual address 181.<br />

The version of DDRXA or ICKDSFSA that occurs first in the minidisk search<br />

order is the version placed on tape.<br />

If ALL is specified, both IPLable programs are written to the same tape file, with<br />

ICKDSFSA being written first. After the last program, two tape marks are<br />

written. When ALL is specified, to IPL the DDRXA program from the tape, you<br />

must IPL twice to bypass ICKDSFSA.<br />

If you do not have a R/W A-disk the tape write operation will complete but no<br />

$MSGLOG will be created.<br />

►◄<br />

Chapter 3. <strong>CP</strong> <strong>Utilities</strong> 1885

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!