Creating a Spool File

SUBSYS Interface › DD Statement SUBSYS Parameter › Creating a Spool File

Creating a Spool File

The following lists the sub-parameters that create a spool file:

//ddname  DD SUBSYS=(ESF   
           ,class        p1
           ,filename     p2
           ,destination  p3
           ,form         p4
           ,affinity     p5
           ,programmer   p6
           ,user info    p7
           ,HOLD         p8
           ,DELETE       p9
           ,fcb          p10
           ,copies       p11
           ,outlimit     p12
           ,retain time) p13

The following sub-parameters apply:

Sub-parameter	Function
p1	Specifies output class to be assigned to the new file. Enter a single alphanumeric character. If this sub-parameter is omitted, the default value is substituted.
p2	Specifies the filename of the file to be created. Enter 1 to 8 alphanumeric characters. If this sub-parameter is omitted, the job name is used as the default.
p3	Specifies the destination name of the file to be created. Enter 1 to 8 alphanumeric characters. This sub-parameter is required.
p4	Specifies the form number. Enter 1 to 8 alphanumeric characters. If this sub-parameter is omitted, the default value is substituted.
p5	Specifies the name of the CA Spool system that will eventually write this file. Enter the 1-to 4-character name of a CA Spool system. This parameter is optional.
p6	Specifies the name of the programmer. Enter 1 to 256 bytes of arbitrary information to help you identify this file. The number of bytes available is usually determined by the system programmer. This parameter is optional.
p7	Specifies user-exit information. Enter 1 to 4 characters of information to be passed to the interface exit. This parameter is optional. To generate a new print file each time the allocation is opened and closed, specify 'SEPA' in this parameter.
p8	Specifies HOLD if the file to be created should be held and not scheduled for print when closed. This parameter is optional; the default is not to hold the file.
p9	Specifies DELETE if the file being created should be purged if it is empty when it is closed. This parameter is optional; the default is to keep the file.
p10	Specifies the FCB image name to be used when this file is to be printed. Enter a 1-4 alphanumeric character FCB image name. If this parameter is omitted, the default value is substituted.
p11	Specifies the copy count. Enter a 1-to 3-character decimal number in the range 1 to 255 specifying the copy count. If this parameter is omitted, a value of 1 is assumed.
p12	Specifies the output limit. Enter a 1-to 8-character decimal number in the range 1-16777215 specifying the maximum number of records this file may contain. If this parameter is omitted, the default value is substituted.
p13	Specifies the retention time. Enter a decimal number in the range 0-4095 specifying the number of hours the file should be retained after it is printed. If a value of 0 is specified, the file is purged immediately after it is printed. If no value is supplied, the default value from the printer definition is used.