© 2004 ibm corporation ibm ^ z/vm module 4: advanced structures and commands conversational...

© 2004 IBM Corporation

IBM ^

z/VMModule 4: Advanced Structures and Commands

Conversational Monitoring System

© 2004 IBM Corporation

IBM ^

Objectives

List and describe additional CMS commands, including:– Command descriptions

– Syntax diagrams

– Usage notes Describe the DIRMAP utility, including:

– Description

– Functions

– Usage notes

© 2004 IBM Corporation

IBM ^

Advanced CMS Commands

© 2004 IBM Corporation

IBM ^

DISK Command

© 2004 IBM Corporation

IBM ^

DISK LOAD Options

© 2004 IBM Corporation

IBM ^

DISK Usage Notes

To read files with the DISK LOAD command, they must have been created by the DISK DUMP command

To load reader files, you must issue the DISK LOAD command for each spool file

• For example:cp spool punch contdisk dump source1assembledisk dump source2 assemblecp spool nocont close

• Then you only need to issue the DISK LOAD command once to read both files You can read multiple files into separate files on disk or directory by spooling

your reader continuously and issuing DISK LOAD with the NOPROMPT option

© 2004 IBM Corporation

IBM ^

DISK Usage Notes continued

You can use the DEFAULTS command to set up options and override command defaults for DISK

DISK LOAD loads a file from the reader into a temporary work file called DISK CMSUT1 and if CMSUT1 already exists then CMSUT2 is created as a temporary file

If you specify the FULLPROMPT or MINPROMPT option the valid responses are explained below

If you encounter errors, the file is not purged by the DISK command, which protects you from losing reader spool files

© 2004 IBM Corporation

IBM ^

DEFAULTS

© 2004 IBM Corporation

IBM ^

DEFAULTS

© 2004 IBM Corporation

IBM ^

DEFAULTS Usage Notes

The FILELIST command has four profiles:• STATS screen• SHARE screen• SEARCH screen• ALLDATES screen

You can only set the CMS TELL command to MSGNOH if you are a Class B user

Within some commands, multiple settings can be issued together, such as:

• STACK FIFO

But since the default for STACK is FIFO, all you need to enter is:

• STACK or FIFO

© 2004 IBM Corporation

IBM ^

EXEC

© 2004 IBM Corporation

IBM ^

EXEC Examples

If QUERY IMPX shows OFF then to execute SQUARE EXEC, you need to enter:

• exec square 4 If QUERY IMPEX shows ON then you can just enter:

• square 4 You will find more examples in the REXX module, but other CMS

examples can be found in the CMS User’s Guide.

© 2004 IBM Corporation

IBM ^

DIRLIST

© 2004 IBM Corporation

IBM ^

DIRLIST Options

© 2004 IBM Corporation

IBM ^

DIRLIST Usage Notes

When invoking DIRLIST, you use the XEDIT environment for editing the current file name. Each line in this file contains:

– A command area– A file mode– The directory name or minidisk address

Entering CMS commands from DIRLIST Using special commands from DIRLIST Saving a list of directories, minidisks, or both Tailoring the DIRLIST command options Using symbols as part of a command

© 2004 IBM Corporation

IBM ^

CSLMAP

© 2004 IBM Corporation

IBM ^

CSLMAP Usage Notes

Using the EXECUTE command within CSLMAP allows you to use the routines displayed

CSLMAP displays information according to the runname if neither USER or SYSTEM is specified

Each line of the CSLMAP file list contains:• A command area• The alias or runname of the routine• The library name the routine belongs; to name a few

When entering CMS commands, enter CMS first to prevent XEDIT from interpreting the command as an XEDIT command.

© 2004 IBM Corporation

IBM ^

CSLMAP Usage Notes cont.

Use DEFAULTS to set up options and override defaults for CSLMAP You can enter commands directly in the command area of the line

that displays a routine Special symbols that can be used alone are =, ?, and / Commands used with CSLMAP are RTNLOAD, RTNMAP,

RTNDROP, and CSLLIST

© 2004 IBM Corporation

IBM ^

CSLLIST

© 2004 IBM Corporation

IBM ^

RDRLIST

© 2004 IBM Corporation

IBM ^

RDRLIST Usage Notes

You can tailor your RDRLIST command options by using the DEFAULTS command

Each line in your RDRLIST contains:• A command area• File name and file type• Class and type• Number of records

