%ICQSPC00  dsname  SPACEFULL(percent) + 
                   SPACEINCREASE(percent) + 
                   KBYTESFREE(nn) + 
                   DIRFULL(percent) + 
                   DIRINCREASE(percent) + 
                   DIRBLOCKSFREE(nn) + 
                   RECALL(yes/no) + 
                   PROTECTNEW(yes/no) + 
                   RACFUACC(none/read/update/alter) + 
                   ALLOWPASSWORDS(yes/no) + 
                   INFOPANEL(panelid) + 
                   ASKPANEL(panelid) + 
                   VERIFYPARMS(yes/no) + 
                   COMPRESS + 
                   TRACE + 
                   REALLOCATENEW(yes/no) + 
                   ALLOCATENEW(yes/no/ask) + 
                     PRIMSPACE(nn) + 
                     SECSPACE(nn) + 
                     UNITS(tracks/cylinders) + 
                     DIRBLOCKS(nn) + 
                     BLKSIZE(nn) + 
                     LRECL(nn) + 
                     RECFM(string) + 
                     LIKE(dsname)

DSNAME

specifies the name of the data set to be managed. If the data set name appears within single quotes, the CLIST treats it as fully qualified. If the data set name appears without quotes, the CLIST adds the prefix.

SPACEFULL(percent)

specifies the percentage that the data set can be full before ICQSPC00 should compress or reallocate it. Specify a number from 0 to 100. The default is 80, which means that when the data set is greater than 80% full, it will be compressed or reallocated.

SPACEINCREASE(percent)

specifies the percentage of increase for the data set's primary extent that ICQSPC00 is to use when reallocating the data set. Specify an integer. The default is 50.

KBYTESFREE(nn)

specifies the minimum amount of space (in kilobytes) that the data set must have free. If the data set does not have this much space free after ICQSPC00 compresses it, ICQSPC00 then reallocates the data set to force this much free space. There is no default.

DIRFULL(percent)

specifies the percentage that the directory for a partitioned data set can be full before it should be compressed or reallocated. Specify a number from 0 to 100. The default is 80, which means that when the directory is greater than 80% full, it will be compressed or reallocated.

DIRINCREASE(percent)

specifies the percentage that a partitioned data set's directory should be increased in size when being reallocated. Specify an integer. The default is 50.

DIRBLOCKSFREE(nn)

specifies the minimum number of directory blocks (in positive integers) that a partitioned data set must have free. If the data set does not have this many blocks free after ICQSPC00 compresses it, ICQSPC00 then reallocates it to force this many directory blocks to be free. There is no default.

RECALL(YES | NO | null)

specifies whether ICQSPC00 is to recall a data set that has been migrated by the Data Facility Hierarchical Storage Manager (DFHSM). Null specifies recalling a migrated data set from DASD. YES specifies recalling a data set from any medium, including tape. NO specifies that no data sets be recalled. The default is null.

PROTECTNEW(YES | NO)

specifies whether ICQSPC00 should RACF-protect a new data set. If you specify YES, ICQSPC00 protects the new data set with the value in RACFUACC and copies the list of users who have permission to access the data set. The default is NO.

RACFUACC(NONE | READ | UPDATE | ALTER)

specifies the universal RACF® access for a new data set or an enlarged data set. When the data set has a generic profile, this parameter also protects the temporary data set used during reallocation. If the data set has a discrete RACF profile, ICQSPC00 ignores this parameter and copies the existing RACFUACC value and the list of users who have permission to access the data set. The default is NONE.

ALLOWPASSWORDS(YES | NO)

specifies whether ICQSPC00 should manage a password-protected data set. If you specify NO and the data set is password-protected, ICQSPC00 does not manage the data set and sets a non-zero return code. If you specify YES, ICQSPC00 executes normally, and the system prompts the user to enter the password when required. The default is NO.

INFOPANEL(panel ID)

specifies the ID of a panel that will override the default space management panel displayed during allocation. The default panel ID is ICQSPE00.

Figure 1. Default Panel for Space Management Allocation (ICQSPE00)

ICQSPE00      INFORMATION CENTER FACILITY - SPACE MANAGEMENT




     The data set specified below is running out of storage space.




     Please wait a few minutes while the storage space for
     this data set is automatically increased.

     None of your work will be lost.

     This panel is simply to inform you of this activity while
     it is taking place, because it can take a few moments.

     You will be returned to where you were interrupted when this
     processing is complete.

     You can then continue where you left off.
 

ASKPANEL(panel ID)

specifies the ID of a panel that will override the default space management panel displayed when a data set does not exist. The default panel ID is ICQSPE01.

Figure 2. Default Panel for Space Management When a Data Set Does Not Exist (ICQSPE01)

ICQSPE01      INFORMATION CENTER FACILITY - SPACE MANAGEMENT
COMMAND ===>



   The data set specified below does not exist.




   To continue normally and have the data set created, press ENTER.
   To cancel, press END.
 

VERIFYPARMS(YES | NO)

specifies whether ICQSPC00 is to check the syntax of the input parameters. Specify YES to check the parameter syntax. Specifying NO can improve performance. The default is YES.

COMPRESS

specifies that ICQSPC00 is to compress the data set. After compressing the data set, ICQSPC00 then checks to see if there is enough space, and if not, it reallocates the data set.

TRACE

specifies that space management should trace ICQSPC00 to the terminal. It sets the same trace level as TRACE2 in other Information Center Facility functions.

Note: If you invoke ICQSPC00 from an ISPF selection panel, it also supports the Information Center Facility trace options ‘TRACE1’, ‘TRACE2’, ‘TRACE3.ICQSPC00’, and ‘TRACEOFF’.

REALLOCATENEW(YES | NO)

specifies whether to enlarge (reallocate) a data set if it is running out of space. Specify YES or NO. If you specify NO, ICQSPC00 does not reallocate the data set. The default is YES.

ALLOCATENEW(YES |NO | ASK)

specifies whether ICQSPC00 is to allocate a new data set if the one specified does not exist. If you specify YES, ICQSPC00 automatically allocates the data set. If you specify NO, ICQSPC00 does not allocate a new data set and sets a return code indicating that the data set was not found. If you specify ASK, the panel specified in the ASKPANEL parameter (or the default, ICQSPE01) is displayed, asking whether the file should be allocated. The default is ASK.

The following optional allocation parameters must be used when allocating a new data set:

PRIMSPACE(nn)

specifies the number of primary space units to be allocated to the data set. There is no default.

SECSPACE(nn)

specifies the number of secondary space units to be allocated to the data set. There is no default.

UNITS(TRACKS | CYLINDERS)

specifies the space units for the data set. It can be TRACKS or CYLINDERS. There is no default.

DIRBLOCKS(nn)

specifies the number of directory blocks to be allocated to a partitioned data set. For a sequential data set, you must specify DIRBLOCKS(0). There is no default.

BLKSIZE(nn)

specifies the block size of the data set. There is no default.

LRECL(nn)

specifies the logical record length of the data set. The length can range from 1 to 32756. There is no default.

RECFM(string)

specifies the record format of the data set. If more than one characteristic is specified, do not separate them with blanks or commas. For example, specify RECFM(FB) to indicate that the records are blocked and fixed-length.

LIKE(dsname)

specifies a data set that the space manager is to use as a model data set. There is no default.

To specify a fully-qualified data set name, enclose it in three sets of single quotes. For example, to use ‘userid.MODEL.CLIST’ as a model data set, specify:

LIKE('userid.MODEL.CLIST'')