Invoking ICKDSF with a CMS EXEC

You can invoke ICKDSF under CMS using an EXEC. The EXEC must:

Contain the required statements to enter ICKDSF
Identify the input and output devices
Identify the ICKDSF commands and parameters for the task

When ICKDSF processing has completed, the highest condition code (MAXCC) set during the entire command processing is returned to CMS.

Figure 1 shows an example of a CMS REXX named CPLIST. CPLIST EXEC issues the CPVOLUME command of ICKDSF with the LIST parameter. This displays the device information, volume serial, and allocation map of a control program (CP) formatted volume or minidisk given the virtual device number or virtual device address.

Figure 1. CPLIST EXEC

 /* Sample CMS REXX procedure of the CPVOLUME command of ICKDSF  */

   Address 'COMMAND'
   Arg ccuu .

   Queue 'CPVOLUME LIST UNITADDRESS('ccuu') NOVERIFY'
   Queue 'END'
   'ICKDSF CONSOLE CONSOLE'

   Exit Rc

The EXEC:

Invokes ICKDSF.
Identifies the console as the input and output device.
Issues the CPVOLUME LIST command. You must supply the UNITADDRESS when you invoke the EXEC from the console. For example, if the UNITADDRESS was E45, you would enter CPLIST E45 at the console to run the EXEC.
Terminates ICKDSF.