It is possible to issue commands directly from the line the file is displayed, such commands are:

• CHANGE RDR, PURGE RDR, TRANSFER RDR, PEEK, AND DISCARD

© 2004 IBM Corporation

IBM ^

RDRLIST Usage Notes cont.

Symbols can be used to represent operands in the command that will be executed

Special symbols can be used alone to execute a previous command (=), display the last command (?), or to make a line the current line

( / ) The return code “DMS205E [RC=28]” tells you that there are no files

currently in your reader.

© 2004 IBM Corporation

IBM ^

CMS Utilities

© 2004 IBM Corporation

IBM ^

DIRMAP Utility

© 2004 IBM Corporation

IBM ^

DIRMAP Utility Options

© 2004 IBM Corporation

IBM ^

DIRMAP Utility Input Files

These files must be fixed-block format and must conform to the following standards:

– Comments are indicated by an asterisk in column 1– Fields to be scanned must be contained within columns 1-71– If all the required fields cannot fit, a continuation line can be used

INCLUDE VOLSERS is used by DIRMAP to select certain minidisks that are to be included in the MDISKMAP

EXCLUDE VOLSERS is used by DIRMAP to select certain minidisks that are to be excluded in the MDISKMAP

© 2004 IBM Corporation

IBM ^

DIRMAP Utility Input Files cont.

GAPFILE VOLSERS is used by DIRMAP to select certain MDISKs whose GAPs are to be included in the GAPFILE

FULLPACK DEFINES is used by DIRMAP to list new fullpack minidisk definitions for device type 3380 and 3390 DASD. Your directory statements would be:

• MDISK 123 3380 000000 1000 VMSRES RR• MDISK 124 3380 000000 1500 VMSPKK RR• MDISK 125 3390 000000 2000 MYPACK RR• MDISK 126 3390 000000 1500 YOURPK RR

© 2004 IBM Corporation

IBM ^

DIRMAP Utility Output Files

fn MDISKMAP is the map of all the MDISKs fn LINKMAP is the cross-reference map of all LINK statements in the

user directory fn GAPFILE is a list of all the gaps that were detected in response to

the GAPFILE option, the format of the GAPFILE is:• columns 01–06 volume serial number of disk• columns 09–15 device type of disk• columns 17–22 start cylinder of gap• columns 23–28 end cylinder of gap• columns 29–34 number of cylinders in gap

DIRECT UNSORT is a file produced in response to the UNSORT option

© 2004 IBM Corporation

IBM ^

DIRMAP Utility Usage Notes

Input files must be fixed 80-byte format on any accessed minidisk There must be a R/W minidisk or directory available for output files A disk that has only fullpack minidisks is not considered to have any

gaps DIRMAP determines the size of a disk from the information it finds in

the z/VM directory The profile names will be prefixed with a “:” to distinguish them from

user IDs

© 2004 IBM Corporation

IBM ^

Conclusion

This topic increases your knowledge of CMS commands and utilities

Commands we covered are:• DISK

• DEFAULTS

• EXEC

• DIRLIST

• CSLLIST

• RDRLIST An important utility we covered was:

• DIRMAP

© 2004 IBM Corporation

IBM ^

Glossary

CSLLIST command - displays the contents of a callable services library (CSL).

CSLMAP command – displays information about currently loaded callable service library (CSL) routines.

DEFAULTS command – allows you to set up default options or display the current default options

© 2004 IBM Corporation

IBM ^

Glossary

DIRLIST command – displays a list of shared File System (SFS) directories for a specified directory structure and your linked minidisks

DIRMAP utility – is a fast, efficient and flexible MDISK/LINK mapping program for the user directory

DISK command – punches CMS files to the virtual spooled card punch in a special format determined by the command

© 2004 IBM Corporation

IBM ^

Glossary

RDRLIST command – displays information about the files in your virtual reader

STACK FIFO - First In, First Out. A queuing method also known as FCFS: first come, first served. Always process the item that has been in the queue the longest.

STACK LIFO – Last In, First Out. A queuing technique where the most recent addition to the queue is processed first. Also known as a push-down stack.

© 2004 IBM Corporation

IBM ^

References

z/VM: CMS Commands and Utilities Reference (V4 R3.0) Publication number: SC24-6010-02

“Dictionary of the Mainframe World”, Software Diversified Services (SDS). www.sdsusa.com/index.htm

z/VM: V4R3.0 General Information Publication number: GC24-5991-04