Use the PRIMARY statement to specify the number of tracks, blocks, or cylinders (according to SPACETYPE) for primary allocation.
- Server
- This setting applies when creating data sets on the server's system.
- Client
- This setting applies when creating data sets on the client's system.
Syntax
.-PRIMARY 1-----------. >>-+---------------------+------------------------------------->< '-PRIMARY--+--------+-' '-amount-'
Parameters
- amount
- The number of tracks, blocks, or cylinders. The valid range is
1 - 16 777 215 blocks (the operating system maximum). The
default is 1.
- If you specify no value for the amount parameter, FTP does not specify the number of tracks, blocks, or cylinders for primary allocation.
- You should specify no value for the amount parameter
if the DATACLASS statement is specified and the space allocation from
the SMS data class is to be used. If
the SMS data class is to be used for space allocation, both the PRIMARY
and SECONDARY values must be omitted and the value on the SPACETYPE
statement is ignored.
Restriction: If a UNIX file (such as /etc/ftp.data) is being used as the configuration input and no value for the amount parameter is specified, the statement should not have any trailing blanks. Ensure that the line ends after the PRIMARY keyword or that a comment is also specified.
- For allocating partitioned data sets, amount is the quantity that is allocated for the primary extent.
- For allocating sequential data sets, amount is the maximum quantity that is allocated for the primary extent. If a lesser amount is needed to hold the data being transferred, the unused amount is released after the transfer is complete.
Examples
Set the primary allocation to
5 tracks:
PRIMARY 5Related topics
- DATACLASS (FTP client and server) statement
- DSNTYPE (FTP client and server) statement
- EATTR (FTP client and server) statement
- See the information about storage management subsystem (SMS) in z/OS Communications Server: IP Configuration Guide for more information about specifying attributes when allocating new data sets.
- SECONDARY (FTP client and server) statement
- SPACETYPE (FTP client and server) statement