z/VM Module 4: Advanced Structures and Commands

1. z/VMModule 4: Advanced Structures and Commands Conversational Monitoring System

2. Objectives • List and describe additional CMS commands, including: • Command descriptions • Syntax diagrams • Usage notes • Describe the DIRMAP utility, including: • Description • Functions • Usage notes

3. Advanced CMS Commands

4. DISK Command

5. DISK LOAD Options

6. 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 cont disk dump source1assemble disk dump source2 assemble cp 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

7. 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

8. DEFAULTS

9. DEFAULTS

10. 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

11. EXEC

12. 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.

13. DIRLIST

14. DIRLIST Options

15. 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

16. CSLMAP

17. 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.

18. 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

19. CSLLIST

20. RDRLIST

21. 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

22. 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.

23. CMS Utilities

24. DIRMAP Utility

25. DIRMAP Utility Options

26. 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

27. 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

28. 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

29. 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

30. 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

31. 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

32. 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

33. 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.

34. 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